@zaip-ai/cli 4.8.0 → 5.0.0

package/templates/.agents/dashboard/packages/local-runtime/src/server.ts

@@ -3,10 +3,10 @@ import { basename, resolve } from "node:path";
 import { serve } from "@hono/node-server";
 import { serveStatic } from "@hono/node-server/serve-static";
 import { WorkspaceFileSystem, type WorkspaceLayout } from "@zaip-ai/core";
-import { fxRateSchema, PricingRepository, pricingCatalogSchema } from "@zaip-ai/costs";
 import { type Context, Hono } from "hono";
 import { getCookie, setCookie } from "hono/cookie";
 import { createDashboardDiagnostics } from "../dashboard-diagnostics.mjs";
+import { activeCaptureFailure as describeActiveCaptureFailure } from "./active-capture-failure.js";
 import {
   type ActiveCodexTelemetryCapture,
   captureRepositoryActiveCodexTelemetry,
@@ -37,6 +37,7 @@ import {
   registerReconciliationRoute,
 } from "./server-reconciliation-route.js";
 import { isAllowedDashboardAuthority } from "./server-request-authority.js";
+import { registerPricingRoutes } from "./server-route-handlers.js";
 import { refreshSqliteSnapshotInWorker } from "./server-snapshot-refresh.js";
 import { readCommittedSnapshotRevision } from "./server-snapshot-revision.js";
 import { startSnapshotSynchronization } from "./server-snapshot-synchronization.js";
@@ -188,13 +189,17 @@ export function createDashboardApp(
   };
   let observedSnapshotRevision: string | null = null;
   const projectionRefreshDiagnostics = createProjectionRefreshDiagnostics();
-  let activeCaptureFailure: { code: string; occurred_at: string; cause: string } | null = null;
+  let activeCaptureFailure: ReturnType<typeof describeActiveCaptureFailure> | null = null;
   let activeCapture: ActiveCodexTelemetryCapture | null = null;
+  let activeCapturePending = false;
   let projectionRefreshInFlight: Promise<void> | null = null;
   let projectionRefreshRequested = false;
   const associatedRefreshJobs = new Set<string>();
-  const rebuildProjection = async (associatedJobId: string | null = null) => {
+  const rebuildProjection = async (associatedJobId: string | null = null): Promise<void> => {
     if (associatedJobId !== null) associatedRefreshJobs.add(associatedJobId);
+    // Capture writes canonical records. Watcher events from those writes must
+    // join the ordered pass, not launch a competing SQLite rebuild.
+    if (telemetryRefresh.capturing) return telemetryRefresh.refresh();
     if (projectionRefreshInFlight !== null) {
       projectionRefreshRequested = true;
       return projectionRefreshInFlight;
@@ -258,29 +263,40 @@ export function createDashboardApp(
       });
     return projectionRefreshInFlight;
   };
+  const captureTelemetry =
+    options.captureTelemetry ??
+    (isSqliteSnapshot &&
+    options.watchSources === true &&
+    process.env.ZAIP_DASHBOARD_WATCH_SOURCES !== "0"
+      ? () => captureRepositoryActiveCodexTelemetry(workspaceRoot)
+      : undefined);
   const telemetryRefresh = createTelemetryProjectionRefresh({
     refresh: rebuildProjection,
-    ...(options.captureTelemetry !== undefined
-      ? { capture: options.captureTelemetry }
-      : isSqliteSnapshot &&
-          options.watchSources === true &&
-          process.env.ZAIP_DASHBOARD_WATCH_SOURCES !== "0"
-        ? { capture: () => captureRepositoryActiveCodexTelemetry(workspaceRoot) }
-        : {}),
+    ...(captureTelemetry === undefined
+      ? {}
+      : {
+          capture: async () => {
+            // A source-only projection can precede the periodic capture. Drain it
+            // while the capture reservation prevents new watcher projections.
+            if (projectionRefreshInFlight !== null)
+              await projectionRefreshInFlight.catch(() => undefined);
+            return captureTelemetry();
+          },
+        }),
     onCaptureSuccess: (result) => {
       activeCapture = result;
       activeCaptureFailure = null;
+      activeCapturePending = result.catch_up_complete === false;
     },
     onCaptureFailure: (error) => {
-      activeCaptureFailure = {
-        code: "active_telemetry_capture_failed",
-        occurred_at: new Date().toISOString(),
-        cause: error instanceof Error ? error.name : "unknown_error",
-      };
+      activeCaptureFailure = describeActiveCaptureFailure(error);
+      diagnostics.log("active_telemetry_capture_failed", activeCaptureFailure);
     },
   });
   const visibleSnapshotState = () =>
-    telemetryRefresh.pending || activeCaptureFailure !== null ? "updating" : snapshotState;
+    telemetryRefresh.pending || activeCaptureFailure !== null || activeCapturePending
+      ? "updating"
+      : snapshotState;
   startSnapshotSynchronization({
     workspaceRoot,
     discoverSourceRoots: () => dashboardCanonicalSourceRoots(workspaceRoot),
@@ -440,7 +456,7 @@ export function createDashboardApp(
         server_pid: process.pid,
         service: "zaip-aios-dashboard",
         status:
-          manifestState === "initialized" && activeCaptureFailure === null
+          manifestState === "initialized" && activeCaptureFailure === null && !activeCapturePending
             ? projectionRefreshDiagnostics.healthStatus
             : "degraded",
         api_version: 2,
@@ -481,7 +497,9 @@ export function createDashboardApp(
         lifecycleManifestState(canonicalFilesystem),
       ]);
       const readinessStatus =
-        manifestState === "initialized" && activeCaptureFailure === null ? "ready" : "degraded";
+        manifestState === "initialized" && activeCaptureFailure === null && !activeCapturePending
+          ? "ready"
+          : "degraded";
       if (isSqliteSnapshot) {
         const revision = readCommittedSnapshotRevision(workspaceRoot);
         if (observedSnapshotRevision !== null && observedSnapshotRevision !== revision) {
@@ -606,36 +624,7 @@ export function createDashboardApp(
     readAggregate,
     clearSnapshotCache,
   });
-  app.on(["GET", "HEAD"], `${API_PREFIX}/pricing`, async (context) =>
-    headOrJson(
-      context,
-      pricingCatalogSchema.parse(
-        JSON.parse(await filesystem.readText(".agents/config/pricing/models.json")),
-      ),
-    ),
-  );
-  app.put(`${API_PREFIX}/pricing`, async (context) => {
-    const catalog = pricingCatalogSchema.parse({
-      ...(await context.req.json()),
-      updated_at: new Date().toISOString(),
-    });
-    await filesystem.writeTextAtomic(
-      ".agents/config/pricing/models.json",
-      `${JSON.stringify(catalog, null, 2)}\n`,
-    );
-    clearSnapshotCache();
-    return context.json(catalog);
-  });
-  app.on(["GET", "HEAD"], `${API_PREFIX}/fx-rate`, async (context) => {
-    const rate = await new PricingRepository(filesystem).readLatestFxRate();
-    return headOrJson(context, rate);
-  });
-  app.put(`${API_PREFIX}/fx-rate`, async (context) => {
-    const input = fxRateSchema.pick({ rate: true }).parse(await context.req.json());
-    const rate = await new PricingRepository(filesystem).writeCurrentFxRate(input.rate);
-    clearSnapshotCache();
-    return context.json(rate);
-  });
+  registerPricingRoutes(app, filesystem, clearSnapshotCache);
   registerAgentCatalogRoutes(app, {
     filesystem,
     workspaceRoot,

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-filter-matrix.test.ts

@@ -60,6 +60,11 @@ it.each([
     );
     await rebuildSqliteReadModel(root);
     fs = new SqliteReadModelFileSystem(root);
+    if (status === "completed") {
+      const fast = fs.viewPage("cost_monitor_agent_invocations", { query: "ainv-low", limit: 1 });
+      const sql = fs.viewPage("cost_monitor_agent_invocations", { query: "%AINV-LOW%", limit: 1 });
+      expect(fast).toEqual(sql);
+    }
     const summary = fs.costMonitorSummaryAggregate({ from: null, to: null });
     // Summary first paint remains aggregate-only, but its controls retain
     // factual filter choices from the same SQLite population.

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-invocation-page.test.ts

@@ -1,7 +1,56 @@
 import { describe, expect, it } from "vitest";
 import { filterCostInvocationProjection } from "./sqlite-cost-invocation-page.js";
+import { readCachedCostViewPage } from "./sqlite-query-cached-cost-page.js";
+import type { SqliteQueryContext } from "./sqlite-query-context.js";
 
 describe("cost invocation projection page", () => {
+  it("searches the immutable projection before pagination, preserving nulls and empty results", () => {
+    const context = {
+      technicalPayloadRows: () => [
+        {
+          agent_invocation_id: "AINV-OTHER",
+          task_id: null,
+          occurred_at: "2026-08-01T12:00:00Z",
+          total_tokens: 20,
+        },
+        {
+          agent_invocation_id: "AINV-TARGET-1",
+          task_id: null,
+          occurred_at: "2026-08-01T11:00:00Z",
+          total_tokens: 12,
+        },
+        {
+          agent_invocation_id: "AINV-TARGET-2",
+          task_id: null,
+          occurred_at: "2026-08-01T10:00:00Z",
+          total_tokens: null,
+        },
+      ],
+    } as unknown as SqliteQueryContext;
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", {
+        query: "target",
+        offset: 1,
+        limit: 1,
+      }),
+    ).toMatchObject({
+      total_count: 2,
+      has_more: false,
+      rows: [{ agent_invocation_id: "AINV-TARGET-2", total_tokens: null }],
+    });
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", { query: "absent" }),
+    ).toMatchObject({ total_count: 0, rows: [] });
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", { query: "TARGET%" }),
+    ).toBeNull();
+    expect(
+      readCachedCostViewPage(context, "cost_monitor_agent_invocations", {
+        query: "target",
+        provider: "openai",
+      }),
+    ).toBeNull();
+  });
   it("uses the Sao Paulo source day for the fast date-only page", () => {
     const rows = [
       { agent_invocation_id: "before", source_started_at: "2026-08-01T02:30:00.000Z" },

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-cost-invocation-page.ts

@@ -1,4 +1,6 @@
-type CostInvocationDateFilter = { from?: string | null; to?: string | null };
+import type { DatabaseSync } from "node:sqlite";
+
+type CostInvocationDateFilter = { from?: string | null; to?: string | null; query?: string };
 
 function costDay(value: string | null | undefined): string | null {
   if (!value) return null;
@@ -21,9 +23,50 @@ export function filterCostInvocationProjection(
 ) {
   const from = costDay(input.from);
   const to = costDay(input.to);
+  // SQLite LIKE folds ASCII only. Wildcard queries remain on the SQL reader.
+  const fold = (value: string) => value.replace(/[A-Z]/g, (letter) => letter.toLowerCase());
+  const query = input.query ? fold(input.query) : null;
   return rows.filter((row) => {
+    if (
+      query !== null &&
+      ![row.agent_invocation_id, row.task_id, row.execution_id].some(
+        (value) => typeof value === "string" && fold(value).includes(query),
+      )
+    )
+      return false;
     const timestamp = row.source_started_at ?? row.source_occurred_at ?? row.occurred_at;
     const day = typeof timestamp === "string" ? costDay(timestamp) : null;
     return day !== null && (from === null || day >= from) && (to === null || day <= to);
   });
 }
+
+/** Enrich only the selected page, matching the original SQL left join. */
+export function enrichCostInvocationPage(
+  database: DatabaseSync,
+  rows: Array<Record<string, unknown>>,
+) {
+  const ids = [
+    ...new Set(rows.flatMap((row) => (typeof row.task_id === "string" ? [row.task_id] : []))),
+  ];
+  const tasks =
+    ids.length === 0
+      ? []
+      : (database
+          .prepare(
+            "SELECT id, priority, risk, status AS task_status, title AS task_title FROM tasks WHERE id IN (" +
+              ids.map(() => "?").join(",") +
+              ")",
+          )
+          .all(...ids) as Array<Record<string, unknown>>);
+  const byId = new Map(tasks.map((task) => [task.id, task]));
+  return rows.map((row) => {
+    const task = byId.get(row.task_id);
+    return {
+      ...row,
+      priority: task?.priority ?? null,
+      risk: task?.risk ?? null,
+      task_status: task?.task_status ?? null,
+      task_title: task?.task_title ?? null,
+    };
+  });
+}

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-cached-cost-page.ts

@@ -1,4 +1,7 @@
-import { filterCostInvocationProjection } from "./sqlite-cost-invocation-page.js";
+import {
+  enrichCostInvocationPage,
+  filterCostInvocationProjection,
+} from "./sqlite-cost-invocation-page.js";
 import type { SqliteQueryContext, SqliteViewPage } from "./sqlite-query-context.js";
 import type { SqliteViewName } from "./sqlite-read-model-types.js";
 
@@ -38,9 +41,9 @@ export function readCachedCostViewPage(
     !input.origin &&
     !input.workType &&
     !input.priority;
-  const isDateOnlyCostInvocationPage =
+  const isCompactCostInvocationPage =
     view === "cost_monitor_agent_invocations" &&
-    !input.query &&
+    !/[\0%_]/.test(input.query ?? "") &&
     !input.status &&
     !input.risk &&
     !input.provider &&
@@ -50,12 +53,10 @@ export function readCachedCostViewPage(
     !input.origin &&
     !input.workType &&
     !input.priority;
-  if (isDateOnlyCostInvocationPage) {
-    const projection = filterCostInvocationProjection(
-      context.technicalPayloadRows("cost_agent_invocation_projection_v1"),
-      input,
-    );
-    if (projection.length > 0) {
+  if (isCompactCostInvocationPage) {
+    const cachedRows = context.technicalPayloadRows("cost_agent_invocation_projection_v1");
+    const projection = filterCostInvocationProjection(cachedRows, input);
+    if (cachedRows.length > 0) {
       const limit = Math.min(200, Math.max(1, input.limit ?? 100));
       const offset = Math.max(0, input.offset ?? 0);
       const rows = projection.slice(offset, offset + limit);
@@ -66,7 +67,7 @@ export function readCachedCostViewPage(
         limit,
         total_count: projection.length,
         has_more: offset + rows.length < projection.length,
-        rows,
+        rows: input.query ? enrichCostInvocationPage(context.database, rows) : rows,
       };
     }
   }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-query-summary.ts

@@ -110,7 +110,7 @@ export function queryCostMonitorSummaryAggregate(
   add("work_type", filter.workTypes);
   if (filter.query) {
     clauses.push(
-      "(a.task_id LIKE ? OR a.spec_id LIKE ? OR a.prd_id LIKE ? OR a.execution_id LIKE ? OR a.conversation_id LIKE ? OR a.zaip_agent LIKE ? OR a.model LIKE ? OR a.run_id LIKE ? OR a.agent_run_id LIKE ? OR EXISTS (SELECT 1 FROM canonical_work_items task WHERE task.id=a.task_id AND task.title LIKE ?))",
+      "(a.task_id LIKE ? OR a.spec_id LIKE ? OR a.prd_id LIKE ? OR a.execution_id LIKE ? OR a.conversation_id LIKE ? OR a.zaip_agent LIKE ? OR a.model LIKE ? OR a.run_id LIKE ? OR a.agent_run_id LIKE ? OR EXISTS (SELECT 1 FROM canonical_work_items task WHERE task.entity_kind='task' AND task.id=a.task_id AND task.title LIKE ?))",
     );
     values.push(...Array(10).fill(`%${filter.query}%`));
   }

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-work-item-index.test.ts

@@ -2,7 +2,7 @@ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
-import { afterEach, describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
 import { rebuildSqliteReadModel, SqliteReadModelFileSystem } from "./sqlite-read-model.js";
 
 const roots: string[] = [];
@@ -35,6 +35,23 @@ describe("SQLite work-item identity index", () => {
       ).toContain("TASK-INDEXED");
       const database = new DatabaseSync(process.env.ZAIP_SQLITE_DB_PATH, { readOnly: true });
       try {
+        const reader = new SqliteReadModelFileSystem(root, database);
+        const prepared = vi.spyOn(database, "prepare");
+        reader.costMonitorSummaryAggregate({ from: null, to: null, query: "Indexed" });
+        const searchSql = prepared.mock.calls
+          .map(([sql]) => sql)
+          .find(
+            (sql) =>
+              sql.startsWith("WITH selected AS MATERIALIZED") && sql.includes("task.title LIKE"),
+          );
+        prepared.mockRestore();
+        expect(searchSql).toBeDefined();
+        const searchPlan = database
+          .prepare(`EXPLAIN QUERY PLAN ${searchSql}`)
+          .all(null, null, null, null, ...Array(10).fill("%Indexed%")) as Array<{ detail: string }>;
+        expect(searchPlan.map((row) => row.detail).join("\n")).toContain(
+          "zaip_activities_work_item_identity",
+        );
         const plan = database
           .prepare(`EXPLAIN QUERY PLAN
           SELECT a.task_id FROM zaip_vw_activities a WHERE a.task_id IS NOT NULL

package/templates/.agents/dashboard/packages/local-runtime/vitest.config.ts

@@ -0,0 +1,12 @@
+import { availableParallelism } from "node:os";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    include: ["src/**/*.test.ts", "*.test.mjs"],
+    // This suite uses node:test and is executed explicitly by the package script.
+    exclude: ["dashboard-diagnostics.test.mjs"],
+    maxWorkers: Math.min(4, availableParallelism()),
+    testTimeout: 60_000,
+  },
+});

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

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

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

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

package/templates/.agents/dashboard/tests/e2e/specs/cost-monitor-pagination.spec.ts

@@ -126,12 +126,19 @@ for (const target of targets) {
     const button = tabs.getByRole("button", { exact: true, name: target.tab });
     await requestPage(page, target.sqliteView, 0, 10, () => button.click());
     await page.getByRole("button", { name: "Exportar Excel" }).click();
-    await expect
-      .poll(() => page.evaluate(() => window.__paginationExportProbe.closes), { timeout: 300_000 })
-      .toBe(1);
-    await expect(page.getByText("Exportação concluída.", { exact: true })).toBeVisible({
-      timeout: 30_000,
-    });
+    // Observe the transient success notice while the export runs. Waiting for
+    // the writer first can miss the notice when a busy host delays polling.
+    await Promise.all([
+      expect
+        .poll(() => page.evaluate(() => window.__paginationExportProbe.closes), {
+          timeout: 300_000,
+        })
+        .toBe(1),
+      expect(page.getByText("Exportação concluída.", { exact: true })).toBeVisible({
+        timeout: 300_000,
+      }),
+    ]);
+    expect(await page.evaluate(() => window.__paginationExportProbe.writes)).toBeGreaterThan(0);
     await expect.poll(() => pages.some((entry) => !entry.has_more), { timeout: 30_000 }).toBe(true);
 
     expect(pages.length).toBeGreaterThan(0);

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

@@ -458,7 +458,7 @@ test("filters the all-work board into Tasks, SPECs and PRDs after hydration", as
     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", { name: "Fechar", exact: true }).click();
   }
 
   await selectWorkBoardType(page, "PRDs", "prd");

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

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "version": "4.8.0",
+  "version": "5.0.0",
   "files": [
     {
       "path": "DESIGN.md",
@@ -276,7 +276,7 @@
     },
     {
       "path": "apps/catalog/package.json",
-      "sha256": "042f7b0a8b2fcfae031c268bfc07f41c96957ce3a6724b9ca8f0c8bd5ce4f3ab"
+      "sha256": "dcd0c6a84e8c1cdc34fafca8ce9089ea55db196d82ac8ef9e8bb9234168dd3c2"
     },
     {
       "path": "apps/catalog/public/logo_novo_azul.png",
@@ -408,7 +408,7 @@
     },
     {
       "path": "packages/local-runtime/package.json",
-      "sha256": "95c9a31264d488e61280b0f3b6955a9c4c3c96aa388c8c2f9b92dc84092dd920"
+      "sha256": "74dea06fa11afb30713fd1c286bc38833fe60ab782d5f9ed83ff380d9c032606"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-catalog",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "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": "4.8.0",
+  "version": "5.0.0",
   "private": true,
   "type": "module",
   "scripts": {

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

@@ -4,9 +4,9 @@ id: REQUIREMENTS-AUTONOMOUS-ASSURANCE
 area: autonomous-assurance
 title: Garantia adaptativa e execução autônoma
 status: active
-version: 3
+version: 6
 source_change: null
-source_release: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Garantia adaptativa e execução autônoma
@@ -22,6 +22,14 @@ Uma Task avulsa deve provar todos os Acceptance Criteria com profundidade propor
 - `AC-ASSURE-001-05`: uma Task sensível a segurança, migração, irreversibilidade ou múltiplos domínios não pode usar `lite` para contornar controles críticos.
 - `AC-ASSURE-001-06`: somente sob `assurance.version: 1`, uma Task `lite` com `editorial_delivery:true`, `verification_scope:"scoped"`, write scope editorial estreito e candidato textual regular pode dispensar a Decision das seis etapas. Ela ainda exige check tipado real, Evidence tipada cobrindo os ACs, commit/candidato Git, revisão e finalização. Código, configuração, controles de agente, ação externa, dado sensível, migração, risco `standard|critical` ou sinal sensível rejeitam a exceção; qualquer Task sem esse opt-in preserva a Decision.
 
+A rota editorial de `AC-ASSURE-001-06` inclui os literais `README.md` e
+`README-ENG.md`, Markdown literal em `docs/` e subdiretório documental estreito
+como `docs/quality/**`, além das raízes editoriais de negócio existentes.
+`docs/**` amplo não concede exceção. A prova usa o diff Git completo, modo de
+arquivo regular não executável e conteúdo textual; controles de agente,
+código, configuração, links, binários e sinais sensíveis continuam rejeitados.
+Uma alteração nesses controles é mudança de código/regra e conserva seu risco.
+
 ## REQ-ASSURE-002 — Garantia parental para SPEC e PRD
 
 Entregar uma SPEC ou PRD deve exigir prova no nível do produto planejado, além da soma dos testes das Tasks descendentes.
@@ -36,6 +44,15 @@ Entregar uma SPEC ou PRD deve exigir prova no nível do produto planejado, além
 
 O framework deve preservar execução manual como padrão e permitir autonomia somente por configuração explícita.
 
+Esta seção mantém o contrato de compatibilidade do runtime gerenciado legado.
+Configuração ausente resolve para `manual`; novos projetos gerados pela v4
+declaram explicitamente `codex_native`, executado pelo host. O teto legado de
+três tentativas em AC-AUTO-001-06 não substitui os perfis congelados de
+`autonomy.version: 1`: seus limites e critérios de recuperação pertencem a
+RULE-AUTONOMY-DECISION. A presença da configuração, isoladamente, não comprova
+que uma Task possui ledger de recuperação; `task recovery-status` deve informar
+esse estado, mantendo `legacy_or_unmigrated` quando o registro estiver ausente.
+
 - `AC-AUTO-001-01`: ausência de `execution` ou `execution.runtime: manual` materializa o trabalho sem invocar provider; `autonomous` exige provider, modelo, lease e paralelismo limitados.
 - `AC-AUTO-001-02`: o paralelismo efetivo é o menor limite entre projeto, plano, provider e squad. SPECs independentes podem usar Executions-filhas isoladas sob coordenação do PRD, mas locks globais de DAG e write scopes, além do orçamento global, continuam soberanos; SPECs sem elegibilidade permanecem na DAG global.
 - `AC-AUTO-001-03`: cada Task autônoma executa em Git worktree registrada, parte de raiz limpa, produz commit final, altera somente write scopes autorizados e aborta merge conflitante sem deixar merge parcial.
@@ -52,12 +69,31 @@ Aprendizado e alegações de maturidade devem ser derivados de fatos verificáve
 - `AC-EVOL-001-02`: lesson exige finding e locator verificável; opinião isolada não promove Rule, Requirement ou skill.
 - `AC-EVOL-001-03`: maturidade progride sequencialmente por `declared`, `implemented`, `locally_evidenced`, `cleanroom_validated`, `representative_validated` e `production_observed`.
 - `AC-EVOL-001-04`: Evidence de validação referencia o hash exato do candidato; cleanroom e estados posteriores exigem verificador independente, e produção exige Run observado. No runtime autônomo, o candidato é confirmado por Git e por ausência de alterações posteriores de produto no escopo, não somente pelo hash declarado em artefatos. Aprovação independente e Evidence devem referenciar o mesmo candidato. Qualidade conhecida abaixo do piso bloqueia mesmo sem dados de custo disponíveis.
+- No fechamento pós-publicação de `AC-EVOL-001-04`, o SHA validado permanece o candidato original. Um SHA publicado descendente só é aceito se cada commit intermediário, inclusive cada pai de merge, alterar exclusivamente `.agents/records/**`; igualdade final de bytes ou reversão posterior não substitui essa prova. O ciclo deve conter um único append com o SHA publicado exato, e Evidence/Validation selecionadas são vinculadas por hash de conteúdo. Mutação do limite de produto deve falhar no teste isolado.
 
 ## REQ-QUALITY-001 — Gates de release e cobertura sem regressão
 
 O release deve falhar de modo discriminante quando código, distribuição ou evidência não atingirem o contrato publicado.
 
-- `AC-QUALITY-001-01`: release crítico inclui unit, E2E, arquitetura, CQRS, módulos, profile, segurança e testes negativos.
+- `AC-QUALITY-001-01`: release crítico executa testes unitários, E2E, arquitetura, CQRS, módulos, profile, segurança e negativos conforme impacto e riscos do candidato. O gate essencial de distribuição mantém integridade, assinatura, instalação/rollback e smoke do pacote exato; uma suíte completa transversal só é obrigatória quando impacto, finding específico ou perfil explicitamente solicitado a exigir.
 - `AC-QUALITY-001-02`: cobertura usa baseline versionada e ratchet `max(piso, baseline anterior)` com pisos de 80% para lines/functions/statements e 75% para branches.
 - `AC-QUALITY-001-03`: baseline observada abaixo do piso pode ser registrada para transparência, mas não reduz o gate nem torna a release aprovada.
 - `AC-QUALITY-001-04`: release verifica paridade entre fonte canônica, template público e artefato distribuído, além de smoke/cleanroom sobre o candidato exato.
+
+Na criação de PRD, SPEC e AC, selecione por impacto os testes de código e os fluxos
+de dashboard alterados. Integre os contratos modificados antes do release e
+qualifique o pacote completo uma vez no candidato final antes de publicar;
+correções posteriores revalidam as provas afetadas. Reuse Evidence apenas quando
+candidato, ambiente, contrato e impacto ainda coincidirem. Teste de código não
+promove comportamento não observado a prova servida.
+
+Na consolidação 4.9, a Decision
+`DEC-AI-2026-10-03-22-18-TAREFA2-ACEITE-CODIGO-XFQFBLLYRN` delimita a
+Task de recuperação a regressões de código dirigidas por seus deltas, revisão
+independente e finalização. Coleta operacional e configurações sem prova servida
+permanecem `unverified`; testes de código não as promovem a observação servida.
+Integração dos fluxos e contratos alterados pertence à fase de integração; a
+qualificação integral do pacote final ocorre uma vez antes da publicação,
+conforme `DEC-AI-2026-10-03-22-16-QUALIFICACAO-FINAL-UNICA-UPQGEC6JJV`.
+Evidence, candidato exato e controles críticos aplicáveis continuam obrigatórios;
+esta divisão de fases não reaprova snapshots antigos nem dispensa findings reais.

package/templates/.agents/requirements/cloud-hostinger-autonomy.md

@@ -6,7 +6,7 @@ title: Autonomia delimitada para Cloudflare e Hostinger
 status: proposed
 version: 1
 source_change: null
-source_release: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Cloudflare e Hostinger (proposta de requisito)

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: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Auditoria comparativa e plano de evolução

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

@@ -4,9 +4,9 @@ id: REQUIREMENTS-CONTEXT-ENGINE
 area: context-engine
 title: Contexto mínimo, seguro e navegável
 status: active
-version: 8
+version: 9
 source_change: null
-source_release: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Context engine
@@ -37,7 +37,7 @@ Coleções de trabalho devem ser navegadas pelos manifests canônicos compactos
 - `AC-CONTEXT-003-02`: listagens de PRD, SPEC e Task omitem o PreparedPlan completo e retornam somente resumo de preparação.
 - `AC-CONTEXT-003-03`: corpos e eventos JSONL são lidos somente após selecionar IDs específicos.
 - `AC-CONTEXT-003-04`: operações comuns consultam somente manifests lifecycle e `InvocationSummary` canônicos, com paginação cursor-estável; varredura integral de `.agents/records` ou `.agents/data` exige comando e confirmação explícitos.
-- `AC-CONTEXT-003-05`: o dashboard não depende de cache ou projeção local; migrações preservam somente os manifests canônicos Git-native em `.agents/records/lifecycle` e backfill verificável.
+- `AC-CONTEXT-003-05`: registros Git-native e seus manifests em `.agents/records/lifecycle` são a fonte canônica. O dashboard pode consultar SQLite/read model local reconstruível e API como projeções; perda ou rebuild da projeção não altera identidade nem estado canônico. Migração preserva registros e manifests, reconstrói/backfill da projeção com verificação de paridade e não trata cache como fonte de verdade.
 - `AC-CONTEXT-003-06`: `.agents/data` e partições diárias anteriores são fallback legado somente leitura; novas escritas usam `.agents/records/<kind>/<ano>/<mês>`.
 - `AC-CONTEXT-003-07`: `context build` descobre paths e relações antes de ler conteúdo; inventário integral exige comando explícito.
 - `AC-CONTEXT-003-08`: uma consulta com ID lifecycle explícito não incorpora outros itens de `active-work`; fallback de path aceita somente o arquivo V3 canônico existente sem varrer records.

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: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Cost observability

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

@@ -6,7 +6,7 @@ title: Inicialização e hidratação confiável do dashboard
 status: active
 version: 1
 source_change: null
-source_release: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Inicialização e hidratação confiável do dashboard

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: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # 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: 5
 source_change: null
-source_release: "4.8.0"
+source_release: "5.0.0"
 ---
 
 # Design system