cdp-edge 1.24.1 → 1.25.0

package/README.md

@@ -2,7 +2,111 @@
 
 **Padrão Quantum Tracking: 100% Cloudflare Edge.** Sem GTM. Sem Stape. Sem cookies de terceiros.
 
-> **v2.3.0** — TypeScript Nativo · Worker 100% tipado · `types.ts` centralizado · `tsconfig.json` · `tsc --noEmit` zero erros · Cloudflare Workers · Meta CAPI v22.0 · GA4 MP · TikTok Events API v1.3
+> **v2.3.5** — UTMs Obfuscadas & Segmentação de Valor (14 de Abril de 2026) 🏷️
+
+> **v2.3.2** — Governança de Conhecimento Automatizada (13 de Abril de 2026) 🧠
+
+### Novidades
+- graphify obrigatório em todas as sessões (CLAUDE.md)
+- Git hooks instalados (post-commit, post-checkout)
+- Hook corrigido para UTF-8 nativo no Windows
+- Redução de custo documentada (40–90% economia ao navegar grafo)
+- Tripé de documentação sincronizado (README + CLAUDE.md + Business Book)
+
+### Correções
+- Hook post-commit corrigido para encoding UTF-8
+- Rebuild code-only funcional após cada commit
+- Push para ts/main (CDP-Edge-Premium.ts.git) concluído
+
+---
+
+## 📋 CHANGELOG v2.3.5 — UTMs Obfuscadas & Segmentação de Valor (14 de Abril de 2026)
+
+### 🏷️ UTM Agent — Novo Agente para Segmentação de Público
+
+**Problema resolvido:**
+- Múltiplos anúncios com diferentes faixas de valor (ex: imóveis 500k-800k, 800k-1.5M, 1M-3M) precisam ser segmentados corretamente para o Meta criar públicos separados
+- Dados sensíveis (valor de preço) não devem estar visíveis na URL pública por segurança
+
+**Solução implementada:**
+- **UTMs Obfuscadas:** Valores de faixa são convertidos em hash SHA256 truncado (8 caracteres)
+  - `800k-1.5M` → `b4e2a1c9` (obfuscado)
+  - Humans veem: `imovel_b4e2a1c9`
+  - Worker sabe: `faixa_real = "800k-1.5M"` (de-obfuscado)
+
+- **Módulo UTM Enricher:** `server-edge-tracker/modules/utm/utm-enricher.ts`
+  - `obfuscateValue()` — gera hash truncado de 8 caracteres
+  - `deobfuscateValue()` — de-obfusca usando mapeamento
+  - `enrichPayloadWithUTM()` — enriquece payload com segmentação
+  - Integração com Meta CAPI: `external_id` segmentado por hash
+
+- **Schema D1:** `server-edge-tracker/schema-utm.sql`
+  - Tabela `utm_mappings` — persiste mapeamento hash→valor
+  - Colunas em `leads`: `faixa_obfuscada`, `faixa_real`, `faixa_category`
+  - VIEW `leads_segmented` — para dashboard e exports
+
+- **Master Orchestrator Atualizado:** UTM Agent integrado ao fluxo (FASE 2-B)
+  - Ordem: Page Analyzer → **UTM Agent** → Premium Intelligence → Browser Tracking
+  - Arquivo: `extracted-skill/tracking-events-generator/agents/utm-agent.md`
+
+**Fluxo de criação de projeto:**
+```
+USUÁRIO INICIA CDP EDGE
+    ↓
+FASE 1: Seleção de plataformas + credenciais
+    ↓
+FASE 2: Page Analyzer (identifica tipo de página)
+    ↓
+FASE 2-B: UTM Agent ← NOVO
+    → Pergunta: "Qual a faixa de valor deste imóvel?"
+    → Gera: URL obfuscada + mapeamento hash→valor
+    ↓
+FASE 3+: Continua fluxo normal (Premium Intelligence, Browser Tracking, etc.)
+```
+
+**Segmentação na Meta:**
+```
+Públicos criados automaticamente via external_id segmentado:
+- Público LOW:  cdp_uid_8a3f1d2b  (500k-800k)
+- Público MID:  cdp_uid_b4e2a1c9  (800k-1.5M)
+- Público HIGH: cdp_uid_d6c3b4e7   (1M-3M)
+```
+
+**Remarketing futuro:**
+```sql
+-- Exportar público por faixa para Meta Custom Audience
+SELECT email, phone, city, state
+FROM leads_segmented
+WHERE faixa_real = '800k-1.5M'
+  AND created_at >= datetime('now', '-30 days');
+```
+
+### Correções
+
+- Documentação sincronizada: README.md + CLAUDE.md + Business Book
+- Versões alinhadas: package.json, CHANGELOG, README
+- Referências cruzadas: agents, modules, schemas
+
+### Breaking Changes
+
+- Nenhuma. API HTTP e comportamento em runtime são idênticos.
+
+### Migração
+
+Para projetos existentes:
+```bash
+# Aplicar schema UTM (adicional)
+cd server-edge-tracker
+wrangler d1 execute cdp-edge-db --file=schema-utm.sql --remote
+
+# Configurar utm-mapping.json (manual ou via UTM Agent)
+cp config/utm-mapping.json.example config/utm-mapping.json
+
+# Deploy
+wrangler deploy
+```
+
+---
 
 > ⚠️ **REGRA DE OURO (SQUAD):** Todas as atualizações, correções ou novas features devem OBRIGATORIAMENTE ser documentadas de forma sincronizada neste `README.md`, no arquivo de instruções `CLAUDE.md` e no dossiê de diretoria `CDP-EDGE-BUSINESS-BOOK.md`. Nenhuma alteração passa sem esse tripé.
 
@@ -27,6 +131,29 @@ Meu ecossistema opera como um Cérebro de Conversão Privado na borda. Quando um
 
 ---
 
+## 📋 CHANGELOG v2.3.1 — Hardening Enterprise (12 de Abril de 2026)
+
+### 🔒 Segurança & Conformidade
+
+- **PII removido dos logs:** `DeviceGraph` parou de logar `user_id` nos Workers logs — dados sensíveis nunca aparecem no Cloudflare dashboard
+- **Deploy seguro:** novo `deploy-client.js` — lê credenciais de `.client.env` (gitignored), gera `wrangler.deploy.toml` temporário, faz deploy e autodestrói o arquivo. Credenciais de cliente nunca entram no repo
+- **`.gitignore` reforçado:** `.client.env` e `wrangler.deploy.toml` explicitamente ignorados
+- **WhatsApp secrets alinhados à Meta Cloud API v22.0:** `resolvePhoneNumberId()` e `resolveAccessToken()` com fallback canônico → legado — backwards compat garantido
+- **`api-versions.json` v1.1.0:** metadata `updated_at` corrigido para `2026-04-12`
+- **`/health` WhatsApp:** reflete corretamente secrets com nomes canônicos ou legados
+
+### 🔧 Deploy de Cliente — Novo Fluxo
+
+```bash
+cd server-edge-tracker
+cp .client.env.example .client.env
+# preencher DATABASE_ID, SITE_DOMAIN, pixels
+node deploy-client.js --dry-run   # valida sem subir
+node deploy-client.js             # deploy real
+```
+
+---
+
 ## 📋 CHANGELOG v2.3.0 — TypeScript Nativo (12 de Abril de 2026)
 
 ### 🔷 Worker 100% TypeScript — Migração Completa
@@ -327,6 +454,42 @@ wrangler deploy
 
 ---
 
+## 🗺️ NAVEGANDO O CÓDIGO COM GRAPHIFY
+
+O **graphify** gera um mapa de conhecimento navegável do projeto (nós, arestas, comunidades). Antes de qualquer trabalho de código:
+
+```bash
+# 1. Verifique se o grafo existe
+ls graphify-out/GRAPH_REPORT.md
+
+# 2. Se não existe ou está desatualizado, gere:
+/graphify .
+
+# 3. Navegue o grafo para entender arquitetura
+/graphify query "como funciona o fraud gate?"
+/graphify query "identity graph → ltv prediction"
+/graphify path "cdp_uid" "cloudflare d1"
+```
+
+### O que o grafo fornece
+
+- **God Nodes**: abstrações centrais (D1, Meta CAPI v22.0, Intelligence Agent, ML Clustering)
+- **65 comunidades**: grupos lógicos (Multi-Platform Agent Layer, ML Bidding, Browser SDK, etc.)
+- **Surprising Connections**: relações inferidas entre conceitos que você não sabia que eram similares
+- **Redução de custo**: navegar grafo = até 40% menos tokens vs. ler arquivos brutos
+
+### Exemplo de uso
+
+**❌ Não faça:**
+> "Ler 50 arquivos para entender como o fraud gate conecta com o LTV predictor"
+
+**✅ Faça:**
+> `/graphify query "fraud gate → ltv predictor"` — resposta instantânea com caminho completo, arquivos fonte e nível de confiança
+
+O grafo fica atualizado automaticamente após cada `git commit` (via hook).
+
+---
+
 ## 🖱️ HUMAN-BEHAVIOR ENGINE
 
 | Evento | Pontuação |

package/contracts/agent-versions.json

@@ -172,6 +172,20 @@
       ],
       "status": "synced"
     },
+    "utm-agent": {
+      "version": "1.0.0",
+      "last_synced": "2026-04-14",
+      "depends_on": [
+        "modules/utm/utm-enricher.ts:enrichPayloadWithUTM",
+        "server-edge-tracker/config/utm-mapping.json"
+      ],
+      "critical_sections": [
+        "UTM obfuscation pattern",
+        "hash truncation length (8)",
+        "mapping config file"
+      ],
+      "status": "synced"
+    },
     "security-enterprise-agent": {
       "version": "2.0.7",
       "last_synced": "2026-04-10",

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

@@ -65,6 +65,7 @@ Master Orchestrator (você)
 │
 ├── 📊 ANÁLISE E ESTRATÉGIA
 │   ├── Page Analyzer Agent                → lê arquivos, mapeia eventos e elementos
+│   ├── UTM Agent                         → gera UTMs obfuscadas para segmentação de valor
 │   ├── Premium Tracking Intelligence Agent → define estratégia de tracking premium
 │   ├── Tracking Plan Agent                → gera plano de eventos por tipo de negócio
 │   └── Intelligence Agent                 → monitora versões de API, saúde do sistema
@@ -143,6 +144,7 @@ SKILL_BASE: [diretório da skill tracking-events-generator]
     │
     ├── ── ANÁLISE E ESTRATÉGIA ──
     ├── page-analyzer.md                      ← análise de páginas e elementos
+    ├── utm-agent.md                         ← gera UTMs obfuscadas para segmentação de valor
     ├── premium-tracking-intelligence-agent.md ← estratégia de tracking premium
     ├── tracking-plan-agent.md                ← plano de eventos por tipo de negócio
     ├── intelligence-agent.md                 ← monitor de versões de API + saúde
@@ -308,6 +310,59 @@ Perguntar ao cliente qual opção se aplica:
 
 ---
 
+### 🏷️ FASE 2-B: UTM Agent
+
+**ENTRA EM AÇÃO:** Após FASE 2 (Page Analyzer completo), antes de Premium Tracking Intelligence
+
+**INPUT RECEBIDO:**
+- JSON do Page Analyzer Agent (tipo de página, categoria do produto)
+- Contexto do negócio (imóveis, automotivos, cursos, etc)
+
+**RESPONSABILIDADE:**
+- Perguntar ao usuário sobre faixas de valor/categoriação do produto
+- Gerar UTMs obfuscadas (hash SHA256 + truncate) para proteger valores sensíveis
+- Criar mapeamento reversível em `server-edge-tracker/config/utm-mapping.json`
+- Integrar com Worker para de-obfuscação no runtime
+
+**SAÍDA:**
+```json
+{
+  "utm_strategy": {
+    "pattern": "{source}/{medium}/{category}_{obfuscated_range}",
+    "obfuscation_method": "sha256",
+    "hash_truncate_length": 8
+  },
+  "obfuscated_utms": [
+    {
+      "campaign": "imovel_8a3f1d2b",
+      "content": "product_9c4e2a1f",
+      "original_range": "700k-1M",
+      "obfuscated_hash": "8a3f1d2b",
+      "category": "imovel",
+      "pixel_audience": "AUDIENCE_MID"
+    }
+  ],
+  "worker_mapping": {
+    "file": "server-edge-tracker/config/utm-mapping.json",
+    "mappings": [
+      {
+        "obfuscated": "8a3f1d2b",
+        "original": "700k-1M",
+        "category": "imovel",
+        "pixel_audience": "AUDIENCE_MID"
+      }
+    ]
+  }
+}
+```
+
+**NÃO FAZ:**
+- ❌ Expor valores reais na URL pública
+- ❌ Fazer obfuscação sem mapeamento reversível
+- ❌ Gera código de tracking (responsabilidade do Browser Tracking Agent)
+
+---
+
 ### 🧠 FASE 3: Premium Tracking Intelligence Agent
 
 **ENTRA EM AÇÃO:** Após FASE 2 (Page Analyzer completo)
@@ -1413,13 +1468,14 @@ Com base nas plataformas selecionadas, spawnar os agentes em paralelo utilizando
 Antes de spawnar agentes em paralelo, seguir esta ordem **OBRIGATÓRIA**:
 
 1. **Page Analyzer Agent** → Analisa páginas e gera mapa de eventos
-2. **Premium Tracking Intelligence Agent** → Define estratégia de tracking (events, micro-events, behavioral signals)
-3. **Browser Tracking Agent** → Gera cdpTrack.js com micro-events (scroll, time, video, heatmap)
-4. **Meta Agent** → Gera código Meta Pixel + CAPI v22.0
-5. **Google Agent** → Gera código GA4 + Google Ads
-6. **TikTok Agent** → Gera código TikTok Pixel + Events API v1.3
-7. **Server Tracking Agent** → Gera Cloudflare Worker + D1 + Queue com engagement scoring
-8. **Webhook Agent** → Gera roteamento de conversões offline
+2. **UTM Agent** → Gera UTMs obfuscadas para segmentação de valor
+3. **Premium Tracking Intelligence Agent** → Define estratégia de tracking (events, micro-events, behavioral signals)
+4. **Browser Tracking Agent** → Gera cdpTrack.js com micro-events (scroll, time, video, heatmap)
+5. **Meta Agent** → Gera código Meta Pixel + CAPI v22.0
+6. **Google Agent** → Gera código GA4 + Google Ads
+7. **TikTok Agent** → Gera código TikTok Pixel + Events API v1.3
+8. **Server Tracking Agent** → Gera Cloudflare Worker + D1 + Queue com engagement scoring
+9. **Webhook Agent** → Gera roteamento de conversões offline
 
 **Regra de Ouro:** Cada agente entra em ação APENAS na sua etapa específica. Nenhum agente entra antes do anterior terminar.
 
@@ -1440,13 +1496,14 @@ Com base nas plataformas selecionadas, spawnar os agentes em paralelo utilizando
 Antes de spawnar agentes em paralelo, seguir esta ordem **OBRIGATÓRIA**:
 
 1. **Page Analyzer Agent** → Analisa páginas e gera mapa de eventos
-2. **Premium Tracking Intelligence Agent** → Define estratégia de tracking (events, micro-events, behavioral signals)
-3. **Browser Tracking Agent** → Gera cdpTrack.js com micro-events (scroll, time, video, heatmap)
-4. **Meta Agent** → Gera código Meta Pixel + CAPI
-5. **Google Agent** → Gera código GA4 + Google Ads
-6. **TikTok Agent** → Gera código TikTok Pixel + Events API
-7. **Server Tracking Agent** → Gera Cloudflare Worker + D1 + Queue com engagement scoring
-8. **Webhook Agent** → Gera roteamento de conversões offline de Gateways de Pagamento
+2. **UTM Agent** → Gera UTMs obfuscadas para segmentação de valor
+3. **Premium Tracking Intelligence Agent** → Define estratégia de tracking (events, micro-events, behavioral signals)
+4. **Browser Tracking Agent** → Gera cdpTrack.js com micro-events (scroll, time, video, heatmap)
+5. **Meta Agent** → Gera código Meta Pixel + CAPI
+6. **Google Agent** → Gera código GA4 + Google Ads
+7. **TikTok Agent** → Gera código TikTok Pixel + Events API
+8. **Server Tracking Agent** → Gera Cloudflare Worker + D1 + Queue com engagement scoring
+9. **Webhook Agent** → Gera roteamento de conversões offline de Gateways de Pagamento
 
 **Regra de Ouro:** Cada agente entra em ação APENAS na sua etapa específica. Nenhum agente entra antes do anterior terminar.
 

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

@@ -0,0 +1,191 @@
+# UTM Agent — Agente de Geração de UTMs Obfuscadas
+
+## Role
+Especialista em gerar estruturas de UTM parametrizadas para segmentação de público, com valores **obfuscados/racheados** para proteção de dados sensíveis na URL.
+
+## When This Agent Runs
+- Após o **Page Analyzer** identificar o tipo de página/produto
+- Antes de gerar os parâmetros de tracking no SDK
+- Quando o usuário precisa configurar campanhas com categorização de valor
+
+## Inputs from Page Analyzer
+```json
+{
+  "page_type": "produto",
+  "product_category": "imovel" | "automotivo" | "curso" | "outros",
+  "url": "https://lançamentosabc.com.br/apartamento-123",
+  "existing_utms": {} // se houver
+}
+```
+
+## Workflow
+
+### 1. Identificar necessidade de UTM
+- Se `product_category` existir, perguntar ao usuário sobre categorização de valor
+- Exemplos de perguntas:
+  - Para **imóveis**: "Qual a faixa de preço deste imóvel? Ex: 500k-800k, 800k-1.5M, 1M-3M"
+  - Para **automotivos**: "Qual a faixa de valor? Ex: 50k-100k, 100k-200k, 200k-500k"
+  - Para **cursos**: "Qual o nível/preço? Ex: básico-49, premium-199, pro-999"
+
+### 2. Gerar estrutura de UTM obfuscada
+
+Para cada categoria informada pelo usuário, gerar:
+
+```json
+{
+  "utm_strategy": {
+    "source": "facebook", // padrão, configurável
+    "medium": "cpc",      // padrão, configurável
+    "campaign": {
+      "pattern": "{product_category}_{obfuscated_range}",
+      "example": "imovel_8a3f1d2b"
+    },
+    "content": {
+      "pattern": "product_{obfuscated_id}",
+      "example": "product_9c4e2a1f"
+    },
+    "faixa_obfuscada": {
+      "original": "700k-1M",
+      "obfuscated": "8a3f1d2b",
+      "hash_method": "sha256",
+      "salt": "CDP_EDGE_UTM_SALT"
+    }
+  }
+}
+```
+
+### 3. Mapeamento reversível (para o Worker)
+Gerar o arquivo `utm-mapping.json` com:
+
+```json
+{
+  "obfuscation_config": {
+    "method": "sha256",
+    "salt": "CDP_EDGE_UTM_SALT",
+    "truncated_length": 8
+  },
+  "mappings": [
+    {
+      "obfuscated": "8a3f1d2b",
+      "original": "700k-1M",
+      "category": "imovel",
+      "pixel_audience": "AUDIENCE_MID",
+      "platform_specific": {
+        "meta": { "custom_audience_id": "2385xxx" },
+        "tiktok": { "pixel_id": "C1xxx" }
+      }
+    }
+  ]
+}
+
+### 4. Perguntas ao usuário (interativo)
+
+**Para imóveis:**
+> "Identifiquei que esta página é um imóvel. Qual a faixa de preço?
+> - 1) 500k-800k
+> - 2) 800k-1.5M
+> - 3) 1M-3M
+> - 4) 3M-5M
+> - 5) Outro (especifique)"
+
+**Para automotivos:**
+> "Qual a faixa de valor do veículo?
+> - 1) 50k-100k
+> - 2) 100k-200k
+> - 3) 200k-500k
+> - 4) Outro (especifique)"
+
+**Para outros produtos:**
+> "Qual a categoria de valor deste produto?
+> - 1) Entry level (até R$500)
+> - 2) Mid-range (R$500-5k)
+> - 3) Premium (R$5k-50k)
+> - 4) Luxury (acima de R$50k)
+> - 5) Outro (especifique)"
+
+### 5. Gerar código do SDK com UTMs obfuscadas
+
+```javascript
+// cdpTrack.js - snippet gerado
+const utmConfig = {
+  faixa_imovel: '8a3f1d2b', // obfuscado
+  product_id: '9c4e2a1f',  // obfuscado
+  source: 'facebook',
+  medium: 'cpc'
+};
+
+cdpTrack('Lead', {
+  utm: utmConfig,
+  // ... outros campos
+});
+```
+
+## Output Structure
+
+```json
+{
+  "agent": "utm-agent",
+  "version": "1.0.0",
+  "utm_strategy": {
+    "pattern": "{source}/{medium}/{category}_{obfuscated_range}",
+    "base_url": "https://lançamentosabc.com.br"
+  },
+  "obfuscated_utms": [
+    {
+      "campaign": "imovel_8a3f1d2b",
+      "content": "product_9c4e2a1f",
+      "original_range": "700k-1M",
+      "obfuscated_hash": "8a3f1d2b"
+    }
+  ],
+  "worker_mapping": {
+    "file": "utm-mapping.json",
+    "location": "server-edge-tracker/config/utm-mapping.json"
+  },
+  "sdk_integration": {
+    "file": "cdpTrack.js",
+    "snippet": "// UTM obfuscado\nconst utmObfuscado = '8a3f1d2b';"
+  }
+}
+```
+
+## Integração com Outros Agentes
+
+1. **Page Analyzer** → informa tipo de produto
+2. **UTM Agent** → pergunta faixa de valor, gera UTMs obfuscadas
+3. **Meta Agent** → recebe UTMs, configura custom audiences
+4. **TikTok Agent** → recebe UTMs, configura pixel events
+5. **Worker** → usa `utm-enricher.ts` para de-obfuscar no runtime
+
+## Edge Cases
+
+- Usuário não sabe a faixa de valor: "Aguardo definição do cliente - use DEFAULT"
+- Produto sem faixa definida: usar `generic_00000000`
+- UTMs existentes: fazer merge sem sobrescrever
+- Múltiplas categorias: perguntar se precisa de segmentação composta
+
+## Example Session
+
+**Page Analyzer:**
+> "Página identificada: imóvel em Vila Mariana, 3 quartos, 2 banheiros"
+
+**UTM Agent:**
+> "Para qual faixa de preço este imóvel deve ser categorizado?"
+>
+> Usuário: "800k-1.5M"
+>
+> **UTM Agent:**
+> ```json
+> {
+>   "utm_faixa": "imovel_b4e2a1c9",
+>   "original_range": "800k-1.5M",
+>   "hash": "b4e2a1c9"
+> }
+> ```
+
+## Rules
+1. **NUNCA** revelar o valor real na URL pública
+2. **SEMPRE** usar hash obfuscado para valores sensíveis
+3. **Mapeamento reversível** deve estar disponível no Worker (não no SDK)
+4. **Meta CAPI** recebe valor de-obfuscado internamente
+5. UTMs sem valor sensível podem ficar em texto claro

package/package.json

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

package/server-edge-tracker/.client.env.example

@@ -0,0 +1,14 @@
+# CDP Edge — Variáveis do cliente para deploy
+# Copie este arquivo para .client.env e preencha com os dados reais.
+# .client.env é gitignored — NUNCA commitado.
+
+# Cloudflare D1 — obter com: wrangler d1 list
+DATABASE_ID=SEU_DATABASE_ID
+
+# Domínio do projeto (sem https://)
+SITE_DOMAIN=seudominio.com.br
+
+# Pixels de rastreamento (opcional — deixar vazio se não usar)
+META_PIXEL_ID=
+GA4_MEASUREMENT_ID=
+TIKTOK_PIXEL_ID=

package/server-edge-tracker/config/utm-mapping.json

@@ -0,0 +1,64 @@
+{
+  "version": "1.0.0",
+  "config": {
+    "method": "sha256",
+    "salt": "CDP_EDGE_UTM_SALT",
+    "truncated_length": 8
+  },
+  "mappings": [],
+  "examples": {
+    "imoveis": [
+      {
+        "obfuscated": "8a3f1d2b",
+        "original": "500k-800k",
+        "category": "imovel",
+        "pixel_audience": "AUDIENCE_LOW",
+        "platform_specific": {
+          "meta": { "custom_audience_id": "2385xxx_LOW" },
+          "tiktok": { "pixel_id": "C1xxx_LOW" }
+        }
+      },
+      {
+        "obfuscated": "b4e2a1c9",
+        "original": "800k-1.5M",
+        "category": "imovel",
+        "pixel_audience": "AUDIENCE_MID",
+        "platform_specific": {
+          "meta": { "custom_audience_id": "2385xxx_MID" },
+          "tiktok": { "pixel_id": "C1xxx_MID" }
+        }
+      },
+      {
+        "obfuscated": "d6c3b4e7",
+        "original": "1M-3M",
+        "category": "imovel",
+        "pixel_audience": "AUDIENCE_HIGH",
+        "platform_specific": {
+          "meta": { "custom_audience_id": "2385xxx_HIGH" },
+          "tiktok": { "pixel_id": "C1xxx_HIGH" }
+        }
+      }
+    ],
+    "automotivos": [
+      {
+        "obfuscated": "e7a5b3d1",
+        "original": "50k-100k",
+        "category": "automotivo",
+        "pixel_audience": "AUDIENCE_ENTRY"
+      },
+      {
+        "obfuscated": "f4c8d2a6",
+        "original": "100k-200k",
+        "category": "automotivo",
+        "pixel_audience": "AUDIENCE_MID"
+      },
+      {
+        "obfuscated": "a9b1e4c3",
+        "original": "200k-500k",
+        "category": "automotivo",
+        "pixel_audience": "AUDIENCE_PREMIUM"
+      }
+    ]
+  },
+  "instructions": "Preencha o array 'mappings' com as categorias do seu projeto. Use o comando 'node scripts/sync-agents.js' para sincronizar com o Agente UTM."
+}

package/server-edge-tracker/deploy-client.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+/**
+ * CDP Edge — deploy-client.js
+ *
+ * Deploy do Worker com variáveis reais do cliente, sem commitar credenciais no repo.
+ * Lê de .client.env (gitignored) e gera um wrangler.deploy.toml temporário.
+ *
+ * Uso:
+ *   node deploy-client.js           → deploy completo
+ *   node deploy-client.js --dry-run → valida sem subir ao Cloudflare
+ *
+ * Setup:
+ *   cp .client.env.example .client.env
+ *   # edite .client.env com os valores do cliente
+ *   node deploy-client.js
+ */
+
+const fs   = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const ROOT    = __dirname;
+const TOML    = path.join(ROOT, 'wrangler.toml');
+const DEPLOY  = path.join(ROOT, 'wrangler.deploy.toml');
+const ENV     = path.join(ROOT, '.client.env');
+const DRY_RUN = process.argv.includes('--dry-run');
+
+// ── Carregar .client.env ──────────────────────────────────────────────────────
+if (!fs.existsSync(ENV)) {
+  console.error('\n❌  .client.env não encontrado.');
+  console.error('   cp .client.env.example .client.env  e preencha os valores do cliente.\n');
+  process.exit(1);
+}
+
+const env = {};
+fs.readFileSync(ENV, 'utf8').split('\n').forEach(line => {
+  const trimmed = line.trim();
+  if (!trimmed || trimmed.startsWith('#')) return;
+  const [key, ...rest] = trimmed.split('=');
+  if (key) env[key.trim()] = rest.join('=').trim();
+});
+
+const required = ['DATABASE_ID', 'SITE_DOMAIN'];
+const missing  = required.filter(k => !env[k]);
+if (missing.length > 0) {
+  console.error(`\n❌  Variáveis obrigatórias faltando no .client.env: ${missing.join(', ')}\n`);
+  process.exit(1);
+}
+
+// ── Substituir placeholders no wrangler.toml → wrangler.deploy.toml ───────────
+let toml = fs.readFileSync(TOML, 'utf8');
+
+toml = toml
+  .replace(/SEU_DATABASE_ID/g,  env.DATABASE_ID)
+  .replace(/SEU_DOMINIO/g,       env.SITE_DOMAIN)
+  .replace(/META_PIXEL_ID\s*=\s*""/,      `META_PIXEL_ID      = "${env.META_PIXEL_ID      || ''}"`)
+  .replace(/GA4_MEASUREMENT_ID\s*=\s*""/,  `GA4_MEASUREMENT_ID = "${env.GA4_MEASUREMENT_ID || ''}"`)
+  .replace(/TIKTOK_PIXEL_ID\s*=\s*""/,     `TIKTOK_PIXEL_ID    = "${env.TIKTOK_PIXEL_ID    || ''}"`);
+
+fs.writeFileSync(DEPLOY, toml);
+
+// ── Executar wrangler deploy ──────────────────────────────────────────────────
+const cmd = `wrangler deploy --config wrangler.deploy.toml${DRY_RUN ? ' --dry-run' : ''}`;
+console.log(`\n🚀  ${DRY_RUN ? '[DRY-RUN] ' : ''}Deploying com config do cliente...\n`);
+
+try {
+  execSync(cmd, { stdio: 'inherit', cwd: ROOT });
+  console.log(`\n✅  Deploy ${DRY_RUN ? '(dry-run) ' : ''}concluído.\n`);
+} catch (err) {
+  console.error('\n❌  Deploy falhou.\n');
+  process.exit(1);
+} finally {
+  // sempre remove o arquivo temporário
+  if (fs.existsSync(DEPLOY)) fs.unlinkSync(DEPLOY);
+  console.log('🧹  wrangler.deploy.toml removido.\n');
+}