@zaip-ai/cli 1.0.7 → 1.0.8

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

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

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

@@ -18,7 +18,7 @@ export default defineConfig({
   },
   projects: [{ name: "chromium", use: { ...devices["Desktop Chrome"] } }],
   webServer: {
-    command: "node .agents/dashboard/packages/local-runtime/dist/server.js",
+    command: "node .agents/dashboard/packages/local-runtime/dist/server.cjs",
     cwd: workspaceRoot,
     url: `${baseURL}/api/v2/health`,
     reuseExistingServer: false,

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

@@ -85,12 +85,19 @@ test("exports the active Cost Monitor, Operations table, and Kanban view through
     .getByRole("textbox", { name: "Busca" });
   await globalSearch.fill("EXEC-");
   await page.getByRole("button", { exact: true, name: "Execuções" }).click();
-  await expect(page.getByRole("columnheader", { name: /Execução/ })).toBeVisible();
+  const executionRows = page.locator(".ui-table-row-action");
+  if ((await executionRows.count()) === 0) {
+    await expect(page.locator(".ui-empty")).toBeVisible();
+  } else {
+    await expect(page.getByRole("columnheader", { name: /Execução/ })).toBeVisible();
+  }
   await expect(page.locator(".export-progress")).toContainText(/\d+%/);
-  await page.locator(".ui-table-row-action").first().click();
-  const executionDialog = page.getByRole("dialog", { name: "Detalhes de Execução ZAIP" });
-  await expect(executionDialog).toBeVisible();
-  await executionDialog.getByRole("button", { name: "Fechar" }).click();
+  if ((await executionRows.count()) > 0) {
+    await executionRows.first().click();
+    const executionDialog = page.getByRole("dialog", { name: "Detalhes de Execução ZAIP" });
+    await expect(executionDialog).toBeVisible();
+    await executionDialog.getByRole("button", { name: "Fechar" }).click();
+  }
   await page.evaluate(() => {
     (
       window as Window & {
@@ -229,7 +236,9 @@ test("renders the modern read-only dashboard and meets accessibility gates", asy
   const period = globalControls.getByRole("combobox", { name: "Período" });
   await expect(startDate).toHaveValue(/^\d{4}-\d{2}-\d{2}$/);
   await expect(endDate).toHaveValue(/^\d{4}-\d{2}-\d{2}$/);
-  await expect(period).toHaveValue("this-month");
+  await expect(period).toHaveValue("all");
+  await expect(startDate).toBeDisabled();
+  await expect(endDate).toBeDisabled();
   const initialStart = await startDate.inputValue();
   const today = await endDate.inputValue();
   await expect(page.getByLabel("Data inicial nos filtros")).toHaveValue(initialStart);
@@ -251,9 +260,9 @@ test("renders the modern read-only dashboard and meets accessibility gates", asy
   await expect(period).toHaveValue("custom");
   await period.selectOption("all");
   await expect(period).toHaveValue("all");
-  await expect(startDate).toHaveValue("");
+  await expect(startDate).toHaveValue(/^\d{4}-\d{2}-\d{2}$/);
   await expect(startDate).toBeDisabled();
-  await expect(endDate).toHaveValue("");
+  await expect(endDate).toHaveValue(/^\d{4}-\d{2}-\d{2}$/);
   await expect(endDate).toBeDisabled();
 
   await page.getByLabel("Risco").selectOption("critical");
@@ -261,17 +270,34 @@ test("renders the modern read-only dashboard and meets accessibility gates", asy
     page.locator(".operations-task-card .operations-risk:not(.is-critical)"),
   ).toHaveCount(0);
   await expect(page.locator(".operations-risk.is-critical").first()).toBeVisible();
+  const filteredTaskTotal = Number(
+    await page
+      .getByRole("button", { name: /Tarefas:/ })
+      .first()
+      .locator("strong")
+      .textContent(),
+  );
+  const filteredStatusCounts = (
+    await page.locator(".operations-panel-wide .operations-legend-value strong").allTextContents()
+  ).map(Number);
+  const filteredRiskCounts = (
+    await page.locator(".operations-panel-risk .operations-legend-value strong").allTextContents()
+  ).map(Number);
+  expect(filteredStatusCounts.reduce((sum, value) => sum + value, 0)).toBe(filteredTaskTotal);
+  expect(filteredRiskCounts.reduce((sum, value) => sum + value, 0)).toBe(filteredTaskTotal);
   await page.getByRole("button", { name: "Limpar filtros" }).click();
   await expect(page.getByRole("dialog", { name: "Atualizar dashboard" })).toHaveCount(0);
   await expect(startDate).toHaveValue(initialStart);
-  await expect(period).toHaveValue("this-month");
+  await expect(period).toHaveValue("all");
+  await expect(startDate).toBeDisabled();
+  await expect(endDate).toBeDisabled();
   await expect(page.getByLabel("Risco")).toHaveValue("");
 
   const results = await new AxeBuilder({ page }).analyze();
   expect(results.violations).toEqual([]);
 });
 
-test("loads one overview first and one full Operations projection only after selection", async ({
+test("loads a quick Operations summary and never hydrates full detail on selection", async ({
   page,
 }) => {
   const operationsRequests: string[] = [];
@@ -282,22 +308,60 @@ test("loads one overview first and one full Operations projection only after sel
   });
 
   await openDashboard(page);
-  expect(operationsRequests).toHaveLength(1);
-  expect(operationsRequests[0]).toContain("scope=overview");
+  expect(operationsRequests.some((url) => url.includes("scope=quick"))).toBe(true);
+  expect(operationsRequests.some((url) => url.includes("scope=detail"))).toBe(false);
+  expect(operationsRequests.some((url) => url.includes("/snapshot"))).toBe(false);
+
+  const requestsBeforeMacroSelection = operationsRequests.length;
+  await page.getByRole("button", { name: /^SPECs:/ }).click();
+  await expect(page.getByRole("heading", { name: "Status das SPECs" })).toBeVisible();
+  await expect(page.getByRole("heading", { name: "Top 5 SPECs" })).toBeVisible();
+  await expect(page.locator(".operations-run-bar")).toHaveCount(5);
+  expect(
+    (await page.locator(".operations-panel-wide .operations-legend-value strong").allTextContents())
+      .map(Number)
+      .reduce((sum, value) => sum + value, 0),
+  ).toBe(32);
+  expect(
+    (await page.locator(".operations-panel-risk .operations-legend-value strong").allTextContents())
+      .map(Number)
+      .reduce((sum, value) => sum + value, 0),
+  ).toBe(32);
+  await page.getByRole("button", { name: /^PRDs:/ }).click();
+  await expect(page.getByRole("heading", { name: "Status das PRDs" })).toBeVisible();
+  await expect(page.getByRole("heading", { name: "Top 5 PRDs" })).toBeVisible();
+  await expect(page.locator(".operations-run-bar")).toHaveCount(5);
+  expect(
+    (await page.locator(".operations-panel-wide .operations-legend-value strong").allTextContents())
+      .map(Number)
+      .reduce((sum, value) => sum + value, 0),
+  ).toBe(12);
+  expect(
+    (await page.locator(".operations-panel-risk .operations-legend-value strong").allTextContents())
+      .map(Number)
+      .reduce((sum, value) => sum + value, 0),
+  ).toBe(12);
+  expect(operationsRequests).toHaveLength(requestsBeforeMacroSelection);
 
   await selectOperations(page);
   await expect(page.getByLabel("Kanban de trabalho")).toBeVisible();
-  expect(operationsRequests).toHaveLength(2);
-  expect(operationsRequests[1]).not.toContain("scope=overview");
+  expect(operationsRequests.some((url) => url.includes("scope=detail"))).toBe(false);
+  expect(operationsRequests.some((url) => url.includes("/snapshot"))).toBe(false);
 
   await page
     .getByRole("navigation", { name: "Áreas do dashboard" })
     .getByRole("button", { name: /Operação/ })
     .click();
-  expect(operationsRequests).toHaveLength(2);
+  expect(operationsRequests.some((url) => url.includes("scope=detail"))).toBe(false);
 });
 
 test("integrates the detailed cost monitor into the main dashboard", async ({ page }) => {
+  const costRequests: string[] = [];
+  const pageErrors: string[] = [];
+  page.on("request", (request) => {
+    if (request.url().includes("/api/v2/")) costRequests.push(request.url());
+  });
+  page.on("pageerror", (error) => pageErrors.push(error.message));
   await openDashboard(page);
   const capabilityNav = page.getByRole("navigation", { name: "Áreas do dashboard" });
   const globalControls = page.locator(".dashboard-global-controls");
@@ -333,9 +397,9 @@ test("integrates the detailed cost monitor into the main dashboard", async ({ pa
   const modelHeader = page.getByRole("columnheader", { name: /Modelo/ });
   if ((await modelHeader.count()) > 0) {
     await expect(modelHeader).toBeVisible();
-    await expect(page.getByRole("columnheader", { name: /Invocações de Agentes/ })).toBeVisible();
-    await expect(page.getByRole("columnheader", { name: /Total de tokens/ })).toBeVisible();
-    await expect(page.getByRole("columnheader", { name: /Custo Final atual/ })).toBeVisible();
+    await expect(page.getByRole("columnheader", { name: /^Invocações / })).toBeVisible();
+    await expect(page.getByRole("columnheader", { name: /^Tokens / })).toBeVisible();
+    await expect(page.getByRole("columnheader", { name: /^Custo / })).toBeVisible();
   } else {
     await expect(page.locator(".cost-content-models .ui-empty")).toBeVisible();
   }
@@ -346,10 +410,41 @@ test("integrates the detailed cost monitor into the main dashboard", async ({ pa
   await expect(page.getByRole("button", { name: "Zaip Agentes" })).toBeVisible();
   await expect(page.getByRole("button", { exact: true, name: "Conversas" })).toBeVisible();
 
+  for (const [tab, kind] of [
+    ["Execuções", "executions"],
+    ["Conversas", "conversations"],
+    ["Tarefas", "tasks"],
+    ["SPEC", "specs"],
+    ["PRD", "prds"],
+  ] as const) {
+    const response = page.waitForResponse(
+      (candidate) =>
+        candidate.url().includes("/api/v2/sqlite-views?") &&
+        candidate.url().includes(`view=cost_monitor_${kind}`),
+    );
+    await page.locator(".cost-tabs").getByRole("button", { exact: true, name: tab }).click();
+    expect((await response).status()).toBe(200);
+    await expect(
+      page
+        .getByRole("columnheader", { name: /Tempo observado/ })
+        .or(page.locator(".ui-empty")),
+    ).toBeVisible();
+    await expect(
+      page.getByRole("navigation", { name: "Paginação dos dados agregados" }),
+    ).toBeVisible();
+    expect(pageErrors).toEqual([]);
+    await expect(page.locator(".cost-tabs")).toBeVisible();
+  }
+  expect(costRequests.some((url) => url.includes("scope=detail"))).toBe(false);
+
   await capabilityNav.getByRole("button", { name: /Operação/ }).click();
   await page.getByRole("button", { exact: true, name: "Invocações de agentes" }).click();
   await page.getByRole("button", { exact: true, name: "Execuções" }).click();
-  await expect(page.getByRole("columnheader", { name: /Execução/ })).toBeVisible();
+  await expect(
+    page
+      .getByRole("columnheader", { name: /Execução/ })
+      .or(page.getByRole("status").filter({ hasText: /Aguardando linhas canônicas de execuções/ })),
+  ).toBeVisible();
   await page.getByRole("button", { exact: true, name: "Invocações de agentes" }).click();
 
   await page.getByRole("button", { name: "PT-BR" }).click();
@@ -362,11 +457,27 @@ test("integrates the detailed cost monitor into the main dashboard", async ({ pa
   await expect(runRow).toBeVisible();
   const initialRunCount = await runRows.count();
   const englishStartDate = globalControls.getByLabel("Start date");
+  const narrowedResponse = page.waitForResponse(
+    (candidate) =>
+      candidate.status() === 200 &&
+      candidate.url().includes("/api/v2/sqlite-views?") &&
+      candidate.url().includes("view=operations_agent_invocations"),
+  );
   await englishStartDate.fill(initialEnd);
+  await narrowedResponse;
   await expect(englishStartDate).toHaveValue(initialEnd);
   expect(await runRows.count()).toBeLessThanOrEqual(initialRunCount);
+  const restoredResponse = page.waitForResponse(
+    (candidate) =>
+      candidate.status() === 200 &&
+      candidate.url().includes("/api/v2/sqlite-views?") &&
+      candidate.url().includes("view=operations_agent_invocations"),
+  );
   await englishStartDate.fill(initialStart);
-  await page.locator(".ui-table-row-action").first().click();
+  const restoredPage = await restoredResponse;
+  expect(((await restoredPage.json()) as { rows: unknown[] }).rows.length).toBeGreaterThan(0);
+  await expect(runRows.first()).toBeVisible();
+  await runRows.first().click();
   const runDetails = page.getByRole("dialog", { name: "Details for Agent Invocation" });
   await expect(runDetails).toBeVisible();
   await runDetails.getByRole("button", { name: "Close" }).click();
@@ -406,9 +517,10 @@ test("embeds traceability and keeps global settings and help available", async (
 
   await page.getByRole("button", { name: "Configurações" }).click();
   await page.getByLabel("Moeda").selectOption("USD");
-  await page.getByRole("button", { name: "Abrir ajuda e guides" }).click();
+  await page.getByRole("button", { name: "Central de Ajuda" }).click();
   await expect(page.getByRole("dialog", { name: "Ajuda do ZAIP-AIOS" })).toBeVisible();
   await expect(page.getByRole("button", { name: "README · ZAIP-AIOS" })).toBeVisible();
+  await expect(page.getByRole("button", { name: "Como o custo é calculado" })).toBeVisible();
   await expect(page.getByText("Aprofundar no framework")).toBeVisible();
   const helpDialog = page.getByRole("dialog", { name: "Ajuda do ZAIP-AIOS" });
   await expect(
@@ -426,6 +538,7 @@ test("groups macro work in All and reveals descendant Tasks only in Tasks", asyn
   await openDashboard(page);
   await selectOperations(page);
   const board = page.getByLabel("Kanban de trabalho");
+  await expect(board.locator(".operations-task-card").first()).toBeVisible();
   const allItemCount = await boardItemCount(board);
 
   await page.getByRole("button", { exact: true, name: "Tarefas" }).click();
@@ -437,23 +550,75 @@ test("groups macro work in All and reveals descendant Tasks only in Tasks", asyn
     .locator(".operations-work-card")
     .filter({ has: page.locator(".operations-work-kind.is-spec") })
     .first();
-  await expect(spec).toBeVisible();
-  await expect(spec.locator(".operations-work-card-counts")).toHaveText(/Tasks \d+\/\d+/);
-  await spec.click();
-  await expect(page.getByRole("dialog", { name: "Detalhes do SPEC" })).toBeVisible();
-  await page.getByRole("button", { name: "Fechar" }).click();
+  if ((await spec.count()) === 0) {
+    await expect(page.getByLabel("Kanban de trabalho").locator(".operations-task-card")).toHaveCount(0);
+  } else {
+    await expect(spec).toBeVisible();
+    await expect(spec.locator(".operations-work-card-counts")).toHaveText(/Tasks \d+\/\d+/);
+    await spec.locator(".operations-work-card-open").click();
+    await expect(page.getByRole("dialog", { name: "Detalhes do SPEC" })).toBeVisible();
+    await page.getByRole("button", { name: "Fechar" }).click();
+  }
 
   await page.getByRole("button", { exact: true, name: "PRDs" }).click();
   const prd = page
     .locator(".operations-work-card")
     .filter({ has: page.locator(".operations-work-kind.is-prd") })
     .first();
-  await expect(prd).toBeVisible();
-  await expect(prd.locator(".operations-work-card-counts")).toHaveText(
-    /SPECs \d+\/\d+ · Tasks \d+\/\d+/,
-  );
-  await prd.click();
-  await expect(page.getByRole("dialog", { name: "Detalhes do PRD" })).toBeVisible();
+  if ((await prd.count()) === 0) {
+    await expect(page.getByLabel("Kanban de trabalho").locator(".operations-task-card")).toHaveCount(0);
+  } else {
+    await expect(prd).toBeVisible();
+    await expect(prd.locator(".operations-work-card-counts")).toHaveText(
+      /SPECs \d+\/\d+ · Tasks \d+\/\d+/,
+    );
+    await prd.locator(".operations-work-card-open").click();
+    await expect(page.getByRole("dialog", { name: "Detalhes do PRD" })).toBeVisible();
+  }
+});
+
+test("loads monthly overview quickly and keeps PRD and SPEC chart totals reconciled", async ({
+  page,
+}) => {
+  const openedAt = Date.now();
+  await openDashboard(page);
+  expect(Date.now() - openedAt).toBeLessThan(3_000);
+
+  const period = page.getByRole("combobox", { name: /Per/ }).first();
+  for (const preset of ["last-month", "this-month"] as const) {
+    const response = page.waitForResponse(
+      (candidate) =>
+        candidate.status() === 200 &&
+        candidate.url().includes("/api/v2/operations") &&
+        candidate.url().includes("scope=quick"),
+    );
+    const selectedAt = Date.now();
+    await period.selectOption(preset);
+    await response;
+    expect(Date.now() - selectedAt).toBeLessThan(3_000);
+
+    for (const kind of ["SPECs", "PRDs"] as const) {
+      const selector = page.locator(".operations-kpi.is-selectable").filter({ hasText: kind });
+      const cardCount = Number(await selector.locator("strong").textContent());
+      await selector.click();
+
+      const panels = page.locator(".operations-chart-grid > .operations-panel");
+      const donutCount = Number(
+        await panels.nth(1).locator(".operations-donut-wrap strong").textContent(),
+      );
+      const statusCounts = await panels
+        .nth(0)
+        .locator(".operations-legend-value strong")
+        .allTextContents();
+      const classificationCounts = await panels
+        .nth(1)
+        .locator(".operations-legend-value strong")
+        .allTextContents();
+      expect(donutCount).toBe(cardCount);
+      expect(statusCounts.reduce((sum, value) => sum + Number(value), 0)).toBe(cardCount);
+      expect(classificationCounts.reduce((sum, value) => sum + Number(value), 0)).toBe(cardCount);
+    }
+  }
 });
 
 async function boardItemCount(board: Locator): Promise<number> {
@@ -475,7 +640,12 @@ test("opens entity-specific details for changes decisions executions and runs",
 
   for (const [tab, dialogName, detailLabel] of cases) {
     await page.getByRole("button", { exact: true, name: tab }).click();
-    await page.locator(".ui-table-row-action").first().click();
+    const rows = page.locator(".ui-table-row-action");
+    if ((await rows.count()) === 0) {
+      await expect(page.locator(".ui-empty")).toBeVisible();
+      continue;
+    }
+    await rows.first().click();
     const dialog = page.getByRole("dialog", { name: dialogName });
     await expect(dialog).toBeVisible();
     await expect(dialog.getByText(detailLabel, { exact: true })).toBeVisible();
@@ -484,6 +654,16 @@ test("opens entity-specific details for changes decisions executions and runs",
   }
 });
 
+test("keeps aggregate KPIs visible without an obsolete coverage overlay", async ({ page }) => {
+  await openDashboard(page);
+
+  await expect(page.getByText(/Agregados do manifesto/)).toHaveCount(0);
+  await expect(page.locator(".operations-coverage-toast")).toHaveCount(0);
+  await expect(page.getByRole("article", { name: /Tempo total de execu/ })).toBeVisible();
+  await expect(page.getByRole("article", { name: /Tokens gastos/ })).toBeVisible();
+  await expect(page.getByRole("article", { name: /Custo Estimado/ })).toBeVisible();
+});
+
 async function globalThisScrollPosition(page: import("@playwright/test").Page) {
   return page.evaluate("window.scrollY");
 }
@@ -493,24 +673,17 @@ async function openDashboard(page: import("@playwright/test").Page) {
     (response) =>
       response.status() === 200 &&
       response.url().includes("/api/v2/operations") &&
-      response.url().includes("scope=overview"),
+      response.url().includes("scope=quick"),
   );
   await page.goto("/?token=e2e-token");
   await operations;
 }
 
 async function selectOperations(page: import("@playwright/test").Page) {
-  const operations = page.waitForResponse(
-    (response) =>
-      response.status() === 200 &&
-      response.url().includes("/api/v2/operations") &&
-      !response.url().includes("scope=overview"),
-  );
   await page
     .getByRole("navigation", { name: "Áreas do dashboard" })
     .getByRole("button", { name: /Operação/ })
     .click();
-  await operations;
 }
 
 test("protects dashboard reads and rejects mutating methods", async ({ request }) => {

package/templates/.agents/dashboard/work-priority.json

@@ -0,0 +1,34 @@
+{
+  "schema_version": 1,
+  "item_ids": [
+    "TASK-2026-07-17-09-15-AUDITORIA-ESTRUTURAL-ZAIP-AIOS-JL7U",
+    "TASK-2026-07-17-22-37-INTAKE-OUTCOMES-V3-GA4Q",
+    "TASK-2026-07-18-11-54-LIBERAR-ACESSO-TOTAL-CODEX-KKP3",
+    "TASK-2026-07-18-12-26-FORMATAR-CUSTOS-CARD-XGRU",
+    "TASK-2026-07-18-12-42-REMOVE-OBSOLETE-TASKS-9RBB",
+    "TASK-2026-07-18-13-11-ALIGN-CODEX-FULL-ACCESS-A7C5",
+    "TASK-2026-07-22-00-26-GLOBAL-CODEX-CONFIG-W7R9",
+    "TASK-2026-08-09-11-12-DASHBOARD-FRESH-PORT-HANDOFF-GCAA",
+    "TASK-2026-08-09-18-59-REQUALIFICAR-CANDIDATO-ESCOPADO-T8WS",
+    "TASK-2026-08-09-20-01-FECHAR-LINT-SHA-LIMPO-RFWB",
+    "TASK-2026-08-10-09-42-SINCRONIZAR-EVIDENCIA-HAQ3-2WBT",
+    "TASK-2026-08-12-01-15-API-SQLITE-PAGINACAO-6D8V",
+    "TASK-2026-08-12-01-15-ASSURANCE-SQLITE-BROWSER-5K9T",
+    "TASK-2026-08-12-01-15-CONTRATO-INVENTARIO-SQLITE-METRICAS-9A2R",
+    "TASK-2026-08-12-01-15-EXPORTACAO-SQLITE-PARIDADE-7H3S",
+    "TASK-2026-08-12-01-15-PROJECAO-SQLITE-SEMANTICA-4C7P",
+    "PRD-2026-08-12-01-25-AUDITORIA-INTEGRAL-DASHBOARD-SQLITE-Q7MK",
+    "SPEC-2026-08-12-01-15-AUDITORIA-DASHBOARD-SQLITE-METRICAS-N5QK",
+    "TASK-2026-08-12-19-43-ADICIONAR-HERMES-README-5V8V",
+    "TASK-2026-08-12-22-14-COST-LIFECYCLE-SUBTOTAL-PARITY-LJTE",
+    "TASK-2026-08-12-23-43-RECONCILE-OPEN-ITEMS-CURRENT-TELEMETRY-XUH8",
+    "TASK-2026-08-12-23-54-RECALIBRAR-OPENCLAW-ECONOMIA-ZRXN",
+    "TASK-2026-08-13-00-02-COST-MONITOR-OVERVIEW-RECONCILIATION-T9RX",
+    "TASK-2026-08-13-00-15-CORRIGIR-PRIORIDADE-KANBAN-SQLITE-9D72",
+    "TASK-2026-08-13-00-17-RECALIBRAR-ZAIP-NOTA-95-GWHV",
+    "TASK-2026-08-13-00-28-RECALIBRAR-TRAYCER-HERMES-KDZB",
+    "TASK-2026-08-13-00-30-COST-DAILY-DURATION-PARITY-JMBS",
+    "TASK-2026-08-13-00-33-PADRONIZAR-METRICAS-LISTA-OPERACIONAL-YSS8"
+  ],
+  "updated_at": "2026-08-13T12:46:29.552Z"
+}

package/templates/.agents/dashboard/zaip-dashboard-linux.sh

@@ -0,0 +1,45 @@
+#!/usr/bin/env sh
+# Linux launcher for the local, loopback-only ZAIP SQLite dashboard.
+set -eu
+
+launcher_dir=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+workspace_root=$(CDPATH= cd -- "$launcher_dir/../.." && pwd)
+runtime="$workspace_root/.agents/dashboard/packages/local-runtime/start-dashboard.mjs"
+
+if [ ! -f "$runtime" ]; then
+  printf '%s\n' "Erro: o runtime do ZAIP Dashboard não foi encontrado. Reinstale ou reconstrua o ZAIP-AIOS." >&2
+  exit 1
+fi
+
+node_bin=${ZAIP_NODE:-}
+if [ -n "$node_bin" ]; then
+  if [ ! -x "$node_bin" ]; then
+    printf '%s\n' "Erro: ZAIP_NODE não aponta para um executável Node.js: $node_bin" >&2
+    exit 1
+  fi
+elif node_bin=$(command -v node 2>/dev/null); then
+  :
+else
+  printf '%s\n' "Erro: Node.js 22 ou superior não foi encontrado no PATH. Instale-o e tente novamente." >&2
+  exit 1
+fi
+
+node_major=$("$node_bin" -p "process.versions.node.split('.')[0]" 2>/dev/null || true)
+case "$node_major" in
+  ''|*[!0-9]*)
+    printf '%s\n' "Erro: não foi possível determinar a versão do Node.js em $node_bin." >&2
+    exit 1
+    ;;
+esac
+if [ "$node_major" -lt 22 ]; then
+  printf '%s\n' "Erro: o Dashboard SQLite requer Node.js 22 ou superior; encontrado Node.js $node_major." >&2
+  exit 1
+fi
+
+if ! "$node_bin" -e "const { builtinModules } = require('node:module'); process.exit(builtinModules.includes('node:sqlite') ? 0 : 1)" >/dev/null 2>&1; then
+  printf '%s\n' "Erro: este Node.js não disponibiliza node:sqlite. Reinstale o Node.js 22 ou superior." >&2
+  exit 1
+fi
+
+cd "$workspace_root"
+exec "$node_bin" "$runtime" "$@"

package/templates/.agents/dashboard/zaip-dashboard-mac.command

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+# macOS Finder-compatible launcher. Keep the Linux contract in the sibling .sh.
+exec "$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)/zaip-dashboard-linux.sh" "$@"

package/templates/.agents/design/.zaip-managed.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "1.0.0",
+  "version": "1.0.8",
   "files": [
     {
       "path": "apps/catalog/.storybook/main.ts",
@@ -220,7 +220,7 @@
     },
     {
       "path": "apps/catalog/package.json",
-      "sha256": "6ed07adcaa1075aba5a41ca157b5f5aad70bae02b3f01914c4efe85181969013"
+      "sha256": "cad5056abeda7f5134e9f5ef61bba5238439b9ec670b25f4cd245157e5b8ffdb"
     },
     {
       "path": "apps/catalog/public/logo_novo_azul.png",
@@ -304,7 +304,7 @@
     },
     {
       "path": "packages/local-runtime/package.json",
-      "sha256": "f00e4ab953a4c1fd2b91b6f510799d5407aa2fe5e61204b9cc80ccef564effef"
+      "sha256": "62dc180ef9f26346fd1cca07f435719de48342575a9463014d4e854e1024a69f"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",

package/templates/.agents/design/apps/catalog/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-catalog",
-  "version": "1.0.0",
+  "version": "1.0.8",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/design/packages/local-runtime/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-local-runtime",
-  "version": "1.0.0",
+  "version": "1.0.8",
   "private": true,
   "type": "module",
   "scripts": {

package/templates/.agents/requirements/autonomous-assurance.md

@@ -6,7 +6,7 @@ title: Garantia adaptativa e execução autônoma
 status: active
 version: 2
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Garantia adaptativa e execução autônoma

package/templates/.agents/requirements/comparative-audit.md

@@ -6,7 +6,7 @@ title: Auditoria comparativa e plano de evolução
 status: active
 version: 1
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Auditoria comparativa e plano de evolução

package/templates/.agents/requirements/context-engine.md

@@ -6,7 +6,7 @@ title: Contexto mínimo, seguro e navegável
 status: active
 version: 8
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Context engine

package/templates/.agents/requirements/cost-observability.md

@@ -6,7 +6,7 @@ title: Tokens, custos e cobertura
 status: active
 version: 10
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Cost observability

package/templates/.agents/requirements/dashboard-launch.md

@@ -0,0 +1,24 @@
+---
+schema_version: 2
+id: REQUIREMENTS-ZAIP-DASHBOARD-LAUNCH
+area: dashboard-launch
+title: Inicialização e hidratação confiável do dashboard
+status: active
+version: 1
+source_change: null
+source_release: "1.0.8"
+---
+
+# Inicialização e hidratação confiável do dashboard
+
+## REQ-ZAIP-DASHBOARD-LAUNCH-001 — Sessão local previsível
+
+O dashboard local deve abrir uma única sessão saudável, preservar processos que não pertencem ao launcher e distinguir carregamento, ausência de dados e falha.
+
+- `AC-ZAIP-DASHBOARD-LAUNCH-001`: a cada lançamento sequencial, o executável abre imediatamente uma aba de preparação em nova porta e inicia uma nova instância; somente após o handoff saudável dessa aba a instância anterior inequivocamente pertencente ao mesmo workspace pode ser encerrada. Invocações concorrentes do mesmo lançamento podem coalescer para a nova sessão saudável, redirecionando a própria aba de preparação sem deixá-la morta. Processos de outro proprietário nunca são encerrados.
+- `AC-ZAIP-DASHBOARD-LAUNCH-002`: o launcher só reporta sucesso depois de observar a resposta saudável da instância escolhida e fornece erro acionável quando a inicialização ou o handoff para o navegador falha.
+- `AC-ZAIP-DASHBOARD-LAUNCH-003`: a interface representa hidratação parcial com estado explícito de carregamento e retry, sem apresentar agregados ainda indisponíveis como zeros válidos.
+
+## Verificação
+
+Validar com testes do launcher, runtime local e projeções quick/detail, além de typecheck, teste do dashboard e paridade entre fonte, runtime instalado e distribuição.

package/templates/.agents/requirements/data-export.md

@@ -6,7 +6,7 @@ title: Exportação contextual de dados para Excel
 status: proposed
 version: 2
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Exportação contextual de dados

package/templates/.agents/requirements/design-system.md

@@ -6,7 +6,7 @@ title: Contrato visual e catálogo executável
 status: active
 version: 3
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Design system

package/templates/.agents/requirements/execution-engine.md

@@ -6,7 +6,7 @@ title: Preparação, materialização e DAG
 status: active
 version: 10
 source_change: null
-source_release: "1.0.7"
+source_release: "1.0.8"
 ---
 
 # Execution engine