@vibecheckai/cli 3.1.5 → 3.1.6

package/bin/runners/runPermissions.js

@@ -20,6 +20,7 @@ const {
   buildIDORTestPlan,
   formatIDORPlan
 } = require("./lib/permissions");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 
 // Entitlements enforcement
 const entitlements = require("./lib/entitlements-v2");
@@ -43,7 +44,7 @@ async function runPermissions(args) {
   const opts = parseArgs(args);
 
   if (opts.help) {
-    printHelp();
+    printHelp(shouldShowBanner(opts));
     return 0;
   }
 
@@ -225,8 +226,12 @@ async function runPermissions(args) {
 }
 
 function parseArgs(args) {
+  // Parse global flags first
+  const { flags: globalFlags, cleanArgs } = parseGlobalFlags(args);
+  
   const opts = {
-    path: process.cwd(),
+    ...globalFlags, // Merge global flags (json, verbose, noBanner, quiet, ci, etc.)
+    path: globalFlags.path || process.cwd(),
     url: null,
     learn: false,
     prove: false,
@@ -237,16 +242,17 @@ function parseArgs(args) {
     help: false,
   };
 
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
+  // Parse command-specific args from cleanArgs
+  for (let i = 0; i < cleanArgs.length; i++) {
+    const arg = cleanArgs[i];
     if (arg === "--learn") opts.learn = true;
     else if (arg === "--prove") opts.prove = true;
     else if (arg === "--matrix") opts.matrix = true;
     else if (arg === "--idor") opts.idor = true;
     else if (arg === "--safe") opts.safe = true;
-    else if (arg === "--url") opts.url = args[++i];
-    else if (arg === "--fastify-entry") opts.fastifyEntry = args[++i];
-    else if (arg === "--path" || arg === "-p") opts.path = args[++i];
+    else if (arg === "--url") opts.url = cleanArgs[++i];
+    else if (arg === "--fastify-entry") opts.fastifyEntry = cleanArgs[++i];
+    else if (arg === "--path" || arg === "-p") opts.path = cleanArgs[++i];
     else if (arg === "--help" || arg === "-h") opts.help = true;
   }
 

package/bin/runners/runProve.js

@@ -30,6 +30,7 @@ const {
   verdictToExitCode,
   saveArtifact 
 } = require("./lib/cli-output");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 
 let runReality;
 try {
@@ -667,8 +668,10 @@ function printTimelineSummary(timeline) {
 // HELP DISPLAY
 // ═══════════════════════════════════════════════════════════════════════════════
 
-function printHelp() {
-  console.log(BANNER_FULL);
+function printHelp(showBanner = true) {
+  if (showBanner && shouldShowBanner({})) {
+    console.log(BANNER_FULL);
+  }
   console.log(`
   ${c.bold}Usage:${c.reset} vibecheck prove [options]
 
@@ -738,30 +741,33 @@ async function runProve(argsOrOpts = {}, context = {}) {
   
   // Handle array args from CLI
   if (Array.isArray(argsOrOpts)) {
-    if (argsOrOpts.includes("--help") || argsOrOpts.includes("-h")) {
-      printHelp();
+    // Parse global flags first
+    const { flags: globalFlags, cleanArgs } = parseGlobalFlags(argsOrOpts);
+    
+    if (globalFlags.help) {
+      printHelp(shouldShowBanner(globalFlags));
       return 0;
     }
+    
     const getArg = (flags) => {
       for (const f of flags) {
-        const idx = argsOrOpts.indexOf(f);
-        if (idx !== -1 && idx < argsOrOpts.length - 1) return argsOrOpts[idx + 1];
+        const idx = cleanArgs.indexOf(f);
+        if (idx !== -1 && idx < cleanArgs.length - 1) return cleanArgs[idx + 1];
       }
       return undefined;
     };
     argsOrOpts = {
+      ...globalFlags, // Merge global flags (json, verbose, noBanner, quiet, ci, etc.)
       url: getArg(["--url", "-u"]),
       auth: getArg(["--auth"]),
       storageState: getArg(["--storage-state"]),
       fastifyEntry: getArg(["--fastify-entry"]),
       maxFixRounds: parseInt(getArg(["--max-fix-rounds"]) || "3", 10),
-      skipReality: argsOrOpts.includes("--skip-reality"),
-      skipFix: argsOrOpts.includes("--skip-fix"),
-      headed: argsOrOpts.includes("--headed"),
-      danger: argsOrOpts.includes("--danger"),
-      json: argsOrOpts.includes("--json"),
+      skipReality: cleanArgs.includes("--skip-reality"),
+      skipFix: cleanArgs.includes("--skip-fix"),
+      headed: cleanArgs.includes("--headed"),
+      danger: cleanArgs.includes("--danger"),
       output: getArg(["--output", "-o"]),
-      ci: argsOrOpts.includes("--ci"),
     };
   }
 

package/bin/runners/runReport.js

@@ -17,6 +17,7 @@
 
 const path = require("path");
 const fs = require("fs");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 
 // Entitlements enforcement
 let entitlements;
@@ -72,11 +73,14 @@ const {
 } = require("./lib/report-output");
 
 function parseArgs(args) {
+  // Parse global flags first
+  const { flags: globalFlags, cleanArgs } = parseGlobalFlags(args);
+  
   const opts = {
     type: "technical",
     format: "html",
-    path: ".",
-    output: null,
+    path: globalFlags.path || ".",
+    output: globalFlags.output || null,
     logo: null,
     company: null,
     theme: "dark",
@@ -86,18 +90,23 @@ function parseArgs(args) {
     redactPaths: false,
     maxFindings: 50,
     open: false,
-    help: false,
-    quiet: false,
+    help: globalFlags.help || false,
+    quiet: globalFlags.quiet || false,
+    json: globalFlags.json || false,
+    noBanner: globalFlags.noBanner || false,
+    ci: globalFlags.ci || false,
+    verbose: globalFlags.verbose || false,
   };
 
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
-    if (a === "--type" || a === "-t") opts.type = args[++i];
-    if (a === "--format" || a === "-f") opts.format = args[++i];
-    if (a === "--output" || a === "-o") opts.output = args[++i];
-    if (a === "--logo") opts.logo = args[++i];
-    if (a === "--company") opts.company = args[++i];
-    if (a === "--theme") opts.theme = args[++i];
+  // Parse command-specific args
+  for (let i = 0; i < cleanArgs.length; i++) {
+    const a = cleanArgs[i];
+    if (a === "--type" || a === "-t") opts.type = cleanArgs[++i];
+    if (a === "--format" || a === "-f") opts.format = cleanArgs[++i];
+    if (a === "--output" || a === "-o") opts.output = cleanArgs[++i];
+    if (a === "--logo") opts.logo = cleanArgs[++i];
+    if (a === "--company") opts.company = cleanArgs[++i];
+    if (a === "--theme") opts.theme = cleanArgs[++i];
     if (a === "--framework") opts.framework = args[++i];
     if (a === "--light") opts.theme = "light";
     if (a === "--dark") opts.theme = "dark";
@@ -115,8 +124,10 @@ function parseArgs(args) {
   return opts;
 }
 
-function printHelp() {
-  console.log(BANNER);
+function printHelp(showBanner = true) {
+  if (showBanner && shouldShowBanner({})) {
+    console.log(BANNER);
+  }
   console.log(formatHelp());
 }
 
@@ -124,7 +135,7 @@ async function runReport(args) {
   const opts = parseArgs(args);
 
   if (opts.help) {
-    printHelp();
+    printHelp(shouldShowBanner(opts));
     return 0;
   }
 
@@ -179,9 +190,11 @@ async function runReport(args) {
 
   // Display banner and report info
   if (!opts.quiet) {
-    console.log(BANNER);
-    console.log(renderReportInfo(opts.type, opts.format, null));
-    console.log('');
+    if (shouldShowBanner(opts)) {
+      console.log(BANNER);
+      console.log(renderReportInfo(opts.type, opts.format, null));
+      console.log('');
+    }
   }
 
   // Progress spinner

package/bin/runners/runScan.js

@@ -17,6 +17,7 @@ const fs = require("fs");
 const { withErrorHandling, createUserError } = require("./lib/error-handler");
 const { enforceLimit, trackUsage } = require("./lib/entitlements");
 const { emitScanStart, emitScanComplete } = require("./lib/audit-bridge");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 
 // ═══════════════════════════════════════════════════════════════════════════════
 // ENHANCED TERMINAL UI & OUTPUT MODULES
@@ -84,34 +85,38 @@ function printLayers(layers) {
 // ═══════════════════════════════════════════════════════════════════════════════
 
 function parseArgs(args) {
+  // Parse global flags first
+  const { flags: globalFlags, cleanArgs } = parseGlobalFlags(args);
+  
   const opts = {
-    path: process.cwd(),
+    path: globalFlags.path || process.cwd(),
     truth: false,
     reality: false,
     realitySniff: false,
     baseUrl: null,
-    json: false,
+    json: globalFlags.json || false,
     sarif: false,
-    verbose: false,
-    help: false,
+    verbose: globalFlags.verbose || false,
+    help: globalFlags.help || false,
     autofix: false,
     save: true, // Always save results by default
+    noBanner: globalFlags.noBanner || false,
+    ci: globalFlags.ci || false,
+    quiet: globalFlags.quiet || false,
   };
 
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
+  // Parse command-specific args from cleanArgs
+  for (let i = 0; i < cleanArgs.length; i++) {
+    const arg = cleanArgs[i];
     
     if (arg === '--truth' || arg === '-t') opts.truth = true;
     else if (arg === '--reality' || arg === '-r') { opts.reality = true; opts.truth = true; }
     else if (arg === '--reality-sniff' || arg === '--sniff') opts.realitySniff = true;
-    else if (arg === '--url' || arg === '-u') { opts.baseUrl = args[++i]; opts.reality = true; opts.truth = true; }
-    else if (arg === '--json') opts.json = true;
+    else if (arg === '--url' || arg === '-u') { opts.baseUrl = cleanArgs[++i]; opts.reality = true; opts.truth = true; }
     else if (arg === '--sarif') opts.sarif = true;
-    else if (arg === '--verbose' || arg === '-v') opts.verbose = true;
-    else if (arg === '--help' || arg === '-h') opts.help = true;
     else if (arg === '--autofix' || arg === '--fix' || arg === '-f') opts.autofix = true;
     else if (arg === '--no-save') opts.save = false;
-    else if (arg === '--path' || arg === '-p') opts.path = args[++i];
+    else if (arg === '--path' || arg === '-p') opts.path = cleanArgs[++i] || process.cwd();
     else if (arg.startsWith('--path=')) opts.path = arg.split('=')[1];
     else if (!arg.startsWith('-')) opts.path = path.resolve(arg);
   }
@@ -119,10 +124,14 @@ function parseArgs(args) {
   return opts;
 }
 
-function printHelp() {
-  console.log(BANNER);
+function printHelp(showBanner = true) {
+  if (showBanner && shouldShowBanner({})) {
+    console.log(BANNER);
+  }
   console.log(`
-  ${ansi.bold}Usage:${ansi.reset} vibecheck scan [path] [options]
+  ${ansi.bold}Usage:${ansi.reset} vibecheck scan ${ansi.dim}(s)${ansi.reset} [path] [options]
+  
+  ${ansi.bold}Aliases:${ansi.reset} ${ansi.dim}s${ansi.reset}
 
   ${ansi.bold}Scan Modes:${ansi.reset}
     ${colors.accent}(default)${ansi.reset}       Layer 1: AST static analysis ${ansi.dim}(fast)${ansi.reset}
@@ -440,7 +449,7 @@ async function runScan(args) {
 
   // Show help if requested
   if (opts.help) {
-    printHelp();
+    printHelp(shouldShowBanner(opts));
     return 0;
   }
 
@@ -463,8 +472,10 @@ async function runScan(args) {
     }
   }
 
-  // Print banner
-  printBanner();
+  // Print banner (respects --no-banner, VIBECHECK_NO_BANNER, --ci, --quiet, --json)
+  if (shouldShowBanner(opts)) {
+    printBanner();
+  }
 
   const projectPath = path.resolve(opts.path);
   const startTime = Date.now();

package/bin/runners/runShip.js

@@ -13,6 +13,7 @@ const { withErrorHandling } = require("./lib/error-handler");
 const { ensureOutputDir, detectProjectFeatures } = require("./utils");
 const { enforceLimit, enforceFeature, trackUsage, getCurrentTier } = require("./lib/entitlements");
 const { emitShipCheck } = require("./lib/audit-bridge");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 const { 
   generateRunId, 
   createJsonOutput, 
@@ -607,10 +608,14 @@ function printFixResults(fixResults) {
 // HELP DISPLAY
 // ═══════════════════════════════════════════════════════════════════════════════
 
-function printHelp() {
-  console.log(BANNER);
+function printHelp(showBanner = true) {
+  if (showBanner && shouldShowBanner({})) {
+    console.log(BANNER);
+  }
   console.log(`
-  ${ansi.bold}Usage:${ansi.reset} vibecheck ship [options]
+  ${ansi.bold}Usage:${ansi.reset} vibecheck ship ${ansi.dim}(go)${ansi.reset} [options]
+  
+  ${ansi.bold}Aliases:${ansi.reset} ${ansi.dim}go${ansi.reset}
 
   ${ansi.bold}The One Command${ansi.reset} — Get a ship verdict: ${colors.success}SHIP${ansi.reset} | ${colors.warning}WARN${ansi.reset} | ${colors.error}BLOCK${ansi.reset}
 
@@ -754,35 +759,36 @@ function getGapType(category) {
 // ═══════════════════════════════════════════════════════════════════════════════
 
 function parseArgs(args) {
+  // Parse global flags first
+  const { flags: globalFlags, cleanArgs } = parseGlobalFlags(args);
+  
   const opts = { 
     fix: false, 
-    path: ".", 
-    verbose: false, 
-    json: false,
+    path: globalFlags.path || ".", 
+    verbose: globalFlags.verbose || false, 
+    json: globalFlags.json || false,
     badge: false,
     assist: false,
-    strict: false,
-    ci: false,
+    strict: globalFlags.strict || false,
+    ci: globalFlags.ci || false,
     mode: null, // "scan" for scan mode
     withRuntime: false, // merge runtime results
-    help: false,
+    help: globalFlags.help || false,
+    noBanner: globalFlags.noBanner || false,
+    quiet: globalFlags.quiet || false,
   };
   
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
+  // Parse command-specific args
+  for (let i = 0; i < cleanArgs.length; i++) {
+    const a = cleanArgs[i];
     if (a === "--fix" || a === "-f") opts.fix = true;
-    else if (a === "--verbose" || a === "-v") opts.verbose = true;
-    else if (a === "--json") opts.json = true;
     else if (a === "--badge" || a === "-b") opts.badge = true;
     else if (a === "--assist") opts.assist = true;
-    else if (a === "--strict") opts.strict = true;
-    else if (a === "--ci") opts.ci = true;
-    else if (a === "--mode") opts.mode = args[++i];
+    else if (a === "--mode") opts.mode = cleanArgs[++i];
     else if (a === "--with") {
-      const next = args[++i];
+      const next = cleanArgs[++i];
       if (next === "runtime") opts.withRuntime = true;
     }
-    else if (a === "--help" || a === "-h") opts.help = true;
     else if (a.startsWith("--path=")) opts.path = a.split("=")[1];
     else if (a === "--path" || a === "-p") opts.path = args[++i];
   }
@@ -804,7 +810,7 @@ async function runShip(args, context = {}) {
 
   // Show help if requested
   if (opts.help) {
-    printHelp();
+    printHelp(shouldShowBanner(opts));
     return 0;
   }
 
@@ -829,8 +835,8 @@ async function runShip(args, context = {}) {
   const outputDir = path.join(projectPath, ".vibecheck");
   const projectName = path.basename(projectPath);
 
-  // Print banner (unless quiet/json/ci)
-  if (!opts.json && !opts.ci) {
+  // Print banner (respects --no-banner, VIBECHECK_NO_BANNER, --ci, --quiet, --json)
+  if (shouldShowBanner(opts)) {
     printBanner();
     console.log(`  ${ansi.dim}Project:${ansi.reset}  ${ansi.bold}${projectName}${ansi.reset}`);
     console.log(`  ${ansi.dim}Path:${ansi.reset}     ${projectPath}`);

package/bin/runners/runStatus.js

@@ -14,6 +14,7 @@
 const fs = require("fs");
 const path = require("path");
 const { formatStatusOutput } = require("./lib/status-output");
+const { parseGlobalFlags } = require("./lib/global-flags");
 
 function readJsonSafe(p) {
   try {
@@ -24,7 +25,22 @@ function readJsonSafe(p) {
   }
 }
 
-async function runStatus({ repoRoot, json = false } = {}) {
+async function runStatus(args = []) {
+  // Parse global flags
+  const { flags: globalFlags, cleanArgs } = parseGlobalFlags(args);
+  
+  // Support both old API ({ repoRoot, json }) and new API (args array)
+  let repoRoot, json;
+  if (typeof args === 'object' && !Array.isArray(args) && args.repoRoot !== undefined) {
+    // Old API compatibility
+    repoRoot = args.repoRoot;
+    json = args.json || false;
+  } else {
+    // New API - parse from args
+    repoRoot = globalFlags.path || process.cwd();
+    json = globalFlags.json || false;
+  }
+  
   const root = repoRoot || process.cwd();
   
   // Gather data