@vibecheckai/cli 3.0.9 → 3.1.0

package/bin/runners/runVerify.js

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+/**
+ * runVerify.js - CLI Verify Command
+ * Verifies AI-generated agent output against vibecheck-v1 protocol
+ * 
+ * Usage:
+ *   vibecheck verify [options]
+ *   vibecheck verify --input response.json
+ *   vibecheck verify --stdin
+ *   vibecheck verify --mode ship --strict
+ */
+
+"use strict";
+
+const fs = require('fs');
+const path = require('path');
+const { parseArgs } = require('util');
+
+const HELP = `
+vibecheck verify - Verify AI-generated agent output
+
+Usage:
+  vibecheck verify [options]
+
+Options:
+  --input, -i <file>    Input file containing agent response JSON
+  --stdin               Read agent response from stdin
+  --root, -r <dir>      Project root directory (default: cwd)
+  --mode, -m <mode>     Verification mode: explore|build|ship (default: build)
+  --strict              Enable strict mode (fail on warnings)
+  --json                Output results as JSON
+  --help, -h            Show this help message
+
+Examples:
+  vibecheck verify --input agent-response.json
+  echo '{"format":"vibecheck-v1",...}' | vibecheck verify --stdin
+  vibecheck verify --input response.json --mode ship --strict
+`;
+
+async function main() {
+  const { values, positionals } = parseArgs({
+    options: {
+      input: { type: 'string', short: 'i' },
+      stdin: { type: 'boolean', default: false },
+      root: { type: 'string', short: 'r' },
+      mode: { type: 'string', short: 'm', default: 'build' },
+      strict: { type: 'boolean', default: false },
+      json: { type: 'boolean', default: false },
+      help: { type: 'boolean', short: 'h' },
+    },
+    allowPositionals: true,
+    strict: false,
+  });
+
+  if (values.help) {
+    console.log(HELP);
+    process.exit(0);
+  }
+
+  const projectRoot = values.root ? path.resolve(values.root) : process.cwd();
+  const mode = values.mode || 'build';
+  const strict = values.strict || false;
+  const outputJson = values.json || false;
+
+  // Validate mode
+  if (!['explore', 'build', 'ship'].includes(mode)) {
+    console.error(`Error: Invalid mode "${mode}". Must be one of: explore, build, ship`);
+    process.exit(2);
+  }
+
+  // Get input
+  let rawInput = '';
+
+  if (values.stdin) {
+    rawInput = await readStdin();
+  } else if (values.input) {
+    const inputPath = path.resolve(values.input);
+    if (!fs.existsSync(inputPath)) {
+      console.error(`Error: Input file not found: ${inputPath}`);
+      process.exit(2);
+    }
+    rawInput = fs.readFileSync(inputPath, 'utf-8');
+  } else if (positionals.length > 0) {
+    // Allow positional argument as input file
+    const inputPath = path.resolve(positionals[0]);
+    if (!fs.existsSync(inputPath)) {
+      console.error(`Error: Input file not found: ${inputPath}`);
+      process.exit(2);
+    }
+    rawInput = fs.readFileSync(inputPath, 'utf-8');
+  } else {
+    console.error('Error: No input provided. Use --input <file> or --stdin');
+    console.log(HELP);
+    process.exit(2);
+  }
+
+  if (!rawInput.trim()) {
+    console.error('Error: Empty input');
+    process.exit(2);
+  }
+
+  // Load the verification module
+  let validateFormat, verifyAgentOutput, formatCheckResults, buildJsonReport;
+  try {
+    // Try loading from the built TypeScript output
+    const verification = require('../../dist/lib/verification/index.js');
+    validateFormat = verification.validateFormat;
+    verifyAgentOutput = verification.verifyAgentOutput;
+    formatCheckResults = verification.formatCheckResults;
+    buildJsonReport = verification.buildJsonReport;
+  } catch (err) {
+    // Fallback: try loading directly (for development)
+    try {
+      const verification = require('../../src/lib/verification/index.ts');
+      validateFormat = verification.validateFormat;
+      verifyAgentOutput = verification.verifyAgentOutput;
+      formatCheckResults = verification.formatCheckResults;
+      buildJsonReport = verification.buildJsonReport;
+    } catch (err2) {
+      console.error('Error loading verification module:', err.message);
+      console.error('Make sure the project is built: pnpm build');
+      process.exit(2);
+    }
+  }
+
+  // Step 1: Validate format
+  if (!outputJson) {
+    console.log('🔍 Validating agent output format...');
+  }
+
+  const formatResult = validateFormat(rawInput);
+
+  if (!formatResult.valid) {
+    if (outputJson) {
+      console.log(JSON.stringify({
+        status: 'fail',
+        phase: 'format-validation',
+        error: formatResult.error,
+        retryPrompt: formatResult.retryPrompt,
+      }, null, 2));
+    } else {
+      console.error('❌ Format validation failed:', formatResult.error);
+      console.error('\n📝 Retry prompt:');
+      console.error(formatResult.retryPrompt);
+    }
+    process.exit(2);
+  }
+
+  // Check if it's an error response
+  if ('error' in formatResult && formatResult.error) {
+    if (outputJson) {
+      console.log(JSON.stringify({
+        status: 'error',
+        phase: 'agent-error',
+        error: formatResult.error.error,
+      }, null, 2));
+    } else {
+      console.log('⚠️  Agent returned an error response:');
+      console.log(formatResult.error.error);
+    }
+    process.exit(1);
+  }
+
+  const agentOutput = formatResult.output;
+
+  if (!outputJson) {
+    console.log('✅ Format valid');
+    console.log(`   Files in diff: ${countFilesInDiff(agentOutput.diff)}`);
+    console.log(`   Commands: ${agentOutput.commands?.length || 0}`);
+    console.log(`   Tests: ${agentOutput.tests?.length || 0}`);
+    console.log('');
+  }
+
+  // Step 2: Run verification pipeline
+  if (!outputJson) {
+    console.log('🔬 Running verification pipeline...');
+  }
+
+  const context = {
+    projectRoot,
+    mode,
+    runTests: mode === 'ship',
+    strictMode: strict,
+    maxFilesChanged: mode === 'ship' ? 10 : mode === 'build' ? 20 : 50,
+  };
+
+  let result;
+  try {
+    result = await verifyAgentOutput(agentOutput, context);
+  } catch (err) {
+    if (outputJson) {
+      console.log(JSON.stringify({
+        status: 'fail',
+        phase: 'verification',
+        error: err.message,
+      }, null, 2));
+    } else {
+      console.error('❌ Verification error:', err.message);
+    }
+    process.exit(2);
+  }
+
+  // Output results
+  if (outputJson) {
+    console.log(JSON.stringify(buildJsonReport(result), null, 2));
+  } else {
+    console.log('');
+    console.log(formatCheckResults(result.checks));
+    console.log('');
+
+    if (result.status === 'pass') {
+      console.log('✅ VERIFICATION PASSED');
+    } else if (result.status === 'warn') {
+      console.log('⚠️  VERIFICATION PASSED WITH WARNINGS');
+    } else {
+      console.log('❌ VERIFICATION FAILED');
+      if (result.failureContext) {
+        console.log('\n📝 Failure context for retry:');
+        console.log(result.failureContext);
+      }
+    }
+  }
+
+  // Exit codes: 0 = pass, 1 = warn (if strict), 2 = fail
+  if (result.status === 'fail') {
+    process.exit(2);
+  } else if (result.status === 'warn' && strict) {
+    process.exit(1);
+  } else {
+    process.exit(0);
+  }
+}
+
+/**
+ * Read all input from stdin
+ */
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    let data = '';
+    process.stdin.setEncoding('utf-8');
+    process.stdin.on('data', chunk => { data += chunk; });
+    process.stdin.on('end', () => resolve(data));
+    process.stdin.on('error', reject);
+
+    // Timeout after 5 seconds if no input
+    setTimeout(() => {
+      if (data === '') {
+        reject(new Error('No input received from stdin'));
+      }
+    }, 5000);
+  });
+}
+
+/**
+ * Count files in a diff string
+ */
+function countFilesInDiff(diff) {
+  if (!diff) return 0;
+  const matches = diff.match(/^diff --git/gm);
+  return matches ? matches.length : 0;
+}
+
+// Export for CLI registry
+module.exports = { main };
+
+// Run if executed directly
+if (require.main === module) {
+  main().catch(err => {
+    console.error('Fatal error:', err.message);
+    process.exit(2);
+  });
+}

package/bin/runners/runWatch.js

@@ -1,6 +1,10 @@
 /**
  * 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.
@@ -12,16 +16,92 @@ 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",
-  red: "\x1b[31m",
-  green: "\x1b[32m",
-  yellow: "\x1b[33m",
-  cyan: "\x1b[36m",
-  blue: "\x1b[34m",
-  clear: "\x1b[2J\x1b[H",
+  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 = [
@@ -58,29 +138,63 @@ function formatDuration(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" ? c.green : verdict === "WARN" ? c.yellow : c.red;
+  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;
-
-  console.log(`
-${c.cyan}${c.bold}╔════════════════════════════════════════════════════════════╗
-║  👁️  vibecheck watch                                         ║
-╚════════════════════════════════════════════════════════════╝${c.reset}
-
-  ${c.dim}Time:${c.reset}     ${formatTime()}
-  ${c.dim}Runs:${c.reset}     ${runCount}
-  ${c.dim}Duration:${c.reset} ${formatDuration(duration)}
-  ${c.dim}Changed:${c.reset}  ${lastFile || "(initial)"}
-
-${c.bold}  VERDICT:  ${verdictColor}${verdict}${c.reset}
+  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}`);
   
-  ${c.dim}Findings:${c.reset} ${blocks} BLOCK, ${warns} WARN
-
-${verdict === "SHIP" ? `  ${c.green}✓ Ready to ship${c.reset}` : `  ${c.yellow}⚠ Run "vibecheck fix" to resolve${c.reset}`}
-
-${c.dim}  Watching for changes... (Ctrl+C to stop)${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) {
@@ -90,12 +204,13 @@ function printTopFindings(findings, max = 5) {
 
   if (!top.length) return;
 
-  console.log(`${c.dim}  Top findings:${c.reset}`);
+  console.log(`  ${c.bold}Top findings:${c.reset}`);
   for (const f of top) {
-    const icon = f.severity === "BLOCK" ? c.red + "●" : c.yellow + "●";
-    console.log(`    ${icon}${c.reset} ${f.title}`);
+    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}`);
   }
-  console.log("");
+  console.log();
 }
 
 async function runShipQuiet(root, fastifyEntry) {
@@ -159,37 +274,42 @@ function watchDirectory(dir, callback) {
 }
 
 function printHelp() {
+  console.log(BANNER_FULL);
   console.log(`
-${c.cyan}${c.bold}vibecheck watch${c.reset} - Continuous Dev Mode
+  ${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}USAGE${c.reset}
-  vibecheck watch [options]
+  ${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}OPTIONS${c.reset}
-  --fastify-entry <path>   Fastify entry file for route extraction
-  --debounce <ms>          Debounce delay in ms (default: 500)
-  --no-clear               Don't clear screen between runs
-  --help, -h               Show this help
+  ${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}WHAT IT DOES${c.reset}
-  1. Runs initial ship analysis
-  2. Watches for file changes in your project
-  3. Re-runs analysis on each change
-  4. Shows live verdict dashboard
+  ${c.bold}Ignored:${c.reset}
+    ${c.dim}node_modules, .next, .vibecheck, dist, build, .git${c.reset}
 
-${c.bold}WATCHED FILES${c.reset}
-  .ts, .tsx, .js, .jsx, .json, .env, .md, .yml, .yaml
+  ${c.bold}Examples:${c.reset}
+    ${c.dim}# Start watching${c.reset}
+    vibecheck watch
 
-${c.bold}IGNORED${c.reset}
-  node_modules, .next, .vibecheck, dist, build, .git
+    ${c.dim}# 1 second debounce${c.reset}
+    vibecheck watch --debounce 1000
 
-${c.bold}EXAMPLES${c.reset}
-  vibecheck watch                      # Start watching
-  vibecheck watch --debounce 1000      # 1s debounce
-  vibecheck watch --no-clear           # Keep history
+    ${c.dim}# Keep history (don't clear)${c.reset}
+    vibecheck watch --no-clear
 
-${c.dim}Press Ctrl+C to stop watching${c.reset}
-`);
+  ${c.dim}Press Ctrl+C to stop watching${c.reset}
+  `);
 }
 
 async function runWatch(argsOrOpts = {}) {