@zaip-ai/cli 2.2.0 → 2.6.0

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

@@ -0,0 +1,151 @@
+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;
+}

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

@@ -15,6 +15,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;
@@ -426,7 +433,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 +460,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 +661,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.ts

@@ -0,0 +1,30 @@
+import type { CostMonitorProjection } from "@zaip-ai/dashboard-cost-monitor/contracts";
+
+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 { total: null, periods: undefined };
+  return {
+    total: currency === "USD" ? snapshot.overview.estimated_usd : snapshot.overview.estimated_brl,
+    periods: {
+      day: snapshot.groups.daily,
+      month: snapshot.groups.monthly,
+      year: snapshot.groups.annual,
+    },
+  };
+}

package/templates/.agents/dashboard/apps/frontend/src/dashboard-project-overview.ts

@@ -1,7 +1,13 @@
 export interface ProjectOverview {
   framework_version: string | null;
+  installation: {
+    completed: number;
+    total: 16;
+    percent: number;
+    state: "complete" | "incomplete";
+  };
   metrics: Array<{
-    id: "agents" | "squads" | "skills" | "rules" | "hooks" | "database";
+    id: "agents" | "squads" | "skills" | "rules" | "hooks";
     label: string;
     value: number | string;
   }>;

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

@@ -0,0 +1,17 @@
+export function retryDashboardLoad(
+  failedArea: string | null,
+  selectedTraceTaskId: string | null,
+  operations: unknown,
+  loadCostSummary: () => Promise<unknown>,
+  openTrace: (id: string) => Promise<unknown>,
+  loadOperationsDetails: () => Promise<unknown>,
+  refresh: () => Promise<unknown>,
+  setError: (error: string | null) => void,
+): void {
+  setError(null);
+  if (failedArea === "costs") void loadCostSummary();
+  else if (failedArea === "traceability" && selectedTraceTaskId)
+    void openTrace(selectedTraceTaskId);
+  else if (failedArea === "operations" && operations !== null) void loadOperationsDetails();
+  else void refresh();
+}

package/templates/.agents/dashboard/apps/frontend/src/dashboard-setup-route.ts

@@ -0,0 +1,29 @@
+import { renderAppSetupRoute } from "./AppSetupRoutes.js";
+
+type SetupInput = Parameters<typeof renderAppSetupRoute>[0];
+
+export function createDashboardSetupRoute(
+  api: SetupInput["api"],
+  costLocale: SetupInput["costLocale"],
+  fxRate: SetupInput["fxRate"],
+  navigate: SetupInput["navigate"],
+  pathname: SetupInput["pathname"],
+  pricing: SetupInput["pricing"],
+  refresh: () => Promise<unknown>,
+  setFxRate: SetupInput["setFxRate"],
+  setPricing: SetupInput["setPricing"],
+) {
+  return renderAppSetupRoute({
+    api,
+    costLocale,
+    fxRate,
+    navigate,
+    pathname,
+    pricing,
+    refresh: async () => {
+      await refresh();
+    },
+    setFxRate,
+    setPricing,
+  });
+}

package/templates/.agents/dashboard/apps/frontend/src/dashboard-view-actions.ts

@@ -0,0 +1,66 @@
+import { shouldLoadCostSummary } from "./AppRequestGuards.js";
+import type { DashboardView } from "./DashboardCapabilityNav.js";
+
+type TraceTask = {
+  id: string;
+  status: string;
+  finished_at: string | null;
+  updated_at: string;
+};
+
+type DashboardViewActions<T extends TraceTask> = {
+  setDashboardView: (view: DashboardView) => void;
+  costsLoadedRef: { current: boolean };
+  currency: "BRL" | "USD";
+  costs: { currency: string } | null;
+  loadCostSummary: () => Promise<unknown>;
+  costSummaryAbortRef: { current: AbortController | null };
+  traceTasks: T[];
+  boardRequestVersionRef: { current: number };
+  loadMoreTraceTasks: (append: boolean, includeCompleted: boolean) => Promise<T[]>;
+  setTraceTasks: (tasks: T[]) => void;
+  setSelectedTraceTaskId: (id: string) => void;
+  openTrace: (id: string) => Promise<unknown>;
+  setTrace: (value: null) => void;
+  setTraceLoadingTaskId: (id: null) => void;
+};
+
+export function createDashboardViewSelector<T extends TraceTask>(input: DashboardViewActions<T>) {
+  return async (nextView: DashboardView) => {
+    input.setDashboardView(nextView);
+    window.scrollTo({ left: 0, top: 0 });
+    if (nextView === "cost-monitor") {
+      if (
+        shouldLoadCostSummary({
+          costsLoaded: input.costsLoadedRef.current,
+          currency: input.currency,
+          snapshotCurrency: input.costs?.currency,
+        })
+      )
+        void input.loadCostSummary();
+    } else {
+      input.costSummaryAbortRef.current?.abort();
+    }
+    if (nextView === "traceability") {
+      let candidates = input.traceTasks;
+      if (candidates.length === 0) {
+        const requestVersion = input.boardRequestVersionRef.current;
+        candidates = await input.loadMoreTraceTasks(false, true);
+        if (requestVersion !== input.boardRequestVersionRef.current) return;
+        input.setTraceTasks(candidates);
+      }
+      const ordered = candidates.toSorted(
+        (a, b) =>
+          Date.parse(b.finished_at ?? b.updated_at) - Date.parse(a.finished_at ?? a.updated_at),
+      );
+      const latest = ordered.find((task) => task.status === "completed") ?? ordered[0];
+      if (latest) {
+        input.setSelectedTraceTaskId(latest.id);
+        void input.openTrace(latest.id);
+      }
+      return;
+    }
+    input.setTrace(null);
+    input.setTraceLoadingTaskId(null);
+  };
+}

package/templates/.agents/dashboard/apps/frontend/src/operations-period-render.test.ts

@@ -4,6 +4,7 @@ import { OperationsPage } from "@zaip-ai/dashboard-operations/react";
 import { createElement } from "react";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it, vi } from "vitest";
+import { readAppCompositionSource } from "./__tests__/app-composition-support.js";
 import { PeriodTransitionOverlay, PeriodTransitionShell } from "./App.js";
 
 const data = {
@@ -95,8 +96,8 @@ describe("App-owned Operations period render", () => {
   });
 
   it("reserves the global gate for a period replacement, not secondary pages", () => {
-    const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
-    expect(app).toContain("const globalLoadingPending =");
+    const app = readAppCompositionSource();
+    expect(app).toContain("globalLoadingPending:");
     expect(app).toContain("periodTransitionPending ||");
     expect(app).not.toContain("entityPage.loading ||");
     expect(app).not.toContain("Object.values(boardStates).some((state) => state.loading)");

package/templates/.agents/dashboard/apps/frontend/src/overview-status-page.test.ts

@@ -1,7 +1,7 @@
-import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
+import { readAppCompositionSource } from "./__tests__/app-composition-support.js";
 
-const source = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
+const source = readAppCompositionSource();
 
 describe("overview status page loading", () => {
   it("requests a dedicated stage and kind page instead of reusing the mixed board page", () => {

package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.test.ts

@@ -0,0 +1,48 @@
+import { describe, expect, it } from "vitest";
+import type { ProjectOverview } from "./dashboard-api.js";
+import {
+  PROJECT_INSTALLATION_TOTAL,
+  projectInstallationStatus,
+  projectSettingsSummaryMetrics,
+} from "./project-installation-status.js";
+
+const overview: Pick<ProjectOverview, "installation"> = {
+  installation: { completed: 16, total: 16, percent: 100, state: "complete" },
+};
+
+describe("projectInstallationStatus", () => {
+  it("uses the verified installation result supplied by the API", () => {
+    expect(projectInstallationStatus(overview)).toEqual({
+      completed: 16,
+      total: PROJECT_INSTALLATION_TOTAL,
+      percentage: 100,
+      complete: true,
+    });
+  });
+
+  it("keeps an incomplete 15/16 result below 100%", () => {
+    const incomplete: Pick<ProjectOverview, "installation"> = {
+      installation: { completed: 15, total: 16, percent: 93.75, state: "incomplete" },
+    };
+
+    expect(projectInstallationStatus(incomplete)).toMatchObject({
+      completed: 15,
+      total: 16,
+      percentage: 93.75,
+      complete: false,
+    });
+  });
+
+  it("keeps five regular metrics and one dedicated installation card for the new API payload", () => {
+    const metrics: ProjectOverview["metrics"] = [
+      { id: "agents", label: "Agentes", value: 23 },
+      { id: "squads", label: "Squads", value: 6 },
+      { id: "skills", label: "Skills", value: 97 },
+      { id: "rules", label: "Rules", value: 18 },
+      { id: "hooks", label: "Hooks", value: 4 },
+    ];
+
+    expect(projectSettingsSummaryMetrics(metrics)).toHaveLength(5);
+    expect(projectSettingsSummaryMetrics(metrics).length + 1).toBe(6);
+  });
+});

package/templates/.agents/dashboard/apps/frontend/src/project-installation-status.ts

@@ -0,0 +1,29 @@
+import type { ProjectOverview } from "./dashboard-api.js";
+
+export const PROJECT_INSTALLATION_TOTAL = 16;
+
+export type ProjectInstallationStatus = {
+  completed: number;
+  total: typeof PROJECT_INSTALLATION_TOTAL;
+  percentage: number;
+  complete: boolean;
+};
+
+/** Keeps the API's verified 16-item installation summary presentation-safe. */
+export function projectInstallationStatus(
+  overview: Pick<ProjectOverview, "installation">,
+): ProjectInstallationStatus {
+  const { completed, percent: percentage, total } = overview.installation;
+
+  return {
+    completed,
+    total,
+    percentage,
+    complete: completed === total,
+  };
+}
+
+export function projectSettingsSummaryMetrics(metrics: ProjectOverview["metrics"]) {
+  // Ignore transitional API payloads so the dedicated installation card remains unique.
+  return metrics.filter((metric) => !["database", "installation"].includes(metric.id as string));
+}