@zaip-ai/cli 6.2.0 → 7.5.0

package/templates/.agents/skills/zaip-skill-change/references/observable-evidence.md

@@ -80,12 +80,12 @@ Quando uma captura real selecionada já foi examinada, preserve o arquivo tempor
 
 ```text
 zaip evidence screenshot preserve --source ABSOLUTE_IMAGE --change CHG-ID --task TASK-ID --run RUN-ID --scenario rota-ou-cenario --state estado-observado --examined-by AGENT-OU-PESSOA --observed-at ISO-8601 --json
-zaip evidence screenshot verify --evidence .local/evidences/c-HASH/t-HASH/r-HASH/rota-ou-cenario--estado-observado.png --json
+zaip evidence screenshot verify --evidence .agents/private/state/evidences/c-HASH/t-HASH/r-HASH/rota-ou-cenario--estado-observado.png --json
 ```
 
-O resultado fornece locators relativos em `.local/evidences/c-<hash>/t-<hash>/r-<hash>/`, mantendo os IDs completos CHG/TASK/RUN/EXEC somente no sidecar de cada extensão (`.png.evidence.json`, por exemplo), junto ao SHA-256, bytes, examinador e horário observado. Os nomes de cenário e estado são slugs minúsculos Windows-safe de até 32 caracteres; o destino completo tem limite de 240 caracteres. Um destino existente falha e nunca é sobrescrito. Quando ausente, o comando cria somente o marcador `.local/.gitignore` com `*` e `!.gitignore`; se ele já existir, exige exatamente esse conteúdo e não o reescreve. A fonte pode permanecer temporária ou ser descartada somente depois da preservação e da verificação bem-sucedida.
+O resultado fornece locators relativos em `.agents/private/state/evidences/c-<hash>/t-<hash>/r-<hash>/`, mantendo os IDs completos CHG/TASK/RUN/EXEC somente no sidecar de cada extensão (`.png.evidence.json`, por exemplo), junto ao SHA-256, bytes, examinador e horário observado. Os nomes de cenário e estado são slugs minúsculos Windows-safe de até 32 caracteres; o destino completo tem limite de 240 caracteres. Um destino existente falha e nunca é sobrescrito. Quando ausente, o comando cria somente o marcador `.agents/private/.gitignore` com `*` e `!.gitignore`; se ele já existir, exige exatamente esse conteúdo e não o reescreve. A fonte pode permanecer temporária ou ser descartada somente depois da preservação e da verificação bem-sucedida.
 
-O marcador existente aceita finais de linha LF ou CRLF, sem reescrita. `.local/evidences/` é histórico local persistente: não deve participar da limpeza de temporários ou caches. Capturas exploratórias continuam em `.temp` ou no temporário da ferramenta; somente as selecionadas e examinadas são preservadas. As imagens não acompanham clones do Git e precisam de backup local independente quando sua retenção for necessária.
+O marcador existente aceita finais de linha LF ou CRLF, sem reescrita. `.agents/private/state/evidences/` é histórico local persistente: não deve participar da limpeza de temporários ou caches. Capturas exploratórias continuam em `.temp` ou no temporário da ferramenta; somente as selecionadas e examinadas são preservadas. As imagens não acompanham clones do Git e precisam de backup local independente quando sua retenção for necessária.
 
 Esse comando não abre uma UI, não certifica a origem da imagem, não examina pixels e não substitui `validation observe`, Validation ou Evidence. Registre URL, viewport, versão carregada, expectativa, resultado e limitações na observação; indique somente o locator preservado. Screenshot e hash sozinhos continuam insuficientes para provar comportamento, integração ou aprovação.
 

package/templates/.agents/skills/zaip-skill-cloud-engineering/SKILL.md

@@ -5,6 +5,8 @@ description: Design, provision, and validate infrastructure as code inside decla
 
 # Engenharia de cloud
 
+Para o cofre padrão do backend, use [Infisical self-hosted](../zaip-skill-infisical/SKILL.md): preparo, implantação autorizada e verificação são etapas distintas.
+
 Para uma pessoa começando uma VPS/Hostinger, conduza primeiro o [guia inicial de VPS e Terraform](../zaip-skill-hostinger-cloudflare-terraform/references/guia-iniciante-hostinger-vps.md). Faça no máximo três perguntas simples e avance uma etapa por vez: objetivo, ação humana, ação do Codex, resultado observável e retomada segura. O guia não autoriza compra, SSH, API, Terraform apply ou deploy.
 
 1. Delimitar ambiente, recurso, provider, estado atual e rollback antes da mudança.

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

@@ -0,0 +1,16 @@
+---
+name: zaip-skill-cloudflare-access-setup
+description: Guide Cloudflare account, scoped API token and DNS or Pages access setup, validating declared targets before authorized operations. Use for configuring access credentials, not Zero Trust applications.
+---
+
+# Acesso de API Cloudflare para DNS e Pages
+
+Use o [tutorial](references/account-token.md) para orientar conta, zona, token e entrega privada, começando da etapa já conhecida. Reutilize mandato vigente e faça perguntas somente sobre os identificadores/objetivo ausentes.
+
+1. Separe documentação, configuração local, autenticação e operação remota. Criar conta, contratar domínio, mudar nameservers e publicar exigem seus próprios escopos; setup não os presume.
+2. Delimite conta, zona, hostnames/projeto e operação. Prefira tokens separados de DNS e Pages e permissões mínimas por recurso; nunca Global API Key ou todas as contas/zonas como atalho.
+3. Prepare contrato sem valores e valide-o com `scripts/preview-access.mjs`. A prévia é offline e não comprova token, associação de conta, propagação nem permissões reais.
+4. Entregue token por fonte privada declarada, nunca chat/argv/prints. Para DNS, valide conta/zona e use exclusivamente `.agents/tools/cloud-runner.mjs` com contrato aprovado; para publicação Pages siga a skill de deploy correspondente e sua autoridade própria. O runner DNS não implementa deploy Pages.
+5. Verifique leitura autorizada e negações por conta/zona fora do escopo, sem editar recurso alheio para testar. Recusa bloqueia: não troque para MCP/HTTP/CLI, nem desative hooks. Registre códigos sanitizados e limitações.
+
+Este nome trata de **acesso à API**. Aplicação Cloudflare Access/Zero Trust, login corporativo e service tokens desse produto são workflows distintos, não configurados por esta skill.

package/templates/.agents/skills/zaip-skill-cloudflare-access-setup/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: "Cloudflare: acesso DNS e Pages"
+  short_description: "Preparar conta e tokens de API com escopo mínimo"
+  default_prompt: "Use $zaip-skill-cloudflare-access-setup para preparar acesso DNS ou Pages na conta e zona explicitamente autorizadas."

package/templates/.agents/skills/zaip-skill-cloudflare-access-setup/references/account-token.md

@@ -0,0 +1,90 @@
+# Tutorial: conta e token Cloudflare
+
+Comece do ponto atual: **já tenho conta/zona/token**, **tenho conta sem token** ou **ainda não tenho conta**. Não recrie recursos existentes. No máximo três perguntas úteis: qual conta/zona? DNS ou Pages e qual projeto/hostname? quais operações já estão autorizadas? Se os fatos já constarem no contexto, avance.
+
+## 1. Conta e identificadores
+
+No navegador, entre no painel Cloudflare com usuário próprio e MFA disponível. Sem conta, o humano faz cadastro, verificação de e-mail e configura recuperação. Não peça senha/código no chat. Abra a conta correta e a zona existente; registre Account ID e Zone ID não secretos e confira nome/domínio. Uma pessoa pode pertencer a várias contas: nome do usuário ou token ativo não seleciona a conta autorizada.
+
+Se a zona ainda não existe, prepare a proposta: domínio, registrador, DNS atual, e-mail e DNSSEC. Adicionar zona ou mudar nameservers requer autorização específica e inventário/rollback. Não compre domínio nem mude delegação como pré-requisito silencioso de token Pages. [Encontrar IDs](https://developers.cloudflare.com/fundamentals/setup/find-account-and-zone-ids/).
+
+## 2. Token mínimo para a operação
+
+Abra **My Profile → API Tokens → Create Token → Custom Token** ou a tela equivalente de Account API tokens, respeitando o tipo de token suportado pela ferramenta. Escolha nome que identifique uso, expiração adequada e restrição de IP somente se o egress real for conhecido. Em Resources, selecione **Specific account** e/ou **Specific zone**; revise resumo antes de criar. Nunca use Global API Key. [Procedimento oficial](https://developers.cloudflare.com/fundamentals/api/get-started/create-token/).
+
+| Objetivo | Permissões no painel | Recurso |
+| --- | --- | --- |
+| Ler DNS e conferir conta/zona pelo runner | Zone → Zone → Read; Zone → DNS → Read | Somente a zona aprovada |
+| Criar/alterar DNS pelo runner | Zone → Zone → Read; Zone → DNS → Edit | Somente a zona aprovada |
+| Inspecionar projeto Pages | Account → Cloudflare Pages → Read | Somente a conta aprovada |
+| Publicar/gerir Pages sob mandato próprio | Account → Cloudflare Pages → Edit | Somente a conta aprovada |
+
+`Edit` é o nome da permissão de escrita no painel; a API pode descrevê-la como Write. Permissão DNS Edit inclui leitura de registros, mas Zone Read continua necessária para o preflight de identidade da zona. Não acrescente Account Read indiscriminadamente: adicione somente se um endpoint de descoberta realmente usado o exigir, depois de revisar o delta. A permissão Pages é em nível de conta; o contrato da ferramenta restringe projeto, mas não transforma o token em token limitado a um único projeto. Use tokens separados para reduzir exposição. [Permissões](https://developers.cloudflare.com/fundamentals/api/reference/permissions/), [Pages CI](https://developers.cloudflare.com/pages/how-to/use-direct-upload-with-continuous-integration/).
+
+## 3. Entrega privada e prévia offline
+
+O humano copia o token diretamente ao destino privado aprovado (secret store/CI ou dotenv ignorado da raiz, conforme contrato). Nunca envie token ao agente, use argumento ou exiba screenshot. O runner lê `CLOUDFLARE_API_TOKEN` da fonte explicitamente selecionada; IDs `TF_VAR_cloudflare_account_id`, `TF_VAR_cloudflare_zone_id` e `TF_VAR_cloudflare_zone_name` são identificadores, não autoridade. Não passe token como variável Terraform. Token expirado é substituído com procedimento explícito, sem fallback global.
+
+Para revisar a intenção antes de autenticar, prepare `.agents/config/cloudflare-access.json` sem segredo:
+
+```json
+{
+  "version": 1,
+  "provider": "cloudflare",
+  "operation": "dns-write",
+  "accountId": "ACCOUNT_ID_REAL_32_HEX",
+  "zoneId": "ZONE_ID_REAL_32_HEX",
+  "zoneName": "example.com",
+  "tokenResourceAccountId": "ACCOUNT_ID_REAL_32_HEX",
+  "tokenResourceZoneId": "ZONE_ID_REAL_32_HEX",
+  "permissions": ["Zone:Zone:Read", "Zone:DNS:Edit"],
+  "authorization": {"approved": true, "reference": "mandato-delimitado"}
+}
+```
+
+Para Pages substitua operation por `pages-read` ou `pages-write`, informe `project` real e permissões Pages correspondentes; não inclua permissões DNS no token Pages. Campos tokenResource* descrevem o resumo humano do token, não introspecção remota.
+
+```text
+node .agents/skills/zaip-skill-cloudflare-access-setup/scripts/preview-access.mjs --contract .agents/config/cloudflare-access.json
+```
+
+A saída confirma somente consistência da declaração. O verificador não lê token, não acessa rede, não cria recurso e não prova que as permissões declaradas existem.
+
+## 4. Autenticação e negações reais
+
+Para DNS, prepare o contrato operacional descrito em [DNS/edge](../../zaip-skill-hostinger-cloudflare-terraform/references/cloudflare-dns.md). Use **somente** `node .agents/tools/cloud-runner.mjs`, com a conta/zona exatas, fonte nomeada, operação de leitura e registro autorizado. O preflight confere zona, nome e conta retornados pela API. Um token ativo no endpoint de verificação só prova validade, não esses vínculos. O runner DNS dispensa Hostinger/SSH/backend. Não use a derivação legada combinada para DNS-only.
+
+O Codex pode preparar este contrato DNS-only sem valores de token, preenchendo os IDs reais a partir do escopo autorizado; o humano não precisa escrever JSON manualmente. Exemplo de leitura de um registro cujo dono é Terraform:
+
+```json
+{
+  "version": 1,
+  "profile": "autonomous-cloud",
+  "authorization": {"standing": true, "reference": "mandato-delimitado"},
+  "cloudflare": {
+    "account_id": "ACCOUNT_ID_REAL",
+    "zone_id": "ZONE_ID_REAL",
+    "zone_name": "example.com",
+    "allowed_operations": ["cloudflare:dns:read"],
+    "dns_records": ["secrets.example.com"]
+  }
+}
+```
+
+Depois de salvar o contrato aprovado em `.agents/config/autonomous-cloud-contract.json` e entregar o token à fonte raiz privada, a leitura autorizada usa o comando abaixo, substituindo IDs e hostname pelos reais. É chamada autenticada, não prévia; não execute durante trabalho limitado a documentação/simulação.
+
+```text
+node .agents/tools/cloud-runner.mjs --contract .agents/config/autonomous-cloud-contract.json --operation cloudflare:dns:read --provider cloudflare --account-id ACCOUNT_ID_REAL --credentials-source root --zone-id ZONE_ID_REAL --dns-record secrets.example.com --dns-type A
+```
+
+Para escrita direta autorizada, o contrato exige `direct_dns_records`, seletor e conteúdo exatos, operações próprias e ausência de dono Terraform; use a referência DNS. Não transforme o exemplo de leitura em criação por trocar apenas um verbo.
+
+Antes da escrita, leia o registro exato e seu dono; revisão deve mostrar delta e rollback. Em ambiente simulado, teste alvo fora da conta/zona e operação ausente; em ambiente real, use apenas negativas de leitura previamente autorizadas e confirme recusa sem efeito. Não crie DNS/Pages alheio para provar que token é restrito. 401 indica falha de autenticação; 403 não prova sozinho qual permissão falta. Resposta incerta de escrita exige reconciliação, não retry automático.
+
+Para Pages, a associação de conta e o acesso de leitura ao projeto devem ser comprovados pelo fluxo de integração/deploy autorizado. Este runner DNS não implementa Pages: reporte capability indisponível em vez de usar HTTP/Wrangler como atalho. Deploy Pages só pela [skill correspondente](../../zaip-skill-cloudflare-github-deploy/SKILL.md), respeitando política da Task e autorização própria de publicação. Conta com Pages Edit não autoriza publicar por si só.
+
+## 5. DNS, TLS e retomada
+
+VPS/cofre: registro edge, certificado de origem válido, Full (strict), certificado edge e health pelo hostname. Pages: vincule domínio ao projeto antes de concluir CNAME; confira status e certificado, pois CNAME isolado não prova associação. Preserve MX/SPF/DKIM/DMARC, CAA e DNSSEC. [DNS/TLS](../../zaip-skill-hostinger-cloudflare-terraform/references/cloudflare-dns.md).
+
+Registre conta/zona/projeto, operação, momento e resultado sanitizado. Retome da última etapa comprovada, sem repetir token/cadastro/escrita. Bloqueio de hook ou provider mantém a etapa pendente; não desligue governança nem troque transporte. Instalação de MCP/skills/CLI não concede autoridade e não substitui a prova de alvo.

package/templates/.agents/skills/zaip-skill-cloudflare-access-setup/scripts/preview-access.mjs

@@ -0,0 +1,91 @@
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { argumentsFor, fail, localFile } from "../../../tools/infisical-policy.mjs";
+
+const workspace = resolve(import.meta.dirname, "../../../..");
+const id = (value) => typeof value === "string" && /^[a-f0-9]{32}$/.test(value);
+const operations = ["dns-read", "dns-write", "pages-read", "pages-write"];
+/** Validates declared scope only; never loads credentials or contacts Cloudflare. */
+export function previewAccess(c) {
+  if (
+    c?.version !== 1 ||
+    c.provider !== "cloudflare" ||
+    !id(c.accountId) ||
+    !operations.includes(c.operation) ||
+    c.authorization?.approved !== true ||
+    typeof c.authorization.reference !== "string" ||
+    !c.authorization.reference.trim()
+  )
+    fail("invalid_contract");
+  if (
+    !Array.isArray(c.permissions) ||
+    !c.permissions.length ||
+    new Set(c.permissions).size !== c.permissions.length ||
+    c.permissions.some(
+      (p) =>
+        ![
+          "Zone:Zone:Read",
+          "Zone:DNS:Read",
+          "Zone:DNS:Edit",
+          "Account:Cloudflare Pages:Read",
+          "Account:Cloudflare Pages:Edit",
+        ].includes(p),
+    )
+  )
+    fail("invalid_permissions");
+  if (c.operation.startsWith("dns-")) {
+    if (!id(c.zoneId) || !/^(?:[a-z0-9-]+\.)+[a-z0-9-]+$/.test(c.zoneName ?? ""))
+      fail("invalid_zone");
+    if (
+      !c.permissions.includes("Zone:Zone:Read") ||
+      (!c.permissions.includes(c.operation === "dns-write" ? "Zone:DNS:Edit" : "Zone:DNS:Read") &&
+        !(c.operation === "dns-read" && c.permissions.includes("Zone:DNS:Edit")))
+    )
+      fail("missing_permission");
+    if (c.permissions.some((p) => p.startsWith("Account:"))) fail("unnecessary_permission");
+  } else {
+    if (
+      !/^[a-z0-9][a-z0-9-]{0,62}$/.test(c.project ?? "") ||
+      (!c.permissions.includes(
+        c.operation === "pages-write"
+          ? "Account:Cloudflare Pages:Edit"
+          : "Account:Cloudflare Pages:Read",
+      ) &&
+        !(c.operation === "pages-read" && c.permissions.includes("Account:Cloudflare Pages:Edit")))
+    )
+      fail("missing_permission");
+    if (c.permissions.some((p) => p.startsWith("Zone:"))) fail("unnecessary_permission");
+  }
+  if (
+    c.tokenResourceAccountId !== c.accountId ||
+    (c.operation.startsWith("dns-") && c.tokenResourceZoneId !== c.zoneId)
+  )
+    fail("declared_scope_mismatch");
+  return {
+    ok: true,
+    operation: c.operation,
+    accountId: c.accountId,
+    ...(c.operation.startsWith("dns-")
+      ? { zoneId: c.zoneId, zoneName: c.zoneName }
+      : { project: c.project }),
+    remoteOperations: false,
+    tokenVerified: false,
+    declaredScopeOnly: true,
+  };
+}
+
+if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1])).href) {
+  try {
+    const args = argumentsFor(process.argv.slice(2), ["contract"]);
+    console.log(
+      JSON.stringify(
+        previewAccess(
+          JSON.parse((await localFile(workspace, args.contract)).bytes.toString("utf8")),
+        ),
+      ),
+    );
+  } catch {
+    console.error(JSON.stringify({ ok: false, code: "access_preview_failed" }));
+    process.exitCode = 1;
+  }
+}

package/templates/.agents/skills/zaip-skill-cloudflare-access-setup/scripts/preview-access.test.mjs

@@ -0,0 +1,44 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { previewAccess } from "./preview-access.mjs";
+
+const dns = () => ({
+  version: 1,
+  provider: "cloudflare",
+  accountId: "a".repeat(32),
+  zoneId: "b".repeat(32),
+  zoneName: "example.test",
+  operation: "dns-write",
+  tokenResourceAccountId: "a".repeat(32),
+  tokenResourceZoneId: "b".repeat(32),
+  permissions: ["Zone:Zone:Read", "Zone:DNS:Edit"],
+  authorization: { approved: true, reference: "offline fixture" },
+});
+test("DNS preview accepts exact zone/account declaration without claiming live authentication", () => {
+  const result = previewAccess(dns());
+  assert.equal(result.tokenVerified, false);
+  assert.equal(result.remoteOperations, false);
+});
+test("Pages uses account Pages Edit without DNS permissions", () => {
+  const c = {
+    ...dns(),
+    operation: "pages-write",
+    project: "my-pages",
+    permissions: ["Account:Cloudflare Pages:Edit"],
+  };
+  assert.equal(previewAccess(c).project, "my-pages");
+  assert.throws(() => previewAccess({ ...c, permissions: ["Account:Cloudflare Pages:Read"] }), {
+    safeCode: "missing_permission",
+  });
+});
+test("mismatched targets, missing DNS Edit, extra broad permission and absent approval fail closed", () => {
+  for (const patch of [
+    { tokenResourceAccountId: "c".repeat(32) },
+    { tokenResourceZoneId: "c".repeat(32) },
+    { permissions: ["Zone:Zone:Read", "Zone:DNS:Read"] },
+    { permissions: ["Zone:Zone:Read", "Zone:DNS:Edit", "All"] },
+    { authorization: { approved: false } },
+    { permissions: [...dns().permissions, "Account:Cloudflare Pages:Edit"] },
+  ])
+    assert.throws(() => previewAccess({ ...dns(), ...patch }));
+});

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

@@ -15,8 +15,8 @@ Use for an authorized change that creates or changes a GitHub Actions workflow w
 
 ## Workflow contract
 
-- The workflow uses `push` on `deploy.branch`, `workflow_dispatch`, least-privilege `permissions: { contents: read }`, and one concurrency group with `cancel-in-progress: true`. Its deploy job accepts either trigger only when `github.ref` is the configured validation branch, rejecting `main`, the configured production branch, and every other ref.
-- A Workers workflow deploys an explicit validation environment and target; it never falls through to Wrangler's default production environment. A Pages workflow publishes a preview branch equal to `deploy.branch`, which must differ from `deploy.production_branch`; production stays a human promotion.
+- Resolve the application branch from `deploy.frontend.branch` or `deploy.backend.branch`. Use that exact branch for `push`, `workflow_dispatch` guards and the Pages `--branch`; `main` is valid when configured and authorized. Use least-privilege `permissions: { contents: read }` and one concurrency group with `cancel-in-progress: true` per target. Reject every other ref.
+- Declare the delivery mode before rendering: preview or production. Preview must use a separate Worker target/environment or a Pages branch different from the provider project's production branch. Production requires authorization covering that target; it may use the configured `main`. Never infer production authority from a branch name. Configure Workers with an explicit `--env <deployment-environment>` for either mode; never silently deploy the default environment. Database promotion remains outside this skill.
 - Pin actions to reviewed immutable commit SHAs and pin Node, the package-manager release, and Wrangler. A floating major reference such as `@v4` is only a review-time convenience, never a final deployment reference. Install with the declared frozen-lock option (`pnpm --frozen-lockfile`, `npm ci`, or equivalent).
 - Keep bundled public variables (for example, `VITE_*`) separate from runtime secrets; a public build variable is never a server secret. Pass only the scoped Cloudflare API-token secret and account identifier to the deployment command; put runtime secrets in the Cloudflare target's secret store through a separately authorized operation.
 - Default to a scoped `CLOUDFLARE_API_TOKEN` with only the deployment permissions required by the selected account and target. Accept `CLOUDFLARE_API_KEY` plus email only when the Task explicitly selects a documented legacy mode. If a separately authorized operation needs a local credential, follow `$zaip-skill-local-credentials` and pass it only to the minimal authorized subprocess; never expose, migrate, or automatically reauthorize it.
@@ -34,4 +34,6 @@ Read [the Workers configuration contract](references/workers-static-assets.md) b
 
 ## Sources and comparison
 
+For agent integration, read [Cloudflare agent setup](../zaip-skill-hostinger-cloudflare-terraform/references/cloudflare-agent-setup.md). Before linking a hostname, read [DNS, TLS and domain verification](../zaip-skill-hostinger-cloudflare-terraform/references/cloudflare-dns.md); deployment success alone does not prove DNS or certificates.
+
 Use the current [setup-node cache guidance](https://github.com/actions/setup-node), [Workers Static Assets guide](https://developers.cloudflare.com/workers/static-assets/get-started/), and [Pages Functions guide](https://developers.cloudflare.com/pages/functions/) when a provider detail changes. The local `zaip-ai` comparison workflow last changed at `f11bea0ed58978763c2a604060c73ab43a7719d1`; separately, [GitHub Actions run 34074776525](https://github.com/zaip-ai/zaip-ai/actions/runs/34074776525) succeeded for SHA `81c602ded4a45bd9174ccc22279981b9fd34a57d`.

package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/references/workers-static-assets.md

@@ -16,7 +16,7 @@ Workers Static Assets needs a repository-owned `wrangler` configuration. Decide
 }
 ```
 
-For automated validation, declare an explicit `env.<validation-environment>` target that has its own Worker name and contains no production routes or domains. The workflow must call `wrangler deploy --env <validation-environment>`; it must not use the default environment.
+Declare an explicit `env.<deployment-environment>` and Worker name for each authorized target. For preview, its routes/domains must not reach production. Production uses its separately authorized environment and routes. The workflow must call `wrangler deploy --env <deployment-environment>`; it must not fall through to the default environment.
 
 - `main` is required only when the Worker has a real entrypoint. Do not add a dummy script to a static application.
 - `assets.directory` is the build output, and `binding` is the Worker-facing asset binding when Worker code reads assets.

package/templates/.agents/skills/zaip-skill-cloudflare-github-deploy/references/workflow-templates.md

@@ -1,6 +1,6 @@
 # Workflow templates
 
-Choose after inspecting the application scope. Use `deploy.frontend.branch` or `deploy.backend.branch`; its persisted value may be `main`. Database migrations never use these templates: `deploy.database.branch` is literal `beta`, has no fallback, and is promoted to `main` only by a human after validation.
+Choose after inspecting the application scope. Replace `<application-scope>` with `frontend` or `backend` and use its corresponding `deploy.frontend.branch` or `deploy.backend.branch`; its persisted value may be `main`. Pass that scope explicitly to preflight so a framework checkout cannot select the framework release branch. Database migrations never use these templates: `deploy.database.branch` is literal `beta`, has no fallback, and is promoted to `main` only by a human after validation.
 
 ## Workers Static Assets with pnpm
 
@@ -21,13 +21,13 @@ jobs:
         with: { version: "<compatible-pnpm-version>" }
       - uses: actions/setup-node@<setup-node-sha>
         with: { node-version: "<compatible-node-version>", cache: pnpm, cache-dependency-path: <root-lockfile> }
-      - run: node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --resolve-branch --branch <deploy-branch>
+      - run: node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --scope <application-scope> --resolve-branch --branch <deploy-branch>
       - run: pnpm install --frozen-lockfile
       - run: pnpm --filter <application-package> run build
         env: { VITE_PUBLIC_VALUE: "${{ vars.VITE_PUBLIC_VALUE }}" }
       - run: pnpm --filter <application-package> run build-storybook
         if: ${{ vars.BUILD_STORYBOOK == 'true' }}
-      - run: npx --yes wrangler@<compatible-wrangler-version> deploy --env=<validation-environment> --config <wrangler-config-from-app-cwd>
+      - run: npx --yes wrangler@<compatible-wrangler-version> deploy --env=<deployment-environment> --config <wrangler-config-from-app-cwd>
         working-directory: <application-path>
         env:
           CLOUDFLARE_API_TOKEN: "${{ secrets.CLOUDFLARE_API_TOKEN }}"
@@ -38,7 +38,7 @@ jobs:
 
 ## Cloudflare Pages with pnpm
 
-Pages publishes its preview branch from `deploy.branch`; it must never use the Pages production branch. Keep `deploy.branch` distinct from `deploy.production_branch`, then keep the action order, root install, package-filtered build, public build-variable boundary, and deployment credentials:
+Resolve `<deploy-branch>` from the application's configured branch. For preview, verify it differs from the Pages project's actual production branch. For an authorized production deployment, use that production branch explicitly, including `main` when configured. Verify provider configuration; a local branch name alone does not determine Pages mode. Keep the action order, root install, package-filtered build, public build-variable boundary, and deployment credentials:
 
 ```yaml pages
 name: Deploy Cloudflare Pages
@@ -57,7 +57,7 @@ jobs:
         with: { version: "<compatible-pnpm-version>" }
       - uses: actions/setup-node@<setup-node-sha>
         with: { node-version: "<compatible-node-version>", cache: pnpm, cache-dependency-path: <root-lockfile> }
-      - run: node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --resolve-branch --branch <deploy-branch>
+      - run: node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --scope <application-scope> --resolve-branch --branch <deploy-branch>
       - run: pnpm install --frozen-lockfile
       - run: pnpm --filter <application-package> run build
         env: { VITE_PUBLIC_VALUE: "${{ vars.VITE_PUBLIC_VALUE }}" }

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

@@ -7,8 +7,9 @@ import { parseDocument } from "../../zaip-skill-github-deploy/scripts/yaml-parse
 const root = resolve(import.meta.dirname, "..");
 const templates = await readFile(resolve(root, "references/workflow-templates.md"), "utf8");
 const values = {
+  "<application-scope>": "frontend",
   "<deploy-branch>": "beta",
-  "<validation-environment>": "beta",
+  "<deployment-environment>": "beta",
   "<deployment-owner>": "example-app",
   "<checkout-sha>": "11bd71901bbe5b1630ceea73d27597364c9af683",
   "<pnpm-setup-sha>": "feee3aa7598f14c5e19f7d3f92c6d8d7cbbf4d7f",
@@ -33,7 +34,7 @@ test("renders valid Workers and Pages workflows with branch guards and ordered p
   const workerSteps = workers.jobs.deploy.steps;
   assert.equal(
     workerSteps[3].run,
-    "node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --resolve-branch --branch beta",
+    "node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --scope frontend --resolve-branch --branch beta",
   );
   assert.equal(workerSteps[6].run, "pnpm --filter @example/app run build-storybook");
   assert.equal(workerSteps[7]["working-directory"], "apps/example-app");
@@ -41,7 +42,7 @@ test("renders valid Workers and Pages workflows with branch guards and ordered p
 
   assert.equal(
     pages.jobs.deploy.steps[3].run,
-    "node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --resolve-branch --branch beta",
+    "node .agents/skills/zaip-skill-github-deploy/scripts/preflight.mjs --repository . --scope frontend --resolve-branch --branch beta",
   );
   const pagesStep = pages.jobs.deploy.steps[6];
   assert.equal(pagesStep["working-directory"], "apps/example-app");
@@ -50,10 +51,28 @@ test("renders valid Workers and Pages workflows with branch guards and ordered p
   assert.doesNotMatch(JSON.stringify({ workers, pages }), /main/);
 });
 
-function render(name) {
+test("configured main production and separate preview render exact branch and environment guards", () => {
+  for (const name of ["workers", "pages"]) {
+    const workflow = render(name, {
+      "<deploy-branch>": "main",
+      "<application-scope>": "backend",
+      "<deployment-environment>": "production",
+    });
+    assertWorkflow(workflow, "main");
+    assert.match(
+      workflow.jobs.deploy.steps[3].run,
+      /--scope backend --resolve-branch --branch main$/,
+    );
+    const command = workflow.jobs.deploy.steps.at(-1).run;
+    assert.match(command, name === "workers" ? /deploy --env=production/ : /--branch=main/);
+    assert.doesNotMatch(command, /--env=beta|--branch=beta/);
+  }
+});
+
+function render(name, overrides = {}) {
   const source = templates.match(new RegExp("```yaml " + name + "\\n([\\s\\S]*?)\\n```"))?.[1];
   assert.notEqual(source, undefined, `missing ${name} template`);
-  const rendered = Object.entries(values).reduce(
+  const rendered = Object.entries({ ...values, ...overrides }).reduce(
     (text, [placeholder, value]) => text.replaceAll(placeholder, value),
     source,
   );

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

@@ -1,6 +1,6 @@
 ---
 name: zaip-skill-config
-description: Guide first steps and configure an installed ZAIP-AIOS project without editing the framework lock.
+description: Configure an installed ZAIP-AIOS project, including repository responsibility profiles for infra, database, frontend, backend, fullstack or general, without editing the framework lock.
 ---
 
 # Configurar o projeto
@@ -9,28 +9,53 @@ Use esta skill para pedidos como “me ajude a configurar meu projeto”, “pri
 
 Escopo de configuração: nome, timezone, stack, clients, tracking, destinos de deploy e preferência de publicação; Rules locais pertencem a `$zaip-skill-rules`.
 
+Para limitar um repositório a infra, banco, frontend, backend ou frontend+backend, siga
+[perfis de responsabilidade](references/repository-profiles.md). Essa configuração é
+project-owned, independente dos perfis de segurança e preservada em upgrades.
+
 ## Onboarding após instalação
 
-Uma resposta afirmativa a “Deseja ajuda para realizar a configuração inicial do ZAIP-AIOS?” ativa esta skill, tanto após a instalação quanto após o setup GitHub. Leia a configuração existente, explique em linguagem simples o que pode ser personalizado e faça uma entrevista curta antes de editar:
+Primeiros passos seguem o [onboarding básico](../zaip-skill-setup/references/basic-onboarding.md):
+dependências locais, Git, identidade, origin GitHub, primeiro commit e instalação válida.
+Não ofereça novos agentes, mudanças no core ou na lógica de orquestração.
+Não abra entrevistas de arquitetura, hosting, modelos ou autonomia. Não testar dashboard
+interno no consumidor; doctor/adapters e integração do host são verificações distintas.
+
+Leia a configuração existente e preserve escolhas, extensões, booleanos de clients/tracking
+e seleção manual do host. Sem pendência indispensável, encerre sem pergunta.
+
+## Personalização explícita (opt-in)
+
+Somente um pedido específico de personalização além dos primeiros passos ativa os
+ajustes abaixo. Onboarding não concede autorização para mudanças de funcionamento,
+criação de agentes ou revisão da orquestração. Aplique apenas o ajuste solicitado;
+explique e pergunte somente por informações indispensáveis ainda ausentes:
 
 - Nome e finalidade do projeto, fuso horário e preferências já existentes.
-- Stack e partes necessárias da aplicação, clientes Codex/Claude e acompanhamento de uso/custos.
+- Stack e partes necessárias da aplicação e acompanhamento de uso/custos, somente se faltarem escolhas indispensáveis.
 - Destinos e branches de deploy, apenas quando pertinentes ao projeto.
 
-Agrupe até cinco perguntas necessárias por turno; mostre os valores atuais para que o usuário possa mantê-los e não solicite novamente escolhas já respondidas. O aceite da ajuda inicia a entrevista, sem autorizar credenciais, recursos externos ou valores presumidos. Não peça segredos no chat. Explique as dependências somente das opções escolhidas e encaminhe às skills específicas deste procedimento.
+Agrupe até cinco perguntas necessárias por turno e não solicite novamente escolhas já respondidas. Nome/timezone/stack/client/tracking existentes não precisam de nova aprovação. Sem escolha real pendente, aplique o ajuste autorizado e valide, sem entrevista ou pergunta final obrigatória. Não peça segredos no chat; recursos externos continuam sujeitos à autorização própria.
+
+Codex é o cliente padrão: não pergunte “Codex ou Claude?” nem ofereça Claude como
+etapa obrigatória. Em projeto novo, use `clients.codex: true` e `clients.claude: false`.
+Habilite Claude somente quando solicitado explicitamente; no instalador público,
+`init --claude` registra essa escolha. Em projeto instalado, preserve os booleanos
+existentes, inclusive Claude já autorizado, sem recriar arquivos de clientes desabilitados.
+Uma escolha salva é reutilizada em atualizações e não precisa de nova confirmação.
 
 Depois de aplicar e validar as escolhas autorizadas, informe o que foi configurado e encerre o onboarding de instalação, sem outro CTA de setup, publicação automática ou retorno à pergunta sobre GitHub. Se houver recusa ou adiamento, encerre sem insistência; se houver falha, descreva a pendência sem declarar configuração concluída.
 
 1. Confirme que ZAIP-AIOS já está instalado por meio de `.agents/config/project.yaml`. Se estiver ausente, explique que a instalação é um pré-requisito e encaminhe para `$zaip-skill-setup`; não instale nem reinstale durante a configuração.
 2. Leia `.agents/config/project.yaml`, o schema vigente e somente as Rules ligadas ao ajuste solicitado; não existe comando `config set`, portanto edite o YAML canônico diretamente. A preferência de modo de deploy pertence ao JSON separado descrito abaixo; não adicione campos não suportados em `project.yaml#deploy`.
-3. Para primeiros passos, apresente as opções de personalização pertinentes antes de alterar valores e só aplique a configuração autorizada pelo usuário.
+3. Para primeiros passos, aplique as escolhas e defaults já autorizados; apresente opções somente quando houver decisão material pendente. Confiança de projeto pode ser configurada somente para o projeto exato, com backup/idempotência e confirmação por leitura, quando o host permitir; nunca altere a trust store de hooks para simular aprovação.
 4. Preserve o contrato: `schema_version: 1`; `project.id/name` não vazios; timezone IANA; `stack.id` não vazio; `stack.overrides` objeto; `clients.codex/claude` booleanos; `tracking.enabled` booleano; `currency` ISO 4217 em maiúsculas; `storage_mode` em `tracked_sanitized` ou `local_only`. `deploy.frontend.branch` e `deploy.backend.branch` são autorização persistida e podem ser `main`; `deploy.database.branch` é sempre `beta`.
 5. Nunca edite `framework.lock.yaml` manualmente: ele é estado resolvido e gerenciado pela instalação do release. Preserve valores desconhecidos apenas quando o schema os permitir; não invente providers, comandos ou credenciais.
 6. Valide config e paths com `zaip doctor`; quando a stack mudar, delegue a adaptação para `$zaip-skill-adapt-stack` e valide-a com `zaip profile validate`.
 7. Se a mudança afetar adapters, delegue a `$zaip-skill-adapters` e rode `zaip adapters build` seguido de `zaip adapters check`.
-8. Informe campos alterados, validações executadas e qualquer reinicialização necessária.
+8. Informe campos alterados e validações executadas. Confiança, aprovação de hooks e perfis carregados são estados distintos. Se a sessão não carregar um agente necessário, diagnostique a capacidade observada e compatibilidade antes de sugerir uma recarga; nunca reinicie o computador.
 9. Para `model_orchestration.mode: auto`, exija `automatic_sources: [spec, prd]`. Não inclua `task`: Tasks avulsas devem continuar usando o modelo e o esforço escolhidos manualmente no host.
-10. Ao liberar escolha manual no Codex, remova `model` e `model_reasoning_effort` do `.codex/config.toml` do projeto, pois essa camada prevalece sobre a preferência pessoal. Preserve no `~/.codex/config.toml` o default escolhido manualmente pelo usuário; remova-o somente quando o usuário quiser voltar ao modelo recomendado. Informe que edições externas exigem reinício.
+10. Ao liberar escolha manual no Codex, remova `model` e `model_reasoning_effort` do `.codex/config.toml` do projeto, pois essa camada prevalece sobre a preferência pessoal. Preserve no `~/.codex/config.toml` o default escolhido manualmente pelo usuário; remova-o somente quando o usuário quiser voltar ao modelo recomendado. Edição externa não comprova recarga: verifique metadados nativos antes de alegar modelo/perfil efetivo.
 11. Para configurar, personalizar, corrigir ou validar os perfis Codex `zaip-aios-security` e `zaip-aios-full-access`, leia `.agents/zaip-aios/guides/10-seguranca.md` antes de alterar arquivos. Preserve os limites nativos, as camadas compensatórias e as validações descritas no guia; o perfil completo continua sendo de maior risco.
 12. Para uma aplicação planejada, valide que layout, comandos, componentes e hosting declarados podem sustentar os módulos, runtime e operação escolhidos; encaminhe divergências para `$zaip-skill-adapt-stack` antes de gerar código.
 13. Configure `deploy.frontend.branch`, `deploy.backend.branch` e `deploy.database.branch` explicitamente, preservando os destinos já autorizados. Frontend e backend podem usar `main`; o valor literal salvo autoriza esse destino sem confirmação repetida. Não infira criação de beta nem sobrescreva main por um default de instalação. Banco de dados exige `beta` distinta e promoção humana posterior; configuração não provisiona uma branch hospedada.
@@ -62,5 +87,5 @@ release, sem requisitos npm, chave ou política protegida do builder.
 ## Limites
 
 - Segredos não pertencem ao config versionado.
-- Rules locais do projeto pertencem a `.agents/rules/`, fora do `framework.lock.yaml`, não ao config.
+- Rules locais do projeto pertencem a `.agents/rules/project/`, fora do `framework.lock.yaml`, não ao config.
 - Esta skill não atualiza, migra ou faz rollback de arquivos gerenciados. Quando um fluxo global como `zaip-update` ou `zaip-rollback` estiver disponível e for aplicável, descreva-o como externo à configuração; não suponha que esses comandos existam em todo ambiente.

package/templates/.agents/skills/zaip-skill-config/agents/openai.yaml

@@ -1,4 +1,4 @@
 interface:
   display_name: "ZAIP Project Config"
-  short_description: "Configure project, first steps, and personalization."
-  default_prompt: "Use $zaip-skill-config to help configure my project, including first steps and safe personalization."
+  short_description: "Check basic readiness; personalize only when requested."
+  default_prompt: "Use $zaip-skill-config to verify basic project readiness, preserve existing choices and report only actual missing prerequisites. Do not offer new agents, core or orchestration changes. Advanced personalization requires an explicit request."

package/templates/.agents/skills/zaip-skill-config/references/repository-profiles.md

@@ -0,0 +1,83 @@
+# Perfis de responsabilidade (v7.5)
+
+Use esta rotina quando a pessoa pedir limites por repositório. Ausência de configuração
+mantém `general`, sem migração dos consumidores. Leia a Rule de responsabilidade, a árvore
+real e o pedido; identifique arquivos permitidos e negados antes de configurar.
+
+| Perfil | Operações do domínio | Exemplo de conteúdo permitido, quando mapeado |
+| --- | --- | --- |
+| general | Todos, sujeitos às autorizações existentes | Projeto geral |
+| infra | Infraestrutura | Terraform, manifests, Dockerfile, Compose |
+| database | Banco de dados | Schemas, migrations e políticas de banco |
+| frontend | Interface | Páginas, componentes e assets |
+| backend | Backend | APIs, serviços, workers |
+| fullstack | Frontend e backend | Interface e serviços no mesmo repositório |
+
+Os nomes das pastas são escolhas do projeto, não inferidos pelo perfil. Um arquivo de
+aplicação colocado numa pasta autorizada não muda semanticamente de responsabilidade:
+a revisão e a Rule continuam necessárias. Paths são limites de escrita, não análise de conteúdo.
+
+1. Inspecione a escolha atual: `node .agents/tools/repository-profile.mjs show`.
+2. Faça a prévia com paths reais. Exemplo somente para um projeto que tenha essas pastas:
+
+   ```powershell
+   node .agents/tools/repository-profile.mjs configure --profile infra --write-path "infra/**" --write-path "compose.yaml" --deny-path "apps/**"
+   ```
+
+3. Confira a prévia e o `expected_sha256` retornado. Na primeira configuração autorizada,
+   execute o mesmo comando com `--apply --expected-sha256 VALOR_DA_PREVIA`; o valor é `missing`.
+   Quando já existir política, forneça o comando exato para a pessoa executar no próprio
+   terminal. O hook bloqueia substituição pelo agente, mesmo com Task/claim: ainda não existe
+   recibo específico de mudança de perfil. Baseline não é autorização. Não peça outra
+   confirmação textual nem remova a política; explique essa limitação técnica.
+4. Rode `show`, `node .agents/runtime/bin/zaip.mjs doctor --json` e testes de paths permitidos
+   e proibidos em fixture. Não teste bloqueio fazendo alterações na infraestrutura real.
+5. Informe perfil, paths e limitações. Não altere outros repositórios, consumers ou contas.
+
+O setup grava `.agents/config/repository-policy.json` com schema 1; não edite o framework
+lock. Escrita é atômica, com lock de setup e conferência do baseline; conflito exige nova
+prévia, sem retry automático. Configuração anterior recebe backup junto ao arquivo.
+Mudança de perfil sem `--write-path` limpa permissões de escrita; mesmo perfil preserva
+paths existentes. Repetir `--write-path` substitui a lista completa; `--deny-path` faz o mesmo
+para negações. Campos desconhecidos, credenciais, links e autorização externa são rejeitados.
+
+Exemplo completo:
+
+```json
+{
+  "schema_version": 1,
+  "profile": "infra",
+  "write_paths": ["infra/**", "compose.yaml", "Dockerfile"],
+  "deny_paths": ["apps/**"],
+  "external_repository_writes": false,
+  "container_source_writes": false,
+  "related_repositories": {
+    "backend": {"reference": "organization/backend", "access": "read_only"}
+  }
+}
+```
+
+O setup preserva referências existentes; novas referências podem ser preparadas por humano
+no arquivo, seguindo o schema. Não use URLs com tokens, query strings ou credenciais.
+
+## Cobertura e restrições
+
+O núcleo valida schema e domínio; writers ZAIP e claims validam paths; o runner cloud valida
+`infra` antes de credenciais, HTTP ou SSH. Hooks Codex aplicam a política antes de manutenção
+e antes das exceções full-access. Um JSON inválido falha fechado.
+
+Com política explícita, shell genérico, `node -e`, scripts arbitrários, SSH e `docker exec`
+são bloqueados. Nem `npm test`/build arbitrário recebe permissão automática: um script pode
+escrever fora do escopo. Use execução isolada com limites nativos verificáveis ou runner
+tipado revisado. Não invente autorização de execução para eliminar essa limitação.
+O runner também bloqueia `vps:host:configure` e `vps:containers:configure` baseados em scripts
+arbitrários quando houver política instalada: hash e contrato não provam que um script não
+altera código dentro do container. Inventário e operações tipadas conservam seus contratos.
+
+Cli/Rules não substituem isolamento do SO, nem interceptam ferramentas que o host não envia
+ao hook. Configurar o perfil não comprova aprovação/recarga do hook. Não alegue proteção
+universal de conectores ou Claude sem verificar a capacidade efetiva. Não há garantia contra
+um processo externo malicioso trocando paths entre a verificação e a escrita.
+
+Para recuperar erro de configuração, o humano pode restaurar o backup e executar `show`;
+o agente não relaxa a política por iniciativa própria. Não remova a política para prosseguir.

package/templates/.agents/skills/zaip-skill-dashboard-sqlite/SKILL.md

@@ -6,8 +6,8 @@ description: Rebuild and open the isolated SQLite dashboard comparison runtime.
 # Dashboard SQLite persistente
 
 Use esta skill para o dashboard SQLite em `.agents/dashboard`. `.local/sqlite/` é o diretório
-central por workspace para bancos SQLite gerenciados localmente; vários nomes estáveis podem ser
-legítimos conforme seu propósito. O Dashboard usa exatamente
+central por workspace para projeções reconstruíveis e fixtures descartáveis. Dados únicos e
+controles exigem armazenamento canônico fora de `.local`. O Dashboard usa exatamente
 `.local/sqlite/zaip-aios-dashboard.sqlite`. Nunca crie cópias do Dashboard por porta, PID, hash
 ou geração. WAL, SHM e JOURNAL são auxiliares normais do banco aberto. Fixtures descartáveis ficam
 em `.local/sqlite/tests/<fixture>/` com limpeza automática. Workspaces isolados usam sua própria