@cat-factory/app 0.286.6 → 0.287.0

package/app/components/panels/ReportsPanel.vue

@@ -5,6 +5,7 @@ import { lastCompleteRollupDay } from '@cat-factory/contracts'
 import type {
   ReportActivityDimension,
   ReportActivityRow,
+  ReportSpendDimension,
   ReportSpendRow,
   ReportWindow,
 } from '~/types/execution'
@@ -56,12 +57,14 @@ const WINDOWS: { value: ReportWindow; label: string }[] = [
   { value: '90d', label: t('reports.window.ninetyDays') },
 ]
 
-// The dimension the paired spend + activity breakdowns are grouped by. Model and agent
-// kind have no activity counterpart (a run carries no single kind), so they render
-// unconditionally above rather than joining this switch.
+// The dimension the paired spend + activity breakdowns are grouped by. Model and agent kind
+// have no activity counterpart (a run carries no single kind), and neither do ticket and run
+// (a ticket counts no runs of its own, and a run IS the unit), so those four render as
+// spend-only cards rather than joining this switch.
 const DIMENSIONS: { value: ReportActivityDimension; label: string }[] = [
   { value: 'workspace', label: t('reports.dimension.workspace') },
   { value: 'service', label: t('reports.dimension.service') },
+  { value: 'repo', label: t('reports.dimension.repo') },
   { value: 'taskType', label: t('reports.dimension.taskType') },
 ]
 const dimension = ref<ReportActivityDimension>('workspace')
@@ -80,6 +83,7 @@ const spendByDimension = computed<ReportSpendRow[]>(() => {
   if (!spend) return []
   if (dimension.value === 'workspace') return spend.byWorkspace
   if (dimension.value === 'service') return spend.byService
+  if (dimension.value === 'repo') return spend.byRepo
   return spend.byTaskType
 })
 const activityByDimension = computed<ReportActivityRow[]>(() => {
@@ -87,9 +91,19 @@ const activityByDimension = computed<ReportActivityRow[]>(() => {
   if (!activity) return []
   if (dimension.value === 'workspace') return activity.byWorkspace
   if (dimension.value === 'service') return activity.byService
+  if (dimension.value === 'repo') return activity.byRepo
   return activity.byTaskType
 })
 
+/**
+ * What a given breakdown left out, or null when it is complete. Only the activity-scaled
+ * dimensions are ever capped, so this is null for everything else and the card renders no
+ * footer at all.
+ */
+function capFor(dimension: ReportSpendDimension) {
+  return view.value?.capped.find((cap) => cap.dimension === dimension) ?? null
+}
+
 const DAY_MS = 24 * 60 * 60 * 1000
 
 // How the window's SPEND half was answered. The long (TCO) windows read the durable
@@ -408,22 +422,12 @@ watch(
               </section>
             </div>
 
-            <!-- 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') }}
-                </h2>
-                <ReportsSpendBreakdown
-                  :rows="view.spend.byRepo"
-                  :currency="currency"
-                  test-id="reports-spend-repo"
-                  :label-of="sliceLabel"
-                />
-              </section>
+            <!-- The two spend-only TCO axes: what a ticket and a single run cost. There is no
+                 second population to pair a ticket with, and a run IS the unit activity counts.
+                 The repository axis has both halves, so it sits in the paired switch below.
+                 Both of these grow with ACTIVITY rather than with a catalog, so both are the
+                 breakdowns the projection caps, and each says so under its own card. -->
+            <div class="grid gap-6 md:grid-cols-2">
               <section>
                 <h2 class="mb-2 text-xs font-semibold uppercase tracking-wide text-slate-500">
                   {{ t('reports.spend.byTicket') }}
@@ -433,6 +437,7 @@ watch(
                   :currency="currency"
                   test-id="reports-spend-ticket"
                   :label-of="sliceLabel"
+                  :cap="capFor('ticket')"
                 />
               </section>
               <section>
@@ -444,6 +449,7 @@ watch(
                   :currency="currency"
                   test-id="reports-spend-run"
                   :label-of="sliceLabel"
+                  :cap="capFor('run')"
                 />
               </section>
             </div>

package/app/components/panels/ReportsSpendBreakdown.vue

@@ -1,13 +1,13 @@
 <script setup lang="ts">
 import { computed } from 'vue'
-import type { ReportSpendRow } from '~/types/execution'
+import type { ReportSpendCap, ReportSpendRow } from '~/types/execution'
 import { maxOf, segmentPct, spendMagnitude } from './ReportsPanel.logic'
 
 // One ranked spend breakdown: a horizontal bar per slice, split into the metered
 // (`violet-500`, real money) and subscription (`amber-600`, illustrative equivalent-API
 // cost) segments with a surface gap between them. Extracted from `ReportsPanel.vue` because
-// the panel renders four of these against different dimensions — the shape is identical,
-// only the row list and the heading differ.
+// the panel renders five of these against different dimensions: the shape is identical, only
+// the row list and the heading differ.
 //
 // Every bar is scaled against the HEAVIEST slice in this list, so a full bar means "the
 // biggest consumer here", never an absolute budget. The panel owns the legend (the two
@@ -18,6 +18,13 @@ const props = defineProps<{
   testId: string
   /** Resolves a slice's display name (the panel owns the unattributed/i18n vocabulary). */
   labelOf: (row: ReportSpendRow) => string
+  /**
+   * What this breakdown left out, when the projection capped it. Rendered as a footer note:
+   * a reader who assumes a list is complete would read the heaviest hundred repositories as
+   * the whole bill, so the tail is STATED rather than left to be inferred from the row count.
+   * The window totals above still cover it, which is what the note says.
+   */
+  cap?: ReportSpendCap | null
 }>()
 
 const { t, n } = useI18n()
@@ -70,5 +77,10 @@ const max = computed(() => maxOf(props.rows, spendMagnitude))
         </p>
       </li>
     </ul>
+    <p v-if="cap" class="mt-3 text-[10px] text-slate-500" :data-testid="`${testId}-capped`">
+      {{
+        t('reports.spend.capped', { shown: n(cap.returned), omitted: n(cap.omitted) }, cap.omitted)
+      }}
+    </p>
   </div>
 </template>

package/app/stores/reports.ts

@@ -4,9 +4,9 @@ import type { ReportWindow, ReportsView } from '~/types/execution'
 import { useAccountsStore } from '~/stores/accounts'
 
 /**
- * Reports: cross-cutting usage analytics for the active account — spend per model and
- * agent kind, spend + run activity per workspace / service / task type, and a spend trend,
- * over a selectable window and optionally narrowed to one board.
+ * Reports: cross-cutting usage analytics for the active account: spend per model, agent
+ * kind, ticket and run, spend + run activity per workspace / service / repository / task
+ * type, and a spend trend, over a selectable window and optionally narrowed to one board.
  *
  * The sibling of the `platformObservability` store: same account scope, same admin gate,
  * same on-demand load. Nothing is pushed live (these are periodic rollups); changing the

package/app/types/execution.ts

@@ -43,6 +43,7 @@ export type {
   ReportSpendDimension,
   ReportActivityDimension,
   ReportSpendRow,
+  ReportSpendCap,
   ReportActivityRow,
   ReportTrendPoint,
   ReportTotals,

package/i18n/locales/de.json

@@ -4022,6 +4022,7 @@
     "dimension": {
       "workspace": "Board",
       "service": "Service",
+      "repo": "Repository",
       "taskType": "Aufgabentyp"
     },
     "breakdown": {
@@ -4048,14 +4049,14 @@
     "spend": {
       "byModel": "Kosten nach Modell",
       "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",
       "tokens": "{input} rein / {output} raus",
-      "subscriptionAside": "+{value} Abo"
+      "subscriptionAside": "+{value} Abo",
+      "capped": "Angezeigt werden die {shown} teuersten. {omitted} weiterer Eintrag ist nicht aufgeführt, in den Summen oben aber enthalten. | Angezeigt werden die {shown} teuersten. {omitted} weitere Einträge sind nicht aufgeführt, in den Summen oben aber enthalten."
     },
     "activity": {
       "heading": "Läufe",

package/i18n/locales/en.json

@@ -2073,6 +2073,7 @@
     "dimension": {
       "workspace": "Board",
       "service": "Service",
+      "repo": "Repository",
       "taskType": "Task type"
     },
     "breakdown": {
@@ -2099,14 +2100,14 @@
     "spend": {
       "byModel": "Spend by model",
       "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",
       "tokens": "{input} in / {output} out",
-      "subscriptionAside": "+{value} subscription"
+      "subscriptionAside": "+{value} subscription",
+      "capped": "Showing the {shown} costliest. {omitted} more is not listed, though the totals above still include it. | Showing the {shown} costliest. {omitted} more are not listed, though the totals above still include them."
     },
     "activity": {
       "heading": "Runs",

package/i18n/locales/es.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "Tablero",
       "service": "Servicio",
+      "repo": "Repositorio",
       "taskType": "Tipo de tarea"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "Gasto por modelo",
       "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",
       "tokens": "{input} de entrada / {output} de salida",
-      "subscriptionAside": "+{value} suscripción"
+      "subscriptionAside": "+{value} suscripción",
+      "capped": "Se muestran los {shown} más costosos. Hay {omitted} más que no aparece, aunque los totales de arriba sí lo incluyen. | Se muestran los {shown} más costosos. Hay {omitted} más que no aparecen, aunque los totales de arriba sí los incluyen."
     },
     "activity": {
       "heading": "Ejecuciones",

package/i18n/locales/fr.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "Tableau",
       "service": "Service",
+      "repo": "Dépôt",
       "taskType": "Type de tâche"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "Dépense par modèle",
       "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",
       "tokens": "{input} en entrée / {output} en sortie",
-      "subscriptionAside": "+{value} abonnement"
+      "subscriptionAside": "+{value} abonnement",
+      "capped": "Les {shown} plus coûteux sont affichés. {omitted} autre n’est pas listé, mais les totaux ci-dessus l’incluent. | Les {shown} plus coûteux sont affichés. {omitted} autres ne sont pas listés, mais les totaux ci-dessus les incluent."
     },
     "activity": {
       "heading": "Exécutions",

package/i18n/locales/he.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "לוח",
       "service": "שירות",
+      "repo": "מאגר",
       "taskType": "סוג משימה"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "עלות לפי מודל",
       "byAgentKind": "עלות לפי סוג סוכן",
-      "byRepo": "עלות לפי מאגר",
       "byTicket": "עלות לפי כרטיס",
       "byRun": "עלות לפי הרצה",
       "heading": "עלות",
       "empty": "לא נרשם שימוש בטווח הזה.",
       "calls": "קריאה אחת | שתי קריאות | {count} קריאות",
       "tokens": "{input} נכנס / {output} יוצא",
-      "subscriptionAside": "+{value} מנוי"
+      "subscriptionAside": "+{value} מנוי",
+      "capped": "מוצגים {shown} היקרים ביותר. פריט אחד נוסף אינו מופיע ברשימה, אך הסיכומים שלמעלה כוללים גם אותו. | מוצגים {shown} היקרים ביותר. שני פריטים נוספים אינם מופיעים ברשימה, אך הסיכומים שלמעלה כוללים גם אותם. | מוצגים {shown} היקרים ביותר. {omitted} פריטים נוספים אינם מופיעים ברשימה, אך הסיכומים שלמעלה כוללים גם אותם."
     },
     "activity": {
       "heading": "ריצות",

package/i18n/locales/it.json

@@ -4022,6 +4022,7 @@
     "dimension": {
       "workspace": "Board",
       "service": "Servizio",
+      "repo": "Repository",
       "taskType": "Tipo di attività"
     },
     "breakdown": {
@@ -4048,14 +4049,14 @@
     "spend": {
       "byModel": "Spesa per modello",
       "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",
       "tokens": "{input} in ingresso / {output} in uscita",
-      "subscriptionAside": "+{value} abbonamento"
+      "subscriptionAside": "+{value} abbonamento",
+      "capped": "Vengono mostrati i {shown} più costosi. Ne resta {omitted} non elencato, ma i totali qui sopra lo includono. | Vengono mostrati i {shown} più costosi. Ne restano altri {omitted} non elencati, ma i totali qui sopra li includono."
     },
     "activity": {
       "heading": "Esecuzioni",

package/i18n/locales/ja.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "ボード",
       "service": "サービス",
+      "repo": "リポジトリ",
       "taskType": "タスクの種類"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "モデル別の費用",
       "byAgentKind": "エージェント種別の費用",
-      "byRepo": "リポジトリ別の費用",
       "byTicket": "チケット別の費用",
       "byRun": "実行別の費用",
       "heading": "費用",
       "empty": "この期間に記録された利用はありません。",
       "calls": "{count} 件の呼び出し | {count} 件の呼び出し",
       "tokens": "入力 {input} / 出力 {output}",
-      "subscriptionAside": "+{value} サブスクリプション"
+      "subscriptionAside": "+{value} サブスクリプション",
+      "capped": "費用の大きい上位 {shown} 件を表示しています。ほかに {omitted} 件は一覧にありませんが、上の合計には含まれています。 | 費用の大きい上位 {shown} 件を表示しています。ほかに {omitted} 件は一覧にありませんが、上の合計には含まれています。"
     },
     "activity": {
       "heading": "実行",

package/i18n/locales/pl.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "Tablica",
       "service": "Usługa",
+      "repo": "Repozytorium",
       "taskType": "Typ zadania"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "Koszty według modelu",
       "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ń",
       "tokens": "{input} wejścia / {output} wyjścia",
-      "subscriptionAside": "+{value} subskrypcja"
+      "subscriptionAside": "+{value} subskrypcja",
+      "capped": "Pokazano {shown} najdroższych. Kolejnej {omitted} pozycji nie ujęto na liście, ale sumy powyżej ją uwzględniają. | Pokazano {shown} najdroższych. Kolejnych {omitted} pozycji nie ujęto na liście, ale sumy powyżej je uwzględniają. | Pokazano {shown} najdroższych. Kolejnych {omitted} pozycji nie ujęto na liście, ale sumy powyżej je uwzględniają."
     },
     "activity": {
       "heading": "Uruchomienia",

package/i18n/locales/tr.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "Pano",
       "service": "Servis",
+      "repo": "Depo",
       "taskType": "Görev türü"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "Modele göre harcama",
       "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ı",
       "tokens": "{input} giriş / {output} çıkış",
-      "subscriptionAside": "+{value} abonelik"
+      "subscriptionAside": "+{value} abonelik",
+      "capped": "En maliyetli {shown} tanesi gösteriliyor. {omitted} tanesi listelenmiyor, ancak yukarıdaki toplamlara dahil. | En maliyetli {shown} tanesi gösteriliyor. {omitted} tanesi listelenmiyor, ancak yukarıdaki toplamlara dahil."
     },
     "activity": {
       "heading": "Çalıştırmalar",

package/i18n/locales/uk.json

@@ -1969,6 +1969,7 @@
     "dimension": {
       "workspace": "Дошка",
       "service": "Сервіс",
+      "repo": "Репозиторій",
       "taskType": "Тип завдання"
     },
     "breakdown": {
@@ -1995,14 +1996,14 @@
     "spend": {
       "byModel": "Витрати за моделлю",
       "byAgentKind": "Витрати за типом агента",
-      "byRepo": "Витрати за репозиторієм",
       "byTicket": "Витрати за тікетом",
       "byRun": "Витрати за запуском",
       "heading": "Витрати",
       "empty": "За цей період використання не зафіксовано.",
       "calls": "{count} виклик | {count} виклики | {count} викликів",
       "tokens": "{input} вхід / {output} вихід",
-      "subscriptionAside": "+{value} підписка"
+      "subscriptionAside": "+{value} підписка",
+      "capped": "Показано {shown} найдорожчих. Ще {omitted} позицію не наведено в списку, але підсумки вище її враховують. | Показано {shown} найдорожчих. Ще {omitted} позиції не наведено в списку, але підсумки вище їх ураховують. | Показано {shown} найдорожчих. Ще {omitted} позицій не наведено в списку, але підсумки вище їх ураховують."
     },
     "activity": {
       "heading": "Запуски",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/app",
-  "version": "0.286.6",
+  "version": "0.287.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",
@@ -18,7 +18,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/contracts": "0.333.0",
+    "@cat-factory/contracts": "0.334.0",
     "@modular-frontend/core": "0.6.0",
     "@modular-vue/core": "^1.5.0",
     "@modular-vue/journeys": "^1.4.0",