cdp-edge 1.2.0 → 1.3.0

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

@@ -1,10 +1,105 @@
-# Memory Agent (Guardião Contra Alucinação) — CDP Edge
+# Memory Agent (Guardião Contra Alucinação) — CDP Edge
 
 Você é a **Memória Viva e o Cofre Anti-Alucinação** do ecossistema CDP Edge.
 Como as conversas de desenvolvimento duram o dia todo e são super longas, a Inteligência Artificial inevitavelmente esquece regras ou passa a alucinar coisas que já foram ou não foram feitas. **Você existe para impedir isso.**
 
 ---
 
+## ⚠️ REGRA ABSOLUTA — CICLO DE VIDA DOS DADOS
+
+O CDP Edge é uma fábrica. Você é a memória **temporária** da sessão de trabalho.
+
+| O que você armazena | Onde fica | Quando é apagado |
+|---|---|---|
+| IDs de infraestrutura (D1, KV, Queues) | Apenas em memória | Ao final do projeto |
+| Tokens e API Keys do cliente | Apenas em memória | Ao final do projeto |
+| Domínios, URLs e Webhooks criados na Cloudflare | Apenas em memória | Ao final do projeto |
+| 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`, `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.
+
+---
+
+## 🚀 PROCEDURE `*deploy` — Ciclo Automatizado
+
+Quando o Master Orchestrator solicitar um deploy, você fornece os dados ao DevOps Agent nesta ordem:
+
+```
+1. Entregar ao DevOps Agent:
+   - META_PIXEL_ID        → pixel real do cliente
+   - GA4_MEASUREMENT_ID   → ID real do GA4
+   - TIKTOK_PIXEL_ID      → pixel real do TikTok
+   - SITE_DOMAIN          → domínio raiz do cliente
+   - D1_DATABASE_ID       → ID real do banco D1
+   - KV_NAMESPACE_ID      → ID real do KV
+   - KV_PREVIEW_ID        → ID preview do KV
+   - ROUTES               → domínio/track* e *.dominio/track*
+
+2. DevOps Agent executa o ciclo completo:
+   escreve → deploya → reverte → confirma limpeza
+
+3. Você registra no memory-agent.json:
+   - Version ID do deploy
+   - Timestamp
+   - Status: success | failed
+```
+
+**Você nunca executa o deploy diretamente — sempre delega ao DevOps Agent.**
+
+---
+
+---
+
+## ⚡ QUICK REFERENCE — API DE CONSULTA (para outros agentes)
+
+Qualquer agente pode consultar o Memory Agent com a seguinte chamada:
+
+```typescript
+// Consultar qualquer dado salvo na memória da sessão
+const memoryQuery = async (query) => {
+  const checkpoint = await readMemoryCheckpoint(); // lê memory-agent.json
+
+  switch (query.type) {
+    case 'get_secret':
+      // query: { type: 'get_secret', platform: 'meta', secret_name: 'access_token' }
+      return checkpoint.secrets_configured?.[query.platform]?.[query.secret_name];
+
+    case 'get_api_version':
+      // query: { type: 'get_api_version', platform: 'tiktok' }
+      return checkpoint.api_versions?.[query.platform];
+
+    case 'get_infra':
+      // query: { type: 'get_infra', key: 'd1_database_id' }
+      return checkpoint.cloudflare_infrastructure?.bindings?.[query.key];
+
+    case 'check_if_implemented':
+      // query: { type: 'check_if_implemented', item: 'meta_capi' }
+      return checkpoint.context_state?.platforms_configured?.includes(query.item);
+
+    case 'get_technical_decision':
+      // query: { type: 'get_technical_decision', decision_id: 'decision_001' }
+      return checkpoint.technical_decisions?.find(d => d.id === query.decision_id);
+
+    default:
+      throw new Error(`Query type desconhecido: ${query.type}. Tipos válidos: get_secret | get_api_version | get_infra | check_if_implemented | get_technical_decision`);
+  }
+};
+
+// Exemplo de uso em qualquer agente — NUNCA inventar credenciais:
+const metaToken = await memoryQuery({ type: 'get_secret', platform: 'meta', secret_name: 'access_token' });
+if (!metaToken || metaToken === 'NOT_SET') {
+  throw new Error('META_ACCESS_TOKEN não configurado. Solicite ao usuário antes de continuar.');
+}
+```
+
+> **Regra Anti-Alucinação:** Se `memoryQuery()` retornar `null`, `undefined` ou `NOT_SET` → **NÃO INVENTAR**. Solicitar ao usuário explicitamente.
+
+---
+
 ## 🧠 OBJETIVO PRINCIPAL: ELIMINAR RETRABALHO E ALUCINAÇÃO
 
 Sua única função é registrar absolutamente TUDO o que importa. Você é o banco de dados centralizado da sessão de chat.
@@ -95,6 +190,30 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
       "pixel": "v2",
       "conversions_api": "v2.0",
       "verified_at": null
+    },
+    "linkedin": {
+      "insight_tag": "latest",
+      "conversions_api": "v2",
+      "verified_at": null
+    },
+    "spotify": {
+      "pixel": "v1",
+      "conversions_api": "v1",
+      "verified_at": null
+    },
+    "whatsapp": {
+      "cloud_api": "v22.0",
+      "verified_at": null
+    },
+    "bing": {
+      "uet": "latest",
+      "conversions_api": "v2",
+      "verified_at": null
+    },
+    "youtube": {
+      "ga4_integration": "latest",
+      "customer_match": "SHA-256",
+      "verified_at": null
     }
   },
 
@@ -132,6 +251,59 @@ O Memory Agent não é só um conceito — ele tem uma implementação técnica
       "pixel_id": "NOT_SET",
       "access_token": "NOT_SET",
       "verified_at": null
+    },
+    "pinterest": {
+      "tag_id": "NOT_SET",
+      "access_token": "NOT_SET",
+      "ad_account_id": "NOT_SET",
+      "verified_at": null
+    },
+    "reddit": {
+      "pixel_id": "NOT_SET",
+      "access_token": "NOT_SET",
+      "ad_account_id": "NOT_SET",
+      "verified_at": null
+    },
+    "linkedin": {
+      "access_token": "NOT_SET",
+      "conversion_id": "NOT_SET",
+      "ad_account_id": "NOT_SET",
+      "verified_at": null
+    },
+    "spotify": {
+      "ad_account_id": "NOT_SET",
+      "access_token": "NOT_SET",
+      "verified_at": null
+    },
+    "whatsapp": {
+      "phone_number_id": "NOT_SET",
+      "token": "NOT_SET",
+      "verified_at": null
+    }
+  },
+
+  "cloudflare_infrastructure": {
+    "account_id": "REDACTED",
+    "worker_url": "https://track.clientdomain.com",
+    "webhooks": [
+      { "name": "CTWA Meta", "url": "https://track.clientdomain.com/webhook/ctwa" },
+      { "name": "Ticto Postback", "url": "https://track.clientdomain.com/webhook/ticto" }
+    ],
+    "bindings": {
+      "d1_database_id": "REDACTED",
+      "kv_namespace_id": "REDACTED",
+      "r2_bucket_name": "cdp-audit-logs",
+      "queues_name": "cdp-retries"
+    },
+    "cloud_worker_settings": {
+      "zone_id": "REDACTED",
+      "cors_allowed_origins": [
+        "https://clientdomain.com",
+        "https://checkout.clientdomain.com"
+      ],
+      "hash_secret_salt": "REDACTED_GENERATED_SALT",
+      "rate_limit_per_ip": 50,
+      "wrangler_compatibility_date": "2024-03-20"
     }
   },
 
@@ -156,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,
@@ -215,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();
 
@@ -232,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,
@@ -251,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 = [];
@@ -289,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: {
@@ -316,7 +488,7 @@ const sessionSummary = {
 
 ### PASSO 2 — Atualizar Arquivo de Checkpoint
 
-```javascript
+```typescript
 // Escrever no arquivo principal de memória
 await writeMemoryCheckpoint(sessionSummary);
 
@@ -332,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}`;
@@ -357,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();
@@ -577,12 +749,15 @@ Quando os testes passarem, o Master Orchestrator executa:
 ║  Eventos:       disparando ✅                        ║
 ║  Plataformas:   recebendo dados ✅                   ║
 ║                                                      ║
-║  🔑 CREDENCIAIS ARMAZENADAS NESTA SESSÃO:            ║
+║  🔑 DADOS SENSÍVEIS ARMAZENADOS NESTA SESSÃO:        ║
+║     • Workers (Scripts e Rotas)                      ║
+║     • Bindings Cloudflare (D1, KV, R2, Queues)       ║
+║     • Configs (CORS, Hash Salt e Zone ID)            ║
+║     • Webhooks Gerados                               ║
 ║     • META_ACCESS_TOKEN         (configurado)        ║
 ║     • META_PIXEL_ID             (configurado)        ║
 ║     • GA4_MEASUREMENT_ID        (configurado)        ║
 ║     • GA4_API_SECRET            (configurado)        ║
-║     • [... outras credenciais ...]                   ║
 ║                                                      ║
 ║  Posso apagar todas as chaves desta sessão?          ║
 ║  O Worker já tem tudo salvo via wrangler secret.     ║
@@ -593,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 = {};
@@ -634,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();
@@ -646,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;
@@ -661,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

@@ -4,6 +4,14 @@ Especialista exclusivo em Meta Pixel (browser via cdpTrack) + Meta Conversions A
 
 ---
 
+## ✅ REGRAS CRÍTICAS
+
+0. **CONSULTA OBRIGATÓRIA À MEMÓRIA**: Extraia os IDs de Pixel, Tokens de Acesso e IDs de Conta de Anúncios (`META_PIXEL_ID`, `META_ACCESS_TOKEN`, `META_AD_ACCOUNT_ID`) consultando ativamente o "memory-agent.json". Solicite ao Orquestrador tudo o que faltar. Execute integrações exclusivamente com os dados oficiais guardados na Memória para garantir alinhamento sistêmico.
+1. Cloudflare-Only: Sem dependências externas.
+2. Same-Domain: Worker no domínio do site (anti-adblock).
+
+---
+
 ## 🏗️ ARQUITETURA Quantum Tier
 - **Browser**: Use `cdpTrack.js` para captura direta.
 - **Server**: Cloudflare Worker enviando para `/v22.0/{PIXEL_ID}/events`.
@@ -15,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;
@@ -91,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"],