cdp-edge 1.11.1 → 1.13.0

package/README.md

@@ -2,20 +2,20 @@
 
 **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
+> **v1.2.2** — 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.
+- **Human-Behavior Engine**: Score de engajamento 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).
+- **Geo Intelligence**: Cidade, estado e CEP em todos os eventos.
 
 ---
 
-## 🏗️ ARQUITETURA QUANTUM (CLOUDFARE NATIVE)
+## 🏗️ ARQUITETURA QUANTUM (CLOUDFLARE NATIVE)
 
-O CDP Edge não é um "script de rastreio", é uma **Content Delivery Network (CDN)** com inteligência de dados acoplada.
+O CDP Edge não é um "script de rastreio", é uma **infraestrutura de borda** com inteligência de dados acoplada.
 
 ```mermaid
 graph TD
@@ -33,168 +33,106 @@ graph TD
 
 ## 🖱 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:
+O sistema é composto por **39+ agentes** coordenados pelo **Master Orchestrator**:
 
 ### 🧠 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). |
+| **Master Orchestrator** | Coordenação central — guia todo o setup do projeto |
+| **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** | Contexto e checkpoints da sessão por projeto |
+| **Intelligence Agent** | Monitoramento de versões de API (Meta v22.0+, etc) |
 
-### 🚀 Despachantes de Plataforma
+### 🚀 Plataformas de Anúncio
 | 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)
+| **Meta Agent** | Facebook Pixel + CAPI v22.0 + WhatsApp CTWA |
+| **Google Agent** | GA4 + Google Ads Enhanced Conversions |
+| **TikTok Agent** | TikTok Pixel + Events API v1.3 |
+| **LinkedIn Agent** | Insight Tag + Conversions API v2 |
+| **Pinterest Agent** | Tag + Conversions API v5 |
+| **Reddit Agent** | Pixel + Conversions API v2.0 |
+| **Spotify Agent** | Pixel + Conversions API v1 |
+| **Bing Agent** | UET Tag + Enhanced Conversions |
+
+### 🛡️ Módulos Enterprise
 | 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. |
+| **Attribution Agent** | Atribuição Multi-Touch de alta fidelidade |
+| **Security Agent** | Rate Limiting, AES-256 e Bot Defense |
+| **Compliance Agent** | LGPD e GDPR (Consent Mode v2) |
+| **Performance Agent** | Otimização de caches e queries D1 |
+| **CRM Integration** | Sincronia D1 ↔ HubSpot/Salesforce |
 
 ---
 
 ## 💻 INSTALAÇÃO E USO
 
-### Instalar Globalmente
-
-```bash
-npm install -g cdp-edge
-cdp-edge --version
-```
+> ⚠️ **Importante:** Execute **um comando por vez** e aguarde terminar antes de rodar o próximo.
 
 ---
 
-## 📋 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.
+### Passo 1 — Instalar o CLI globalmente
 
 ```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
+npm install -g cdp-edge
 ```
 
-**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:**
+Verifique a instalação:
 
 ```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
+cdp-edge --version
 ```
 
 ---
 
-### Outros Comandos
+### Passo 2 — Criar a pasta do projeto e instalar o CDP Edge
 
-#### `setup` — Wizard interativo
+Crie a pasta do projeto, abra o terminal dentro dela e execute:
 
 ```bash
-cdp-edge setup
-cdp-edge setup ./meu-projeto
+cdp-edge install . --name "Nome do 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
+**O que é criado na pasta:**
 
----
-
-#### `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
+| Arquivo/Pasta | Função |
+|---|---|
+| `cdp-edge/` | Skill completa — 39+ agentes, SDK, worker, templates, docs |
+| `.claude/commands/cdp.md` | Habilita o comando `/cdp` no Claude Code |
+| `CLAUDE.md` | Auto-ativação do Orchestrator ao abrir sessão |
 
 ---
 
-#### `server` — Gerar infraestrutura Cloudflare
+### Passo 4 — Abrir no Claude Code e ativar
 
 ```bash
-cdp-edge server .
-cdp-edge server ./meu-worker
+claude .
 ```
 
-**Arquivos gerados:**
-- `worker.js` — Cloudflare Worker completo
-- `schema.sql` — Schema D1
-- `wrangler.toml` — Configuração Wrangler
+Dentro do Claude Code, digite:
 
----
-
-#### `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
+/cdp
 ```
 
+O **Master Orchestrator** inicia e guia todo o setup — plataformas, credenciais e geração da infraestrutura.
+
 ---
 
-## 🔄 CICLO DE VIDA DO SETUP (/setup)
+## 📋 COMANDOS DISPONÍVEIS
 
-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`.
+| Comando | Descrição |
+|---------|-----------|
+| `cdp-edge install [dir]` | **Instala CDP Edge no projeto + habilita /cdp** |
+| `cdp-edge setup [dir]` | Wizard interativo de configuração |
+| `cdp-edge analyze <dir>` | Analisa páginas e detecta eventos |
+| `cdp-edge server <dir>` | Gera infraestrutura Cloudflare Workers + D1 |
+| `cdp-edge validate <file>` | Audita tracking existente |
+| `cdp-edge infra` | Guia de setup de infraestrutura Cloudflare |
+| `cdp-edge --version` | Versão instalada |
+| `cdp-edge --help` | Ajuda completa |
 
 ---
 
@@ -202,25 +140,23 @@ cdp-edge infra
 
 ```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).
+├── README.md
+├── CLAUDE.md                        # Guia de desenvolvimento e padrões
+├── extracted-skill/
 │   └── 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
+├── server-edge-tracker/
+│   ├── worker.js                    # Cloudflare Worker principal
 │   ├── schema.sql                   # D1 Schema (Identity Graph)
 │   └── wrangler.toml                # Bindings: D1 + Queue + KV + AI
-├── bin/                             # CLI Executável (cdp-edge)
+├── bin/                             # CLI Executável
 ├── 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
+│   │   └── .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/
@@ -234,128 +170,108 @@ CDP Edge/
 
 ## 📚 EXEMPLOS DE USO
 
-### Cenário 1: Novo projeto com Claude Code
+### 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"
+# 1. Crie a pasta do projeto e abra o terminal dentro dela
 
-# 2. Abrir no Claude Code
-claude ./landing-page-lead
+# 2. Instalar CDP Edge
+cdp-edge install . --name "Landing Page Lead"
 
-# 3. Ativar o Orchestrator
+# 3. Abrir no Claude Code
+claude .
+
+# 4. Ativar o Orchestrator
 /cdp
-# → CDP Edge inicia, faz perguntas, gera toda a infraestrutura
 ```
 
-### Cenário 2: Apenas Infraestrutura Cloudflare
+### Gerar 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
+### Validar tracking 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
+### Analisar projeto
 
 ```bash
-cdp-edge analyze ./meu-projeto-web
-
-# 📊 Eventos detectados: leads: 2 | purchases: 1 | views: 3
-# 🎯 Nicho identificado: E-commerce
+cdp-edge analyze ./meu-projeto
 ```
 
 ---
 
-## ⚡ COMANDOS RÁPIDOS (CLI)
+## 🔧 SOLUÇÃO DE PROBLEMAS
 
-| 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 |
+### "cdp-edge não é reconhecido"
 
----
+O install não foi concluído. Execute separado e aguarde terminar:
 
-## 🔧 SOLUÇÃO DE PROBLEMAS
+```bash
+npm install -g cdp-edge
+```
+
+```bash
+cdp-edge --version
+```
+
+---
 
-### Erro: "Cannot find module dist/commands/install.js"
+### "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:
+Versão antiga em cache. Reinstale:
 
 ```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"
+---
+
+### "Permissão negada"
 
 Execute o terminal como Administrador (Windows) ou use `sudo` (Mac/Linux).
 
-### Erro: "Módulo não encontrado" (outros módulos)
+---
+
+### Nada foi criado na pasta após `cdp-edge install`
+
+Confirme que o terminal está aberto dentro da pasta do projeto e rode:
 
 ```bash
-npm cache clean --force
-npm uninstall -g cdp-edge
-npm install -g cdp-edge
+cdp-edge install . --name "Nome do Projeto"
 ```
 
 ---
 
-## 🖱️ HUMAN-BEHAVIOR ENGINE (O MOTOR DE INTENÇÃO)
+## 🖱️ HUMAN-BEHAVIOR ENGINE
 
-A joia da coroa do CDP Edge. Capturamos o que o usuário **sente** e **faz**, e não apenas onde ele clica.
+Capturamos o que o usuário **sente** e **faz**, não apenas onde 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.
+| Evento | Pontuação |
+|--------|-----------|
+| Scroll 25–90% | +5 a +15 pts |
+| VSL Watch 25–100% | +10 a +50 pts |
+| Copy Intent (cupom, PIX) | +20 pts |
+| Preenchimento de campo | +10 pts |
+| Rage Click | -10 pts |
+| **Hot Lead (80+ pts)** | **Dispara High_Intent_Lead** |
 
-### 🎥 VSL & Video Tracker
-Monitoramento nativo de retenção em vídeos YouTube e Vimeo sem necessidade de scripts externos pesados.
+**VSL & Video Tracker:** Monitoramento nativo de retenção em YouTube, Vimeo e HTML5 — dropout heatmap incluso.
 
 ---
 
 ## 📞 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
 

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.2.0');
+  .version('1.2.2');
 
 // Comando padrão (wizard interativo)
 program

package/docs/whatsapp-ctwa.md

@@ -120,7 +120,7 @@ A coluna `wamid` tem índice UNIQUE — garante que a mesma mensagem não seja p
 2. Menu lateral → **WhatsApp** → **Configuration**
 3. Seção **Webhook** → clique em **Edit**
 4. Preencha:
-   - **Callback URL:** `https://server-edge-tracker.suporte-ed9.workers.dev/webhook/whatsapp`
+   - **Callback URL:** `https://SEU_WORKER.SEU_USUARIO.workers.dev/webhook/whatsapp`
    - **Verify Token:** valor do secret `WA_WEBHOOK_VERIFY_TOKEN`
 5. Clique em **Verify and Save**
 6. Após verificar, clique em **Manage** → ative o campo **`messages`**
@@ -161,7 +161,7 @@ Depois do `Contact` inicial, você pode enviar eventos adicionais conforme o lea
 Exemplo de chamada para registrar uma venda fechada pelo WhatsApp:
 
 ```javascript
-fetch('https://server-edge-tracker.suporte-ed9.workers.dev/track', {
+fetch('https://SEU_WORKER.SEU_USUARIO.workers.dev/track', {
   method: 'POST',
   headers: { 'Content-Type': 'application/json' },
   body: JSON.stringify({

package/extracted-skill/tracking-events-generator/agents/database-agent.md

@@ -27,10 +27,10 @@ Enquanto o `server-tracking-agent` define **o que o Worker FAZ**, você define *
 ### Worker Ativo
 ```
 Nome:    server-edge-tracker
-URL:     https://server-edge-tracker.suporte-ed9.workers.dev
-Account: suporte@kadoshmkt.com.br
-ID:      ed96c1aa212ab5ab2e97e522b9a0b49b
-Deploy:  2026-03-29 (último)
+URL:     https://SEU_WORKER.SEU_USUARIO.workers.dev
+Account: SEU_EMAIL@SEUDOMINIO.com.br
+ID:      SEU_CLOUDFLARE_ACCOUNT_ID
+Deploy:  (data do último deploy)
 ```
 
 ### `wrangler.toml` — Estado Real
@@ -45,13 +45,13 @@ compatibility_flags = ["nodejs_compat"]
 META_PIXEL_ID      = "SEU_PIXEL_ID"
 GA4_MEASUREMENT_ID = "G-XXXXXXXXXX"
 TIKTOK_PIXEL_ID    = "CXXXXXXXXXXXXXXX"
-SITE_DOMAIN        = "server-edge-tracker.suporte-ed9.workers.dev"
+SITE_DOMAIN        = "SEU_DOMINIO"
 
 # ── D1 Database ───────────────────────────────────────────────────────────────
 [[d1_databases]]
 binding       = "DB"
 database_name = "cdp-edge-db"
-database_id   = "7867d38f-5fa8-4c17-b465-386211422c09"
+database_id   = "SEU_D1_DATABASE_ID"
 
 # ── Workers AI ────────────────────────────────────────────────────────────────
 [ai]
@@ -67,7 +67,7 @@ crons = ["0 2 * * 7", "0 3 1 * *"]
 ## 🗄️ BINDING 1 — D1 DATABASE (`env.DB`)
 
 ### Banco: `cdp-edge-db`
-- **ID:** `7867d38f-5fa8-4c17-b465-386211422c09`
+- **ID:** `SEU_D1_DATABASE_ID`
 - **Região:** ENAM (US East)
 - **Engine:** SQLite (Cloudflare D1)
 - **Tabelas ativas:** 8

package/extracted-skill/tracking-events-generator/agents/devops-agent.md

@@ -0,0 +1,149 @@
+# DevOps Agent — CDP Edge
+
+Você é o **Agente DevOps exclusivo** do CDP Edge. Nenhum outro agente pode executar deploys ou operações de infraestrutura Cloudflare. Toda operação de deploy passa obrigatoriamente por você.
+
+---
+
+## ⚠️ AUTORIDADE EXCLUSIVA
+
+| Operação | Exclusivo? |
+|---|---|
+| `wrangler deploy` | SIM — só você |
+| `wrangler secret put` | SIM — só você |
+| `wrangler d1 execute` (migrações) | SIM — só você |
+| `wrangler kv namespace create` | SIM — só você |
+| Rollback de versão | SIM — só você |
+
+Outros agentes que precisarem de deploy **delegam para você** via `*deploy`.
+
+---
+
+## CICLO DE DEPLOY AUTOMÁTICO
+
+### Comando: `*deploy`
+
+Executa o ciclo completo sem intervenção manual:
+
+```
+1. Recebe os dados reais do Memory Agent
+        ↓
+2. Escreve temporariamente no wrangler.toml:
+   - META_PIXEL_ID, GA4_MEASUREMENT_ID, TIKTOK_PIXEL_ID, SITE_DOMAIN
+   - database_id (D1)
+   - id + preview_id (KV)
+   - [[routes]] do domínio do cliente
+        ↓
+3. Executa: wrangler deploy
+        ↓
+4. Confirma sucesso (Version ID + triggers ativos)
+        ↓
+5. Reverte IMEDIATAMENTE todos os valores para placeholder
+        ↓
+6. Confirma que CDP Edge está limpo (git status)
+```
+
+**O wrangler.toml nunca fica com dados reais após o deploy.**
+
+---
+
+## PROCEDURE `*deploy`
+
+```bash
+# Passo 1 — Receber do Memory Agent:
+# - META_PIXEL_ID, GA4_MEASUREMENT_ID, TIKTOK_PIXEL_ID
+# - SITE_DOMAIN, D1_DATABASE_ID, KV_ID, KV_PREVIEW_ID
+
+# Passo 2 — Aplicar temporariamente no wrangler.toml
+# (substituir placeholders pelos valores reais)
+
+# Passo 3 — Deploy
+cd server-edge-tracker
+wrangler deploy
+
+# Passo 4 — Reverter IMEDIATAMENTE
+# (substituir valores reais pelos placeholders)
+
+# Passo 5 — Verificar limpeza
+git status
+# Esperado: "nothing to commit, working tree clean"
+# Se modificado: git checkout server-edge-tracker/wrangler.toml
+```
+
+---
+
+## PROCEDURE `*migrate`
+
+Aplica migrações D1 em ordem:
+
+```bash
+wrangler d1 execute cdp-edge-db --file=migrate-v2.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v3.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v4.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v5.sql --remote
+wrangler d1 execute cdp-edge-db --file=migrate-v6.sql --remote
+```
+
+Após cada migração: confirmar sucesso antes de prosseguir.
+
+---
+
+## PROCEDURE `*rollback`
+
+Reverte para versão anterior do Worker:
+
+```bash
+# Listar versões disponíveis
+wrangler deployments list
+
+# Fazer rollback para versão específica
+wrangler rollback [VERSION_ID]
+```
+
+---
+
+## PROCEDURE `*secrets`
+
+Configura todos os secrets do cliente na Cloudflare:
+
+```bash
+# Obrigatórios
+wrangler secret put META_ACCESS_TOKEN
+wrangler secret put GA4_API_SECRET
+wrangler secret put WA_ACCESS_TOKEN
+wrangler secret put WA_PHONE_ID
+wrangler secret put WA_NOTIFY_NUMBER
+wrangler secret put WA_WEBHOOK_VERIFY_TOKEN
+
+# Opcionais (conforme plataformas selecionadas)
+wrangler secret put TIKTOK_ACCESS_TOKEN
+wrangler secret put PINTEREST_ACCESS_TOKEN
+wrangler secret put REDDIT_ACCESS_TOKEN
+wrangler secret put LINKEDIN_ACCESS_TOKEN
+wrangler secret put SPOTIFY_ACCESS_TOKEN
+wrangler secret put CALLMEBOT_PHONE
+wrangler secret put CALLMEBOT_APIKEY
+```
+
+---
+
+## PROCEDURE `*smoke-test`
+
+Valida se o Worker está operacional após deploy:
+
+```bash
+# Testar endpoint de health ativo
+curl https://SEU_DOMINIO/health
+
+# Resultado esperado: todos os bindings OK
+# Se algum MISSING: investigar e corrigir antes de prosseguir
+```
+
+---
+
+## REGRAS
+
+1. **Sempre** verificar `git status` após reverter placeholders
+2. **Nunca** commitar com dados reais — se acontecer, reverter imediatamente com `git checkout`
+3. **Sempre** confirmar Version ID após deploy bem-sucedido
+4. **Sempre** rodar `*smoke-test` após `*deploy`
+5. Qualquer falha de deploy: reportar ao Master Orchestrator com o erro completo