@zaip-ai/cli 3.7.0 → 4.0.0

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-source-fingerprint.ts

@@ -1,6 +1,10 @@
+import { execFile } from "node:child_process";
 import { createHash } from "node:crypto";
 import { readdir, readFile, stat } from "node:fs/promises";
 import { join, relative, resolve } from "node:path";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
 
 const textExtensions = new Set([".json", ".jsonl", ".md", ".yaml", ".yml", ".txt"]);
 
@@ -45,8 +49,141 @@ export type SqliteReadModelSourceCheckpoint = Omit<SqliteReadModelSourceCandidat
 type FingerprintOptions = {
   previous?: ReadonlyMap<string, SqliteReadModelSourceCheckpoint>;
   verifyContent?: boolean;
+  /** Explicit roots allow deterministic testing without a Git checkout. */
+  sourceRoots?: readonly string[] | undefined;
 };
 
+export async function dashboardCanonicalSourceRoots(workspaceRoot: string): Promise<string[]> {
+  const primary = resolve(workspaceRoot);
+  const gitRoot = await execFileAsync("git", ["rev-parse", "--show-toplevel"], {
+    cwd: primary,
+    encoding: "utf8",
+    windowsHide: true,
+    timeout: 5_000,
+  }).catch(() => ({ stdout: "" }));
+  if (resolve(gitRoot.stdout.trim()).toLowerCase() !== primary.toLowerCase()) return [primary];
+  const output = await execFileAsync("git", ["worktree", "list", "--porcelain"], {
+    cwd: primary,
+    encoding: "utf8",
+    windowsHide: true,
+    timeout: 15_000,
+  }).catch(() => ({ stdout: "" }));
+  // Git supplies only worktrees registered to this repository. Ignore unrelated
+  // sibling folders and ordinary task workspaces; they are not Codex worktrees.
+  const registeredRoots = output.stdout
+    .split(/\r?\n/u)
+    .filter((line) => line.startsWith("worktree "))
+    .map((line) => resolve(line.slice(9).trim()));
+  const codexRoots = registeredRoots.filter(isCodexManagedWorktreeRoot);
+  // The first registered checkout is the repository's main worktree and may
+  // contain canonical history absent from a Codex worktree's branch.
+  return [...new Set([primary, ...registeredRoots.slice(0, 1), ...codexRoots])];
+}
+
+export function isCodexManagedWorktreeRoot(root: string): boolean {
+  // Internal Task workspaces can sit below a managed checkout but are not
+  // separate Codex checkouts. Avoid re-scanning that nested copy on every
+  // dashboard refresh.
+  return /[\\/]\.codex[\\/]worktrees(?:[\\/][^\\/]+){1,2}$/iu.test(root);
+}
+
+function canonicalRevision(content: string, source: string): [string, number, number] {
+  if (source.endsWith(".jsonl")) {
+    const dates = [...content.matchAll(/"occurred_at"\s*:\s*"([^"]+)"/gu)];
+    return [
+      dates.reduce((latest, match) => ((match[1] ?? "") > latest ? (match[1] ?? "") : latest), ""),
+      dates.length,
+      content.length,
+    ];
+  }
+  const updated = /^updated_at:\s*([^\r\n]+)/mu.exec(content)?.[1]?.trim() ?? "";
+  const created = /^created_at:\s*([^\r\n]+)/mu.exec(content)?.[1]?.trim() ?? "";
+  const revision = Number(/^revision:\s*(\d+)/mu.exec(content)?.[1] ?? 0);
+  return [updated || created, revision, content.length];
+}
+
+async function selectCanonicalSources(
+  roots: readonly string[],
+): Promise<Array<{ path: string; source: string }>> {
+  const locations = new Map<string, string[]>();
+  for (const [index, root] of roots.entries()) {
+    const directories =
+      index === 0
+        ? [
+            ".agents/config",
+            ...[
+              "tasks",
+              "specs",
+              "prds",
+              "runs",
+              "executions",
+              "changes",
+              "lifecycle/historical-developer-attribution",
+            ].flatMap((kind) => [`.agents/data/${kind}`, `.agents/records/${kind}`]),
+          ]
+        : [
+            "tasks",
+            "specs",
+            "prds",
+            "runs",
+            "executions",
+            "changes",
+            "lifecycle/historical-developer-attribution",
+          ].map((kind) => `.agents/records/${kind}`);
+    const paths = (
+      await Promise.all(directories.map((directory) => listFiles(resolve(root, directory))))
+    ).flat();
+    for (const path of paths) {
+      const source = relative(root, path).replaceAll("\\", "/");
+      if (
+        !textExtensions.has(path.slice(path.lastIndexOf(".")).toLowerCase()) ||
+        !isDashboardCanonicalSource(source)
+      )
+        continue;
+      const peers = locations.get(source) ?? [];
+      peers.push(path);
+      locations.set(source, peers);
+    }
+  }
+  const selected: Array<{ path: string; source: string }> = [];
+  const entries = [...locations.entries()];
+  for (let offset = 0; offset < entries.length; offset += 32) {
+    selected.push(
+      ...(await Promise.all(
+        entries.slice(offset, offset + 32).map(async ([source, paths]) => {
+          const firstPath = paths[0];
+          if (firstPath === undefined) throw new Error(`No canonical source for ${source}`);
+          if (paths.length === 1) return { source, path: firstPath };
+          // Worktree checkout mtimes do not represent canonical record recency.
+          // Compare embedded revision timestamps and prefer the first registered
+          // source on an exact tie, so repeated scans remain deterministic.
+          const revisions = await Promise.all(
+            paths.map(async (path) => canonicalRevision(await readFile(path, "utf8"), source)),
+          );
+          let winner = 0;
+          for (let index = 1; index < paths.length; index += 1) {
+            const left = revisions[index];
+            const right = revisions[winner];
+            if (left === undefined || right === undefined)
+              throw new Error(`Incomplete canonical revisions for ${source}`);
+            if (
+              left[0] > right[0] ||
+              (left[0] === right[0] &&
+                (left[1] > right[1] || (left[1] === right[1] && left[2] > right[2])))
+            )
+              winner = index;
+          }
+          const selectedPath = paths[winner];
+          if (selectedPath === undefined)
+            throw new Error(`No selected canonical source for ${source}`);
+          return { source, path: selectedPath };
+        }),
+      )),
+    );
+  }
+  return selected.sort((left, right) => left.source.localeCompare(right.source));
+}
+
 export async function sourceFingerprint(
   workspaceRoot: string,
   options: FingerprintOptions = {},
@@ -56,29 +193,9 @@ export async function sourceFingerprint(
   hashedFiles: number;
   reusedFiles: number;
 }> {
-  const candidates = (
-    await Promise.all(
-      [
-        ".agents/config",
-        ...[
-          "tasks",
-          "specs",
-          "prds",
-          "runs",
-          "executions",
-          "changes",
-          "lifecycle/historical-developer-attribution",
-        ].flatMap((kind) => [`.agents/data/${kind}`, `.agents/records/${kind}`]),
-      ].map((root) => listFiles(resolve(workspaceRoot, root))),
-    )
-  )
-    .flat()
-    .filter(
-      (path) =>
-        textExtensions.has(path.slice(path.lastIndexOf(".")).toLowerCase()) &&
-        isDashboardCanonicalSource(relative(workspaceRoot, path).replaceAll("\\", "/")),
-    )
-    .sort();
+  const candidates = await selectCanonicalSources(
+    options.sourceRoots ?? (await dashboardCanonicalSourceRoots(workspaceRoot)),
+  );
   const candidatesWithMetadata: SqliteReadModelSourceCandidate[] = [];
   let hashedFiles = 0;
   let reusedFiles = 0;
@@ -91,8 +208,7 @@ export async function sourceFingerprint(
     candidatesWithMetadata.push(
       ...(
         await Promise.all(
-          candidates.slice(offset, offset + 32).map(async (candidate) => {
-            const source = relative(workspaceRoot, candidate).replaceAll("\\", "/");
+          candidates.slice(offset, offset + 32).map(async ({ path: candidate, source }) => {
             try {
               for (let attempt = 0; attempt < 3; attempt += 1) {
                 const metadata = await stat(candidate);

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-read-model-worktree-sources.test.ts

@@ -0,0 +1,60 @@
+import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { describe, expect, it } from "vitest";
+import { rebuildSqliteReadModel } from "./sqlite-read-model.js";
+
+const tempRoot = join(
+  resolve(import.meta.dirname, "../../../../../.."),
+  ".tmp",
+  "sqlite-read-model-tests",
+);
+
+describe("SQLite worktree source aggregation", () => {
+  it("materializes recent worktree Tasks once and refreshes when a sibling changes", async () => {
+    await mkdir(tempRoot, { recursive: true });
+    const root = await mkdtemp(join(tempRoot, "fixture-"));
+    const sibling = await mkdtemp(join(tempRoot, "fixture-"));
+    try {
+      await mkdir(join(root, ".agents/config"), { recursive: true });
+      await mkdir(join(root, ".agents/records/tasks"), { recursive: true });
+      await mkdir(join(sibling, ".agents/records/tasks"), { recursive: true });
+      await writeFile(join(root, ".agents/config/project.yaml"), "zaip:\n  enabled: true\n");
+      const oldRecord =
+        "---\nid: TASK-DUPLICATE\ntitle: Old\nstatus: executing\ncreated_at: 2026-09-17T10:00:00Z\nupdated_at: 2026-09-17T10:00:00Z\n---\n";
+      const newRecord = oldRecord.replace("Old", "Recent").replaceAll("2026-09-17", "2026-09-23");
+      await writeFile(join(root, ".agents/records/tasks/TASK-DUPLICATE.md"), oldRecord);
+      await writeFile(join(sibling, ".agents/records/tasks/TASK-DUPLICATE.md"), newRecord);
+      await writeFile(
+        join(sibling, ".agents/records/tasks/TASK-NEW.md"),
+        newRecord.replaceAll("TASK-DUPLICATE", "TASK-NEW"),
+      );
+      const options = { sourceRoots: [root, sibling] };
+      await rebuildSqliteReadModel(root, options);
+      const database = new DatabaseSync(join(root, ".local/sqlite/zaip-aios-dashboard.sqlite"), {
+        readOnly: true,
+      });
+      try {
+        expect(
+          database.prepare("SELECT count(*) AS n FROM zaip_vw_task_summary").get(),
+        ).toMatchObject({ n: 2 });
+        expect(
+          database
+            .prepare("SELECT task_count FROM zaip_vw_daily_aggregates WHERE day=?")
+            .get("2026-09-23"),
+        ).toMatchObject({ task_count: 2 });
+      } finally {
+        database.close();
+      }
+      await writeFile(
+        join(sibling, ".agents/records/tasks/TASK-THIRD.md"),
+        newRecord.replaceAll("TASK-DUPLICATE", "TASK-THIRD"),
+      );
+      const refreshed = await rebuildSqliteReadModel(root, options);
+      expect(refreshed.refresh.added_sources).toBe(1);
+    } finally {
+      await rm(root, { recursive: true, force: true });
+      await rm(sibling, { recursive: true, force: true });
+    }
+  });
+});

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-rebuild-fingerprint-options.ts

@@ -0,0 +1,13 @@
+import { persistedSourceCheckpoint } from "./sqlite-read-model-schema.js";
+
+export interface SqliteRebuildOptions {
+  forceCanonical?: boolean;
+  preferExisting?: boolean;
+  sourceRoots?: readonly string[];
+}
+
+export function rebuildFingerprintOptions(path: string, options: SqliteRebuildOptions) {
+  return options.forceCanonical
+    ? { verifyContent: true, sourceRoots: options.sourceRoots }
+    : { previous: persistedSourceCheckpoint(path), sourceRoots: options.sourceRoots };
+}

package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-launch-page.mjs

@@ -1,5 +1,9 @@
+import { execFile } from "node:child_process";
 import { createServer as createHttpServer } from "node:http";
 import { basename } from "node:path";
+import { promisify } from "node:util";
+
+const execFileAsync = promisify(execFile);
 
 const escapeHtml = (text) =>
   String(text).replace(
@@ -8,6 +12,21 @@ const escapeHtml = (text) =>
       ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[character],
   );
 
+async function githubRepository(workspaceRoot) {
+  if (!workspaceRoot) return null;
+  try {
+    const { stdout } = await execFileAsync(
+      "git",
+      ["-C", workspaceRoot, "remote", "get-url", "origin"],
+      { encoding: "utf8", windowsHide: true, timeout: 1500 },
+    );
+    const match = stdout.trim().match(/github\.com(?::|\/)([^/\s]+)\/([^/\s]+?)(?:\.git)?$/i);
+    return match ? `${match[1]}/${match[2]}` : null;
+  } catch {
+    return null;
+  }
+}
+
 export async function createDashboardLaunchPage({
   port,
   host,
@@ -16,6 +35,10 @@ export async function createDashboardLaunchPage({
   delay,
   workspaceRoot = "",
 }) {
+  const repository = await githubRepository(workspaceRoot);
+  const repositoryBadge = repository
+    ? `<a class="repository-badge" href="https://github.com/${escapeHtml(repository)}" target="_blank" rel="noopener noreferrer" aria-label="Repositório GitHub ${escapeHtml(repository)}"><svg aria-hidden="true" viewBox="0 0 16 16" fill="currentColor"><path d="M8 0a8 8 0 0 0-2.53 15.59c.4.07.55-.17.55-.39v-1.5c-2.23.49-2.7-.95-2.7-.95-.36-.93-.89-1.18-.89-1.18-.73-.5.05-.49.05-.49.8.06 1.23.82 1.23.82.71 1.22 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.9-3.64-3.95 0-.87.31-1.58.82-2.14-.08-.2-.36-1.01.08-2.11 0 0 .67-.21 2.2.82a7.67 7.67 0 0 1 4 0c1.53-1.03 2.2-.82 2.2-.82.44 1.1.16 1.91.08 2.11.51.56.82 1.27.82 2.14 0 3.06-1.87 3.75-3.65 3.95.28.24.53.71.53 1.44v2.27c0 .22.14.47.55.39A8 8 0 0 0 8 0Z"/></svg>${escapeHtml(repository)}</a>`
+    : "";
   let redirectUrl = null;
   let failure = null;
   let progress = {
@@ -86,17 +109,18 @@ export async function createDashboardLaunchPage({
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width,initial-scale=1">
-  <title>Dashboard Zaip AIOS</title>
+  <title>Dashboard ZAIP AIOS</title>
   <style>
     :root{color-scheme:dark;font-family:Inter,system-ui,sans-serif;background:#010610;color:#f1f5f9}
     *{box-sizing:border-box}body{margin:0;background:#010610}.launch-overlay{position:fixed;inset:0;width:100vw;height:100vh;display:grid;place-items:center;padding:clamp(18px,5vw,72px);background:radial-gradient(circle at 50% 35%,rgba(0,176,240,.11),transparent 42%),#010610}
     .progress{width:min(100%,760px);padding:clamp(24px,4vw,42px);border:1px solid rgba(125,211,252,.2);border-radius:20px;background:rgba(3,9,22,.94);box-shadow:0 24px 80px rgba(0,0,0,.45);backdrop-filter:blur(10px)}.progress strong,.progress span:not(.handoff):not(.failure){display:block}.progress strong{font-size:clamp(1.05rem,2vw,1.35rem)}.progress span{color:#b6c6db;font-size:clamp(.88rem,1.5vw,1rem);margin-top:7px}.track{position:relative;height:9px;margin-top:20px;border-radius:999px;background:#172033;overflow:hidden}.track::after{content:"";position:absolute;z-index:2;inset:0;background:linear-gradient(90deg,transparent 0%,rgba(224,242,254,.14) 35%,rgba(224,242,254,.8) 50%,rgba(224,242,254,.14) 65%,transparent 100%);transform:translateX(-100%);animation:launch-activity 1.35s ease-in-out infinite;pointer-events:none}.progress.terminal-failure .track::after{animation:none;transform:none;background:rgba(254,202,202,.2)}.progress.terminal-failure .bar{background:#f87171}.bar{position:relative;z-index:1;height:100%;width:4%;border-radius:inherit;background:linear-gradient(90deg,#38bdf8,#818cf8);transition:width .35s ease}@keyframes launch-activity{to{transform:translateX(100%)}}@media (prefers-reduced-motion:reduce){.track::after{animation:none;transform:none;background:linear-gradient(90deg,transparent 0%,rgba(224,242,254,.2) 50%,transparent 100%)}}.handoff,.failure{display:none;margin-top:16px;color:#dbeafe}.failure{color:#fecaca}
     .activity{min-height:1.3em}.steps{display:grid;gap:7px;max-height:12.5rem;overflow:auto;margin:18px 0 0;padding:0;list-style:none}.steps li{position:relative;padding-left:20px;color:#94a3b8;font-size:.82rem}.steps li::before{content:"";position:absolute;left:1px;top:.4em;width:8px;height:8px;border-radius:50%;background:#475569}.steps li[data-state="active"]{color:#dbeafe}.steps li[data-state="active"]::before{background:#38bdf8;box-shadow:0 0 0 4px rgba(56,189,248,.16)}.progress.terminal-failure .steps li[data-state="active"]::before{background:#f87171}@media (prefers-reduced-motion:reduce){.bar{transition:none}}
+    .launch-heading{margin-bottom:18px}.launch-heading h1{margin:0;font-size:clamp(1.2rem,2.4vw,1.55rem)}.workspace-identity{display:flex;flex-wrap:wrap;align-items:center;gap:10px}.repository-badge{display:inline-flex;align-items:center;gap:7px;max-width:100%;padding:6px 10px;border-radius:999px;background:#f8fafc;color:#0f172a;font-size:.78rem;font-weight:700;text-decoration:none;overflow-wrap:anywhere}.repository-badge svg{width:15px;height:15px;flex:none}.repository-badge:focus-visible{outline:2px solid #7dd3fc;outline-offset:3px}
   </style>
 </head>
 <body>
   <main class="launch-overlay" aria-label="Preparando dashboard" aria-busy="true">
-    <section class="progress" aria-live="polite" role="status"><div aria-label="Workspace" style="margin-bottom:20px;overflow-wrap:anywhere"><strong>${escapeHtml(basename(workspaceRoot))}</strong><span>${escapeHtml(workspaceRoot)}</span></div><strong id="phase">Iniciando o launcher local</strong><span id="detail">Abrindo a página de preparação.</span><span class="activity" id="activity" aria-hidden="true">Atividade em andamento.</span><div class="track" id="track" role="progressbar" aria-label="Preparação em andamento" aria-valuemin="0" aria-valuemax="100" aria-valuenow="4" aria-valuetext="Iniciando o launcher local"><div class="bar" id="bar"></div></div><ol class="steps" id="steps" aria-label="Etapas de preparação"><li data-state="active">Iniciando o launcher local</li></ol><span class="handoff" id="handoff">O dashboard está pronto. Abrindo a tela principal automaticamente…</span><span class="failure" id="failure" role="alert"></span></section>
+    <section class="progress" aria-live="polite" role="status"><div class="launch-heading"><h1>Dashboard ZAIP AIOS</h1></div><div aria-label="Workspace" style="margin-bottom:20px;overflow-wrap:anywhere"><div class="workspace-identity"><strong>${escapeHtml(basename(workspaceRoot))}</strong>${repositoryBadge}</div><span>${escapeHtml(workspaceRoot)}</span></div><strong id="phase">Iniciando o launcher local</strong><span id="detail">Abrindo a página de preparação.</span><span class="activity" id="activity" aria-hidden="true">Atividade em andamento.</span><div class="track" id="track" role="progressbar" aria-label="Preparação em andamento" aria-valuemin="0" aria-valuemax="100" aria-valuenow="4" aria-valuetext="Iniciando o launcher local"><div class="bar" id="bar"></div></div><ol class="steps" id="steps" aria-label="Etapas de preparação"><li data-state="active">Iniciando o launcher local</li></ol><span class="handoff" id="handoff">O dashboard está pronto. Abrindo a tela principal automaticamente…</span><span class="failure" id="failure" role="alert"></span></section>
   </main>
   <script>
     let handoffTarget=null,progressRequestInFlight=false,terminalFailure=false,lastProgressPercent=4,compilationStartedAt=null,compilationDetail="",compilationTicker=null,activeStepKey="",activeStepStartedAt=Date.now();

package/templates/.agents/dashboard/packages/local-runtime/start-dashboard-launch-page.test.mjs

@@ -12,6 +12,9 @@ describe("dashboard launch page", () => {
 
       expect(page.status).toBe(200);
       const html = await page.text();
+      expect(html).toContain("<h1>Dashboard ZAIP AIOS</h1>");
+      expect(html).toContain('class="repository-badge"');
+      expect(html).toContain("zaip-ai/zaip-aios</a>");
       expect(html).toContain('class="launch-overlay"');
       expect(html).toContain("position:fixed;inset:0;width:100vw;height:100vh");
       expect(html).toContain("display:grid;place-items:center");
@@ -69,6 +72,8 @@ describe("dashboard launch page", () => {
       );
       await page.route("**/api/v2/health", () => new Promise(() => {}));
       await page.goto(`http://${host}:${launchPage.port}/?token=temporary`);
+      if (process.env.ZAIP_LAUNCH_SCREENSHOT_PATH)
+        await page.screenshot({ path: process.env.ZAIP_LAUNCH_SCREENSHOT_PATH });
 
       await expect
         .poll(() =>

package/templates/.agents/dashboard/packages/ui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-ui",
-  "version": "3.7.0",
+  "version": "4.0.0",
   "private": true,
   "type": "module",
   "exports": {

package/templates/.agents/dashboard/packages/ui/src/DashboardHeader.test.mjs

@@ -2,6 +2,7 @@ import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
 
 const styles = readFileSync(new URL("ui.css", import.meta.url), "utf8");
+const headerSource = readFileSync(new URL("DashboardHeader.tsx", import.meta.url), "utf8");
 
 describe("DashboardHeader", () => {
   it("optically balances the repository badge horizontal spacing", () => {
@@ -9,6 +10,10 @@ describe("DashboardHeader", () => {
     expect(rule).toContain("padding-block: 0.3rem");
     expect(rule).toContain("padding-inline: 0.6rem 0.72rem");
   });
+  it("labels the timestamp as telemetry rather than overall snapshot freshness", () => {
+    expect(headerSource).toContain('updated: "Última telemetria"');
+    expect(headerSource).toContain('waiting: "Sem telemetria medida"');
+  });
 });
 
 function cssRule(source, selector) {

package/templates/.agents/dashboard/packages/ui/src/DashboardHeader.tsx

@@ -38,8 +38,8 @@ export function DashboardHeader({
           refresh: "Atualizar",
           refreshing: "Atualizando…",
           settings: "Configurações",
-          updated: "Atualizado",
-          waiting: "Aguardando atualização",
+          updated: "Última telemetria",
+          waiting: "Sem telemetria medida",
         }
       : {
           filters: "Filters",
@@ -47,8 +47,8 @@ export function DashboardHeader({
           refresh: "Refresh",
           refreshing: "Refreshing…",
           settings: "Settings",
-          updated: "Updated",
-          waiting: "Waiting for refresh",
+          updated: "Last telemetry",
+          waiting: "No measured telemetry",
         };
   const updatedLabel =
     lastUpdatedAt === null

package/templates/.agents/dashboard/tests/e2e/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/dashboard-e2e",
-  "version": "3.7.0",
+  "version": "4.0.0",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/dashboard/tests/e2e/playwright.config.ts

@@ -42,6 +42,10 @@ export default defineConfig({
       // Match the Windows launcher: first paint uses the latest validated
       // immutable seed while canonical refresh work stays off the served path.
       ZAIP_SQLITE_PREFER_LAST_VALID_SEED: "1",
+      // Browser qualification reads a fixed Git candidate. Live host capture
+      // would mutate its canonical records during the clean-worktree gate.
+      // Source-watch/capture behavior has separate runtime tests.
+      ZAIP_DASHBOARD_WATCH_SOURCES: "0",
       // Keep pre-bind progress observable if the web-server health gate times out.
       ZAIP_DASHBOARD_LAUNCH_PROGRESS: "1",
     },

package/templates/.agents/dashboard/tests/e2e/specs/dashboard-performance-matrix.spec.ts

@@ -1,24 +1,13 @@
 import { expect, type Locator, type Page, test } from "@playwright/test";
 import { exportRowIdentity } from "./export-row-identity.js";
-
-type Metric = {
-  surface: string;
-  period: "this-month" | "all";
-  ttfv_ms: number;
-  settled_ms: number;
-  request_count: number;
-};
-
-type SqlitePage = {
-  offset: number;
-  limit: number;
-  total_count: number;
-  has_more: boolean;
-  rows: readonly Record<string, unknown>[];
-};
+import type { Metric, SqlitePage } from "./performance-matrix-types.js";
+import {
+  assertPerformanceWarnings,
+  observePerformanceWarnings,
+} from "./performance-observability.js";
+import { workRowIdentities } from "./performance-work-row-identity.js";
 
 type PeriodQuery = { from: string | null; to: string | null };
-
 const costViews = [
   ["Diário", "daily", "cost_monitor_daily"],
   ["Mensal", "monthly", "cost_monitor_monthly"],
@@ -91,11 +80,12 @@ test("measures Cost, Operation and Traceability surfaces without full snapshot h
   page.on("requestfinished", finishApiRequest);
   page.on("requestfailed", finishApiRequest);
   page.on("response", (response) => {
+    const startedAt = requestStartedAt.get(response.request());
+    const elapsed = startedAt === undefined ? undefined : performance.now() - startedAt;
     if (process.env.ZAIP_E2E_LOG_TIMINGS === "1") {
-      const startedAt = requestStartedAt.get(response.request());
-      if (startedAt !== undefined) {
+      if (elapsed !== undefined) {
         console.log(
-          `DASHBOARD_API_TIMING ${Math.round(performance.now() - startedAt)}ms ${response.status()} ${response.url()}`,
+          `DASHBOARD_API_TIMING ${Math.round(elapsed)}ms ${response.status()} ${response.url()}`,
         );
       }
     }
@@ -115,6 +105,7 @@ test("measures Cost, Operation and Traceability surfaces without full snapshot h
     }
   });
   page.on("pageerror", (error) => pageErrors.push(error.message));
+  const performanceWarnings = observePerformanceWarnings(page, requestStartedAt);
 
   await installExportSink(page);
   await openDashboard(page);
@@ -156,6 +147,7 @@ test("measures Cost, Operation and Traceability surfaces without full snapshot h
   await verifyCompleteWorkListExport(page);
 
   expect(pageErrors).toEqual([]);
+  assertPerformanceWarnings(performanceWarnings);
   expect(apiFailures).toEqual([]);
   expect(idleSnapshots).toEqual([]);
   console.log(`DASHBOARD_PERFORMANCE_MATRIX ${JSON.stringify(metrics)}`);
@@ -359,7 +351,7 @@ async function assertWorkListPagination(
   const totalText = await pager.locator("output").textContent();
   const total = Number(totalText?.match(/de\s+(\d+)/)?.[1] ?? 0);
   if (total > 10) {
-    const firstPageRows = await rowSignatures(rows);
+    const firstPageRows = await workRowIdentities(rows);
     const next = pager.getByRole("button", { name: "Próxima" });
     await expect(next).toBeEnabled();
     await assertNoFullscreenOverlay(page);
@@ -369,7 +361,7 @@ async function assertWorkListPagination(
     await expect(pager.locator("output")).toContainText("11–", { timeout: 10_000 });
     await expect(rows).toHaveCount(Math.min(10, total - 10), { timeout: 10_000 });
     await expect(surface).not.toHaveAttribute("aria-busy", "true", { timeout: 10_000 });
-    expect(await rowSignatures(rows)).not.toEqual(firstPageRows);
+    expect(await workRowIdentities(rows)).not.toEqual(firstPageRows);
     // Filter hydration must not reset an already loaded page after navigation.
     await waitForApiQuiet(matchesSelection);
     await expect(pager.locator("output")).toContainText("11–", { timeout: 10_000 });
@@ -381,7 +373,7 @@ async function assertWorkListPagination(
     await expect(pager.locator("output")).toContainText("1–", { timeout: 10_000 });
     await expect(rows).toHaveCount(Math.min(10, total), { timeout: 10_000 });
     await expect(surface).not.toHaveAttribute("aria-busy", "true", { timeout: 10_000 });
-    expect(await rowSignatures(rows)).toEqual(firstPageRows);
+    expect(await workRowIdentities(rows)).toEqual(firstPageRows);
     await assertNoFullscreenOverlay(page);
   }
 }

package/templates/.agents/dashboard/tests/e2e/specs/dashboard.spec.ts

@@ -173,7 +173,7 @@ test("renders the modern read-only dashboard and meets accessibility gates", asy
   // Identity is loaded independently; both the initial title and the title
   // with the observed repository identify the same accessible navigation.
   await expect(
-    page.getByRole("navigation", { name: /^Dashboard Zaip AIOS(?: .+)? menu$/ }),
+    page.getByRole("navigation", { name: /^Dashboard ZAIP AIOS(?: .+)? menu$/ }),
   ).toBeVisible();
   const capabilityNav = page.getByRole("navigation", { name: "Áreas do dashboard" });
   const globalControls = page.locator(".dashboard-global-controls");

package/templates/.agents/dashboard/tests/e2e/specs/performance-matrix-types.ts

@@ -0,0 +1,15 @@
+export type Metric = {
+  surface: string;
+  period: "this-month" | "all";
+  ttfv_ms: number;
+  settled_ms: number;
+  request_count: number;
+};
+
+export type SqlitePage = {
+  offset: number;
+  limit: number;
+  total_count: number;
+  has_more: boolean;
+  rows: readonly Record<string, unknown>[];
+};

package/templates/.agents/dashboard/tests/e2e/specs/performance-observability.ts

@@ -0,0 +1,30 @@
+import { expect, type Page, type Request } from "@playwright/test";
+
+export function observePerformanceWarnings(page: Page, requestStartedAt: WeakMap<Request, number>) {
+  const reactKeyWarnings: string[] = [];
+  const healthAndReadyTimings: number[] = [];
+  page.on("response", (response) => {
+    const startedAt = requestStartedAt.get(response.request());
+    if (startedAt === undefined) return;
+    if (["/api/v2/health", "/api/v2/ready"].includes(new URL(response.url()).pathname)) {
+      healthAndReadyTimings.push(performance.now() - startedAt);
+    }
+  });
+  page.on("console", (message) => {
+    if (message.type() === "warning" && /unique "key"|unique key/i.test(message.text())) {
+      reactKeyWarnings.push(message.text());
+    }
+  });
+  return { healthAndReadyTimings, reactKeyWarnings };
+}
+
+export function assertPerformanceWarnings(
+  observations: ReturnType<typeof observePerformanceWarnings>,
+) {
+  expect(observations.reactKeyWarnings).toEqual([]);
+  expect(observations.healthAndReadyTimings.length).toBeGreaterThan(0);
+  expect(
+    Math.max(...observations.healthAndReadyTimings),
+    "health and ready remain responsive under load",
+  ).toBeLessThan(10_000);
+}

package/templates/.agents/dashboard/tests/e2e/specs/performance-work-row-identity.ts

@@ -0,0 +1,6 @@
+import type { Locator } from "@playwright/test";
+
+/** Live telemetry can change metrics while a paginated row keeps the same identity. */
+export function workRowIdentities(rows: Locator): Promise<string[]> {
+  return rows.locator(".operations-work-list-identity small").allTextContents();
+}