@zaip-ai/cli 1.3.2 → 1.3.5

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

@@ -25,6 +25,7 @@ export {
 
 import {
   dateRangeForPreset,
+  factualCostDateRange,
   initialOperationsDateRange,
   isDateInOperationPreset,
   isRunInOperationPreset,
@@ -130,10 +131,13 @@ export function OperationsPage({
   const [filterLoading, setFilterLoading] = useState(false);
   const filterLoadingTimer = useRef<number | null>(null);
   const searchInputRef = useRef<HTMLInputElement>(null);
-  const defaultDateRange = useMemo(
-    () => initialOperationsDateRange(data.tasks, Object.keys(data.summary.periods?.daily ?? {})),
-    [data.summary.periods, data.tasks],
-  );
+  const defaultDateRange = useMemo(() => {
+    const operationsRange = initialOperationsDateRange(
+      data.tasks,
+      Object.keys(data.summary.periods?.daily ?? {}),
+    );
+    return factualCostDateRange(factualCostPeriods?.day, operationsRange);
+  }, [data.summary.periods, data.tasks, factualCostPeriods?.day]);
   const initialDateRange = useMemo(() => dateRangeForPreset("this-month"), []);
   const [localDateRange, setLocalDateRange] = useState(() => initialDateRange);
   const [localDatePreset, setLocalDatePreset] = useState<OperationDatePreset>("all");
@@ -156,6 +160,17 @@ 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]);

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

@@ -3,11 +3,13 @@ import {
   AGENT_INVOCATION_EXPORT_COLUMNS,
   COMPACT_LIFECYCLE_EXPORT_COLUMNS,
   COST_GROUP_EXPORT_COLUMNS,
+  DEVELOPER_EXPORT_COLUMNS,
   EXECUTION_EXPORT_COLUMNS,
   EXPORT_SUCCESS_TOAST_MS,
   exportAgentInvocationRows,
   exportCompactLifecycleRows,
   exportCostGroupRows,
+  exportDeveloperRows,
   exportExecutionRows,
   exportHeadersForView,
   exportPageSourceRows,
@@ -198,6 +200,63 @@ it("uses the compact work schema for Kanban and Work List", () => {
   ]);
 });
 
+it("exports developer attribution with its factual schema and unavailable metrics intact", () => {
+  expect(DEVELOPER_EXPORT_COLUMNS).toEqual([
+    "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",
+  ]);
+  expect(
+    exportDeveloperRows([
+      {
+        account_id: "42",
+        login_snapshot: "dev-42",
+        prd_count: 1,
+        spec_count: 2,
+        task_count: 3,
+        run_count: 4,
+        test_count: null,
+        evidence_count: null,
+        total_duration_ms: null,
+        total_tokens: null,
+        total_cost_brl: 1.5,
+        duration_covered_runs: 0,
+        token_covered_runs: 0,
+        brl_covered_runs: 4,
+      },
+    ]),
+  ).toEqual([
+    {
+      account_id: "42",
+      login_snapshot: "dev-42",
+      prd_count: 1,
+      spec_count: 2,
+      task_count: 3,
+      run_count: 4,
+      test_count: null,
+      evidence_count: null,
+      total_duration_hours: null,
+      total_tokens: null,
+      total_cost_brl: 1.5,
+      duration_covered_runs: 0,
+      token_covered_runs: 0,
+      brl_covered_runs: 4,
+    },
+  ]);
+  expect(exportHeadersForView("cost-developers", [])).toEqual(DEVELOPER_EXPORT_COLUMNS);
+});
+
 it("normalizes Tasks and macros into the same populated work columns", () => {
   expect(
     exportWorkRows([

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

@@ -118,6 +118,26 @@ export const COST_GROUP_EXPORT_COLUMNS = [
   "duration_hours",
 ] 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",
@@ -334,6 +354,31 @@ export function exportCostGroupRows(
   });
 }
 
+/** Normalize Cost Monitor developer facts into the fixed XLSX schema. */
+export function exportDeveloperRows(
+  rows: readonly Record<string, unknown>[],
+): Record<string, unknown>[] {
+  return rows.map((row) => {
+    const durationMs = numberValue(row.total_duration_ms);
+    return {
+      account_id: row.account_id ?? null,
+      login_snapshot: row.login_snapshot ?? null,
+      prd_count: numberValue(row.prd_count),
+      spec_count: numberValue(row.spec_count),
+      task_count: numberValue(row.task_count),
+      run_count: numberValue(row.run_count),
+      test_count: numberValue(row.test_count),
+      evidence_count: numberValue(row.evidence_count),
+      total_duration_hours: durationMs === null ? null : durationMs / 3_600_000,
+      total_tokens: numberValue(row.total_tokens),
+      total_cost_brl: numberValue(row.total_cost_brl),
+      duration_covered_runs: numberValue(row.duration_covered_runs),
+      token_covered_runs: numberValue(row.token_covered_runs),
+      brl_covered_runs: numberValue(row.brl_covered_runs),
+    };
+  });
+}
+
 export function exportConversationRows(
   rows: readonly Record<string, unknown>[],
 ): Record<string, unknown>[] {
@@ -480,6 +525,7 @@ export function exportHeadersForView(
   const isCompactLifecycleView =
     /-(?:tasks|specs|prds|conversations)$/.test(view) && !isOperationsConversationView;
   const isCostGroupView = /-(?:agents|models|providers)$/.test(view);
+  const isDeveloperView = view === "cost-developers";
   const isChangeView = view === "operations-changes";
   const isDecisionView = view === "operations-decisions";
   if (isPeriodView) headers.push(...PERIOD_EXPORT_COLUMNS);
@@ -489,6 +535,7 @@ export function exportHeadersForView(
   if (isAgentInvocationView) headers.push(...AGENT_INVOCATION_EXPORT_COLUMNS);
   if (isCompactLifecycleView) headers.push(...COMPACT_LIFECYCLE_EXPORT_COLUMNS);
   if (isCostGroupView) headers.push(...COST_GROUP_EXPORT_COLUMNS);
+  if (isDeveloperView) headers.push(...DEVELOPER_EXPORT_COLUMNS);
   if (isOperationsConversationView) headers.push(...CONVERSATION_EXPORT_COLUMNS);
   if (isChangeView) headers.push(...CHANGE_EXPORT_COLUMNS);
   if (isDecisionView) headers.push(...DECISION_EXPORT_COLUMNS);
@@ -502,6 +549,7 @@ export function exportHeadersForView(
     isAgentInvocationView ||
     isCompactLifecycleView ||
     isCostGroupView ||
+    isDeveloperView ||
     isOperationsConversationView ||
     isChangeView ||
     isDecisionView;
@@ -545,6 +593,7 @@ export function ExcelExportAction({ filters, pageSource, rows, view }: ExcelExpo
   const isCompactLifecycleView =
     /-(?:tasks|specs|prds|conversations)$/.test(view) && !isOperationsConversationView;
   const isCostGroupView = /-(?:agents|models|providers)$/.test(view);
+  const isDeveloperView = view === "cost-developers";
   const isChangeView = view === "operations-changes";
   const isDecisionView = view === "operations-decisions";
   const createSnapshot = async () => {
@@ -584,7 +633,9 @@ export function ExcelExportAction({ filters, pageSource, rows, view }: ExcelExpo
                             ? exportCompactLifecycleRows
                             : isCostGroupView
                               ? exportCostGroupRows
-                              : exportRowsWithDurationHours,
+                              : isDeveloperView
+                                ? exportDeveloperRows
+                                : exportRowsWithDurationHours,
           );
           return;
         }
@@ -610,7 +661,9 @@ export function ExcelExportAction({ filters, pageSource, rows, view }: ExcelExpo
                             ? exportCompactLifecycleRows
                             : isCostGroupView
                               ? exportCostGroupRows
-                              : exportRowsWithDurationHours
+                              : isDeveloperView
+                                ? exportDeveloperRows
+                                : exportRowsWithDurationHours
           )(rows.slice(offset, offset + 500));
       },
     });

package/templates/.agents/dashboard/modules/operations/src/react/operation-date-range.test.ts

@@ -1,6 +1,7 @@
 import { describe, expect, it } from "vitest";
 import {
   dateRangeForPreset,
+  factualCostDateRange,
   initialOperationsDateRange,
   initialTaskDateRange,
   isDateInOperationPreset,
@@ -34,6 +35,30 @@ describe("operation date ranges", () => {
     });
   });
 
+  it("uses the first factual Cost Monitor day for All Time while ending today", () => {
+    expect(
+      factualCostDateRange(
+        [
+          { key: "2026-06-01", estimated_brl: null, estimated_usd: null },
+          { key: "2026-06-02", estimated_brl: 0, estimated_usd: 0 },
+          { key: "2026-06-03", estimated_brl: 1.25, estimated_usd: 0.24 },
+        ],
+        { start: "2026-07-10", end: "2026-07-14" },
+        today,
+      ),
+    ).toEqual({ start: "2026-06-02", end: "2026-07-14" });
+  });
+
+  it("keeps the Operations range when no factual Cost Monitor day is available", () => {
+    expect(
+      factualCostDateRange(
+        [{ key: "2026-06-01", estimated_brl: null, estimated_usd: null }],
+        { start: "2026-07-10", end: "2026-07-14" },
+        today,
+      ),
+    ).toEqual({ start: "2026-07-10", end: "2026-07-14" });
+  });
+
   it.each([
     ["today", "2026-07-14", "2026-07-14"],
     ["yesterday", "2026-07-13", "2026-07-13"],

package/templates/.agents/dashboard/modules/operations/src/react/operation-date-range.ts

@@ -17,6 +17,35 @@ export interface OperationDateRange {
   end: string;
 }
 
+/** A daily Cost Monitor group with a factual monetary measurement. */
+export interface FactualCostDay {
+  key: string;
+  estimated_brl: number | null;
+  estimated_usd: number | null;
+}
+
+/**
+ * All Time is unbounded for requests, but its disabled date controls should
+ * describe the actual Cost Monitor coverage rather than an Operations record.
+ */
+export function factualCostDateRange(
+  days: readonly FactualCostDay[] | undefined,
+  fallback: OperationDateRange,
+  today = new Date(),
+): OperationDateRange {
+  const firstMeasuredDay = days
+    ?.map((day) => day.key)
+    .filter(
+      (key, index, keys) =>
+        /^\d{4}-\d{2}-\d{2}$/.test(key) &&
+        (days[index]!.estimated_brl !== null || days[index]!.estimated_usd !== null),
+    )
+    .sort()[0];
+  return firstMeasuredDay === undefined
+    ? fallback
+    : { start: firstMeasuredDay, end: toDateInputValue(today) };
+}
+
 export function initialTaskDateRange(
   tasks: readonly { created_at: string }[],
   today = new Date(),

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

@@ -36,7 +36,7 @@ describe("Operations persisted aggregate display", () => {
     expect(totals).toMatchObject({ duration_ms: null, tokens: 0, cost_brl: 0 });
   });
 
-  it("preserves unavailable aggregate totals instead of rendering coerced zeroes", () => {
+  it("preserves unavailable aggregate totals and renders zero only for an empty population", () => {
     const overview = readFileSync(new URL("OperationsOverview.tsx", import.meta.url), "utf8");
 
     expect(overview).toContain("overviewMetrics?.duration_ms ??");
@@ -48,7 +48,8 @@ describe("Operations persisted aggregate display", () => {
     expect(overview).toContain(
       "durationMs: totalDurationMetric, tokens: totalTokensMetric, costBrl: totalCostMetric",
     );
-    expect(overview).toContain("formatEntityDuration(averageDuration, locale)");
+    expect(overview).toContain("formatSummaryMetricValue(\n        averageDuration,");
+    expect(overview).toContain('populationCount === 0 ? "0"');
     expect(overview).not.toContain("allPhaseMetrics.tokens ?? 0");
     expect(overview).not.toContain("executionMetrics.durationMs ?? 0");
   });

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

@@ -50,6 +50,15 @@ describe("overview period filter", () => {
     expect(shouldRenderOperationsContent(true)).toBe(false);
   });
 
+  it("synchronizes the controlled All Time display after factual cost coverage arrives", () => {
+    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");
+  });
+
   it("derives all big-number KPIs from the period-filtered global aggregate", () => {
     const source = readFileSync(new URL("OperationsOverview.tsx", import.meta.url), "utf8");
     const helpers = readFileSync(
@@ -81,8 +90,9 @@ describe("overview period filter", () => {
 
     expect(source).toContain('currency: "BRL" | "USD"');
     expect(source).toContain("const selectedCurrencyCost =");
-    expect(source).toContain("formatCurrency(averageCost, currency, locale)");
-    expect(source).toContain("formatRoundedCurrency(totalCostMetric, currency, locale)");
+    expect(source).toContain("formatCurrency(value, currency, locale)");
+    expect(source).toContain("formatSummaryMetricValue(\n            totalCostMetric,");
+    expect(source).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)");