@zaip-ai/cli 3.2.0 → 3.4.0

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

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-33bdaf9e2d6bcbde2e4e613e865e403f8fe21fc621078d34c30b0bdc7f68d903  VERSION
-b1a09bfc88d679b61a3cceee499bd9e425dac9138a3df58e0f9659a85cc3781c  bin/zaip.mjs
-bc20fdf9f7e63f5babf4314c4292874ff13a1e8f15e33303e33ae5a5a8ebb189  manifest.json
+f5e3e93e58ffc2a20a3ca53e8025bc50d7c1dccbef4b34e2388aa9bbf8678466  VERSION
+8583ee1474bc30d9ac497c879729077aafaabc905422b9c738cb9632a7ebb013  bin/zaip.mjs
+ec9932ea72fc82824b5b472b252b0276797f7a52cc48db60c719ab828de53118  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
 2d738247131a923ea6e3a32d0d1d6de763866fd96a8a8dc75d127a343809b0aa  pnpm-lock.sha256
-19460b9687fec09ec858d3142e56caf9218c3b695dcaed625af2ddec11cb8232  provenance.json
-bbe98dd24ef9132f5d89f57db90756a77d55e8042ea2d2cb52f82d936571a47e  sbom.cdx.json
+d1b096f8ae3e7e5b804205020a0e75d43e9393c0adc121fa362e2d64e9e11e39  provenance.json
+0b19f004d8af24f71fa1d47489529026c1d86391a74dbfe2d11612b6e494713a  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

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

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

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

@@ -2,10 +2,10 @@
   "schema_version": 1,
   "statement_type": "self_reported_build_integrity",
   "authenticity": "unverified",
-  "version": "3.2.0",
+  "version": "3.4.0",
   "source_origin": "zaip-aios:local-build",
   "lockfile_sha256": "f8557f3600849eb880b8f245b63b80fed9a3e9addf2c5f2c6d492547af900219",
-  "sbom_sha256": "bbe98dd24ef9132f5d89f57db90756a77d55e8042ea2d2cb52f82d936571a47e",
-  "runtime_sha256": "7eccbcf4fb108a7e226bf72fd483de197ac8397b1a3ccdb6cd5988fcb8afbdae",
-  "statement_sha256": "c838e8e9a828f925f9c32179876c078fdbec58bef0bab9c2a5339f22da6a9bce"
+  "sbom_sha256": "0b19f004d8af24f71fa1d47489529026c1d86391a74dbfe2d11612b6e494713a",
+  "runtime_sha256": "7c1cff8714c83874e79830afb133628232a384512c066db3ffd9ae4abf247045",
+  "statement_sha256": "b025e30f1a337d75bf580808b164441310184e002d96345c7e3bafbc043f22ca"
 }

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

@@ -6,7 +6,7 @@
     "component": {
       "type": "application",
       "name": "zaip-aios",
-      "version": "3.2.0"
+      "version": "3.4.0"
     }
   },
   "components": [

package/templates/.agents/skills/zaip-aios/SKILL.md

@@ -1,5 +1,4 @@
 ---
-# zaip-managed generated-do-not-edit source=discovery-skill version=2.5.0 sha256=76f3edc1dc8dfecc8c1b3c5b789557a515d05e270c044bf35e758923dff0aa0f
 name: zaip-aios
 description: Discover and apply the repository-local ZAIP-AIOS framework.
 ---

package/templates/.agents/skills/zaip-skill-author-skills/scripts/audit-skill-catalog.mjs

@@ -18,6 +18,7 @@ for (const agent of catalog.agents ?? []) {
   }
 }
 for (const [agentId, requiredSkill] of [
+  ["agent-builder", "zaip-skill-update-version-doc"],
   ["agent-frontend", "zaip-skill-frontend"],
   ["agent-frontend", "zaip-skill-frontend-componentization"],
   ["agent-backend", "zaip-skill-backend"],

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

@@ -11,7 +11,7 @@ Escopo de configuração: nome, timezone, stack, clients, tracking e destinos de
 
 ## Onboarding após instalação
 
-Uma resposta afirmativa a “Gostaria de ajuda com a configuração inicial do projeto?” ativa esta skill, tanto após a instalação quanto após o setup GitHub. Leia a configuração existente, explique em linguagem simples o que pode ser personalizado e faça uma entrevista curta antes de editar:
+Uma resposta afirmativa a “Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?” ativa esta skill, tanto após a instalação quanto após o setup GitHub. Leia a configuração existente, explique em linguagem simples o que pode ser personalizado e faça uma entrevista curta antes de editar:
 
 - Nome e finalidade do projeto, fuso horário e preferências já existentes.
 - Stack e partes necessárias da aplicação, clientes Codex/Claude e acompanhamento de uso/custos.

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

@@ -11,6 +11,19 @@ Carregue [a governança de execução e delegação](references/runtime-governan
 
 Use esta skill somente quando o usuário pedir execução. `prepare` não autoriza mutação nem promoção para `ready`; quando a execução foi pedida explicitamente, prepare o PRD/SPEC ainda em `draft`, se necessário, e então execute sem exigir outra confirmação intermediária.
 
+## Continuidade do pedido de execução
+
+“Execute esta SPEC/este PRD” autoriza finalizar a preparação necessária, materializar, ativar e executar toda a DAG selecionada até verificação e finalização. Essa autorização permanece durante a preparação e o rework necessário dentro do mesmo escopo; um sucessor canônico preserva o vínculo e a autorização existente. Pedido somente de planejamento ou de `ready` continua sem autorizar implementação.
+
+- Não encerre após criar/validar plano, sucessor, DAG ou Execution ativa. Não peça “continue execução” nem outra confirmação só porque a preparação consumiu tempo ou contexto; faça checkpoint/refresh e prossiga.
+- `spec execute`/`prd execute` ativam o macro e retornam `continuation.required`; isso é handoff obrigatório, não prova de implementação. Em runtime gerenciado, acione `execution run EXEC`; na colaboração nativa Codex, siga a seção de DAG nativa abaixo. Use somente um caminho de dispatch, com a mesma Execution e atribuição válida.
+- Depois de cada Task, execute as próximas elegíveis; ao terminar a DAG, realize os gates parentais e Gui. Só encerre com resultado observado ou impedimento concreto após recuperação permitida. Ramos independentes continuam somente quando a política de falha da DAG permitir.
+- Falta real de autoridade, informação essencial, capacidade do host ou gates continua sendo bloqueio. Informe a causa e a condição de retomada; não invente sucesso, nova autorização, identidade ou ancestralidade para continuar.
+
+Antes de encerrar com trabalho pendente ou responder a uma falha, aplique [continuidade automática e parada justificada](references/autonomous-continuation.md). O perfil congelado e seu ledger decidem recuperação; reparação elegível usa a autorização existente, sem pedir outro turno.
+
+## Passos de execução
+
 1. Carregue o PreparedPlan e valide hash, origem, Requirements/AC, DAG, write scopes e estado atual. Antes de selecionar executor, carregue as Rules aplicáveis; para decisão comercial, use `$RULE-SPECIALIST-ROUTING` como fonte única da matriz de roteamento. Ao construir ou diagnosticar o plano externo, leia [o contrato compacto](references/prepared-plan.md).
 2. Materialize idempotentemente Change, Tasks e Execution antes da primeira alteração do produto.
 3. A partir da tentativa explícita de `execute`, classifique uso como `execution`; inicie Execution, Changes, Tasks elegíveis e Runs com atribuição ao nível de entrada (`task`, `spec` ou `prd`). Ausência de diff não retroage a fase: registre `changed_files` vazio e o resultado real.

package/templates/.agents/skills/zaip-skill-execution/references/autonomous-continuation.md

@@ -0,0 +1,17 @@
+# Continuidade automática e parada justificada
+
+O desenvolvimento autorizado continua automaticamente. Antes de terminar um turno com trabalho pendente, o orquestrador aplica esta sequência:
+
+1. Consulte o estado real, a autorização vigente, a política da DAG e o perfil congelado da Task. Use o ledger persistente existente; na ausência de autonomy-v1, respeite os limites legados. Configuração nova não renova tentativas antigas; valores desconhecidos não significam zero ou ilimitado.
+2. Havendo trabalho elegível, implemente, valide e continue as próximas Tasks. Agente ativo, lease ocupado, checkpoint de contexto e transição de fase exigem espera ou refresh, não uma mensagem “continue execução”. Não duplique invocações pendentes.
+3. Falha recuperável dentro do escopo aciona diagnóstico, retry operacional, reparação ou replanejamento permitido pelo perfil, sem nova confirmação. Registre cada tentativa e reserve o orçamento antes do dispatch. Os comandos explícitos de resume/rework são operações canônicas que o agente executa com a autorização já vigente; não significam exigir outro pedido humano.
+4. Pare quando houver cancelamento humano, impedimento de autoridade/segurança, dependência ou capacidade essencial indisponível após recuperação permitida, falha impeditiva ou esgotamento real da política. Nunca contorne esses motivos, apague contadores, aumente perfil, reabra completed/cancelled ou invente prova. Perfil Persistente não remove esses limites, embora não tenha teto numérico de tentativas.
+5. Respeite failure_policy: continue_independent permite ramos elegíveis independentes; stop_on_terminal_failure impede novo dispatch enquanto o motivo terminal permanecer. Nenhuma política autoriza executar dependentes sem aceite da dependência.
+6. Após a última Task, avance para gates parentais e finalização. A resposta terminal deve ser conclusão comprovada ou parada justificada; quantidade de trabalho, duração e tamanho de contexto não são falhas do produto.
+
+## Saídas e papéis
+
+- Em progresso, informe o resultado observado e a próxima ação que está executando. Não termine com “envie continue”, “posso prosseguir?” ou “aguardo autorização” quando a autorização e a recuperação aplicável já existem.
+- Em parada real, informe Task/Execution afetada, motivo comprovado, perfil e consumo observado quando disponíveis, recuperação tentada, condição objetiva de retomada e a única ação humana necessária, se houver. Não sugira uma nova tentativa que ultrapasse o perfil.
+- Executor termina sua unidade e devolve evidências ao orquestrador; reviewer/finalizer devolvem sua decisão e não implementam nem criam filhos. O término de um filho não autoriza o orquestrador a abandonar a entrega.
+- Stop do host é sinal de término físico, não autorização para fabricar dispatch, reabrir registros ou aprovar trabalho. Preserve recibos, idempotência e a proteção contra loops do hook. Continuidade é realizada pela invocação viva ou pelo coordenador autorizado.

package/templates/.agents/skills/zaip-skill-execution/references/correction-cycle.md

@@ -1,7 +1,7 @@
 # Ciclo de correção e bloqueio
 
-Carregue esta referência somente antes de uma nova correção. Falha operacional transitória, cuja recuperação é esperada, recebe retry limitado; impedimento essencial deixa a Task `blocked`; falha lógica exige correção localizada ou repair/rework explícito.
+Carregue esta referência somente antes de uma nova correção. Falha operacional transitória, cuja recuperação é esperada, recebe retry limitado; impedimento essencial deixa a Task `blocked`; falha lógica exige correção localizada ou comando canônico de repair/rework dentro da autorização vigente. Operação explícita não exige nova autorização humana quando escopo, perfil e ledger permitem recuperação automática.
 
 Registre nos findings, Change ou Run existentes somente resultados observáveis: falha, tentativa e resultado, aprendizado ou hipótese nova, e próxima ação e teste discriminante; não registre raciocínio privado. Se a mesma falha reaparecer após uma correção, revise a hipótese antes de editar novamente. Evidência pode refutá-la mesmo quando o teste não passa. Diff, ID cosmético ou mera ausência de erro não demonstram avanço.
 
-Preserve escopo e critérios de aceite; evite melhorias opcionais e valide primeiro a hipótese específica, repetindo validação ampla somente por mudança relevante ou gate exigido. Respeite os limites e contadores existentes, sem criar paralelos; um replanejamento não os reinicia nem cria identidades novas para ganhar tentativas. Sem rota fundada, ou quando o limite aplicável se esgota, marque `blocked` com a condição objetiva de retomada no lifecycle. Astra só é usado onde a política atual permite; Task avulsa preserva modelo e effort selecionados pelo host.
+Preserve escopo e critérios de aceite; evite melhorias opcionais e valide primeiro a hipótese específica, repetindo validação ampla somente por mudança relevante ou gate exigido. Respeite os limites e contadores existentes, sem criar paralelos; um replanejamento não os reinicia nem cria identidades novas para ganhar tentativas. Esgotada a recuperação, use `failed` somente para impedimento técnico comprovado; falta de acesso, prova, autoridade ou conclusão segura usa `blocked`, com a condição objetiva de retomada. Não peça “continue execução” para repetir uma tentativa vedada. Antes de uma parada, aplique [o contrato de continuidade](autonomous-continuation.md). Astra só é usado onde a política atual permite; Task avulsa preserva modelo e effort selecionados pelo host.

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

@@ -42,7 +42,7 @@ Every product commit requires causal Task/Change/Execution records and matching
 
 1. Compose `$zaip-skill-release-qualification` and follow [local preparation](../zaip-skill-release-qualification/references/local-preparation.md). Synchronize and commit before preparing the clean exact SHA. Failed or stale evidence is not qualification.
 2. Resolve the previous Release, next canonical version and package identity using [release identity](references/release-identity.md). For the framework, `vN.N` maps to package `N.N.0`; only GitHub Actions publishes `@zaip-ai/cli` to npm.
-3. For `zaip-ai/zaip-aios`, use `scripts/local-release-deploy.mjs`. It prepares/verifies, pushes the exact SHA to configured `main`, uploads verified assets to a draft, then publishes the Release. Enable the thin publisher only after explicit rollout authority, public trust enrollment and signed full local qualification. It validates published assets and runs one read-only installation smoke before npm; no private-draft pilot or write token is needed. GitHub Release publication and npm completion remain separate.
+3. For `zaip-ai/zaip-aios`, use `scripts/local-release-deploy.mjs`. It prepares/verifies, pushes the exact SHA to configured `main`, uploads verified assets to a draft, then publishes the Release. Enable the thin publisher only after explicit rollout authority, public trust enrollment and signed local qualification. It validates published assets and runs one read-only installation smoke before npm; no private-draft pilot or write token is needed. GitHub Release publication and npm completion remain separate.
 4. Consumers use `scripts/consumer-release-preparation.mjs guarded-push` with their own policy and explicit branch, SHA and trusted receipt. They have no framework npm/TGZ requirement. See the preparation guide for bootstrap and guarded commands.
 5. Immediately before delivery, reread the configured target; if changed, restart preparation. Helpers bind the exact candidate to `HEAD:refs/heads/<configured branch>` (or its equivalent immutable-SHA refspec); do not bypass them with a manual push.
 6. After qualification, a missing Release is normal. Unless explicitly push-only, automatically create the draft for that SHA or resume a verified draft for the same SHA. Verify an already-published exact Release as a no-op; an API/authentication error never proves absence. Refuse conflicting tags/assets without overwrite.
@@ -50,7 +50,9 @@ Every product commit requires causal Task/Change/Execution records and matching
 
 ## Proportional validation
 
-Guarded local framework delivery requires a valid `full-v2` receipt with the mandatory full gate.
+Guarded local framework delivery requires a valid `essential-v3` receipt for the exact candidate.
+It runs the fixed essential integrity, build/type, package and clean-consumer doctor/SQLite/API
+smoke checks. Dashboard-per-tab and XLSX certification are reserved for explicit `--profile full`.
 Without explicit thin-path activation, the default GitHub publisher separately requires the legacy workflow's
 exact-candidate qualification receipt after its full gate and TGZ matrix.
 Rapid impact checks have no test-count ceiling and cannot substitute for release evidence.

package/templates/.agents/skills/zaip-skill-github-deploy/references/deployment-workflow.md

@@ -70,9 +70,11 @@ Run preflight once at the start of the authorized deployment. Classify a failure
 
 ## Validation budget
 
-Guarded local framework preparation requires `full-v2` and its mandatory full gate.
+Guarded local framework preparation requires the signed `essential-v3` receipt. It excludes
+dashboard-tab and XLSX certification; select `--profile full` explicitly when that extended
+coverage is required.
 The default legacy GitHub publisher accepts its separate exact-candidate qualification
-receipt only after the remote full gate and TGZ matrix. Explicit administrator activation after signed full local qualification switches the
+receipt only after the remote full gate and TGZ matrix. Explicit administrator activation after signed local qualification switches the
 publisher to the verified local receipt. One read-only install smoke then gates npm;
 no private-draft pilot is required. Activation is never implicit.
 Follow [local preparation](../../zaip-skill-release-qualification/references/local-preparation.md)

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

@@ -34,10 +34,10 @@ current head `sha` and matching `npm_channel`. This extended path qualifies sour
 and the runtime matrix; it does not publish npm or create a Release.
 
 With explicitly enabled `ZAIP_LOCAL_RELEASE_ENABLED=true`, guarded delivery uses
-the signed local `full-v2` receipt and enrolled public trust. It does not require a
+the signed local `essential-v3` receipt and enrolled public trust. It does not require a
 legacy `qualify-cli.yml` receipt or a private-draft pilot. GitHub verifies the
 published assets and runs one read-only exact-TGZ installation/doctor smoke before
-the separate npm publication job. Source tests and full qualification remain local.
+the separate npm publication job. Extended full qualification remains an explicit local option.
 
 Only when the reduced path is disabled does the legacy publisher require
 `github-readiness.mjs` with `--workflow-path .github/workflows/qualify-cli.yml`

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

@@ -9,9 +9,9 @@ Configure the requested Git/GitHub state idempotently while preserving unrelated
 
 ## Installation onboarding
 
-An affirmative response to the installation question “Gostaria de ajuda para configurar o GitHub?” selects this skill. First explain the relevant setup options below and inspect the existing state. Ask concise questions only for missing choices: the intended Git identity, an existing repository URL or the owner/name/visibility for a new repository, and the preferred authentication method. Never ask for private keys or tokens in chat. Ask key-path and passphrase questions only when creating a requested key. Do not initialize Git, create a remote, change identity, or make a first commit merely because the user accepted help; apply the choices once supplied.
+An affirmative response to the installation question “Deseja ajuda para configurar seu repositório Git?” selects this skill. First explain the relevant setup options below and inspect the existing state. Ask concise questions only for missing choices: the intended Git identity, an existing repository URL or the owner/name/visibility for a new repository, and the preferred authentication method. Never ask for private keys or tokens in chat. Ask key-path and passphrase questions only when creating a requested key. Do not initialize Git, create a remote, change identity, or make a first commit merely because the user accepted help; apply the choices once supplied.
 
-After the requested GitHub setup succeeds and is verified, summarize the observed changes and end with exactly: **Gostaria de ajuda com a configuração inicial do projeto?** An affirmative response selects `$zaip-skill-config`, which explains configuration options and asks the necessary questions before editing. If setup is incomplete, report the actual pending step rather than claiming completion. A refusal or request to defer ends installation onboarding without repeated offers or automatic setup.
+After the requested GitHub setup succeeds and is verified, summarize the observed changes and end with exactly: **Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?** An affirmative response selects `$zaip-skill-config`, which explains configuration options and asks the necessary questions before editing. If setup is incomplete, report the actual pending step rather than claiming completion. A refusal or request to defer ends installation onboarding without repeated offers or automatic setup.
 
 ## Select the requested mode
 

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

@@ -33,6 +33,10 @@ Use apenas comandos canônicos ZAIP. Não edite status diretamente no frontmatte
 - `desenvolva|melhore|aprimore` sempre cria refinamento ou rework e nunca executa automaticamente. Preserve snapshots e tentativas; depois do novo plano, exija nova promoção.
 - PRD `cancelled` é imutável. Use `prd rework <ID-CANCELADO>` para criar sucessor `draft` com tag `rework` e vínculo `rework_of_prd_id`; nunca reabra ou reescreva o cancelado.
 
+## Continuidade após execute
+
+Após ativar, siga imediatamente o contrato de continuidade de `$zaip-skill-execution`: execute as Tasks elegíveis e os gates parentais no mesmo fluxo. A resposta `continuation.required` da CLI indica trabalho pendente; ativação e materialização não comprovam implementação. Não solicite “continue execução” nem encerre por ter consumido o turno preparando o plano. Preserve bloqueios reais, escopo e autoridade.
+
 ## Verificar
 
 Na continuação de um PRD preparado, reutilize a Execution de `plan_ref`/PreparedPlan. Para `blocked` ou `paused`, inspecione a causa e use a retomada canônica autorizada antes da captura; não repita `prd execute` contra um macro já materializado. `conversation start --intent continue --prd ID --execution EXEC` deve resolver a mesma Execution e fase `execution`, rejeitando divergências antes de escrever. Para colaboração nativa Codex, siga a seção de DAG nativa da skill de execução; `native-next` prepara envelopes e não substitui o spawn/capture observado nem os gates de entrega.

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

@@ -32,6 +32,10 @@ Use apenas comandos canônicos ZAIP. Não edite status diretamente no frontmatte
 - `implemente` em `draft` finaliza o plano sem executar; em `ready` autoriza `execute`; em `active` continua; em `blocked|failed` usa resume/rework.
 - `desenvolva|melhore|aprimore` sempre cria refinamento ou rework, preserva snapshots/tentativas e nunca executa automaticamente.
 
+## Continuidade após execute
+
+Após ativar, siga imediatamente o contrato de continuidade de `$zaip-skill-execution`: execute as Tasks elegíveis e os gates parentais no mesmo fluxo. A resposta `continuation.required` da CLI indica trabalho pendente; ativação e materialização não comprovam implementação. Não solicite “continue execução” nem encerre por ter consumido o turno preparando o plano. Preserve bloqueios reais, escopo e autoridade.
+
 ## Verificar
 
 1. Leia novamente a SPEC após o comando.

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

@@ -46,13 +46,13 @@ Durante essa etapa, a Execution universal `interaction` e sua Run raiz continuam
 1. Bloqueie PRD sem SPEC, SPEC de outro PRD, referência quebrada, AC vago, DAG cíclica, dependência entre SPECs ou write scopes concorrentes.
 2. Construa uma DAG por SPEC; dependências nunca atravessam SPECs. Mantenha integração e outcomes como gates parentais do PRD.
 3. Gere e valide o PreparedPlan conforme [o contrato compacto](../zaip-skill-execution/references/prepared-plan.md), persista-o e pré-aloque IDs sem materializar trabalho executável nem mudar `draft` para `ready`. Um pedido explícito posterior de `prd ready` materializa, na mesma operação idempotente, a DAG selecionada em Execution, Changes e Tasks `planned`, sem iniciar a execução.
-4. Após `prepare`, mostre que o PRD continua em Definição e pare; não encadeie `prd ready` ou `prd execute` sem a solicitação explícita correspondente.
+4. Após `prepare`, pare em Definição somente quando o pedido se limitar a planejamento. Se o usuário já pediu execução, essa autorização cobre a preparação necessária: prossiga imediatamente com $zaip-skill-execution, sem nova confirmação.
 
 ## Handoff e analyze
 
-Ao receber “execute esse PRD” em outro turno, reutilize o ID canônico e delegue à skill de execução a captura inicial como continuação desse PRD. Não repita o intake `conversation --definition prd,spec` da autoria anterior e não recrie o pacote. Se o documento citado existir apenas como rascunho local, informe essa diferença: a existência de um arquivo de planejamento não comprova PRD canônico nem Run de delivery.
+Ao receber “execute esse PRD”, inclusive no mesmo turno da preparação, reutilize o ID canônico e delegue à skill de execução a captura inicial como continuação desse PRD. Não repita o intake `conversation --definition prd,spec` da autoria anterior e não recrie o pacote. Se o documento citado existir apenas como rascunho local, informe essa diferença: a existência de um arquivo de planejamento não comprova PRD canônico nem Run de delivery.
 
-1. Pare em Definição após `prepare`. Somente após pedido explícito de promoção, use `$zaip-skill-move-prd`: `prd ready` deixa PRD/SPECs selecionadas em `ready` e materializa a DAG sem executá-la; cada Task materializada `planned` e nunca iniciada aparece em Pronto para Executar, mesmo vinculada a SPEC. Somente após pedido explícito de execução, delegue a persistência da continuação, ativação e orquestração para `$zaip-skill-execution`.
+1. Pare em Definição após `prepare` somente sem autorização de execução vigente. Somente após pedido explícito de promoção, use `$zaip-skill-move-prd`: `prd ready` deixa PRD/SPECs selecionadas em `ready` e materializa a DAG sem executá-la; cada Task materializada `planned` e nunca iniciada aparece em Pronto para Executar, mesmo vinculada a SPEC. Somente após pedido explícito de execução, delegue a persistência da continuação, ativação e orquestração para `$zaip-skill-execution`.
 2. Na análise, mostre visão macro por PRD: SPECs, Tasks, Executions, Runs, outcomes, AC/evidência, retrabalho, tokens e custo por fase/total.
 
 ## Assurance de outcomes

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

@@ -7,6 +7,10 @@ description: Qualify an exact ZAIP release candidate through source-template-pac
 
 Use before deciding whether a concrete candidate is ready. It does not publish.
 
+For the framework installer, first apply `zaip-skill-update-version-doc` and its
+executable source check. Candidate identity comes from the root manifest;
+generated artifact hashes and exact-package proof remain mandatory below.
+
 This skill is mandatory before every frontend/backend GitHub deploy and framework release.
 Follow [the executable preparation guide](references/local-preparation.md). Synchronize and commit
 the candidate first. The framework helper runs fixed gates in an isolated checkout, builds the
@@ -17,7 +21,7 @@ their configured branch (default `beta`) and no framework npm requirements.
 The deployment skill must call the guarded helper, which prepares and verifies before sending.
 A changed candidate or invalid evidence requires new qualification.
 Full source qualification runs locally. Extended GitHub qualification is manual;
-the reduced publisher requires enrolled public trust and signed full local qualification.
+the reduced publisher requires enrolled public trust and signed local qualification.
 
 The only public npm package is `@zaip-ai/cli`; the installation entry point is
 `npx @zaip-ai/cli@latest init`. Verify that release automation, manifests, and
@@ -25,19 +29,22 @@ registry checks target only this package before qualifying the next publication.
 
 ## Proportional validation
 
-Local framework preparation receipts require `full-v2`, including the mandatory `pnpm qualify:full`
-gate. The default legacy GitHub path retains its own qualification receipt after the full gate
-and exact-TGZ matrix; it does not use the local receipt format. Neither path accepts rapid-only
-evidence. A rapid check is diagnostic preparation, not release certification. Select rapid tests
-by impact without a count ceiling; a deadline must fail visibly, never truncate coverage.
+Local framework preparation defaults to signed `essential-v3`: deterministic source, lock,
+build/type checks, package/SBOM/TGZ integrity, dependency audit and one clean installed-consumer
+doctor/SQLite/API smoke. It deliberately does not certify every dashboard tab or XLSX export.
+Use `--profile full` only for an explicit extended `full-v2` qualification; it retains
+`pnpm qualify:full`, browser and XLSX coverage. The profile, fixed gate list and artifact digests
+are signed, so an old `full-v2` or rapid receipt cannot satisfy the new default by accident.
+The default legacy GitHub path retains its separate full receipt and exact-TGZ matrix. Rapid
+checks remain diagnostics, never release receipts; timeouts fail visibly.
 Follow [local preparation](references/local-preparation.md) for budgets, exact-candidate
 evidence and cache validity. A failed or timed-out gate emits no success receipt.
 Report local qualification, runtime matrix, GitHub and publication outcomes separately.
 
 ## Guarded local qualification and single remote smoke
 
-An administrator explicitly enables `ZAIP_LOCAL_RELEASE_ENABLED=true` after full local
-qualification and public trust enrollment. The guarded helper publishes the exact signed
+An administrator explicitly enables `ZAIP_LOCAL_RELEASE_ENABLED=true` after signed essential
+local qualification and public trust enrollment. The guarded helper publishes the exact signed
 GitHub Release assets. The read-only verifier validates receipt, policy, SHA and TGZ,
 then runs one Linux installation/doctor smoke before the isolated npm job receives
 publication credentials. No private-draft pilot or contents-write token is required.

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

@@ -13,18 +13,19 @@ to tag `vN.N` and package version `N.N.0`.
 ```text
 node scripts/local-release-preparation.mjs keygen --output-dir <new-key-directory>
 node scripts/local-release-preparation.mjs bootstrap --trust-store <trust-directory> --public-key <public-key.pem> --key-id maintainer --channels latest
-node scripts/local-release-preparation.mjs prepare --repository <absolute-repository> --expected-repository zaip-ai/zaip-aios --sha <40-character-sha> --output-dir <candidate-artifacts> --policy <policy.json> --private-key <private-key.pem> --key-id maintainer --channel latest --version <N.N> --expires-at <future-ISO-within-seven-days> --trust-store <trust-directory>
+node scripts/local-release-preparation.mjs prepare --repository <absolute-repository> --expected-repository zaip-ai/zaip-aios --sha <40-character-sha> --output-dir <candidate-artifacts> --policy <policy.json> --private-key <private-key.pem> --key-id maintainer --channel latest --version <N.N> --expires-at <future-ISO-within-seven-days> --trust-store <trust-directory> --profile essential
 ```
 
 The framework policy is an administrator-reviewed file whose bytes must match the protected
 GitHub policy. Gates are fixed in the versioned helper, not supplied by the caller. Preparation
-fails at the first failed gate. It validates source size before dependency installation; then runs
-the `full-v2` profile: static integrity checks, dependency audit, package validation,
-mandatory `pnpm qualify:full` and exact-TGZ consumer identity. Preparation commands share
-a 60-minute deadline, with process-tree termination and cleanup after expiry. A failure
-never produces a successful receipt. Full qualification includes coverage, skill tests,
-cleanroom/rollback and Dashboard E2E; these gates are not optional for a release receipt.
-Former rapid-only receipts are invalid for this policy and require requalification.
+fails at the first failed gate. The default `essential-v3` profile validates source size, locks,
+build/type integrity, package/SBOM/TGZ binding, dependency audit and one clean installed-consumer
+doctor/SQLite/API smoke. It does not run browser navigation across every dashboard tab or XLSX
+exports. `--profile full` explicitly selects `full-v2`, which also runs the full source suite,
+browser and XLSX qualification. Essential preparation has a 15-minute deadline; full preparation
+has a 60-minute deadline. Both use process-tree
+termination and cleanup after expiry. A failure never produces a successful receipt. Receipts bind
+the selected profile and its fixed gate list, so former receipts require requalification.
 Successful preparation emits receipt, manifest, SBOM and TGZ.
 
 The separate rapid preparation helper has an eight-minute deadline and emits no signed
@@ -41,7 +42,7 @@ is refused. Choose a new output path after repair instead of deleting or overwri
 For an authorized release, call this command with the same arguments and paths:
 
 ```text
-node scripts/local-release-deploy.mjs --repository <absolute-repository> --expected-repository zaip-ai/zaip-aios --sha <40-character-sha> --branch main --output-dir <candidate-artifacts> --policy <policy.json> --private-key <private-key.pem> --key-id maintainer --channel latest --version <N.N> --expires-at <future-ISO-within-seven-days> --trust-store <trust-directory> --notes-file <reviewed-notes.md> --inventory-file <release-inventory.json> --from <previous-release-tag>
+node scripts/local-release-deploy.mjs --repository <absolute-repository> --expected-repository zaip-ai/zaip-aios --sha <40-character-sha> --branch main --output-dir <candidate-artifacts> --policy <policy.json> --private-key <private-key.pem> --key-id maintainer --channel latest --version <N.N> --expires-at <future-ISO-within-seven-days> --trust-store <trust-directory> --notes-file <reviewed-notes.md> --inventory-file <release-inventory.json> --from <previous-release-tag> --profile essential
 ```
 
 `--dry-run` prepares and verifies without sending. The live command verifies again around
@@ -86,7 +87,7 @@ verified SHA. This flow does not require a TGZ, npm version, npm channel or npm
 
 ## Activate the reduced GitHub path
 
-After explicit rollout authority, complete signed full-v2 local preparation and enroll
+After explicit rollout authority, complete signed essential-v3 local preparation and enroll
 only the reviewed public key, exact policy and key ID. Then explicitly enable
 `ZAIP_LOCAL_RELEASE_ENABLED=true` and use guarded delivery. The GitHub Release is published
 with its four signed assets before Actions validates them; the verifier needs only
@@ -99,8 +100,8 @@ The registry digest and channel are always verified by the isolated publisher.
 The default legacy publisher validates `qualification-receipt.json` from the successful
 GitHub qualification run, bound to candidate SHA, run/attempt, channel and exact TGZ. That
 workflow requires the full gate and runtime matrix before issuing its receipt. This is a
-separate accepted remote policy, not a `full-v2` local receipt or a rapid-only exemption.
-The guarded local helper still requires `full-v2` even while legacy remote checks are enabled.
+separate accepted remote policy, not an `essential-v3` local receipt or a rapid-only exemption.
+The guarded local helper requires `essential-v3` even while legacy remote checks are enabled.
 
 An administrator enrolls the public key, exact policy bytes and key ID in protected repository
 variables `ZAIP_LOCAL_RELEASE_TRUSTED_PUBLIC_KEY_B64`, `ZAIP_LOCAL_RELEASE_POLICY_B64` and

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

@@ -1,6 +1,6 @@
 ---
 name: zaip-skill-setup
-description: Install ZAIP-AIOS and its authorized prerequisites in a new workspace.
+description: Install or update ZAIP-AIOS and format the final chat response after init, including installations started before this skill was available.
 ---
 
 # Instalar ZAIP-AIOS
@@ -12,11 +12,26 @@ Para Supabase, a instalação nunca cria branch, preview ou custo hospedado. O f
 Use somente o pacote público `@zaip-ai/cli`: `npx @zaip-ai/cli@latest init`.
 Para escolher o perfil, acrescente `--profile full|dev-lite|lite` ao comando `init`.
 
+## Atualização solicitada
+
+Pedido simples de “update”, “atualize o ZAIP” ou equivalente em projeto instalado usa, por padrão,
+`npx --yes @zaip-ai/cli@latest init --force --yes --profile full` (Windows: `npx.cmd`).
+O pedido autoriza a reinstalação com backup automático e a instalação das dependências e
+pré-requisitos do perfil completo, sem nova confirmação ou dry-run obrigatório. Versão, perfil,
+dry-run ou restrições explícitas prevalecem. O primeiro `--yes` aceita baixar a CLI; o segundo
+confirma o force. Preserve as proteções transacionais e de ownership do instalador.
+Se houver falha, diagnostique o erro concreto; não apague arquivos para contorná-la.
+Valide pelo resultado do init e `doctor --json` do runtime instalado, sem auditar abas do
+Dashboard ou exportações XLSX. Informe versão, backup, dependências e pendências observadas.
+Esse fluxo instala dependências ausentes e preserva as já instaladas; não executa `npm update`.
+
+## Instalação inicial
+
 For the isolated SQLite dashboard, also discover and use `$zaip-skill-sqlite-read-model`.
 Create the disposable dashboard database only from canonical `.agents/records` and
 `.agents/config` sources.
 
-1. Confirme que o usuário quer instalar ZAIP-AIOS em um workspace que ainda não o possui. Se já houver `.agents/config/project.yaml`, não reinstale: encaminhe configuração, personalização, primeiros passos ou edição para `$zaip-skill-config`.
+1. Se o `init` acabou de concluir neste turno, vá diretamente ao modelo obrigatório de resposta abaixo; não reinstale nem inicie configuração. Para uma nova instalação, use o pedido explícito de instalação como autorização. Se já houver `.agents/config/project.yaml` e o pedido for atualização, aplique o fluxo acima; encaminhe configuração, personalização ou primeiros passos para `$zaip-skill-config`.
 2. Faça dry-run e detecte apenas conflitos que impeçam a instalação inicial, como checksum, ownership ou arquivos do usuário que seriam sobrescritos.
 3. Verifique Node.js 22+; instale a versão LTS com `winget` somente quando o usuário tiver autorizado a instalação automática do pré-requisito.
 4. Instale e valide o conteúdo do release: `config/project.yaml`, `config/framework.lock.yaml`, Rules core, Requirements e skills gerenciados pelo manifest, raízes V3 de `records` e, quando distribuído, o dashboard frontend-only em `.agents/dashboard`. Preserve arquivos e Rules locais do projeto.
@@ -25,17 +40,39 @@ Create the disposable dashboard database only from canonical `.agents/records` a
 7. Após a instalação, use `$zaip-skill-dev-environment` para inventariar apenas nomes e presença de pré-requisitos. Para configurar o projeto, personalizar perfis Codex ou seguir os primeiros passos, use `$zaip-skill-config`.
 8. A instalação deixa `beta` como ramo padrão de frontend, backend e banco, mas não cria uma branch Supabase hospedada, integração GitHub, credencial ou custo adicional. A configuração protegida de migrations é uma escolha posterior e explícita pelo `$zaip-skill-config`.
 
-## Resumo e onboarding de instalação
-
-- Git, identidade de autor, repositório, commit inicial e GitHub configurado não são pré-requisitos para instalar. Não interrompa a instalação para configurá-los; os requisitos de Git para executar entregas continuam sendo verificados pelo runtime.
-- Após a instalação, apresente um resumo curto com a versão efetivamente instalada, contagens observadas de arquivos adicionados/preservados/sobrescritos, resultado do Dashboard SQLite, resultado do `doctor --json` e estado local do GitHub. Não copie versão, contagens ou sucesso de exemplos; dry-run e etapas não executadas não comprovam instalação ou validação.
-- A versão deve ser um link Markdown clicável para a versão instalada no npm: `[VERSÃO](https://www.npmjs.com/package/@zaip-ai/cli/v/VERSÃO)`. Obtenha VERSÃO dos metadados/resultados da instalação, nunca de `latest` ou de um valor fixo.
-- Use o diagnóstico local do instalador: Git disponível, repositório, identidade efetiva e remote GitHub identificável. Um remote sozinho não comprova autenticação. Estado ausente ou inconclusivo encaminha para configurar GitHub; não imprima credenciais nem valores sensíveis.
-- Termine a resposta bem-sucedida com exatamente uma pergunta, sem texto depois dela:
-  - GitHub pendente: **Gostaria de ajuda para configurar o GitHub?** Explique antes que essa configuração pode ficar para depois.
-  - GitHub configurado localmente: **Gostaria de ajuda com a configuração inicial do projeto?**
-- No terminal, o CTA é apenas texto e não mantém o processo esperando entrada. No chat, uma resposta afirmativa à última pergunta ativa a skill correspondente: `$zaip-skill-github-setup` ou `$zaip-skill-config`. O aceite inicia a explicação das opções e as perguntas necessárias; não autoriza valores presumidos ou publicação.
-- Depois do setup GitHub concluído, ofereça a configuração do projeto. Depois da configuração do projeto concluída, encerre o onboarding. Recusa ou adiamento encerra a oferta atual sem insistência, novas perguntas ou configuração automática; preserve a possibilidade de retomada por pedido posterior.
+## Resposta final obrigatória após instalação
+
+Este contrato vale para a **resposta final do assistente no chat**, além do output da CLI. Aplique-o mesmo quando o usuário pediu apenas o comando npx, a instalação começou sem skills disponíveis ou esta skill só foi descoberta depois do init. Releia esta seção antes de responder. A existência de project.yaml recém-instalado não deve desviar a resposta para uma configuração automática.
+
+Reproduza a estrutura abaixo como Markdown renderizado: frase inicial, linha “Resumo:”, lista de bullets e uma pergunta final. Não use bloco de código para envolver a resposta, não converta a lista em parágrafos e não substitua o link por negrito, texto simples ou código. Use o comando realmente executado ou sua forma npx equivalente; nunca copie a versão ou as contagens do exemplo do usuário.
+
+Modelo (substitua todos os campos por resultados observados):
+
+```markdown
+ZAIP-AIOS foi instalado com sucesso no projeto atual usando `npx @zaip-ai/cli@latest init`.
+
+Resumo:
+
+- Versão instalada: [v{VERSÃO}](https://www.npmjs.com/package/@zaip-ai/cli/v/{VERSÃO})
+- {ADICIONADOS} arquivos adicionados
+- {SOBRESCRITOS} arquivos existentes sobrescritos
+- Dashboard SQLite configurado
+- `doctor --json`: válido, sem problemas
+- {ESTADO_OBSERVADO_DO_GIT_GITHUB}
+
+Deseja ajuda para configurar seu repositório Git?
+```
+
+- Substitua VERSÃO pela versão instalada, sem prefixo v no URL. Obtenha números e resultados da execução; dado ausente deve aparecer como “não informado”. Não declare sucesso de SQLite/doctor quando não executados ou falhos. Dry-run e instalação falha não usam a frase de sucesso.
+- Se não houver repositório, use “O diretório ainda não possui um repositório Git configurado.” Outros estados devem descrever a pendência real. Git, identidade, repositório, commit inicial e GitHub não são pré-requisitos de instalação; informe que podem ser configurados depois. Estado local não comprova autenticação.
+- Com GitHub pendente ou inconclusivo, termine com **Deseja ajuda para configurar seu repositório Git?** Com GitHub configurado localmente, substitua apenas a pergunta por **Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?**
+- Termine com exatamente uma dessas perguntas. Não escreva nada depois dela nem ofereça as duas alternativas juntas. Antes de enviar, confirme: bullets presentes; versão clicável no npm correto; pergunta correspondente ao estado e última linha da resposta.
+
+## Aceite e encerramento do onboarding
+
+O CTA da CLI é texto, sem bloquear aguardando entrada. No chat, “sim” à pergunta de Git ativa `$zaip-skill-github-setup`; “sim” à configuração inicial ativa `$zaip-skill-config`. A skill explica opções e faz perguntas curtas antes de aplicar escolhas; o aceite não autoriza valores presumidos, credenciais, recursos externos ou publicação.
+
+Depois de configurar e verificar GitHub, ofereça a configuração inicial com **Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?** Depois de concluir a configuração inicial, encerre o onboarding. Recusa ou adiamento encerra a oferta sem insistência; uma solicitação posterior pode retomá-la.
 
 Esta skill não executa nem descreve upgrade, migração ou rollback como ações primárias. Esses fluxos somente podem ser encaminhados às skills `zaip-update` ou `zaip-rollback` quando estiverem disponíveis e forem aplicáveis; elas não são uma dependência portátil desta skill.
 

package/templates/.agents/skills/zaip-skill-setup/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "ZAIP Setup"
-  short_description: "Install ZAIP-AIOS in a new workspace."
-  default_prompt: "Use $zaip-skill-setup to install ZAIP-AIOS in a workspace that does not yet have ZAIP."
+  short_description: "Install or update ZAIP-AIOS and report the result."
+  default_prompt: "Use $zaip-skill-setup to install ZAIP-AIOS or format the final reply after init with Markdown bullets, the installed-version npm link and the final setup question."

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

@@ -31,11 +31,11 @@ SPEC é opcional para trabalho técnico amplo; Task-first continua válida para
 2. Bloqueie stack ausente, profile/overrides divergentes, versão em range ou móvel, componente sem linguagem, descrição sem componente/versão ou `version_source` inexistente. Mudança posterior da stack exige nova revisão da SPEC; não reinterprete silenciosamente snapshot preparado.
 3. Gere e valide o PreparedPlan conforme [o contrato compacto](../zaip-skill-execution/references/prepared-plan.md), então persista IDs pré-alocados sem mudar `draft` para `ready`; preparação continua em Planejamento. Um pedido explícito posterior de `spec ready` materializa, na mesma operação idempotente, a DAG em Execution, Changes e Tasks `planned`, sem iniciar a execução.
 4. Quando o plano for global de um PRD, a SPEC pode ser preparada/ativada pelo pai sem duplicar outra Execution.
-5. Após `prepare`, mostre que a SPEC continua em Planejamento e pare; não encadeie `spec ready` ou `spec execute` sem a solicitação explícita correspondente.
+5. Após `prepare`, pare em Planejamento somente quando o pedido se limitar a planejamento. Se o usuário já pediu execução, essa autorização cobre a preparação necessária: prossiga imediatamente com $zaip-skill-execution, sem nova confirmação.
 
 ## Handoff e analyze
 
-1. Pare em Planejamento após `prepare`. Somente após pedido explícito de promoção, use `$zaip-skill-move-spec`: `spec ready` mantém a SPEC em `ready` e materializa a DAG sem executá-la; cada Task materializada `planned` e nunca iniciada aparece em Pronto para Executar, inclusive com `spec_id` preenchido. Somente após pedido explícito de execução, delegue a persistência da continuação, ativação e orquestração a `$zaip-skill-execution`.
+1. Pare em Planejamento após `prepare` somente sem autorização de execução vigente. Somente após pedido explícito de promoção, use `$zaip-skill-move-spec`: `spec ready` mantém a SPEC em `ready` e materializa a DAG sem executá-la; cada Task materializada `planned` e nunca iniciada aparece em Pronto para Executar, inclusive com `spec_id` preenchido. Somente após pedido explícito de execução, delegue a persistência da continuação, ativação e orquestração a `$zaip-skill-execution`.
 2. Considere a SPEC entregável somente quando Changes, Tasks, Executions, Runs e evidências descendentes passarem.
 3. Na análise, agregue tokens/custo por conversa, planejamento, execução e total, sem dupla contagem.
 

package/templates/.agents/skills/zaip-skill-update-version-doc/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: zaip-skill-update-version-doc
+description: Update and verify the ZAIP-AIOS installer candidate version, code identities and documentation; mandatory for the framework builder before build, packing or release qualification.
+---
+
+# Update version doc
+
+Use in the ZAIP-AIOS framework source. The installed copy explains maintenance;
+it must not change a consumer application's version. This workflow does not publish.
+
+1. Read the root `package.json` and the authorized release target. Its `version`
+   is the only product-version input; public manifests and runtime constants are projections.
+   Run `node scripts/update-version-doc.mjs inspect`, then `plan N.N.0` to inspect
+   the exact owned files before `apply N.N.0`. Omit the target to repair current identity.
+2. Keep general instructions versionless. Link to the generated
+   `docs/release-identity.md` in source documentation; installed guidance uses
+   `zaip version --json`. Preserve historical releases, evidence, upgrade fixtures,
+   schema versions, dependencies and compatibility minima. Never replace a number globally.
+   A newly introduced product identity must enter the updater inventory and tests.
+3. Review current instructions against actual CLI behavior: Node requirement from the public
+   manifest, Git optional for installation, commands/flags, supported environments and
+   managed-runtime limitations. Updating numbers alone does not validate documentation.
+4. Run `node scripts/update-version-doc.mjs check` before building. Build source,
+   regenerate adapters from their canonical generator, and build release artifacts. Synchronize
+   framework lock after release generation updates managed manifests, then sync the public
+   template. `pnpm release:artifacts:prepared` enforces this order. Never relabel a stale binary.
+   Check again after generation; run `verify-package` against the prepared artifacts.
+5. Apply `zaip-skill-release-qualification` to the final committed candidate.
+   Bind results to its SHA and TGZ hashes. Report candidate, installed and published versions
+   separately. A missing registry observation remains unavailable; local checks do not prove
+   publication or sustained stability.
+
+The builder must run this workflow for every installer release. Its source check is also called
+by build/pack gates. A failed check blocks qualification. `apply` validates every proposed edit
+before writing and can resume idempotently after interruption; it does not certify artifacts.
+
+In a distributed skill context, the wrapper
+`node .agents/skills/zaip-skill-update-version-doc/scripts/update-version-doc.mjs inspect`
+locates the maintainer helper or fails without mutating the consumer.

package/templates/.agents/skills/zaip-skill-update-version-doc/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Update version doc"
+  short_description: "Sincronizar versão, código e documentação"
+  default_prompt: "Use $zaip-skill-update-version-doc para preparar e verificar a versão do instalador ZAIP-AIOS."

package/templates/.agents/skills/zaip-skill-update-version-doc/scripts/update-version-doc.mjs

@@ -0,0 +1,21 @@
+import { access, readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+
+const root = resolve(import.meta.dirname, "../../../..");
+const helper = resolve(root, "scripts/update-version-doc.mjs");
+const manifest = JSON.parse(await readFile(resolve(root, "package.json"), "utf8"));
+if (manifest.name !== "@zaip-ai/aios") {
+  throw new Error(
+    "Framework source required; a consumer application's version must remain unchanged.",
+  );
+}
+try {
+  await access(helper);
+} catch {
+  throw new Error(
+    "Run this framework release skill in the ZAIP-AIOS source repository; do not rewrite a consumer project's version.",
+  );
+}
+const { main } = await import(pathToFileURL(helper).href);
+process.stdout.write(`${JSON.stringify(await main(process.argv.slice(2), root), null, 2)}\n`);