cdp-edge 1.18.0 → 1.18.2

package/contracts/api-versions.json

@@ -212,10 +212,14 @@
         ]
       },
       "conversions_api": {
-        "current": "v2",
-        "minimum_supported": "v1",
-        "recommended": "v2",
-        "endpoint_pattern": "https://api.linkedin.com/rest/attributionConversions/{VERSION}",
+        "current": "202401",
+        "minimum_supported": "202401",
+        "recommended": "202401",
+        "endpoint_pattern": "https://api.linkedin.com/rest/conversionEvents",
+        "required_headers": {
+          "LinkedIn-Version": "202401",
+          "X-Restli-Protocol-Version": "2.0.0"
+        },
         "authentication": "Bearer token (LINKEDIN_ACCESS_TOKEN)",
         "rate_limits": {
           "requests_per_second": 10,
@@ -359,10 +363,10 @@
   },
 
   "last_updated_by": {
-    "agent": "Intelligence Agent",
-    "session_id": "CDP_2026-03-28_sync",
-    "timestamp": "2026-03-28T00:00:00.000Z"
+    "agent": "Audit — CDP Edge v2.0",
+    "session_id": "CDP_2026-04-10_audit",
+    "timestamp": "2026-04-10T00:00:00.000Z"
   },
 
-  "next_review_date": "2026-04-27T00:00:00.000Z"
+  "next_review_date": "2026-05-10T00:00:00.000Z"
 }

package/dist/commands/install.js

@@ -0,0 +1,186 @@
+/**
+ * CDP Edge Install Command
+ * Instala o CDP Edge em qualquer projeto de cliente
+ *
+ * Uso: cdp-edge install [dir] [--name "Nome do Projeto"] [--cursor]
+ *
+ * O que faz:
+ * 1. Copia os arquivos do CDP Edge para <dir>/cdp-edge/
+ * 2. Cria <dir>/.claude/commands/cdp.md  → habilita /cdp no Claude Code
+ * 3. Cria <dir>/CLAUDE.md               → auto-ativação opcional
+ * 4. Cria <dir>/.cursorrules            → Cursor IDE (flag --cursor)
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import chalk from 'chalk';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Raiz do pacote CDP Edge (2 níveis acima de dist/commands/)
+const CDP_EDGE_ROOT = path.resolve(__dirname, '..', '..');
+
+function printBanner() {
+  console.log('');
+  console.log(chalk.white.bold('  CDP Edge Installation'));
+  console.log('');
+  console.log(chalk.cyan(' ██████╗██████╗ ██████╗     ███████╗██████╗  ██████╗ ███████╗'));
+  console.log(chalk.cyan('██╔════╝██╔══██╗██╔══██╗    ██╔════╝██╔══██╗██╔════╝ ██╔════╝'));
+  console.log(chalk.cyan('██║     ██║  ██║██████╔╝    █████╗  ██║  ██║██║  ███╗█████╗  '));
+  console.log(chalk.cyan('██║     ██║  ██║██╔═══╝     ██╔══╝  ██║  ██║██║   ██║██╔══╝  '));
+  console.log(chalk.cyan('╚██████╗██████╔╝██║         ███████╗██████╔╝╚██████╔╝███████╗'));
+  console.log(chalk.cyan(' ╚═════╝╚═════╝ ╚═╝         ╚══════╝╚═════╝  ╚═════╝╚══════╝'));
+  console.log('');
+  console.log(chalk.gray('  Customer Data Platform on the Edge · Global Edge Tracking · v2.0.2'));
+  console.log('');
+  console.log(chalk.gray('═'.repeat(68)));
+  console.log('');
+}
+
+export async function runInstall(targetDir = '.', options = {}) {
+  const projectName = options.name || path.basename(path.resolve(targetDir));
+  const target = path.resolve(targetDir);
+
+  printBanner();
+
+  console.log(chalk.gray(`  Projeto: ${chalk.white(projectName)}`));
+  console.log(chalk.gray(`  Destino: ${chalk.white(target)}\n`));
+
+  // 1. Garantir que o diretório alvo existe
+  if (!fs.existsSync(target)) {
+    fs.mkdirSync(target, { recursive: true });
+    console.log(chalk.green(`✔ Diretório criado: ${target}`));
+  }
+
+  // 2. Copiar arquivos CDP Edge para <target>/cdp-edge/
+  const cdpEdgeDest = path.join(target, 'cdp-edge');
+  const foldersToInstall = [
+    'extracted-skill',
+    'server-edge-tracker',
+    'templates',
+    'docs',
+  ];
+
+  let installedFromSource = false;
+  const missingFolders = [];
+
+  for (const folder of foldersToInstall) {
+    const src = path.join(CDP_EDGE_ROOT, folder);
+    const dest = path.join(cdpEdgeDest, folder);
+
+    if (fs.existsSync(src)) {
+      copyDir(src, dest);
+      console.log(chalk.green(`✔ Copiado: cdp-edge/${folder}/`));
+      installedFromSource = true;
+    } else {
+      missingFolders.push(folder);
+    }
+  }
+
+  if (!installedFromSource) {
+    // Pacote instalado via npm sem os arquivos de código-fonte
+    console.log(chalk.yellow('\n⚠  Arquivos de skill não encontrados no pacote npm.'));
+    console.log(chalk.yellow('   Clone o repositório completo manualmente:'));
+    console.log(chalk.cyan('\n   git clone https://github.com/ricardosoli777/CDP-Edge-Premium cdp-edge\n'));
+  } else if (missingFolders.length > 0) {
+    console.log(chalk.yellow(`\n⚠  Pastas não encontradas (ignoradas): ${missingFolders.join(', ')}`));
+  }
+
+  // 3. Criar .claude/commands/cdp.md → habilita /cdp no Claude Code
+  const commandSrc = path.join(CDP_EDGE_ROOT, 'templates', 'install', '.claude', 'commands', 'cdp.md');
+  const commandDest = path.join(target, '.claude', 'commands', 'cdp.md');
+
+  if (fs.existsSync(commandDest)) {
+    console.log(chalk.yellow('⚠  .claude/commands/cdp.md já existe — não sobrescrito.'));
+  } else {
+    fs.mkdirSync(path.dirname(commandDest), { recursive: true });
+    if (fs.existsSync(commandSrc)) {
+      fs.copyFileSync(commandSrc, commandDest);
+    } else {
+      // Fallback inline
+      fs.writeFileSync(commandDest,
+        'Leia o arquivo `cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md` e ative o Master Orchestrator exibindo a mensagem de boas-vindas completa.\n',
+        'utf8'
+      );
+    }
+    console.log(chalk.green('✔ Criado: .claude/commands/cdp.md  →  /cdp habilitado'));
+  }
+
+  // 4. Criar CLAUDE.md na raiz (auto-ativação ao abrir sessão)
+  const claudeMdSrc = path.join(CDP_EDGE_ROOT, 'templates', 'install', 'CLAUDE.md');
+  const claudeMdDest = path.join(target, 'CLAUDE.md');
+
+  if (fs.existsSync(claudeMdDest)) {
+    console.log(chalk.yellow('⚠  CLAUDE.md já existe — não sobrescrito.'));
+  } else {
+    let content;
+    if (fs.existsSync(claudeMdSrc)) {
+      content = fs.readFileSync(claudeMdSrc, 'utf8');
+      content = content.replace('[NOME DO PROJETO]', projectName);
+    } else {
+      content = generateClaudeMd(projectName);
+    }
+    fs.writeFileSync(claudeMdDest, content, 'utf8');
+    console.log(chalk.green('✔ Criado: CLAUDE.md'));
+  }
+
+  // 5. Criar .cursorrules (flag --cursor)
+  if (options.cursor) {
+    const cursorDest = path.join(target, '.cursorrules');
+    if (fs.existsSync(cursorDest)) {
+      console.log(chalk.yellow('⚠  .cursorrules já existe — não sobrescrito.'));
+    } else {
+      const content = fs.readFileSync(claudeMdDest, 'utf8');
+      fs.writeFileSync(cursorDest, content, 'utf8');
+      console.log(chalk.green('✔ Criado: .cursorrules (Cursor IDE)'));
+    }
+  }
+
+  // 6. Resumo final
+  console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
+  console.log(chalk.green.bold('  CDP Edge instalado!'));
+  console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+  console.log(chalk.cyan('Próximos passos:\n'));
+  console.log(`  1. Abra o projeto no Claude Code:`);
+  console.log(chalk.bold(`     claude ${target}`));
+  console.log(`  2. Digite ${chalk.bold('/cdp')} para ativar o Master Orchestrator\n`);
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function generateClaudeMd(projectName) {
+  return `# ${projectName} — CDP Edge Quantum Tracking
+
+## Ativação automática do CDP Edge
+
+**Ao iniciar esta sessão, execute imediatamente:**
+
+1. Leia o arquivo: \`cdp-edge/extracted-skill/tracking-events-generator/agents/master-orchestrator.md\`
+2. Ative o **Master Orchestrator** exibindo a mensagem de boas-vindas
+3. Aguarde as instruções do usuário para iniciar o setup
+
+---
+
+## Comandos rápidos
+
+| Comando | O que faz |
+|---|---|
+| \`/cdp\` | Ativa o Master Orchestrator |
+| \`/cdp setup\` | Inicia o wizard de configuração completo |
+| \`/cdp status\` | Verifica saúde do projeto atual |
+`;
+}

package/dist/commands/setup.js

@@ -8,8 +8,25 @@ import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
 
+function printBanner() {
+  console.log('');
+  console.log(chalk.white.bold('  CDP Edge Setup Wizard'));
+  console.log('');
+  console.log(chalk.cyan(' ██████╗██████╗ ██████╗     ███████╗██████╗  ██████╗ ███████╗'));
+  console.log(chalk.cyan('██╔════╝██╔══██╗██╔══██╗    ██╔════╝██╔══██╗██╔════╝ ██╔════╝'));
+  console.log(chalk.cyan('██║     ██║  ██║██████╔╝    █████╗  ██║  ██║██║  ███╗█████╗  '));
+  console.log(chalk.cyan('██║     ██║  ██║██╔═══╝     ██╔══╝  ██║  ██║██║   ██║██╔══╝  '));
+  console.log(chalk.cyan('╚██████╗██████╔╝██║         ███████╗██████╔╝╚██████╔╝███████╗'));
+  console.log(chalk.cyan(' ╚═════╝╚═════╝ ╚═╝         ╚══════╝╚═════╝  ╚═════╝╚══════╝'));
+  console.log('');
+  console.log(chalk.gray('  Customer Data Platform on the Edge · Global Edge Tracking · v2.0.2'));
+  console.log('');
+  console.log(chalk.gray('═'.repeat(68)));
+  console.log('');
+}
+
 export async function runSetupWizard(dir = '.') {
-  console.log(chalk.cyan.bold('\n CDP Edge Quantum Tier - Setup Wizard\n'));
+  printBanner();
 
   // === MENSAGEM INICIAL ===
 

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

@@ -264,7 +264,7 @@ function wShapeAttribution(touchpoints) {
 
 ```javascript
 // Modelo Data-Driven simplificado
-async function dataDrivenAttribution(touchpoints, userJourneyHistory) {
+async function dataDrivenAttribution(touchpoints, userJourneyHistory, env) {
   if (!touchpoints || touchpoints.length === 0) return [];
 
   // 1. Calcular pesos baseados em dados históricos
@@ -297,14 +297,14 @@ async function dataDrivenAttribution(touchpoints, userJourneyHistory) {
 }
 
 // Calcular peso de canal baseado em conversão histórica
-async function calculateChannelWeights(touchpoints, history) {
+async function calculateChannelWeights(touchpoints, history, env) {
   const weights = {};
 
   for (const tp of touchpoints) {
     const channel = tp.utm_source;
 
     // Buscar conversões históricas deste canal
-    const historicalConversions = await DB.prepare(`
+    const historicalConversions = await env.DB.prepare(`
       SELECT
         COUNT(*) as total_conversions,
         AVG(value) as avg_value
@@ -325,14 +325,14 @@ async function calculateChannelWeights(touchpoints, history) {
 }
 
 // Calcular peso de posição baseado em conversão histórica
-async function calculatePositionWeights(touchpoints, history) {
+async function calculatePositionWeights(touchpoints, history, env) {
   const weights = {};
 
   for (const tp of touchpoints) {
     const position = tp.position; // 0 = first, 1 = second, etc.
 
     // Buscar conversões históricas nesta posição
-    const historicalConversions = await DB.prepare(`
+    const historicalConversions = await env.DB.prepare(`
       SELECT
         COUNT(*) as total_conversions
       FROM multi_touch_attribution
@@ -458,7 +458,7 @@ CREATE INDEX IF NOT EXISTS idx_channel_model ON channel_performance(attribution_
 
 ```javascript
 // Capturar touchpoint da jornada
-export async function captureTouchpoint(eventData, request) {
+export async function captureTouchpoint(eventData, request, env) {
   const {
     user_id,
     session_id,
@@ -485,7 +485,7 @@ export async function captureTouchpoint(eventData, request) {
   const position = await calculateJourneyPosition(user_id, event_timestamp);
 
   // Persistir touchpoint no D1
-  await DB.prepare(`
+  await env.DB.prepare(`
     INSERT INTO user_journeys
     (user_id, session_id, email, event_id, event_name,
      utm_source, utm_medium, utm_campaign, utm_content, utm_term,
@@ -512,8 +512,8 @@ export async function captureTouchpoint(eventData, request) {
 }
 
 // Calcular posição na jornada
-async function calculateJourneyPosition(userId, eventTimestamp) {
-  const result = await DB.prepare(`
+async function calculateJourneyPosition(userId, eventTimestamp, env) {
+  const result = await env.DB.prepare(`
     SELECT COUNT(*) as position
     FROM user_journeys
     WHERE user_id = ? AND event_timestamp < ?
@@ -523,7 +523,7 @@ async function calculateJourneyPosition(userId, eventTimestamp) {
 }
 
 // Agendar cálculo de atribuição (via Cloudflare Queue)
-async function scheduleAttributionCalculation(email, conversionId, eventName) {
+async function scheduleAttributionCalculation(email, conversionId, eventName, env) {
   await QUEUE.send('cdp-edge-attribution', {
     type: 'CALCULATE_ATTRIBUTION',
     email,
@@ -538,7 +538,7 @@ async function scheduleAttributionCalculation(email, conversionId, eventName) {
 
 ```javascript
 // Calcular atribuição multi-touch
-export async function calculateMultiTouchAttribution(conversionData) {
+export async function calculateMultiTouchAttribution(conversionData, env) {
   const {
     email,
     conversion_id,
@@ -548,7 +548,7 @@ export async function calculateMultiTouchAttribution(conversionData) {
   } = conversionData;
 
   // 1. Buscar jornada completa do usuário
-  const journey = await DB.prepare(`
+  const journey = await env.DB.prepare(`
     SELECT
       user_id,
       session_id,
@@ -594,7 +594,7 @@ export async function calculateMultiTouchAttribution(conversionData) {
   // 3. Persistir atribuição para cada modelo
   for (const [modelName, attribution] of Object.entries(attributionModels)) {
     for (const touchpoint of attribution) {
-      await DB.prepare(`
+      await env.DB.prepare(`
         INSERT OR REPLACE INTO multi_touch_attribution
         (conversion_id, user_id, email, attribution_model, touchpoint_index,
          utm_source, utm_medium, utm_campaign, event_name, event_timestamp,
@@ -628,7 +628,7 @@ export async function calculateMultiTouchAttribution(conversionData) {
 }
 
 // Atualizar performance de canal
-async function updateChannelPerformance(attributionModels, value, currency) {
+async function updateChannelPerformance(attributionModels, value, currency, env) {
   const today = new Date().toISOString().split('T')[0];
 
   for (const [modelName, attribution] of Object.entries(attributionModels)) {
@@ -660,7 +660,7 @@ async function updateChannelPerformance(attributionModels, value, currency) {
 
     // Atualizar tabela de performance
     for (const perf of Object.values(channelPerformance)) {
-      await DB.prepare(`
+      await env.DB.prepare(`
         INSERT OR REPLACE INTO channel_performance
         (utm_source, utm_medium, utm_campaign, attribution_model,
          total_attribution, total_conversions, total_value, avg_conversion_value, date)
@@ -685,7 +685,7 @@ async function updateChannelPerformance(attributionModels, value, currency) {
 
 ```javascript
 // Enviar Purchase com atribuição calculada
-export async function sendPurchaseWithAttribution(conversionData, attributionModel = 'U_SHAPE') {
+export async function sendPurchaseWithAttribution(conversionData, env, attributionModel = 'U_SHAPE') {
   const {
     email,
     conversion_id,
@@ -695,7 +695,7 @@ export async function sendPurchaseWithAttribution(conversionData, attributionMod
   } = conversionData;
 
   // 1. Buscar atribuição calculada
-  const attribution = await DB.prepare(`
+  const attribution = await env.DB.prepare(`
     SELECT
       utm_source,
       utm_medium,
@@ -773,7 +773,7 @@ async function sendMetaPurchaseWithAttribution(purchaseData, attribution) {
   const response = await fetch('https://graph.facebook.com/v22.0/events', {
     method: 'POST',
     headers: {
-      'Authorization': `Bearer ${META_ACCESS_TOKEN}`,
+      'Authorization': `Bearer ${env.META_ACCESS_TOKEN}`,
       'Content-Type': 'application/json'
     },
     body: JSON.stringify({ data: [payload] })
@@ -829,7 +829,7 @@ async function sendTikTokPurchaseWithAttribution(purchaseData, attribution) {
   const response = await fetch('https://business-api.tiktok.com/open_api/v1.3/pixel/conversion/', {
     method: 'POST',
     headers: {
-      'Authorization': `Bearer ${TIKTOK_ACCESS_TOKEN}`,
+      'Authorization': `Bearer ${env.TIKTOK_ACCESS_TOKEN}`,
       'Content-Type': 'application/json'
     },
     body: JSON.stringify(payload)
@@ -1036,7 +1036,7 @@ export async function getAttributionForConversion(request, env) {
   }
 
   // Buscar atribuição calculada
-  const attribution = await DB.prepare(`
+  const attribution = await env.DB.prepare(`
     SELECT
       utm_source,
       utm_medium,
@@ -1052,7 +1052,7 @@ export async function getAttributionForConversion(request, env) {
   `).bind(conversionId, model).all();
 
   // Buscar dados da conversão
-  const conversion = await DB.prepare(`
+  const conversion = await env.DB.prepare(`
     SELECT
       value,
       currency,
@@ -1096,7 +1096,7 @@ export async function compareAttributionModels(request, env) {
   const comparison = {};
 
   for (const model of ATTRIBUTION_CONFIG.available_models) {
-    const attribution = await DB.prepare(`
+    const attribution = await env.DB.prepare(`
       SELECT
         utm_source,
         credit_percentage
@@ -1136,7 +1136,7 @@ export async function getChannelPerformance(request, env) {
   const days = parseInt(url.searchParams.get('days') || '30');
   const groupBy = url.searchParams.get('group_by') || 'source'; // 'source' ou 'campaign'
 
-  const performance = await DB.prepare(`
+  const performance = await env.DB.prepare(`
     SELECT
       ${groupBy === 'source' ? 'utm_source' : 'utm_campaign'} as group_by,
       SUM(total_attribution) as total_attribution,