cdp-edge 1.5.0

package/README.md

@@ -0,0 +1,377 @@
+# 🚀 CDP Edge - Quantum Tracking
+
+**Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
+
+> **v1.1.0** — 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 (0-100) 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 (Workers Paid).
+
+---
+
+## 🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)
+
+O CDP Edge não é um "script de rastreio", é uma **Content Delivery Network (CDN)** com inteligência de dados acoplada.
+
+```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]
+    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]
+```
+
+---
+
+## 🖱 CATÁLOGO DE AGENTES ESPECIALISTAS
+
+O sistema é composto por mais de 30 agentes coordenados pelo **Master Orchestrator**. Cada um possui uma função técnica específica:
+
+### 🧠 Núcleo de Inteligência
+| Agente | Função |
+|---|---|
+| **Master Orchestrator** | Coordenação central de especialistas e validação Quantum Tier. |
+| **Page Analyzer** | Mapeamento automático de CTAs, Forms e Nicho do site. |
+| **Validator Agent** | Auditoria de código, segurança e conformidade de APIs. |
+| **Memory Agent** | Gestão de contexto e checkpoints técnicos da sessão. |
+| **Intelligence Agent** | Monitoramento de atualizações de API (Meta v22.0+, etc). |
+
+### 🚀 Despachantes de Plataforma
+| Agente | Especialidade |
+|---|---|
+| **Meta Agent** | Facebook Pixel + CAPI (EMQ Max). |
+| **Google Agent** | GA4 + Google Ads Server-Side. |
+| **TikTok Agent** | TikTok Pixel + Events API v1.3. |
+| **Plataformas Ads** | Pinterest, Reddit, Bing, LinkedIn, Spotify. |
+| **Browser Agent** | Geração do SDK `cdpTrack.js` lightweight. |
+
+### 🛡️ Módulos Enterprise (Premium)
+| Agente | Função |
+|---|---|
+| **Attribution Agent** | Atribuição Multi-Touch de alta fidelidade. |
+| **Security Agent** | Rate Limiting, Criptografia AES-256 e Bot Defense. |
+| **Compliance Agent** | Gestão de LGPD e GDPR (Consent Mode v2). |
+| **Performance Opt.** | Otimização de Caches e Queries D1 SQL. |
+| **CRM Integration** | Sincronia D1 ↔ HubSpot/Salesforce via CRM Agent. |
+
+---
+
+## 💻 INSTALAÇÃO E USO (POWERShell)
+
+### Opção 1: Instalar Globalmente
+
+```powershell
+# 1. Instalar o pacote
+npm install -g cdp-edge
+
+# 2. Verificar instalação
+cdp-edge --version
+
+# 3. Executar
+cdp-edge
+```
+
+### Opção 2: Usar via npx (sem instalar)
+
+```powershell
+# Executar direto
+npx cdp-edge
+```
+
+---
+
+## 📋 COMANDOS DISPONÍVEIS
+
+### Comando Único (Wizard Interativo)
+
+```powershell
+# Inicia wizard completo no diretório atual
+cdp-edge
+
+# Ou em outro diretório
+cdp-edge "C:\caminho\do\projeto"
+```
+
+### Comandos Específicos
+
+#### 1. Setup Completo
+
+```powershell
+# Configuração interativa completa
+cdp-edge setup
+
+# Setup em diretório específico
+cdp-edge setup "C:\meu-projeto"
+```
+
+**O que faz:**
+- Pergunta plataformas (Meta, TikTok, GA4, etc.)
+- Pergunta tipo de produto (lead, checkout, webinar, etc.)
+- Analisa arquivos do projeto
+- Gera código de tracking (Browser + Server)
+- Cria schema D1 SQL
+- Gera configuração Wrangler
+
+---
+
+#### 2. Analisar Páginas
+
+```powershell
+# Analisar diretório atual
+cdp-edge analyze .
+
+# Analisar projeto específico
+cdp-edge analyze "C:\caminho\do\projeto"
+```
+
+**O que faz:**
+- Lê todos os arquivos HTML/JS
+- Detecta CTAs e formulários
+- Identifica nicho do negócio
+- Sugere micro-eventos comportamentais
+
+---
+
+#### 3. Gerar Infraestrutura Server
+
+```powershell
+# Gerar Worker + D1 no diretório atual
+cdp-edge server .
+
+# Gerar em diretório específico
+cdp-edge server "C:\meu-worker-cloudflare"
+```
+
+**Arquivos gerados:**
+- `worker.js` - Cloudflare Worker completo
+- `schema.sql` - Schema D1 para persistência
+- `wrangler.toml` - Configuração do Wrangler
+
+---
+
+#### 4. Validar Tracking Existente
+
+```powershell
+# Validar arquivo específico
+cdp-edge validate "C:\meu-projeto\tracking.js"
+```
+
+**O que verifica:**
+- Presença de `event_id` (deduplicação)
+- Hashing SHA256 para PII (e-mail, telefone)
+- Detecção de GTM/Stape (avisa para migrar)
+- Conformidade com APIs mais recentes
+
+---
+
+#### 5. Guia de Infraestrutura
+
+```powershell
+# Mostra guia passo a passo do zero ao deploy
+cdp-edge infra
+```
+
+**Cobre:**
+- Criação de conta Cloudflare
+- Instalação Wrangler CLI
+- Configuração D1 Database
+- Setup de secrets (API tokens)
+- Deploy via `wrangler deploy`
+- Configuração de domínio e rotas
+
+---
+
+## 🔄 CICLO DE VIDA DO SETUP (/setup)
+
+1.  **FASE 0 — Checkpoint:** Sincronização de contexto via Memory Agent.
+2.  **FASE 1 — Análise:** Detecção automática de nicho e estrutura da página.
+3.  **FASE 2 — Mapeamento:** Identificação de CTAs, Forms e Gateways de venda.
+4.  **FASE 3 — Geração:** Código paralelo para Browser (`cdpTrack`), Worker e D1 SQL.
+5.  **FASE 4 — Auditoria:** Validação rigorosa e correções automáticas (Validator).
+6.  **FASE 5 — Deploy:** Publicação instantânea via `wrangler deploy`.
+
+---
+
+## 📁 ESTRUTURA DO REPOSITÓRIO
+
+```text
+CDP Edge/
+├── README.md                        # Você está aqui. A bíblia do sistema.
+├── CLAUDE.md                        # Guia de desenvolvimento e padrões.
+├── extracted-skill/                 # O motor da IA (Agentes e Knowledge Base).
+│   └── tracking-events-generator/
+│       ├── agents/                  # 35+ agentes especialistas
+│       ├── models/                  # Checklists de cenários de negócio
+│       ├── cdpTrack.js              # SDK Browser (window.cdpTrack)
+│       └── knowledge-base.md        # Enciclopédia de APIs e Schemas
+├── server-edge-tracker/             # Cloudflare Worker (Infra de Borda)
+│   ├── worker.js                    # Handler principal + Queue consumer
+│   ├── schema.sql                   # D1 Schema (Identity Graph)
+│   └── wrangler.toml                # Bindings: D1 + Queue + KV + AI
+├── bin/                             # CLI Executável (cdp-edge)
+└── templates/                       # Templates por cenário de negócio
+```
+
+---
+
+## 📚 EXEMPLOS DE USO POWERShell
+
+### Cenário 1: Setup Completo para Landing Page
+
+```powershell
+# 1. Navegar para o projeto
+cd "C:\Users\comer\meus-projetos\landing-page-lead"
+
+# 2. Executar setup
+cdp-edge setup
+
+# 3. Responder perguntas do wizard
+# - Plataformas: [ ] Meta (Facebook/Instagram)
+# - Tipo: Lead Capture (Formulário)
+# - Server-side: [x] Sim
+
+# 4. Arquivos gerados automaticamente:
+#    - cdpTrack.js (Browser SDK)
+#    - tracking.config.js
+#    - worker.js (Cloudflare Worker)
+#    - schema.sql (D1 Database)
+```
+
+### Cenário 2: Apenas Infraestrutura Cloudflare
+
+```powershell
+# 1. Criar diretório para o Worker
+New-Item -Path "C:\meu-worker-cloudflare" -ItemType Directory
+cd "C:\meu-worker-cloudflare"
+
+# 2. Gerar infraestrutura
+cdp-edge server .
+
+# 3. Deploy com Wrangler
+wrangler deploy
+
+# 4. Configurar secrets
+wrangler secret put META_ACCESS_TOKEN
+wrangler secret put TIKTOK_ACCESS_TOKEN
+```
+
+### Cenário 3: Validar Código Existe
+
+```powershell
+# 1. Validar arquivo de tracking
+cdp-edge validate "C:\meu-projeto\tracking.js"
+
+# 2. Ver relatório
+# Status: PASS
+# Score:  85/100
+#
+# ⚠️  Avisos:
+#   └─ Hashing não detectado para PII
+```
+
+### Cenário 4: Análise de Projeto
+
+```powershell
+# 1. Analisar projeto completo
+cdp-edge analyze "C:\meu-projeto-web"
+
+# 2. Resultado
+# 📊 Eventos detectados:
+#   leads: 2
+#   purchases: 1
+#   views: 3
+#   custom: 0
+#
+# 🎯 Nicho identificado: E-commerce (SaaS)
+```
+
+---
+
+## ⚡ COMANDOS RÁPIDOS (CLI)
+
+| Comando | Descrição |
+|---------|-----------|
+| `cdp-edge` | Wizard interativo completo |
+| `cdp-edge setup [dir]` | Configuração guiada |
+| `cdp-edge analyze <dir>` | Análise de páginas |
+| `cdp-edge server <dir>` | Gerar infraestrutura Workers + D1 |
+| `cdp-edge validate <file>` | Auditoria de código |
+| `cdp-edge infra` | Guia Cloudflare |
+| `cdp-edge --help` | Ajuda completa |
+| `cdp-edge --version` | Versão instalada |
+
+---
+
+## 🔧 SOLUÇÃO DE PROBLEMAS
+
+### Erro: "cdp-edge não é reconhecido"
+
+```powershell
+# Solução 1: Instalar globalmente
+npm install -g cdp-edge
+
+# Solução 2: Usar npx
+npx cdp-edge
+
+# Solução 3: Verificar PATH
+$env:Path -split ';' | Where-Object { $_ -like '*node*' }
+```
+
+### Erro: "Permissão negada ao escrever arquivos"
+
+```powershell
+# Executar PowerShell como Administrador
+# 1. Clique com botão direito no PowerShell
+# 2. "Executar como administrador"
+```
+
+### Erro: "Módulo não encontrado"
+
+```powershell
+# Limpar cache npm
+npm cache clean --force
+
+# Reinstalar pacote
+npm install -g cdp-edge
+```
+
+---
+
+## 🖱️ HUMAN-BEHAVIOR ENGINE (O MOTOR DE INTENÇÃO)
+
+A joia da coroa do CDP Edge. Capturamos o que o usuário **sente** e **faz**, e não apenas onde ele clica.
+
+### 🌡️ Engagement Scoring Engine (0-100)
+Cada ação do usuário soma (ou subtrai) pontos em tempo real:
+*   **Scroll (25-90%)**: +5 a +15 pontos.
+*   **VSL Watch (25-100%)**: +10 a +50 pontos.
+*   **Copy Intent**: +20 pontos ao copiar cupons ou chaves PIX.
+*   **Form Interaction**: +10 pontos por campo preenchido.
+*   **Rage Click**: -10 pontos (sinal de frustração técnica).
+*   **Gatilho Hot Lead**: Ao atingir **80 pontos**, disparar `High_Intent_Lead` para as plataformas.
+
+### 🎥 VSL & Video Tracker
+Monitoramento nativo de retenção em vídeos YouTube e Vimeo sem necessidade de scripts externos pesados.
+
+---
+
+## 📞 SUPORTE
+
+- **Documentação**: Verifique `CLAUDE.md` para padrões de desenvolvimento
+- **Issues**: https://github.com/ricardosoli777/CDP-Edge-Premium/issues
+- **Releases**: https://github.com/ricardosoli777/CDP-Edge-Premium/releases
+
+---
+
+### **CDP Edge — By Rica Soares**
+> "Dados sem inteligência são apenas ruído. No Quantum Tier, transformamos dados em ROAS."
+
+© 2026 CDP Edge Premium. Todos os direitos reservados.

package/bin/cdp-edge.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+/**
+ * CDP Edge CLI - Entry Point
+ * Sistema multi-agente para tracking digital Quantum Tier
+ */
+
+import { Command } from 'commander';
+import { runSetupWizard } from '../dist/commands/setup.js';
+import { runAnalyze } from '../dist/commands/analyze.js';
+import { runServer } from '../dist/commands/server.js';
+import { runValidate } from '../dist/commands/validate.js';
+import { runInfra } from '../dist/commands/infra.js';
+
+const program = new Command();
+
+program
+  .name('cdp-edge')
+  .description('CDP Edge Quantum Tier - Sistema multi-agente para tracking digital Cloudflare Native')
+  .version('1.0.0');
+
+// Comando padrão (wizard interativo)
+program
+  .argument('[dir]', 'Diretório do projeto', '.')
+  .action(runSetupWizard);
+
+// Comandos específicos
+program
+  .command('setup [dir]')
+  .description('Configuração completa com wizard interativo')
+  .action(runSetupWizard);
+
+program
+  .command('analyze <dir>')
+  .description('Analisa páginas e detecta eventos de tracking')
+  .action(runAnalyze);
+
+program
+  .command('server <dir>')
+  .description('Gera apenas infraestrutura Cloudflare Workers + D1')
+  .action(runServer);
+
+program
+  .command('validate <file>')
+  .description('Audita tracking existente')
+  .action(runValidate);
+
+program
+  .command('infra')
+  .description('Mostra guia de setup de infraestrutura Cloudflare')
+  .action(runInfra);
+
+program.parse(process.argv);