@zaip-ai/cli 6.3.0 → 7.5.0

package/templates/.agents/skills/zaip-skill-lead-measurement/references/bant-contract.md

@@ -0,0 +1,36 @@
+# BANT v2 — contrato opt-in
+
+Origem: kit BANT da auditoria 2026-10-29, resultados C02.1–C02.4. Compor [descoberta Sales](../../zaip-skill-sales-methodology/references/bant-discovery.md), [arquitetura](architecture.md) e [autoridade](authority.md). Não altera helper v1, nomes publicados, histórico ou configuração de consumidor. Não é backend, formulário instalado nem motor produtivo de qualificação.
+
+## Separação e aprovação
+
+`versions` fixa independentemente `contract` (2), `questionnaire`, `rule`, `consent` e `mapping`. Regra referencia exatamente sua versão de questionário. Tudo aqui é `status: draft`, `synthetic: true`, `opt_in: true`, `adoption_authorized: false`. `approval` identifica revisor fictício/data e `simulated: true`; representa apenas cenário de teste. O checker recusa ativação e aprovação não simulada: aprovação real exige contrato futuro do consumidor, não editar uma fixture para contornar o gate.
+
+Cada exemplo contém empresa/oferta/owner fictícios, política identificada, perguntas/códigos e unidade/moeda quando aplicável. Duas empresas independentes: Oficina Solar Fictícia tem cinco perguntas (BRL por projeto, dias até início e kWp); Escola Nuvem Fictícia tem seis (BRL mensais, semanas e assentos). Quantidade de perguntas, opções e unidades não são defaults comerciais.
+
+## Respostas e perfil
+
+Schema [questionnaire-v2.schema.json](questionnaire-v2.schema.json). Tipos `single_choice`, `multi_choice`, `number`, `date`, `text`. Códigos de opção não precisam começar por letra (fixture Moradigna). Números são finitos, sem coerção; datas Gregorianas ISO válidas; texto possui limite; multi_choice não duplica códigos. Unidade/moeda e significado são definidos na entrevista. Sem valores default.
+
+Resposta `{state, value}`: `answered` exige valor do tipo declarado; `unknown|not_applicable|withheld` exigem `null`. Chave ausente significa não coletado. Perfil completo requer `answered` em cada pergunta obrigatória aplicável. `not_applicable` só satisfaz completude quando branch provadamente falsa; não serve para pular pergunta obrigatória. Branch incerta deixa perfil pendente. Respostas de pergunta inativa são rejeitadas se afirmarem `answered`.
+
+`required_when` só referencia pergunta anterior; não há ciclo ou referência futura. Branch usa a mesma AST limitada. Limites fixos: 20 perguntas, 30 opções/pergunta, 10 seleções, texto 500 caracteres, AST profundidade 6, 64 nós e 8 filhos lógicos; no máximo 20 branches e 20 casos. Limites não são configuráveis por payload.
+
+## Política determinística e incerteza
+
+Operadores allowlist: `all`, `any`, `not`, `eq`, `in`, `contains`, `gte`, `lte`. Nós lógicos têm somente `op,args`; folhas somente `op,question,value`. Sem expressão textual, código, SQL, eval, acesso a propriedades arbitrárias, coerção ou execução dinâmica. Referência/código/operador/versão/tipo inválido invalida o contrato inteiro. AST e branches são validadas antes de avaliar qualquer caso, inclusive ramos que seriam curtos-circuitos.
+
+Comparações numéricas só em `number`; `contains` só em `multi_choice`; `in` só em escolhas simples; igualdade em valor escalar do tipo correto. Opções têm que existir. Folha não respondida produz incerteza tipada `missing|unknown|not_applicable|withheld`, nunca false. Combinação lógica preserva incerteza mesmo com outro ramo decisivo (fail-closed conservador). Incerteza devolve `pending`; false conhecido `not_qualified`; true conhecido `qualified`. Perfil incompleto impede qualificação automática. Esse modelo é intencionalmente limitado a condições obrigatórias, sem pontuação inventada.
+
+`manual_override` é simulado, exige owner/motivo/id, versão da regra, resultado explícito `qualified|not_qualified|human_review`; registra avaliação distinta preservando decisão automática/incerteza. Não promove perfil/cadastro nem autoriza transição CRM. Erro de contrato não é superado por override. Histórico de revisões/avaliações deve ser append-only na futura adoção; este helper retorna objetos novos sem persistir ou alterar entradas. `cadastro` requer recibo aceito modelado; `profile` requer cobertura; `qualified` é decisão comercial separada. IDs de ocorrência raiz, avaliação e evento continuam distintos; nenhum deles gera quatro leads.
+
+## Fixtures e compatibilidade
+
+- [solar.json](examples/solar.json) e [escola.json](examples/escola.json): dois negócios inventados; casos positivos, negativos, fronteira, override e incerteza. Todos os quatro estados são exercitados; decisões compartilhadas qualificam quando a regra específica permite.
+- [moradigna-regression.json](examples/moradigna-regression.json): reprodução exclusivamente sintética dos códigos documentados, sem nova leitura de consumidor: 7 budget (`5k`…`over_50k`), 7 timing (`7d`…`over_180d`), 6 need (`1`…`over_5`), 2 authority (`yes`,`no`), exatamente 22 alternativas. São quatro perguntas, não 22 perguntas/conversões.
+
+Aliases preservados explicitamente: campo `autority`→`authority`, prefixo externo `Autority_`→`authority` (grafia mantida, nunca renomear evento externo automaticamente). `authority_type` permanece metadado separado `sole|shared|researcher|owner_approval`, não inferido de `yes/no`. A política sintética permite shared. A regra histórica MQL solo citada no kit pertence somente ao consumidor; não equiparar à métrica Meta, nem universalizar `no` como desqualificado. Aliases são dicionário documental validado, não adaptador de envio.
+
+## Prova local e rollback
+
+`node scripts/run-mixed-tests.mjs .agents/skills/zaip-skill-lead-measurement/scripts/check-questionnaire.test.mjs` e `node .agents/skills/zaip-skill-lead-measurement/scripts/check-questionnaire.mjs --check` são teste e static-check offline. CLI valida o schema suportado, fixtures, casos esperados e invariantes Moradigna; não prova SQL, conta, CRM, consentimento real, ingestão ou atribuição. Review comercial independente permanece gate da Task. Reverter apenas estes arquivos/referências novas mantém v1 e o histórico; retirar opt-in não reavalia ou reenvia nada.

package/templates/.agents/skills/zaip-skill-lead-measurement/references/consent-contract.md

@@ -0,0 +1,48 @@
+# Consentimento por finalidade — modelo C04
+
+Revisão 2026-10-29, opt-in; decisão técnica `DEC-AI-2026-10-29-08-17-MEASUREMENT-CONSENT-GATE-PWSH6DFT9T`. Compõe [autoridade](authority.md), [identidade](identity-contract.md) e [persistência](persistence-reference.md). O helper [consent.mjs](../scripts/consent.mjs) é síncrono/determinístico, sem rede/DB/SDK. Callbacks são efeitos sintéticos de teste, não CMP, identidade autenticada, persistência, envio ou prova legal.
+
+## Estado e autoridade
+
+Cinco finalidades independentes: `contact`, `terms`, `analytics`, `google_ads`, `meta_measurement`. Estados vigentes `unknown|denied|granted`; evento `revoked` é retido no histórico e produz estado inelegível `denied`. Ausência permanece unknown. Histórico possui sequência server-owned crescente, sem empate/retrocesso; desconhecido, inválido ou leitura falha bloqueiam todos os efeitos. Nova concessão autenticada posterior pode mudar estado vigente; não volta a snapshot de enqueue nem reativa jobs suprimidos por si só.
+
+O helper recebe `readCurrent` e política por injeção de dependência; o caller confiável é responsável por autenticar origem, tenant, finalidade, sequência e política. `owner: server` é marcador validado de contrato, não autenticação criptográfica; o navegador pode fabricar esse texto. Não usar esse módulo isoladamente como autorização de cliente ou evidência de consentimento real. Sinais do request, snapshot ou campo livre não podem substituir a fonte vigente. Política é copiada/congelada; alterar objeto recebido depois não muda sua autorização. Cada instância recusa revisão inferior ou conteúdo diferente na mesma revisão já observada; esse watermark em memória não é proteção persistente/cross-process e não autentica a primeira leitura.
+
+| Destino modelado | Finalidade exigida | Fases permitidas |
+| --- | --- | --- |
+| contact_service | contact | event, retry |
+| terms_record (registro interno sintético) | terms | event |
+| ga4 | analytics | loader, base, page_view, event, retry |
+| google_ads | google_ads | loader, base, page_view, event, retry |
+| meta_pixel | meta_measurement | loader, base, page_view, event, retry |
+| meta_capi | meta_measurement | event, retry |
+
+Mapa fechado de finalidade agregada; não substitui inventário de sinais técnicos necessários por plataforma (como analytics_storage/ad_storage/ad_user_data/ad_personalization). Na adoção, a finalidade só pode ser granted se todas as condições/sinais aprovados para aquele destino estiverem satisfeitos; esse mapeamento e CMP reais estão fora do helper. Termos/contato não concedem analytics/publicidade; Google não concede Meta. Destino/fase/finalidade desconhecidos são inelegíveis, sem fallback.
+
+## Ordem dos efeitos e revogação
+
+Cada tentativa valida contrato e projeção, lê estado vigente, aplica finalidade e só então permite callback loader ou emit e log técnico allowlist. Negado/unknown/revoked não chama nenhum desses callbacks. Loader já carregado não ignora revalidação; revogação bloqueia base/PageView/event/retry posteriores. Repetir loader elegível não o recarrega. Enqueue é apenas referência de trabalho; retry lê a origem atual novamente. Leitura falha retorna `current_state_unavailable` sem erro bruto, PII ou efeito.
+
+Não há await/IO no modelo; readCurrent retorna histórico síncrono. Integração real exige obter contexto autenticado e verificar estado imediatamente antes de cada efeito, inclusive início do SDK. Revogação não desfaz requisição já em voo, descarrega SDK real ou cancela scripts carregados por outras fontes. É preciso inventariar loaders/autoeventos e controlar execução real/filas, sem alegar atomicidade entre consentimento e rede. Callbacks que falham não são transação reversível; o modelo não faz retry automático.
+
+## Consent Mode e cookieless
+
+Default denied/CMP não demonstram ausência de pings. [Google Consent Mode](https://developers.google.com/tag-platform/security/guides/consent), fonte pública verificada pelo host em 2026-10-29: default antes de config/event; atualização antes da navegação; templates GTM usam APIs de consentimento apropriadas; Consent Mode não persiste escolhas. Basic/advanced é escolha explícita. Não confundir configuração de sinais com bloqueio físico de rede.
+
+`cookieless: true` sempre bloqueia neste helper, até com granted. Um contrato próprio aprovado deve definir finalidade, dados, sinais técnicos, autoridade e provas de tráfego antes de uma implementação separada; não existe fallback por denied/unknown nem autorização implícita por ligar esse booleano. Este pacote não configura Google/Meta ou envia pings.
+
+## Projeções e dados
+
+Payload público aceita somente UUID v4 opaco `event_id`, evento de negócio fechado e classificação com `service`, `budget_band`, `qualification` presentes em catálogos server-owned aprovados. Enum não é texto livre. Catálogo aprovado não pode conter PII disfarçada; regex sozinha não prova isso. Telefone/e-mail/hash de contato, recibo, formulário, claims, tokens e campos extras são rejeitados, inclusive classificação extra. Matching de CAPI, se necessário futuramente, tem contrato restrito próprio e não atravessa esta projeção/dataLayer/log.
+
+URL deve ser exatamente a rota HTTPS `/lead` aprovada por destino, sem credencial/query/fragmento; não carregar contato em path/referrer. Restrição deliberada do exemplo sintético, não URL obrigatória para consumidores. Emit/loader recebe somente destination/phase/url/data reduzidos e congelados; log recebe destination/phase/event_id/revision/status. Nunca logar payload bruto, digest pessoal ou erro da origem. Event ID opaco também exige classificação/retention apropriadas. Nenhum contato ou hash é aceito só por chamá-lo de enum.
+
+## Provas e rollback
+
+[Suíte autocontida](../scripts/consent.test.mjs): executar `node .agents/skills/zaip-skill-lead-measurement/scripts/consent.test.mjs`. Assertions observam histórico/regrant, independência de finalidades, todos os destinos/fases em unknown/denied/revoked, loader carregado e revogação, enqueue→retry, falha sanitizada, cookieless e canais URL/dataLayer/log. Nenhuma chamada HTTP/DB.
+
+`--mutation [SHA256_BASELINE]` executa baseline real em TEMP mínima, aplica sete mutantes no código real e invoca as mesmas assertions. Só falha de assertion pertinente conta killed; syntax/import/protocolo/infrastructure não contam. JSON `mutation_discrimination` inclui baseline, digest de vínculo, total/killed/mutants, source/restored hashes e cleanup. Batch exige TEST imediatamente anterior, baseline_validation_id e argv `@ZAIP_BASELINE_SHA256@`; sem digest externo, o vínculo é hash do baseline próprio executado. Não inventar kill ratio ou reusar resultados de outro SHA.
+
+`--rollback BASE_SHA` é prova separada: obtém bytes/presença dos quatro arquivos base/candidato por Git, exige candidato commitado (aceita somente conversão CRLF/LF no checkout), aplica blobs candidato→base→candidato em fixture TEMP mínima e compara bytes/hash/presença, com sentinel de records/história preservado e checkout principal intacto byte a byte. Não copia repositório/dependências; não executa código base; teardown valida posse e remoção. Restauração de mutante sozinha não comprova rollback da regra/referência. Host registra ledger de temporários e Evidence separada da entrega.
+
+Estas são instruções de prova, não resultados já observados. Critical exige teste, mutação discriminante, review independente e Evidence de rollback; o executor não aprova a própria entrega. Não alegar CMP instalada, consentimento válido juridicamente, isolamento DB, SDK controlado, ingestão, dedupe ou atribuição reais. SQL/contas/consumidores/publicação seguem fora do escopo.

package/templates/.agents/skills/zaip-skill-lead-measurement/references/delivery-contract.md

@@ -0,0 +1,65 @@
+# Entrega: modelo local e integração real
+
+**v1 LEGACY DEPRECATED:** API/shape/25 testes históricos preservados. `recordDeliveryAttempt` aceita qualquer 2xx como `sent`; esse comportamento é exclusivamente compatibilidade histórica, não aceite semântico/ingestão nem caminho recomendado. Timeout v1 também não distingue efeito incerto. Opt-in explícito em `scripts/delivery-v2.mjs`; não chamar v1 como prova, não converter seus estados silenciosamente e não reenfileirar histórico. Catálogo/SKILL/routing não são alterados por C05.
+
+`scripts/lead-measurement.mjs` valida/projeta contratos. `scripts/delivery-ledger.mjs` modela em memória a chave `(destination,event_id)`, conflito de conteúdo e tentativas. Não há HTTP, credencial, banco, outbox persistente, transação, prova de consentimento nem validação de conta no helper.
+
+Quando `google_ads.source=ga4_import`, a projeção Ads é metadata para reconciliação/inspeção da importação: não faça outro envio direto Ads. O envio de cadastro é o evento GA4; importação/contabilização precisam de prova na conta. `direct` representa a outra rota escolhida, ainda dependente de adaptador autorizado.
+
+## API determinística v1 — somente compatibilidade legada
+
+- `validateEnvelope(event, config)` normaliza consentimento ausente e recusa campo extra/enum inválido/aceitação não persistida.
+- `projectMeasurement(event, config)` retorna projeções allowlist ou `null` por destino suprimido. Configuração Ads tem uma fonte primária única; qualificação posterior não recria o cadastro Ads.
+- `queueMeasurement(ledger, event, config, destination)` cria um novo `Map` com um job congelado no conteúdo. Destinos são `ga4`, `google_ads`, `meta_pixel`, `meta_capi`. Sem projeção habilitada, retorna `suppressed` sem job.
+- A mesma chave com mesmo fingerprint retorna o job existente. Conteúdo, horário ou versão divergentes para a mesma chave geram conflito, sem sobrescrever a aceitação.
+- `recordDeliveryAttempt(job, outcome, at)` devolve um job novo. `at` é explícito; ocorrência, payload, ID, versão e fingerprint ficam intactos. HTTP 408/429/5xx, timeout e falha de rede podem receber retry; demais falhas pedem revisão. Sucesso e revisão terminal são idempotentes.
+
+A política legada aceita 1–10 tentativas, delays inteiros positivos e limite de backoff. Não usar seu `sent` como prova operacional. O adaptador real interpreta headers; nenhum helper faz chamadas.
+
+## Modelo seguro v2 — opt-in
+
+Referência/decisão `DEC-AI-2026-10-29-09-02-MEASUREMENT-DELIVERY-V2-6RXQ9E5WZZ`. Runtime dividido em `delivery-v2-contract.mjs` (JSON canônico, projeções e resposta) e `delivery-v2.mjs` (estado em memória). Manifesto fechado e [wrapper](event-contract.md) não instalam backend/adaptador produtivo. API:
+
+| Operação | Condição e resultado modelado |
+| --- | --- |
+| enqueue(id,event,config) | Cria job por chave completa; replay idêntico preserva estado; payload/versão divergentes conflitam sem overwrite |
+| get(key) | Snapshot clonado/congelado, sem autoridade para editar Map interno |
+| claim(key,at,duration) | Horário inteiro explícito, due e limite de tentativas; consulta consentimento vigente; gera token/fence por entrega; lease ocupado não concede outra tentativa |
+| authorize(key,token,at,effect) | Revalida lease/fence/expiração e consentimento imediatamente antes de callback sintético síncrono; uma chamada por lease; exceção de efeito fica incerta |
+| record(key,token,response,at,jitter) | Exige tentativa iniciada e lease vigente; interpreta transporte/semântica separadamente; resposta tardia não confirma outro fence |
+| reconcile(key,proof,at) | Só queued/uncertain; decisão explícita confirmada ou ausência de efeito; referência opaca de revisão, nunca retry por timeout sozinho |
+
+`at` está em milissegundos inteiros explícitos; relógio, IDs/tokens e jitter são determinísticos. Claim não conta envio; authorize conta tentativa. Expiração/crash invalida lease e vai a uncertain/reconciliação, mesmo se nenhum efeito foi observado. Lease por entrega não coordena operações distintas do mesmo contato/destino Kommo: essa coordenação durável exige contrato próprio na adoção. Não há concorrência multiprocesso/DB comprovada por chamadas sequenciais ao Map.
+
+| Evidência/estado | Semântica v2 |
+| --- | --- |
+| transport | Status/erro da tentativa, sem resposta bruta ou contato; nunca basta para `confirmed` |
+| semantic_acceptance | unverified, accepted, rejected ou not_available; não é atribuição |
+| queued | HTTP202 indica fila; não entregue, sem retry automático; reconciliar antes de agir |
+| uncertain | Malformed, 2xx sem aceite, timeout após possível efeito, callback com exceção, lease expirado ou prova insuficiente; claim bloqueia |
+| confirmed | Apenas aceite semântico explícito ou reconciliação modelada confirmada; não prova evento visível/dedupe/conversão/atribuição |
+| attributed | Sempre false neste modelo; nenhuma API infere atribuição |
+
+Respostas são JSON estrito com status (ou null), error (null/before_send/timeout_after_effect), effect (none/possible), body e retry_after_ms opcional. São entradas sintéticas/normalizadas do adaptador futuro, não requisições nem contrato universal das APIs reais. O recibo normalizado Meta CAPI do modelo exige body fechado `events_received:1` para lote unitário; count0/2/string ou corpo incompleto nunca confirma. Isso não é schema completo da resposta Meta real, que pode conter messages/fbtrace_id: um adaptador futuro precisa validar resposta/conta/contexto reais antes de normalizar, sem descartar erros para fabricar aceite. Kommo exige recibo normalizado fechado com entity_id decimal string e checkpoint complete; o adaptador futuro deve provar vínculo/conta e normalizar resposta real antes de fornecer esse recibo. Reconciliação também é decisão modelada que exige prova externa própria na adoção. GA4 MP/collect2xx é not_available/uncertain, nunca ingestão; seu endpoint debug também não prova relatórios. Nenhum HTTP204 genérico vira sent v2.
+
+Timeout após possível efeito exige reconciliação. Resposta retryable (429/5xx ou before_send) só agenda retry se ausência de efeito foi explicitamente declarada por fronteira confiável; HTTP sozinho não prova ausência. Retry-After já convertido pelo adaptador em ms é respeitado, com backoff exponencial e jitter determinístico [0,1] de até25%, limitado por max_delay. Retry-After acima do cap não é truncado para antecipar envio: vai a uncertain/revisão. max_attempts vem da política validada, esgotamento/permanente é terminal. Estado terminal/confirmado não se reabre por regrant, mapping novo ou outro destination_id.
+
+Fonte de consentimento deve ser síncrona, autenticada, atual, vinculada ao tenant/evento; erros e revisões regressivas/divergentes bloqueiam sem logs brutos. Consentimento ausente/denied/revoked não invoca efeito, inclusive após claim ou antes de retry. Revogação não desfaz efeito em voo; não há atomicidade entre DB/consentimento/rede. `proof` de reconcile é informação do caller confiável, não autenticação por string; integração real exige observação independente e autorização próprias.
+
+## Provas proporcionais C05
+
+`node --test .agents/skills/zaip-skill-lead-measurement/scripts/lead-measurement.test.mjs` preserva25cases v1 e registra `delivery-v2-cases.mjs`: semântica, isolamento tenant/dataset/modo, canonicalização, conflito/replay, leases/fencing/crash, revogação/regrant, retry/jitter/terminal, PII e limites. Os casos são compartilhados pelo probe, sem duplicar assertions no harness. V1verde não aprova v2 ou produção.
+
+`node .agents/skills/zaip-skill-lead-measurement/scripts/delivery-v2-proof.mjs --mutation [BASELINE_SHA256]` executa baseline real v2 e mutantes textuais reais nos dois módulos em TEMP mínima. Só assertion pertinente conta killed; syntax/import/infra não contam. Reporta kind mutation_discrimination, baseline/ref, hashes de fontes/restauração, total/killed/mutants e cleanup; mesma suíte após restauração. Batch usa TEST anterior, baseline_validation_id e argv `@ZAIP_BASELINE_SHA256@`. Números planejados não são resultados.
+
+`--rollback BASE_SHA` no mesmo harness exige commit real, distinto e ancestral do candidato antes de TEMP; negativas same/unrelated/erroGit integram suíte. Inventário OWNED_FILES contém somente nove arquivos causais C05. Fixture mínima compara bytes/presença base→candidato→base→candidato, preserva sentinel de ledger/história e checkout principal, sem reenfileirar. Não copia repo/dependências nem altera fontes C04; teardown verifica posse/remoção. Host registra ledger e Evidence de rollback separada da restauração de mutante. Review de qualidade independente permanece obrigatório.
+
+## Integração que ainda precisa ser construída e provada
+
+1. Backend confirma persistência e emite envelope interno. Navegador não declara sucesso por conta própria.
+2. Grave lead e outbox atomicamente quando o banco permitir. Se forem duas escritas, declare a lacuna e defina reconciliação; o teste do `Map` não prova atomicidade de banco.
+3. Persista unicidade de destino/ID e fingerprint, conteúdo/versionamento congelados, estado, tentativas e próxima execução. Replays não remintam IDs nem alteram o mapeamento já enfileirado.
+4. Antes de cada envio, inclusive retry, revalide o consentimento vigente: revogação/unknown suspendem a entrega. O job congelado não é prova de permissão atual. Adapte apenas os campos permitidos ao schema atual de cada provedor. CAPI requer definição autorizada de `action_source`/`user_data`; a projeção parcial não inventa esses dados.
+5. Falha externa mantém o lead aceito. Logs/evidências contêm destino, ID opaco, status/categoria e tentativa, sem contato, recibo, payload bruto ou token. Credenciais usam o Infisical do projeto/ambiente.
+
+Separe prova do modelo local, persistência/outbox real, configuração externa, recebimento, deduplicação e atribuição/contabilização. Cada etapa requer evidência própria; testes sintéticos não ativam nem validam contas reais.

package/templates/.agents/skills/zaip-skill-lead-measurement/references/event-contract.md

@@ -0,0 +1,47 @@
+# Contrato local versionado — v1 legado e v2 opt-in
+
+**LEGACY DEPRECATED:** envelope/projeções v1 permanecem compatíveis, com os 25 testes históricos. O ledger v1 e seu estado `sent` para qualquer 2xx não são recomendação nem prova de entrega. Use explicitamente `scripts/delivery-v2.mjs` para o modelo de entrega seguro; nenhuma seleção implícita migra histórico ou publica algo. A v2 preserva IDs/nomes/payloads públicos v1 válidos, acrescentando escopo e estado de entrega em wrapper próprio `schema_version: 2`.
+
+Este contrato não autentica respostas do backend nem conta/plataforma. A aplicação deve construir o envelope após persistência confirmada, e não confiar em `persisted:true` vindo do cliente.
+
+Use [evento sintético](synthetic-event.json) e [configuração sintética](synthetic-config.json) como exemplos reproduzíveis, nunca como catálogo ou consentimento de produção. O catálogo de enums e os dois nomes de evento de qualificação precisam de decisão explícita do projeto.
+
+## Envelope
+
+Chaves estritas: `schema_version`, `event_id`, `event_name`, `occurred_at`, `acceptance`, `classification`, `consent`. A versão é literalmente 1; eventos aceitos são `lead_accepted` e `lead_qualified`.
+
+- `event_id`: opaco e estável, formato local `evt_` mais identificador de 8–96 caracteres ASCII alfanuméricos/underscore/hífen; nunca derive de contato. Uma qualificação posterior recebe ID próprio.
+- `occurred_at`: timestamp RFC3339 válido com timezone, preservado em retry; não é o horário da tentativa de entrega.
+- `acceptance`: somente `persisted:true` e `receipt_id` opaco, interno, de 8–128 caracteres ASCII alfanuméricos/underscore/hífen. O recibo não sai do backend.
+- `classification`: exatamente `service`, `budget_band`, `qualification`; cada valor pertence ao catálogo versionado fornecido. `unknown` só é válido se estiver no catálogo.
+- `consent`: somente os cinco sinais do exemplo, com `granted|denied|unknown`. Campos ausentes, inclusive o objeto inteiro, normalizam para `unknown`; valores inválidos não são normalizados silenciosamente.
+
+Contato, hash de contato, texto livre, formulário completo e campos desconhecidos são recusados. O helper não consegue provar a origem semântica de um ID ou de um enum; o produtor e sua fonte backend continuam responsáveis por essa garantia.
+
+## Configuração congelada
+
+Exige versão 1, `catalog_version`, `mapping_version`, três catálogos de enums, mapeamento dos dois eventos, configuração Ads, sinais exigidos por destino e política de retry.
+
+`lead_accepted` mapeia para GA4 `generate_lead` e Meta `Lead`. O nome de qualificação é explícito e diferente do cadastro nos dois destinos. Nomes/enums têm formato local limitado; isso não comprova aceitação do nome pelo provedor.
+
+`google_ads.primary_source` aceita `ga4_import|direct`; exatamente essa fonte deve estar primária e a outra secundária em `sources`. A configuração local não inspeciona as ações da conta real. Qualificação não gera a projeção primária de cadastro Ads.
+
+`required_consent` é um contrato por finalidade. GA4 exige pelo menos `analytics_storage`; Ads, `ad_storage` e `ad_user_data`; Meta, `meta_measurement`. A configuração pode exigir mais sinais. Importação Ads também depende da projeção GA4 habilitada. Esta política conservadora local não é uma afirmação sobre todos os usos permitidos por APIs/leis/Consent Mode.
+
+## Projeções
+
+GA4, Ads, Pixel e CAPI recebem somente nome mapeado, identidade/ocorrência estáveis, versão e parâmetros enum; Ads acrescenta fonte/primária. São objetos internos neutros para adaptadores, não requisições completas de provedor. `dataLayer` recebe somente evento interno, ID e os três enums quando houver destino habilitado.
+
+Pixel e CAPI compartilham nome/ID da mesma aceitação. GA4 não recebe recibo, dados de contato nem envelope inteiro. Nenhum `event_id` local comprova dedupe GA4 ou recebimento/deduplicação Meta.
+
+Instalação e prova externa pertencem às skills de cada destino. Veja [entrega](delivery-contract.md) para idempotência/retry locais e limites de outbox.
+
+## Wrapper e identidade v2
+
+`createDeliveryV2({destinations, readCurrent})` recebe manifesto server-owned fechado. Cada destino declara `schema_version:2`, tenant opaco, environment `test|staging|production`, provider `meta_capi|ga4_mp|kommo`, resource opaco, mode `test|production` e destination_id lógico. IDs/recursos não são autoridade do browser; o caller deve autenticar contexto e aprovar manifestos na adoção. Nenhum endpoint/URL/secret é recebido ou enviado pelo helper.
+
+`enqueue(destination_id, event_v1, config_v1)` valida cópia JSON estrita antes de compor validadores/projeções v1. Chave física: tenant + environment + provider + resource + mode + event_id. Tenant, dataset, modo e ambiente são fronteiras distintas. destination_id/mapping_version não são atalhos para nova chave ou replay; alias físico duplicado é recusado no manifesto, desconhecido não pode ser adicionado a evento entregue e mapping drift conflita. Destinos aprovados desde o início podem receber entregas independentes; adicionar destinatários/backfill depois requer novo contrato fora do modelo.
+
+Fingerprint SHA-256 canônico é integridade de conteúdo local, não HMAC de idempotência de cadastro ou identidade de pessoa. Inclui evento validado, configuração e payload congelados; objeto reordenado não muda semântica, tipos/ordem de arrays mudam. Records próprios enumeráveis de dados, sem accessors/símbolos; arrays densos JSON sem propriedades extras; limites de profundidade/tamanho. Não suporta Proxy/objetos ativos. Números não finitos/inseguros e -0 são recusados. Não logar fingerprint ou envelope interno; a projeção pública continua allowlist sem PII/recibo.
+
+Evento/horário/ID/mapping não são remintados em retry. Consentimento no envelope v1 é snapshot de elegibilidade inicial, nunca prova de permissão vigente; projeção inicialmente inelegível não vira job por default. A v2 compõe `resolveConsent` de C04 antes de claim e antes do callback, com fonte atual injetada e watermark por tenant/ambiente/evento. Caller autentica tenant/pessoa/finalidade/sinais técnicos e vincula a fonte ao fato; módulo puro não autentica essas entradas. Google não concede Meta, e Kommo exige finalidade contact aprovada. Nova concessão vigente só permite tentativa explícita ainda elegível; não reenvia fato confirmado nem restaura entrega terminal/suprimida.

package/templates/.agents/skills/zaip-skill-lead-measurement/references/examples/escola.json

@@ -0,0 +1,180 @@
+{
+  "schema_version": 2,
+  "status": "draft",
+  "synthetic": true,
+  "opt_in": true,
+  "adoption_authorized": false,
+  "company": {
+    "code": "escola_ficticia",
+    "name": "Escola Nuvem Fictícia",
+    "offer": "Treinamento corporativo inventado",
+    "owner": "Comercial Escola Fictício"
+  },
+  "versions": { "contract": 2, "questionnaire": 5, "rule": 7, "consent": 2, "mapping": 6 },
+  "approval": {
+    "simulated": true,
+    "reviewer": "Revisor comercial fictício Escola",
+    "date": "2026-10-29"
+  },
+  "questions": [
+    {
+      "code": "budget",
+      "dimension": "B",
+      "label": "Orçamento mensal",
+      "type": "number",
+      "unit": "BRL/mês",
+      "currency": "BRL",
+      "minimum": 0,
+      "maximum": 100000,
+      "required": true
+    },
+    {
+      "code": "authority",
+      "dimension": "A",
+      "label": "Papéis envolvidos",
+      "type": "multi_choice",
+      "max_selections": 3,
+      "options": [
+        { "code": "team", "label": "Equipe decisora" },
+        { "code": "buyer", "label": "Comprador" },
+        { "code": "user", "label": "Usuário" }
+      ],
+      "required": true
+    },
+    {
+      "code": "need",
+      "dimension": "N",
+      "label": "Objetivo principal",
+      "type": "single_choice",
+      "options": [
+        { "code": "training", "label": "Treinamento" },
+        { "code": "support", "label": "Suporte" }
+      ],
+      "required": true
+    },
+    {
+      "code": "timing",
+      "dimension": "T",
+      "label": "Semanas até contratação",
+      "type": "number",
+      "unit": "semanas/contratação",
+      "minimum": 0,
+      "maximum": 52,
+      "required": true
+    },
+    {
+      "code": "seats",
+      "dimension": "extension",
+      "label": "Assentos",
+      "type": "number",
+      "unit": "assentos",
+      "minimum": 1,
+      "maximum": 1000,
+      "required": true
+    },
+    {
+      "code": "start",
+      "dimension": "extension",
+      "label": "Data de início UTC",
+      "type": "date",
+      "unit": "data ISO UTC",
+      "required": true,
+      "required_when": { "op": "eq", "question": "need", "value": "training" }
+    }
+  ],
+  "policy": {
+    "code": "escola_fit_draft",
+    "questionnaire_version": 5,
+    "expression_ast": {
+      "op": "all",
+      "args": [
+        { "op": "gte", "question": "budget", "value": 500 },
+        { "op": "contains", "question": "authority", "value": "team" },
+        { "op": "eq", "question": "need", "value": "training" },
+        { "op": "lte", "question": "timing", "value": 12 },
+        { "op": "gte", "question": "seats", "value": 10 }
+      ]
+    }
+  },
+  "cases": [
+    {
+      "id": "positive",
+      "kind": "positive",
+      "receipt_accepted": true,
+      "authority_type": "shared",
+      "answers": {
+        "budget": { "state": "answered", "value": 2000 },
+        "authority": { "state": "answered", "value": ["team", "user"] },
+        "need": { "state": "answered", "value": "training" },
+        "timing": { "state": "answered", "value": 4 },
+        "seats": { "state": "answered", "value": 25 },
+        "start": { "state": "answered", "value": "2027-01-15" }
+      },
+      "expected": { "cadastro": true, "profile": true, "outcome": "qualified" }
+    },
+    {
+      "id": "negative",
+      "kind": "negative",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "answered", "value": 2000 },
+        "authority": { "state": "answered", "value": ["team"] },
+        "need": { "state": "answered", "value": "support" },
+        "timing": { "state": "answered", "value": 4 },
+        "seats": { "state": "answered", "value": 25 },
+        "start": { "state": "not_applicable", "value": null }
+      },
+      "expected": { "cadastro": true, "profile": true, "outcome": "not_qualified" }
+    },
+    {
+      "id": "boundary",
+      "kind": "boundary",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "answered", "value": 500 },
+        "authority": { "state": "answered", "value": ["team"] },
+        "need": { "state": "answered", "value": "training" },
+        "timing": { "state": "answered", "value": 12 },
+        "seats": { "state": "answered", "value": 10 },
+        "start": { "state": "answered", "value": "2028-02-29" }
+      },
+      "expected": { "cadastro": true, "profile": true, "outcome": "qualified" }
+    },
+    {
+      "id": "override",
+      "kind": "override",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "unknown", "value": null },
+        "authority": { "state": "withheld", "value": null },
+        "need": { "state": "answered", "value": "support" },
+        "timing": { "state": "answered", "value": 20 },
+        "seats": { "state": "answered", "value": 5 },
+        "start": { "state": "not_applicable", "value": null }
+      },
+      "manual_override": {
+        "id": "escola_review_1",
+        "owner": "Closer fictício",
+        "reason": "Revisão de escopo simulada",
+        "rule_version": 7,
+        "outcome": "human_review",
+        "simulated": true
+      },
+      "expected": { "cadastro": true, "profile": false, "outcome": "human_review" }
+    },
+    {
+      "id": "uncertainty",
+      "kind": "uncertainty",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "answered", "value": 500 },
+        "authority": { "state": "answered", "value": ["team"] },
+        "need": { "state": "unknown", "value": null },
+        "timing": { "state": "withheld", "value": null },
+        "seats": { "state": "answered", "value": 10 },
+        "start": { "state": "not_applicable", "value": null }
+      },
+      "expected": { "cadastro": true, "profile": false, "outcome": "pending" }
+    }
+  ]
+}

package/templates/.agents/skills/zaip-skill-lead-measurement/references/examples/moradigna-regression.json

@@ -0,0 +1,158 @@
+{
+  "schema_version": 2,
+  "status": "draft",
+  "synthetic": true,
+  "opt_in": true,
+  "adoption_authorized": false,
+  "company": {
+    "code": "moradigna_regression_synthetic",
+    "name": "Moradigna — regressão sintética",
+    "offer": "Reprodução documental sem adoção",
+    "owner": "Revisor fictício da regressão"
+  },
+  "versions": { "contract": 2, "questionnaire": 1, "rule": 1, "consent": 1, "mapping": 1 },
+  "approval": {
+    "simulated": true,
+    "reviewer": "Revisor comercial fictício regressão",
+    "date": "2026-10-29"
+  },
+  "questions": [
+    {
+      "code": "budget",
+      "dimension": "B",
+      "label": "Faixa de orçamento",
+      "type": "single_choice",
+      "required": true,
+      "options": [
+        { "code": "5k", "label": "5k" },
+        { "code": "10k", "label": "10k" },
+        { "code": "20k", "label": "20k" },
+        { "code": "30k", "label": "30k" },
+        { "code": "40k", "label": "40k" },
+        { "code": "50k", "label": "50k" },
+        { "code": "over_50k", "label": "Acima de 50k" }
+      ]
+    },
+    {
+      "code": "timing",
+      "dimension": "T",
+      "label": "Faixa de prazo",
+      "type": "single_choice",
+      "required": true,
+      "options": [
+        { "code": "7d", "label": "7 dias" },
+        { "code": "15d", "label": "15 dias" },
+        { "code": "30d", "label": "30 dias" },
+        { "code": "60d", "label": "60 dias" },
+        { "code": "90d", "label": "90 dias" },
+        { "code": "180d", "label": "180 dias" },
+        { "code": "over_180d", "label": "Acima de 180 dias" }
+      ]
+    },
+    {
+      "code": "need",
+      "dimension": "N",
+      "label": "Quantidade de ambientes",
+      "type": "single_choice",
+      "required": true,
+      "options": [
+        { "code": "1", "label": "1" },
+        { "code": "2", "label": "2" },
+        { "code": "3", "label": "3" },
+        { "code": "4", "label": "4" },
+        { "code": "5", "label": "5" },
+        { "code": "over_5", "label": "Acima de 5" }
+      ]
+    },
+    {
+      "code": "authority",
+      "dimension": "A",
+      "label": "Decisão individual?",
+      "type": "single_choice",
+      "required": true,
+      "options": [{ "code": "yes", "label": "Sim" }, { "code": "no", "label": "Não" }]
+    }
+  ],
+  "aliases": {
+    "field": { "autority": "authority" },
+    "event_prefix": { "Autority_": "authority" },
+    "authority_types": ["sole", "shared", "researcher", "owner_approval"]
+  },
+  "policy": {
+    "code": "regression_only_not_consumer_mql",
+    "questionnaire_version": 1,
+    "expression_ast": {
+      "op": "all",
+      "args": [
+        {
+          "op": "in",
+          "question": "budget",
+          "value": ["10k", "20k", "30k", "40k", "50k", "over_50k"]
+        },
+        { "op": "in", "question": "authority", "value": ["yes", "no"] }
+      ]
+    }
+  },
+  "cases": [
+    {
+      "id": "positive",
+      "kind": "positive",
+      "authority_type": "shared",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "answered", "value": "20k" },
+        "timing": { "state": "answered", "value": "30d" },
+        "need": { "state": "answered", "value": "2" },
+        "authority": { "state": "answered", "value": "no" }
+      },
+      "expected": { "cadastro": true, "profile": true, "outcome": "qualified" }
+    },
+    {
+      "id": "negative",
+      "kind": "negative",
+      "authority_type": "sole",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "answered", "value": "5k" },
+        "timing": { "state": "answered", "value": "7d" },
+        "need": { "state": "answered", "value": "1" },
+        "authority": { "state": "answered", "value": "yes" }
+      },
+      "expected": { "cadastro": true, "profile": true, "outcome": "not_qualified" }
+    },
+    {
+      "id": "boundary",
+      "kind": "boundary",
+      "authority_type": "owner_approval",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "answered", "value": "10k" },
+        "timing": { "state": "answered", "value": "over_180d" },
+        "need": { "state": "answered", "value": "over_5" },
+        "authority": { "state": "answered", "value": "no" }
+      },
+      "expected": { "cadastro": true, "profile": true, "outcome": "qualified" }
+    },
+    {
+      "id": "override",
+      "kind": "override",
+      "authority_type": "researcher",
+      "receipt_accepted": true,
+      "answers": {
+        "budget": { "state": "unknown", "value": null },
+        "timing": { "state": "withheld", "value": null },
+        "need": { "state": "not_applicable", "value": null },
+        "authority": { "state": "answered", "value": "no" }
+      },
+      "manual_override": {
+        "id": "regression_review_1",
+        "owner": "Revisor fictício",
+        "reason": "Encaminhamento simulado",
+        "rule_version": 1,
+        "outcome": "human_review",
+        "simulated": true
+      },
+      "expected": { "cadastro": true, "profile": false, "outcome": "human_review" }
+    }
+  ]
+}