@zaip-ai/cli 6.3.0 → 7.6.0

package/templates/.agents/runtime/checksums.sha256

@@ -1,11 +1,12 @@
 b146bd0c7c60b1ab43c4f71e0b1d2262c6df6da6f7053a0425f834ccb77a6b48  LICENSE
 bc02cba77e8d51e5c580f43668863dc868eda66f1ff663bfaa49fcf3ca16320e  THIRD_PARTY_NOTICES.md
-e33e70efdb9c35eb184b87ee7abc05ac16a925c9c36e84408999dea33a741fa8  VERSION
-60293f9d34af6db86b3eb65ba860bff3684f282d2dd8633ce28b447b64aea9c9  bin/zaip.mjs
-7ceeb8edcc47ce59c7fe5d1c0bbe3e554e40cb15bd984eb3ec27a2434acaeca2  manifest.json
+ed168794d9d7df063a415e5653b0e30779b6004fefbae2a84b96cfbad461d62a  VERSION
+b6b6516200bdb412c92063e887ccef329d7c5193b5610cba5346e97c71301394  bin/historical-catalog-b6b6516200bdb412c92063e887ccef329d7c5193b5610cba5346e97c71301394.mjs
+b9b75c646ab4c6da685335e36fd855e4b110e9b7168476a9f9ef3f8fb098add8  bin/zaip.mjs
+70306752086ae84d604684f64a952429245c68cc68c96aaa5277158b6cab5aef  manifest.json
 7f89219d7c567c82a51679ad136d84364bded7ac659492537e125d33b1d58a7a  migrations/001-layout-v1.json
 5f8c48b286d0b44d8fbb57a9a5d009a8a500439aa3148d750b8f193f72995c9f  migrations/002-layout-v2.json
-2bd34b2f5c253a2167d9addaf1994167308ac0bb4fec22a794c8a5b488205278  pnpm-lock.sha256
-b3c4c2562390c6f9d803a9d0f444aa6edce3aa550271625fd3bedc17586ad82e  provenance.json
-4bda6dc62a82cd4c67da9089657161e829a0006e7585ef6a8b967dd6104c4b6d  sbom.cdx.json
+a565a60a140384751f84a15824df29ddda4a9dc2c608aca96171d2c75731f0f6  pnpm-lock.sha256
+0c3c5460bba91a82f280bc5923f306ac9c1b6a67bb908b88a472de772e1fcd67  provenance.json
+f6fef16eef724861d7a5a13cb5dcde75270b104b44681a3fd9d7561b6e0cc40b  sbom.cdx.json
 b3ffedf9e146be802a15b4009f33e031dec3071ca1525e12c67606fd964a3067  schemas/contracts.schema.json

package/templates/.agents/runtime/manifest.json

@@ -1,12 +1,13 @@
 {
   "schemaVersion": 2,
   "name": "zaip-aios",
-  "version": "6.3.0",
+  "version": "7.6.0",
   "node": ">=22",
   "files": [
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",
     "VERSION",
+    "bin/historical-catalog-b6b6516200bdb412c92063e887ccef329d7c5193b5610cba5346e97c71301394.mjs",
     "bin/zaip.mjs",
     "migrations/001-layout-v1.json",
     "migrations/002-layout-v2.json",

package/templates/.agents/runtime/pnpm-lock.sha256

@@ -1 +1 @@
-b5e11351951654d41aa78dc858d43990a12964ba4051a070613ac8b11bc73a27  pnpm-lock.yaml
+4bc8b0268e9eac5d04122c1b38e72ad075d5037ac9082f84c025ae86fe83bfcd  pnpm-lock.yaml

package/templates/.agents/runtime/provenance.json

@@ -2,10 +2,10 @@
   "schema_version": 1,
   "statement_type": "self_reported_build_integrity",
   "authenticity": "unverified",
-  "version": "6.3.0",
+  "version": "7.6.0",
   "source_origin": "zaip-aios:local-build",
-  "lockfile_sha256": "b5e11351951654d41aa78dc858d43990a12964ba4051a070613ac8b11bc73a27",
-  "sbom_sha256": "4bda6dc62a82cd4c67da9089657161e829a0006e7585ef6a8b967dd6104c4b6d",
-  "runtime_sha256": "e03b3eed9641e817d39d07b1d75b9bd7bee7e3ab9df2b90611707e84da740192",
-  "statement_sha256": "2801c481b7f993d5b6a5ef8e3955bb1f8ef922557f8e936c3df5522e24fca70c"
+  "lockfile_sha256": "4bc8b0268e9eac5d04122c1b38e72ad075d5037ac9082f84c025ae86fe83bfcd",
+  "sbom_sha256": "f6fef16eef724861d7a5a13cb5dcde75270b104b44681a3fd9d7561b6e0cc40b",
+  "runtime_sha256": "a17a233d253f35db64282a05f664d86b4b9742612c6eaed34ee7a98c6ea0bab1",
+  "statement_sha256": "01db7127e41f37005bad2a3f3ca742764181c2d703b110d76682e496c27ad00d"
 }

package/templates/.agents/runtime/sbom.cdx.json

@@ -6,7 +6,7 @@
     "component": {
       "type": "application",
       "name": "zaip-aios",
-      "version": "6.3.0"
+      "version": "7.6.0"
     }
   },
   "components": [
@@ -2527,8 +2527,8 @@
     {
       "type": "library",
       "name": "hono",
-      "version": "4.13.7",
-      "purl": "pkg:npm/hono@4.13.7"
+      "version": "4.13.11",
+      "purl": "pkg:npm/hono@4.13.11"
     },
     {
       "type": "library",
@@ -3835,8 +3835,8 @@
     {
       "type": "library",
       "name": "vite",
-      "version": "8.1.4",
-      "purl": "pkg:npm/vite@8.1.4"
+      "version": "8.1.6",
+      "purl": "pkg:npm/vite@8.1.6"
     },
     {
       "type": "library",
@@ -3925,8 +3925,8 @@
     {
       "type": "library",
       "name": "zod",
-      "version": "4.4.3",
-      "purl": "pkg:npm/zod@4.4.3"
+      "version": "4.6.6",
+      "purl": "pkg:npm/zod@4.6.6"
     },
     {
       "type": "library",

package/templates/.agents/skills/criar-pasta-obsidian/SKILL.md

@@ -8,7 +8,7 @@ description: Gere, atualize ou valide um vault Obsidian local e reconstruível c
 1. Ler `.agents/config/project.yaml`, a Rule core e o manifesto canônico `.agents/records/lifecycle/entity-snapshot.json`. Nunca varrer históricos normais nem gravar records canônicos.
 2. Gerar somente a projeção local resumida; ela contém IDs, estado, título, proveniência, relações e links para entidades presentes no lifecycle e nos artefatos formais permitidos (PRD, SPEC, Change, Task, Execution, Run, Decision, Evidence, Test, Check, Eval, Review, Requirement e Acceptance Criterion), nunca seus corpos completos:
    `node .agents/skills/criar-pasta-obsidian/scripts/generate-obsidian-vault.mjs --task <TASK-ID>`
-3. As notas têm YAML Properties, locator canônico e arestas tipadas/direcionadas (`explicit` ou `derived`). Para consultas sem abrir o snapshot, use somente `zaip manifest neighbors|path|explain|gaps`, sempre com IDs e resultado limitado. O comando grava apenas em `.local/obsidian/vault/`, cria `.obsidian/` mínima, mantém hashes incrementais e remove somente arquivos que esse manifesto anterior listava.
+3. As notas têm YAML Properties, locator canônico e arestas tipadas/direcionadas (`explicit` ou `derived`). Para consultas sem abrir o snapshot, use somente `zaip manifest neighbors|path|explain|gaps`, sempre com IDs e resultado limitado. O comando grava apenas em `.agents/private/state/exports/obsidian/vault/`, cria `.obsidian/` mínima, mantém hashes incrementais e remove somente arquivos que esse manifesto anterior listava.
 4. Validar uma projeção existente sem alterá-la:
    `node .agents/skills/criar-pasta-obsidian/scripts/generate-obsidian-vault.mjs --check --task <TASK-ID>`
 5. Tratar o vault como opcional, local e descartável. Não instalar Obsidian, não adicionar configuração do aplicativo e não iniciar o aplicativo. Se a pessoa pedir explicitamente para abrir o diretório, informar o caminho gerado ou usar o abridor local autorizado pelo host.
@@ -17,4 +17,4 @@ description: Gere, atualize ou valide um vault Obsidian local e reconstruível c
 
 - O snapshot do lifecycle e os artefatos formais referenciados continuam sendo fontes de verdade; as notas são índices derivados, não cópias. Categorias sem entidades não ganham notas vazias.
 - Reexecutar com a mesma entrada produz os mesmos arquivos; dados indisponíveis permanecem ausentes.
-- Parar e reportar se o snapshot não existir, for inválido, a Task pedida não estiver nele ou a saída sair de `.local/obsidian/vault/`.
+- Parar e reportar se o snapshot não existir, for inválido, a Task pedida não estiver nele ou a saída sair de `.agents/private/state/exports/obsidian/vault/`.

package/templates/.agents/skills/criar-pasta-obsidian/scripts/generate-obsidian-vault.mjs

@@ -1,6 +1,7 @@
-import { createHash } from "node:crypto";
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { basename, relative, resolve, sep } from "node:path";
+import { directory } from "../../zaip-skill-worktree-recovery/scripts/durable-state-files.mjs";
+import { cssToken, sha256, text, yaml } from "./obsidian-format.mjs";
 
 const MAX_SOURCE_BYTES = 250_000;
 const TRACE_ID =
@@ -33,10 +34,10 @@ for (const arg of args) {
 }
 
 const root = resolve(process.cwd());
-const output = resolve(root, ".local/obsidian/vault");
+const output = resolve(root, ".agents/private/state/exports/obsidian/vault");
 const snapshotPath = resolve(root, ".agents/records/lifecycle/entity-snapshot.json");
-if (!inside(resolve(root, ".local/obsidian/vault"), output)) {
-  fail("vault output must stay in .local/obsidian/vault");
+if (!inside(resolve(root, ".agents/private/state/exports/obsidian/vault"), output)) {
+  fail("vault output must stay in .agents/private/state/exports/obsidian/vault");
 }
 
 let snapshot;
@@ -95,6 +96,7 @@ if (check) {
   }
   process.stdout.write(`Validated ${notes.size} Obsidian projection files.\n`);
 } else {
+  await directory(root, ".agents/private/state/exports/obsidian/vault");
   const previous = await readManifest(resolve(output, "generated-manifest.json"));
   for (const portablePath of previous.files) {
     if (!notes.has(portablePath)) await rm(safeOutput(portablePath), { force: true });
@@ -106,7 +108,7 @@ if (check) {
       await writeFile(destination, content, "utf8");
   }
   process.stdout.write(
-    `Generated ${notes.size} Obsidian projection files at .local/obsidian/vault.\n`,
+    `Generated ${notes.size} Obsidian projection files at .agents/private/state/exports/obsidian/vault.\n`,
   );
 }
 
@@ -389,25 +391,6 @@ function isEntity(value) {
   );
 }
 
-function text(value) {
-  return String(value ?? "unavailable")
-    .replaceAll("\n", " ")
-    .replaceAll("\r", " ");
-}
-
-function yaml(value) {
-  return JSON.stringify(String(value ?? "unavailable"));
-}
-
-function cssToken(value) {
-  return String(value ?? "entity")
-    .toLowerCase()
-    .replaceAll(/[^a-z0-9-]/g, "-");
-}
-function sha256(value) {
-  return createHash("sha256").update(value).digest("hex");
-}
-
 function fail(message) {
   process.stderr.write(`${message}\n`);
   process.exit(1);

package/templates/.agents/skills/criar-pasta-obsidian/scripts/generate-obsidian-vault.test.mjs

@@ -1,8 +1,9 @@
 import assert from "node:assert/strict";
 import { spawnSync } from "node:child_process";
-import { access, mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { access, mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { resolve } from "node:path";
+import { after } from "node:test";
 
 async function exists(path) {
   try {
@@ -14,6 +15,7 @@ async function exists(path) {
 }
 
 const root = await mkdtemp(resolve(tmpdir(), "zaip-obsidian-test-"));
+after(() => rm(root, { recursive: true, force: true }));
 const records = resolve(root, ".agents/records/lifecycle");
 await mkdir(records, { recursive: true });
 await writeFile(
@@ -86,7 +88,7 @@ for (const scriptArgs of [[], [], ["--check"]]) {
   assert.equal(result.status, 0, result.stderr);
 }
 
-const vault = resolve(root, ".local/obsidian/vault");
+const vault = resolve(root, ".agents/private/state/exports/obsidian/vault");
 const task = await readFile(resolve(vault, "Tasks/TASK-1.md"), "utf8");
 assert.match(task, /Task summary/);
 assert.match(task, /canonical_locator: "lifecycle:TASK-1"/);

package/templates/.agents/skills/criar-pasta-obsidian/scripts/obsidian-format.mjs

@@ -0,0 +1,20 @@
+import { createHash } from "node:crypto";
+
+export function text(value) {
+  return String(value ?? "unavailable")
+    .replaceAll("\n", " ")
+    .replaceAll("\r", " ");
+}
+
+export function yaml(value) {
+  return JSON.stringify(String(value ?? "unavailable"));
+}
+
+export function cssToken(value) {
+  return String(value ?? "entity")
+    .toLowerCase()
+    .replaceAll(/[^a-z0-9-]/g, "-");
+}
+export function sha256(value) {
+  return createHash("sha256").update(value).digest("hex");
+}

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

@@ -13,3 +13,9 @@ Um `.codex/config.toml` existente sem cabeçalho `zaip-managed` é um overlay lo
 4. Gere com cabeçalho managed, versão, checksum e allowlist determinísticos; execute `adapters build` e depois `adapters check`.
 5. Verifique descoberta de todas as skills, links existentes e ausência de ampliação de permissão.
 6. Se houver drift em arquivo gerenciado, mostre diff e origem; nunca sobrescreva conteúdo do usuário silenciosamente.
+
+Gere e confira somente os clientes habilitados em `project.yaml#clients`.
+O padrão de instalação é Codex; Claude requer opt-in explícito (`init --claude`
+ou configuração solicitada). Não faça uma pergunta de seleção de cliente no
+onboarding. Preserve a seleção e arquivos personalizados em updates; arquivos de
+um cliente desabilitado não devem ser criados para satisfazer o checker.

package/templates/.agents/skills/zaip-skill-application-observability/references/lead-measurement.md

@@ -0,0 +1,52 @@
+# Observabilidade de mensuração — referência C09
+
+Owner documental: mantenedores application-observability/lead-measurement; revisão 2026-10-29. Compor [signal design](signal-design.md), [operações/allowlist](../../zaip-skill-lead-measurement/references/operations.md), [migração](../../zaip-skill-lead-measurement/references/migration.md) e [delivery](../../zaip-skill-lead-measurement/references/delivery-contract.md). Não implementa logger, métrica, painel ou alerta; nenhuma coleta/conta/DB foi consultada. Telemetria de aplicação e telemetria interna de Runs/dashboard ZAIP são superfícies diferentes.
+
+## Perguntas e condições observáveis
+
+| Pergunta / sinal | Definição e cuidado | Owner futuro / resposta |
+| --- | --- | --- |
+| Cadastro aceito virou fato esperado? | Coorte de raízes new elegíveis no contrato-fonte; contato, respostas BANT, perfil e avaliação não são denominadores intercambiáveis | Owner de negócio/dados: conferir proveniência/IDs/contrato, sem recalcular histórico ou criar eventos por ausência inferida |
+| Entrega está pendente além do permitido? | Comparar relógio confiável a available_at/due e limiar aprovado por destino; diferenciar not_due, supressão e worker parado | Owner de integração: investigar scheduler/worker/config elegível; sem SLA universal inventado |
+| Lease expirou ou resposta ficou stale? | Conferir lease/fence/tentativa por canal restrito; expiração não significa não enviado | Runtime/reconciliador: bloquear confirmação antiga e resolver possível efeito antes de retry |
+| Onde parou Kommo? | Checkpoint de suboperação, conta/destino e decisão normalizados; contato confirmado não completa link/fields/workflow | Owner CRM: preservar carteira/owner/estágio/tags/override; retomar só suboperação pendente |
+| API aceitou mas evento não aparece? | Transporte/semantic_acceptance/queued/visibilidade/dedupe/conversão/atribuição em camadas separadas | Operador do destino: obter prova faltante sem promover2xx/UTM a ingestão/atribuição |
+| Houve esgotamento/dead-letter? | Terminal com código/contagem/política e referência técnica, não dump do payload | Owner da integração: correção e decisão limitada, sem reenfileirar todos ou remintar IDs |
+| Falha é consentimento ou drift de mapping? | Ler estado vigente/finalidade e destino/versão; snapshot de enqueue não concede permissão atual | Owner técnico/privacidade: bloquear efeito, corrigir causa autorizada, sem divulgar matching/hash |
+| Sinal está disponível? | Cobertura/horário/fonte completos e efetivamente observados; unknown/unavailable não são zero saudável | Owner da telemetria: restaurar visibilidade sob autoridade própria, registrar limite de prova |
+
+Limiar, janela, volume, retenção, destinatário/on-call e objetivo são decisões a preencher por aplicação/ambiente, com owner e ação observáveis. Nenhum número universal é aplicado pelo pacote. Timestamp futuro/clock inconsistente pede diagnóstico, não idade0 inventada; ocorrência não é horário da tentativa nem momento de registro da evidência.
+
+## Dados, métricas e traces
+
+Usar apenas [allowlist técnica](../../zaip-skill-lead-measurement/references/operations.md). Códigos/categorias fechados em vez de message livre; sem PII/contato/hash/token/password/receipt/body/query. Construir novo envelope, não serializar erro/request integral nem usar fallback raw em caso de rejeição. Filtros de renderização do painel não removem dado que já vazou para storage/export/trace.
+
+Labels de métricas devem ser limitados: ambiente, provider, família de estado/código/rota ou worker conforme pergunta e orçamento de cardinalidade. Não usar event/contact/occurrence/delivery IDs, e-mail, dataset arbitrário, hash pessoal, URL completa ou SHA por evento como labels. Correlação técnica aprovada fica em logs/traces restritos e com retention própria. Traces também não são repositório de payload sensível.
+
+Contadores preservam fonte/coorte e semântica: registrar tentativa de efeito real/modelada conforme contrato, não contar claim como envio; não resetar tentativas em migração/mapping. Legacy sent permanece estado de origem sem prova semântica; confirmed local não vira attributed. Falha de tracking preserva cadastro aceito, e erro de uma entrega não torna todos os leads perdidos.
+
+Dead-letter deve conter referência/estado/código técnico e próxima decisão, não raw matching ou formulário. Payload restrito necessário é buscado só pelo componente/operador autorizado para finalidade aprovada; suporte genérico/painel não amplia acesso. Consentimento revogado não autoriza expor dados para diagnóstico.
+
+## Fixture O09 — estados esperados, não resultados
+
+JSON sintético/documental **não executado**, sem métrica ou painel observado:
+
+```json
+{
+  "fixture_id": "O09",
+  "synthetic": true,
+  "executed": false,
+  "precondition": "no authorized complete telemetry reading",
+  "inputs": { "source_available": false, "legacy_transport_status": 204, "legacy_state": "sent", "database_backup_observed": false },
+  "expected": { "availability": "unavailable", "count": null, "semantic_acceptance": "unverified", "attributed": false, "database_restore_verified": false },
+  "proof_limit": "documentary inspection; no collector, redaction, API or restore executed"
+}
+```
+
+O09 impede transformar ausência de leitura em0, HTTP204 legado em aceite ou plano de backup em restore verificado. O01 e O02–O08 na referência de operações cobrem a projeção esperada de redaction e recuperação. São cenários para futura integração C10/C11, não testes já rodados.
+
+## Verificação e recuperação condicionadas
+
+Na adoção autorizada, observar fluxo sintético de sucesso e erro controlado desde request/job até efeito/checkpoint com referências seguras, versão/candidato/horários e limites. Provar a origem dos sinais e a ausência de dados proibidos no storage/export real, não só screenshot do painel. Cada camada exige evidência própria; helper local ou teste de consentimento não provam coleta/retenção/integração real.
+
+Recuperar observabilidade sem alterar fatos: fonte indisponível tem diagnóstico próprio; uncertain continua reconciliação; restore/toggle não apagam histórico nem repetem eventos confirmados. Pausar publicador/claims novos quando necessário sob autoridade, preservando IDs, counters, checkpoints e dados. Rollback atual C09 é apenas documental; SQL/migration/restore, provisionamento de stack de observabilidade ou alteração de conta continuam fora do escopo.

package/templates/.agents/skills/zaip-skill-architecture-design/SKILL.md

@@ -7,8 +7,10 @@ description: Design application modules, boundaries, data ownership, and runtime
 
 Use when a new capability needs module boundaries, a cross-cutting design, or a documented tradeoff before code changes.
 
-1. Read the declared stack, active Requirements, existing module inventory, and `.agents/architecture/software-architecture.md`. Treat that architecture file as a generated projection; change approved config or Decisions, then regenerate it through the relevant workflow.
+1. Read the declared stack, active Requirements, existing module inventory, and the consumer's principal in `.agents/architecture/`. Reuse `software-architecture.md` when it is canonical; otherwise discover and reuse the existing principal, failing on ambiguity. Architecture and its decision history are project-owned after seeding, preserved by normal and forced updates. The default proposal is under evaluation, not a deployment assertion.
 2. Identify actors, commands, queries, owned data, public contracts, synchronous calls, and asynchronous handoffs.
 3. Assign every dependency direction and infrastructure concern to a module boundary. Record assumptions and unresolved decisions with `$zaip-skill-decisions`.
 4. Produce a concise boundary map with failure, authorization, tenancy, and rollback implications. Use `$zaip-skill-enforce-architecture` to check a proposed implementation.
 5. Keep design separate from execution authority; create a SPEC or Task only on an explicit request.
+6. Separate proposal, chosen/planned architecture, code/configuration and deployed/verified infrastructure. An explicit human topology choice authorizes updating the principal and directly affected references, with no second documentary approval. Exploratory questions do not change decisions. Record origin, time, available reason, alternatives, consequences and pending work; never invent a human reason.
+7. Review a coherent replacement against the previous document hash, preserving unrelated content and the complete prior document as superseded history. Update diagram, host roles, network/ports/isolation, data/queues/persistence, capacity/expansion, backup, observability, recovery and sequence by impact. A mismatched Terraform topology is adaptation pending; it is not permission to apply the old plan. See [the modular VPS procedure](../zaip-skill-hostinger-cloudflare-terraform/references/vps-onboarding.md).

package/templates/.agents/skills/zaip-skill-auth-tenancy/references/lead-measurement.md

@@ -0,0 +1,42 @@
+# Isolamento de mensuração — contrato C03
+
+Revisão documental 2026-10-29. Compõe [caminhos de acesso](data-access-paths.md), [identidade](../../zaip-skill-lead-measurement/references/identity-contract.md), [persistência e matriz S01–S18](../../zaip-skill-lead-measurement/references/persistence-reference.md) e [autoridade](../../zaip-skill-lead-measurement/references/authority.md). Não implementa adapter, login, policy ou SQL; nenhuma role/conexão real foi inspecionada por esta Task.
+
+## Fonte de autoridade do tenant
+
+Tenant é contexto server-owned derivado de autenticação/associação e autorização da ação. Em formulário público, a rota/formulário/ambiente precisa estar ligado a tenant por configuração confiável com controles antiabuso e protocolo aprovado. Domínio, header Origin, hidden field, UUID, client idempotency key, `persisted:true` ou destination_id do navegador não autenticam tenant ou pessoa. Não aceitar override de tenant/role/destino pelo corpo.
+
+Recuperar recibo exige autorização própria, sem enumeração por e-mail/key nem exposição de contato. Match de contato não autentica pessoa; replay de operação deve permanecer no mesmo escopo verificado. Worker trata job como input não confiável: valida versão/IDs/origem, reautoriza tenant/ação/recurso no estado vigente e rejeita payload stale, revogado, sem tenant ou divergente do registro durável. Referências a snapshots de autorização só podem existir com semântica e validade aprovadas, não por default.
+
+## GUC, RLS e privilégios
+
+Conexão PostgreSQL direta por Kysely não herda automaticamente JWT do navegador. GUC de tenant é contexto de transação; **não autentica tenant**. Quem controla SQL com a credencial da aplicação pode escolher contexto diferente. RLS aqui é defesa adicional ao backend confiável, não isolamento contra comprometimento integral da aplicação. Se o requisito exigir essa resistência, definir arquitetura/credenciais por tenant ou controle equivalente em adoção futura, sem presumir que uma GUC basta.
+
+PostgreSQL via Supabase permanece contexto atual; PostgreSQL 16 é referência condicionada à D-01, não major comprovado. Fontes oficiais da referência: [RLS PostgreSQL 16](https://www.postgresql.org/docs/16/ddl-rowsecurity.html) e [configuração de sessão PostgreSQL 16](https://www.postgresql.org/docs/16/config-setting.html). Verificação pública read-only informada pelo host em 2026-10-29; não é inspeção DB. Owner normalmente bypassa RLS; superuser/BYPASSRLS bypassam mesmo FORCE. RLS não cobre TRUNCATE/REFERENCES; não conceder tais privilégios ao runtime. SET/set_config não cria autenticação.
+
+Exigir conexões efetivas de API e worker não-owner das tabelas tenant, não-superuser e sem BYPASSRLS, com privilégios mínimos. Role de migração/admin é isolada; runtime não pode assumi-la por membership/herança/SET ROLE, pool ou composição. Não usar a exceção de owner como atalho nesta adoção. FORCE RLS, quando avaliado no desenho, não elimina checks de role/ownership/grants nem a obrigação de testar o caminho real.
+
+## Ciclo transacional e pool — pseudofluxo
+
+1. Antes do checkout da conexão, resolver identidade/contexto tenant e ação; ausente ou inválido nega sem fallback global.
+2. Verificar papel efetivo, grants/ownership e isolamento do pool de runtime; iniciar transação na mesma conexão que executará os acessos Kysely.
+3. Estabelecer contexto tenant transacional exclusivamente a partir do contexto verificado. Falha de início/contexto não executa query ou write. Não usar variável de sessão persistente, middleware executado em outra conexão ou valor residual do pool.
+4. Todos os lookups, relações, locks lógicos, keys, caches e jobs incluem escopo tenant/ambiente apropriado. IDs opacos não dispensam autorização. Revalidar vínculo pai/root/contact/event/delivery e recurso server-owned.
+5. Ao finalizar, confirmar commit ou rollback; estado desconhecido bloqueia recibo e passa a recuperação pela chave composta. Em finally conceitual, encerrar transação e descartar contexto antes da devolução ao pool.
+6. Se rollback/reset/estado da conexão falhar ou não puder ser comprovado, não reutilizar essa conexão. Recuperar/descartar via mecanismo suportado do pool; não assumir contexto vazio. Isso não concede reinício de host nem interrupção de processo alheio.
+7. Request/job seguinte, inclusive de B após A, cria seu próprio contexto desde o início. Não cachear tenant em singleton mutável nem transportar credencial admin em job. Leitura sem tenant deve negar, não retornar todas as empresas.
+
+Logs/evidências recebem somente IDs técnicos necessários, estado/código e correlação permitida; sem JWT, claims brutos, chave HMAC, fingerprint, PII ou payload. Digest HMAC não é anonimização de PII nem chave pública para buscar contato. Limitar parâmetros, tamanho, frequência e respostas da recuperação; falhas auth, forbidden, conflito e incerto mantêm causas técnicas distintas sem revelar dados de outro tenant.
+
+## Discriminantes e prova futura
+
+| Fronteira | Casos da matriz estática | Condição de rejeição / prova futura necessária |
+| --- | --- | --- |
+| Tenant A/B e IDs conhecidos | S01–S03, S13 | UUID/corpo/job não muda tenant; negar leitura/mutação/relação cruzada sem leak |
+| Pool/contexto/role | S04–S05 | Reuso A→B e exceções/rollback não vazam contexto; role privilegiada é inelegível |
+| Idempotência e recuperação | S07–S11, S14–S16, S18 | Key pública não autentica; conflito/rotação/expiração não geram novo efeito |
+| Linhagem e destino | S12–S13, S17 | Raiz/contact/tenant e recurso aprovados; mudança de mapping não autoriza replay |
+
+Na adoção autorizada, testes devem observar atributos/grants reais, negação sem contexto, tentativa A→B, reads/writes e worker, conexão reaproveitada após sucesso/erro/rollback e proibição de role admin. Teste de JWT na Data API não prova conexão direta Kysely. Teste serial/local não prova dois processos concorrentes; documento SQL, helper ou mock não prova RLS. Registrar versão real/role/candidato/camada e resultado sem secrets.
+
+Nenhum desses testes DB foi executado nesta entrega; SQL inclusive local, PGlite, psql e migrations seguem proibidos. Review de segurança independente avalia o contrato e seus limites; não transforma cenários esperados em resultados observados. Adoção depende de D-01, identidade/roles/retenção e autorizações/testes próprios; não selecionar provedor/major ou introduzir Supabase/Edge Functions novos para preencher a pendência.

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

@@ -15,7 +15,7 @@ description: Create and audit portable ZAIP skills, triggers, resources, and rel
 6. No frontmatter aceite somente `name` e `description`. A descrição deve dizer o que faz e quando dispara.
 7. Mantenha o corpo operacional e curto. Coloque schemas/exemplos extensos em `references/`, scripts determinísticos em `scripts/` e assets somente quando reutilizáveis.
 8. Gere metadata com nome legível, descrição curta específica e prompt que mencione `$nome-da-skill`; evite prompts genéricos.
-9. Rode `scripts/audit-skill-catalog.mjs` para validar referências do catálogo, bindings obrigatórios, comandos conhecidos e contratos técnicos que não podem ser duplicados em documentação; rode `scripts/run-skill-tests.mjs` para executar todos os testes de skills descobertos.
+9. Rode `scripts/audit-skill-catalog.mjs` para validar referências do catálogo, bindings obrigatórios, comandos conhecidos e contratos técnicos que não podem ser duplicados em documentação. No framework com as dependências do lock instaladas (incluindo Acorn e Vitest), use `scripts/run-skill-tests.mjs --plan` para inspecionar o inventário e `scripts/run-skill-tests.mjs` para executá-lo. O runner separa Node/Vitest pelos imports reais, limita cada grupo a oito arquivos e mantém falhas de todos os grupos; dependência ausente não equivale a teste aprovado.
 10. Valide links relativos, encoding UTF-8, placeholders, tamanho, políticas de invocação, triggers sobrepostos e comandos citados.
 11. No framework source, rode `pnpm sync:framework-lock`, validação, testes relevantes, sync do template público, build e parity; no consumer, rode somente validação da skill, `zaip doctor` e adapters aplicáveis.
 

package/templates/.agents/skills/zaip-skill-author-skills/references/engineering-skill-index.md

@@ -1,5 +1,9 @@
 # Engineering skill index
 
+Use [qa](../../zaip-skill-qa/SKILL.md) for an explicit request to test ZAIP-AIOS itself in a dedicated QA repository. It coordinates deterministic checks, real host work items and evidence-backed telemetry/dashboard verification without publication; ordinary application tests still use `testing-strategy`.
+
+Use [infisical](../../zaip-skill-infisical/SKILL.md) for the default self-hosted backend secret store: installation preparation, machine identities, create-only credentials and scoped delivery to reviewed backend processes. It does not authorize real infrastructure or provider credential issuance.
+
 Use `architecture-design` before a cross-module capability; `dev-environment` for checkout prerequisites; and `module-scaffold` for a minimal owned module. Use `data-modeling`, `database-migrations`, and `auth-tenancy` before persistent tenant data changes.
 
 Use `api-contracts`, `async-jobs`, `cache-strategy`, `external-integrations`, `storage-uploads`, and `frontend-data-flows` for their named runtime boundaries. Use `testing-strategy`, `test-data`, `systematic-debugging`, `performance-engineering`, and `dependency-upgrade` for verification and maintenance.

package/templates/.agents/skills/zaip-skill-author-skills/scripts/audit-skill-catalog.mjs

@@ -25,6 +25,9 @@ for (const [agentId, requiredSkill] of [
   ["agent-designer", "zaip-skill-design-system"],
   ["agent-designer", "zaip-skill-frontend-componentization"],
   ["agent-website-developer", "zaip-skill-frontend-componentization"],
+  ["agent-website-developer", "zaip-skill-website-readiness"],
+  ["agent-website-developer", "zaip-skill-image-optimization"],
+  ["agent-website-developer", "zaip-skill-performance-engineering"],
 ]) {
   const agent = (catalog.agents ?? []).find((entry) => entry.id === agentId);
   if (!agent?.skills?.includes(requiredSkill))

package/templates/.agents/skills/zaip-skill-author-skills/scripts/run-skill-tests.mjs

@@ -1,6 +1,7 @@
 import { spawn } from "node:child_process";
-import { readdir } from "node:fs/promises";
+import { readdir, readFile } from "node:fs/promises";
 import { resolve } from "node:path";
+import { skillTestCommands } from "./skill-test-plan.mjs";
 
 const skillsRoot = resolve(import.meta.dirname, "..", "..");
 const tests = (await files(skillsRoot))
@@ -17,13 +18,42 @@ if (process.argv.includes("--list")) {
   process.exit(0);
 }
 
-await new Promise((resolveRun, reject) => {
-  const child = spawn(process.execPath, ["--test", ...tests], { stdio: "inherit" });
-  child.once("error", reject);
-  child.once("exit", (code) =>
-    code === 0 ? resolveRun() : reject(new Error(`Skill tests failed (${code})`)),
+const entries = await Promise.all(
+  tests.map(async (path) => ({ path, source: await readFile(path, "utf8") })),
+);
+const commands = skillTestCommands(entries);
+if (process.argv.includes("--plan")) {
+  console.log(JSON.stringify(commands, null, 2));
+  process.exit(0);
+}
+const failures = [];
+for (const [index, { runner, args }] of commands.entries()) {
+  console.log(
+    JSON.stringify({
+      skill_test_group: index + 1,
+      runner,
+      suites: args.slice(runner === "node" ? 2 : 4),
+    }),
   );
-});
+  const code = await new Promise((accept, reject) => {
+    const child = spawn(process.execPath, args, {
+      stdio: "inherit",
+      windowsHide: true,
+      shell: false,
+    });
+    child.once("error", reject);
+    child.once("exit", (code, signal) => accept(signal ? 1 : (code ?? 1)));
+  });
+  if (code !== 0) failures.push(index + 1);
+}
+console.log(
+  JSON.stringify({
+    skill_test_suites: tests.length,
+    groups: commands.length,
+    failed_groups: failures,
+  }),
+);
+if (failures.length) process.exitCode = 1;
 
 async function files(directory) {
   const entries = await readdir(directory, { withFileTypes: true });

package/templates/.agents/skills/zaip-skill-author-skills/scripts/skill-test-plan.mjs

@@ -0,0 +1,79 @@
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { parse } from "acorn";
+
+export function skillTestRunner(source) {
+  const imports = [];
+  for (const statement of parse(source, {
+    ecmaVersion: "latest",
+    sourceType: "module",
+    allowHashBang: true,
+  }).body) {
+    if (statement.type === "ImportDeclaration") imports.push(statement.source.value);
+    if (statement.type === "VariableDeclaration") {
+      for (const { init } of statement.declarations) {
+        if (
+          init?.type === "CallExpression" &&
+          init.callee.type === "Identifier" &&
+          init.callee.name === "require" &&
+          init.arguments.length === 1 &&
+          init.arguments[0].type === "Literal"
+        )
+          imports.push(init.arguments[0].value);
+      }
+    }
+  }
+  const node = imports.includes("node:test");
+  const vitest = imports.some((name) => name === "vitest" || name === "@vitest/runner");
+  if (node && vitest) throw new Error("Skill suite must declare exactly one supported test runner");
+  if (vitest) return "vitest";
+  if (node || imports.some((name) => name === "node:assert" || name === "node:assert/strict"))
+    return "node";
+  throw new Error("Skill suite must declare exactly one supported test runner");
+}
+
+export function skillTestCommands(
+  entries,
+  resolveVitest = () => {
+    const require = createRequire(import.meta.url);
+    return resolve(dirname(require.resolve("vitest/package.json")), "vitest.mjs");
+  },
+) {
+  const groups = new Map();
+  const seen = new Set();
+  for (const { path, source } of entries) {
+    if (typeof path !== "string" || /[\r\n\0]/.test(path) || seen.has(path))
+      throw new Error("Invalid or duplicate skill test path");
+    seen.add(path);
+    let runner;
+    try {
+      runner = skillTestRunner(source);
+    } catch (error) {
+      throw new Error(`${path}: ${error.message}`, { cause: error });
+    }
+    if (!groups.has(runner)) groups.set(runner, []);
+    groups.get(runner).push(path);
+  }
+  const commands = [];
+  for (const [runner, paths] of groups) {
+    const prefix =
+      runner === "node"
+        ? ["--test", "--test-concurrency=2"]
+        : [resolveVitest(), "run", "--no-file-parallelism", "--maxWorkers=1"];
+    let batch = [],
+      size = prefix.join(" ").length;
+    for (const path of paths) {
+      if (path.length + prefix.join(" ").length > 6000)
+        throw new Error("Skill test path exceeds argument budget");
+      if (size + path.length + 1 > 6000 || batch.length === 8) {
+        commands.push({ runner, args: [...prefix, ...batch] });
+        batch = [];
+        size = prefix.join(" ").length;
+      }
+      batch.push(path);
+      size += path.length + 1;
+    }
+    if (batch.length) commands.push({ runner, args: [...prefix, ...batch] });
+  }
+  return commands;
+}

package/templates/.agents/skills/zaip-skill-author-skills/scripts/skill-test-plan.test.mjs

@@ -0,0 +1,47 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { skillTestCommands, skillTestRunner } from "./skill-test-plan.mjs";
+
+test("routes suites by their declared API, preserving bounded execution and every file", () => {
+  const entries = Array.from({ length: 19 }, (_, i) => ({
+    path: `/fixture/test-${i}.test.mjs`,
+    source: i % 3 === 0 ? 'import {it,vi} from "vitest";' : 'import test from "node:test";',
+  }));
+  const commands = skillTestCommands(entries, () => "/fixture/vitest.mjs");
+  assert.deepEqual(
+    commands.flatMap((c) => c.args.slice(c.runner === "node" ? 2 : 4)).sort(),
+    entries.map((e) => e.path).sort(),
+  );
+  for (const command of commands) {
+    assert.ok(command.args.slice(command.runner === "node" ? 2 : 4).length <= 8);
+    assert.ok(
+      command.args.includes(command.runner === "node" ? "--test-concurrency=2" : "--maxWorkers=1"),
+    );
+  }
+  assert.equal(skillTestRunner('const test = require("node:test");'), "node");
+  assert.equal(
+    skillTestRunner('import assert from "node:assert/strict"; assert.equal(1, 1);'),
+    "node",
+  );
+  assert.equal(
+    skillTestRunner(
+      `import test from "node:test";\nconst fixture = 'import {it} from "vitest";';\n// import {it} from "vitest";`,
+    ),
+    "node",
+  );
+});
+
+test("refuses ambiguous/unknown suites and duplicates instead of silently omitting them", () => {
+  for (const source of ["export {};", 'import test from "node:test"; import {it} from "vitest";'])
+    assert.throws(() => skillTestRunner(source), /exactly one/);
+  const entry = { path: "/x.test.mjs", source: 'import test from "node:test";' };
+  assert.throws(() => skillTestCommands([entry, entry]), /duplicate/);
+  assert.throws(() => skillTestCommands([{ ...entry, path: "x".repeat(7000) }]), /budget/);
+  assert.throws(
+    () =>
+      skillTestCommands([{ path: "/v.test.mjs", source: 'import {it} from "vitest";' }], () => {
+        throw Error("missing Vitest");
+      }),
+    /missing Vitest/,
+  );
+});

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

@@ -5,6 +5,8 @@ description: Implement backend APIs, persistence, and integration boundaries ins
 
 # Entregar backend
 
+Para credenciais do backend use [Infisical self-hosted](../zaip-skill-infisical/SKILL.md): identidade por aplicação/ambiente, criação sem sobrescrita e consumo sem revelar valores. A configuração da stack não autoriza instalar o cofre ou acessar segredos.
+
 1. Confirmar contrato de entrada e saída, limites de persistência e dependências antes da alteração.
 2. Preservar a direção de dependências e manter detalhes de infraestrutura atrás da fronteira do módulo.
 3. Aplicar arquitetura e CQRS proporcionalmente ao contrato alterado: não introduzir camadas, migrações ou gates pesados quando a mudança local não os exige. Cobrir o comportamento alterado com testes focados e registrar incompatibilidades, migrações ou riscos de integração.

package/templates/.agents/skills/zaip-skill-backend/references/deployment-environments.md

@@ -9,9 +9,9 @@ Este contrato separa validação e produção para qualquer projeto ZAIP-AIOS. E
 - `deploy.branch` é legado e serve exclusivamente ao release/npm do framework.
 - `deploy.production_branch` é a branch de produção. O padrão é `main`.
 - Banco de dados nunca faz deploy automatizado para `main`. Frontend e backend seguem seus campos próprios, inclusive `main` quando foi configurado pelo usuário.
-- Produção exige promoção humana por PR/merge, com as proteções e aprovações definidas no repositório remoto. A branch atual e o upstream local não decidem o destino.
+- A promoção de banco para produção exige ação humana por PR/merge. Para aplicações, respeite o destino persistido e as proteções e aprovações definidas no repositório remoto. A branch atual e o upstream local não decidem o destino.
 - Para um banco compartilhado, o repositório central de migrações é uma convenção documentada do projeto, não um campo implícito de `project.yaml`. Cada contribuição é integrada nele pela branch de validação configurada. Não se envia o histórico inteiro de outro repositório para esse destino.
-- Frontend e site publicam a própria versão de validação a partir da branch de validação. A promoção de seus ambientes de produção continua humana.
+- Frontend e site usam `deploy.frontend.branch`; o ambiente de validação ou produção deve corresponder à configuração verificada do provedor e à autorização vigente. Uma branch configurada não dispensa a verificação do ambiente de destino.
 
 ## Configuração esperada