@zaip-ai/cli 2.2.0 → 3.0.0

package/templates/.agents/skills/zaip-skill-test-data/scripts/generate.mjs

@@ -0,0 +1,72 @@
+import { lstat, mkdir, readFile, realpath, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+
+const [output, ...rest] = process.argv.slice(2);
+if (!output || (rest.length !== 0 && (rest.length !== 2 || rest[0] !== "--seed"))) {
+  throw new Error("Usage: generate.mjs <output.json> [--seed <text>]");
+}
+const seed = rest[1] ?? "zaip-test-data";
+if (seed.length === 0 || seed.length > 120) throw new Error("seed must contain 1-120 characters");
+const fixture = createFixture(seed);
+const target = resolve(output);
+await safeOutput(target);
+await mkdir(dirname(target), { recursive: true });
+if (await unchanged(target, fixture))
+  process.stdout.write(`${JSON.stringify({ written: false, fixture }, null, 2)}\n`);
+else {
+  if (await existing(target)) throw new Error("refusing divergent existing output");
+  await safeOutput(target);
+  await writeFile(target, `${JSON.stringify(fixture, null, 2)}\n`, {
+    encoding: "utf8",
+    flag: "wx",
+  });
+  process.stdout.write(`${JSON.stringify({ written: true, fixture }, null, 2)}\n`);
+}
+function createFixture(seed) {
+  const suffix = hash(seed).toString(36).padStart(7, "0").slice(-7);
+  return {
+    schema_version: 1,
+    seed,
+    tenants: [
+      { id: `tenant-${suffix}-a`, name: "Tenant A" },
+      { id: `tenant-${suffix}-b`, name: "Tenant B" },
+    ],
+    users: [
+      { id: `user-${suffix}-owner`, tenant_id: `tenant-${suffix}-a`, role: "owner" },
+      { id: `user-${suffix}-member`, tenant_id: `tenant-${suffix}-a`, role: "member" },
+      { id: `user-${suffix}-other`, tenant_id: `tenant-${suffix}-b`, role: "owner" },
+    ],
+  };
+}
+async function unchanged(path, fixture) {
+  try {
+    return (await readFile(path, "utf8")) === `${JSON.stringify(fixture, null, 2)}\n`;
+  } catch {
+    return false;
+  }
+}
+async function existing(path) {
+  try {
+    await lstat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function safeOutput(path) {
+  for (let current = dirname(path); ; current = dirname(current)) {
+    const stat = await lstat(current).catch(() => null);
+    if (stat) {
+      const resolved = await realpath(current);
+      if (stat.isSymbolicLink() || resolved.toLowerCase() !== resolve(current).toLowerCase())
+        throw new Error("output path cannot use a symbolic link or junction");
+    }
+    const parent = dirname(current);
+    if (parent === current) break;
+  }
+}
+function hash(value) {
+  let total = 2166136261;
+  for (const character of value) total = Math.imul(total ^ character.charCodeAt(0), 16777619);
+  return total >>> 0;
+}

package/templates/.agents/skills/zaip-skill-testing-strategy/SKILL.md

@@ -0,0 +1,15 @@
+---
+name: zaip-skill-testing-strategy
+description: Map acceptance risks to focused unit, integration, contract, and end-to-end tests with meaningful evidence.
+---
+
+# Plan tests
+
+Use when a change needs a proportionate verification plan or existing tests do not prove important behavior.
+Read `references/example-map.md` for a Hono and Kysely multi-tenant mutation.
+
+1. Start with acceptance criteria, failure modes, external boundaries, and user-visible states rather than a target coverage number.
+2. Choose the lowest layer that can prove each behavior; use real integration boundaries when mocks cannot prove configuration or policy.
+3. Define deterministic fixtures, isolation, cleanup, and the observable assertion for each high-risk case.
+4. Include unauthorized, invalid, retry, and regression cases where the altered behavior makes them meaningful.
+5. Keep test execution evidence separate from a test plan and record baseline failures as baseline failures.

package/templates/.agents/skills/zaip-skill-testing-strategy/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Testing Strategy"
+  short_description: "Map risks to meaningful test evidence"
+  default_prompt: "Use $zaip-skill-testing-strategy to create a focused verification strategy for this change."

package/templates/.agents/skills/zaip-skill-testing-strategy/references/example-map.md

@@ -0,0 +1,3 @@
+# Example map
+
+A Hono multi-tenant mutation needs a unit test for use-case invariants, a route contract test for validation and response, a Kysely integration test for transaction and tenant context, and a UI assertion for loading, validation error, and success feedback. Add a cross-tenant denial test through the actual database access path.

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

@@ -5,6 +5,8 @@ description: Discover, install, configure, authenticate, enable, disable, and di
 
 # Configurar tools ZAIP
 
+Aplique a proteção do computador local de `RULE-CORE`: nunca reinicie/desligue o PC, inclusive por instaladores ou scripts de configuração. Suprima reinício automático com opções documentadas ou pare a etapa. Reiniciar/reabrir o Codex refere-se somente ao aplicativo; reinício do Windows fica a cargo do usuário.
+
 1. Leia `.agents/tools/catalog.yaml` e somente o manifesto da tool solicitada.
 2. Execute `scripts/inspect-tool.mjs <id> [mcp|api]` para produzir um plano sem segredos.
 3. Confirme que a implementacao ou URL MCP e oficial, verificavel ou mantida pelo ZAIP; nunca invente pacote.

package/templates/.agents/skills/zaip-skill-website-readiness/SKILL.md

@@ -5,6 +5,9 @@ description: Build capability-aware websites with discoverable agent-readable me
 
 # Website and Agent Readiness
 
+Para componentes de UI novos ou alterados, carregue também
+`$zaip-skill-frontend-componentization`.
+
 Use this skill for `apps/site/**`, landing pages, institutional websites, SEO, GEO,
 Markdown for Agents, or an Agent Readiness audit. Jonny owns implementation inside the
 site scope; Manu remains the owner of central design rules and must be called first when
@@ -21,6 +24,11 @@ the work changes `DESIGN.md`, design tokens, or canonical components.
    [references/capability-checklist.md](references/capability-checklist.md).
 6. Verify the rendered HTML, structured data, crawler files, Markdown representation,
    links, and response headers. Record unsupported capabilities explicitly.
+7. Publish only to the configured validation branch and the site's own validation
+   environment. Production promotion follows the [deployment and access
+   contract](../zaip-skill-backend/references/deployment-environments.md); a
+   Supabase query, when relevant, uses only a configured READ-ONLY-BETA or
+   READ-ONLY-PROD context.
 
 ## Required outcomes
 

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

@@ -29,7 +29,7 @@ introduzidos em releases mais novas.
 | Consultar instalação detalhada | [20 — Instalação detalhada](guides/20-instalacao-detalhada.md) |
 | Consultar telemetria do Monitor | [21 — Telemetria do Monitor de Custos](guides/21-telemetria-monitor-custos.md) |
 | Entender fluxos e roteamento | [22 — Fluxos e roteamento](guides/22-fluxos-e-roteamento.md) |
-| Escolher modelos e limitar o diagnóstico Astra | [23 — Orquestração de modelos](guides/23-orquestracao-de-modelos.md) |
+| Entender modelos, delegação e escalada por preset | [23 — Orquestração de modelos](guides/23-orquestracao-de-modelos.md) |
 | Entender cálculo e fontes de custo | [24 — Cálculo](guides/24-calculo-de-custos-openai.md) e [25 — Fontes](guides/25-fontes-de-precos-openai.md) |
 | Consultar qualidade e release | [26 — Qualidade e release](guides/26-qualidade-e-release.md) |
 | Entender a telemetria Git-native | [27 — Telemetria Git-native](guides/27-telemetria-git-native.md) |
@@ -60,3 +60,11 @@ introduzidos em releases mais novas.
 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
+
+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)
+e [16 — Fechamento](guides/16-lifecycle-e-reconciliacao.md).
+Perfil de instalação, assurance e autonomia são configurações distintas.
+As fontes em qualificação não comprovam disponibilidade no npm nem produção.

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

@@ -40,8 +40,10 @@ presença de uma instrução ou screenshot não comprova execução naquele ambi
 - Use o guia 16 para entender status, reconciliacao e a ordem de finalizacao.
 - Use os guias 17 e 24 a 25 para interpretar tokens, precificacao e conversao de moeda.
 - Use o [guia 08](guides/08-contexto-e-tokens.md) para consultas com contexto enxuto e
-  o [guia 23](guides/23-orquestracao-de-modelos.md) para a divisão Luna/Terra/Sol e o
-  diagnóstico Astra em `high`, limitado a três invocações por tarefa.
+  o [guia 23](guides/23-orquestracao-de-modelos.md) para modelos, seleção manual do principal e escaladas governadas pelo preset.
+- Use o [guia 19](guides/19-assurance-e-autonomia.md) para Essencial (4/1),
+  Equilibrado (10/3) e Persistente ilimitado: execuções/replanejamentos por Task,
+  configuração no YAML/Dashboard e limites atuais do despacho gerenciado.
 - Use os guias 18 a 28 quando precisar do contrato completo de agentes, lifecycle, telemetria, qualidade, instalacao ou roteamento.
 
 O instalador npm projeta esta pasta da `.agents` canonica para o tarball e a
@@ -51,9 +53,28 @@ Os manuais completos em português e inglês são instalados como
 `.agents/README.md` e `.agents/README-ENG.md`; os READMEs da raiz do consumidor
 permanecem sob sua autoria.
 
+A Ajuda do Dashboard incorpora estes arquivos no build. Em inglês, carrega o
+README inglês canônico; os 28 guias atualmente têm fonte em português e são
+apresentados com aviso de idioma, sem traduções resumidas paralelas obsoletas.
+
 Para concluir trabalho, use [revisão e validação](guides/07-revisao-e-validacao.md)
 e o [contrato de prova observável](../skills/zaip-skill-change/references/observable-evidence.md).
 Registros estruturados validam vínculos, não substituem o exame do resultado.
 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.
+
+## Novidades em preparação para v3
+
+A documentação descreve `autonomy-v1` sem declarar release publicada.
+Os manifests deste checkout identificam o candidato `3.0.0`. Novos templates usam
+Equilibrado e `execution.runtime: managed`: PRDs/SPECs gerenciados e tarefas
+avulsas preferencialmente diretas. Configurações legadas sem essa opção mantêm
+o default manual do schema; salvar configuração não inicia execução.
+Não há desistência por duração nem diminuição automática de ACs.
+Gui finaliza a tentativa da Task como último filho direto, não cada trabalhador.
+
+O controle determinístico exige despacho gerenciado; chamadas nativas externas
+não recebem essa garantia por instrução. Tasks legadas não são migradas
+silenciosamente. O guia 19 descreve a autorização imutável da raiz Task direta;
+ela dispensa executor fictício, mas preserva revisão, Evidence e Gui.

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

@@ -1 +1 @@
-2.0
+3.0

package/templates/.agents/zaip-aios/guides/01-primeiros-passos.md

@@ -5,8 +5,12 @@
 3. Classifique a entrada: Conversation, Task avulsa, SPEC ou PRD. Pergunta/análise read-only é Conversation e não cria Task.
 4. Carregue somente Rules, Requirements e skills aplicaveis.
 5. Defina aceite verificavel antes de editar.
-6. Antes de escrita persistente, inicie Task, Change, Execution e Run raiz do orquestrador; execute Sub-Runs, teste e registre evidencias no ciclo de vida ativo.
+6. Antes de escrita persistente, inicie Task, Change, Execution e Run raiz do orquestrador; priorize trabalho direto na avulsa, delegue apenas quando necessário e respeite os gates de fechamento vigentes; teste e registre evidências no ciclo ativo.
 
 Evite varrer `.agents/records/`: abra um record apenas quando possuir seu ID.
 
 Para PRD/SPEC, diferencie conversa de criação: “me ajude a pensar” não cria artefato; “crie” persiste o pacote `draft` completo e sua telemetria. Faça até cinco perguntas críticas por turno, no máximo três turnos; depois registre decisões delegáveis da IA. Tasks reais só nascem em `ready|execute`.
+
+Para os novos controles, leia [perfis de autonomia](19-assurance-e-autonomia.md)
+e [modelos](23-orquestracao-de-modelos.md): perfil não ativa provider nem migra
+Tasks legadas. O principal avulso mantém sua seleção; filhos seguem política divulgada.

package/templates/.agents/zaip-aios/guides/03-tasks.md

@@ -7,7 +7,7 @@ Use Task para uma entrega pequena, independente e com um resultado claro.
 3. Vincule Requirements aplicaveis.
 4. Liste arquivos ou componentes provaveis, sem congelar a solucao.
 5. Defina verificacoes proporcionais ao risco.
-6. Use uma Run raiz do orquestrador por tentativa, finalize os Sub-Runs de trabalho e execute o finalizador como ultimo filho.
+6. Use um orquestrador responsável por tentativa; se delegado pelo macro, sua Run conserva o pai real. Finalize os Sub-Runs de trabalho e execute Gui como último filho direto desse responsável.
 7. Antes de a Run terminar, mova a Task para completed, blocked, failed ou cancelled; nunca deixe executing/verifying.
 8. Retome blocked com `task resume`; trate failed com `task rework` na mesma Task. Completed/cancelled sao imutaveis.
 
@@ -15,4 +15,17 @@ Em PRD/SPEC `draft`, a lista visível vem dos blueprints do PreparedPlan e não
 
 ## Modelo, effort e velocidade
 
-Conversation e Task-first preservam o modelo, o reasoning effort e a velocidade selecionados manualmente no Codex. A única forma suportada de executar trabalho de produto mais rápido é usar Fast manualmente em uma Task-first realmente independente; o ZAIP não ativa nem persiste essa seleção. Uma Task descendente de PRD ou SPEC segue a orquestração automática do pai e executa sempre com velocidade `standard`, mesmo quando for acionada no menor grão.
+Conversation e o principal de Task avulsa preservam a seleção manual do Codex e
+preferem execução direta. Se subagentes forem necessários, informe que modelo e
+esforço podem diferir conforme catálogo/preset ZAIP. A exceção de Astra manual
+no Essencial só vale para o principal avulso. A seleção automática solicita
+velocidade `standard`; Fast manual não é herdado pelo fluxo gerenciado.
+
+## Orçamento e retomada
+
+[Autonomia](19-assurance-e-autonomia.md) é por Task estável: Essencial 4/1,
+Equilibrado 10/3, Persistente ilimitado (execuções/replanejamentos).
+Reiniciar, retomar ou mudar o YAML não zera a quota. `attempt_count` do lifecycle
+e reservas de execução do diário não são o mesmo contador.
+Falta de prova termina `blocked`; erro técnico impeditivo comprovado termina
+`failed`. Não diminua ACs nem use duração como critério de desistência.

package/templates/.agents/zaip-aios/guides/04-specs.md

@@ -18,3 +18,16 @@ Uma SPEC planeja a entrega; nao autoriza mudancas externas por si so.
 Use uma SPEC por padrão. Separe outra somente quando as capacidades puderem ser implementadas e verificadas em paralelo contra contratos estáveis, sem dependência ou write scope conflitante. Dependências e ordem ficam na DAG de Tasks da mesma SPEC.
 
 Toda Execution originada por SPEC usa velocidade `standard` em suas Tasks, Runs e Sub-Runs. A seleção manual de Fast no Codex não substitui essa política. Se uma necessidade urgente for realmente pequena e independente da DAG e dos gates parentais, ela pode ser tratada como Task-first com velocidade manual; não fragmente uma SPEC artificialmente apenas para executar mais rápido.
+
+## Autonomia e continuidade da DAG
+
+O [preset](19-assurance-e-autonomia.md) é aplicado por Task, não como teto
+compartilhado do macro. Dez Tasks Equilibradas permitem até 100 execuções
+(10 iniciais + 90 reparações) e 30 replanejamentos, sem prazo de abandono.
+Use um orquestrador responsável por tentativa de Task e Gui como seu último
+filho direto. Gates parentais continuam separados.
+
+Se um nó ficar bloqueado/falhado, continue somente ramos independentes
+elegíveis; não repita nós concluídos nem libere dependentes sem conclusão.
+A política gerenciada não intercepta chamadas nativas externas do Codex.
+Não ative outra forma de execução nem migre estados legados implicitamente.

package/templates/.agents/zaip-aios/guides/05-prds.md

@@ -36,3 +36,16 @@ PRD cancelado permanece imutável. Novo planejamento cria sucessor `draft`, tag
 Qualquer dependência técnica entre duas frentes obriga reuni-las na mesma SPEC e expressar a ordem entre Tasks. Mais de cinco exige recortar o PRD ou registrar uma decisão de exceção.
 
 Toda Execution originada por PRD usa velocidade `standard` em todas as SPECs, Tasks, Runs e Sub-Runs descendentes. Não existe skill, hook ou override de Fast para esse fluxo. A única execução de produto mais rápida suportada é Task-first realmente independente, com Fast selecionado manualmente no Codex; uma urgência não autoriza remover a estrutura necessária de PRD/SPEC.
+
+## Autonomia e continuidade da DAG
+
+O [preset](19-assurance-e-autonomia.md) é aplicado por Task, não como teto
+compartilhado do macro. Dez Tasks Equilibradas permitem até 100 execuções
+(10 iniciais + 90 reparações) e 30 replanejamentos, sem prazo de abandono.
+Use um orquestrador responsável por tentativa de Task e Gui como seu último
+filho direto. Gates parentais continuam separados.
+
+Se um nó ficar bloqueado/falhado, continue somente ramos independentes
+elegíveis; não repita nós concluídos nem libere dependentes sem conclusão.
+A política gerenciada não intercepta chamadas nativas externas do Codex.
+Não ative outra forma de execução nem migre estados legados implicitamente.

package/templates/.agents/zaip-aios/guides/06-execucao.md

@@ -1,7 +1,7 @@
 # Execucao
 
-1. Confirme Task, Change, Execution, aceite e Run raiz do orquestrador.
-2. Antes da primeira mutacao persistente, confirme Task executing e Run raiz ativa no turno atual.
+1. Confirme Task, Change, Execution, aceite e Run do orquestrador responsável, preservando o pai quando delegado pelo macro.
+2. Antes da primeira mutacao persistente, confirme Task executing e Run responsável ativa no turno atual.
 3. Inspecione o diff e preserve alteracoes alheias.
 4. Use Sub-Runs para cada subagente; a Run raiz aguarda todos os descendentes ativos.
 5. Implemente o menor incremento coerente e rode verificacoes focadas.
@@ -10,7 +10,8 @@
    produza o commit isolado quando houver mutação e persista Validation/Evidence
    do candidato exato. Falta de prova permanece pendência.
 8. Depois dos demais descendentes e das provas, execute `zaip-agent-finalizer`
-   como último filho. Nenhum filho novo pode iniciar depois dele.
+   como último filho direto do responsável da Task, não do executor. Nenhum
+   filho novo pode iniciar depois dele.
 9. Aplique a decisão terminal pela CLI: Task, Change e Execution; atualize os
    manifests e finalize a Run raiz, separando status técnico e resultado da Task.
 
@@ -25,8 +26,22 @@ procedimento nem aprova o AC sozinho.
 
 ## Modelo, effort e velocidade por origem
 
-- Conversation e Task-first preservam o modelo, o reasoning effort e a velocidade selecionados manualmente no Codex.
+- Conversation e o principal avulso preservam a seleção manual. Ao delegar por
+  necessidade, avise que modelo/esforço dos filhos podem mudar pela política ZAIP.
 - Fast para execução de produto é suportado somente em Task-first realmente independente e deve ser selecionado manualmente no Codex.
 - Executions originadas por SPEC ou PRD usam sempre velocidade `standard`, inclusive em todas as Tasks, Runs e Sub-Runs descendentes.
 - O ZAIP não ativa, persiste ou herda Fast por skill, hook, PreparedPlan ou override de Execution.
 - Selecionar uma Task descendente como menor grão não a transforma em Task-first nem remove a velocidade `standard` herdada do macro.
+
+## Reparação e finalização sem espera artificial
+
+Aplique o diário e o preset do [guia 19](19-assurance-e-autonomia.md) antes
+do despacho gerenciado. Não gere tentativas por tempo nem reexecute gates
+caros inalterados para preencher uma cota.
+
+O host persiste a decisão real do Gui antes do Stop canônico e aplica a mesma
+decisão no fechamento. Gui read-only pode retornar sem aguardar recibos;
+o relay aceita filho já terminal enquanto o responsável estiver aberto.
+Sem decisão, preserve a pendência; não infira aprovação do status nativo.
+Após decisão persistida, reconcilie `closure_pending` sem executar outro Gui
+ou recomeçar os workers. Veja [recuperação](16-lifecycle-e-reconciliacao.md).

package/templates/.agents/zaip-aios/guides/07-revisao-e-validacao.md

@@ -13,3 +13,17 @@ candidato, ambiente, locators e limitações segundo o contrato de
 `confirmed` pode complementar uma Evidence compatível, mas não substitui
 validação, revisão independente nem finalizador. `pending`, `limited`,
 `failed` e `not_applicable` não são aprovação.
+
+## Preset não reduz prova
+
+Essencial não significa revisão superficial; Persistente não autoriza
+aceite com evidência faltante. O [perfil de autonomia](19-assurance-e-autonomia.md)
+controla persistência. Assurance segue risco e domínio: comportamento para
+software, fontes/briefing para conteúdo, dados/premissas para estratégia e Ops.
+Ao esgotar recuperação, registre ACs atendidos e pendentes, sem removê-los.
+
+A decisão do finalizador seleciona seus IDs imutáveis de Evidence antes de
+validá-los. Provas antigas permanecem preservadas, mas outro candidato,
+falha ou correlação incompatível não aprova a tentativa atual.
+Reutilização exige elegibilidade e vínculo real; nunca relabele um teste
+histórico como nova execução.

package/templates/.agents/zaip-aios/guides/08-contexto-e-tokens.md

@@ -15,9 +15,10 @@ Uma pergunta simples de Marketing, Sales, Growth ou Ops recebe o contexto do dom
 necessário à resposta. Não cria Task/Change artificial nem carrega instruções de
 engenharia ou diagnóstico Astra apenas por mencionar um departamento.
 
-O [guia 23](23-orquestracao-de-modelos.md) define a escalada excepcional. A
-[Rule Astra](../../rules/astra-diagnostic.md) só é carregada ao avaliar elegibilidade:
-prova da falha, dificuldade estruturada e, no caso preventivo, impacto crítico comprovado.
+O [guia 23](23-orquestracao-de-modelos.md) distingue os replanejamentos por
+preset do diagnóstico legado. Carregue [autonomia](../../rules/autonomy-decision.md)
+quando aplicável; a [Rule Astra](../../rules/astra-diagnostic.md) detalha a
+compatibilidade e a elegibilidade, sem liberar Astra automático no Essencial.
 A consulta diagnóstica usa contexto novo e delimitado, sem histórico integral ou ferramentas;
 o executor recebe a rota corrigida e preserva os critérios de aceite originais.
 

package/templates/.agents/zaip-aios/guides/09-agentes-e-squads.md

@@ -10,7 +10,9 @@ memorizar uma lista ou inventar uma identidade.
 1. Quebre o trabalho em subtarefas concretas, independentes e verificaveis.
 2. Escolha pelo conjunto de `capabilities`, `execution_eligibility`, ferramentas
    e `write_scopes` do catalogo, nao apenas pelo titulo do agente.
-3. Use apenas o `codex_name` e o `codex_task_name` exatos do registro. Nao use
+3. Use `agent_type` com o `codex_name` exato. Envie `task_name` somente se
+   existir no schema nativo, usando o `codex_task_name` exato. Preserve UUID e
+   nickname realmente retornados, inclusive sufixos; não invente `agent_path`. Não use
    `default`, `worker`, `explorer` ou nomes ad-hoc.
 4. Defina objetivo, escopo de escrita, entradas, criterio de aceite e formato de
    retorno antes da delegacao.
@@ -18,10 +20,10 @@ memorizar uma lista ou inventar uma identidade.
 
 ## Squads
 
-As seis squads coordenam contextos recorrentes: entrega critica, analise de
-produto, design e website, marca e marketing, growth e RevOps, e vendas e
-governanca. A squad e um roteador de capacidade; a delegacao continua usando o
-agente catalogado que satisfaz o trabalho concreto.
+Os seis squads organizacionais são Product, Admin & Operations, Development,
+Delivery Assurance, Infra & Security e Growth — Sales, Marketing and Branding.
+Squad não concede capacidade ou autoridade: o roteamento usa o catálogo e os
+write scopes da Task, não a organização visual.
 
 ## Execucao e fechamento
 
@@ -30,10 +32,10 @@ orquestrador coordena a DAG, preserva a separacao de telemetria entre raiz e
 Sub-Runs e captura metadados observados apos spawn e termino. Reviewer,
 auditor ou integrador so entram quando sua capacidade for necessaria.
 
-O ultimo filho e sempre `zaip-agent-finalizer`, depois que os demais
-descendentes terminaram. Ele nao reescreve evidencia: aplica uma decisao
-restrita baseada em testes, diffs e registros reais. O resultado so deve ser
-reportado apos a barreira de finalizacao estar satisfeita.
+Gui é o último filho direto do orquestrador responsável da Task, irmão dos
+executores, nunca filho de cada trabalhador. Ele avalia e retorna uma decisão
+restrita; o host autorizado a persiste e a CLI aplica a transição. Um macro
+coordena um responsável por tentativa de Task e seus gates parentais próprios.
 
 ## Boas praticas
 
@@ -43,3 +45,9 @@ reportado apos a barreira de finalizacao estar satisfeita.
 - Use paralelismo apenas quando reduzir o caminho critico sem elevar conflito.
 - Escale bloqueios de autoridade, credencial, seguranca ou escopo; nao suponha
   permissao externa.
+
+Tarefas avulsas preferem execução direta; quando delegar for necessário, informe
+que filhos podem usar modelo/esforço diferentes da seleção manual do principal.
+[Essencial nunca escala automaticamente para Astra](23-orquestracao-de-modelos.md).
+A exigência canônica atual de executor elegível para delivery permanece:
+preferência por execução direta não permite inventar captura para aprovar gates.

package/templates/.agents/zaip-aios/guides/10-seguranca.md

@@ -237,7 +237,17 @@ ao novo token. Não edite ACLs manualmente e preserve o backup para rollback.
 | `.codex/zaip-aios-security.config.toml` | configuração dedicada do perfil restrito |
 | `.codex/zaip-aios-full-access.config.toml` | configuração dedicada do perfil completo |
 | `.agents/skills/zaip-skill-security/SKILL.md` | avaliação dos riscos e controles |
-| `.agents/skills/zaip-skill-setup/SKILL.md` | instalação, correção e validação dos perfis |
+| `.agents/skills/zaip-skill-setup/SKILL.md` | instalação inicial dos modelos de perfil entregues pelo release |
+| `.agents/skills/zaip-skill-config/SKILL.md` | seleção, personalização, correção e validação dos perfis |
 | `.codex/hooks/zaip-pre-tool-use.mjs` | guarda adicional de comandos |
 | `.codex/rules/` | decisões determinísticas de comandos permitidos e proibidos |
 | este guia | contrato operacional e comparação dos perfis |
+
+## Autonomia não é permissão
+
+Essencial, Equilibrado e Persistente controlam persistência, não sandbox.
+Persistente ilimitado não remove approvals, escopos, proteção de segredos,
+revisão ou autoridade para publicação. Replanejadores gerenciados têm ferramentas
+isoladas; executor e Gui conservam seus próprios limites.
+Hooks best-effort e prompts não substituem controle preventivo do host.
+Veja [limites do runtime](19-assurance-e-autonomia.md).

package/templates/.agents/zaip-aios/guides/11-observabilidade-e-custos.md

@@ -10,3 +10,72 @@
 Run é o envelope da chamada do `zaip-agent-orchestrator`; `parent_run_id` nulo identifica esse nível. Sub-Run é a chamada de qualquer subagente e possui `parent_run_id`. Ambas podem agregar Calls, segmentos de uso, tokens e custo; Calls não possuem tela ou lifecycle próprio. A configuração solicitada de modelo e effort pertence à Run. Modelo, effort e tier efetivos só devem ser reportados quando vierem de evento/provider observado: defaults do catálogo, seleção planejada ou comportamento aparente não os comprovam. Operação e Monitor de Custos apresentam “Chamadas do agente orquestrador” e “Chamadas de subagentes”; a Execution soma as duas categorias, finalizadores e Calls sem dupla contagem. Cada segmento de uso possui uma chave de origem e só pode ser atribuído uma vez; uma correção de duplicidade registra supersessão e preserva o evento histórico. Inspecione `run_purpose`, pai e `agent_name`; agentes do catálogo usam `zaip-agent-*`. Diferencie status técnico da chamada de agente e resultado terminal da Task. Reconcilie lifecycle globalmente apenas por comando humano explícito ou pelo popup confirmado; isso não ocorre em cada turno nem ao abrir o dashboard.
 
 A criação explícita de PRD/SPEC vincula a Run de definição e o `creation_run_id` ao macro. Duração, tokens e custo aparecem no PRD/SPEC antes de existirem Tasks somente quando houver fonte capturada ou derivação identificada por proveniência. Um valor `estimated`, `legacy_inferred` ou `reconciled` não é dado observado e não comprova medição da chamada. Quando duração, tokens ou custo não foram capturados, eles permanecem explicitamente indisponíveis (`null`/`unavailable`); nunca atribua telemetria ausente nem transforme ausência em zero. Pensar sem criar permanece apenas em Conversas.
+
+## Contagem de autonomia e consultas compactas
+
+### Leitura dos números do Dashboard
+
+O total operacional de Tasks, a distribuição por risco e as contagens temporais
+de Tasks usam a população sem rascunhos. Runs e custos já observados de um
+rascunho continuam preservados; excluir a Task do indicador não apaga seu uso.
+PRDs/SPECs em definição mantêm seu próprio contrato de contagem.
+
+O rodapé de Provedores pertence à mesma consulta e aos mesmos filtros das
+linhas, antes da paginação. Não é substituído pelo custo global: chamadas sem
+atribuição ao provedor e outras populações podem tornar esses totais diferentes.
+Valores parciais conhecidos não comprovam custo total nem saldo da conta.
+
+O cartão de Tasks distingue `complete`, `partial` e `unavailable`. Uma soma
+conhecida aparece no cartão compacto **Custo Estimado**, sem ícone. O tooltip e a
+descrição acessível explicam a quantidade de Runs precificadas e a cobertura.
+O subtítulo apresenta taxas estimadas de alocação: subtotal conhecido dividido pelo
+número de tarefas e pelas horas registradas do mesmo recorte. Isso não estima os
+custos faltantes nem representa a média de custos completos das tarefas. Cada
+denominador indisponível ou zero deixa apenas sua taxa como `—`. Não completar
+as Runs desconhecidas com zero nem apresentar o subtotal como gasto integral.
+Um subtotal observado igual a zero é diferente de ausência total de medição.
+SPECs/PRDs usam seus agregados próprios, não recebem o subtotal global de Tasks.
+
+Rascunhos de Task sem execução permanecem consultáveis na lista, mas não ocupam
+a coluna de Definição do Kanban: essa etapa pertence aos PRDs. A projeção de
+provedor normaliza aliases de Codex tanto na atividade quanto nos segmentos de
+uso; isso não altera identidade nem preços nos registros canônicos.
+
+Enquanto uma consulta de médias está pendente, a interface mostra carregamento,
+não zero. Zero observado, ausência de captura e carregamento são estados distintos.
+A validação deve comparar API, linhas, rodapé e exportação no mesmo período,
+moeda e filtro. Um processo saudável não comprova que o snapshot foi atualizado;
+confirme também a revisão, a data da fonte e o estado da projeção.
+
+O inventário SQLite recalcula hashes de arquivos recém-alterados: gravações
+rápidas no Windows podem preservar tamanho, mtime e até ctime. Durante a janela
+de estabilização de dois segundos não reutiliza o hash; a primeira leitura após
+essa janela também confere o conteúdo antes de habilitar o cache histórico.
+Checkpoints anteriores a essa proteção são revalidados. Verificação explícita
+de conteúdo continua disponível; o cache não garante detectar adulteração de
+metadados nem oferece semântica de filesystem distribuído.
+
+As médias temporais são calculadas antes da paginação, sobre todo o período
+filtrado. Mudar de página não altera a média. Para tokens e custo, o denominador
+inclui os períodos com medição conhecida; ausência total permanece indisponível.
+
+Tentativas/replanejamentos vêm do diário durável da Task; não de duração,
+tokens, Calls ou contagem de testes. `attempt_count` do lifecycle mede outra
+transição. Custo equivalente é uma estimativa, não saldo de créditos.
+
+A CLI `run list`/`run aggregate` usa projeções de entidades Run, preservando
+identidade, ordenação, filtros e métricas conhecidas/parciais. Campos obrigatórios
+ausentes geram diagnóstico de rebuild explícito, não zeros sintéticos nem
+leitura global oculta dos JSONLs. `run show RUN-ID` é inspeção canônica explícita.
+`source_latest_at` e `lag_ms` precisam refletir a fonte, não a hora do refresh.
+
+Isso não comprova custo O(1), economia de tokens ou o benchmark completo de
+20 pares da v3. Projeções, API, DOM e produção requerem provas próprias.
+
+O Dashboard coleta uso de uma Run ativa por passagem, em rodízio a cada minuto
+(`run usage --active --limit 1 --disable-codex-raw`). Esse orçamento de coleta
+não limita a execução da tarefa. Com várias Runs ativas, a cobertura leva mais
+de uma passagem; não prometa atualização simultânea ou custo O(1). Uma falha de
+coleta aparece em `active_capture_failure`; falha de projeção aparece em
+`projection_refresh_failure`. Dados canônicos continuam atualizáveis mesmo
+quando a coleta falha, sem transformar a telemetria ausente em zero.

package/templates/.agents/zaip-aios/guides/12-instalacao-e-upgrade.md

@@ -29,10 +29,15 @@ Os manuais instalados ficam em `.agents/README.md` (português) e
 Os READMEs da raiz pertencem ao projeto consumidor e são preservados.
 As versões geradas em `public-cli/packages/cli/templates` vêm das fontes canônicas.
 
-Novas instalações mantêm seleção de modelo em `manual`. Instalar ou atualizar
-não ativa Astra automaticamente. O opt-in `auto` aplica-se a SPEC/PRD e a allowlist
-Astra habilita somente diagnóstico `high`, limitado e evidenciado, conforme o
-[guia 23](23-orquestracao-de-modelos.md). Conversas e Tasks avulsas preservam a seleção do host.
+Novos templates mantêm a seleção do principal em `manual` e configuram
+`execution.runtime: managed` para PRD/SPEC, com
+`autonomy: { version: 1, preset: balanced }`. São controles diferentes:
+instalar/salvar o preset não inicia provider. O [guia 19](19-assurance-e-autonomia.md)
+explica Essencial, Equilibrado e Persistente; o [guia 23](23-orquestracao-de-modelos.md)
+detalha Astra/high nos replanejamentos e sua execução elegível no terceiro bloco.
+O Essencial nunca usa Astra automático. Principal avulso preserva a seleção
+manual; filhos necessários seguem política divulgada. Projetos e estados legados
+não recebem migração silenciosa de quotas.
 
 `@latest` entrega o que está publicado no npm. Uma atualização local das fontes ou
 um pacote validado localmente só chegará a esse comando após publicação.

package/templates/.agents/zaip-aios/guides/13-boas-praticas.md

@@ -10,9 +10,15 @@
 - Registre observação somente como resultado declarado e vinculado; ela não
   executa comandos, não examina automaticamente telas e não aprova um AC.
   Aplique o [contrato de prova observável](../../skills/zaip-skill-change/references/observable-evidence.md).
-- Nunca termine a Run raiz sem o Sub-Run finalizador ou com Task em executing/verifying.
+- Em delivery/interação delegada, use Gui como último filho do responsável e
+  concilie a Task; conversa read-only sem filhos não precisa desse circuito.
 - Nao terminalize SPEC/PRD por causa do resultado isolado de uma Task filha.
 - Prefira reconciliacao manual sob demanda; hooks de escrita fazem checagem local sem varredura global.
 - Use uma SPEC por padrão; divida somente capacidades realmente independentes e paralelizáveis.
 - Não crie Tasks durante definição: mostre blueprints compactos e materialize somente em `ready|execute`.
 - Resolva verbos de lifecycle pelo alvo e status persistido, nunca por palavra isolada.
+
+- Prefira uma investigação útil a repetir a mesma hipótese; conte reservas reais
+  pelo preset da Task, não por duração ou quantidade de testes.
+- Não transforme tempo decorrido em falha nem incompletude em aprovação.
+- Preserve o diário de autonomia; ele não é cache. Veja [guia 19](19-assurance-e-autonomia.md).

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

@@ -12,3 +12,21 @@ Se uma Task estiver presa em executing/verifying, use o popup Reconciliar. O rep
 Se o problema for de instalacao ou integridade, consulte `framework.lock.yaml`.
 
 Se “finalizar” tentou entregar um PRD `draft`, confira adapters/skills: o correto é lapidar e mover para `ready`. Se uma DAG nova cruza SPECs, una as capacidades em uma SPEC e mantenha a dependência entre suas Tasks. PRD cancelado não reabre; crie sucessor `rework`.
+
+## Repetição, orçamento e recibos
+
+| Sintoma | Diagnóstico e próxima ação |
+| --- | --- |
+| Task longa, ainda com trabalho real | Examine progresso/logs; não encerre apenas pela duração |
+| `RECOVERY_PENDING` | Localize a reserva e resultado real; não despache outra invocação nem apague o diário |
+| `ATTEMPT_BUDGET_EXHAUSTED` / `REPLAN_BUDGET_EXHAUSTED` | Confira o preset congelado e consumo; registre o resultado parcial sem reset |
+| `REPLAN_INCOMPLETE` | Plano inválido não libera reparação; preserve a reserva consumida |
+| Gui terminou sem recibo de início | Capture o evento real e use relay suportado com responsável aberto; não invente decisão |
+| 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 |
+
+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
+falha do produto. Veja [autonomia](19-assurance-e-autonomia.md) e
+[relay de fechamento](16-lifecycle-e-reconciliacao.md).