@zaip-ai/cli 2.6.0 → 3.1.0

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview-keeps-structure-classes-mutually-exclusive.test.ts

@@ -84,7 +84,7 @@ describe("taskStatusDistribution", () => {
     );
 
     expect(distribution.map(({ key, label, count }) => ({ key, label, count }))).toEqual([
-      { key: "definition", label: "Definição (PRD + Requisitos)", count: 2 },
+      { key: "definition", label: "Definição (PRD + Requisitos)", count: 0 },
       { key: "planning", label: "Planejamento (SPEC + Change)", count: 0 },
       { key: "ready", label: "Pronto para Executar", count: 2 },
       { key: "executing", label: "Execução", count: 1 },
@@ -117,7 +117,7 @@ describe("taskStatusDistribution", () => {
     );
 
     expect(visible.map(({ key, count }) => ({ key, count }))).toEqual([
-      { key: "definition", count: 1 },
+      { key: "definition", count: 0 },
       { key: "planning", count: 0 },
       { key: "ready", count: 2 },
       { key: "executing", count: 1 },
@@ -127,7 +127,8 @@ describe("taskStatusDistribution", () => {
       { key: "cancelled", count: 1 },
       { key: "failed", count: 1 },
     ]);
-    expect(visible.reduce((total, item) => total + item.count, 0)).toBe(8);
+    // Draft Tasks stay in the list, outside the PRD/SPEC pipeline stages.
+    expect(visible.reduce((total, item) => total + item.count, 0)).toBe(7);
   });
 });
 describe("macroStatusDistribution", () => {

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.helpers.tsx

@@ -7,6 +7,8 @@ import {
   sumObserved,
 } from "./execution-metrics.js";
 import { formatDurationInHours, formatRoundedDuration } from "./format-rounded-duration.js";
+import type { FactualCostFact } from "./operations-page-contract.js";
+import { formatRoundedCurrency } from "./overview-metric-format.js";
 import type { OperationsLocale } from "./status-labels.js";
 import type { WorkStage } from "./work-board-model.js";
 
@@ -365,6 +367,7 @@ export function canonicalMacroMetric(
 /** Selects currency totals without treating Operations' BRL aggregate as USD. */
 export function resolveOverviewCostTotal({
   currency,
+  factualSnapshotFact,
   factualSnapshotTotal,
   macroCostTotal,
   overviewView,
@@ -372,6 +375,7 @@ export function resolveOverviewCostTotal({
   operationsBrlTotal,
 }: {
   currency: "BRL" | "USD";
+  factualSnapshotFact?: FactualCostFact | undefined;
   factualSnapshotTotal: number | null | undefined;
   macroCostTotal?: number | null | undefined;
   overviewView?: OverviewView;
@@ -379,12 +383,67 @@ export function resolveOverviewCostTotal({
   operationsBrlTotal: number | null;
 }): number | null {
   if (overviewView !== undefined && overviewView !== "tasks") return macroCostTotal ?? null;
-  if (factualSnapshotTotal !== null && factualSnapshotTotal !== undefined)
-    return factualSnapshotTotal;
+  if (factualSnapshotFact !== undefined)
+    return factualSnapshotFact.state === "unavailable" ? null : factualSnapshotFact.knownSum;
+  // Explicit null is authoritative unavailability, not permission to use a partial fallback.
+  if (factualSnapshotTotal !== undefined) return factualSnapshotTotal;
   if (resolvedRunTotal !== null) return resolvedRunTotal;
   return currency === "BRL" ? operationsBrlTotal : null;
 }
 
+export function factualCostMetricLabel(
+  _fact: FactualCostFact | undefined,
+  locale: OperationsLocale,
+): string {
+  return locale === "pt-BR" ? "Custo Estimado" : "Estimated cost";
+}
+
+export function factualCostMetricHint(
+  fact: FactualCostFact | undefined,
+  metricUnit: string,
+  locale: OperationsLocale,
+): string | null {
+  if (fact?.state !== "partial") return null;
+  const { known, total } = fact.coverage;
+  return locale === "pt-BR"
+    ? `${known} de ${total} runs com custo conhecido. Taxas estimadas: subtotal conhecido dividido pelas ${metricUnit}s e horas registradas do recorte; cobertura parcial, sem estimar custos ausentes.`
+    : `${known} of ${total} runs have known cost. Estimated rates: known subtotal divided by the selected ${metricUnit}s and recorded hours; partial coverage, missing costs are not estimated.`;
+}
+
+export function factualCostAverageLabel(
+  fact: FactualCostFact | undefined,
+  _populationCount: number | null,
+  locale: OperationsLocale,
+): string {
+  const base = locale === "pt-BR" ? "Custo médio" : "Average cost";
+  if (fact?.state !== "partial") return base;
+  const partial = locale === "pt-BR" ? "cobertura parcial" : "partial coverage";
+  return `${base} — ${partial} (${fact.coverage.known}/${fact.coverage.total} runs)`;
+}
+
+/** Rates allocate observed spend across the selected population, not missing spend. */
+export function overviewCostForRates(fact: FactualCostFact | undefined, total: number | null) {
+  return fact?.state === "unavailable" ? null : total;
+}
+
+export function overviewCostRateHint(
+  fact: FactualCostFact | undefined,
+  unit: string,
+  locale: OperationsLocale,
+  currency: "BRL" | "USD",
+  _count: number | null,
+  perItem: number | null,
+  perHour: number | null,
+): string {
+  const formatRate = (value: number | null) =>
+    fact?.state === "unavailable" || value === null || !Number.isFinite(value)
+      ? "—"
+      : formatRoundedCurrency(value, currency, locale);
+  const item = formatRate(perItem);
+  const hour = formatRate(perHour);
+  return `${item} / ${unit} (${hour} / ${locale === "pt-BR" ? "hora" : "hour"})`;
+}
+
 export function partialOverviewMetrics(data: OperationsProjection) {
   return data.summary.overview_metrics;
 }
@@ -450,18 +509,20 @@ export function Kpi({
   label,
   value,
   hint,
+  description,
   featured = false,
   onSelect,
 }: {
   label: string;
   value: string;
   hint: string;
+  description?: string | undefined;
   featured?: boolean;
   onSelect?: (() => void) | undefined;
 }) {
   const content = (
     <>
-      <span>{label}</span>
+      <span title={description}>{label}</span>
       <strong>{value}</strong>
       <small>{hint}</small>
     </>
@@ -469,6 +530,7 @@ export function Kpi({
   if (onSelect !== undefined) {
     return (
       <button
+        aria-description={description}
         aria-pressed={featured}
         aria-label={`${label}: ${value}. ${hint}`}
         className={`operations-kpi is-selectable${featured ? " is-featured" : ""}`}
@@ -481,6 +543,7 @@ export function Kpi({
   }
   return (
     <article
+      aria-description={description}
       aria-label={`${label}: ${value}. ${hint}`}
       className={`operations-kpi${featured ? " is-featured" : ""}`}
     >

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

@@ -5,10 +5,14 @@ import {
   executionMetricTotals,
   operationalRootExecutionDuration,
 } from "./execution-metrics.js";
+import { overviewCostForRates, overviewCostRateHint } from "./OperationsOverview.helpers.js";
 import {
   aggregateMacroMetrics,
   aggregateTaskMetrics,
   countExecutionDays,
+  factualCostAverageLabel,
+  factualCostMetricHint,
+  factualCostMetricLabel,
   formatExecutionAverageHint,
   formatSummaryMetricValue,
   formatTokenThroughputHint,
@@ -128,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");
@@ -158,6 +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({
@@ -361,7 +431,7 @@ describe("overviewMetricAverages", () => {
     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");

package/templates/.agents/dashboard/modules/operations/src/react/OperationsOverview.tsx

@@ -1,4 +1,4 @@
-import { formatRoundedCurrency, formatSummaryMetricValue } from "./overview-metric-format.js";
+import { formatSummaryMetricValue } from "./overview-metric-format.js";
 
 export { formatSummaryMetricValue } from "./overview-metric-format.js";
 
@@ -18,11 +18,13 @@ import {
   aggregateTaskMetrics,
   canonicalMacroMetric,
   countExecutionDays,
+  factualCostAverageLabel,
   findLatestCreatedAt,
   formatExecutionAverageHint,
   Kpi,
   macroClassificationStats,
   overviewCopy,
+  overviewCostForRates,
   overviewMetricAverages,
   overviewText,
   partialOverviewMetrics,
@@ -39,8 +41,10 @@ import {
 } from "./OperationsOverview.helpers.js";
 import { OperationsOverviewCharts } from "./OperationsOverviewCharts.js";
 import { OperationsOverviewTopPanel } from "./OperationsOverviewTopPanel.js";
+import { OverviewCostKpi } from "./OverviewCostKpi.js";
 import type { OperationDatePreset, OperationDateRange } from "./operation-date-range.js";
 import type {
+  FactualCostFact,
   OverviewClassification,
   OverviewClassificationPage,
   OverviewStatusKind,
@@ -55,6 +59,9 @@ export {
   aggregateTaskMetrics,
   canonicalMacroMetric,
   countExecutionDays,
+  factualCostAverageLabel,
+  factualCostMetricHint,
+  factualCostMetricLabel,
   findLatestCreatedAt,
   findLatestTaskCreatedAt,
   formatExecutionAverageHint,
@@ -96,6 +103,7 @@ export function OperationsOverview({
   specs = data.specs,
   tasks = data.tasks,
   factualCostTotal,
+  factualCostFact,
   resolveRunCost,
   includeLegacyEffort: _includeLegacyEffort = false,
 }: {
@@ -131,6 +139,8 @@ export function OperationsOverview({
   tasks?: OperationsProjection["tasks"];
   /** Factual Cost Monitor snapshot total for the selected locale/currency. */
   factualCostTotal?: number | null | undefined;
+  /** Measurement completeness for the matching Cost Monitor snapshot. */
+  factualCostFact?: FactualCostFact | undefined;
   resolveRunCost?: ((runId: string) => number | null) | undefined;
   includeLegacyEffort?: boolean;
 }) {
@@ -304,6 +314,7 @@ export function OperationsOverview({
   // from Cost Monitor's factual per-Run estimates; never relabel BRL as USD.
   const totalCostMetric = resolveOverviewCostTotal({
     currency,
+    factualSnapshotFact: overviewView === "tasks" ? factualCostFact : undefined,
     factualSnapshotTotal: factualCostTotal,
     macroCostTotal: canonicalMacroMetric(
       selectedMacroAggregate !== undefined,
@@ -314,14 +325,18 @@ export function OperationsOverview({
     resolvedRunTotal: selectedCurrencyCost,
     operationsBrlTotal: overviewMetrics?.cost_brl ?? allPhaseMetrics.costBrl,
   });
+  const rateCost = overviewCostForRates(
+    overviewView === "tasks" ? factualCostFact : undefined,
+    totalCostMetric,
+  );
   const hourlyCost =
-    totalDurationMetric === null || totalDurationMetric <= 0 || totalCostMetric === null
+    totalDurationMetric === null || totalDurationMetric <= 0 || rateCost === null
       ? null
-      : (totalCostMetric * 3_600_000) / totalDurationMetric;
+      : (rateCost * 3_600_000) / totalDurationMetric;
   const costPerTask =
-    totalCostMetric === null || metricPopulationCount === null || metricPopulationCount === 0
+    rateCost === null || metricPopulationCount === null || metricPopulationCount === 0
       ? null
-      : totalCostMetric / metricPopulationCount;
+      : rateCost / metricPopulationCount;
   const tokensPerTask =
     totalTokensMetric === null || metricPopulationCount === null || metricPopulationCount === 0
       ? null
@@ -332,7 +347,7 @@ export function OperationsOverview({
       : (totalTokensMetric * 3_600_000) / totalDurationMetric;
   const averageMetricTotals =
     overviewView === "tasks"
-      ? { durationMs: totalDurationMetric, tokens: totalTokensMetric, costBrl: totalCostMetric }
+      ? { durationMs: totalDurationMetric, tokens: totalTokensMetric, costBrl: rateCost }
       : {
           durationMs: canonicalMacroMetric(
             selectedMacroAggregate !== undefined,
@@ -397,7 +412,11 @@ export function OperationsOverview({
       ),
     ],
     [
-      text.averageCost,
+      factualCostAverageLabel(
+        overviewView === "tasks" ? factualCostFact : undefined,
+        selectedCount,
+        locale,
+      ),
       formatSummaryMetricValue(
         averageCost,
         selectedCount,
@@ -618,35 +637,22 @@ export function OperationsOverview({
             locale,
           )}
         />{" "}
-        <Kpi
-          hint={
-            hourlyCost === null || costPerTask === null
-              ? metricPopulationCount === 0
-                ? locale === "pt-BR"
-                  ? `${formatRoundedCurrency(0, currency, locale)} / ${metricUnit} (${formatRoundedCurrency(0, currency, locale)} / hora)`
-                  : `${formatRoundedCurrency(0, currency, locale)} / ${metricUnit} (${formatRoundedCurrency(0, currency, locale)} / hour)`
-                : locale === "pt-BR"
-                  ? "Custo por tarefa e por hora indispon\u00edvel"
-                  : "Cost per task and hour unavailable"
-              : locale === "pt-BR"
-                ? `${formatRoundedCurrency(costPerTask, currency, locale)} / ${metricUnit} (${formatRoundedCurrency(hourlyCost, currency, locale)} / hora)`
-                : `${formatRoundedCurrency(costPerTask, currency, locale)} / ${metricUnit} (${formatRoundedCurrency(hourlyCost, currency, locale)} / hour)`
-          }
+        <OverviewCostKpi
+          fact={overviewView === "tasks" ? factualCostFact : undefined}
+          unit={metricUnit}
+          locale={locale}
+          currency={currency}
+          count={metricPopulationCount}
+          perItem={costPerTask}
+          perHour={hourlyCost}
+          total={totalCostMetric}
           label={
             overviewView === "tasks"
-              ? locale === "pt-BR"
-                ? "Custo Estimado"
-                : "Estimated cost"
+              ? undefined
               : locale === "pt-BR"
                 ? `Custo de ${copy.shortPlural}`
                 : `${copy.shortPlural} cost`
           }
-          value={formatSummaryMetricValue(
-            totalCostMetric,
-            metricPopulationCount,
-            (value) => formatRoundedCurrency(value, currency, locale),
-            locale,
-          )}
         />{" "}
       </div>
       <div className="operations-chart-grid">

package/templates/.agents/dashboard/modules/operations/src/react/OperationsPage.tsx

@@ -119,6 +119,7 @@ export function OperationsPage({
   repositoryName,
   settings,
   factualCostTotal,
+  factualCostFact,
   factualCostPeriods,
   resolveRunCost,
 }: OperationsPageProps) {
@@ -147,6 +148,7 @@ export function OperationsPage({
     dateRange: controlledDateRange,
     fallbackPreset: localDatePreset,
     fallbackRange: localDateRange,
+    allTimeRange: defaultDateRange,
   });
   const isPeriodControlled = periodControl.controlled;
   const dateRange = periodControl.dateRange;
@@ -161,20 +163,8 @@ export function OperationsPage({
     },
     [isPeriodControlled, onDateChange, onPeriodChange],
   );
-  // A controlled parent initially owns the range selected before the factual
-  // Cost summary arrives. Once it does, synchronize only All Time's displayed
-  // coverage range; requestPeriodForOperations still omits both bounds.
-  useEffect(() => {
-    if (
-      datePreset !== "all" ||
-      (dateRange.start === defaultDateRange.start && dateRange.end === defaultDateRange.end)
-    )
-      return;
-    updatePeriod("all", defaultDateRange);
-  }, [datePreset, dateRange.end, dateRange.start, defaultDateRange, updatePeriod]);
-  useEffect(() => {
-    if (!isPeriodControlled && datePreset === "all") setLocalDateRange(defaultDateRange);
-  }, [datePreset, defaultDateRange, isPeriodControlled]);
+  // Coverage is derived display data, not a user selection. Never feed it
+  // back through onDateChange: a delayed effect can overwrite a newer period.
   const showFilterLoading = useCallback(() => {
     setFilterLoading(true);
     if (filterLoadingTimer.current !== null) window.clearTimeout(filterLoadingTimer.current);
@@ -680,6 +670,7 @@ export function OperationsPage({
               prds={prds}
               query={query}
               factualCostTotal={factualCostTotal}
+              factualCostFact={factualCostFact}
               resolveRunCost={resolveRunCost}
               runs={runs}
               searchInputRef={searchInputRef}

package/templates/.agents/dashboard/modules/operations/src/react/OperationsPageOverview.tsx

@@ -19,6 +19,7 @@ export function OperationsPageOverview({
   dateRange,
   defaultDateRange,
   factualCostTotal,
+  factualCostFact,
   includeLegacyEffort,
   locale,
   onOpenTask,
@@ -47,6 +48,7 @@ export function OperationsPageOverview({
   dateRange: OperationDateRange;
   defaultDateRange: OperationDateRange;
   factualCostTotal: OverviewProps["factualCostTotal"];
+  factualCostFact: OverviewProps["factualCostFact"];
   includeLegacyEffort: boolean;
   locale: OperationsLocale;
   onOpenTask: OverviewProps["onOpenTask"];
@@ -74,6 +76,7 @@ export function OperationsPageOverview({
         data={data}
         currency={currency}
         factualCostTotal={factualCostTotal}
+        factualCostFact={factualCostFact}
         datePreset={datePreset}
         dateRange={dateRange}
         locale={locale}

package/templates/.agents/dashboard/modules/operations/src/react/OverviewCostKpi.tsx

@@ -0,0 +1,46 @@
+import {
+  factualCostMetricHint,
+  factualCostMetricLabel,
+  Kpi,
+  overviewCostRateHint,
+} from "./OperationsOverview.helpers.js";
+import type { FactualCostFact } from "./operations-page-contract.js";
+import { formatRoundedCurrency, formatSummaryMetricValue } from "./overview-metric-format.js";
+import type { OperationsLocale } from "./status-labels.js";
+
+/** Compact presentation, preserving completeness and matching population semantics. */
+export function OverviewCostKpi({
+  fact,
+  unit,
+  locale,
+  currency,
+  count,
+  perItem,
+  perHour,
+  total,
+  label,
+}: {
+  fact: FactualCostFact | undefined;
+  unit: string;
+  locale: OperationsLocale;
+  currency: "BRL" | "USD";
+  count: number | null;
+  perItem: number | null;
+  perHour: number | null;
+  total: number | null;
+  label?: string | undefined;
+}) {
+  return (
+    <Kpi
+      hint={overviewCostRateHint(fact, unit, locale, currency, count, perItem, perHour)}
+      description={factualCostMetricHint(fact, unit, locale) ?? undefined}
+      label={label ?? factualCostMetricLabel(fact, locale)}
+      value={formatSummaryMetricValue(
+        total,
+        count,
+        (value) => formatRoundedCurrency(value, currency, locale),
+        locale,
+      )}
+    />
+  );
+}

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

@@ -2,9 +2,36 @@ import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { describe, expect, it } from "vitest";
 import type { DashboardTaskProjection, MacroProjection, RunProjection } from "../contracts.js";
-import { buildWorkListRows, formatWorkListDuration } from "./UnifiedWorkList.js";
+import {
+  buildWorkListRows,
+  formatWorkListDuration,
+  workListStageLabel,
+} from "./UnifiedWorkList.js";
 
 describe("buildWorkListRows", () => {
+  it("retains unexecuted Task drafts without labeling them as SPEC planning", () => {
+    const task = {
+      id: "TASK-DRAFT",
+      title: "Unprepared work",
+      status: "draft",
+      progress: 0,
+      spec_id: null,
+      execution_started: false,
+      execution_count: 0,
+      attempt_count: 0,
+    } as DashboardTaskProjection;
+    const [row] = buildWorkListRows({
+      allSpecs: [],
+      allTasks: [task],
+      changes: [],
+      items: [{ kind: "task", row: task }],
+      runs: [],
+    });
+    expect(row?.stage).toBe("draft");
+    if (row === undefined) throw new Error("Expected the draft to remain visible in the list");
+    expect(workListStageLabel(row.stage, "pt-BR")).toBe("Rascunho");
+    expect(workListStageLabel(row.stage, "en-US")).toBe("Draft");
+  });
   it("labels only active missing time as in progress and preserves temporal absence elsewhere", () => {
     expect(formatWorkListDuration(null, "executing", "pt-BR")).toBe("Em andamento");
     expect(formatWorkListDuration(null, "blocked", "pt-BR")).toBe("Sem atribuição temporal");

package/templates/.agents/dashboard/modules/operations/src/react/UnifiedWorkList.tsx

@@ -26,10 +26,11 @@ import {
 type WorkItem =
   | { kind: "task"; row: DashboardTaskProjection }
   | { kind: "prd" | "spec"; row: MacroProjection };
+type WorkListStage = WorkStage | "draft" | "unstaged";
 
 interface WorkListRow {
   item: WorkItem;
-  stage: WorkStage;
+  stage: WorkListStage;
   risk: string | null;
   progress: string;
   durationMs: number | null;
@@ -109,7 +110,7 @@ export function UnifiedWorkList({
               label: "Status",
               render: ({ stage }) => (
                 <span className={`operations-status is-${stage}`}>
-                  {workStageLabel(stage, locale)}
+                  {workListStageLabel(stage, locale)}
                 </span>
               ),
               sortValue: ({ stage }) => stage,
@@ -214,7 +215,7 @@ export function UnifiedWorkList({
 
 export function formatWorkListDuration(
   durationMs: number | null,
-  stage: WorkStage,
+  stage: WorkListStage,
   locale: OperationsLocale,
 ): string {
   if (durationMs !== null) return formatRoundedDuration(durationMs);
@@ -224,6 +225,12 @@ export function formatWorkListDuration(
   );
 }
 
+export function workListStageLabel(stage: WorkListStage, locale: OperationsLocale): string {
+  if (stage === "draft") return locale === "pt-BR" ? "Rascunho" : "Draft";
+  if (stage === "unstaged") return locale === "pt-BR" ? "Sem etapa" : "Unstaged";
+  return workStageLabel(stage, locale);
+}
+
 export function buildWorkListRows({
   allSpecs,
   allTasks,
@@ -269,7 +276,7 @@ export function buildWorkListRows({
     }
     return {
       item,
-      stage: taskWorkStage(task) ?? "planning",
+      stage: taskWorkStage(task) ?? (task.status === "draft" ? "draft" : "unstaged"),
       risk: task.risk ?? null,
       progress: `${Math.round(task.progress)}%`,
       durationMs: taskUsage?.durationMs ?? (hasProvenNoTaskActivity(task, relatedRuns) ? 0 : null),

package/templates/.agents/dashboard/modules/operations/src/react/index.ts

@@ -6,6 +6,7 @@ export * from "./MacroBoard.js";
 export * from "./MacroPlanningDialog.js";
 export * from "./OperationsPage.js";
 export * from "./operation-date-range.js";
+export type { FactualCostFact } from "./operations-page-contract.js";
 export * from "./PrdDocumentDialog.js";
 export * from "./TaskBoard.js";
 export * from "./TaskDetailsDialog.js";

package/templates/.agents/dashboard/modules/operations/src/react/operations-coverage-toast.test.ts

@@ -49,8 +49,8 @@ describe("Operations persisted aggregate display", () => {
     expect(overview).toContain("const totalDurationMetric = scopedOverviewMetric(");
     expect(overview).toContain("selectedMacroTotals?.durationMs,");
     expect(overview).toContain("const totalCostMetric =");
-    expect(overview).toContain(
-      "durationMs: totalDurationMetric, tokens: totalTokensMetric, costBrl: totalCostMetric",
+    expect(overview).toMatch(
+      /durationMs: totalDurationMetric,\s*tokens: totalTokensMetric,\s*costBrl: rateCost/,
     );
     expect(overview).toContain("formatSummaryMetricValue(\n        averageDuration,");
     expect(overview).toContain('populationCount === 0 ? "0"');