cdp-edge 1.13.0 → 1.15.0

package/README.md

@@ -1,39 +1,82 @@
-# 🚀 CDP Edge - Quantum Tracking
+# 🚀 CDP Edge — Quantum Tracking Enterprise
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v1.2.2** — Cloudflare Queue + KV + Workers AI · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
-
-- **Precisão Máxima**: Meta CAPI v22.0+, GA4 MP e TikTok Events API v1.3.
-- **Identity Graph**: Persistência de leads e eventos via Cloudflare D1.
-- **Anti-Adblock**: Endpoint Same-Domain indetectável.
-- **Human-Behavior Engine**: Score de engajamento em tempo real.
-- **Queue Retry**: Zero perda de conversão — eventos com falha reenfileirados automaticamente.
-- **Geo Intelligence**: Cidade, estado e CEP em todos os eventos.
+> **v1.4.0** — Enterprise-Level Intelligence Engine · Cloudflare Workers · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
 
 ---
 
-## 🏗️ ARQUITETURA QUANTUM (CLOUDFLARE NATIVE)
+## 📋 CHANGELOG v1.4.0 (9 de Abril de 2026)
+
+### 🆕 Sprint Enterprise — Fases 1 a 4
+
+#### ✅ Fase 1 — ML Clustering (Segmentação Dinâmica)
+- **`POST /api/segmentation/cluster`** — K-means / DBSCAN / Hierarchical via Workers AI
+- **`GET  /api/segmentation/list`** — Segmentos ativos com métricas
+- **`GET  /api/segmentation/outliers`** — Detecção de outliers comportamentais
+- **`PUT  /api/segmentation/update`** — Atualização de metadados de segmento
+- Schema D1: `ml_segments`, `ml_segment_members` + VIEWs otimizadas
+- Agente: `ml-clustering-agent.md`
+
+#### ✅ Fase 2 — Bidding Recommendations (Otimização de Bids ML)
+- **`POST /api/bidding/recommend`** — Bid otimizado por segmento × plataforma (Meta/Google/TikTok), calculado com fórmula `LTV × ROI target / CPA base`
+- **`GET  /api/bidding/history`** — Histórico completo de recomendações
+- **`GET  /api/bidding/status`** — Snapshot atual das recomendações ativas por vertical
+- Schema D1: `bid_recommendations` + VIEW `v_active_bid_recommendations`
+- Agente: `bidding-agent.md`
+
+#### ✅ Fase 3 — A/B Testing de Prompts LTV
+- **`POST /api/ltv/ab-test/create`** — Cria experimento com múltiplas variações de system prompt
+- **`GET  /api/ltv/ab-test/list`** — Lista experimentos com status e progresso
+- **`GET  /api/ltv/ab-test/results`** — Accuracy score por variação + recomendação automática de winner
+- **`POST /api/ltv/ab-test/winner`** — Declara vencedor e retorna o prompt ganador
+- Integração automática: cada evento Lead sorteia a variação ativa e registra o assignment via KV cache
+- Schema D1: `ltv_ab_tests`, `ltv_ab_variations`, `ltv_ab_assignments` + VIEW `v_ab_test_performance`
+- Agente: `ab-ltv-agent.md`
+
+#### ✅ Fase 4 — Fraud Detection Engine
+- **Fraud Gate automático em `/track`** — roda ANTES de qualquer processamento (heurístico puro, ~2ms)
+- Silent drop (retorna 200 falso) — bots não detectam a defesa
+- **`GET  /api/fraud/stats`** — Dashboard de fraude (últimas 24h)
+- **`GET  /api/fraud/alerts`** — Log de sinais detectados com filtros
+- **`GET  /api/fraud/blocklist`** — IPs/fingerprints atualmente bloqueados
+- **`POST /api/fraud/blocklist/add`** — Bloquear IP ou fingerprint (via KV, efeito imediato)
+- **`DELETE /api/fraud/blocklist/remove`** — Remover do blocklist
+- Sinais detectados: bot_score, datacenter IP, velocity attack, email descartável, headless UA, sem Accept-Language
+- Schema D1: `fraud_signals`, `fraud_alerts` + VIEW `v_fraud_dashboard`
+- Agente: `fraud-detection-agent.md`
+
+### 🔧 Fix: `wrangler.toml` atualizado
+- Todos os placeholders (`SEU_D1_DATABASE_ID`, `SEU_KV_NAMESPACE_ID`) substituídos pelos IDs reais da conta Cloudflare
+- D1: `7867d38f-5fa8-4c17-b465-386211422c09`
+- KV: `821b6c1ccb4b475985439b801c1fdbe0`
+
+---
 
-O CDP Edge não é um "script de rastreio", é uma **infraestrutura de borda** com inteligência de dados acoplada.
+## 🏗️ ARQUITETURA QUANTUM ENTERPRISE (CLOUDFLARE NATIVE)
 
 ```mermaid
 graph TD
     User((Usuário)) -->|Interação| SDK[cdpTrack SDK + Behavior Engine]
-    SDK -->|Edge Fetch| Worker[Cloudflare Worker Agent]
-    Worker -->|Identity Graph| D1[(D1 SQL Database)]
-    Worker -->|Background Job| Queue[Cloudflare Queues]
+    SDK -->|Edge Fetch 1ª via KV blocklist| FraudGate{🛡️ Fraud Gate}
+    FraudGate -->|score ≥ 80: Silent Drop 200| Void[/dev/null]
+    FraudGate -->|score < 80: Permitido| Worker[Cloudflare Worker Agent]
+    Worker -->|Identity Graph + _cdp_uid| D1[(D1 SQL — 21 tabelas)]
+    Worker -->|LTV + A/B Prompt| AI[Workers AI Llama 3.1 8B]
+    Worker -->|Segmento ML| Cluster[ML Clustering Engine]
+    Cluster -->|Bid otimizado| Bidding[Bidding Recommendations]
+    Worker -->|Background| Queue[Cloudflare Queues]
     Queue -->|Server Dispatch| Meta[Meta CAPI v22.0]
     Queue -->|Server Dispatch| Google[GA4 / Google Ads]
     Queue -->|Server Dispatch| TikTok[TikTok API v1.3]
-    D1 -->|Retention Reports| Dash[Dashboard Agent]
+    D1 -->|Reports| Dash[Dashboard Agent]
 ```
 
 ---
 
-## 🖱 CATÁLOGO DE AGENTES ESPECIALISTAS
+## 🧠 CATÁLOGO DE AGENTES ESPECIALISTAS
 
-O sistema é composto por **39+ agentes** coordenados pelo **Master Orchestrator**:
+O sistema é composto por **43+ agentes** coordenados pelo **Master Orchestrator**:
 
 ### 🧠 Núcleo de Inteligência
 | Agente | Função |
@@ -56,6 +99,14 @@ O sistema é composto por **39+ agentes** coordenados pelo **Master Orchestrator
 | **Spotify Agent** | Pixel + Conversions API v1 |
 | **Bing Agent** | UET Tag + Enhanced Conversions |
 
+### 🤖 Enterprise Intelligence (Fase 1–4)
+| Agente | Endpoint Principal | Impacto |
+|---|---|---|
+| **ML Clustering Agent** | `POST /api/segmentation/cluster` | Segmentação K-means/DBSCAN/Hierarchical |
+| **Bidding Agent** | `POST /api/bidding/recommend` | -20% CPA via bid por segmento de LTV |
+| **A/B LTV Agent** | `POST /api/ltv/ab-test/create` | +25% precisão LTV via test de prompts |
+| **Fraud Detection Agent** | Auto em `/track` | Bloqueia click fraud, bots, velocity attacks |
+
 ### 🛡️ Módulos Enterprise
 | Agente | Função |
 |---|---|
@@ -63,200 +114,111 @@ O sistema é composto por **39+ agentes** coordenados pelo **Master Orchestrator
 | **Security Agent** | Rate Limiting, AES-256 e Bot Defense |
 | **Compliance Agent** | LGPD e GDPR (Consent Mode v2) |
 | **Performance Agent** | Otimização de caches e queries D1 |
-| **CRM Integration** | Sincronia D1 ↔ HubSpot/Salesforce |
-
----
-
-## 💻 INSTALAÇÃO E USO
-
-> ⚠️ **Importante:** Execute **um comando por vez** e aguarde terminar antes de rodar o próximo.
 
 ---
 
-### Passo 1 — Instalar o CLI globalmente
+## 📊 BANCO DE DADOS D1 — 21 Tabelas
 
-```bash
-npm install -g cdp-edge
 ```
-
-Verifique a instalação:
-
-```bash
-cdp-edge --version
+CORE TRACKING           ML & INTELLIGENCE        ENTERPRISE SECURITY
+─────────────────        ─────────────────────    ─────────────────────
+leads                   ml_segments               fraud_signals
+events                  ml_segment_members        fraud_alerts
+sessions                bid_recommendations       ltv_ab_tests
+webhook_events          ltv_ab_tests              ltv_ab_variations
+api_failures            ltv_ab_variations         ltv_ab_assignments
+
+VIEWS
+─────────────────────────────────────────────────
+v_active_segments          → Segmentos ML ativos com contagem de membros
+v_active_bid_recs          → Bids ativos por plataforma/vertical
+v_ab_test_performance      → Accuracy por variação de prompt
+v_fraud_dashboard          → Dashboard fraude 24h
 ```
 
 ---
 
-### Passo 2 — Criar a pasta do projeto e instalar o CDP Edge
-
-Crie a pasta do projeto, abra o terminal dentro dela e execute:
+## 🔄 FLUXO ENTERPRISE COMPLETO
 
-```bash
-cdp-edge install . --name "Nome do Projeto"
 ```
-
-**O que é criado na pasta:**
-
-| Arquivo/Pasta | Função |
-|---|---|
-| `cdp-edge/` | Skill completa — 39+ agentes, SDK, worker, templates, docs |
-| `.claude/commands/cdp.md` | Habilita o comando `/cdp` no Claude Code |
-| `CLAUDE.md` | Auto-ativação do Orchestrator ao abrir sessão |
-
----
-
-### Passo 4 — Abrir no Claude Code e ativar
-
-```bash
-claude .
-```
-
-Dentro do Claude Code, digite:
-
-```
-/cdp
-```
-
-O **Master Orchestrator** inicia e guia todo o setup — plataformas, credenciais e geração da infraestrutura.
-
----
-
-## 📋 COMANDOS DISPONÍVEIS
-
-| Comando | Descrição |
-|---------|-----------|
-| `cdp-edge install [dir]` | **Instala CDP Edge no projeto + habilita /cdp** |
-| `cdp-edge setup [dir]` | Wizard interativo de configuração |
-| `cdp-edge analyze <dir>` | Analisa páginas e detecta eventos |
-| `cdp-edge server <dir>` | Gera infraestrutura Cloudflare Workers + D1 |
-| `cdp-edge validate <file>` | Audita tracking existente |
-| `cdp-edge infra` | Guia de setup de infraestrutura Cloudflare |
-| `cdp-edge --version` | Versão instalada |
-| `cdp-edge --help` | Ajuda completa |
-
----
-
-## 📁 ESTRUTURA DO REPOSITÓRIO
-
-```text
-CDP Edge/
-├── README.md
-├── CLAUDE.md                        # Guia de desenvolvimento e padrões
-├── extracted-skill/
-│   └── tracking-events-generator/
-│       ├── agents/                  # 39+ agentes especialistas
-│       ├── cdpTrack.js              # SDK Browser (window.cdpTrack)
-│       └── micro-events.js          # Scroll, vídeo, hover, click tracking
-├── server-edge-tracker/
-│   ├── worker.js                    # Cloudflare Worker principal
-│   ├── schema.sql                   # D1 Schema (Identity Graph)
-│   └── wrangler.toml                # Bindings: D1 + Queue + KV + AI
-├── bin/                             # CLI Executável
-├── dist/commands/                   # Implementação dos comandos CLI
-├── templates/
-│   ├── install/
-│   │   ├── CLAUDE.md                # Template de auto-ativação para projetos
-│   │   └── .claude/commands/cdp.md  # Define /cdp no Claude Code
-│   ├── vsl-page.md                  # Template VSL / vídeo de vendas
-│   └── afiliado-sem-landing.md      # Template bridge page afiliado
-└── docs/
-    ├── quick-start.md               # Do zero ao deploy
-    ├── events-reference.md          # Catálogo completo de eventos
-    ├── sdk-reference.md             # API pública do cdpTrack.js
-    └── installation.md              # Instalar CDP Edge em projetos clientes
+POST /track (evento Lead)
+  │
+  ├─ [1] 🛡️ Fraud Gate (KV blocklist + velocity + heurísticas) ~2ms
+  │         ├─ score < 40  → processa normalmente
+  │         ├─ score 40-79 → processa + loga suspeito (background)
+  │         └─ score ≥ 80  → silent drop 200 + loga (background)
+  │
+  ├─ [2] 🔮 A/B LTV Testing — sorteia variação ativa (KV cache ~0ms)
+  │         └─ passa customSystemPrompt para predictLtv()
+  │
+  ├─ [3] 🧮 LTV Prediction — Workers AI Llama 3.1 8B
+  │         └─ Score 0-100 → class High/Medium/Low → valor em BRL
+  │
+  ├─ [4] 💾 D1 Writes (background via ctx.waitUntil)
+  │         ├─ upsertLtvProfile() → tabela leads
+  │         ├─ recordAbAssignment() → ltv_ab_assignments
+  │         └─ resolveDeviceGraph() → cross-device linking
+  │
+  └─ [5] 📡 CAPI dispatch (Meta + GA4 + TikTok em paralelo)
+            └─ com LTV injetado no value field
 ```
 
 ---
 
-## 📚 EXEMPLOS DE USO
-
-### Novo projeto com Claude Code
-
-```bash
-# 1. Crie a pasta do projeto e abra o terminal dentro dela
-
-# 2. Instalar CDP Edge
-cdp-edge install . --name "Landing Page Lead"
-
-# 3. Abrir no Claude Code
-claude .
-
-# 4. Ativar o Orchestrator
-/cdp
-```
-
-### Gerar apenas infraestrutura Cloudflare
+## 💻 INSTALAÇÃO E USO
 
-```bash
-cdp-edge server ./meu-worker
-cd meu-worker
-wrangler deploy
-```
+> ⚠️ **Importante:** Execute **um comando por vez** e aguarde terminar antes de rodar o próximo.
 
-### Validar tracking existente
+### Passo 1 — Instalar o CLI globalmente
 
 ```bash
-cdp-edge validate tracking.js
+npm install -g cdp-edge
 ```
 
-### Analisar projeto
+### Passo 2 — Criar a pasta do projeto
 
 ```bash
-cdp-edge analyze ./meu-projeto
+cdp-edge install . --name "Nome do Projeto"
 ```
 
----
-
-## 🔧 SOLUÇÃO DE PROBLEMAS
-
-### "cdp-edge não é reconhecido"
-
-O install não foi concluído. Execute separado e aguarde terminar:
-
-```bash
-npm install -g cdp-edge
-```
+### Passo 3 — Ativar no Claude Code
 
 ```bash
-cdp-edge --version
+claude .
 ```
-
----
-
-### "Cannot find module dist/commands/install.js"
-
-Versão antiga em cache. Reinstale:
-
-```bash
-npm uninstall -g cdp-edge
+Dentro do Claude Code:
 ```
-
-```bash
-npm install -g cdp-edge
+/cdp
 ```
 
 ---
 
-### "Permissão negada"
-
-Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
-
----
-
-### Nada foi criado na pasta após `cdp-edge install`
-
-Confirme que o terminal está aberto dentro da pasta do projeto e rode:
+## 🚀 DEPLOY COMPLETO (referência)
 
 ```bash
-cdp-edge install . --name "Nome do Projeto"
+cd server-edge-tracker
+
+# 1. Schemas D1 (todos em sequência)
+wrangler d1 execute cdp-edge-db --file=schema.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
+wrangler d1 execute cdp-edge-db --file=schema-segmentation.sql --remote  # Fase 1
+wrangler d1 execute cdp-edge-db --file=schema-bidding.sql --remote        # Fase 2
+wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote         # Fase 3
+wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote           # Fase 4
+
+# 2. Secrets
+wrangler secret put META_ACCESS_TOKEN
+wrangler secret put GA4_API_SECRET
+wrangler secret put TIKTOK_ACCESS_TOKEN
+
+# 3. Deploy
+wrangler deploy
 ```
 
 ---
 
 ## 🖱️ HUMAN-BEHAVIOR ENGINE
 
-Capturamos o que o usuário **sente** e **faz**, não apenas onde clica.
-
 | Evento | Pontuação |
 |--------|-----------|
 | Scroll 25–90% | +5 a +15 pts |
@@ -266,7 +228,45 @@ Capturamos o que o usuário **sente** e **faz**, não apenas onde clica.
 | Rage Click | -10 pts |
 | **Hot Lead (80+ pts)** | **Dispara High_Intent_Lead** |
 
-**VSL & Video Tracker:** Monitoramento nativo de retenção em YouTube, Vimeo e HTML5 — dropout heatmap incluso.
+---
+
+## 📋 TODOS OS ENDPOINTS (referência rápida)
+
+### Core Tracking
+| Rota | Método | Função |
+|---|---|---|
+| `/track` | POST | Evento principal (browser → CAPI) |
+| `/health` | GET | Smoke test completo |
+| `/webhook/hotmart` | POST | Webhook Hotmart Purchase |
+| `/webhook/kiwify` | POST | Webhook Kiwify Purchase |
+| `/webhook/ticto` | POST | Webhook Ticto Purchase |
+
+### Intelligence ML
+| Rota | Método | Função |
+|---|---|---|
+| `/api/segmentation/cluster` | POST | Clustering K-means/DBSCAN |
+| `/api/segmentation/list` | GET | Segmentos ativos |
+| `/api/segmentation/outliers` | GET | Outliers comportamentais |
+| `/api/bidding/recommend` | POST | Bid otimizado por segmento |
+| `/api/bidding/history` | GET | Histórico de bids |
+| `/api/bidding/status` | GET | Status por plataforma |
+
+### A/B Testing LTV
+| Rota | Método | Função |
+|---|---|---|
+| `/api/ltv/ab-test/create` | POST | Criar experimento |
+| `/api/ltv/ab-test/list` | GET | Listar experimentos |
+| `/api/ltv/ab-test/results` | GET | Accuracy por variação |
+| `/api/ltv/ab-test/winner` | POST | Declarar vencedor |
+
+### Fraud Detection
+| Rota | Método | Função |
+|---|---|---|
+| `/api/fraud/stats` | GET | Dashboard 24h |
+| `/api/fraud/alerts` | GET | Log de alertas |
+| `/api/fraud/blocklist` | GET | Lista bloqueada |
+| `/api/fraud/blocklist/add` | POST | Bloquear IP/fingerprint |
+| `/api/fraud/blocklist/remove` | DELETE | Desbloquear |
 
 ---
 
@@ -278,6 +278,6 @@ Capturamos o que o usuário **sente** e **faz**, não apenas onde clica.
 ---
 
 ### **CDP Edge — By Rica Soares**
-> "Dados sem inteligência são apenas ruído. No Quantum Tier, transformamos dados em ROAS."
+> "Dados sem inteligência são apenas ruído. No Quantum Tier Enterprise, transformamos dados em ROAS."
 
 © 2026 CDP Edge Premium. Todos os direitos reservados.

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

@@ -0,0 +1,196 @@
+# A/B LTV Testing Agent — CDP Edge Quantum Tier
+
+## Identidade
+
+**Agente:** A/B LTV Testing Agent
+**Papel:** Otimização Contínua de Precisão do LTV Preditivo
+**Nível:** Deus (Quantum Tier) — Enterprise-Level Fase 3
+**Versão:** 1.0.0 — 9 de Abril de 2026
+
+---
+
+## Missão
+
+Testar variações do prompt do modelo de LTV de forma automática e estatisticamente controlada,
+identificando qual formulação do sistema prompt para o Workers AI produz as predições mais
+próximas do valor real de compra — **aumentando a precisão do LTV em até +25%**.
+
+---
+
+## Posição no Fluxo do Master Orchestrator
+
+```
+Browser /track (Lead Event)
+    ↓
+LTV Prediction Call (predictLtv)
+    ↓ [se teste ativo]
+getLtvAbVariation() → sorteia variação ponderada do teste ativo
+    ↓
+Workers AI com system_prompt da variação sorteada
+    ↓
+D1: ltv_ab_assignments (registra user_id + variation_id + predicted_ltv)
+    ↓
+[quando compra chega via webhook]
+D1: ltv_ab_assignments.converted = 1 + real_revenue
+    ↓
+GET /api/ltv/ab-test/results → accuracy_score por variação
+    ↓
+POST /api/ltv/ab-test/winner → aplica vencedor ao LTV padrão
+```
+
+**Upstream (de onde recebe dados):**
+- `worker.js → predictLtv()` — ponto de interceptação do teste
+- `webhook events` — fonte verdade do revenue real para scoring
+
+**Downstream (quem consome outputs):**
+- `ltv-predictor-agent.md` → recebe o prompt vencedor para aplicar como novo default
+- `bidding-agent.md` → LTV mais preciso → bids mais precisos
+- `dashboard-agent.md` → exibe resultados dos testes no painel
+
+---
+
+## Como o A/B Test Funciona
+
+### 1. Criação do Experimento
+
+```
+POST /api/ltv/ab-test/create
+{
+  "name": "Teste: Foco Engajamento vs Intenção",
+  "min_sample": 200,
+  "variations": [
+    {
+      "name": "Controle — Prompt Original",
+      "is_control": true,
+      "weight": 0.5,
+      "system_prompt": "You are a conversion rate expert. Reply ONLY with JSON {\"adjustment\": <-10 to 10>} based on lead data. No explanation."
+    },
+    {
+      "name": "Variação B — Foco em Intenção de Compra",
+      "weight": 0.5,
+      "system_prompt": "You are a Brazilian digital marketing expert specializing in course sales. Focus on purchase intention signals. Reply ONLY with JSON {\"adjustment\": <-10 to 10>}."
+    }
+  ]
+}
+```
+
+### 2. Distribuição Automática
+
+A cada chamada de `predictLtv()` para um evento Lead, o sistema:
+1. Busca o teste ativo no D1 (com cache de 5 min no KV para evitar latência)
+2. Sorteia uma variação usando distribuição ponderada pelos `weight`
+3. Usa o `system_prompt` da variação sorteada no Workers AI
+4. Registra o assignment em `ltv_ab_assignments`
+
+### 3. Scoring Automático via Webhook
+
+Quando chega um webhook de compra (`Purchase`), o sistema:
+1. Busca o email do comprador em `ltv_ab_assignments` (por hash)
+2. Atualiza `converted = 1` e `real_revenue = valor_da_compra`
+3. Incrementa `total_purchases` e `sum_real_revenue` na variação
+
+### 4. Cálculo de Accuracy Score
+
+```
+accuracy_score =
+  1 - (ABS(avg_predicted_ltv - avg_real_revenue) / avg_real_revenue)
+  → 1.0 = predição perfeita
+  → 0.0 = predição completamente errada
+  → Valores negativos = predição muito errada
+```
+
+### 5. Declaração de Vencedor
+
+```
+POST /api/ltv/ab-test/winner
+{ "test_id": 1, "variation_id": 2 }
+→ marca variation como winner
+→ retorna o system_prompt vencedor para aplicar como novo default
+```
+
+---
+
+## Endpoints Expostos
+
+| Método | Rota | Função |
+|--------|------|--------|
+| `POST` | `/api/ltv/ab-test/create` | Cria novo experimento com variações |
+| `GET`  | `/api/ltv/ab-test/list` | Lista todos os experimentos |
+| `GET`  | `/api/ltv/ab-test/results` | Resultados de accuracy por variação |
+| `POST` | `/api/ltv/ab-test/winner` | Declara vencedor e retorna prompt |
+
+---
+
+## Variações de Prompt Predefinidas (use nos seus testes)
+
+### Variação A — Controle (atual)
+```text
+You are a conversion rate expert. Reply ONLY with a JSON object
+{"adjustment": <number between -10 and 10>} based on the lead data provided.
+No explanation.
+```
+
+### Variação B — Foco em Intenção
+```text
+You are a Brazilian infoproduct marketing expert. The lead is likely interested in
+online courses or digital products. Focus heavily on purchase_intention and
+engagement signals. Reply ONLY with JSON {"adjustment": <-10 to 10>}.
+Higher adjustment = higher purchase probability.
+```
+
+### Variação C — Foco em Dados Comportamentais
+```text
+You are a behavioral economics expert. Analyze recency, frequency, and monetary
+signals from the lead data. Score based on: (1) engagement quality, (2) time of
+conversion, (3) traffic source quality. Reply ONLY with JSON {"adjustment": <-10 to 10>}.
+```
+
+### Variação D — Foco em Geo + Canal
+```text
+You are a CRM specialist for Brazilian digital products. Brazilian leads from paid
+social (facebook/instagram) between 18h-23h BRT have highest LTV. Organic traffic
+and direct access indicate research phase. Reply ONLY with JSON {"adjustment": <-10 to 10>}.
+```
+
+---
+
+## Regras de Negócio
+
+```
+✅ SEMPRE manter o controle ativo (is_control = 1) — baseline para comparação
+✅ SEMPRE aguardar min_sample assignments antes de recomendar vencedor
+✅ SEMPRE registrar assignments mesmo quando Workers AI está indisponível
+✅ SEMPRE usar cache KV (5 min TTL) para buscar o teste ativo — evitar latência D1
+✅ SEMPRE atualizar assignments quando purchase webhook chegar
+
+❌ NUNCA declarar vencedor com < 50 conversões por variação
+❌ NUNCA rodar dois testes simultâneos (status = 'running' deve ser único)
+❌ NUNCA alterar o prompt default automaticamente — sempre exigir aprovação manual via POST /winner
+```
+
+---
+
+## Schema D1 — Tabelas
+
+```sql
+ltv_ab_tests           -- Experimentos (id, name, status, winner_id, min_sample)
+ltv_ab_variations      -- Variações de prompt por experimento
+ltv_ab_assignments     -- Registro de qual variação foi usada por lead
+v_ab_test_performance  -- VIEW: accuracy por variação com métricas consolidadas
+```
+
+---
+
+## Variáveis de Ambiente Requeridas
+
+| Variável | Binding | Descrição |
+|----------|---------|-----------|
+| `DB` | D1 | Tabelas ltv_ab_tests, ltv_ab_variations, ltv_ab_assignments |
+| `AI` | Workers AI | Executa as variações de prompt |
+| `GEO_CACHE` | KV | Cache do teste ativo (TTL: 5 min) |
+
+*(Nenhum secret externo necessário)*
+
+---
+
+*Agente criado em conformidade com a arquitetura Quantum Tier CDP Edge — 9 de Abril de 2026*