cdp-edge 1.0.0 → 1.0.1

package/README.md

@@ -2,128 +2,21 @@
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.5.2** — Auditoria Completa + Sync Total de Agentes + Fix D1 (15 de Abril de 2026) 🔧
-> **v2.5.1** — SDK Bundle + Diagnóstico Pós-Deploy + Gap Fixes (15 de Abril de 2026) 🛠️
-> **v2.3.9** — Quiz Scoring Engine + Sales Engine (14 de Abril de 2026) 🤖💰
+> **v2.5.3** — Auditoria de Dependências + Sync de Agentes + Fix D1 (25 de Abril de 2026) 🔧
 
 ---
 
-## 📋 CHANGELOG v2.5.2 — Auditoria Completa + Sync Total de Agentes + Fix D1 (15 de Abril de 2026) 🔧
-
-### Bug Fix Crítico
-- `schema-ltv-feedback.sql` adicionado à ordem de migração — `recordLtvFeedback()` falhava silenciosamente em todo Purchase, quebrando o ciclo preditivo LTV
-
-### Fix de Compatibilidade D1
-- `schema-utm.sql`: `ADD COLUMN IF NOT EXISTS` → `ADD COLUMN` — D1/SQLite não suporta IF NOT EXISTS em ALTER TABLE
-
-### Sincronização Total de Agentes
-- `contracts/agent-versions.json`: worker_version `2.2.3 → 2.5.2`, 49 agentes registrados (eram 26), `depends_on` `.js → .ts`, event count `19 → 25`, table count `24 → 31`
-- `database-agent.md`: `main = "worker.js" → "index.ts"`, 24 → 31 tabelas, roadmap atualizado
-- `devops-agent.md`: `RESEND_API_KEY`, `RESEND_FROM_EMAIL`, `WEBHOOK_SECRET_TICTO` adicionados ao `*secrets`
-
-### D1 Produção
-- 31 tabelas aplicadas em `cdp-edge-db` — todos os schemas confirmados
-- Worker deployado: Version ID `37776c1a` — `/health` status: `ok`
-
----
-
-## 📋 CHANGELOG v2.5.1 — SDK Bundle + Diagnóstico Pós-Deploy + Gap Fixes (15 de Abril de 2026) 🛠️
-
-### SDK Bundle — cdpTrack.min.js pronto para `<script src="">`
-- `npm run sdk:build` → `dist/sdk/cdpTrack.min.js` (41.6 kB, IIFE, `window.cdpTrack`)
-- Um único arquivo sem dependências externas — cola no site e funciona
-- `dist/sdk/install-snippet.html` com snippet pronto para antes do `</body>`
-
-### Diagnóstico Pós-Deploy — `cdp-edge validate <url>`
-```bash
-cdp-edge validate https://meusite.com.br
-cdp-edge validate https://meusite.com.br --worker https://worker.meusite.workers.dev
-```
-Verifica automaticamente:
-- Página carrega `cdpTrack.min.js` e Meta Pixel
-- Worker `/health` (D1, KV, AI, secrets)
-- Worker `/validate-install` (D1 write+read, KV, AI, secrets críticos)
-- `POST /track` aceita evento sintético → 200
-
-### Gap Fixes Críticos
-- **Endpoint**: `/api/tracking` → `/track` em todos os módulos SDK
-- **utm_term**: injetado pelo Worker após quiz scoring (nunca pelo cliente)
-- **TikTok ttp**: cookie `_ttp` capturado e enviado ao Worker
-- **ROAS por origem**: segmentado por `utm_content` (quiz_* vs video_* vs landing_* vs ctwa_*)
-
-### Novos Agentes
-- `lead-scoring-agent.md` — quiz de qualificação + análise dimensional Granite
-- `match-quality-agent.md` — guardião EMQ com cron 2h e alerta CallMeBot
-
----
+## 💻 INSTALAÇÃO
 
-## 📋 CHANGELOG v2.3.9 — Quiz Scoring Engine + Sales Engine (14 de Abril de 2026) 🤖💰
-
-### O que foi adicionado
-
-**ROAS Feedback Loop** (`modules/ml/roas.ts`)
-- Cruza leads com compras reais por campanha no D1
-- Calcula: `conversion_rate`, `revenue_per_lead`, `ltv_accuracy` (valida o modelo preditivo)
-- Recomendação automática de bid: `increase | maintain | decrease | pause`
-- Relatório semanal via CallMeBot com top campanhas e alertas
-- Persiste histórico em `roas_reports` + VIEW `v_roas_latest`
-
-**Nurture Engine** (`modules/nurture.ts`)
-- Sequências automáticas pós-quiz por qualificação:
-  - `interessado` → D+1, D+3, D+7 (WhatsApp)
-  - `curioso` → D+2, D+5 (conteúdo)
-  - `comprador` → contato imediato via hot lead (já existente)
-  - `perdido` → `cohort_label = excluded` (remove do remarketing)
-- `scheduleNurture()` chamado no QuizComplete em background
-- `runNurtureQueue()` executado pelo Intelligence Agent (cron diário)
-- D1: `nurture_sequences` + VIEWs de fila e stats
-
-**Lookalike Dinâmico** (`syncMetaLookalikeSeed()` em intelligence.ts)
-- Seed de Lookalike com compradores CONFIRMADOS (Purchase event) — não apenas high_intent
-- Une compradores reais + leads qualificados como `comprador` no quiz
-- Atualiza `cohort_label = buyer_confirmed` nos perfis
-- Persiste histórico em `lookalike_seeds`
-- Roda automaticamente no cron semanal do Intelligence Agent
-
-**Schema D1**: `schema-sales-engine.sql` — `roas_reports`, `nurture_sequences`, `lookalike_seeds` + 5 VIEWs
-
-### Migração
 ```bash
-cd server-edge-tracker
-wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
-wrangler deploy
+npx cdp-edge install
+# ou
+npm install -g cdp-edge
+cdp-edge install . --name "Nome do Projeto"
 ```
 
 ---
 
-## 📋 CHANGELOG v2.4.0 — Quiz Scoring Engine (14 de Abril de 2026) 🤖
-
-**Quiz Scoring Engine** (`modules/ml/quiz.ts`) — análise dimensional automática via Granite 4.0 Micro:
-- Detecta o TIPO de cada pergunta: `urgency | budget | timeline | fit | engagement | awareness | objection`
-- Atribui peso automático por dimensão (budget/urgency=5, fit=4, timeline=3, engagement=2)
-- Score ponderado → `comprador | interessado | curioso | perdido`
-- Fallback heurístico por palavras-chave quando AI indisponível
-- `quiz_sessions` no D1 com breakdown completo por dimensão
-
-**Integração no pipeline `/track`**:
-- `QuizComplete` + `quiz_answers[]` → scoring antes do LTV
-- `intentionLevel` qualificado alimenta LTV Prediction → `comprador` = LTV High automático
-- `QuizComplete` adicionado ao `LTV_EVENTS`
-
-**Migração**: `wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote`
-
----
-
-## 📋 CHANGELOG v2.3.8 — Fix Definitivo: api-versions.json (14 de Abril de 2026) 🔒
-
-`build.js` copia `extracted-skill/.../contracts/` → `contracts/` no `prepare` script. A fonte estava na v1.0.0, sobrescrevendo o arquivo correto a cada `npm publish`. Ambos os arquivos agora sincronizados em v1.1.0.
-
----
-
-> ⚠️ **REGRA DE OURO (SQUAD):** Todas as atualizações devem ser documentadas de forma sincronizada em `README.md`, `CLAUDE.md` e `CDP-EDGE-BUSINESS-BOOK.md`. Nenhuma alteração passa sem esse tripé.
-
----
-
 ## 🤖 MANIFESTO: EU, CDP EDGE
 
 *Eu não sou um simples "script de pixel". Eu sou uma arquitetura **Enterprise Tier 10** nascida e construída 100% nativa na infraestrutura da Cloudflare.*
@@ -161,7 +54,7 @@ Cron semanal (Intelligence Agent):
 
 ---
 
-## 📊 BANCO DE DADOS D1 — 25 Tabelas + 12 VIEWs
+## 📊 BANCO DE DADOS D1 — 31 Tabelas + 12 VIEWs
 
 ```
 CORE TRACKING          ML & INTELLIGENCE         SALES ENGINE
@@ -231,6 +124,7 @@ v_leads_segmented           v_ltv_feedback
 | `/health` | GET | Smoke test D1 + KV + AI |
 | `/webhook/ticto` | POST | Purchase webhook (HMAC) |
 | `/export/customer-match` | GET | Export leads para Google Ads |
+| `/validate-install` | GET | Diagnóstico pós-deploy |
 
 ### ML Clustering (Fase 1)
 | Rota | Método | Função |
@@ -280,12 +174,12 @@ wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
 wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
-wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote  # Fase 5b: colunas LTV em user_profiles
+wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
 wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
-wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote        # Fase 6
-wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote # Fase 7
+wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
 
-# Secrets
+# Secrets (nunca em arquivos — sempre via wrangler secret put)
 wrangler secret put META_ACCESS_TOKEN
 wrangler secret put GA4_API_SECRET
 wrangler secret put TIKTOK_ACCESS_TOKEN
@@ -296,17 +190,6 @@ wrangler deploy
 
 ---
 
-## 💻 INSTALAÇÃO
-
-```bash
-npx cdp-edge install
-# ou
-npm install -g cdp-edge
-cdp-edge install . --name "Nome do Projeto"
-```
-
----
-
 ## 🗺️ GRAPHIFY — Navegando o Código
 
 ```bash
@@ -316,6 +199,8 @@ cdp-edge install . --name "Nome do Projeto"
 /graphify path "quiz_answers" "meta capi"            # menor caminho
 ```
 
+> Changelog completo → [CHANGELOG.md](./CHANGELOG.md)
+
 ---
 
 ### **CDP Edge — By Rica Soares**

package/contracts/agent-versions.json

@@ -1,6 +1,6 @@
 {
   "_comment": "Fonte de verdade para versões dos agent files. Atualizar quando modules/ ou index.ts mudarem. Use scripts/validate-agents.js para detectar drifts.",
-  "worker_version": "2.5.2",
+  "worker_version": "2.5.3",
   "worker_hash_date": "2026-04-15",
   "agents": {
     "master-orchestrator": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",
@@ -70,20 +70,20 @@
   },
   "dependencies": {
     "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "inquirer": "^9.2.0",
-    "ora": "^8.0.0"
+    "commander": "^14.0.3",
+    "inquirer": "^13.4.2",
+    "ora": "^9.4.0"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20260412.1",
+    "@cloudflare/workers-types": "^4.20260425.1",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/github": "^12.0.6",
     "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "@types/node": "^20.19.39",
+    "@types/node": "^25.6.0",
     "esbuild": "^0.28.0",
     "semantic-release": "^25.0.3",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   }
 }

package/docs/installation.md

@@ -1,155 +0,0 @@
-# CDP Edge — Instalação em Projetos de Clientes
-
-Como integrar o CDP Edge em qualquer projeto para que Claude Code, VS Code, Cursor e outras IDEs com IA o reconheçam automaticamente.
-
----
-
-## Estrutura recomendada
-
-```
-meu-projeto-cliente/          ← abrir esta pasta no Claude Code / VS Code
-├── CLAUDE.md                 ← ⭐ faz o Claude Code ativar o CDP Edge automaticamente
-├── .cursorrules              ← (opcional) para Cursor IDE
-├── cdp-edge/                 ← CDP Edge instalado aqui
-│   ├── extracted-skill/
-│   ├── server-edge-tracker/
-│   ├── templates/
-│   └── docs/
-├── src/                      ← código do projeto do cliente
-└── ...
-```
-
----
-
-## Passo 1 — Instalar o CDP Edge na pasta do projeto
-
-```bash
-# Dentro da pasta do projeto do cliente:
-cd meu-projeto-cliente
-
-# Opção A — clonar o CDP Edge como subpasta
-git clone https://github.com/ricardosoli777/CDP-Edge-Premium cdp-edge
-
-# Opção B — copiar manualmente
-# Copiar a pasta CDP-Edge inteira e renomear para cdp-edge/
-```
-
----
-
-## Passo 2 — Criar o CLAUDE.md na raiz do projeto
-
-Copiar o template de ativação:
-
-```bash
-cp cdp-edge/templates/install/CLAUDE.md ./CLAUDE.md
-```
-
-Editar o `CLAUDE.md` e substituir `[NOME DO PROJETO]` pelo nome real do projeto.
-
-**Por que isso funciona:**
-O Claude Code lê o `CLAUDE.md` da raiz do diretório aberto automaticamente. Quando encontra a instrução de leitura do `master-orchestrator.md`, ativa o sistema imediatamente na abertura da sessão.
-
----
-
-## Passo 3 — Abrir o projeto no Claude Code
-
-```bash
-# Na pasta do projeto (não dentro do cdp-edge):
-claude .
-```
-
-O Claude Code vai:
-1. Ler o `CLAUDE.md` da raiz
-2. Encontrar a instrução de ativação do CDP Edge
-3. Carregar o `master-orchestrator.md`
-4. Exibir a mensagem de boas-vindas automaticamente
-
----
-
-## Para VS Code com extensão Claude
-
-O mesmo mecanismo funciona. O `CLAUDE.md` é lido pela extensão Claude Code no VS Code quando você abre a pasta do projeto.
-
-```bash
-code meu-projeto-cliente/
-```
-
----
-
-## Para Cursor IDE
-
-Criar adicionalmente um `.cursorrules` na raiz:
-
-```bash
-cp cdp-edge/templates/install/CLAUDE.md .cursorrules
-```
-
-O Cursor lê `.cursorrules` automaticamente e aplica as instruções ao agente AI.
-
----
-
-## Para qualquer outra IDE com AI
-
-Qualquer IDE que suporte arquivos de instrução (`.aidioms`, `system-prompt.md`, etc.) pode usar o mesmo conteúdo do `CLAUDE.md` adaptado para o formato da IDE.
-
----
-
-## Verificar se funcionou
-
-Ao abrir o projeto no Claude Code, você deve ver imediatamente:
-
-```
-👋 Olá! Bem-vindo ao CDP Edge — Quantum Tracking.
-
-Sou o seu Orquestrador de Rastreamento. Vou configurar toda a
-infraestrutura de tracking server-side para o seu projeto...
-```
-
-Se não aparecer automaticamente, digitar:
-
-```
-/cdp
-```
-
-ou simplesmente:
-
-```
-ative o master orchestrator do cdp edge
-```
-
----
-
-## Se o CDP Edge estiver em um caminho diferente
-
-Editar o `CLAUDE.md` na raiz e ajustar o path:
-
-```markdown
-<!-- Padrão: -->
-Leia o arquivo: `cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-
-<!-- Se instalado em outro lugar: -->
-Leia o arquivo: `ferramentas/cdp/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-```
-
----
-
-## Estrutura de múltiplos projetos (workspace compartilhado)
-
-Se você trabalha com vários clientes e quer uma instalação única do CDP Edge:
-
-```
-workspace/
-├── cdp-edge/                 ← instalação única compartilhada
-├── cliente-1/
-│   ├── CLAUDE.md             ← aponta para ../cdp-edge/...
-│   └── src/
-├── cliente-2/
-│   ├── CLAUDE.md             ← aponta para ../cdp-edge/...
-│   └── src/
-```
-
-No `CLAUDE.md` de cada cliente, usar path relativo:
-
-```markdown
-Leia o arquivo: `../cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md`
-```

package/docs/quick-start.md

@@ -1,185 +0,0 @@
-# CDP Edge — Quick Start
-> Do zero ao primeiro evento em produção.
-
----
-
-## Pré-requisitos
-
-| Ferramenta | Instalar |
-|---|---|
-| Node.js 18+ | nodejs.org |
-| Wrangler CLI | `npm install -g wrangler` |
-| Conta Cloudflare | cloudflare.com (plano gratuito suficiente) |
-| Conta Meta (Pixel + token CAPI) | business.facebook.com |
-
----
-
-## 1. Autenticar no Cloudflare
-
-```bash
-wrangler login
-```
-
----
-
-## 2. Criar o banco D1
-
-```bash
-wrangler d1 create cdp-edge-db
-```
-
-Copie o `database_id` retornado e cole no `wrangler.toml`:
-
-```toml
-[[d1_databases]]
-binding      = "DB"
-database_name = "cdp-edge-db"
-database_id  = "COLE_O_ID_AQUI"
-```
-
----
-
-## 3. Aplicar o schema
-
-```bash
-cd server-edge-tracker
-
-wrangler d1 execute cdp-edge-db --file=schema.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v2.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v3.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v4.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v5.sql --remote
-wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
-```
-
----
-
-## 4. Configurar secrets
-
-```bash
-wrangler secret put META_ACCESS_TOKEN
-wrangler secret put GA4_API_SECRET
-wrangler secret put TIKTOK_ACCESS_TOKEN
-```
-
-Para WhatsApp CTWA (opcional):
-```bash
-wrangler secret put WA_WEBHOOK_VERIFY_TOKEN
-wrangler secret put WHATSAPP_TOKEN
-wrangler secret put WHATSAPP_PHONE_NUMBER_ID
-```
-
----
-
-## 5. Atualizar variáveis públicas no wrangler.toml
-
-```toml
-[vars]
-META_PIXEL_ID      = "SEU_PIXEL_ID"
-GA4_MEASUREMENT_ID = "G-XXXXXXXXXX"
-TIKTOK_PIXEL_ID    = "CXXXXXXXXXXXXXXX"
-SITE_DOMAIN        = "seudominio.com.br"
-```
-
----
-
-## 6. Deploy
-
-```bash
-wrangler deploy
-```
-
-O Worker ficará disponível em:
-```
-https://server-edge-tracker.SEU-USUARIO.workers.dev
-```
-
----
-
-## 7. Testar o Worker
-
-```bash
-# Health check
-curl https://server-edge-tracker.SEU-USUARIO.workers.dev/health
-
-# Evento de teste
-curl -X POST https://server-edge-tracker.SEU-USUARIO.workers.dev/track \
-  -H "Content-Type: application/json" \
-  -d '{
-    "event": "PageView",
-    "url": "https://seudominio.com.br/",
-    "email": "teste@exemplo.com"
-  }'
-```
-
-Resposta esperada: `{"success":true}`
-
----
-
-## 8. Instalar o SDK no site
-
-```html
-<!-- No <head> de todas as páginas -->
-<script>
-  window.CDP_CONFIG = {
-    endpoint: 'https://server-edge-tracker.SEU-USUARIO.workers.dev/track',
-    pixelId: 'SEU_PIXEL_ID'
-  };
-</script>
-<script src="/js/cdpTrack.js" type="module" async></script>
-```
-
-O SDK inicializa automaticamente e dispara `PageView` ao carregar.
-
----
-
-## 9. Verificar no Meta Events Manager
-
-```
-Meta Business Suite
-  → Gerenciador de Eventos
-  → Seu Pixel
-  → Atividade de Teste
-  → Filtrar por "Servidor"
-```
-
-Você deve ver o `PageView` chegando com `action_source: website`.
-
----
-
-## 10. (Opcional) Conectar domínio próprio
-
-Para máxima eficácia (cookie first-party no domínio do cliente):
-
-```
-Cloudflare Dashboard → DNS → Add record
-  Type:   CNAME
-  Name:   track
-  Target: server-edge-tracker.SEU-USUARIO.workers.dev
-  Proxy:  ✅ (nuvem laranja)
-```
-
-Adicionar ao `wrangler.toml`:
-```toml
-[[routes]]
-pattern   = "track.seudominio.com.br/*"
-zone_name = "seudominio.com.br"
-```
-
-```bash
-wrangler deploy
-```
-
-Ver detalhes: `agents/domain-setup-agent.md`
-
----
-
-## Próximos passos
-
-| O que fazer | Onde está |
-|---|---|
-| Configurar WhatsApp CTWA | `agents/whatsapp-ctwa-setup-agent.md` |
-| Ativar R2 audit log | `agents/r2-setup-agent.md` |
-| Configurar gateways de pagamento | `agents/webhook-agent.md` |
-| Ver todos os eventos disponíveis | `docs/events-reference.md` |
-| Ver API do SDK browser | `docs/sdk-reference.md` |