@zaip-ai/cli 1.0.8 → 1.3.0

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

@@ -73,7 +73,13 @@ export interface OperationsBoardPage {
   stage: WorkBoardStage;
   offset: number;
   total: number;
-  totals_by_kind: { all: number; task: number; prd: number; spec: number };
+  totals_by_kind: {
+    all: number;
+    task: number;
+    "standalone-task": number;
+    prd: number;
+    spec: number;
+  };
   prds: MacroProjection[];
   specs: MacroProjection[];
   tasks: DashboardTaskProjection[];
@@ -423,6 +429,21 @@ export class DashboardApiClient {
     );
   }
 
+  refreshProjection(
+    currency: "BRL" | "USD" = "BRL",
+    period?: { from: string | null; to: string | null },
+  ): Promise<{
+    operations: OperationsProjection;
+    costs: CostMonitorProjection;
+    dashboard?: { title: string; repository_name: string };
+    projection: { source_latest_at: string | null; served_at: string };
+  }> {
+    return this.post(
+      withPeriod(`${dashboardApiPaths.refreshProjection}?currency=${currency}`, period),
+      reconciliationRequestTimeoutMs,
+    );
+  }
+
   task(taskId: string): Promise<TaskDetailProjection> {
     return this.get(dashboardApiPaths.task(taskId));
   }

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

@@ -7,7 +7,9 @@ describe("overview status page loading", () => {
   it("requests a dedicated stage and kind page instead of reusing the mixed board page", () => {
     expect(source).toContain("const loadOverviewStatusPage");
     expect(source).toContain("api.operationsBoard(period, stage, offset, { kind })");
-    expect(source).toContain("kind === \"task\" ? page.tasks : kind === \"spec\" ? page.specs : page.prds");
+    expect(source).toContain(
+      'kind === "task" ? page.tasks : kind === "spec" ? page.specs : page.prds',
+    );
   });
 
   it("keeps a dedicated collection paginated by the loaded typed rows", () => {

package/templates/.agents/dashboard/apps/frontend/src/project-settings-page.css

@@ -20,33 +20,34 @@
 
 .project-settings-state-card {
   display: grid;
+  gap: 12px;
   justify-items: center;
-  max-width: 580px;
+  max-width: 420px;
   border: 1px solid #dbe4ef;
   border-radius: 24px;
-  padding: clamp(32px, 6vw, 56px);
+  padding: clamp(32px, 6vw, 48px);
   background: #fff;
   box-shadow: 0 18px 48px rgba(15, 23, 42, 0.08);
   text-align: center;
 }
 
 .project-settings-loader {
-  width: 42px;
-  height: 42px;
-  margin-bottom: 20px;
-  border: 4px solid rgba(0, 176, 240, 0.18);
+  width: 32px;
+  height: 32px;
+  border: 3px solid rgba(0, 176, 240, 0.18);
   border-top-color: #00b0f0;
   border-radius: 50%;
   animation: project-settings-spin 0.8s linear infinite;
 }
 
 .project-settings-state-card h1 {
-  max-width: 16ch;
+  max-width: 18ch;
+  font-size: clamp(1.75rem, 5vw, 2.25rem);
 }
 
 .project-settings-state-card button {
   width: auto;
-  margin-top: 26px;
+  margin-top: 12px;
 }
 
 .project-settings-header {
@@ -59,7 +60,7 @@
 
 .project-settings-header p,
 .project-settings-state p {
-  margin: 0 0 8px;
+  margin: 0;
   color: #006b91;
   font-size: 0.75rem;
   font-weight: 700;
@@ -406,15 +407,18 @@
 
 .project-stack-versions > div {
   display: grid;
-  grid-template-columns: minmax(0, 1fr);
+  grid-template-columns: repeat(2, minmax(0, 1fr));
   gap: 8px;
 }
 
 .project-stack-versions article {
   display: grid;
-  grid-template-columns: minmax(150px, 1.1fr) minmax(92px, 0.55fr) auto minmax(0, 1fr);
-  gap: 12px;
-  align-items: center;
+  grid-template-columns: minmax(0, 1fr) auto;
+  grid-template-areas:
+    "identity badge"
+    "source source";
+  gap: 7px 12px;
+  align-items: start;
   min-width: 0;
   border: 1px solid #dbe4ef;
   border-radius: 12px;
@@ -422,13 +426,22 @@
   background: #f8fafc;
 }
 
-.project-stack-versions article strong {
+.project-stack-version-identity {
+  display: flex;
+  grid-area: identity;
+  align-items: baseline;
+  gap: 8px;
+  min-width: 0;
+}
+
+.project-stack-version-identity strong {
   min-width: 0;
   color: #334155;
   font-size: 0.8rem;
 }
 
-.project-stack-versions article code {
+.project-stack-version-identity code {
+  flex: none;
   min-width: 0;
   color: #0f172a;
   font-size: 0.8rem;
@@ -436,6 +449,7 @@
 }
 
 .project-stack-versions article small {
+  grid-area: source;
   min-width: 0;
   color: #64748b;
   font-size: 0.68rem;
@@ -444,6 +458,7 @@
 }
 
 .project-stack-versions article span {
+  grid-area: badge;
   width: fit-content;
   border-radius: 999px;
   padding: 3px 6px;
@@ -726,29 +741,24 @@
 
   .project-stack-versions article {
     grid-template-areas:
-      "name badge"
-      "version source";
+      "identity badge"
+      "source source";
     grid-template-columns: minmax(0, 1fr) auto;
     gap: 6px 10px;
     align-items: start;
     padding: 10px 12px;
   }
 
-  .project-stack-versions article strong {
-    grid-area: name;
-  }
-
-  .project-stack-versions article code {
-    grid-area: version;
+  .project-stack-versions > div {
+    grid-template-columns: 1fr;
   }
 
   .project-stack-versions article span {
-    grid-area: badge;
+    align-self: start;
   }
 
   .project-stack-versions article small {
-    grid-area: source;
-    text-align: right;
+    text-align: left;
   }
 
   .project-stack-table {

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

@@ -34,8 +34,8 @@ const config: ProjectConfigSettings = {
 
 describe("project settings form mapping", () => {
   it("renders a canonical framework SemVer as a short major.minor label", () => {
-    expect(shortFrameworkVersion("1.0.8")).toBe("v1.0");
-    expect(shortFrameworkVersion("v1.0.8")).toBe("v1.0");
+    expect(shortFrameworkVersion("1.3.0")).toBe("v1.3");
+    expect(shortFrameworkVersion("v1.3.0")).toBe("v1.3");
     expect(shortFrameworkVersion("1.0")).toBeNull();
   });
 

package/templates/.agents/dashboard/apps/frontend/src/snapshot-banner-semantics.test.ts

@@ -6,25 +6,59 @@ describe("snapshot update banner semantics", () => {
   it("delays the notice, then hides it on dismiss or completed initial load", () => {
     expect(snapshotNoticeDelayMs).toBe(1_500);
     // A fast first-fold load completes before the delay and never flashes.
-    expect(shouldShowSnapshotNotice({ snapshotUpdating: true, initialDataPending: true, dismissed: false, delayElapsed: false })).toBe(false);
+    expect(
+      shouldShowSnapshotNotice({
+        snapshotUpdating: true,
+        initialDataPending: true,
+        dismissed: false,
+        delayElapsed: false,
+      }),
+    ).toBe(false);
     // A genuinely slow initial read receives the helpful stale-snapshot notice.
-    expect(shouldShowSnapshotNotice({ snapshotUpdating: true, initialDataPending: true, dismissed: false, delayElapsed: true })).toBe(true);
-    expect(shouldShowSnapshotNotice({ snapshotUpdating: true, initialDataPending: true, dismissed: true, delayElapsed: true })).toBe(false);
-    expect(shouldShowSnapshotNotice({ snapshotUpdating: true, initialDataPending: false, dismissed: false, delayElapsed: true })).toBe(false);
+    expect(
+      shouldShowSnapshotNotice({
+        snapshotUpdating: true,
+        initialDataPending: true,
+        dismissed: false,
+        delayElapsed: true,
+      }),
+    ).toBe(true);
+    expect(
+      shouldShowSnapshotNotice({
+        snapshotUpdating: true,
+        initialDataPending: true,
+        dismissed: true,
+        delayElapsed: true,
+      }),
+    ).toBe(false);
+    expect(
+      shouldShowSnapshotNotice({
+        snapshotUpdating: true,
+        initialDataPending: false,
+        dismissed: false,
+        delayElapsed: true,
+      }),
+    ).toBe(false);
   });
 
   it("presents a stale local snapshot as neutral status and reserves alert red for errors", () => {
     const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
     const boundary = readFileSync(new URL("./AppLoadingBoundary.tsx", import.meta.url), "utf8");
     const styles = readFileSync(new URL("./styles.css", import.meta.url), "utf8");
-    const snapshot = app.slice(app.indexOf("const initialDataPending"), app.indexOf("const renderedOperations"));
+    const snapshot = app.slice(
+      app.indexOf("const initialDataPending"),
+      app.indexOf("const renderedOperations"),
+    );
+    const compactSnapshot = snapshot.replace(/\s+/g, " ");
     const error = app.slice(app.indexOf("{error ?"), app.indexOf("{/* Cost Monitor boundary"));
 
     expect(snapshot).toContain('className="app-notice app-snapshot-status" role="status"');
     expect(snapshot).toContain('aria-live="polite"');
     expect(snapshot).toContain("shouldShowSnapshotNotice({");
     expect(snapshot).toContain("delayElapsed: snapshotNoticeDelayElapsed,");
-    expect(snapshot).toContain("window.setTimeout(() => setSnapshotNoticeDelayElapsed(true), snapshotNoticeDelayMs)");
+    expect(compactSnapshot).toMatch(
+      /window\.setTimeout\(\s*\(\) => setSnapshotNoticeDelayElapsed\(true\),\s*snapshotNoticeDelayMs,?\s*\)/,
+    );
     expect(snapshot).toContain("return () => window.clearTimeout(timeout);");
     expect(snapshot).toContain("setSnapshotNoticeDismissed(true)");
     expect(snapshot).toContain('"Fechar aviso de atualização do snapshot"');

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

@@ -2,6 +2,7 @@ import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
 import { isCurrentDashboardRequest, mergeBoardPages, needsAtomicCostSnapshot } from "./App.js";
 import { loadAtomicCostSnapshot } from "./snapshot-coherence.js";
+import { projectionRefreshDebounceMs, shouldRefreshVisibleProjection } from "./use-app-effects.js";
 
 describe("atomic Cost snapshot loading", () => {
   it("keeps Operations, Cost, and cards on one source generation while the source moves", async () => {
@@ -49,7 +50,10 @@ describe("atomic Cost snapshot loading", () => {
 
   it("opens the global overlay while the Cost page loads a selected group", () => {
     const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
-    const globalGate = app.slice(app.indexOf("const globalLoadingPending"), app.indexOf("const renderedOperations"));
+    const globalGate = app.slice(
+      app.indexOf("const globalLoadingPending"),
+      app.indexOf("const renderedOperations"),
+    );
     expect(app).toContain("const [costSurfaceLoading, setCostSurfaceLoading] = useState(false);");
     expect(globalGate).toContain("costSurfaceLoading");
     expect(globalGate).toContain('loadingArea !== "costs"');
@@ -94,6 +98,40 @@ describe("atomic Cost snapshot loading", () => {
     expect(app).toContain('setLoadingArea("costs")');
   });
 
+  it("coalesces focus and visibility events into one non-reconciling projection refresh", () => {
+    expect(
+      shouldRefreshVisibleProjection({
+        visibilityState: "visible",
+        inFlight: false,
+        lastRefreshAt: 0,
+        now: projectionRefreshDebounceMs,
+      }),
+    ).toBe(true);
+    expect(
+      shouldRefreshVisibleProjection({
+        visibilityState: "visible",
+        inFlight: false,
+        lastRefreshAt: projectionRefreshDebounceMs,
+        now: projectionRefreshDebounceMs + 1,
+      }),
+    ).toBe(false);
+    expect(
+      shouldRefreshVisibleProjection({
+        visibilityState: "hidden",
+        inFlight: false,
+        lastRefreshAt: 0,
+        now: projectionRefreshDebounceMs * 2,
+      }),
+    ).toBe(false);
+    const effects = readFileSync(new URL("./use-app-effects.ts", import.meta.url), "utf8");
+    expect(effects).toContain('window.addEventListener("focus", refreshVisibleProjection)');
+    expect(effects).toContain(
+      'document.addEventListener("visibilitychange", refreshVisibleProjection)',
+    );
+    expect(effects).not.toContain("setInterval");
+    expect(effects).toContain("void refresh(false, false, true)");
+  });
+
   it("removes the global Cost detail request and keeps stale request guards", () => {
     const app = readFileSync(new URL("./App.tsx", import.meta.url), "utf8");
     const costPage = readFileSync(

package/templates/.agents/dashboard/apps/frontend/src/use-app-cost-loaders.test.ts

@@ -1,5 +1,5 @@
-import { describe, expect, it } from "vitest";
 import { CostRunsTable, matchesCostRunFilter } from "@zaip-ai/dashboard-cost-monitor/react";
+import { describe, expect, it } from "vitest";
 import {
   adaptSqliteCompactLifecyclePage,
   adaptSqliteCostRun,
@@ -19,7 +19,16 @@ describe("daily Cost Monitor continuous pagination", () => {
             total_count: 35,
             has_more: true,
             rows: [{ period_key: "2026-08-17" }, { period_key: "2026-07-19" }],
-            totals: { task_count: 916, prd_count: 13, spec_count: 59, total_run_count: 238, total_duration: 619_920_000, total_tokens: 7_300_000_000, total_cost_usd: 8_731.92, total_cost_brl: 47_589 },
+            totals: {
+              task_count: 916,
+              prd_count: 13,
+              spec_count: 59,
+              total_run_count: 238,
+              total_duration: 619_920_000,
+              total_tokens: 7_300_000_000,
+              total_cost_usd: 8_731.92,
+              total_cost_brl: 47_589,
+            },
           };
         }
         return {
@@ -27,12 +36,35 @@ describe("daily Cost Monitor continuous pagination", () => {
           limit: 30,
           total_count: 35,
           has_more: false,
-          rows: [{ period_key: "2026-07-18", task_count: 2, total_tokens: 10 }, { period_key: "2026-07-14", task_count: 2, total_tokens: 10 }],
-          totals: { task_count: 916, prd_count: 13, spec_count: 59, total_run_count: 238, total_duration: 619_920_000, total_tokens: 7_300_000_000, total_cost_usd: 8_731.92, total_cost_brl: 47_589 },
+          rows: [
+            { period_key: "2026-07-18", task_count: 2, total_tokens: 10 },
+            { period_key: "2026-07-14", task_count: 2, total_tokens: 10 },
+          ],
+          totals: {
+            task_count: 916,
+            prd_count: 13,
+            spec_count: 59,
+            total_run_count: 238,
+            total_duration: 619_920_000,
+            total_tokens: 7_300_000_000,
+            total_cost_usd: 8_731.92,
+            total_cost_brl: 47_589,
+          },
         };
       },
     };
-    const filters = { query: "", provider: "", model: "", agent: "", phase: "", status: "", origin: "", workType: "", priority: "", risk: "" } as never;
+    const filters = {
+      query: "",
+      provider: "",
+      model: "",
+      agent: "",
+      phase: "",
+      status: "",
+      origin: "",
+      workType: "",
+      priority: "",
+      risk: "",
+    } as never;
     const firstPage = await loadSqliteCostGroupPage(api as never, {
       view: "daily",
       from: "2026-07-14",
@@ -51,8 +83,16 @@ describe("daily Cost Monitor continuous pagination", () => {
     });
 
     expect(calls).toEqual([
-      { view: "cost_monitor_daily", range: { from: "2026-07-14", to: "2026-08-17" }, page: { offset: 0, limit: 30 } },
-      { view: "cost_monitor_daily", range: { from: "2026-07-14", to: "2026-08-17" }, page: { offset: 30, limit: 30 } },
+      {
+        view: "cost_monitor_daily",
+        range: { from: "2026-07-14", to: "2026-08-17" },
+        page: { offset: 0, limit: 30 },
+      },
+      {
+        view: "cost_monitor_daily",
+        range: { from: "2026-07-14", to: "2026-08-17" },
+        page: { offset: 30, limit: 30 },
+      },
     ]);
     expect(firstPage).toMatchObject({
       offset: 0,
@@ -60,7 +100,13 @@ describe("daily Cost Monitor continuous pagination", () => {
       total_count: 35,
       has_more: true,
       rows: [{ key: "2026-08-17" }, { key: "2026-07-19" }],
-      totals: { task_count: 916, prd_count: 13, spec_count: 59, total_tokens: 7_300_000_000, estimated_brl: 47_589 },
+      totals: {
+        task_count: 916,
+        prd_count: 13,
+        spec_count: 59,
+        total_tokens: 7_300_000_000,
+        estimated_brl: 47_589,
+      },
     });
     expect(secondPage).toMatchObject({
       offset: 30,
@@ -102,10 +148,12 @@ describe("adaptSqliteCostRun", () => {
       currency: "BRL",
       locale: "pt-BR",
     });
-    const multiplier = (table.props.columns as Array<{
-      key: string;
-      render: (row: typeof run) => unknown;
-    }>).find((column) => column.key === "contextMultiplier");
+    const multiplier = (
+      table.props.columns as Array<{
+        key: string;
+        render: (row: typeof run) => unknown;
+      }>
+    ).find((column) => column.key === "contextMultiplier");
     expect(multiplier?.render(run)).toBe("Indisponível");
     expect(
       matchesCostRunFilter(run, {
@@ -165,22 +213,40 @@ describe("adaptSqliteCompactLifecyclePage", () => {
       limit: 50,
       total_count: 270,
       has_more: true,
-      totals: { entity_count: 270, invocation_count: 270, total_duration: 270_000, total_tokens: 540, total_cost_usd: 270, total_cost_brl: 1_350 },
-      rows: Array.from({ length: 50 }, (_, index) => ({ task_id: `TASK-${index}`, invocation_count: 1, total_duration: 1_000, total_tokens: 2, total_cost_brl: 5 })),
+      totals: {
+        entity_count: 270,
+        invocation_count: 270,
+        total_duration: 270_000,
+        total_tokens: 540,
+        total_cost_usd: 270,
+        total_cost_brl: 1_350,
+      },
+      rows: Array.from({ length: 50 }, (_, index) => ({
+        task_id: `TASK-${index}`,
+        invocation_count: 1,
+        total_duration: 1_000,
+        total_tokens: 2,
+        total_cost_brl: 5,
+      })),
     } as const;
-    for (const [kind, view] of [["tasks", "cost_monitor_tasks"], ["specs", "cost_monitor_specs"], ["prds", "cost_monitor_prds"], ["conversations", "cost_monitor_conversations"]] as const) {
+    for (const [kind, view] of [
+      ["tasks", "cost_monitor_tasks"],
+      ["specs", "cost_monitor_specs"],
+      ["prds", "cost_monitor_prds"],
+      ["conversations", "cost_monitor_conversations"],
+    ] as const) {
       const page = adaptSqliteCompactLifecyclePage(kind, { ...sqlitePage, view });
       expect(page.rows).toHaveLength(50);
       expect(page.offset).toBe(50);
       expect(page.subtotal).toEqual({
-      entity_count: 270,
-      run_count: { known_sum: 270, unknown: 0, complete: true, coverage_ratio: 1 },
-      metrics: {
-        duration: { known_sum: 270_000, unknown: 0, complete: true, coverage_ratio: 1 },
-        total_tokens: { known_sum: 540, unknown: 0, complete: true, coverage_ratio: 1 },
-        cost_brl: { known_sum: 1_350, unknown: 0, complete: true, coverage_ratio: 1 },
-        cost_usd: { known_sum: 270, unknown: 0, complete: true, coverage_ratio: 1 },
-      },
+        entity_count: 270,
+        run_count: { known_sum: 270, unknown: 0, complete: true, coverage_ratio: 1 },
+        metrics: {
+          duration: { known_sum: 270_000, unknown: 0, complete: true, coverage_ratio: 1 },
+          total_tokens: { known_sum: 540, unknown: 0, complete: true, coverage_ratio: 1 },
+          cost_brl: { known_sum: 1_350, unknown: 0, complete: true, coverage_ratio: 1 },
+          cost_usd: { known_sum: 270, unknown: 0, complete: true, coverage_ratio: 1 },
+        },
       });
     }
   });