@vibecheckai/cli 3.1.6 → 3.1.8

package/bin/runners/runInit.js

@@ -11,6 +11,7 @@
 
 const fs = require("fs");
 const path = require("path");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 
 // Use enhanced wizard if available
 let InitWizard;
@@ -1100,8 +1101,10 @@ function printComplianceInfo(complianceType) {
 // 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 init [mode] [options]
 
@@ -1176,13 +1179,19 @@ function printHelp() {
 // ═══════════════════════════════════════════════════════════════════════════════
 
 function parseArgs(args) {
+  // Parse global flags first
+  const { flags: globalFlags, cleanArgs } = parseGlobalFlags(args);
+  
   const out = {
-    path: ".",
+    path: globalFlags.path || ".",
     gitHooks: false,
-    help: false,
+    help: globalFlags.help || false,
     quick: false,
-    json: false,
-    verbose: false,
+    json: globalFlags.json || false,
+    verbose: globalFlags.verbose || false,
+    noBanner: globalFlags.noBanner || false,
+    ci: globalFlags.ci || false,
+    quiet: globalFlags.quiet || false,
     // Mode flags (--local is default, --connect requires STARTER)
     local: false,
     connect: false,
@@ -1194,24 +1203,20 @@ function parseArgs(args) {
     verify: false,
     // Enterprise options
     enterprise: false,
-    ci: false,
     compliance: false,
     team: false,
     mcp: false,
-    strict: false,
+    strict: globalFlags.strict || false,
     failOnWarn: false,
     detect: false,
   };
 
-  for (let i = 0; i < args.length; i++) {
-    const a = args[i];
+  for (let i = 0; i < cleanArgs.length; i++) {
+    const a = cleanArgs[i];
     if (a.startsWith("--path=")) out.path = a.split("=")[1];
-    if (a === "--path" || a === "-p") out.path = args[++i];
+    if (a === "--path" || a === "-p") out.path = cleanArgs[++i];
     if (a === "--git-hooks") out.gitHooks = true;
-    if (a === "--help" || a === "-h") out.help = true;
     if (a === "--quick" || a === "-q") out.quick = true;
-    if (a === "--json") out.json = true;
-    if (a === "--verbose" || a === "-v") out.verbose = true;
     if (a === "--verify") out.verify = true;
     
     // Enhancement flags
@@ -1602,7 +1607,7 @@ async function runInit(args) {
   const opts = parseArgs(args);
   
   if (opts.help) {
-    printHelp();
+    printHelp(shouldShowBanner(opts));
     return 0;
   }
 
@@ -1621,7 +1626,7 @@ async function runInit(args) {
                         opts.team || opts.mcp || opts.detect;
   
   if (EnterpriseInit && useEnterprise && !opts.local && !opts.connect) {
-    if (!opts.json) {
+    if (shouldShowBanner(opts)) {
       printBanner();
       bannerPrinted = true;
       printEnterpriseHeader(opts);
@@ -1637,7 +1642,7 @@ async function runInit(args) {
 
   // Detect-only mode (quick detection report)
   if (opts.detect) {
-    if (!opts.json) {
+    if (shouldShowBanner(opts)) {
       printBanner();
       bannerPrinted = true;
       console.log(`  ${c.dim}Project:${c.reset}  ${c.bold}${projectName}${c.reset}`);
@@ -1669,8 +1674,9 @@ async function runInit(args) {
   
   // Interactive wizard mode
   if (opts.wizard && InitWizard) {
-    if (!opts.json && !bannerPrinted) {
+    if (shouldShowBanner(opts) && !bannerPrinted) {
       printBanner();
+      bannerPrinted = true;
     }
     const wizard = new InitWizard(targetDir, opts);
     return await wizard.run();
@@ -1678,7 +1684,7 @@ async function runInit(args) {
   
   // Repair mode - fix partial state
   if (opts.repair) {
-    if (!opts.json && !bannerPrinted) {
+    if (shouldShowBanner(opts) && !bannerPrinted) {
       printBanner();
       bannerPrinted = true;
       console.log(`  ${c.dim}Project:${c.reset}  ${c.bold}${projectName}${c.reset}`);
@@ -1690,7 +1696,7 @@ async function runInit(args) {
   }
   
   // Print banner only once (not already printed in enterprise/detect modes)
-  if (!opts.json && !bannerPrinted) {
+  if (shouldShowBanner(opts) && !bannerPrinted) {
     printBanner();
     bannerPrinted = true;
     

package/bin/runners/runInstall.js

@@ -8,6 +8,7 @@
 
 const fs = require("fs");
 const path = require("path");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 const { buildTruthpack, writeTruthpack } = require("./lib/truth");
 const { detectPackageManager, detectNext, detectFastify, detectFastifyEntry } = require("./lib/detect");
 const { readPkg, writePkg, upsertScripts } = require("./lib/pkgjson");
@@ -135,8 +136,10 @@ function printSection(title, icon = '◆') {
   printDivider();
 }
 
-function printHelp() {
-  console.log(BANNER_FULL);
+function printHelp(opts = {}) {
+  if (shouldShowBanner(opts)) {
+    console.log(BANNER_FULL);
+  }
   console.log(`
   ${c.bold}Usage:${c.reset} vibecheck install [options]
 
@@ -174,12 +177,15 @@ function ensureDir(p) {
 
 async function runInstall(argsOrContext = {}) {
   // Handle array args from CLI
+  let opts = { noBanner: false, json: false, quiet: false, ci: false };
   if (Array.isArray(argsOrContext)) {
-    if (argsOrContext.includes("--help") || argsOrContext.includes("-h")) {
-      printHelp();
+    const { flags } = parseGlobalFlags(argsOrContext);
+    opts = { ...opts, ...flags };
+    if (opts.help) {
+      printHelp(opts);
       return 0;
     }
-    argsOrContext = { repoRoot: process.cwd() };
+    argsOrContext = { repoRoot: opts.path || process.cwd() };
   }
   
   const { repoRoot } = argsOrContext;
@@ -187,7 +193,9 @@ async function runInstall(argsOrContext = {}) {
   const projectName = path.basename(root);
 
   // Print banner
-  console.log(BANNER_FULL);
+  if (shouldShowBanner(opts)) {
+    console.log(BANNER_FULL);
+  }
   console.log(`  ${c.dim}Project:${c.reset}  ${c.bold}${projectName}${c.reset}`);
   console.log(`  ${c.dim}Path:${c.reset}     ${root}`);
   console.log();

package/bin/runners/runReality.js

@@ -25,6 +25,7 @@
 const fs = require("fs");
 const path = require("path");
 const crypto = require("crypto");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 
 // Entitlements enforcement
 const entitlements = require("./lib/entitlements-v2");
@@ -612,8 +613,10 @@ function printTierWarning(tier, limits, originalMaxPages, appliedMaxPages, verif
 // HELP DISPLAY
 // ═══════════════════════════════════════════════════════════════════════════════
 
-function printHelp() {
-  console.log(BANNER_FULL);
+function printHelp(opts = {}) {
+  if (shouldShowBanner(opts)) {
+    console.log(BANNER_FULL);
+  }
   console.log(`
   ${c.bold}Usage:${c.reset} vibecheck reality --url <url> [options]
 
@@ -1027,9 +1030,12 @@ function coverageFromTruthpack({ truthpack, visitedUrls }) {
 
 async function runReality(argsOrOpts = {}) {
   // Handle array args from CLI
+  let globalOpts = { noBanner: false, json: false, quiet: false, ci: false };
   if (Array.isArray(argsOrOpts)) {
-    if (argsOrOpts.includes("--help") || argsOrOpts.includes("-h")) {
-      printHelp();
+    const { flags } = parseGlobalFlags(argsOrOpts);
+    globalOpts = { ...globalOpts, ...flags };
+    if (globalOpts.help) {
+      printHelp(globalOpts);
       return 0;
     }
     // Parse args to options
@@ -1052,6 +1058,7 @@ async function runReality(argsOrOpts = {}) {
       maxPages: parseInt(getArg(["--max-pages"]) || "18", 10),
       maxDepth: parseInt(getArg(["--max-depth"]) || "2", 10),
       timeoutMs: parseInt(getArg(["--timeout"]) || "15000", 10),
+      ...globalOpts,
     };
   }
 
@@ -1071,7 +1078,7 @@ async function runReality(argsOrOpts = {}) {
   } = argsOrOpts;
 
   if (!url) {
-    printHelp();
+    printHelp(argsOrOpts);
     console.log(`\n  ${colors.error}${ICONS.cross}${c.reset} ${c.bold}Error:${c.reset} --url is required\n`);
     return 1;
   }
@@ -1109,7 +1116,9 @@ async function runReality(argsOrOpts = {}) {
   }
 
   // Print banner
-  printBanner();
+  if (shouldShowBanner(argsOrOpts)) {
+    printBanner();
+  }
   
   console.log(`  ${c.dim}Project:${c.reset}  ${c.bold}${projectName}${c.reset}`);
   console.log(`  ${c.dim}URL:${c.reset}      ${colors.accent}${url}${c.reset}`);

package/bin/runners/runWatch.js

@@ -14,6 +14,7 @@
 
 const fs = require("fs");
 const path = require("path");
+const { parseGlobalFlags, shouldShowBanner } = require("./lib/global-flags");
 const { shipCore } = require("./runShip");
 
 // ═══════════════════════════════════════════════════════════════════════════════
@@ -273,8 +274,10 @@ function watchDirectory(dir, callback) {
   };
 }
 
-function printHelp() {
-  console.log(BANNER_FULL);
+function printHelp(opts = {}) {
+  if (shouldShowBanner(opts)) {
+    console.log(BANNER_FULL);
+  }
   console.log(`
   ${c.bold}Usage:${c.reset} vibecheck watch [options]
 
@@ -314,9 +317,12 @@ function printHelp() {
 
 async function runWatch(argsOrOpts = {}) {
   // Handle array args from CLI
+  let globalOpts = { noBanner: false, json: false, quiet: false, ci: false };
   if (Array.isArray(argsOrOpts)) {
-    if (argsOrOpts.includes("--help") || argsOrOpts.includes("-h")) {
-      printHelp();
+    const { flags } = parseGlobalFlags(argsOrOpts);
+    globalOpts = { ...globalOpts, ...flags };
+    if (globalOpts.help) {
+      printHelp(globalOpts);
       return 0;
     }
     const getArg = (flags) => {
@@ -331,6 +337,7 @@ async function runWatch(argsOrOpts = {}) {
       fastifyEntry: getArg(["--fastify-entry"]),
       debounceMs: parseInt(getArg(["--debounce"]) || "500", 10),
       clearScreen: !argsOrOpts.includes("--no-clear"),
+      ...globalOpts,
     };
   }
 

package/bin/vibecheck.js

@@ -1083,10 +1083,7 @@ async function main() {
     const suggestions = findSimilarCommands(cmd, ALL_COMMANDS);
     console.log(`\n${c.red}${sym.error}${c.reset} Unknown command: ${c.yellow}${cmd}${c.reset}`);
 
-    if (cmd === "replay" || cmd === "record") {
-      console.log(`\n${c.dim}replay is a PRO feature for session recording.${c.reset}`);
-      console.log(`${c.dim}Free alternative:${c.reset} ${c.cyan}vibecheck reality${c.reset} ${c.dim}(one-time runtime proof)${c.reset}`);
-    } else if (suggestions.length > 0) {
+    if (suggestions.length > 0) {
       console.log(`\n${c.dim}Did you mean:${c.reset}`);
       suggestions.forEach((s) => {
         const actual = ALIAS_MAP[s] || s;
@@ -1173,47 +1170,8 @@ async function main() {
       runStart,
     };
 
-    // Execute command
-    switch (cmd) {
-      case "prove":
-      case "reality":
-      case "watch":
-      case "ship":
-      case "runtime":
-      case "export":
-      case "security":
-      case "install":
-      case "pr":
-      case "share":
-        exitCode = await runner(cmdArgs, context);
-        break;
-
-      case "ctx":
-      case "truthpack":
-        if (cmdArgs[0] === "sync") {
-          const { runCtxSync } = require("./runners/runCtxSync");
-          exitCode = await runCtxSync({ ...context, fastifyEntry: getArgValue(cmdArgs, ["--fastify-entry"]) });
-        } else if (cmdArgs[0] === "guard") {
-          const { runCtxGuard } = require("./runners/runCtxGuard");
-          exitCode = await runCtxGuard.main(cmdArgs.slice(1));
-        } else if (cmdArgs[0] === "diff") {
-          const { main: ctxDiffMain } = require("./runners/runCtxDiff");
-          exitCode = await ctxDiffMain(cmdArgs.slice(1));
-        } else if (cmdArgs[0] === "search") {
-          const { runContext } = require("./runners/runContext");
-          exitCode = await runContext(["--search", ...cmdArgs.slice(1)]);
-        } else {
-          exitCode = await runner(cmdArgs, context);
-        }
-        break;
-
-      case "status":
-        exitCode = await runner({ ...context, json: cmdArgs.includes("--json") });
-        break;
-
-      default:
-        exitCode = await runner(cmdArgs);
-    }
+    // Execute command - all commands use consistent runner signature
+    exitCode = await runner(cmdArgs, context);
   } catch (error) {
     console.error(formatError(error, config));
     exitCode = 1;

package/mcp-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibecheck-mcp-server",
-  "version": "3.1.6",
+  "version": "3.1.8",
   "description": "Professional MCP server for vibecheck - Intelligent development environment vibechecks",
   "type": "module",
   "main": "index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecheckai/cli",
-  "version": "3.1.6",
+  "version": "3.1.8",
   "description": "Vibecheck CLI - Ship with confidence. One verdict: SHIP | WARN | BLOCK.",
   "main": "bin/vibecheck.js",
   "bin": {