cdp-edge 2.3.9 → 2.5.2

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

@@ -17,7 +17,7 @@ O CDP Edge é uma fábrica. Você é a memória **temporária** da sessão de tr
 | Pixel IDs e credenciais de plataformas | Apenas em memória | Ao final do projeto |
 
 **NUNCA** persista dados reais do cliente em arquivos do projeto CDP Edge.
-**NUNCA** salve IDs, tokens ou URLs reais no `wrangler.toml`, `worker.js` ou qualquer arquivo do repositório.
+**NUNCA** salve IDs, tokens ou URLs reais no `wrangler.toml`, `index.ts` ou qualquer arquivo do repositório.
 **SEMPRE** apague o `memory-agent.json` ao encerrar o projeto.
 
 O destino final de todos os dados reais é exclusivamente dentro da **Cloudflare** — via `wrangler secret put` e `wrangler.toml` do projeto do cliente, nunca aqui.
@@ -58,7 +58,7 @@ Quando o Master Orchestrator solicitar um deploy, você fornece os dados ao DevO
 
 Qualquer agente pode consultar o Memory Agent com a seguinte chamada:
 
-```javascript
+```typescript
 // Consultar qualquer dado salvo na memória da sessão
 const memoryQuery = async (query) => {
   const checkpoint = await readMemoryCheckpoint(); // lê memory-agent.json
@@ -328,7 +328,7 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
       "generated_at": "2025-03-27T15:00:00.000Z"
     },
     {
-      "file": "worker.js",
+      "file": "index.ts",
       "agent": "server-tracking-agent",
       "status": "generated",
       "size_bytes": 28456,
@@ -387,7 +387,7 @@ Quando o Master Orchestrator invocar o Memory Agent na FASE 0, seguir este fluxo
 
 ### PASSO 1 — Ler Checkpoint Atual
 
-```javascript
+```typescript
 // Master Orchestrator — FASE 0
 const memoryCheckpoint = await readMemoryCheckpoint();
 
@@ -404,7 +404,7 @@ if (memoryCheckpoint) {
 
 ### PASSO 2 — Carregar Contexto para Outros Agentes
 
-```javascript
+```typescript
 // Quando spawnar qualquer agente, passar contexto do Memory Agent
 const agentContext = {
   api_versions: memoryCheckpoint.api_versions,
@@ -423,7 +423,7 @@ await spawnAgent('meta-agent', {
 
 ### PASSO 3 — Verificar Consistência
 
-```javascript
+```typescript
 // Memory Agent deve verificar inconsistências no checkpoint
 function validateCheckpointConsistency(checkpoint) {
   const warnings = [];
@@ -461,7 +461,7 @@ Quando o Master Orchestrator finalizar a FASE 5, seguir este fluxo de escrita:
 
 ### PASSO 1 — Compilar Resumo da Sessão
 
-```javascript
+```typescript
 // Master Orchestrator — FASE 5
 const sessionSummary = {
   session_metadata: {
@@ -488,7 +488,7 @@ const sessionSummary = {
 
 ### PASSO 2 — Atualizar Arquivo de Checkpoint
 
-```javascript
+```typescript
 // Escrever no arquivo principal de memória
 await writeMemoryCheckpoint(sessionSummary);
 
@@ -504,7 +504,7 @@ await cleanupOldSessions(10);
 
 Se o projeto tiver Cloudflare Worker configurado:
 
-```javascript
+```typescript
 // Master Orchestrator — Persistência em KV para próxima sessão
 async function persistToCloudflareKV(summary) {
   const key = `memory_session_${summary.session_metadata.session_id}`;
@@ -529,7 +529,7 @@ Outros agentes podem consultar o Memory Agent para obter informações específi
 
 ### API de Consulta (para outros agentes)
 
-```javascript
+```typescript
 // Qualquer agente pode chamar:
 const memoryQuery = async (query) => {
   const checkpoint = await readMemoryCheckpoint();
@@ -768,7 +768,7 @@ Quando os testes passarem, o Master Orchestrator executa:
 
 **Se usuário confirmar (SIM):**
 
-```javascript
+```typescript
 async function purgeCredentials() {
   // 1. Zerar secrets_configured no checkpoint
   checkpoint.secrets_configured = {};
@@ -809,7 +809,7 @@ async function purgeCredentials() {
 
 ### Função de Formatação de Data
 
-```javascript
+```typescript
 function formatDate(date) {
   const d = new Date(date);
   const year = d.getFullYear();
@@ -821,7 +821,7 @@ function formatDate(date) {
 
 ### Função de Mask de Segredos
 
-```javascript
+```typescript
 function maskSecret(secret) {
   if (!secret || secret.length < 10) return 'NOT_SET';
   const visibleChars = 4;
@@ -836,7 +836,7 @@ function maskSecret(secret) {
 
 ### Função de Cleanup de Histórico
 
-```javascript
+```typescript
 async function cleanupOldSessions(maxSessions) {
   const historyDir = 'agents/memory-agent/history';
   const files = await listFiles(historyDir);

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

@@ -23,7 +23,7 @@ Especialista exclusivo em Meta Pixel (browser via cdpTrack) + Meta Conversions A
 
 ### PASSO 0 — Ler Versões Atuais
 
-```javascript
+```typescript
 // Ler versões do arquivo centralizado
 const apiVersions = await readJSON('contracts/api-versions.json');
 const metaVersion = apiVersions.meta;
@@ -99,7 +99,7 @@ Gere payloads para o Worker seguir a API oficial da Meta:
 {
   "arquivos_gerados": {
     "browser": "cdpTrack.js (eventos Meta injetados)",
-    "server": "cloudflare/meta-capi.js"
+    "server": "modules/dispatch/meta.ts"
   },
   "versao_api": "v22.0",
   "eventos_implementados": ["PageView", "Lead", "InitiateCheckout", "Purchase", "ViewContent"],

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

@@ -155,7 +155,7 @@ is_business_hours = 1 if 9 <= hour_of_day <= 18 else 0
 
 ### 2.3 Perfil textual por lead (input para embedding)
 
-```javascript
+```typescript
 function _buildLeadProfile(l) {
   return [
     `LTV: ${l.predicted_ltv_class || 'desconhecido'}`,
@@ -173,7 +173,7 @@ function _buildLeadProfile(l) {
 
 ### 2.4 Chamada de embeddings em batch
 
-```javascript
+```typescript
 // Embeds até 100 perfis em uma única chamada
 const embRes = await env.AI.run('@cf/baai/bge-m3', { text: profiles });
 const vectors = embRes.data; // float32[][] — shape [N, 768]
@@ -181,15 +181,15 @@ const vectors = embRes.data; // float32[][] — shape [N, 768]
 
 ### 2.5 K-means vetorial (cosine distance)
 
-```javascript
+```typescript
 // Inicialização K-means++ → iterações até convergência → assignments finais
-const { assignments } = _kmeansRun(vectors, nClusters); // implementado em worker.js
+const { assignments } = _kmeansRun(vectors, nClusters); // implementado em index.ts
 const silhouetteScore = _silhouette(vectors, assignments, nClusters); // score real
 ```
 
 ### 2.6 Naming dos clusters via Granite (único uso de LLM)
 
-```javascript
+```typescript
 // Granite recebe apenas as estatísticas agregadas por cluster
 // Retorna nome descritivo + recomendação de campanha em português
 const nameRes = await env.AI.run('@cf/ibm-granite/granite-4.0-h-micro', {
@@ -200,7 +200,7 @@ const nameRes = await env.AI.run('@cf/ibm-granite/granite-4.0-h-micro', {
 
 ### 2.2 Features para K-Means
 
-```javascript
+```typescript
 // Features recomendadas para clustering (com base na análise D1)
 
 const RECOMMENDED_FEATURES = [
@@ -461,7 +461,7 @@ CREATE INDEX IF NOT EXISTS idx_ml_segment_members_lead ON ml_segment_members(lea
 
 ### 7.1 Endpoint de Clustering
 
-```javascript
+```typescript
 // server-edge-tracker/functions/api/segmentation/cluster.ts
 
 export async function onRequestGet(context: EventContext<Env>) {
@@ -515,7 +515,7 @@ export async function onRequestGet(context: EventContext<Env>) {
 
 ### 7.2 Endpoint de Consulta de Segmentos
 
-```javascript
+```typescript
 // server-edge-tracker/functions/api/segmentation/list.ts
 
 export async function onRequestGet(context: EventContext<Env>) {
@@ -546,7 +546,7 @@ export async function onRequestGet(context: EventContext<Env>) {
 
 ### 7.3 Endpoint de Anomalias (DBSCAN)
 
-```javascript
+```typescript
 // server-edge-tracker/functions/api/segmentation/outliers.ts
 
 export async function onRequestGet(context: EventContext<Env>) {

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

@@ -12,6 +12,7 @@ Toda a sua análise deve ser baseada na infraestrutura nativa da Cloudflare.
 - Eventos de formulário servem para captura de PII direto para o **D1 Database**.
 - Conversões externas cruzam dados via Webhook + D1.
 - **Human-Behavior Engine**: Micro-eventos são obrigatórios em TODA página.
+- **Worker:** `server-edge-tracker/index.ts` (TypeScript nativo, compilado via wrangler/esbuild)
 
 ---
 

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

@@ -36,7 +36,7 @@ Prover **monitoramento contínuo e profissional** da performance do sistema de t
 
 ### 1.1 Latência do Worker
 
-```javascript
+```typescript
 // Monitorar tempo de resposta do Cloudflare Worker
 export async function measureWorkerLatency() {
   const sampleSize = 100;
@@ -115,7 +115,7 @@ function evaluateLatencyPerformance(latencyMetrics) {
 
 ### 1.2 Error Rate das APIs
 
-```javascript
+```typescript
 // Monitorar taxa de falhas em todas as APIs
 export async function measureApiErrorRate(env, hours = 24) {
   const platforms = ['meta', 'google', 'tiktok', 'pinterest', 'reddit'];
@@ -167,7 +167,7 @@ function evaluateErrorRate(errorRate) {
 
 ### 1.3 Throughput do Sistema
 
-```javascript
+```typescript
 // Monitorar eventos processados por segundo/minuto
 export async function measureThroughput(env, hours = 24) {
   const now = new Date();
@@ -237,7 +237,7 @@ function evaluateThroughputTrend(recent, historical) {
 
 ### 1.4 Performance de D1
 
-```javascript
+```typescript
 // Monitorar performance do banco de dados D1
 export async function measureD1Performance(env, hours = 24) {
   // Queries lentas
@@ -331,7 +331,7 @@ function evaluateD1Health(slowQueries, locks, dbSize) {
 
 ### 1.5 Cache Performance (KV)
 
-```javascript
+```typescript
 // Monitorar eficiência do cache KV
 export async function measureCachePerformance(env, hours = 24) {
   // Cache hits e misses
@@ -549,7 +549,7 @@ alerts:
 
 ### Implementação com Server-Sent Events (SSE)
 
-```javascript
+```typescript
 // Endpoint SSE para atualizações em tempo real do dashboard
 export async function handleMonitoringStream(request, env) {
   const headers = {
@@ -856,7 +856,7 @@ cpu_ms = 50 # Aumentar de 10ms para 50ms
 **Problema:** Queries repetidas ao D1 degradam performance.
 
 **Solução:**
-```javascript
+```typescript
 // Cache de métricas globais por 1 hora
 const cacheKey = `metrics:global:${getHourBucket()}`;
 const cached = await env.GEO_CACHE.get(cacheKey);
@@ -881,7 +881,7 @@ return metrics;
 **Problema:** Processar eventos um por um é ineficiente.
 
 **Solução:**
-```javascript
+```typescript
 // Agrupar eventos em batches de 10
 const eventBatches = [];
 for (let i = 0; i < events.length; i += 10) {
@@ -950,7 +950,7 @@ WHERE e.created_at > datetime('now', '-1 day')
 **Problema:** Enviar eventos muito rápido causa 429 errors.
 
 **Solução:**
-```javascript
+```typescript
 // Rate limiting com token bucket algorithm
 const RATE_LIMITS = {
   meta: { tokens: 200, refill_rate: 10 },      // 200 req/min, recarrega 10/min
@@ -985,7 +985,7 @@ async function consumeToken(platform, env) {
 **Problema:** Perda de eventos durante rate limits.
 
 **Solução:**
-```javascript
+```typescript
 // Cloudflare Queue para eventos bloqueados
 export async function queueEventForRetry(event, platform, reason) {
   await QUEUE.send('cdp-edge-events', {
@@ -1018,7 +1018,7 @@ setInterval(async () => {
 **Problema:** TTL muito baixo causa cache misses frequentes.
 
 **Solução:**
-```javascript
+```typescript
 // TTLs otimizados por tipo de dado
 const CACHE_TTL = {
   metrics_global: 3600,      // 1 hora para métricas globais
@@ -1038,7 +1038,7 @@ const CACHE_TTL = {
 **Problema:** Cache desatualizado causa dados incorretos.
 
 **Solução:**
-```javascript
+```typescript
 // Invalidar cache quando dados mudarem
 async function invalidateCacheOnChange(eventType, env) {
   const patterns = {

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

@@ -75,7 +75,7 @@ Agente especializado em otimização de performance para o sistema CDP Edge (Clo
 
 ### L1: Memory Cache (Request-Scoped)
 
-```javascript
+```typescript
 /**
  * L1 Memory Cache - In-request cache with automatic expiration
  */
@@ -163,7 +163,7 @@ let l1Cache = new L1Cache();
 
 ### L2: KV Cache (Global Edge Cache)
 
-```javascript
+```typescript
 /**
  * L2 KV Cache - Global distributed cache with automatic invalidation
  */
@@ -314,7 +314,7 @@ let l2Cache = null;
 
 ### Cache Strategy Implementation
 
-```javascript
+```typescript
 /**
  * Multi-Layer Cache Manager
  * Orchestrates L1 and L2 caches with fallback logic
@@ -485,7 +485,7 @@ CREATE INDEX IF NOT EXISTS idx_channel_performance_updated
 
 ### Query Optimization Patterns
 
-```javascript
+```typescript
 /**
  * Optimized Query Builder for D1
  */
@@ -676,7 +676,7 @@ let queryOptimizer = null;
 
 ### Batch Processing for Attribution
 
-```javascript
+```typescript
 /**
  * Batch Attribution Processor
  * Processes multiple attributions in parallel with batching
@@ -938,7 +938,7 @@ let batchProcessor = null;
 
 ### Performance Monitoring
 
-```javascript
+```typescript
 /**
  * Latency Profiler
  * Monitors and tracks performance metrics
@@ -1209,7 +1209,7 @@ let latencyProfiler = new LatencyProfiler();
 
 ### Worker API Endpoints
 
-```javascript
+```typescript
 /**
  * Performance Monitoring Endpoints
  */

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

@@ -34,7 +34,7 @@ Buscar: "Pinterest", "pintrk", "pin_id", "Pinterest Conversions API", "PINTEREST
 
 ### PASSO 0 obrigatório — Ler Versões de API (api-versions.json)
 
-```javascript
+```typescript
 // Ler versões do arquivo centralizado
 const apiVersions = await readJSON('contracts/api-versions.json');
 const pinterestVersion = apiVersions.pinterest;
@@ -86,7 +86,7 @@ if (isDeprecated) {
 
 **Ler do template:** `models/pinterest/tag-template.js`
 
-```javascript
+```typescript
 import { PINTEREST_TAG_TEMPLATE } from '../models/pinterest/tag-template.js';
 
 // Substituir placeholders
@@ -193,7 +193,7 @@ Seu código gerado será incorporado pelo **Browser Tracking Agent** e **Server
 [Função de inicialização + pintrk('load') + pintrk('page')]
 
 ### PINTEREST_CONVERSIONS_API_FUNCTION
-[função sendPinterestApi() para o worker.js]
+[função sendPinterestApi() para o index.ts]
 
 ### PINTEREST_HEAD_TAGS
 [tags <script> e <noscript> para inserir no <head>]
@@ -205,7 +205,7 @@ Seu código gerado será incorporado pelo **Browser Tracking Agent** e **Server
 [Referência ao models/pinterest/event-mappings.json]
 ```
 
-O Master Orchestrator usará esses blocos para injetar no `tracking.js` e `worker.js` via Write/Edit.
+O Master Orchestrator usará esses blocos para injetar no `tracking.js` e `index.ts` via Write/Edit.
 
 ---
 
@@ -254,7 +254,7 @@ wrangler secret put PINTEREST_AD_ACCOUNT_ID --name server-edge-tracker
 Quando o Master Orchestrator solicitar código do Pinterest Agent:
 
 1. **Ler versões da API:**
-   ```javascript
+   ```typescript
    const apiVersions = await readJSON('contracts/api-versions.json');
    const pinterestVersion = apiVersions.pinterest.conversions_api.current; // "v5"
    ```
@@ -302,7 +302,7 @@ Quando o Master Orchestrator solicitar código do Pinterest Agent:
 {
   "blocos_gerados": {
     "PINTEREST_BROWSER_SNIPPET": "pintrk('load') + pintrk('page') + eventos",
-    "PINTEREST_CONVERSIONS_API_FUNCTION": "sendPinterestApi() para worker.js",
+    "PINTEREST_CONVERSIONS_API_FUNCTION": "sendPinterestApi() para index.ts",
     "PINTEREST_HEAD_TAGS": "<script> + <noscript> para <head>",
     "PINTEREST_CSP_DOMAINS": ["ct.pinterest.com", "log.pinterest.com"]
   },

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

@@ -711,10 +711,10 @@ const browserTracking = {
 };
 ```
 
-### O que roda no Servidor (Cloudflare Worker)
+### O que roda no Servidor (Cloudflare Worker — TypeScript)
 
-```javascript
-// Server Tracking - Processamento e despacho para plataformas
+```typescript
+// Server Tracking - Processamento e despacho para plataformas (index.ts)
 const serverTracking = {
   // 1. Receber evento do browser
   handleEvent: async (eventData, env, ctx) => {

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

@@ -111,13 +111,13 @@ bucket_name = "cdp-edge-logs"
 
 ---
 
-## Fase 4 — Ativar saveAuditLog() no worker.js
+## Fase 4 — Ativar saveAuditLog() no index.ts
 
-O worker.js já possui a função `saveAuditLog()` implementada mas com o binding condicional. Após descomentar o binding, ela passa a salvar automaticamente.
+O index.ts já possui a função `saveAuditLog()` implementada mas com o binding condicional. Após descomentar o binding, ela passa a salvar automaticamente.
 
-### Verificar a função no worker.js:
+### Verificar a função no index.ts:
 
-```javascript
+```typescript
 // Buscar por: saveAuditLog ou AUDIT_LOGS
 async function saveAuditLog(env, eventId, eventType, payload, platforms) {
   if (!env.AUDIT_LOGS) return; // Skip se R2 não configurado (graceful degradation)
@@ -139,9 +139,9 @@ async function saveAuditLog(env, eventId, eventType, payload, platforms) {
 }
 ```
 
-Se a função não existir ainda, adicionar ao worker.js (seção de funções utilitárias):
+Se a função não existir ainda, adicionar ao index.ts (seção de funções utilitárias):
 
-```javascript
+```typescript
 // ── R2 Audit Log ─────────────────────────────────────────────────────────────
 async function saveAuditLog(env, eventId, eventType, payload, platforms) {
   if (!env.AUDIT_LOGS) return;
@@ -161,7 +161,7 @@ async function saveAuditLog(env, eventId, eventType, payload, platforms) {
 
 Adicionar ao `Promise.allSettled` no endpoint `/track` (dentro de `ctx.waitUntil`):
 
-```javascript
+```typescript
 // Adicionar como última entrada no allSettled:
 saveAuditLog(env, eventId, eventType, payload, ['meta', 'ga4', 'tiktok']),
 ```
@@ -226,7 +226,7 @@ R2 Dashboard
 [ ] R2 habilitado no Cloudflare Dashboard
 [ ] Bucket cdp-edge-logs criado
 [ ] wrangler.toml: [[r2_buckets]] descomentado
-[ ] worker.js: saveAuditLog() implementada
+[ ] index.ts: saveAuditLog() implementada
 [ ] wrangler deploy executado sem erros
 [ ] Evento de teste disparado
 [ ] Objeto .json visível no R2 Dashboard

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

@@ -36,7 +36,7 @@ Buscar: "Reddit", "reddit pixel", "rdt", "Reddit Conversions API"
 
 ### PASSO 0 obrigatório — Ler Versões de API (api-versions.json)
 
-```javascript
+```typescript
 // Ler versões do arquivo centralizado
 const apiVersions = await readJSON('contracts/api-versions.json');
 const redditVersion = apiVersions.reddit;
@@ -86,7 +86,7 @@ if (isDeprecated) {
 
 **Ler do template:** `models/reddit/pixel-template.js`
 
-```javascript
+```typescript
 import { REDDIT_PIXEL_TEMPLATE } from '../models/reddit/pixel-template.js';
 
 // Substituir placeholders
@@ -152,7 +152,7 @@ function reinitRedditWithUserData(userData) {
 
 **Ler do template:** `models/reddit/conversions-api-template.js`
 
-```javascript
+```typescript
 // Reutilizar funções do template
 import {
   trackRedditLead,
@@ -240,13 +240,13 @@ Seu código gerado (Reddit Pixel browser + Conversions API server) será incorpo
 [rdt('init') + rdt('track', 'PageVisit') + funções de evento browser]
 
 ### REDDIT_CONVERSIONS_FUNCTION
-[função sendRedditApi() para o worker.js]
+[função sendRedditApi() para o index.ts]
 
 ### REDDIT_HEAD_TAGS
 [tag <script> para inserir no <head>]
 ```
 
-O Master Orchestrator usará esses blocos para injetar no `tracking.js` e `worker.js` via Write/Edit.
+O Master Orchestrator usará esses blocos para injetar no `tracking.js` e `index.ts` via Write/Edit.
 
 ---
 
@@ -255,7 +255,7 @@ O Master Orchestrator usará esses blocos para injetar no `tracking.js` e `worke
 Quando o Master Orchestrator solicitar código do Reddit Agent:
 
 1. **Ler versões da API:**
-   ```javascript
+   ```typescript
    const apiVersions = await readJSON('contracts/api-versions.json');
    const redditVersion = apiVersions.reddit.conversions_api.current; // "v2.0"
    ```
@@ -305,7 +305,7 @@ Quando o Master Orchestrator solicitar código do Reddit Agent:
 {
   "blocos_gerados": {
     "REDDIT_BROWSER_SNIPPET": "rdt('init') + rdt('track', 'PageVisit') + eventos",
-    "REDDIT_CONVERSIONS_FUNCTION": "sendRedditApi() para worker.js",
+    "REDDIT_CONVERSIONS_FUNCTION": "sendRedditApi() para index.ts",
     "REDDIT_HEAD_TAGS": "<script> para <head>"
   },
   "versao_api": "v2.0",