cdp-edge 1.11.0 → 1.12.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.
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
4
4
 
5
- > **v1.1.0** — Cloudflare Queue + KV + Workers AI · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
5
+ > **v1.2.2** — Cloudflare Queue + KV + Workers AI · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
6
6
 
7
7
  - **Precisão Máxima**: Meta CAPI v22.0+, GA4 MP e TikTok Events API v1.3.
8
8
  - **Identity Graph**: Persistência de leads e eventos via Cloudflare D1.
@@ -64,129 +64,127 @@ O sistema é composto por mais de 30 agentes coordenados pelo **Master Orchestra
64
64
 
65
65
  ---
66
66
 
67
- ## 💻 INSTALAÇÃO E USO (POWERShell)
67
+ ## 💻 INSTALAÇÃO E USO
68
68
 
69
- ### Opção 1: Instalar Globalmente
69
+ ### Instalar Globalmente
70
70
 
71
- ```powershell
72
- # 1. Instalar o pacote
71
+ ```bash
73
72
  npm install -g cdp-edge
74
-
75
- # 2. Verificar instalação
76
73
  cdp-edge --version
77
-
78
- # 3. Executar
79
- cdp-edge
80
74
  ```
81
75
 
82
- ### Opção 2: Usar via npx (sem instalar)
76
+ ---
77
+
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
83
90
 
84
- ```powershell
85
- # Executar direto
86
- npx cdp-edge
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
87
96
  ```
88
97
 
89
- ---
98
+ **O que cria na raiz do projeto:**
90
99
 
91
- ## 📋 COMANDOS DISPONÍVEIS
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`) |
92
106
 
93
- ### Comando Único (Wizard Interativo)
107
+ **Fluxo após install:**
94
108
 
95
- ```powershell
96
- # Inicia wizard completo no diretório atual
97
- cdp-edge
109
+ ```bash
110
+ # 1. Criar e instalar
111
+ mkdir meu-projeto
112
+ cdp-edge install ./meu-projeto
98
113
 
99
- # Ou em outro diretório
100
- cdp-edge "C:\caminho\do\projeto"
114
+ # 2. Abrir no Claude Code
115
+ claude ./meu-projeto
116
+
117
+ # 3. Ativar o Orchestrator
118
+ /cdp
101
119
  ```
102
120
 
103
- ### Comandos Específicos
121
+ ---
122
+
123
+ ### Outros Comandos
104
124
 
105
- #### 1. Setup Completo
125
+ #### `setup` Wizard interativo
106
126
 
107
- ```powershell
108
- # Configuração interativa completa
127
+ ```bash
109
128
  cdp-edge setup
110
-
111
- # Setup em diretório específico
112
- cdp-edge setup "C:\meu-projeto"
129
+ cdp-edge setup ./meu-projeto
113
130
  ```
114
131
 
115
132
  **O que faz:**
116
133
  - Pergunta plataformas (Meta, TikTok, GA4, etc.)
117
134
  - Pergunta tipo de produto (lead, checkout, webinar, etc.)
118
- - Analisa arquivos do projeto
119
135
  - Gera código de tracking (Browser + Server)
120
- - Cria schema D1 SQL
121
- - Gera configuração Wrangler
136
+ - Cria schema D1 SQL e configuração Wrangler
122
137
 
123
138
  ---
124
139
 
125
- #### 2. Analisar Páginas
140
+ #### `analyze` Analisar páginas
126
141
 
127
- ```powershell
128
- # Analisar diretório atual
142
+ ```bash
129
143
  cdp-edge analyze .
130
-
131
- # Analisar projeto específico
132
- cdp-edge analyze "C:\caminho\do\projeto"
144
+ cdp-edge analyze ./meu-projeto
133
145
  ```
134
146
 
135
147
  **O que faz:**
136
- - Lê todos os arquivos HTML/JS
137
148
  - Detecta CTAs e formulários
138
149
  - Identifica nicho do negócio
139
150
  - Sugere micro-eventos comportamentais
140
151
 
141
152
  ---
142
153
 
143
- #### 3. Gerar Infraestrutura Server
154
+ #### `server` Gerar infraestrutura Cloudflare
144
155
 
145
- ```powershell
146
- # Gerar Worker + D1 no diretório atual
156
+ ```bash
147
157
  cdp-edge server .
148
-
149
- # Gerar em diretório específico
150
- cdp-edge server "C:\meu-worker-cloudflare"
158
+ cdp-edge server ./meu-worker
151
159
  ```
152
160
 
153
161
  **Arquivos gerados:**
154
- - `worker.js` - Cloudflare Worker completo
155
- - `schema.sql` - Schema D1 para persistência
156
- - `wrangler.toml` - Configuração do Wrangler
162
+ - `worker.js` Cloudflare Worker completo
163
+ - `schema.sql` Schema D1
164
+ - `wrangler.toml` Configuração Wrangler
157
165
 
158
166
  ---
159
167
 
160
- #### 4. Validar Tracking Existente
168
+ #### `validate` Auditar tracking existente
161
169
 
162
- ```powershell
163
- # Validar arquivo específico
164
- cdp-edge validate "C:\meu-projeto\tracking.js"
170
+ ```bash
171
+ cdp-edge validate tracking.js
165
172
  ```
166
173
 
167
174
  **O que verifica:**
168
- - Presença de `event_id` (deduplicação)
169
- - Hashing SHA256 para PII (e-mail, telefone)
170
- - Detecção de GTM/Stape (avisa para migrar)
171
- - Conformidade com APIs mais recentes
175
+ - `event_id` para deduplicação
176
+ - SHA256 para PII (e-mail, telefone)
177
+ - Detecção de GTM/Stape
178
+ - Conformidade com APIs
172
179
 
173
180
  ---
174
181
 
175
- #### 5. Guia de Infraestrutura
182
+ #### `infra` Guia de infraestrutura Cloudflare
176
183
 
177
- ```powershell
178
- # Mostra guia passo a passo do zero ao deploy
184
+ ```bash
179
185
  cdp-edge infra
180
186
  ```
181
187
 
182
- **Cobre:**
183
- - Criação de conta Cloudflare
184
- - Instalação Wrangler CLI
185
- - Configuração D1 Database
186
- - Setup de secrets (API tokens)
187
- - Deploy via `wrangler deploy`
188
- - Configuração de domínio e rotas
189
-
190
188
  ---
191
189
 
192
190
  ## 🔄 CICLO DE VIDA DO SETUP (/setup)
@@ -204,93 +202,84 @@ cdp-edge infra
204
202
 
205
203
  ```text
206
204
  CDP Edge/
207
- ├── README.md # Você está aqui. A bíblia do sistema.
205
+ ├── README.md # Você está aqui.
208
206
  ├── CLAUDE.md # Guia de desenvolvimento e padrões.
209
207
  ├── extracted-skill/ # O motor da IA (Agentes e Knowledge Base).
210
208
  │ └── tracking-events-generator/
211
- │ ├── agents/ # 35+ agentes especialistas
212
- │ ├── models/ # Checklists de cenários de negócio
209
+ │ ├── agents/ # 39+ agentes especialistas
213
210
  │ ├── cdpTrack.js # SDK Browser (window.cdpTrack)
214
- │ └── knowledge-base.md # Enciclopédia de APIs e Schemas
211
+ │ └── micro-events.js # Scroll, vídeo, hover, click tracking
215
212
  ├── server-edge-tracker/ # Cloudflare Worker (Infra de Borda)
216
213
  │ ├── worker.js # Handler principal + Queue consumer
217
214
  │ ├── schema.sql # D1 Schema (Identity Graph)
218
215
  │ └── wrangler.toml # Bindings: D1 + Queue + KV + AI
219
216
  ├── bin/ # CLI Executável (cdp-edge)
220
- └── templates/ # Templates por cenário de negócio
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
221
231
  ```
222
232
 
223
233
  ---
224
234
 
225
- ## 📚 EXEMPLOS DE USO POWERShell
226
-
227
- ### Cenário 1: Setup Completo para Landing Page
235
+ ## 📚 EXEMPLOS DE USO
228
236
 
229
- ```powershell
230
- # 1. Navegar para o projeto
231
- cd "C:\Users\comer\meus-projetos\landing-page-lead"
237
+ ### Cenário 1: Novo projeto com Claude Code
232
238
 
233
- # 2. Executar setup
234
- cdp-edge setup
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"
235
243
 
236
- # 3. Responder perguntas do wizard
237
- # - Plataformas: [ ] Meta (Facebook/Instagram)
238
- # - Tipo: Lead Capture (Formulário)
239
- # - Server-side: [x] Sim
244
+ # 2. Abrir no Claude Code
245
+ claude ./landing-page-lead
240
246
 
241
- # 4. Arquivos gerados automaticamente:
242
- # - cdpTrack.js (Browser SDK)
243
- # - tracking.config.js
244
- # - worker.js (Cloudflare Worker)
245
- # - schema.sql (D1 Database)
247
+ # 3. Ativar o Orchestrator
248
+ /cdp
249
+ # → CDP Edge inicia, faz perguntas, gera toda a infraestrutura
246
250
  ```
247
251
 
248
252
  ### Cenário 2: Apenas Infraestrutura Cloudflare
249
253
 
250
- ```powershell
251
- # 1. Criar diretório para o Worker
252
- New-Item -Path "C:\meu-worker-cloudflare" -ItemType Directory
253
- cd "C:\meu-worker-cloudflare"
254
-
255
- # 2. Gerar infraestrutura
256
- cdp-edge server .
254
+ ```bash
255
+ # 1. Gerar infraestrutura Worker + D1
256
+ cdp-edge server ./meu-worker
257
257
 
258
- # 3. Deploy com Wrangler
258
+ # 2. Deploy
259
+ cd meu-worker
259
260
  wrangler deploy
260
261
 
261
- # 4. Configurar secrets
262
+ # 3. Configurar secrets
262
263
  wrangler secret put META_ACCESS_TOKEN
263
264
  wrangler secret put TIKTOK_ACCESS_TOKEN
264
265
  ```
265
266
 
266
- ### Cenário 3: Validar Código Existe
267
+ ### Cenário 3: Validar Código Existente
267
268
 
268
- ```powershell
269
- # 1. Validar arquivo de tracking
270
- cdp-edge validate "C:\meu-projeto\tracking.js"
269
+ ```bash
270
+ cdp-edge validate tracking.js
271
271
 
272
- # 2. Ver relatório
273
- # Status: PASS
274
- # Score: 85/100
275
- #
276
- # ⚠️ Avisos:
277
- # └─ Hashing não detectado para PII
272
+ # Status: PASS | Score: 85/100
273
+ # ⚠ Hashing não detectado para PII
278
274
  ```
279
275
 
280
276
  ### Cenário 4: Análise de Projeto
281
277
 
282
- ```powershell
283
- # 1. Analisar projeto completo
284
- cdp-edge analyze "C:\meu-projeto-web"
285
-
286
- # 2. Resultado
287
- # 📊 Eventos detectados:
288
- # leads: 2
289
- # purchases: 1
290
- # views: 3
291
- # custom: 0
292
- #
293
- # 🎯 Nicho identificado: E-commerce (SaaS)
278
+ ```bash
279
+ cdp-edge analyze ./meu-projeto-web
280
+
281
+ # 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
282
+ # 🎯 Nicho identificado: E-commerce
294
283
  ```
295
284
 
296
285
  ---
@@ -299,8 +288,8 @@ cdp-edge analyze "C:\meu-projeto-web"
299
288
 
300
289
  | Comando | Descrição |
301
290
  |---------|-----------|
302
- | `cdp-edge` | Wizard interativo completo |
303
- | `cdp-edge setup [dir]` | Configuração guiada |
291
+ | `cdp-edge install [dir]` | **Instala CDP Edge + habilita /cdp no Claude Code** |
292
+ | `cdp-edge setup [dir]` | Configuração guiada (wizard) |
304
293
  | `cdp-edge analyze <dir>` | Análise de páginas |
305
294
  | `cdp-edge server <dir>` | Gerar infraestrutura Workers + D1 |
306
295
  | `cdp-edge validate <file>` | Auditoria de código |
@@ -312,34 +301,35 @@ cdp-edge analyze "C:\meu-projeto-web"
312
301
 
313
302
  ## 🔧 SOLUÇÃO DE PROBLEMAS
314
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
+
315
314
  ### Erro: "cdp-edge não é reconhecido"
316
315
 
317
- ```powershell
318
- # Solução 1: Instalar globalmente
316
+ ```bash
317
+ # Instalar globalmente
319
318
  npm install -g cdp-edge
320
319
 
321
- # Solução 2: Usar npx
322
- npx cdp-edge
323
-
324
- # Solução 3: Verificar PATH
325
- $env:Path -split ';' | Where-Object { $_ -like '*node*' }
320
+ # Ou instalar direto do repositório
321
+ npm install -g github:ricardosoli777/CDP-Edge-Premium
326
322
  ```
327
323
 
328
324
  ### Erro: "Permissão negada ao escrever arquivos"
329
325
 
330
- ```powershell
331
- # Executar PowerShell como Administrador
332
- # 1. Clique com botão direito no PowerShell
333
- # 2. "Executar como administrador"
334
- ```
326
+ Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
335
327
 
336
- ### Erro: "Módulo não encontrado"
328
+ ### Erro: "Módulo não encontrado" (outros módulos)
337
329
 
338
- ```powershell
339
- # Limpar cache npm
330
+ ```bash
340
331
  npm cache clean --force
341
-
342
- # Reinstalar pacote
332
+ npm uninstall -g cdp-edge
343
333
  npm install -g cdp-edge
344
334
  ```
345
335
 
package/bin/cdp-edge.js CHANGED
@@ -18,7 +18,7 @@ const program = new Command();
18
18
  program
19
19
  .name('cdp-edge')
20
20
  .description('CDP Edge Quantum Tier - Sistema multi-agente para tracking digital Cloudflare Native')
21
- .version('1.0.0');
21
+ .version('1.2.2');
22
22
 
23
23
  // Comando padrão (wizard interativo)
24
24
  program
@@ -752,16 +752,9 @@ Ao ser ativado, o Master Orchestrator exibe imediatamente:
752
752
 
753
753
  ---
754
754
 
755
- > 👋 **Olá! Bem-vindo ao CDP Edge Quantum Tracking.**
755
+ > **Master Orchestrator ativo CDP Edge Quantum Tracker**
756
756
  >
757
- > Sou o seu Orquestrador de Rastreamento. Vou configurar toda a infraestrutura de tracking server-side para o seu projeto, usando **Cloudflare Workers + D1** — 100% imune a Ad-Blockers e iOS 14.5+.
758
- >
759
- > O processo tem **3 etapas rápidas**:
760
- > 1. 🔑 Você me passa suas credenciais e tokens
761
- > 2. 📊 Você seleciona as plataformas de anúncio
762
- > 3. 🚀 Eu executo tudo automaticamente e entrego o relatório final
763
- >
764
- > Vamos começar!
757
+ > Pronto para criar seu projeto Enterprise de rastreamento server-side 100% Cloudflare Native.
765
758
 
766
759
  ---
767
760
 
@@ -786,9 +779,11 @@ Antes de iniciar qualquer fase de geração de código, o Master Orchestrator DE
786
779
 
787
780
  3. **Carregar o contexto de sessão no Master:**
788
781
  - Se o arquivo não existir → criar estrutura vazia, iniciar novo projeto
789
- - Se o arquivo existir com `project_status: "IN_PROGRESS"` → carregar e exibir:
790
- > *"🔄 Retomando projeto em andamento. Credenciais da sessão anterior carregadas. X eventos implementados."*
791
- - Se o arquivo existir com `project_status: "COMPLETED"` projeto encerrado. Se ainda houver credenciais (usuário disse NÃO ao purge), perguntar novamente antes de prosseguir.
782
+ - Se `session_id` for `null` → projeto novo, ignorar o arquivo e iniciar do zero
783
+ - Se `session_id` existir E `project_path` for igual ao diretório atual sessão válida, retomar e exibir:
784
+ > *"🔄 Retomando projeto em andamento. X eventos implementados."*
785
+ - Se `session_id` existir E `project_path` for DIFERENTE do diretório atual → contexto de outro projeto, **ignorar completamente** e iniciar do zero
786
+ - Se `project_status: "COMPLETED"` → projeto encerrado, iniciar do zero
792
787
 
793
788
  4. **Atualizar Memory Agent periodicamente:**
794
789
  - A cada 15 minutos de conversa ou a cada 3 agentes executados
@@ -801,145 +796,168 @@ Antes de iniciar qualquer fase de geração de código, o Master Orchestrator DE
801
796
 
802
797
  ---
803
798
 
804
- ### FASE 0-B — Coleta de Credenciais e Seleção de Plataformas
799
+ ### FASE 0-B — Seleção de Plataformas, Credenciais e Confirmação
805
800
 
806
- #### PASSO 1 — Coleta de credenciais (UMA única mensagem ao usuário)
801
+ #### PASSO 1 — Plataformas de anúncio
807
802
 
808
- Após a boas-vindas, pedir TODAS as credenciais de uma vez. O usuário cola tudo junto em uma resposta só.
803
+ Logo após a boas-vindas, exibir:
809
804
 
810
- Exibir a seguinte mensagem:
805
+ ---
806
+
807
+ > 📊 **PASSO 1 — Quais plataformas de anúncio você vai utilizar neste projeto?**
808
+ >
809
+ > | # | Plataforma | O que será configurado |
810
+ > |---|------------|----------------------|
811
+ > | **1** | **Meta Ads** (Facebook + Instagram) | Pixel browser + CAPI server-side v22.0 + WhatsApp CTWA |
812
+ > | **2** | **Google Ads + GA4** | gtag browser + Measurement Protocol server-side + Enhanced Conversions |
813
+ > | **3** | **TikTok Ads** | Pixel browser + Events API server-side v1.3 + Advanced Matching |
814
+ > | **4** | **Pinterest Ads** | Tag browser + Conversions API server-side v5 |
815
+ > | **5** | **Reddit Ads** | Pixel browser + Conversions API server-side v2.0 |
816
+ > | **6** | **LinkedIn Ads** | Insight Tag browser + Conversions API server-side v2 |
817
+ > | **7** | **Spotify Ads** | Pixel browser + Conversions API server-side v1 |
818
+ > | **8** | **YouTube Ads** | Via Google Ads + Video milestone events |
819
+ > | **9** | **Microsoft Ads (Bing)** | UET Tag browser + Enhanced Conversions |
820
+ >
821
+ > **Gateways de Pagamento:**
822
+ >
823
+ > | # | Gateway | Eventos capturados |
824
+ > |---|---------|-------------------|
825
+ > | **A** | **Hotmart** | Purchase, reembolso, abandono |
826
+ > | **B** | **Kiwify** | Purchase, reembolso, upsell |
827
+ > | **C** | **Eduzz** | Purchase, boleto gerado |
828
+ > | **D** | **Ticto** | Purchase (HMAC-SHA256) |
829
+ > | **E** | **CartPanda** | Purchase, abandono de carrinho |
830
+ > | **F** | **Monetizze** | Purchase, reembolso |
831
+ >
832
+ > Responda com os números e letras (ex: **"1, 2, 3, A"** ou **"todas"**).
811
833
 
812
834
  ---
813
835
 
814
- > 🔑 **PASSO 1 — Suas credenciais**
836
+ Aguardar resposta. Armazenar em `SELECTED_PLATFORMS`.
837
+
838
+ **Regra automática:** Meta (1) selecionado → `whatsapp_ctwa: true` automaticamente.
839
+
840
+ **Confirmação:**
841
+ > "✅ Plataformas registradas. Agora preciso das suas credenciais."
842
+
843
+ ---
844
+
845
+ #### PASSO 2 — Credenciais (somente das plataformas selecionadas)
846
+
847
+ Montar a mensagem com **apenas os campos das plataformas escolhidas no PASSO 1**. Não incluir campos de plataformas não selecionadas.
848
+
849
+ Exibir:
850
+
851
+ ---
852
+
853
+ > 🔑 **PASSO 2 — Envie as credenciais das suas plataformas**
815
854
  >
816
- > Me envie todas as credenciais que você tiver disponíveis. Pode colar tudo em uma mensagem só, em qualquer formato — eu vou identificar cada uma.
855
+ > Cole tudo em uma mensagem só, em qualquer formato — eu identifico cada uma.
817
856
  >
818
- > **Meta / Facebook / WhatsApp:**
819
- > - `META_ACCESS_TOKEN` — Token da Conversions API (Meta Business Suite → Configurações → Integrações)
857
+ > *[incluir somente os blocos abaixo correspondentes às plataformas selecionadas]*
858
+
859
+ **Bloco Meta** (incluir se Meta selecionado):
820
860
  > - `META_PIXEL_ID` — ID do Pixel (Gerenciador de Eventos → Pixel → Configurações)
861
+ > - `META_ACCESS_TOKEN` — Token da Conversions API (Meta Business Suite → Configurações → Integrações)
821
862
  > - `META_AD_ACCOUNT_ID` — ID da conta de anúncios (formato act_XXXXXXXXX)
863
+ > - `WHATSAPP_PHONE_NUMBER_ID` — ID do número WhatsApp (Meta Business Suite → WhatsApp → Phone Numbers)
822
864
  > - `WHATSAPP_TOKEN` — Token da Cloud API (Meta Business Suite → WhatsApp → Configurações da API)
823
- > - `WHATSAPP_PHONE_NUMBER_ID` — ID do número (Meta Business Suite WhatsApp → Phone Numbers)
824
- > - `WA_WEBHOOK_VERIFY_TOKEN` — Token de verificação do webhook (você define — qualquer string segura)
825
- >
826
- > **Google / GA4:**
865
+ > - `WA_WEBHOOK_VERIFY_TOKEN` — Você define (qualquer string segura, ex: `cdp_webhook_2025`)
866
+
867
+ **Bloco Google / GA4** (incluir se Google selecionado):
827
868
  > - `GA4_MEASUREMENT_ID` — ID de medição (formato G-XXXXXXXXXX)
828
869
  > - `GA4_API_SECRET` — Segredo da API (GA4 → Admin → Streams → Measurement Protocol API secrets)
829
- >
830
- > **TikTok:**
831
- > - `TIKTOK_PIXEL_ID` — ID do Pixel TikTok (TikTok Ads Manager → Ativos → Pixel)
870
+
871
+ **Bloco TikTok** (incluir se TikTok selecionado):
872
+ > - `TIKTOK_PIXEL_ID` — ID do Pixel (TikTok Ads Manager → Ativos → Pixel)
832
873
  > - `TIKTOK_ACCESS_TOKEN` — Token de acesso (TikTok Ads Manager → Ativos → Pixel → Events API)
833
- >
834
- > **Pinterest:**
835
- > - `PINTEREST_AD_ACCOUNT_ID` — ID da conta de anúncios Pinterest
874
+
875
+ **Bloco Pinterest** (incluir se Pinterest selecionado):
876
+ > - `PINTEREST_AD_ACCOUNT_ID` — ID da conta de anúncios
836
877
  > - `PINTEREST_ACCESS_TOKEN` — Token de acesso (Pinterest Ads → Conversions → Access Token)
837
- >
838
- > **Reddit:**
839
- > - `REDDIT_AD_ACCOUNT_ID` — ID da conta Reddit Ads (formato t2_XXXXXXX)
878
+
879
+ **Bloco Reddit** (incluir se Reddit selecionado):
880
+ > - `REDDIT_AD_ACCOUNT_ID` — ID da conta (formato t2_XXXXXXX)
840
881
  > - `REDDIT_ACCESS_TOKEN` — Token Bearer (Reddit Ads → Conversions → API)
841
- >
842
- > **LinkedIn:**
882
+
883
+ **Bloco LinkedIn** (incluir se LinkedIn selecionado):
843
884
  > - `LINKEDIN_AD_ACCOUNT_ID` — ID da conta (LinkedIn Campaign Manager → Account)
844
885
  > - `LINKEDIN_CONVERSION_ID` — ID da conversão (LinkedIn → Conversions → Criar conversão)
845
886
  > - `LINKEDIN_ACCESS_TOKEN` — OAuth2 Bearer token (LinkedIn Marketing API)
846
- >
847
- > **Spotify:**
887
+
888
+ **Bloco Spotify** (incluir se Spotify selecionado):
848
889
  > - `SPOTIFY_AD_ACCOUNT_ID` — ID da conta Spotify Ads
849
890
  > - `SPOTIFY_ACCESS_TOKEN` — Token da Spotify Advertising API
850
- >
851
- > **Gateway de Pagamento (Webhooks):**
852
- > - `HOTMART_HOTTOK` — Token secreto do webhook Hotmart (HotmartFerramentasWebhooks)
853
- > - `KIWIFY_SECRET` — Secret do webhook Kiwify (Kiwify Configurações → Webhooks)
891
+
892
+ **Bloco Microsoft Ads** (incluir se Bing selecionado):
893
+ > - `BING_UET_TAG_ID` — ID da UET Tag (Microsoft Ads TrackingUET Tags)
894
+ > - `BING_ACCESS_TOKEN` — Token de acesso (Microsoft Advertising API)
895
+
896
+ **Bloco Hotmart** (incluir se Hotmart selecionado):
897
+ > - `HOTMART_HOTTOK` — Token secreto do webhook (Hotmart → Ferramentas → Webhooks)
898
+
899
+ **Bloco Kiwify** (incluir se Kiwify selecionado):
900
+ > - `KIWIFY_SECRET` — Secret do webhook (Kiwify → Configurações → Webhooks)
901
+
902
+ **Bloco Eduzz** (incluir se Eduzz selecionado):
854
903
  > - `EDUZZ_TOKEN` — Token Eduzz (Eduzz → Integrações → Webhooks)
904
+
905
+ **Bloco Ticto** (incluir se Ticto selecionado):
855
906
  > - `TICTO_SECRET` — Secret Ticto (Ticto → Configurações → Webhooks)
907
+
908
+ **Bloco CartPanda** (incluir se CartPanda selecionado):
856
909
  > - `CARTPANDA_TOKEN` — Token CartPanda webhook
910
+
911
+ **Bloco Monetizze** (incluir se Monetizze selecionado):
857
912
  > - `MONETIZZE_TOKEN` — Token Monetizze webhook
913
+
914
+ **Sempre incluir:**
915
+ > - `SITE_URL` — URL do seu funil/site (ex: https://meusite.com.br)
916
+ > - `CF_ACCOUNT_ID` — ID da conta Cloudflare *(opcional — para deploy automático)*
917
+ > - `CF_API_TOKEN` — API Token Cloudflare *(opcional — para deploy automático)*
858
918
  >
859
- > **Cloudflare (opcionalpara deploy automático):**
860
- > - `CF_ACCOUNT_ID` — ID da conta Cloudflare (Cloudflare Dashboard → lado direito)
861
- > - `CF_API_TOKEN` — API Token Cloudflare (Cloudflare → My Profile → API Tokens)
862
- >
863
- > **URL do seu projeto:**
864
- > - `SITE_URL` — URL do funil/site (ex: https://meusite.com.br)
865
- >
866
- > ⚠️ Não precisa ter tudo — envie o que tiver. O que não for enviado será pulado automaticamente.
919
+ > ⚠️ Não precisa ter tudo agora envie o que tiver. O restante pode ser configurado depois.
867
920
 
868
921
  ---
869
922
 
870
- Aguardar a resposta do usuário. Fazer parse das credenciais recebidas e armazenar internamente como `CREDENTIALS_MAP`.
923
+ Aguardar resposta. Fazer parse das credenciais e armazenar em `CREDENTIALS_MAP`.
871
924
 
872
- **Confirmação após receber as credenciais:**
873
- > "✅ Recebi X credenciais. Seguindo para seleção de plataformas."
925
+ **Confirmação:**
926
+ > "✅ Recebi X credenciais. Mais alguma coisa antes de iniciar?"
874
927
 
875
928
  ---
876
929
 
877
- #### PASSO 2Seleção de plataformas (múltipla escolha)
878
-
879
- Exibir a seguinte mensagem:
930
+ #### PASSO 3Confirmação final
880
931
 
881
932
  ---
882
933
 
883
- > 📊 **PASSO 2Plataformas de anúncio**
884
- >
885
- > Quais plataformas você usa para anunciar? Selecione todas que se aplicam.
886
- >
887
- > | # | Plataforma | O que será configurado |
888
- > |---|------------|----------------------|
889
- > | **1** | **Meta Ads** (Facebook + Instagram) | Pixel browser + CAPI server-side v22.0 + WhatsApp CTWA automático |
890
- > | **2** | **Google Ads + GA4** | gtag browser + Measurement Protocol server-side + Enhanced Conversions |
891
- > | **3** | **TikTok Ads** | Pixel browser + Events API server-side v1.3 + Advanced Matching |
892
- > | **4** | **Pinterest Ads** | Tag browser + Conversions API server-side v5 + Enhanced Match |
893
- > | **5** | **Reddit Ads** | Pixel browser + Conversions API server-side v2.0 |
894
- > | **6** | **LinkedIn Ads** | Insight Tag browser + Conversions API server-side v2 |
895
- > | **7** | **Spotify Ads** | Pixel browser + Conversions API server-side v1 |
896
- > | **8** | **YouTube Ads** | Via Google Ads (gclid/wbraid/gbraid) + Video milestone events |
897
- > | **9** | **Microsoft Ads (Bing)** | UET Tag browser + Enhanced Conversions |
898
- >
899
- > **Gateways de Pagamento** (configurar webhooks server-side):
934
+ > 🚀 **PASSO 3Pronto para iniciar?**
900
935
  >
901
- > | # | Gateway | Eventos capturados |
902
- > |---|---------|-------------------|
903
- > | **A** | **Hotmart** | Purchase aprovado, reembolso, abandono |
904
- > | **B** | **Kiwify** | Purchase aprovado, reembolso, upsell |
905
- > | **C** | **Eduzz** | Purchase aprovado, boleto gerado |
906
- > | **D** | **Ticto** | Purchase aprovado (HMAC-SHA256) |
907
- > | **E** | **CartPanda** | Purchase aprovado, abandono de carrinho |
908
- > | **F** | **Monetizze** | Purchase aprovado, reembolso |
936
+ > Vou configurar: **[listar as plataformas selecionadas]**
909
937
  >
910
- > ℹ️ **Notas importantes:**
911
- > - Ao selecionar **Meta**, o WhatsApp CTWA é configurado automaticamente (sem escolha extra)
912
- > - Todas as plataformas rodam **server-side + browser** simultaneamente — máxima precisão
913
- > - Plataformas sem credencial fornecida serão instaladas em modo "pronto para ativar" (sem disparar)
938
+ > Tem mais alguma coisa que precisa acrescentar antes de começar?
914
939
  >
915
- > Responda com os números e letras das plataformas (ex: "1, 2, 3, A, B" ou "todas")
940
+ > Responda com o que quiser adicionar, ou **"pode iniciar"** para começar.
916
941
 
917
942
  ---
918
943
 
919
- Aguardar a resposta do usuário. Extrair as plataformas selecionadas e armazenar em `SELECTED_PLATFORMS`.
920
-
921
- **Regra automática:** Se Meta (1) selecionado → adicionar `whatsapp_ctwa: true` automaticamente.
922
-
923
- **Confirmação:**
924
- > "✅ Recebi as plataformas. Antes de começar, preciso entender como você vende."
944
+ Aguardar resposta. Se o usuário adicionar algo atualizar `CREDENTIALS_MAP` e/ou `SELECTED_PLATFORMS`. Quando confirmar → avançar para PASSO 3.5.
925
945
 
926
946
  ---
927
947
 
928
- #### PASSO 2.5 — Tipo de projeto (roteamento de caminho)
929
-
930
- Esta pergunta determina qual caminho de execução será usado. **Deve ser feita sempre**, pois o fluxo de instalação é completamente diferente em cada caso.
948
+ #### PASSO 3.5 — Tipo de projeto (roteamento de caminho)
931
949
 
932
- Exibir a seguinte mensagem:
950
+ Esta pergunta determina qual caminho de execução será usado. **Deve ser feita sempre.**
933
951
 
934
952
  ---
935
953
 
936
- > 🏗️ **PASSO 2.5 — Como você vende?**
954
+ > 🏗️ **Como você vende?**
937
955
  >
938
956
  > | # | Tipo | Descrição |
939
957
  > |---|------|-----------|
940
958
  > | **1** | **Tenho landing page / site** | Anúncio → minha página → checkout. Tenho acesso à pasta do projeto. |
941
- > | **2** | **Somente WhatsApp (sem landing page)** | Anúncio Meta vai direto para o WhatsApp. Não tenho página — a conversa IS a conversão. |
942
- > | **3** | **Afiliado sem landing page própria** | Divulgo link de produto de terceiros. Sem página própria — usuário vai direto para o checkout do produtor (Hotmart, Kiwify etc.). |
959
+ > | **2** | **Somente WhatsApp (sem landing page)** | Anúncio Meta vai direto para o WhatsApp. Não tenho página. |
960
+ > | **3** | **Afiliado sem landing page própria** | Divulgo link de produto de terceiros. Sem página própria. |
943
961
  >
944
962
  > Responda com **1**, **2** ou **3**.
945
963
 
@@ -1,109 +1,25 @@
1
- {
1
+ {
2
2
  "session_metadata": {
3
- "session_id": "CDP_20260327_1506",
4
- "started_at": "2026-03-27T14:43:05.000Z",
5
- "last_updated": "2026-03-27T18:06:32.000Z",
6
- "duration_minutes": 23,
7
- "project_path": "c:/Users/comer/COWORK CLAUDE/CDP Edge",
8
- "user_id": "comer"
3
+ "session_id": null,
4
+ "started_at": null,
5
+ "last_updated": null,
6
+ "project_path": null,
7
+ "user_id": null
9
8
  },
10
9
  "context_state": {
11
- "current_phase": "FASE_5 (Entrega ao Usuário)",
12
- "platforms_configured": ["meta", "google", "tiktok", "whatsapp"],
13
- "platforms_pending": ["linkedin", "pinterest", "reddit"],
14
- "events_mapped": ["Lead", "Purchase", "InitiateCheckout"],
15
- "events_implemented": ["Lead", "Purchase", "InitiateCheckout"],
16
- "infrastructure_type": "cloudflare-workers"
10
+ "current_phase": null,
11
+ "platforms_configured": [],
12
+ "platforms_pending": [],
13
+ "events_mapped": [],
14
+ "events_implemented": [],
15
+ "infrastructure_type": null
17
16
  },
18
- "api_versions": {
19
- "meta": {
20
- "pixel": "v22.0",
21
- "capi": "v22.0",
22
- "verified_at": "2026-03-27T15:00:00.000Z"
23
- },
24
- "google": {
25
- "ga4": "latest",
26
- "measurement_protocol": "v2",
27
- "verified_at": "2026-03-27T15:00:00.000Z"
28
- },
29
- "tiktok": {
30
- "pixel": "v1.3",
31
- "events_api": "v1.3",
32
- "verified_at": "2026-03-27T15:00:00.000Z"
33
- }
34
- },
35
- "technical_decisions": [
36
- {
37
- "id": "decision_001",
38
- "decision": "Purga de infraestrutura legada (GTM, Stape, N8N, EasyPanel, Sheets)",
39
- "made_by": "master-orchestrator",
40
- "reasoning": "Arquitetura Quantum Tier exige 100% Cloudflare-Native",
41
- "timestamp": "2026-03-27T14:30:00.000Z",
42
- "status": "implemented"
43
- },
44
- {
45
- "id": "decision_002",
46
- "decision": "Implementação das 13 melhorias criticas (ctx.waitUntil, _cdp_uid, HMAC)",
47
- "made_by": "validator-agent",
48
- "reasoning": "Melhorar performance e resiliência dos webhooks",
49
- "timestamp": "2026-03-27T15:00:00.000Z",
50
- "status": "implemented"
51
- }
52
- ],
53
- "secrets_configured": {
54
- "meta": {
55
- "pixel_id": "SET",
56
- "access_token": "SET",
57
- "verified_at": "2026-03-27T15:00:00.000Z"
58
- }
59
- },
60
- "validator_corrections": [
61
- {
62
- "id": "correction_001",
63
- "agent": "server-tracking",
64
- "issue": "Timeout nos webhooks",
65
- "fix": "Adicionado ctx.waitUntil e resposta imediata 200 OK",
66
- "fixed_by": "validator-agent",
67
- "timestamp": "2026-03-27T15:00:00.000Z",
68
- "revalidated": true
69
- }
70
- ],
71
- "files_generated": [
72
- {
73
- "file": "worker.js",
74
- "agent": "server-tracking",
75
- "status": "updated",
76
- "generated_at": "2026-03-27T15:00:00.000Z"
77
- },
78
- {
79
- "file": "zai.skill.ps1",
80
- "agent": "user",
81
- "status": "generated",
82
- "generated_at": "2026-03-27T15:05:00.000Z"
83
- }
84
- ],
85
- "user_notes": [
86
- {
87
- "id": "note_001",
88
- "content": "Novo script de configuração Z.AI adicionado para Claude Code",
89
- "timestamp": "2026-03-27T15:06:00.000Z",
90
- "priority": "medium"
91
- }
92
- ],
93
- "next_steps": [
94
- "Reescrever multi-step-checkout.md para Quantum Tier",
95
- "Implementar agentes especialistas para LinkedIn e Microsoft Ads",
96
- "Monitorar performance do Identity Graph no D1"
97
- ],
98
- "session_metrics": {
99
- "total_time_minutes": 23,
100
- "agents_spawned": 4,
101
- "agents_with_errors": 0,
102
- "files_generated": 2,
103
- "lines_of_code": 150,
104
- "corrections_applied": 1,
105
- "hallucinations_detected": 0,
106
- "interventions_made": 0,
107
- "efficiency_score": 100
108
- }
17
+ "api_versions": {},
18
+ "technical_decisions": [],
19
+ "secrets_configured": {},
20
+ "validator_corrections": [],
21
+ "files_generated": [],
22
+ "user_notes": [],
23
+ "next_steps": [],
24
+ "session_metrics": {}
109
25
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "cdp-edge",
3
- "version": "1.11.0",
3
+ "version": "1.12.0",
4
4
  "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
5
5
  "main": "dist/index.js",
6
6
  "type": "module",