cdp-edge 1.2.0

package/README.md

@@ -0,0 +1,367 @@
+# 🚀 CDP Edge - Quantum Tracking
+
+**Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
+
+> **v1.2.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
+
+### Instalar Globalmente
+
+```bash
+npm install -g cdp-edge
+cdp-edge --version
+```
+
+---
+
+## 📋 COMANDOS DISPONÍVEIS
+
+### `install` — Instalar CDP Edge em um projeto cliente
+
+**O comando principal.** Configura o CDP Edge em qualquer projeto e habilita o `/cdp` no Claude Code.
+
+```bash
+# Instalar no diretório atual
+cdp-edge install .
+
+# Instalar em outro diretório
+cdp-edge install ./meu-projeto
+
+# Com nome do projeto
+cdp-edge install ./meu-projeto --name "Landing Page XYZ"
+
+# Incluir .cursorrules para Cursor IDE
+cdp-edge install ./meu-projeto --cursor
+```
+
+**O que cria na raiz do projeto:**
+
+| Arquivo/Pasta | Função |
+|---|---|
+| `cdp-edge/` | Skill completa (agentes, SDK, worker, templates, docs) |
+| `.claude/commands/cdp.md` | Habilita `/cdp` no Claude Code |
+| `CLAUDE.md` | Auto-ativação ao abrir sessão |
+| `.cursorrules` | Integração Cursor IDE (flag `--cursor`) |
+
+**Fluxo após install:**
+
+```bash
+# 1. Criar e instalar
+mkdir meu-projeto
+cdp-edge install ./meu-projeto
+
+# 2. Abrir no Claude Code
+claude ./meu-projeto
+
+# 3. Ativar o Orchestrator
+/cdp
+```
+
+---
+
+### Outros Comandos
+
+#### `setup` — Wizard interativo
+
+```bash
+cdp-edge setup
+cdp-edge setup ./meu-projeto
+```
+
+**O que faz:**
+- Pergunta plataformas (Meta, TikTok, GA4, etc.)
+- Pergunta tipo de produto (lead, checkout, webinar, etc.)
+- Gera código de tracking (Browser + Server)
+- Cria schema D1 SQL e configuração Wrangler
+
+---
+
+#### `analyze` — Analisar páginas
+
+```bash
+cdp-edge analyze .
+cdp-edge analyze ./meu-projeto
+```
+
+**O que faz:**
+- Detecta CTAs e formulários
+- Identifica nicho do negócio
+- Sugere micro-eventos comportamentais
+
+---
+
+#### `server` — Gerar infraestrutura Cloudflare
+
+```bash
+cdp-edge server .
+cdp-edge server ./meu-worker
+```
+
+**Arquivos gerados:**
+- `worker.js` — Cloudflare Worker completo
+- `schema.sql` — Schema D1
+- `wrangler.toml` — Configuração Wrangler
+
+---
+
+#### `validate` — Auditar tracking existente
+
+```bash
+cdp-edge validate tracking.js
+```
+
+**O que verifica:**
+- `event_id` para deduplicação
+- SHA256 para PII (e-mail, telefone)
+- Detecção de GTM/Stape
+- Conformidade com APIs
+
+---
+
+#### `infra` — Guia de infraestrutura Cloudflare
+
+```bash
+cdp-edge infra
+```
+
+---
+
+## 🔄 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.
+├── CLAUDE.md                        # Guia de desenvolvimento e padrões.
+├── extracted-skill/                 # O motor da IA (Agentes e Knowledge Base).
+│   └── 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/             # 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)
+├── dist/commands/                   # Implementação dos comandos CLI
+│   └── install.js                   # cdp-edge install
+├── 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
+```
+
+---
+
+## 📚 EXEMPLOS DE USO
+
+### Cenário 1: Novo projeto com Claude Code
+
+```bash
+# 1. Criar projeto e instalar CDP Edge
+mkdir landing-page-lead
+cdp-edge install ./landing-page-lead --name "Landing Page Lead"
+
+# 2. Abrir no Claude Code
+claude ./landing-page-lead
+
+# 3. Ativar o Orchestrator
+/cdp
+# → CDP Edge inicia, faz perguntas, gera toda a infraestrutura
+```
+
+### Cenário 2: Apenas Infraestrutura Cloudflare
+
+```bash
+# 1. Gerar infraestrutura Worker + D1
+cdp-edge server ./meu-worker
+
+# 2. Deploy
+cd meu-worker
+wrangler deploy
+
+# 3. Configurar secrets
+wrangler secret put META_ACCESS_TOKEN
+wrangler secret put TIKTOK_ACCESS_TOKEN
+```
+
+### Cenário 3: Validar Código Existente
+
+```bash
+cdp-edge validate tracking.js
+
+# Status: PASS | Score: 85/100
+# ⚠  Hashing não detectado para PII
+```
+
+### Cenário 4: Análise de Projeto
+
+```bash
+cdp-edge analyze ./meu-projeto-web
+
+# 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
+# 🎯 Nicho identificado: E-commerce
+```
+
+---
+
+## ⚡ COMANDOS RÁPIDOS (CLI)
+
+| Comando | Descrição |
+|---------|-----------|
+| `cdp-edge install [dir]` | **Instala CDP Edge + habilita /cdp no Claude Code** |
+| `cdp-edge setup [dir]` | Configuração guiada (wizard) |
+| `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: "Cannot find module dist/commands/install.js"
+
+O npm ainda tem a versão antiga em cache. Instale direto do GitHub para ter a versão mais recente:
+
+```bash
+npm uninstall -g cdp-edge
+npm install -g github:ricardosoli777/CDP-Edge-Premium
+cdp-edge --version
+```
+
+### Erro: "cdp-edge não é reconhecido"
+
+```bash
+# Instalar globalmente
+npm install -g cdp-edge
+
+# Ou instalar direto do repositório
+npm install -g github:ricardosoli777/CDP-Edge-Premium
+```
+
+### Erro: "Permissão negada ao escrever arquivos"
+
+Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
+
+### Erro: "Módulo não encontrado" (outros módulos)
+
+```bash
+npm cache clean --force
+npm uninstall -g cdp-edge
+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,61 @@
+#!/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';
+import { runInstall } from '../dist/commands/install.js';
+
+const program = new Command();
+
+program
+  .name('cdp-edge')
+  .description('CDP Edge Quantum Tier - Sistema multi-agente para tracking digital Cloudflare Native')
+  .version('1.2.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
+  .command('install [dir]')
+  .description('Instala o CDP Edge em um projeto cliente e habilita /cdp no Claude Code')
+  .option('-n, --name <name>', 'Nome do projeto')
+  .option('--cursor', 'Criar .cursorrules para Cursor IDE')
+  .action(runInstall);
+
+program.parse(process.argv);