@zaip-ai/cli 1.0.8 → 1.3.1

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CompactLifecycleCostTable.test.ts

@@ -8,21 +8,47 @@ describe("CompactLifecycleCostTable filtered subtotal", () => {
   it("renders the server subtotal as the final DataTable row with all metrics", () => {
     const view = CompactLifecycleCostTable({
       locale: "pt-BR",
-      rows: [{
-        id: "TASK-PAGE-50", title: "Página 2", kind: "task", status: "active", risk: null,
-        occurred_at: "2026-08-04T12:00:00.000Z", parent_id: null, run_count: 1, cost_currency: "BRL",
-        metrics: { duration: known(1_000), total_tokens: known(2), cost: known(5) },
-      }],
+      rows: [
+        {
+          id: "TASK-PAGE-50",
+          title: "Página 2",
+          kind: "task",
+          status: "active",
+          risk: null,
+          occurred_at: "2026-08-04T12:00:00.000Z",
+          parent_id: null,
+          run_count: 1,
+          cost_currency: "BRL",
+          metrics: { duration: known(1_000), total_tokens: known(2), cost: known(5) },
+        },
+      ],
       subtotal: {
         entity_count: 270,
         run_count: known(270),
-        metrics: { duration: known(270_000), total_tokens: known(540), cost_brl: known(1_350), cost_usd: known(270) },
+        metrics: {
+          duration: known(270_000),
+          total_tokens: known(540),
+          cost_brl: known(1_350),
+          cost_usd: known(270),
+        },
+      },
+      pagination: {
+        offset: 50,
+        limit: 50,
+        total: 270,
+        has_more: true,
+        loading: false,
+        error: null,
+        onChange: () => undefined,
+        onRetry: () => undefined,
       },
-      pagination: { offset: 50, limit: 50, total: 270, has_more: true, loading: false, error: null, onChange: () => undefined, onRetry: () => undefined },
     });
-    const [table] = view.props.children as readonly { props: { columns: Array<{ key: string; footer?: unknown }> } }[];
+    const [table] = view.props.children as readonly {
+      props: { columns: Array<{ key: string; footer?: unknown }> };
+    }[];
     expect(table).toBeDefined();
-    const footer = (key: string) => table!.props.columns.find((column) => column.key === key)?.footer;
+    const footer = (key: string) =>
+      table!.props.columns.find((column) => column.key === key)?.footer;
     expect(footer("occurredAt")).toContain("Subtotal filtrado");
     expect(footer("entity")).toBe("270");
     expect(footer("runs")).toBe("270");
@@ -34,13 +60,35 @@ describe("CompactLifecycleCostTable filtered subtotal", () => {
 
   it("renders unknown numeric subtotals as zero", () => {
     const view = CompactLifecycleCostTable({
-      locale: "pt-BR", rows: [],
-      subtotal: { entity_count: 0, run_count: known(0), metrics: { duration: unavailable, total_tokens: known(0), cost_brl: known(0), cost_usd: unavailable } },
-      pagination: { offset: 0, limit: 50, total: 0, has_more: false, loading: false, error: null, onChange: () => undefined, onRetry: () => undefined },
+      locale: "pt-BR",
+      rows: [],
+      subtotal: {
+        entity_count: 0,
+        run_count: known(0),
+        metrics: {
+          duration: unavailable,
+          total_tokens: known(0),
+          cost_brl: known(0),
+          cost_usd: unavailable,
+        },
+      },
+      pagination: {
+        offset: 0,
+        limit: 50,
+        total: 0,
+        has_more: false,
+        loading: false,
+        error: null,
+        onChange: () => undefined,
+        onRetry: () => undefined,
+      },
     });
-    const [table] = view.props.children as readonly { props: { columns: Array<{ key: string; footer?: unknown }> } }[];
+    const [table] = view.props.children as readonly {
+      props: { columns: Array<{ key: string; footer?: unknown }> };
+    }[];
     expect(table).toBeDefined();
-    const footer = (key: string) => table!.props.columns.find((column) => column.key === key)?.footer;
+    const footer = (key: string) =>
+      table!.props.columns.find((column) => column.key === key)?.footer;
     expect(footer("runs")).toBe("0");
     expect(footer("tokens")).toBe("0");
     expect(footer("duration")).toBe("0");
@@ -48,12 +96,34 @@ describe("CompactLifecycleCostTable filtered subtotal", () => {
 
   it("does not render a subtotal row when all lifecycle metrics are unavailable", () => {
     const view = CompactLifecycleCostTable({
-      locale: "pt-BR", rows: [],
-      subtotal: { entity_count: 1, run_count: unavailable, metrics: { duration: unavailable, total_tokens: unavailable, cost_brl: unavailable, cost_usd: unavailable } },
-      pagination: { offset: 0, limit: 50, total: 0, has_more: false, loading: false, error: null, onChange: () => undefined, onRetry: () => undefined },
+      locale: "pt-BR",
+      rows: [],
+      subtotal: {
+        entity_count: 1,
+        run_count: unavailable,
+        metrics: {
+          duration: unavailable,
+          total_tokens: unavailable,
+          cost_brl: unavailable,
+          cost_usd: unavailable,
+        },
+      },
+      pagination: {
+        offset: 0,
+        limit: 50,
+        total: 0,
+        has_more: false,
+        loading: false,
+        error: null,
+        onChange: () => undefined,
+        onRetry: () => undefined,
+      },
     });
-    const [table] = view.props.children as readonly { props: { columns: Array<{ key: string; footer?: unknown }> } }[];
-    const footer = (key: string) => table!.props.columns.find((column) => column.key === key)?.footer;
+    const [table] = view.props.children as readonly {
+      props: { columns: Array<{ key: string; footer?: unknown }> };
+    }[];
+    const footer = (key: string) =>
+      table!.props.columns.find((column) => column.key === key)?.footer;
     expect(footer("occurredAt")).toBeUndefined();
     expect(footer("entity")).toBeUndefined();
     expect(footer("runs")).toBeUndefined();

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CompactLifecycleCostTable.tsx

@@ -88,8 +88,7 @@ export function CompactLifecycleCostTable({
   const durationMetric = (row: CompactLifecycleCostRow) => {
     const value = row.metrics.duration;
     const effective = compactLifecycleDurationMs(row);
-    if (effective === null || (value.unknown > 0 && effective === 0))
-      return "0";
+    if (effective === null || (value.unknown > 0 && effective === 0)) return "0";
     return formatDurationMs(effective, locale);
   };
   const subtotalMetric = (value: KnownMetric, format: (known: number) => string) => {
@@ -98,21 +97,24 @@ export function CompactLifecycleCostTable({
   };
   const subtotalMetricUnavailable = (value: KnownMetric) =>
     value.unknown > 0 && value.known_sum === 0;
-  const showSubtotal = subtotal !== null && ![
-    subtotal.run_count,
-    subtotal.metrics.duration,
-    subtotal.metrics.total_tokens,
-    subtotal.metrics.cost_brl,
-  ].every(subtotalMetricUnavailable);
+  const showSubtotal =
+    subtotal !== null &&
+    ![
+      subtotal.run_count,
+      subtotal.metrics.duration,
+      subtotal.metrics.total_tokens,
+      subtotal.metrics.cost_brl,
+    ].every(subtotalMetricUnavailable);
   const number = (value: number) => new Intl.NumberFormat(locale).format(value);
   const subtotalLabel = !showSubtotal
     ? undefined
     : subtotal === null
-    ? "Total"
-    : `${locale === "pt-BR" ? "Subtotal filtrado" : "Filtered subtotal"} · ${number(subtotal.entity_count)} ${locale === "pt-BR" ? "registros" : "records"}`;
-  const subtotalCost = !showSubtotal || subtotal === null
-    ? undefined
-    : subtotalMetric(subtotal.metrics.cost_brl, (brl) => formatCurrency(brl, "BRL", locale));
+      ? "Total"
+      : `${locale === "pt-BR" ? "Subtotal filtrado" : "Filtered subtotal"} · ${number(subtotal.entity_count)} ${locale === "pt-BR" ? "registros" : "records"}`;
+  const subtotalCost =
+    !showSubtotal || subtotal === null
+      ? undefined
+      : subtotalMetric(subtotal.metrics.cost_brl, (brl) => formatCurrency(brl, "BRL", locale));
   return (
     <>
       <DataTable
@@ -140,14 +142,22 @@ export function CompactLifecycleCostTable({
             label: locale === "pt-BR" ? "Invocações" : "Invocations",
             render: (row) => new Intl.NumberFormat(locale).format(row.run_count),
             align: "right",
-            footer: !showSubtotal || subtotal === null ? undefined : subtotalMetric(subtotal.run_count, number),
+            footer:
+              !showSubtotal || subtotal === null
+                ? undefined
+                : subtotalMetric(subtotal.run_count, number),
           },
           {
             key: "duration",
             label: locale === "pt-BR" ? "Tempo observado" : "Observed time",
             render: durationMetric,
             align: "right",
-            footer: !showSubtotal || subtotal === null ? undefined : subtotalMetric(subtotal.metrics.duration, (value) => value === 0 ? "0" : formatDurationMs(value, locale)),
+            footer:
+              !showSubtotal || subtotal === null
+                ? undefined
+                : subtotalMetric(subtotal.metrics.duration, (value) =>
+                    value === 0 ? "0" : formatDurationMs(value, locale),
+                  ),
           },
           {
             key: "tokens",
@@ -155,7 +165,12 @@ export function CompactLifecycleCostTable({
             render: (row) =>
               metric(row.metrics.total_tokens, (value) => formatCompactNumber(value, locale)),
             align: "right",
-            footer: !showSubtotal || subtotal === null ? undefined : subtotalMetric(subtotal.metrics.total_tokens, (value) => formatCompactNumber(value, locale)),
+            footer:
+              !showSubtotal || subtotal === null
+                ? undefined
+                : subtotalMetric(subtotal.metrics.total_tokens, (value) =>
+                    formatCompactNumber(value, locale),
+                  ),
           },
           {
             key: "cost",

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostCharts.test.ts

@@ -56,11 +56,7 @@ describe("lastSevenDays", () => {
 
     const result = lastSevenDays(rows, "BRL");
 
-    expect(result.map((day) => day.key)).toEqual([
-      "2026-07-08",
-      "2026-07-10",
-      "2026-07-15",
-    ]);
+    expect(result.map((day) => day.key)).toEqual(["2026-07-08", "2026-07-10", "2026-07-15"]);
     expect(result.map((day) => day.value)).toEqual([99, 12.5, 8]);
   });
 
@@ -93,7 +89,11 @@ describe("aggregate-only overview metrics", () => {
     const usage = {
       conversation: metric({ input: 10, cached_input: 1, output: 5, reasoning: 3, total: 15 }, 2),
       planning: metric({ input: 20, cached_input: 2, output: 10, reasoning: 6, total: 30 }, 3),
-      execution: metric({ input: 30, cached_input: 3, output: 15, reasoning: 9, total: 45 }, 4, 12_000),
+      execution: metric(
+        { input: 30, cached_input: 3, output: 15, reasoning: 9, total: 45 },
+        4,
+        12_000,
+      ),
       total: metric({ input: 60, cached_input: 6, output: 30, reasoning: 18, total: 90 }, 9),
     };
 
@@ -113,8 +113,32 @@ describe("aggregate-only overview metrics", () => {
       planning: metric({ input: 0, cached_input: 0, output: 0, reasoning: 0, total: 0 }, 0),
       total: metric({ input: 0, cached_input: 0, output: 0, reasoning: 0, total: 0 }, 0),
     };
-    expect(chartPhaseMetrics("execution", [], { ...base, execution: metric({ input: 0, cached_input: 0, output: 0, reasoning: 0, total: 0 }, 0, 0) }, "BRL").duration).toBe(0);
-    expect(chartPhaseMetrics("execution", [], { ...base, execution: metric({ input: 0, cached_input: 0, output: 0, reasoning: 0, total: 0 }, 0, null) }, "BRL").duration).toBeNull();
+    expect(
+      chartPhaseMetrics(
+        "execution",
+        [],
+        {
+          ...base,
+          execution: metric({ input: 0, cached_input: 0, output: 0, reasoning: 0, total: 0 }, 0, 0),
+        },
+        "BRL",
+      ).duration,
+    ).toBe(0);
+    expect(
+      chartPhaseMetrics(
+        "execution",
+        [],
+        {
+          ...base,
+          execution: metric(
+            { input: 0, cached_input: 0, output: 0, reasoning: 0, total: 0 },
+            0,
+            null,
+          ),
+        },
+        "BRL",
+      ).duration,
+    ).toBeNull();
   });
 
   it("marks an invalid cached or reasoning subset unavailable without changing inclusive totals", () => {
@@ -132,15 +156,20 @@ describe("aggregate-only overview metrics", () => {
 
   it("preserves canonical output when a partial source total diverges", () => {
     const usage = {
-      total: metric({ input: 400_000, cached_input: 390_000, output: 30_000, reasoning: 10_000, total: 445_099 }, 1),
+      total: metric(
+        {
+          input: 400_000,
+          cached_input: 390_000,
+          output: 30_000,
+          reasoning: 10_000,
+          total: 445_099,
+        },
+        1,
+      ),
     };
 
     expect(chartTokenMix([], usage, costChartsCopy("pt-BR")).map(([, value]) => value)).toEqual([
-      10_000,
-      390_000,
-      20_000,
-      10_000,
-      430_000,
+      10_000, 390_000, 20_000, 10_000, 430_000,
     ]);
   });
 });

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostCharts.tsx

@@ -169,7 +169,10 @@ export function CostCharts({
 export function chartTokenMix(
   rows: readonly CostRunRow[],
   summaryUsage: Pick<UsageProjection, "total"> | undefined,
-  copy: Pick<ReturnType<typeof costChartsCopy>, "inputWithoutCache" | "cachedInput" | "visibleOutput" | "reasoning" | "total">,
+  copy: Pick<
+    ReturnType<typeof costChartsCopy>,
+    "inputWithoutCache" | "cachedInput" | "visibleOutput" | "reasoning" | "total"
+  >,
 ) {
   const tokens = summaryUsage?.total.tokens;
   const input = tokens?.input ?? observed(rows.map((row) => row.input_tokens));
@@ -321,10 +324,7 @@ function inclusiveTokenTotal(
   return input !== null && output !== null ? input + output : reportedTotal;
 }
 
-export function lastSevenDays(
-  daily: readonly CostGroupRow[],
-  currency: CostCurrency,
-) {
+export function lastSevenDays(daily: readonly CostGroupRow[], currency: CostCurrency) {
   const values = new Map(daily.map((row) => [row.key, cost(row, currency)]));
   const buckets = [...values.keys()].sort().slice(-7);
   return buckets.map((key) => {

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostDeveloperAttributionPanel.tsx

@@ -0,0 +1,60 @@
+import { useEffect, useState } from "react";
+import { type CostDeveloperAttributionRow, CostDeveloperAttributionTable } from "./CostTables.js";
+import type { CostLocale } from "./cost-monitor-copy.js";
+
+/** Cost-specific rendering of the factual developer aggregate endpoint. */
+export function CostDeveloperAttributionPanel({
+  from,
+  to,
+  locale,
+}: {
+  from?: string;
+  to?: string;
+  locale: CostLocale;
+}) {
+  const [state, setState] = useState<{
+    loading: boolean;
+    error: string | null;
+    rows: readonly CostDeveloperAttributionRow[];
+  }>({ loading: true, error: null, rows: [] });
+  useEffect(() => {
+    const controller = new AbortController();
+    const params = new URLSearchParams();
+    if (from) params.set("from", from);
+    if (to) params.set("to", to);
+    setState((previous) => ({ ...previous, loading: true, error: null }));
+    fetch(`/api/v2/developers${params.size === 0 ? "" : `?${params}`}`, {
+      signal: controller.signal,
+    })
+      .then(async (response) => {
+        if (!response.ok) throw new Error(`HTTP ${response.status}`);
+        return response.json() as Promise<{ rows?: CostDeveloperAttributionRow[] }>;
+      })
+      .then((payload) => setState({ loading: false, error: null, rows: payload.rows ?? [] }))
+      .catch((error: unknown) => {
+        if ((error as { name?: string }).name !== "AbortError")
+          setState({
+            loading: false,
+            error: error instanceof Error ? error.message : "unknown",
+            rows: [],
+          });
+      });
+    return () => controller.abort();
+  }, [from, to]);
+  if (state.loading)
+    return (
+      <p className="operations-empty" role="status">
+        {locale === "pt-BR" ? "Carregando desenvolvedores…" : "Loading developers…"}
+      </p>
+    );
+  if (state.error)
+    return (
+      <p className="operations-empty" role="alert">
+        {locale === "pt-BR"
+          ? "Não foi possível carregar desenvolvedores."
+          : "Could not load developers."}{" "}
+        {state.error}
+      </p>
+    );
+  return <CostDeveloperAttributionTable locale={locale} rows={state.rows} />;
+}

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostDeveloperAttributionTable.tsx

@@ -0,0 +1,191 @@
+import {
+  DataTable,
+  formatCompactNumber,
+  formatCurrency as formatDashboardCurrency,
+  formatDurationMs,
+} from "@zaip-ai/dashboard-ui";
+import type { CostLocale } from "./cost-monitor-copy.js";
+
+export type CostDeveloperAttributionRow = {
+  account_id: string;
+  login_snapshot: string | null;
+  prd_count: number;
+  spec_count: number;
+  task_count: number;
+  run_count: number;
+  test_count: number | null;
+  evidence_count: number | null;
+  total_duration_ms: number | null;
+  total_tokens: number | null;
+  total_cost_brl: number | null;
+  duration_covered_runs: number;
+  token_covered_runs: number;
+  brl_covered_runs: number;
+};
+
+const visuallyHiddenStyle = {
+  clip: "rect(0, 0, 0, 0)",
+  height: 1,
+  margin: -1,
+  overflow: "hidden",
+  position: "absolute",
+  whiteSpace: "nowrap",
+  width: 1,
+} as const;
+
+function formatCount(value: number | null, locale: CostLocale): string {
+  return value === null
+    ? "—"
+    : new Intl.NumberFormat(locale, { maximumFractionDigits: 0 }).format(value);
+}
+
+function formatDuration(value: number | null, locale: CostLocale): string {
+  if (value === null) return locale === "pt-BR" ? "Indisponível" : "Unavailable";
+  return value === 0 ? "0" : formatDurationMs(value, locale);
+}
+
+function formatBrlCurrency(value: number | null, locale: CostLocale): string {
+  return value === null ? "—" : formatDashboardCurrency(value, "BRL", locale);
+}
+
+function formatTokens(value: number | null, locale: CostLocale): string {
+  return value === null
+    ? locale === "pt-BR"
+      ? "Indisponível"
+      : "Unavailable"
+    : formatCompactNumber(value, locale);
+}
+
+function partialMetric(
+  formatted: string,
+  coveredRuns: number,
+  runCount: number,
+  locale: CostLocale,
+) {
+  if (coveredRuns >= runCount) return formatted;
+  const label =
+    locale === "pt-BR"
+      ? `Valor parcial: telemetria conhecida em ${coveredRuns} de ${runCount} runs.`
+      : `Partial value: telemetry is known for ${coveredRuns} of ${runCount} runs.`;
+  return (
+    <span title={label}>
+      <span aria-hidden="true">{formatted}</span>
+      <span style={visuallyHiddenStyle}>{`${label} ${formatted}`}</span>
+    </span>
+  );
+}
+
+/**
+ * Developer facts are intentionally separate from the Operations table. The
+ * Cost Monitor reports only structural and financial facts tied to an
+ * attributed developer Run.
+ */
+export function CostDeveloperAttributionTable({
+  locale,
+  rows,
+}: {
+  locale: CostLocale;
+  rows: readonly CostDeveloperAttributionRow[];
+}) {
+  return (
+    <DataTable
+      columns={[
+        {
+          key: "developer",
+          label: locale === "pt-BR" ? "Desenvolvedor" : "Developer",
+          render: (row) => (
+            <>
+              <strong>{row.login_snapshot ?? row.account_id}</strong>
+              <small>#{row.account_id}</small>
+            </>
+          ),
+          sortValue: (row) => row.login_snapshot ?? row.account_id,
+        },
+        {
+          key: "prds",
+          label: "PRDs",
+          render: (row) => formatCount(row.prd_count, locale),
+          align: "right",
+        },
+        {
+          key: "specs",
+          label: "SPECs",
+          render: (row) => formatCount(row.spec_count, locale),
+          align: "right",
+        },
+        {
+          key: "tasks",
+          label: locale === "pt-BR" ? "Tarefas" : "Tasks",
+          render: (row) => formatCount(row.task_count, locale),
+          align: "right",
+        },
+        {
+          key: "runs",
+          label: "Runs",
+          render: (row) => formatCount(row.run_count, locale),
+          align: "right",
+        },
+        {
+          key: "tests",
+          label: locale === "pt-BR" ? "Testes" : "Tests",
+          render: (row) => formatCount(row.test_count, locale),
+          align: "right",
+        },
+        {
+          key: "evidences",
+          label: locale === "pt-BR" ? "Evidências" : "Evidence",
+          render: (row) => formatCount(row.evidence_count, locale),
+          align: "right",
+        },
+        {
+          key: "duration",
+          label: locale === "pt-BR" ? "Tempo" : "Time",
+          render: (row) =>
+            partialMetric(
+              formatDuration(row.total_duration_ms, locale),
+              row.duration_covered_runs,
+              row.run_count,
+              locale,
+            ),
+          sortValue: (row) => row.total_duration_ms,
+          align: "right",
+        },
+        {
+          key: "tokens",
+          label: "Tokens",
+          render: (row) =>
+            partialMetric(
+              formatTokens(row.total_tokens, locale),
+              row.token_covered_runs,
+              row.run_count,
+              locale,
+            ),
+          sortValue: (row) => row.total_tokens,
+          align: "right",
+        },
+        {
+          key: "cost",
+          label: locale === "pt-BR" ? "Custos" : "Costs",
+          render: (row) =>
+            partialMetric(
+              formatBrlCurrency(row.total_cost_brl, locale),
+              row.brl_covered_runs,
+              row.run_count,
+              locale,
+            ),
+          sortValue: (row) => row.total_cost_brl,
+          align: "right",
+        },
+      ]}
+      defaultSort={{ key: "cost", direction: "desc" }}
+      emptyMessage={locale === "pt-BR" ? "Nenhum dado disponível." : "No data available."}
+      locale={locale}
+      pageSize={10}
+      rowKey={(row) => row.account_id}
+      rows={rows}
+      scrollLabel={locale === "pt-BR" ? "Métricas por desenvolvedor" : "Developer metrics"}
+      showColumnInfo
+      sortable
+    />
+  );
+}

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostFilters.loading.test.ts

@@ -0,0 +1,14 @@
+import { readFileSync } from "node:fs";
+import { describe, expect, it } from "vitest";
+
+describe("Cost period loading lifecycle", () => {
+  it("clears a filtered request when the embedded snapshot becomes sufficient", () => {
+    const source = readFileSync(new URL("./CostFilters.tsx", import.meta.url), "utf8");
+
+    expect(source).toContain("const generation = ++generationRef.current;");
+    expect(source).toContain("if (!shouldFetch)");
+    expect(source).toContain("setPeriodLoading(false);");
+    expect(source).toContain("setPeriodData(null);");
+    expect(source).toContain("generation === generationRef.current");
+  });
+});

package/templates/.agents/dashboard/modules/cost-monitor/src/react/CostFilters.run-page.test.ts

@@ -0,0 +1,18 @@
+import { describe, expect, it } from "vitest";
+import { loadCostMonitorRunPage } from "./CostFilters.js";
+
+describe("Cost Monitor invocation page loading", () => {
+  it("uses a ten-row default for the remote invocation page", async () => {
+    const calls: string[] = [];
+    await loadCostMonitorRunPage({
+      currency: "BRL",
+      offset: 0,
+      fetcher: async (url) => {
+        calls.push(String(url));
+        return new Response(JSON.stringify({ runs: [] }), { status: 200 });
+      },
+    });
+
+    expect(new URL(calls[0]!, "http://dashboard.local").searchParams.get("limit")).toBe("10");
+  });
+});