cdp-edge 2.5.5 → 2.5.7

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

@@ -75,7 +75,7 @@ Master Orchestrator (você)
 │   └── Fingerprint Agent                  → salva e resgata origens/UTMs perdidas
 │
 ├── 📡 PLATAFORMAS DE ANÚNCIO (server + browser)
-│   ├── Meta Agent                         → Meta Pixel + CAPI v22.0
+│   ├── Meta Agent                         → Meta Pixel + CAPI v25.0
 │   ├── Google Agent                       → GA4 + Google Ads Enhanced Conversions
 │   ├── YouTube Agent                      → YouTube Ads (TrueView, Bumper, gclid/wbraid)
 │   ├── TikTok Agent                       → TikTok Pixel + Events API v1.3
@@ -103,12 +103,18 @@ Master Orchestrator (você)
 │   ├── LTV Predictor Agent                → prevê LTV financeiro com Workers AI
 │   ├── ML Clustering Agent                → segmentação dinâmica K-means/DBSCAN (Fase 1 Enterprise)
 │   ├── Bidding Recommendations Agent      → recomendações de bids por segmento ML (Fase 2 Enterprise)
-│   ├── A/B Testing Agent                  → separação de requisições na borda
+│   ├── A/B Testing Agent                  → split de tráfego invisível na borda (sem flicker)
+│   ├── A/B LTV Testing Agent              → otimização contínua da precisão do LTV preditivo (Fase 3 Enterprise)
 │   └── Localization Agent                 → moedas e traduções no edge
 │
 ├── 📈 DASHBOARD E RELATÓRIOS
 │   ├── Dashboard Agent                    → gerencia meta-dashboard-full (React)
-│   └── Performance Agent                  → métricas de performance do worker
+│   ├── Performance Agent                  → monitoramento em tempo real: latência, throughput, SLA alerts
+│   └── Performance Optimization Agent     → estratégias de cache L1/L2/L3, query D1, batch processing (Enterprise)
+│
+│   ⚠️  REGRA DE ROTEAMENTO — Performance:
+│   • Invoke Performance Agent             → quando precisar de métricas, health checks ou alertas de degradação
+│   • Invoke Performance Optimization Agent → quando precisar otimizar cache, queries D1 ou latência estrutural
 │
 ├── 🔍 QUALIDADE E SEGURANÇA
 │   ├── Match Quality Agent                → garante que só dado com valor real vai para as plataformas
@@ -157,7 +163,7 @@ SKILL_BASE: [diretório da skill tracking-events-generator]
     ├── fingerprint-agent.md                  ← Fingerprinting LGPD + Salva-UTMs
     │
     ├── ── PLATAFORMAS DE ANÚNCIO ──
-    ├── meta-agent.md                         ← Meta Pixel + CAPI v22.0
+    ├── meta-agent.md                         ← Meta Pixel + CAPI v25.0
     ├── google-agent.md                       ← GA4 + Google Ads Enhanced Conversions
     ├── youtube-agent.md                      ← YouTube Ads (TrueView, Bumper, gclid/wbraid)
     ├── tiktok-agent.md                       ← TikTok Pixel + Events API v1.3
@@ -185,7 +191,8 @@ SKILL_BASE: [diretório da skill tracking-events-generator]
     ├── ltv-predictor-agent.md               ← IA Preditiva de Receita (Workers AI)
     ├── ml-clustering-agent.md               ← Segmentação Dinâmica ML (K-means, DBSCAN, Hierarchical)
     ├── bidding-agent.md                     ← Recomendações de Bids por Segmento ML
-    ├── ab-testing-agent.md                  ← A/B Edge Route Optimization
+    ├── ab-testing-agent.md                  ← A/B Edge Route Optimization (split de tráfego invisível, sem flicker)
+    ├── ab-ltv-agent.md                      ← A/B LTV Testing — otimização contínua da precisão preditiva (Fase 3 Enterprise)
     ├── localization-agent.md                ← Traduções de Checkout em Borda
     │
     ├── ── DASHBOARD E RELATÓRIOS ──
@@ -524,7 +531,7 @@ src/tracking/
 
 **RESPONSABILIDADE:**
 - Gerar código Meta Pixel (browser via cdpTrack.js)
-- Gerar payload Meta CAPI v22.0 (server-side)
+- Gerar payload Meta CAPI v25.0 (server-side)
 - Implementar Advanced Matching (em, ph, fbp, fbc, client_ip_address, client_user_agent)
 - Implementar eventos priorizados para Meta
 - Mapear eventos browser → eventos CAPI
@@ -534,7 +541,7 @@ src/tracking/
 ```
 src/tracking/platforms/
 ├── meta-pixel.js          ← Browser Pixel (cdpTrack.js)
-└── meta-capi.js           ← Server CAPI v22.0 payload
+└── meta-capi.js           ← Server CAPI v25.0 payload
 ```
 
 **SAÍDA:**
@@ -554,7 +561,7 @@ src/tracking/platforms/
     "fbp_fbc": true,
     "client_ip_user_agent": true
   },
-  "api_version": "v22.0"
+  "api_version": "v25.0"
 }
 ```
 
@@ -788,7 +795,7 @@ cloudflare/
     "intention_levels": ["curioso", "interessado", "comprador"]
   },
   "integracoes": {
-    "meta_capi": "v22.0",
+    "meta_capi": "v25.0",
     "google_mp": "GA4 Measurement Protocol",
     "tiktok_api": "v1.3",
     "hashing": "SHA256 WebCrypto",
@@ -887,7 +894,7 @@ FASE 0 → FASE 1 → FASE 2 → FASE 3 → FASE 4 → FASE 5 → FASE 6 → FAS
 
 ```
 FASE 5 (Geração em paralelo):
-  ├─ FASE 5-A: Meta Agent           (Pixel + CAPI v22.0 + WhatsApp CTWA)
+  ├─ FASE 5-A: Meta Agent           (Pixel + CAPI v25.0 + WhatsApp CTWA)
   ├─ FASE 5-B: Google Agent         (GA4 + Measurement Protocol)
   ├─ FASE 5-C: TikTok Agent         (Pixel + Events API v1.3)
   ├─ FASE 5-F: Pinterest Agent      (Tag + Conversions API v5)
@@ -916,6 +923,277 @@ FASE 6 (Enterprise Features — ordem de configuração):
 
 ---
 
+## COMANDO *new-ai-module — Criar novo módulo Workers AI
+
+### TRIGGERS (qualquer uma das formas abaixo ativa este comando)
+
+| Forma | Exemplo |
+|---|---|
+| `*new-ai-module [descrição]` | `*new-ai-module classifica leads por score do quiz` |
+| `crie um worker ai para [descrição]` | `crie um worker ai para distribuir leads por pontuação` |
+| `quero um módulo de IA que [descrição]` | `quero um módulo de IA que detecta intenção de compra` |
+
+**REGRA:** O Master Orchestrator NÃO pede mais informações antes de agir. Infere tudo a partir da descrição e executa imediatamente.
+
+---
+
+### DECISÃO INICIAL — Tipo de módulo
+
+Antes de spawnar agentes, classificar automaticamente:
+
+| Descrição contém | Tipo | Agente primário |
+|---|---|---|
+| classificar, score, pontuar, prever, predizer, LTV, valor | **Scoring/Prediction** | LTV Predictor Agent |
+| segmentar, agrupar, cluster, similaridade, perfil | **Clustering/Embedding** | ML Clustering Agent |
+| detectar, identificar, intenção, comportamento, padrão | **Classification** | LTV Predictor Agent |
+| distribuir, rotear, priorizar, fila, ranking | **Routing/Ranking** | LTV Predictor Agent |
+
+---
+
+### PERGUNTA OBRIGATÓRIA — Modo de execução
+
+Antes de iniciar o pipeline, fazer UMA pergunta:
+
+> **"Este módulo deve rodar:"**
+> - **[A] Dentro do pipeline `/track`** — executa automaticamente a cada evento capturado
+> - **[B] Sob demanda via API** — chamado explicitamente por outro sistema ou cron
+> - **[C] Ambos** — rota API + integrado ao `/track`
+
+A resposta define como o PASSO 3 (Server Tracking Agent) conecta o módulo.
+
+---
+
+### PIPELINE DE EXECUÇÃO (sempre nesta ordem, sem pular passos)
+
+---
+
+**PASSO 1 — Agente de IA (LTV Predictor Agent ou ML Clustering Agent)**
+
+Responsabilidade: especificar o cérebro do módulo.
+
+Entregar obrigatoriamente:
+
+1. **Modelo escolhido** com justificativa:
+
+| Caso de uso | Modelo |
+|---|---|
+| Classificação / scoring / raciocínio leve | `@cf/ibm-granite/granite-4.0-h-micro` |
+| Embeddings / similaridade / clustering semântico | `@cf/baai/bge-m3` |
+| Análise rica / respostas longas / contexto amplo | `@cf/meta/llama-3.1-8b-instruct` |
+| Sentimento / classificação binária (rápido) | `@cf/huggingface/distilbert-sst-2-int8` |
+
+2. **Contrato de input/output tipado:**
+```typescript
+// Exemplo para módulo de scoring de leads
+interface AIModuleInput {
+  lead_id: string;
+  features: Record<string, string | number | boolean>;
+  context?: string; // contexto extra opcional
+}
+
+interface AIModuleOutput {
+  lead_id: string;
+  result_class: string;        // ex: 'High' | 'Medium' | 'Low'
+  confidence: number;          // 0.0 – 1.0
+  score: number;               // 0 – 100
+  reasoning: string;           // explicação do modelo (1 linha)
+  model: string;               // @cf/modelo-usado
+  latency_ms: number;
+  cached: boolean;
+}
+```
+
+3. **System prompt do modelo** — calibrado ao caso de uso específico, com instrução de retornar JSON puro.
+
+4. **Estratégia de cache** — resultado deve ser cacheado no KV (`GEO_CACHE`) por TTL definido pelo agente (padrão: 1h), usando `input_hash` como chave, para evitar rechamadas desnecessárias ao modelo.
+
+---
+
+**PASSO 2 — Database Agent**
+
+Responsabilidade: criar schema D1 tipado e com índices corretos.
+
+Schema obrigatório — **sem campos genéricos**:
+```sql
+-- Nomenclatura: schema-ai-[nome-do-módulo].sql
+CREATE TABLE IF NOT EXISTS ai_[nome] (
+  id           TEXT    PRIMARY KEY,               -- UUID v4
+  lead_id      TEXT    NOT NULL,
+  input_hash   TEXT    NOT NULL,                  -- SHA256 do input (usado como cache key)
+  result_class TEXT    NOT NULL,                  -- saída classificada do modelo
+  confidence   REAL    NOT NULL DEFAULT 0,        -- 0.0 – 1.0
+  score        INTEGER NOT NULL DEFAULT 0,        -- 0 – 100
+  reasoning    TEXT,                              -- explicação do modelo
+  model        TEXT    NOT NULL,                  -- @cf/modelo-usado
+  latency_ms   INTEGER,                           -- tempo de inferência
+  cached       INTEGER NOT NULL DEFAULT 0,        -- 0 = fresh, 1 = from KV cache
+  pipeline     TEXT    NOT NULL DEFAULT 'api',    -- 'track' | 'api' | 'cron'
+  created_at   INTEGER NOT NULL DEFAULT (unixepoch())
+);
+
+CREATE INDEX IF NOT EXISTS idx_ai_[nome]_lead    ON ai_[nome](lead_id);
+CREATE INDEX IF NOT EXISTS idx_ai_[nome]_class   ON ai_[nome](result_class);
+CREATE INDEX IF NOT EXISTS idx_ai_[nome]_created ON ai_[nome](created_at DESC);
+```
+
+Após gerar o schema, o Database Agent passa o arquivo para o DevOps Agent aplicar — **não aplica diretamente**.
+
+---
+
+**PASSO 3 — Server Tracking Agent**
+
+Responsabilidade: criar o módulo TypeScript + rotas REST + integração ao pipeline conforme resposta da PERGUNTA OBRIGATÓRIA.
+
+**Estrutura do módulo gerado:**
+```typescript
+// server-edge-tracker/modules/ml/[nome].ts
+
+export async function run[Nome](
+  env: Env,
+  input: AIModuleInput
+): Promise<AIModuleOutput> {
+
+  // 1. Verificar cache KV antes de chamar o modelo
+  const cacheKey = `ai:[nome]:${input.input_hash}`;
+  const cached = await env.GEO_CACHE.get(cacheKey, 'json');
+  if (cached) return { ...cached, cached: true };
+
+  // 2. Chamar Workers AI
+  const aiRes = await env.AI.run('[modelo-escolhido]', {
+    messages: [
+      { role: 'system', content: '[system-prompt-gerado-no-passo-1]' },
+      { role: 'user',   content: JSON.stringify(input.features) }
+    ],
+    max_tokens: 64
+  });
+
+  // 3. Parsear output do modelo (sempre JSON puro)
+  const parsed = JSON.parse(aiRes.response);
+  const output: AIModuleOutput = {
+    lead_id:      input.lead_id,
+    result_class: parsed.class,
+    confidence:   parsed.confidence ?? 0,
+    score:        parsed.score ?? 0,
+    reasoning:    parsed.reasoning ?? '',
+    model:        '[modelo-escolhido]',
+    latency_ms:   0, // preenchido pelo caller
+    cached:       false
+  };
+
+  // 4. Salvar no KV (cache) e no D1 (persistência)
+  await env.GEO_CACHE.put(cacheKey, JSON.stringify(output), { expirationTtl: 3600 });
+  await env.DB.prepare(`
+    INSERT INTO ai_[nome] (id, lead_id, input_hash, result_class, confidence, score, reasoning, model, pipeline)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `).bind(crypto.randomUUID(), input.lead_id, input.input_hash, output.result_class,
+          output.confidence, output.score, output.reasoning, output.model, input.pipeline ?? 'api')
+    .run();
+
+  return output;
+}
+```
+
+**Rotas REST criadas (sempre, independente do modo):**
+```
+POST /api/ai/[nome]            → executa inferência ad-hoc
+GET  /api/ai/[nome]/:lead_id   → retorna último resultado salvo para o lead
+GET  /api/ai/[nome]/stats      → distribuição de classes + taxa de cache hit
+```
+
+**Integração ao pipeline `/track` (somente se Modo A ou C):**
+```typescript
+// Em index.ts — dentro do handler POST /track, após Quiz Scoring e antes do CAPI Dispatch
+// Ordem runtime atualizada:
+// [1] Fraud Gate → [2] Quiz Scoring → [3] LTV → [3.x] [NOME] → [4] D1 → [5] CAPI
+
+const [nomeResult] = await run[Nome](env, {
+  lead_id:    payload.userId,
+  input_hash: await sha256(JSON.stringify(relevantFeatures)),
+  features:   relevantFeatures,
+  pipeline:   'track'
+});
+
+// Resultado disponível para enriquecer o CAPI dispatch
+payload.ai_[nome]_class = [nomeResult].result_class;
+payload.ai_[nome]_score = [nomeResult].score;
+```
+
+---
+
+**PASSO 4 — DevOps Agent**
+
+Sequência de execução obrigatória:
+
+```bash
+# 1. Verificar se binding [ai] já existe (não duplicar)
+! grep -c '\[ai\]' server-edge-tracker/wrangler.toml
+# Se retornar 0 → adicionar bloco [ai] binding = "AI"
+# Se retornar ≥1 → pular, já existe
+
+# 2. Aplicar schema D1
+! wrangler d1 execute cdp-edge-db --file=server-edge-tracker/schema-ai-[nome].sql --remote
+
+# 3. Deploy
+! wrangler deploy
+```
+
+**Em caso de falha no deploy:** o DevOps Agent captura o erro, passa para o Debug Agent e tenta correção automática antes de escalar para o usuário.
+
+---
+
+**PASSO 5 — Validator Agent**
+
+Smoke tests obrigatórios em sequência:
+
+```bash
+# Test 1 — Inferência ad-hoc
+POST /api/ai/[nome]
+Body: { "lead_id": "smoke-test-001", "features": { [campo-principal]: [valor-teste] } }
+Esperado: 200 + { result_class, confidence, score, cached: false }
+
+# Test 2 — Cache hit
+POST /api/ai/[nome]  (mesmo payload)
+Esperado: 200 + { cached: true, latency_ms < 10 }
+
+# Test 3 — Leitura do resultado
+GET /api/ai/[nome]/smoke-test-001
+Esperado: 200 + registro da tabela D1
+
+# Test 4 — Stats
+GET /api/ai/[nome]/stats
+Esperado: 200 + { total, by_class: { ... }, cache_hit_rate }
+
+# Test 5 — Pipeline /track (somente se Modo A ou C)
+POST /track com payload real
+Esperado: response contém ai_[nome]_class no resultado
+```
+
+Se qualquer teste falhar: **bloquear** e escalar para Debug Agent antes de entregar ao usuário.
+
+---
+
+### SAÍDA FINAL AO USUÁRIO
+
+```
+⚡ Módulo AI criado: [nome-do-módulo]
+
+Modelo:     @cf/[modelo]
+Tabela D1:  ai_[nome]  ([N] colunas tipadas + 3 índices)
+Cache KV:   ai:[nome]:{hash}  (TTL: 1h)
+
+Rotas:
+  POST /api/ai/[nome]           → inferência
+  GET  /api/ai/[nome]/:lead_id  → histórico
+  GET  /api/ai/[nome]/stats     → métricas
+
+Pipeline /track: [INTEGRADO na posição [3.x] | NÃO INTEGRADO]
+
+Smoke tests:  5/5 ✅
+Deploy:       OK — [worker-url]
+```
+
+---
+
 ## COMANDO /setup — Fluxo principal de configuração
 
 ### MENSAGEM DE BOAS-VINDAS (disparar na ativação do agente)
@@ -980,7 +1258,7 @@ Logo após a boas-vindas, exibir:
 >
 > | # | Plataforma | O que será configurado |
 > |---|------------|----------------------|
-> | **1** | **Meta Ads** (Facebook + Instagram) | Pixel browser + CAPI server-side v22.0 + WhatsApp CTWA |
+> | **1** | **Meta Ads** (Facebook + Instagram) | Pixel browser + CAPI server-side v25.0 + WhatsApp CTWA |
 > | **2** | **Google Ads + GA4** | gtag browser + Measurement Protocol server-side + Enhanced Conversions |
 > | **3** | **TikTok Ads** | Pixel browser + Events API server-side v1.3 + Advanced Matching |
 > | **4** | **Pinterest Ads** | Tag browser + Conversions API server-side v5 |
@@ -1082,9 +1360,9 @@ Exibir:
 
 **Bloco EVO CRM (OAuth2)** (incluir se CRM selecionado):
 > - `EVO_CRM_BASE_URL` — URL base (ex: https://api-evocrm.dominio.com)
-> - `EVO_CRM_CLIENT_ID` — OAuth client_id
-> - `EVO_CRM_CLIENT_SECRET` — OAuth client_secret
-> - `EVO_CRM_INBOX_ID` — ID do inbox no CRM
+> - `EVO_CRM_CLIENT_ID` — OAuth client_id (Configurações -> Aplicações)
+> - `EVO_CRM_CLIENT_SECRET` — OAuth client_secret (O segredo do app)
+> - `EVO_CRM_INBOX_ID` — ID numérico do inbox (final da URL da caixa)
 > - `EVO_CRM_DEFAULT_COUNTRY` — Dial code default (ex: 55)
 > - `EVO_CRM_LOCALE` — Locale das notas (pt-BR | en-US | es-ES)
 
@@ -1500,7 +1778,7 @@ Antes de spawnar agentes em paralelo, seguir esta ordem **OBRIGATÓRIA**:
 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
+5. **Meta Agent** → Gera código Meta Pixel + CAPI v25.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
@@ -1595,7 +1873,15 @@ Spawnar os agentes enterprise em ordem:
      - W-Shape
      - Data-Driven (requer histórico de dados)
 
-2. **Security Enterprise Agent** (security-enterprise-agent.md)
+6. **A/B LTV Testing Agent** (ab-ltv-agent.md)
+   - Ativar experimentos A/B sobre o system prompt do Workers AI LTV
+   - Aplicar `schema-ab-ltv.sql` no D1 (ltv_ab_tests + ltv_ab_assignments + ltv_ab_results)
+   - Configurar rotas: `POST /api/ltv/ab-test/create`, `GET /api/ltv/ab-test/results`, `POST /api/ltv/ab-test/winner`
+   - Integrar `getLtvAbVariation()` no fluxo `predictLtv()` do `index.ts`
+   - Conectar resultado do webhook (compra real) ao `ltv_ab_assignments.converted` para scoring de acurácia
+   - Downstream: ao detectar vencedor com `accuracy_improvement ≥ 5%`, notificar LTV Predictor Agent para atualizar o prompt padrão
+
+7. **Security Enterprise Agent** (security-enterprise-agent.md)
    - Implementar rate limiting (IP, user, global)
    - Configurar IP blacklist/whitelist
    - Implementar input validation com Joi
@@ -1604,14 +1890,14 @@ Spawnar os agentes enterprise em ordem:
    - Criar audit logging completo
    - Criar D1 schemas: ip_blacklist, ip_whitelist, ip_violations, audit_logs
 
-3. **Performance Optimization Agent** (performance-optimization-agent.md)
+8. **Performance Optimization Agent** (performance-optimization-agent.md)
    - Implementar caching multi-camada (L1 memory, L2 KV, L3 D1)
    - Criar índices otimizados para D1
    - Implementar batch processing para atribuição
    - Configurar latency profiling
    - Criar endpoints de monitoramento de performance
 
-4. **Compliance Agent** (compliance-agent.md)
+9. **Compliance Agent** (compliance-agent.md)
    - Implementar consent management (GDPR, LGPD, CCPA)
    - Configurar data rights (access, deletion, portability, rectification)
    - Implementar data retention policies automatizadas
@@ -1630,6 +1916,7 @@ Usar `AskUserQuestion` com multi-select para permitir múltiplas seleções:
 > - [ ] **Match Quality** (garante que só dado com valor real vai para as plataformas — EMQ Score)
 > - [ ] **ROAS Feedback + Nurture** (ROAS real por campanha + follow-up automático pós-quiz)
 > - [x] Multi-Touch Attribution
+> - [ ] **A/B LTV Testing** (testa variações do prompt LTV → aumenta precisão preditiva em até +25%)
 > - [ ] Security Enterprise (rate limiting, IP blocking)
 > - [ ] Performance Optimization (caching, query optimization)
 > - [ ] Compliance (GDPR, LGPD, Consent Management)
@@ -1877,7 +2164,7 @@ Apresentar o resultado organizado com resumo de eventos e próximos passos.
 ## 📊 Resumo do Setup
 
 ### Plataformas Configuradas:
-- [x] Meta (Facebook Pixel + CAPI v22.0)
+- [x] Meta (Facebook Pixel + CAPI v25.0)
 - [x] Google (GA4 + Google Ads Enhanced)
 - [x] TikTok (Pixel + Events API v1.3)
 
@@ -1956,6 +2243,10 @@ Apresentar o resultado organizado com resumo de eventos e próximos passos.
    wrangler secret put META_ACCESS_TOKEN
    wrangler secret put GA4_API_SECRET
    wrangler secret put TIKTOK_ACCESS_TOKEN
+   wrangler secret put EVO_CRM_BASE_URL
+   wrangler secret put EVO_CRM_CLIENT_ID
+   wrangler secret put EVO_CRM_CLIENT_SECRET
+   wrangler secret put EVO_CRM_INBOX_ID
    ```
 
 3. **Testar Eventos:**
@@ -2013,7 +2304,7 @@ Após entregar o resultado ao usuário, o Master Orchestrator DEVE:
      "events_mapped": ["Lead", "Purchase", "InitiateCheckout"],
      "files_created": ["tracking.js", "index.ts", "schema.sql"],
      "api_versions": {
-       "meta": "v22.0",
+       "meta": "v25.0",
        "tiktok": "v1.3",
        "google": "GA4_MP"
      },
@@ -2025,7 +2316,7 @@ Após entregar o resultado ao usuário, o Master Orchestrator DEVE:
        {
          "agent": "meta-agent",
          "issue": "API version desatualizada",
-         "fix_applied": "Atualizado para v22.0"
+         "fix_applied": "Atualizado para v25.0"
        }
      ],
      "validation_status": {

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

@@ -253,7 +253,7 @@ POST /track
               ├─ autoEnrichPayload() ← MATCH QUALITY AGENT age aqui
               │     → recupera email/fbp/phone do Identity Graph
               ├─ buildMetaCAPIPayload()
-              ├─ fetch Meta CAPI v22.0
+              ├─ fetch Meta CAPI v25.0
               └─ logMatchQuality() em background ← registra flags
 
 Cron a cada 2h:

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

@@ -167,8 +167,8 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
 
   "api_versions": {
     "meta": {
-      "pixel": "v22.0",
-      "capi": "v22.0",
+      "pixel": "v25.0",
+      "capi": "v25.0",
       "verified_at": "2025-03-27T14:00:00.000Z"
     },
     "google": {
@@ -202,7 +202,7 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
       "verified_at": null
     },
     "whatsapp": {
-      "cloud_api": "v22.0",
+      "cloud_api": "v25.0",
       "verified_at": null
     },
     "bing": {
@@ -312,7 +312,7 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
       "id": "correction_001",
       "agent": "meta-agent",
       "issue": "API version desatualizada detectada",
-      "fix": "Atualizado de v21.0 para v22.0",
+      "fix": "Atualizado de v21.0 para v25.0",
       "fixed_by": "validator-agent (auto)",
       "timestamp": "2025-03-27T14:40:00.000Z",
       "revalidated": true
@@ -372,7 +372,7 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
       "type": "api_version_check",
       "platform": "meta",
       "result": "current",
-      "details": "Meta CAPI v22.0 está atualizado",
+      "details": "Meta CAPI v25.0 está atualizado",
       "timestamp": "2025-03-27T14:00:00.000Z"
     }
   ]
@@ -616,17 +616,17 @@ Verifique o código existente antes de reimplementar.
 
 ```
 Chat:
-@validator-agent: Vou validar se está usando Meta CAPI v22.0...
+@validator-agent: Vou validar se está usando Meta CAPI v25.0...
 
 Memory Agent (detecta versão inconsistente):
 🔴 VERSÃO INCORRETA!
 
 Verificação no Memory Agent:
-- Meta API configurada: v22.0
+- Meta API configurada: v25.0
 - Version verify: 2025-03-27T14:00:00Z
 - Agent usando: v21.0
 
-AÇÃO CORRETA: Atualizar código para v22.0.
+AÇÃO CORRETA: Atualizar código para v25.0.
 Intelligence Agent já alertou sobre desatualização.
 ```
 

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

@@ -14,7 +14,7 @@ Especialista exclusivo em Meta Pixel (browser via cdpTrack) + Meta Conversions A
 
 ## 🏗️ ARQUITETURA Quantum Tier
 - **Browser**: Use `cdpTrack.js` para captura direta.
-- **Server**: Cloudflare Worker enviando para `/v22.0/{PIXEL_ID}/events`.
+- **Server**: Cloudflare Worker enviando para `/v25.0/{PIXEL_ID}/events`.
 - **Database**: D1 para persistência de `fbp` e `fbc`.
 
 ---
@@ -29,9 +29,9 @@ const apiVersions = await readJSON('contracts/api-versions.json');
 const metaVersion = apiVersions.meta;
 
 // Extrair versões necessárias
-const currentPixelVersion = metaVersion.versions.pixel.current;           // "v22.0"
-const currentCapiVersion = metaVersion.versions.capi.current;           // "v22.0"
-const recommendedVersion = metaVersion.versions.pixel.recommended;        // "v22.0"
+const currentPixelVersion = metaVersion.versions.pixel.current;           // "v25.0"
+const currentCapiVersion = metaVersion.versions.capi.current;           // "v25.0"
+const recommendedVersion = metaVersion.versions.pixel.recommended;        // "v25.0"
 const minimumSupported = metaVersion.versions.pixel.minimum_supported; // "v21.0"
 
 // Verificar depreciação
@@ -58,7 +58,7 @@ cdpTrack.track('Lead', {
 });
 ```
 
-### 2. Server (CAPI v22.0)
+### 2. Server (CAPI v25.0)
 Gere payloads para o Worker seguir a API oficial da Meta:
 - `action_source`: 'website' (obrigatório)
 - `event_id`: Identidade única compartilhada (deduplicação)
@@ -70,7 +70,7 @@ Gere payloads para o Worker seguir a API oficial da Meta:
 - **Browser**: Use `cdpTrack.js` para captura e despacho direto.
 - **Hashing**: Use `crypto.subtle.digest` (SHA-256) para PII no Worker.
 - **Deduplicação**: Inclua sempre o `event_id` único gerado no browser.
-- **Versão da API**: Utilize estritamente a API **v22.0**.
+- **Versão da API**: Utilize estritamente a API **v25.0**.
 
 ---
 
@@ -86,7 +86,7 @@ Gere payloads para o Worker seguir a API oficial da Meta:
 ## RESPONSABILIDADE
 
 - Gerar código Meta Pixel browser via `cdpTrack.track()` para todos os eventos mapeados
-- Gerar função `dispatchMetaCapi()` no Worker com CAPI v22.0
+- Gerar função `dispatchMetaCapi()` no Worker com CAPI v25.0
 - Implementar Advanced Matching Máximo: `em`, `ph`, `fn`, `ln`, `ct`, `st`, `zp`, `country`, `external_id`, `fbp`, `fbc`
 - Garantir deduplicação browser↔server via `event_id` idêntico
 - Aplicar SHA-256 via WebCrypto API em todos os campos PII antes do dispatch
@@ -101,7 +101,7 @@ Gere payloads para o Worker seguir a API oficial da Meta:
     "browser": "cdpTrack.js (eventos Meta injetados)",
     "server": "modules/dispatch/meta.ts"
   },
-  "versao_api": "v22.0",
+  "versao_api": "v25.0",
   "eventos_implementados": ["PageView", "Lead", "InitiateCheckout", "Purchase", "ViewContent"],
   "advanced_matching": {
     "campos": ["em", "ph", "fn", "ln", "ct", "st", "zp", "country", "external_id", "fbp", "fbc"],

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

@@ -744,6 +744,26 @@ curl "https://seudominio.com/api/segmentation/outliers?limit=20"
 
 ---
 
+## COMANDO *new-ai-module — Ativação por módulo genérico
+
+Este agente também é invocado pelo Master Orchestrator quando recebe o comando `*new-ai-module` com descrição do tipo:
+**segmentar, agrupar, cluster, similaridade, perfil, embedding, distribuição**
+
+### Responsabilidade no PASSO 1 do pipeline *new-ai-module
+
+Entregar obrigatoriamente ao Master Orchestrator:
+
+1. **Modelo escolhido** — para clustering semântico: `@cf/baai/bge-m3`; para auto-labeling de segmentos: `@cf/ibm-granite/granite-4.0-h-micro`
+2. **Estratégia de clustering** — K-means (grupos fixos) ou DBSCAN (anomalias/fraude), com `n_clusters` recomendado
+3. **Pipeline de features** — quais campos do payload ou da tabela D1 alimentam o vetor de embedding
+4. **Contrato de output** — `{ segment_id, segment_label, similarity_score, cluster_method }`
+5. **TTL de cache KV recomendado** — padrão 3600s; para segmentos comportamentais usar 1800s
+6. **Posição no pipeline `/track`** — se Modo A ou C, este módulo entra após LTV Prediction
+
+> **Regra:** Responder com o pacote completo em uma única mensagem. Sem perguntas de volta ao Orchestrator.
+
+---
+
 *ML Clustering Agent v1.0 — Segmentação Dinâmica ML*
 *Versão: 1.0 — Criado em: 9 de Abril de 2026*
 *Status: Ready para implementação*

package/extracted-skill/tracking-events-generator/agents/page-analyzer.md

@@ -61,7 +61,7 @@ Antes de mapear elementos, identifique o **modelo de negócio** da página para
 ---
 
 ## 🏁 RETORNO JSON
-Retorne o JSON seguindo o padrão `cdpTrack`, focando em `seletores` CSS diretos e `eventos` compatíveis com Meta CAPI v22.0 e TikTok v1.3.
+Retorne o JSON seguindo o padrão `cdpTrack`, focando em `seletores` CSS diretos e `eventos` compatíveis com Meta CAPI v25.0 e TikTok v1.3.
 
 ## PASSO 6 — Retornar JSON estruturado
 

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

@@ -810,7 +810,7 @@ const serverTracking = {
 - [x] Calcular Engagement Score (0.0 - 5.0)
 - [x] Classificar intenção (curioso, interessado, comprador)
 - [x] Hashing de PII (SHA256: email, phone, name, city, state, zip)
-- [x] Despachar para Meta CAPI v22.0 (event_id, user_data, custom_data)
+- [x] Despachar para Meta CAPI v25.0 (event_id, user_data, custom_data)
 - [x] Despachar para Google GA4 MP (event_name, user_properties)
 - [x] Despachar para TikTok Events API v1.3 (event, context, properties)
 - [x] Persistir no D1 (Identity Graph + events_log)

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

@@ -26,7 +26,7 @@ Browser (Cliente)          Worker (Server-Side)           APIs (Meta/Google/TikT
      │                            ├─► [6] Audit Logging ──────┤
      │                            ├─► [7] Encryption ─────────────┤
      │                            └─► Processar evento ──────────────►│
-     │                            │        (Meta CAPI v22.0)        │
+     │                            │        (Meta CAPI v25.0)        │
      │                            │        (TikTok v1.3)             │
      │                            │        (GA4 MP)                 │
      │                            │                                  │