@zaip-ai/cli 5.1.0 → 5.3.0

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

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-c0eacacd7e27bbf341d21e7e0e2997a363840a210d8e358d4babaebd765b5bfd  VERSION
-bc095b0649bb85426f67614a7cc450afbc4a7d52bab8e83954e318f0d4aa4db4  bin/zaip.mjs
-429917091d9e2a4af73bee5aa1d5d8f85888528e0c2cbcd62fa703b855deed79  manifest.json
+d92973800706e6107fce68570df8589348db4a4127663e491f5bc2ff630f1450  VERSION
+41a3e5d688c59269eb0d65159275d7a8c4b642df43d0b5085781284af001e5fd  bin/zaip.mjs
+c2d0005475e8f8d7dcb676a4f1fd87c04dc5ef0ce9921b6685fde1f7aeaef438  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
 2bd34b2f5c253a2167d9addaf1994167308ac0bb4fec22a794c8a5b488205278  pnpm-lock.sha256
-f7612762f640328ad211f8e39308decde7ab1539a67be5f4770f9367e28e3290  provenance.json
-d2956defc87c3bc6022b68eaf905f7eda311b410918568b0d57101bdd6aec2d5  sbom.cdx.json
+69f525f9b1f6419c28f6b2f9f5e4defd5c02cac30980e5f2acf039e9c005bad5  provenance.json
+6effd566ac07d305daebba775b81cfb2031be89ec3f5d5c18abb1fa74fd16d94  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

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

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "name": "zaip-aios",
-  "version": "5.1.0",
+  "version": "5.3.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": "5.1.0",
+  "version": "5.3.0",
   "source_origin": "zaip-aios:local-build",
   "lockfile_sha256": "b5e11351951654d41aa78dc858d43990a12964ba4051a070613ac8b11bc73a27",
-  "sbom_sha256": "d2956defc87c3bc6022b68eaf905f7eda311b410918568b0d57101bdd6aec2d5",
-  "runtime_sha256": "0c57b09af7368dc856de264574e9835376097fe52f79713b21414d7f1f9acf65",
-  "statement_sha256": "5d508534242390ce35e059e0bcfe53a449eac817b34105b376bb200702857321"
+  "sbom_sha256": "6effd566ac07d305daebba775b81cfb2031be89ec3f5d5c18abb1fa74fd16d94",
+  "runtime_sha256": "f6d79701cff2c98781e538f1f7c95a236eb256b442c0718cdfa4af54feb046b8",
+  "statement_sha256": "5f5324711dc20b81d79122422114bd65b5a569cadf60c0fcda1b7c90db0455c7"
 }

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

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

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

@@ -6,6 +6,7 @@ Carregue antes de executar uma entrega ou delegar. Este contrato detalha o kerne
 - 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 por padrão uma Execution idempotente/claim atômico; sem ele use identidade local sem prometer idempotência. A exceção versionada de `spec execute` permite uma Execution delivery sucessiva à interaction de definição no mesmo turno físico somente após definição terminal+Gui, SPEC pronta e autorização explícita observada para o alvo exato. A exceção tipada de `task resume-post-publication` permite a sucessora da SPEC histórica após a raiz delivery de manutenção terminar com Gui, com recibo canônico emitido antes do encerramento e publicação/ciclo revalidados; em novo turno observado, o claim vincula o mesmo recibo ao sucessor sem duplicar a raiz anterior. O claim vincula as Executions e Runs, preserva a anterior e impede dois proprietários ativos; não fabrica novo turno ou child. `interaction` read-only sem descendentes é conversa sem Task artificial e termina após a resposta entregue, sem executor ou finalizador; interaction com trabalho delegado e `delivery` exigem executor/finalizador. `delivery` é trabalho materializado e reuso exige kind/origem compatíveis. A raiz é `zaip-agent-orchestrator`; quando a barreira é exigida escolha executor por capacidade, permita reviewer/auditor/integrator e termine com `zaip-agent-finalizer` em `finalization`, após descendentes, bloqueando novas chamadas.
+- A exceção pós-publicação também admite Task-first histórica com `spec_id: null`, origem Task e DAG unitário exato. Recibo v2 e claims v5/v6 preservam Task, Change, Execution, autorizações humanas observadas, produtor da Evidence e Gui independente; não criam SPEC nem concedem writer de produto antigo. A publicação histórica pode preceder avanços posteriores, desde que ciclo contínuo, tag/SHA, assets, npm e ancestralidade remota permaneçam verificáveis. Continuação não abre nova raiz enquanto seu responsável no mesmo alvo estiver ativo. Veja o [contrato v5.3 e procedimento](../../zaip-skill-lifecycle-closure/references/post-publication-task-first.md); aceite histórico não comprovado permanece bloqueado, mesmo com release posterior aprovada.
 - 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/scripts/deploy-contract.mjs

@@ -77,6 +77,29 @@ export function requestedDeployment(request) {
     "A bounded current human request is required",
   );
   const text = normalize(request);
+  // A separate, literal imperative paragraph can authorize implementation and
+  // publication together. Do not rewrite the user's request or accept reported,
+  // quoted, conditional or merely mentioned publication language.
+  const implementAndPublish =
+    !/[`"'“”]/.test(request) &&
+    !/\b(?:disse|citou|exemplo|quoted|said)\b/.test(text) &&
+    !/\b(?:nao|nunca|jamais|sem|proibido|proibo|evite|aguarde)\b[^.!?]*\b(?:public\w*|publiqu\w*|release|deploy|versao)\b/.test(
+      text,
+    ) &&
+    !/\b(?:ate|quando|se|apos|depois)\b[^.!?]*\b(?:revis\w*|autor\w*|aprov\w*|confirm\w*)\b/.test(
+      text,
+    ) &&
+    !/\b(?:aguard\w*|esper\w*|so|somente|apenas|depend\w*|condicion\w*)\b[^.!?]*\b(?:revis\w*|autor\w*|aprov\w*|confirm\w*)\b/.test(
+      text,
+    ) &&
+    request
+      .split(/\r?\n/)
+      .map(normalize)
+      .some((line) =>
+        /^(?:faca|realize|execute)\s+(?:as mudancas necessarias|os ajustes necessarios|as melhorias|todos os testes)(?:\s+e\s+(?:todos os testes|as validacoes|os testes))?\s+e\s+publique\s+(?:em\s+)?(?:uma\s+|a\s+)?(?:nova|proxima)\s+versao[.!]?$/.test(
+          line,
+        ),
+      );
   const resumedSpecPublication =
     /^pode retomar a execucao da spec ate finalizar todas as tasks e fazer publicacao deploy da v((?:0|[1-9]\d*)\.(?:0|[1-9]\d*))(?: com release(?: e npm publicado)?)?$/.exec(
       text,
@@ -138,6 +161,7 @@ export function requestedDeployment(request) {
     releaseDirective ||
     proceedToVersion ||
     finalAdjustmentsToPublish ||
+    implementAndPublish ||
     shortPublicationVersion !== null;
   if (!direct || /\?/.test(text) || waitsForAuthorization)
     return { authorized: false, reason: "not-a-direct-deployment-request" };
@@ -156,6 +180,7 @@ export function requestedDeployment(request) {
     /^release\b/.test(withoutCourtesy) ||
     releaseDirective ||
     proceedToVersion ||
+    implementAndPublish ||
     shortPublicationVersion !== null;
   const nonPublication = text.replace(
     /\bnao\s+(?:publique|publicar)\s+(?:(?:um|uma|o|a|novo|nova)\s+)*release\b/g,

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

@@ -0,0 +1,42 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { resolveDeployment } from "./deploy-contract.mjs";
+
+const builder = {
+  origin: "git@github.com:zaip-ai/zaip-aios.git",
+  rootName: "@zaip-ai/aios",
+  cliName: "@zaip-ai/cli",
+  rootVersion: "4.5.0",
+  cliVersion: "4.5.0",
+  workspaceVersion: "4.5.0",
+};
+const input = (request, identity) => ({ request, identity });
+test("implementation plus publication accepts a literal paragraph but not quotation or conditions", () => {
+  const directive = "Faça as mudanças necessárias e todos os testes e publique em uma nova versao";
+  const request = `Pode executar as melhorias para chegar na nota 9.\n\n${directive}`;
+  const plan = resolveDeployment(input(request, builder));
+  assert.equal(plan.mode, "release");
+  assert.equal(plan.phase, "publish");
+  assert.equal(plan.scope, "current-work");
+  assert.equal(plan.version, null);
+  assert.equal(plan.npm_publication, true);
+  for (const rejected of [
+    `O usuário disse:\n${directive}`,
+    `Exemplo:\n${directive}`,
+    `"\n${directive}\n"`,
+    `${directive}?`,
+    `${directive} se eu confirmar`,
+    `Quando eu autorizar:\n${directive}`,
+    `Não faça nenhuma publicação até eu revisar.\n${directive}`,
+    `${directive}\nNão faça nenhuma publicação até eu revisar.`,
+    `Aguarde minha revisão antes de publicar.\n${directive}`,
+    `Até eu revisar, só faça os testes.\n${directive}`,
+    `Aguarde minha confirmação.\n${directive}`,
+    `${directive}\nAguarde minha confirmação.`,
+    `Só publique com minha aprovação.\n${directive}`,
+    `${directive}\nSó publique com minha aprovação.`,
+    `A publicação depende da minha aprovação.\n${directive}`,
+    directive.replace("e publique", "e não publique"),
+  ])
+    assert.equal(resolveDeployment(input(rejected, builder)).mode, "none", rejected);
+});

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

@@ -18,6 +18,7 @@ const managedDeployFiles = [
   "skills/zaip-skill-github-deploy/scripts/preflight.test.mjs",
   "skills/zaip-skill-github-deploy/scripts/deploy-contract.mjs",
   "skills/zaip-skill-github-deploy/scripts/deploy-contract.test.mjs",
+  "skills/zaip-skill-github-deploy/scripts/deploy-publication-intent.test.mjs",
   "skills/zaip-skill-github-deploy/scripts/guarded-commits.mjs",
 ];
 

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

@@ -50,5 +50,13 @@ the supplied ID and canonical record; never scan ordinary history to guess a tar
     to a verified backup. An inconclusive check refuses recovery. Preserve that backup
     and report its path; use the existing Task workspace flow afterwards.
 
+11. For published historical delivery, follow the [Task-first and SPEC recovery contract](references/post-publication-task-first.md).
+    Preview `task recover-post-publication`, bind the exact observed human authorization,
+    and issue its receipt before maintenance Gui. Consume it only after maintenance
+    completes with Gui through `task resume-post-publication`. Preserve original Evidence
+    and its producer, immutable publication identity, and the historical finalizer.
+    Missing historical acceptance remains blocked; a newer release does not prove an older
+    candidate. Never manufacture a SPEC, cancellation authorization, receipt, or product claim.
+
 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-lifecycle-closure/references/post-publication-task-first.md

@@ -0,0 +1,119 @@
+# v5.3 — recuperação Task-first após publicação
+
+Este contrato descreve a recuperação de metadados de uma entrega publicada que
+continua bloqueada no lifecycle. Implementar ou testar o mecanismo não comprova o
+fechamento de uma Task real, nem concede uma nota de prontidão.
+
+## Elegibilidade e autoridade
+
+- A Task histórica continua vinculada ao Change, à Execution, à release e ao
+  candidato originais. Para Task-first, `spec_id` permanece `null`, a origem da
+  Execution é a própria Task e o DAG contém exatamente seu par Task/Change.
+- O fluxo legado com SPEC permanece compatível. Não crie uma SPEC sintética para
+  contornar a ausência de uma origem macro.
+- A raiz de manutenção deve ser uma entrega autorizada e observada. Aceita-se
+  intake `new_work` explícito ou `direct_execution_authorization` persistida na
+  raiz, vinculada ao mesmo thread, turno, modelo e esforço observados.
+- A autorização direta é vinculada por hash junto ao hash da mensagem humana
+  observada. Ela não autoriza sozinha o recibo: uma Decision humana confirmada no
+  Change da manutenção deve conter exatamente o payload retornado pelo preview.
+  Não reescreva cabeçalhos nem invente confirmação humana.
+- Preview retorna `authorization_status: pending-human-decision`, `applied: false`
+  e nenhum recibo. Uma string de autorização direta não confirma que o humano
+  aprovou aquele reparo; somente a Decision humana exata permite aplicar o payload.
+- O recibo deve ser emitido enquanto a manutenção está ativa. Seu consumo exige
+  Task de manutenção concluída, Run concluída e decisão real `completed` do Gui.
+  A entrega histórica retomada exige sua própria barreira de finalização.
+
+## Prova de publicação preservada
+
+O comando verifica tag remota, SHA publicado, Release, workflows de CI/publicação,
+inventário e integridade dos assets, versão npm e integridade do tarball. A versão
+histórica não precisa continuar no dist-tag `latest`. A branch remota principal
+deve ser descendente verificável do SHA publicado; objetos Git ausentes impedem a
+verificação em vez de conceder sucesso.
+
+O avanço histórico da versão precisa ser único e pertencer a uma sequência
+contínua até o ciclo aberto. A manutenção pode pertencer ao ciclo atual ou ao
+avanço imediatamente anterior. Exemplo: depois de publicar 5.3 e avançar para
+5.4, a manutenção 5.3 pode emitir recibo para uma Task 5.2 publicada, preservando a
+prova original de 5.2. O recibo vincula os bytes do ciclo observado; emita-o após o
+último avanço necessário, antes do Gui da manutenção.
+
+Evidências permanecem atribuídas ao produtor original. O claim consumido e o
+recibo canônico permitem seu uso histórico pelo sucessor exato, sem copiar uma
+prova de 5.3 para 5.2, trocar SHA ou alterar a Evidence. A fronteira entre candidato
+original e publicação continua limitada às alterações de registros admitidas.
+Alterações posteriores do produto não são atribuídas ao candidato antigo.
+
+## Procedimento canônico
+
+1. Inspecione somente os IDs envolvidos, a revisão atual e as evidências originais.
+   Confirme que os critérios de aceite históricos realmente foram satisfeitos.
+   Publicação, teste técnico aprovado e `run.finished` não substituem esse aceite.
+2. Na manutenção autorizada, após o avanço de ciclo necessário e antes de seu Gui,
+   execute o preview abaixo. Substitua os marcadores pelos IDs e revisão observados.
+
+   ```text
+   node .agents/runtime/bin/zaip.mjs task recover-post-publication TASK-HISTORICA --actor-task TASK-MANUTENCAO --actor-execution EXEC-MANUTENCAO --run RUN-MANUTENCAO --expected-revision REVISAO --evidence EVD-ORIGINAL --json
+   ```
+
+3. Registre/ confirme a Decision humana correspondente à autorização real com o
+   `authorization_payload` exato do preview. Repita o comando com
+   `--decision DEC-HUMAN-OBSERVADA --apply`. Preserve o `receipt_path` retornado e
+   a Decision de emissão. Não monte nem edite o JSON do recibo manualmente.
+4. Conclua a manutenção com seu Gui real. Depois consuma o recibo:
+
+   ```text
+   node .agents/runtime/bin/zaip.mjs task resume-post-publication TASK-HISTORICA --receipt .local/recovery/post-publication/HASH-RETORNADO.json --json
+   ```
+
+5. Use a raiz sucessora retornada para o fechamento histórico autorizado. Preserve
+   executor elegível, revisão aplicável e Gui independente. Verifique os estados
+   canônicos de Task, Change e Execution antes de anunciar conclusão.
+
+No mesmo turno, o claim preserva o predecessor terminal e vincula o sucessor ao
+recibo exato. Um novo turno exige identidade, modelo e esforço observados e mantém
+a causalidade. Não simule turno, executor ou identidade para obter o claim.
+
+Os artefatos originais de tests, evals, checks, evidence e observations são
+congelados em inventário de caminhos e hashes. Alterar ou remover um original
+depois da emissão invalida a ponte de prova. Novas validações/Evidences tipadas
+podem ser anexadas após a retomada, vinculadas à raiz recovery exata, à mesma
+Task/Change/Execution e ao candidato histórico. Artefato de outro Run, candidato
+novo ou observação adicional não amplia esse snapshot. Recibos legados sem
+inventário conservam sua verificação integral anterior.
+Metadados de fechamento continuam sujeitos aos gates existentes. A recuperação
+não concede writer de produto para uma release já publicada, não move tags e não
+afrouxa o claim geral do checkout.
+
+## Quando o resultado histórico não pode ser concluído
+
+Se uma meta histórica permanece sem prova, mantenha o bloqueio e registre a
+pendência e sua relação com a entrega que a absorveu. Uma release posterior pode
+demonstrar seu próprio resultado, mas não cumprir retroativamente o aceite de
+outro candidato. `task cancel TASK-ID --json` é uma operação existente para
+cancelamento explicitamente autorizado pelo humano; não significa sucesso nem
+deve ser inferida de uma publicação. O runtime não introduz um estado automático
+`superseded` para disfarçar uma pendência.
+
+## Continuidade e compatibilidade
+
+A continuação procura o responsável pelo mesmo alvo no contexto do thread. Uma
+Run responsável ainda ativa impede criar outra raiz concorrente; reconcilie o
+evento terminal observado e preserve a decisão do Gui. Uma Run terminal pode ser
+usada como predecessor causal. Essa verificação não fecha Runs automaticamente.
+
+Recibos v1 e claims de SPEC v3/v4 continuam legíveis. Recibos v2 suportam Task-first
+e a vinculação da autorização direta; claims v5/v6 representam respectivamente
+sucessão no mesmo turno e em novo turno para Task-first. O relay delegado da SPEC
+continua reservado ao fluxo macro; Task-first usa `task resume-post-publication`.
+
+Os testes focais cobrem rejeição por identidade/autorização/prova incompatível,
+reexecução após falha parcial sem duplicar proprietário, preservação do produtor
+da Evidence, histórico de publicação avançado e continuidade sem raízes paralelas.
+Essas provas locais não substituem a revisão independente nem os gates do candidato
+final. Reteste apenas após invalidação documentada relevante.
+
+Consulte também [governança de execução](../../zaip-skill-execution/references/runtime-governance.md)
+e [fechamento de lifecycle](../SKILL.md).

package/templates/.agents/zaip-aios/VERSION

@@ -1 +1 @@
-5.1
+5.3