@vibecheckai/cli 3.1.6 → 3.2.0

package/bin/runners/runCtx.js

@@ -1,680 +0,0 @@
-/**
- * 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");
-const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// 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',
-  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(showBanner = true) {
-  if (showBanner && shouldShowBanner({})) {
-    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(),
-    fastifyEntry: null,
-    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;
-  }
-
-  return opts;
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// MAIN CTX FUNCTION
-// ═══════════════════════════════════════════════════════════════════════════════
-
-async function runCtx(args) {
-  const opts = typeof args === 'object' && !Array.isArray(args) 
-    ? args  // Legacy object format
-    : parseArgs(args || []);
-
-  if (opts.help) {
-    printHelp(shouldShowBanner(opts));
-    return 0;
-  }
-
-  const root = opts.repoRoot || opts.path || process.cwd();
-  const projectName = path.basename(root);
-  const entry = opts.fastifyEntry || detectFastifyEntry(root);
-  const startTime = Date.now();
-
-  // 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;
-  }
-
-  // Print banner conditionally
-  if (shouldShowBanner(opts)) {
-    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);
-
-  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, '-');
-    snapshotPath = path.join(snapshotsDir, `truthpack-${timestamp}.json`);
-    fs.writeFileSync(snapshotPath, JSON.stringify(truthpack, null, 2));
-    
-    stopSpinner('Snapshot saved', true);
-  }
-
-  // Print summary
-  printTruthpackSummary(truthpack, root);
-
-  // 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;
-  
-  printSuccessCard(relativeOutput, relativeSnapshot, entry, buildDuration);
-
-  // 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 };