@zaip-ai/cli 1.4.3 → 2.2.0

package/templates/.agents/dashboard/packages/local-runtime/src/sqlite-snapshot-seed.test.ts

@@ -1,4 +1,4 @@
-import { copyFile, mkdir, mkdtemp, readdir, rm, writeFile } from "node:fs/promises";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { DatabaseSync } from "node:sqlite";
@@ -17,24 +17,53 @@ afterEach(async () => {
 });
 
 describe("SQLite snapshot seed publication", () => {
+  it("rebuilds schema-73 parser state from unchanged current data", async () => {
+    const root = await mkdtemp(join(tmpdir(), "zaip-schema-74-parser-"));
+    roots.push(root);
+    const task = join(root, ".agents", "data", "tasks", "TASK-CURRENT.md");
+    await mkdir(join(root, ".agents", "config"), { recursive: true });
+    await mkdir(join(root, ".agents", "data", "tasks"), { recursive: true });
+    await writeFile(join(root, ".agents", "config", "project.yaml"), "zaip:\n  enabled: true\n");
+    await writeFile(
+      task,
+      "---\nid: TASK-CURRENT\ntitle: Current parser record\nstatus: executing\ncreated_at: 2026-09-05T12:00:00.000Z\n---\n",
+    );
+    const first = await rebuildSqliteReadModel(root);
+    const before = await readFile(task, "utf8");
+    const stale = new DatabaseSync(first.path);
+    try {
+      stale.exec(
+        "UPDATE zaip_aios_activities SET payload_json=json_set(payload_json, '$.value', '73') WHERE payload_type='metadata' AND json_extract(payload_json, '$.key')='schema_version'; UPDATE zaip_aios_activities SET payload_json='[]' WHERE payload_type='parsed_source';",
+      );
+    } finally {
+      stale.close();
+    }
+
+    await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({ cache: "rebuilt" });
+    expect(await readFile(task, "utf8")).toBe(before);
+    const served = new SqliteReadModelFileSystem(root);
+    try {
+      expect(served.canonicalWorkPage("task", { from: null, to: null }, 0, 10)).toMatchObject({
+        rows: [expect.objectContaining({ id: "TASK-CURRENT", title: "Current parser record" })],
+      });
+    } finally {
+      served.close();
+    }
+  });
+
   it.each([
     "old-schema",
     "missing-index",
-  ])("rebuilds incompatible %s generations and stale seeds", async (damage) => {
+  ])("rebuilds incompatible %s launcher-selected generations", async (damage) => {
     const root = await mkdtemp(join(tmpdir(), "zaip-snapshot-index-upgrade-"));
     roots.push(root);
     await mkdir(join(root, ".agents", "config"), { recursive: true });
     await writeFile(join(root, ".agents", "config", "project.yaml"), "zaip:\n  enabled: true\n");
     const destination = join(root, ".local", "dashboard-sqlite", "read-model.sqlite");
-    const cacheDirectory = join(root, ".local", "dashboard-sqlite", "cache");
     vi.stubEnv("ZAIP_SQLITE_DB_PATH", destination);
-    vi.stubEnv("ZAIP_SQLITE_CACHE_DIR", cacheDirectory);
-    vi.stubEnv("ZAIP_SQLITE_PREFER_LAST_VALID_SEED", "1");
     try {
       await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({ cache: "rebuilt" });
-      const seedName = (await readdir(cacheDirectory)).find((name) => name.endsWith(".sqlite"));
-      if (seedName === undefined) throw new Error("Expected the rebuilt seed");
-      for (const path of [destination, join(cacheDirectory, seedName)]) {
+      for (const path of [destination]) {
         const database = new DatabaseSync(path);
         try {
           if (damage === "missing-index")
@@ -49,14 +78,14 @@ describe("SQLite snapshot seed publication", () => {
       }
       await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({ cache: "rebuilt" });
       expect(() => validateSqliteReadModelSchema(destination)).not.toThrow();
-      await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({ cache: "stale_seed" });
+      await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({ cache: "generation" });
       expect(() => validateSqliteReadModelSchema(destination)).not.toThrow();
     } finally {
       vi.unstubAllEnvs();
     }
   });
 
-  it("skips a newer incomplete seed and materializes the prior complete cache", async () => {
+  it("rebuilds the launcher-selected database without using a hidden seed cache", async () => {
     const root = await mkdtemp(join(tmpdir(), "zaip-snapshot-seed-"));
     roots.push(root);
     const task = join(root, ".agents", "records", "tasks", "task.md");
@@ -65,17 +94,6 @@ describe("SQLite snapshot seed publication", () => {
     await writeFile(join(root, ".agents", "config", "project.yaml"), "zaip:\n  enabled: true\n");
     await writeFile(task, "# original\n");
     await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({ cache: "rebuilt" });
-    const cacheDirectory = join(root, ".local", "dashboard-sqlite", "cache");
-    const completeName = (await readdir(cacheDirectory)).find((name) => name.endsWith(".sqlite"));
-    expect(completeName).toBeDefined();
-    if (completeName === undefined) throw new Error("Expected a complete SQLite seed");
-    const incomplete = join(cacheDirectory, "v67-ff5-incomplete-newest.sqlite");
-    await copyFile(join(cacheDirectory, completeName), incomplete);
-    const incompleteDatabase = new DatabaseSync(incomplete);
-    incompleteDatabase
-      .prepare("DELETE FROM zaip_aios_activities WHERE payload_type='first_fold_all_time_cache'")
-      .run();
-    incompleteDatabase.close();
     await writeFile(task, "# changed canonically\n");
     const previousPath = process.env.ZAIP_SQLITE_DB_PATH;
     const previousSeed = process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED;
@@ -83,7 +101,7 @@ describe("SQLite snapshot seed publication", () => {
       process.env.ZAIP_SQLITE_DB_PATH = join(root, ".local", "dashboard-sqlite", "next.sqlite");
       process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED = "1";
       await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({
-        cache: "stale_seed",
+        cache: "rebuilt",
         files: 2,
       });
       const served = new SqliteReadModelFileSystem(root);
@@ -101,7 +119,7 @@ describe("SQLite snapshot seed publication", () => {
     }
   });
 
-  it("uses a compatible stale seed before source inventory when launcher policy requests it", async () => {
+  it("rebuilds current canonical data before source inventory is declared current", async () => {
     const root = await mkdtemp(join(tmpdir(), "zaip-snapshot-seed-early-"));
     roots.push(root);
     await mkdir(join(root, ".agents", "records", "tasks"), { recursive: true });
@@ -119,11 +137,9 @@ describe("SQLite snapshot seed publication", () => {
       process.env.ZAIP_SQLITE_PREFER_LAST_VALID_SEED = "1";
       process.env.ZAIP_DASHBOARD_LAUNCH_PROGRESS = "1";
       await expect(rebuildSqliteReadModel(root)).resolves.toMatchObject({
-        cache: "stale_seed",
-        fingerprint_ms: 0,
+        cache: "rebuilt",
       });
-      expect(stderr.mock.calls.join("\n")).toContain('"phase":"stale_seed_ready"');
-      expect(stderr.mock.calls.join("\n")).not.toContain('"phase":"source_fingerprint_started"');
+      expect(stderr.mock.calls.join("\n")).toContain('"phase":"source_fingerprint_started"');
     } finally {
       stderr.mockRestore();
       if (previousPath === undefined) delete process.env.ZAIP_SQLITE_DB_PATH;
@@ -146,16 +162,8 @@ describe("SQLite snapshot seed publication", () => {
       "---\nid: TASK-SEED-POPULATION\ntitle: Seed population\nstatus: ready\nrisk: standard\ncreated_at: 2026-08-01T12:00:00.000Z\n---\n# Seed population\n",
     );
     await rebuildSqliteReadModel(root);
-    const seed = join(
-      root,
-      ".local",
-      "dashboard-sqlite",
-      "cache",
-      (await readdir(join(root, ".local", "dashboard-sqlite", "cache"))).find((name) =>
-        name.endsWith(".sqlite"),
-      ) ?? "missing.sqlite",
-    );
-    const database = new DatabaseSync(seed);
+    const built = await rebuildSqliteReadModel(root);
+    const database = new DatabaseSync(built.path);
     try {
       database
         .prepare(
@@ -179,11 +187,8 @@ describe("SQLite snapshot seed publication", () => {
       "---\nid: TASK-SEED-HISTORICAL\ntitle: Historical seed task\nstatus: ready\nrisk: standard\ncreated_at: 2026-07-01T12:00:00.000Z\n---\n# Historical seed task\n",
     );
     await rebuildSqliteReadModel(root);
-    const cacheDirectory = join(root, ".local", "dashboard-sqlite", "cache");
-    const seedName = (await readdir(cacheDirectory)).find((name) => name.endsWith(".sqlite"));
-    expect(seedName).toBeDefined();
-    if (seedName === undefined) throw new Error("Expected a complete SQLite seed");
-    const database = new DatabaseSync(join(cacheDirectory, seedName), { readOnly: true });
+    const built = await rebuildSqliteReadModel(root);
+    const database = new DatabaseSync(built.path, { readOnly: true });
     try {
       expect(hasRequiredFirstFoldPayloads(database)).toBe(true);
     } finally {

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

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

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

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

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

@@ -1,7 +1,15 @@
 {
   "schemaVersion": 1,
-  "version": "1.3.0",
+  "version": "2.2.0",
   "files": [
+    {
+      "path": "DESIGN.md",
+      "sha256": "9970e5040403dfe41b86651128b691ddb3ee6f5e9909cebfacf0a614555cb7f6"
+    },
+    {
+      "path": "README.md",
+      "sha256": "7efaff80b0a1add169646dc250b84d5b3a42378c57f6e891bab51ac2bb0e4b50"
+    },
     {
       "path": "apps/catalog/.storybook/main.ts",
       "sha256": "d3b2540af9898ed7cf4e360a553bc9c84b0270150fe9114b23bbfb07cc527c1b"
@@ -30,14 +38,34 @@
       "path": "apps/catalog/dist/logo_novo_azul.png",
       "sha256": "bb6043bda9fc53a111aaea4d6a004559b9ce8a3569691c060d217a7c6aafa0ae"
     },
-    {
-      "path": "apps/catalog/dist/storybook/assets/axe-Bk3eEgJf.js",
-      "sha256": "7859f7599f0e67573826ead33b5670064e35a6b44d09b5da87c8bfc758f2b2ea"
-    },
     {
       "path": "apps/catalog/dist/storybook/assets/CatalogShell-BWY-80s4.js",
       "sha256": "84d451e4102b3f22bb5ad5862f7c1639929f12a1b972ec390076b49381814e0c"
     },
+    {
+      "path": "apps/catalog/dist/storybook/assets/Color-6AOWCN3U-B-kAgAjB.js",
+      "sha256": "0e3ac0b9820668e73414175d055967f9d49bb2e7d826cdbd4aa6cd7fd384a713"
+    },
+    {
+      "path": "apps/catalog/dist/storybook/assets/Components.stories-Be2mDUQj.js",
+      "sha256": "2981c30e093c3a23616f465a6afc1bc287732692af998d608593598a731c97c4"
+    },
+    {
+      "path": "apps/catalog/dist/storybook/assets/DesignSystem.stories-DRx9blDs.js",
+      "sha256": "3471400ec1a7cf9cce8f1e58068f91ebe416d34aea4be99a2431aeb0dba776a2"
+    },
+    {
+      "path": "apps/catalog/dist/storybook/assets/DocsRenderer-JROSPFPF-BVN7xHtv.js",
+      "sha256": "162d64f939550ce9e9582f15e3befbb7a8d5fdcc502410ed88262994d6cb82ce"
+    },
+    {
+      "path": "apps/catalog/dist/storybook/assets/WithTooltip-7X4HQR7L-CDHtKYkz.js",
+      "sha256": "9be8ec095a76bf6993527027d4fd16ed5a97340c31de0bf86d1658840989aabe"
+    },
+    {
+      "path": "apps/catalog/dist/storybook/assets/axe-Bk3eEgJf.js",
+      "sha256": "7859f7599f0e67573826ead33b5670064e35a6b44d09b5da87c8bfc758f2b2ea"
+    },
     {
       "path": "apps/catalog/dist/storybook/assets/chunk-242VQQM5-DB2JSNUA.js",
       "sha256": "99518b5bd7da5186fe889de049274f734939938a15b2a6ff4fd72b09b89ddf3b"
@@ -54,26 +82,10 @@
       "path": "apps/catalog/dist/storybook/assets/chunk-W22LQPXL-B4m5uloN.js",
       "sha256": "8c45d2277c1a1c93f0bdc62c0122c515babacff466bb79538c95c1f885e76a1b"
     },
-    {
-      "path": "apps/catalog/dist/storybook/assets/Color-6AOWCN3U-B-kAgAjB.js",
-      "sha256": "0e3ac0b9820668e73414175d055967f9d49bb2e7d826cdbd4aa6cd7fd384a713"
-    },
     {
       "path": "apps/catalog/dist/storybook/assets/components-CN8YyTUg.js",
       "sha256": "2793aa528869e3947d41591db2023524f8d81578f713214e9acac02f743d22e7"
     },
-    {
-      "path": "apps/catalog/dist/storybook/assets/Components.stories-Be2mDUQj.js",
-      "sha256": "2981c30e093c3a23616f465a6afc1bc287732692af998d608593598a731c97c4"
-    },
-    {
-      "path": "apps/catalog/dist/storybook/assets/DesignSystem.stories-DRx9blDs.js",
-      "sha256": "3471400ec1a7cf9cce8f1e58068f91ebe416d34aea4be99a2431aeb0dba776a2"
-    },
-    {
-      "path": "apps/catalog/dist/storybook/assets/DocsRenderer-JROSPFPF-BVN7xHtv.js",
-      "sha256": "162d64f939550ce9e9582f15e3befbb7a8d5fdcc502410ed88262994d6cb82ce"
-    },
     {
       "path": "apps/catalog/dist/storybook/assets/formatter-L2YTDE3Q-EwuTh8Zk.js",
       "sha256": "73f231544e7f0272b6ac45ec3a665c69b6fc2073afa243915c1d09e119c18aa7"
@@ -114,10 +126,6 @@
       "path": "apps/catalog/dist/storybook/assets/theming-DS_ue2sb.js",
       "sha256": "deba2831ca2a9bae10430a9388d4c1cb3b83d0824f2e55f3ffce97bf51818cf2"
     },
-    {
-      "path": "apps/catalog/dist/storybook/assets/WithTooltip-7X4HQR7L-CDHtKYkz.js",
-      "sha256": "9be8ec095a76bf6993527027d4fd16ed5a97340c31de0bf86d1658840989aabe"
-    },
     {
       "path": "apps/catalog/dist/storybook/favicon-wrapper.svg",
       "sha256": "5311f921255509431fc978cd04fd497ae54c46cfd97b3578dc53d7f652667a71"
@@ -220,7 +228,7 @@
     },
     {
       "path": "apps/catalog/package.json",
-      "sha256": "e9ffdce8dcc8ed1fed3888add953e7e789261307b8d037a6001d98a38f644279"
+      "sha256": "44766720319e51f1a60ddce76263e081a109e7d01d5ce63b01c20f82200d0abb"
     },
     {
       "path": "apps/catalog/public/logo_novo_azul.png",
@@ -234,6 +242,10 @@
       "path": "apps/catalog/src/components/CatalogShell.tsx",
       "sha256": "9c1c20501aabf476bde54b453fe826efe31a0b3d484a0a050c898bf45f343096"
     },
+    {
+      "path": "apps/catalog/src/components/Primitives.tsx",
+      "sha256": "68d65caaa90818b7e942db30cd2fd6f68912e63b974c940ce694b93fa1bdc5ce"
+    },
     {
       "path": "apps/catalog/src/components/dialog-focus.test.ts",
       "sha256": "b62a5209b8554a4500ff241fb3d0cb67bff4ff751b8eddbda2dfd17dd9b6beed"
@@ -242,10 +254,6 @@
       "path": "apps/catalog/src/components/dialog-focus.ts",
       "sha256": "de72b418a3e8f08da924477014503581a8fd257c73fac85fdfbd883ad49de483"
     },
-    {
-      "path": "apps/catalog/src/components/Primitives.tsx",
-      "sha256": "68d65caaa90818b7e942db30cd2fd6f68912e63b974c940ce694b93fa1bdc5ce"
-    },
     {
       "path": "apps/catalog/src/design-contract.test.ts",
       "sha256": "e1854f467f0f98c418daf44a723e0d095df2af2917f51858c67afef708ad776e"
@@ -298,13 +306,9 @@
       "path": "apps/catalog/vitest.config.ts",
       "sha256": "552604801fdfc82b1b6bc1bebad3310738fa4f2e391a494e2bd10a2181196770"
     },
-    {
-      "path": "DESIGN.md",
-      "sha256": "9970e5040403dfe41b86651128b691ddb3ee6f5e9909cebfacf0a614555cb7f6"
-    },
     {
       "path": "packages/local-runtime/package.json",
-      "sha256": "73bbd424a00481ca49bd3265183e0b505cc313484459d0701361a987f2b89057"
+      "sha256": "4584315601e42ab39805a047ad2073fc3ef51fb030fee1aa7aafb60942d0bba2"
     },
     {
       "path": "packages/local-runtime/runtime.mjs",
@@ -318,17 +322,13 @@
       "path": "packages/local-runtime/start-design.mjs",
       "sha256": "7623422e49c35c5584bf7579465ef7c159a72eb40427308585176bb0064a9e7a"
     },
-    {
-      "path": "packages/windows-launcher/build-design-launcher.ps1",
-      "sha256": "c4ec3926aafae3a2f0122e756f2a0ec301a1eaac8563cae591d0ae6353fbbbff"
-    },
     {
       "path": "packages/windows-launcher/Program.cs",
       "sha256": "a52e7837a2c81e49fb9f39fc9ad550b791ceac73ee27c5980f2f4f9c4dd7bf22"
     },
     {
-      "path": "README.md",
-      "sha256": "7efaff80b0a1add169646dc250b84d5b3a42378c57f6e891bab51ac2bb0e4b50"
+      "path": "packages/windows-launcher/build-design-launcher.ps1",
+      "sha256": "c4ec3926aafae3a2f0122e756f2a0ec301a1eaac8563cae591d0ae6353fbbbff"
     },
     {
       "path": "tokens.json",

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

@@ -1,6 +1,6 @@
 {
   "name": "@zaip-ai/design-catalog",
-  "version": "1.3.0",
+  "version": "2.2.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": "1.3.0",
+  "version": "2.2.0",
   "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: 3
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Garantia adaptativa e execução autônoma

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: "1.4.3"
+source_release: "2.2.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: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # 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.4.3"
+source_release: "2.2.0"
 ---
 
 # 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.4.3"
+source_release: "2.2.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: "1.4.3"
+source_release: "2.2.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: "1.4.3"
+source_release: "2.2.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: 3
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Design system

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

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

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

@@ -6,7 +6,7 @@ title: Projeções operacionais e analíticas
 status: active
 version: 14
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Kanban and dashboard

package/templates/.agents/requirements/model-orchestration.md

@@ -4,9 +4,9 @@ id: REQUIREMENTS-MODEL-ORCHESTRATION
 area: model-orchestration
 title: Seleção automática e observável de modelo e effort
 status: active
-version: 7
+version: 8
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Orquestração de modelos
@@ -16,7 +16,7 @@ source_release: "1.4.3"
 O projeto deve poder habilitar seleção automática de modelo, effort e velocidade sem alterar o comportamento dos modos existentes.
 
 - `AC-MODEL-001-01`: o schema aceita `model_orchestration.mode: auto` além de `manual` e `off`; ausência do bloco e os dois modos existentes mantêm o comportamento anterior em testes de compatibilidade.
-- `AC-MODEL-001-02`: o modo `auto` exige `default_model: gpt-5.6-terra`, `default_effort: medium`, `default_velocity: standard`, allowlist contendo exatamente `gpt-5.6-luna`, `gpt-5.6-terra` e `gpt-5.6-sol`, efforts automáticos restritos a `low|medium|high|xhigh` e teto automático `xhigh`.
+- `AC-MODEL-001-02`: o modo `auto` exige `default_model: gpt-5.6-terra`, `default_effort: medium`, `default_velocity: standard` e allowlist única com o trio obrigatório `gpt-5.6-luna`, `gpt-5.6-terra`, `gpt-5.6-sol`; `gpt-6-astra` é o quarto modelo opcional. Efforts automáticos são `low|medium|high|xhigh`, com teto geral `xhigh` e teto específico Astra `high`.
 - `AC-MODEL-001-03`: setup, migration, adapters e templates preservam `manual` como default de projetos novos e existentes; `auto` só é ativado por configuração explícita do projeto e passa em `zaip doctor`.
 - `AC-MODEL-001-04`: o modo `auto` exige `automatic_sources: [spec, prd]`; `task` não é uma origem automática válida, preservando a seleção manual do host para Tasks avulsas.
 
@@ -24,10 +24,10 @@ O projeto deve poder habilitar seleção automática de modelo, effort e velocid
 
 Cada Invocação de Agente deve resolver uma configuração única a partir do agente do catálogo, dos metadados estruturados da Task e da fase, sem depender de instrução em linguagem natural.
 
-- `AC-MODEL-002-01`: o resolvedor aplica a precedência `runtime_defaults explícito da Execution -> runtime explícito da Task -> política automática -> defaults do projeto`, retornando modelo, effort, velocidade, origem, versão da política e ao menos um motivo enumerado.
+- `AC-MODEL-002-01`: o resolvedor aplica a precedência `runtime_defaults explícito da Execution -> runtime explícito da Task -> política automática -> defaults do projeto`, retornando modelo, effort, velocidade, origem, versão da política e ao menos um motivo enumerado. A precedência nunca contorna os limites Astra: diagnóstico difícil evidenciado, somente high, reserva pré-dispatch de até três diagnósticos por Task e handback validado para executor, conforme REQ-MODEL-006.
 - `AC-MODEL-002-02`: Tasks novas de PRD/SPEC persistem `model_profile` calculado de `model_signals` reais com fase-base, complexidade, transversalidade, ambiguidade, rework, custo, boundedness, volume, gatilhos `xhigh` e sinais de risco. A classificação `task-risk-v1` deriva `lite|standard|critical` e motivos enumerados; declaração conflitante é rejeitada, enquanto PreparedPlans históricos sem perfil continuam legíveis. A política considera o perfil persistido, a fase e o agente reais da chamada e restrições de capacidade; risco governa assurance e não força sozinho modelo ou effort superior.
 - `AC-MODEL-002-03`: a política inicial usa Luna para trabalho simples, delimitado ou de alto volume, Terra como baseline de implementação e teste e Sol para planejamento, revisão ou reparo ambíguo/transversal; `xhigh` só é elegível para planejamento, replanejamento, auditoria ou rework estrutural delimitado quando as quatro condições e ao menos dois gatilhos observáveis do guia forem satisfeitos.
-- `AC-MODEL-002-04`: `ultra`, `max`, effort desconhecido e modelo fora da allowlist são rejeitados antes da chamada com erro tipado, sem fallback silencioso; `xhigh` é aceito quando vier de override explícito válido ou da política elegível.
+- `AC-MODEL-002-04`: `ultra`, `max`, effort desconhecido e modelo fora da allowlist são rejeitados antes da chamada com erro tipado, sem fallback silencioso; `xhigh` é aceito quando vier de override explícito válido ou da política elegível, sempre excluindo Astra.
 - `AC-MODEL-002-05`: a Invocação do Orquestrador usa a identidade visível `zaip-agent-orchestrator`; cada Execução ZAIP delega por capacidade a ao menos um executor do catálogo, conversas podem usar `zaip-agent-analyst`, e a última Invocação Delegada usa `zaip-agent-finalizer`.
 
 ## REQ-MODEL-003 — Configuração imutável por Agent Run
@@ -56,3 +56,13 @@ O modo automático deve ser ativado com evals, rollback e documentação que dis
 - `AC-MODEL-005-01`: uma suíte determinística cobre ao menos seleção lite, baseline Terra, planejamento Sol, risco crítico mecânico, rework estrutural, `xhigh` elegível, `xhigh` inelegível, `ultra` rejeitado, velocidade diferente de `standard` rejeitada, override explícito e capacidade incompatível.
 - `AC-MODEL-005-02`: o rollout compara sucesso por Acceptance Criteria, aprovação na primeira revisão, repair cycles, tokens, latência e custo por Task aprovada; regressão de qualidade bloqueia a ativação ampla mesmo quando houver economia.
 - `AC-MODEL-005-03`: o guia, adapters, templates e configuração distribuída descrevem os mesmos defaults e permitem rollback para `manual` sem migração destrutiva de Runs já registrados.
+
+## REQ-MODEL-006 — Diagnóstico Astra limitado e econômico
+
+Astra orienta a solução de problemas difíceis; a implementação permanece nos executores existentes.
+
+- `AC-MODEL-006-01`: a rota exige complexidade alta ou ambiguidade alta e evidência de tentativa executora falha por hipótese/raciocínio, ou impacto material crítico evidenciado com diagnóstico difícil. Risco isolado, tarefa simples, departamento, volume, rótulos e falhas de ambiente/ferramenta não ativam Astra.
+- `AC-MODEL-006-02`: a invocação diagnóstica usa identidade catalogada, high, contexto novo, zero ferramentas e nenhum resume; Astra como executor/reviewer/finalizer e efforts superiores são rejeitados antes da chamada. Entrada serializada limitada a 48000 bytes, orçamento de saída até 8000 tokens e timeout até 180 segundos; provider usage e limites declarados permanecem distintos.
+- `AC-MODEL-006-03`: reserva persistente e atômica antes de cada dispatch limita três diagnósticos por Task estável, inclusive retomada, nova Execution e concorrência. Replay não autoriza novo dispatch; eventos de usage não consomem nem restauram quota.
+- `AC-MODEL-006-04`: handback estruturado traz findings, prova, causa/hipótese, rota corrigida, escopo, executor não Astra e teste. A próxima tentativa executa a correção com Luna/Terra/Sol; outro diagnóstico exige evidência nova e progresso de hipótese/rota. Sem progresso ou com quota esgotada, devolve rota útil ou bloqueia explicitamente.
+- `AC-MODEL-006-05`: a expansão Astra é condicional e não aumenta o kernel sempre carregado nem prompts de especialistas comerciais. Política automática continua restrita a SPEC/PRD, sem alterar seleção manual do host. Evals negativos e positivos, quota e integração real do coordenador são verificados antes da entrega.

package/templates/.agents/requirements/public-distribution.md

@@ -4,9 +4,9 @@ id: REQUIREMENTS-PUBLIC-DISTRIBUTION
 area: public-distribution
 title: Distribuição pública e ativação
 status: active
-version: 3
+version: 4
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Distribuição pública e ativação
@@ -15,7 +15,7 @@ source_release: "1.4.3"
 
 O pacote público deve entregar, verificar e reparar o mesmo runtime de lifecycle referenciado pelo guidance instalado, sem depender do checkout mantenedor nem criar autoridade implícita.
 
-- `AC-DIST-001-01`: o `.tgz` exato de `@zaip-ai/cli` e `create-zaip-aios` instala `.agents/runtime/bin/zaip.mjs` e seus metadados de supply chain; no workspace vazio, `doctor`, `status`, `conversation start`, `disable` e `enable` terminam com sucesso.
+- `AC-DIST-001-01`: o `.tgz` exato de `@zaip-ai/cli` instala `.agents/runtime/bin/zaip.mjs` e seus metadados de supply chain; no workspace vazio, `doctor`, `status`, `conversation start`, `disable` e `enable` terminam com sucesso.
 - `AC-DIST-001-02`: `zaip.enabled` é a única chave gravada; a matriz canônica/legada `true|false|ausente` preserva compatibilidade, normaliza a próxima escrita e rejeita valores contraditórios antes de mutar o workspace.
 - `AC-DIST-001-03`: `template:sync` e `template:audit` cobrem `.agents`, incluindo `.agents/runtime`, recalculam o digest agregado, rejeitam path traversal, symlink, duplicata, descendente de arquivo allowlisted e checksum divergente.
 - `AC-DIST-001-04`: geração de runtime e manifest ocorre como uma única substituição recuperável; falhas injetadas antes e depois da troca preservam byte a byte o runtime e o manifest anteriores, e reinstalação autorizada restaura arquivo ausente.

package/templates/.agents/requirements/software-architecture.md

@@ -6,7 +6,7 @@ title: Layout modular e limites de código-fonte
 status: active
 version: 5
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Software architecture

package/templates/.agents/requirements/strategic-improvements.md

@@ -6,7 +6,7 @@ title: Melhorias estratégicas de custo, qualidade e resiliência
 status: active
 version: 1
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Melhorias estratégicas de custo, qualidade e resiliência

package/templates/.agents/requirements/work-lifecycle.md

@@ -6,7 +6,7 @@ title: Ciclo de vida do trabalho
 status: active
 version: 24
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Work lifecycle

package/templates/.agents/requirements/zaip-strategic-95.md

@@ -6,7 +6,7 @@ title: Evidências, custo por Task e autonomia por SPEC
 status: active
 version: 1
 source_change: null
-source_release: "1.4.3"
+source_release: "2.2.0"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC

package/templates/.agents/rules/astra-diagnostic.md

@@ -0,0 +1,20 @@
+---
+id: RULE-ASTRA-DIAGNOSTIC
+load: manual
+priority: high
+max_context_tokens: 650
+requires:
+  - RULE-CORE
+---
+
+# Astra para diagnóstico difícil
+
+Carregue somente ao avaliar uma escalada Astra. Luna/Terra executam trabalho comum; Sol continua responsável pela faixa difícil. Marketing, Sales, Growth, Ops, título, palavras como “crítico”, volume ou número de arquivos não justificam Astra.
+
+- Entrada: origem automática autorizada, dificuldade estruturada (complexidade alta ou ambiguidade alta) e evidência de uma tentativa executora que falhou por hipótese/raciocínio. Exceção preventiva: impacto material crítico comprovado e diagnóstico difícil comprovado. Erros de ambiente, credenciais, ferramentas, sintaxe ou falta de evidência não autorizam a escalada.
+- Astra é uma invocação diagnóstica do orquestrador, somente `high` e `standard`. Nunca executor, reviewer rotineiro ou finalizer; nunca `xhigh`, `max` ou `ultra`, inclusive via override.
+- Prefira um diagnóstico. Reserve atomicamente antes do dispatch; máximo três invocações por Task estável, somando Runs, Executions e retomadas. Não reinicie a quota, crie Task artificial nem repita invocation_id para contornar o teto. “Ciclo” é diagnóstico governado, não evento de uso ou chamada interna.
+- Receba contexto novo e compacto: falha, prova, tentativa anterior, restrições e critérios de aceite. Sem histórico integral, resume, ferramentas, filhos ou escrita. Envelope: até 48000 bytes de entrada serializada, orçamento de 8000 tokens de saída, timeout de 180 segundos. Bytes não são tokens; reporte consumo apenas quando observado.
+- Devolva JSON com findings, evidências, causa/hipótese, rota corrigida, escopo, executor Luna/Terra/Sol e teste de validação. O executor realiza o reparo e verifica o resultado na tentativa seguinte. Não prometa solução na segunda tentativa.
+- Outro diagnóstico exige evidência nova e mudança verificável de hipótese/rota. Pare antes do teto se não houver progresso; não alterne Astra/Sol repetindo o mesmo plano. Ao esgotar três, devolva uma rota executável ou bloqueie com a evidência/decisão faltante.
+- O runtime deve validar elegibilidade, quota, isolamento e handback. Configuração incompatível bloqueia o diagnóstico; não converta Astra em executor. A preferência manual do host em conversa/Task avulsa permanece fora do controle automático.