cdp-edge 1.18.3 → 1.20.0

package/dist/commands/setup.js

@@ -1,138 +1,353 @@
-/**
- * Setup Wizard - Wrapper para invocar CDP Edge Skill
+/**
+ * CDP Edge Setup Wizard — Guiado e não-técnico
  *
- * O CLI é apenas um disparador. A skill (Master Orchestrator) faz tudo.
+ * Coleta os dados do projeto do cliente e gera:
+ *  • Comandos wrangler secret put prontos para copiar
+ *  • URLs de webhook com domínio preenchido
+ *  • Checklist de próximos passos para o agente
  */
 
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
+import { writeFileSync } from 'fs';
+import { join } from 'path';
 
 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(chalk.cyan('  ╔═══════════════════════════════════════╗'));
+  console.log(chalk.cyan('  ║') + chalk.white.bold('      CDP Edge — Setup Wizard          ') + chalk.cyan('║'));
+  console.log(chalk.cyan('  ║') + chalk.gray('   Configuração Guiada de Tracking     ') + chalk.cyan('║'));
+  console.log(chalk.cyan('  ╚═══════════════════════════════════════╝'));
   console.log('');
 }
 
+function sep(label = '') {
+  if (label) {
+    console.log('\n' + chalk.gray('── ') + chalk.cyan.bold(label) + chalk.gray(' ' + '─'.repeat(Math.max(0, 40 - label.length))));
+  } else {
+    console.log(chalk.gray('─'.repeat(50)));
+  }
+}
+
 export async function runSetupWizard(dir = '.') {
   printBanner();
 
-  // === MENSAGEM INICIAL ===
+  console.log(chalk.cyan('  Vou te fazer algumas perguntas simples.'));
+  console.log(chalk.cyan('  Não precisa saber programar — é só preencher os dados.\n'));
+  console.log(chalk.gray('  Ao final, vou gerar todos os comandos prontos para instalar.\n'));
 
-  console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-  console.log(chalk.green.bold('  ✅ CDP Edge INSTALADO COM SUCESSO!'));
-  console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
+  // ── PASSO 1: Dados do projeto ──────────────────────────────────────────────
+  sep('1. Dados do Projeto');
 
-  console.log(chalk.cyan('🎯 O Master Orchestrator controla todo o processo de criação.'));
-  console.log(chalk.cyan('   Ele vai:\n'));
-  console.log(chalk.cyan('   • Fazer as perguntas necessárias'));
-  console.log(chalk.cyan('   • Analisar suas páginas automaticamente'));
-  console.log(chalk.cyan('   • Chamar os agentes especialistas'));
-  console.log(chalk.cyan('   • Gerar todos os arquivos de tracking'));
-  console.log(chalk.cyan('   • Validar o código gerado\n'));
+  const projeto = await inquirer.prompt([
+    {
+      type:     'input',
+      name:     'domain',
+      message:  'Qual o domínio do site? (ex: meusite.com.br)',
+      validate: v => v.trim() ? true : 'Domínio é obrigatório',
+      filter:   v => v.trim().replace(/^https?:\/\//, '').replace(/\/$/, ''),
+    },
+    {
+      type:    'input',
+      name:    'projectName',
+      message: 'Nome do projeto (para identificação):',
+      default: answers => answers.domain.split('.')[0],
+    },
+    {
+      type:    'list',
+      name:    'productType',
+      message: 'Que tipo de produto você vende?',
+      choices: [
+        { name: 'Infoproduto / Curso Online',       value: 'infoproduto' },
+        { name: 'E-commerce físico',                value: 'ecommerce' },
+        { name: 'SaaS / Assinatura',                value: 'saas' },
+        { name: 'Serviço / Consultoria',            value: 'servico' },
+        { name: 'Lead Generation (captação)',       value: 'leadgen' },
+      ],
+    },
+  ]);
 
-  // === MENU DE OPÇÃO ===
+  // ── PASSO 2: Plataforma de vendas ──────────────────────────────────────────
+  sep('2. Plataforma de Vendas / Checkout');
 
-  const menu = await inquirer.prompt([
+  const { plataformas } = await inquirer.prompt([
     {
-      type: 'list',
-      name: 'action',
-      message: 'O que você deseja fazer?',
+      type:    'checkbox',
+      name:    'plataformas',
+      message: 'Quais plataformas de checkout você usa? (espaço para marcar)',
       choices: [
-        { name: '🚀 Iniciar Master Orchestrator (Configuração Completa)', value: 'start' },
-        { name: '📖 Ver documentação', value: 'docs' },
-        { name: '❌ Sair', value: 'exit' }
-      ]
-    }
+        { name: 'Hotmart',  value: 'hotmart',  checked: false },
+        { name: 'Kiwify',   value: 'kiwify',   checked: false },
+        { name: 'Ticto',    value: 'ticto',    checked: false },
+        { name: 'Eduzz',    value: 'eduzz',    checked: false },
+        { name: 'Stripe',   value: 'stripe',   checked: false },
+        { name: 'Nenhuma (apenas formulário de captação)', value: 'none', checked: false },
+      ],
+      validate: v => v.length > 0 ? true : 'Selecione pelo menos uma opção',
+    },
+  ]);
+
+  // ── PASSO 3: Plataformas de anúncios ───────────────────────────────────────
+  sep('3. Plataformas de Anúncios');
+
+  const { adsPlataformas } = await inquirer.prompt([
+    {
+      type:    'checkbox',
+      name:    'adsPlataformas',
+      message: 'Onde você faz anúncios? (espaço para marcar)',
+      choices: [
+        { name: 'Meta Ads (Facebook / Instagram)', value: 'meta',      checked: true },
+        { name: 'Google Ads / YouTube',            value: 'google',    checked: false },
+        { name: 'TikTok Ads',                      value: 'tiktok',    checked: false },
+        { name: 'Pinterest Ads',                   value: 'pinterest', checked: false },
+        { name: 'LinkedIn Ads',                    value: 'linkedin',  checked: false },
+      ],
+      validate: v => v.length > 0 ? true : 'Selecione pelo menos uma plataforma',
+    },
   ]);
 
-  if (menu.action === 'exit') {
-    console.log(chalk.yellow('\n👋 Até logo!\n'));
-    process.exit(0);
-  }
-
-  if (menu.action === 'docs') {
-    console.log(chalk.cyan('\n📚 Documentação:'));
-    console.log('   Acesse: ' + chalk.underline('docs/guia-cloudflare-iniciante.md'));
-    console.log('   Ou visite: ' + chalk.underline('github.com/ricardosoli777/CDP-Edge-Premium'));
-    return;
-  }
-
-  if (menu.action === 'start') {
-    const spinner = ora('Iniciando Master Orchestrator...').start();
-    await sleep(800);
-    spinner.succeed(chalk.green('Master Orchestrator iniciado!'));
-
-    console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-    console.log(chalk.cyan.bold('  ' + chalk.bold('🧠 MASTER ORCHESTRATOR ATIVO')));
-    console.log(chalk.cyan('  Controlando todo o fluxo de criação...'));
-    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
-
-    // === AQUI INVOCARIA A SKILL ===
-    //
-    // Em produção, aqui seria:
-    //
-    // import { spawnMasterOrchestrator } from '../skill-wrapper';
-    // await spawnMasterOrchestrator({ dir, platforms: [] });
-    //
-    // A skill faria:
-    // - Perguntar modo (guiado/livre)
-    // - Perguntar plataformas
-    // - Acessar projeto
-    // - Spawnar Page Analyzer Agent
-    // - Spawnar Browser Agent
-    // - Spawnar Meta Agent, Google Agent, TikTok Agent
-    // - Spawnar Server Agent
-    // - Gerar todos os arquivos
-    // - Validar
-
-    // === DEMONSTRAÇÃO DO QUE ACONTECE ===
-
-    console.log(chalk.yellow.bold('\n🔄 MODO DEMONSTRAÇÃO\n'));
-    console.log(chalk.gray('   Nesta versão, veja o fluxo que a skill executaria:\n'));
-
-    const demoFlow = [
-      '  [1] Perguntar: Como prefere configurar?',
-      '       → Guiado ou Livre',
-      '  [2] Perguntar: Quais plataformas de ads usa?',
-      '       → Meta, Google, TikTok, LinkedIn, Spotify...',
-      '  [3] Acessar: Seu projeto (GitHub ou local)',
-      '  [4] Page Analyzer: Analisar páginas',
-      '       → Detecta tipo de produto, nicho, formulários',
-      '  [5] Browser Agent: Gerar cdpTrack.js',
-      '       → Tracking SDK + micro-events',
-      '  [6] Meta Agent: Gerar Pixel + CAPI',
-      '  [7] Google Agent: Gerar GA4 + Google Ads',
-      '  [8] TikTok Agent: Gerar Pixel + Events API',
-      '  [9] Server Agent: Gerar Worker + D1',
-      '  [10] Validator: Auditar código gerado',
-      '  [11] Entregar: Arquivos no seu projeto',
-      '       → tracking.config.js, cdpTrack.js, worker.js, schema.sql'
-    ];
-
-    demoFlow.forEach(line => console.log(chalk.cyan(line)));
-
-    console.log(chalk.gray('\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
-    console.log(chalk.green.bold('  ✅ SETUP CONCLUÍDO!'));
-    console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n'));
-
-    console.log(chalk.cyan('📁 Arquivos gerados: ' + chalk.underline(dir || '.')));
-    console.log(chalk.gray('\nPróximos passos:'));
-    console.log('  1. Configure seus API tokens no Wrangler');
-    console.log('  2. Faça o deploy: ' + chalk.bold('wrangler deploy'));
-    console.log('  3. Configure o domínio no Cloudflare Dashboard');
+  // ── PASSO 4: Credenciais Meta ──────────────────────────────────────────────
+  const creds = {};
+
+  if (adsPlataformas.includes('meta')) {
+    sep('4a. Credenciais — Meta Ads');
+    console.log(chalk.gray('   Onde encontrar: Meta Events Manager → Configurações → Pixel\n'));
+
+    const meta = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'pixelId',
+        message:  'Meta Pixel ID:',
+        validate: v => v.trim() ? true : 'Pixel ID é obrigatório',
+        filter:   v => v.trim(),
+      },
+      {
+        type:     'password',
+        name:     'accessToken',
+        message:  'Meta Access Token (CAPI):',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'Access Token é obrigatório',
+      },
+      {
+        type:    'input',
+        name:    'testCode',
+        message: 'Meta Test Event Code (opcional, para homologação):',
+        default: '',
+        filter:  v => v.trim(),
+      },
+    ]);
+    creds.meta = meta;
+  }
+
+  if (adsPlataformas.includes('google')) {
+    sep('4b. Credenciais — Google Analytics 4');
+    console.log(chalk.gray('   Onde encontrar: GA4 → Admin → Data Streams → Measurement Protocol\n'));
+
+    const google = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'measurementId',
+        message:  'GA4 Measurement ID (G-XXXXXXXX):',
+        validate: v => /^G-[A-Z0-9]+$/i.test(v.trim()) ? true : 'Formato: G-XXXXXXXX',
+        filter:   v => v.trim().toUpperCase(),
+      },
+      {
+        type:     'password',
+        name:     'apiSecret',
+        message:  'GA4 API Secret:',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'API Secret é obrigatório',
+      },
+    ]);
+    creds.google = google;
+  }
+
+  if (adsPlataformas.includes('tiktok')) {
+    sep('4c. Credenciais — TikTok');
+    console.log(chalk.gray('   Onde encontrar: TikTok Events Manager → Pixel → Detalhes\n'));
+
+    const tiktok = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'pixelId',
+        message:  'TikTok Pixel ID:',
+        validate: v => v.trim() ? true : 'Pixel ID é obrigatório',
+        filter:   v => v.trim(),
+      },
+      {
+        type:     'password',
+        name:     'accessToken',
+        message:  'TikTok Access Token:',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'Access Token é obrigatório',
+      },
+    ]);
+    creds.tiktok = tiktok;
+  }
+
+  // ── PASSO 5: Alertas WhatsApp ──────────────────────────────────────────────
+  sep('5. Alertas WhatsApp (opcional)');
+  console.log(chalk.gray('   Receba alertas de erros e match quality direto no WhatsApp.\n'));
+
+  const { wantsWhatsapp } = await inquirer.prompt([
+    {
+      type:    'confirm',
+      name:    'wantsWhatsapp',
+      message: 'Deseja ativar alertas via WhatsApp?',
+      default: true,
+    },
+  ]);
+
+  let whatsapp = {};
+  if (wantsWhatsapp) {
+    console.log(chalk.gray('\n   Como configurar: acesse callmebot.com e adicione o bot no WhatsApp.'));
+    console.log(chalk.gray('   Envie "I allow callmebot to send me messages" para +34 644 35 78 48\n'));
+
+    whatsapp = await inquirer.prompt([
+      {
+        type:     'input',
+        name:     'phone',
+        message:  'Seu número com DDI (ex: +5511999999999):',
+        validate: v => /^\+\d{10,15}$/.test(v.trim()) ? true : 'Formato: +5511999999999',
+        filter:   v => v.trim(),
+      },
+      {
+        type:     'password',
+        name:     'apiKey',
+        message:  'CallMeBot API Key:',
+        mask:     '*',
+        validate: v => v.trim() ? true : 'API Key é obrigatória',
+      },
+    ]);
+  }
+
+  // ── GERAÇÃO DOS OUTPUTS ────────────────────────────────────────────────────
+  const spinner = ora('Gerando configurações...').start();
+  await sleep(600);
+  spinner.succeed('Configurações geradas!');
+
+  const domain = projeto.domain;
+
+  // Monta lista de secrets
+  const secrets = [];
+
+  if (creds.meta) {
+    secrets.push({ key: 'META_PIXEL_ID',      value: creds.meta.pixelId,      platform: 'Meta' });
+    secrets.push({ key: 'META_ACCESS_TOKEN',  value: creds.meta.accessToken,  platform: 'Meta' });
+    if (creds.meta.testCode) {
+      secrets.push({ key: 'META_TEST_CODE',   value: creds.meta.testCode,     platform: 'Meta (homologação)' });
+    }
+  }
+
+  if (creds.google) {
+    secrets.push({ key: 'GA4_MEASUREMENT_ID', value: creds.google.measurementId, platform: 'Google' });
+    secrets.push({ key: 'GA4_API_SECRET',     value: creds.google.apiSecret,     platform: 'Google' });
+  }
+
+  if (creds.tiktok) {
+    secrets.push({ key: 'TIKTOK_PIXEL_ID',      value: creds.tiktok.pixelId,     platform: 'TikTok' });
+    secrets.push({ key: 'TIKTOK_ACCESS_TOKEN',  value: creds.tiktok.accessToken, platform: 'TikTok' });
   }
+
+  if (whatsapp.phone) {
+    secrets.push({ key: 'CALLMEBOT_PHONE',   value: whatsapp.phone,  platform: 'WhatsApp' });
+    secrets.push({ key: 'CALLMEBOT_API_KEY', value: whatsapp.apiKey, platform: 'WhatsApp' });
+  }
+
+  secrets.push({ key: 'SITE_DOMAIN', value: domain, platform: 'Worker' });
+
+  // Webhooks
+  const webhookUrls = {};
+  const webhookSecrets = [];
+  if (plataformas.includes('hotmart')) {
+    webhookUrls.hotmart = `https://${domain}/webhook/hotmart`;
+    webhookSecrets.push({ key: 'WEBHOOK_SECRET_HOTMART', platform: 'Hotmart', note: 'Gere uma senha forte qualquer' });
+  }
+  if (plataformas.includes('kiwify')) {
+    webhookUrls.kiwify = `https://${domain}/webhook/kiwify`;
+    webhookSecrets.push({ key: 'WEBHOOK_SECRET_KIWIFY', platform: 'Kiwify', note: 'Gere uma senha forte qualquer' });
+  }
+  if (plataformas.includes('ticto')) {
+    webhookUrls.ticto = `https://${domain}/webhook/ticto`;
+    webhookSecrets.push({ key: 'WEBHOOK_SECRET_TICTO', platform: 'Ticto', note: 'Chave HMAC configurada no painel Ticto' });
+  }
+
+  // ── EXIBIR RESULTADO ───────────────────────────────────────────────────────
+  console.log('\n');
+  sep('CONFIGURAÇÃO PRONTA');
+
+  console.log(chalk.green.bold('\n  Projeto: ') + chalk.white(projeto.projectName));
+  console.log(chalk.green.bold('  Domínio: ') + chalk.white(domain));
+  console.log(chalk.green.bold('  Produto: ') + chalk.white(projeto.productType));
+  console.log(chalk.green.bold('  Ads:     ') + chalk.white(adsPlataformas.join(', ')));
+
+  // Comandos de secrets
+  sep('Comandos para configurar os secrets');
+  console.log(chalk.gray('  Execute dentro da pasta server-edge-tracker:\n'));
+
+  for (const s of secrets) {
+    const masked = s.value.length > 4 ? s.value.slice(0, 4) + '*'.repeat(Math.min(s.value.length - 4, 8)) : '****';
+    console.log(chalk.cyan(`  wrangler secret put ${s.key}`));
+    console.log(chalk.gray(`  # ${s.platform} — valor: ${masked}\n`));
+  }
+
+  if (webhookSecrets.length > 0) {
+    console.log(chalk.yellow('  # Secrets de webhook (gere senhas e configure abaixo + no painel da plataforma):'));
+    for (const ws of webhookSecrets) {
+      console.log(chalk.cyan(`  wrangler secret put ${ws.key}`));
+      console.log(chalk.gray(`  # ${ws.platform}: ${ws.note}\n`));
+    }
+  }
+
+  // URLs de webhook
+  if (Object.keys(webhookUrls).length > 0) {
+    sep('URLs de Webhook para configurar nas plataformas');
+    for (const [plat, url] of Object.entries(webhookUrls)) {
+      console.log(chalk.green.bold(`  ${plat.charAt(0).toUpperCase() + plat.slice(1)}:`));
+      console.log(chalk.white(`    ${url}\n`));
+    }
+  }
+
+  // Checklist
+  sep('Próximos passos');
+  const steps = [
+    'Executar todos os wrangler secret put acima',
+    'Executar as migrations D1 (schema.sql → migrate-v7.sql)',
+    'Executar: wrangler deploy',
+    ...(Object.keys(webhookUrls).length > 0 ? ['Configurar as URLs de webhook nas plataformas de venda'] : []),
+    'Configurar Worker Route no Cloudflare: ' + domain + '/*',
+    'Testar o endpoint: https://' + domain + '/health',
+    ...(adsPlataformas.includes('meta') && creds.meta?.testCode ? ['Testar eventos no Meta Events Manager com o Test Event Code'] : []),
+  ];
+
+  steps.forEach((step, i) => {
+    console.log(chalk.cyan(`  [${i + 1}] `) + chalk.white(step));
+  });
+
+  // Salvar config (sem tokens reais)
+  const configOutput = {
+    generatedAt:  new Date().toISOString(),
+    domain,
+    projectName:  projeto.projectName,
+    productType:  projeto.productType,
+    adsPlataformas,
+    checkoutPlataformas: plataformas,
+    webhookUrls,
+    secretKeys:   secrets.map(s => s.key),
+    whatsappAlertsEnabled: !!whatsapp.phone,
+  };
+
+  const outputPath = join(dir, 'cdp-edge-setup.json');
+  try {
+    writeFileSync(outputPath, JSON.stringify(configOutput, null, 2), 'utf8');
+    console.log(chalk.gray(`\n  Configuração salva em: ${outputPath} (sem tokens)\n`));
+  } catch {
+    // não crítico se não conseguir salvar
+  }
+
+  sep();
+  console.log(chalk.green.bold('\n  Setup concluído! Passe os comandos acima para o agente instalar.\n'));
 }
 
 function sleep(ms) {

package/extracted-skill/tracking-events-generator/agents/server-tracking.md

@@ -526,7 +526,7 @@ async function syncIdentity(DB, body) {
   const fp = body.fingerprint || null;
   if (!fp || !DB) return body;
 
-  const existing = await DB.prepare(
+  const existing = await env.DB.prepare(
     'SELECT * FROM identity_graph WHERE fingerprint = ?'
   ).bind(fp).first();
 
@@ -541,7 +541,7 @@ async function syncIdentity(DB, body) {
       visit_count: (existing.visit_count || 1) + 1
     };
   } else {
-    await DB.prepare(`
+    await env.DB.prepare(`
       INSERT OR IGNORE INTO identity_graph (fingerprint, fbp, fbc, ga_client_id, external_id, ttclid, first_utm)
       VALUES (?, ?, ?, ?, ?, ?, ?)
     `).bind(fp, body.fbp, body.fbc, body.ga_client_id, body.external_id, body.ttclid, JSON.stringify(body.utm || {})).run();
@@ -635,7 +635,7 @@ function buildCookieHeader(visitor, umbrellaDomain) {
 async function logBehavioralEvent(DB, body, visitor, engagementScore) {
   if (!DB) return;
 
-  await DB.prepare(`
+  await env.DB.prepare(`
     INSERT OR REPLACE INTO behavioral_events (
       event_id, user_id, session_id,
       engagement_score, time_level, scroll_score, click_score, video_score, hover_score, intention_level,
@@ -972,7 +972,7 @@ CREATE INDEX IF NOT EXISTS idx_retry_scheduled ON retry_queue(scheduled_at, stat
 async function logEventSuccess(DB, platform, eventId) {
   if (!DB) return;
 
-  await DB.prepare(`
+  await env.DB.prepare(`
     UPDATE events_log
     SET status = 'success',
         retry_count = 0,
@@ -988,7 +988,7 @@ async function logEventFailure(DB, platform, eventId, errorMessage, retryCount)
   const maxRetries = 3;
   const isFinalFailure = retryCount >= maxRetries;
 
-  await DB.prepare(`
+  await env.DB.prepare(`
     UPDATE events_log
     SET status = ?,
         retry_count = ?,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdp-edge",
-  "version": "1.18.3",
+  "version": "1.20.0",
   "description": "CDP Edge - Quantum Tracking - Sistema multi-agente para tracking digital Cloudflare Native (Workers + D1)",
   "main": "dist/index.js",
   "type": "module",
@@ -28,7 +28,12 @@
     "test:unit:hash": "node tests/unit/hashing.test.js",
     "test:unit:dedup": "node tests/unit/deduplication.test.js",
     "test:unit:payload": "node tests/unit/payload-validation.test.js",
-    "test:all": "npm run test:unit"
+    "test:all": "npm run test:unit",
+    "test:integration": "cd tests/integration && npx vitest run",
+    "agents:check": "node scripts/validate-agents.js",
+    "agents:sync": "node scripts/sync-agents.js",
+    "agents:sync:list": "node scripts/sync-agents.js --list",
+    "agents:sync:all": "node scripts/sync-agents.js --apply-all"
   },
   "keywords": [
     "pixel",