@vibecheckai/cli 3.1.6 → 3.2.0

package/bin/runners/runGraph.js

@@ -1,454 +0,0 @@
-/**
- * vibecheck graph - Reality Proof Graph
- * 
- * ═══════════════════════════════════════════════════════════════════════════════
- * ENTERPRISE EDITION - World-Class Terminal Experience
- * ═══════════════════════════════════════════════════════════════════════════════
- * 
- * Builds and visualizes the complete causal chain:
- * UI action → client function → network call → server route → handler → DB/external
- * 
- * Identifies broken edges that indicate:
- * - Routes referenced but don't exist
- * - Routes that fail at runtime
- * - UI showing success but server returning errors
- */
-
-"use strict";
-
-const path = require("path");
-const fs = require("fs");
-const { buildTruthpack, loadTruthpack } = require("./lib/truth");
-const { 
-  extractStaticGraph, 
-  buildProofGraph, 
-  getFindingsFromGraph,
-  renderGraphHtml,
-  renderGraphMermaid,
-  generateFetchWrapper,
-  collectRequests,
-  buildRuntimeEdges,
-  mergeRuntimeResults
-} = require("./lib/graph");
-
-// Entitlements enforcement
-const entitlements = require("./lib/entitlements-v2");
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// ADVANCED TERMINAL - ANSI CODES & UTILITIES
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  italic: '\x1b[3m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  magenta: '\x1b[35m',
-  cyan: '\x1b[36m',
-  white: '\x1b[37m',
-  gray: '\x1b[90m',
-  clearLine: '\x1b[2K',
-  hideCursor: '\x1b[?25l',
-  showCursor: '\x1b[?25h',
-};
-
-const rgb = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
-const bgRgb = (r, g, b) => `\x1b[48;2;${r};${g};${b}m`;
-
-const colors = {
-  gradient1: rgb(255, 100, 150),
-  gradient2: rgb(255, 80, 170),
-  gradient3: rgb(255, 60, 190),
-  shipGreen: rgb(0, 255, 150),
-  warnAmber: rgb(255, 200, 0),
-  blockRed: rgb(255, 80, 80),
-  accent: rgb(255, 100, 150),
-  muted: rgb(120, 120, 140),
-  node: rgb(100, 200, 255),
-  edge: rgb(150, 255, 150),
-  broken: rgb(255, 100, 100),
-};
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// PREMIUM BANNER
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const GRAPH_BANNER = `
-${rgb(255, 100, 150)}   ██████╗ ██████╗  █████╗ ██████╗ ██╗  ██╗${c.reset}
-${rgb(255, 80, 170)}  ██╔════╝ ██╔══██╗██╔══██╗██╔══██╗██║  ██║${c.reset}
-${rgb(255, 60, 190)}  ██║  ███╗██████╔╝███████║██████╔╝███████║${c.reset}
-${rgb(255, 40, 210)}  ██║   ██║██╔══██╗██╔══██║██╔═══╝ ██╔══██║${c.reset}
-${rgb(255, 20, 230)}  ╚██████╔╝██║  ██║██║  ██║██║     ██║  ██║${c.reset}
-${rgb(255, 0, 255)}   ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝${c.reset}
-`;
-
-const BANNER_FULL = `
-${rgb(255, 100, 150)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
-${rgb(255, 90, 160)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
-${rgb(255, 80, 170)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
-${rgb(255, 60, 190)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
-${rgb(255, 40, 210)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
-${rgb(255, 20, 230)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
-
-${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
-${c.dim}  │${c.reset}  ${rgb(255, 100, 150)}📊${c.reset} ${c.bold}GRAPH${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}Proof Visualization${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}Causal Chain${c.reset} ${c.dim}•${c.reset} ${rgb(100, 100, 100)}Edge Analysis${c.reset} ${c.dim}│${c.reset}
-${c.dim}  └─────────────────────────────────────────────────────────────────────┘${c.reset}
-`;
-
-const ICONS = {
-  graph: '📊',
-  check: '✓',
-  cross: '✗',
-  warning: '⚠',
-  arrow: '→',
-  bullet: '•',
-  node: '◉',
-  edge: '─',
-  broken: '╳',
-  sparkle: '✨',
-  file: '📄',
-  folder: '📁',
-  view: '👁️',
-};
-
-const SPINNER_DOTS = ['⣾', '⣽', '⣻', '⢿', '⡿', '⣟', '⣯', '⣷'];
-let spinnerIndex = 0;
-let spinnerInterval = null;
-let spinnerStartTime = null;
-
-function formatDuration(ms) {
-  if (ms < 1000) return `${ms}ms`;
-  return `${(ms / 1000).toFixed(1)}s`;
-}
-
-function startSpinner(message) {
-  spinnerStartTime = Date.now();
-  process.stdout.write(c.hideCursor);
-  spinnerInterval = setInterval(() => {
-    const elapsed = formatDuration(Date.now() - spinnerStartTime);
-    process.stdout.write(`\r${c.clearLine}  ${colors.accent}${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.shipGreen}${ICONS.check}${c.reset}` : `${colors.blockRed}${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;
-}
-
-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();
-}
-
-function progressBar(percent, width = 25) {
-  const filled = Math.round((percent / 100) * width);
-  const empty = width - filled;
-  const color = percent >= 80 ? colors.shipGreen : percent >= 50 ? colors.warnAmber : colors.blockRed;
-  return `${color}${'█'.repeat(filled)}${c.dim}${'░'.repeat(empty)}${c.reset}`;
-}
-
-function ensureDir(p) {
-  fs.mkdirSync(p, { recursive: true });
-}
-
-async function runGraph(args) {
-  const opts = parseArgs(args);
-  const startTime = Date.now();
-
-  if (opts.help) {
-    printHelp();
-    return 0;
-  }
-
-  // TIER ENFORCEMENT: COMPLETE only
-  const access = await entitlements.enforce("graph", {
-    projectPath: opts.path || process.cwd(),
-    silent: false,
-  });
-  
-  if (!access.allowed) {
-    console.log(`\n${c.yellow}Tip:${c.reset} The graph command requires COMPLETE tier for advanced proof graph visualization.`);
-    return entitlements.EXIT_FEATURE_NOT_ALLOWED;
-  }
-
-  const root = path.resolve(opts.path || process.cwd());
-  const projectName = path.basename(root);
-  const outDir = path.join(root, ".vibecheck", "graph");
-  ensureDir(outDir);
-
-  // Print banner
-  console.log(BANNER_FULL);
-  console.log(`  ${c.dim}Project:${c.reset}  ${c.bold}${projectName}${c.reset}`);
-  console.log(`  ${c.dim}Path:${c.reset}     ${root}`);
-  console.log();
-
-  // Load or build truthpack
-  startSpinner('Loading truthpack...');
-  let truthpack = loadTruthpack(root);
-  if (!truthpack) {
-    stopSpinner('Truthpack not found, building...', true);
-    startSpinner('Building truthpack...');
-    truthpack = await buildTruthpack({ repoRoot: root, fastifyEntry: opts.fastifyEntry });
-  }
-  stopSpinner('Truthpack loaded', true);
-
-  // Extract static graph
-  startSpinner('Extracting static edges...');
-  const staticData = await extractStaticGraph(root, truthpack);
-  stopSpinner(`Extracted ${staticData.edges?.length || 0} edges`, true);
-
-  // Build proof graph
-  startSpinner('Building proof graph...');
-  let graph = buildProofGraph({
-    nodes: staticData.nodes,
-    edges: staticData.edges,
-    meta: { repoRoot: root }
-  });
-  stopSpinner(`Built graph with ${graph.nodes?.length || 0} nodes`, true);
-
-  // Runtime verification (optional)
-  if (opts.runtime && opts.url) {
-    startSpinner(`Collecting runtime edges from ${opts.url}...`);
-    
-    try {
-      const runtimeEdges = await collectRuntimeEdges(opts.url, graph, opts);
-      graph = mergeRuntimeResults(graph, runtimeEdges);
-      stopSpinner('Runtime edges collected', true);
-    } catch (e) {
-      stopSpinner('Runtime collection failed', false);
-      console.log(`    ${c.dim}${e.message}${c.reset}`);
-    }
-  }
-
-  // Get findings from broken edges
-  const findings = getFindingsFromGraph(graph);
-
-  // Write outputs
-  startSpinner('Writing outputs...');
-  fs.writeFileSync(path.join(outDir, "graph.json"), JSON.stringify(graph, null, 2), "utf8");
-  
-  if (!opts.jsonOnly) {
-    const html = renderGraphHtml(graph);
-    fs.writeFileSync(path.join(outDir, "graph.html"), html, "utf8");
-    
-    const mermaid = renderGraphMermaid(graph);
-    fs.writeFileSync(path.join(outDir, "graph.mmd"), mermaid, "utf8");
-  }
-
-  if (findings.length > 0) {
-    fs.writeFileSync(path.join(outDir, "broken-edges.json"), JSON.stringify(findings, null, 2), "utf8");
-  }
-  stopSpinner('Outputs written', true);
-
-  // Print summary
-  const duration = Date.now() - startTime;
-  const coverage = graph.coverage?.percent || 0;
-  
-  printSection('GRAPH SUMMARY', ICONS.graph);
-  console.log();
-  console.log(`  ${colors.node}${ICONS.node}${c.reset} ${c.bold}Nodes:${c.reset}        ${graph.nodes?.length || 0}`);
-  console.log(`  ${colors.edge}${ICONS.edge}${c.reset} ${c.bold}Valid edges:${c.reset}  ${colors.shipGreen}${graph.edges?.length || 0}${c.reset}`);
-  console.log(`  ${colors.broken}${ICONS.broken}${c.reset} ${c.bold}Broken edges:${c.reset} ${graph.brokenEdges?.length > 0 ? colors.blockRed : colors.shipGreen}${graph.brokenEdges?.length || 0}${c.reset}`);
-  console.log();
-  console.log(`  ${c.bold}Coverage:${c.reset}     ${progressBar(coverage)} ${coverage}%`);
-  console.log(`  ${c.bold}Duration:${c.reset}     ${formatDuration(duration)}`);
-
-  if (opts.broken || findings.length > 0) {
-    printSection('BROKEN EDGES', ICONS.broken);
-    console.log();
-    
-    if (findings.length === 0) {
-      console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} No broken edges found`);
-    } else {
-      for (const f of findings.slice(0, 10)) {
-        const icon = f.severity === "BLOCK" ? `${colors.blockRed}●` : `${colors.warnAmber}●`;
-        console.log(`  ${icon}${c.reset} ${f.title}`);
-      }
-      if (findings.length > 10) {
-        console.log(`  ${c.dim}... and ${findings.length - 10} more${c.reset}`);
-      }
-    }
-  }
-
-  printSection('OUTPUT', ICONS.folder);
-  console.log();
-  console.log(`  ${ICONS.file} ${colors.accent}graph.json${c.reset}         ${c.dim}Machine-readable graph${c.reset}`);
-  if (!opts.jsonOnly) {
-    console.log(`  ${ICONS.view} ${colors.accent}graph.html${c.reset}         ${c.dim}Interactive visualization${c.reset}`);
-    console.log(`  ${ICONS.file} ${colors.accent}graph.mmd${c.reset}          ${c.dim}Mermaid diagram${c.reset}`);
-  }
-  if (findings.length > 0) {
-    console.log(`  ${ICONS.warning} ${colors.accent}broken-edges.json${c.reset}  ${c.dim}Broken edges as findings${c.reset}`);
-  }
-
-  if (opts.view && !opts.jsonOnly) {
-    const htmlPath = path.join(outDir, "graph.html");
-    console.log();
-    console.log(`  ${c.dim}Opening visualization...${c.reset}`);
-    
-    const { exec } = require("child_process");
-    const cmd = process.platform === "win32" ? `start "" "${htmlPath}"` :
-                process.platform === "darwin" ? `open "${htmlPath}"` :
-                `xdg-open "${htmlPath}"`;
-    exec(cmd);
-  }
-
-  const blocks = findings.filter(f => f.severity === "BLOCK").length;
-  const warns = findings.filter(f => f.severity === "WARN").length;
-
-  // Verdict card
-  console.log();
-  const verdictColor = blocks ? colors.blockRed : warns ? colors.warnAmber : colors.shipGreen;
-  const verdictIcon = blocks ? '🛑' : warns ? '⚠️' : '✅';
-  const verdictText = blocks ? 'BLOCK' : warns ? 'WARN' : 'CLEAN';
-  console.log(`  ${verdictColor}${c.bold}${verdictIcon} ${verdictText}${c.reset}`);
-  console.log();
-
-  return blocks ? 2 : warns ? 1 : 0;
-}
-
-async function collectRuntimeEdges(url, staticGraph, opts) {
-  let chromium;
-  try {
-    chromium = require("playwright").chromium;
-  } catch {
-    throw new Error("Playwright not installed. Run: npm i -D playwright");
-  }
-
-  const browser = await chromium.launch({ headless: !opts.headed });
-  const context = await browser.newContext();
-  const page = await context.newPage();
-
-  // Inject fetch wrapper
-  await page.addInitScript(generateFetchWrapper());
-
-  // Navigate and interact
-  await page.goto(url, { waitUntil: "domcontentloaded" });
-  await page.waitForLoadState("networkidle", { timeout: 10000 }).catch(() => {});
-
-  // Click some interactive elements to trigger requests
-  const buttons = await page.locator("button, a[href^='/'], [role='button']").all();
-  for (const btn of buttons.slice(0, 10)) {
-    try {
-      await btn.click({ timeout: 1000 });
-      await page.waitForTimeout(500);
-    } catch {
-      // Ignore click failures
-    }
-  }
-
-  // Collect requests
-  const requests = await collectRequests(page);
-  
-  await browser.close();
-
-  // Build runtime edges
-  return buildRuntimeEdges(requests, staticGraph);
-}
-
-function parseArgs(args) {
-  const opts = {
-    path: process.cwd(),
-    url: null,
-    runtime: false,
-    view: false,
-    broken: false,
-    jsonOnly: false,
-    headed: false,
-    fastifyEntry: null,
-    help: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--build") continue; // Default behavior
-    else if (arg === "--runtime") opts.runtime = true;
-    else if (arg === "--url") opts.url = args[++i];
-    else if (arg === "--view") opts.view = true;
-    else if (arg === "--broken") opts.broken = true;
-    else if (arg === "--json") opts.jsonOnly = true;
-    else if (arg === "--headed") opts.headed = 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;
-}
-
-function printHelp() {
-  console.log(BANNER_FULL);
-  console.log(`
-  ${c.bold}Usage:${c.reset} vibecheck graph [options]
-
-  ${c.bold}Reality Proof Graph${c.reset} — Visualize the complete causal chain from UI to database.
-
-  ${c.bold}Modes:${c.reset}
-    ${colors.accent}vibecheck graph${c.reset}                              ${c.dim}Build static graph${c.reset}
-    ${colors.accent}vibecheck graph --runtime --url http://...${c.reset}   ${c.dim}Add runtime edges${c.reset}
-    ${colors.accent}vibecheck graph --view${c.reset}                       ${c.dim}Open visualization${c.reset}
-    ${colors.accent}vibecheck graph --broken${c.reset}                     ${c.dim}List broken edges${c.reset}
-
-  ${c.bold}Options:${c.reset}
-    ${colors.accent}--build${c.reset}              Build static graph ${c.dim}(default)${c.reset}
-    ${colors.accent}--runtime${c.reset}            Collect runtime edges via Playwright
-    ${colors.accent}--url <url>${c.reset}          Target URL for runtime collection
-    ${colors.accent}--view${c.reset}               Open interactive HTML visualization
-    ${colors.accent}--broken${c.reset}             Show only broken edges
-    ${colors.accent}--json${c.reset}               Output JSON only ${c.dim}(no HTML/Mermaid)${c.reset}
-    ${colors.accent}--headed${c.reset}             Run browser in headed mode
-    ${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}Graph Nodes:${c.reset}
-    ${colors.node}◉${c.reset} UI Action          ${c.dim}onClick, onSubmit, etc.${c.reset}
-    ${colors.node}◉${c.reset} Client Function    ${c.dim}Functions that make network calls${c.reset}
-    ${colors.node}◉${c.reset} Network Call       ${c.dim}fetch(), axios.*()${c.reset}
-    ${colors.node}◉${c.reset} Server Route       ${c.dim}Next API routes, Fastify routes${c.reset}
-    ${colors.node}◉${c.reset} Handler            ${c.dim}Route handler functions${c.reset}
-    ${colors.node}◉${c.reset} DB Call            ${c.dim}Prisma, raw SQL${c.reset}
-    ${colors.node}◉${c.reset} External Call      ${c.dim}Stripe, GitHub, etc.${c.reset}
-
-  ${c.bold}Broken Edge Types:${c.reset}
-    ${colors.blockRed}╳${c.reset} MissingRoute        ${c.dim}Route referenced but doesn't exist${c.reset}
-    ${colors.blockRed}╳${c.reset} RuntimeFailure      ${c.dim}Route returns 4xx/5xx at runtime${c.reset}
-    ${colors.blockRed}╳${c.reset} CausalContradiction ${c.dim}UI shows success but server returned error${c.reset}
-
-  ${c.bold}Output:${c.reset}
-    ${c.dim}.vibecheck/graph/${c.reset}
-      ${colors.accent}graph.json${c.reset}          ${c.dim}Machine-readable graph${c.reset}
-      ${colors.accent}graph.html${c.reset}          ${c.dim}Interactive D3 visualization${c.reset}
-      ${colors.accent}graph.mmd${c.reset}           ${c.dim}Mermaid diagram${c.reset}
-      ${colors.accent}broken-edges.json${c.reset}   ${c.dim}Broken edges as findings${c.reset}
-
-  ${c.bold}Examples:${c.reset}
-    ${c.dim}# Build + open visualization${c.reset}
-    vibecheck graph --view
-
-    ${c.dim}# Runtime verification with Playwright${c.reset}
-    vibecheck graph --runtime --url http://localhost:3000 --view
-
-    ${c.dim}# CI mode: just broken edges as JSON${c.reset}
-    vibecheck graph --broken --json
-  `);
-}
-
-module.exports = { runGraph };