@vibecheckai/cli 3.2.6 → 3.3.0

package/bin/runners/runAuth.js

@@ -1,3 +1,11 @@
+/**
+ * vibecheck auth commands - Login, Logout, Whoami
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * World-Class Authentication Experience
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
 const readline = require("readline");
 const {
   saveApiKey,
@@ -5,17 +13,22 @@ const {
   getApiKey,
   getEntitlements,
 } = require("./lib/auth");
-
-const c = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  red: "\x1b[31m",
-  green: "\x1b[32m",
-  yellow: "\x1b[33m",
-  blue: "\x1b[34m",
-  cyan: "\x1b[36m",
-};
+const { EXIT } = require("./lib/exit-codes");
+const { parseGlobalFlags, shouldSuppressOutput, isJsonMode } = require("./lib/global-flags");
+const {
+  ansi,
+  sym,
+  renderMinimalHeader,
+  renderSectionHeader,
+  renderSuccess,
+  renderError,
+  renderWarning,
+  renderKeyValue,
+  renderFooter,
+  Spinner,
+  getTierBadge,
+  TIER,
+} = require("./lib/unified-cli-output");
 
 async function prompt(question) {
   const rl = readline.createInterface({
@@ -31,127 +44,343 @@ async function prompt(question) {
   });
 }
 
+function isValidKeyFormat(key) {
+  if (!key || typeof key !== "string") return false;
+  return key.length >= 20 && /^[a-zA-Z0-9_-]+$/.test(key);
+}
+
 async function runLogin(args) {
-  if (args.includes("--help") || args.includes("-h")) {
+  const { flags } = parseGlobalFlags(args);
+  const quiet = shouldSuppressOutput(flags);
+  const json = isJsonMode(flags);
+  
+  if (flags.help) {
     console.log(`
-  ${c.bold}vibecheck login${c.reset} - Authenticate with API key
+  ${ansi.bold}USAGE${ansi.reset}
+    ${ansi.cyan}vibecheck login${ansi.reset} [options]
 
-  ${c.bold}Usage:${c.reset}
-    vibecheck login
+  ${ansi.dim}Aliases: auth, signin${ansi.reset}
 
-  ${c.bold}Description:${c.reset}
-    Authenticate with your Vibecheck API key.
-    Get your API key from https://vibecheckai.dev/settings/keys
+  Authenticate with your Vibecheck API key to unlock paid features
+  and sync with the dashboard.
 
-  ${c.bold}Options:${c.reset}
-    ${c.cyan}--help, -h${c.reset}         Show this help
+  ${ansi.bold}OPTIONS${ansi.reset}
+    ${ansi.cyan}--key <key>${ansi.reset}       Provide API key directly (non-interactive)
+    ${ansi.cyan}--json${ansi.reset}            Output result as JSON
+    ${ansi.cyan}--quiet, -q${ansi.reset}       Suppress non-essential output
+    ${ansi.cyan}--help, -h${ansi.reset}        Show this help
 
-  ${c.bold}Examples:${c.reset}
+  ${ansi.bold}EXAMPLES${ansi.reset}
+    ${ansi.dim}# Interactive login${ansi.reset}
     vibecheck login
+
+    ${ansi.dim}# Non-interactive (CI/scripts)${ansi.reset}
+    vibecheck login --key YOUR_API_KEY
+
+    ${ansi.dim}# Using environment variable${ansi.reset}
+    VIBECHECK_API_KEY=xxx vibecheck whoami
+
+  ${ansi.bold}GET YOUR API KEY${ansi.reset}
+    https://vibecheckai.dev/settings/keys
+
+  ${ansi.dim}────────────────────────────────────────────────────────────────────${ansi.reset}
+  ${ansi.dim}Documentation: https://docs.vibecheckai.dev/authentication${ansi.reset}
 `);
-    return 0;
+    return EXIT.SUCCESS;
   }
-  
-  console.log("\n  🔐 vibecheck LOGIN\n");
 
-  const existing = getApiKey();
-  if (existing.key) {
-    console.log(`  Already logged in (source: ${existing.source}).`);
-    const answer = await prompt("  Do you want to overwrite? (y/N) ");
-    if (answer.toLowerCase() !== "y") {
-      console.log("  Cancelled.");
-      return 0;
+  try {
+    let key = null;
+    const keyIndex = args.indexOf("--key");
+    if (keyIndex !== -1 && args[keyIndex + 1]) {
+      key = args[keyIndex + 1];
+    }
+    
+    if (!quiet && !json) {
+      renderMinimalHeader("login", "free");
     }
-  }
 
-  console.log(
-    "  Paste your API key from https://vibecheckai.dev/settings/keys",
-  );
-  const key = await prompt("  API Key: ");
+    const existing = getApiKey();
+    if (existing.key && !key) {
+      if (!quiet && !json) {
+        renderWarning(`Already logged in (source: ${existing.source})`);
+      }
+      
+      if (process.env.CI || !process.stdin.isTTY) {
+        if (json) {
+          console.log(JSON.stringify({ success: true, message: "Already logged in", source: existing.source }));
+        }
+        return EXIT.SUCCESS;
+      }
+      
+      const answer = await prompt(`  Overwrite existing credentials? (y/N) `);
+      if (answer.toLowerCase() !== "y") {
+        if (!quiet && !json) console.log(`  ${ansi.dim}Cancelled.${ansi.reset}\n`);
+        if (json) console.log(JSON.stringify({ success: false, message: "Cancelled by user" }));
+        return EXIT.SUCCESS;
+      }
+    }
 
-  if (!key) {
-    console.error("  ❌ No key provided.");
-    return 1;
-  }
+    if (!key) {
+      if (process.env.CI || !process.stdin.isTTY) {
+        const errorMsg = "No API key provided. Use --key flag or set VIBECHECK_API_KEY environment variable.";
+        if (json) {
+          console.log(JSON.stringify({ success: false, error: errorMsg }));
+        } else {
+          renderError(errorMsg);
+        }
+        return EXIT.USER_ERROR;
+      }
+      
+      if (!quiet && !json) {
+        console.log(`  ${ansi.dim}Get your API key at: https://vibecheckai.dev/settings/keys${ansi.reset}\n`);
+      }
+      key = await prompt(`  ${sym.key} API Key: `);
+    }
 
-  // Validate key by fetching entitlements
-  console.log("  Verifying...");
-  const entitlements = await getEntitlements(key);
+    if (!key) {
+      if (json) {
+        console.log(JSON.stringify({ success: false, error: "No API key provided" }));
+      } else {
+        renderError("No API key provided");
+      }
+      return EXIT.USER_ERROR;
+    }
 
-  if (
-    !entitlements ||
-    (entitlements.plan === "free" && !key.startsWith("gr_"))
-  ) {
-    // If mocking, we might accept anything, but let's pretend valid keys start with gr_
-    // For now, since it's a mock, we just check if we got entitlements back.
-  }
+    if (!isValidKeyFormat(key)) {
+      if (json) {
+        console.log(JSON.stringify({ success: false, error: "Invalid API key format" }));
+      } else {
+        renderError("Invalid API key format");
+        console.log(`  ${ansi.dim}API keys should be at least 20 characters.${ansi.reset}`);
+      }
+      return EXIT.USER_ERROR;
+    }
+
+    const spinner = !quiet && !json ? new Spinner("Verifying API key").start() : null;
+    
+    let entitlements;
+    try {
+      entitlements = await getEntitlements(key);
+    } catch (apiError) {
+      spinner?.fail(`Failed to verify: ${apiError.message}`);
+      if (json) {
+        console.log(JSON.stringify({ success: false, error: apiError.message }));
+      }
+      return EXIT.NETWORK_ERROR;
+    }
+
+    if (!entitlements) {
+      spinner?.fail("Invalid API key or server unreachable");
+      if (json) {
+        console.log(JSON.stringify({ success: false, error: "Invalid API key" }));
+      }
+      return EXIT.AUTH_FAILED;
+    }
 
-  saveApiKey(key);
-  console.log(
-    `  ✅ Successfully logged in as ${entitlements?.user?.name || "User"}`,
-  );
-  console.log(`  Plan: ${entitlements?.plan || "Free"}`);
+    saveApiKey(key);
+    
+    const result = {
+      success: true,
+      user: entitlements?.user?.name || "User",
+      plan: entitlements?.plan || "free",
+    };
+    
+    if (json) {
+      console.log(JSON.stringify(result));
+    } else if (!quiet) {
+      spinner?.succeed(`Logged in as ${ansi.bold}${result.user}${ansi.reset}`);
+      console.log(`  ${ansi.dim}Plan:${ansi.reset} ${getTierBadge(result.plan)}\n`);
+    }
 
-  return 0;
+    return EXIT.SUCCESS;
+  } catch (error) {
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: error.message }));
+    } else {
+      renderError(`Login failed: ${error.message}`);
+    }
+    return EXIT.INTERNAL_ERROR;
+  }
 }
 
 async function runLogout(args) {
-  console.log("\n  🔓 vibecheck LOGOUT\n");
-  deleteApiKey();
-  console.log("  ✅ API key removed from local config.");
-  return 0;
+  const { flags } = parseGlobalFlags(args);
+  const quiet = shouldSuppressOutput(flags);
+  const json = isJsonMode(flags);
+  
+  if (flags.help) {
+    console.log(`
+  ${ansi.bold}USAGE${ansi.reset}
+    ${ansi.cyan}vibecheck logout${ansi.reset}
+
+  ${ansi.dim}Aliases: signout${ansi.reset}
+
+  Remove stored API credentials from local config.
+
+  ${ansi.bold}OPTIONS${ansi.reset}
+    ${ansi.cyan}--json${ansi.reset}            Output result as JSON
+    ${ansi.cyan}--quiet, -q${ansi.reset}       Suppress non-essential output
+    ${ansi.cyan}--help, -h${ansi.reset}        Show this help
+`);
+    return EXIT.SUCCESS;
+  }
+  
+  try {
+    if (!quiet && !json) {
+      renderMinimalHeader("logout", "free");
+    }
+    
+    deleteApiKey();
+    
+    if (json) {
+      console.log(JSON.stringify({ success: true, message: "Logged out" }));
+    } else if (!quiet) {
+      renderSuccess("API key removed from local config");
+      console.log();
+    }
+    
+    return EXIT.SUCCESS;
+  } catch (error) {
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: error.message }));
+    } else {
+      renderError(`Logout failed: ${error.message}`);
+    }
+    return EXIT.INTERNAL_ERROR;
+  }
 }
 
 async function runWhoami(args) {
-  if (args.includes("--help") || args.includes("-h")) {
+  const { flags } = parseGlobalFlags(args);
+  const quiet = shouldSuppressOutput(flags);
+  const json = isJsonMode(flags);
+  
+  if (flags.help) {
     console.log(`
-  ${c.bold}vibecheck whoami${c.reset} - Show current user and plan
+  ${ansi.bold}USAGE${ansi.reset}
+    ${ansi.cyan}vibecheck whoami${ansi.reset}
 
-  ${c.bold}Usage:${c.reset}
-    vibecheck whoami
+  ${ansi.dim}Aliases: me, user${ansi.reset}
 
-  ${c.bold}Description:${c.reset}
-    Display information about the currently authenticated user,
-    including plan, limits, and scopes.
+  Display information about the currently authenticated user,
+  including plan, limits, and available scopes.
 
-  ${c.bold}Options:${c.reset}
-    ${c.cyan}--help, -h${c.reset}         Show this help
+  ${ansi.bold}OPTIONS${ansi.reset}
+    ${ansi.cyan}--json${ansi.reset}            Output result as JSON
+    ${ansi.cyan}--quiet, -q${ansi.reset}       Suppress non-essential output
+    ${ansi.cyan}--help, -h${ansi.reset}        Show this help
 
-  ${c.bold}Examples:${c.reset}
+  ${ansi.bold}EXAMPLES${ansi.reset}
+    ${ansi.dim}# Check current user${ansi.reset}
     vibecheck whoami
+
+    ${ansi.dim}# Get JSON for scripts${ansi.reset}
+    vibecheck whoami --json
 `);
-    return 0;
+    return EXIT.SUCCESS;
   }
-  
-  console.log("\n  👤 vibecheck WHOAMI\n");
 
-  const { key, source } = getApiKey();
+  try {
+    if (!quiet && !json) {
+      renderMinimalHeader("whoami", "free");
+    }
 
-  if (!key) {
-    console.log("  Not logged in.");
-    console.log('  Run "vibecheck login" or set VIBECHECK_API_KEY.');
-    return 1;
-  }
+    const { key, source } = getApiKey();
 
-  console.log(
-    `  Source: ${source === "env" ? "Environment Variable" : "Local Config"}`,
-  );
+    if (!key) {
+      const result = { authenticated: false, message: "Not logged in" };
+      
+      if (json) {
+        console.log(JSON.stringify(result));
+      } else {
+        renderWarning("Not logged in");
+        console.log(`  ${ansi.dim}Run "vibecheck login" or set VIBECHECK_API_KEY.${ansi.reset}\n`);
+      }
+      return EXIT.AUTH_REQUIRED;
+    }
 
-  const entitlements = await getEntitlements(key);
-  if (!entitlements) {
-    console.log("  ⚠️  Invalid API Key or server unreachable.");
-    return 1;
-  }
+    const spinner = !quiet && !json ? new Spinner("Fetching user info").start() : null;
 
-  console.log(`  User:   ${entitlements.user.name} (${entitlements.user.id})`);
-  console.log(`  Plan:   ${entitlements.plan.toUpperCase()}`);
-  console.log(`  Limits: ${entitlements.limits.runsPerMonth} runs/month`);
-  console.log("");
-  console.log("  Scopes:");
-  entitlements.scopes.forEach((s) => console.log(`   - ${s}`));
-  console.log("");
+    let entitlements;
+    try {
+      entitlements = await getEntitlements(key);
+    } catch (apiError) {
+      spinner?.fail(`Failed to fetch: ${apiError.message}`);
+      if (json) {
+        console.log(JSON.stringify({ authenticated: true, error: apiError.message }));
+      }
+      return EXIT.NETWORK_ERROR;
+    }
+    
+    if (!entitlements) {
+      spinner?.fail("Invalid API key or server unreachable");
+      if (json) {
+        console.log(JSON.stringify({ authenticated: false, error: "Invalid API key" }));
+      } else {
+        console.log(`  ${ansi.dim}Run "vibecheck login" to re-authenticate.${ansi.reset}\n`);
+      }
+      return EXIT.AUTH_FAILED;
+    }
 
-  return 0;
+    spinner?.stop(null, null, null); // Clear spinner without message
+
+    const result = {
+      authenticated: true,
+      source: source === "env" ? "environment" : "config",
+      user: {
+        name: entitlements.user?.name,
+        id: entitlements.user?.id,
+      },
+      plan: entitlements.plan,
+      limits: entitlements.limits,
+      scopes: entitlements.scopes,
+    };
+
+    if (json) {
+      console.log(JSON.stringify(result, null, 2));
+    } else if (!quiet) {
+      renderSectionHeader("Account", sym.key);
+      
+      renderKeyValue([
+        { label: "User", value: `${ansi.bold}${result.user.name}${ansi.reset} ${ansi.dim}(${result.user.id})${ansi.reset}` },
+        { label: "Plan", value: getTierBadge(result.plan) },
+        { label: "Source", value: source === "env" ? "Environment Variable" : "Local Config" },
+        { label: "Limits", value: `${result.limits?.runsPerMonth || "unlimited"} runs/month` },
+      ]);
+      
+      if (result.scopes && result.scopes.length > 0) {
+        console.log();
+        console.log(`  ${ansi.dim}Scopes:${ansi.reset}`);
+        result.scopes.forEach(s => console.log(`    ${ansi.gray}${sym.bullet}${ansi.reset} ${s}`));
+      }
+      
+      // Tier-specific upsell
+      if (result.plan === "free") {
+        renderFooter({
+          nextSteps: [
+            { cmd: "vibecheck scan", desc: "analyze your codebase" },
+          ],
+          showUpsell: true,
+        });
+      } else if (result.plan === "starter") {
+        console.log();
+        console.log(`  ${ansi.dim}${sym.star}${ansi.reset} ${ansi.magenta}PRO${ansi.reset}${ansi.dim}: proof loops + badge generation + priority support${ansi.reset}`);
+        console.log(`  ${ansi.dim}  Upgrade ${sym.arrow} https://vibecheckai.dev${ansi.reset}\n`);
+      } else {
+        console.log();
+      }
+    }
+
+    return EXIT.SUCCESS;
+  } catch (error) {
+    if (json) {
+      console.log(JSON.stringify({ authenticated: false, error: error.message }));
+    } else {
+      renderError(`Whoami failed: ${error.message}`);
+    }
+    return EXIT.INTERNAL_ERROR;
+  }
 }
 
 module.exports = { runLogin, runLogout, runWhoami };

package/bin/runners/runCheckpoint.js

@@ -13,7 +13,8 @@
 const fs = require("fs");
 const path = require("path");
 const entitlements = require("./lib/entitlements-v2");
-const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
+const { parseGlobalFlags, shouldShowBanner, shouldSuppressOutput, isJsonMode } = require("./lib/global-flags");
+const { EXIT } = require("./lib/exit-codes");
 
 // ═══════════════════════════════════════════════════════════════════════════════
 // TERMINAL STYLING
@@ -284,13 +285,25 @@ ${c.bold}TIER${c.reset}
 
 async function runCheckpoint(args) {
   const opts = parseArgs(args);
+  const quiet = shouldSuppressOutput(opts);
+  const json = isJsonMode(opts) || opts.json;
   
   if (opts.help) {
     printHelp(shouldShowBanner(opts));
-    return 0;
+    return EXIT.SUCCESS;
   }
   
   const projectPath = path.resolve(opts.path);
+  
+  // Validate project path exists
+  if (!fs.existsSync(projectPath)) {
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: `Project path does not exist: ${projectPath}` }));
+    } else {
+      console.error(`${c.red}${icons.cross}${c.reset} Project path does not exist: ${projectPath}`);
+    }
+    return EXIT.NOT_FOUND;
+  }
   const vibecheckDir = path.join(projectPath, '.vibecheck');
   const resultsDir = path.join(vibecheckDir, 'results');
   const checkpointsDir = path.join(vibecheckDir, 'checkpoints');
@@ -316,17 +329,17 @@ async function runCheckpoint(args) {
   }
   
   if (!baseline) {
-    console.log(`\n${c.yellow}${icons.warning}${c.reset} No baseline found.`);
-    console.log(`${c.dim}Run 'vibecheck scan' first to create a baseline.${c.reset}`);
-    console.log(`${c.dim}Or specify --baseline <file> to use a specific file.${c.reset}\n`);
-    
-    if (!opts.json) {
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: "No baseline found" }));
+    } else if (!quiet) {
+      console.log(`\n${c.yellow}${icons.warning}${c.reset} No baseline found.`);
+      console.log(`${c.dim}Run 'vibecheck scan' first to create a baseline.${c.reset}`);
+      console.log(`${c.dim}Or specify --baseline <file> to use a specific file.${c.reset}\n`);
       console.log(`${c.bold}TIP:${c.reset} Create a baseline with:`);
       console.log(`  ${c.cyan}vibecheck scan${c.reset}`);
       console.log(`  ${c.cyan}cp .vibecheck/results/latest.json .vibecheck/results/baseline.json${c.reset}\n`);
     }
-    
-    return 1;
+    return EXIT.NOT_FOUND;
   }
   
   // Load current
@@ -340,9 +353,13 @@ async function runCheckpoint(args) {
   }
   
   if (!current) {
-    console.log(`\n${c.yellow}${icons.warning}${c.reset} No current results found.`);
-    console.log(`${c.dim}Run 'vibecheck scan' to generate current results.${c.reset}\n`);
-    return 1;
+    if (json) {
+      console.log(JSON.stringify({ success: false, error: "No current results found" }));
+    } else if (!quiet) {
+      console.log(`\n${c.yellow}${icons.warning}${c.reset} No current results found.`);
+      console.log(`${c.dim}Run 'vibecheck scan' to generate current results.${c.reset}\n`);
+    }
+    return EXIT.NOT_FOUND;
   }
   
   // Extract findings arrays
@@ -408,18 +425,17 @@ async function runCheckpoint(args) {
       if (comparison.regressions.length > 3) {
         console.log(`  ${c.dim}... and ${comparison.regressions.length - 3} more${c.reset}`);
       }
-      return 1;
+      return EXIT.BLOCKING;
     } else {
       console.log(`${c.green}${icons.check}${c.reset} Checkpoint passed (${checkpoint.summary.fixed} fixed, ${checkpoint.summary.remaining} remaining)`);
-      return 0;
+      return EXIT.SUCCESS;
     }
   }
   
   // JSON output
   if (opts.json) {
     console.log(JSON.stringify(checkpoint, null, 2));
-    const exitCode = opts.gate && checkpoint.summary.regressions > 0 ? 1 : 0;
-    return exitCode;
+    return opts.gate && checkpoint.summary.regressions > 0 ? EXIT.BLOCKING : EXIT.SUCCESS;
   }
   
   // Human-readable output
@@ -531,14 +547,16 @@ ${c.bold}╔══════════════════════
   console.log();
   
   // Return code:
-  // - With --gate: 1 if regressions, 0 otherwise
-  // - Without --gate: always 0 (informational only)
+  // - With --gate: BLOCKING (2) if regressions, SUCCESS otherwise
+  // - Without --gate: always SUCCESS (informational only)
   if (opts.gate && comparison.regressions.length > 0) {
-    console.log(`${c.yellow}${icons.warning} Gate mode: Exiting with code 1 due to regressions${c.reset}\n`);
-    return 1;
+    if (!quiet) {
+      console.log(`${c.yellow}${icons.warning} Gate mode: Exiting with code 2 due to regressions${c.reset}\n`);
+    }
+    return EXIT.BLOCKING;
   }
   
-  return 0;
+  return EXIT.SUCCESS;
 }
 
 module.exports = { runCheckpoint };