@zaip-ai/cli 4.7.0 → 4.9.0

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

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-ef3193df6d68bc7ef70fda62056eba15f0ef668fc9c21b487ae7fd56a562bfd6  VERSION
-8732989380e59d4890a8ccd7a27e6b974e28af5bfe5d65c9ddd21bbdbd4f485b  bin/zaip.mjs
-c6f46b86e46b2c14fcdc49ea2b8b1cf1f816f25c22bc9246f8b4a85c9a871120  manifest.json
+b9c635e14ee1fd055bbf8779b20efb85b5eff17d66df342c4735683297373176  VERSION
+825a4900d32a38c686a1affd449f213eb745628e13059095d69bc076cc55aea8  bin/zaip.mjs
+5cd860165138336d4fdf2da60d1c282d75ddcbea3ff8b6774ee8e319142e4d23  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
-33c98d5dc506bba4b8b3ca612706d9eb05ef13d9e03c33a4f9e65ca7804be9d1  pnpm-lock.sha256
-3c589ae6cf792da2d5045fd63260fea252f79a7844eab680c474f1b9a6363832  provenance.json
-7b566eefe84980f4cc7b88a0c504f2286fb8968e916fb212f8a7ef3ec1267a47  sbom.cdx.json
+31194079d919ebf882b75cde4de4cd444347e0a051a81602affac0822dbf4c7c  pnpm-lock.sha256
+a7f6f1a4965c4233969ccb664e91373f5630db915bcc3244dab27dc445fb8bfd  provenance.json
+1e00d2087311d109edea35e1dfbd315d731e1e671c6bd5798211a4ade0a25f52  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.7.0",
+  "version": "4.9.0",
   "node": ">=22",
   "files": [
     "LICENSE",

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

@@ -1 +1 @@
-03d08e5bbb198d74014ea4a806fcdeb350db23ec2bf0c2886a2265066555d418  pnpm-lock.yaml
+74609eb6b1aa005a6924bb2785e313c76e6459983687560ba08b6eff8b184721  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.7.0",
+  "version": "4.9.0",
   "source_origin": "zaip-aios:local-build",
-  "lockfile_sha256": "03d08e5bbb198d74014ea4a806fcdeb350db23ec2bf0c2886a2265066555d418",
-  "sbom_sha256": "7b566eefe84980f4cc7b88a0c504f2286fb8968e916fb212f8a7ef3ec1267a47",
-  "runtime_sha256": "0849009f992e81c5c878dcd496628525f41e929c11c578ea1f0c4af1e7a6638e",
-  "statement_sha256": "50e637a687d5bc3386c2eafbb6571e035550ebf027c8b9c001bcab3e74ab1e41"
+  "lockfile_sha256": "74609eb6b1aa005a6924bb2785e313c76e6459983687560ba08b6eff8b184721",
+  "sbom_sha256": "1e00d2087311d109edea35e1dfbd315d731e1e671c6bd5798211a4ade0a25f52",
+  "runtime_sha256": "ce179d284aea950e6ba2f0bdfcfb1464194c0a808b82a044f5e89c2b72e96b06",
+  "statement_sha256": "44d1925ba9300d711c60d5b10e6f2045bbb2f9d26c5a3a2e19948c10645f6eac"
 }

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

@@ -6,7 +6,7 @@
     "component": {
       "type": "application",
       "name": "zaip-aios",
-      "version": "4.7.0"
+      "version": "4.9.0"
     }
   },
   "components": [
@@ -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",
@@ -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. A única transição de segmento admitida é `spec execute` para a SPEC pronta cuja definição no mesmo turno físico terminou com Gui e recebeu autorização explícita observada para aquele alvo. O comando vincula claim, predecessor, sucessor e hash da autorização; 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.
+- 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,30 @@
+# Recuperação controlada de SPEC e release
+
+## 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. O claim vincula as duas 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.

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

@@ -89,14 +89,45 @@ export function requestedDeployment(request) {
   );
   const proceedToVersion =
     /^(?:pode\s+)?(?:seguir|continue|avancar)\s+para\s+(?:a\s+)?v\d+\.\d+\b/.test(withoutCourtesy);
+  const finalAdjustmentsToPublish =
+    /^(?: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,
+    );
   const direct =
     /^(?:(?:pode|podemos)\s+)?(?:(?:faca|fazer|faz|realize|execute|do)\s+)?(?:deploy|dpeloy|depoly|push|commit|publique|publicar|publish|envie|release|prepare|preparar)\b/.test(
       withoutCourtesy,
     ) ||
     sequencedDirect ||
     releaseDirective ||
-    proceedToVersion;
-  if (!direct || /\?/.test(text))
+    proceedToVersion ||
+    finalAdjustmentsToPublish ||
+    shortPublicationVersion !== null;
+  if (!direct || /\?/.test(text) || waitsForAuthorization)
     return { authorized: false, reason: "not-a-direct-deployment-request" };
   const noRelease =
     /\b(?:sem|nao)\s+(?:(?:quero|criar|fazer|publicar|publique|crie|faca)\s+)?(?:(?:um|uma|o|a|novo|nova)\s+)*(?:release|nova versao|proxima versao|versao)\b/.test(
@@ -112,7 +143,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,
     "",
@@ -133,6 +165,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,

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

@@ -101,6 +101,54 @@ test("discussion, quoted history, negation and questions never authorize publica
   assert.equal(resolveDeployment(input("pode seguir para v4.7", builder)).version, "4.7");
   assert.equal(resolveDeployment(input("pode seguir para v4.7?", builder)).mode, "none");
 });
+
+test("final adjustments with an explicit publication goal preserve the actual human request", () => {
+  for (const request of [
+    "ativei o hook faça as validações finais e os ajustes necessários pra publicar v4.8",
+    "faça os ajustes necessários para publicar v4.8",
+  ]) {
+    const plan = resolveDeployment(input(request, builder));
+    assert.equal(plan.mode, "release");
+    assert.equal(plan.phase, "publish");
+    assert.equal(plan.version, "4.8");
+  }
+  for (const request of [
+    "explique os ajustes necessários para publicar v4.8",
+    "não faça os ajustes necessários para publicar v4.8",
+    "faça os ajustes necessários para publicar v4.8?",
+    "faça os ajustes necessários para publicar v4.8 quando eu autorizar",
+    "o usuário disse 'faça os ajustes necessários para publicar v4.8'",
+  ]) {
+    assert.equal(resolveDeployment(input(request, builder)).mode, "none", request);
+  }
+  const prepare = resolveDeployment(
+    input("faça os ajustes necessários para publicar v4.8, mas não publique ainda", builder),
+  );
+  assert.equal(prepare.phase, "prepare");
+  assert.equal(prepare.npm_publication, false);
+});
+test("short positive publication statements bind their stated version without promoting questions or conditions", () => {
+  const request = "Boa, boa. Eu quero publicar quatro ponto nove, sim";
+  for (const [utterance, version] of [
+    [request, "4.9"],
+    ["Eu quero publicar quatro ponto oito, sim", "4.8"],
+    ["Quero publicar a versão v5.0", "5.0"],
+  ]) {
+    const plan = resolveDeployment(input(utterance, builder));
+    assert.equal(plan.mode, "release", utterance);
+    assert.equal(plan.phase, "publish", utterance);
+    assert.equal(plan.scope, "current-work", utterance);
+    assert.equal(plan.version, version, utterance);
+  }
+  for (const unsafe of [
+    `${request}?`,
+    "Boa, boa. Eu não quero publicar quatro ponto nove, sim",
+    `Se estiver pronto, ${request}`,
+    `O usuário disse '${request}'`,
+    "Eu quero publicar quatro ponto nove se vocês aprovarem",
+  ])
+    assert.equal(resolveDeployment(input(unsafe, builder)).mode, "none", unsafe);
+});
 test("preferences are project-owned; one-shot overrides, scope and invalid config are explicit", () => {
   const preference = { ...DEFAULT_POLICY, default_mode: "release" };
   assert.equal(resolveDeployment(input("faça deploy", consumer, preference)).mode, "release");
@@ -194,19 +242,21 @@ test("commits route checks before push, sends the exact SHA and never creates re
   assert.equal((await guardedCommits({ ...value, dryRun: true }, operations)).pushed, false);
   assert.ok(!events.includes("preflight"));
 });
-test("critical builder commit qualifies locally and waits for exact main CI", async () => {
+test("critical builder commit uses portable injected gates and fails closed if either is missing", async (t) => {
+  const root = await mkdtemp(join(tmpdir(), "zaip-critical-portable-"));
+  t.after(() => rm(root, { recursive: true, force: true }));
   const current = input("faça deploy apenas commits", builder);
   const sha = "a".repeat(40);
   const events = [];
   const value = {
-    repository: process.cwd(),
+    repository: root,
     request: current.request,
     plan: resolveDeployment(current),
     sha,
     branch: "main",
     checks: [{ command: "node", args: ["--test", "fixture.test.mjs"] }],
   };
-  await guardedCommits(value, {
+  const operations = {
     readInput: async () => current,
     identity: () => {},
     branchFor: async () => "main",
@@ -217,8 +267,17 @@ test("critical builder commit qualifies locally and waits for exact main CI", as
     push: async () => events.push("main"),
     remoteSha: async () => sha,
     verifyMainCi: async () => events.push("main-ci"),
-  });
+  };
+  await guardedCommits(value, operations);
   assert.deepEqual(events, ["checks", "preflight", "qualify", "main", "main-ci"]);
+  for (const missing of ["qualifyPreMain", "verifyMainCi"]) {
+    events.length = 0;
+    await assert.rejects(
+      guardedCommits(value, { ...operations, [missing]: undefined }),
+      /remote-candidate-gate\.mjs/,
+    );
+    assert.ok(!events.includes("main"), `${missing} must fail before push`);
+  }
 });
 test("critical Task in an earlier candidate commit requires candidate-bound proof", async (t) => {
   const root = await mkdtemp(join(tmpdir(), "zaip-critical-range-"));

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

@@ -67,10 +67,7 @@ test("deploy guidance preserves canonical Task identity and builder-versus-consu
     skill,
     /verified builder means Release plus npm through Actions; a consumer means commits plus push/,
   );
-  assert.match(
-    workflow,
-    /Preserve trabalho\/index concorrentes e causalidade de todos os commits publicados/,
-  );
+  assert.match(workflow, /Preserve trabalho, index, causalidade, SHA, integridade e autorização/);
 });
 
 test("framework deploy follows Release-triggered npm publication without claiming partial success", async () => {
@@ -124,10 +121,15 @@ test("deploy permission and reconciliation remain explicit and recoverable", asy
 });
 
 test("workflow retains the explicit publication routing contract", async () => {
-  const workflow = await readFile(resolve(root, "rules", "workflow.md"), "utf8");
+  const [workflow, core, skill] = await Promise.all([
+    readFile(resolve(root, "rules", "workflow.md"), "utf8"),
+    readFile(resolve(root, "rules", "core.md"), "utf8"),
+    readFile(resolve(skillRoot, "SKILL.md"), "utf8"),
+  ]);
   assert.match(workflow, /\$zaip-skill-github-deploy/);
   assert.match(workflow, /deploy-policy\.json/);
-  assert.match(workflow, /current-work/);
+  assert.match(core, /Escopo `current-work`/);
+  assert.match(skill, /Default scope is `current-work`/);
 });
 
 test("release guidance requires reviewed categorized notes and published-body readback", async () => {

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

@@ -134,9 +134,11 @@ export async function guardedCommits(input, operations = {}) {
       input.sha,
       input.remote ?? "origin",
     ));
-  const candidateGate = critical
-    ? await import(pathToFileURL(resolve(root, "scripts/remote-candidate-gate.mjs")).href)
-    : null;
+  // Portable callers can supply both gates; otherwise load the real gate before push.
+  const candidateGate =
+    critical && (!operations.qualifyPreMain || !operations.verifyMainCi)
+      ? await import(pathToFileURL(resolve(root, "scripts/remote-candidate-gate.mjs")).href)
+      : null;
   if (critical) {
     await (operations.qualifyPreMain ?? candidateGate.qualifyLocalCandidate)({
       repository: root,

package/templates/.agents/skills/zaip-skill-lifecycle-closure/SKILL.md

@@ -42,6 +42,13 @@ the supplied ID and canonical record; never scan ordinary history to guess a tar
    while the responsible root is active. A finalizer stop may close that root, so do not
    send it an unfinished framework lock, failed local check, or outdated SHA evidence.
    Rebind validation and independent review after each candidate-changing commit.
+10. For a confirmed residual Git `index.lock`, use the official `git-lock recover --task TASK
+    --run RUN --decision DEC-HUMAN-ID --json` command before claiming a Task workspace.
+    The Decision must explicitly authorize this lock recovery. The command verifies the real
+    Git dir (including linked worktrees), a regular empty lock older than ten minutes,
+    no active Git process or operation marker, and a stable second stat; it moves the lock
+    to a verified backup. An inconclusive check refuses recovery. Preserve that backup
+    and report its path; use the existing Task workspace flow afterwards.
 
 Use `$zaip-skill-reconcile-telemetry` only for missing observed usage after lifecycle
 identity is correct; it is not a substitute for closure.

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

@@ -5,6 +5,12 @@ description: Create, refine, prepare, or analyze a ZAIP PRD on explicit PRD work
 
 # Trabalhar com PRDs
 
+Antes de promover um PRD novo, aplique o aceite binário `proportional-acceptance-v1` de `@zaip-ai/specs` conforme `docs/quality/production-readiness.md` via `zaip plan build --acceptance <contrato.json>` e valide o plano embutido. Registre por outcome obrigatório origem, aplicabilidade, resultado observável, prova suficiente, responsável e condição de parada. Só adicione obrigação ligada ao pedido, Requirement ativo ou risco concreto. Melhoria opcional não bloqueia a promoção; resultado ausente não é aprovação. Preserve snapshots anteriores até migração explícita versionada e atribuída.
+
+Ao definir ACs, selecione testes de código e fluxos de dashboard pelo impacto; a
+qualificação integral do pacote pertence ao candidato final antes da publicação.
+Reuso de prova exige identidade e contrato ainda válidos.
+
 PRD é opcional e permanece em Definição com `status: draft` durante criação, revisão, refinamento e `prepare`. Ter SPECs ou PreparedPlan válido não autoriza promoção.
 
 ## Limite de autoridade

package/templates/.agents/skills/zaip-skill-release-qualification/SKILL.md

@@ -5,10 +5,20 @@ description: Qualify a release candidate after deploy mode resolution or an expl
 
 # Qualify a release candidate
 
+For new release evaluations, use the versioned binary `proportional-acceptance-v1` contract in `@zaip-ai/specs` and `docs/quality/production-readiness.md` through `zaip plan acceptance --input <contract.json>`. This command only checks self-reported data and never authorizes publication; authenticated pipeline receipts remain the gate. Map each mandatory outcome to its origin, applicability, sufficient proof, owner and stop condition; bind release proof to the exact candidate. Optional improvements do not block. The historical technical grade remains informative and unchanged. Local qualification uses the declared Windows host; the GitHub Linux smoke is a remote publication check. Do not require local Docker, WSL or another OS by inference.
+
 Use after `$zaip-skill-github-deploy` resolves release mode, or when local preparation/qualification is explicitly requested. Resolve deploy mode first using [the deployment contract](../zaip-skill-github-deploy/references/deployment-workflow.md). Generic consumer deploy under auto and explicit commits mode use scoped checks and `guarded-commits.mjs`; they do not acquire a release gate from this skill.
 
 Preparation, verification and dry-run do not publish. The request's resolved route supplies publication authority separately.
 
+For readiness grades, load `RULE-PRODUCTION-READINESS` and apply
+`technical-essential-v1` from `docs/quality/production-readiness.md`. Grade 9
+requires the six essential criteria; grade 10 adds reviewed concurrency,
+process interruption/recovery and representative load. There is no minimum
+observation period or production-cycle count. This technical assessment never
+waives the distribution gates below, changes a historical audit, or proves
+long-term stability. Keep operational history and publication status separate.
+
 ## Select the distribution surface
 
 - Verified ZAIP builder requires approved `zaip-ai/zaip-aios` origin and both `@zaip-ai/aios` root/`@zaip-ai/cli` public CLI package identities. Apply `zaip-skill-update-version-doc`; root manifest defines candidate `N.N.0`, aligned to GitHub `vN.N`.
@@ -23,8 +33,16 @@ Local builder preparation defaults to signed `essential-v3`: deterministic sourc
 
 These dense distribution checks are release gates. Change validation outside release remains targeted, with installer/security checks selected when directly impacted. Do not automatically run the full suite for generic commits, impose a test-count ceiling or classify a Task by wallclock duration.
 
+For a multi-Task delivery, verify changed code and affected dashboard flows by
+impact during the Tasks, integrate modified contracts, and run full package
+qualification once against the final candidate before publication. Reuse
+prior evidence only when candidate identity, environment and contract remain
+valid; later changes revalidate affected proof.
+
 Use `--profile full` for explicitly requested extended `full-v2` qualification, including full source, browser and XLSX coverage. Changed dashboard/export behavior still needs its relevant tests in the current Change. Rapid impact checks emit no signed release receipt and cannot substitute for release qualification.
 
+Post-receipt rapid group reuse follows `docs/quality/v49-deploy-cache-controls.md`. Only a reviewed Git-versioned group proof may yield a HIT; promote a failed result as the latest tombstone before retry. This never replaces signed candidate qualification.
+
 The framework helper uses an isolated exact-SHA clone, builds once, verifies the exact TGZ and signs a receipt. Cache validity requires matching candidate, policy, gate definitions, runtime, channel, version, trusted key, expiry and artifact digests. Failed/timed-out gates emit no successful receipt; changed candidates or invalid evidence require new qualification.
 
 Resolve builder signing material from the configured stable private directory and run `scripts/local-release-key.mjs preflight` before expensive gates. Inspect actual key/trust/policy configuration before claiming absence. Missing/mismatched required material fails closed; never generate replacement keys, rotate trust or remove signatures during routine deploy.
@@ -43,6 +61,12 @@ Where the legacy path remains configured, retain its separate exact-candidate qu
 
 Recover under the frozen Task autonomy profile: balanced permits 10 executions total and 3 replans. Individual tests/tool calls and elapsed time are not executions, and continuation never resets the ledger.
 
+Use eligible recovery before a terminal block: the three balanced replans use
+Sol/high, Sol/high and Astra/high and each releases up to three repairs. A real
+authority/access/capability blocker may stop earlier; do not manufacture three
+attempts against an unchanged unavailable prerequisite. Keep the exhausted
+ledger, actual findings and resume condition; never lower acceptance criteria.
+
 The framework release cut uses `node scripts/release-cycle-gate.mjs freeze --repository ROOT --version N.N --release-task TASK-ID --release-run RUN-ID`. The exceptional coordinator is the critical, release-only Task at the end of the owner SPEC's exact Execution DAG. Every predecessor Task must be completed; only the release Task may still execute. Its delegated Task orchestrator Run must be active under that SPEC's active macro Run. `audit` and `advance` recheck predecessor status and authenticate the same Task, Run, SPEC, Execution and committed candidate records; only the release Task and owner SPEC are exempt from the open-work gate. Unrelated work remains blocked. The candidate commits the frozen cycle before qualification. The deploy helper checks its exact SHA, pushes only `main`, and requires successful CI on that SHA before publication.
 
 For an authorized Task-first request that combines a product fix and its release in one direct Task root, use the explicit `--integrated-task` freeze option with that Task and active root Run. The Task must be critical, target the current release, own the release-cycle config scope and have a delivery Execution bound to its Change. `audit` and `advance` authenticate its committed Task and Run start, while all other current-release work, secondary worktrees and remote branches still block. This route avoids creating a second root Run or asking the user for a new turn solely to publish already authorized work. Do not use it for a delegated SPEC release Task or as a general waiver for release checks.

package/templates/.agents/skills/zaip-skill-release-qualification/references/local-preparation.md

@@ -121,6 +121,9 @@ doctor/SQLite/API smoke. It does not run browser navigation across every dashboa
 exports. `--profile full` explicitly selects `full-v2`, which also runs the full source suite,
 browser and XLSX qualification. Dense distribution checks belong to builder release; a normal
 Change runs targeted validation, including installer/security regressions when directly impacted.
+The essential source-size gate reports 401–800-line debt and stale warning ceilings as visible
+warnings, while files above 800 lines and provenance or baseline tampering remain blocking.
+The explicit `full-v2` profile keeps the strict source-size debt gate.
 Individual process/test timeouts remain technical limits, not a Task wallclock or abandonment rule.
 Retain failed-gate evidence and cleanup outcomes; a failed/timed-out gate emits no success receipt.
 Receipts bind the selected profile and fixed gate list, so stale receipts require requalification.
@@ -131,9 +134,12 @@ critical baseline and affected consumers without a test-count cap. An unmapped i
 an evidenced broader selection; it does not make every generic commits deploy run the full suite.
 Rapid checks never prove full release qualification. Observe pending commands through the host's
 wait mechanism instead of treating elapsed Task time as a result.
-Retain Windows/Linux Node 22.16.0 and 24.x matrix outcomes against the same exact TGZ,
-recording the actual Node patch version and digest. A configured matrix is not proof that
-its jobs ran; unavailable runtime execution remains unverified, never passed.
+Qualify the exact TGZ on the authorized local host and record its actual OS, Node patch
+version and digest. The GitHub publisher performs the bounded Linux smoke on that same
+digest before npm publication. A configured matrix is not proof that its jobs ran;
+unavailable runtime execution remains unverified, never passed. The Windows/Linux
+Node 22.16.0 and 24.x matrix remains historical v4.6 evidence, not a default gate
+for each later release.
 Reuse an existing output directory only with its complete valid signed candidate; an invalid cache
 is refused. Choose a new output path after repair instead of deleting or overwriting evidence.
 

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

@@ -5,6 +5,13 @@ description: Create, refine, prepare, or analyze a technical ZAIP SPEC on explic
 
 # Trabalhar com SPECs
 
+Antes de promover uma SPEC ou sua DAG nova, avalie suficiência pelo contrato binário `proportional-acceptance-v1` de `@zaip-ai/specs` (`docs/quality/production-readiness.md`) via `zaip plan build --acceptance <contrato.json>` e valide o plano embutido. Cada AC obrigatório registra origem, aplicabilidade, resultado observável, prova suficiente, responsável e parada; toda dependência da DAG tem resultado verificável. Critério local fora do ambiente declarado falha no preparo. Pendência opcional não bloqueia; finding novo ou candidato alterado justifica outra rodada. Snapshots antigos só mudam por migração explícita versionada e atribuída.
+
+Mapeie cada mudança da DAG a testes de código e aos fluxos de dashboard
+afetados. Integre contratos modificados antes do release; qualifique o pacote
+completo uma vez no candidato final antes de publicar, revalidando provas
+atingidas por correções posteriores.
+
 SPEC é opcional para trabalho técnico amplo; Task-first continua válida para uma mudança pontual. A SPEC permanece em Planejamento com `status: draft` durante criação, revisão, refinamento e `prepare`.
 
 ## Limite de autoridade
@@ -25,6 +32,8 @@ SPEC é opcional para trabalho técnico amplo; Task-first continua válida para
 6. A criação, o rework e o prepare da SPEC exigem uma Run delegada e ativa do Rafa (`zaip-agent-builder`), com propósito `execution`, sob o orquestrador do turno raiz atual; passe essa Run em `--run`, ou em `--spec-run` quando a SPEC for materializada por `prd create --plan`. Não aceite replay histórico nem a Run da Bia como autoria técnica. Não crie registros Task, Change ou Execution antes de `ready|execute`; vincule sempre a Run realmente observada e o `creation_run_id` à SPEC e agregue telemetria somente quando observada ou reconciliada.
 7. Depois de materialização, use rework rastreável e preserve snapshots/tentativas.
 
+Para o defeito específico de versão de `pnpm` em snapshot já materializado, a [revisão controlada](../zaip-skill-execution/references/controlled-release-recovery.md) altera somente a versão comprovada em `package.json` e sua descrição, com Decision humana exata, revisão esperada e histórico de implementação. Não edite o frontmatter diretamente.
+
 ## Prepare
 
 1. Valide referências, cobertura de AC, IDs, ciclos, conflitos de paralelismo, comandos de verificação e o snapshot de stack contra a configuração atual do projeto.