@zaip-ai/cli 2.2.0 → 3.0.0

package/templates/.agents/dashboard/apps/frontend/src/cost-period-refresh.test.ts

@@ -1,5 +1,6 @@
 import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
+import { readAppCompositionSource } from "./__tests__/app-composition-support.js";
 import {
   isCurrentCostSummaryRequest,
   isCurrentDashboardRequest,
@@ -42,7 +43,7 @@ describe("Cost period refresh", () => {
   });
 
   it("invalidates and aborts an old Cost summary on a global period transition", () => {
-    const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
+    const app = readAppCompositionSource();
     const periodChange = app.slice(
       app.indexOf("onDateChange={(preset, range) => {"),
       app.indexOf("settings={"),
@@ -51,14 +52,15 @@ describe("Cost period refresh", () => {
     expect(periodChange).toContain("costSummaryAbortRef.current?.abort();");
     expect(periodChange).toContain("++costSummaryRequestVersion.current;");
     expect(app).toContain("isCurrentCostSummaryRequest({");
-    expect(app).toContain('if (failedArea === "costs") void loadCostSummary();');
+    const retry = readFileSync(new URL("./dashboard-retry.ts", import.meta.url), "utf8");
+    expect(retry).toContain('if (failedArea === "costs") void loadCostSummary();');
   });
 
   it("reloads the invalidated BRL Cost snapshot for Cost Monitor and All Time presentation", () => {
-    const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
+    const app = readAppCompositionSource();
     const activeCostReload = app.slice(
       app.indexOf("// A global period change invalidates the Cost snapshot"),
-      app.indexOf("const loadMoreTraceTasks"),
+      app.indexOf("const selectDashboardView"),
     );
 
     expect(activeCostReload).toContain(
@@ -72,7 +74,7 @@ describe("Cost period refresh", () => {
   });
 
   it("does not make the all-time data request depend on its displayed factual range", () => {
-    const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
+    const app = readAppCompositionSource();
 
     expect(app).toContain(
       'operationsPeriod.preset === "all" ? null : operationsPeriod.range.start',
@@ -123,7 +125,7 @@ describe("Cost period refresh", () => {
   });
 
   it("mounts Cost from a Daily seed without a full summary request", () => {
-    const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
+    const app = readAppCompositionSource();
     const refresh = app.slice(
       app.indexOf("const refresh = useCallback"),
       app.indexOf("const loadOperationsDetails"),
@@ -161,7 +163,7 @@ describe("Cost period refresh", () => {
   });
 
   it("connects SQLite run and filtered group pagers through App", () => {
-    const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
+    const app = readAppCompositionSource();
     const loaders = readFileSync(new URL("./use-app-cost-loaders.ts", import.meta.url), "utf8");
     expect(app).toContain("useAppCostLoaders(api)");
     expect(loaders).toContain("const loadCostRunPage = useCallback<LoadCostRunPage>");

package/templates/.agents/dashboard/apps/frontend/src/dashboard-api-settings.ts

@@ -0,0 +1,152 @@
+export interface PricingModel {
+  id: string;
+  provider: "openai" | "anthropic";
+  aliases: string[];
+  input_per_million_usd: number;
+  cached_input_per_million_usd: number | null;
+  output_per_million_usd: number;
+  reasoning_per_million_usd: number | null;
+  priority_input_per_million_usd?: number | null;
+  priority_cached_input_per_million_usd?: number | null;
+  priority_output_per_million_usd?: number | null;
+  priority_reasoning_per_million_usd?: number | null;
+  reasoning_billed_separately: boolean;
+  long_context_threshold_tokens: number | null;
+  long_context_input_multiplier: number;
+  long_context_output_multiplier: number;
+  source_label: string;
+  source_url: string;
+  notes: string[];
+}
+
+export interface PricingCatalog {
+  schema_version: 1;
+  updated_at: string;
+  source: string;
+  disclaimer: string;
+  models: PricingModel[];
+}
+
+export interface FxRate {
+  schema_version: 1;
+  base: "USD";
+  quote: "BRL";
+  rate: number;
+  as_of: string;
+  source_label: string;
+  source_url: string;
+}
+
+export type AgentReasoningEffort = "low" | "medium" | "high" | "xhigh" | "ultra";
+
+export interface AgentCatalogAgent {
+  id: string;
+  version: number;
+  purpose: string;
+  codex_name: string;
+  codex_task_name: string;
+  persona: { nome: string; cargo: string; foto_url?: string };
+  role: string;
+  capabilities: string[];
+  execution_eligibility: Array<"interaction" | "delivery">;
+  model: {
+    required_capabilities: string[];
+    preferred: string[];
+    reasoning_effort?: AgentReasoningEffort;
+  };
+  [key: string]: unknown;
+}
+
+export interface AgentCatalogSettings {
+  catalog: {
+    schema_version: 1;
+    agents: AgentCatalogAgent[];
+    squads: unknown[];
+  };
+  framework_agent_ids: string[];
+  default_model: string | null;
+  default_reasoning_effort: string | null;
+  allowed_models: string[];
+  allowed_reasoning_efforts: AgentReasoningEffort[];
+  sync: {
+    required: true;
+    valid: boolean | null;
+    drifted: string[];
+  };
+}
+
+export interface ProjectConfigSettings {
+  autonomy?: { version: 1; preset: "essential" | "balanced" | "persistent" } | undefined;
+  schema_version: 1;
+  zaip?: { enabled: boolean };
+  project: {
+    id: string;
+    name: string;
+    timezone: string;
+  };
+  stack: {
+    id: string;
+    overrides: Record<string, unknown>;
+  };
+  clients: {
+    codex: boolean;
+    claude: boolean;
+  };
+  tracking: {
+    enabled: boolean;
+    currency: string;
+    storage_mode: "tracked_sanitized" | "local_only";
+  };
+  model_orchestration?:
+    | {
+        mode: "manual";
+        default_model: "manual";
+        default_effort: "manual";
+        default_velocity: "manual";
+        notice: "always" | "mismatch";
+      }
+    | {
+        mode: "off";
+        default_model: string;
+        default_effort: string;
+        default_velocity: string;
+        notice: "always" | "mismatch";
+      }
+    | {
+        mode: "auto";
+        default_model: "gpt-5.6-terra";
+        default_effort: "medium";
+        default_velocity: "standard";
+        allowed_models: ["gpt-5.6-luna", "gpt-5.6-terra", "gpt-5.6-sol"];
+        allowed_efforts: ["low", "medium", "high", "xhigh"];
+        max_auto_effort: "xhigh";
+        automatic_sources: ["spec", "prd"];
+        notice: "always" | "mismatch";
+      }
+    | undefined;
+  execution?:
+    | { runtime: "manual" }
+    | {
+        runtime: "autonomous" | "managed";
+        autonomous: {
+          provider: "codex" | "claude";
+          model: string;
+          max_parallelism: number;
+          lease_ms: number;
+        };
+      }
+    | undefined;
+  assurance?:
+    | {
+        version: 1;
+        standard_depth: "auto" | "base" | "elevated";
+        require_final_commit: boolean;
+      }
+    | undefined;
+  context?:
+    | {
+        canonical_roots: string[];
+        projection_roots: string[];
+      }
+    | undefined;
+}

package/templates/.agents/dashboard/apps/frontend/src/dashboard-api.test.ts

@@ -11,6 +11,25 @@ describe("DashboardApiClient reconciliation", () => {
     vi.unstubAllGlobals();
   });
 
+  it("loads the bounded all-status traceability index rather than Kanban stages", async () => {
+    vi.stubGlobal("window", globalThis);
+    const payload = {
+      tasks: [{ id: "TASK-DRAFT", status: "draft" }],
+      total: 11,
+      offset: 10,
+      limit: 10,
+    };
+    const fetchMock = vi.fn(async () => new Response(JSON.stringify(payload), { status: 200 }));
+    vi.stubGlobal("fetch", fetchMock);
+    await expect(new DashboardApiClient("session").traceabilityTasks(10, 10)).resolves.toEqual(
+      payload,
+    );
+    expect(fetchMock).toHaveBeenCalledWith(
+      "/api/v2/operations?scope=traceability&offset=10&limit=10",
+      expect.objectContaining({ headers: expect.anything() }),
+    );
+  });
+
   it("keeps the manual reconciliation request alive past the normal dashboard timeout", async () => {
     vi.useFakeTimers();
     vi.stubGlobal("window", globalThis);

package/templates/.agents/dashboard/apps/frontend/src/dashboard-api.ts

@@ -3,7 +3,10 @@ import type { ProjectOverview } from "./dashboard-project-overview.js";
 export type { ProjectOverview } from "./dashboard-project-overview.js";
 
 import { type ApiErrorPayload, dashboardApiPaths } from "@zaip-ai/dashboard-contracts";
-import type { CostMonitorProjection } from "@zaip-ai/dashboard-cost-monitor/contracts";
+import type {
+  CostMonitorProjection,
+  CostPeriodAverages,
+} from "@zaip-ai/dashboard-cost-monitor/contracts";
 import type {
   ChangeProjection,
   DashboardTaskProjection,
@@ -15,6 +18,13 @@ import type {
 } from "@zaip-ai/dashboard-operations/contracts";
 import type { TaskTrace } from "@zaip-ai/dashboard-traceability/contracts";
 import type { ReconcileOpenWorkResponse } from "./dashboard-api-reconciliation.js";
+import type {
+  AgentCatalogAgent,
+  AgentCatalogSettings,
+  FxRate,
+  PricingCatalog,
+  ProjectConfigSettings,
+} from "./dashboard-api-settings.js";
 import type { DashboardIdentityResponse } from "./dashboard-identity.js";
 export interface ReconciliationBlockedItem {
   id: string;
@@ -59,6 +69,7 @@ export interface SqliteViewPage {
   total_count: number;
   has_more: boolean;
   totals?: Record<string, unknown>;
+  period_averages?: Record<"BRL" | "USD", CostPeriodAverages>;
   rows: Array<Record<string, unknown>>;
 }
 export type OperationsScope = "quick" | "overview" | "detail";
@@ -313,6 +324,23 @@ export class DashboardApiClient {
     );
   }
 
+  traceabilityTasks(
+    offset = 0,
+    limit = 10,
+  ): Promise<{
+    tasks: OperationsProjection["tasks"];
+    total: number;
+    offset: number;
+    limit: number;
+  }> {
+    const params = new URLSearchParams({
+      scope: "traceability",
+      offset: String(offset),
+      limit: String(limit),
+    });
+    return this.get(`${dashboardApiPaths.operations}?${params}`);
+  }
+
   operationsClassification(
     period: { from: string | null; to: string | null } | undefined,
     kind: "task" | "spec" | "prd",
@@ -426,7 +454,12 @@ export class DashboardApiClient {
     operations: OperationsProjection;
     costs: CostMonitorProjection;
     dashboard?: { title: string; repository_name: string };
-    projection: { source_latest_at: string | null; served_at: string };
+    projection: {
+      source_latest_at: string | null;
+      updated_at: string | null;
+      latest_token_collected_at: string | null;
+      served_at: string;
+    };
   }> {
     return this.get(withPeriod(`${dashboardApiPaths.snapshot}?currency=${currency}`, period));
   }
@@ -448,7 +481,12 @@ export class DashboardApiClient {
     operations: OperationsProjection;
     costs: CostMonitorProjection;
     dashboard?: { title: string; repository_name: string };
-    projection: { source_latest_at: string | null; served_at: string };
+    projection: {
+      source_latest_at: string | null;
+      updated_at: string | null;
+      latest_token_collected_at: string | null;
+      served_at: string;
+    };
   }> {
     return this.post(
       withPeriod(`${dashboardApiPaths.refreshProjection}?currency=${currency}`, period),
@@ -644,154 +682,12 @@ function withPeriod(
   return `${url.pathname}${url.search}`;
 }
 
-export interface PricingModel {
-  id: string;
-  provider: "openai" | "anthropic";
-  aliases: string[];
-  input_per_million_usd: number;
-  cached_input_per_million_usd: number | null;
-  output_per_million_usd: number;
-  reasoning_per_million_usd: number | null;
-  priority_input_per_million_usd?: number | null;
-  priority_cached_input_per_million_usd?: number | null;
-  priority_output_per_million_usd?: number | null;
-  priority_reasoning_per_million_usd?: number | null;
-  reasoning_billed_separately: boolean;
-  long_context_threshold_tokens: number | null;
-  long_context_input_multiplier: number;
-  long_context_output_multiplier: number;
-  source_label: string;
-  source_url: string;
-  notes: string[];
-}
-
-export interface PricingCatalog {
-  schema_version: 1;
-  updated_at: string;
-  source: string;
-  disclaimer: string;
-  models: PricingModel[];
-}
-
-export interface FxRate {
-  schema_version: 1;
-  base: "USD";
-  quote: "BRL";
-  rate: number;
-  as_of: string;
-  source_label: string;
-  source_url: string;
-}
-
-export type AgentReasoningEffort = "low" | "medium" | "high" | "xhigh" | "ultra";
-
-export interface AgentCatalogAgent {
-  id: string;
-  version: number;
-  purpose: string;
-  codex_name: string;
-  codex_task_name: string;
-  persona: { nome: string; cargo: string; foto_url?: string };
-  role: string;
-  capabilities: string[];
-  execution_eligibility: Array<"interaction" | "delivery">;
-  model: {
-    required_capabilities: string[];
-    preferred: string[];
-    reasoning_effort?: AgentReasoningEffort;
-  };
-  [key: string]: unknown;
-}
-
-export interface AgentCatalogSettings {
-  catalog: {
-    schema_version: 1;
-    agents: AgentCatalogAgent[];
-    squads: unknown[];
-  };
-  framework_agent_ids: string[];
-  default_model: string | null;
-  default_reasoning_effort: string | null;
-  allowed_models: string[];
-  allowed_reasoning_efforts: AgentReasoningEffort[];
-  sync: {
-    required: true;
-    valid: boolean | null;
-    drifted: string[];
-  };
-}
-
-export interface ProjectConfigSettings {
-  schema_version: 1;
-  zaip?: { enabled: boolean };
-  project: {
-    id: string;
-    name: string;
-    timezone: string;
-  };
-  stack: {
-    id: string;
-    overrides: Record<string, unknown>;
-  };
-  clients: {
-    codex: boolean;
-    claude: boolean;
-  };
-  tracking: {
-    enabled: boolean;
-    currency: string;
-    storage_mode: "tracked_sanitized" | "local_only";
-  };
-  model_orchestration?:
-    | {
-        mode: "manual";
-        default_model: "manual";
-        default_effort: "manual";
-        default_velocity: "manual";
-        notice: "always" | "mismatch";
-      }
-    | {
-        mode: "off";
-        default_model: string;
-        default_effort: string;
-        default_velocity: string;
-        notice: "always" | "mismatch";
-      }
-    | {
-        mode: "auto";
-        default_model: "gpt-5.6-terra";
-        default_effort: "medium";
-        default_velocity: "standard";
-        allowed_models: ["gpt-5.6-luna", "gpt-5.6-terra", "gpt-5.6-sol"];
-        allowed_efforts: ["low", "medium", "high", "xhigh"];
-        max_auto_effort: "xhigh";
-        automatic_sources: ["spec", "prd"];
-        notice: "always" | "mismatch";
-      }
-    | undefined;
-  execution?:
-    | { runtime: "manual" }
-    | {
-        runtime: "autonomous";
-        autonomous: {
-          provider: "codex" | "claude";
-          model: string;
-          max_parallelism: number;
-          lease_ms: number;
-        };
-      }
-    | undefined;
-  assurance?:
-    | {
-        version: 1;
-        standard_depth: "auto" | "base" | "elevated";
-        require_final_commit: boolean;
-      }
-    | undefined;
-  context?:
-    | {
-        canonical_roots: string[];
-        projection_roots: string[];
-      }
-    | undefined;
-}
+export type {
+  AgentCatalogAgent,
+  AgentCatalogSettings,
+  AgentReasoningEffort,
+  FxRate,
+  PricingCatalog,
+  PricingModel,
+  ProjectConfigSettings,
+} from "./dashboard-api-settings.js";

package/templates/.agents/dashboard/apps/frontend/src/dashboard-app-shell.tsx

@@ -0,0 +1,33 @@
+import type { CostLocale } from "@zaip-ai/dashboard-cost-monitor/react";
+import * as React from "react";
+import { DashboardCapabilityNav, type DashboardView } from "./DashboardCapabilityNav.js";
+
+export function useDashboardBrowserLease(token: string): void {
+  React.useEffect(() => {
+    if (!token) return undefined;
+    const lease = new EventSource(`/api/v2/browser-lease?token=${encodeURIComponent(token)}`);
+    return () => lease.close();
+  }, [token]);
+}
+
+export function renderCapabilityNavigation(
+  dashboardView: DashboardView | null,
+  locale: CostLocale,
+  onChange: (view: DashboardView) => void,
+) {
+  return (
+    <div
+      className={`dashboard-capability-shell dashboard-capability-shell--${dashboardView ?? "initial"}`}
+    >
+      <DashboardCapabilityNav activeView={dashboardView} locale={locale} onChange={onChange} />
+    </div>
+  );
+}
+
+export function navigateDashboard(setPathname: (path: string) => void) {
+  return (nextPath: string) => {
+    window.history.pushState(null, "", nextPath);
+    setPathname(nextPath);
+    window.scrollTo({ left: 0, top: 0 });
+  };
+}

package/templates/.agents/dashboard/apps/frontend/src/dashboard-cost-facts.test.ts

@@ -0,0 +1,54 @@
+import type { CostMonitorProjection } from "@zaip-ai/dashboard-cost-monitor/contracts";
+import { describe, expect, it } from "vitest";
+import { factualCostFacts } from "./dashboard-cost-facts.js";
+
+function fixture(known: number, runs: number, total: number | null = 0): CostMonitorProjection {
+  return {
+    currency: "BRL",
+    overview: {
+      run_count: runs,
+      estimated_usd: total,
+      estimated_brl: total,
+      coverage: { events: runs, tokens: known, usd: known, brl: known },
+    },
+    groups: { daily: [], monthly: [], annual: [] },
+  } as unknown as CostMonitorProjection;
+}
+
+describe("factual cost facts", () => {
+  it("preserves a partly measured known subtotal with its coverage", () => {
+    expect(factualCostFacts(fixture(3, 5, 12.5), null, "BRL").fact).toEqual({
+      state: "partial",
+      knownSum: 12.5,
+      coverage: { known: 3, total: 5 },
+    });
+  });
+  it("preserves fully measured zero as a complete observed total", () => {
+    expect(factualCostFacts(fixture(3, 3), null, "BRL").fact).toEqual({
+      state: "complete",
+      knownSum: 0,
+      coverage: { known: 3, total: 3 },
+    });
+  });
+  it("does not hide a measured zero when other Runs remain unpriced", () => {
+    expect(factualCostFacts(fixture(1, 3, 0), null, "BRL").fact).toEqual({
+      state: "partial",
+      knownSum: 0,
+      coverage: { known: 1, total: 3 },
+    });
+  });
+  it("keeps an unknown aggregate unavailable even when coverage exists", () => {
+    expect(factualCostFacts(fixture(3, 3, null), null, "BRL").fact).toEqual({
+      state: "unavailable",
+      knownSum: null,
+      coverage: { known: 3, total: 3 },
+    });
+  });
+  it("does not relabel a stale different-currency snapshot", () => {
+    expect(factualCostFacts(fixture(3, 3), null, "USD").fact).toEqual({
+      state: "unavailable",
+      knownSum: null,
+      coverage: null,
+    });
+  });
+});

package/templates/.agents/dashboard/apps/frontend/src/dashboard-cost-facts.ts

@@ -0,0 +1,48 @@
+import type { CostMonitorProjection } from "@zaip-ai/dashboard-cost-monitor/contracts";
+import type { FactualCostFact } from "@zaip-ai/dashboard-operations/react";
+
+export type { FactualCostFact } from "@zaip-ai/dashboard-operations/react";
+
+export function currentCostByRun(
+  costs: CostMonitorProjection | null,
+  displayedCosts: CostMonitorProjection | null,
+  currency: "BRL" | "USD",
+) {
+  return new Map(
+    (displayedCosts ?? costs)?.runs.map(
+      (run) => [run.run_id, currency === "USD" ? run.estimated_usd : run.estimated_brl] as const,
+    ) ?? [],
+  );
+}
+
+export function factualCostFacts(
+  costs: CostMonitorProjection | null,
+  displayedCosts: CostMonitorProjection | null,
+  currency: "BRL" | "USD",
+) {
+  const snapshot = displayedCosts ?? costs;
+  if (snapshot?.currency !== currency) {
+    return {
+      fact: { state: "unavailable", knownSum: null, coverage: null } as const,
+      periods: undefined,
+    };
+  }
+  const known = snapshot.overview.coverage[currency === "USD" ? "usd" : "brl"];
+  const knownSum =
+    currency === "USD" ? snapshot.overview.estimated_usd : snapshot.overview.estimated_brl;
+  const coverage = { known, total: snapshot.overview.run_count };
+  const fact: FactualCostFact =
+    knownSum === null
+      ? { state: "unavailable", knownSum: null, coverage }
+      : known < snapshot.overview.run_count
+        ? { state: "partial", knownSum, coverage }
+        : { state: "complete", knownSum, coverage };
+  return {
+    fact,
+    periods: {
+      day: snapshot.groups.daily,
+      month: snapshot.groups.monthly,
+      year: snapshot.groups.annual,
+    },
+  };
+}