@vibecheckai/cli 3.5.0 → 3.5.1

package/bin/vibecheck.js

@@ -795,7 +795,7 @@ ${c.bold}Installation:${c.reset}
 }
 
 // ═══════════════════════════════════════════════════════════════════════════════
-// HELP SYSTEM - World-Class CLI Experience
+// HELP SYSTEM
 // ═══════════════════════════════════════════════════════════════════════════════
 function printBanner() {
   const VERSION = getVersion();
@@ -807,69 +807,6 @@ ${c.dim}${sym.boxBottomLeft}${sym.boxHorizontal.repeat(60)}${sym.boxBottomRight}
 `);
 }
 
-/**
- * Print command-specific help with rich examples
- */
-function printCommandHelp(cmd) {
-  const registry = getRegistry();
-  const def = registry.COMMANDS[cmd];
-  if (!def) return false;
-  
-  // Build reverse alias map
-  const reverseAliases = {};
-  for (const [alias, target] of Object.entries(registry.ALIAS_MAP)) {
-    if (!reverseAliases[target]) reverseAliases[target] = [];
-    reverseAliases[target].push(alias);
-  }
-  
-  const aliases = reverseAliases[cmd] || [];
-  
-  // Tier badge (2-tier: FREE / PRO)
-  const tierBadge = def.tier === "free" ? `${c.green}[FREE]${c.reset}` :
-                    def.tier === "pro" ? `${c.magenta}[PRO]${c.reset}` : "";
-  
-  console.log(`
-  ${c.bold}${sym.arrowRight} vibecheck ${cmd}${c.reset} ${tierBadge}
-  ${aliases.length > 0 ? `${c.dim}Aliases: ${aliases.join(", ")}${c.reset}` : ""}
-  
-  ${def.longDescription || def.description}
-`);
-
-  // Examples
-  if (def.examples && def.examples.length > 0) {
-    console.log(`  ${c.bold}${sym.star} EXAMPLES${c.reset}\n`);
-    for (const ex of def.examples) {
-      const exTier = ex.tier === "pro" ? `${c.magenta}[PRO]${c.reset} ` : "";
-      console.log(`    ${c.dim}#${c.reset} ${ex.description} ${exTier}`);
-      console.log(`    ${c.cyan}${ex.command}${c.reset}`);
-      console.log();
-    }
-  }
-  
-  // Related commands
-  if (def.related && def.related.length > 0) {
-    console.log(`  ${c.bold}${sym.arrowRight} RELATED COMMANDS${c.reset}\n`);
-    for (const relCmd of def.related) {
-      const relDef = registry.COMMANDS[relCmd];
-      if (relDef) {
-        const relTier = relDef.tier === "pro" ? `${c.magenta}[PRO]${c.reset} ` : "";
-        console.log(`    ${c.cyan}vibecheck ${relCmd}${c.reset} ${relTier}${c.dim}${relDef.description}${c.reset}`);
-      }
-    }
-    console.log();
-  }
-  
-  // Documentation link
-  if (def.docsUrl) {
-    console.log(`  ${c.dim}${sym.boxHorizontal.repeat(56)}${c.reset}`);
-    console.log(`  ${c.dim}Documentation: ${c.underline}${def.docsUrl}${c.reset}`);
-  }
-  
-  console.log(`  ${c.dim}Run 'vibecheck --help' for all commands.${c.reset}\n`);
-  
-  return true;
-}
-
 function printHelp(showBanner = true) {
   if (showBanner) printBanner();
 
@@ -883,74 +820,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,73 +843,67 @@ ${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) {
-      // Tier badge (2-tier: FREE / PRO)
+    for (const { cmd, description, tier, caps } of commands) {
+      // Tier badge
       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 === "starter") tierBadge = `${c.cyan}[STARTER]${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.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}--path, -p <dir>${c.reset}     Run in specified directory
-`);
+${c.green}TIERS${c.reset}
+
+  ${c.green}FREE${c.reset}      $0       init --local, scan, ship (static), report (HTML/MD), doctor, polish
+  ${c.cyan}STARTER${c.reset}   $39/mo   + init --connect, scan --autofix, report (SARIF/CSV), mcp, PR comments
+  ${c.magenta}PRO${c.reset}       $99/mo   + prove, fix --apply, checkpoint (hallucination), reality (advanced)
 
-  // Common workflows
-  console.log(`${c.bold}COMMON WORKFLOWS${c.reset}
+${c.green}QUICK START - The 5-Step Journey${c.reset}
 
-  ${c.dim}# First-time setup${c.reset}
-  ${c.cyan}vibecheck init${c.reset}
+  1. ${c.bold}Setup${c.reset}         ${c.cyan}vibecheck init --local${c.reset}
+  2. ${c.bold}Scan${c.reset}          ${c.cyan}vibecheck scan${c.reset}
+  3. ${c.bold}Fix${c.reset}           ${c.cyan}vibecheck scan --autofix${c.reset} ${c.cyan}[STARTER]${c.reset}
+  4. ${c.bold}Prove${c.reset}         ${c.cyan}vibecheck prove${c.reset} ${c.magenta}[PRO]${c.reset}
+  5. ${c.bold}Ship${c.reset}          ${c.cyan}vibecheck ship${c.reset}
 
-  ${c.dim}# Daily development${c.reset}
-  ${c.cyan}vibecheck scan${c.reset}
+${c.bold}GLOBAL OPTIONS${c.reset}
 
-  ${c.dim}# Before shipping${c.reset}
-  ${c.cyan}vibecheck ship${c.reset}
+  ${c.cyan}--offline, --local${c.reset}   Run in offline mode (no API, unlimited local scans)
+  ${c.cyan}--json${c.reset}               Output as JSON
+  ${c.cyan}--quiet, -q${c.reset}          Suppress output
+  ${c.cyan}--verbose${c.reset}            Show detailed output
+  ${c.cyan}--path, -p <dir>${c.reset}     Run in specified directory
 
-  ${c.dim}# Auto-fix issues${c.reset}
-  ${c.cyan}vibecheck fix --apply${c.reset}
+${c.bold}SHELL COMPLETIONS${c.reset}
 
-  ${c.dim}# CI/CD pipeline${c.reset}
-  ${c.cyan}vibecheck gate --strict${c.reset}
-`);
+  ${c.cyan}vibecheck completion bash${c.reset}   ${c.dim}# Add to ~/.bashrc${c.reset}
+  ${c.cyan}vibecheck completion zsh${c.reset}    ${c.dim}# Add to ~/.zshrc${c.reset}
+  ${c.cyan}vibecheck completion fish${c.reset}   ${c.dim}# Save to completions dir${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}
+${c.dim}Run 'vibecheck <command> --help' for command-specific help.${c.reset}
+${c.dim}Pricing: https://vibecheckai.dev/pricing${c.reset}
 `);
 }
 
@@ -1170,57 +1046,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 +1057,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") {
@@ -1267,14 +1074,6 @@ async function main() {
   }
   let cmdArgs = cleanArgs.slice(1);
 
-  // Handle command-specific help (vibecheck <cmd> --help)
-  if (globalFlags.help && cmd && COMMANDS[cmd]) {
-    // Try our rich help first, then fall back to runner's --help
-    if (printCommandHelp(cmd)) {
-      process.exit(0);
-    }
-  }
-  
   // Pass --help to runner if specified with command
   if (globalFlags.help) cmdArgs = ["--help", ...cmdArgs];
 
@@ -1324,60 +1123,35 @@ async function main() {
                     process.env.VIBECHECK_LOCAL === '1';
 
   // Auth check (unless skipAuth or offline mode)
-  // Only allow login, logout, whoami, and help without auth
-  const authExemptCommands = ['login', 'logout', 'whoami', 'help', '--help', '-h', 'version', '--version'];
-  const needsAuth = !authExemptCommands.includes(cmd) && !cmdDef.skipAuth && !isOffline;
-  
-  if (needsAuth) {
+  if (!cmdDef.skipAuth && !isOffline) {
     const auth = getAuthModule();
     const { key } = auth.getApiKey();
     authInfo.key = key;
 
-    // If no API key, prompt for login
-    if (!key) {
-      console.log(`\n  ${c.red}❌ Authentication Required${c.reset}`);
-      console.log(`  Please log in to use vibecheck.\n`);
-      console.log(`  ${c.cyan}Options:${c.reset}`);
-      console.log(`  1. Press ${c.yellow}Enter${c.reset} to open browser and sign up`);
-      console.log(`  2. Visit ${c.underline}https://vibecheckai.dev${c.reset} directly`);
-      console.log(`  3. Run ${c.cyan}vibecheck login${c.reset} after getting your API key\n`);
-      
-      // Wait for Enter key
-      const readline = getReadline();
-      readline.createInterface({
-        input: process.stdin,
-        output: process.stdout
-      }).question('', async () => {
-        try {
-          const https = getHttps();
-          const url = 'https://vibecheckai.dev';
-          console.log(`\n  Opening ${c.underline}${url}${c.reset} in your browser...\n`);
-          
-          // Try to open browser
-          const start = process.platform === 'darwin' ? 'open' : 
-                       process.platform === 'win32' ? 'start' : 'xdg-open';
-          require('child_process').exec(`${start} ${url}`);
-        } catch (e) {
-          console.log(`  Could not open browser. Please visit: ${c.underline}https://vibecheckai.dev${c.reset}`);
-        }
-        process.exit(0);
-      });
-      
-      // Keep process alive
-      return new Promise(() => {});
-    }
-
     const access = await checkCommandAccess(cmd, cmdArgs, authInfo);
 
     if (!access.allowed) {
       console.log(access.reason);
-      
-      // Show upgrade prompt if tier insufficient
-      if (access.upgradeUrl) {
-        console.log(`\n  ${c.cyan}Upgrade:${c.reset} ${access.upgradeUrl}`);
+      process.exit(access.exitCode || 3);
+    }
+
+    // Downgrade notice
+    if (access.downgrade && !config.quiet) {
+      const upsell = getUpsell();
+      console.log(upsell.formatDowngrade(cmd, {
+        currentTier: access.tier,
+        effectiveMode: access.downgrade,
+        caps: access.caps,
+      }));
+    }
+
+    // Tier badge
+    if (!config.quiet && !config.noBanner) {
+      if (access.tier === "pro") {
+        console.log(`${c.magenta}${sym.arrowRight} PRO${c.reset} ${c.dim}feature${c.reset}`);
+      } else if (access.tier === "complete") {
+        console.log(`${c.yellow}${sym.arrowRight} COMPLETE${c.reset} ${c.dim}feature${c.reset}`);
       }
-      
-      return 1;
     }
 
     authInfo.access = access;