@vibecheckai/cli 3.0.9 → 3.0.10

package/bin/runners/runInstall.js

@@ -1,4 +1,11 @@
-// bin/runners/runInstall.js
+/**
+ * vibecheck install - Zero-friction Onboarding
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENTERPRISE EDITION - World-Class Terminal Experience
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
 const fs = require("fs");
 const path = require("path");
 const { buildTruthpack, writeTruthpack } = require("./lib/truth");
@@ -6,34 +13,159 @@ const { detectPackageManager, detectNext, detectFastify, detectFastifyEntry } =
 const { readPkg, writePkg, upsertScripts } = require("./lib/pkgjson");
 const { writeEnvTemplateFromTruthpack } = require("./lib/env-template");
 
+// ═══════════════════════════════════════════════════════════════════════════════
+// 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 colors = {
+  gradient1: rgb(255, 200, 100),
+  gradient2: rgb(255, 180, 80),
+  gradient3: rgb(255, 160, 60),
+  shipGreen: rgb(0, 255, 150),
+  warnAmber: rgb(255, 200, 0),
+  blockRed: rgb(255, 80, 80),
+  accent: rgb(255, 200, 100),
+  muted: rgb(120, 120, 140),
+  next: rgb(100, 200, 255),
+  fastify: rgb(255, 150, 200),
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// PREMIUM BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const INSTALL_BANNER = `
+${rgb(255, 200, 100)}  ██╗███╗   ██╗███████╗████████╗ █████╗ ██╗     ██╗     ${c.reset}
+${rgb(255, 180, 80)}  ██║████╗  ██║██╔════╝╚══██╔══╝██╔══██╗██║     ██║     ${c.reset}
+${rgb(255, 160, 60)}  ██║██╔██╗ ██║███████╗   ██║   ███████║██║     ██║     ${c.reset}
+${rgb(255, 140, 40)}  ██║██║╚██╗██║╚════██║   ██║   ██╔══██║██║     ██║     ${c.reset}
+${rgb(255, 120, 20)}  ██║██║ ╚████║███████║   ██║   ██║  ██║███████╗███████╗${c.reset}
+${rgb(255, 100, 0)}  ╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚══════╝${c.reset}
+`;
+
+const BANNER_FULL = `
+${rgb(255, 200, 100)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(255, 190, 90)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
+${rgb(255, 180, 80)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
+${rgb(255, 160, 60)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
+${rgb(255, 140, 40)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
+${rgb(255, 120, 20)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
+
+${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
+${c.dim}  │${c.reset}  ${rgb(255, 200, 100)}📥${c.reset} ${c.bold}INSTALL${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}Zero-Friction${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}Auto-Detect${c.reset} ${c.dim}•${c.reset} ${rgb(100, 100, 100)}Onboarding${c.reset}   ${c.dim}│${c.reset}
+${c.dim}  └─────────────────────────────────────────────────────────────────────┘${c.reset}
+`;
+
+const ICONS = {
+  install: '📥',
+  package: '📦',
+  file: '📄',
+  check: '✓',
+  cross: '✗',
+  warning: '⚠',
+  arrow: '→',
+  bullet: '•',
+  sparkle: '✨',
+  folder: '📁',
+  next: '▲',
+  fastify: '⚡',
+  npm: '📦',
+  gear: '⚙️',
+};
+
+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 printHelp() {
+  console.log(BANNER_FULL);
   console.log(`
-vibecheck install - Zero-friction onboarding
-
-USAGE
-  vibecheck install [options]
-
-OPTIONS
-  --path, -p <dir>    Project path (default: current directory)
-  --help, -h          Show this help
-
-WHAT IT DOES
-  1. Detects package manager (npm, yarn, pnpm)
-  2. Detects frameworks (Next.js, Fastify)
-  3. Builds initial truthpack
-  4. Creates .vibecheck/config.json
-  5. Generates env template from truthpack
-  6. Adds vibecheck scripts to package.json
-
-CREATED FILES
-  .vibecheck/config.json     - Local configuration
-  .vibecheck/truthpack.json  - Ground truth for AI agents
-  .env.template              - Env vars from truthpack
-
-EXAMPLES
-  vibecheck install                    # Install in current directory
-  vibecheck install --path ./my-app    # Install in specific directory
-`);
+  ${c.bold}Usage:${c.reset} vibecheck install [options]
+
+  ${c.bold}Zero-Friction Onboarding${c.reset} — Auto-detect and configure your project.
+
+  ${c.bold}Options:${c.reset}
+    ${colors.accent}--path, -p <dir>${c.reset}    Project path ${c.dim}(default: current directory)${c.reset}
+    ${colors.accent}--help, -h${c.reset}          Show this help
+
+  ${c.bold}What It Does:${c.reset}
+    ${colors.shipGreen}1.${c.reset} Detects package manager ${c.dim}(npm, yarn, pnpm)${c.reset}
+    ${colors.shipGreen}2.${c.reset} Detects frameworks ${c.dim}(Next.js, Fastify)${c.reset}
+    ${colors.shipGreen}3.${c.reset} Builds initial truthpack
+    ${colors.shipGreen}4.${c.reset} Creates .vibecheck/config.json
+    ${colors.shipGreen}5.${c.reset} Generates env template from truthpack
+    ${colors.shipGreen}6.${c.reset} Adds vibecheck scripts to package.json
+
+  ${c.bold}Created Files:${c.reset}
+    ${ICONS.file} ${colors.accent}.vibecheck/config.json${c.reset}     ${c.dim}Local configuration${c.reset}
+    ${ICONS.file} ${colors.accent}.vibecheck/truthpack.json${c.reset}  ${c.dim}Ground truth for AI agents${c.reset}
+    ${ICONS.file} ${colors.accent}.env.template${c.reset}              ${c.dim}Env vars from truthpack${c.reset}
+
+  ${c.bold}Examples:${c.reset}
+    ${c.dim}# Install in current directory${c.reset}
+    vibecheck install
+
+    ${c.dim}# Install in specific directory${c.reset}
+    vibecheck install --path ./my-app
+  `);
 }
 
 function ensureDir(p) {
@@ -52,20 +184,32 @@ async function runInstall(argsOrContext = {}) {
   
   const { repoRoot } = argsOrContext;
   const root = repoRoot || process.cwd();
+  const projectName = path.basename(root);
+
+  // 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();
 
   const { path: pkgPath, json: pkg } = readPkg(root);
 
+  // Detect environment
+  startSpinner('Detecting environment...');
   const pm = detectPackageManager(root);
   const next = detectNext(root, pkg);
   const fastify = detectFastify(root, pkg);
-
   const fastifyEntry = fastify.enabled ? await detectFastifyEntry(root) : null;
+  stopSpinner('Environment detected', true);
 
-  // Build truthpack once (this powers env template + ctx baseline)
+  // Build truthpack
+  startSpinner('Building truthpack...');
   const truthpack = await buildTruthpack({ repoRoot: root, fastifyEntry: fastifyEntry || undefined });
   writeTruthpack(root, truthpack);
+  stopSpinner('Truthpack built', true);
 
-  // Write minimal local config
+  // Write config
+  startSpinner('Writing configuration...');
   const cfgDir = path.join(root, ".vibecheck");
   ensureDir(cfgDir);
 
@@ -80,37 +224,54 @@ async function runInstall(argsOrContext = {}) {
   };
 
   fs.writeFileSync(path.join(cfgDir, "config.json"), JSON.stringify(cfg, null, 2), "utf8");
+  stopSpinner('Configuration written', true);
 
-  // Generate/extend env template from reality
+  // Generate env template
+  startSpinner('Generating env template...');
   const envRes = writeEnvTemplateFromTruthpack(root, truthpack);
+  stopSpinner(envRes.wrote ? `Env template generated (+${envRes.added.length} vars)` : 'Env template up to date', true);
 
-  // Add scripts (vibecoder-friendly)
+  // Add scripts
+  startSpinner('Updating package.json scripts...');
   const scriptsToAdd = {
     "vibecheck:ctx": "vibecheck ctx",
     "vibecheck:ship": "vibecheck ship",
     "vibecheck:fix": "vibecheck fix --apply",
     "vibecheck:pr": "vibecheck pr"
   };
-
   const changedScripts = upsertScripts(pkg, scriptsToAdd);
   if (changedScripts.length) writePkg(pkgPath, pkg);
+  stopSpinner(changedScripts.length ? `Added ${changedScripts.length} scripts` : 'Scripts up to date', true);
 
-  // Output (one next command)
-  console.log(`\n✅ vibecheck install`);
-  console.log(`Detected package manager: ${pm}`);
-  console.log(`Detected Next: ${next.enabled ? "yes" : "no"}`);
-  console.log(`Detected Fastify: ${fastify.enabled ? "yes" : "no"}`);
-  if (fastifyEntry) console.log(`Fastify entry: ${fastifyEntry}`);
+  // Summary
+  printSection('DETECTED', ICONS.gear);
+  console.log();
+  console.log(`  ${ICONS.npm} ${c.bold}Package Manager:${c.reset} ${colors.accent}${pm}${c.reset}`);
+  console.log(`  ${colors.next}${ICONS.next}${c.reset} ${c.bold}Next.js:${c.reset}         ${next.enabled ? `${colors.shipGreen}yes${c.reset}` : `${c.dim}no${c.reset}`}`);
+  console.log(`  ${colors.fastify}${ICONS.fastify}${c.reset} ${c.bold}Fastify:${c.reset}         ${fastify.enabled ? `${colors.shipGreen}yes${c.reset}` : `${c.dim}no${c.reset}`}`);
+  if (fastifyEntry) {
+    console.log(`  ${c.dim}   Entry:${c.reset}          ${colors.accent}${fastifyEntry}${c.reset}`);
+  }
 
-  console.log(`\nWrote:`);
-  console.log(`- .vibecheck/config.json`);
-  console.log(`- .vibecheck/truthpack.json`);
-  if (envRes.wrote) console.log(`- ${envRes.outRel} (+${envRes.added.length} var(s))`);
-  if (changedScripts.length) console.log(`- package.json scripts: ${changedScripts.join(", ")}`);
+  printSection('CREATED FILES', ICONS.folder);
+  console.log();
+  console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}.vibecheck/config.json${c.reset}`);
+  console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}.vibecheck/truthpack.json${c.reset}`);
+  if (envRes.wrote) {
+    console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}${envRes.outRel}${c.reset} ${c.dim}(+${envRes.added.length} vars)${c.reset}`);
+  }
+  if (changedScripts.length) {
+    console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}package.json${c.reset} ${c.dim}(${changedScripts.join(', ')})${c.reset}`);
+  }
 
+  // Next steps
   const runner = pm === "pnpm" ? "pnpm" : pm === "yarn" ? "yarn" : "npm run";
-  console.log(`\nNext (do this):`);
-  console.log(`  ${runner} vibecheck:ship`);
+  printSection('NEXT STEP', ICONS.arrow);
+  console.log();
+  console.log(`  ${colors.accent}${runner} vibecheck:ship${c.reset}`);
+  console.log();
+  console.log(`  ${colors.shipGreen}${ICONS.sparkle}${c.reset} Installation complete!`);
+  console.log();
 }
 
 module.exports = { runInstall };

package/bin/runners/runPR.js

@@ -1,44 +1,135 @@
-// bin/runners/runPR.js
+/**
+ * vibecheck pr - Generate PR Comment from Ship Report
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENTERPRISE EDITION - World-Class Terminal Experience
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
 const fs = require("fs");
 const path = require("path");
 const { shipCore } = require("./runShip");
 
+// ═══════════════════════════════════════════════════════════════════════════════
+// ADVANCED TERMINAL - ANSI CODES & UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+
 const c = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  cyan: "\x1b[36m",
+  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',
+  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(100, 150, 255),
+  gradient2: rgb(80, 130, 255),
+  gradient3: rgb(60, 110, 255),
+  shipGreen: rgb(0, 255, 150),
+  warnAmber: rgb(255, 200, 0),
+  blockRed: rgb(255, 80, 80),
+  accent: rgb(100, 150, 255),
+  muted: rgb(120, 120, 140),
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// PREMIUM BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const PR_BANNER = `
+${rgb(100, 150, 255)}  ██████╗ ██████╗ ${c.reset}
+${rgb(80, 130, 255)}  ██╔══██╗██╔══██╗${c.reset}
+${rgb(60, 110, 255)}  ██████╔╝██████╔╝${c.reset}
+${rgb(40, 90, 255)}  ██╔═══╝ ██╔══██╗${c.reset}
+${rgb(20, 70, 255)}  ██║     ██║  ██║${c.reset}
+${rgb(0, 50, 255)}  ╚═╝     ╚═╝  ╚═╝${c.reset}
+`;
+
+const BANNER_FULL = `
+${rgb(100, 150, 255)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(90, 140, 255)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
+${rgb(80, 130, 255)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
+${rgb(60, 110, 255)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
+${rgb(40, 90, 255)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
+${rgb(20, 70, 255)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
+
+${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
+${c.dim}  │${c.reset}  ${rgb(100, 150, 255)}📋${c.reset} ${c.bold}PR${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}GitHub Comments${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}CI Integration${c.reset} ${c.dim}•${c.reset} ${rgb(100, 100, 100)}Ship Verdict${c.reset}     ${c.dim}│${c.reset}
+${c.dim}  └─────────────────────────────────────────────────────────────────────┘${c.reset}
+`;
+
+const ICONS = {
+  pr: '📋',
+  check: '✓',
+  cross: '✗',
+  warning: '⚠',
+  arrow: '→',
+  bullet: '•',
+  ship: '🚀',
+  github: '🐙',
+  file: '📄',
+  sparkle: '✨',
+};
+
+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 printHelp() {
+  console.log(BANNER_FULL);
   console.log(`
-${c.cyan}${c.bold}vibecheck pr${c.reset} - Generate PR comment from ship report
-
-${c.bold}USAGE${c.reset}
-  vibecheck pr [options]
-
-${c.bold}OPTIONS${c.reset}
-  --fastify-entry <path>   Fastify entry file for route extraction
-  --out <file>             Write markdown to file
-  --fail-on-warn           Exit 1 on WARN verdict
-  --max-findings <n>       Max findings to show (default: 12)
-  --help, -h               Show this help
-
-${c.bold}WHAT IT DOES${c.reset}
-  1. Runs ship analysis (static + runtime)
-  2. Generates GitHub-ready markdown summary
-  3. Outputs PR comment body to stdout
-
-${c.bold}EXIT CODES${c.reset}
-  0 = SHIP or WARN (without --fail-on-warn)
-  1 = WARN (with --fail-on-warn)
-  2 = BLOCK
-
-${c.bold}EXAMPLES${c.reset}
-  vibecheck pr                           # Print PR comment
-  vibecheck pr --out pr-comment.md       # Save to file
-  vibecheck pr --fail-on-warn            # Strict CI mode
-`);
+  ${c.bold}Usage:${c.reset} vibecheck pr [options]
+
+  ${c.bold}PR Comment Generator${c.reset} — Generate GitHub-ready markdown from ship analysis.
+
+  ${c.bold}Options:${c.reset}
+    ${colors.accent}--fastify-entry <path>${c.reset}   Fastify entry file for route extraction
+    ${colors.accent}--out <file>${c.reset}             Write markdown to file
+    ${colors.accent}--fail-on-warn${c.reset}           Exit 1 on WARN verdict
+    ${colors.accent}--max-findings <n>${c.reset}       Max findings to show ${c.dim}(default: 12)${c.reset}
+    ${colors.accent}--help, -h${c.reset}               Show this help
+
+  ${c.bold}What It Does:${c.reset}
+    ${colors.shipGreen}1.${c.reset} Runs ship analysis (static + runtime)
+    ${colors.shipGreen}2.${c.reset} Generates GitHub-ready markdown summary
+    ${colors.shipGreen}3.${c.reset} Outputs PR comment body to stdout
+
+  ${c.bold}Exit Codes:${c.reset}
+    ${colors.shipGreen}0${c.reset}  SHIP or WARN ${c.dim}(without --fail-on-warn)${c.reset}
+    ${colors.warnAmber}1${c.reset}  WARN ${c.dim}(with --fail-on-warn)${c.reset}
+    ${colors.blockRed}2${c.reset}  BLOCK
+
+  ${c.bold}Examples:${c.reset}
+    ${c.dim}# Print PR comment to stdout${c.reset}
+    vibecheck pr
+
+    ${c.dim}# Save to file for GitHub Actions${c.reset}
+    vibecheck pr --out pr-comment.md
+
+    ${c.dim}# Strict CI mode (fail on warnings)${c.reset}
+    vibecheck pr --fail-on-warn
+  `);
 }
 
 function ensureDir(p) {