cdp-edge 1.2.2 → 1.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (141) hide show
  1. package/README.md +153 -306
  2. package/bin/cdp-edge.js +71 -61
  3. package/contracts/agent-versions.json +682 -0
  4. package/contracts/api-versions.json +372 -368
  5. package/contracts/types.ts +81 -0
  6. package/dist/commands/analyze.js +52 -52
  7. package/dist/commands/infra.js +54 -54
  8. package/dist/commands/install.js +26 -3
  9. package/dist/commands/server.js +174 -174
  10. package/dist/commands/setup.js +332 -100
  11. package/dist/commands/validate.js +248 -84
  12. package/dist/index.js +12 -12
  13. package/dist/sdk/cdpTrack.js +2095 -0
  14. package/dist/sdk/cdpTrack.min.js +64 -0
  15. package/dist/sdk/install-snippet.html +10 -0
  16. package/docs/whatsapp-ctwa.md +5 -4
  17. package/extracted-skill/tracking-events-generator/INTEGRACAO-COMPLETA.md +89 -0
  18. package/extracted-skill/tracking-events-generator/MELHORIAS-IMPLEMENTADAS.md +101 -0
  19. package/extracted-skill/tracking-events-generator/advanced-matching.js +364 -364
  20. package/extracted-skill/tracking-events-generator/agents/ab-ltv-agent.md +196 -0
  21. package/extracted-skill/tracking-events-generator/agents/ab-testing-agent.md +1 -1
  22. package/extracted-skill/tracking-events-generator/agents/attribution-agent.md +41 -41
  23. package/extracted-skill/tracking-events-generator/agents/bidding-agent.md +347 -0
  24. package/extracted-skill/tracking-events-generator/agents/bing-agent.md +40 -50
  25. package/extracted-skill/tracking-events-generator/agents/browser-tracking.md +174 -74
  26. package/extracted-skill/tracking-events-generator/agents/code-guardian-agent.md +1 -1
  27. package/extracted-skill/tracking-events-generator/agents/compliance-agent.md +25 -5
  28. package/extracted-skill/tracking-events-generator/agents/dashboard-agent.md +10 -10
  29. package/extracted-skill/tracking-events-generator/agents/database-agent.md +43 -42
  30. package/extracted-skill/tracking-events-generator/agents/debug-agent.md +22 -22
  31. package/extracted-skill/tracking-events-generator/agents/devops-agent.md +232 -0
  32. package/extracted-skill/tracking-events-generator/agents/domain-setup-agent.md +23 -9
  33. package/extracted-skill/tracking-events-generator/agents/email-agent.md +28 -1
  34. package/extracted-skill/tracking-events-generator/agents/evo-crm-agent.md +253 -0
  35. package/extracted-skill/tracking-events-generator/agents/fingerprint-agent.md +206 -1
  36. package/extracted-skill/tracking-events-generator/agents/fraud-detection-agent.md +143 -0
  37. package/extracted-skill/tracking-events-generator/agents/google-agent.md +128 -2
  38. package/extracted-skill/tracking-events-generator/agents/intelligence-agent.md +191 -31
  39. package/extracted-skill/tracking-events-generator/agents/lead-scoring-agent.md +282 -0
  40. package/extracted-skill/tracking-events-generator/agents/linkedin-agent.md +145 -34
  41. package/extracted-skill/tracking-events-generator/agents/localization-agent.md +1 -1
  42. package/extracted-skill/tracking-events-generator/agents/ltv-predictor-agent.md +24 -5
  43. package/extracted-skill/tracking-events-generator/agents/master-feedback-loop.md +81 -21
  44. package/extracted-skill/tracking-events-generator/agents/master-orchestrator.md +588 -93
  45. package/extracted-skill/tracking-events-generator/agents/match-quality-agent.md +304 -0
  46. package/extracted-skill/tracking-events-generator/agents/memory-agent.md +190 -15
  47. package/extracted-skill/tracking-events-generator/agents/meta-agent.md +10 -2
  48. package/extracted-skill/tracking-events-generator/agents/ml-clustering-agent.md +769 -0
  49. package/extracted-skill/tracking-events-generator/agents/page-analyzer.md +21 -4
  50. package/extracted-skill/tracking-events-generator/agents/performance-agent.md +41 -31
  51. package/extracted-skill/tracking-events-generator/agents/performance-optimization-agent.md +18 -8
  52. package/extracted-skill/tracking-events-generator/agents/pinterest-agent.md +14 -6
  53. package/extracted-skill/tracking-events-generator/agents/premium-tracking-intelligence-agent.md +7 -7
  54. package/extracted-skill/tracking-events-generator/agents/r2-setup-agent.md +16 -8
  55. package/extracted-skill/tracking-events-generator/agents/reddit-agent.md +15 -7
  56. package/extracted-skill/tracking-events-generator/agents/security-enterprise-agent.md +157 -48
  57. package/extracted-skill/tracking-events-generator/agents/server-tracking.md +35 -35
  58. package/extracted-skill/tracking-events-generator/agents/spotify-agent.md +15 -7
  59. package/extracted-skill/tracking-events-generator/agents/tiktok-agent.md +73 -2
  60. package/extracted-skill/tracking-events-generator/agents/tracking-plan-agent.md +104 -9
  61. package/extracted-skill/tracking-events-generator/agents/utm-agent.md +322 -0
  62. package/extracted-skill/tracking-events-generator/agents/validator-agent.md +13 -9
  63. package/extracted-skill/tracking-events-generator/agents/webhook-agent.md +112 -4
  64. package/extracted-skill/tracking-events-generator/agents/whatsapp-agent.md +58 -5
  65. package/extracted-skill/tracking-events-generator/agents/whatsapp-ctwa-setup-agent.md +26 -18
  66. package/extracted-skill/tracking-events-generator/agents/youtube-agent.md +152 -37
  67. package/extracted-skill/tracking-events-generator/anti-blocking.js +285 -285
  68. package/extracted-skill/tracking-events-generator/cdpTrack.js +642 -641
  69. package/extracted-skill/tracking-events-generator/contracts/api-versions.json +14 -10
  70. package/extracted-skill/tracking-events-generator/engagement-scoring.js +226 -226
  71. package/extracted-skill/tracking-events-generator/evals/evals.json +235 -235
  72. package/extracted-skill/tracking-events-generator/integration-test.js +497 -497
  73. package/extracted-skill/tracking-events-generator/knowledge-base.md +172 -0
  74. package/extracted-skill/tracking-events-generator/micro-events.js +992 -992
  75. package/extracted-skill/tracking-events-generator/models/lancamento-imobiliario.md +344 -0
  76. package/extracted-skill/tracking-events-generator/models/pinterest/conversions-api-template.js +144 -144
  77. package/extracted-skill/tracking-events-generator/models/pinterest/event-mappings.json +48 -48
  78. package/extracted-skill/tracking-events-generator/models/pinterest/tag-template.js +28 -28
  79. package/extracted-skill/tracking-events-generator/models/quiz-funnel.md +83 -19
  80. package/extracted-skill/tracking-events-generator/models/reddit/conversions-api-template.js +205 -205
  81. package/extracted-skill/tracking-events-generator/models/reddit/event-mappings.json +56 -56
  82. package/extracted-skill/tracking-events-generator/models/reddit/pixel-template.js +19 -19
  83. package/extracted-skill/tracking-events-generator/models/scenarios/behavior-engine.js +425 -425
  84. package/extracted-skill/tracking-events-generator/route-intent-capture.js +222 -0
  85. package/extracted-skill/tracking-events-generator/tracking.config.js +3 -3
  86. package/package.json +89 -75
  87. package/scripts/build-sdk.js +106 -0
  88. package/server-edge-tracker/.client.env.example +14 -0
  89. package/server-edge-tracker/INSTALAR.md +222 -23
  90. package/server-edge-tracker/SEGMENTATION-DOCS.md +513 -0
  91. package/server-edge-tracker/config/utm-mapping.json +64 -0
  92. package/server-edge-tracker/deploy-client.cjs +76 -0
  93. package/server-edge-tracker/index.ts +1230 -0
  94. package/server-edge-tracker/migrate-v7.sql +64 -0
  95. package/server-edge-tracker/modules/db.ts +710 -0
  96. package/server-edge-tracker/modules/dispatch/crm.ts +382 -0
  97. package/server-edge-tracker/modules/dispatch/ga4.ts +72 -0
  98. package/server-edge-tracker/modules/dispatch/meta.ts +143 -0
  99. package/server-edge-tracker/modules/dispatch/platforms.ts +255 -0
  100. package/server-edge-tracker/modules/dispatch/tiktok.ts +107 -0
  101. package/server-edge-tracker/modules/dispatch/whatsapp.ts +296 -0
  102. package/server-edge-tracker/modules/intelligence.ts +589 -0
  103. package/server-edge-tracker/modules/ml/bidding.ts +247 -0
  104. package/server-edge-tracker/modules/ml/fraud.ts +302 -0
  105. package/server-edge-tracker/modules/ml/logistic.ts +226 -0
  106. package/server-edge-tracker/modules/ml/ltv.ts +531 -0
  107. package/server-edge-tracker/modules/ml/matchquality.ts +232 -0
  108. package/server-edge-tracker/modules/ml/quiz.ts +343 -0
  109. package/server-edge-tracker/modules/ml/roas.ts +255 -0
  110. package/server-edge-tracker/modules/ml/segmentation.ts +407 -0
  111. package/server-edge-tracker/modules/nurture.ts +257 -0
  112. package/server-edge-tracker/modules/utils.ts +311 -0
  113. package/server-edge-tracker/modules/utm/utm-enricher.ts +231 -0
  114. package/server-edge-tracker/schema-ab-ltv.sql +97 -0
  115. package/server-edge-tracker/schema-bidding.sql +86 -0
  116. package/server-edge-tracker/schema-fraud.sql +90 -0
  117. package/server-edge-tracker/schema-indexes.sql +67 -0
  118. package/server-edge-tracker/schema-ltv-feedback.sql +11 -0
  119. package/server-edge-tracker/schema-quiz.sql +52 -0
  120. package/server-edge-tracker/schema-sales-engine.sql +113 -0
  121. package/server-edge-tracker/schema-segmentation.sql +219 -0
  122. package/server-edge-tracker/schema-utm.sql +82 -0
  123. package/server-edge-tracker/schema.sql +281 -265
  124. package/server-edge-tracker/types.ts +275 -0
  125. package/server-edge-tracker/wrangler.toml +140 -85
  126. package/templates/lancamento-imobiliario.md +344 -0
  127. package/templates/multi-step-checkout.md +3 -4
  128. package/templates/pinterest/conversions-api-template.js +144 -144
  129. package/templates/pinterest/event-mappings.json +48 -48
  130. package/templates/pinterest/tag-template.js +28 -28
  131. package/templates/quiz-funnel.md +83 -19
  132. package/templates/reddit/conversions-api-template.js +205 -205
  133. package/templates/reddit/event-mappings.json +56 -56
  134. package/templates/reddit/pixel-template.js +12 -39
  135. package/templates/scenarios/behavior-engine.js +45 -22
  136. package/docs/PixelBuilder-Documentacao-Completa (2).docx +0 -0
  137. package/docs/installation.md +0 -155
  138. package/docs/quick-start.md +0 -185
  139. package/extracted-skill/tracking-events-generator/agents/crm-integration-agent.md +0 -1419
  140. package/extracted-skill/tracking-events-generator/agents/intelligence-scheduling.md +0 -643
  141. package/server-edge-tracker/worker.js +0 -2574
package/README.md CHANGED
@@ -1,367 +1,214 @@
1
- # 🚀 CDP Edge - Quantum Tracking
2
-
1
+ # 🚀 CDP Edge Quantum Tracking Enterprise
3
2
  **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
4
3
 
5
- > **v1.2.2** — Cloudflare Queue + KV + Workers AI · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
6
-
7
- - **Precisão Máxima**: Meta CAPI v22.0+, GA4 MP e TikTok Events API v1.3.
8
- - **Identity Graph**: Persistência de leads e eventos via Cloudflare D1.
9
- - **Anti-Adblock**: Endpoint Same-Domain indetectável.
10
- - **Human-Behavior Engine**: Score de engajamento (0-100) em tempo real.
11
- - **Queue Retry**: Zero perda de conversão — eventos com falha reenfileirados automaticamente.
12
- - **Geo Intelligence**: Cidade, estado e CEP em todos os eventos (Workers Paid).
13
-
14
- ---
15
-
16
- ## 🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)
17
-
18
- O CDP Edge não é um "script de rastreio", é uma **Content Delivery Network (CDN)** com inteligência de dados acoplada.
19
-
20
- ```mermaid
21
- graph TD
22
- User((Usuário)) -->|Interação| SDK[cdpTrack SDK + Behavior Engine]
23
- SDK -->|Edge Fetch| Worker[Cloudflare Worker Agent]
24
- Worker -->|Identity Graph| D1[(D1 SQL Database)]
25
- Worker -->|Background Job| Queue[Cloudflare Queues]
26
- Queue -->|Server Dispatch| Meta[Meta CAPI v22.0]
27
- Queue -->|Server Dispatch| Google[GA4 / Google Ads]
28
- Queue -->|Server Dispatch| TikTok[TikTok API v1.3]
29
- D1 -->|Retention Reports| Dash[Dashboard Agent]
30
- ```
31
-
32
- ---
33
-
34
- ## 🖱 CATÁLOGO DE AGENTES ESPECIALISTAS
35
-
36
- O sistema é composto por mais de 30 agentes coordenados pelo **Master Orchestrator**. Cada um possui uma função técnica específica:
37
-
38
- ### 🧠 Núcleo de Inteligência
39
- | Agente | Função |
40
- |---|---|
41
- | **Master Orchestrator** | Coordenação central de especialistas e validação Quantum Tier. |
42
- | **Page Analyzer** | Mapeamento automático de CTAs, Forms e Nicho do site. |
43
- | **Validator Agent** | Auditoria de código, segurança e conformidade de APIs. |
44
- | **Memory Agent** | Gestão de contexto e checkpoints técnicos da sessão. |
45
- | **Intelligence Agent** | Monitoramento de atualizações de API (Meta v22.0+, etc). |
46
-
47
- ### 🚀 Despachantes de Plataforma
48
- | Agente | Especialidade |
49
- |---|---|
50
- | **Meta Agent** | Facebook Pixel + CAPI (EMQ Max). |
51
- | **Google Agent** | GA4 + Google Ads Server-Side. |
52
- | **TikTok Agent** | TikTok Pixel + Events API v1.3. |
53
- | **Plataformas Ads** | Pinterest, Reddit, Bing, LinkedIn, Spotify. |
54
- | **Browser Agent** | Geração do SDK `cdpTrack.js` lightweight. |
55
-
56
- ### 🛡️ Módulos Enterprise (Premium)
57
- | Agente | Função |
58
- |---|---|
59
- | **Attribution Agent** | Atribuição Multi-Touch de alta fidelidade. |
60
- | **Security Agent** | Rate Limiting, Criptografia AES-256 e Bot Defense. |
61
- | **Compliance Agent** | Gestão de LGPD e GDPR (Consent Mode v2). |
62
- | **Performance Opt.** | Otimização de Caches e Queries D1 SQL. |
63
- | **CRM Integration** | Sincronia D1 ↔ HubSpot/Salesforce via CRM Agent. |
4
+ > **v2.5.5** — Integração EVO CRM (OAuth2) + Sync Total de Agentes (27 de Abril de 2026) 🔧
64
5
 
65
6
  ---
66
7
 
67
- ## 💻 INSTALAÇÃO E USO
68
-
69
- ### Instalar Globalmente
8
+ ## 💻 INSTALAÇÃO
70
9
 
71
10
  ```bash
11
+ npx cdp-edge install
12
+ # ou
72
13
  npm install -g cdp-edge
73
- cdp-edge --version
14
+ cdp-edge install . --name "Nome do Projeto"
74
15
  ```
75
16
 
76
17
  ---
77
18
 
78
- ## 📋 COMANDOS DISPONÍVEIS
79
-
80
- ### `install` — Instalar CDP Edge em um projeto cliente
81
-
82
- **O comando principal.** Configura o CDP Edge em qualquer projeto e habilita o `/cdp` no Claude Code.
83
-
84
- ```bash
85
- # Instalar no diretório atual
86
- cdp-edge install .
87
-
88
- # Instalar em outro diretório
89
- cdp-edge install ./meu-projeto
90
-
91
- # Com nome do projeto
92
- cdp-edge install ./meu-projeto --name "Landing Page XYZ"
93
-
94
- # Incluir .cursorrules para Cursor IDE
95
- cdp-edge install ./meu-projeto --cursor
96
- ```
97
-
98
- **O que cria na raiz do projeto:**
99
-
100
- | Arquivo/Pasta | Função |
101
- |---|---|
102
- | `cdp-edge/` | Skill completa (agentes, SDK, worker, templates, docs) |
103
- | `.claude/commands/cdp.md` | Habilita `/cdp` no Claude Code |
104
- | `CLAUDE.md` | Auto-ativação ao abrir sessão |
105
- | `.cursorrules` | Integração Cursor IDE (flag `--cursor`) |
106
-
107
- **Fluxo após install:**
19
+ ## 🤖 MANIFESTO: EU, CDP EDGE
108
20
 
109
- ```bash
110
- # 1. Criar e instalar
111
- mkdir meu-projeto
112
- cdp-edge install ./meu-projeto
113
-
114
- # 2. Abrir no Claude Code
115
- claude ./meu-projeto
21
+ *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.*
116
22
 
117
- # 3. Ativar o Orchestrator
118
- /cdp
119
- ```
23
+ Quando um evento de Lead bate no endpoint `/track`:
24
+ 1. **Fraud Gate:** Bloqueio bots silenciosamente antes de qualquer processamento (~2ms via KV)
25
+ 2. **Quiz Scoring Engine:** Classifico as respostas do quiz com Granite 4.0 Micro — `comprador | interessado | curioso | perdido`
26
+ 3. **A/B LTV Testing:** Sorteio de prompt via KV Cache em ~0ms
27
+ 4. **LTV Predictor:** Machine Learning para qualificar intenção e gerar valor preditivo em BRL
28
+ 5. **Nurture Scheduler:** Agendar sequência de follow-up baseada na qualificação (background)
29
+ 6. **CAPI Dispatch:** Meta/GA4/TikTok recebem payload limpo com LTV e intention injetados
30
+ 7. **Sales Engine:** Semanalmente, calculo ROAS real por campanha e atualizo o seed de Lookalike com compradores confirmados
120
31
 
121
32
  ---
122
33
 
123
- ### Outros Comandos
34
+ ## 🏗️ ARQUITETURA QUANTUM ENTERPRISE
124
35
 
125
- #### `setup` — Wizard interativo
126
-
127
- ```bash
128
- cdp-edge setup
129
- cdp-edge setup ./meu-projeto
130
36
  ```
37
+ POST /track (QuizComplete)
38
+
39
+ ├─ [1] 🛡️ Fraud Gate (KV blocklist + velocity) ~2ms
40
+ ├─ [2] 🤖 Quiz Scoring Engine (Granite 4.0 Micro) → comprador/interessado/curioso/perdido
41
+ ├─ [3] 🔮 A/B LTV Sorting (KV cache ~0ms)
42
+ ├─ [4] 🧮 LTV Prediction (Granite 4.0 Micro) — intent qualificado → High LTV
43
+ ├─ [5] 💾 D1 Writes background (quiz_sessions + leads + nurture_sequences)
44
+ └─ [6] 📡 CAPI paralelo (Meta v22.0 + GA4 + TikTok v1.3)
131
45
 
132
- **O que faz:**
133
- - Pergunta plataformas (Meta, TikTok, GA4, etc.)
134
- - Pergunta tipo de produto (lead, checkout, webinar, etc.)
135
- - Gera código de tracking (Browser + Server)
136
- - Cria schema D1 SQL e configuração Wrangler
137
-
138
- ---
139
-
140
- #### `analyze` — Analisar páginas
141
-
142
- ```bash
143
- cdp-edge analyze .
144
- cdp-edge analyze ./meu-projeto
46
+ Cron semanal (Intelligence Agent):
47
+ ├─ ROAS Feedback cruza leads × purchases por campanha → bid recommendation
48
+ ├─ Nurture Queue envia D+1/D+3/D+7 para leads qualificados
49
+ ├─ Lookalike Seed compradores confirmados Meta Custom Audience
50
+ ├─ LTV Model Training regressão logística com dados reais
51
+ └─ A/B LTV Auto-winner — declara vencedor quando amostra suficiente
145
52
  ```
146
53
 
147
- **O que faz:**
148
- - Detecta CTAs e formulários
149
- - Identifica nicho do negócio
150
- - Sugere micro-eventos comportamentais
151
-
152
54
  ---
153
55
 
154
- #### `server`Gerar infraestrutura Cloudflare
56
+ ## 📊 BANCO DE DADOS D1 31 Tabelas + 12 VIEWs
155
57
 
156
- ```bash
157
- cdp-edge server .
158
- cdp-edge server ./meu-worker
159
58
  ```
59
+ CORE TRACKING ML & INTELLIGENCE SALES ENGINE
60
+ ────────────── ───────────────────── ──────────────────
61
+ leads ml_segments roas_reports
62
+ events ml_segment_members nurture_sequences
63
+ sessions bid_recommendations lookalike_seeds
64
+ webhook_events ltv_ab_tests quiz_sessions
65
+ api_failures ltv_ab_variations
66
+ device_graph ltv_ab_assignments
67
+ user_profiles fraud_signals
68
+ intelligence_logs fraud_alerts
69
+ messaging_history match_quality_logs
70
+ automation_rules utm_mappings
71
+ edge_fingerprints
160
72
 
161
- **Arquivos gerados:**
162
- - `worker.js` — Cloudflare Worker completo
163
- - `schema.sql` — Schema D1
164
- - `wrangler.toml` — Configuração Wrangler
165
-
166
- ---
167
-
168
- #### `validate` — Auditar tracking existente
169
-
170
- ```bash
171
- cdp-edge validate tracking.js
73
+ VIEWS (12)
74
+ ──────────────────────────────────────────────────────────────────
75
+ v_active_segments v_active_bid_recs
76
+ v_ab_test_performance v_fraud_dashboard
77
+ v_quiz_qualification_summary v_quiz_dimension_impact
78
+ v_roas_latest v_nurture_pending
79
+ v_nurture_stats v_quiz_session_summary
80
+ v_leads_segmented v_ltv_feedback
172
81
  ```
173
82
 
174
- **O que verifica:**
175
- - `event_id` para deduplicação
176
- - SHA256 para PII (e-mail, telefone)
177
- - Detecção de GTM/Stape
178
- - Conformidade com APIs
179
-
180
83
  ---
181
84
 
182
- #### `infra` Guia de infraestrutura Cloudflare
85
+ ## 🧠 CATÁLOGO DE MÓDULOS ML
183
86
 
184
- ```bash
185
- cdp-edge infra
186
- ```
87
+ | Módulo | Arquivo | Função |
88
+ |---|---|---|
89
+ | **Quiz Scoring** | `modules/ml/quiz.ts` | Análise dimensional automática das respostas |
90
+ | **LTV Prediction** | `modules/ml/ltv.ts` | Score 0-100 + valor BRL via Granite + A/B test |
91
+ | **Fraud Gate** | `modules/ml/fraud.ts` | Detecção de bots e fraude na borda |
92
+ | **ML Clustering** | `modules/ml/segmentation.ts` | K-means vetorial com bge-m3 embeddings |
93
+ | **Bidding ML** | `modules/ml/bidding.ts` | Recomendação de bid por segmento × plataforma |
94
+ | **ROAS Feedback** | `modules/ml/roas.ts` | ROAS real por campanha, alimenta bidding |
95
+ | **Match Quality** | `modules/ml/matchquality.ts` | Score de qualidade de dados para CAPI |
96
+ | **Logistic** | `modules/ml/logistic.ts` | Regressão logística para LTV model treinável |
97
+ | **Nurture Engine** | `modules/nurture.ts` | Sequências automáticas pós-qualificação |
187
98
 
188
99
  ---
189
100
 
190
- ## 🔄 CICLO DE VIDA DO SETUP (/setup)
191
-
192
- 1. **FASE 0 — Checkpoint:** Sincronização de contexto via Memory Agent.
193
- 2. **FASE 1 — Análise:** Detecção automática de nicho e estrutura da página.
194
- 3. **FASE 2 — Mapeamento:** Identificação de CTAs, Forms e Gateways de venda.
195
- 4. **FASE 3 — Geração:** Código paralelo para Browser (`cdpTrack`), Worker e D1 SQL.
196
- 5. **FASE 4 — Auditoria:** Validação rigorosa e correções automáticas (Validator).
197
- 6. **FASE 5 — Deploy:** Publicação instantânea via `wrangler deploy`.
198
-
199
- ---
101
+ ## 🧠 CATÁLOGO DE AGENTES
200
102
 
201
- ## 📁 ESTRUTURA DO REPOSITÓRIO
202
-
203
- ```text
204
- CDP Edge/
205
- ├── README.md # Você está aqui.
206
- ├── CLAUDE.md # Guia de desenvolvimento e padrões.
207
- ├── extracted-skill/ # O motor da IA (Agentes e Knowledge Base).
208
- │ └── tracking-events-generator/
209
- │ ├── agents/ # 39+ agentes especialistas
210
- │ ├── cdpTrack.js # SDK Browser (window.cdpTrack)
211
- │ └── micro-events.js # Scroll, vídeo, hover, click tracking
212
- ├── server-edge-tracker/ # Cloudflare Worker (Infra de Borda)
213
- │ ├── worker.js # Handler principal + Queue consumer
214
- │ ├── schema.sql # D1 Schema (Identity Graph)
215
- │ └── wrangler.toml # Bindings: D1 + Queue + KV + AI
216
- ├── bin/ # CLI Executável (cdp-edge)
217
- ├── dist/commands/ # Implementação dos comandos CLI
218
- │ └── install.js # cdp-edge install
219
- ├── templates/
220
- │ ├── install/
221
- │ │ ├── CLAUDE.md # Template de auto-ativação para projetos
222
- │ │ └── .claude/commands/
223
- │ │ └── cdp.md # Define /cdp no Claude Code
224
- │ ├── vsl-page.md # Template VSL / vídeo de vendas
225
- │ └── afiliado-sem-landing.md # Template bridge page afiliado
226
- └── docs/
227
- ├── quick-start.md # Do zero ao deploy
228
- ├── events-reference.md # Catálogo completo de eventos
229
- ├── sdk-reference.md # API pública do cdpTrack.js
230
- └── installation.md # Instalar CDP Edge em projetos clientes
231
- ```
103
+ | Categoria | Agente | Função |
104
+ |---|---|---|
105
+ | Orquestração | `master-orchestrator.md` | Coordena todo o setup |
106
+ | Análise | `page-analyzer.md` | Detecta CTAs, forms e nicho |
107
+ | Plataformas | `meta-agent.md`, `google-agent.md`, `tiktok-agent.md`... | Especialistas por plataforma |
108
+ | Infra | `server-tracking.md`, `devops-agent.md` | Arquitetura Cloudflare |
109
+ | Enterprise | `ml-clustering-agent.md` | Segmentação dinâmica ML |
110
+ | Enterprise | `bidding-agent.md` | Bids ML por segmento |
111
+ | Enterprise | `ab-ltv-agent.md` | A/B testing de prompts LTV |
112
+ | Enterprise | `fraud-detection-agent.md` | Detecção de fraude na borda |
113
+ | Infraestrutura | `evo-crm-agent.md` | Roteamento de leads p/ EVO CRM (OAuth2) |
114
+ | Monitoramento | `intelligence-agent.md` | Cron ROAS, Nurture, Lookalike, LTV training |
232
115
 
233
116
  ---
234
117
 
235
- ## 📚 EXEMPLOS DE USO
236
-
237
- ### Cenário 1: Novo projeto com Claude Code
238
-
239
- ```bash
240
- # 1. Criar projeto e instalar CDP Edge
241
- mkdir landing-page-lead
242
- cdp-edge install ./landing-page-lead --name "Landing Page Lead"
118
+ ## 📋 TODOS OS ENDPOINTS
243
119
 
244
- # 2. Abrir no Claude Code
245
- claude ./landing-page-lead
120
+ ### Core
121
+ | Rota | Método | Função |
122
+ |---|---|---|
123
+ | `/track` | POST | Evento principal — Fraud Gate → Quiz Scoring → LTV → CAPI |
124
+ | `/health` | GET | Smoke test D1 + KV + AI |
125
+ | `/webhook/ticto` | POST | Purchase webhook (HMAC) |
126
+ | `/webhook/whatsapp` | POST | Webhook Meta WhatsApp → CRM (Evolution/EVO) |
127
+ | `/export/customer-match` | GET | Export leads para Google Ads |
128
+ | `/validate-install` | GET | Diagnóstico pós-deploy |
246
129
 
247
- # 3. Ativar o Orchestrator
248
- /cdp
249
- # → CDP Edge inicia, faz perguntas, gera toda a infraestrutura
250
- ```
130
+ ### ML Clustering (Fase 1)
131
+ | Rota | Método | Função |
132
+ |---|---|---|
133
+ | `/api/segmentation/cluster` | POST | K-means vetorial (bge-m3 + Granite) |
134
+ | `/api/segmentation/list` | GET | Segmentos ativos |
135
+ | `/api/segmentation/outliers` | GET | Outliers comportamentais |
136
+ | `/api/segmentation/update` | PUT | Atualiza metadados |
137
+
138
+ ### Bidding (Fase 2)
139
+ | Rota | Método | Função |
140
+ |---|---|---|
141
+ | `/api/bidding/recommend` | POST | Bid por segmento × plataforma |
142
+ | `/api/bidding/history` | GET | Histórico de recomendações |
143
+ | `/api/bidding/status` | GET | Snapshot atual |
144
+
145
+ ### A/B LTV (Fase 3)
146
+ | Rota | Método | Função |
147
+ |---|---|---|
148
+ | `/api/ltv/ab-test/create` | POST | Cria experimento |
149
+ | `/api/ltv/ab-test/list` | GET | Lista experimentos |
150
+ | `/api/ltv/ab-test/results` | GET | Accuracy por variação |
151
+ | `/api/ltv/ab-test/winner` | POST | Declara vencedor |
251
152
 
252
- ### Cenário 2: Apenas Infraestrutura Cloudflare
153
+ ### Fraud (Fase 4)
154
+ | Rota | Método | Função |
155
+ |---|---|---|
156
+ | `/api/fraud/stats` | GET | Dashboard 24h |
157
+ | `/api/fraud/alerts` | GET | Log de sinais |
158
+ | `/api/fraud/blocklist` | GET | IPs bloqueados |
159
+ | `/api/fraud/blocklist/add` | POST | Bloquear |
160
+ | `/api/fraud/blocklist/remove` | DELETE | Desbloquear |
161
+
162
+ ---
163
+
164
+ ## 🚀 DEPLOY COMPLETO
253
165
 
254
166
  ```bash
255
- # 1. Gerar infraestrutura Worker + D1
256
- cdp-edge server ./meu-worker
257
-
258
- # 2. Deploy
259
- cd meu-worker
260
- wrangler deploy
261
-
262
- # 3. Configurar secrets
167
+ cd server-edge-tracker
168
+
169
+ # Schemas D1 (ordem correta — todos idempotentes)
170
+ wrangler d1 execute cdp-edge-db --file=schema.sql --remote
171
+ wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
172
+ wrangler d1 execute cdp-edge-db --file=schema-segmentation.sql --remote
173
+ wrangler d1 execute cdp-edge-db --file=schema-bidding.sql --remote
174
+ wrangler d1 execute cdp-edge-db --file=schema-ab-ltv.sql --remote
175
+ wrangler d1 execute cdp-edge-db --file=schema-fraud.sql --remote
176
+ wrangler d1 execute cdp-edge-db --file=schema-indexes.sql --remote
177
+ wrangler d1 execute cdp-edge-db --file=migrate-v7.sql --remote
178
+ wrangler d1 execute cdp-edge-db --file=schema-ltv-feedback.sql --remote
179
+ wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
180
+ wrangler d1 execute cdp-edge-db --file=schema-quiz.sql --remote
181
+ wrangler d1 execute cdp-edge-db --file=schema-sales-engine.sql --remote
182
+
183
+ # Secrets (nunca em arquivos — sempre via wrangler secret put)
263
184
  wrangler secret put META_ACCESS_TOKEN
185
+ wrangler secret put GA4_API_SECRET
264
186
  wrangler secret put TIKTOK_ACCESS_TOKEN
265
- ```
266
-
267
- ### Cenário 3: Validar Código Existente
268
-
269
- ```bash
270
- cdp-edge validate tracking.js
187
+ wrangler secret put EVO_CRM_BASE_URL
188
+ wrangler secret put EVO_CRM_CLIENT_ID
189
+ wrangler secret put EVO_CRM_CLIENT_SECRET
190
+ wrangler secret put EVO_CRM_INBOX_ID
271
191
 
272
- # Status: PASS | Score: 85/100
273
- # ⚠ Hashing não detectado para PII
274
- ```
275
-
276
- ### Cenário 4: Análise de Projeto
277
-
278
- ```bash
279
- cdp-edge analyze ./meu-projeto-web
280
-
281
- # 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
282
- # 🎯 Nicho identificado: E-commerce
192
+ # Deploy
193
+ wrangler deploy
283
194
  ```
284
195
 
285
196
  ---
286
197
 
287
- ## COMANDOS RÁPIDOS (CLI)
288
-
289
- | Comando | Descrição |
290
- |---------|-----------|
291
- | `cdp-edge install [dir]` | **Instala CDP Edge + habilita /cdp no Claude Code** |
292
- | `cdp-edge setup [dir]` | Configuração guiada (wizard) |
293
- | `cdp-edge analyze <dir>` | Análise de páginas |
294
- | `cdp-edge server <dir>` | Gerar infraestrutura Workers + D1 |
295
- | `cdp-edge validate <file>` | Auditoria de código |
296
- | `cdp-edge infra` | Guia Cloudflare |
297
- | `cdp-edge --help` | Ajuda completa |
298
- | `cdp-edge --version` | Versão instalada |
299
-
300
- ---
301
-
302
- ## 🔧 SOLUÇÃO DE PROBLEMAS
303
-
304
- ### Erro: "Cannot find module dist/commands/install.js"
305
-
306
- O npm ainda tem a versão antiga em cache. Instale direto do GitHub para ter a versão mais recente:
307
-
308
- ```bash
309
- npm uninstall -g cdp-edge
310
- npm install -g github:ricardosoli777/CDP-Edge-Premium
311
- cdp-edge --version
312
- ```
313
-
314
- ### Erro: "cdp-edge não é reconhecido"
198
+ ## 🗺️ GRAPHIFY Navegando o Código
315
199
 
316
200
  ```bash
317
- # Instalar globalmente
318
- npm install -g cdp-edge
319
-
320
- # Ou instalar direto do repositório
321
- npm install -g github:ricardosoli777/CDP-Edge-Premium
201
+ /graphify . # gera o mapa
202
+ /graphify query "como funciona o quiz scoring?" # exploração BFS
203
+ /graphify query "nurture engine → meta audience" # exploração DFS
204
+ /graphify path "quiz_answers" "meta capi" # menor caminho
322
205
  ```
323
206
 
324
- ### Erro: "Permissão negada ao escrever arquivos"
325
-
326
- Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
327
-
328
- ### Erro: "Módulo não encontrado" (outros módulos)
329
-
330
- ```bash
331
- npm cache clean --force
332
- npm uninstall -g cdp-edge
333
- npm install -g cdp-edge
334
- ```
335
-
336
- ---
337
-
338
- ## 🖱️ HUMAN-BEHAVIOR ENGINE (O MOTOR DE INTENÇÃO)
339
-
340
- A joia da coroa do CDP Edge. Capturamos o que o usuário **sente** e **faz**, e não apenas onde ele clica.
341
-
342
- ### 🌡️ Engagement Scoring Engine (0-100)
343
- Cada ação do usuário soma (ou subtrai) pontos em tempo real:
344
- * **Scroll (25-90%)**: +5 a +15 pontos.
345
- * **VSL Watch (25-100%)**: +10 a +50 pontos.
346
- * **Copy Intent**: +20 pontos ao copiar cupons ou chaves PIX.
347
- * **Form Interaction**: +10 pontos por campo preenchido.
348
- * **Rage Click**: -10 pontos (sinal de frustração técnica).
349
- * **Gatilho Hot Lead**: Ao atingir **80 pontos**, disparar `High_Intent_Lead` para as plataformas.
350
-
351
- ### 🎥 VSL & Video Tracker
352
- Monitoramento nativo de retenção em vídeos YouTube e Vimeo sem necessidade de scripts externos pesados.
353
-
354
- ---
355
-
356
- ## 📞 SUPORTE
357
-
358
- - **Documentação**: Verifique `CLAUDE.md` para padrões de desenvolvimento
359
- - **Issues**: https://github.com/ricardosoli777/CDP-Edge-Premium/issues
360
- - **Releases**: https://github.com/ricardosoli777/CDP-Edge-Premium/releases
207
+ > Changelog completo [CHANGELOG.md](./CHANGELOG.md)
361
208
 
362
209
  ---
363
210
 
364
211
  ### **CDP Edge — By Rica Soares**
365
- > "Dados sem inteligência são apenas ruído. No Quantum Tier, transformamos dados em ROAS."
212
+ > "Dados sem inteligência são apenas ruído. No Quantum Tier Enterprise, transformamos dados em ROAS."
366
213
 
367
214
  © 2026 CDP Edge Premium. Todos os direitos reservados.
package/bin/cdp-edge.js CHANGED
@@ -1,61 +1,71 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * CDP Edge CLI - Entry Point
5
- * Sistema multi-agente para tracking digital Quantum Tier
6
- */
7
-
8
- import { Command } from 'commander';
9
- import { runSetupWizard } from '../dist/commands/setup.js';
10
- import { runAnalyze } from '../dist/commands/analyze.js';
11
- import { runServer } from '../dist/commands/server.js';
12
- import { runValidate } from '../dist/commands/validate.js';
13
- import { runInfra } from '../dist/commands/infra.js';
14
- import { runInstall } from '../dist/commands/install.js';
15
-
16
- const program = new Command();
17
-
18
- program
19
- .name('cdp-edge')
20
- .description('CDP Edge Quantum Tier - Sistema multi-agente para tracking digital Cloudflare Native')
21
- .version('1.2.2');
22
-
23
- // Comando padrão (wizard interativo)
24
- program
25
- .argument('[dir]', 'Diretório do projeto', '.')
26
- .action(runSetupWizard);
27
-
28
- // Comandos específicos
29
- program
30
- .command('setup [dir]')
31
- .description('Configuração completa com wizard interativo')
32
- .action(runSetupWizard);
33
-
34
- program
35
- .command('analyze <dir>')
36
- .description('Analisa páginas e detecta eventos de tracking')
37
- .action(runAnalyze);
38
-
39
- program
40
- .command('server <dir>')
41
- .description('Gera apenas infraestrutura Cloudflare Workers + D1')
42
- .action(runServer);
43
-
44
- program
45
- .command('validate <file>')
46
- .description('Audita tracking existente')
47
- .action(runValidate);
48
-
49
- program
50
- .command('infra')
51
- .description('Mostra guia de setup de infraestrutura Cloudflare')
52
- .action(runInfra);
53
-
54
- program
55
- .command('install [dir]')
56
- .description('Instala o CDP Edge em um projeto cliente e habilita /cdp no Claude Code')
57
- .option('-n, --name <name>', 'Nome do projeto')
58
- .option('--cursor', 'Criar .cursorrules para Cursor IDE')
59
- .action(runInstall);
60
-
61
- program.parse(process.argv);
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * CDP Edge CLI - Entry Point
5
+ * Sistema multi-agente para tracking digital Quantum Tier
6
+ */
7
+
8
+ import fs from 'fs';
9
+ import path from 'path';
10
+ import { fileURLToPath } from 'url';
11
+ import { Command } from 'commander';
12
+ import { runSetupWizard } from '../dist/commands/setup.js';
13
+ import { runAnalyze } from '../dist/commands/analyze.js';
14
+ import { runServer } from '../dist/commands/server.js';
15
+ import { runValidate } from '../dist/commands/validate.js';
16
+ import { runInfra } from '../dist/commands/infra.js';
17
+ import { runInstall } from '../dist/commands/install.js';
18
+
19
+ // Ler versão do package.json
20
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
21
+ const packageJsonPath = path.join(__dirname, '..', 'package.json');
22
+ const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
23
+ const CDP_VERSION = packageJson.version;
24
+
25
+ const program = new Command();
26
+
27
+ program
28
+ .name('cdp-edge')
29
+ .description('CDP Edge Quantum Tier - Sistema multi-agente para tracking digital Cloudflare Native')
30
+ .version(CDP_VERSION);
31
+
32
+ // Comando padrão (wizard interativo)
33
+ program
34
+ .argument('[dir]', 'Diretório do projeto', '.')
35
+ .action(runSetupWizard);
36
+
37
+ // Comandos específicos
38
+ program
39
+ .command('setup [dir]')
40
+ .description('Configuração completa com wizard interativo')
41
+ .action(runSetupWizard);
42
+
43
+ program
44
+ .command('analyze <dir>')
45
+ .description('Analisa páginas e detecta eventos de tracking')
46
+ .action(runAnalyze);
47
+
48
+ program
49
+ .command('server <dir>')
50
+ .description('Gera apenas infraestrutura Cloudflare Workers + D1')
51
+ .action(runServer);
52
+
53
+ program
54
+ .command('validate <url>')
55
+ .description('Diagnóstico pós-deploy — verifica se o tracking está funcionando de ponta a ponta')
56
+ .option('--worker <url>', 'URL do Worker se diferente do site (ex: https://worker.meusite.workers.dev)')
57
+ .action(runValidate);
58
+
59
+ program
60
+ .command('infra')
61
+ .description('Mostra guia de setup de infraestrutura Cloudflare')
62
+ .action(runInfra);
63
+
64
+ program
65
+ .command('install [dir]')
66
+ .description('Instala o CDP Edge em um projeto cliente e habilita /cdp no Claude Code')
67
+ .option('-n, --name <name>', 'Nome do projeto')
68
+ .option('--cursor', 'Criar .cursorrules para Cursor IDE')
69
+ .action(runInstall);
70
+
71
+ program.parse(process.argv);