@zaip-ai/cli 2.6.0 → 3.1.0

package/templates/.agents/dashboard/modules/operations/src/react/operations-overview-period-filter.test.ts

@@ -51,13 +51,30 @@ describe("overview period filter", () => {
     expect(shouldRenderOperationsContent(true)).toBe(false);
   });
 
-  it("synchronizes the controlled All Time display after factual cost coverage arrives", () => {
+  it("derives All Time coverage without dispatching a selection or replacing bounded input", () => {
     const source = readFileSync(new URL("OperationsPage.tsx", import.meta.url), "utf8");
-
-    expect(source).toContain('datePreset !== "all"');
-    expect(source).toContain("dateRange.start === defaultDateRange.start");
-    expect(source).toContain('updatePeriod("all", defaultDateRange);');
-    expect(source).toContain("requestPeriodForOperations still omits both bounds");
+    const input = {
+      datePreset: "all" as const,
+      dateRange: { start: "2026-09-01", end: "2026-09-10" },
+      fallbackPreset: "all" as const,
+      fallbackRange: { start: "2026-09-10", end: "2026-09-10" },
+    };
+    const coverage = { start: "2026-06-02", end: "2026-09-10" };
+    expect(resolveOperationsPeriodControl({ ...input, allTimeRange: coverage })).toEqual({
+      controlled: true,
+      datePreset: "all",
+      dateRange: coverage,
+    });
+    expect(
+      resolveOperationsPeriodControl({
+        ...input,
+        datePreset: "this-month",
+        allTimeRange: coverage,
+      }),
+    ).toEqual({ controlled: true, datePreset: "this-month", dateRange: input.dateRange });
+    expect(input.datePreset).toBe("all");
+    expect(source).toContain("allTimeRange: defaultDateRange");
+    expect(source).not.toContain('updatePeriod("all", defaultDateRange)');
   });
 
   it("derives all big-number KPIs from the period-filtered global aggregate", () => {
@@ -88,12 +105,15 @@ describe("overview period filter", () => {
       "utf8",
     );
     const periods = readFileSync(new URL("PeriodSummaryTable.tsx", import.meta.url), "utf8");
+    const costCard = readFileSync(new URL("OverviewCostKpi.tsx", import.meta.url), "utf8");
 
     expect(source).toContain('currency: "BRL" | "USD"');
     expect(source).toContain("const selectedCurrencyCost =");
     expect(source).toContain("formatCurrency(value, currency, locale)");
-    expect(source).toContain("formatSummaryMetricValue(\n            totalCostMetric,");
-    expect(source).toContain("formatRoundedCurrency(value, currency, locale)");
+    expect(source).toContain("<OverviewCostKpi");
+    expect(source).toContain("total={totalCostMetric}");
+    expect(source).toContain("currency={currency}");
+    expect(costCard).toContain("formatRoundedCurrency(value, currency, locale)");
     expect(source).toContain("const topEntitiesCost =");
     expect(topPanel).toContain("formatCurrency(topCost, currency, locale)");
     expect(periods).toContain("resolveRunCost?: ((runId: string) => number | null)");

package/templates/.agents/dashboard/modules/operations/src/react/operations-page-contract.ts

@@ -26,6 +26,16 @@ export type OverviewClassification =
   | "structured"
   | "rework";
 
+/** A Cost Monitor total with its measurement completeness for the active currency. */
+export type FactualCostFact =
+  | { state: "complete"; knownSum: number; coverage: { known: number; total: number } }
+  | { state: "partial"; knownSum: number; coverage: { known: number; total: number } }
+  | {
+      state: "unavailable";
+      knownSum: null;
+      coverage: { known: number; total: number } | null;
+    };
+
 /** A remounted Trabalho (Lista) selector always starts on "all". */
 export function workListTypeOnViewChange(nextView: OperationsView): WorkTypeFilter | null {
   return nextView === "work-list" ? "all" : null;
@@ -153,6 +163,8 @@ export interface OperationsPageProps {
    * This is needed when its compact snapshot intentionally omits Run rows.
    */
   factualCostTotal?: number | null | undefined;
+  /** Factual Cost Monitor measurement state for the active period and currency. */
+  factualCostFact?: FactualCostFact | undefined;
   /** Factual Cost Monitor rows matching the active global period. */
   factualCostPeriods?:
     | Partial<
@@ -175,11 +187,16 @@ export function resolveOperationsPeriodControl(input: {
   dateRange?: OperationDateRange | undefined;
   fallbackPreset: OperationDatePreset;
   fallbackRange: OperationDateRange;
+  allTimeRange?: OperationDateRange;
 }) {
   const controlled = input.datePreset !== undefined && input.dateRange !== undefined;
+  const datePreset = input.datePreset ?? input.fallbackPreset;
   return {
     controlled,
-    datePreset: input.datePreset ?? input.fallbackPreset,
-    dateRange: input.dateRange ?? input.fallbackRange,
+    datePreset,
+    dateRange:
+      datePreset === "all" && input.allTimeRange !== undefined
+        ? input.allTimeRange
+        : (input.dateRange ?? input.fallbackRange),
   };
 }

package/templates/.agents/dashboard/modules/operations/src/react/overview-cost-card.test.tsx

@@ -0,0 +1,89 @@
+import { renderToStaticMarkup } from "react-dom/server";
+import { describe, expect, it } from "vitest";
+import {
+  factualCostMetricHint,
+  factualCostMetricLabel,
+  Kpi,
+  overviewCostRateHint,
+} from "./OperationsOverview.helpers.js";
+import { OverviewCostKpi } from "./OverviewCostKpi.js";
+
+describe("compact estimated cost card", () => {
+  it.each([
+    ["BRL", "pt-BR", "R$\u00a052.629", "R$\u00a049 / tarefa (R$\u00a0259 / hora)"],
+    ["USD", "en-US", "$52,629", "$49 / task ($259 / hour)"],
+  ] as const)("renders the extracted card in %s without losing factual rates", (currency, locale, total, rates) => {
+    const markup = renderToStaticMarkup(
+      <OverviewCostKpi
+        fact={undefined}
+        unit={locale === "pt-BR" ? "tarefa" : "task"}
+        locale={locale}
+        currency={currency}
+        count={10}
+        perItem={49}
+        perHour={259}
+        total={52629}
+      />,
+    );
+    expect(markup).toContain(total);
+    expect(markup).toContain(`<small>${rates}</small>`);
+    expect(markup).not.toContain("Indisponível");
+  });
+  it("keeps the prior title and rates when the population is complete", () => {
+    expect(factualCostMetricLabel(undefined, "pt-BR")).toBe("Custo Estimado");
+    expect(overviewCostRateHint(undefined, "tarefa", "pt-BR", "BRL", 10, 49, 259)).toBe(
+      "R$\u00a049 / tarefa (R$\u00a0259 / hora)",
+    );
+    expect(overviewCostRateHint(undefined, "task", "en-US", "USD", 10, 5, 26)).toBe(
+      "$5 / task ($26 / hour)",
+    );
+  });
+
+  it("moves partial coverage to accessible help rather than a large paragraph", () => {
+    const fact = { state: "partial", knownSum: 12, coverage: { known: 2, total: 3 } } as const;
+    const description = factualCostMetricHint(fact, "tarefa", "pt-BR") ?? undefined;
+    expect(description).toContain("2 de 3 runs");
+    const markup = renderToStaticMarkup(
+      <Kpi
+        label={factualCostMetricLabel(fact, "pt-BR")}
+        value="R$ 12"
+        hint={overviewCostRateHint(fact, "tarefa", "pt-BR", "BRL", 3, 4, 6)}
+        description={description}
+      />,
+    );
+    expect(markup).toContain("Custo Estimado</span>");
+    expect(markup).not.toContain("ⓘ");
+    expect(markup).toContain("<small>R$\u00a04 / tarefa (R$\u00a06 / hora)</small>");
+    expect(description).toContain("sem estimar custos ausentes");
+    expect(markup).toContain(`aria-description="${description}"`);
+    expect(markup).toContain(`title="${description}"`);
+    expect(markup).not.toContain("<p>");
+    expect(markup).not.toContain("Subtotal estimado conhecido");
+  });
+
+  it("keeps unavailable rates distinct from observed zero, including other units", () => {
+    expect(overviewCostRateHint(undefined, "tarefa", "pt-BR", "BRL", 3, 4, null)).toBe(
+      "R$\u00a04 / tarefa (— / hora)",
+    );
+    expect(overviewCostRateHint(undefined, "task", "en-US", "USD", 0, null, 6)).toBe(
+      "— / task ($6 / hour)",
+    );
+    expect(overviewCostRateHint(undefined, "SPEC", "pt-BR", "BRL", 3, null, null)).toBe(
+      "— / SPEC (— / hora)",
+    );
+    expect(overviewCostRateHint(undefined, "tarefa", "pt-BR", "BRL", 3, 0, 0)).toBe(
+      "R$\u00a00 / tarefa (R$\u00a00 / hora)",
+    );
+    expect(
+      overviewCostRateHint(
+        { state: "unavailable", knownSum: null, coverage: null },
+        "task",
+        "en-US",
+        "USD",
+        0,
+        null,
+        null,
+      ),
+    ).toBe("— / task (— / hour)");
+  });
+});

package/templates/.agents/dashboard/modules/operations/src/react/work-board-model.test.ts

@@ -27,9 +27,9 @@ describe("unified work board stages", () => {
   });
 
   it.each([
-    ["draft", "SPEC-1", "definition"],
+    ["draft", "SPEC-1", null],
     ["planned", "SPEC-1", "ready"],
-    ["draft", null, "definition"],
+    ["draft", null, null],
     ["executing", null, "executing"],
     ["verifying", null, "verifying"],
     ["completed", null, "completed"],
@@ -58,7 +58,7 @@ describe("unified work board stages", () => {
         execution_started: false,
       }),
     ).toBe("ready");
-    expect(taskWorkStage({ status: "draft", spec_id: null })).toBe("definition");
+    expect(taskWorkStage({ status: "draft", spec_id: null })).toBeNull();
     expect(taskWorkStage({ status: "planned", spec_id: "SPEC-1" })).toBe("ready");
   });
 

package/templates/.agents/dashboard/modules/operations/src/work-board-model.ts

@@ -40,7 +40,8 @@ export function taskWorkStage(
   if (task.status === "verifying") return "verifying";
   if ((task.attempt_count ?? 0) > 0 || task.started_at != null || task.execution_started === true)
     return "executing";
-  if (task.status === "draft") return "definition";
+  // Definition belongs to PRDs; unprepared Tasks remain in the list only.
+  if (task.status === "draft") return null;
   return task.status === "planned" ? "ready" : null;
 }
 

package/templates/.agents/dashboard/modules/traceability/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-traceability",
-  "version": "2.6.0",
+  "version": "3.1.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/branding/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-branding",
-  "version": "2.6.0",
+  "version": "3.1.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/contracts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-contracts",
-  "version": "2.6.0",
+  "version": "3.1.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/data-export/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-data-export",
-  "version": "2.6.0",
+  "version": "3.1.0",
   "private": true,
   "type": "module",
   "exports": {