vibecheck-ai 2.0.1 → 5.0.0

package/bin/runners/runWatch.js

@@ -0,0 +1,478 @@
+/**
+ * vibecheck watch - Continuous Dev Mode
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENTERPRISE EDITION - World-Class Terminal Experience
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Watches for file changes and re-runs ship automatically.
+ * Shows a persistent status line with current verdict.
+ * Perfect for development workflow.
+ */
+
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+const { parseGlobalFlags, shouldShowBanner, shouldSuppressOutput } = require("./lib/global-flags");
+const { EXIT } = require("./lib/exit-codes");
+const { shipCore } = require("./runShip");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// ADVANCED TERMINAL - ANSI CODES & UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  italic: '\x1b[3m',
+  underline: '\x1b[4m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  gray: '\x1b[90m',
+  clear: '\x1b[2J\x1b[H',
+  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(150, 100, 255),
+  gradient2: rgb(130, 80, 255),
+  gradient3: rgb(110, 60, 255),
+  shipGreen: rgb(0, 255, 150),
+  warnAmber: rgb(255, 200, 0),
+  blockRed: rgb(255, 80, 80),
+  accent: rgb(150, 100, 255),
+  muted: rgb(120, 120, 140),
+  watching: rgb(100, 200, 255),
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// PREMIUM BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const WATCH_BANNER = `
+${rgb(150, 100, 255)}  ██╗    ██╗ █████╗ ████████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(130, 80, 255)}  ██║    ██║██╔══██╗╚══██╔══╝██╔════╝██║  ██║${c.reset}
+${rgb(110, 60, 255)}  ██║ █╗ ██║███████║   ██║   ██║     ███████║${c.reset}
+${rgb(90, 40, 255)}  ██║███╗██║██╔══██║   ██║   ██║     ██╔══██║${c.reset}
+${rgb(70, 20, 255)}  ╚███╔███╔╝██║  ██║   ██║   ╚██████╗██║  ██║${c.reset}
+${rgb(50, 0, 255)}   ╚══╝╚══╝ ╚═╝  ╚═╝   ╚═╝    ╚═════╝╚═╝  ╚═╝${c.reset}
+`;
+
+const BANNER_FULL = `
+${rgb(150, 100, 255)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(140, 90, 255)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
+${rgb(130, 80, 255)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
+${rgb(110, 60, 255)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
+${rgb(90, 40, 255)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
+${rgb(70, 20, 255)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
+
+${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
+${c.dim}  │${c.reset}  ${rgb(150, 100, 255)}👁️${c.reset} ${c.bold}WATCH${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}Live Reload${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}Auto Analysis${c.reset} ${c.dim}•${c.reset} ${rgb(100, 100, 100)}Dev Mode${c.reset}       ${c.dim}│${c.reset}
+${c.dim}  └─────────────────────────────────────────────────────────────────────┘${c.reset}
+`;
+
+const BOX = {
+  topLeft: '╭', topRight: '╮', bottomLeft: '╰', bottomRight: '╯',
+  horizontal: '─', vertical: '│',
+  dTopLeft: '╔', dTopRight: '╗', dBottomLeft: '╚', dBottomRight: '╝',
+  dHorizontal: '═', dVertical: '║',
+};
+
+const ICONS = {
+  eye: '👁️',
+  check: '✓',
+  cross: '✗',
+  warning: '⚠',
+  arrow: '→',
+  bullet: '•',
+  ship: '🚀',
+  clock: '⏱',
+  file: '📄',
+  sparkle: '✨',
+  lightning: '⚡',
+  refresh: '🔄',
+  watching: '◉',
+};
+
+const IGNORE_PATTERNS = [
+  /node_modules/,
+  /\.next/,
+  /\.vibecheck/,
+  /dist/,
+  /build/,
+  /\.git/,
+  /\.DS_Store/,
+  /\.log$/,
+  /\.map$/,
+];
+
+function shouldIgnore(filePath) {
+  return IGNORE_PATTERNS.some(p => p.test(filePath));
+}
+
+function debounce(fn, ms) {
+  let timeout;
+  return (...args) => {
+    clearTimeout(timeout);
+    timeout = setTimeout(() => fn(...args), ms);
+  };
+}
+
+function formatTime() {
+  const d = new Date();
+  return `${String(d.getHours()).padStart(2, "0")}:${String(d.getMinutes()).padStart(2, "0")}:${String(d.getSeconds()).padStart(2, "0")}`;
+}
+
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+
+function progressBar(percent, width = 20) {
+  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 printDivider(char = '─', width = 62) {
+  console.log(`  ${c.dim}${char.repeat(width)}${c.reset}`);
+}
+
+function printStatus({ verdict, findings, duration, lastFile, runCount }) {
+  const verdictColor = verdict === "SHIP" ? colors.shipGreen : verdict === "WARN" ? colors.warnAmber : colors.blockRed;
+  const blocks = findings.filter(f => f.severity === "BLOCK").length;
+  const warns = findings.filter(f => f.severity === "WARN").length;
+  const total = blocks + warns;
+  const health = total === 0 ? 100 : Math.max(0, 100 - (blocks * 20) - (warns * 5));
+
+  console.log();
+  console.log(`  ${c.dim}${BOX.dTopLeft}${BOX.dHorizontal.repeat(62)}${BOX.dTopRight}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}  ${colors.watching}${ICONS.eye}${c.reset} ${c.bold}VIBECHECK WATCH${c.reset}                                          ${c.dim}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${BOX.dHorizontal.repeat(62)}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}                                                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  // Stats row
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}  ${c.dim}${ICONS.clock} Time:${c.reset} ${formatTime()}    ${c.dim}${ICONS.refresh} Runs:${c.reset} ${runCount}    ${c.dim}${ICONS.lightning} Duration:${c.reset} ${formatDuration(duration)}     ${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  // Changed file
+  const changedDisplay = lastFile ? lastFile.slice(0, 40) : '(initial scan)';
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}  ${c.dim}${ICONS.file} Changed:${c.reset} ${colors.accent}${changedDisplay}${c.reset}${' '.repeat(Math.max(0, 45 - changedDisplay.length))}${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}                                                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${BOX.dHorizontal.repeat(62)}${BOX.dVertical}${c.reset}`);
+  
+  // Verdict
+  const verdictIcon = verdict === "SHIP" ? ICONS.ship : verdict === "WARN" ? ICONS.warning : ICONS.cross;
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}                                                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}     ${c.bold}VERDICT:${c.reset}  ${verdictColor}${c.bold}${verdictIcon} ${verdict}${c.reset}                                      ${c.dim}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}                                                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  // Health bar
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}     ${c.dim}Health:${c.reset}  ${progressBar(health)} ${health}%                      ${c.dim}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}     ${c.dim}Findings:${c.reset} ${colors.blockRed}${blocks}${c.reset} ${c.dim}BLOCK${c.reset}  ${colors.warnAmber}${warns}${c.reset} ${c.dim}WARN${c.reset}                          ${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}                                                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  // Status message
+  const statusMsg = verdict === "SHIP" 
+    ? `${colors.shipGreen}${ICONS.check}${c.reset} Ready to ship` 
+    : `${colors.warnAmber}${ICONS.arrow}${c.reset} Run ${colors.accent}vibecheck fix${c.reset} to resolve`;
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}     ${statusMsg}                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  
+  console.log(`  ${c.dim}${BOX.dVertical}${c.reset}                                                              ${c.dim}${BOX.dVertical}${c.reset}`);
+  console.log(`  ${c.dim}${BOX.dBottomLeft}${BOX.dHorizontal.repeat(62)}${BOX.dBottomRight}${c.reset}`);
+  console.log();
+  console.log(`  ${c.dim}${ICONS.watching} Watching for changes... (Ctrl+C to stop)${c.reset}`);
+  console.log();
+}
+
+function printTopFindings(findings, max = 5) {
+  const top = findings
+    .filter(f => f.severity === "BLOCK" || f.severity === "WARN")
+    .slice(0, max);
+
+  if (!top.length) {
+    // Show success upsell for PRO
+    console.log(`  ${colors.shipGreen}✓${c.reset} ${c.bold}No issues detected!${c.reset}`);
+    console.log(`  ${c.dim}Want a verified badge? Try${c.reset} ${colors.cyan}vibecheck prove${c.reset} ${c.dim}(PRO)${c.reset}`);
+    console.log();
+    return;
+  }
+
+  console.log(`  ${c.bold}Top findings:${c.reset}`);
+  for (const f of top) {
+    const icon = f.severity === "BLOCK" ? `${colors.blockRed}●` : `${colors.warnAmber}●`;
+    const title = f.title?.length > 50 ? f.title.slice(0, 47) + '...' : f.title;
+    console.log(`    ${icon}${c.reset} ${title}`);
+  }
+  
+  // Show upsell based on findings
+  const blockers = findings.filter(f => f.severity === "BLOCK").length;
+  if (blockers > 0) {
+    console.log();
+    console.log(`  ${colors.cyan}→${c.reset} ${c.dim}Fix these with${c.reset} ${colors.cyan}vibecheck fix${c.reset} ${c.dim}(STARTER)${c.reset}`);
+  }
+  console.log();
+}
+
+async function runShipQuiet(root, fastifyEntry) {
+  const start = Date.now();
+  try {
+    const result = await shipCore({ repoRoot: root, fastifyEntry, noWrite: false });
+    return {
+      verdict: result.verdict,
+      findings: result.report?.findings || [],
+      duration: Date.now() - start,
+      error: null
+    };
+  } catch (err) {
+    return {
+      verdict: "ERROR",
+      findings: [],
+      duration: Date.now() - start,
+      error: err.message
+    };
+  }
+}
+
+function watchDirectory(dir, callback) {
+  const watchers = new Map();
+
+  function addWatcher(p) {
+    if (watchers.has(p)) return;
+    try {
+      const watcher = fs.watch(p, { recursive: false }, (event, filename) => {
+        if (!filename || shouldIgnore(filename)) return;
+        callback(path.join(p, filename), event);
+      });
+      watchers.set(p, watcher);
+    } catch {}
+  }
+
+  function scanDir(p) {
+    try {
+      addWatcher(p);
+      const entries = fs.readdirSync(p, { withFileTypes: true });
+      for (const entry of entries) {
+        if (shouldIgnore(entry.name)) continue;
+        const full = path.join(p, entry.name);
+        if (entry.isDirectory()) {
+          scanDir(full);
+        }
+      }
+    } catch {}
+  }
+
+  scanDir(dir);
+
+  return {
+    close: () => {
+      for (const w of watchers.values()) {
+        try { w.close(); } catch {}
+      }
+      watchers.clear();
+    }
+  };
+}
+
+function printHelp(opts = {}) {
+  if (shouldShowBanner(opts)) {
+    console.log(BANNER_FULL);
+  }
+  console.log(`
+  ${c.bold}Usage:${c.reset} vibecheck watch [options]
+
+  ${c.bold}Continuous Dev Mode${c.reset} — Live reload with automatic ship analysis.
+
+  ${c.bold}Options:${c.reset}
+    ${colors.accent}--fastify-entry <path>${c.reset}   Fastify entry file for route extraction
+    ${colors.accent}--debounce <ms>${c.reset}          Debounce delay in ms ${c.dim}(default: 500)${c.reset}
+    ${colors.accent}--no-clear${c.reset}               Don't clear screen between runs
+    ${colors.accent}--help, -h${c.reset}               Show this help
+
+  ${c.bold}What It Does:${c.reset}
+    ${colors.shipGreen}1.${c.reset} Runs initial ship analysis
+    ${colors.shipGreen}2.${c.reset} Watches for file changes in your project
+    ${colors.shipGreen}3.${c.reset} Re-runs analysis on each change
+    ${colors.shipGreen}4.${c.reset} Shows live verdict dashboard
+
+  ${c.bold}Watched Files:${c.reset}
+    ${colors.accent}.ts${c.reset} ${colors.accent}.tsx${c.reset} ${colors.accent}.js${c.reset} ${colors.accent}.jsx${c.reset} ${colors.accent}.json${c.reset} ${colors.accent}.env${c.reset} ${colors.accent}.md${c.reset} ${colors.accent}.yml${c.reset} ${colors.accent}.yaml${c.reset}
+
+  ${c.bold}Ignored:${c.reset}
+    ${c.dim}node_modules, .next, .vibecheck, dist, build, .git${c.reset}
+
+  ${c.bold}Examples:${c.reset}
+    ${c.dim}# Start watching${c.reset}
+    vibecheck watch
+
+    ${c.dim}# 1 second debounce${c.reset}
+    vibecheck watch --debounce 1000
+
+    ${c.dim}# Keep history (don't clear)${c.reset}
+    vibecheck watch --no-clear
+
+  ${c.dim}Press Ctrl+C to stop watching${c.reset}
+  `);
+}
+
+async function runWatch(argsOrOpts = {}) {
+  // Handle array args from CLI
+  let globalOpts = { noBanner: false, json: false, quiet: false, ci: false };
+  let rawArgs = [];
+  
+  if (Array.isArray(argsOrOpts)) {
+    rawArgs = argsOrOpts;
+    const { flags } = parseGlobalFlags(argsOrOpts);
+    globalOpts = { ...globalOpts, ...flags };
+    if (globalOpts.help) {
+      printHelp(globalOpts);
+      return EXIT.SUCCESS;
+    }
+    const getArg = (flags) => {
+      for (const f of flags) {
+        const idx = argsOrOpts.indexOf(f);
+        if (idx !== -1 && idx < argsOrOpts.length - 1) return argsOrOpts[idx + 1];
+      }
+      return undefined;
+    };
+    argsOrOpts = {
+      repoRoot: globalOpts.path || process.cwd(),
+      fastifyEntry: getArg(["--fastify-entry"]),
+      debounceMs: parseInt(getArg(["--debounce"]) || "500", 10),
+      clearScreen: !rawArgs.includes("--no-clear"),
+      ...globalOpts,
+    };
+  }
+
+  const {
+    repoRoot,
+    fastifyEntry,
+    debounceMs = 500,
+    clearScreen = true,
+    quiet,
+  } = argsOrOpts;
+
+  const root = repoRoot || process.cwd();
+  const suppress = shouldSuppressOutput(argsOrOpts);
+  
+  // Validate project path exists
+  if (!fs.existsSync(root)) {
+    console.error(`${c.red}✗${c.reset} Project path does not exist: ${root}`);
+    console.log(`  ${c.dim}Verify the path and try again.${c.reset}`);
+    return EXIT.NOT_FOUND;
+  }
+  
+  // Validate debounce is a valid number
+  if (isNaN(debounceMs) || debounceMs < 0) {
+    console.error(`${c.red}✗${c.reset} Invalid debounce value: ${debounceMs}`);
+    console.log(`  ${c.dim}Debounce must be a positive number in milliseconds.${c.reset}`);
+    return EXIT.USER_ERROR;
+  }
+  
+  let runCount = 0;
+  let lastFile = null;
+  let watcher = null;
+  let exitCode = EXIT.SUCCESS;
+
+  try {
+    if (!suppress) {
+      console.log(`${c.cyan}Starting vibecheck watch...${c.reset}\n`);
+    }
+
+    async function runAndDisplay() {
+      runCount++;
+      
+      if (clearScreen && !suppress) {
+        process.stdout.write(c.clear);
+      }
+
+      try {
+        const result = await runShipQuiet(root, fastifyEntry);
+
+        if (result.error) {
+          if (!suppress) {
+            console.log(`${c.red}Error: ${result.error}${c.reset}`);
+            console.log(`  ${c.dim}Will retry on next file change.${c.reset}`);
+          }
+          return;
+        }
+
+        if (!suppress) {
+          printStatus({
+            verdict: result.verdict,
+            findings: result.findings,
+            duration: result.duration,
+            lastFile,
+            runCount
+          });
+
+          printTopFindings(result.findings);
+        }
+      } catch (e) {
+        if (!suppress) {
+          console.log(`${c.red}Analysis error: ${e.message}${c.reset}`);
+        }
+      }
+    }
+
+    // Initial run
+    await runAndDisplay();
+
+    // Watch for changes
+    const debouncedRun = debounce(async (filePath) => {
+      lastFile = path.relative(root, filePath);
+      await runAndDisplay();
+    }, debounceMs);
+
+    watcher = watchDirectory(root, (filePath) => {
+      // Only watch source files
+      if (!/\.(ts|tsx|js|jsx|json|env|md|yml|yaml)$/.test(filePath)) return;
+      if (shouldIgnore(filePath)) return;
+      debouncedRun(filePath);
+    });
+
+    // Handle cleanup - store cleanup function for signal handlers
+    const cleanup = () => {
+      if (watcher) {
+        watcher.close();
+        watcher = null;
+      }
+    };
+
+    process.on("SIGINT", () => {
+      if (!suppress) {
+        console.log(`\n${c.dim}Watch stopped.${c.reset}`);
+      }
+      cleanup();
+      process.exit(EXIT.SUCCESS);
+    });
+
+    process.on("SIGTERM", () => {
+      cleanup();
+      process.exit(EXIT.SUCCESS);
+    });
+
+    // Keep process alive
+    await new Promise(() => {});
+  } catch (error) {
+    console.error(`${c.red}✗${c.reset} Watch failed: ${error.message}`);
+    if (watcher) watcher.close();
+    return EXIT.INTERNAL_ERROR;
+  }
+}
+
+module.exports = { runWatch };