@zaip-ai/cli 1.3.8 → 1.4.1

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostTables.tsx

@@ -5,6 +5,7 @@ import {
   formatDurationMs,
 } from "@zaip-ai/dashboard-ui";
 import type { CostGroupRow, CostRunRow, DurationCoverage } from "../contracts.js";
+import { invocationMetricDescription } from "./CostTableDisplay.js";
 import { MoreVerticalIcon } from "./CostTableIcons.js";
 import { type CostRunPagination, CostRunServerPagination } from "./CostTableLoading.js";
 import type { CostCurrency, CostLocale } from "./cost-monitor-copy.js";
@@ -76,6 +77,14 @@ export function formatAuditableNumber(value: number | null, locale: CostLocale):
   return new Intl.NumberFormat(locale, { maximumFractionDigits: 0 }).format(value ?? 0);
 }
 
+function formatFactualCount(value: number | null, locale: CostLocale): string {
+  return value === null
+    ? locale === "pt-BR"
+      ? "Indisponível"
+      : "Unavailable"
+    : formatAuditableNumber(value, locale);
+}
+
 export function formatAuditableCompactNumber(value: number | null, locale: CostLocale): string {
   return formatCompactNumber(value ?? 0, locale);
 }
@@ -85,7 +94,8 @@ export function formatAuditableCurrency(
   currency: CostCurrency,
   locale: CostLocale,
 ): string {
-  return formatCurrency(value ?? 0, currency, locale);
+  if (value === null) return locale === "pt-BR" ? "Indispon\u00edvel" : "Unavailable";
+  return formatCurrency(value, currency, locale);
 }
 
 export function formatAuditableDuration(value: number | null, locale: CostLocale): string {
@@ -113,108 +123,6 @@ const formatInvocationMultiplierPair = (
   locale: CostLocale,
 ) => formatMultiplierPair(input, output, locale);
 
-function invocationMetricDescription(locale: CostLocale, metric: string): string {
-  const source =
-    locale === "pt-BR"
-      ? "Valor da projeção SQLite/API desta Invocação de Agente. Fato canônico nulo permanece indisponível e não é convertido em zero."
-      : "Value from this Agent Invocation's SQLite/API projection. A null canonical fact remains unavailable and is not converted to zero.";
-  const details: Record<string, readonly [string, string]> = {
-    duration: [
-      "Tempo factual da invocação, quando capturado ou reconciliado.",
-      "Factual invocation duration, when captured or reconciled.",
-    ],
-    inputTokens: [
-      "Input total informado pela fonte; inclui a parcela de cache.",
-      "Source-reported total input; includes the cached portion.",
-    ],
-    cachedInputTokens: [
-      "Parcela de cache já incluída no input total.",
-      "Cached portion already included in total input.",
-    ],
-    outputTokens: [
-      "Output total informado pela fonte; inclui a parcela de raciocínio.",
-      "Source-reported total output; includes the reasoning portion.",
-    ],
-    reasoningTokens: [
-      "Parcela de raciocínio já incluída no output total.",
-      "Reasoning portion already included in total output.",
-    ],
-    totalTokens: [
-      "Soma de entrada e saída quando ambas são conhecidas; caso contrário, total informado pela fonte.",
-      "Input plus output when both are known; otherwise the source-reported total.",
-    ],
-    inputRate: [
-      "Tarifa efetiva de entrada em USD por milhão de tokens.",
-      "Effective input rate in USD per million tokens.",
-    ],
-    cacheRate: [
-      "Tarifa efetiva de entrada em cache em USD por milhão de tokens.",
-      "Effective cached-input rate in USD per million tokens.",
-    ],
-    outputRate: [
-      "Tarifa efetiva de saída em USD por milhão de tokens.",
-      "Effective output rate in USD per million tokens.",
-    ],
-    reasoningRate: [
-      "Tarifa efetiva de raciocínio em USD por milhão de tokens.",
-      "Effective reasoning rate in USD per million tokens.",
-    ],
-    contextMultiplier: [
-      "Multiplicadores de contexto de entrada/saída aplicados aos segmentos internos.",
-      "Input/output context multipliers applied to internal segments.",
-    ],
-    inputCost: [
-      "Custo USD de entrada calculado com tokens e tarifa efetiva.",
-      "Input USD cost calculated from tokens and the effective rate.",
-    ],
-    cacheCost: [
-      "Custo USD da entrada em cache calculado com tokens e tarifa efetiva.",
-      "Cached-input USD cost calculated from tokens and the effective rate.",
-    ],
-    outputCost: [
-      "Custo USD de saída calculado com tokens e tarifa efetiva.",
-      "Output USD cost calculated from tokens and the effective rate.",
-    ],
-    reasoningCost: [
-      "Custo USD de raciocínio calculado com tokens e tarifa efetiva.",
-      "Reasoning USD cost calculated from tokens and the effective rate.",
-    ],
-    standardCost: [
-      "Custo USD no cenário Standard, antes do acréscimo de velocidade.",
-      "USD cost in the Standard scenario, before the speed uplift.",
-    ],
-    speedUplift: [
-      "Acréscimo USD do cenário Priority/Fast, já incluído no custo efetivo.",
-      "USD uplift from the Priority/Fast scenario, already included in the effective cost.",
-    ],
-    finalUsd: [
-      "Custo final estimado da API em USD, somando os componentes de custo desta invocação.",
-      "Estimated final API cost in USD, summing this invocation's cost components.",
-    ],
-    fxRate: [
-      "Câmbio BRL/USD atual aplicado para converter o custo final atual.",
-      "Current BRL/USD exchange rate used to convert the current final cost.",
-    ],
-    recordedFxRate: [
-      "Câmbio BRL/USD registrado no período da atividade.",
-      "BRL/USD exchange rate recorded for the activity period.",
-    ],
-    recordedBrl: [
-      "Custo final BRL registrado no período, preservado para auditoria histórica.",
-      "Final BRL cost recorded in the period, retained for historical audit.",
-    ],
-    cost: [
-      "Custo final atual: USD estimado ou sua conversão BRL pelo câmbio atual selecionado.",
-      "Current final cost: estimated USD or its BRL conversion at the selected current exchange rate.",
-    ],
-  };
-  const detail = details[metric] ?? [
-    "Métrica numérica desta invocação.",
-    "Numeric metric for this invocation.",
-  ];
-  return `${detail[locale === "pt-BR" ? 0 : 1]} ${source}`;
-}
-
 export function formatDurationCoverage(value: DurationCoverage, locale: CostLocale): string {
   // `known_sum` is a factual elapsed-time observation even when another
   // activity in the population is unavailable.  Keep completeness and the
@@ -611,6 +519,7 @@ export function CostGroupsTable({
   showDateTime = true,
   showAgentIdentity = false,
   showInvocationTasks = false,
+  showModelLifecycleDetails = false,
   dateHeading,
   labelHeading,
   totals: suppliedTotals,
@@ -624,18 +533,37 @@ export function CostGroupsTable({
   showDateTime?: boolean;
   showAgentIdentity?: boolean;
   showInvocationTasks?: boolean;
+  showModelLifecycleDetails?: boolean;
   dateHeading?: string;
   labelHeading?: string;
   totals?: CostGroupTotals;
   loading?: boolean;
 }) {
+  const displayCount = (value: number | null) =>
+    formatFactualCount(
+      showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
+      locale,
+    );
+  const displayDuration = (value: DurationCoverage) =>
+    (showAgentIdentity || showModelLifecycleDetails) && value.known_sum <= 0
+      ? "0"
+      : formatDurationCoverage(value, locale);
+  const displayCurrency = (value: number | null) =>
+    formatAuditableCurrency(
+      showAgentIdentity || showModelLifecycleDetails ? (value ?? 0) : value,
+      currency,
+      locale,
+    );
+  const conversationCount = (row: unknown): number | null =>
+    (row as { conversation_count?: number | null }).conversation_count ?? null;
   const pageTotals = {
     runs: rows.reduce((sum, row) => sum + row.run_count, 0),
-    tasks: rows.reduce((sum, row) => sum + (row.task_count ?? 0), 0),
-    prds: rows.reduce((sum, row) => sum + row.prd_count, 0),
-    specs: rows.reduce((sum, row) => sum + row.spec_count, 0),
-    evidences: rows.reduce((sum, row) => sum + row.evidence_count, 0),
-    tests: rows.reduce((sum, row) => sum + row.test_count, 0),
+    tasks: sumNumbers(rows.map((row) => row.task_count)),
+    prds: sumNumbers(rows.map((row) => row.prd_count)),
+    specs: sumNumbers(rows.map((row) => row.spec_count)),
+    evidences: sumNumbers(rows.map((row) => row.evidence_count)),
+    tests: sumNumbers(rows.map((row) => row.test_count)),
+    conversations: sumNumbers(rows.map(conversationCount)),
     durationKnownMs: rows.reduce((sum, row) => sum + row.duration.known_sum, 0),
     durationPartial: rows.some((row) => !row.duration.complete),
     tokens: sumNumbers(rows.map((row) => row.total_tokens)),
@@ -647,18 +575,19 @@ export function CostGroupsTable({
       ? pageTotals
       : {
           runs: suppliedTotals.run_count,
-          tasks: suppliedTotals.task_count ?? 0,
+          tasks: suppliedTotals.task_count,
           prds: suppliedTotals.prd_count,
           specs: suppliedTotals.spec_count,
           evidences: suppliedTotals.evidence_count,
           tests: suppliedTotals.test_count,
+          conversations: conversationCount(suppliedTotals) ?? pageTotals.conversations,
           durationKnownMs: suppliedTotals.duration.known_sum,
           durationPartial: !suppliedTotals.duration.complete,
           tokens: suppliedTotals.total_tokens,
           usd: suppliedTotals.estimated_usd,
           brl: suppliedTotals.estimated_brl,
         };
-  const totalDurationDisplay = formatDurationCoverage(
+  const totalDurationDisplay = displayDuration(
     suppliedTotals?.duration ?? {
       known_sum: totals.durationKnownMs,
       unknown: totals.durationPartial ? 1 : 0,
@@ -667,14 +596,12 @@ export function CostGroupsTable({
       // factual known sum. Individual rows retain their original provenance.
       coverage_ratio: totals.durationPartial ? 0 : 1,
     },
-    locale,
   );
-  const totalTokensDisplay = formatAuditableCompactNumber(totals.tokens, locale);
-  const totalCostDisplay = formatAuditableCurrency(
-    currency === "BRL" ? totals.brl : totals.usd,
-    currency,
+  const totalTokensDisplay = formatAuditableCompactNumber(
+    showModelLifecycleDetails ? (totals.tokens ?? 0) : totals.tokens,
     locale,
   );
+  const totalCostDisplay = displayCurrency(currency === "BRL" ? totals.brl : totals.usd);
   const totalAriaLabel = costPeriodTotalAriaLabel({
     locale,
     duration: totalDurationDisplay,
@@ -729,7 +656,7 @@ export function CostGroupsTable({
           sortValue: (row) => row.key,
           footer: showDateTime ? undefined : <output aria-label={totalLabel}>Total</output>,
         },
-        ...(period === undefined
+        ...(period === undefined && !showAgentIdentity && !showModelLifecycleDetails
           ? [
               {
                 key: "runs",
@@ -761,79 +688,165 @@ export function CostGroupsTable({
               {
                 key: "prds",
                 label: "PRDs",
-                render: (row: CostGroupRow) => row.prd_count,
+                render: (row: CostGroupRow) => displayCount(row.prd_count),
+                sortValue: (row: CostGroupRow) => row.prd_count ?? 0,
                 align: "right" as const,
-                footer: totals.prds,
+                footer: displayCount(totals.prds),
+                description: localizedDescription(
+                  locale,
+                  showAgentIdentity
+                    ? "PRDs com criação atribuída ao agente por Run registrado. Conta apenas vínculos observados, sem duplicar IDs."
+                    : "PRDs criados por vínculo canônico com um único modelo financeiro observado. Sem essa prova, o indicador exibido é 0.",
+                  "PRDs created through a canonical link to one observed financial model. Without that evidence, the displayed indicator is 0.",
+                ),
               },
               {
                 key: "specs",
                 label: "SPECs",
-                render: (row: CostGroupRow) => row.spec_count,
+                render: (row: CostGroupRow) => displayCount(row.spec_count),
+                sortValue: (row: CostGroupRow) => row.spec_count ?? 0,
                 align: "right" as const,
-                footer: totals.specs,
+                footer: displayCount(totals.specs),
+                description: localizedDescription(
+                  locale,
+                  showAgentIdentity
+                    ? "SPECs com criação atribuída ao agente por Run registrado. Conta apenas vínculos observados, sem duplicar IDs."
+                    : "SPECs criadas por vínculo canônico com um único modelo financeiro observado. Sem essa prova, o indicador exibido é 0.",
+                  "SPECs created through a canonical link to one observed financial model. Without that evidence, the displayed indicator is 0.",
+                ),
               },
               {
                 key: "tasks",
-                label: locale === "pt-BR" ? "Tarefas criadas" : "Tasks created",
-                render: (row: CostGroupRow) => row.task_count ?? 0,
+                label: showAgentIdentity
+                  ? locale === "pt-BR"
+                    ? "Tarefas"
+                    : "Tasks"
+                  : showModelLifecycleDetails
+                    ? "Tasks"
+                    : locale === "pt-BR"
+                      ? "Tarefas criadas"
+                      : "Tasks created",
+                render: (row: CostGroupRow) => displayCount(row.task_count),
+                sortValue: (row: CostGroupRow) => row.task_count ?? 0,
                 align: "right" as const,
-                footer: totals.tasks,
+                footer: displayCount(totals.tasks),
+                description: localizedDescription(
+                  locale,
+                  showAgentIdentity
+                    ? "Tasks distintas em que o agente participou no período. Uma Task pode contar em vários agentes; o total soma essas participações entre agentes. Sem participação, mostra 0."
+                    : "Tasks contam apenas quando creation_run_id tem um único modelo financeiro observável. Participação posterior não é criação; ausência ou multi-modelo exibe 0.",
+                  "Tasks count only when creation_run_id has one observed financial model. Later participation is not creation; missing or multi-model linkage displays 0.",
+                ),
               },
+              ...(showModelLifecycleDetails
+                ? [
+                    {
+                      key: "conversations",
+                      label: "Conversations",
+                      render: (row: CostGroupRow) => displayCount(conversationCount(row)),
+                      sortValue: (row: CostGroupRow) => conversationCount(row) ?? 0,
+                      align: "right" as const,
+                      footer: displayCount(totals.conversations),
+                      description: localizedDescription(
+                        locale,
+                        "Conversas canônicas, incluindo turns unassisted legados. Cada ID conta uma vez por modelo; um modelo múltiplo pode repetir. Run com Task e conversa de origem não cria Task adicional.",
+                        "Canonical conversations, including legacy unassisted turns. Each ID counts once per model; a multi-model conversation may repeat. A Run with a Task and source conversation does not create an additional Task.",
+                      ),
+                    },
+                  ]
+                : []),
               {
                 key: "runs",
                 label: "Runs",
                 render: (row: CostGroupRow) => row.run_count,
+                sortValue: (row: CostGroupRow) => row.run_count,
                 align: "right" as const,
                 footer: totals.runs,
+                description: localizedDescription(
+                  locale,
+                  showAgentIdentity
+                    ? "Chamadas observadas atribuídas ao agente no período selecionado."
+                    : "Runs financeiros observados neste modelo, sem distribuir ou duplicar custo, tokens e tempo entre modelos.",
+                  "Observed financial Runs for this model, without allocating or duplicating cost, tokens, or time across models.",
+                ),
               },
               {
                 key: "tests",
                 label: locale === "pt-BR" ? "Testes" : "Tests",
-                render: (row: CostGroupRow) => row.test_count,
+                render: (row: CostGroupRow) => displayCount(row.test_count),
+                sortValue: (row: CostGroupRow) => row.test_count ?? 0,
                 align: "right" as const,
-                footer: totals.tests,
+                footer: displayCount(totals.tests),
+                description: localizedDescription(
+                  locale,
+                  showAgentIdentity
+                    ? "Registros de testes distintos vinculados ao Run do agente no período. Revisões e outras validações não são contadas como testes."
+                    : "Validações canônicas cuja artifact_run_id coincide com a Run registradora deste modelo; ausência de prova exibe 0.",
+                  "Canonical validations whose artifact_run_id matches this model's registering Run; missing evidence displays 0.",
+                ),
               },
               {
                 key: "evidences",
                 label: locale === "pt-BR" ? "Evidências" : "Evidence",
-                render: (row: CostGroupRow) => row.evidence_count,
+                render: (row: CostGroupRow) => displayCount(row.evidence_count),
+                sortValue: (row: CostGroupRow) => row.evidence_count ?? 0,
                 align: "right" as const,
-                footer: totals.evidences,
+                footer: displayCount(totals.evidences),
+                description: localizedDescription(
+                  locale,
+                  showAgentIdentity
+                    ? "Evidências distintas vinculadas ao Run do agente no período. Conta apenas vínculos registrados."
+                    : "Evidências canônicas cuja artifact_run_id coincide com a Run registradora deste modelo; o total não duplica a mesma evidência. Sem prova, exibe 0.",
+                  "Canonical evidence whose artifact_run_id matches this model's registering Run; the total does not duplicate the same evidence. Missing proof displays 0.",
+                ),
               },
             ]),
         {
           key: "duration",
           label: "Tempo",
-          render: (row) => formatTokenBackedDuration(row.duration, row.total_tokens, locale),
-          sortValue: (row) => (hasKnownDuration(row.duration) ? row.duration.known_sum : null),
+          render: (row) => displayDuration(row.duration),
+          sortValue: (row) =>
+            hasKnownDuration(row.duration)
+              ? row.duration.known_sum
+              : showModelLifecycleDetails
+                ? 0
+                : null,
           align: "right",
           footer: <output aria-label={totalAriaLabel}>{totalDurationDisplay}</output>,
         },
         {
           key: "tokens",
           label: "Tokens",
-          render: (row) => formatAuditableCompactNumber(row.total_tokens, locale),
-          sortValue: (row) => row.total_tokens,
+          render: (row) =>
+            formatAuditableCompactNumber(
+              showModelLifecycleDetails ? (row.total_tokens ?? 0) : row.total_tokens,
+              locale,
+            ),
+          sortValue: (row) =>
+            showModelLifecycleDetails ? (row.total_tokens ?? 0) : row.total_tokens,
           align: "right",
           footer: <output aria-label={totalAriaLabel}>{totalTokensDisplay}</output>,
         },
         {
           key: "cost",
           label:
-            period === undefined
+            showAgentIdentity || showModelLifecycleDetails || period !== undefined
               ? locale === "pt-BR"
-                ? "Custo"
-                : "Cost"
-              : locale === "pt-BR"
                 ? "Custos"
-                : "Costs",
+                : "Costs"
+              : period === undefined
+                ? locale === "pt-BR"
+                  ? "Custo"
+                  : "Cost"
+                : locale === "pt-BR"
+                  ? "Custos"
+                  : "Costs",
           render: (row) =>
-            formatAuditableCurrency(
-              currency === "BRL" ? row.estimated_brl : row.estimated_usd,
-              currency,
-              locale,
-            ),
-          sortValue: (row) => sortCostValue(currency, row.estimated_brl, row.estimated_usd),
+            displayCurrency(currency === "BRL" ? row.estimated_brl : row.estimated_usd),
+          sortValue: (row) =>
+            showModelLifecycleDetails
+              ? (sortCostValue(currency, row.estimated_brl, row.estimated_usd) ?? 0)
+              : sortCostValue(currency, row.estimated_brl, row.estimated_usd),
           align: "right",
           footer: <output aria-label={totalAriaLabel}>{totalCostDisplay}</output>,
         },

package/templates/.agents/dashboard/modules/cost-monitor/src/react/InvocationManifestQuery.test.ts

@@ -0,0 +1,145 @@
+import { createHash } from "node:crypto";
+import { queryInvocationManifestPeriod } from "@zaip-ai/costs";
+import { describe, expect, it } from "vitest";
+
+describe("manifest-first invocation query", () => {
+  it("opens only intersecting monthly manifests and candidate chunks", async () => {
+    const inRange = signedSummary({
+      agent_invocation_id: "RUN-JULY-OPENAI",
+      occurred_at: "2026-07-10T12:00:00.000Z",
+      provider: "openai",
+    });
+    const outOfRange = signedSummary({
+      agent_invocation_id: "RUN-JULY-ANTHROPIC",
+      occurred_at: "2026-07-20T12:00:00.000Z",
+      provider: "anthropic",
+    });
+    const firstChunk = `${JSON.stringify(inRange)}\n`;
+    const secondChunk = `${JSON.stringify(outOfRange)}\n`;
+    const manifest = signedManifest({
+      period: { year: 2026, month: 7 },
+      from: "2026-07-10T12:00:00.000Z",
+      to: "2026-07-20T12:00:00.000Z",
+      chunks: [
+        {
+          path: ".agents/records/telemetry/2026/07/chunk-openai.jsonl",
+          content_sha256: digest(firstChunk),
+          summary_count: 1,
+          from: inRange.occurred_at,
+          to: inRange.occurred_at,
+          summary_hashes: [inRange.summary_hash],
+          dimensions: dimensions({ providers: ["openai"] }),
+        },
+        {
+          path: ".agents/records/telemetry/2026/07/chunk-anthropic.jsonl",
+          content_sha256: digest(secondChunk),
+          summary_count: 1,
+          from: outOfRange.occurred_at,
+          to: outOfRange.occurred_at,
+          summary_hashes: [outOfRange.summary_hash],
+          dimensions: dimensions({ providers: ["anthropic"] }),
+        },
+      ],
+    });
+    const reads: string[] = [];
+    const openaiChunkPath = manifest.chunks[0]?.path;
+    const anthropicChunkPath = manifest.chunks[1]?.path;
+    if (openaiChunkPath === undefined || anthropicChunkPath === undefined)
+      throw new Error("Expected two manifest chunks");
+    const files = new Map<string, string>([
+      [".agents/records/telemetry/2026/07/manifest.json", JSON.stringify(manifest)],
+      [openaiChunkPath, firstChunk],
+      [anthropicChunkPath, secondChunk],
+    ]);
+    const result = await queryInvocationManifestPeriod(
+      {
+        exists: async (path) => files.has(path),
+        readText: async (path) => {
+          reads.push(path);
+          const value = files.get(path);
+          if (value === undefined) throw new Error(`Missing fixture: ${path}`);
+          return value;
+        },
+      },
+      { from: "2026-07-09", to: "2026-07-11", filters: { providers: ["openai"] } },
+    );
+    expect(result.summaries.map((summary) => summary.agent_invocation_id)).toEqual([
+      "RUN-JULY-OPENAI",
+    ]);
+    expect(result.manifest_count).toBe(1);
+    expect(result.chunk_count).toBe(1);
+    expect(result.source_latest_at).toBe("2026-07-20T12:00:00.000Z");
+    expect(result.lag_ms).toBe(10);
+    expect(reads).toEqual([".agents/records/telemetry/2026/07/manifest.json", openaiChunkPath]);
+  });
+});
+
+function digest(value: string): string {
+  return createHash("sha256").update(value).digest("hex");
+}
+function dimensions(overrides: Partial<Record<string, readonly string[]>> = {}) {
+  return {
+    providers: [],
+    models: [],
+    zaip_agents: [],
+    phases: [],
+    purposes: [],
+    statuses: [],
+    executions: [],
+    tasks: [],
+    specs: [],
+    prds: [],
+    changes: [],
+    ...overrides,
+  };
+}
+function signedSummary(input: {
+  agent_invocation_id: string;
+  occurred_at: string;
+  provider: string;
+}) {
+  const unsigned = {
+    schema_version: 1,
+    agent_invocation_id: input.agent_invocation_id,
+    occurred_at: input.occurred_at,
+    coverage: "complete",
+    usage_segments: [{ provider: input.provider, model: "gpt-5.6-terra" }],
+  };
+  return { ...unsigned, summary_hash: digest(JSON.stringify(unsigned)) };
+}
+function signedManifest(input: {
+  period: { year: number; month: number };
+  from: string;
+  to: string;
+  chunks: Array<{
+    path: string;
+    content_sha256: string;
+    summary_count: number;
+    from: string;
+    to: string;
+    summary_hashes: string[];
+    dimensions: ReturnType<typeof dimensions>;
+  }>;
+}) {
+  const unsigned = {
+    schema_version: 1,
+    period: input.period,
+    summary_count: input.chunks.reduce((sum, chunk) => sum + chunk.summary_count, 0),
+    chunk_count: input.chunks.length,
+    from: input.from,
+    to: input.to,
+    source_latest_at: input.to,
+    lag_ms: 10,
+    coverage: { complete: 2, partial: 0, unavailable: 0 },
+    chunks: input.chunks,
+    dimensions: dimensions(),
+    aggregates: { daily: {}, monthly: {}, annual: {} },
+    integrity: {
+      status: "verified",
+      algorithm: "sha256",
+      chunk_count: input.chunks.length,
+      summary_count: input.chunks.reduce((sum, chunk) => sum + chunk.summary_count, 0),
+    },
+  };
+  return { ...unsigned, manifest_hash: digest(JSON.stringify(unsigned)) };
+}

package/templates/.agents/dashboard/modules/cost-monitor/src/react/period-cost-groups.ts

@@ -78,18 +78,19 @@ export function enrichPeriodCostGroups(
 
   for (const prd of entities.prds) {
     const bucket = bucketFor(prd.created_at);
-    if (bucket !== null) bucket.prd_count += 1;
+    if (bucket !== null) bucket.prd_count = (bucket.prd_count ?? 0) + 1;
   }
   for (const spec of entities.specs) {
     const bucket = bucketFor(spec.created_at);
-    if (bucket !== null) bucket.spec_count += 1;
+    if (bucket !== null) bucket.spec_count = (bucket.spec_count ?? 0) + 1;
   }
   for (const task of entities.tasks) {
     const bucket = bucketFor(task.created_at);
     if (bucket === null) continue;
     bucket.task_count = (bucket.task_count ?? 0) + 1;
     bucket.tasksCreated = (bucket.tasksCreated ?? 0) + 1;
-    if (entities.validations === undefined) bucket.test_count += task.test_count ?? 0;
+    if (entities.validations === undefined)
+      bucket.test_count = (bucket.test_count ?? 0) + (task.test_count ?? 0);
     const ids = evidenceIds.get(bucket.key) ?? new Set<string>();
     for (const evidenceId of task.result?.evidence_ids ?? [])
       if (!typedEvidenceIds.has(evidenceId)) ids.add(evidenceId);
@@ -129,8 +130,9 @@ export function summarizeCostPeriodAverages(
   return {
     tasks:
       divisor === 0 ? null : rows.reduce((sum, row) => sum + (row.task_count ?? 0), 0) / divisor,
-    specs: divisor === 0 ? null : rows.reduce((sum, row) => sum + row.spec_count, 0) / divisor,
-    prds: divisor === 0 ? null : rows.reduce((sum, row) => sum + row.prd_count, 0) / divisor,
+    specs:
+      divisor === 0 ? null : rows.reduce((sum, row) => sum + (row.spec_count ?? 0), 0) / divisor,
+    prds: divisor === 0 ? null : rows.reduce((sum, row) => sum + (row.prd_count ?? 0), 0) / divisor,
     durationMs: averagePerPeriod(
       rows.map((row) => row.duration_ms),
       divisor,

package/templates/.agents/dashboard/modules/cost-monitor/src/react/use-compact-cost-page.ts

@@ -44,6 +44,7 @@ export function useCompactCostPage({
   range,
   query,
   filters,
+  revision,
 }: {
   view: CostView;
   load: LoadCompactCostPage | undefined;
@@ -51,6 +52,8 @@ export function useCompactCostPage({
   range: { from: string; to: string } | undefined;
   query: string | undefined;
   filters: CostFilterState;
+  /** Changes when the host promotes a new immutable dashboard snapshot. */
+  revision: number;
 }) {
   const [offset, setOffset] = useState(0);
   const [page, setPage] = useState<CompactLifecycleCostPage | null>(null);
@@ -66,7 +69,7 @@ export function useCompactCostPage({
   const rangeTo = range?.to;
   const filterKey = Object.values(filters).join("\u0000");
   const paginationKey = `${view}\u0000${limit}\u0000${query ?? ""}\u0000${rangeFrom ?? ""}\u0000${rangeTo ?? ""}\u0000${filterKey}`;
-  const requestKey = `${paginationKey}\u0000${offset}`;
+  const requestKey = `${paginationKey}\u0000${offset}\u0000${revision}`;
   const requestInputRef = useRef({ filters, limit, query, rangeFrom, rangeTo });
   requestInputRef.current = { filters, limit, query, rangeFrom, rangeTo };
   useEffect(() => {

package/templates/.agents/dashboard/modules/cost-monitor/src/react/use-cost-group-page.ts

@@ -98,6 +98,7 @@ export function useCostGroupPage({
   globalQuery,
   limit = 50,
   filters,
+  revision,
   load,
 }: {
   active?: boolean;
@@ -106,6 +107,8 @@ export function useCostGroupPage({
   globalQuery: string;
   limit?: number;
   filters: CostGroupFilters;
+  /** Changes when the host promotes a new immutable dashboard snapshot. */
+  revision: number;
   load?: LoadCostGroupPage;
 }) {
   const [offset, setOffset] = useState(0);
@@ -120,7 +123,7 @@ export function useCostGroupPage({
   const query = effectiveCostGroupQuery(filters, globalQuery);
   const filterKey = `${Object.values(filters).join("\u0000")}\u0000${query}`;
   const paginationKey = `${view}\u0000${limit}\u0000${range?.from ?? ""}\u0000${range?.to ?? ""}\u0000${filterKey}`;
-  const requestKey = `${paginationKey}\u0000${offset}`;
+  const requestKey = `${paginationKey}\u0000${offset}\u0000${revision}`;
   const requestInputRef = useRef({ filters, limit, query, range, view });
   requestInputRef.current = { filters, limit, query, range, view };
   useEffect(() => {