@zaip-ai/cli 6.0.1 → 6.2.0

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

@@ -1,11 +1,11 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-cf3701cb2416e87a99c0e77dbd0518fc4fc27e390f025c024e6ed1c389c928e0  VERSION
-ea96e255489fc59126568fbf2e36f88d46a56442514a43aba211f33ef37a1c5e  bin/zaip.mjs
-3b5cf6b8aeebc457cde6a5a3d889d042983272ad8695b4acb95c8be581ccdaac  manifest.json
+143d44a26fb0a34265b64a4b268daa11cd45a7200d8c4b23b844cc3028cff6db  VERSION
+3394d619b29dda46ab5834df34e13a9eb602df376bb72bd46d6f7a9a808542e2  bin/zaip.mjs
+0e1ac04d216912122c3e559e842ae0558ec962c3a21d291c273408ee51465631  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
 2bd34b2f5c253a2167d9addaf1994167308ac0bb4fec22a794c8a5b488205278  pnpm-lock.sha256
-9a3baaaa1db06fe6caa56dc3b3e9391625e08969f887fb3afcc38f7a69d8c6c9  provenance.json
-56beff20a7c2bd8e3e457f32cc50559528e1b4db38db44b7ef7f87e9ab07aba0  sbom.cdx.json
+5d608132809d582cc7145d90384482c765f0ae4f6e91e7986a3907c55f5d2ad7  provenance.json
+168a896e7065c9660680604b8f17eb3bac40d5a42eef8e708e1df3f0ad340996  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

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

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 2,
   "name": "zaip-aios",
-  "version": "6.0.1",
+  "version": "6.2.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": "6.0.1",
+  "version": "6.2.0",
   "source_origin": "zaip-aios:local-build",
   "lockfile_sha256": "b5e11351951654d41aa78dc858d43990a12964ba4051a070613ac8b11bc73a27",
-  "sbom_sha256": "56beff20a7c2bd8e3e457f32cc50559528e1b4db38db44b7ef7f87e9ab07aba0",
-  "runtime_sha256": "8781c0725c48b5a6d20f156fd23d03842ba161ada04e8080422442f1ec2f29e2",
-  "statement_sha256": "e8a81f1ce0a1d0140772a85671588ceab818c86d19422da4bf23fe4976df3918"
+  "sbom_sha256": "168a896e7065c9660680604b8f17eb3bac40d5a42eef8e708e1df3f0ad340996",
+  "runtime_sha256": "6134447215ae3248518545dd522729851079e5871d5800a799f5a5a8d45d7389",
+  "statement_sha256": "c979f00632a01aec55e35bfdc7f1e6a5381229f0f0c6f6f9ba28019fa90c1bed"
 }

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

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

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

@@ -26,6 +26,8 @@ The request file is UTF-8 plain text containing the actual human request. The re
 
 The requested deploy is sufficient authorization for the selected mode. Continue without a routine confirmation or an extra warning about an existing pipeline. Integrity, authentication, destructive operations and a required scope expansion remain real blockers.
 
+The resolver also accepts direct requests to finish pending work, update documentation and publish an explicit minor version, or “Pode fazer os ajustes e publicar”. The latter uses project policy and the current release cycle without inventing a version. Quoted requests, questions, negations and pending human approval remain non-authorizing; all-worktree scope is never inferred from these phrases.
+
 ## Preserve and prepare
 
 1. Record sanitized intent, resolved mode/scope, selected checkout, source SHA/branch, configured remote target, reviewed paths, preflight and preservation reference in evidence. Keep the chat result brief.

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

@@ -77,6 +77,16 @@ export function requestedDeployment(request) {
     "A bounded current human request is required",
   );
   const text = normalize(request);
+  // An explicitly named numeric patch keeps its separate signed patch route.
+  // Never truncate an ordinary release suffix into a minor version.
+  const ordinaryVersions = text.replace(
+    /\bpatch\s+v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?![\w.+-])/g,
+    "patch",
+  );
+  if (ordinaryVersions !== text && [...text.matchAll(/\bv?\d+\.\d+/g)].length !== 1)
+    return { authorized: false, reason: "conflicting-explicit-release-versions" };
+  if (/\bv\d+\.\d+(?:\.[a-z0-9_]|[-+][a-z0-9_]|[a-z_])/.test(ordinaryVersions))
+    return { authorized: false, reason: "unsupported-explicit-release-version" };
   // Provenance and explicit human holds constrain every authorization route.
   const quotedOrReported =
     /[`"'“”]/.test(request) || /\b(?:disse|citou|exemplo|quoted|said)\b/.test(text);
@@ -124,6 +134,10 @@ export function requestedDeployment(request) {
   // Only a direct publication imperative is executable. References, questions and quoted
   // historical instructions are not authority; unknown wording never upgrades the mode.
   const withoutCourtesy = text.replace(/^(?:(?:ok|por favor|agora|please)[, ]+)+/, "");
+  const finalAdjustmentsAndPublish =
+    /^(?:faca|realize|execute)\s+(?:esses|os)\s+(?:ultimos\s+)?(?:ajustes|ajuates)(?:\s+necessarios)?\s+e\s+publique\s+(?:a\s+)?(?:versao\s+)?v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)[.!]?$/.test(
+      withoutCourtesy,
+    );
   const sequencedDirect =
     /^primeiro passo entao e corrigir\b[^\n?]*\bfazer merge\b[^\n?]*,\s*fazer deploy\b/.test(
       withoutCourtesy,
@@ -163,6 +177,14 @@ export function requestedDeployment(request) {
     /\b(?:quando|se|apos|depois)\b[^?]*\b(?:autorizar|aprovar|confirmar|autorizacao|aprovacao|confirmacao)\b/.test(
       text,
     );
+  const pendingWorkAndPublish =
+    /^(?:execute|conclua|finalize)\s+o\s+que(?:\s+que)?\s+ficou\s+pendente,\s*atualize\s+(?:as\s+)?documentacoes\s+e\s+publique\s+(?:a\s+)?(?:versao\s+)?v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)[.!]?$/.test(
+      withoutCourtesy,
+    );
+  const approvedAdjustmentsAndPublish =
+    /^pode\s+(?:criar\s+sim\s+e\s+finalize\s+os\s+ajustes\s+e\s+publique\s+(?:a\s+)?v(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)|fazer\s+os\s+ajustes\s+e\s+publicar)[.!]?$/.test(
+      withoutCourtesy,
+    );
   const direct =
     /^(?:(?:pode|podemos)\s+)?(?:(?:faca|fazer|faz|realize|execute|do)\s+)?(?:deploy|dpeloy|depoly|push|commit|publique|publicar|publish|envie|release|prepare|preparar)\b/.test(
       withoutCourtesy,
@@ -171,6 +193,9 @@ export function requestedDeployment(request) {
     releaseDirective ||
     proceedToVersion ||
     finalAdjustmentsToPublish ||
+    finalAdjustmentsAndPublish ||
+    pendingWorkAndPublish ||
+    approvedAdjustmentsAndPublish ||
     implementAndPublish ||
     shortPublicationVersion !== null;
   if (!direct || (/\?/.test(text) && !implementAndPublish) || waitsForAuthorization)
@@ -207,7 +232,7 @@ export function requestedDeployment(request) {
     /^(?:(?:pode|podemos)\s+)?(?:(?:faca|fazer|faz|realize|execute|do)\s+)?(?:push|commit)\b/.test(
       withoutCourtesy,
     );
-  const versions = [...text.matchAll(/\bv((?:0|[1-9]\d*)\.(?:0|[1-9]\d*))(?![.\d])/g)].map(
+  const versions = [...text.matchAll(/\bv((?:0|[1-9]\d*)\.(?:0|[1-9]\d*))(?!\d|\.\d)/g)].map(
     (x) => x[1],
   );
   if (releaseDirective)

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

@@ -12,6 +12,82 @@ const builder = {
 };
 const input = (request, identity) => ({ request, identity });
 
+test("pending documentation and approved adjustments preserve explicit publication authority", () => {
+  const directives = [
+    "Execute o que que ficou pendente, atualize as documentacoes e publique a v6.2",
+    "Conclua o que ficou pendente, atualize as documentações e publique v6.2.",
+    "Pode criar sim e finalize os ajustes e publique v6.2",
+    "Pode fazer os ajustes e publicar",
+  ];
+  for (const directive of directives) {
+    const plan = resolveDeployment(input(directive, builder));
+    assert.equal(plan.mode, "release", directive);
+    assert.equal(plan.phase, "publish");
+    assert.equal(plan.scope, "current-work");
+    assert.equal(plan.version, directive.includes("v6.2") ? "6.2" : null);
+    for (const request of [
+      `${directive}?`,
+      `Ele disse: ${directive}`,
+      `"${directive}"`,
+      `${directive} se eu aprovar`,
+      `${directive}. Aguarde minha confirmação.`,
+      directive.replace(/e (publique|publicar)/, "e não $1"),
+      `Não publique. ${directive}`,
+    ])
+      assert.equal(resolveDeployment(input(request, builder)).mode, "none", request);
+  }
+  for (const suffix of [".1", "-rc1", " e a v6.3"])
+    assert.equal(resolveDeployment(input(`${directives[0]}${suffix}`, builder)).mode, "none");
+  const consumer = resolveDeployment(
+    input(directives[3], { origin: "git@github.com:example/app.git", rootName: "app" }),
+  );
+  assert.equal(consumer.mode, "commits");
+  assert.equal(consumer.npm_publication, false);
+});
+
+test("explicit numeric patch retains its separate signed route without minor truncation", () => {
+  const plan = resolveDeployment(input("Publique o patch v6.0.1 com Release e npm", builder));
+  assert.equal(plan.mode, "release");
+  assert.equal(plan.phase, "publish");
+  assert.equal(plan.version, null);
+  for (const request of [
+    "Publique o patch v6.0.1-rc1 com Release e npm",
+    "Publique o patch v6.0.1.beta com Release e npm",
+    "Publique o patch v6.0.1 se eu aprovar",
+    '"Publique o patch v6.0.1 com Release e npm"',
+    "Publique a v6.1 e o patch v6.0.1",
+    "Publique o patch v6.0.1 e a v6.1",
+    "Publique o patch v6.0.1 e o patch v6.0.2",
+    "Publique o patch v6.0.1 e a versão 6.1",
+  ])
+    assert.equal(resolveDeployment(input(request, builder)).mode, "none", request);
+});
+
+test("final adjustments and an explicit minor publication preserve bounded authority", () => {
+  const directive = "Ok, faca esses ultimos ajuates e publique a versao v6.1";
+  for (const request of [directive, "Faça os últimos ajustes e publique a versão v6.1."]) {
+    const plan = resolveDeployment(input(request, builder));
+    assert.equal(plan.mode, "release");
+    assert.equal(plan.phase, "publish");
+    assert.equal(plan.version, "6.1");
+    assert.equal(plan.scope, "current-work");
+  }
+  for (const request of [
+    `${directive}?`,
+    `Ele disse: ${directive}`,
+    `"${directive}"`,
+    `${directive} se eu aprovar`,
+    `${directive}. Aguarde minha confirmação.`,
+    directive.replace("e publique", "e não publique"),
+    directive.replace("v6.1", "v6.1.1"),
+    `${directive} e a v6.2`,
+    "publique a versão v6.1.beta",
+    "publique a versão v6.1-rc1",
+    "publique a versão v6.1.1",
+  ])
+    assert.equal(resolveDeployment(input(request, builder)).mode, "none", request);
+});
+
 test("explicit major after adjustments preserves literal authority and refuses human holds", () => {
   const directive =
     "Faça todos os ajuates e publique a v6.0 com uma versao final pronta pra produção";

package/templates/.agents/zaip-aios/INDEX.md

@@ -61,7 +61,16 @@ Guias são documentação, não certificado de release nem autorização para
 deploy, reabrir trabalho bloqueado, alterar permissões ou executar exemplos
 destrutivos. Relatórios históricos preservam o candidato e a data observados.
 
-## Ler as novidades da v3
+## Mudanças recentes e contexto histórico
+
+Para as mudanças recentes, leia [16 — Fechamento](guides/16-lifecycle-e-reconciliacao.md)
+(preflight, respostas compactas e recuperação Task-first/SPEC),
+[14 — Diagnósticos](guides/14-troubleshooting.md) (cache, conflitos e demora),
+[26 — Qualidade e release](guides/26-qualidade-e-release.md) (patch imutável,
+provas de publicação e auditoria datada v6.1) e
+[27 — Telemetria](guides/27-telemetria-git-native.md) (proprietário único no handoff).
+
+### Contexto histórico da linha v3
 
 Comece por [19 — Perfis de autonomia](guides/19-assurance-e-autonomia.md):
 4/1, 10/3 e ilimitado; depois [23 — Modelos](guides/23-orquestracao-de-modelos.md)

package/templates/.agents/zaip-aios/README.md

@@ -1,5 +1,10 @@
 # ZAIP-AIOS Handbook
 
+Na v6.2, os [guias de modelos](guides/23-orquestracao-de-modelos.md) e de
+[qualidade e release](guides/26-qualidade-e-release.md) cobrem Sol 6.1, migração
+dos defaults e publicação com coordenador integrado. Use `zaip version --json`
+para observar a versão instalada; documentação local não comprova publicação.
+
 Este handbook é a camada operacional instalada junto do ZAIP-AIOS. Ele ajuda
 pessoas e agentes a localizar o procedimento certo sem carregar todo o
 framework no contexto. O contrato executável continua nos arquivos canônicos
@@ -64,6 +69,22 @@ Consulte [qualidade e release](guides/26-qualidade-e-release.md) para distinguir
 checks locais, CI e aprovação de produção. Documentação não autoriza publicação
 nem reabertura de entregas históricas bloqueadas.
 
+## Atualização operacional e distribuição
+
+Os guias [16](guides/16-lifecycle-e-reconciliacao.md),
+[26](guides/26-qualidade-e-release.md) e [27](guides/27-telemetria-git-native.md)
+incorporam diagnóstico antes do Gui, recuperação pós-publicação, saída compacta,
+patch imutável e atribuição única de telemetria. O guia 26 registra a auditoria
+datada da v6.1 e separa mudanças entregues de otimizações ainda propostas.
+Consulte [troubleshooting](guides/14-troubleshooting.md) para sintomas recentes.
+
+No mantenedor, sincronize framework lock e templates com os geradores oficiais
+antes de empacotar. Confira os guias e os dois READMEs no TGZ e numa instalação
+isolada: os manuais da raiz são instalados em `.agents/README.md` e
+`.agents/README-ENG.md`, e o handbook em `.agents/zaip-aios/`. Preserve o README
+autoral do consumidor. Template atualizado no checkout não altera pacote npm
+publicado; a atualização pública depende de nova versão imutável.
+
 ## Funcionamento da linha v3
 
 A documentação descreve `autonomy-v1`; publicação e qualificação devem ser

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

@@ -1 +1 @@
-6.0
+6.2

package/templates/.agents/zaip-aios/guides/14-troubleshooting.md

@@ -5,7 +5,7 @@
 3. Rode doctor, validadores focados e `git diff --check`.
 4. Confira versoes, paths, encoding, variaveis e arquivos gerenciados.
 5. Compare `manifest.json`, `summary.json`, índices e chunks de `records/lifecycle`, sem varrer records.
-6. Corrija a causa, repita a reproducao e depois os gates completos.
+6. Corrija a causa e repita a reprodução e as verificações afetadas. Execute gates completos somente quando o impacto ou a qualificação final exigir; preserve provas ainda válidas do mesmo candidato e ambiente.
 
 Se uma Task estiver presa em executing/verifying, use o popup Reconciliar para o backlog global. O reparo aceita `task_complete` exato, marca Run orfa apos dez minutos como failed e usa blocked quando faltam gates; nunca infere cancelamento. A v4 deve conciliar a tentativa **atual** no fechamento ou próximo evento Codex da mesma Task, sem varredura global automática na abertura do dashboard. Se o host parou e não houve novo evento, relate a pendência em vez de dizer que ela ainda está executando.
 
@@ -27,6 +27,11 @@ Se “finalizar o documento” tentou entregar um PRD `draft`, confira adapters/
 | Responsável já fechado sem decisão | Recuperação autorizada/nova tentativa; reconciliação repetida não cria aprovação |
 | Perfil Essencial tentou Astra automático | Rejeite a seleção; não trate fallback/herança como autorização |
 | Snapshot de Runs incompleto | Rebuild explícito dos manifests; não invente campos ou faça varredura JSONL oculta na query |
+| `executor_missing` antes do Gui | Consulte `run closure --id RUN-ID --preflight --json`; executor iniciado/falho não satisfaz conclusão. Preserve `blocked`/`failed` quando cabível; não crie executor cerimonial. |
+| Recuperação acusa outro dono do turno | Confira recibo e identidade exatos. A exceção de observação passiva exige a forma canônica do guia 16; dono operacional continua bloqueando. |
+| Cache sem reaproveitamento | Inspecione `--plan` no rapid check do mantenedor e as razões por grupo. `identity-changed` difere de `no-proof`; não retire SHA, assinatura ou verificação de dependências para forçar um hit. |
+| `run finish --view compact` demora | Compacto descreve a saída, não o custo interno. Examine o processo iniciado, telemetria, locks e projeções; não dispare fechamento concorrente nem atribua a causa sem medição. |
+| Release GitHub existe, npm ainda não | Acompanhe o publicador até resultado terminal e confira versão/integridade no registry. Preserve tag/TGZ; reparo de controle exige a rota autenticada, não reempacotamento da mesma versão. |
 
 A tolerância de dez minutos para Run órfã no reparo manual não é prazo de
 desistência de Task em atividade. Um timeout operacional também não comprova

package/templates/.agents/zaip-aios/guides/16-lifecycle-e-reconciliacao.md

@@ -122,3 +122,45 @@ uma autorização humana apenas no texto não substitui o contrato capturado.
 No fluxo nativo atual, editar produto exige posse central de escrita: `zaip task workspace TASK-ID --run RUN-ID`. A posse usa a raiz Git comum entre chats e worktrees e valida o dono e a Run; indisponibilidade bloqueia edição. Registros canônicos de lifecycle têm bootstrap próprio. Mensagens entre chats coordenam, mas não substituem Task, Run e claim. Alterações de produto sem proveniência única no checkout compartilhado bloqueiam transferência e limpeza automática até reconciliação.
 
 Para checkout isolado terminal, `zaip task workspace TASK-ID --run RUN-ID --close` inventaria arquivos e ignorados, exige integração se a Task concluiu, cria e testa backup em `.local/backup-branchs` e `.local/backup-worktrees` e só então remove worktree e branch. Ignorados desconhecidos ou backup não recuperável bloqueiam. `.local` fica fora do Git; o usuário limpa seus backups manualmente depois de conferi-los.
+
+## Diagnóstico antecipado e respostas compactas
+
+Antes de despachar Gui, consulte `zaip run closure --id RUN-ID --preflight --json`.
+`completion_preflight.completion_allowed` verifica a autoridade para concluir:
+executor elegível **concluído** ou autorização direta válida desde a captura.
+Executor ausente ou falho retorna `executor_missing`. `blocked_or_failed_allowed`
+preserva uma avaliação verdadeira de inconclusão; não autoriza `completed`.
+`active_descendant_ids` e `finalizer_dispatch_ready` informam separadamente
+descendentes ativos e se já houve finalizador. Leia os campos em conjunto:
+prontidão de despacho não significa aprovação. `execution native-next` também
+fornece esse diagnóstico. O preflight é somente leitura; Evidence, revisão
+aplicável e as barreiras de `run finalization`/`run finish` continuam exigidas.
+
+`zaip manifest reconcile --id ID --view compact --json` e
+`zaip run finish --id RUN-ID --status completed --view compact --json` retornam
+resumos explícitos. O primeiro reconcilia a entidade indicada; o segundo só pode
+concluir quando os gates permitirem. O JSON padrão e `--view full` preservam
+o contrato anterior. Saída compacta reduz texto, não elimina coleta de telemetria,
+leitura de Runs ou cálculo de reconciliação.
+
+## Recuperação pós-publicação e histórico bloqueado
+
+Use `task recover-post-publication` e `task resume-post-publication` conforme
+a [skill de fechamento](../../skills/zaip-skill-lifecycle-closure/SKILL.md).
+O recibo autenticado vincula publicação imutável, manutenção concluída,
+autorização, Task/Execution e responsável único. Um avanço posterior do ciclo
+não apaga a publicação anterior: sua linha deve continuar única e conservar o
+SHA. A Task histórica não recebe autorização para editar produto antigo.
+
+Uma raiz observacional passiva pode compartilhar o turno sem ser dona da entrega.
+A exceção exige cliente/thread/turno exatos, forma canônica de observação,
+autor ausente ou compatível, ausência de Task/Change/Execution/Conversation,
+de autorização operacional e de descendentes. Outro responsável real continua
+sendo conflito. Não converta uma Run operacional em observação para liberá-la.
+
+`task assurance TASK-ID --inherit-applicability-attempt N --run RUN-ID --json`
+admite herança autenticada na recuperação Task-first, além da rota SPEC;
+preserva plano, critérios, Decisions e hashes e valida o recibo consumido e o
+turno observado. Não fabrica Evidence nova. Tasks bloqueadas por decisão humana
+permanecem bloqueadas até retomada autorizada e comprovada. Testes de interrupção
+e replay não concluem Tasks históricas reais.

package/templates/.agents/zaip-aios/guides/18-catalogo-de-agentes.md

@@ -72,7 +72,7 @@ O dispatch autônomo passa os `Task.write_scopes` a essa seleção **por Task**
 
 O `budget.soft_cycles` também acompanha o agente selecionado por Task e governa seu checkpoint suave. Tokens continuam observados para telemetria e custo, mas não interrompem nem exigem checkpoint. Para comparar agentes, use `zaip run aggregate --agent agent-ID`; o resultado inclui duração coberta, ciclos de uso observados, tokens, custo, cobertura e Runs de rework.
 
-Nanda (`agent-reviewer`) usa `gpt-6-sol` com esforço `medium` e `soft_cycles: 12`, proporcional à revisão standard. Ana (`agent-auditor`) usa `gpt-6-sol`/`high` para auditoria crítica ou explicitamente auditável; Luiz (`agent-security-auditor`) usa `gpt-6-sol`/`high` para auditoria de segurança explícita.
+Nanda (`agent-reviewer`) usa `gpt-6.1-sol` com esforço `medium` e `soft_cycles: 12`, proporcional à revisão standard. Ana (`agent-auditor`) usa `gpt-6.1-sol`/`high` para auditoria crítica ou explicitamente auditável; Luiz (`agent-security-auditor`) usa `gpt-6.1-sol`/`high` para auditoria de segurança explícita.
 
 ## Dashboard e segurança operacional
 

package/templates/.agents/zaip-aios/guides/23-orquestracao-de-modelos.md

@@ -66,7 +66,7 @@ partir do terceiro, quando a rota válida o selecionar; não se torna reviewer
 ou finalizer. A exceção de execução não acrescenta tentativas nem amplia
 write scopes.
 
-Os dois primeiros replanejamentos usam `gpt-6-sol`; o terceiro e os
+Os dois primeiros replanejamentos usam `gpt-6.1-sol`; o terceiro e os
 seguintes permitidos usam `gpt-6-astra`. Executor e replanejador são
 invocações diferentes. Um plano Astra não obriga o executor a usar Astra.
 
@@ -93,15 +93,36 @@ telemetria de duração e checkpoints têm outras funções. Resultado desconhec
 não libera despacho duplicado. Para retomada, consulte o diário existente,
 não crie outra Task ou apague `.local` para renovar a quota.
 
+## Sol 6.1 e escolha de Luna/high
+
+Novas seleções Sol usam `gpt-6.1-sol`, inclusive baseline, revisão, Gui e os dois primeiros replanejamentos. Luna continua `gpt-6-luna` e Astra continua `gpt-6-astra`; Terra não participa de novas seleções. Defaults legados Sol 6 e Terra/Sol 5.6 são normalizados em memória ao ler a configuração. Histórico, custos antigos e cabeçalhos de Runs permanecem com as identidades originais.
+
+Na instalação/atualização autorizada, o instalador também persiste a migração dos IDs conhecidos no `project.yaml`, com backup, preservação de comentários e deduplicação da allowlist. Preferências manuais do Codex e identidades históricas não são reescritas.
+
+Um plano congelado com Sol 6 permanece legível, mas não autoriza novo despacho automático: exige replanejamento explícito. Ausência de Sol 6.1 no host bloqueia sem downgrade. Os perfis gerados precisam estar carregados na sessão do Codex; escrever o TOML não comprova recarga. A seleção manual do principal continua pertencendo ao usuário.
+
+Recomendação operacional, ainda sem benchmark comparativo neste projeto:
+
+| Situação | Recomendação |
+| --- | --- |
+| Mudança mecânica ou extração simples com aceite claro | Luna/low |
+| Problema local delimitado que exige mais raciocínio, com teste decisivo barato | Comparar Luna/high com Sol 6.1/medium |
+| Implementação em vários módulos, ambiguidade ou custo alto de correção | Sol 6.1/medium; high quando a dificuldade justificar |
+| Auditoria ampla, segurança ou arquitetura difícil | Sol 6.1/high; Astra só pela rota autorizada |
+
+Luna/high é permitido por override explícito válido, mas não é o default automático, não altera revisores/Gui e não recebe equivalência presumida com Sol/medium. Compare os mesmos ACs, ambiente e conjunto de tarefas: aprovação na primeira revisão, reparos, duração total e custo por tarefa aprovada. Se falhar por compreensão/hipótese, prefira a rota governada Sol 6.1 em vez de insistir com mais esforço no Luna; mantenha os limites de recuperação. Mais esforço pode aumentar tokens e latência.
+
+Fontes oficiais consultadas em 2026-10-10: [Sol 6.1](https://developers.openai.com/api/docs/models/gpt-6.1-sol), [Luna](https://developers.openai.com/api/docs/models/gpt-6-luna) e [reasoning effort](https://developers.openai.com/api/docs/guides/reasoning). Os preços API por 1M de tokens sem cache são US$2/US$10 (entrada/saída) para Sol 6.1 e US$0,10/US$0,50 para Luna: diferença de 20 vezes por token, não economia total garantida nem consumo equivalente da assinatura Codex.
+
 ## Família de modelos
 
 | Modelo | Papel dentro da política ZAIP |
 | --- | --- |
 | `gpt-6-luna` | Implementação/testes simples, locais e delimitados: low; alto volume delimitado conforme sinais |
-| `gpt-6-sol` | Execução padrão: medium; complexidade/ambiguidade alta: high; reviewer/Gui: medium; auditor: high |
+| `gpt-6.1-sol` | Execução padrão: medium; complexidade/ambiguidade alta: high; reviewer/Gui: medium; auditor: high |
 | `gpt-6-astra` | Diagnóstico crítico difícil evidenciado e replanejamento/execução autorizados a partir do terceiro plano: high |
 
-Os antigos `gpt-5.6-terra` e `gpt-5.6-sol` migraram para `gpt-6-sol`;
+Os antigos `gpt-5.6-terra` e `gpt-5.6-sol` migraram para `gpt-6.1-sol`;
 `gpt-5.6-luna` migrou para `gpt-6-luna`. A preferência Sol do catálogo é um
 baseline. Ela não substitui a política de um perfil persistido nem altera os
 nomes dos modelos em registros históricos.

package/templates/.agents/zaip-aios/guides/26-qualidade-e-release.md

@@ -1,5 +1,25 @@
 # Qualidade e qualificação de release
 
+## Ajustes e publicação na v6.2
+
+Pedidos diretos de finalizar pendências, atualizar documentação e publicar uma
+versão explícita são reconhecidos pelo contrato. “Pode fazer os ajustes e
+publicar” segue a política do projeto e seu ciclo corrente; não infere versão
+arbitrária nem amplia o escopo. Perguntas, citações, negações e espera por
+aprovação humana permanecem sem autoridade de publicação.
+
+Para ajustes e publicação autorizados juntos, mantenha uma única Task crítica
+direta e use o modo `--integrated-task` do freeze. Uma Task já concluída não deve
+ser reutilizada para novos arquivos: normalmente o intake exige novo turno para
+outra entrega. Planejar o coordenador integrado desde a captura evita essa
+interrupção sem eliminar revisão, finalizador, CI ou qualificação assinada.
+
+Confira README, guias, templates e a instalação do TGZ final 6.2.0. Sol 6.1 e
+Luna/high estão detalhados no guia 23. Preserve as notas históricas de auditoria;
+esta mudança não constitui nova medição de qualidade ou redução de custo.
+
+## Critérios de qualificação
+
 O candidato de release precisa passar gates locais, clean-room e distribuição pública sem confundir validação técnica com aprovação de produção.
 
 As decisões de [lifecycle v4](28-lifecycle-completo.md#contrato-aprovado-para-a-v4-a-implementar-e-qualificar)
@@ -263,6 +283,89 @@ defina uma medição independente com artefatos identificados e falhas observada
 
 ## Evolução de confiabilidade e documentação
 
+A evolução recente, as provas da v6.1 e os limites da auditoria estão nas seções
+seguintes. Os registros abaixo preservam sua data e seu candidato.
+
+### Patch imutável e fechamento separado
+
+A linha corretiva separa produto `N.N`, pacote `N.N.P` e tag `vN.N.P`. Patch exige
+pedido explícito e contrato assinado próprio; não substitui bytes publicados nem
+avança por si só o ciclo de produto. O parser distingue pedido direto de citação,
+negação, pergunta e condição. Misturar patch e minor ou informar versões ambíguas
+não autoriza publicação. Consulte a [skill de deploy](../../skills/zaip-skill-github-deploy/SKILL.md).
+
+Se o publicador falhar depois da Release, preserve candidato e TGZ. Reparo de
+controle usa SHA e CI próprios, ancestralidade e inventário restrito; cada commit
+intermediário é inspecionado. O publicador instala dependências do lockfile com
+scripts desabilitados antes do verificador, sem recompilar o produto assinado.
+O CI do reparo não substitui a qualificação do pacote.
+
+Distinga qualificação do candidato, publicação GitHub, versão/integridade npm e
+fechamento Task/Change/Execution. O commit posterior de metadata tem CI próprio
+e conserva a tag no SHA publicado. Alterar documentação ou sincronizar templates
+localmente não modifica o pacote no npm; novos bytes exigem nova versão publicada.
+
+### Eficiência medida e prevenção de retrabalho
+
+O rapid check do mantenedor resume contagens, seleção e cache no console;
+`--plan` conserva o diagnóstico completo. Grupos limitados a dependências estáticas
+comprovadas podem usar sua identidade; os demais preservam SHA exato e limpeza
+do checkout. Uma mudança de identidade pode invalidar provas legítimas.
+Reuso exige identidade, dependências, ambiente, política e autoridade compatíveis.
+
+Antecipe formatação, paridade e contratos baratos antes dos gates longos.
+Após correção, revalide o impacto e a prova invalidada; não repita testes só para
+criar artefatos. Registre preparo, qualificação, pre-main, CI, publicação e
+fechamento separadamente, com hits/misses e causas. Duração de uma etapa,
+quantidade de testes e resposta curta não demonstram economia total.
+
+### Fotografia da auditoria de 10/10/2026 — v6.1
+
+Escopo: delta de código, evidências existentes e consultas de Release/npm/CI;
+sem nova suíte completa, teste de intrusão, ensaio visual ou operação prolongada.
+As notas são avaliações técnicas do chat, não certificações nem gates.
+
+| Dimensão | Nota / 10 |
+| --- | ---: |
+| Funcionalidade e CLI | 8,7 |
+| Governança e fechamento | 8,5 |
+| Eficiência e prevenção de retrabalho | 7,0 |
+| Recuperação e resiliência | 8,0 |
+| Segurança e controles | 8,7 |
+| Testes e qualidade das evidências | 8,8 |
+| Distribuição e publicação | 9,2 |
+| Arquitetura e manutenção | 8,0 |
+| Observabilidade e rastreabilidade | 8,0 |
+| Documentação e README | 8,7 |
+
+Média simples arredondada: **8,4/10**; prontidão para produção avaliada
+separadamente: **8,2/10**, com acompanhamento. A qualificação assinada passou
+20 gates em 871096 ms (14min31s); pre-main passou 28 grupos com 837 arquivos
+selecionados e zero hits (26 `identity-changed`, dois `no-proof`). O gate de
+tamanho registrou 2332 arquivos, 181 avisos e zero erros. Esses números pertencem
+ao candidato e ambiente observados, não são SLA nem medição dos consumidores.
+
+Candidato: `7bf498e2bea42f8739a73e1bd32b8c2105834a85`;
+[Release v6.1](https://github.com/zaip-ai/zaip-aios/releases/tag/v6.1),
+[npm 6.1.0](https://www.npmjs.com/package/@zaip-ai/cli/v/6.1.0),
+[CI do candidato](https://github.com/zaip-ai/zaip-aios/actions/runs/38083472311),
+[publicador](https://github.com/zaip-ai/zaip-aios/actions/runs/38083583146) e
+[CI do fechamento](https://github.com/zaip-ai/zaip-aios/actions/runs/38084917032)
+foram confirmados; `latest` apontava para 6.1.0 na consulta. Task, Change e
+Execution da entrega estavam `completed`; a captura do finalizador usou fallback
+oficial, sem inventar telemetria. O commit de fechamento foi
+`9e0417f4826615d4723d2bb768808581c0c6a8f5`. As Tasks históricas v5.7/v5.8
+permaneceram bloqueadas por decisão humana, sem impedir essa conclusão.
+
+Pendências propostas, **não implementadas por esta revisão documental**:
+ampliar cache por dependências comprovadas; medir e reduzir cálculo interno do
+fechamento; antecipar checks baratos; exercitar consumidor limpo com hooks nativos,
+interrupção, retomada e fechamento automático; reduzir avisos por refatorações
+coesas. A recuperação tem provas em fixtures integradas; isso não comprova
+fechamento histórico real nem estabilidade prolongada.
+
+### Referências das linhas anteriores
+
 A [matriz de evolução](https://github.com/zaip-ai/zaip-aios/blob/main/docs/quality/v50-documentacao-editorial.md)
 vincula as dez frentes aos seus comandos, provas, rollback e limitações.
 READMEs PT/EN descrevem o mesmo contrato: `essential-v3` por padrão,

package/templates/.agents/zaip-aios/guides/27-telemetria-git-native.md

@@ -179,6 +179,18 @@ combinação de hashes válidos, cobertura explícita e leitura do período real
 
 ## Caminho atual de consulta e limites de performance
 
+Em recuperação com `same_turn_handoff`, predecessor e sucessor lógico podem
+compartilhar uma invocação física. Correlação e tokens observados permanecem
+no proprietário original: coleta individual, em lote e no fechamento não devem
+contabilizar o mesmo transcript novamente. Sem fronteira observável de consumo,
+o sucessor mantém uso indisponível, não zero nem estimativa apresentada como medida.
+Hooks e tracking continuam independentes da autorização de entrega.
+
+Se a identidade rica do filho não puder ser resolvida, somente o fallback oficial
+elegível de captura terminal pode registrar o evento observado. Modelo, effort,
+tokens e custo ausentes continuam indisponíveis. Isso não comprova que a correlação
+nativa rica funcionou e não autoriza duplicar um agente já concluído.
+
 A descrição manifest-first acima inclui o caminho de compatibilidade.
 No runtime SQLite, a primeira dobra do Monitor usa agregados compactos;
 detalhes de Runs ficam em endpoints paginados explícitos. Queries preservam

package/templates/.agents/zaip-aios/guides/28-lifecycle-completo.md

@@ -198,6 +198,14 @@ zaip run closure RUN-ID
 
 ## Fechamento e retomada de Tasks
 
+Antes do último Gui, consulte o [preflight do guia 16](16-lifecycle-e-reconciliacao.md#diagnóstico-antecipado-e-respostas-compactas).
+Ele separa autoridade para `completed`, descendentes ativos e prontidão de
+despacho; não substitui decisão nem gates. Recuperação pós-publicação revalida
+recibo, publicação e proprietário único; observação passiva elegível não é outro
+executor. Em `same_turn_handoff`, a telemetria física é atribuída uma única vez,
+conforme o [guia 27](27-telemetria-git-native.md). Saída compacta preserva o cálculo
+interno e não comprova menor duração.
+
 Antes de uma Run raiz terminar, sua Task deve estar em um destes estados:
 
 - `completed`: resultado e gates aprovados;