@zaip-ai/cli 1.0.2 → 1.0.4

package/templates/.agents/requirements/autonomous-assurance.md

@@ -6,7 +6,7 @@ title: Garantia adaptativa e execução autônoma
 status: active
 version: 1
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Garantia adaptativa e execução autônoma

package/templates/.agents/requirements/context-engine.md

@@ -6,7 +6,7 @@ title: Contexto mínimo, seguro e navegável
 status: active
 version: 8
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Context engine

package/templates/.agents/requirements/cost-observability.md

@@ -6,7 +6,7 @@ title: Tokens, custos e cobertura
 status: active
 version: 9
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Cost observability

package/templates/.agents/requirements/design-system.md

@@ -6,7 +6,7 @@ title: Contrato visual e catálogo executável
 status: active
 version: 3
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Design system

package/templates/.agents/requirements/execution-engine.md

@@ -6,7 +6,7 @@ title: Preparação, materialização e DAG
 status: active
 version: 10
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Execution engine

package/templates/.agents/requirements/kanban-dashboard.md

@@ -6,7 +6,7 @@ title: Projeções operacionais e analíticas
 status: active
 version: 10
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Kanban and dashboard

package/templates/.agents/requirements/model-orchestration.md

@@ -6,7 +6,7 @@ title: Seleção automática e observável de modelo e effort
 status: active
 version: 5
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Orquestração de modelos
@@ -28,7 +28,7 @@ Cada Run ou Sub-Run deve resolver uma configuração única a partir do agente d
 - `AC-MODEL-002-02`: a política considera fase, papel do agente, complexidade, risco, transversalidade, ambiguidade, rework e restrições de capacidade; risco governa assurance e não força sozinho modelo ou effort superior.
 - `AC-MODEL-002-03`: a política inicial usa Luna para trabalho simples, delimitado ou de alto volume, Terra como baseline de implementação e teste e Sol para planejamento, revisão ou reparo ambíguo/transversal; `xhigh` só é elegível para planejamento, replanejamento, auditoria ou rework estrutural delimitado quando as quatro condições e ao menos dois gatilhos observáveis do guia forem satisfeitos.
 - `AC-MODEL-002-04`: `ultra`, `max`, effort desconhecido e modelo fora da allowlist são rejeitados antes da chamada com erro tipado, sem fallback silencioso; `xhigh` é aceito quando vier de override explícito válido ou da política elegível.
-- `AC-MODEL-002-05`: a Run raiz usa a identidade visível `zaip-agent-orchestrator`; cada Execution delega por capacidade a ao menos um executor do catálogo, conversas podem usar `zaip-agent-analyst`, e o último Sub-Run usa `zaip-agent-execution-finalizer`.
+- `AC-MODEL-002-05`: a Run raiz usa a identidade visível `zaip-agent-orchestrator`; cada Execution delega por capacidade a ao menos um executor do catálogo, conversas podem usar `zaip-agent-analyst`, e o último Sub-Run usa `zaip-agent-finalizer`.
 
 ## REQ-MODEL-003 — Configuração imutável por Agent Run
 

package/templates/.agents/requirements/public-distribution.md

@@ -6,7 +6,7 @@ title: Distribuição pública e ativação
 status: proposed
 version: 2
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Distribuição pública e ativação

package/templates/.agents/requirements/software-architecture.md

@@ -6,7 +6,7 @@ title: Layout modular e limites de código-fonte
 status: active
 version: 5
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Software architecture

package/templates/.agents/requirements/work-lifecycle.md

@@ -6,7 +6,7 @@ title: Ciclo de vida do trabalho
 status: active
 version: 19
 source_change: null
-source_release: "1.0.2"
+source_release: "1.0.4"
 ---
 
 # Work lifecycle
@@ -25,7 +25,7 @@ O ZAIP-AIOS deve aceitar trabalho iniciado por Task, SPEC ou PRD, mantendo PRD e
 - `AC-WORK-001-06`: `conversation start|finish` coordena Executions e Runs idempotentes quando `client_turn_id` é observável; quando indisponível, cada captura usa uma identidade local única. O fluxo permite término sem Task e atualiza a projeção sem exigir comandos manuais intermediários.
 - `AC-WORK-001-07`: pergunta, análise pontual e classificação ausente ou de baixa confiança usam fallback `conversation`, nunca criam Task e preservam telemetria do Run.
 - `AC-WORK-001-08`: continuação, resposta a pergunta do agente, aprovação, refinamento e rework reutilizam o alvo explícito ou o último foco válido da mesma thread; não consultam trabalho global e não criam Task adicional salvo pedido explícito.
-- `AC-WORK-001-09`: edição persistente do repositório, novo resultado independente ou pedido explícito de nova Task cria exatamente uma Task `draft`, sua Change `draft`, uma Execution `delivery` e uma Run raiz `zaip-agent-orchestrator` antes de qualquer mutação; prepare e execute promovem e reutilizam esses mesmos agregados. Cada `client_turn_id` observável possui claim exclusivo e resolve global e atomicamente para exatamente uma Execution `interaction|delivery`; sem ID observável, cada captura recebe identidade local única. Reuso exige kind e origem compatíveis; kind e elegibilidade declarada no catálogo são persistidos, ao menos uma Sub-Run executora elegível é exigida e o encerramento ocorre somente após `zaip-agent-execution-finalizer` ser o último filho concluído; `agent-task-finalizer` é aceito apenas na leitura histórica; write scopes ausentes permanecem vazios e título e objetivo são sínteses semânticas fornecidas pela IA.
+- `AC-WORK-001-09`: edição persistente do repositório, novo resultado independente ou pedido explícito de nova Task cria exatamente uma Task `draft`, sua Change `draft`, uma Execution `delivery` e uma Run raiz `zaip-agent-orchestrator` antes de qualquer mutação; prepare e execute promovem e reutilizam esses mesmos agregados. Cada `client_turn_id` observável possui claim exclusivo e resolve global e atomicamente para exatamente uma Execution `interaction|delivery`; sem ID observável, cada captura recebe identidade local única. Reuso exige kind e origem compatíveis; kind e elegibilidade declarada no catálogo são persistidos, ao menos uma Sub-Run executora elegível é exigida e o encerramento ocorre somente após `zaip-agent-finalizer` ser o último filho concluído; `agent-task-finalizer` é aceito apenas na leitura histórica; write scopes ausentes permanecem vazios e título e objetivo são sínteses semânticas fornecidas pela IA.
 - `AC-WORK-001-10`: a decisão de intake registra intenção, origem, confiança e motivos compactos no Run sem armazenar prompt, segredo ou raciocínio interno.
 - `AC-WORK-001-11`: qualquer mutação persistente intencional no repositório ou no PC exige Task materializada e Run raiz de orquestração antes da primeira escrita. São isentos apenas publicação Git/deploy sem mudança de produto, records/projections/telemetria ZAIP, metadados `.git`, caches, builds, testes e arquivos temporários descartáveis; editar código, documentação ou configuração ZAIP nunca é isento.
 
@@ -73,7 +73,7 @@ Cada Execution `interaction|delivery` possui uma Run raiz de orquestração, ao
 
 - `AC-WORK-006-01`: uma Run raiz de `orchestration` governa exatamente uma tentativa de Task e permanece aberta enquanto seus Sub-Runs executam; antes de a Run terminar, a Task deve estar `completed`, `blocked`, `failed` ou `cancelled`. `executing` e `verifying` nunca são estados válidos no fim da tentativa.
 - `AC-WORK-006-02`: um registro `RUN-*` sem `parent_run_id` é uma Run; com `parent_run_id`, é um Sub-Run. Novas gravações usam somente `run_role: intake|orchestrator|subagent`; valores históricos `owner|contributor` permanecem legíveis e são normalizados na borda. Ambos usam o mesmo ledger e status técnico, sem entidade duplicada. A Run raiz não pode terminar enquanto qualquer descendente estiver ativo.
-- `AC-WORK-006-03`: o último filho de qualquer Execution é um Sub-Run `finalization` executado por `zaip-agent-execution-finalizer`. Ele só inicia depois que um executor elegível e os demais descendentes terminam, impede novos filhos e retorna uma decisão restrita; reviewer, auditor e integrator são permitidos antes da barreira. A CLI aplica deterministicamente o status terminal.
+- `AC-WORK-006-03`: o último filho de qualquer Execution é um Sub-Run `finalization` executado por `zaip-agent-finalizer`. Ele só inicia depois que um executor elegível e os demais descendentes terminam, impede novos filhos e retorna uma decisão restrita; reviewer, auditor e integrator são permitidos antes da barreira. A CLI aplica deterministicamente o status terminal.
 - `AC-WORK-006-04`: uma Run raiz de SPEC/PRD pode terminar sem terminalizar o macro. O pai passa a `active` quando uma Task filha inicia, permanece em Execução durante intervalos e só entra em Verificação depois de todas as Tasks concluírem; delivery exige gates parentais próprios.
 - `AC-WORK-006-05`: status técnico de Run/Sub-Run (`completed`, `failed`, `cancelled`) é independente do resultado da Task (`completed`, `blocked`, `failed`, `cancelled`); a orquestração pode concluir tecnicamente e bloquear a Task por falha de gate.
 - `AC-WORK-006-06`: continuação não preserva Task em `executing` ou `verifying`, e fechamento da tentativa não pode ser adiado. Retomada de `blocked` usa `resume`; `failed` usa `rework` na mesma Task e incrementa a tentativa; `completed` e `cancelled` são imutáveis.

package/templates/.agents/rules/zaip/core.md

@@ -19,6 +19,6 @@ requires: []
 - Nunca invente uso de tokens, custo, decisão, evidência, teste ou resultado.
 - Quando `model_orchestration.mode` for `manual`, carregue `RULE-MODEL-ORCHESTRATION` antes da primeira resposta visível a cada mensagem do usuário. O aviso é informativo, nunca bloqueia nem aguarda confirmação, e não altera modelo, esforço ou velocidade.
 - Quando `clients.codex` estiver ativo e houver delegação, selecione exclusivamente `codex_name` do `.agents/config/agents/catalog.yaml`. Todo nome e apelido visível de custom agent Codex usa o formato `zaip-agent-NOME`; a regra é recursiva para subagentes e proíbe `default`, `worker`, `explorer` e tipos ad-hoc. Tasks independentes podem executar em paralelo e agentes podem criar subagentes até a profundidade configurada pelo adapter.
-- Cada turno com `client_turn_id` observável possui exatamente uma Execution idempotente, protegida por claim exclusivo e atômico; sem esse ID, cada captura usa identidade local única e não promete idempotência entre invocações. `interaction` representa conversa/análise sem Tasks artificiais e `delivery` trabalho materializado; reuso exige kind e origem compatíveis. A Run raiz usa `zaip-agent-orchestrator`; ao menos um Sub-Run executor deve ser selecionado por capacidade no catálogo, sem identidade fixa. Reviewer, auditor e integrator são permitidos. O último filho de qualquer Execution é obrigatoriamente `zaip-agent-execution-finalizer` com propósito `finalization`; ele inicia somente após os demais descendentes terminarem e cria uma barreira contra novas chamadas.
+- Cada turno com `client_turn_id` observável possui exatamente uma Execution idempotente, protegida por claim exclusivo e atômico; sem esse ID, cada captura usa identidade local única e não promete idempotência entre invocações. `interaction` representa conversa/análise sem Tasks artificiais e `delivery` trabalho materializado; reuso exige kind e origem compatíveis. A Run raiz usa `zaip-agent-orchestrator`; ao menos um Sub-Run executor deve ser selecionado por capacidade no catálogo, sem identidade fixa. Reviewer, auditor e integrator são permitidos. O último filho de qualquer Execution é obrigatoriamente `zaip-agent-finalizer` com propósito `finalization`; ele inicia somente após os demais descendentes terminarem e cria uma barreira contra novas chamadas.
 - Em `model_orchestration.mode: auto`, aplique seleção automática somente a Executions cuja origem conste em `automatic_sources` (`spec` e `prd`). Resolva modelo e reasoning effort no início de cada Run ou Sub-Run materialmente distinta (`discovery`, `planning`, `implementation`, `testing`, `review`, `audit`, `finalization` ou `rework`) e mantenha ambos imutáveis até o fim. Calls internas herdam a mesma configuração; mudança deliberada exige nova chamada de agente. Task avulsa preserva a escolha manual do host e nunca herda `default_model` por inferência.
 - Quando um plano visível for útil, prefixe os passos com `DEFINE:`, `PLAN:`, `EXECUTE:` ou `VERIFY:`; prefira 3–4 passos, limite a 5, omita fases sem ação real e combine ações triviais. Tarefas simples seguem sem plano.

package/templates/.agents/rules/zaip/workflow.md

@@ -23,7 +23,7 @@ requires:
 - Toda alteração de código possui Change criada antes da implementação. `change.md` registra plano, implementação, decisões, evidências, evals, testes e resultado.
 - Requirements descrevem a verdade funcional/técnica; a Change propõe deltas e só os aplica após Acceptance Criteria e evidências passarem.
 - Task contém trabalho executável; Execution possui snapshot da DAG; Run registra a chamada do orquestrador; Sub-Run registra cada chamada de subagente; Calls registram invocações internas de LLM quando observáveis.
-- Run e Sub-Run compartilham o ledger `RUN-*`: ausência de `parent_run_id` define Run; presença define Sub-Run. Novas gravações usam somente `run_role: intake|orchestrator|subagent`; `owner|contributor` são valores históricos normalizados na leitura. Toda Execution usa `zaip-agent-orchestrator` na raiz, ao menos um executor escolhido pelas capacidades do catálogo e `zaip-agent-execution-finalizer` como último Sub-Run. Reviewer, auditor e integrator podem participar antes da barreira. A CLI aplica a decisão restrita do finalizador.
+- Run e Sub-Run compartilham o ledger `RUN-*`: ausência de `parent_run_id` define Run; presença define Sub-Run. Novas gravações usam somente `run_role: intake|orchestrator|subagent`; `owner|contributor` são valores históricos normalizados na leitura. Toda Execution usa `zaip-agent-orchestrator` na raiz, ao menos um executor escolhido pelas capacidades do catálogo e `zaip-agent-finalizer` como último Sub-Run. Reviewer, auditor e integrator podem participar antes da barreira. A CLI aplica a decisão restrita do finalizador.
 - Run filha não terminaliza o macro; SPEC/PRD permanecem `active` até todas as Tasks e gates parentais concluírem. Status técnico das chamadas de agente é independente do resultado da Task. `blocked` retoma com `task resume`, `failed` exige `task rework` na mesma Task, e `completed`/`cancelled` são imutáveis.
 - Reconciliação global ocorre somente após confirmação humana no popup Reconciliar; nunca ao abrir o dashboard, a cada turno ou por intervalo. O reparo usa `task_complete` exato ou falha órfã após dez minutos, sem inferir cancelamento ou sucesso sem gates.
 - Classifique risco como `lite`, `standard` ou `critical`; crie anexos somente quando risco ou evidência exigirem.

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

@@ -0,0 +1,9 @@
+<!-- zaip-managed generated-do-not-edit source=discovery-skill version=1.0.0 sha256=75c2fcb5043d4a9d360caee0ca49dda016d4c7bad4eb2f86a5957dbe4429d7af -->
+---
+name: zaip-aios
+description: Discover and apply the repository-local ZAIP-AIOS framework.
+---
+
+# ZAIP-AIOS adapter
+
+Read `.agents/config/project.yaml` first. If `zaip.enabled` is `false`, do not apply the ZAIP workflow or load its context; only help with status, maintenance or explicit reactivation through `node .zaip-aios/bin/zaip.mjs enable`. If the field is `true` or absent, classify and capture the exact current turn before substantive work: question, read-only analysis, or uncertainty uses `conversation start --intent conversation`; answer, approval, continuation, refinement, or rework uses `--intent continue|refine|rework` and reuses same-thread focus; repository edits, independent outcomes, or an explicit new Task use `--intent new-work` with an AI-authored semantic `--title` of 4-10 words, `--short-name`, and synthesized `--objective`. Never copy or truncate the prompt into a title, and fall back to conversation when uncertain. Pure deploy, push, or publication is git-only. Then read `.agents/rules/zaip/core.md`, select only matching Rules, Requirements and skills, discover active work through local projections, then point-read lifecycle records by explicit ID. Capture is idempotent for an exact client turn. Do not scan `.agents/records/` or legacy `.agents/data/`. The framework lock is operational metadata, not prompt context.

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

@@ -17,7 +17,7 @@ Use esta skill somente quando o usuário pedir execução. `prepare` não autori
 8. Em cada `run usage`, leia `budget.context_refresh_required` e `budget.checkpoint_required`. O runtime grava o checkpoint sanitizado em `.agents/projections/runtime/checkpoints/`; quando sinalizado, reconstrua contexto somente de IDs ativos, diff e findings, descarte outputs brutos antigos e continue apenas com autoridade.
 9. Em falha operacional, use retry limitado; em falha lógica, crie repair/rework explícito. Nunca esconda uma tentativa.
 10. Cada tentativa usa uma Run raiz do `zaip-agent-orchestrator`; subagentes e fases materialmente distintas usam Sub-Runs relacionadas por `parent_run_id`. Cada Run/Sub-Run fixa agente, modelo e effort; retry técnico preserva a configuração e qualquer mudança deliberada abre outra chamada de agente.
-11. Depois que todos os Sub-Runs de trabalho terminarem, invoque `zaip-agent-execution-finalizer` como último filho de qualquer Execution com propósito `finalization`. Não inicie novos filhos depois dele. A CLI aplica seu resultado restrito; ausência, interrupção ou falha deixa a Execution inconclusiva como `blocked`.
+11. Depois que todos os Sub-Runs de trabalho terminarem, invoque `zaip-agent-finalizer` como último filho de qualquer Execution com propósito `finalization`. Não inicie novos filhos depois dele. A CLI aplica seu resultado restrito; ausência, interrupção ou falha deixa a Execution inconclusiva como `blocked`.
 12. SPEC/PRD permanece `active` entre Runs filhas e só entra em verificação após todas as Tasks; a Run filha não entrega nem bloqueia automaticamente o pai.
 
 ## Paralelismo

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

@@ -38,4 +38,4 @@ Somente trabalho executável é capturado como Task-first. Perguntas, análises
 2. Task `standard` usa exatamente duas validações/Evidences no perfil base ou três no elevado; `standard_depth: auto` eleva Tasks com múltiplos write scopes. Inclua teste executado e modalidades distintas.
 3. Task `critical` usa três ou mais validações, Evidence por AC, teste, quality review por autor/Run independente, discriminação de mutação, rollback e commit final. Nunca rebaixe risco sensível para caber no perfil `lite`.
 4. Quantidade não substitui semântica: cada Evidence referencia validações aprovadas da mesma Task, Change e Execution e descreve o outcome observado.
-5. Nunca encerre a Run raiz sem executar `zaip-agent-execution-finalizer` como último Sub-Run da Execution nem com a Task em `executing` ou `verifying`. Gate insuficiente ou finalizador ausente termina a tentativa em `blocked`; retome com `task resume`. Falha técnica usa `failed` e `task rework` na mesma identidade; completed/cancelled são imutáveis.
+5. Nunca encerre a Run raiz sem executar `zaip-agent-finalizer` como último Sub-Run da Execution nem com a Task em `executing` ou `verifying`. Gate insuficiente ou finalizador ausente termina a tentativa em `blocked`; retome com `task resume`. Falha técnica usa `failed` e `task rework` na mesma identidade; completed/cancelled são imutáveis.

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

@@ -6,7 +6,7 @@
 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.
 6. Registre decisoes consequenciais, evidencias e desvios.
-7. Depois dos demais descendentes, execute `zaip-agent-execution-finalizer` como ultimo Sub-Run da Execution. Nenhum filho novo pode iniciar depois dele.
+7. Depois dos demais descendentes, execute `zaip-agent-finalizer` como ultimo Sub-Run da Execution. Nenhum filho novo pode iniciar depois dele.
 8. Finalize a Run raiz com status tecnico e resultado terminal da Task separados.
 9. Execute os gates finais e documente rollback.
 

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

@@ -28,7 +28,7 @@
 - cada Run/Sub-Run fixa agente, modelo e effort; mudanca deliberada abre outra chamada de agente.
 - Calls e ferramentas sao eventos internos; quantidade, tokens e custo ficam agregados na Run/Sub-Run, sem tela propria.
 
-O ultimo filho de qualquer Execution e sempre o `zaip-agent-execution-finalizer`. Ele aguarda todos os outros descendentes, cria uma barreira contra filhos posteriores e retorna uma decisao terminal restrita para a CLI aplicar. Toda Execution exige antes ao menos um executor elegivel pelas capacidades do catalogo. Status tecnico da chamada de agente e resultado do trabalho sao independentes.
+O ultimo filho de qualquer Execution e sempre o `zaip-agent-finalizer`. Ele aguarda todos os outros descendentes, cria uma barreira contra filhos posteriores e retorna uma decisao terminal restrita para a CLI aplicar. Toda Execution exige antes ao menos um executor elegivel pelas capacidades do catalogo. Status tecnico da chamada de agente e resultado do trabalho sao independentes.
 
 `blocked` e retomavel com `task resume`; `failed` exige `task rework` na mesma Task e nova tentativa. `completed` e `cancelled` sao imutaveis. Interromper geracao bloqueia; cancelar a Task explicitamente cancela.