cdp-edge 2.5.5 → 2.5.7

package/README.md

@@ -1,7 +1,7 @@
 # 🚀 CDP Edge — Quantum Tracking Enterprise
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.5.5** — Integração EVO CRM (OAuth2) + Sync Total de Agentes (27 de Abril de 2026) 🔧
+> **v2.5.7** — Fraud Gate parametrizável: geo-fence + datacenter kill-switch + threshold configurável (30 de Abril de 2026) 🛡️
 
 ---
 
@@ -41,7 +41,7 @@ POST /track (QuizComplete)
   ├─ [3] 🔮  A/B LTV Sorting (KV cache ~0ms)
   ├─ [4] 🧮  LTV Prediction (Granite 4.0 Micro) — intent qualificado → High LTV
   ├─ [5] 💾  D1 Writes background (quiz_sessions + leads + nurture_sequences)
-  └─ [6] 📡  CAPI paralelo (Meta v22.0 + GA4 + TikTok v1.3)
+  └─ [6] 📡  CAPI paralelo (Meta v25.0 + GA4 + TikTok v1.3)
 
 Cron semanal (Intelligence Agent):
   ├─ ROAS Feedback — cruza leads × purchases por campanha → bid recommendation
@@ -110,7 +110,7 @@ v_leads_segmented           v_ltv_feedback
 | Enterprise | `bidding-agent.md` | Bids ML por segmento |
 | Enterprise | `ab-ltv-agent.md` | A/B testing de prompts LTV |
 | Enterprise | `fraud-detection-agent.md` | Detecção de fraude na borda |
-| Infraestrutura | `evo-crm-agent.md` | Roteamento de leads p/ EVO CRM (OAuth2) |
+| Infraestrutura | `zapman-agent.md` | Roteamento de leads p/ ZapMan SDR (Kanban + webhook IA) |
 | Monitoramento | `intelligence-agent.md` | Cron — ROAS, Nurture, Lookalike, LTV training |
 
 ---
@@ -123,7 +123,7 @@ v_leads_segmented           v_ltv_feedback
 | `/track` | POST | Evento principal — Fraud Gate → Quiz Scoring → LTV → CAPI |
 | `/health` | GET | Smoke test D1 + KV + AI |
 | `/webhook/ticto` | POST | Purchase webhook (HMAC) |
-| `/webhook/whatsapp` | POST | Webhook Meta WhatsApp → CRM (Evolution/EVO) |
+| `/webhook/whatsapp` | POST | Webhook Meta WhatsApp → ZapMan SDR |
 | `/export/customer-match` | GET | Export leads para Google Ads |
 | `/validate-install` | GET | Diagnóstico pós-deploy |
 
@@ -184,10 +184,7 @@ wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
 wrangler secret put META_ACCESS_TOKEN
 wrangler secret put GA4_API_SECRET
 wrangler secret put TIKTOK_ACCESS_TOKEN
-wrangler secret put EVO_CRM_BASE_URL
-wrangler secret put EVO_CRM_CLIENT_ID
-wrangler secret put EVO_CRM_CLIENT_SECRET
-wrangler secret put EVO_CRM_INBOX_ID
+wrangler secret put ZAPMAN_API_KEY
 
 # Deploy
 wrangler deploy

package/contracts/agent-versions.json

@@ -1,7 +1,7 @@
 {
   "_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.5",
-  "worker_hash_date": "2026-04-27",
+  "worker_version": "2.5.7",
+  "worker_hash_date": "2026-04-30",
   "agents": {
     "master-orchestrator": {
       "version": "2.0.7",
@@ -44,7 +44,7 @@
         "contracts/api-versions.json:meta"
       ],
       "critical_sections": [
-        "Meta CAPI version v22.0",
+        "Meta CAPI version v25.0",
         "endpoint pattern",
         "event names"
       ],

package/contracts/api-versions.json

@@ -15,9 +15,9 @@
 
     "versions": {
       "pixel": {
-        "current": "v22.0",
+        "current": "v25.0",
         "minimum_supported": "v21.0",
-        "recommended": "v22.0",
+        "recommended": "v25.0",
         "deprecated": ["v20.0", "v21.0"],
         "deprecated_cutoff": {
           "v20.0": "2024-01-01T00:00:00.000Z",
@@ -26,9 +26,9 @@
       },
 
       "capi": {
-        "current": "v22.0",
+        "current": "v25.0",
         "minimum_supported": "v21.0",
-        "recommended": "v22.0",
+        "recommended": "v25.0",
         "endpoint_pattern": "https://graph.facebook.com/{VERSION}/{PIXEL_ID}/events",
         "authentication": "Bearer token (META_ACCESS_TOKEN)",
         "rate_limits": {
@@ -39,10 +39,10 @@
       },
 
       "messenger": {
-        "current": "v22.0",
+        "current": "v25.0",
         "minimum_supported": "v21.0",
-        "recommended": "v22.0",
-        "whatsapp_cloud_api": "v22.0"
+        "recommended": "v25.0",
+        "whatsapp_cloud_api": "v25.0"
       }
     }
   },
@@ -322,7 +322,7 @@
       "new_parameters": [],
       "deprecated_parameters": [],
       "migration_steps": [
-        "Atualizar endpoint de /v20.0/ para /v22.0/",
+        "Atualizar endpoint de /v20.0/ para /v25.0/",
         "Verificar novos parâmetros obrigatórios",
         "Testar em ambiente de sandbox"
       ]

package/extracted-skill/tracking-events-generator/INSTALACAO-CDPEDGE.md

@@ -28,12 +28,12 @@ O **CDP Edge** é um sistema de tracking digital completo que opera de forma nat
 | **cdpTrack.js** | SDK do Site | Envio direto via Fetch para o Worker |
 | **Workers** | Processamento | Execução na borda com baixa latência |
 | **D1 Database** | Persistência | Armazenamento seguro de leads e eventos |
-| **CAPI v22.0** | Despacho | Atribuição de alta qualidade via servidor |
+| **CAPI v25.0** | Despacho | Atribuição de alta qualidade via servidor |
 
 ### Plataformas Suportadas (Server-Side)
 | Plataforma | Status | Protocolo |
 |---|---|---|
-| Meta / Facebook Pixel | ✅ | ✅ CAPI v22.0 |
+| Meta / Facebook Pixel | ✅ | ✅ CAPI v25.0 |
 | Google Analytics 4 | ✅ | ✅ Measurement Protocol |
 | Google Ads | ✅ | ✅ Conversão + User-provided Data |
 | TikTok Pixel | ✅ | ✅ Events API v1.3 |

package/extracted-skill/tracking-events-generator/INTEGRACAO-COMPLETA.md

@@ -46,7 +46,7 @@
           ┌────────┐  ┌────────┐  ┌─────────┐
           │  Meta  │  │ Google │  │  TikTok │
           │ CAPI   │  │  GA4 MP │  │ Events API│
-          │ v22.0  │  │        │  │  v1.3    │
+          │ v25.0  │  │        │  │  v1.3    │
           └────────┘  └────────┘  └─────────┘
 ```
 
@@ -291,7 +291,7 @@ Sync Identity Graph (D1)
     ↓
 Calculate Server-Side Engagement Score (0-5.0 com histórico)
     ↓
-Dispatch para Meta CAPI v22.0 (com engagement score + advanced matching)
+Dispatch para Meta CAPI v25.0 (com engagement score + advanced matching)
     ↓
 Dispatch para Google GA4 MP (com engagement score)
     ↓
@@ -323,7 +323,7 @@ Cidade, estado, zip, dob NÃO são hashados (Meta AM)
     ↓
 Calculate Engagement Score (com PII + histórico)
     ↓
-Dispatch para Meta CAPI v22.0:
+Dispatch para Meta CAPI v25.0:
   user_data: {
     em: [sha256_email],
     ph: [sha256_phone_ddi55],

package/extracted-skill/tracking-events-generator/Premium-Tracking-Intelligence-Resumo.md

@@ -177,7 +177,7 @@ WORKER RECEBE PAYLOAD
 [4] Log Behavioral → Grava behavioral_events no D1
     ↓
 DISPATCH MULTIPLATAFORMA
-    ├──▶ META CAPI v22.0
+    ├──▶ META CAPI v25.0
     │   └── user_data: { em, ph, fn, ln, ct, st, zp, db }
     │       └── custom_data: { engagement_score, intention_level, ... }
     ├──▶ GOOGLE GA4 MP

package/extracted-skill/tracking-events-generator/SKILL.md

@@ -3,13 +3,13 @@ name: cdp-edge
 description: >
   CDP Edge — Sistema multi-agente para Quantum Tracking.
   Arquitetura Cloudflare Native (Workers + D1).
-  Gera tracking para Meta (CAPI v22.0), TikTok (API v1.3), GA4 (MP) e Spotify (v1).
+  Gera tracking para Meta (CAPI v25.0), TikTok (API v1.3), GA4 (MP) e Spotify (v1).
   **Human-Behavior Engine**: Captura rage clicks, tab focus, heatmaps (D1) e pulse heartbeat nativamente.
   **Niche AI**: Detecção automática de cenários (Imobiliário, Vendas, SaaS) para injeção estratégica.
   Possui agentes especialistas para análise de página, arquitetura de servidor e validação rigorosa.
 
   Use SEMPRE que o usuário pedir: pixel, tracking, CAPI, Cloudflare, rastrear conversão,
-  "configura meu servidor", "v22.0" ou "rastreamento nativo".
+  "configura meu servidor", "v25.0" ou "rastreamento nativo".
 ---
 
 # CDP Edge — Quantum Tracking
@@ -34,7 +34,7 @@ O CDP Edge é um sistema de rastreamento focado em **atribuição direta** no ec
 graph TD
     A[Browser: cdpTrack SDK] -->|Fetch API| B[Cloudflare Workers]
     B -->|Persistência| C[Cloudflare D1 Database]
-    B -->|CAPI v22.0| D[Meta API]
+    B -->|CAPI v25.0| D[Meta API]
     B -->|v1.3| E[TikTok API]
     B -->|MP| F[GA4 Collect]
 ```
@@ -133,7 +133,7 @@ Seguir o fluxo definido nesse arquivo. Ele define todas as fases: perguntas, an
 ### /setup — Configuração Quantum
 Inicia o fluxo de perguntas, análise de projeto e geração de infraestrutura Cloudflare.
 
-### /server — Gerar Worker v22.0
+### /server — Gerar Worker v25.0
 Gera apenas o código do `worker.js` com suporte a Meta CAPI e TikTok API v1.3.
 
 ---

package/extracted-skill/tracking-events-generator/advanced-matching.js

@@ -2,7 +2,7 @@
  * ADVANCED MATCHING MAXIMUM - CDP Edge (Quantum Tier)
  *
  * Sistema de normalização e hashing de PII (Personally Identifiable Information)
- * para máxima precisão de atribuição em Meta CAPI v22.0.
+ * para máxima precisão de atribuição em Meta CAPI v25.0.
  *
  * @version 1.0.0
  */

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

@@ -23,7 +23,7 @@ Browser (Cliente)          Worker (Server-Side)           APIs (Meta/Google/TikT
      │                            ├─► Persistir no D1                │
      │                            ├─► Enviar para APIs com           │
      │                            │   atribuição calculada          │
-     │                            │        (Meta CAPI v22.0)        │
+     │                            │        (Meta CAPI v25.0)        │
      │                            │        (TikTok v1.3)             │
      │                            │        (GA4 MP)                 │
      │                            │                                  │
@@ -769,8 +769,8 @@ async function sendMetaPurchaseWithAttribution(purchaseData, attribution) {
     }
   };
 
-  // Enviar via Meta CAPI v22.0
-  const response = await fetch('https://graph.facebook.com/v22.0/events', {
+  // Enviar via Meta CAPI v25.0
+  const response = await fetch('https://graph.facebook.com/v25.0/events', {
     method: 'POST',
     headers: {
       'Authorization': `Bearer ${env.META_ACCESS_TOKEN}`,

package/extracted-skill/tracking-events-generator/agents/browser-tracking.md

@@ -72,7 +72,7 @@ Implementado via `anti-blocking.js`:
 ## 🛠️ CRITÉRIOS DE VALIDAÇÃO (Quantum Tier)
 
 ### PASSO 1 — API Versions
-- Verificar versões compatíveis (Meta v22.0+, TikTok v1.3+, Google GA4 MP, Spotify v1)
+- Verificar versões compatíveis (Meta v25.0+, TikTok v1.3+, Google GA4 MP, Spotify v1)
 - Consultar `contracts/api-versions.json`
 
 ### PASSO 2 — Coerência com Page Analyzer
@@ -300,7 +300,7 @@ document.getElementById('buy-btn').addEventListener('click', function() {
 </script>
 ```
 
-> **Nota:** O Worker recebe os dados crus, aplica SHA-256, e despacha para Meta CAPI v22.0, GA4 MP, TikTok Events API v1.3 e demais plataformas configuradas — tudo em paralelo via `Promise.allSettled`.
+> **Nota:** O Worker recebe os dados crus, aplica SHA-256, e despacha para Meta CAPI v25.0, GA4 MP, TikTok Events API v1.3 e demais plataformas configuradas — tudo em paralelo via `Promise.allSettled`.
 
 ---
 

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

@@ -49,7 +49,7 @@ SHA-256 ausente em dados PII enviados para CAPI
 
 ### APIs Desatualizadas
 ```
-Meta CAPI < v22.0
+Meta CAPI < v25.0
 TikTok Events API < v1.3
 GA4 endpoint incorreto
 ```
@@ -87,7 +87,7 @@ Antes de qualquer commit, verificar automaticamente:
 - [ ] event_id gerado com prefixo `cdp_`
 - [ ] PII hasheado com SHA-256 antes de enviar para APIs externas
 - [ ] Nenhum secret hardcoded (usar `env.SECRET_NAME`)
-- [ ] Versões de API: Meta v22.0+, TikTok v1.3+
+- [ ] Versões de API: Meta v25.0+, TikTok v1.3+
 - [ ] wrangler.toml atualizado se novos bindings foram adicionados
 - [ ] INDEX.md atualizado se novos agentes foram criados
 - [ ] package.json version bumped se mudança significativa

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

@@ -80,7 +80,7 @@ async function dispatchEventToMeta(event, userContext) {
   const startTime = Date.now();
 
   try {
-    const response = await fetch('https://graph.facebook.com/v22.0/events', {
+    const response = await fetch('https://graph.facebook.com/v25.0/events', {
       method: 'POST',
       headers: { 'Authorization': `Bearer ${env.META_ACCESS_TOKEN}` },
       body: JSON.stringify(event)

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

@@ -152,7 +152,7 @@ Timestamp: ${new Date().toISOString()}
 
   // Enviar via WhatsApp Agent
   if (env.WHATSAPP_PHONE_NUMBER_ID && env.ADMIN_PHONE_NUMBER) {
-    await fetch(`https://graph.facebook.com/v22.0/${env.WHATSAPP_PHONE_NUMBER_ID}/messages`, {
+    await fetch(`https://graph.facebook.com/v25.0/${env.WHATSAPP_PHONE_NUMBER_ID}/messages`, {
       method: 'POST',
       headers: {
         'Content-Type': 'application/json',
@@ -186,7 +186,7 @@ Quando o Intelligence Agent detectar API desatualizada, emitir alerta estruturad
   "api_version_alert": {
     "platform": "meta",
     "severity": "CRITICAL",
-    "current_version": "v22.0",
+    "current_version": "v25.0",
     "latest_version": "v23.0",
     "deprecation_date": "2025-06-01",
     "impact": [
@@ -201,7 +201,7 @@ Quando o Intelligence Agent detectar API desatualizada, emitir alerta estruturad
       "estimated_time": "30 minutos"
     },
     "recommended_fix": {
-      "step_1": "Atualizar endpoint de /v22.0/ para /v23.0/",
+      "step_1": "Atualizar endpoint de /v25.0/ para /v23.0/",
       "step_2": "Verificar novos parâmetros obrigatórios na documentação",
       "step_3": "Testar em ambiente de sandbox antes de deploy"
     }
@@ -269,8 +269,8 @@ O Intelligence Agent DEVE verificar se alguma API está prestes a ser descontinu
 async function checkApiDepreciations(env) {
   const deprecationSchedule = {
     meta: {
-      'v20.0': { deprecated: true, cutoff: '2024-01-01', replacement: 'v22.0' },
-      'v21.0': { deprecated: true, cutoff: '2024-06-01', replacement: 'v22.0' }
+      'v20.0': { deprecated: true, cutoff: '2024-01-01', replacement: 'v25.0' },
+      'v21.0': { deprecated: true, cutoff: '2024-06-01', replacement: 'v25.0' }
     },
     tiktok: {
       'v1.2': { deprecated: true, cutoff: '2024-03-01', replacement: 'v1.3' }
@@ -515,7 +515,7 @@ wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote # Fase 7
   },
   "endpoint_manual": "GET /api/intelligence/check",
   "alertas": {
-    "canal_primario": "WhatsApp Meta Cloud API v22.0",
+    "canal_primario": "WhatsApp Meta Cloud API v25.0",
     "canal_fallback": "CallMeBot",
     "anti_spam": "24h cooldown por issue"
   },

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

@@ -57,3 +57,22 @@ Sempre que o Orquestrador invocar a Otimização de Baleias (LTV Prediction):
   "limite_diario": 10000
 }
 ```
+
+---
+
+## COMANDO *new-ai-module — Ativação por módulo genérico
+
+Este agente também é invocado pelo Master Orchestrator quando recebe o comando `*new-ai-module` com descrição do tipo:
+**classificar, score, pontuar, prever, predizer, detectar, identificar, intenção, distribuir, rotear, priorizar, ranking**
+
+### Responsabilidade no PASSO 1 do pipeline *new-ai-module
+
+Entregar obrigatoriamente ao Master Orchestrator:
+
+1. **Modelo escolhido** — justificado pelo caso de uso descrito
+2. **System prompt calibrado** — instrução para o modelo retornar JSON puro com os campos: `class`, `confidence`, `score`, `reasoning`
+3. **Contrato de features** — quais campos do payload `/track` alimentam o modelo como input
+4. **TTL de cache KV recomendado** — padrão 3600s, ajustar se o módulo for sensível a tempo real
+5. **Posição no pipeline `/track`** — se Modo A ou C, indicar após qual módulo existente este deve ser inserido
+
+> **Regra:** Responder com o pacote completo em uma única mensagem. Sem perguntas de volta ao Orchestrator.