@zaip-ai/cli 6.2.0 → 7.5.0

package/templates/.agents/tools/visual-url/visual-model.mjs

@@ -0,0 +1,393 @@
+import { applyCapturedVisual } from "./captured-visual.mjs";
+import { declaredCandidates } from "./color-candidates.mjs";
+import { resolveVariables } from "./colors.mjs";
+import { safeVisualValue } from "./safe-visual-value.mjs";
+
+export { safeVisualValue } from "./safe-visual-value.mjs";
+
+import { localDeclarationMethods } from "./local-source.mjs";
+
+export const visualModelBytes = 65536;
+
+export function boundedVisualModel(value) {
+  if (value === null || value === undefined) return value;
+  const model = structuredClone(value);
+  const size = () => Buffer.byteLength(JSON.stringify(model), "utf8");
+  if (size() <= visualModelBytes) return validateVisualModel(model);
+  // Preserve representative palette and semantic globals before repeated component detail.
+  let components = 0,
+    tokens = 0;
+  const omitted =
+    "Modelo visual amostrado para64KiB; relatório e proveniência originais permanecem integrais";
+  model.limitations.push(omitted);
+  if (!model.unknown.includes("visual_model.budget_omissions"))
+    model.unknown.push("visual_model.budget_omissions");
+  const overflow = () => size() > visualModelBytes - 128;
+  while (overflow() && model.components.length) {
+    const removed = model.components.pop();
+    components++;
+    tokens += Object.values(removed.tokens ?? {}).filter(Boolean).length;
+  }
+  for (const key of ["borders", "shadows", "radii", "spacing"])
+    while (overflow() && model.tokens[key].length) {
+      model.tokens[key].pop();
+      tokens++;
+    }
+  while (overflow() && model.variants.length) model.variants.pop();
+  const omitCandidate = (index) => {
+    model.color_candidates.splice(index, 1);
+    if (model.coverage)
+      model.coverage.candidates_omitted = (model.coverage.candidates_omitted ?? 0) + 1;
+  };
+  // Retain one full provenance context per source/value before any repeated contexts.
+  for (let index = (model.color_candidates?.length ?? 0) - 1; index >= 0 && overflow(); index--) {
+    const row = model.color_candidates[index];
+    if (
+      model.color_candidates
+        .slice(0, index)
+        .some((other) => other.source === row.source && other.value === row.value)
+    )
+      omitCandidate(index);
+  }
+  for (const [group, keys] of [
+    [
+      "typography",
+      ["letter_spacing", "line_height", "weight", "size", "heading_family", "body_family"],
+    ],
+    [
+      "colors",
+      [
+        "card_foreground",
+        "card",
+        "border",
+        "muted",
+        "secondary",
+        "accent",
+        "primary_foreground",
+        "foreground",
+        "background",
+        "primary",
+      ],
+    ],
+  ])
+    for (const key of keys)
+      if (overflow() && model.tokens[group][key] !== null) {
+        model.tokens[group][key] = null;
+        model.unknown.push(`${group}.${key}`);
+        tokens++;
+      }
+  while (overflow() && model.color_candidates?.length)
+    omitCandidate(model.color_candidates.length - 1);
+  model.limitations.push(
+    `${components} componentes e ${tokens} tokens omitidos do modelo de demonstração`,
+  );
+  return validateVisualModel(model);
+}
+
+const colorNames = {
+  background: ["background", "bg", "bg-base", "surface", "canvas"],
+  foreground: ["foreground", "text-primary", "text", "fg"],
+  primary: ["primary", "color-brand", "brand", "accent"],
+  primary_foreground: ["primary-foreground", "on-primary"],
+  secondary: ["secondary"],
+  muted: ["muted"],
+  accent: ["accent"],
+  border: ["border"],
+  card: ["card", "surface-alt", "surface"],
+  card_foreground: ["card-foreground"],
+};
+
+export function validateVisualModel(value) {
+  if (value === null || value === undefined) return value;
+  if (
+    value.schema_version !== 1 ||
+    value.method !== "declared-semantic-v1" ||
+    !["inferred", "unavailable"].includes(value.status) ||
+    !value.tokens?.colors ||
+    !value.tokens?.typography ||
+    !Array.isArray(value.components) ||
+    value.components.length > 12 ||
+    !Array.isArray(value.variants) ||
+    value.variants.length > 8 ||
+    Buffer.byteLength(JSON.stringify(value), "utf8") > visualModelBytes
+  )
+    throw new Error("Invalid bounded visual model");
+  if (value.color_candidates !== undefined) {
+    if (!Array.isArray(value.color_candidates) || value.color_candidates.length > 32)
+      throw new Error("Invalid visual color candidates");
+    for (const row of value.color_candidates)
+      if (
+        !/^#[a-f\d]{6}$/.test(row.value) ||
+        !["observed", "declared"].includes(row.source) ||
+        row.kind !== "inferred" ||
+        typeof row.property !== "string" ||
+        !/^(?:--)?[a-zA-Z][\w-]{0,127}$/.test(row.property) ||
+        !Array.isArray(row.evidence) ||
+        !row.evidence.length ||
+        row.evidence.length > 16 ||
+        !row.provenance ||
+        typeof row.reason !== "string" ||
+        row.reason.length > 512 ||
+        ![
+          null,
+          "action",
+          "gradient-text",
+          "pseudo",
+          "svg-paint",
+          "footer",
+          "surface",
+          "text",
+        ].includes(row.role_hint)
+      )
+        throw new Error("Unsafe visual color candidate");
+  }
+  if (
+    value.coverage !== undefined &&
+    (!value.coverage ||
+      !["sampled", "incomplete", "legacy-unknown"].includes(value.coverage.status) ||
+      !Array.isArray(value.coverage.limitations) ||
+      value.coverage.limitations.length > 8)
+  )
+    throw new Error("Invalid visual capture coverage");
+  const tokens = [
+    ...Object.values(value.tokens.colors),
+    ...Object.values(value.tokens.typography),
+    ...["spacing", "radii", "shadows", "borders"].flatMap((key) => {
+      if (!Array.isArray(value.tokens[key]) || value.tokens[key].length > 12)
+        throw new Error("Invalid visual token scale");
+      return value.tokens[key];
+    }),
+    ...value.components.flatMap((item) => Object.values(item.tokens ?? {})),
+  ];
+  for (const token of tokens)
+    if (
+      token !== null &&
+      (token.kind !== "inferred" ||
+        safeVisualValue(token.property, token.value) !== token.value ||
+        !Array.isArray(token.evidence) ||
+        !token.evidence.length ||
+        token.evidence.length > 16 ||
+        !token.provenance)
+    )
+      throw new Error("Unsafe visual model token");
+  return value;
+}
+
+export function visualModel(proposal, report) {
+  if (proposal.local_visual_model) return boundedVisualModel(proposal.local_visual_model);
+  const declarations = proposal.observations
+    .filter(
+      (item) =>
+        ["static-css-declaration", "browser-CSS", ...localDeclarationMethods].includes(
+          item.provenance.method,
+        ) && item.reason === null,
+    )
+    .map((item) => {
+      const split = item.value.indexOf(":");
+      return {
+        ...item,
+        property: item.value.slice(0, split).trim(),
+        declared: item.value.slice(split + 1).trim(),
+      };
+    });
+  const variables = new Map(),
+    scopes = new Map();
+  for (const item of declarations.filter((item) => item.property.startsWith("--"))) {
+    if (!scopes.has(item.provenance.selector)) scopes.set(item.provenance.selector, new Map());
+    scopes.get(item.provenance.selector).set(item.property, item.declared);
+    if (/^(?::root|html)$/.test(item.provenance.selector))
+      variables.set(item.property, item.declared);
+  }
+  const resolve = (item) =>
+    resolveVariables(
+      item.declared,
+      (key) => scopes.get(item.provenance.selector)?.get(key) ?? variables.get(key),
+    );
+  const token = (item, property = item?.property) => {
+    if (!item) return null;
+    const value = resolve(item);
+    const safe = value === null ? null : safeVisualValue(property, value);
+    return safe === null
+      ? null
+      : {
+          value: safe,
+          property,
+          kind: "inferred",
+          evidence: [item.id],
+          provenance: item.provenance,
+          reason: "Declaração estática normalizada; cascata e estado ativo não calculados",
+        };
+  };
+  const exactRoot = (item) => /^(?::root|html|body)$/.test(item.provenance.selector);
+  const simpleMatch = (selector, node) =>
+    selector.split(",").some((group) => {
+      const name = group.trim();
+      return (
+        name === node.tag ||
+        name === node.selector ||
+        (/^\.[\w-]+$/.test(name) && node.selector.split(/[.#\s]/).includes(name.slice(1)))
+      );
+    });
+  const colors = {};
+  for (const [role, names] of Object.entries(colorNames)) {
+    const named = declarations.filter(
+      (item) =>
+        item.property.startsWith("--") &&
+        names.some((name) => item.property === `--${name}` || item.property.endsWith(`-${name}`)),
+    );
+    named.sort((a, b) => Number(exactRoot(b)) - Number(exactRoot(a)));
+    const base = named.filter(exactRoot);
+    colors[role] = base.map((item) => token(item, role)).find(Boolean) ?? null;
+    if (!colors[role]) {
+      const properties =
+        role === "background"
+          ? ["background", "background-color"]
+          : role === "foreground"
+            ? ["color"]
+            : [];
+      colors[role] =
+        declarations
+          .filter((item) => exactRoot(item) && properties.includes(item.property))
+          .map((item) => token(item))
+          .find(Boolean) ?? null;
+    }
+  }
+  const font = (heading) => {
+    const nodes = proposal.dom.filter((node) =>
+      heading ? /^h[1-6]$/.test(node.tag) : node.tag === "body",
+    );
+    const rank = (item) =>
+      nodes.some((node) => simpleMatch(item.provenance.selector, node))
+        ? 3
+        : exactRoot(item) && item.property.startsWith("--")
+          ? 2
+          : exactRoot(item) && !heading
+            ? 1
+            : 0;
+    const items = declarations
+      .filter(
+        (item) =>
+          item.property === "font-family" ||
+          (item.property.startsWith("--") &&
+            (heading
+              ? /-(?:font-heading|heading-font)$/.test(item.property)
+              : /-(?:font-sans|font-body|body-font)$/.test(item.property))),
+      )
+      .filter((item) => rank(item) > 0);
+    items.sort((a, b) => rank(b) - rank(a));
+    return items.map((item) => token(item, "font-family")).find(Boolean) ?? null;
+  };
+  const one = (property) =>
+    declarations
+      .filter((item) => item.property === property)
+      .sort((a, b) => Number(exactRoot(b)) - Number(exactRoot(a)))
+      .map((item) => token(item))
+      .find(Boolean) ?? null;
+  const rows = (expression) => {
+    const seen = new Set(),
+      result = [];
+    for (const item of declarations.filter((item) => expression.test(item.property))) {
+      const value = token(item);
+      if (value && !seen.has(`${value.property}:${value.value}`)) {
+        seen.add(`${value.property}:${value.value}`);
+        result.push(value);
+      }
+      if (result.length === 12) break;
+    }
+    return result;
+  };
+  const tokens = {
+    colors,
+    typography: {
+      body_family: font(false),
+      heading_family: font(true),
+      size: one("font-size"),
+      weight: one("font-weight"),
+      line_height: one("line-height"),
+      letter_spacing: one("letter-spacing"),
+    },
+    spacing: rows(/^(?:padding|margin|gap|row-gap|column-gap)$/),
+    radii: rows(/radius$/),
+    shadows: rows(/shadow$/),
+    borders: rows(/^border-(?:width|color|style)$/),
+  };
+  const componentProperties = {
+    background: "background-color",
+    foreground: "color",
+    border: "border-color",
+    radius: "border-radius",
+    padding: "padding",
+    font_family: "font-family",
+    font_size: "font-size",
+    font_weight: "font-weight",
+    shadow: "box-shadow",
+  };
+  const components = report.components.slice(0, 12).map((item) => {
+    const local = declarations.filter((declaration) =>
+      simpleMatch(declaration.provenance.selector, item),
+    );
+    return {
+      ...item,
+      tokens: Object.fromEntries(
+        Object.entries(componentProperties).map(([role, property]) => [
+          role,
+          local
+            .filter((row) => row.property === property)
+            .map((row) => token(row))
+            .find(Boolean) ?? null,
+        ]),
+      ),
+    };
+  });
+  return boundedVisualModel(
+    applyCapturedVisual(
+      {
+        schema_version: 1,
+        method: "declared-semantic-v1",
+        status: declarations.length ? "inferred" : "unavailable",
+        tokens,
+        color_candidates: declaredCandidates(declarations, resolve).slice(0, 32),
+        coverage: {
+          status: "incomplete",
+          method: "static-declarations",
+          scanned: null,
+          sampled: null,
+          omitted: null,
+          readiness: null,
+          limitations: [
+            "CSS declarado não comprova elementos renderizados, tema ativo ou prontidão de recursos.",
+          ],
+        },
+        components,
+        theme: { status: "unknown", active: null, declared: report.themes },
+        variants: [...scopes.keys()]
+          .filter((selector) => /theme|dark|light/i.test(selector))
+          .slice(0, 8)
+          .map((selector) => ({
+            selector,
+            status: "inferred",
+            reason: "Escopo declarado; não representa tema ativo",
+          })),
+        unknown: [
+          ...Object.entries(colors)
+            .filter(([, value]) => value === null)
+            .map(([key]) => `colors.${key}`),
+          ...Object.entries(tokens.typography)
+            .filter(([, value]) => value === null)
+            .map(([key]) => `typography.${key}`),
+          "font_faces.actual_bytes",
+          "motion.executed_behavior",
+          "stack.runtime",
+          "contrast.computed_cascade",
+        ],
+        limitations: [
+          "Demonstração com tokens inferidos; não reprodução da página ou cascata observada",
+          "Valores ausentes exigem fallback local explícito; nenhum CSS/HTML externo aplicado",
+          "Componentes locais usam apenas seletor/tag exatos; seletores compostos e pseudoestados não resolvidos",
+        ],
+      },
+      proposal,
+      safeVisualValue,
+    ),
+  );
+}

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

@@ -1,5 +1,11 @@
 # ZAIP-AIOS Handbook
 
+Na v6.3, o [guia de qualidade e release](guides/26-qualidade-e-release.md)
+explica o lint antecipado e o reaproveitamento seguro dos grupos de testes
+aprovados após uma falha posterior. Uma retomada só reutiliza resultados com
+candidato, entradas, dependências e toolchain estáveis; a falha da validação
+completa continua exigindo correção e nova aprovação.
+
 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`

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

@@ -1 +1 @@
-6.2
+7.5

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

@@ -55,4 +55,4 @@ ou recomeçar os workers. Veja [recuperação](16-lifecycle-e-reconciliacao.md).
 
 Antes de editar produto, execute `zaip task workspace TASK-ID --run RUN-ID` e confirme o modo e a posse. O hook usa a raiz Git comum para validar a Task/Run entre chats; registros de lifecycle continuam graváveis para bootstrap e fechamento. `run finish` tenta limpar automaticamente somente worktree isolado da Task terminal. Se bloqueado, use `zaip task workspace TASK-ID --run RUN-ID --close` depois de resolver o motivo sem apagar trabalho alheio.
 
-Para worktree isolado, o fechamento exige branch concluída integrada ou Task bloqueada, inventaria ignorados, cria bundle e snapshot verificados em `.local/backup-branchs` e `.local/backup-worktrees`, testa restauração e só então remove checkout/branch. Caches ignorados conhecidos são inventariados como descartáveis; ignorados desconhecidos bloqueiam. No checkout compartilhado, diff de produto misturado bloqueia limpeza automática até atribuição. O backup local é consulta recuperável e permanece fora do Git; limpeza posterior é manual.
+Para worktree isolado, o fechamento exige branch concluída integrada ou Task bloqueada, inventaria ignorados, cria bundle e snapshot verificados em `.agents/private/state/backup-branchs` e `.agents/private/state/backup-worktrees`, testa restauração e só então remove checkout/branch. Caches ignorados conhecidos são inventariados como descartáveis; ignorados desconhecidos bloqueiam. No checkout compartilhado, diff de produto misturado bloqueia limpeza automática até atribuição. O backup local é consulta recuperável e permanece fora do Git; limpeza posterior é manual.

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

@@ -121,7 +121,7 @@ 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.
+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 `.agents/private/state/backup-branchs` e `.agents/private/state/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
 

package/templates/.agents/zaip-aios/guides/19-assurance-e-autonomia.md

@@ -74,7 +74,7 @@ selecionar/salvar um perfil não migra silenciosamente estados já materializado
 ## Contagem determinística e recuperação
 
 O coordenador gerenciado reserva a operação **antes** de chamar o provider em
-`.local/autonomous/recovery/<hash-da-task>/ledger.json`. O diário é durável,
+`.agents/private/state/autonomous/recovery/<hash-da-task>/ledger.json`. O diário é durável,
 privado e vinculado à Task, com escrita exclusiva e transições idempotentes.
 Não é cache descartável nem deve ser removido para liberar uma nova tentativa.
 
@@ -281,4 +281,4 @@ O ratchet de cobertura nunca reduz o piso: 80% para lines, functions e statement
 
 ## Checkout nativo corrente
 
-A descrição acima de worktree por Task pertence ao runtime autônomo gerenciado legado. Para Task avulsa Codex-native, `task workspace` concede posse exclusiva no checkout compartilhado e não cria branch. PRD/SPEC serial segue o mesmo padrão. Frentes paralelas usam branch/worktree próprios só com plano `independent_branches`, concorrência ativa e dependências e escopos disjuntos. Validação isolada curta usa worktree detached em `.local/worktrees/validation` e o remove após verificar. O fechamento de frente isolada exige snapshot e bundle recuperáveis antes de eliminar checkout/branch; diffs compartilhados misturados param para atribuição.
+A descrição acima de worktree por Task pertence ao runtime autônomo gerenciado legado. Para Task avulsa Codex-native, `task workspace` concede posse exclusiva no checkout compartilhado e não cria branch. PRD/SPEC serial segue o mesmo padrão. Frentes paralelas usam branch/worktree próprios só com plano `independent_branches`, concorrência ativa e dependências e escopos disjuntos. Validação isolada curta usa worktree detached em `.agents/private/state/worktrees/validation` e o remove após verificar. O fechamento de frente isolada exige snapshot e bundle recuperáveis antes de eliminar checkout/branch; diffs compartilhados misturados param para atribuição.

package/templates/.agents/zaip-aios/guides/20-instalacao-detalhada.md

@@ -13,7 +13,7 @@ antes de iniciar entregas; essa exigência não bloqueia `init`.
 
 O consumidor não precisa compilar o monorepo nem instalar pnpm para executar
 o runtime distribuído. No checkout mantenedor, use o pnpm fixado em
-`packageManager` (11.12.0 neste snapshot), com `corepack pnpm` quando disponível.
+`packageManager`, com `corepack pnpm` quando disponível.
 
 ## Instalação pública no projeto consumidor
 
@@ -36,24 +36,57 @@ explícito para evitar colisão entre os dois CLIs.
 ### Resumo e próximos passos
 
 A resposta final do assistente mantém a frase inicial com o comando, a linha
-“Resumo:”, bullets e exatamente uma pergunta no final. Siga o modelo obrigatório
+“Resumo:” e bullets. Só há pergunta quando falta uma escolha indispensável. Siga o modelo obrigatório
 de `.agents/skills/zaip-skill-setup/SKILL.md`, inclusive quando a instalação começou
 antes de as skills estarem disponíveis. Não converta o resumo em parágrafos.
 A versão instalada usa o rótulo `vVERSÃO` com link para sua página no npm,
 contagens reais de arquivos e resultados de SQLite e `doctor`. O link usa
 `https://www.npmjs.com/package/@zaip-ai/cli/v/<versão-instalada>`.
 
-Quando o GitHub ainda precisa de configuração, a última pergunta é:
-**Deseja ajuda para configurar seu repositório Git?**
-Se a configuração local já estiver identificada, a pergunta será:
-**Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?**
-Configuração local não comprova autenticação remota.
-
-No terminal, a pergunta é textual: o comando encerra normalmente. No chat,
-responder “sim” encaminha à skill de GitHub ou de configuração do projeto.
-A skill apresenta o que pode configurar e coleta as escolhas antes de editar.
-Concluído o GitHub, oferece a configuração do projeto; concluído o projeto,
-encerra o onboarding. Uma recusa ou adiamento encerra a oferta sem insistência.
+Codex é o padrão, sem pergunta “Codex ou Claude?”. O projeto novo recebe
+`clients.codex: true` e `clients.claude: false`. Para habilitar Claude por
+pedido explícito, use `npx @zaip-ai/cli@latest init --claude`; a opção instala
+adapters e registra a preferência, não baixa o aplicativo Claude Code.
+Updates preservam seleções existentes, inclusive Claude já habilitado.
+
+A instalação detecta o diretório e a configuração existente, verifica o template,
+preserva conteúdo do consumidor, instala as dependências ausentes conforme o perfil,
+gera adapters dos clientes habilitados e prepara o Dashboard SQLite. Depois verifica
+`doctor`, estado do Git/GitHub e integração Codex. Arquivos válidos, confiança
+do projeto, aprovação de hooks e agentes carregados são provas distintas.
+`--project-only` mantém a configuração global do Codex fora da operação.
+
+O perfil é `full` em uma instalação nova; `--profile dev-lite|lite` seleciona
+outro e updates reutilizam o perfil salvo. O perfil não é uma pergunta interativa.
+O único prompt de confirmação da CLI é a reinstalação com `--force` sem
+`--yes`, em terminal interativo; sem TTY, a CLI exige `--yes`. Um pedido
+de update no chat usa o comando autorizado com `--force --yes --profile full`,
+salvo restrição explícita, sem repetir a autorização.
+O próprio npm/npx pode pedir confirmação para baixar o pacote. O `--yes`
+antes de `@zaip-ai/cli` responde a essa confirmação; ele é separado do
+`--yes` após `init`, que confirma a reinstalação do ZAIP.
+
+### Perguntas no onboarding assistido
+
+Não há questionário obrigatório após instalar. A configuração do projeto só começa
+se fizer parte do pedido; Git/GitHub pendente é informado, sem oferta obrigatória.
+Quando a configuração estiver autorizada, descubra o que for verificável e reutilize
+o contexto e os defaults. Pergunte apenas pelos dados materiais que ainda faltam:
+
+- Nome/finalidade do projeto ou fuso diferente, quando não estiverem resolvidos.
+- Stack e partes da aplicação necessárias, se não houver definição existente.
+- Preferência de acompanhamento de uso/custos, somente se precisar mudar ou decidir.
+- Destinos e branches de deploy pertinentes, se não estiverem definidos.
+- Em setup GitHub solicitado, identidade/conta/alvo que a descoberta não consiga
+  resolver com segurança; não peça credenciais no chat.
+
+Agrupe até cinco dúvidas indispensáveis por turno. Não pergunte por cliente,
+perfil ou escolhas já resolvidas. A aprovação de hooks pendentes é uma ação na UI
+do Codex, informada uma vez, não uma pergunta de seleção nem uma aprovação textual.
+Provisionamento externo com custo, como beta hospedada Supabase, exige a autorização
+própria dessa operação e não integra a instalação padrão. Configuração local não
+comprova autenticação remota. Ao concluir, encerre sem CTA obrigatório; recusa ou
+adiamento encerra a etapa sem insistência.
 
 ### Manuais e seleção de modelos
 
@@ -63,13 +96,14 @@ O instalador preserva os READMEs do projeto na raiz. Os perfis `full`, `dev-lite
 e `lite` selecionam ferramentas de instalação; eles não classificam a dificuldade
 de uma tarefa nem ativam um modelo mais caro.
 
-O candidato local v4 mantém a seleção do principal em `manual` e configura
+O template atual preserva a seleção do principal no host e configura
+`model_orchestration.mode: auto` com `automatic_sources: [spec, prd]`,
 `execution.runtime: codex_native` para PRD/SPEC e Tasks avulsas, 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 o alvo v4 Sol/high → Sol/high → Astra/high e execução elegível no
-terceiro bloco. Schema e template v4 já adotam Codex-native como padrão;
+detalha Sol/high → Sol/high → Astra/high e execução elegível no
+terceiro bloco. Schema e template adotam Codex-native como padrão;
 adapters, pacote real e host ainda devem ser qualificados. O Essencial nunca usa Astra
 automático. Principal avulso preserva a seleção manual; filhos seguem a
 política ZAIP verificada no host. Projetos e estados legados
@@ -108,7 +142,7 @@ O setup V2 cria ou valida:
 .agents/skills/
 .agents/records/{prds,specs,changes,tasks,executions,runs}/
 .agents/records/lifecycle/
-.local/claims/                 # claims idempotentes do lifecycle; não é histórico canônico
+.agents/private/state/claims/                 # claims idempotentes do lifecycle; não é histórico canônico
 ```
 
 O runtime `.agents/runtime` usa a `.agents/` da raiz como fonte canônica das Rules, dos seis
@@ -293,7 +327,7 @@ Uma Execution é `interaction` para conversa sem Task artificial ou `delivery` p
 Operação oferece Trabalho (Kanban) e Trabalho (Lista), ambas com os filtros Todas as Tarefas, Visão Unificada Geral, PRDs, SPECs e Tarefas Avulsas. A lista mostra status, origem, Runs, Sub-Runs, duração, tokens, custo e cobertura. Operação e Monitor de Custos apresentam Runs e Sub-Runs separadamente. Cada Execution agrega contagens de Runs, Sub-Runs, finalizadores, Tasks finalizadas e Calls conhecidas sem dupla contagem; telemetria incompleta aparece como parcial. Cada segmento de uso é atribuído uma única vez; correções de duplicidade usam supersessão sem apagar o histórico.
 
 A captura do Codex persiste primeiro um envelope sanitizado em
-`.local/codex-telemetry-spool/v1/`, que permanece fora do Git. Depois do terminal da
+`.agents/private/state/codex-telemetry-spool/v1/`, que permanece fora do Git. Depois do terminal da
 invocação, a compactação produz um `InvocationSummary` e publica chunks e manifestos por
 ano/mês/writer em `.agents/records/telemetry/`. Prompts, respostas, reasoning privado e segredos não
 entram nesses arquivos.
@@ -379,6 +413,7 @@ zaip manifest rebuild|refresh|show|reconcile
 zaip verify --changed --risk lite|standard|critical
 zaip architecture validate; zaip cqrs validate; zaip modules validate; zaip profile validate
 zaip eval run
+zaip qa init|plan|run|next|record|status|resume|report
 zaip migrate plan|apply|status|rollback
 zaip plan build|validate|normalize
 zaip prd create|list|show|prepare|ready|execute|activate|deliver|block|fail|cancel
@@ -399,6 +434,13 @@ E2E do dashboard.
 
 ## Validação
 
+Para testar o próprio ZAIP-AIOS em um repositório destinado explicitamente a testes,
+use a skill `zaip-skill-qa` e seu protocolo de host. `zaip qa init` registra o
+laboratório; `plan`, `run`, `next` e `record` conduzem a execução com evidências,
+enquanto `status`, `resume` e `report` permitem acompanhar e retomar. Esse fluxo
+não publica, não instala em consumidores reais e não altera infraestrutura.
+Uma saída bem-sucedida de consulta não representa aprovação completa dos cenários.
+
 ```bash
 zaip adapters check
 zaip context inventory

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

@@ -1,5 +1,28 @@
 # Qualidade e qualificação de release
 
+## Reuso parcial e lint antecipado
+
+O perfil essencial inclui o lint raiz e o lint do CLI público antes dos contratos
+de workflow e builds caros: são 21 gates obrigatórios. O perfil estendido conserva
+seus testes adicionais e executa esse lint público uma única vez. Uma falha de lint
+interrompe a preparação antes dos testes de paridade do pacote.
+
+No rapid, um grupo aprovado não precisa ser marcado como falho só porque outro
+grupo falhou depois. Sua aprovação é consolidada somente após revalidar candidato,
+entradas de política, ferramentas e instalação. A execução completa permanece
+reprovada e o grupo realmente falho mantém seu registro de falha. Na retomada,
+somente uma prova autenticada com identidade compatível recebe HIT. Mudança de
+código, dependências, política, ferramenta ou prova incompleta impede o reuso;
+grupos que exigem SHA exato continuam exigindo checkout limpo.
+
+O cenário automatizado A aprovado/B falho preservou A nas duas retomadas, evitando
+duas execuções repetidas de A. Esse resultado é de uma fixture com processos reais,
+não uma estimativa de horas ou tokens economizados em produção. A medição final de
+dependências é compartilhada pelos grupos pendentes; não se repete após cada grupo.
+Interrupção sem prova final não produz aprovação. Nunca edite o cache ou remova
+registros de falha para forçar um HIT; a qualificação assinada do TGZ permanece
+independente e obrigatória para publicação.
+
 ## Ajustes e publicação na v6.2
 
 Pedidos diretos de finalizar pendências, atualizar documentação e publicar uma
@@ -390,6 +413,14 @@ proteções de segredos, destruição, lifecycle, filhos restritos e energia do
 
 ## Ciclo corrente, limpeza e CI da main antes da Release
 
+No builder com opt-in versionado em `.github/ci-validation.json`, siga a
+[validação remota](../../skills/zaip-skill-release-qualification/references/remote-validation.md).
+Essa rota move os testes determinísticos para Actions na `main` existente,
+sem criar branches. O push autorizado inicia a qualificação; Release/npm exigem
+sucesso autenticado no SHA exato. Autorização humana de publicação, ciclo
+congelado, identidade exata, preservação de alterações, revisão e aceite continuam
+obrigatórios. Consumidores e recuperações históricas conservam suas próprias rotas.
+
 O manifesto versionado `.agents/config/release-cycle.json` identifica `current_release` e estado `open`/`frozen` (4.5 e 4.5.0 são normalizados). Drafts de PRD/SPEC futuros são permitidos; ready/execução, novas Tasks e código exigem o release corrente. Depois de conciliar Tasks atuais, prove `main`, branches, worktrees e registros antes do candidato. Branch/worktree isolados são fechados com backup local recuperável; checkout compartilhado com diff de proveniência mista bloqueia. A existência de `main` ou de um teste verde isolado não qualifica a release.
 
 Para congelar, use `node scripts/release-cycle-gate.mjs freeze --repository ROOT --version VERSAO`. A exceção da Task de coordenação exige risco crítico, alvo corrente, IDs explícitos `--release-task TASK-ID --release-run RUN-ID` e vínculos canônicos válidos. O manifesto frozen registra esses IDs. Há três contratos distintos:

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

@@ -23,7 +23,7 @@ evento observável do Codex
         │
         ▼
 spool local sanitizado e ignorado pelo Git
-.local/codex-telemetry-spool/v1/
+.agents/private/state/codex-telemetry-spool/v1/
         │
         ▼
 InvocationSummaryV1 por agent_invocation_id
@@ -92,7 +92,7 @@ catálogo, da seleção planejada ou do comportamento aparente.
 ### Chunks e manifestos
 
 Cada workspace recebe um `writer-id` aleatório persistido somente em
-`.local/telemetry-writer-id.json`. Isso separa autores e worktrees e reduz conflitos
+`.agents/private/state/telemetry-writer-id.json`. Isso separa autores e worktrees e reduz conflitos
 em um manifesto global compartilhado.
 
 Os summaries de cada mês são ordenados e escritos em chunk imutável endereçado pelo hash do

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

@@ -293,8 +293,8 @@ caminhos dispensa Evidence, gates e decisão real de Gui.
 
 ## Regra operacional de checkout e release
 
-Branch é uma linha de commits; worktree é outra pasta de checkout que pode apontar para uma branch. Task avulsa ou PRD/SPEC serial usa um único checkout e um escritor por Task/Run registrado na raiz Git comum. Assim, uma edição pequena não cria branch. Só frentes paralelas independentes, com concorrência ativa, dependências resolvidas e `write_scopes` disjuntos, recebem branch e worktree separados. Um teste isolado pode usar worktree detached temporário em `.local/worktrees/validation`.
+Branch é uma linha de commits; worktree é outra pasta de checkout que pode apontar para uma branch. Task avulsa ou PRD/SPEC serial usa um único checkout e um escritor por Task/Run registrado na raiz Git comum. Assim, uma edição pequena não cria branch. Só frentes paralelas independentes, com concorrência ativa, dependências resolvidas e `write_scopes` disjuntos, recebem branch e worktree separados. Um teste isolado pode usar worktree detached temporário em `.agents/private/state/worktrees/validation`.
 
-No fim da Task isolada, integre trabalho concluído, inventarie arquivos e ignorados, faça bundle/snapshot verificáveis em `.local/backup-branchs` e `.local/backup-worktrees` e feche branch/worktree. Se a Task estiver bloqueada, preserve o trabalho no backup antes de liberar o checkout. A limpeza dos backups é manual. No checkout compartilhado, alterações de várias Tasks sem atribuição verificável bloqueiam fechamento automático.
+No fim da Task isolada, integre trabalho concluído, inventarie arquivos e ignorados, faça bundle/snapshot verificáveis em `.agents/private/state/backup-branchs` e `.agents/private/state/backup-worktrees` e feche branch/worktree. Se a Task estiver bloqueada, preserve o trabalho no backup antes de liberar o checkout. A limpeza dos backups é manual. No checkout compartilhado, alterações de várias Tasks sem atribuição verificável bloqueiam fechamento automático.
 
 O ciclo em `.agents/config/release-cycle.json` admite drafts de PRD/SPEC futuros, mas execução só do release corrente. `freeze`, `audit` e `advance` exigem prova de SHA, estado canônico e branches/worktrees. Para release/crítico, checks locais fixos antecedem o push de `main`; CI remoto do mesmo SHA antecede a Release. A exceção de uma Task de coordenação de release exige identidade explícita no manifesto congelado, Run ativa no freeze, risco crítico, alvo corrente e escopos somente de release. Ela termina e integra seus records no candidato antes de `audit`; audit/advance conferem os records no SHA. Até a auditoria ficar verde, o release permanece pendente.