cdp-edge 1.10.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

@@ -11,13 +11,14 @@ 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.0.0');
+  .version('1.2.0');
 
 // Comando padrão (wizard interativo)
 program
@@ -50,4 +51,11 @@ program
   .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);

package/docs/CI-CD-SETUP.md

@@ -0,0 +1,217 @@
+# CDP Edge - Setup CI/CD e Versionamento Automático
+
+## Fluxo Escolhido
+
+Escolha **UMA** das opções:
+
+| Opção | Versão | Quando usar |
+|-------|--------|------------|
+| **semantic-release** | Automática | Commits convencionais, time pequeno |
+| **Manual workflow** | Controlada | Quer aprovar cada release |
+
+---
+
+## PASSO 1: Criar Conta e Token no npm
+
+```bash
+# 1. Criar conta em https://www.npmjs.com/signup
+
+# 2. Login
+npm login
+
+# 3. Criar token de automação
+# Vá em: https://www.npmjs.com/settings/tokens
+# - Clique "Create New Token"
+# - Nome: "GitHub Actions"
+# - Tipo: "Automation"
+# - Copie o token gerado
+```
+
+---
+
+## PASSO 2: Configurar Secrets no GitHub
+
+Vá no repositório: `Settings` → `Secrets and variables` → `Actions` → `New repository secret`
+
+**Adicione:**
+
+| Nome | Valor |
+|------|-------|
+| `NPM_TOKEN` | Token do passo 1 |
+| `GITHUB_TOKEN` | Já existe automaticamente (não precisa criar) |
+
+---
+
+## PASSO 3: Configurar o Workflow
+
+### Opção A: semantic-release (Automática)
+
+```bash
+# 1. Adicionar dependências
+npm install -D semantic-release @semantic-release/changelog @semantic-release/commit-analyzer @semantic-release/github @semantic-release/npm @semantic-release/release-notes-generator
+
+# 2. O arquivo .releaserc.json já está criado
+# 3. O workflow .github/workflows/release.yml já está criado
+# 4. Commit e push
+git add .
+git commit -m "ci: add semantic-release automation"
+git push
+```
+
+**Como usar:**
+
+```bash
+# Nova feature
+git commit -m "feat: add Reddit support"
+
+# Bugfix
+git commit -m "fix: correct TikTok endpoint"
+
+# Breaking change
+git commit -m "feat!: remove GTM support"
+# ou
+git commit -m "feat: add new API
+
+BREAKING CHANGE: requires Node 20+"
+```
+
+Ao fazer push no `main`, o release é automático!
+
+---
+
+### Opção B: Manual Workflow
+
+```bash
+# 1. O arquivo .github/workflows/publish.yml já está criado
+# 2. Commit e push
+git add .
+git commit -m "ci: add manual publish workflow"
+git push
+```
+
+**Como usar:**
+
+1. Vá em: `Actions` → `Publish to npm`
+2. Clique `Run workflow`
+3. Escolha o tipo: `patch`, `minor` ou `major`
+4. Clique `Run workflow`
+
+---
+
+## PASSO 4: Configurar Conventional Commits (Opcional mas recomendado)
+
+```bash
+# Instalar commitlint
+npm install -D @commitlint/cli @commitlint/config-conventional
+
+# Criar commitlint.config.js
+echo "export default { extends: ['@commitlint/config-conventional'] };" > commitlint.config.js
+
+# Adicionar ao package.json scripts
+# "prepare": "husky install"
+# "commitlint": "commitlint --edit"
+
+# Instalar husky
+npm install -D husky
+npx husky install
+npx husky add .husky/commit-msg 'npx --no -- commitlint --edit "$1"'
+```
+
+Agora commits inválidos são bloqueados!
+
+---
+
+## Fluxo Completo de Desenvolvimento
+
+```
+Desenvolvimento
+      ↓
+git commit -m "feat: nova funcionalidade"
+      ↓
+git push origin main
+      ↓
+GitHub Actions detecta push
+      ↓
+    ┌─────────┐
+    │ semantic-│  (se Opção A)
+    │ release  │──→ Calcula versão
+    └─────────┘
+      ↓
+    ┌─────────┐
+    │  CI/CD  │──→ Build + Test
+    └─────────┘
+      ↓
+    ┌─────────┐
+    │ Publish │──→ npm publish
+    │  npm    │
+    └─────────┘
+      ↓
+    ┌─────────┐
+    │GitHub   │──→ Criar Release
+    │ Release │    + Changelog
+    └─────────┘
+```
+
+---
+
+## Verificação
+
+```bash
+# Ver releases criados
+npm view cdp-edge versions
+
+# Ver changelog
+# Vá em: https://github.com/seu-usuario/cdp-edge/releases
+```
+
+---
+
+## Solução de Problemas
+
+### Erro: "401 Unauthorized"
+→ Verifique se `NPM_TOKEN` está correto no GitHub Secrets
+
+### Erro: "403 Forbidden"
+→ Verifique se o nome do pacote está disponível no npm
+
+### Release não aparece
+→ Verifique se o workflow falhou em `Actions`
+
+---
+
+## Dicas Avançadas
+
+### Pre-release (beta, alpha)
+
+```bash
+git commit -m "feat: add beta feature
+
+Release: 1.1.0-beta.1"
+```
+
+### Ignorar commits no release
+
+```
+# .releaserc.json
+{
+  "branches": ["main"],
+  "tagFormat": "v${version}",
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    {
+      "preset": "conventionalcommits",
+      "releaseRules": [
+        { "type": "chore", "scope": "deps", "release": "patch" }
+      ]
+    }
+  ]
+}
+```
+
+### Multiple publish channels
+
+Use scopes para diferentes canais:
+```bash
+npm publish --tag beta    # @beta
+npm publish --tag next    # @next
+```