@zaip-ai/cli 3.3.0 → 3.4.0

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 = [

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

@@ -52,8 +52,16 @@ export function macroWorkProgress(
   return {
     completedSpecs: childSpecs.filter(isCompletedMacro).length,
     totalSpecs: childSpecs.length,
-    completedTasks: childTasks.filter((task) => task.status === "completed").length,
-    totalTasks: Math.max(childTasks.length, row.planned_tasks.length),
+    completedTasks: Math.max(
+      childTasks.filter((task) => task.status === "completed").length,
+      row.quality?.completed_tasks ?? 0,
+    ),
+    totalTasks: Math.max(
+      childTasks.length,
+      taskIds.size,
+      row.planned_tasks.length,
+      row.task_count ?? 0,
+    ),
   };
 }
 

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

@@ -67,7 +67,7 @@ export function macroWorkStage(
   if (row.work_status === "executing") {
     const children = tasks.filter((task) => row.task_ids.includes(task.id));
     if (
-      children.some((task) => task.status === "verifying") &&
+      children.length > 0 &&
       children.every((task) => task.status === "verifying" || task.status === "completed")
     )
       return "verifying";

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

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-contracts",
-  "version": "3.3.0",
+  "version": "3.4.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": "3.3.0",
+  "version": "3.4.0",
   "private": true,
   "type": "module",
   "exports": {