@cat-factory/app 0.238.0 → 0.239.0

package/app/components/panels/ReportsPanel.vue

@@ -1,6 +1,7 @@
 <script setup lang="ts">
 import { computed, ref, watch } from 'vue'
 import { onKeyStroke } from '@vueuse/core'
+import { lastCompleteRollupDay } from '@cat-factory/contracts'
 import type {
   ReportActivityDimension,
   ReportActivityRow,
@@ -89,6 +90,29 @@ const activityByDimension = computed<ReportActivityRow[]>(() => {
   return activity.byTaskType
 })
 
+const DAY_MS = 24 * 60 * 60 * 1000
+
+// How the window's SPEND half was answered. The long (TCO) windows read the durable
+// cost-attribution rollup, which is only as fresh as the last retention sweep, so a rollup
+// that has materialised NOTHING must not render as a quiet quarter and one whose watermark is
+// well behind `now` must not render its empty tail as thrift. Same three states as the
+// operator dashboard's daily run rollup.
+//
+// The lag is measured against `lastCompleteRollupDay(generatedAt)`, NOT against `generatedAt`
+// itself, because that is what `rolledUpThrough` counts in: the newest day the sweep could
+// possibly have finished by now. Measuring against the wall clock instead compares a day
+// boundary with an instant, so the very same healthy rollup drifts from ~0h of apparent lag
+// just after midnight to ~24h just before the next one, and any fixed threshold then turns the
+// hour the report happened to be opened into a health verdict. One whole missed day of slack
+// is deliberate: the sweep is a daily cron on one facade, so a single skipped firing is a
+// hiccup the next pass heals, while two in a row is the wedge worth naming.
+const rollupState = computed<'none' | 'stale' | 'current' | null>(() => {
+  const v = view.value
+  if (!v || v.source !== 'daily-rollup') return null
+  if (v.rolledUpThrough == null) return 'none'
+  return lastCompleteRollupDay(v.generatedAt) - v.rolledUpThrough > DAY_MS ? 'stale' : 'current'
+})
+
 const maxTrend = computed(() => maxOf(view.value?.trend.points ?? [], trendMagnitude))
 const hasSpend = computed(() => (view.value?.totals.calls ?? 0) > 0)
 // Hoisted: every activity bar is scaled against the busiest slice in the SAME list, so this
@@ -246,6 +270,38 @@ watch(
               }}
             </p>
 
+            <!-- Which store answered, and how far it reaches. An un-materialised rollup and an
+                 account that spent nothing produce the same empty breakdown. -->
+            <p
+              v-if="rollupState === 'none'"
+              class="rounded-lg border border-amber-800/60 bg-amber-950/30 px-3 py-2 text-xs text-amber-200"
+              data-testid="reports-rollup-none"
+            >
+              {{ t('reports.rollup.none') }}
+            </p>
+            <p
+              v-else-if="rollupState === 'stale'"
+              class="rounded-lg border border-amber-800/60 bg-amber-950/30 px-3 py-2 text-xs text-amber-200"
+              data-testid="reports-rollup-stale"
+            >
+              {{
+                t('reports.rollup.stale', {
+                  date: d(new Date(view.rolledUpThrough ?? 0), 'short'),
+                })
+              }}
+            </p>
+            <p
+              v-else-if="rollupState === 'current'"
+              class="text-[11px] text-slate-500"
+              data-testid="reports-rollup-current"
+            >
+              {{
+                t('reports.rollup.current', {
+                  date: d(new Date(view.rolledUpThrough ?? 0), 'short'),
+                })
+              }}
+            </p>
+
             <!-- Headline totals. A stat tile, not a chart: these are single numbers. -->
             <section>
               <h2 class="mb-2 text-xs font-semibold uppercase tracking-wide text-slate-500">
@@ -352,10 +408,11 @@ watch(
               </section>
             </div>
 
-            <!-- The TCO axes: what a repository and a ticket actually cost. Spend-only, like the
-                 pair above, because a run's activity is already sliced by the service that owns
-                 the repo and there is no second population to pair a ticket with. -->
-            <div class="grid gap-6 md:grid-cols-2">
+            <!-- The TCO axes: what a repository, a ticket and a single run actually cost.
+                 Spend-only, like the pair above, because a run's activity is already sliced by
+                 the service that owns the repo and there is no second population to pair a
+                 ticket with, and a run IS the unit activity counts. -->
+            <div class="grid gap-6 md:grid-cols-3">
               <section>
                 <h2 class="mb-2 text-xs font-semibold uppercase tracking-wide text-slate-500">
                   {{ t('reports.spend.byRepo') }}
@@ -378,6 +435,17 @@ watch(
                   :label-of="sliceLabel"
                 />
               </section>
+              <section>
+                <h2 class="mb-2 text-xs font-semibold uppercase tracking-wide text-slate-500">
+                  {{ t('reports.spend.byRun') }}
+                </h2>
+                <ReportsSpendBreakdown
+                  :rows="view.spend.byRun"
+                  :currency="currency"
+                  test-id="reports-spend-run"
+                  :label-of="sliceLabel"
+                />
+              </section>
             </div>
 
             <!-- The shared axis: spend AND activity for the same grouping, side by side. -->

package/i18n/locales/de.json

@@ -3640,6 +3640,11 @@
     "retry": "Erneut versuchen",
     "error": "Berichte konnten nicht geladen werden.",
     "period": "{from} bis {to}",
+    "rollup": {
+      "none": "Die dauerhafte Kostenaggregation hat noch nichts erzeugt. Dieses Zeitfenster ist also mangels Daten leer, nicht mangels Kosten.",
+      "stale": "Die dauerhafte Kostenaggregation reicht nur bis {date}. Alles danach sind fehlende Daten, keine günstige Woche.",
+      "current": "Aus der dauerhaften Kostenaggregation, vollständig bis {date}. Die Zuordnung zu Repository, Ticket und Lauf ist hier die, die beim Entstehen der Kosten erfasst wurde."
+    },
     "unattributed": "Nicht zugeordnet",
     "window": {
       "oneDay": "Letzte 24 Stunden",
@@ -3682,6 +3687,7 @@
       "byAgentKind": "Kosten nach Agententyp",
       "byRepo": "Kosten nach Repository",
       "byTicket": "Kosten nach Ticket",
+      "byRun": "Kosten nach Lauf",
       "heading": "Kosten",
       "empty": "In diesem Zeitraum wurde keine Nutzung erfasst.",
       "calls": "{count} Aufruf | {count} Aufrufe",

package/i18n/locales/en.json

@@ -1875,6 +1875,11 @@
     "retry": "Retry",
     "error": "Reports could not be loaded.",
     "period": "{from} to {to}",
+    "rollup": {
+      "none": "The durable cost rollup has produced nothing yet, so this window is empty for lack of data, not for lack of spend.",
+      "stale": "The durable cost rollup only reaches {date}. Anything after that is missing data, not a cheap week.",
+      "current": "From the durable cost rollup, complete through {date}. Repository, ticket and run attribution here is the one recorded when the spend happened."
+    },
     "unattributed": "Unattributed",
     "window": {
       "oneDay": "Last 24 hours",
@@ -1917,6 +1922,7 @@
       "byAgentKind": "Spend by agent kind",
       "byRepo": "Spend by repository",
       "byTicket": "Spend by ticket",
+      "byRun": "Spend by run",
       "heading": "Spend",
       "empty": "No recorded usage in this window.",
       "calls": "{count} call | {count} calls",

package/i18n/locales/es.json

@@ -1777,6 +1777,11 @@
     "retry": "Reintentar",
     "error": "No se pudieron cargar los informes.",
     "period": "Del {from} al {to}",
+    "rollup": {
+      "none": "La agregación de costes duradera aún no ha producido nada, así que esta ventana está vacía por falta de datos, no por falta de gasto.",
+      "stale": "La agregación de costes duradera solo llega hasta {date}. Lo posterior son datos que faltan, no una semana barata.",
+      "current": "De la agregación de costes duradera, completa hasta {date}. La atribución a repositorio, tique y ejecución es la que se registró cuando se produjo el gasto."
+    },
     "unattributed": "Sin atribuir",
     "window": {
       "oneDay": "Últimas 24 horas",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "Gasto por tipo de agente",
       "byRepo": "Gasto por repositorio",
       "byTicket": "Gasto por tique",
+      "byRun": "Gasto por ejecución",
       "heading": "Gasto",
       "empty": "No se registró uso en este periodo.",
       "calls": "{count} llamada | {count} llamadas",

package/i18n/locales/fr.json

@@ -1777,6 +1777,11 @@
     "retry": "Réessayer",
     "error": "Impossible de charger les rapports.",
     "period": "Du {from} au {to}",
+    "rollup": {
+      "none": "L'agrégation durable des coûts n'a encore rien produit : cette fenêtre est vide faute de données, pas faute de dépenses.",
+      "stale": "L'agrégation durable des coûts ne va que jusqu'au {date}. Ce qui suit correspond à des données manquantes, pas à une semaine bon marché.",
+      "current": "Issu de l'agrégation durable des coûts, complète jusqu'au {date}. L'attribution au dépôt, au ticket et à l'exécution est celle enregistrée au moment de la dépense."
+    },
     "unattributed": "Non attribué",
     "window": {
       "oneDay": "Dernières 24 heures",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "Dépense par type d’agent",
       "byRepo": "Dépense par dépôt",
       "byTicket": "Dépense par ticket",
+      "byRun": "Dépense par exécution",
       "heading": "Dépense",
       "empty": "Aucune utilisation enregistrée sur cette période.",
       "calls": "{count} appel | {count} appels",

package/i18n/locales/he.json

@@ -1777,6 +1777,11 @@
     "retry": "נסה שוב",
     "error": "לא ניתן היה לטעון את הדוחות.",
     "period": "מ־{from} עד {to}",
+    "rollup": {
+      "none": "סיכום העלויות המתמיד עוד לא הפיק דבר, ולכן החלון הזה ריק מחוסר נתונים ולא מחוסר הוצאה.",
+      "stale": "סיכום העלויות המתמיד מגיע רק עד {date}. כל מה שאחרי זה הוא נתונים חסרים, לא שבוע זול.",
+      "current": "מתוך סיכום העלויות המתמיד, שלם עד {date}. הייחוס למאגר, לכרטיס ולהרצה הוא זה שנרשם בזמן ההוצאה."
+    },
     "unattributed": "ללא שיוך",
     "window": {
       "oneDay": "24 השעות האחרונות",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "עלות לפי סוג סוכן",
       "byRepo": "עלות לפי מאגר",
       "byTicket": "עלות לפי כרטיס",
+      "byRun": "עלות לפי הרצה",
       "heading": "עלות",
       "empty": "לא נרשם שימוש בטווח הזה.",
       "calls": "קריאה אחת | שתי קריאות | {count} קריאות",

package/i18n/locales/it.json

@@ -3640,6 +3640,11 @@
     "retry": "Riprova",
     "error": "Impossibile caricare i report.",
     "period": "Dal {from} al {to}",
+    "rollup": {
+      "none": "L'aggregazione permanente dei costi non ha ancora prodotto nulla: questa finestra è vuota per mancanza di dati, non di spesa.",
+      "stale": "L'aggregazione permanente dei costi arriva solo al {date}. Quello che viene dopo sono dati mancanti, non una settimana economica.",
+      "current": "Dall'aggregazione permanente dei costi, completa fino al {date}. L'attribuzione a repository, ticket ed esecuzione è quella registrata quando la spesa è avvenuta."
+    },
     "unattributed": "Non attribuito",
     "window": {
       "oneDay": "Ultime 24 ore",
@@ -3682,6 +3687,7 @@
       "byAgentKind": "Spesa per tipo di agente",
       "byRepo": "Spesa per repository",
       "byTicket": "Spesa per ticket",
+      "byRun": "Spesa per esecuzione",
       "heading": "Spesa",
       "empty": "Nessun utilizzo registrato in questo periodo.",
       "calls": "{count} chiamata | {count} chiamate",

package/i18n/locales/ja.json

@@ -1777,6 +1777,11 @@
     "retry": "再試行",
     "error": "レポートを読み込めませんでした。",
     "period": "{from} 〜 {to}",
+    "rollup": {
+      "none": "永続的なコスト集計はまだ何も生成していません。この期間が空なのは費用がなかったからではなく、データがないためです。",
+      "stale": "永続的なコスト集計は {date} までしか届いていません。それ以降は費用が少なかったのではなく、欠けているデータです。",
+      "current": "永続的なコスト集計より。{date} まで完全です。ここでのリポジトリ・チケット・実行への割り当ては、費用が発生した時点で記録されたものです。"
+    },
     "unattributed": "未割り当て",
     "window": {
       "oneDay": "過去24時間",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "エージェント種別の費用",
       "byRepo": "リポジトリ別の費用",
       "byTicket": "チケット別の費用",
+      "byRun": "実行別の費用",
       "heading": "費用",
       "empty": "この期間に記録された利用はありません。",
       "calls": "{count} 件の呼び出し | {count} 件の呼び出し",

package/i18n/locales/pl.json

@@ -1777,6 +1777,11 @@
     "retry": "Spróbuj ponownie",
     "error": "Nie udało się wczytać raportów.",
     "period": "Od {from} do {to}",
+    "rollup": {
+      "none": "Trwałe zestawienie kosztów nie wyprodukowało jeszcze niczego, więc to okno jest puste z braku danych, a nie z braku wydatków.",
+      "stale": "Trwałe zestawienie kosztów sięga tylko do {date}. To, co po tej dacie, to brakujące dane, a nie tani tydzień.",
+      "current": "Z trwałego zestawienia kosztów, kompletnego do {date}. Przypisanie do repozytorium, zgłoszenia i uruchomienia jest tym zapisanym w chwili poniesienia kosztu."
+    },
     "unattributed": "Nieprzypisane",
     "window": {
       "oneDay": "Ostatnie 24 godziny",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "Koszty według typu agenta",
       "byRepo": "Koszty według repozytorium",
       "byTicket": "Koszty według zgłoszenia",
+      "byRun": "Koszty według uruchomienia",
       "heading": "Koszty",
       "empty": "W tym okresie nie zarejestrowano użycia.",
       "calls": "{count} wywołanie | {count} wywołania | {count} wywołań",

package/i18n/locales/tr.json

@@ -1777,6 +1777,11 @@
     "retry": "Yeniden dene",
     "error": "Raporlar yüklenemedi.",
     "period": "{from} – {to}",
+    "rollup": {
+      "none": "Kalıcı maliyet toplaması henüz hiçbir şey üretmedi; bu pencere harcama olmadığı için değil, veri olmadığı için boş.",
+      "stale": "Kalıcı maliyet toplaması yalnızca {date} tarihine kadar geliyor. Sonrası ucuz geçen bir hafta değil, eksik veri.",
+      "current": "Kalıcı maliyet toplamasından; {date} tarihine kadar eksiksiz. Buradaki depo, bilet ve çalıştırma ataması, harcama yapıldığı anda kaydedilenidir."
+    },
     "unattributed": "Atanmamış",
     "window": {
       "oneDay": "Son 24 saat",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "Ajan türüne göre harcama",
       "byRepo": "Depoya göre harcama",
       "byTicket": "Bilete göre harcama",
+      "byRun": "Çalıştırmaya göre harcama",
       "heading": "Harcama",
       "empty": "Bu dönemde kayıtlı kullanım yok.",
       "calls": "{count} çağrı | {count} çağrı",

package/i18n/locales/uk.json

@@ -1777,6 +1777,11 @@
     "retry": "Спробувати ще раз",
     "error": "Не вдалося завантажити звіти.",
     "period": "З {from} по {to}",
+    "rollup": {
+      "none": "Стале зведення витрат ще нічого не сформувало, тож це вікно порожнє через брак даних, а не через брак витрат.",
+      "stale": "Стале зведення витрат сягає лише {date}. Усе після цієї дати означає відсутні дані, а не дешевий тиждень.",
+      "current": "Зі сталого зведення витрат, повного до {date}. Прив’язку до репозиторію, тікета й запуску тут зафіксовано в момент витрати."
+    },
     "unattributed": "Без прив’язки",
     "window": {
       "oneDay": "Останні 24 години",
@@ -1819,6 +1824,7 @@
       "byAgentKind": "Витрати за типом агента",
       "byRepo": "Витрати за репозиторієм",
       "byTicket": "Витрати за тікетом",
+      "byRun": "Витрати за запуском",
       "heading": "Витрати",
       "empty": "За цей період використання не зафіксовано.",
       "calls": "{count} виклик | {count} виклики | {count} викликів",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.238.0",
+  "version": "0.239.0",
   "description": "Reusable Nuxt layer for the Agent Architecture Board SPA (components, stores, composables, pages). Consume it from a thin deployment app via `extends: ['@cat-factory/app']` and point it at your backend with NUXT_PUBLIC_API_BASE. See deploy/frontend for an example.",
   "repository": {
     "type": "git",
@@ -40,7 +40,7 @@
     "valibot": "^1.4.2",
     "vue": "3.5.40",
     "wretch": "^3.0.9",
-    "@cat-factory/contracts": "0.258.0"
+    "@cat-factory/contracts": "0.259.0"
   },
   "devDependencies": {
     "@toad-contracts/testing": "0.3.2",