cdp-edge 1.11.0 → 1.11.1

package/README.md

@@ -2,7 +2,7 @@
 
 **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
+> **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.
@@ -64,129 +64,127 @@ O sistema é composto por mais de 30 agentes coordenados pelo **Master Orchestra
 
 ---
 
-## 💻 INSTALAÇÃO E USO (POWERShell)
+## 💻 INSTALAÇÃO E USO
 
-### Opção 1: Instalar Globalmente
+### Instalar Globalmente
 
-```powershell
-# 1. Instalar o pacote
+```bash
 npm install -g cdp-edge
-
-# 2. Verificar instalação
 cdp-edge --version
-
-# 3. Executar
-cdp-edge
 ```
 
-### Opção 2: Usar via npx (sem instalar)
+---
+
+## 📋 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
 
-```powershell
-# Executar direto
-npx cdp-edge
+# 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:**
 
-## 📋 COMANDOS DISPONÍVEIS
+| 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`) |
 
-### Comando Único (Wizard Interativo)
+**Fluxo após install:**
 
-```powershell
-# Inicia wizard completo no diretório atual
-cdp-edge
+```bash
+# 1. Criar e instalar
+mkdir meu-projeto
+cdp-edge install ./meu-projeto
 
-# Ou em outro diretório
-cdp-edge "C:\caminho\do\projeto"
+# 2. Abrir no Claude Code
+claude ./meu-projeto
+
+# 3. Ativar o Orchestrator
+/cdp
 ```
 
-### Comandos Específicos
+---
+
+### Outros Comandos
 
-#### 1. Setup Completo
+#### `setup` — Wizard interativo
 
-```powershell
-# Configuração interativa completa
+```bash
 cdp-edge setup
-
-# Setup em diretório específico
-cdp-edge setup "C:\meu-projeto"
+cdp-edge setup ./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
+- Cria schema D1 SQL e configuração Wrangler
 
 ---
 
-#### 2. Analisar Páginas
+#### `analyze` — Analisar páginas
 
-```powershell
-# Analisar diretório atual
+```bash
 cdp-edge analyze .
-
-# Analisar projeto específico
-cdp-edge analyze "C:\caminho\do\projeto"
+cdp-edge analyze ./meu-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
+#### `server` — Gerar infraestrutura Cloudflare
 
-```powershell
-# Gerar Worker + D1 no diretório atual
+```bash
 cdp-edge server .
-
-# Gerar em diretório específico
-cdp-edge server "C:\meu-worker-cloudflare"
+cdp-edge server ./meu-worker
 ```
 
 **Arquivos gerados:**
-- `worker.js` - Cloudflare Worker completo
-- `schema.sql` - Schema D1 para persistência
-- `wrangler.toml` - Configuração do Wrangler
+- `worker.js` — Cloudflare Worker completo
+- `schema.sql` — Schema D1
+- `wrangler.toml` — Configuração Wrangler
 
 ---
 
-#### 4. Validar Tracking Existente
+#### `validate` — Auditar tracking existente
 
-```powershell
-# Validar arquivo específico
-cdp-edge validate "C:\meu-projeto\tracking.js"
+```bash
+cdp-edge validate 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
+- `event_id` para deduplicação
+- SHA256 para PII (e-mail, telefone)
+- Detecção de GTM/Stape
+- Conformidade com APIs
 
 ---
 
-#### 5. Guia de Infraestrutura
+#### `infra` — Guia de infraestrutura Cloudflare
 
-```powershell
-# Mostra guia passo a passo do zero ao deploy
+```bash
 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)
@@ -204,93 +202,84 @@ cdp-edge infra
 
 ```text
 CDP Edge/
-├── README.md                        # Você está aqui. A bíblia do sistema.
+├── 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/                  # 35+ agentes especialistas
-│       ├── models/                  # Checklists de cenários de negócio
+│       ├── agents/                  # 39+ agentes especialistas
 │       ├── cdpTrack.js              # SDK Browser (window.cdpTrack)
-│       └── knowledge-base.md        # Enciclopédia de APIs e Schemas
+│       └── 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)
-└── templates/                       # Templates por cenário de negócio
+├── 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 POWERShell
-
-### Cenário 1: Setup Completo para Landing Page
+## 📚 EXEMPLOS DE USO
 
-```powershell
-# 1. Navegar para o projeto
-cd "C:\Users\comer\meus-projetos\landing-page-lead"
+### Cenário 1: Novo projeto com Claude Code
 
-# 2. Executar setup
-cdp-edge setup
+```bash
+# 1. Criar projeto e instalar CDP Edge
+mkdir landing-page-lead
+cdp-edge install ./landing-page-lead --name "Landing Page Lead"
 
-# 3. Responder perguntas do wizard
-# - Plataformas: [ ] Meta (Facebook/Instagram)
-# - Tipo: Lead Capture (Formulário)
-# - Server-side: [x] Sim
+# 2. Abrir no Claude Code
+claude ./landing-page-lead
 
-# 4. Arquivos gerados automaticamente:
-#    - cdpTrack.js (Browser SDK)
-#    - tracking.config.js
-#    - worker.js (Cloudflare Worker)
-#    - schema.sql (D1 Database)
+# 3. Ativar o Orchestrator
+/cdp
+# → CDP Edge inicia, faz perguntas, gera toda a infraestrutura
 ```
 
 ### 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 .
+```bash
+# 1. Gerar infraestrutura Worker + D1
+cdp-edge server ./meu-worker
 
-# 3. Deploy com Wrangler
+# 2. Deploy
+cd meu-worker
 wrangler deploy
 
-# 4. Configurar secrets
+# 3. Configurar secrets
 wrangler secret put META_ACCESS_TOKEN
 wrangler secret put TIKTOK_ACCESS_TOKEN
 ```
 
-### Cenário 3: Validar Código Existe
+### Cenário 3: Validar Código Existente
 
-```powershell
-# 1. Validar arquivo de tracking
-cdp-edge validate "C:\meu-projeto\tracking.js"
+```bash
+cdp-edge validate tracking.js
 
-# 2. Ver relatório
-# Status: PASS
-# Score:  85/100
-#
-# ⚠️  Avisos:
-#   └─ Hashing não detectado para PII
+# Status: PASS | Score: 85/100
+# ⚠  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)
+```bash
+cdp-edge analyze ./meu-projeto-web
+
+# 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
+# 🎯 Nicho identificado: E-commerce
 ```
 
 ---
@@ -299,8 +288,8 @@ cdp-edge analyze "C:\meu-projeto-web"
 
 | Comando | Descrição |
 |---------|-----------|
-| `cdp-edge` | Wizard interativo completo |
-| `cdp-edge setup [dir]` | Configuração guiada |
+| `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 |
@@ -312,34 +301,35 @@ cdp-edge analyze "C:\meu-projeto-web"
 
 ## 🔧 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"
 
-```powershell
-# Solução 1: Instalar globalmente
+```bash
+# 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*' }
+# Ou instalar direto do repositório
+npm install -g github:ricardosoli777/CDP-Edge-Premium
 ```
 
 ### Erro: "Permissão negada ao escrever arquivos"
 
-```powershell
-# Executar PowerShell como Administrador
-# 1. Clique com botão direito no PowerShell
-# 2. "Executar como administrador"
-```
+Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
 
-### Erro: "Módulo não encontrado"
+### Erro: "Módulo não encontrado" (outros módulos)
 
-```powershell
-# Limpar cache npm
+```bash
 npm cache clean --force
-
-# Reinstalar pacote
+npm uninstall -g cdp-edge
 npm install -g cdp-edge
 ```
 

package/bin/cdp-edge.js

@@ -18,7 +18,7 @@ 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');
+  .version('1.2.0');
 
 // Comando padrão (wizard interativo)
 program

package/extracted-skill/tracking-events-generator/agents/master-orchestrator.md

@@ -756,12 +756,14 @@ Ao ser ativado, o Master Orchestrator exibe imediatamente:
 >
 > 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+.
 >
-> O processo tem **3 etapas rápidas**:
-> 1. 🔑 Você me passa suas credenciais e tokens
-> 2. 📊 Você seleciona as plataformas de anúncio
-> 3. 🚀 Eu executo tudo automaticamente e entrego o relatório final
+> Para começar, preciso entender o seu projeto:
 >
-> Vamos começar!
+> **Como você vende?**
+> - **A)** Tenho página de vendas / landing page
+> - **B)** Vendo apenas pelo WhatsApp (sem página)
+> - **C)** Sou afiliado (sem página própria)
+>
+> Me diga qual caminho e já iniciamos o setup.
 
 ---
 
@@ -786,9 +788,11 @@ Antes de iniciar qualquer fase de geração de código, o Master Orchestrator DE
 
 3. **Carregar o contexto de sessão no Master:**
    - Se o arquivo não existir → criar estrutura vazia, iniciar novo projeto
-   - Se o arquivo existir com `project_status: "IN_PROGRESS"` → carregar e exibir:
-     > *"🔄 Retomando projeto em andamento. Credenciais da sessão anterior carregadas. X eventos já implementados."*
-   - 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.
+   - Se `session_id` for `null` → projeto novo, ignorar o arquivo e iniciar do zero
+   - Se `session_id` existir E `project_path` for igual ao diretório atual → sessão válida, retomar e exibir:
+     > *"🔄 Retomando projeto em andamento. X eventos já implementados."*
+   - Se `session_id` existir E `project_path` for DIFERENTE do diretório atual → contexto de outro projeto, **ignorar completamente** e iniciar do zero
+   - Se `project_status: "COMPLETED"` → projeto encerrado, iniciar do zero
 
 4. **Atualizar Memory Agent periodicamente:**
    - A cada 15 minutos de conversa ou a cada 3 agentes executados

package/extracted-skill/tracking-events-generator/agents/memory-agent.json

@@ -1,109 +1,25 @@
-{
+{
   "session_metadata": {
-    "session_id": "CDP_20260327_1506",
-    "started_at": "2026-03-27T14:43:05.000Z",
-    "last_updated": "2026-03-27T18:06:32.000Z",
-    "duration_minutes": 23,
-    "project_path": "c:/Users/comer/COWORK CLAUDE/CDP Edge",
-    "user_id": "comer"
+    "session_id": null,
+    "started_at": null,
+    "last_updated": null,
+    "project_path": null,
+    "user_id": null
   },
   "context_state": {
-    "current_phase": "FASE_5 (Entrega ao Usuário)",
-    "platforms_configured": ["meta", "google", "tiktok", "whatsapp"],
-    "platforms_pending": ["linkedin", "pinterest", "reddit"],
-    "events_mapped": ["Lead", "Purchase", "InitiateCheckout"],
-    "events_implemented": ["Lead", "Purchase", "InitiateCheckout"],
-    "infrastructure_type": "cloudflare-workers"
+    "current_phase": null,
+    "platforms_configured": [],
+    "platforms_pending": [],
+    "events_mapped": [],
+    "events_implemented": [],
+    "infrastructure_type": null
   },
-  "api_versions": {
-    "meta": {
-      "pixel": "v22.0",
-      "capi": "v22.0",
-      "verified_at": "2026-03-27T15:00:00.000Z"
-    },
-    "google": {
-      "ga4": "latest",
-      "measurement_protocol": "v2",
-      "verified_at": "2026-03-27T15:00:00.000Z"
-    },
-    "tiktok": {
-      "pixel": "v1.3",
-      "events_api": "v1.3",
-      "verified_at": "2026-03-27T15:00:00.000Z"
-    }
-  },
-  "technical_decisions": [
-    {
-      "id": "decision_001",
-      "decision": "Purga de infraestrutura legada (GTM, Stape, N8N, EasyPanel, Sheets)",
-      "made_by": "master-orchestrator",
-      "reasoning": "Arquitetura Quantum Tier exige 100% Cloudflare-Native",
-      "timestamp": "2026-03-27T14:30:00.000Z",
-      "status": "implemented"
-    },
-    {
-      "id": "decision_002",
-      "decision": "Implementação das 13 melhorias criticas (ctx.waitUntil, _cdp_uid, HMAC)",
-      "made_by": "validator-agent",
-      "reasoning": "Melhorar performance e resiliência dos webhooks",
-      "timestamp": "2026-03-27T15:00:00.000Z",
-      "status": "implemented"
-    }
-  ],
-  "secrets_configured": {
-    "meta": {
-      "pixel_id": "SET",
-      "access_token": "SET",
-      "verified_at": "2026-03-27T15:00:00.000Z"
-    }
-  },
-  "validator_corrections": [
-    {
-      "id": "correction_001",
-      "agent": "server-tracking",
-      "issue": "Timeout nos webhooks",
-      "fix": "Adicionado ctx.waitUntil e resposta imediata 200 OK",
-      "fixed_by": "validator-agent",
-      "timestamp": "2026-03-27T15:00:00.000Z",
-      "revalidated": true
-    }
-  ],
-  "files_generated": [
-    {
-      "file": "worker.js",
-      "agent": "server-tracking",
-      "status": "updated",
-      "generated_at": "2026-03-27T15:00:00.000Z"
-    },
-    {
-      "file": "zai.skill.ps1",
-      "agent": "user",
-      "status": "generated",
-      "generated_at": "2026-03-27T15:05:00.000Z"
-    }
-  ],
-  "user_notes": [
-    {
-      "id": "note_001",
-      "content": "Novo script de configuração Z.AI adicionado para Claude Code",
-      "timestamp": "2026-03-27T15:06:00.000Z",
-      "priority": "medium"
-    }
-  ],
-  "next_steps": [
-    "Reescrever multi-step-checkout.md para Quantum Tier",
-    "Implementar agentes especialistas para LinkedIn e Microsoft Ads",
-    "Monitorar performance do Identity Graph no D1"
-  ],
-  "session_metrics": {
-    "total_time_minutes": 23,
-    "agents_spawned": 4,
-    "agents_with_errors": 0,
-    "files_generated": 2,
-    "lines_of_code": 150,
-    "corrections_applied": 1,
-    "hallucinations_detected": 0,
-    "interventions_made": 0,
-    "efficiency_score": 100
-  }
+  "api_versions": {},
+  "technical_decisions": [],
+  "secrets_configured": {},
+  "validator_corrections": [],
+  "files_generated": [],
+  "user_notes": [],
+  "next_steps": [],
+  "session_metrics": {}
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.11.0",
+  "version": "1.11.1",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",