@zaip-ai/cli 3.2.0 → 3.4.0

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

@@ -4,9 +4,9 @@ id: REQUIREMENTS-PUBLIC-DISTRIBUTION
 area: public-distribution
 title: Distribuição pública e ativação
 status: active
-version: 6
+version: 8
 source_change: null
-source_release: "3.2.0"
+source_release: "3.4.0"
 ---
 
 # Distribuição pública e ativação
@@ -26,10 +26,24 @@ A distribuição pública só pode ser candidata quando fonte canônica, templat
 
 A skill portátil de publicação é `zaip-skill-github-deploy`. A publicação npm do framework pertence exclusivamente ao GitHub Actions do repositório mantenedor, com versão alinhada ao tag GitHub e canal explícito. Workflow mantenedor e skill legada de publicação npm não entram no template nem no pacote. Atualizações removem arquivos obsoletos comprovadamente gerenciados e inalterados, preservando personalizações e arquivos sem prova de ownership.
 
-- `AC-DIST-002-01`: o gate de release executa sync reproduzível, audit, typecheck, testes, pack, doctor, smoke e rollback sobre o candidato exato, sem substituir falha por evidência de outro checkout.
+- `AC-DIST-002-01`: o gate padrão de release usa o perfil `essential-v3`: sync reproduzível, integridade e paridade, audit de dependências, typecheck, regressões prioritárias de instalação/rollback e contratos de release, pack, doctor e smoke do runtime/SQLite/API sobre o candidato exato. O recibo assinado vincula perfil, gates, SHA e hashes do pacote; falha ou timeout não produz aprovação. Validação de cada aba do Dashboard, XLSX, cobertura completa e matriz estendida ficam no perfil full solicitado explicitamente, sem bloquear uma nova versão por padrão. Mudança funcional nesses componentes exige somente os testes pertinentes ao impacto.
 - `AC-DIST-002-02`: o manifest registra versão, hashes e conteúdo efetivo de `.agents`, incluindo o runtime; qualquer divergência entre fonte, template e pacote bloqueia a candidatura.
 - `AC-DIST-002-03`: README, guias de instalação, versão pública e comandos documentados permanecem alinhados ao pacote qualificado e não prometem capability ausente.
 
+A identidade da candidata deriva exclusivamente de `package.json#version` na raiz.
+O builder do instalador aplica `zaip-skill-update-version-doc`: mantém instruções gerais
+sem número de release, gera as identidades necessárias e bloqueia divergências nos gates
+de build, pacote e qualificação. Novos literais de versão em fontes de produção exigem
+classificação explícita. Dependências, compatibilidade, schemas, migrações e evidências
+históricas conservam seus próprios números. Igualdade de versão não substitui paridade
+de bytes, hashes, instalação real nem prova da versão publicada.
+
+Pedidos simples de atualização usam `npx --yes @zaip-ai/cli@latest init --force --yes --profile full`
+(`npx.cmd` no Windows), com backup antes de sobrescrever e instalação das dependências ausentes.
+Restrições explícitas prevalecem. No init sem force, catálogo oficial legado reconhecido pode
+ser atualizado e passa a integrar o lock; catálogo personalizado permanece protegido. Discovery
+gerenciada é uma projeção única, regenerada a partir do catálogo da versão instalada.
+
 ## REQ-DIST-003 — Configuração global portátil do Codex
 
 O CLI público deve descobrir o diretório inicial do usuário em execução e reconciliar a proteção
@@ -45,7 +59,7 @@ introduzir paths ou identidades locais fixas.
 ### Onboarding de instalação sob REQ-DIST-002
 
 - A instalação não exige Git disponível, identidade Git, repositório, commit inicial ou GitHub previamente configurados. Falhas reais de integridade e etapas obrigatórias continuam sendo informadas.
-- O resumo mostra a versão efetivamente instalada como link Markdown para a página npm dessa versão, contagens observadas e resultados reais de SQLite e doctor. Dry-run ou etapa não executada não equivale a sucesso.
+- A resposta final do assistente usa frase inicial com o comando, “Resumo:”, bullets e exatamente uma pergunta na última linha; não pode substituir a lista por parágrafos. O resumo mostra a versão efetivamente instalada com rótulo vVERSÃO como link Markdown para a página npm dessa versão, contagens observadas e resultados reais de SQLite e doctor. Dry-run ou etapa não executada não equivale a sucesso.
 - O último CTA pergunta se o usuário deseja ajuda para configurar GitHub quando o estado local estiver pendente/inconclusivo; com GitHub configurado localmente, pergunta pela configuração inicial do projeto. Estado local não comprova autenticação.
 - Uma resposta afirmativa encaminha à skill correspondente, que explica opções e pergunta antes de aplicar escolhas. Após GitHub concluído, oferece projeto. Após projeto concluído ou recusa/adiamento, encerra o onboarding sem novas ofertas automáticas.
 

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: "3.2.0"
+source_release: "3.4.0"
 ---
 
 # Software architecture

package/templates/.agents/requirements/strategic-improvements.md

@@ -6,7 +6,7 @@ title: Melhorias estratégicas de custo, qualidade e resiliência
 status: active
 version: 1
 source_change: null
-source_release: "3.2.0"
+source_release: "3.4.0"
 ---
 
 # Melhorias estratégicas de custo, qualidade e resiliência

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

@@ -6,7 +6,7 @@ title: Ciclo de vida do trabalho
 status: active
 version: 26
 source_change: null
-source_release: "3.2.0"
+source_release: "3.4.0"
 ---
 
 # Work lifecycle

package/templates/.agents/requirements/zaip-strategic-95.md

@@ -6,7 +6,7 @@ title: Evidências, custo por Task e autonomia por SPEC
 status: active
 version: 1
 source_change: null
-source_release: "3.2.0"
+source_release: "3.4.0"
 ---
 
 # Evidências, custo por Task e autonomia por SPEC

package/templates/.agents/rules/autonomy-decision.md

@@ -19,6 +19,7 @@ phases: [conversation, definition, planning, execution]
 - Essencial nunca seleciona Astra automaticamente, inclusive por herança, fallback ou subagentes. A única exceção é o principal de uma Task avulsa com Astra escolhido manualmente pelo usuário no host. Nos demais perfis, Astra/high pode também executar no bloco iniciado pelo terceiro replanejamento, sem ampliar o orçamento.
 - Task avulsa preserva modelo/esforço do principal e prioriza trabalho direto. Delegue só por necessidade concreta. Antes da delegação, informe que subagentes seguem a política ZAIP e podem usar modelo/esforço diferentes; registre a configuração observada, mantendo desconhecidos explícitos. Não prometa override que o host não suporta.
 - Reserve no ledger persistente da Task antes da invocação e registre o resultado observado. Tool calls, testes individuais, tokens e relógio não são tentativas. Uma retomada não renova orçamento; mudança de configuração só vale para novas Tasks. Não invente contagens históricas numa migração.
+- Execução autorizada continua automaticamente; não peça “continue execução” nem nova confirmação para reparação elegível. Pause somente por cancelamento humano, bloqueio real ou falha terminal após a recuperação permitida pelo perfil congelado. Aguarde filhos ativos e leases; checkpoint/contexto não autoriza parar. Respeite a política de falha da DAG.
 - Não abandone por duração. Limites técnicos de uma ferramenta não provam falha do produto. Recuperações internas e replanejamentos inválidos não podem criar chamadas de IA fora do controle de orçamento. Ausência de decisão Gui não é aprovação; persista decisão real e depois Stop, ou use o relay atômico suportado na captura.
 - Ao esgotar recuperação: `failed` exige impedimento técnico comprovado; falta de verificação, acesso, evidência ou conclusão segura é `blocked`. Preserve entrega parcial e liste ACs pendentes; nunca reduza ACs automaticamente. Continue ramos independentes da DAG, mas não execute dependentes de Task não concluída.
 - Perfil controla persistência, não rigor: engenharia comprova comportamento e segurança; conteúdo comprova fidelidade às fontes e briefing; estratégia/operações comprovam dados e premissas. Risco define assurance, não o domínio sozinho.

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

@@ -16,7 +16,7 @@ phases: [planning, execution, verification, evidence]
 - Colunas: Definição só PRD `draft`; Planejamento só SPEC `draft`; Pronto para Executar recebe macro `ready` e Task `planned`, não ativa/nunca iniciada ou tentada. Task `draft` não entra; iniciada/tentada fica em Execução, Verificação ou terminal e não retorna.
 - Todo turno tem Execution/Run raiz, mas só trabalho executável tem Task. Pergunta, explicação, status, análise pontual ou baixa confiança usa `interaction`, `phase: conversation`, `entrypoint: conversation`, sem Task/Change artificial. Mencionar PRD/SPEC não autoriza criação; leitura permanece Conversation. Fora da criação explícita de draft, mutação persistente ou resultado independente cria Task-first; deploy/push/publicação puros são Git-only.
 - PRD pode ser draft sem SPEC, mas `prepare|execute|deliver` exige SPEC e veda Change direta fora dela; só SPECs selecionadas pelo PreparedPlan contam. `task create` só persiste draft; Run de captura é separado. `prepare` pré-aloca IDs/valida DAG sem produto, Change, Execution ou Run de execução; em PRD/SPEC não cria Task nem promove draft. Task auto-prepare só sem `depends_on`; dependência exige `zaip plan build` completo.
-- Só pedido humano explícito move PRD/SPEC a `ready`; executar autoriza `prepare` necessário e `execute`. Criação, revisão, refinamento, aprovação de conteúdo ou planejamento genérico não promovem. Até cinco perguntas críticas no primeiro turno e três de esclarecimento; depois decisão técnica IA delegável. Não presuma credencial, autoridade externa/destrutiva, obrigação legal ou segurança não delegável.
+- Só pedido humano explícito move PRD/SPEC a `ready`; executar autoriza finalizar o preparo e seguir com implementação, DAG e gates parentais no mesmo fluxo; não pare na ativação nem peça “continue execução” por tempo/contexto gasto no preparo. Criação, revisão, refinamento, aprovação de conteúdo ou planejamento genérico não promovem. Até cinco perguntas críticas no primeiro turno e três de esclarecimento; depois decisão técnica IA delegável. Não presuma credencial, autoridade externa/destrutiva, obrigação legal ou segurança não delegável.
 - Resolva verbo por alvo/status: `finalize|conclua|deixe pronto` em `draft|ready` significa `ready`; conclusão de implementação em `active` continua Tasks/gates; `execute` usa o menor grão nomeado. `implemente` sem alvo conversa; em draft finaliza plano, ready executa, active|blocked|failed continua/retoma/rework. `desenvolva|melhore|aprimore` planeja/refina/rework e requer nova promoção. PRD cancelado é imutável; sucessor draft usa `tags:[rework]` e `rework_of_prd_id`.
 - `execute` é explícito/idempotente e materializa DAG antes da primeira mutação; `execution` inicia na tentativa mesmo sem diff, comprovado separadamente por `changed_files`/`result`. Pedido avulso de ação materializa/inicia Task, Change, Execution e Run raiz antes da mutação; só fica pronto se o usuário autorizou apenas planejamento/preparo. Refinamento draft é Git-native, incrementa `revision`/`updated_at`; após prepare gere revisão/rework, sem Task extra salvo pedido/resultado independente.
 - Toda mudança de código tem Change antes da implementação; `change.md` registra plano, decisão, Evidence, eval, teste e resultado. Requirements são verdade funcional/técnica; Change aplica delta só após AC/Evidence. Task é trabalho executável, Execution tem snapshot DAG, invocação orquestradora é inicial, delegada é subagente e chamada LLM é evento observável.

package/templates/.agents/runtime/VERSION

@@ -1 +1 @@
-3.2.0
+3.4.0