cdp-edge 1.2.2 → 1.4.0

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

@@ -33,7 +33,7 @@ Database: Cloudflare D1 (Persistência)
 ## 📊 FUNCIONALIDADES DO SDK
 
 ### 1. Direct Fetch
-O rastreamento utiliza chamadas diretas via `fetch()` para o endpoint `/api/tracking` no mesmo domínio.
+O rastreamento utiliza chamadas diretas via `fetch()` para o endpoint `/track` no mesmo domínio.
 
 ### 2. Deduplicação
 Gera um `event_id` único para cada evento disparado no browser para que o Worker possa bater com a CAPI.
@@ -109,99 +109,199 @@ Implementado via `anti-blocking.js`:
 
 ## 💻 EXEMPLO DE CÓDIGO GERADO
 
-### `cdpTrack.js` (SDK Principal)
+### `cdpTrack.js` (SDK Principal — Padrão Multi-Plataforma)
+
+> Este é o padrão canônico do cdpTrack SDK para Meta, TikTok e GA4.
+> Cada agente de plataforma injeta seus eventos neste SDK via Browser Tracking Agent.
 
 ```javascript
 /**
  * cdpTrack SDK - CDP Edge Quantum Tier
  * Browser Tracking SDK Principal
+ * Suporta: Meta Pixel, TikTok Pixel, GA4, Pinterest Tag, Reddit Pixel, Spotify Pixel
  */
 
-(function(w, d, s, l) {
-  w._pbq = w._pbq || [];
-  w._pbq.push = w._pbq.push || [];
-  w._spotify = w._spotify || {};
-
-  // Carregar configuração
-  const config = window.cdpTrack?.config || {};
+(function(w) {
+  'use strict';
 
-  // Inicializar Spotify Pixel (se configurado)
-  if (config.spotifyPixelId) {
-    w._spotify.pixelId = config.spotifyPixelId;
-    w._spotify.currency = config.currency || 'USD';
+  // ──────────────────────────────────────────────
+  // CORE: Geração de event_id único (deduplicação)
+  // O mesmo event_id deve ser usado no browser E no servidor (CAPI)
+  // ──────────────────────────────────────────────
+  function generateEventId() {
+    return 'evt_' + Date.now() + '_' + Math.random().toString(36).substring(2, 11);
   }
 
-  // Função principal de envio
-  w._spotify.trackEvent = function(eventName, params) {
-    const eventId = cdpTrack.generateEventId();
-
-    // Track localmente
-    w._spq.push({
-      e: eventName,
-      params: params,
-      eventId: eventId,
-      platform: 'spotify'
-    });
-
-    // Enviar para servidor (via cdpTrack)
-    if (window.cdpTrack && window.cdpTrack.submit) {
-      window.cdpTrack.submit('spotify', {
-        event: eventName,
-        event_id: eventId,
-        ...params
+  // ──────────────────────────────────────────────
+  // CORE: Envio para Cloudflare Worker (same-domain)
+  // Usa /track no mesmo domínio — imune a ad-blockers
+  // ──────────────────────────────────────────────
+  async function sendToWorker(eventName, payload) {
+    const eventId = generateEventId();
+
+    const body = {
+      event:    eventName,
+      event_id: eventId,   // CRÍTICO: mesmo ID usado nas CAPIs
+      url:      window.location.href,
+      referrer: document.referrer,
+      timestamp: Date.now(),
+      ...payload
+    };
+
+    try {
+      // Tentativa primária: fetch
+      await fetch('/track', {
+        method:  'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body:    JSON.stringify(body),
+        keepalive: true
       });
+    } catch (_) {
+      // Fallback: Beacon API (funciona mesmo no unload da página)
+      navigator.sendBeacon('/track', JSON.stringify(body));
     }
-  };
 
-  // Eventos Padrão Spotify
-  w._spotify.Content = function(contentName, contentId, params) {
-    w._spotify.trackEvent('ViewContent', {
-      content_name: contentName,
-      content_id: contentId,
-      ...params
-    });
-  };
+    return eventId;
+  }
 
-  w._spotify.AddToCart = function(contentName, contentId, cartId, params) {
-    w._spotify.trackEvent('AddToCart', {
-      content_name: contentName,
-      content_id: contentId,
-      cart_id: cartId,
-      ...params
-    });
-  };
+  // ──────────────────────────────────────────────
+  // CORE: Captura de cookies first-party
+  // ──────────────────────────────────────────────
+  function getCookie(name) {
+    const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'));
+    return match ? decodeURIComponent(match[2]) : null;
+  }
 
-  w._spotify.Purchase = function(contentName, contentId, value, currency, params) {
-    w._spotify.trackEvent('Purchase', {
-      content_name: contentName,
-      content_id: contentId,
-      value: value,
-      currency: currency,
-      ...params
-    });
-  };
+  // ──────────────────────────────────────────────
+  // CORE: Captura de click IDs da URL (Meta, TikTok, Google)
+  // ──────────────────────────────────────────────
+  function getClickIds() {
+    const params = new URLSearchParams(window.location.search);
+    return {
+      fbclid:  params.get('fbclid')  || getCookie('fbclid')  || null,
+      ttclid:  params.get('ttclid')  || getCookie('ttclid')  || null,
+      gclid:   params.get('gclid')   || null,
+      gbraid:  params.get('gbraid')  || null,
+      wbraid:  params.get('wbraid')  || null,
+      fbp:     getCookie('_fbp')     || null,
+      fbc:     getCookie('_fbc')     || null,
+      ttp:     getCookie('_ttp')     || null,
+      uid:     getCookie('_cdp_uid') || null   // Identity Graph first-party cookie
+    };
+  }
 
-  w._spotify.Lead = function(contentName, contentId, leadType, params) {
-    w._spotify.trackEvent('Lead', {
-      content_name: contentName,
-      content_id: contentId,
-      lead_type: leadType,
-      ...params
-    });
-  };
+  // ──────────────────────────────────────────────
+  // API PÚBLICA
+  // ──────────────────────────────────────────────
+  const cdpTrack = {
+    generateEventId,
+
+    /**
+     * Rastrear evento genérico — enviado para o Worker
+     * O Worker despacha para Meta CAPI, GA4 MP, TikTok Events API etc.
+     *
+     * @param {string} eventName  - Nome do evento (ex: 'Lead', 'Purchase', 'PageView')
+     * @param {Object} params     - Parâmetros adicionais do evento
+     */
+    track(eventName, params = {}) {
+      const clickIds = getClickIds();
+      return sendToWorker(eventName, { ...clickIds, ...params });
+    },
+
+    /**
+     * Rastrear Lead (captura de formulário)
+     * Enviar dados PII crus — o Worker faz SHA-256 no servidor
+     */
+    trackLead(userData = {}) {
+      const clickIds = getClickIds();
+      return sendToWorker('Lead', {
+        ...clickIds,
+        email:      userData.email      || null,   // Worker aplica SHA-256
+        phone:      userData.phone      || null,   // Worker aplica E.164 + SHA-256
+        first_name: userData.first_name || null,
+        last_name:  userData.last_name  || null,
+        city:       userData.city       || null,
+        state:      userData.state      || null,
+        zip:        userData.zip        || null,
+        country:    userData.country    || 'BR'
+      });
+    },
 
-  w._spotify.Signup = function(contentName, contentId, signupType, params) {
-    w._spotify.trackEvent('Signup', {
-      content_name: contentName,
-      content_id: contentId,
-      signup_type: signupType,
-      ...params
-    });
+    /**
+     * Rastrear Purchase (confirmação de compra)
+     */
+    trackPurchase(orderData = {}) {
+      const clickIds = getClickIds();
+      return sendToWorker('Purchase', {
+        ...clickIds,
+        value:        orderData.value    || 0,
+        currency:     orderData.currency || 'BRL',
+        order_id:     orderData.order_id || null,
+        content_name: orderData.product  || null
+      });
+    },
+
+    /**
+     * Rastrear PageView — chamar no load da página
+     */
+    trackPageView() {
+      const clickIds = getClickIds();
+      return sendToWorker('PageView', { ...clickIds });
+    },
+
+    /**
+     * Rastrear InitiateCheckout
+     */
+    trackInitiateCheckout(checkoutData = {}) {
+      const clickIds = getClickIds();
+      return sendToWorker('InitiateCheckout', {
+        ...clickIds,
+        value:    checkoutData.value    || 0,
+        currency: checkoutData.currency || 'BRL'
+      });
+    }
   };
 
-})(window, document, 'script', 'location');
+  // Expor no window
+  w.cdpTrack = cdpTrack;
+
+  // Auto page_view no load
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', () => cdpTrack.trackPageView());
+  } else {
+    cdpTrack.trackPageView();
+  }
+
+})(window);
 ```
 
+### Uso típico no HTML do cliente
+
+```html
+<!-- 1. Carregar o SDK -->
+<script src="/tracking/cdpTrack.js"></script>
+
+<!-- 2. Rastrear lead ao submeter formulário -->
+<script>
+document.getElementById('lead-form').addEventListener('submit', function(e) {
+  cdpTrack.trackLead({
+    email:      document.getElementById('email').value,
+    phone:      document.getElementById('phone').value,
+    first_name: document.getElementById('name').value
+  });
+});
+</script>
+
+<!-- 3. Rastrear checkout (botão de compra) -->
+<script>
+document.getElementById('buy-btn').addEventListener('click', function() {
+  cdpTrack.trackInitiateCheckout({ value: 97.00, currency: 'BRL' });
+});
+</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`.
+
 ---
 
 ## 🔧 INTEGRAÇÃO COM OUTROS AGENTES
@@ -211,7 +311,7 @@ Implementado via `anti-blocking.js`:
 | Depende de | Input Esperado | O que faz com isso |
 |-------------|----------------|------------------|
 | **Page Analyzer** | Lista de elementos HTML | Mapeia `content_name` e `content_id` |
-| **Server Tracking Agent** | Lista de plataformas | Adiciona endpoint Spotify `/api/wh/spotify` |
+| **Server Tracking Agent** | Lista de plataformas | Adiciona endpoint Spotify `/webhook/spotify` |
 | **Premium Tracking Intelligence** | Estratégia de tracking | Define eventos prioritários para Spotify |
 | **Validator Agent** | Código gerado | Valida conformidade com Spotify API v1 |
 

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

@@ -137,7 +137,7 @@ Regras que nunca podem ser violadas, independente do contexto:
 ## ESCOPO
 
 Este agente monitora:
-- `server-edge-tracker/worker.js` — código crítico de produção
+- `server-edge-tracker/index.ts` — código crítico de produção
 - `extracted-skill/tracking-events-generator/cdpTrack.js` — SDK browser
 - `extracted-skill/tracking-events-generator/agents/*.md` — definições de agentes
 - `server-edge-tracker/wrangler.toml` — configuração de infraestrutura

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

@@ -183,7 +183,7 @@ CREATE INDEX IF NOT EXISTS idx_consent_policy_version
 
 ### Consent Collection & Storage
 
-```javascript
+```typescript
 /**
  * Consent Manager
  * Manages user consent collection, storage, and tracking
@@ -559,7 +559,7 @@ let consentManager = null;
 
 ### GDPR/LGPD/CCPA Data Rights Implementation
 
-```javascript
+```typescript
 /**
  * Data Rights Manager
  * Handles GDPR/LGPD/CCPA data rights: access, deletion, portability, rectification
@@ -1110,7 +1110,7 @@ let dataRightsManager = null;
 
 ### Automated Data Retention Policies
 
-```javascript
+```typescript
 /**
  * Data Retention Manager
  * Manages automated data retention and deletion policies
@@ -1381,7 +1381,7 @@ let dataRetentionManager = null;
 
 ### Comprehensive Audit Logging
 
-```javascript
+```typescript
 /**
  * Compliance Audit Logger
  * Records all compliance-related activities for audit purposes
@@ -1533,7 +1533,7 @@ let complianceAuditLogger = null;
 
 ### Compliance Management Endpoints
 
-```javascript
+```typescript
 /**
  * Compliance Management Endpoints
  */
@@ -2044,6 +2044,26 @@ async function handleGetCurrentPolicy(request, env) {
 - **security-enterprise-agent.md**: Usa encryption de PII para LGPD/GDPR
 - **attribution-agent.md**: Respeita consentimento para analytics e marketing
 - **master-orchestrator.md**: Implementa middleware de consentimento antes de tracking
+- **validator-agent.md**: O Compliance Agent DEVE ser consultado pelo Validator Agent para verificar conformidade de PII. Fluxo:
+
+```
+validator-agent (auditoria do código gerado)
+    └─► checkComplianceCompliance(generatedCode)
+            ├─ Verificar: SHA-256 aplicado em todos os campos PII (em, ph, fn, ln)?
+            ├─ Verificar: Google Consent Mode v2 implementado (ad_storage, analytics_storage)?
+            ├─ Verificar: url_passthrough: true ativo?
+            ├─ Verificar: PII nunca logada em plaintext?
+            └─ Verificar: opt-in explícito antes de tracking de marketing?
+
+// No validator-agent, chamar:
+const complianceCheck = await validateComplianceRequirements(generatedBrowserCode, generatedWorkerCode);
+if (!complianceCheck.passed) {
+  // Bloquear entrega e reportar issues ao Master Orchestrator
+  return { status: 'BLOCKED', issues: complianceCheck.issues };
+}
+```
+
+- **google-agent.md**: Consent Mode v2 gerado por este agente valida conformidade detectada pelo Compliance Agent
 
 ---
 

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

@@ -94,18 +94,18 @@ Definir o Dashboard como um **Centro de Comando de Dados** que equilibra:
   - Dados de evento: 15 minutos
 
 **Implementação:**
-```javascript
+```typescript
 // Carregar dados do cache
-const fetchMetrics = async (forceRefresh = false) => {
+const fetchMetrics = async (env, forceRefresh = false) => {
   const cacheKey = 'dashboard_metrics';
-  const cached = await KV.get(cacheKey);
+  const cached = await env.GEO_CACHE.get(cacheKey);
 
   if (cached && !forceRefresh) {
     return JSON.parse(cached);
   }
 
   // Cache miss ou refresh forçado — consultar D1
-  const metrics = await DB.prepare(`
+  const metrics = await env.DB.prepare(`
     SELECT
       AVG(heat_score) as avg_heat,
       COUNT(DISTINCT fingerprint) as total_users,
@@ -115,7 +115,7 @@ const fetchMetrics = async (forceRefresh = false) => {
   `).all();
 
   // Salvar no KV com TTL de 1 hora
-  await KV.put(cacheKey, JSON.stringify(metrics), { expirationTtl: 3600 });
+  await env.GEO_CACHE.put(cacheKey, JSON.stringify(metrics), { expirationTtl: 3600 });
 
   return metrics;
 };
@@ -129,7 +129,7 @@ const fetchMetrics = async (forceRefresh = false) => {
 - Desativação manual ou timeout de inatividade
 
 **Implementação:**
-```javascript
+```typescript
 const useRealTime = async () => {
   // WebSockets ou Server-Sent Events (SSE)
   const eventSource = new EventSource('/api/metrics/stream');
@@ -187,7 +187,7 @@ Invalidação:
 
 ### Para Cloudflare Worker
 
-```javascript
+```typescript
 // ENDPOINTS DE CONSULTA (otimizados)
 export const DASHBOARD_API = {
   // Métricas globais (cache no KV)
@@ -217,13 +217,13 @@ export const DASHBOARD_API = {
 };
 
 // HANDLER DE SINCronizaÇÃO (atualização de cache)
-export async function invalidateCache(domain, pattern) {
+export async function invalidateCache(domain, pattern, env) {
   const deletePattern = `${domain}:${pattern}`;
 
   // Deletar do KV
-  const keys = await KV.list({ prefix: deletePattern });
+  const keys = await env.GEO_CACHE.list({ prefix: deletePattern });
   for (const key of keys.keys) {
-    await KV.delete(key);
+    await env.GEO_CACHE.delete(key);
   }
 
   // Retornar contagem

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

@@ -6,6 +6,14 @@ Enquanto o `server-tracking-agent` define **o que o Worker FAZ**, você define *
 
 ---
 
+## ✅ REGRAS CRÍTICAS
+
+0. **CONSULTA OBRIGATÓRIA À MEMÓRIA**: Extraia os IDs de Recursos Cloudflare (`D1_DATABASE_ID`, `KV_ID`, `R2_BUCKET_NAME`, `ZONE_ID`) e configurações de bindings consultando ativamente o "memory-agent.json". Solicite ao Orquestrador tudo o que faltar. Execute configurações de infraestrutura 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).
+
+---
+
 ## 🏛️ RESPONSABILIDADES EXCLUSIVAS
 
 | Domínio | Você é dono de |
@@ -27,16 +35,16 @@ Enquanto o `server-tracking-agent` define **o que o Worker FAZ**, você define *
 ### Worker Ativo
 ```
 Nome:    server-edge-tracker
-URL:     https://server-edge-tracker.suporte-ed9.workers.dev
-Account: suporte@kadoshmkt.com.br
-ID:      ed96c1aa212ab5ab2e97e522b9a0b49b
-Deploy:  2026-03-29 (último)
+URL:     https://SEU_WORKER.SEU_USUARIO.workers.dev
+Account: SEU_EMAIL@SEUDOMINIO.com.br
+ID:      SEU_CLOUDFLARE_ACCOUNT_ID
+Deploy:  (data do último deploy)
 ```
 
 ### `wrangler.toml` — Estado Real
 ```toml
 name = "server-edge-tracker"
-main = "worker.js"
+main = "index.ts"
 compatibility_date = "2025-01-01"
 compatibility_flags = ["nodejs_compat"]
 
@@ -45,13 +53,13 @@ compatibility_flags = ["nodejs_compat"]
 META_PIXEL_ID      = "SEU_PIXEL_ID"
 GA4_MEASUREMENT_ID = "G-XXXXXXXXXX"
 TIKTOK_PIXEL_ID    = "CXXXXXXXXXXXXXXX"
-SITE_DOMAIN        = "server-edge-tracker.suporte-ed9.workers.dev"
+SITE_DOMAIN        = "SEU_DOMINIO"
 
 # ── D1 Database ───────────────────────────────────────────────────────────────
 [[d1_databases]]
 binding       = "DB"
 database_name = "cdp-edge-db"
-database_id   = "7867d38f-5fa8-4c17-b465-386211422c09"
+database_id   = "SEU_D1_DATABASE_ID"
 
 # ── Workers AI ────────────────────────────────────────────────────────────────
 [ai]
@@ -67,10 +75,10 @@ crons = ["0 2 * * 7", "0 3 1 * *"]
 ## 🗄️ BINDING 1 — D1 DATABASE (`env.DB`)
 
 ### Banco: `cdp-edge-db`
-- **ID:** `7867d38f-5fa8-4c17-b465-386211422c09`
+- **ID:** `SEU_D1_DATABASE_ID`
 - **Região:** ENAM (US East)
 - **Engine:** SQLite (Cloudflare D1)
-- **Tabelas ativas:** 8
+- **Tabelas ativas:** 31 (core: 13, migrate-v6: 1, migrate-v7: 2, Fases 1-4: 10, schema-ltv-feedback: +3 colunas, schema-utm: 1, schema-quiz: 1, schema-sales-engine: 3)
 
 ### Schema Completo (Produção)
 
@@ -251,7 +259,7 @@ CREATE INDEX IF NOT EXISTS idx_wa_ctwa_clid   ON whatsapp_contacts(ctwa_clid);
 CREATE INDEX IF NOT EXISTS idx_wa_created_at  ON whatsapp_contacts(created_at);
 ```
 > **Migration:** `migrate-v6.sql` — aplicar com `wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote`
-> **Tabelas ativas após v6:** 9
+> **Tabelas ativas após v6:** 14 (core: 13 + whatsapp_contacts). Total final após todos os schemas: 31 tabelas.
 
 ---
 
@@ -272,7 +280,7 @@ CREATE TABLE intelligence_logs (
 ```
 
 ### Padrões de Acesso D1 no Worker
-```javascript
+```typescript
 // SELECT com bind (previne SQL injection)
 const { results } = await env.DB
   .prepare('SELECT * FROM leads WHERE email = ? ORDER BY created_at DESC LIMIT 1')
@@ -305,9 +313,9 @@ ctx.waitUntil(
 
 ---
 
-## 📬 BINDING 2 — QUEUES (`env.QUEUE`) — *A Adicionar*
+## 📬 BINDING 2 — QUEUES (`env.RETRY_QUEUE`) — ✅ Configurado
 
-> **Status:** Arquitetado, ainda não configurado no `wrangler.toml`. Adicionar para habilitar retry assíncrono robusto.
+> **Status:** Ativo em produção — `wrangler.toml` com `RETRY_QUEUE` binding e consumer configurados.
 
 ### Configuração no `wrangler.toml`
 ```toml
@@ -331,7 +339,7 @@ wrangler queues create cdp-edge-dlq
 ```
 
 ### Uso no Worker (Produtor)
-```javascript
+```typescript
 // Enfileirar evento com falha para retry
 await env.RETRY_QUEUE.send({
   platform:    'meta',
@@ -343,7 +351,7 @@ await env.RETRY_QUEUE.send({
 ```
 
 ### Handler do Consumidor
-```javascript
+```typescript
 export default {
   async queue(batch, env) {
     for (const msg of batch.messages) {
@@ -379,9 +387,9 @@ Queue Consumer (assíncrono)
 
 ---
 
-## 🗂️ BINDING 3 — KV NAMESPACE (`env.GEO_CACHE`) — *A Adicionar*
+## 🗂️ BINDING 3 — KV NAMESPACE (`env.GEO_CACHE`) — ✅ Configurado
 
-> **Status:** Arquitetado para cache de geo/IP. Ainda não configurado.
+> **Status:** Ativo em produção — usado para geo cache, fraud blocklist, fraud velocity counters e A/B test cache.
 
 ### Configuração no `wrangler.toml`
 ```toml
@@ -398,7 +406,7 @@ wrangler kv namespace create GEO_CACHE
 ```
 
 ### Uso no Worker
-```javascript
+```typescript
 // Cache de geolocalização por IP (TTL: 1 hora)
 const cacheKey = `geo:${clientIp}`;
 let geoData = await env.GEO_CACHE.get(cacheKey, { type: 'json' });
@@ -440,7 +448,7 @@ wrangler r2 bucket create cdp-edge-logs
 ```
 
 ### Uso no Worker
-```javascript
+```typescript
 // Armazenar evento bruto para auditoria (LGPD)
 const logKey = `events/${year}/${month}/${day}/${eventId}.json`;
 await env.AUDIT_LOGS.put(logKey, JSON.stringify({
@@ -459,13 +467,14 @@ await env.AUDIT_LOGS.put(logKey, JSON.stringify({
 
 ### Modelo em Uso
 ```
-@cf/meta/llama-3.1-8b-instruct
-Custo: ~10.000 neurônios/requisição
-Limite Free: 10.000 neurônios/dia (~1.000 predições/dia)
+@cf/ibm-granite/granite-4.0-h-micro   ← LTV Prediction + Naming de Clusters
+@cf/baai/bge-m3         ← Embeddings para K-means vetorial (ML Clustering)
+Custo Granite: ~20-35 neurônios/requisição (3x mais eficiente que Llama 3.1 8B)
+Limite Free: 10.000 neurônios/dia (~350 predições/dia com Granite)
 ```
 
 ### Uso no Worker (LTV Prediction)
-```javascript
+```typescript
 async function predictLtv(leadData, env) {
   if (!env.AI) return { ltv_class: 'unknown', ltv_value: 0 };
 
@@ -477,7 +486,7 @@ async function predictLtv(leadData, env) {
       Responda apenas: {"class": "high|medium|low", "value": 0-1000}
     `;
 
-    const response = await env.AI.run('@cf/meta/llama-3.1-8b-instruct', {
+    const response = await env.AI.run('@cf/ibm-granite/granite-4.0-h-micro', {
       messages: [{ role: 'user', content: prompt }],
       max_tokens: 50
     });
@@ -501,7 +510,7 @@ async function predictLtv(leadData, env) {
 | `0 3 1 * *` | Dia 1 03:00 | Intelligence Agent — auditoria mensal de erros |
 
 ### Handler no Worker
-```javascript
+```typescript
 export default {
   async scheduled(event, env, ctx) {
     ctx.waitUntil(runIntelligenceAgent(event.cron, env));
@@ -540,7 +549,7 @@ async function runIntelligenceAgent(cron, env) {
 | `META_TEST_CODE` | ⚠️ Reconfigurar | Só testes | meta-agent |
 | `META_AD_ACCOUNT_ID` | ⚠️ Reconfigurar | Customer Match | meta-agent |
 | `META_AUDIENCE_ID` | ⚠️ Reconfigurar | Customer Match | meta-agent |
-| `WHATSAPP_TOKEN` | ⚠️ Reconfigurar | WhatsApp | whatsapp-agent |
+| `WHATSAPP_ACCESS_TOKEN` | ⚠️ Reconfigurar | WhatsApp | whatsapp-agent |
 | `WHATSAPP_PHONE_NUMBER_ID` | ⚠️ Reconfigurar | WhatsApp | whatsapp-agent |
 | `RESEND_API_KEY` | ⚠️ Reconfigurar | Email | email-agent |
 | `RESEND_FROM_EMAIL` | ⚠️ Reconfigurar | Email | email-agent |
@@ -552,7 +561,7 @@ async function runIntelligenceAgent(cron, env) {
 wrangler secret put META_ACCESS_TOKEN
 wrangler secret put GA4_API_SECRET
 wrangler secret put TIKTOK_ACCESS_TOKEN
-wrangler secret put WHATSAPP_TOKEN
+wrangler secret put WHATSAPP_ACCESS_TOKEN
 wrangler secret put WHATSAPP_PHONE_NUMBER_ID
 wrangler secret put RESEND_API_KEY
 wrangler secret put RESEND_FROM_EMAIL
@@ -564,7 +573,7 @@ wrangler secret put RESEND_FROM_EMAIL
 
 Todo I/O que não bloqueia a resposta ao browser **DEVE** usar `ctx.waitUntil`:
 
-```javascript
+```typescript
 export default {
   async fetch(request, env, ctx) {
 
@@ -592,20 +601,12 @@ export default {
 
 ## 🗺️ ROADMAP DE INFRAESTRUTURA
 
-### Fase Atual (✅ Implementado)
-- D1 com 8 tabelas em produção
-- Workers AI para LTV Prediction
-- 2 Cron Triggers ativos
-- Secrets básicos (a reconfigurar)
-
-### Fase 2 (🔧 Próximos Passos)
-- Queues para retry robusto (substituir retry síncrono atual)
-- KV para cache de geo/sessão (reduzir latência)
-
-### Fase 3 (🚀 Enterprise)
-- R2 para logs auditáveis (conformidade LGPD)
-- Múltiplos Workers especializados (routing por subdomínio)
-- Durable Objects para sessões real-time
+### Fase Atual (✅ Implementado — v2.5.1)
+- D1 com 31 tabelas em produção (core + Fases 1-7)
+- Workers AI: Granite 4.0 Micro (LTV + Quiz Scoring) + bge-m3 (Clustering)
+- 2 Cron Triggers ativos (semanal + mensal)
+- Rate Limiter, KV, R2 Audit Logs, Queues configurados
+- Quiz Scoring Engine + Nurture Engine + ROAS Feedback Loop ativos
 
 ---