@zaip-ai/cli 1.0.7 → 1.3.0

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

@@ -1,5 +1,21 @@
 import { describe, expect, it } from "vitest";
-import { EXPORT_SUCCESS_TOAST_MS, exportRowsWithDurationHours } from "./ExcelExportAction.js";
+import {
+  AGENT_INVOCATION_EXPORT_COLUMNS,
+  COMPACT_LIFECYCLE_EXPORT_COLUMNS,
+  COST_GROUP_EXPORT_COLUMNS,
+  EXECUTION_EXPORT_COLUMNS,
+  EXPORT_SUCCESS_TOAST_MS,
+  exportAgentInvocationRows,
+  exportCompactLifecycleRows,
+  exportCostGroupRows,
+  exportExecutionRows,
+  exportHeadersForView,
+  exportPageSourceRows,
+  exportRowsWithDurationHours,
+  exportWorkRows,
+  KANBAN_EXPORT_COLUMNS,
+  WORK_EXPORT_COLUMNS,
+} from "./ExcelExportAction.js";
 
 describe("ExcelExportAction duration mapper", () => {
   it("exports millisecond durations as unrounded numeric base hours with explicit hour headers", () => {
@@ -21,12 +37,426 @@ describe("ExcelExportAction duration mapper", () => {
       },
     ]);
   });
+
+  it("maps populated monthly facts to fixed XLSX columns and retains unavailable values as null", () => {
+    expect(
+      exportRowsWithDurationHours([
+        {
+          key: "2026-07",
+          prds: 12,
+          specs: 58,
+          tasksCreated: 648,
+          runs: 1419,
+          tests: 2,
+          evidences: 547,
+          durationMs: 7_200_000,
+          tokens: 5_490_000_000,
+          costBrl: 36_925.24,
+        },
+        { key: "2026-08", durationMs: null, costBrl: null },
+      ]),
+    ).toEqual([
+      {
+        key: "2026-07",
+        prds: 12,
+        specs: 58,
+        tasks: 648,
+        runs: 1419,
+        tests: 2,
+        evidences: 547,
+        duration_hours: 2,
+        tokens: 5_490_000_000,
+        cost: 36_925.24,
+      },
+      {
+        key: "2026-08",
+        prds: undefined,
+        specs: undefined,
+        tasks: undefined,
+        runs: undefined,
+        tests: undefined,
+        evidences: undefined,
+        duration_hours: null,
+        tokens: undefined,
+        cost: null,
+      },
+    ]);
+  });
+
+  it("maps the canonical annual SQLite aliases into populated period columns", () => {
+    expect(
+      exportRowsWithDurationHours([
+        {
+          period_key: "2026",
+          prd_count: 13,
+          spec_count: 59,
+          task_count: 920,
+          total_run_count: 1_751,
+          validation_count: 17,
+          evidence_count: 648,
+          operations_total_duration: 619_958_763,
+          total_tokens: 7_342_609_361,
+          total_cost_brl: 47_588.9452,
+        },
+      ]),
+    ).toEqual([
+      {
+        key: "2026",
+        prds: 13,
+        specs: 59,
+        tasks: 920,
+        runs: 1_751,
+        tests: 17,
+        evidences: 648,
+        duration_hours: 172.2107675,
+        tokens: 7_342_609_361,
+        cost: 47_588.9452,
+      },
+    ]);
+  });
+});
+
+it("exports every paginated row once instead of only the visible page", async () => {
+  const exported: Record<string, unknown>[] = [];
+  for await (const page of exportPageSourceRows({
+    totalRows: 3,
+    pages: async function* () {
+      yield [
+        { id: "A", duration_ms: 3_600_000 },
+        { id: "B", duration_ms: 7_200_000 },
+      ];
+      yield [
+        { id: "B", duration_ms: 7_200_000 },
+        { id: "C", duration_ms: 10_800_000 },
+      ];
+    },
+  }))
+    exported.push(...page);
+
+  expect(exported).toEqual([
+    { id: "A", duration_hours: 1 },
+    { id: "B", duration_hours: 2 },
+    { id: "C", duration_hours: 3 },
+  ]);
+});
+
+it("exports a complete paginated annual snapshot with factual numeric duration hours", async () => {
+  const exported: Record<string, unknown>[] = [];
+  for await (const page of exportPageSourceRows({
+    totalRows: 3,
+    pages: async function* () {
+      yield [
+        { key: "2026", run_count: 2, duration_ms: 7_200_000 },
+        { key: "2025", run_count: 1, duration_ms: null },
+      ];
+      yield [
+        { key: "2025", run_count: 1, duration_ms: null },
+        { key: "2024", run_count: 3, duration_ms: 3_600_000 },
+      ];
+    },
+  }))
+    exported.push(...exportRowsWithDurationHours(page));
+
+  expect(exported).toEqual([
+    expect.objectContaining({ key: "2026", runs: 2, duration_hours: 2 }),
+    expect.objectContaining({ key: "2025", runs: 1, duration_hours: null }),
+    expect.objectContaining({ key: "2024", runs: 3, duration_hours: 1 }),
+  ]);
 });
 
 it("keeps success feedback duration at four seconds", () => {
   expect(EXPORT_SUCCESS_TOAST_MS).toBe(4_000);
 });
 
+it("uses a prepared total when rows continue beyond the visible first fold", async () => {
+  const prepared = {
+    totalRows: 3,
+    pages: async function* () {
+      yield [{ id: "first" }];
+      yield [{ id: "beyond-first-fold" }, { id: "last" }];
+    },
+  };
+  const rows: Record<string, unknown>[] = [];
+  for await (const page of exportPageSourceRows(prepared)) rows.push(...page);
+  expect(rows.map((row) => row.id)).toEqual(["first", "beyond-first-fold", "last"]);
+  expect(prepared.totalRows).toBe(3);
+});
+
+it("uses the compact work schema for Kanban and Work List", () => {
+  expect(KANBAN_EXPORT_COLUMNS).toEqual(WORK_EXPORT_COLUMNS);
+  expect(WORK_EXPORT_COLUMNS).toEqual([
+    "type",
+    "id",
+    "title",
+    "status",
+    "risk",
+    "occurred_at",
+    "duration_hours",
+    "tokens",
+    "cost_brl",
+  ]);
+});
+
+it("normalizes Tasks and macros into the same populated work columns", () => {
+  expect(
+    exportWorkRows([
+      {
+        kind: "task",
+        id: "TASK-1",
+        title: "Export Task",
+        status: "executing",
+        risk: "standard",
+        occurred_at: "2026-08-21T00:00:00.000Z",
+        telemetry: { duration_ms: 3_600_000, tokens: 123, cost_brl: 4.5 },
+      },
+      {
+        kind: "spec",
+        id: "SPEC-1",
+        title: "Export Spec",
+        work_status: "planning",
+        occurred_at: "2026-08-20T00:00:00.000Z",
+        total_duration: 7_200_000,
+        total_tokens: 456,
+        total_cost_brl: 7.5,
+      },
+      {
+        kind: "prd",
+        id: "PRD-1",
+        title: "Export PRD",
+        status: "ready",
+        occurred_at: "2026-08-19T00:00:00.000Z",
+        metrics: {
+          duration: { known_sum: 10_800_000 },
+          total_tokens: { known_sum: 789 },
+          cost: { known_sum: 9.5 },
+        },
+      },
+    ]),
+  ).toEqual([
+    {
+      type: "task",
+      id: "TASK-1",
+      title: "Export Task",
+      status: "executing",
+      risk: "standard",
+      occurred_at: "2026-08-21T00:00:00.000Z",
+      duration_hours: 1,
+      tokens: 123,
+      cost_brl: 4.5,
+    },
+    {
+      type: "spec",
+      id: "SPEC-1",
+      title: "Export Spec",
+      status: "planning",
+      risk: null,
+      occurred_at: "2026-08-20T00:00:00.000Z",
+      duration_hours: 2,
+      tokens: 456,
+      cost_brl: 7.5,
+    },
+    {
+      type: "prd",
+      id: "PRD-1",
+      title: "Export PRD",
+      status: "ready",
+      risk: null,
+      occurred_at: "2026-08-19T00:00:00.000Z",
+      duration_hours: 3,
+      tokens: 789,
+      cost_brl: 9.5,
+    },
+  ]);
+});
+
+it("uses populated entity columns for executions instead of period-summary columns", () => {
+  expect(EXECUTION_EXPORT_COLUMNS).toEqual([
+    "id",
+    "kind",
+    "status",
+    "origin",
+    "task_id",
+    "conversation_id",
+    "created_at",
+    "finished_at",
+    "duration_hours",
+    "tokens",
+    "cost_brl",
+    "invocations",
+  ]);
+  expect(
+    exportExecutionRows([
+      {
+        execution_id: "EXEC-42",
+        execution_kind: "delivery",
+        status: "completed",
+        origin_type: "task",
+        task_id: "TASK-42",
+        started_at: "2026-08-21T00:00:00.000Z",
+        finished_at: "2026-08-21T01:00:00.000Z",
+        duration_ms: 3_600_000,
+        total_tokens: 123,
+        total_cost_brl: 4.5,
+        invocation_count: 2,
+      },
+    ]),
+  ).toEqual([
+    {
+      id: "EXEC-42",
+      kind: "delivery",
+      status: "completed",
+      origin: "task",
+      task_id: "TASK-42",
+      conversation_id: null,
+      created_at: "2026-08-21T00:00:00.000Z",
+      finished_at: "2026-08-21T01:00:00.000Z",
+      duration_hours: 1,
+      tokens: 123,
+      cost_brl: 4.5,
+      invocations: 2,
+    },
+  ]);
+});
+
+it("exports Agent Invocations with populated fields instead of the result fallback", () => {
+  expect(AGENT_INVOCATION_EXPORT_COLUMNS).not.toContain("result");
+  expect(
+    exportAgentInvocationRows([
+      {
+        run_id: "RUN-42",
+        execution_id: "EXEC-42",
+        task_id: "TASK-42",
+        origin: "task",
+        run_role: "orchestrator",
+        run_purpose: "execution",
+        phase: "execution",
+        status: "completed",
+        agent: "zaip-agent-task-executor",
+        provider: "openai",
+        model: "gpt-5.6-terra",
+        started_at: "2026-08-21T00:00:00.000Z",
+        duration_ms: 3_600_000,
+        total_tokens: 123,
+        estimated_usd: 0.1,
+        estimated_brl: 0.5,
+      },
+    ]),
+  ).toEqual([
+    expect.objectContaining({
+      run_id: "RUN-42",
+      duration_hours: 1,
+      total_tokens: 123,
+      estimated_usd: 0.1,
+      estimated_brl: 0.5,
+    }),
+  ]);
+});
+
+it("exports compact Task, SPEC, PRD, and Conversation rows with entity columns", () => {
+  expect(COMPACT_LIFECYCLE_EXPORT_COLUMNS).toEqual([
+    "id",
+    "title",
+    "status",
+    "occurred_at",
+    "invocations",
+    "duration_hours",
+    "tokens",
+    "cost_brl",
+  ]);
+  expect(
+    exportCompactLifecycleRows([
+      {
+        id: "TASK-42",
+        title: "Export",
+        kind: "task",
+        status: "completed",
+        risk: "standard",
+        occurred_at: "2026-08-21T00:00:00.000Z",
+        parent_id: null,
+        run_count: 2,
+        metrics: {
+          duration: { known_sum: 3_600_000 },
+          total_tokens: { known_sum: 123 },
+          cost: { known_sum: 4.5 },
+        },
+      },
+    ]),
+  ).toEqual([
+    {
+      id: "TASK-42",
+      title: "Export",
+      status: "completed",
+      occurred_at: "2026-08-21T00:00:00.000Z",
+      invocations: 2,
+      duration_hours: 1,
+      tokens: 123,
+      cost_brl: 4.5,
+    },
+  ]);
+});
+
+it("keeps cost-executions headers and exported row keys in the compact lifecycle schema", () => {
+  const source = {
+    id: "RUN-42",
+    title: "Cost execution",
+    status: "completed",
+    occurred_at: "2026-08-21T00:00:00.000Z",
+    parent_id: "raw-parent-must-not-export",
+    raw_duration_ms: 99_999,
+    metrics: {
+      duration: { known_sum: 3_600_000 },
+      total_tokens: { known_sum: 123 },
+      cost: { known_sum: 4.5 },
+    },
+  };
+  const rows = exportCompactLifecycleRows([source]);
+  expect(exportHeadersForView("cost-executions", [source])).toEqual(
+    COMPACT_LIFECYCLE_EXPORT_COLUMNS,
+  );
+  expect(Object.keys(rows[0] ?? {})).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
+});
+
+it("does not append raw keys to any explicitly schema-bound Cost view", () => {
+  const raw = [{ id: "ROW-1", internal_only: "must-not-be-a-header" }];
+  expect(exportHeadersForView("cost-tasks", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
+  expect(exportHeadersForView("cost-specs", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
+  expect(exportHeadersForView("cost-prds", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
+  expect(exportHeadersForView("cost-conversations", raw)).toEqual(COMPACT_LIFECYCLE_EXPORT_COLUMNS);
+  expect(exportHeadersForView("cost-agents", raw)).toEqual(COST_GROUP_EXPORT_COLUMNS);
+  expect(exportHeadersForView("cost-agent-calls", raw)).toEqual(AGENT_INVOCATION_EXPORT_COLUMNS);
+  expect(exportHeadersForView("operations-conversations", raw)).toEqual(
+    expect.not.arrayContaining(["internal_only"]),
+  );
+});
+
+it("exports model, provider, and ZAIP Agent groups with their populated metrics", () => {
+  expect(COST_GROUP_EXPORT_COLUMNS).not.toContain("result");
+  expect(
+    exportCostGroupRows([
+      {
+        key: "gpt-5.6-terra",
+        label: "gpt-5.6-terra",
+        run_count: 3,
+        task_count: 1,
+        prd_count: 1,
+        spec_count: 1,
+        total_tokens: 123,
+        estimated_usd: 0.1,
+        estimated_brl: 0.5,
+        duration_ms: 3_600_000,
+      },
+    ]),
+  ).toEqual([
+    expect.objectContaining({
+      key: "gpt-5.6-terra",
+      invocations: 3,
+      tokens: 123,
+      cost_brl: 0.5,
+      duration_hours: 1,
+    }),
+  ]);
+});
+
 it("clears pending success when a new export starts", () => {
   expect("running").not.toBe("completed");
 });