@zaip-ai/cli 3.3.0 → 3.5.0

package/templates/.agents/dashboard/modules/operations/src/react/PagedWorkList.test.tsx

@@ -1,9 +1,21 @@
 import { createElement } from "react";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vitest";
-import { PagedWorkList } from "./PagedWorkList.js";
+import { PagedWorkList, pagedWorkStatusLabel } from "./PagedWorkList.js";
 
 describe("PagedWorkList", () => {
+  it("displays the reconciled macro stage while preserving draft Task semantics", () => {
+    expect(pagedWorkStatusLabel({ status: "active", stage: "verifying" }, "pt-BR")).toBe(
+      "Verificação",
+    );
+    expect(pagedWorkStatusLabel({ status: "draft", stage: "planning" }, "pt-BR")).toBe(
+      "Planejamento (SPEC + Change)",
+    );
+    expect(pagedWorkStatusLabel({ status: "draft", stage: null }, "pt-BR")).toBe("Rascunho");
+    expect(pagedWorkStatusLabel({ status: "delivered", stage: "completed" }, "en-US")).toBe(
+      "Completed",
+    );
+  });
   it("renders the factual developer column without object coercion", () => {
     const markup = renderToStaticMarkup(
       createElement(PagedWorkList, {

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

@@ -3,7 +3,12 @@ import { formatDeveloperIdentities } from "./developer-identities.js";
 import { formatRoundedDuration } from "./format-rounded-duration.js";
 import type { OperationsLocale } from "./status-labels.js";
 import { WorkTypeFilters } from "./UnifiedWorkBoard.js";
-import type { WorkTypeFilter } from "./work-board-model.js";
+import {
+  workStageLabel,
+  workStages,
+  type WorkStage,
+  type WorkTypeFilter,
+} from "./work-board-model.js";
 
 export type PagedWorkListRow = Record<string, unknown>;
 export type PagedWorkListPage = {
@@ -25,6 +30,14 @@ function number(value: unknown): number | null {
   return typeof value === "number" && Number.isFinite(value) ? value : null;
 }
 
+export function pagedWorkStatusLabel(row: PagedWorkListRow, locale: OperationsLocale): string {
+  const stage = row.stage ?? row.status;
+  if (stage === "draft") return locale === "pt-BR" ? "Rascunho" : "Draft";
+  return workStages.includes(stage as WorkStage)
+    ? workStageLabel(stage as WorkStage, locale)
+    : text(stage);
+}
+
 function workKindLabel(value: unknown, locale: OperationsLocale) {
   const kind = text(value, "");
   const labels =
@@ -77,8 +90,8 @@ export function PagedWorkList({
             {
               key: "status",
               label: "Status",
-              render: (row) => text(row.status),
-              sortValue: (row) => text(row.status),
+              render: (row) => pagedWorkStatusLabel(row, locale),
+              sortValue: (row) => pagedWorkStatusLabel(row, locale),
             },
             {
               key: "type",

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

@@ -9,7 +9,6 @@ import {
   EXPORT_SUCCESS_TOAST_MS,
   exportAgentInvocationRows,
   exportCompactLifecycleRows,
-  exportCostAgentRows,
   exportCostGroupRows,
   exportDeveloperRows,
   exportExecutionRows,
@@ -466,6 +465,17 @@ it("exports compact Task, SPEC, PRD, and Conversation rows with entity columns",
   ]);
 });
 
+it("preserves unavailable compact timing and cost while exporting known tokens and real zero", () => {
+  const missing = { known_sum: 0, unknown: 1, complete: false, coverage_ratio: 0 };
+  const zero = { known_sum: 0, unknown: 0, complete: true, coverage_ratio: 1 };
+  const rows = exportCompactLifecycleRows([
+    { metrics: { duration: missing, cost: missing, total_tokens: { ...zero, known_sum: 15 } } },
+    { metrics: { duration: zero, cost: zero, total_tokens: zero } },
+  ]);
+  expect(rows[0]).toMatchObject({ duration_hours: null, cost_brl: null, tokens: 15 });
+  expect(rows[1]).toMatchObject({ duration_hours: 0, cost_brl: 0, tokens: 0 });
+});
+
 it("keeps cost-executions headers and exported row keys in the compact lifecycle schema", () => {
   const source = {
     id: "RUN-42",
@@ -579,29 +589,3 @@ it("exports model analysis in table order with explicit numeric zeroes", () => {
 it("clears pending success when a new export starts", () => {
   expect("running").not.toBe("completed");
 });
-
-it("exports Agent tasks as participations and fills every missing numeric cell with zero", () => {
-  expect(COST_AGENT_EXPORT_COLUMNS).toEqual([
-    "Persona",
-    "Cargo",
-    "Zaip Agentes",
-    "PRDs",
-    "SPECs",
-    "Tarefas",
-    "Runs",
-    "Testes",
-    "Evidências",
-    "Tempo",
-    "Tokens",
-    "Custos",
-  ]);
-  const rows = exportCostAgentRows([
-    { key: "dave", task_count: 2 },
-    { key: "leo", task_count: 2 },
-    {},
-  ]);
-  expect(rows[0]?.Tarefas).toBe(2);
-  expect(rows[1]?.Tarefas).toBe(2);
-  for (const key of COST_AGENT_EXPORT_COLUMNS.slice(3)) expect(rows[2]?.[key]).toBe(0);
-  expect(rows[0]).not.toHaveProperty("tasks_created");
-});

package/templates/.agents/dashboard/modules/operations/src/react/export/ExcelExportAction.tsx

@@ -5,6 +5,38 @@ import { formatDeveloperIdentities } from "../developer-identities.js";
 import { ExportProgressToast, ExportSuccessToast } from "./ExportProgressToast.js";
 import { ExportController, type ExportState } from "./export-session.js";
 
+export {
+  AGENT_INVOCATION_EXPORT_COLUMNS,
+  CHANGE_EXPORT_COLUMNS,
+  COMPACT_LIFECYCLE_EXPORT_COLUMNS,
+  CONVERSATION_EXPORT_COLUMNS,
+  COST_AGENT_EXPORT_COLUMNS,
+  COST_GROUP_EXPORT_COLUMNS,
+  DECISION_EXPORT_COLUMNS,
+  DEVELOPER_EXPORT_COLUMNS,
+  EXECUTION_EXPORT_COLUMNS,
+  KANBAN_EXPORT_COLUMNS,
+  MODEL_COST_GROUP_EXPORT_COLUMNS,
+  PERIOD_EXPORT_COLUMNS,
+  WORK_EXPORT_COLUMNS,
+} from "./ExcelExportColumns.js";
+
+import {
+  AGENT_INVOCATION_EXPORT_COLUMNS,
+  CHANGE_EXPORT_COLUMNS,
+  COMPACT_LIFECYCLE_EXPORT_COLUMNS,
+  CONVERSATION_EXPORT_COLUMNS,
+  COST_AGENT_EXPORT_COLUMNS,
+  COST_GROUP_EXPORT_COLUMNS,
+  DECISION_EXPORT_COLUMNS,
+  DEVELOPER_EXPORT_COLUMNS,
+  EXECUTION_EXPORT_COLUMNS,
+  KANBAN_EXPORT_COLUMNS,
+  MODEL_COST_GROUP_EXPORT_COLUMNS,
+  PERIOD_EXPORT_COLUMNS,
+  WORK_EXPORT_COLUMNS,
+} from "./ExcelExportColumns.js";
+
 export type ExcelExportInput = {
   view: string;
   filters: Readonly<Record<string, unknown>>;
@@ -22,193 +54,6 @@ export type PreparedExportPageSource = {
 };
 export const EXPORT_SUCCESS_TOAST_MS = 4_000;
 
-export const PERIOD_EXPORT_COLUMNS = [
-  "key",
-  "prds",
-  "specs",
-  "tasks",
-  "conversations",
-  "runs",
-  "tests",
-  "evidences",
-  "tokens",
-  "cost",
-  "duration_hours",
-] as const;
-
-// Work views contain PRDs, SPECs, and Tasks. Export the common, user-facing
-// fields instead of the union of their internal lifecycle projections. The
-// latter produces columns that are empty for an entire view (or nearly every
-// row), which makes the workbook much harder to use.
-export const WORK_EXPORT_COLUMNS = [
-  "type",
-  "id",
-  "title",
-  "status",
-  "risk",
-  "developers",
-  "occurred_at",
-  "duration_hours",
-  "tokens",
-  "cost_brl",
-] as const;
-
-// Execution rows are entities, not period summaries.  Keep their schema
-// aligned with the Execution table so the workbook never inherits the empty
-// PRD/SPEC/period columns shown by a different tab.
-export const EXECUTION_EXPORT_COLUMNS = [
-  "id",
-  "kind",
-  "status",
-  "origin",
-  "task_id",
-  "conversation_id",
-  "created_at",
-  "finished_at",
-  "duration_hours",
-  "tokens",
-  "cost_brl",
-  "invocations",
-] as const;
-
-export const AGENT_INVOCATION_EXPORT_COLUMNS = [
-  "run_id",
-  "execution_id",
-  "conversation_id",
-  "task_id",
-  "origin",
-  "run_role",
-  "run_purpose",
-  "phase",
-  "status",
-  "agent",
-  "provider",
-  "model",
-  "reasoning_effort",
-  "started_at",
-  "finished_at",
-  "duration_hours",
-  "input_tokens",
-  "cached_input_tokens",
-  "output_tokens",
-  "reasoning_tokens",
-  "total_tokens",
-  "estimated_usd",
-  "estimated_brl",
-] as const;
-
-export const COMPACT_LIFECYCLE_EXPORT_COLUMNS = [
-  "id",
-  "title",
-  "status",
-  "occurred_at",
-  "invocations",
-  "duration_hours",
-  "tokens",
-  "cost_brl",
-] as const;
-
-export const COST_GROUP_EXPORT_COLUMNS = [
-  "key",
-  "label",
-  "invocations",
-  "tasks",
-  "tokens",
-  "cost_usd",
-  "cost_brl",
-  "duration_hours",
-] as const;
-
-/** Agent exports count Task participation, including repeated Tasks across agents. */
-export const COST_AGENT_EXPORT_COLUMNS = [
-  "Persona",
-  "Cargo",
-  "Zaip Agentes",
-  "PRDs",
-  "SPECs",
-  "Tarefas",
-  "Runs",
-  "Testes",
-  "Evidências",
-  "Tempo",
-  "Tokens",
-  "Custos",
-] as const;
-
-/** The model audit mirrors its table: entity links precede financial facts. */
-export const MODEL_COST_GROUP_EXPORT_COLUMNS = [
-  "model",
-  "prds",
-  "specs",
-  "tasks",
-  "conversations",
-  "runs",
-  "tests",
-  "evidences",
-  "duration_hours",
-  "tokens",
-  "costs",
-] as const;
-
-// Cost Monitor developer attribution is a factual aggregate with coverage
-// counters. Keep the workbook schema aligned with that table and retain null
-// facts instead of allowing them to be inferred as zero by a spreadsheet.
-export const DEVELOPER_EXPORT_COLUMNS = [
-  "account_id",
-  "login_snapshot",
-  "prd_count",
-  "spec_count",
-  "task_count",
-  "run_count",
-  "test_count",
-  "evidence_count",
-  "total_duration_hours",
-  "total_tokens",
-  "total_cost_brl",
-  "duration_covered_runs",
-  "token_covered_runs",
-  "brl_covered_runs",
-] as const;
-
-export const CONVERSATION_EXPORT_COLUMNS = [
-  "conversation_id",
-  "status",
-  "risk",
-  "started_at",
-  "finished_at",
-  "model",
-  "reasoning_effort",
-  "invocations",
-  "duration_hours",
-  "tokens",
-  "cost_brl",
-] as const;
-
-export const CHANGE_EXPORT_COLUMNS = [
-  "id",
-  "title",
-  "status",
-  "risk",
-  "source_type",
-  "source_id",
-  "requirement_ids_json",
-  "acceptance_ids_json",
-  "task_ids_json",
-  "occurred_at",
-] as const;
-
-export const DECISION_EXPORT_COLUMNS = [
-  "id",
-  "title",
-  "origin",
-  "scope_type",
-  "scope_id",
-  "occurred_at",
-] as const;
-
-/** @deprecated Use WORK_EXPORT_COLUMNS for Kanban and Work List exports. */
-export const KANBAN_EXPORT_COLUMNS = WORK_EXPORT_COLUMNS;
-
 export async function* exportPageSourceRows(
   pageSource: PreparedExportPageSource,
   mapRows: (
@@ -253,7 +98,7 @@ export function exportWorkRows(
       numberValue(row.duration_ms) ??
       numberValue(telemetry?.duration_ms) ??
       numberValue(row.total_duration) ??
-      numberValue(metricDuration?.known_sum);
+      exportKnownMetric(metricDuration);
     return {
       type: row.kind ?? row.entity_kind,
       id: row.id,
@@ -269,13 +114,13 @@ export function exportWorkRows(
         numberValue(row.total_tokens) ??
         numberValue(telemetry?.tokens) ??
         numberValue(tokenUsage?.total) ??
-        numberValue(metricTokens?.known_sum),
+        exportKnownMetric(metricTokens),
       cost_brl:
         numberValue(row.cost_brl) ??
         numberValue(row.total_cost_brl) ??
         numberValue(telemetry?.cost_brl) ??
         numberValue(costUsage?.brl) ??
-        numberValue(metricCost?.known_sum),
+        exportKnownMetric(metricCost),
     };
   });
 }
@@ -346,6 +191,11 @@ export function exportAgentInvocationRows(
   });
 }
 
+function exportKnownMetric(metric: Record<string, unknown> | null): number | null {
+  if (metric?.complete === false && metric.coverage_ratio === 0) return null;
+  return numberValue(metric?.known_sum);
+}
+
 export function exportCompactLifecycleRows(
   rows: readonly Record<string, unknown>[],
 ): Record<string, unknown>[] {
@@ -354,7 +204,8 @@ export function exportCompactLifecycleRows(
     const duration = asRecord(metrics?.duration);
     const tokens = asRecord(metrics?.total_tokens);
     const cost = asRecord(metrics?.cost);
-    const durationMs = numberValue(duration?.known_sum) ?? numberValue(row.total_duration);
+    const durationMs =
+      duration === null ? numberValue(row.total_duration) : exportKnownMetric(duration);
     return {
       id: row.id ?? null,
       title: row.title ?? null,
@@ -362,8 +213,8 @@ export function exportCompactLifecycleRows(
       occurred_at: row.occurred_at ?? null,
       invocations: numberValue(row.run_count) ?? numberValue(row.invocation_count),
       duration_hours: durationMs === null ? null : durationMs / 3_600_000,
-      tokens: numberValue(tokens?.known_sum) ?? numberValue(row.total_tokens),
-      cost_brl: numberValue(cost?.known_sum) ?? numberValue(row.total_cost_brl),
+      tokens: tokens === null ? numberValue(row.total_tokens) : exportKnownMetric(tokens),
+      cost_brl: cost === null ? numberValue(row.total_cost_brl) : exportKnownMetric(cost),
     };
   });
 }

package/templates/.agents/dashboard/modules/operations/src/react/export/ExcelExportColumns.ts

@@ -0,0 +1,186 @@
+export const PERIOD_EXPORT_COLUMNS = [
+  "key",
+  "prds",
+  "specs",
+  "tasks",
+  "conversations",
+  "runs",
+  "tests",
+  "evidences",
+  "tokens",
+  "cost",
+  "duration_hours",
+] as const;
+
+// Work views contain PRDs, SPECs, and Tasks. Export the common, user-facing
+// fields instead of the union of their internal lifecycle projections. The
+// latter produces columns that are empty for an entire view (or nearly every
+// row), which makes the workbook much harder to use.
+export const WORK_EXPORT_COLUMNS = [
+  "type",
+  "id",
+  "title",
+  "status",
+  "risk",
+  "developers",
+  "occurred_at",
+  "duration_hours",
+  "tokens",
+  "cost_brl",
+] as const;
+
+// Execution rows are entities, not period summaries.  Keep their schema
+// aligned with the Execution table so the workbook never inherits the empty
+// PRD/SPEC/period columns shown by a different tab.
+export const EXECUTION_EXPORT_COLUMNS = [
+  "id",
+  "kind",
+  "status",
+  "origin",
+  "task_id",
+  "conversation_id",
+  "created_at",
+  "finished_at",
+  "duration_hours",
+  "tokens",
+  "cost_brl",
+  "invocations",
+] as const;
+
+export const AGENT_INVOCATION_EXPORT_COLUMNS = [
+  "run_id",
+  "execution_id",
+  "conversation_id",
+  "task_id",
+  "origin",
+  "run_role",
+  "run_purpose",
+  "phase",
+  "status",
+  "agent",
+  "provider",
+  "model",
+  "reasoning_effort",
+  "started_at",
+  "finished_at",
+  "duration_hours",
+  "input_tokens",
+  "cached_input_tokens",
+  "output_tokens",
+  "reasoning_tokens",
+  "total_tokens",
+  "estimated_usd",
+  "estimated_brl",
+] as const;
+
+export const COMPACT_LIFECYCLE_EXPORT_COLUMNS = [
+  "id",
+  "title",
+  "status",
+  "occurred_at",
+  "invocations",
+  "duration_hours",
+  "tokens",
+  "cost_brl",
+] as const;
+
+export const COST_GROUP_EXPORT_COLUMNS = [
+  "key",
+  "label",
+  "invocations",
+  "tasks",
+  "tokens",
+  "cost_usd",
+  "cost_brl",
+  "duration_hours",
+] as const;
+
+/** Agent exports count Task participation, including repeated Tasks across agents. */
+export const COST_AGENT_EXPORT_COLUMNS = [
+  "Persona",
+  "Cargo",
+  "Zaip Agentes",
+  "PRDs",
+  "SPECs",
+  "Tarefas",
+  "Runs",
+  "Testes",
+  "Evidências",
+  "Tempo",
+  "Tokens",
+  "Custos",
+] as const;
+
+/** The model audit mirrors its table: entity links precede financial facts. */
+export const MODEL_COST_GROUP_EXPORT_COLUMNS = [
+  "model",
+  "prds",
+  "specs",
+  "tasks",
+  "conversations",
+  "runs",
+  "tests",
+  "evidences",
+  "duration_hours",
+  "tokens",
+  "costs",
+] as const;
+
+// Cost Monitor developer attribution is a factual aggregate with coverage
+// counters. Keep the workbook schema aligned with that table and retain null
+// facts instead of allowing them to be inferred as zero by a spreadsheet.
+export const DEVELOPER_EXPORT_COLUMNS = [
+  "account_id",
+  "login_snapshot",
+  "prd_count",
+  "spec_count",
+  "task_count",
+  "run_count",
+  "test_count",
+  "evidence_count",
+  "total_duration_hours",
+  "total_tokens",
+  "total_cost_brl",
+  "duration_covered_runs",
+  "token_covered_runs",
+  "brl_covered_runs",
+] as const;
+
+export const CONVERSATION_EXPORT_COLUMNS = [
+  "conversation_id",
+  "status",
+  "risk",
+  "started_at",
+  "finished_at",
+  "model",
+  "reasoning_effort",
+  "invocations",
+  "duration_hours",
+  "tokens",
+  "cost_brl",
+] as const;
+
+export const CHANGE_EXPORT_COLUMNS = [
+  "id",
+  "title",
+  "status",
+  "risk",
+  "source_type",
+  "source_id",
+  "requirement_ids_json",
+  "acceptance_ids_json",
+  "task_ids_json",
+  "occurred_at",
+] as const;
+
+export const DECISION_EXPORT_COLUMNS = [
+  "id",
+  "title",
+  "origin",
+  "scope_type",
+  "scope_id",
+  "occurred_at",
+] as const;
+
+/** @deprecated Use WORK_EXPORT_COLUMNS for Kanban and Work List exports. */
+export const KANBAN_EXPORT_COLUMNS = WORK_EXPORT_COLUMNS;

package/templates/.agents/dashboard/modules/operations/src/react/export/excel-agent-participations.test.ts

@@ -0,0 +1,28 @@
+import { expect, it } from "vitest";
+import { COST_AGENT_EXPORT_COLUMNS, exportCostAgentRows } from "./ExcelExportAction.js";
+
+it("exports Agent tasks as participations and fills every missing numeric cell with zero", () => {
+  expect(COST_AGENT_EXPORT_COLUMNS).toEqual([
+    "Persona",
+    "Cargo",
+    "Zaip Agentes",
+    "PRDs",
+    "SPECs",
+    "Tarefas",
+    "Runs",
+    "Testes",
+    "Evidências",
+    "Tempo",
+    "Tokens",
+    "Custos",
+  ]);
+  const rows = exportCostAgentRows([
+    { key: "dave", task_count: 2 },
+    { key: "leo", task_count: 2 },
+    {},
+  ]);
+  expect(rows[0]?.Tarefas).toBe(2);
+  expect(rows[1]?.Tarefas).toBe(2);
+  for (const key of COST_AGENT_EXPORT_COLUMNS.slice(3)) expect(rows[2]?.[key]).toBe(0);
+  expect(rows[0]).not.toHaveProperty("tasks_created");
+});

package/templates/.agents/dashboard/modules/operations/src/react/export/export-layout.test.ts

@@ -1,5 +1,6 @@
 import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
+import { WORK_EXPORT_COLUMNS } from "./ExcelExportAction.js";
 
 const operationsPage = readFileSync(new URL("../OperationsPage.tsx", import.meta.url), "utf8");
 const operationsNavigation = readFileSync(
@@ -50,7 +51,7 @@ describe("Excel export layout", () => {
   });
 
   it("exports factual developer identities with the work-list rows", () => {
-    expect(action).toContain('"developers"');
+    expect(WORK_EXPORT_COLUMNS).toContain("developers");
     expect(action).toContain("formatDeveloperIdentities(row.developers)");
   });
 

package/templates/.agents/dashboard/modules/operations/src/react/operations-export-duration.ts

@@ -0,0 +1,13 @@
+import { applyFactualPeriodDurations } from "./PeriodSummaryTable.js";
+import type { PeriodGranularity, PeriodSummaryRow } from "./period-summary.js";
+
+/** Applies shared duration facts only to the period exports that own them. */
+export function factualDurationRowsForExport(
+  granularity: PeriodGranularity,
+  rows: readonly PeriodSummaryRow[],
+  factualRows?: readonly { key: string; duration_ms: number | null }[],
+): PeriodSummaryRow[] {
+  return granularity === "month" || granularity === "year"
+    ? applyFactualPeriodDurations(rows, factualRows)
+    : [...rows];
+}

package/templates/.agents/dashboard/modules/operations/src/react/operations-filter-panel.css

@@ -185,3 +185,7 @@
     transform: rotate(360deg);
   }
 }
+.operations-entity-filters {
+  display: grid;
+  gap: 12px;
+}

package/templates/.agents/dashboard/modules/operations/src/react/use-operation-filter-feedback.ts

@@ -0,0 +1,18 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+
+export function useOperationFilterFeedback() {
+  const [filterLoading, setFilterLoading] = useState(false);
+  const filterLoadingTimer = useRef<number | null>(null);
+  const showFilterLoading = useCallback(() => {
+    setFilterLoading(true);
+    if (filterLoadingTimer.current !== null) window.clearTimeout(filterLoadingTimer.current);
+    filterLoadingTimer.current = window.setTimeout(() => setFilterLoading(false), 220);
+  }, []);
+  useEffect(
+    () => () => {
+      if (filterLoadingTimer.current !== null) window.clearTimeout(filterLoadingTimer.current);
+    },
+    [],
+  );
+  return { filterLoading, showFilterLoading };
+}

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

@@ -212,6 +212,17 @@ describe("unified work board stages", () => {
     });
   });
 
+  it("retains canonical progress when linked Tasks are outside the loaded board page", () => {
+    const spec = {
+      ...macro("spec", "active", "executing"),
+      id: "SPEC-1",
+      task_ids: ["TASK-1", "TASK-2"],
+      task_count: 2,
+      quality: { completed_tasks: 1 },
+    } as MacroProjection;
+    expect(macroWorkProgress(spec, [spec], [])).toMatchObject({ completedTasks: 1, totalTasks: 2 });
+  });
+
   it("summarizes only the Tasks that belong to a standalone SPEC", () => {
     const spec = { ...macro("spec", "active", "executing"), id: "SPEC-1", task_ids: ["TASK-1"] };
     const tasks = [