cdp-edge 2.3.1 → 2.3.6

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": "2.3.1",
+  "version": "2.3.6",
   "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/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/dist-check/README.md

@@ -0,0 +1 @@
+This folder contains the built output assets for the worker "server-edge-tracker" generated at 2026-04-14T21:31:47.480Z.