cdp-edge 1.2.2 → 1.3.0

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

@@ -50,12 +50,12 @@ Implementar um **ciclo virtuoso de melhoria contínua** onde o CDP Edge aprende
 
 ### 1.1 Fontes de Feedback
 
-```javascript
+```typescript
 // Coleta estruturada de feedback de todos os agentes
-async function collectFeedback() {
+async function collectFeedback(env) {
   const feedback = {
-    validator: await collectValidatorFeedback(),
-    server_tracking: await collectServerTrackingFeedback(),
+    validator: await collectValidatorFeedback(env),
+    server_tracking: await collectServerTrackingFeedback(env),
     page_analyzer: await collectPageAnalyzerFeedback(),
     memory_agent: await collectMemoryAgentFeedback(),
     debug_agent: await collectDebugAgentFeedback(),
@@ -73,8 +73,8 @@ async function collectFeedback() {
 }
 
 // Feedback específico do Validator Agent
-async function collectValidatorFeedback() {
-  const validations = await DB.prepare(`
+async function collectValidatorFeedback(env) {
+  const validations = await env.DB.prepare(`
     SELECT
       agent_id,
       issue_type,
@@ -97,8 +97,8 @@ async function collectValidatorFeedback() {
 }
 
 // Feedback de Server Tracking (falhas de API)
-async function collectServerTrackingFeedback() {
-  const failures = await DB.prepare(`
+async function collectServerTrackingFeedback(env) {
+  const failures = await env.DB.prepare(`
     SELECT
       platform,
       event_name,
@@ -136,7 +136,7 @@ async function collectMemoryAgentFeedback() {
 
 ### 1.2 Coleta de Feedback de Plataformas
 
-```javascript
+```typescript
 // Feedback de agentes de plataforma (API versions, deprecations)
 async function collectPlatformAgentFeedback(platform) {
   const feedback = {
@@ -173,7 +173,7 @@ function calculatePlatformHealthScore(feedback) {
 
 ### 2.1 Identificação de Padrões Recorrentes
 
-```javascript
+```typescript
 // Analisar padrões de problemas
 function analyzePatterns(feedback) {
   const patterns = {
@@ -235,7 +235,7 @@ function calculateTrend(issues) {
 
 ### 2.2 Análise de Causa Raiz Sistêmica
 
-```javascript
+```typescript
 // Identificar causas raiz de problemas sistêmicos
 function identifySystemicRootCauses(patterns) {
   const rootCauses = [];
@@ -309,7 +309,7 @@ function priorityOrder(priority) {
 
 ### 3.1 Matriz de Priorização
 
-```javascript
+```typescript
 // Priorizar melhorias baseado em impacto × esforço
 function prioritizeImprovements(rootCauses, feedback) {
   const improvements = rootCauses.map(cause => ({
@@ -382,7 +382,7 @@ function calculateUrgencyScore(cause) {
 
 ### 3.2 Classificação de Melhorias
 
-```javascript
+```typescript
 // Classificar melhorias em categorias
 function classifyImprovements(improvements) {
   return {
@@ -400,7 +400,7 @@ function classifyImprovements(improvements) {
 
 ### 4.1 Roteamento de Melhorias para Agentes
 
-```javascript
+```typescript
 // Rotear melhorias para os agentes apropriados
 async function routeImprovements(improvements) {
   const routing = {
@@ -463,7 +463,7 @@ function calculateDeadline(priority) {
 
 ### 4.2 Orquestração Paralela de Correções
 
-```javascript
+```typescript
 // Executar correções em paralelo sempre que possível
 async function orchestrateCorrections(routing) {
   const results = {
@@ -533,7 +533,7 @@ async function executeCorrectionsForAgent(agent, tasks) {
 
 ### 5.1 Atualização de Base de Conhecimento
 
-```javascript
+```typescript
 // Atualizar knowledge-base.md com aprendizados
 async function updateKnowledgeBase(corrections) {
   const learnings = extractLearnings(corrections);
@@ -579,7 +579,7 @@ function calculateConfidenceScore(correction) {
 
 ### 5.2 Atualização de Templates e Contratos
 
-```javascript
+```typescript
 // Atualizar templates e contratos automaticamente
 async function updateTemplatesAndContracts(corrections) {
   const updates = [];
@@ -736,7 +736,7 @@ O Master Orchestrator deve salvar em `feedback-loop-cycle-{timestamp}.md` e atua
 
 ### Frequência de Execução
 
-```javascript
+```typescript
 // Configuração automática de ciclos de feedback loop
 const FEEDBACK_LOOP_CONFIG = {
   // Ciclo completo: Coleta → Análise → Correção → Atualização
@@ -785,6 +785,66 @@ const FEEDBACK_LOOP_CONFIG = {
 
 ---
 
+## 🗄️ D1 SCHEMA — TABELAS REQUERIDAS
+
+As funções `collectValidatorFeedback()` e `collectServerTrackingFeedback()` dependem das seguintes tabelas. Executar no D1 antes do primeiro ciclo:
+
+```sql
+-- Tabela: validation_logs
+-- Alimentada pelo Validator Agent após cada validação de tracking plan
+CREATE TABLE IF NOT EXISTS validation_logs (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  agent_id      TEXT    NOT NULL,                    -- ex: 'validator-agent', 'tracking-plan-agent'
+  issue_type    TEXT    NOT NULL,                    -- ex: 'missing_event', 'wrong_selector', 'pii_not_hashed'
+  severity      TEXT    NOT NULL CHECK (severity IN ('CRITICAL','HIGH','MEDIUM','LOW')),
+  description   TEXT,
+  resolution_status TEXT NOT NULL DEFAULT 'pending' CHECK (resolution_status IN ('pending','resolved','wontfix')),
+  time_to_resolve_ms INTEGER,                        -- NULL enquanto pending
+  created_at    TEXT    NOT NULL DEFAULT (datetime('now')),
+  resolved_at   TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_vl_created  ON validation_logs(created_at);
+CREATE INDEX IF NOT EXISTS idx_vl_severity ON validation_logs(severity);
+CREATE INDEX IF NOT EXISTS idx_vl_status   ON validation_logs(resolution_status);
+
+-- Tabela: api_failures
+-- Alimentada pelo Server Tracking Agent (index.ts) quando um dispatch CAPI falha
+CREATE TABLE IF NOT EXISTS api_failures (
+  id           INTEGER PRIMARY KEY AUTOINCREMENT,
+  platform     TEXT    NOT NULL,                     -- ex: 'meta', 'google', 'tiktok', 'linkedin'
+  event_name   TEXT    NOT NULL,                     -- ex: 'Purchase', 'Lead', 'ViewContent'
+  error_code   TEXT,                                 -- HTTP status ou código interno, ex: '429', 'TIMEOUT'
+  error_message TEXT,
+  retry_count  INTEGER NOT NULL DEFAULT 0,
+  final_status TEXT    NOT NULL DEFAULT 'failed' CHECK (final_status IN ('failed','success','dlq')),
+  event_id     TEXT,                                 -- para correlação com events_log
+  created_at   TEXT    NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_af_platform   ON api_failures(platform);
+CREATE INDEX IF NOT EXISTS idx_af_created    ON api_failures(created_at);
+CREATE INDEX IF NOT EXISTS idx_af_error_code ON api_failures(error_code);
+```
+
+### Como alimentar as tabelas
+
+```typescript
+// No Validator Agent — ao detectar um problema:
+await env.DB.prepare(`
+  INSERT INTO validation_logs (agent_id, issue_type, severity, description)
+  VALUES (?, ?, ?, ?)
+`).bind('validator-agent', issueType, severity, description).run();
+
+// No index.ts — ao falhar um dispatch CAPI (já em ctx.waitUntil):
+await env.DB.prepare(`
+  INSERT INTO api_failures (platform, event_name, error_code, error_message, retry_count, final_status, event_id)
+  VALUES (?, ?, ?, ?, ?, ?, ?)
+`).bind(platform, eventName, errorCode, errorMessage, retryCount, finalStatus, eventId).run();
+```
+
+---
+
 ## 📊 CHECKLIST DE IMPLEMENTAÇÃO
 
 ### Coleta de Feedback
@@ -852,7 +912,7 @@ const FEEDBACK_LOOP_CONFIG = {
 
 ### Cron Triggers no Cloudflare Worker
 
-```javascript
+```typescript
 // Configurar triggers no wrangler.toml
 [triggers]
 crons = [
@@ -864,10 +924,10 @@ crons = [
 
 ### Handlers de Execução
 
-```javascript
+```typescript
 // Handler do ciclo completo
 export async function scheduledFullCycle(event, env, ctx) {
-  const feedback = await collectFeedback();
+  const feedback = await collectFeedback(env);
   const patterns = await analyzePatterns(feedback);
   const rootCauses = await identifySystemicRootCauses(patterns);
   const improvements = await prioritizeImprovements(rootCauses, feedback);