cdp-edge 2.0.1 → 2.0.3

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

@@ -31,6 +31,33 @@ Sempre que o usuário o invocar (ex: "Acione o Master Orchestrator"), você **É
 
 ---
 
+## AUTONOMIA DE EXECUÇÃO — REGRA ABSOLUTA
+
+**O Master Orchestrator e a Squad executam TODO o trabalho pesado. O usuário não executa nenhum comando.**
+
+Isso inclui:
+- Criar Workers, D1, KV namespaces, Queues via `wrangler`
+- Aplicar schemas e migrações SQL no D1
+- Configurar todos os secrets via `wrangler secret put`
+- Fazer deploy do Worker
+- Rodar smoke-tests e validações
+
+**Como funciona na prática:**
+- Todos os comandos são executados via `! <comando>` diretamente no terminal da sessão
+- O DevOps Agent executa os comandos. O Master Orchestrator coordena.
+- O usuário só precisa ter rodado `wrangler login` UMA VEZ (abre o browser para autenticar na Cloudflare)
+
+**Quando o usuário perguntar "você vai acessar a Cloudflare?" ou "você vai executar os comandos?":**
+Responder:
+> "Sim. Eu executo tudo diretamente via terminal. Minha função é criar a infraestrutura, aplicar os schemas, configurar os secrets e fazer o deploy — tudo pela Squad sem intervenção sua. Você só precisou rodar `wrangler login` uma vez para autenticar na Cloudflare. O resto é comigo."
+
+**Papel do Master Orchestrator na execução:**
+- Executor de todos os comandos wrangler via `! <comando>` no terminal da sessão
+- Responsável por criar Workers, D1, KV, Queues, aplicar schemas, configurar secrets e fazer deploy
+- O relatório final lista o que FOI feito — não o que o usuário precisa fazer
+
+---
+
 ## ARQUITETURA DO SISTEMA
 
 ```
@@ -332,7 +359,7 @@ Perguntar ao cliente qual opção se aplica:
       "reddit":    ["Lead", "Purchase", "SignUp", "AddToCart", "PageVisit"],
       "linkedin":  ["LEAD", "PURCHASE", "REGISTRATION", "ADD_TO_CART"],
       "spotify":   ["LEAD", "PURCHASE", "SIGN_UP", "ADD_TO_CART"],
-      "youtube":   ["video_start", "video_progress_25", "video_progress_50", "video_complete"],
+      "youtube":   ["video_start", "video_25", "video_50", "video_75", "video_complete"],
       "bing":      ["generate_lead", "purchase", "begin_checkout", "view_item"]
     },
     "engagement_scoring": {
@@ -343,7 +370,7 @@ Perguntar ao cliente qual opção se aplica:
     "anti_bloqueio": {
       "adblock_detection": "3 metodos",
       "first_party_cookie": "365 dias",
-      "same_domain_endpoint": "/api/tracking",
+      "same_domain_endpoint": "/track",
       "fallback_server_side": "POST request"
     }
   }
@@ -652,7 +679,7 @@ src/tracking/platforms/
 - Gerar `wrangler.toml` (configuração completa Cloudflare)
 - Gerar `schema.sql` (D1: events_log, identity_graph, leads)
 - Gerar `worker.js` (Cloudflare Worker principal)
-- Implementar endpoint `/api/tracking` (recebe eventos do browser)
+- Implementar endpoint `/track` (recebe eventos do browser)
 - Implementar Engagement Scoring (0.0 - 5.0) calculado no servidor
 - Implementar Intention Level (curioso, interessado, comprador) calculado no servidor
 - Implementar SHA256 hashing (WebCrypto) para PII
@@ -681,7 +708,7 @@ cloudflare/
     "cloudflare/DEPLOY.md"
   ],
   "recursos_implementados": {
-    "worker_endpoint": "/api/tracking",
+    "worker_endpoint": "/track",
     "d1_database": "cdp-edge-db",
     "cloudflare_queue": "cdp-edge-retry",
     "kv_namespace": "geo-cache",
@@ -714,7 +741,7 @@ cloudflare/
 - JSON do Premium Tracking Intelligence Agent (estratégia de tracking)
 
 **RESPONSABILIDADE:**
-- Gerar endpoint `/api/wh/*` (recebe webhooks de Hotmart, Kiwify, Eduzz, Ticto)
+- Gerar endpoint `/webhook/*` (recebe webhooks de Hotmart, Kiwify, Eduzz, Ticto)
 - Implementar Lead Lock (salvar PII no D1, vincular com fbp/fbc)
 - Implementar despacho de Purchase via Server-Side (CAPI, Events API)
 - Implementar Advanced Matching Máximo (email, phone, city, state) via checkout data
@@ -724,9 +751,9 @@ cloudflare/
 ```
 cloudflare/
 └── webhooks/
-    ├── hotmart-webhook.js    ← Rota /api/wh/hotmart
-    ├── kiwify-webhook.js     ← Rota /api/wh/kiwify
-    ├── eduzz-webhook.js      ← Rota /api/wh/eduzz
+    ├── hotmart-webhook.js    ← Rota /webhook/hotmart
+    ├── kiwify-webhook.js     ← Rota /webhook/kiwify
+    ├── eduzz-webhook.js      ← Rota /webhook/eduzz
     └── ticto-webhook.js      ← Rota /webhook/ticto (HMAC-SHA256 X-Ticto-Signature)
 ```
 
@@ -927,7 +954,7 @@ Exibir:
 > - `META_ACCESS_TOKEN` — Token da Conversions API (Meta Business Suite → Configurações → Integrações)
 > - `META_AD_ACCOUNT_ID` — ID da conta de anúncios (formato act_XXXXXXXXX)
 > - `WHATSAPP_PHONE_NUMBER_ID` — ID do número WhatsApp (Meta Business Suite → WhatsApp → Phone Numbers)
-> - `WHATSAPP_TOKEN` — Token da Cloud API (Meta Business Suite → WhatsApp → Configurações da API)
+> - `WHATSAPP_ACCESS_TOKEN` — Token da Cloud API (Meta Business Suite → WhatsApp → Configurações da API)
 > - `WA_WEBHOOK_VERIFY_TOKEN` — Você define (qualquer string segura, ex: `cdp_webhook_2025`)
 
 **Bloco Google / GA4** (incluir se Google selecionado):
@@ -1065,7 +1092,7 @@ Aguardar resposta. Armazenar em `PROJECT_TYPE`.
    - Gera / valida worker.js com:
        GET  /webhook/whatsapp → verifica hub.verify_token
        POST /webhook/whatsapp → processWhatsAppWebhook()
-       /api/tracking (manter ativo — pode ser usado no futuro)
+       /track (manter ativo — pode ser usado no futuro)
    - Confirma wrangler.toml com D1 binding
 
 ✅ FASE B-3 — Database Agent
@@ -1116,9 +1143,9 @@ Aguardar resposta. Armazenar em `PROJECT_TYPE`.
 
 📋 Próximos passos para qualificar leads do WhatsApp:
    • Quando lead qualificado → dispare Lead via:
-     POST /api/tracking { event: "Lead", phone: "+5511...", ... }
+     POST /track { event: "Lead", phone: "+5511...", ... }
    • Quando venda confirmada → dispare Purchase via:
-     POST /api/tracking { event: "Purchase", value: 97, phone: "+5511..." }
+     POST /track { event: "Purchase", value: 97, phone: "+5511..." }
 ```
 
 ---
@@ -1137,7 +1164,7 @@ Aguardar resposta. Armazenar em `PROJECT_TYPE`.
    com o link de afiliado correto injetado
 
 ✅ FASE C-2 — Server Tracking Agent (mínimo)
-   Worker com: /api/tracking + /webhook/{plataforma}
+   Worker com: /track + /webhook/{plataforma}
 
 ✅ FASE C-3 — Database Agent
    Schema identity_graph + webhook_events
@@ -1178,14 +1205,12 @@ Ao final, entregar relatório no formato:
 ✅ Webhooks Configurados
    [lista de gateways com URLs]
 
-⚠️  Ações Manuais Necessárias
-   [lista com links diretos para cada ação pendente]
+⚠️  Pendências (se houver)
+   [apenas itens que requerem ação do cliente fora do escopo técnico,
+    ex: validar pixel no Gerenciador de Eventos da Meta, aprovar domínio]
 
-📋 Próximos Passos
-   1. Aplicar migration: wrangler d1 execute cdp-edge-db --file=schema.sql --remote
-   2. Deploy: wrangler deploy
-   3. Configurar secrets: [lista de wrangler secret put]
-   4. Testar evento: curl -X POST https://[worker].workers.dev/track ...
+✅ Deploy & Infraestrutura
+   Executado pela Squad via terminal — nenhuma ação manual necessária.
 ```
 
 **NOTA IMPORTANTE:**
@@ -1244,23 +1269,41 @@ Quando o usuário disser que o Worker está em produção e os eventos estão di
 
 ---
 
-### FASE 0.5 — Intelligence Agent (opcional, recomendado em projetos novos)
+### FASE 0.5 — Intelligence Agent (OBRIGATÓRIO — todo projeto, novo ou em andamento)
+
+**Esta fase roda SEMPRE, automaticamente, antes de qualquer geração de código.**
+Não é opcional. Não depende de pergunta ao usuário.
+
+Spawnar o **Intelligence Agent** para realizar auditoria completa da stack:
 
-Antes de qualquer geração de código, spawnar o **Intelligence Agent** para:
-1. Confirmar que as versões de API estão atualizadas (Meta v22.0+, TikTok v1.3+, GA4 MP)
-2. Auditar conformidade com Google Consent Mode v2 (LGPD/GDPR/CCPA)
-3. Verificar se há parâmetros novos que aumentam Event Match Quality nas plataformas
+**1. Versões de API**
+- Meta CAPI — versão atual em uso vs versão mais recente disponível
+- GA4 Measurement Protocol — parâmetros obrigatórios atualizados
+- TikTok Events API — versão atual vs v1.3+
+- Pinterest, Reddit, LinkedIn, Spotify, Bing — conformidade com versões ativas
+- Fonte de verdade: `contracts/api-versions.json`
 
-**Ativar automaticamente quando:**
-- Projeto novo (primeira vez configurando o rastreamento)
-- Usuário mencionar problemas de qualidade de sinal / Event Match Score baixo
-- Houver suspeita de uso de APIs desatualizadas
+**2. Infraestrutura Cloudflare**
+- `wrangler.toml` — bindings D1, KV, Queue, AI estão todos declarados
+- `schema.sql` e migrations — todas as fases (core, segmentation, bidding, ab-ltv, fraud) aplicadas
+- Worker.js — endpoints ativos correspondem à arquitetura esperada
+
+**3. Conformidade e Qualidade de Sinal**
+- Google Consent Mode v2 (LGPD/GDPR/CCPA)
+- Parâmetros que aumentam Event Match Quality em cada plataforma
+- Deduplicação ativa (event_id consistente browser ↔ CAPI)
+
+**4. Agentes e Contratos**
+- Todos os agentes especialistas estão lendo de `contracts/api-versions.json`
+- Memory Agent com checkpoint válido para a sessão atual
 
 **Ativar via:**
 ```
 Read: {SKILL_BASE}/agents/intelligence-agent.md
 ```
-Passar como contexto: lista de plataformas selecionadas na Fase 0.
+Passar como contexto: lista de plataformas selecionadas + tipo de projeto (novo / em andamento).
+
+**Resultado esperado:** relatório compacto de conformidade antes da FASE 1. Se houver divergências, corrigir antes de prosseguir.
 
 ---
 
@@ -1343,7 +1386,7 @@ Define a estratégia completa de tracking profissional para reduzir 30-50% no cu
       "reddit":    ["Lead", "Purchase", "SignUp", "AddToCart", "PageVisit"],
       "linkedin":  ["LEAD", "PURCHASE", "REGISTRATION", "ADD_TO_CART"],
       "spotify":   ["LEAD", "PURCHASE", "SIGN_UP", "ADD_TO_CART"],
-      "youtube":   ["video_start", "video_progress_25", "video_progress_50", "video_complete"],
+      "youtube":   ["video_start", "video_25", "video_50", "video_75", "video_complete"],
       "bing":      ["generate_lead", "purchase", "begin_checkout", "view_item"]
     },
     "engagement_scoring": {
@@ -1354,7 +1397,7 @@ Define a estratégia completa de tracking profissional para reduzir 30-50% no cu
     "anti_bloqueio": {
       "adblock_detection": "3 metodos",
       "first_party_cookie": "365 dias",
-      "same_domain_endpoint": "/api/tracking",
+      "same_domain_endpoint": "/track",
       "fallback_server_side": "POST request"
     }
   }
@@ -1365,12 +1408,6 @@ Define a estratégia completa de tracking profissional para reduzir 30-50% no cu
 
 Com base nas plataformas selecionadas, spawnar os agentes em paralelo utilizando os modelos de referência em `models/`.
 
----
-
-### FASE 3 — Geração em paralelo (agentes especialistas)
-
-Com base nas plataformas selecionadas, spawnar os agentes em paralelo utilizando os modelos de referência em `models/`.
-
 **IMPORTANTE: Ordem de Execução Sequencial:**
 
 Antes de spawnar agentes em paralelo, seguir esta ordem **OBRIGATÓRIA**:

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

@@ -1,5 +1,15 @@
 # Performance Agent (Monitoring Master) — CDP Edge
 
+> **ESCOPO DESTE AGENTE:** Monitoramento e observabilidade em tempo real.
+> Para otimização de cache, queries e latência, ver: **performance-optimization-agent.md**
+>
+> | Este agente faz | performance-optimization-agent faz |
+> |---|---|
+> | Medir latência, throughput, error rates | Estratégias de caching (L1/L2/L3) |
+> | Alertas de degradação de SLA | Otimização de queries D1 |
+> | Health checks e dashboards | Batch processing, indexação |
+> | Relatórios de performance | Profiling e tunning de Workers |
+
 Você é o **Agente de Monitoramento de Performance do CDP Edge**. Sua responsabilidade: **monitorar continuamente a saúde do sistema de tracking** (latência, throughput, error rates, performance de D1) e prover métricas acionáveis para otimização.
 
 ---
@@ -107,20 +117,20 @@ function evaluateLatencyPerformance(latencyMetrics) {
 
 ```javascript
 // Monitorar taxa de falhas em todas as APIs
-export async function measureApiErrorRate(hours = 24) {
+export async function measureApiErrorRate(env, hours = 24) {
   const platforms = ['meta', 'google', 'tiktok', 'pinterest', 'reddit'];
   const errorRates = {};
 
   for (const platform of platforms) {
     // Total de requisições (sucesso + falha)
-    const totalRequests = await DB.prepare(`
+    const totalRequests = await env.DB.prepare(`
       SELECT COUNT(*) as total
       FROM events_log
       WHERE platform = ? AND created_at > datetime('now', '-${hours} hours')
     `).bind(platform).get();
 
     // Requisições que falharam
-    const failedRequests = await DB.prepare(`
+    const failedRequests = await env.DB.prepare(`
       SELECT COUNT(*) as failed
       FROM events_log
       WHERE platform = ? AND status = 'failed' AND created_at > datetime('now', '-${hours} hours')
@@ -159,7 +169,7 @@ function evaluateErrorRate(errorRate) {
 
 ```javascript
 // Monitorar eventos processados por segundo/minuto
-export async function measureThroughput(hours = 24) {
+export async function measureThroughput(env, hours = 24) {
   const now = new Date();
   const windows = [];
 
@@ -168,7 +178,7 @@ export async function measureThroughput(hours = 24) {
     const windowStart = new Date(now - (i + 1) * 60 * 60 * 1000);
     const windowEnd = new Date(now - i * 60 * 60 * 1000);
 
-    const eventsInWindow = await DB.prepare(`
+    const eventsInWindow = await env.DB.prepare(`
       SELECT COUNT(*) as events,
              MIN(created_at) as first_event,
              MAX(created_at) as last_event
@@ -229,9 +239,9 @@ function evaluateThroughputTrend(recent, historical) {
 
 ```javascript
 // Monitorar performance do banco de dados D1
-export async function measureD1Performance(hours = 24) {
+export async function measureD1Performance(env, hours = 24) {
   // Queries lentas
-  const slowQueries = await DB.prepare(`
+  const slowQueries = await env.DB.prepare(`
     SELECT
       query_hash,
       COUNT(*) as execution_count,
@@ -246,7 +256,7 @@ export async function measureD1Performance(hours = 24) {
   `).all();
 
   // Verificar locks
-  const locks = await DB.prepare(`
+  const locks = await env.DB.prepare(`
     SELECT
       COUNT(*) as total_locks,
       AVG(lock_duration_ms) as avg_lock_duration,
@@ -323,9 +333,9 @@ function evaluateD1Health(slowQueries, locks, dbSize) {
 
 ```javascript
 // Monitorar eficiência do cache KV
-export async function measureCachePerformance(hours = 24) {
+export async function measureCachePerformance(env, hours = 24) {
   // Cache hits e misses
-  const cacheStats = await DB.prepare(`
+  const cacheStats = await env.DB.prepare(`
     SELECT
       COUNT(*) FILTER (WHERE hit = 1) as hits,
       COUNT(*) FILTER (WHERE hit = 0) as misses,
@@ -340,7 +350,7 @@ export async function measureCachePerformance(hours = 24) {
   const hitRate = total > 0 ? (hits / total * 100) : 0;
 
   // Keys armazenadas
-  const totalKeys = await KV.list().then(list => list.keys.length);
+  const totalKeys = await env.GEO_CACHE.list().then(list => list.keys.length);
 
   return {
     hits,
@@ -849,7 +859,7 @@ cpu_ms = 50 # Aumentar de 10ms para 50ms
 ```javascript
 // Cache de métricas globais por 1 hora
 const cacheKey = `metrics:global:${getHourBucket()}`;
-const cached = await KV.get(cacheKey);
+const cached = await env.GEO_CACHE.get(cacheKey);
 
 if (cached) {
   return JSON.parse(cached);
@@ -857,7 +867,7 @@ if (cached) {
 
 // Cache miss — consultar D1 e persistir no KV
 const metrics = await fetchMetricsFromD1();
-await KV.put(cacheKey, JSON.stringify(metrics), { expirationTtl: 3600 });
+await env.GEO_CACHE.put(cacheKey, JSON.stringify(metrics), { expirationTtl: 3600 });
 
 return metrics;
 ```
@@ -948,17 +958,17 @@ const RATE_LIMITS = {
   tiktok: { tokens: 10, refill_rate: 1 }        // 10 req/min
 };
 
-async function consumeToken(platform) {
+async function consumeToken(platform, env) {
   const limit = RATE_LIMITS[platform];
   const key = `rate_limit:${platform}`;
 
-  let tokens = await KV.get(key) || JSON.stringify(limit.tokens);
+  let tokens = await env.GEO_CACHE.get(key) || JSON.stringify(limit.tokens);
 
   tokens = JSON.parse(tokens);
 
   if (tokens > 0) {
     tokens--;
-    await KV.put(key, JSON.stringify(tokens));
+    await env.GEO_CACHE.put(key, JSON.stringify(tokens));
     return true; // Permitido
   }
 
@@ -1030,17 +1040,17 @@ const CACHE_TTL = {
 **Solução:**
 ```javascript
 // Invalidar cache quando dados mudarem
-async function invalidateCacheOnChange(eventType) {
+async function invalidateCacheOnChange(eventType, env) {
   const patterns = {
     'lead_created': ['metrics:*', 'user_profile:*'],
     'purchase_completed': ['metrics:*', 'session_data:*'],
     'api_config_changed': ['api_config:*']
   };
 
-  const keysToDelete = await KV.list({ prefix: patterns[eventType] });
+  const keysToDelete = await env.GEO_CACHE.list({ prefix: patterns[eventType] });
 
   for (const key of keysToDelete.keys) {
-    await KV.delete(key.name);
+    await env.GEO_CACHE.delete(key.name);
   }
 
   console.log(`Invalidated ${keysToDelete.keys.length} cache keys for ${eventType}`);

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

@@ -8,6 +8,16 @@ version: "1.0.0"
 
 # Performance Optimization Enterprise Agent
 
+> **ESCOPO DESTE AGENTE:** Otimização ativa de performance — caching, queries, batching.
+> Para monitoramento passivo (métricas, alertas, dashboards), ver: **performance-agent.md**
+>
+> | Este agente faz | performance-agent faz |
+> |---|---|
+> | Estratégias de caching L1/L2/L3 | Medir latência e throughput |
+> | Otimização de queries D1 e indexação | Alertas de degradação de SLA |
+> | Batch processing e pipeline tuning | Health checks e dashboards |
+> | Profiling de Workers e CPU optimization | Relatórios de performance |
+
 ## 🚀 Visão Geral
 
 Agente especializado em otimização de performance para o sistema CDP Edge (Cloudflare Workers + D1 + Queue). Implementa estratégias de caching multi-camada, otimização de queries, processamento em lote e monitoramento de latência em tempo real.
@@ -159,7 +169,7 @@ let l1Cache = new L1Cache();
  */
 class L2Cache {
   constructor(env) {
-    this.kv = env.CACHE_KV; // Cloudflare KV namespace
+    this.kv = env.GEO_CACHE; // Cloudflare KV namespace
     this.stats = {
       hits: 0,
       misses: 0,

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

@@ -553,7 +553,7 @@ function detectAdBlock() {
 function handleAdBlockFallback(eventData) {
   if (detectAdBlock()) {
     // AdBlock ativo: enviar via servidor (não pode usar scripts de terceiros)
-    fetch('/api/tracking', {
+    fetch('/track', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify({
@@ -619,9 +619,9 @@ function getSessionId() {
 ```javascript
 /**
  * Endpoint de Tracking no Mesmo Domínio
- * URL: https://meusite.com/api/tracking (NÃO third-party)
+ * URL: https://meusite.com/track (NÃO third-party)
  */
-const TRACKING_ENDPOINT = '/api/tracking'; // Same-Domain Protocol
+const TRACKING_ENDPOINT = '/track'; // Same-Domain Protocol
 
 /**
  * Enviar evento via servidor (adblock-proof)
@@ -804,7 +804,7 @@ const serverTracking = {
 
 ### Server Tracking (O que processar no Worker)
 
-- [x] Receber eventos do browser (POST /api/tracking)
+- [x] Receber eventos do browser (POST /track)
 - [x] Capturar IP e geolocalização (Cloudflare headers)
 - [x] Recuperar PII do D1 (Lead Lock)
 - [x] Calcular Engagement Score (0.0 - 5.0)