@zaip-ai/cli 2.2.0 → 3.0.0

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.test.ts

@@ -5,17 +5,17 @@ import {
   executionMetricTotals,
   operationalRootExecutionDuration,
 } from "./execution-metrics.js";
+import { overviewCostForRates, overviewCostRateHint } from "./OperationsOverview.helpers.js";
 import {
   aggregateMacroMetrics,
   aggregateTaskMetrics,
   countExecutionDays,
-  findLatestCreatedAt,
-  findLatestTaskCreatedAt,
+  factualCostAverageLabel,
+  factualCostMetricHint,
+  factualCostMetricLabel,
   formatExecutionAverageHint,
   formatSummaryMetricValue,
   formatTokenThroughputHint,
-  macroClassificationStats,
-  macroStatusDistribution,
   overviewMetricAverages,
   overviewText,
   partialOverviewMetrics,
@@ -25,14 +25,39 @@ import {
   selectTopEntities,
   statusColors,
   summarizeTopEntityMetrics,
-  summarizeTopTaskMetrics,
   taskMetricAverages,
   taskStatusDistribution,
 } from "./OperationsOverview.js";
 
 const readOverviewSource = (file = "OperationsOverview.tsx") =>
   readFileSync(new URL(file, import.meta.url), "utf8");
-
+function run(
+  taskId: string | null,
+  durationMs: number,
+  tokens: number,
+  costBrl: number,
+  links: { id?: string; specId?: string | null; prdId?: string | null } = {},
+) {
+  return {
+    id: links.id ?? `RUN-${taskId ?? "NONE"}-${durationMs}`,
+    phase: "execution",
+    task_id: taskId,
+    parent_run_id: null,
+    spec_id: links.specId ?? null,
+    prd_id: links.prdId ?? null,
+    duration_ms: durationMs,
+    usage: { total: { tokens: { total: tokens }, cost: { brl: costBrl } } },
+  };
+}
+function entityMetric(
+  id: string,
+  durationMs: number | null,
+  tokens: number | null,
+  costBrl: number | null,
+  runCount: number,
+) {
+  return { id, title: id, durationMs, tokens, costBrl, runCount };
+}
 describe("global card population", () => {
   it("includes conversation and planning usage but excludes them from duration", () => {
     const runs = [
@@ -43,7 +68,6 @@ describe("global card population", () => {
     expect(executionMetricTotals(runs)).toMatchObject({ durationMs: 100, tokens: 10, costBrl: 1 });
     expect(allPhaseMetricTotals(runs)).toMatchObject({ tokens: 60, costBrl: 6 });
   });
-
   it("uses the same observed execution population as period tables, never lifecycle elapsed time", () => {
     const root = {
       ...run("TASK-1", 100, 10, 1),
@@ -63,7 +87,6 @@ describe("global card population", () => {
     expect(operationalRootExecutionDuration([root, child])).toBeNull();
     expect(executionMetricTotals([root, child])).toMatchObject({ durationMs: null });
   });
-
   it("keeps delegated Sub-Run duration out of Operations root execution totals", () => {
     const root = {
       ...run("TASK-1", 99, 1, 1),
@@ -86,7 +109,6 @@ describe("global card population", () => {
     expect(totals.durationMs).toBe(4 * 3_600_000);
     expect(totals.runs.map((run) => run.id)).toEqual(["RUN-ROOT-OBS", "RUN-ESTIMATED"]);
   });
-
   it("uses observed source duration instead of a projected duration", () => {
     const staleObserved = {
       ...run("TASK-1", 413_659_026, 10, 1),
@@ -110,6 +132,61 @@ describe("partial overview charts", () => {
   });
 });
 describe("overview aggregate source", () => {
+  it("allocates known spend without imputing unknown costs and labels partial coverage", () => {
+    const fact = { state: "partial", knownSum: 12.5, coverage: { known: 3, total: 5 } } as const;
+    expect(factualCostMetricLabel(fact, "pt-BR")).toBe("Custo Estimado");
+    expect(factualCostMetricHint(fact, "tarefa", "pt-BR")).toContain("3 de 5 runs");
+    expect(factualCostAverageLabel(fact, 2, "pt-BR")).toContain("cobertura parcial (3/5 runs)");
+    expect(overviewCostForRates(fact, 12.5)).toBe(12.5);
+    expect(overviewCostForRates({ ...fact, knownSum: 0 }, 0)).toBe(0);
+    expect(
+      overviewCostForRates({ ...fact, state: "complete", coverage: { known: 5, total: 5 } }, 0),
+    ).toBe(0);
+    expect(overviewCostRateHint(fact, "tarefa", "pt-BR", "BRL", 2, null, null)).toBe(
+      "— / tarefa (— / hora)",
+    );
+    expect(
+      resolveOverviewCostTotal({
+        currency: "BRL",
+        factualSnapshotFact: fact,
+        factualSnapshotTotal: null,
+        overviewView: "tasks",
+        resolvedRunTotal: 99,
+        operationsBrlTotal: 99,
+      }),
+    ).toBe(12.5);
+    const source = readOverviewSource();
+    const costCard = readOverviewSource("OverviewCostKpi.tsx");
+    expect(costCard).toContain("factualCostMetricLabel(fact, locale)");
+    expect(costCard).toContain("overviewCostRateHint(");
+    expect(source).toContain("factualCostAverageLabel(");
+  });
+  it("keeps complete zero and unavailable facts distinct", () => {
+    expect(
+      resolveOverviewCostTotal({
+        currency: "USD",
+        factualSnapshotFact: {
+          state: "complete",
+          knownSum: 0,
+          coverage: { known: 0, total: 0 },
+        },
+        factualSnapshotTotal: null,
+        overviewView: "tasks",
+        resolvedRunTotal: 1,
+        operationsBrlTotal: 1,
+      }),
+    ).toBe(0);
+    expect(
+      resolveOverviewCostTotal({
+        currency: "USD",
+        factualSnapshotFact: { state: "unavailable", knownSum: null, coverage: null },
+        factualSnapshotTotal: 1,
+        overviewView: "tasks",
+        resolvedRunTotal: 1,
+        operationsBrlTotal: 1,
+      }),
+    ).toBeNull();
+  });
   it("keeps aggregate-only Top 5 USD factual and leaves a missing value unavailable", () => {
     const source = readOverviewSource();
     const topPanelSource = readOverviewSource("OperationsOverviewTopPanel.tsx");
@@ -118,7 +195,6 @@ describe("overview aggregate source", () => {
     );
     expect(topPanelSource).toContain("topCost === null");
   });
-
   it("uses the factual compact USD summary when its Run rows are intentionally absent", () => {
     expect(
       resolveOverviewCostTotal({
@@ -130,7 +206,6 @@ describe("overview aggregate source", () => {
       }),
     ).toBe(8731.92);
   });
-
   it("does not relabel a BRL-only Operations aggregate as USD", () => {
     expect(
       resolveOverviewCostTotal({
@@ -142,7 +217,17 @@ describe("overview aggregate source", () => {
       }),
     ).toBeNull();
   });
-
+  it("does not replace authoritative unavailable cost with a known-zero partial fallback", () => {
+    expect(
+      resolveOverviewCostTotal({
+        currency: "BRL",
+        factualSnapshotTotal: null,
+        overviewView: "tasks",
+        resolvedRunTotal: 0,
+        operationsBrlTotal: 0,
+      }),
+    ).toBeNull();
+  });
   it("uses a selected macro's factual USD total rather than the global Task snapshot", () => {
     expect(
       resolveOverviewCostTotal({
@@ -155,7 +240,6 @@ describe("overview aggregate source", () => {
       }),
     ).toBe(13.4);
   });
-
   it("keeps summary metrics as the KPI source after a detail response", () => {
     const summary = {
       overview_metrics: {
@@ -180,7 +264,6 @@ describe("overview aggregate source", () => {
       } as never),
     ).toMatchObject({ task_count: 15, spec_count: 15, prd_count: 5 });
   });
-
   it("keeps the global aggregate across Operations, Cost Monitor, and Kanban navigations", () => {
     const partial = partialOverviewMetrics({
       summary: {
@@ -234,14 +317,12 @@ describe("overview aggregate source", () => {
     expect(filteredKanbanTasks.filter((task) => task.risk === "standard")).toHaveLength(157);
   });
 });
-
 describe("execution average summary", () => {
   it("calculates fast overview task averages from the filtered aggregate totals", () => {
     expect(taskMetricAverages({ durationMs: 12_600_000, tokens: 63_000, costBrl: 126 }, 3)).toEqual(
       { durationMs: 4_200_000, tokens: 21_000, costBrl: 42 },
     );
   });
-
   it("keeps aggregate task averages unavailable when the task count is unavailable", () => {
     expect(taskMetricAverages({ durationMs: 12_600_000, tokens: 63_000, costBrl: 126 }, 0)).toEqual(
       {
@@ -251,7 +332,6 @@ describe("execution average summary", () => {
       },
     );
   });
-
   it("uses the summary task count when the fast overview omits task records", () => {
     const source = readOverviewSource();
     const durationCard = source.slice(
@@ -265,7 +345,6 @@ describe("execution average summary", () => {
     expect(durationCard).toContain("metricPopulationCount ?? 0");
     expect(durationCard).not.toContain("tasks.length");
   });
-
   it("formats average duration per task and per active execution day", () => {
     expect(
       countExecutionDays([
@@ -278,7 +357,6 @@ describe("execution average summary", () => {
       "20 min / tarefa (6 h / dia) (6 dias)",
     );
   });
-
   it("localizes English and shows zero for an empty population", () => {
     expect(formatExecutionAverageHint(3_600_000, 3, 1, "en-US")).toBe(
       "20 min / task (1 h / day) (1 day)",
@@ -287,14 +365,12 @@ describe("execution average summary", () => {
     expect(formatExecutionAverageHint(0, 0, 0, "en-US")).toBe("0");
   });
 });
-
 describe("token throughput summary", () => {
   it("formats average tokens per hour and per active day in pt-BR", () => {
     expect(formatTokenThroughputHint(1_911_000_000, 49 * 3_600_000, 7, "pt-BR")).toBe(
       "39 M/hora (273 M/dia)",
     );
   });
-
   it("localizes EN-US and preserves unavailable coverage", () => {
     expect(formatTokenThroughputHint(1_911_000_000, 49 * 3_600_000, 7, "en-US")).toBe(
       "39 M/hour (273 M/day)",
@@ -302,7 +378,6 @@ describe("token throughput summary", () => {
     expect(formatTokenThroughputHint(0, 0, 0, "pt-BR")).toBe("Throughput indisponível");
   });
 });
-
 describe("overviewText", () => {
   it("provides English copy for every shared overview card and summary label", () => {
     expect(overviewText("en-US")).toMatchObject({
@@ -326,7 +401,6 @@ describe("overviewText", () => {
     });
   });
 });
-
 describe("statusColors", () => {
   it("uses the same neutral gray for terminal non-success states", () => {
     expect(statusColors.failed).toBe(statusColors.blocked);
@@ -352,13 +426,12 @@ describe("overviewMetricAverages", () => {
       costBrl: null,
     });
   });
-
   it("keeps unknown totals null internally and renders zero only for an empty population", () => {
     const averages = overviewMetricAverages({ durationMs: null, tokens: null, costBrl: null }, 3);
     expect(averages).toEqual({ durationMs: null, tokens: null, costBrl: null });
     const source = readOverviewSource();
     expect(source).toContain(
-      "durationMs: totalDurationMetric, tokens: totalTokensMetric, costBrl: totalCostMetric",
+      "durationMs: totalDurationMetric, tokens: totalTokensMetric, costBrl: rateCost",
     );
     expect(formatSummaryMetricValue(null, 0, (value) => String(value), "pt-BR")).toBe("0");
     expect(formatSummaryMetricValue(null, 0, (value) => String(value), "en-US")).toBe("0");
@@ -390,7 +463,6 @@ describe("selectedOverviewCount", () => {
     });
   });
 });
-
 describe("aggregateTaskMetrics", () => {
   it("accumulates observed run metrics by task and ignores unlinked runs", () => {
     const metrics = aggregateTaskMetrics(
@@ -420,7 +492,6 @@ describe("aggregateTaskMetrics", () => {
       },
     ]);
   });
-
   it("does not count conversation time as task execution time", () => {
     const metrics = aggregateTaskMetrics(
       [{ id: "TASK-1", title: "Primeira" }],
@@ -434,7 +505,6 @@ describe("aggregateTaskMetrics", () => {
       { id: "TASK-1", title: "Primeira", durationMs: 100, tokens: 110, costBrl: 11, runCount: 1 },
     ]);
   });
-
   it("uses only root execution duration while retaining all related usage", () => {
     const metrics = aggregateTaskMetrics(
       [{ id: "TASK-1", title: "Primeira" }],
@@ -452,7 +522,6 @@ describe("aggregateTaskMetrics", () => {
     });
   });
 });
-
 describe("selectTopEntities", () => {
   it("keeps the complete selected SPEC population, ordering observed duration before unavailable", () => {
     const selected = selectTopEntities([
@@ -474,7 +543,6 @@ describe("selectTopEntities", () => {
     ]);
     expect(summarizeTopEntityMetrics(selected, selected).durationMs).toBe(500);
   });
-
   it("retains four selected SPEC entries when only one has observed duration", () => {
     const selected = selectTopEntities([
       entityMetric("SPEC-OBSERVED", 600, 10, 1, 1),
@@ -496,7 +564,6 @@ describe("selectTopEntities", () => {
       costBrl: 4,
     });
   });
-
   it("keeps all-unavailable selected SPECs and reports duration as unavailable, never zero", () => {
     const selected = selectTopEntities([
       entityMetric("SPEC-A", null, 4, 1, 1),
@@ -515,7 +582,6 @@ describe("selectTopEntities", () => {
     expect(source).toContain("duration(summary.durationMs, locale)");
   });
 });
-
 describe("aggregateMacroMetrics", () => {
   it("uses the materialized macro duration instead of partial Run rows", () => {
     const [metric] = aggregateMacroMetrics(
@@ -556,7 +622,6 @@ describe("aggregateMacroMetrics", () => {
       runCount: 4,
     });
   });
-
   it("keeps related metrics populated when the overview switches from Tasks to SPECs to PRDs", () => {
     const tasks = [{ id: "TASK-1" }, { id: "TASK-2" }];
     const specs = [{ id: "SPEC-1", title: "SPEC", kind: "spec", run_ids: ["RUN-SPEC"] }];
@@ -580,7 +645,6 @@ describe("aggregateMacroMetrics", () => {
     expect(specMetrics[0]).toMatchObject({ durationMs: 200, tokens: 20, costBrl: 2, runCount: 1 });
     expect(prdMetrics[0]).toMatchObject({ durationMs: 300, tokens: 30, costBrl: 3, runCount: 1 });
   });
-
   it("aggregates only Runs linked to each macro and honors resolved costs", () => {
     const metrics = aggregateMacroMetrics(
       [{ id: "SPEC-1", title: "Planejamento", kind: "spec", run_ids: ["RUN-DECLARED"] }],
@@ -607,245 +671,3 @@ describe("aggregateMacroMetrics", () => {
     ]);
   });
 });
-
-describe("macroClassificationStats", () => {
-  it("keeps structure classes mutually exclusive", () => {
-    const stats = macroClassificationStats(
-      [
-        { task_count: 0, rework_run_count: 0 },
-        { task_count: 0, rework_run_count: 2 },
-        { task_count: 2, rework_run_count: 0 },
-        { task_count: 3, rework_run_count: 1 },
-      ],
-      "pt-BR",
-    );
-
-    expect(stats.map(({ key, label, count }) => ({ key, label, count }))).toEqual([
-      { key: "empty", label: "Sem tarefas", count: 1 },
-      { key: "structured", label: "Com tarefas", count: 1 },
-      { key: "rework", label: "Com retrabalho", count: 2 },
-    ]);
-    expect(stats.reduce((total, row) => total + row.count, 0)).toBe(4);
-  });
-});
-
-describe("taskStatusDistribution", () => {
-  it("includes cancelled and failed statuses with the other task states", () => {
-    const distribution = taskStatusDistribution(
-      [
-        { status: "draft", spec_id: "SPEC-1" },
-        { status: "planned", spec_id: "SPEC-1" },
-        { status: "draft", spec_id: null },
-        {
-          status: "planned",
-          spec_id: null,
-          attempt_count: 0,
-          started_at: null,
-          execution_started: false,
-        },
-        { status: "executing", spec_id: null },
-        { status: "verifying", spec_id: null },
-        { status: "completed", spec_id: null },
-        { status: "blocked", spec_id: null },
-        { status: "cancelled", spec_id: null },
-        { status: "failed", spec_id: null },
-      ],
-      "pt-BR",
-    );
-
-    expect(distribution.map(({ key, label, count }) => ({ key, label, count }))).toEqual([
-      { key: "definition", label: "Definição (PRD + Requisitos)", count: 2 },
-      { key: "planning", label: "Planejamento (SPEC + Change)", count: 0 },
-      { key: "ready", label: "Pronto para Executar", count: 2 },
-      { key: "executing", label: "Execução", count: 1 },
-      { key: "verifying", label: "Verificação", count: 1 },
-      { key: "completed", label: "Concluído", count: 1 },
-      { key: "blocked", label: "Bloqueado", count: 1 },
-      { key: "cancelled", label: "Cancelado", count: 1 },
-      { key: "failed", label: "Falhado", count: 1 },
-    ]);
-  });
-
-  it("includes cancelled and failed statuses in the visible total", () => {
-    const visible = taskStatusDistribution(
-      [
-        { status: "draft", spec_id: "SPEC-1" },
-        { status: "planned", spec_id: "SPEC-1" },
-        {
-          status: "planned",
-          spec_id: null,
-          attempt_count: 0,
-          started_at: null,
-          execution_started: false,
-        },
-        { status: "completed", spec_id: null },
-        { status: "executing", spec_id: null },
-        { status: "blocked", spec_id: null },
-        { status: "failed", spec_id: null },
-        { status: "cancelled", spec_id: null },
-      ],
-      "pt-BR",
-    );
-
-    expect(visible.map(({ key, count }) => ({ key, count }))).toEqual([
-      { key: "definition", count: 1 },
-      { key: "planning", count: 0 },
-      { key: "ready", count: 2 },
-      { key: "executing", count: 1 },
-      { key: "verifying", count: 0 },
-      { key: "completed", count: 1 },
-      { key: "blocked", count: 1 },
-      { key: "cancelled", count: 1 },
-      { key: "failed", count: 1 },
-    ]);
-    expect(visible.reduce((total, item) => total + item.count, 0)).toBe(8);
-  });
-});
-
-describe("macroStatusDistribution", () => {
-  it("includes every macro status so the distribution totals match the macro card", () => {
-    const macros = [
-      { kind: "spec", lifecycle_status: "draft", work_status: "planning" },
-      { kind: "prd", lifecycle_status: "completed", work_status: "completed" },
-      { kind: "spec", lifecycle_status: "failed", work_status: "failed" },
-      { kind: "prd", lifecycle_status: "blocked", work_status: "blocked" },
-      { kind: "spec", lifecycle_status: "cancelled", work_status: "cancelled" },
-    ];
-    const macroCount = macros.length;
-
-    const visible = macroStatusDistribution(macros as never, [], "pt-BR");
-
-    expect(visible.map(({ key, count }) => ({ key, count }))).toEqual([
-      { key: "definition", count: 0 },
-      { key: "planning", count: 1 },
-      { key: "ready", count: 0 },
-      { key: "executing", count: 0 },
-      { key: "verifying", count: 0 },
-      { key: "completed", count: 1 },
-      { key: "blocked", count: 1 },
-      { key: "cancelled", count: 1 },
-      { key: "failed", count: 1 },
-    ]);
-    expect(visible.reduce((total, item) => total + item.count, 0)).toBe(macroCount);
-  });
-});
-
-describe("findLatestTaskCreatedAt", () => {
-  it("selects the newest task regardless of lifecycle status", () => {
-    expect(
-      findLatestTaskCreatedAt([
-        { created_at: "2026-07-16T10:00:00.000Z" },
-        { created_at: "2026-07-16T12:30:00.000Z" },
-        { created_at: "2026-07-16T11:00:00.000Z" },
-      ]),
-    ).toBe("2026-07-16T12:30:00.000Z");
-  });
-
-  it("returns null when no valid task date exists", () => {
-    expect(findLatestTaskCreatedAt([])).toBeNull();
-    expect(findLatestTaskCreatedAt([{ created_at: "invalid" }])).toBeNull();
-  });
-});
-
-describe("findLatestCreatedAt", () => {
-  it("supports nullable macro dates", () => {
-    expect(
-      findLatestCreatedAt([{ created_at: null }, { created_at: "2026-07-16T10:00:00.000Z" }]),
-    ).toBe("2026-07-16T10:00:00.000Z");
-  });
-});
-
-describe("summarizeTopEntityMetrics", () => {
-  it("summarizes the top entities against the selected entity total", () => {
-    const first = entityMetric("ONE", 100, 10, 1, 1);
-    const second = entityMetric("TWO", 300, 30, 3, 2);
-    expect(summarizeTopEntityMetrics([second], [first, second])).toEqual({
-      durationMs: 300,
-      durationShare: 0.75,
-      runCount: 2,
-      tokens: 30,
-      costBrl: 3,
-    });
-  });
-});
-
-describe("summarizeTopTaskMetrics", () => {
-  it("summarizes the selected tasks against all measured run duration", () => {
-    const runs = [run("TASK-1", 100, 10, 1), run("TASK-2", 200, 20, 2), run("TASK-3", 300, 30, 3)];
-
-    expect(
-      summarizeTopTaskMetrics(
-        [
-          { id: "TASK-1", durationMs: 100 },
-          { id: "TASK-2", durationMs: 200 },
-        ],
-        runs,
-      ),
-    ).toEqual({ durationMs: 300, durationShare: 0.5, runCount: 2, tokens: 30, costBrl: 3 });
-  });
-
-  it("keeps tokens and cost unavailable when no related run has coverage", () => {
-    expect(
-      summarizeTopTaskMetrics(
-        [{ id: "TASK-1", durationMs: 100 }],
-        [
-          {
-            ...run("TASK-1", 100, 0, 0),
-            usage: { total: { tokens: { total: null }, cost: { brl: null } } },
-          },
-        ],
-      ),
-    ).toMatchObject({ tokens: null, costBrl: null });
-  });
-
-  it("uses root execution duration but all related phases for top-task usage", () => {
-    const root = run("TASK-1", 2_000, 10, 1, { id: "RUN-ROOT" });
-    const child = {
-      ...run("TASK-1", 1_000, 20, 2, { id: "RUN-CHILD" }),
-      parent_run_id: "RUN-ROOT",
-    };
-    const conversation = {
-      ...run("TASK-1", 9_000, 30, 3, { id: "RUN-CONVERSATION" }),
-      phase: "conversation",
-    };
-
-    expect(
-      summarizeTopTaskMetrics([{ id: "TASK-1", durationMs: 2_000 }], [root, child, conversation]),
-    ).toEqual({
-      durationMs: 2_000,
-      durationShare: 1,
-      runCount: 3,
-      tokens: 60,
-      costBrl: 6,
-    });
-  });
-});
-
-function run(
-  taskId: string | null,
-  durationMs: number,
-  tokens: number,
-  costBrl: number,
-  links: { id?: string; specId?: string | null; prdId?: string | null } = {},
-) {
-  return {
-    id: links.id ?? `RUN-${taskId ?? "NONE"}-${durationMs}`,
-    phase: "execution",
-    task_id: taskId,
-    parent_run_id: null,
-    spec_id: links.specId ?? null,
-    prd_id: links.prdId ?? null,
-    duration_ms: durationMs,
-    usage: { total: { tokens: { total: tokens }, cost: { brl: costBrl } } },
-  };
-}
-
-function entityMetric(
-  id: string,
-  durationMs: number | null,
-  tokens: number | null,
-  costBrl: number | null,
-  runCount: number,
-) {
-  return { id, title: id, durationMs, tokens, costBrl, runCount };
-}