@vibecheckai/cli 3.5.0 → 3.5.2

package/bin/runners/runTruth.js

@@ -11,9 +11,6 @@ const fs = require("fs");
 const path = require("path");
 const { buildTruthpackV2 } = require("./lib/extractors/truthpack-v2");
 
-// Unified Output System
-const { output } = require("./lib/output/index.js");
-
 /**
  * Run truth command
  * @param {object} options - Command options

package/bin/runners/runValidate.js

@@ -4,17 +4,21 @@
 
 const fs = require("fs");
 const path = require("path");
-const { buildTruthpack } = require("./lib/truth");
+const { buildTruthpackSmart } = require("./lib/truth");
 const { routeMatches } = require("./lib/claims");
 const { EXIT } = require("./lib/exit-codes");
 const { formatSoftUpsell, formatWorkflowUpsell, PRICING_URL } = require("./lib/upsell");
 const { getApiKey } = require("./lib/auth");
 
-// Terminal UI - Import from shared module
-const { c } = require("./lib/terminal-ui");
-
-// Unified Output System
-const { output } = require("./lib/output/index.js");
+const c = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  green: "\x1b[32m",
+  yellow: "\x1b[33m",
+  red: "\x1b[31m",
+  cyan: "\x1b[36m",
+};
 
 function parseArgs(args) {
   const opts = {
@@ -87,7 +91,7 @@ async function runValidate(args) {
 
   try {
     // Build truthpack for validation
-    const truthpack = await buildTruthpack({ repoRoot: projectPath });
+    const truthpack = await buildTruthpackSmart({ repoRoot: projectPath });
     
     const issues = [];
     
@@ -133,7 +137,7 @@ async function runValidate(args) {
     
     // Output results
     const { key } = getApiKey();
-    const currentTier = key ? "pro" : "free";
+    const currentTier = key ? "starter" : "free";
     
     if (opts.json) {
       console.log(JSON.stringify({ issues, valid: issues.length === 0 }, null, 2));
@@ -158,7 +162,7 @@ async function runValidate(args) {
         // Upsell for auto-fix
         if (currentTier === "free") {
           console.log(`  ${c.dim}─────────────────────────────────────────────────────────────${c.reset}`);
-          console.log(`  ${c.magenta}★ PRO${c.reset}${c.dim}: auto-fix hallucinations with vibecheck fix${c.reset}`);
+          console.log(`  ${c.cyan}★ STARTER${c.reset}${c.dim}: auto-fix hallucinations with vibecheck fix${c.reset}`);
           console.log(`  ${c.dim}  Upgrade → ${PRICING_URL}${c.reset}\n`);
         }
       }

package/bin/runners/runWatch.js

@@ -19,15 +19,32 @@ const { EXIT } = require("./lib/exit-codes");
 const { shipCore } = require("./runShip");
 
 // ═══════════════════════════════════════════════════════════════════════════════
-// TERMINAL UI - Import from shared module
+// ADVANCED TERMINAL - ANSI CODES & UTILITIES
 // ═══════════════════════════════════════════════════════════════════════════════
 
-const { c, rgb, bgRgb, icons: ICONS_BASE, Spinner } = require("./lib/terminal-ui");
+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',
+};
 
-// Unified Output System
-const { output } = require("./lib/output/index.js");
+const rgb = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
+const bgRgb = (r, g, b) => `\x1b[48;2;${r};${g};${b}m`;
 
-// Extended color palette for watch command
 const colors = {
   gradient1: rgb(150, 100, 255),
   gradient2: rgb(130, 80, 255),
@@ -206,7 +223,7 @@ function printTopFindings(findings, max = 5) {
   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}(PRO)${c.reset}`);
+    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();
 }
@@ -321,14 +338,6 @@ async function runWatch(argsOrOpts = {}) {
     rawArgs = argsOrOpts;
     const { flags } = parseGlobalFlags(argsOrOpts);
     globalOpts = { ...globalOpts, ...flags };
-    
-    // Configure unified output mode
-    output.setMode({ 
-      json: globalOpts.json, 
-      quiet: globalOpts.quiet, 
-      ci: globalOpts.ci 
-    });
-    
     if (globalOpts.help) {
       printHelp(globalOpts);
       return EXIT.SUCCESS;

package/bin/scan.js

@@ -47,7 +47,12 @@ function getScanHistory(projectPath) {
     if (fs.existsSync(historyFile)) {
       return JSON.parse(fs.readFileSync(historyFile, "utf8"));
     }
-  } catch (e) {}
+  } catch (e) {
+    // Corrupted or unreadable history file - log in debug mode and reset
+    if (process.env.DEBUG) {
+      console.warn(`[scan] Could not read scan history: ${e.message}`);
+    }
+  }
   return { scans: [], lastScore: null };
 }
 

package/bin/vibecheck.js

@@ -800,10 +800,17 @@ ${c.bold}Installation:${c.reset}
 function printBanner() {
   const VERSION = getVersion();
   console.log(`
-${c.dim}${sym.boxTopLeft}${sym.boxHorizontal.repeat(60)}${sym.boxTopRight}${c.reset}
-${c.dim}${sym.boxVertical}${c.reset}  ${gradient("VIBECHECK", [[0, 255, 255], [138, 43, 226], [255, 20, 147]])} ${c.dim}v${VERSION}${c.reset}${" ".repeat(60 - 13 - VERSION.length - 4)}${c.dim}${sym.boxVertical}${c.reset}
-${c.dim}${sym.boxVertical}${c.reset}  ${c.dim}Ship with confidence. Catch fake features before users do.${c.reset}  ${c.dim}${sym.boxVertical}${c.reset}
-${c.dim}${sym.boxBottomLeft}${sym.boxHorizontal.repeat(60)}${sym.boxBottomRight}${c.reset}
+${c.dim}${sym.boxTopLeft}${sym.boxHorizontal.repeat(64)}${sym.boxTopRight}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}  ${gradient("VIBECHECK", [[0, 255, 255], [138, 43, 226], [255, 20, 147]])} ${c.dim}v${VERSION}${c.reset}${" ".repeat(64 - 13 - VERSION.length - 4)}${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}                                                                ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}  ${c.bold}Catch AI hallucinations before your users do.${c.reset}                 ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}                                                                ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}  ${c.cyan}${sym.check}${c.reset} Detects routes that look real but don't work             ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}  ${c.cyan}${sym.check}${c.reset} Finds env vars used but never declared                   ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}  ${c.cyan}${sym.check}${c.reset} Flags auth endpoints with no protection                  ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}                                                                ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxVertical}${c.reset}  ${c.dim}SHIP = proof your code works. Not a vibe check.${c.reset}               ${c.dim}${sym.boxVertical}${c.reset}
+${c.dim}${sym.boxBottomLeft}${sym.boxHorizontal.repeat(64)}${sym.boxBottomRight}${c.reset}
 `);
 }
 
@@ -883,74 +890,19 @@ function printHelp(showBanner = true) {
     reverseAliases[target].push(alias);
   }
 
-  // Show beginner tip first
-  console.log(`
-${c.yellow}${sym.star} NEW TO VIBECHECK?${c.reset}
-
-  Run ${c.cyan}${c.bold}vibecheck${c.reset} with no arguments to open the ${c.bold}interactive menu${c.reset}.
-  Or follow the Quick Start guide below.
-
-${c.dim}${sym.boxHorizontal.repeat(68)}${c.reset}
-`);
-
-  // Quick Start section (most important for beginners)
-  console.log(`${c.green}${sym.rocket} QUICK START${c.reset} ${c.dim}(Get running in 60 seconds)${c.reset}
-
-  ${c.bold}${c.white}Step 1:${c.reset} ${c.cyan}vibecheck init${c.reset}
-          ${c.dim}Set up vibecheck for your project${c.reset}
-
-  ${c.bold}${c.white}Step 2:${c.reset} ${c.cyan}vibecheck scan${c.reset}
-          ${c.dim}Analyze your codebase for issues${c.reset}
-
-  ${c.bold}${c.white}Step 3:${c.reset} ${c.cyan}vibecheck ship${c.reset} ${c.magenta}[PRO]${c.reset}
-          ${c.dim}Get final SHIP/WARN/BLOCK verdict${c.reset}
-`);
-
-  // Pricing tiers (simple 2-tier)
-  console.log(`${c.dim}${sym.boxHorizontal.repeat(68)}${c.reset}
-
-${c.bold}PRICING${c.reset}
-
-  ${c.green}${c.bold}FREE${c.reset}  ${c.dim}$0${c.reset}        Scan, Report, Context, Doctor
-  ${c.magenta}${c.bold}PRO${c.reset}   ${c.dim}$69/mo${c.reset}    Ship verdicts, Auto-fix, Runtime proof, CI gates
-                   ${c.dim}→ ${c.cyan}https://vibecheckai.dev/pricing${c.reset}
-`);
-
-  // Most-used commands
-  console.log(`${c.dim}${sym.boxHorizontal.repeat(68)}${c.reset}
-
-${c.bold}MOST USED COMMANDS${c.reset}
-`);
-
-  const popularCommands = [
-    { cmd: "scan", badge: "FREE", desc: "Analyze codebase for issues (routes, env, auth, mocks)" },
-    { cmd: "ship", badge: "PRO", desc: "Get SHIP/WARN/BLOCK verdict with evidence" },
-    { cmd: "fix", badge: "PRO", desc: "AI-powered auto-fix for detected issues" },
-    { cmd: "doctor", badge: "FREE", desc: "Check environment and config health" },
-    { cmd: "report", badge: "FREE", desc: "Generate HTML/JSON/SARIF reports" },
-    { cmd: "prove", badge: "PRO", desc: "Runtime verification with Playwright" },
-  ];
-
-  for (const { cmd, badge, desc } of popularCommands) {
-    const badgeStr = badge === "FREE" 
-      ? `${c.green}[FREE]${c.reset}` 
-      : `${c.magenta}[PRO]${c.reset}`;
-    console.log(`  ${c.cyan}${cmd.padEnd(10)}${c.reset} ${badgeStr}  ${c.dim}${desc}${c.reset}`);
-  }
-
-  // Categories with all commands
+  // Categories ordered as specified
   const categoryOrder = ["setup", "analysis", "proof", "quality", "truth", "output", "ci", "automation", "account", "extras"];
   const categories = {
-    setup: { name: "SETUP & CONFIG", color: c.yellow, icon: sym.gear },
+    setup: { name: "SETUP", color: c.yellow, icon: sym.gear },
     analysis: { name: "ANALYSIS", color: c.cyan, icon: sym.chart },
-    proof: { name: "PROOF & VERIFICATION", color: c.green, icon: sym.shield },
+    proof: { name: "PROOF LOOP", color: c.green, icon: sym.shield },
     quality: { name: "QUALITY", color: c.brightGreen, icon: sym.star },
-    truth: { name: "AI GUARDRAILS", color: c.magenta, icon: sym.lightning },
-    output: { name: "OUTPUT & REPORTS", color: c.blue, icon: sym.file },
-    ci: { name: "CI/CD", color: c.cyan, icon: sym.rocket },
+    truth: { name: "AI TRUTH", color: c.magenta, icon: sym.lightning },
+    output: { name: "OUTPUT", color: c.blue, icon: sym.file },
+    ci: { name: "CI & COLLABORATION", color: c.cyan, icon: sym.rocket },
     automation: { name: "AUTOMATION", color: c.brightBlue, icon: sym.fire },
-    account: { name: "ACCOUNT", color: c.gray, icon: sym.key },
-    extras: { name: "EXTRAS", color: c.gray, icon: sym.starEmpty },
+    account: { name: "ACCOUNT", color: c.dim, icon: sym.key },
+    extras: { name: "EXTRAS", color: c.dim, icon: sym.starEmpty },
   };
 
   // Group commands
@@ -961,74 +913,126 @@ ${c.bold}MOST USED COMMANDS${c.reset}
     grouped[cat].push({ cmd, ...def });
   }
 
-  console.log(`
-${c.dim}${sym.boxHorizontal.repeat(68)}${c.reset}
-
-${c.bold}ALL COMMANDS${c.reset}
-`);
-
   // Print in order
   for (const catKey of categoryOrder) {
     const commands = grouped[catKey];
     if (!commands || commands.length === 0) continue;
 
     const cat = categories[catKey];
-    console.log(`  ${cat.color}${cat.icon} ${cat.name}${c.reset}`);
+    console.log(`\n${cat.color}${cat.icon} ${cat.name}${c.reset}\n`);
 
-    for (const { cmd, description, tier } of commands) {
+    for (const { cmd, description, tier, caps } of commands) {
       // Tier badge (2-tier: FREE / PRO)
       let tierBadge = "";
-      if (tier === "free") tierBadge = `${c.green}[FREE]${c.reset}`;
-      else if (tier === "pro") tierBadge = `${c.magenta}[PRO]${c.reset}`;
+      if (tier === "free") tierBadge = `${c.green}[FREE]${c.reset} `;
+      else if (tier === "pro") tierBadge = `${c.magenta}[PRO]${c.reset} `;
 
-      // Aliases
+      // Aliases (from reverseAliases map built earlier)
       const aliasList = reverseAliases[cmd] || [];
       const aliasStr = aliasList.length > 0 
-        ? `${c.dim}(${aliasList.slice(0, 2).join(", ")})${c.reset}` 
+        ? `${c.dim}(${aliasList.slice(0, 3).join(", ")})${c.reset} ` 
         : "";
 
-      console.log(`     ${c.cyan}${cmd.padEnd(12)}${c.reset} ${tierBadge.padEnd(15)} ${description} ${aliasStr}`);
+      // Caps info
+      const capsStr = caps ? `${c.dim}(${caps})${c.reset}` : "";
+
+      console.log(`  ${c.cyan}${cmd.padEnd(12)}${c.reset} ${aliasStr}${tierBadge}${description} ${capsStr}`);
     }
-    console.log();
   }
 
-  // Global options
-  console.log(`${c.bold}GLOBAL OPTIONS${c.reset}
+  console.log(`
+${c.dim}${sym.boxHorizontal.repeat(64)}${c.reset}
+
+${c.green}${sym.star} PRICING TIERS${c.reset}
+
+  ${c.green}FREE${c.reset}      ${c.dim}$0${c.reset}       scan, ship, report, context, doctor, polish - full visibility
+  ${c.magenta}PRO${c.reset}       ${c.dim}$69/mo${c.reset}   + autofix, prove, reality, mcp, guard, ai-test, PR comments
+
+${c.green}${sym.rocket} QUICK START (2 minutes to first proof)${c.reset}
+
+  ${c.bold}Option 1: One command${c.reset}
+  ${c.cyan}vibecheck quickstart${c.reset}     ${c.dim}Runs doctor → ctx → scan → ship → report${c.reset}
+
+  ${c.bold}Option 2: Step by step${c.reset}
+  ${c.bold}1.${c.reset} ${c.cyan}vibecheck init${c.reset}         ${c.dim}Set up your project${c.reset}
+  ${c.bold}2.${c.reset} ${c.cyan}vibecheck scan${c.reset}         ${c.dim}Analyze your codebase${c.reset}
+  ${c.bold}3.${c.reset} ${c.cyan}vibecheck ship${c.reset}         ${c.dim}Get shipping verdict${c.reset}
+
+${c.green}${sym.lightning} COMMON WORKFLOWS${c.reset}
+
+  ${c.dim}# Quick health check${c.reset}
+  ${c.cyan}vibecheck doctor${c.reset}
+
+  ${c.dim}# Scan and auto-fix${c.reset}
+  ${c.cyan}vibecheck scan --autofix${c.reset}
+
+  ${c.dim}# Full proof with evidence pack${c.reset}
+  ${c.cyan}vibecheck prove --url http://localhost:3000 --bundle${c.reset}
+
+${c.bold}GLOBAL OPTIONS${c.reset}
 
   ${c.cyan}--help, -h${c.reset}           Show help for any command
   ${c.cyan}--json${c.reset}               Machine-readable JSON output
   ${c.cyan}--quiet, -q${c.reset}          Suppress non-essential output
   ${c.cyan}--verbose${c.reset}            Detailed output for debugging
   ${c.cyan}--ci${c.reset}                 CI mode (quiet + no-banner)
+  ${c.cyan}--offline${c.reset}            Run without API connection
   ${c.cyan}--path, -p <dir>${c.reset}     Run in specified directory
-`);
-
-  // Common workflows
-  console.log(`${c.bold}COMMON WORKFLOWS${c.reset}
-
-  ${c.dim}# First-time setup${c.reset}
-  ${c.cyan}vibecheck init${c.reset}
 
-  ${c.dim}# Daily development${c.reset}
-  ${c.cyan}vibecheck scan${c.reset}
+${c.bold}SHELL COMPLETIONS${c.reset}
 
-  ${c.dim}# Before shipping${c.reset}
-  ${c.cyan}vibecheck ship${c.reset}
+  ${c.cyan}vibecheck completion bash${c.reset}   ${c.dim}# Bash (add to ~/.bashrc)${c.reset}
+  ${c.cyan}vibecheck completion zsh${c.reset}    ${c.dim}# Zsh (add to ~/.zshrc)${c.reset}
+  ${c.cyan}vibecheck completion fish${c.reset}   ${c.dim}# Fish (save to completions)${c.reset}
 
-  ${c.dim}# Auto-fix issues${c.reset}
-  ${c.cyan}vibecheck fix --apply${c.reset}
-
-  ${c.dim}# CI/CD pipeline${c.reset}
-  ${c.cyan}vibecheck gate --strict${c.reset}
+${c.dim}${sym.boxHorizontal.repeat(64)}${c.reset}
+${c.dim}Run 'vibecheck <command> --help' for detailed command help.${c.reset}
+${c.dim}Documentation: https://docs.vibecheckai.dev${c.reset}
+${c.dim}Pricing: https://vibecheckai.dev/pricing${c.reset}
 `);
+}
 
-  // Footer
-  console.log(`${c.dim}${sym.boxHorizontal.repeat(68)}${c.reset}
-${c.dim}Run ${c.cyan}vibecheck <command> --help${c.reset}${c.dim} for detailed command help.${c.reset}
-${c.dim}Interactive menu: ${c.cyan}vibecheck menu${c.reset}${c.dim} or just ${c.cyan}vibecheck${c.reset}
-${c.dim}Documentation: ${c.underline}https://docs.vibecheckai.dev${c.reset}
-${c.dim}Upgrade to Pro: ${c.underline}https://vibecheckai.dev/pricing${c.reset}
-`);
+// ═══════════════════════════════════════════════════════════════════════════════
+// HELP VALIDATION
+// ═══════════════════════════════════════════════════════════════════════════════
+
+/**
+ * Self-test function to verify help output matches actual commands
+ * Run with: node bin/vibecheck.js --self-test
+ */
+function validateHelpOutput() {
+  const registry = getRegistry();
+  const { COMMANDS, ALIAS_MAP } = registry;
+  
+  // Extract commands from help text (simplified - just check registry)
+  const actualCommands = Object.keys(COMMANDS);
+  const actualAliases = Object.keys(ALIAS_MAP);
+  const allActualCommands = [...actualCommands, ...actualAliases];
+  
+  // Check for obvious issues
+  const issues = [];
+  
+  // Check that all commands have runners
+  for (const [cmd, def] of Object.entries(COMMANDS)) {
+    if (!def.runner) {
+      issues.push(`Command '${cmd}' missing runner`);
+    }
+  }
+  
+  // Check that aliases point to valid commands
+  for (const [alias, target] of Object.entries(ALIAS_MAP)) {
+    if (!COMMANDS[target]) {
+      issues.push(`Alias '${alias}' points to non-existent command '${target}'`);
+    }
+  }
+  
+  if (issues.length > 0) {
+    console.error('Help output validation failed:');
+    issues.forEach(issue => console.error(`  - ${issue}`));
+    return false;
+  }
+  
+  return true;
 }
 
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -1057,6 +1061,50 @@ function formatError(error, config) {
   return lines.join("\n");
 }
 
+/**
+ * Map error to standardized exit code
+ * @param {Error} error - Error object
+ * @param {boolean} json - Whether JSON output is requested
+ * @returns {number} Exit code
+ */
+function mapErrorToExitCode(error, json = false) {
+  const EXIT_CODES = {
+    'AUTH_REQUIRED': 5,
+    'AUTH_FAILED': 6,
+    'TIER_REQUIRED': 7,
+    'RATE_LIMITED': 8,
+    'NOT_FOUND': 4,
+    'VALIDATION_ERROR': 3,
+    'USER_ERROR': 3,
+    'NETWORK_ERROR': 9,
+  };
+  
+  // Check error.code first
+  if (error.code && EXIT_CODES[error.code]) {
+    return EXIT_CODES[error.code];
+  }
+  
+  // Check error.exitCode
+  if (error.exitCode !== undefined) {
+    return error.exitCode;
+  }
+  
+  // Check error message for common patterns
+  const message = error.message?.toLowerCase() || '';
+  if (message.includes('not found') || message.includes('not exist')) {
+    return 4; // NOT_FOUND
+  }
+  if (message.includes('auth') || message.includes('login')) {
+    return 5; // AUTH_REQUIRED
+  }
+  if (message.includes('network') || message.includes('connection')) {
+    return 9; // NETWORK_ERROR
+  }
+  
+  // Default to internal error
+  return 10; // INTERNAL_ERROR
+}
+
 // ═══════════════════════════════════════════════════════════════════════════════
 // FLAG PARSING
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -1156,6 +1204,16 @@ async function main() {
     process.exit(0);
   }
 
+  // Handle self-test flag (for CI validation)
+  if (cleanArgs.includes('--self-test')) {
+    const registry = getRegistry();
+    if (!validateHelpOutput()) {
+      process.exit(1);
+    }
+    console.log('Self-test passed: Help output matches command registry');
+    process.exit(0);
+  }
+
   // Load config and state
   const config = loadConfig();
   const state = loadState();
@@ -1170,57 +1228,10 @@ async function main() {
     config.noBanner = true;
   }
 
-  // ═══════════════════════════════════════════════════════════════════════════
-  // EASY MODE - Super simple commands for non-technical users
-  // ═══════════════════════════════════════════════════════════════════════════
-  const easyModeCommands = ['test', 'protect', 'status'];
-  const firstArg = cleanArgs[0]?.toLowerCase();
-  
-  // Check if this is an easy mode command or URL
-  const isEasyCommand = easyModeCommands.includes(firstArg);
-  const isDirectUrl = firstArg && (firstArg.startsWith('http') || firstArg.includes('localhost'));
-  
-  if (isEasyCommand || isDirectUrl) {
-    try {
-      const { main: runEasy } = require("./runners/runEasy");
-      await runEasy();
-      return;
-    } catch (err) {
-      if (config.debug) console.error(`Easy mode error: ${err.message}`);
-      // Fall through to normal handling
-    }
-  }
-
-  // Handle no command - show EASY wizard for beginners (much friendlier)
+  // Handle no command
   if (!cleanArgs[0]) {
-    // In TTY mode, show the EASY wizard for new users
-    if (process.stdout.isTTY && !config.quiet && !config.ci) {
-      try {
-        // Try easy wizard first (friendlier for new users)
-        const { Wizard } = require("./runners/lib/easy/interactive-wizard");
-        const wizard = new Wizard();
-        await wizard.start();
-        return;
-      } catch {
-        // Fall back to original interactive menu
-        try {
-          const { runInteractiveMenu } = require("./runners/lib/cli-interactive-menu");
-          runInteractiveMenu().then(() => process.exit(0)).catch(() => {
-            printHelp(!config.noBanner);
-            process.exit(0);
-          });
-          return; // Let async menu run
-        } catch {
-          // Fall back to help if menu module not available
-          printHelp(!config.noBanner);
-          process.exit(0);
-        }
-      }
-    } else {
-      // Non-TTY or quiet mode: show help
-      printHelp(!config.noBanner);
-      process.exit(0);
-    }
+    printHelp(!config.noBanner);
+    process.exit(0);
   }
 
   // Handle global help
@@ -1228,28 +1239,6 @@ async function main() {
     printHelp(!config.noBanner);
     process.exit(0);
   }
-  
-  // Handle explicit menu command
-  if (cleanArgs[0] === "menu") {
-    if (process.stdout.isTTY) {
-      try {
-        const { runInteractiveMenu } = require("./runners/lib/cli-interactive-menu");
-        runInteractiveMenu().then(() => process.exit(0)).catch((err) => {
-          console.error(`Menu error: ${err.message}`);
-          process.exit(1);
-        });
-        return;
-      } catch (err) {
-        console.error(`${c.red}Error:${c.reset} Interactive menu not available: ${err.message}`);
-        console.log(`${c.dim}Use 'vibecheck --help' to see available commands.${c.reset}`);
-        process.exit(1);
-      }
-    } else {
-      console.error(`${c.yellow}Warning:${c.reset} Interactive menu requires a terminal.`);
-      console.log(`${c.dim}Use 'vibecheck --help' to see available commands.${c.reset}`);
-      process.exit(1);
-    }
-  }
 
   // Handle completion command (special - doesn't need registry loaded normally)
   if (cleanArgs[0] === "completion") {
@@ -1318,10 +1307,16 @@ async function main() {
   const cmdDef = COMMANDS[cmd];
   let authInfo = { key: null };
 
-  // Check for offline mode (via flag or env var)
+  // Check for offline/dev mode (via flag or env var)
+  // SECURITY: VIBECHECK_DEV_PRO only works in non-production to prevent auth bypass
+  const isDevProAllowed = process.env.NODE_ENV !== 'production' && 
+                          process.env.CI !== 'true' && 
+                          process.env.CI !== '1' &&
+                          process.env.VIBECHECK_DEV_PRO === '1';
   const isOffline = globalFlags.offline || 
                     process.env.VIBECHECK_OFFLINE === '1' || 
-                    process.env.VIBECHECK_LOCAL === '1';
+                    process.env.VIBECHECK_LOCAL === '1' ||
+                    isDevProAllowed;
 
   // Auth check (unless skipAuth or offline mode)
   // Only allow login, logout, whoami, and help without auth
@@ -1383,7 +1378,9 @@ async function main() {
     authInfo.access = access;
   } else if (isOffline) {
     // Offline mode - provide basic access info
-    if (!config.quiet && !config.noBanner) {
+    // Suppress message if JSON/SARIF output is requested (check both global flags and command args)
+    const hasJsonOutput = globalFlags.json || cmdArgs.includes('--json') || cmdArgs.includes('--sarif');
+    if (!config.quiet && !config.noBanner && !hasJsonOutput) {
       console.log(`${c.cyan}${sym.arrowRight} OFFLINE${c.reset} ${c.dim}mode - local scanning without API${c.reset}`);
     }
     authInfo.access = {
@@ -1412,7 +1409,7 @@ async function main() {
     const runner = getRunner(cmd);
     if (!runner) {
       console.error(`${c.red}${sym.error}${c.reset} Failed to load runner for: ${cmd}`);
-      process.exit(1);
+      process.exit(4); // NOT_FOUND
     }
 
     const context = {
@@ -1427,10 +1424,32 @@ async function main() {
     };
 
     // Execute command - all commands use consistent runner signature
-    exitCode = await runner(cmdArgs, context);
+    const result = await runner(cmdArgs, context);
+    
+    // Ensure result has standardized exit code
+    if (typeof result === 'object' && result.exitCode !== undefined) {
+      exitCode = result.exitCode;
+    } else if (typeof result === 'number') {
+      exitCode = result;
+    } else {
+      exitCode = 0; // SUCCESS
+    }
   } catch (error) {
-    console.error(formatError(error, config));
-    exitCode = 1;
+    // Map errors to exit codes
+    exitCode = mapErrorToExitCode(error, globalFlags.json);
+    
+    if (globalFlags.json) {
+      console.log(JSON.stringify({
+        success: false,
+        error: {
+          code: error.code || 'INTERNAL_ERROR',
+          message: error.message,
+        },
+        exitCode,
+      }, null, 2));
+    } else {
+      console.error(formatError(error, config));
+    }
   }
 
   // Create receipt for paid commands