@vibecheckai/cli 3.0.8 → 3.0.10

package/bin/runners/runCtx.js

@@ -1,20 +1,577 @@
-// bin/runners/runCtx.js
+/**
+ * vibecheck ctx - Truth Pack Generator
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENTERPRISE EDITION - World-Class Terminal Experience
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Build a comprehensive truth pack of your codebase for AI agents.
+ * The truth pack is the ground truth that powers all vibecheck analysis.
+ */
+
 const path = require("path");
 const fs = require("fs");
 const { buildTruthpack, writeTruthpack, detectFastifyEntry } = require("./lib/truth");
 
+// ═══════════════════════════════════════════════════════════════════════════════
+// ADVANCED TERMINAL - ANSI CODES & UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+
 const c = {
   reset: '\x1b[0m',
   bold: '\x1b[1m',
   dim: '\x1b[2m',
+  italic: '\x1b[3m',
+  underline: '\x1b[4m',
+  blink: '\x1b[5m',
+  inverse: '\x1b[7m',
+  hidden: '\x1b[8m',
+  strike: '\x1b[9m',
+  // Colors
+  black: '\x1b[30m',
   red: '\x1b[31m',
   green: '\x1b[32m',
   yellow: '\x1b[33m',
   blue: '\x1b[34m',
-  cyan: '\x1b[36m',
   magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  // Bright colors
+  gray: '\x1b[90m',
+  brightRed: '\x1b[91m',
+  brightGreen: '\x1b[92m',
+  brightYellow: '\x1b[93m',
+  brightBlue: '\x1b[94m',
+  brightMagenta: '\x1b[95m',
+  brightCyan: '\x1b[96m',
+  brightWhite: '\x1b[97m',
+  // Background
+  bgBlack: '\x1b[40m',
+  bgRed: '\x1b[41m',
+  bgGreen: '\x1b[42m',
+  bgYellow: '\x1b[43m',
+  bgBlue: '\x1b[44m',
+  bgMagenta: '\x1b[45m',
+  bgCyan: '\x1b[46m',
+  bgWhite: '\x1b[47m',
+  // Cursor control
+  cursorUp: (n = 1) => `\x1b[${n}A`,
+  cursorDown: (n = 1) => `\x1b[${n}B`,
+  cursorRight: (n = 1) => `\x1b[${n}C`,
+  cursorLeft: (n = 1) => `\x1b[${n}D`,
+  clearLine: '\x1b[2K',
+  clearScreen: '\x1b[2J',
+  saveCursor: '\x1b[s',
+  restoreCursor: '\x1b[u',
+  hideCursor: '\x1b[?25l',
+  showCursor: '\x1b[?25h',
 };
 
+// True color support
+const rgb = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
+const bgRgb = (r, g, b) => `\x1b[48;2;${r};${g};${b}m`;
+
+// Premium color palette (blue/teal theme for "truth/context")
+const colors = {
+  // Gradient for banner
+  gradient1: rgb(0, 200, 255),    // Bright cyan
+  gradient2: rgb(0, 180, 240),    // Cyan
+  gradient3: rgb(0, 160, 220),    // Cyan-blue
+  gradient4: rgb(0, 140, 200),    // Blue-cyan
+  gradient5: rgb(0, 120, 180),    // Blue
+  gradient6: rgb(0, 100, 160),    // Deep blue
+  
+  // Category colors
+  routes: rgb(100, 200, 255),     // Light blue
+  env: rgb(200, 150, 255),        // Purple
+  auth: rgb(100, 180, 255),       // Blue
+  billing: rgb(255, 200, 100),    // Gold
+  enforcement: rgb(255, 150, 100), // Orange
+  
+  // Status colors
+  success: rgb(0, 255, 150),
+  warning: rgb(255, 200, 0),
+  error: rgb(255, 80, 80),
+  info: rgb(100, 200, 255),
+  
+  // UI colors
+  accent: rgb(0, 200, 255),
+  muted: rgb(120, 140, 160),
+  subtle: rgb(80, 100, 120),
+  highlight: rgb(255, 255, 255),
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// PREMIUM BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const CTX_BANNER = `
+${rgb(0, 220, 255)}   ██████╗████████╗██╗  ██╗${c.reset}
+${rgb(0, 200, 255)}  ██╔════╝╚══██╔══╝╚██╗██╔╝${c.reset}
+${rgb(0, 180, 240)}  ██║        ██║    ╚███╔╝ ${c.reset}
+${rgb(0, 160, 220)}  ██║        ██║    ██╔██╗ ${c.reset}
+${rgb(0, 140, 200)}  ╚██████╗   ██║   ██╔╝ ██╗${c.reset}
+${rgb(0, 120, 180)}   ╚═════╝   ╚═╝   ╚═╝  ╚═╝${c.reset}
+`;
+
+const BANNER_FULL = `
+${rgb(0, 220, 255)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(0, 200, 255)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
+${rgb(0, 180, 240)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
+${rgb(0, 160, 220)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
+${rgb(0, 140, 200)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
+${rgb(0, 120, 180)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
+
+${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
+${c.dim}  │${c.reset}  ${rgb(0, 200, 255)}📦${c.reset} ${c.bold}CTX${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}Truth Pack Generator${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}Ground Truth for AI${c.reset}       ${c.dim}│${c.reset}
+${c.dim}  └─────────────────────────────────────────────────────────────────────┘${c.reset}
+`;
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// ICONS & SYMBOLS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const ICONS = {
+  // Main
+  package: '📦',
+  truth: '🎯',
+  context: '📋',
+  
+  // Status
+  check: '✓',
+  cross: '✗',
+  warning: '⚠',
+  info: 'ℹ',
+  arrow: '→',
+  bullet: '•',
+  
+  // Categories
+  routes: '🛤️',
+  env: '🌍',
+  auth: '🔒',
+  billing: '💰',
+  enforcement: '🛡️',
+  
+  // Frameworks
+  nextjs: '▲',
+  fastify: '⚡',
+  express: '🚂',
+  
+  // Objects
+  file: '📄',
+  folder: '📁',
+  snapshot: '📸',
+  clock: '⏱',
+  lightning: '⚡',
+  sparkle: '✨',
+  link: '🔗',
+  gap: '🕳️',
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// BOX DRAWING
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const BOX = {
+  topLeft: '╭', topRight: '╮', bottomLeft: '╰', bottomRight: '╯',
+  horizontal: '─', vertical: '│',
+  teeRight: '├', teeLeft: '┤', teeDown: '┬', teeUp: '┴',
+  cross: '┼',
+  // Double line
+  dTopLeft: '╔', dTopRight: '╗', dBottomLeft: '╚', dBottomRight: '╝',
+  dHorizontal: '═', dVertical: '║',
+  // Rounded
+  rTopLeft: '╭', rTopRight: '╮', rBottomLeft: '╰', rBottomRight: '╯',
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// SPINNER & PROGRESS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const SPINNER_DOTS = ['⣾', '⣽', '⣻', '⢿', '⡿', '⣟', '⣯', '⣷'];
+const SPINNER_BLOCKS = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█', '▇', '▆', '▅', '▄', '▃', '▂'];
+
+let spinnerIndex = 0;
+let spinnerInterval = null;
+let spinnerStartTime = null;
+
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
+  const mins = Math.floor(ms / 60000);
+  const secs = Math.floor((ms % 60000) / 1000);
+  return `${mins}m ${secs}s`;
+}
+
+function formatNumber(num) {
+  return num.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+
+function truncate(str, len) {
+  if (!str) return '';
+  if (str.length <= len) return str;
+  return str.slice(0, len - 3) + '...';
+}
+
+function padCenter(str, width) {
+  const padding = Math.max(0, width - str.length);
+  const left = Math.floor(padding / 2);
+  const right = padding - left;
+  return ' '.repeat(left) + str + ' '.repeat(right);
+}
+
+function progressBar(percent, width = 30, opts = {}) {
+  const filled = Math.round((percent / 100) * width);
+  const empty = width - filled;
+  
+  let filledColor = opts.color || colors.accent;
+  if (!opts.color) {
+    if (percent >= 80) filledColor = colors.success;
+    else if (percent >= 50) filledColor = colors.warning;
+    else filledColor = colors.error;
+  }
+  
+  const filledChar = opts.filled || '█';
+  const emptyChar = opts.empty || '░';
+  
+  return `${filledColor}${filledChar.repeat(filled)}${c.dim}${emptyChar.repeat(empty)}${c.reset}`;
+}
+
+function startSpinner(message, color = colors.accent) {
+  spinnerStartTime = Date.now();
+  process.stdout.write(c.hideCursor);
+  
+  spinnerInterval = setInterval(() => {
+    const elapsed = formatDuration(Date.now() - spinnerStartTime);
+    process.stdout.write(`\r${c.clearLine}  ${color}${SPINNER_DOTS[spinnerIndex]}${c.reset} ${message} ${c.dim}${elapsed}${c.reset}`);
+    spinnerIndex = (spinnerIndex + 1) % SPINNER_DOTS.length;
+  }, 80);
+}
+
+function stopSpinner(message, success = true) {
+  if (spinnerInterval) {
+    clearInterval(spinnerInterval);
+    spinnerInterval = null;
+  }
+  const elapsed = spinnerStartTime ? formatDuration(Date.now() - spinnerStartTime) : '';
+  const icon = success ? `${colors.success}${ICONS.check}${c.reset}` : `${colors.error}${ICONS.cross}${c.reset}`;
+  process.stdout.write(`\r${c.clearLine}  ${icon} ${message} ${c.dim}${elapsed}${c.reset}\n`);
+  process.stdout.write(c.showCursor);
+  spinnerStartTime = null;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// SECTION HEADERS
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printBanner() {
+  console.log(BANNER_FULL);
+}
+
+function printCompactBanner() {
+  console.log(CTX_BANNER);
+}
+
+function printDivider(char = '─', width = 69, color = c.dim) {
+  console.log(`${color}  ${char.repeat(width)}${c.reset}`);
+}
+
+function printSection(title, icon = '◆') {
+  console.log();
+  console.log(`  ${colors.accent}${icon}${c.reset} ${c.bold}${title}${c.reset}`);
+  printDivider();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// CATEGORY BOXES - Premium Truth Pack Display
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printCategoryBox(title, icon, color, items) {
+  const w = 68;
+  
+  console.log(`  ${color}${BOX.topLeft}${BOX.horizontal} ${icon} ${title} ${BOX.horizontal.repeat(w - title.length - 6)}${BOX.topRight}${c.reset}`);
+  
+  for (const item of items) {
+    let line = `  ${color}${BOX.vertical}${c.reset}  `;
+    
+    if (item.label && item.value !== undefined) {
+      const valueStr = typeof item.value === 'number' ? formatNumber(item.value) : item.value;
+      const labelPad = 18;
+      line += `${c.bold}${item.label.padEnd(labelPad)}${c.reset} ${valueStr}`;
+      
+      if (item.extra) {
+        line += `  ${c.dim}${item.extra}${c.reset}`;
+      }
+      if (item.status) {
+        const statusColor = item.status === 'success' ? colors.success : 
+                           item.status === 'warning' ? colors.warning : 
+                           item.status === 'error' ? colors.error : colors.muted;
+        const statusIcon = item.status === 'success' ? ICONS.check : 
+                          item.status === 'warning' ? ICONS.warning : 
+                          item.status === 'error' ? ICONS.cross : ICONS.bullet;
+        line += `  ${statusColor}${statusIcon}${c.reset}`;
+        if (item.statusText) {
+          line += ` ${statusColor}${item.statusText}${c.reset}`;
+        }
+      }
+    } else if (item.text) {
+      line += item.text;
+    } else if (item.divider) {
+      line = `  ${color}${BOX.teeRight}${BOX.horizontal.repeat(w)}${BOX.teeLeft}${c.reset}`;
+    }
+    
+    console.log(line);
+  }
+  
+  console.log(`  ${color}${BOX.bottomLeft}${BOX.horizontal.repeat(w)}${BOX.bottomRight}${c.reset}`);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// TRUTH PACK SUMMARY DISPLAY
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printTruthpackSummary(truthpack, root) {
+  // Calculate stats
+  const nextRoutes = (truthpack.routes?.server || []).filter(r => 
+    r.handler?.includes("app/api") || r.handler?.includes("pages/api")
+  ).length;
+  const otherRoutes = (truthpack.routes?.server || []).filter(r => 
+    !r.handler?.includes("app/api") && !r.handler?.includes("pages/api")
+  ).length;
+  
+  const detectedFramework = truthpack.meta?.framework || 
+    (truthpack.routes?.server || []).find(r => r.evidence?.[0]?.reason)?.evidence?.[0]?.reason?.split(' ')[0] ||
+    'Express';
+  
+  const clientRefs = truthpack.routes?.clientRefs?.length || 0;
+  const gaps = truthpack.routes?.gaps?.length || 0;
+  const totalRoutes = (truthpack.routes?.server || []).length;
+
+  const envUsed = truthpack.env?.vars?.length || 0;
+  const envDeclared = truthpack.env?.declared?.length || 0;
+  const envSources = (truthpack.env?.declaredSources || []).join(", ") || "none";
+  const envCoverage = envUsed > 0 ? Math.round((envDeclared / envUsed) * 100) : 100;
+
+  const nextMiddleware = truthpack.auth?.nextMiddleware?.length || 0;
+  const fastifySignals = truthpack.auth?.fastify?.signalTypes?.length || 0;
+  const authPatterns = truthpack.auth?.patterns?.length || 0;
+
+  const hasStripe = truthpack.billing?.hasStripe;
+  const webhooks = truthpack.billing?.summary?.webhookHandlersFound || 0;
+  const stripeUsage = truthpack.billing?.stripeUsage?.length || 0;
+
+  const enforced = truthpack.enforcement?.enforcedCount || 0;
+  const checked = truthpack.enforcement?.checkedCount || 0;
+  const enforcementRate = checked > 0 ? Math.round((enforced / checked) * 100) : 100;
+
+  // Routes Box
+  console.log();
+  printCategoryBox('ROUTES', ICONS.routes, colors.routes, [
+    { 
+      label: `${ICONS.nextjs} Next.js:`, 
+      value: nextRoutes, 
+      extra: 'API routes' 
+    },
+    { 
+      label: `${ICONS.fastify} ${detectedFramework}:`, 
+      value: otherRoutes, 
+      extra: 'server routes' 
+    },
+    { divider: true },
+    { 
+      label: 'Client refs:', 
+      value: clientRefs,
+      status: gaps > 0 ? 'warning' : 'success',
+      statusText: gaps > 0 ? `${gaps} gaps` : 'no gaps'
+    },
+    { 
+      label: 'Total:', 
+      value: totalRoutes,
+      extra: 'routes mapped'
+    },
+  ]);
+
+  // Environment Box
+  printCategoryBox('ENVIRONMENT', ICONS.env, colors.env, [
+    { 
+      label: 'Used:', 
+      value: envUsed, 
+      extra: 'env vars' 
+    },
+    { 
+      label: 'Declared:', 
+      value: envDeclared, 
+      extra: `(${envSources})` 
+    },
+    { divider: true },
+    { 
+      label: 'Coverage:', 
+      value: `${envCoverage}%`,
+      status: envCoverage >= 100 ? 'success' : envCoverage >= 80 ? 'warning' : 'error',
+      statusText: envCoverage >= 100 ? 'complete' : 'missing declarations'
+    },
+  ]);
+
+  // Auth Box
+  printCategoryBox('AUTH', ICONS.auth, colors.auth, [
+    { 
+      label: 'Next middleware:', 
+      value: nextMiddleware,
+      extra: 'handlers'
+    },
+    { 
+      label: 'Fastify signals:', 
+      value: fastifySignals,
+      extra: 'types'
+    },
+    { 
+      label: 'Auth patterns:', 
+      value: authPatterns,
+      extra: 'detected'
+    },
+  ]);
+
+  // Billing Box
+  printCategoryBox('BILLING', ICONS.billing, colors.billing, [
+    { 
+      label: 'Stripe:', 
+      value: hasStripe ? 'detected' : 'not detected',
+      status: hasStripe ? 'success' : null,
+    },
+    { 
+      label: 'Webhooks:', 
+      value: webhooks,
+      extra: 'handlers'
+    },
+    { 
+      label: 'Stripe usage:', 
+      value: stripeUsage,
+      extra: 'call sites'
+    },
+  ]);
+
+  // Enforcement Box
+  printCategoryBox('ENFORCEMENT', ICONS.enforcement, colors.enforcement, [
+    { 
+      label: 'Paid routes:', 
+      value: `${enforced}/${checked}`,
+      extra: 'enforced'
+    },
+    { 
+      label: 'Coverage:', 
+      value: `${enforcementRate}%`,
+      status: enforcementRate >= 100 ? 'success' : enforcementRate >= 80 ? 'warning' : 'error',
+    },
+  ]);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// SUCCESS CARD
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printSuccessCard(outputPath, snapshotPath = null, fastifyEntry = null, duration = null) {
+  const w = 68;
+  
+  console.log();
+  console.log(`  ${colors.success}${BOX.dTopLeft}${BOX.dHorizontal.repeat(w)}${BOX.dTopRight}${c.reset}`);
+  console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${' '.repeat(w)}${colors.success}${BOX.dVertical}${c.reset}`);
+  
+  const headline = `${ICONS.sparkle}  TRUTH PACK GENERATED`;
+  const headlinePadded = padCenter(headline, w);
+  console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${colors.success}${c.bold}${headlinePadded}${c.reset}${colors.success}${BOX.dVertical}${c.reset}`);
+  
+  console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${' '.repeat(w)}${colors.success}${BOX.dVertical}${c.reset}`);
+  
+  // Output path
+  const outputLabel = `${ICONS.arrow} `;
+  const outputValue = truncate(outputPath, 55);
+  const outputLine = `     ${outputLabel}${outputValue}`;
+  const outputPadded = outputLine + ' '.repeat(Math.max(0, w - outputLine.length + 5));
+  console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${outputPadded}${colors.success}${BOX.dVertical}${c.reset}`);
+  
+  // Snapshot path (if any)
+  if (snapshotPath) {
+    const snapLabel = `${ICONS.snapshot} `;
+    const snapValue = truncate(snapshotPath, 55);
+    const snapLine = `     ${snapLabel}${snapValue}`;
+    const snapPadded = snapLine + ' '.repeat(Math.max(0, w - snapLine.length + 5));
+    console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${snapPadded}${colors.success}${BOX.dVertical}${c.reset}`);
+  }
+  
+  // Fastify entry (if detected)
+  if (fastifyEntry) {
+    const entryLabel = `${ICONS.fastify} Fastify: `;
+    const entryValue = truncate(fastifyEntry, 45);
+    const entryLine = `     ${entryLabel}${c.dim}${entryValue}${c.reset}`;
+    // Need to account for ANSI codes in padding
+    const visibleLength = `     ${ICONS.fastify} Fastify: ${entryValue}`.length;
+    const entryPadded = entryLine + ' '.repeat(Math.max(0, w - visibleLength));
+    console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${entryPadded}${colors.success}${BOX.dVertical}${c.reset}`);
+  }
+  
+  // Duration (if provided)
+  if (duration) {
+    const durLabel = `${ICONS.clock} `;
+    const durValue = formatDuration(duration);
+    const durLine = `     ${durLabel}${durValue}`;
+    const durPadded = durLine + ' '.repeat(Math.max(0, w - durLine.length + 5));
+    console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${c.dim}${durPadded}${c.reset}${colors.success}${BOX.dVertical}${c.reset}`);
+  }
+  
+  console.log(`  ${colors.success}${BOX.dVertical}${c.reset}${' '.repeat(w)}${colors.success}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${colors.success}${BOX.dBottomLeft}${BOX.dHorizontal.repeat(w)}${BOX.dBottomRight}${c.reset}`);
+  console.log();
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// HELP DISPLAY
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function printHelp() {
+  console.log(BANNER_FULL);
+  console.log(`
+  ${c.bold}Usage:${c.reset} vibecheck ctx [options]
+
+  ${c.bold}Truth Pack Generator${c.reset} — Build ground truth for AI agents.
+
+  ${c.bold}What It Generates:${c.reset}
+    ${colors.routes}${ICONS.routes} routes${c.reset}        Server routes + client refs + gaps
+    ${colors.env}${ICONS.env} env${c.reset}           Used vars + declared vars + sources
+    ${colors.auth}${ICONS.auth} auth${c.reset}          Middleware + patterns + signals
+    ${colors.billing}${ICONS.billing} billing${c.reset}       Stripe usage + webhooks + gates
+    ${colors.enforcement}${ICONS.enforcement} enforcement${c.reset}   Paid surface checks
+
+  ${c.bold}Options:${c.reset}
+    ${colors.accent}--json, -j${c.reset}            Output raw JSON
+    ${colors.accent}--snapshot, -s${c.reset}        Save timestamped snapshot
+    ${colors.accent}--fastify-entry${c.reset}       Fastify entry file ${c.dim}(e.g. src/server.ts)${c.reset}
+    ${colors.accent}--path, -p${c.reset}            Project path ${c.dim}(default: current directory)${c.reset}
+    ${colors.accent}--help, -h${c.reset}            Show this help
+
+  ${c.bold}Output:${c.reset}
+    ${c.dim}.vibecheck/truth/truthpack.json${c.reset}   Main truth pack
+    ${c.dim}.vibecheck/truth/truthpack.md${c.reset}     Human-readable summary
+
+  ${c.bold}Examples:${c.reset}
+    ${c.dim}# Generate truth pack${c.reset}
+    vibecheck ctx
+
+    ${c.dim}# Save timestamped snapshot${c.reset}
+    vibecheck ctx --snapshot
+
+    ${c.dim}# Export as JSON${c.reset}
+    vibecheck ctx --json > truthpack.json
+
+    ${c.dim}# Specify fastify entry${c.reset}
+    vibecheck ctx --fastify-entry src/server.ts
+  `);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// ARGS PARSER
+// ═══════════════════════════════════════════════════════════════════════════════
+
 function parseArgs(args) {
   const opts = {
     path: process.cwd(),
@@ -22,12 +579,14 @@ function parseArgs(args) {
     json: false,
     snapshot: false,
     help: false,
+    verbose: false,
   };
 
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === '--json' || arg === '-j') opts.json = true;
     else if (arg === '--snapshot' || arg === '-s') opts.snapshot = true;
+    else if (arg === '--verbose' || arg === '-v') opts.verbose = true;
     else if (arg === '--fastify-entry') opts.fastifyEntry = args[++i];
     else if (arg === '--path' || arg === '-p') opts.path = args[++i];
     else if (arg === '--help' || arg === '-h') opts.help = true;
@@ -36,41 +595,9 @@ function parseArgs(args) {
   return opts;
 }
 
-function printHelp() {
-  console.log(`
-${c.cyan}${c.bold}📦 vibecheck ctx${c.reset} — Truth Pack Generator
-
-${c.dim}Build a comprehensive truth pack of your codebase for AI agents.${c.reset}
-
-${c.bold}USAGE${c.reset}
-  vibecheck ctx                Generate truth pack
-  vibecheck ctx --snapshot     Save timestamped snapshot
-  vibecheck ctx --json         Output as JSON
-
-${c.bold}OPTIONS${c.reset}
-  --json, -j          Output raw JSON
-  --snapshot, -s      Save to snapshots/ with timestamp
-  --fastify-entry     Fastify entry file (e.g. src/server.ts)
-  --path, -p          Project path (default: current directory)
-  --help, -h          Show this help
-
-${c.bold}TRUTH PACK CONTENTS${c.reset}
-  • ${c.cyan}routes${c.reset}      Server routes + client refs + gaps
-  • ${c.cyan}env${c.reset}         Used vars + declared vars + sources
-  • ${c.cyan}auth${c.reset}        Middleware + patterns + signals
-  • ${c.cyan}billing${c.reset}     Stripe usage + webhooks + gates
-  • ${c.cyan}enforcement${c.reset} Paid surface checks
-
-${c.bold}OUTPUT${c.reset}
-  .vibecheck/truth/truthpack.json   Main truth pack
-  .vibecheck/truth/truthpack.md     Human-readable summary
-
-${c.bold}EXAMPLES${c.reset}
-  vibecheck ctx                          # Generate truth pack
-  vibecheck ctx --snapshot               # Save snapshot
-  vibecheck ctx --json > truthpack.json  # Export as JSON
-`);
-}
+// ═══════════════════════════════════════════════════════════════════════════════
+// MAIN CTX FUNCTION
+// ═══════════════════════════════════════════════════════════════════════════════
 
 async function runCtx(args) {
   const opts = typeof args === 'object' && !Array.isArray(args) 
@@ -83,110 +610,66 @@ async function runCtx(args) {
   }
 
   const root = opts.repoRoot || opts.path || process.cwd();
+  const projectName = path.basename(root);
   const entry = opts.fastifyEntry || detectFastifyEntry(root);
+  const startTime = Date.now();
 
-  // Print header
-  if (!opts.json && !opts.print) {
-    console.log('');
-    console.log(`${c.cyan}╔══════════════════════════════════════════════════════════════════════╗${c.reset}`);
-    console.log(`${c.cyan}║${c.reset}                                                                      ${c.cyan}║${c.reset}`);
-    console.log(`${c.cyan}║${c.reset}   ${c.bold}📦 TRUTH PACK GENERATOR${c.reset}                                          ${c.cyan}║${c.reset}`);
-    console.log(`${c.cyan}║${c.reset}   ${c.dim}Building ground truth for AI agents${c.reset}                              ${c.cyan}║${c.reset}`);
-    console.log(`${c.cyan}║${c.reset}                                                                      ${c.cyan}║${c.reset}`);
-    console.log(`${c.cyan}╚══════════════════════════════════════════════════════════════════════╝${c.reset}`);
-    console.log('');
+  // JSON mode - minimal output
+  if (opts.json || opts.print) {
+    const truthpack = await buildTruthpack({ repoRoot: root, fastifyEntry: entry });
+    writeTruthpack(root, truthpack);
+    console.log(JSON.stringify(truthpack, null, 2));
+    return 0;
   }
 
-  // Build truthpack with progress
-  if (!opts.json && !opts.print) {
-    process.stdout.write(`${c.dim}○${c.reset} Building truth pack...`);
+  // Print banner
+  printBanner();
+  
+  console.log(`  ${c.dim}Project:${c.reset}  ${c.bold}${projectName}${c.reset}`);
+  console.log(`  ${c.dim}Path:${c.reset}     ${root}`);
+  if (entry) {
+    console.log(`  ${c.dim}Fastify:${c.reset}  ${colors.accent}${entry}${c.reset}`);
   }
 
+  // Build truthpack with spinner
+  console.log();
+  startSpinner('Building truth pack...', colors.accent);
+
   const truthpack = await buildTruthpack({ repoRoot: root, fastifyEntry: entry });
   writeTruthpack(root, truthpack);
 
-  if (!opts.json && !opts.print) {
-    process.stdout.write(`\r${c.green}✓${c.reset} Truth pack built        \n`);
-  }
+  const buildDuration = Date.now() - startTime;
+  stopSpinner('Truth pack built', true);
 
   // Handle snapshot
+  let snapshotPath = null;
   if (opts.snapshot) {
+    startSpinner('Saving snapshot...', colors.accent);
+    
     const snapshotsDir = path.join(root, ".vibecheck", "truth", "snapshots");
     fs.mkdirSync(snapshotsDir, { recursive: true });
     const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
-    const snapshotPath = path.join(snapshotsDir, `truthpack-${timestamp}.json`);
+    snapshotPath = path.join(snapshotsDir, `truthpack-${timestamp}.json`);
     fs.writeFileSync(snapshotPath, JSON.stringify(truthpack, null, 2));
-    if (!opts.json) {
-      console.log(`${c.green}✓${c.reset} Snapshot saved: ${c.dim}${path.relative(root, snapshotPath)}${c.reset}`);
-    }
+    
+    stopSpinner('Snapshot saved', true);
   }
 
-  // JSON output
-  if (opts.json || opts.print) {
-    console.log(JSON.stringify(truthpack, null, 2));
-    return 0;
-  }
+  // Print summary
+  printTruthpackSummary(truthpack, root);
 
-  // Beautiful summary
-  const nextRoutes = (truthpack.routes?.server || []).filter(r => 
-    r.handler?.includes("app/api") || r.handler?.includes("pages/api")
-  ).length;
-  const otherRoutes = (truthpack.routes?.server || []).filter(r => 
-    !r.handler?.includes("app/api") && !r.handler?.includes("pages/api")
-  ).length;
+  // Success card
+  const outputPath = path.join(root, ".vibecheck", "truth", "truthpack.json");
+  const relativeOutput = path.relative(root, outputPath);
+  const relativeSnapshot = snapshotPath ? path.relative(root, snapshotPath) : null;
   
-  // Detect framework from routes evidence or truthpack meta
-  const detectedFramework = truthpack.meta?.framework || 
-    (truthpack.routes?.server || []).find(r => r.evidence?.[0]?.reason)?.evidence?.[0]?.reason?.split(' ')[0] ||
-    'Express';
-  const clientRefs = truthpack.routes?.clientRefs?.length || 0;
-  const gaps = truthpack.routes?.gaps?.length || 0;
-
-  const envUsed = truthpack.env?.vars?.length || 0;
-  const envDeclared = truthpack.env?.declared?.length || 0;
-  const envSources = (truthpack.env?.declaredSources || []).join(", ") || "none";
-
-  const nextMiddleware = truthpack.auth?.nextMiddleware?.length || 0;
-  const fastifySignals = truthpack.auth?.fastify?.signalTypes?.length || 0;
-
-  const hasStripe = truthpack.billing?.hasStripe;
-  const webhooks = truthpack.billing?.summary?.webhookHandlersFound || 0;
+  printSuccessCard(relativeOutput, relativeSnapshot, entry, buildDuration);
 
-  const enforced = truthpack.enforcement?.enforcedCount || 0;
-  const checked = truthpack.enforcement?.checkedCount || 0;
-
-  console.log('');
-  console.log(`${c.cyan}┌─ Routes ──────────────────────────────────────────────────────────────┐${c.reset}`);
-  console.log(`${c.cyan}│${c.reset}  ${c.bold}▲ Next.js:${c.reset}  ${nextRoutes} routes`);
-  console.log(`${c.cyan}│${c.reset}  ${c.bold}⚡ ${detectedFramework}:${c.reset} ${otherRoutes} routes`);
-  console.log(`${c.cyan}│${c.reset}  ${c.dim}Client refs:${c.reset} ${clientRefs}  ${gaps > 0 ? `${c.yellow}⚠ ${gaps} gaps${c.reset}` : `${c.green}✓ no gaps${c.reset}`}`);
-  console.log(`${c.cyan}└───────────────────────────────────────────────────────────────────────┘${c.reset}`);
-
-  console.log(`${c.magenta}┌─ Environment ─────────────────────────────────────────────────────────┐${c.reset}`);
-  console.log(`${c.magenta}│${c.reset}  ${c.bold}Used:${c.reset}     ${envUsed} env vars`);
-  console.log(`${c.magenta}│${c.reset}  ${c.bold}Declared:${c.reset} ${envDeclared} (${envSources})`);
-  console.log(`${c.magenta}└───────────────────────────────────────────────────────────────────────┘${c.reset}`);
-
-  console.log(`${c.blue}┌─ Auth ─────────────────────────────────────────────────────────────────┐${c.reset}`);
-  console.log(`${c.blue}│${c.reset}  ${c.bold}Next middleware:${c.reset} ${nextMiddleware}`);
-  console.log(`${c.blue}│${c.reset}  ${c.bold}Fastify signals:${c.reset} ${fastifySignals}`);
-  console.log(`${c.blue}└───────────────────────────────────────────────────────────────────────┘${c.reset}`);
-
-  console.log(`${c.yellow}┌─ Billing ──────────────────────────────────────────────────────────────┐${c.reset}`);
-  console.log(`${c.yellow}│${c.reset}  ${c.bold}Stripe:${c.reset}   ${hasStripe ? `${c.green}✓ detected${c.reset}` : `${c.dim}not detected${c.reset}`}`);
-  console.log(`${c.yellow}│${c.reset}  ${c.bold}Webhooks:${c.reset} ${webhooks} handlers`);
-  console.log(`${c.yellow}│${c.reset}  ${c.bold}Enforced:${c.reset} ${enforced}/${checked} paid routes`);
-  console.log(`${c.yellow}└───────────────────────────────────────────────────────────────────────┘${c.reset}`);
-
-  console.log('');
-  console.log(`${c.green}${c.bold}✓ Truth pack saved${c.reset}`);
-  console.log(`  ${c.dim}→${c.reset} ${path.join(root, ".vibecheck", "truth", "truthpack.json")}`);
-  if (entry) {
-    console.log(`  ${c.dim}Fastify entry:${c.reset} ${entry}`);
-  }
-  console.log('');
+  // Next steps hint
+  console.log(`  ${c.dim}Next:${c.reset} ${colors.accent}vibecheck ship${c.reset} ${c.dim}to check if you're ready to ship${c.reset}`);
+  console.log();
 
   return 0;
 }
 
-module.exports = { runCtx };
+module.exports = { runCtx };