@zaip-ai/cli 3.3.0 → 3.4.0

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

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-5eee6c0c5c6901f5e523f0a434bca4106e1ff7136deb451f982b0bb1a7b13716  VERSION
-4db3d63944b2c9f28019e705e4f125f6bcceb877e3efa5954cc7555a99b73536  bin/zaip.mjs
-dd2a7c216fd2c9d4f33164ae850af05db51b0b3ff885ddf03760d00fc1dcd491  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
-dd21d399e85ec0791965450a32fa13af51e71e17b86cc7ee11e8ce8072868c32  provenance.json
-cc111be184be67dd46cb46fb3f8fe75b192e33f3114d8c6c9cc0639a841962cf  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.3.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.3.0",
+  "version": "3.4.0",
   "source_origin": "zaip-aios:local-build",
   "lockfile_sha256": "f8557f3600849eb880b8f245b63b80fed9a3e9addf2c5f2c6d492547af900219",
-  "sbom_sha256": "cc111be184be67dd46cb46fb3f8fe75b192e33f3114d8c6c9cc0639a841962cf",
-  "runtime_sha256": "3925086e5b413bca4e23fc2f7bda7298ab11e28cb803b65e67492d1ef7a66f10",
-  "statement_sha256": "bb71d94b1a0092923e1480b2bced65a01ee0875f24740349155ad9bbff058039"
+  "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.3.0"
+      "version": "3.4.0"
     }
   },
   "components": [

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-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

@@ -21,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
@@ -29,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 format the final chat response after init, including installations started before this skill was available.
+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. 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, 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.

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

@@ -1,4 +1,4 @@
 interface:
   display_name: "ZAIP Setup"
-  short_description: "Install ZAIP-AIOS and format the installation reply."
+  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/zaip-aios/VERSION

@@ -1 +1 @@
-3.3
+3.4