@zaip-ai/cli 4.8.0 → 5.0.0

package/templates/.agents/runtime/checksums.sha256

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-4938ef88cd76dd7f6297a3d1d0c57af9c8e420e9359e778f3fc3725a8781af0a  VERSION
-20260ddb4f0a306d1ef52bb67b0ad4eb5e6edbdf0af0c1db5e6084b101b15490  bin/zaip.mjs
-78f229de87d67490a9bbec827e21be6c3c01a19cc1ad26af9bca781e6a0f559b  manifest.json
+1cc3d76ac7c21a664e79848fd481e9791016451b244e7de5feeeb9bea5fd2184  VERSION
+82403b0ced92c346777cc9c23cca3a075a8e6a128d6e380ac204e6edb19e7185  bin/zaip.mjs
+2ce5edd97bb6f95343de79f9b6fd7ab0c6aaedd6214dc63814ddbe2a6108b42f  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
-33c98d5dc506bba4b8b3ca612706d9eb05ef13d9e03c33a4f9e65ca7804be9d1  pnpm-lock.sha256
-d7459fa9108cc5cf7974c46daba9b02d1fa36a6f059c0eefcc8a5ce6ba2a4184  provenance.json
-5dcd790db0a223a246bc742f6b96bb13e7f93be9495267b0f49de603f770d80f  sbom.cdx.json
+46f22db07aa1cf319150bcde84220f1229ee151899b9c1487dd8347144ef8224  pnpm-lock.sha256
+d8e885983c3f54221498e812d4c04c90939189bf83f2e0e83beb774a45ae73cc  provenance.json
+5f723b2f41f9110ad5f40487e0591434d195b7a044c8411cd033b03ca4d59430  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

package/templates/.agents/runtime/manifest.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "name": "zaip-aios",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "node": ">=22",
   "files": [
     "LICENSE",

package/templates/.agents/runtime/pnpm-lock.sha256

@@ -1 +1 @@
-03d08e5bbb198d74014ea4a806fcdeb350db23ec2bf0c2886a2265066555d418  pnpm-lock.yaml
+05e0dbb29d49d08cd3735fdd50ab01b72772e3cea476294c5ce3db1b4bbb13db  pnpm-lock.yaml

package/templates/.agents/runtime/provenance.json

@@ -2,10 +2,10 @@
   "schema_version": 1,
   "statement_type": "self_reported_build_integrity",
   "authenticity": "unverified",
-  "version": "4.8.0",
+  "version": "5.0.0",
   "source_origin": "zaip-aios:local-build",
-  "lockfile_sha256": "03d08e5bbb198d74014ea4a806fcdeb350db23ec2bf0c2886a2265066555d418",
-  "sbom_sha256": "5dcd790db0a223a246bc742f6b96bb13e7f93be9495267b0f49de603f770d80f",
-  "runtime_sha256": "adb2086da9e7f21c2f9041c50a60ab5f9780e38bc7b51f7f7f3d7b00c07adddf",
-  "statement_sha256": "5b480f8fb89b356e35dd20faa6cdff0304e276856bad0049f1466d22ddb538ac"
+  "lockfile_sha256": "05e0dbb29d49d08cd3735fdd50ab01b72772e3cea476294c5ce3db1b4bbb13db",
+  "sbom_sha256": "5f723b2f41f9110ad5f40487e0591434d195b7a044c8411cd033b03ca4d59430",
+  "runtime_sha256": "e8dcc671f1db7816a764ad56112c5dfbeadac421086e6fad1cfbe5789f7a0d11",
+  "statement_sha256": "2f68e78a59993bf3214f2390e4c9149ad83a184efc4fb95b625a55ec6a369559"
 }

package/templates/.agents/runtime/sbom.cdx.json

@@ -6,7 +6,7 @@
     "component": {
       "type": "application",
       "name": "zaip-aios",
-      "version": "4.8.0"
+      "version": "5.0.0"
     }
   },
   "components": [
@@ -577,158 +577,158 @@
     {
       "type": "library",
       "name": "@img/sharp-darwin-arm64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-darwin-arm64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-darwin-arm64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-darwin-x64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-darwin-x64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-darwin-x64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-freebsd-wasm32",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-freebsd-wasm32@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-freebsd-wasm32@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-darwin-arm64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-darwin-arm64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-darwin-arm64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-darwin-x64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-darwin-x64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-darwin-x64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linux-arm",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linux-arm@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linux-arm@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linux-arm64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linux-arm64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linux-arm64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linux-ppc64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linux-ppc64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linux-ppc64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linux-riscv64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linux-riscv64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linux-riscv64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linux-s390x",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linux-s390x@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linux-s390x@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linux-x64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linux-x64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linux-x64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linuxmusl-arm64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linuxmusl-arm64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linuxmusl-arm64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-libvips-linuxmusl-x64",
-      "version": "1.3.3",
-      "purl": "pkg:npm/%40img/sharp-libvips-linuxmusl-x64@1.3.3"
+      "version": "1.3.4",
+      "purl": "pkg:npm/%40img/sharp-libvips-linuxmusl-x64@1.3.4"
     },
     {
       "type": "library",
       "name": "@img/sharp-linux-arm",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linux-arm@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linux-arm@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linux-arm64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linux-arm64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linux-arm64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linux-ppc64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linux-ppc64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linux-ppc64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linux-riscv64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linux-riscv64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linux-riscv64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linux-s390x",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linux-s390x@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linux-s390x@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linux-x64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linux-x64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linux-x64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linuxmusl-arm64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linuxmusl-arm64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linuxmusl-arm64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-linuxmusl-x64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-linuxmusl-x64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-linuxmusl-x64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-wasm32",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-wasm32@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-wasm32@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-webcontainers-wasm32",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-webcontainers-wasm32@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-webcontainers-wasm32@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-win32-arm64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-win32-arm64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-win32-arm64@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-win32-ia32",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-win32-ia32@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-win32-ia32@0.35.5"
     },
     {
       "type": "library",
       "name": "@img/sharp-win32-x64",
-      "version": "0.35.4",
-      "purl": "pkg:npm/%40img/sharp-win32-x64@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/%40img/sharp-win32-x64@0.35.5"
     },
     {
       "type": "library",
@@ -1885,20 +1885,20 @@
     {
       "type": "library",
       "name": "brace-expansion",
-      "version": "1.1.18",
-      "purl": "pkg:npm/brace-expansion@1.1.18"
+      "version": "1.1.21",
+      "purl": "pkg:npm/brace-expansion@1.1.21"
     },
     {
       "type": "library",
       "name": "brace-expansion",
-      "version": "2.1.4",
-      "purl": "pkg:npm/brace-expansion@2.1.4"
+      "version": "2.1.7",
+      "purl": "pkg:npm/brace-expansion@2.1.7"
     },
     {
       "type": "library",
       "name": "brace-expansion",
-      "version": "5.0.9",
-      "purl": "pkg:npm/brace-expansion@5.0.9"
+      "version": "5.0.12",
+      "purl": "pkg:npm/brace-expansion@5.0.12"
     },
     {
       "type": "library",
@@ -2197,8 +2197,8 @@
     {
       "type": "library",
       "name": "devalue",
-      "version": "5.9.1",
-      "purl": "pkg:npm/devalue@5.9.1"
+      "version": "5.9.3",
+      "purl": "pkg:npm/devalue@5.9.3"
     },
     {
       "type": "library",
@@ -2527,8 +2527,8 @@
     {
       "type": "library",
       "name": "hono",
-      "version": "4.13.5",
-      "purl": "pkg:npm/hono@4.13.5"
+      "version": "4.13.7",
+      "purl": "pkg:npm/hono@4.13.7"
     },
     {
       "type": "library",
@@ -3469,8 +3469,8 @@
     {
       "type": "library",
       "name": "sharp",
-      "version": "0.35.4",
-      "purl": "pkg:npm/sharp@0.35.4"
+      "version": "0.35.5",
+      "purl": "pkg:npm/sharp@0.35.5"
     },
     {
       "type": "library",
@@ -3493,14 +3493,14 @@
     {
       "type": "library",
       "name": "smol-toml",
-      "version": "1.8.0",
-      "purl": "pkg:npm/smol-toml@1.8.0"
+      "version": "1.9.0",
+      "purl": "pkg:npm/smol-toml@1.9.0"
     },
     {
       "type": "library",
       "name": "source-map-js",
-      "version": "1.2.1",
-      "purl": "pkg:npm/source-map-js@1.2.1"
+      "version": "1.2.2",
+      "purl": "pkg:npm/source-map-js@1.2.2"
     },
     {
       "type": "library",
@@ -3733,8 +3733,8 @@
     {
       "type": "library",
       "name": "undici",
-      "version": "8.10.0",
-      "purl": "pkg:npm/undici@8.10.0"
+      "version": "8.10.2",
+      "purl": "pkg:npm/undici@8.10.2"
     },
     {
       "type": "library",

package/templates/.agents/skills/zaip-skill-execution/SKILL.md

@@ -35,6 +35,8 @@ Antes de encerrar com trabalho pendente ou responder a uma falha, aplique [conti
 8. Respeite a política do plano: use `zaip verify --changed --risk <risk>` no modo `scoped`; reserve `pnpm verify` para `full`, risco critical ou gate final exigido.
 9. Em cada `run usage`, leia `budget.context_refresh_required` e `budget.checkpoint_required`. O runtime grava o checkpoint sanitizado em `.local/checkpoints/`; quando sinalizado, reconstrua contexto somente de IDs ativos, diff e findings, descarte outputs brutos antigos e continue apenas com autoridade.
 10. Falha operacional transitória recebe retry limitado; impedimento essencial deixa a Task `blocked`; falha lógica exige correção localizada ou repair/rework explícito. Antes de uma próxima correção, carregue o [ciclo de correção e bloqueio](references/correction-cycle.md). Nunca esconda uma tentativa.
+
+Recuperação de SPEC materializada com versão de pnpm defasada e Task bloqueada sob release frozen usa somente as prévias e operações atribuídas `spec revise-implementation` e `task recover-release` descritas em [recuperação controlada](references/controlled-release-recovery.md). Decision humana operacional exata, Run/turno observados, journal e refreeze são obrigatórios. O grant permite somente a retomada da Task alvo; audit/publicação continuam bloqueados até novo freeze e qualificação.
 11. Cada tentativa usa uma Run raiz do `zaip-agent-orchestrator`; subagentes e fases materialmente distintas usam Sub-Runs relacionadas por `parent_run_id`. Cada Run/Sub-Run fixa agente, modelo e effort; retry técnico preserva a configuração e qualquer mudança deliberada abre outra chamada de agente.
 12. Para delegação Codex, Sub-Run é somente subagente nativo de colaboração (`spawn_agent`). `create_thread` e `fork_thread` criam chats independentes e só podem ocorrer por pedido explícito do usuário; nunca os use como Sub-Run, fallback, retry ou prova de delegação. Se delegação nativa estiver indisponível, relate a limitação em vez de criar chat independente. Nome de catálogo, `task_name`, título ou prompt não provam ancestralidade nativa. Antes de repetir a mesma delegação limitada, aguarde ou reutilize seu filho pendente; capture somente ancestralidade/metadados observados em resultados nativos de spawn/terminal do host ou eventos SubagentStart/SubagentStop.
 13. Interaction read-only sem descendentes termina após a resposta, sem executor/finalizador. Para interaction com descendente delegado e para delivery, depois que todos os Sub-Runs de trabalho terminarem invoque `zaip-agent-finalizer` como último filho com propósito `finalization`. Não inicie novos filhos depois dele; auto-settlement nunca fecha interaction com descendente ativo. Isso também vale para `cancelled`: o orquestrador aplica a decisão Gui pela CLI; comandos diretos Task/SPEC/PRD nunca terminalizam. Ausência, interrupção ou falha do Gui deixa a Execution inconclusiva como `blocked`.
@@ -48,8 +50,8 @@ Antes de encerrar com trabalho pendente ou responder a uma falha, aplique [conti
 - Resolva o alcance completo antes de iniciar a primeira parte. Em “Task X e o restante do PRD”, se X pertence à DAG, capture o PRD e delegue suas Tasks; mantenha Gui por Task e Gui parental ao final. Se X é uma entrega avulsa fora da DAG, não finja que pertence ao PRD: este runtime não possui coordenador multi-Execution. Identifique essa limitação antes de executar, preserve entregas já concluídas e não prometa uma sequência que exija trocar a raiz capturada. Uma correção avulsa já concluída não precisa ser reaberta para retomar o PRD.
 
 - Pedido para executar um PRD/SPEC existente é continuação da entrega, não nova autoria. Resolva o ID canônico e use `conversation start --intent continue --prd ID` (ou `--spec ID` / `--task ID` no menor grão pedido); inspecione a Run retornada e reutilize sua identidade. Não use `--definition` para executar um macro já criado.
-- `conversation start --intent new-work` já materializa e inicia Task, Change, Execution e Run. Não abra outra Run raiz para o mesmo turno. Uma repetição compatível deve reutilizar a identidade; intenção, alvo, modelo ou atribuição diferentes não são uma repetição compatível.
-- Antes de iniciar Tasks ou delegar, confira `execution_kind: delivery`, atribuição ao alvo e Execution correta. Uma Run `interaction` de definição não autoriza a implementação. Não reescreva seu header, altere IDs do cliente ou retire a proteção de correlação para convertê-la.
+- `conversation start --intent new-work` já materializa e inicia Task, Change, Execution e Run. Não abra outra Run raiz para o mesmo turno. As transições tipadas admitidas são `spec execute` para a SPEC pronta cuja definição terminou com Gui e, exclusivamente para fechamento pós-publicação comprovado, `task resume-post-publication` após Task de manutenção e Gui concluídos. Cada comando vincula claim, predecessor, sucessor e hash da autorização observada; não reabre nem reescreve a Run anterior. Repetição compatível reutiliza a identidade; intenção, alvo, modelo ou atribuição diferentes não são repetição compatível. O segundo caminho não autoriza escrita de produto na Task histórica; veja `references/controlled-release-recovery.md`.
+- Antes de iniciar Tasks ou delegar, confira `execution_kind: delivery`, atribuição ao alvo e Execution correta. Uma Run `interaction` de definição não autoriza a implementação; a sucessora só existe após o handoff validado. Não reescreva o header anterior, altere IDs do cliente ou duplique telemetria sem fronteira observável.
 - Quando a CLI rejeitar uma captura incompatível, preserve o estado e os IDs existentes e explique a divergência. Não avance manualmente as entidades para `executing` nem crie outro PRD/DAG como tentativa de recuperação. A proteção de um proprietário por invocação permanece obrigatória.
 
 ## Paralelismo

package/templates/.agents/skills/zaip-skill-execution/references/controlled-release-recovery.md

@@ -0,0 +1,44 @@
+# Recuperação controlada de SPEC e release
+
+## Fechamento de publicação já avançada
+
+Quando a publicação e o avanço único de ciclo já ocorreram, mas a Task 4.9 foi bloqueada antes do fechamento, **não** use `recover-release`, não renove o grant antigo e não congele 5.0. A manutenção ativa pode preparar o recibo para a Task histórica exata. Primeiro faça a prévia e selecione os IDs das Evidence canônicas aprovadas. Registre na Change de manutenção uma Decision humana `confirmed`, categoria `contract`, cujo texto `decision` seja exatamente o JSON `authorization_payload` da prévia; a autorização original do pedido deve ser atribuída fielmente, sem inventar aprovação. A aplicação exige `--decision DEC-HUMAN-ID` e então grava uma Decision de emissão de origem `agent` com o hash do recibo e da solicitação humana observada.
+
+```text
+node .agents/runtime/bin/zaip.mjs task recover-post-publication TASK-2026-10-03-13-40-PUBLICACAO-49 --actor-task TASK-2026-10-05-00-17-REPARO-POS-PUBLICACAO-49-FMCRW5CDK3 --actor-execution EXEC-2026-10-05-00-17-DELIVERY-NEW-WORK-EFX3MNZ9WN --run RUN-2026-10-05-00-17-REPARO-POS-PUBLICACAO-49-7K4R7ZVMDM --expected-revision 28 --evidence EVD-ID --json
+node .agents/runtime/bin/zaip.mjs task recover-post-publication TASK-2026-10-03-13-40-PUBLICACAO-49 --actor-task TASK-2026-10-05-00-17-REPARO-POS-PUBLICACAO-49-FMCRW5CDK3 --actor-execution EXEC-2026-10-05-00-17-DELIVERY-NEW-WORK-EFX3MNZ9WN --run RUN-2026-10-05-00-17-REPARO-POS-PUBLICACAO-49-7K4R7ZVMDM --expected-revision 28 --evidence EVD-ID --decision DEC-HUMAN-ID --apply --json
+node .agents/runtime/bin/zaip.mjs task resume-post-publication TASK-2026-10-03-13-40-PUBLICACAO-49 --receipt .local/recovery/post-publication/RECEIPT-HASH.json --json
+```
+
+Substitua `EVD-ID` pelo ID real de cada Evidence selecionada (se houver múltiplas, separe os IDs por vírgula no mesmo `--evidence`) e `RECEIPT-HASH` pelo nome devolvido pela **aplicação**; a prévia ainda não emite recibo. O primeiro comando é somente leitura. Depois da emissão, finalize normalmente a Task de manutenção e seu Gui; só então execute `resume-post-publication` na mesma invocação humana observada ou em um novo turno autenticamente observado no mesmo thread. A CLI retoma a Execution e a SPEC originais com a Task bloqueada como único alvo. Ela revalida revisões, Decision humana e de emissão, ausência de proprietário, SHA candidato, cada commit até o SHA publicado, Evidence/Validation e observação canônica, CI push em main, Release/tag/asset, npm version/latest/SRI e bytes do tarball, Actions de publicação, origin e hash exato do ciclo. Escrita de produto pela Task histórica continua vedada; complete apenas metadados de fechamento, Evidence, revisão independente quando aplicável e o Gui novo, sem apagar os registros históricos.
+
+Para rollback operacional antes do consumo, deixe o recibo não consumido e a Task histórica bloqueada; a manutenção pode ser bloqueada pelo fluxo normal, sem reabrir o ciclo. Após falha parcial, repita o mesmo comando e recibo; um claim de turno ou raiz já persistida só pode ser reutilizado para o alvo idêntico. Se qualquer prova, revisão, proprietário ou conteúdo mudou, a CLI bloqueia e exige nova investigação em vez de reescrever autorização. O caminho de exceção do hook permite somente o comando literal de consumo; os demais comandos e escrita direta continuam sob a correlação normal de Task/Run. No repositório mantenedor, `node scripts/qualification/v49-post-publication.mjs test` roda a qualificação focal; `mutation --isolated` verifica mutantes e restaura os bytes originais.
+
+## Grant pendente após interrupção
+
+Quando uma Task já retomou, mudou de revisão e voltou a ficar bloqueada antes do refreeze, use `task recover-release TASK --renew-grant --actor-execution EXEC --run RUN --expected-revision N --json`. A prévia exige o mesmo alvo Task/SPEC/Execution/release, um novo responsável observado e o responsável anterior terminal. A aplicação mantém a Decision humana exata, acrescentando `--decision DEC-HUMAN-ID --apply`; o payload inclui o hash do grant anterior e o estado atual. A CLI não altera a revisão da Task para acomodar o grant.
+
+O journal preserva o grant anterior e o novo. Replay da operação antiga não renova autorização. Revisões concorrentes, outro alvo ou proprietário ativo continuam recusados. `--renew-grant` não libera outras Tasks nem dispensa `task workspace`, refreeze, qualificação ou finalizador. A operação pública de renovação aceita a raiz de interaction sem Task já suportada pelo fluxo de recuperação; portanto não exige criar outra Task para corrigir um grant pendente.
+
+## Leitura de conteúdo externo no PreToolUse
+
+O hook permite leitura literal de arquivos textuais autorizados em `.agents/config/external-read-policy.json`, com schema `{ "schema_version": 1, "files": ["CAMINHO_ABSOLUTO_DO_ARQUIVO"] }`. Essa configuração é local, não acompanha o pacote e só deve registrar arquivos autorizados pelo usuário. Uma pasta de anexos não concede autorização automática a todos os arquivos nela.
+
+As permissões se aplicam a `Get-Content` e `rg` nas formas delimitadas pelo hook. O caminho real deve corresponder ao autorizado; arquivo vizinho, link divergente, execução e escrita não herdam a permissão. Leituras de memórias, skills e cache de plugins já previstas permanecem no contrato anterior. Alterar a configuração é mutação de produto sujeita à autorização de escrita; não é uma lista livremente modificável por conteúdo externo.
+
+Esta operação pública resolve um snapshot de pnpm desatualizado numa SPEC já materializada e prepara a retomada de uma Task bloqueada na release corrente. A revisão de implementação é **limitada a `pnpm` em `package.json`**: altera apenas sua versão exata e a menção correspondente em `stack_description`. IDs, DAG, plano, demais componentes, fontes, status e histórico permanecem preservados. Não é uma API genérica de migração de stack.
+
+O ator pode ser a Run raiz ativa de uma Task de manutenção em execução (`--actor-task`) ou uma Run raiz de interaction ativa sem Task. Ambos passam `--actor-execution` e `--run`; a CLI compara a sessão e o turno observados com a Run, além da ancestralidade e da Execution. A Task alvo deve estar `blocked`, sem Run proprietária ativa, com predecessoras concluídas. A Decision operacional precisa ser humana, confirmada, vinculada à Change de manutenção ou à Execution da interaction, categoria `contract`, e conter exatamente o JSON `authorization_payload` da prévia. Uma Decision narrativa de escopo geral não substitui esse vínculo.
+
+```text
+zaip spec revise-implementation SPEC-ID --target-task TASK-ID --actor-task TASK-MANUT --actor-execution EXEC-MANUT --run RUN-MANUT --expected-revision N --implementation .local/proposal.json --json
+zaip spec revise-implementation SPEC-ID --target-task TASK-ID --actor-task TASK-MANUT --actor-execution EXEC-MANUT --run RUN-MANUT --expected-revision N --implementation .local/proposal.json --decision DEC-HUMAN-ID --apply --json
+zaip task recover-release TASK-ID --actor-task TASK-MANUT --actor-execution EXEC-MANUT --run RUN-MANUT --expected-revision N --json
+zaip task recover-release TASK-ID --actor-task TASK-MANUT --actor-execution EXEC-MANUT --run RUN-MANUT --expected-revision N --decision DEC-HUMAN-ID --apply --json
+```
+
+No caminho sem Task de manutenção, omita `--actor-task` e use a Execution da interaction em `--actor-execution`. Faça prévia de cada ação, registre uma Decision operacional distinta com o payload exato e só então aplique. O journal limitado em `.local/recovery/` conserva hashes e textos antes/depois, ator e Decision. Repetir a mesma aplicação devolve o resultado já aplicado; se a escrita interrompeu após o journal, a mesma chamada retoma apenas se o conteúdo original e a Run ativa ainda corresponderem. Conteúdo independente divergente bloqueia replay.
+
+`recover-release` muda `frozen` para `open` com um grant que admite apenas `task resume` da Task/SPEC/Execution autorizadas. A Task continua bloqueada até sua retomada pública sob proprietário legítimo. Outras Tasks não podem iniciar enquanto o grant existir. O refreeze consome o grant somente pela mesma Task de coordenação delegada da SPEC, validada pela política de release existente; o audit e o advance recusam grant pendente. O novo candidato precisa ser qualificado e revisado no SHA final depois desse refreeze. Nenhuma prova histórica é aprovada retroativamente.
+
+No repositório mantenedor, em candidato isolado com Node 24 e pnpm offline disponível, `node scripts/qualification/v49-recovery.mjs test` executa testes focais e typechecks. O gate geral de source-size segue separado. `node scripts/qualification/v49-recovery.mjs mutation --isolated` executa mutantes de autorização, grant, preflight e audit, restaurando os bytes originais no `finally` e verificando seus hashes. Esse harness pertence exclusivamente ao repositório mantenedor; não está disponível no pacote nem no template público.

package/templates/.agents/skills/zaip-skill-execution/references/runtime-governance.md

@@ -5,7 +5,7 @@ Carregue antes de executar uma entrega ou delegar. Este contrato detalha o kerne
 - `RULE-CORE` e `RULE-WORKFLOW`, já carregadas antes desta referência, são a fonte para configuração, autoridade externa, captura, PRD/SPEC/Task lifecycle, Git-only/deploy, perguntas, verbos, credenciais e plano visível. Aplique-as integralmente; esta referência só acrescenta a governança de execução e delegação abaixo.
 - Em modo manual carregue `RULE-MODEL-ORCHESTRATION` antes da primeira resposta visível; aviso não bloqueia nem altera seleção. Com Codex/delegação use apenas `codex_name` do catálogo, formato `zaip-agent-NOME`, recursivamente; proíba `default`, `worker`, `explorer` e tipos ad-hoc.
 - Para delegação Codex, Sub-Run ZAIP é somente subagente nativo de colaboração (`spawn_agent`). `create_thread` e `fork_thread` criam chats independentes e exigem pedido explícito do usuário; nunca são Sub-Run, fallback, retry ou prova de delegação. Se delegação nativa estiver indisponível, relate a limitação em vez de criar chat independente. Nome de catálogo, `task_name`, título ou prompt não prova ancestralidade nativa. Antes de repetir a mesma delegação limitada, aguarde ou reutilize seu filho pendente e capture somente ancestralidade/metadados observados em resultados nativos de spawn/terminal do host ou eventos SubagentStart/SubagentStop.
-- Cada `client_turn_id` observável tem uma Execution idempotente/claim atômico; sem ele use identidade local sem prometer idempotência. `interaction` read-only sem descendentes é conversa sem Task artificial e termina após a resposta entregue, sem executor ou finalizador; interaction com trabalho delegado e `delivery` exigem executor/finalizador. `delivery` é trabalho materializado e reuso exige kind/origem compatíveis. A raiz é `zaip-agent-orchestrator`; quando a barreira é exigida escolha executor por capacidade, permita reviewer/auditor/integrator e termine com `zaip-agent-finalizer` em `finalization`, após descendentes, bloqueando novas chamadas.
+- Cada `client_turn_id` observável tem por padrão uma Execution idempotente/claim atômico; sem ele use identidade local sem prometer idempotência. A exceção versionada de `spec execute` permite uma Execution delivery sucessiva à interaction de definição no mesmo turno físico somente após definição terminal+Gui, SPEC pronta e autorização explícita observada para o alvo exato. A exceção tipada de `task resume-post-publication` permite a sucessora da SPEC histórica após a raiz delivery de manutenção terminar com Gui, com recibo canônico emitido antes do encerramento e publicação/ciclo revalidados; em novo turno observado, o claim vincula o mesmo recibo ao sucessor sem duplicar a raiz anterior. O claim vincula as Executions e Runs, preserva a anterior e impede dois proprietários ativos; não fabrica novo turno ou child. `interaction` read-only sem descendentes é conversa sem Task artificial e termina após a resposta entregue, sem executor ou finalizador; interaction com trabalho delegado e `delivery` exigem executor/finalizador. `delivery` é trabalho materializado e reuso exige kind/origem compatíveis. A raiz é `zaip-agent-orchestrator`; quando a barreira é exigida escolha executor por capacidade, permita reviewer/auditor/integrator e termine com `zaip-agent-finalizer` em `finalization`, após descendentes, bloqueando novas chamadas.
 - Hooks são best-effort: após cada spawn/terminal, o host autorizado a serviço do orquestrador executa `zaip subagent capture` idempotente com metadados reais. Na captura rica, preserve session/turn observados, `agent-id` com a identidade nativa retornada e `parent-agent-id`/`parent-run-id` do pai imediato exato; cada invocação preserva seu turn. Quando um evento terminal observado expõe somente agent_path, status, identidade catalogada e pai exato, `capture-terminal` aceita apenas `zaip-agent-finalizer` ou executor elegível para delivery com capacidade `task-delivery`; exige também `parent-run-id` igual ao `run_id` da raiz ativa exata, pois um client thread pode conter raízes concorrentes. O último segmento do agent_path deve ser seu `codex_task_name` canônico. O propósito deriva da identidade validada e session/turn/model/provider/usage permanecem indisponíveis; o fallback nunca substitui captura rica nem inventa modelo, effort, tokens ou custo.
 - Antes da primeira edição do executor nativo, capture seu início observado. Na captura manual de executor cujo pai é orquestrador de Task delegado por uma SPEC, `--session` continua sendo o UUID físico da raiz macro; informe também `--native-session CHILD_UUID` com o UUID do filho observado no retorno do spawn. O PreToolUse pode receber a sessão do pai junto com o turno do filho: a CLI grava correlações locais exatas para esse formato e para a sessão nativa do filho, somente após verificar ancestralidade, modelo/effort, Task e Execution ativos. A autorização de patch fica limitada aos write scopes da Task; reviewers, identidades desconhecidas, outro turno e Runs terminais não recebem essa capacidade. Não copie nem fabrique recibos. Ao reutilizar um subagente, capture seu novo turno ativo; o recibo anterior não autoriza a retomada.
 - Em `autonomy-v1`, carregue `RULE-AUTONOMY-DECISION`. Conversation sem entrega responde diretamente; Task avulsa no padrão `codex_native` usa executor e Gui nativos. O principal preserva a seleção manual do host; cada filho segue a seleção ZAIP por papel/risco/fase, registrada conforme o modelo/esforço efetivamente observados. Capacidade ausente bloqueia a tentativa, nunca é substituída por prompt. Sem `autonomy`, preserve o contrato legado de `automatic_sources` (`spec`,`prd`).

package/templates/.agents/skills/zaip-skill-github-deploy/SKILL.md

@@ -45,6 +45,8 @@ Commit subjects retain `[CODEX|CLAUDE] [P:XXXX] [S:XXXX] [T:XXXX] <Task title>`
 
 Dense source/template/package/TGZ gates belong to builder release qualification. Generic commits use targeted validation, without an automatic full suite, test-count cap or Task wallclock limit. Apply the frozen autonomy profile: balanced permits 10 executions total and 3 replans; tests/tool calls are not executions and resumption does not reset the budget. Do not add an independent five-cycle limit.
 
+For post-receipt rapid reuse in the verified builder, follow `docs/quality/v49-deploy-cache-controls.md`: the host reviews and promotes each group proof and its index before a later candidate; a failed result must become a tombstone before retry, never an older PASS hit.
+
 ## Verify and report
 
 Compare the exact pushed SHA with the configured remote ref. If a push result is uncertain, read remote state before retrying. Observe required checks for that SHA, inspect failed steps and repair their evidenced cause within the frozen profile; do not repeat unchanged failures or bypass a gate.
@@ -59,4 +61,8 @@ For the verified framework builder, release delivery requires `.agents/config/re
 
 When the same authorized direct Task root implements the product repair and release, the explicit integrated coordinator mode in `$zaip-skill-release-qualification` can freeze while that Task and Run are active. It keeps the clean exact-SHA, only-main, no-other-work, independent validation and publication gates. Record this selection in the frozen cycle; it does not create a second Task or client turn.
 
-After a published release, use `node scripts/release-cycle-gate.mjs advance --repository ROOT --from N.N --to NEXT --sha CANDIDATE --ci-run-id RUN_ID` while the release coordinator remains active. This checks remote main, tag, published Release, exact successful CI, local branch/worktree cleanup and owner lineage before recording the transition. Bind Evidence to that immutable candidate, close Task and SPEC, then make one metadata-only closure commit. `node scripts/local-release-deploy.mjs push-closure --repository ROOT --expected-repository zaip-ai/zaip-aios --branch main --version N.N --published-sha CANDIDATE --closure-sha CLOSURE --expected-remote-sha CANDIDATE --metadata-paths-file REVIEWED_JSON` verifies tag, public Release, npm, the candidate's recorded exact CI run, one descendant metadata commit, exact remote main and only-main before pushing; it waits for CI on the closure SHA. The reviewed JSON is an array of exact changed metadata paths, including causal telemetry when present. `--metadata-paths EXACT,PATHS` is available for a short list. Do not retag or treat local lifecycle closure as remotely published. It does not prove provider deployment. Future drafts can remain in `draft`; executable future work cannot.
+After a published release, use `node scripts/release-cycle-gate.mjs advance --repository ROOT --from N.N --to NEXT --sha CANDIDATE --ci-run-id RUN_ID` while the release coordinator remains active. This checks remote main, tag, published Release, exact successful CI, local branch/worktree cleanup and owner lineage before recording the transition. Bind Evidence to that immutable candidate, close Task and SPEC, then make one metadata-only closure commit. `node scripts/local-release-deploy.mjs push-closure --repository ROOT --expected-repository zaip-ai/zaip-aios --branch main --version N.N --published-sha CANDIDATE --closure-sha CLOSURE --expected-remote-sha CANDIDATE --metadata-paths-file REVIEWED_JSON --receipt RECEIPT --tarball TGZ --policy POLICY --trust-store TRUST --notes-file NOTES --output-dir CANDIDATE_DIR` verifies tag, public Release, npm, the candidate's recorded exact CI run, one descendant metadata commit, exact remote main and only-main before pushing; it waits for CI on the closure SHA. The reviewed JSON is an array of exact changed metadata paths, including causal telemetry when present. `--metadata-paths EXACT,PATHS` is available for a short list. Do not retag or treat local lifecycle closure as remotely published. It does not prove provider deployment. Future drafts can remain in `draft`; executable future work cannot.
+
+The closure helper also revalidates the signed receipt against the immutable published Git tree, exact four Release assets/body/latest and TGZ SHA-512 against npm integrity/latest. If remote main already equals the reviewed closure, retry waits for its exact CI without pushing again. Checkpoints preserve observed identity, never replace external verification, and never extend receipt expiry.
+
+For a final SPEC Task that also implements product changes, the explicit `--integrated-spec-task` mode follows the [release qualification contract](../zaip-skill-release-qualification/SKILL.md). Validate coordinator eligibility before expensive qualification; ordinary release-only and direct `--integrated-task` routes retain their separate restrictions.

package/templates/.agents/skills/zaip-skill-github-deploy/references/release-gate-matrix.md

@@ -1,24 +1,19 @@
 # Release gate retention matrix
 
-| Gate | Qualification location | Publication cost |
+| Gate | When it runs | Evidence boundary |
 |---|---|---|
-| Architecture, CQRS, modules, profile, skills, tools, encoding, source size, lint, types and contracts | `prepare-and-qualify`: `validate:github:prepared` | None; reuse successful run for the same SHA |
-| Dashboard and Design workspace unit tests | `validate:github:prepared`, separately from package coverage | None |
-| `packages/**` unit coverage and ratchet | `create-coverage-qualification.mjs`, once | None |
-| Public CLI units, integration and installer profiles | `test:qualification:prepared` | None |
-| Release cleanroom, rollback, supply chain and client contracts | `test:release-e2e:prepared` and source validation | None |
-| Production dependency audit | `pnpm audit --prod --audit-level high` | None |
-| Dashboard and Design browser checks | Dashboard E2E workspace | None |
-| Linux, Windows and macOS Node 22; Linux Node 24 | `exact-tgz-smoke`, SHA-256 checked TGZ, install and doctor | None |
-| Literal consumer record identity through SQLite, API and UI | `consumer-identity --tarball` with the same TGZ | None |
-| Package build, template sync and pack | Prepared once before artifact fan-out | No build or pack |
-| Repository, workflow, SHA, latest run attempt, policy, expiration and artifact digests | Receipt created after all gates; GitHub API checked again by publisher | Small verification steps |
-| GitHub release tag and npm registry integrity | `publish-cli.yml` | Required publication checks plus exact registry-version smoke |
+| Focused code, type, contract and security regressions; applicable mutation and independent review | Per changed Task on its exact candidate SHA | Reuse only while SHA, scope, risk and impact remain valid |
+| Final `essential-v3` source, package, installer, upgrade, rollback, audit and consumer qualification | Once in the isolated local checkout of the final release SHA | A failed gate emits no signed success receipt; repair creates a new candidate |
+| Full source suite, browser navigation and XLSX coverage | Only when explicit impact/profile requires `full-v2` | Never infer a pass from an unrun optional gate |
+| Signed receipt, profile, repository/SHA, manifest, SBOM and TGZ digest | Local preparation; reverified before each delivery transition | The same file and digest must reach the Release and publisher |
+| Pushed `main` checkout, previous-main ancestry, workflow integrity and commit policy | `pre-main-candidate.yml` on push to `main` | Exact successful workflow run on the pushed SHA; no future Release asset is needed |
+| Release asset signature/policy/expiration, SHA, TGZ/SBOM digest and bounded Linux install/doctor smoke | `publish-cli.yml` after the draft Release exists | Publish the same checked TGZ; no rebuild, repack or repeat of the local source suite |
+| Registry version, integrity and channel | Publisher after npm publication | Observe the registry result separately from local qualification and GitHub Release |
 
-`qualify-cli.yml` starts automatically on pushes to the configured validation or human-promoted production branch. A manual dispatch requires that branch head to equal the input SHA. A changed SHA requires a new qualification. Workflow run IDs and attempts identify evidence; a local receipt alone is never authority.
-
-Publication uses an unexpired successful qualification (maximum seven days). It downloads the qualified artifact; it never invokes `release:artifacts`, `npm pack`, coverage, browser qualification or a broad agent review. Missing, altered, expired or failed qualification blocks publication.
-
-A GitHub prerelease publishes to `beta`; a production Release after human promotion publishes to `latest`. Only the framework release workflow publishes npm. Consumer installations receive the single GitHub skill and its GitHub-only setup helpers.
-
-Measure qualification and publication separately in GitHub Actions after rollout. No wall-clock improvement is claimed from local tests alone.
+The local candidate gate runs lint, types, commit policy and impact-selected regressions
+before `main` moves. The push-triggered main job checks its own checkout and workflow
+state without rerunning that local suite or installing Chromium unconditionally. The
+publisher rechecks the signed artifact because custody changes at the Release boundary.
+Any changed SHA, receipt, profile or artifact digest requires requalification; a successful
+main job alone never authorizes publication. An unavailable branch-protection setting
+is reported as unavailable, not inferred from signing or a green workflow.

package/templates/.agents/skills/zaip-skill-github-deploy/scripts/deploy-contract.mjs

@@ -77,6 +77,18 @@ export function requestedDeployment(request) {
     "A bounded current human request is required",
   );
   const text = normalize(request);
+  const resumedSpecPublication =
+    /^pode retomar a execucao da spec ate finalizar todas as tasks e fazer publicacao deploy da v((?:0|[1-9]\d*)\.(?:0|[1-9]\d*))(?: com release(?: e npm publicado)?)?$/.exec(
+      text,
+    );
+  if (resumedSpecPublication)
+    return {
+      authorized: true,
+      override: "release",
+      version: resumedSpecPublication[1],
+      phase: "publish",
+      scope: "current-work",
+    };
   // Only a direct publication imperative is executable. References, questions and quoted
   // historical instructions are not authority; unknown wording never upgrades the mode.
   const withoutCourtesy = text.replace(/^(?:(?:ok|por favor|agora|please)[, ]+)+/, "");
@@ -93,6 +105,27 @@ export function requestedDeployment(request) {
     /^(?:ativei\s+(?:o\s+hook|os\s+hooks)[, ]+)?(?:faca|realize|execute)\s+(?:as\s+validacoes\s+finais(?:\s+e\s+os\s+ajustes\s+necessarios)?|os\s+ajustes\s+necessarios)\s+(?:pra|para)\s+publicar\s+(?:a\s+)?v\d+\.\d+\b/.test(
       withoutCourtesy,
     );
+  const unit = "zero|um|uma|dois|duas|tres|quatro|cinco|seis|sete|oito|nove";
+  const shortPublication = new RegExp(
+    `^(?:boa, boa\\.\\s*)?(?:eu\\s+)?quero publicar\\s+(?:(?:a\\s+)?versao\\s+)?(?:v?((?:0|[1-9]\\d*)\\.(?:0|[1-9]\\d*))|(${unit})\\s+ponto\\s+(${unit}))(?:,?\\s+sim)?\\.?$`,
+  ).exec(withoutCourtesy);
+  const unitValue = {
+    zero: "0",
+    um: "1",
+    uma: "1",
+    dois: "2",
+    duas: "2",
+    tres: "3",
+    quatro: "4",
+    cinco: "5",
+    seis: "6",
+    sete: "7",
+    oito: "8",
+    nove: "9",
+  };
+  const shortPublicationVersion = shortPublication
+    ? (shortPublication[1] ?? `${unitValue[shortPublication[2]]}.${unitValue[shortPublication[3]]}`)
+    : null;
   const waitsForAuthorization =
     /\b(?:quando|se|apos|depois)\b[^?]*\b(?:autorizar|aprovar|confirmar|autorizacao|aprovacao|confirmacao)\b/.test(
       text,
@@ -104,7 +137,8 @@ export function requestedDeployment(request) {
     sequencedDirect ||
     releaseDirective ||
     proceedToVersion ||
-    finalAdjustmentsToPublish;
+    finalAdjustmentsToPublish ||
+    shortPublicationVersion !== null;
   if (!direct || /\?/.test(text) || waitsForAuthorization)
     return { authorized: false, reason: "not-a-direct-deployment-request" };
   const noRelease =
@@ -121,7 +155,8 @@ export function requestedDeployment(request) {
     ).test(text) ||
     /^release\b/.test(withoutCourtesy) ||
     releaseDirective ||
-    proceedToVersion;
+    proceedToVersion ||
+    shortPublicationVersion !== null;
   const nonPublication = text.replace(
     /\bnao\s+(?:publique|publicar)\s+(?:(?:um|uma|o|a|novo|nova)\s+)*release\b/g,
     "",
@@ -142,6 +177,7 @@ export function requestedDeployment(request) {
   );
   if (releaseDirective)
     versions.push(/\bpreciso que crie (?:uma |a )?nova versao\s+v?(\d+\.\d+)\b/.exec(text)[1]);
+  if (shortPublicationVersion !== null) versions.push(shortPublicationVersion);
   assert(new Set(versions).size <= 1, "Conflicting explicit release versions");
   return {
     authorized: true,