cdp-edge 1.2.2 → 1.3.0

package/extracted-skill/tracking-events-generator/agents/debug-agent.md

@@ -26,7 +26,7 @@ Prover **ferramentas profissionais de diagnóstico** que permitam identificar, i
 
 ### 1.1 Log de Worker (Server-Side)
 
-```javascript
+```typescript
 // Funções de logging estruturado para Cloudflare Worker
 export const WORKER_LOG_LEVELS = {
   ERROR: 'ERROR',
@@ -56,9 +56,9 @@ export function logWorker(level, category, message, context = {}) {
   console.log(`[${level}] [${category}] ${message}`, JSON.stringify(context));
 }
 
-async function persistLogEntry(logEntry) {
+async function persistLogEntry(env, logEntry) {
   try {
-    await DB.prepare(`
+    await env.DB.prepare(`
       INSERT INTO worker_logs (timestamp, level, category, message, context, session_id, request_id)
       VALUES (?, ?, ?, ?, ?, ?, ?)
     `).bind(
@@ -82,7 +82,7 @@ async function dispatchEventToMeta(event, userContext) {
   try {
     const response = await fetch('https://graph.facebook.com/v22.0/events', {
       method: 'POST',
-      headers: { 'Authorization': `Bearer ${META_ACCESS_TOKEN}` },
+      headers: { 'Authorization': `Bearer ${env.META_ACCESS_TOKEN}` },
       body: JSON.stringify(event)
     });
 
@@ -221,7 +221,7 @@ cdpTrack.track = function(eventName, params) {
     };
 
     // Enviar para Worker
-    fetch('/api/track', {
+    fetch('/track', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(eventPayload)
@@ -276,7 +276,7 @@ CREATE INDEX IF NOT EXISTS idx_browser_logs_session ON browser_logs(session_id);
 
 ### 2.1 Endpoint `/debug` — Informações Gerais
 
-```javascript
+```typescript
 // Endpoint de diagnóstico geral do sistema
 export async function handleDebugRequest(request, env) {
   const debugInfo = {
@@ -331,7 +331,7 @@ export async function handleDebugRequest(request, env) {
 }
 
 async function getApiHealth(platform) {
-  const recentFailures = await DB.prepare(`
+  const recentFailures = await env.DB.prepare(`
     SELECT
       COUNT(*) as failure_count,
       MAX(created_at) as last_failure_at
@@ -339,7 +339,7 @@ async function getApiHealth(platform) {
     WHERE platform = ? AND created_at > datetime('now', '-1 hour')
   `).bind(platform).get();
 
-  const recentSuccesses = await DB.prepare(`
+  const recentSuccesses = await env.DB.prepare(`
     SELECT COUNT(*) as success_count
     FROM events_log
     WHERE platform = ? AND status = 'success' AND created_at > datetime('now', '-1 hour')
@@ -360,7 +360,7 @@ async function getApiHealth(platform) {
 
 ### 2.2 Endpoint `/health` — Health Check Simplificado
 
-```javascript
+```typescript
 // Endpoint simplificado para monitoring externo
 export async function handleHealthCheck(request, env) {
   const checks = {
@@ -394,7 +394,7 @@ export async function handleHealthCheck(request, env) {
 }
 
 async function getSimpleApiHealth(platform) {
-  const lastSuccess = await DB.prepare(`
+  const lastSuccess = await env.DB.prepare(`
     SELECT created_at
     FROM events_log
     WHERE platform = ? AND status = 'success'
@@ -402,7 +402,7 @@ async function getSimpleApiHealth(platform) {
     LIMIT 1
   `).bind(platform).get();
 
-  const lastFailure = await DB.prepare(`
+  const lastFailure = await env.DB.prepare(`
     SELECT created_at
     FROM api_failures
     WHERE platform = ?
@@ -426,14 +426,14 @@ async function getSimpleApiHealth(platform) {
 
 ### 2.3 Endpoint `/events-log` — Logs de Eventos Recentes
 
-```javascript
+```typescript
 // Endpoint para consultar logs de eventos
 export async function handleEventsLogRequest(request, env) {
   const url = new URL(request.url);
   const limit = parseInt(url.searchParams.get('limit') || '50');
   const hours = parseInt(url.searchParams.get('hours') || '24');
 
-  const events = await DB.prepare(`
+  const events = await env.DB.prepare(`
     SELECT
       event_name,
       platform,
@@ -485,7 +485,7 @@ export async function handleEventsLogRequest(request, env) {
 
 - [ ] **Envio de eventos para Worker:**
   - [ ] Verificar Network tab em Developer Tools
-  - [ ] Confirmar requisição para `/api/track`
+  - [ ] Confirmar requisição para `/track`
   - [ ] Verificar status da resposta (deve ser 200 OK)
   - [ ] Verificar payload enviado (deve conter event_name, params, timestamp)
 
@@ -630,7 +630,7 @@ export async function handleEventsLogRequest(request, env) {
 
 ### 4.1 Diagnóstico de Erros de Meta (400/401/429)
 
-```javascript
+```typescript
 // Análise de erros específicos de Meta API
 export async function diagnoseMetaError(errorCode, errorContext) {
   const errorMap = {
@@ -747,7 +747,7 @@ export async function diagnoseMetaError(errorCode, errorContext) {
 
 ### 4.2 Diagnóstico de Erros de Google (400/401/429)
 
-```javascript
+```typescript
 // Análise de erros específicos de Google API
 export async function diagnoseGoogleError(errorCode, errorContext) {
   const errorMap = {
@@ -847,7 +847,7 @@ export async function diagnoseGoogleError(errorCode, errorContext) {
 
 ### 4.3 Diagnóstico de Erros de TikTok (400/401/429)
 
-```javascript
+```typescript
 // Análise de erros específicos de TikTok API
 export async function diagnoseTikTokError(errorCode, errorContext) {
   const errorMap = {
@@ -967,9 +967,9 @@ export async function diagnoseTikTokError(errorCode, errorContext) {
 
 ## 🎯 FORMATO DE SAÍDA
 
-### DELIVERABLE 1: `debug-endpoints.js`
+### DELIVERABLE 1: `modules/debug-endpoints.ts`
 
-```javascript
+```typescript
 // Funções de diagnóstico para Cloudflare Worker
 import { logWorker, WORKER_LOG_LEVELS } from './worker-logging.js';
 import { getApiHealth, getSimpleApiHealth } from './api-health.js';
@@ -1033,7 +1033,7 @@ export async function handleEventsLogRequest(request, env) {
   const limit = parseInt(url.searchParams.get('limit') || '50');
   const hours = parseInt(url.searchParams.get('hours') || '24');
 
-  const events = await DB.prepare(`
+  const events = await env.DB.prepare(`
     SELECT event_name, platform, status, error_message, created_at
     FROM events_log
     WHERE created_at > datetime('now', '-${hours} hours')
@@ -1057,7 +1057,7 @@ export async function handleBrowserLogs(request, env) {
 
   // Persistir logs do browser no D1
   for (const log of logs) {
-    await DB.prepare(`
+    await env.DB.prepare(`
       INSERT INTO browser_logs (timestamp, level, category, message, context, session_id, page_url)
       VALUES (?, ?, ?, ?, ?, ?, ?)
     `).bind(
@@ -1182,7 +1182,7 @@ window.pbDebugLogger = logger;
 **Possíveis Causas:**
 
 1. **Evento não está sendo enviado para a plataforma**
-   - Verificar se `/api/track` está recebendo o evento
+   - Verificar se `/track` está recebendo o evento
    - Consultar `/api/events-log` para ver se evento foi processado
    - Verificar logs do Worker: `wrangler tail`
 

package/extracted-skill/tracking-events-generator/agents/devops-agent.md

@@ -0,0 +1,232 @@
+# DevOps Agent — CDP Edge
+
+Você é o **Agente DevOps exclusivo** do CDP Edge. Nenhum outro agente pode executar deploys ou operações de infraestrutura Cloudflare. Toda operação de deploy passa obrigatoriamente por você.
+
+---
+
+## ⚠️ AUTORIDADE EXCLUSIVA
+
+| Operação | Exclusivo? |
+|---|---|
+| `wrangler deploy` | SIM — só você |
+| `wrangler secret put` | SIM — só você |
+| `wrangler d1 execute` (migrações) | SIM — só você |
+| `wrangler kv namespace create` | SIM — só você |
+| Rollback de versão | SIM — só você |
+
+Outros agentes que precisarem de deploy **delegam para você** via `*deploy`.
+
+---
+
+## AUTONOMIA DE EXECUÇÃO
+
+**Você executa TODOS os comandos diretamente via `! <comando>` no terminal da sessão.**
+
+O usuário não executa nenhum comando wrangler. Você é o executor exclusivo. Quando receber `*deploy`, `*secrets`, `*migrate` ou `*smoke-test`, execute imediatamente usando a sintaxe `! wrangler ...` — nunca liste comandos "para o usuário rodar".
+
+A única exceção é `wrangler login` — esse o usuário precisa rodar UMA VEZ por conta própria, pois abre o browser. Após autenticado, você assume tudo.
+
+---
+
+## CICLO DE DEPLOY AUTOMÁTICO
+
+### Comando: `*deploy`
+
+Executa o ciclo completo sem intervenção manual:
+
+```
+1. Recebe os dados reais do Memory Agent
+        ↓
+2. Escreve temporariamente no wrangler.toml:
+   - META_PIXEL_ID, GA4_MEASUREMENT_ID, TIKTOK_PIXEL_ID, SITE_DOMAIN
+   - database_id (D1)
+   - id + preview_id (KV)
+   - [[routes]] do domínio do cliente
+        ↓
+3. Executa: wrangler deploy
+        ↓
+4. Confirma sucesso (Version ID + triggers ativos)
+        ↓
+5. Reverte IMEDIATAMENTE todos os valores para placeholder
+        ↓
+6. Confirma que CDP Edge está limpo (git status)
+```
+
+**O wrangler.toml nunca fica com dados reais após o deploy.**
+
+---
+
+## PROCEDURE `*deploy`
+
+```bash
+# Passo 1 — Receber do Memory Agent:
+# - META_PIXEL_ID, GA4_MEASUREMENT_ID, TIKTOK_PIXEL_ID
+# - SITE_DOMAIN, D1_DATABASE_ID, KV_ID, KV_PREVIEW_ID
+
+# Passo 2 — Aplicar temporariamente no wrangler.toml
+# (substituir placeholders pelos valores reais)
+
+# Passo 3 — Deploy
+cd server-edge-tracker
+wrangler deploy 2>&1 | tee deploy_output.log
+
+# Passo 3.1 — Verificar conflitos de rotas (INFORMATIVO)
+if grep -q "Can't deploy routes that are assigned to another worker" deploy_output.log; then
+  echo "⚠️ NOTA: Conflito de rotas detectado"
+  echo "📍 Solução: Remover rotas manualmente em https://dash.cloudflare.com/[ACCOUNT_ID]/workers/overview"
+  echo "📍 Ou: Listar deployments com 'wrangler deployments list' e remover o conflitante"
+  echo "🔄 O deploy será repetido após resolver conflito manualmente"
+fi
+
+# Passo 4 — Reverter IMEDIATAMENTE
+# (substituir valores reais pelos placeholders)
+
+# Passo 5 — Verificar limpeza
+git status
+# Esperado: "nothing to commit, working tree clean"
+# Se modificado: git checkout server-edge-tracker/wrangler.toml
+```
+
+---
+
+## PROCEDURE `*migrate`
+
+Aplica schemas D1 em ordem (todos idempotentes — `IF NOT EXISTS`):
+
+```bash
+cd server-edge-tracker
+
+# Core tracking (sempre primeiro)
+wrangler d1 execute cdp-edge-db --file=schema.sql --remote
+
+# Migrations históricas
+wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
+
+# Fase 1: ML Clustering
+wrangler d1 execute cdp-edge-db --file=schema-segmentation.sql --remote
+
+# Fase 2: Bidding ML
+wrangler d1 execute cdp-edge-db --file=schema-bidding.sql --remote
+
+# Fase 3: A/B LTV Testing
+wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
+
+# Fase 4: Fraud Detection
+wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
+
+# Índices compostos de performance (queries D1)
+wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
+
+# Fase 5: LTV Model (regressão logística) + Match Quality Log
+wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
+
+# Fase 5b: Colunas LTV Feedback em user_profiles (real_ltv_value, ltv_accuracy, ltv_feedback_at)
+# OBRIGATÓRIO — sem isso recordLtvFeedback() falha silenciosamente em todo Purchase com value > 0
+wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
+
+# UTM Segmentação
+wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
+
+# Fase 6: Lead Scoring (quiz_sessions + VIEWs)
+# OBRIGATÓRIO se Lead Scoring Agent habilitado — sem isso QuizComplete não persiste
+wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote
+
+# Fase 7: Sales Engine (roas_reports + nurture_sequences + lookalike_seeds + VIEWs)
+# OBRIGATÓRIO se ROAS Feedback + Nurture Engine habilitados — depende de schema-quiz.sql aplicado antes
+# Se só Lead Scoring (sem ROAS): aplicar apenas schema-quiz.sql
+# Se ROAS + Nurture: aplicar ambos (schema-quiz.sql → schema-sales-engine.sql nesta ordem)
+wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
+```
+
+Após cada migração: confirmar sucesso antes de prosseguir.
+
+> **Fase 5 cria duas tabelas críticas:**
+> - `ltv_model_weights` — pesos do modelo LTV treinado semanalmente pelo cron
+> - `match_quality_log` — registra flags de qualidade de dados (has_email, has_fbp, etc.) a cada CAPI dispatch
+> Sem essas tabelas: o modelo LTV não persiste e o Match Quality Alert não funciona.
+>
+> **Fase 5b adiciona 3 colunas em `user_profiles` (ALTER TABLE):**
+> - `real_ltv_value` — valor real de compra registrado após Purchase
+> - `ltv_accuracy` — acurácia do modelo: `1 - |pred-real|/real` (0–1)
+> - `ltv_feedback_at` — timestamp do último feedback
+> **SEM ESSA MIGRAÇÃO:** `recordLtvFeedback()` falha silenciosamente em todo Purchase com value > 0 — ciclo preditivo nunca fecha.
+>
+> **Fase 6 (Lead Scoring) cria:**
+> - `quiz_sessions` — qualificação por lead com breakdown dimensional auditável
+> - `v_quiz_qualification_summary`, `v_quiz_dimension_impact` — VIEWs de análise
+>
+> **Fase 7 (Sales Engine) cria:**
+> - `roas_reports` — histórico de ROAS por campanha com bid recommendation
+> - `nurture_sequences` — fila de follow-up automático pós-quiz
+> - `lookalike_seeds` — histórico de compradores confirmados para Lookalike Meta
+
+---
+
+## PROCEDURE `*rollback`
+
+Reverte para versão anterior do Worker:
+
+```bash
+# Listar versões disponíveis
+wrangler deployments list
+
+# Fazer rollback para versão específica
+wrangler rollback [VERSION_ID]
+```
+
+---
+
+## PROCEDURE `*secrets`
+
+Configura todos os secrets do cliente na Cloudflare:
+
+```bash
+# Obrigatórios
+wrangler secret put META_ACCESS_TOKEN
+wrangler secret put GA4_API_SECRET
+wrangler secret put WHATSAPP_ACCESS_TOKEN
+wrangler secret put WHATSAPP_PHONE_NUMBER_ID
+wrangler secret put WA_NOTIFY_NUMBER
+wrangler secret put WA_WEBHOOK_VERIFY_TOKEN
+
+# Nurture Engine — email (obrigatório se Nurture habilitado)
+wrangler secret put RESEND_API_KEY           # API Key resend.com
+wrangler secret put RESEND_FROM_EMAIL        # ex: "CDP Edge <noreply@seudominio.com.br>"
+
+# Plataformas de anúncio opcionais (conforme selecionadas)
+wrangler secret put TIKTOK_ACCESS_TOKEN
+wrangler secret put PINTEREST_ACCESS_TOKEN
+wrangler secret put REDDIT_ACCESS_TOKEN
+wrangler secret put LINKEDIN_ACCESS_TOKEN
+wrangler secret put SPOTIFY_ACCESS_TOKEN
+wrangler secret put CALLMEBOT_PHONE
+wrangler secret put CALLMEBOT_APIKEY
+
+# Webhooks de gateway de pagamento
+wrangler secret put WEBHOOK_SECRET_TICTO     # HMAC-SHA256 Ticto
+```
+
+---
+
+## PROCEDURE `*smoke-test`
+
+Valida se o Worker está operacional após deploy:
+
+```bash
+# Testar endpoint de health ativo
+curl https://SEU_DOMINIO/health
+
+# Resultado esperado: todos os bindings OK
+# Se algum MISSING: investigar e corrigir antes de prosseguir
+```
+
+---
+
+## REGRAS
+
+0. **CONSULTA OBRIGATÓRIA À MEMÓRIA**: Extraia as credenciais de cliente, Domain IDs e Bindings Cloudflare (`wrangler.toml` vars e secrets) consultando ativamente o "memory-agent.json". Solicite ao Orquestrador tudo o que faltar. Execute deploys exclusivamente com os dados oficiais guardados na Memória para garantir alinhamento sistêmico.
+1. **Sempre** verificar `git status` após reverter placeholders
+2. **Nunca** commitar com dados reais — se acontecer, reverter imediatamente com `git checkout`
+3. **Sempre** confirmar Version ID após deploy bem-sucedido
+4. **Sempre** rodar `*smoke-test` após `*deploy`
+5. Qualquer falha de deploy: reportar ao Master Orchestrator com o erro completo

package/extracted-skill/tracking-events-generator/agents/domain-setup-agent.md

@@ -7,6 +7,14 @@
 
 ---
 
+## ✅ REGRAS CRÍTICAS
+
+0. **CONSULTA OBRIGATÓRIA À MEMÓRIA**: Extraia o Domínio do Site, IDs de Conta Cloudflare e Worker URL (`SITE_DOMAIN`, `CF_ACCOUNT_ID`, `ZONE_ID`, `WORKER_URL`) consultando ativamente o "memory-agent.json". Solicite ao Orquestrador tudo o que faltar. Execute configurações de DNS e Worker Routes exclusivamente com os dados oficiais guardados na Memória para garantir alinhamento sistêmico.
+1. Cloudflare-Only: Sem dependências externas.
+2. Same-Domain: Worker no domínio do site (anti-adblock).
+
+---
+
 ## Por que isso importa
 
 | Situação Atual | Com Domínio Próprio |
@@ -47,7 +55,7 @@ Cloudflare Dashboard
   → Add record
   → Type: CNAME
   → Name: track
-  → Target: server-edge-tracker.suporte-ed9.workers.dev
+  → Target: SEU_WORKER.SEU_USUARIO.workers.dev
   → Proxy status: Proxied (nuvem laranja ☁️)
   → TTL: Auto
   → Save
@@ -64,7 +72,7 @@ curl -X POST "https://api.cloudflare.com/client/v4/zones/{ZONE_ID}/dns_records"
   --data '{
     "type": "CNAME",
     "name": "track",
-    "content": "server-edge-tracker.suporte-ed9.workers.dev",
+    "content": "SEU_WORKER.SEU_USUARIO.workers.dev",
     "proxied": true
   }'
 ```
@@ -101,6 +109,12 @@ pattern = "track.clientdomain.com/*"
 zone_name = "clientdomain.com"
 ```
 
+> ⚠️ NOTA IMPORTANTE — Rota Direta Opcional:
+> A estrutura atual do CDP Edge suporta também rota direta no domínio principal:
+> `pattern = "clientdomain.com/track*"`
+> Isso evita criar subdomínio DNS e simplifica configuração
+> Ambos os métodos funcionam — escolha baseado em preferência de arquitetura
+
 Depois:
 
 ```bash
@@ -115,7 +129,7 @@ Localizar e substituir no `wrangler.toml`:
 
 ```toml
 # ANTES:
-SITE_DOMAIN = "server-edge-tracker.suporte-ed9.workers.dev"
+SITE_DOMAIN = "SEU_WORKER.SEU_USUARIO.workers.dev"
 
 # DEPOIS:
 SITE_DOMAIN = "clientdomain.com"
@@ -125,13 +139,13 @@ SITE_DOMAIN = "clientdomain.com"
 
 ---
 
-## Fase 4 — Verificar Cookie Domain no worker.js
+## Fase 4 — Verificar Cookie Domain no index.ts
 
 O cookie `_cdp_uid` precisa ser definido com `Domain=.clientdomain.com` (ponto antes = root domain = compartilhado entre subdomínios).
 
-### Localizar no worker.js a função de cookie:
+### Localizar no index.ts a função de cookie:
 
-```javascript
+```typescript
 // Buscar por: Set-Cookie ou _cdp_uid
 // Deve conter:
 `_cdp_uid=${uid}; Max-Age=31536000; Path=/; Domain=.${env.SITE_DOMAIN}; SameSite=None; Secure`
@@ -141,7 +155,7 @@ Se o worker usa `env.SITE_DOMAIN` no Domain do cookie (correto), basta atualizar
 
 Se o worker usa o domínio hardcoded ou `workers.dev`, atualizar manualmente:
 
-```javascript
+```typescript
 // Substituir:
 `Domain=.workers.dev`
 // Por:
@@ -177,7 +191,7 @@ O `cdpTrack.js` do cliente deve apontar para o novo endpoint:
 
 ```javascript
 // ANTES:
-const CDP_ENDPOINT = 'https://server-edge-tracker.suporte-ed9.workers.dev/track';
+const CDP_ENDPOINT = 'https://SEU_WORKER.SEU_USUARIO.workers.dev/track';
 
 // DEPOIS:
 const CDP_ENDPOINT = 'https://track.clientdomain.com/track';
@@ -210,7 +224,7 @@ const CDP_ENDPOINT = 'https://track.clientdomain.com/track';
 | 522 Connection Timed Out | CNAME não-proxied ou worker offline | Verificar proxy status + `wrangler deploy` |
 | Cookie Domain errado | SITE_DOMAIN antigo | Confirmar `wrangler.toml` + deploy |
 | Worker Route não ativando | Route sem deploy | `wrangler deploy` novamente |
-| CORS error no browser | Origin não permitido | Verificar headers CORS no worker.js |
+| CORS error no browser | Origin não permitido | Verificar headers CORS no index.ts |
 
 ---
 

package/extracted-skill/tracking-events-generator/agents/email-agent.md

@@ -4,6 +4,33 @@ Você é o **Especialista em E-mail Transacional (Quantum Tier)** do CDP Edge, f
 
 ---
 
+## 🔗 FLUXO DE ATIVAÇÃO (Como este agente é chamado)
+
+O Email Agent é ativado pelo **Webhook Agent** após confirmação de compra ou captura de lead:
+
+```
+Webhook Agent (Hotmart/Kiwify/Ticto)
+    └─► ctx.waitUntil(sendEmail(env, type, payload))
+            │
+            ├─ type = 'purchase_confirmation' → email de confirmação de compra
+            ├─ type = 'lead_welcome'          → email de boas-vindas ao lead
+            └─ type = 'cart_abandonment'      → email de recuperação de carrinho
+```
+
+**Assinatura da função que este agente gera:**
+
+```typescript
+// Injetada no Worker principal (index.ts)
+export async function sendEmail(env, type, payload) {
+  const { to, name, product, value } = payload;
+  // ... implementação completa abaixo
+}
+```
+
+> O Webhook Agent importa `sendEmail` e chama via `ctx.waitUntil` para não bloquear resposta ao gateway de pagamento.
+
+---
+
 ## 📧 PROTOCOLOS DE ENVIO (Quantum Tier)
 
 1. **Resend API Excellence**:
@@ -46,7 +73,7 @@ Sempre que o usuário precisar de automação de e-mail:
 ```json
 {
   "arquivos_criados": [
-    "cloudflare/email-service.js"
+    "modules/email-service.ts"
   ],
   "tipos_de_email": {
     "purchase_confirmation": "ativo",