@vibecheckai/cli 3.0.7 → 3.0.8

package/bin/runners/cli-utils.js

@@ -38,12 +38,12 @@ const c = {
 
 // ASCII Art Banner
 const BANNER = `
-${c.brightCyan}  ██████╗ ██╗   ██╗ █████╗ ██████╗ ██████╗ ██████╗  █████╗ ██╗██╗     
-  ██╔════╝ ██║   ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗██╔══██╗██║██║     
-  ██║  ███╗██║   ██║███████║██████╔╝██║  ██║██████╔╝███████║██║██║     
-  ██║   ██║██║   ██║██╔══██║██╔══██╗██║  ██║██╔══██╗██╔══██║██║██║     
-  ╚██████╔╝╚██████╔╝██║  ██║██║  ██║██████╔╝██║  ██║██║  ██║██║███████╗
-   ╚═════╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚══════╝${c.reset}
+${c.brightCyan}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗
+  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝
+  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ 
+  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ 
+   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗
+    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
 ${c.dim}                     AI-Native Code Security Platform${c.reset}
 `;
 

package/bin/runners/lib/firewall-prompt.js

@@ -1,7 +1,7 @@
 // bin/runners/lib/firewall-prompt.js
 function buildRealityFirewall({ truthpackSummary, mission, template, findings, fileSnippets, allowedFiles }) {
   return `
-You are Guardrail Fix Engine.
+You are Vibecheck Fix Engine.
 
 REALITY RULES (non-negotiable):
 - Do NOT invent files, routes, env vars, middleware, or functions.

package/bin/runners/lib/sandbox/proof-chain.js

@@ -82,7 +82,7 @@ async function runStaticProof(sandboxPath, options) {
 
   // Run vibecheck ship in sandbox
   try {
-    const vibecheckBin = path.join(__dirname, "..", "..", "..", "guardrail.js");
+    const vibecheckBin = path.join(__dirname, "..", "..", "..", "vibecheck.js");
     const output = execSync(`node "${vibecheckBin}" ship --json`, {
       cwd: sandboxPath,
       encoding: "utf8",
@@ -120,7 +120,7 @@ async function runStaticProof(sandboxPath, options) {
   const contractsDir = path.join(sandboxPath, ".vibecheck", "contracts");
   if (fs.existsSync(contractsDir)) {
     try {
-      const vibecheckBin = path.join(__dirname, "..", "..", "..", "guardrail.js");
+      const vibecheckBin = path.join(__dirname, "..", "..", "..", "vibecheck.js");
       const output = execSync(`node "${vibecheckBin}" ctx guard --json`, {
         cwd: sandboxPath,
         encoding: "utf8",
@@ -293,7 +293,7 @@ async function runRealityProof(sandboxPath, options) {
 
   // Run vibecheck reality
   try {
-    const vibecheckBin = path.join(__dirname, "..", "..", "..", "guardrail.js");
+    const vibecheckBin = path.join(__dirname, "..", "..", "..", "vibecheck.js");
     const cmd = `node "${vibecheckBin}" reality --url ${options.url} --max-pages 5 --max-depth 1`;
     
     execSync(cmd, {

package/bin/runners/runInstall.js

@@ -6,11 +6,51 @@ const { detectPackageManager, detectNext, detectFastify, detectFastifyEntry } =
 const { readPkg, writePkg, upsertScripts } = require("./lib/pkgjson");
 const { writeEnvTemplateFromTruthpack } = require("./lib/env-template");
 
+function printHelp() {
+  console.log(`
+vibecheck install - Zero-friction onboarding
+
+USAGE
+  vibecheck install [options]
+
+OPTIONS
+  --path, -p <dir>    Project path (default: current directory)
+  --help, -h          Show this help
+
+WHAT IT DOES
+  1. Detects package manager (npm, yarn, pnpm)
+  2. Detects frameworks (Next.js, Fastify)
+  3. Builds initial truthpack
+  4. Creates .vibecheck/config.json
+  5. Generates env template from truthpack
+  6. Adds vibecheck scripts to package.json
+
+CREATED FILES
+  .vibecheck/config.json     - Local configuration
+  .vibecheck/truthpack.json  - Ground truth for AI agents
+  .env.template              - Env vars from truthpack
+
+EXAMPLES
+  vibecheck install                    # Install in current directory
+  vibecheck install --path ./my-app    # Install in specific directory
+`);
+}
+
 function ensureDir(p) {
   fs.mkdirSync(p, { recursive: true });
 }
 
-async function runInstall({ repoRoot } = {}) {
+async function runInstall(argsOrContext = {}) {
+  // Handle array args from CLI
+  if (Array.isArray(argsOrContext)) {
+    if (argsOrContext.includes("--help") || argsOrContext.includes("-h")) {
+      printHelp();
+      return 0;
+    }
+    argsOrContext = { repoRoot: process.cwd() };
+  }
+  
+  const { repoRoot } = argsOrContext;
   const root = repoRoot || process.cwd();
 
   const { path: pkgPath, json: pkg } = readPkg(root);

package/bin/runners/runProve.js

@@ -33,16 +33,7 @@ try {
   runFixCore = null;
 }
 
-const c = {
-  reset: "\x1b[0m",
-  bold: "\x1b[1m",
-  dim: "\x1b[2m",
-  red: "\x1b[31m",
-  green: "\x1b[32m",
-  yellow: "\x1b[33m",
-  cyan: "\x1b[36m",
-  blue: "\x1b[34m",
-};
+const { c, sym, Spinner, printHeader, printSection, printDivider, verdictBadge, formatDuration, box } = require("./lib/ui");
 
 function ensureDir(p) {
   fs.mkdirSync(p, { recursive: true });
@@ -54,23 +45,90 @@ function stamp() {
   return `${d.getFullYear()}${z(d.getMonth() + 1)}${z(d.getDate())}_${z(d.getHours())}${z(d.getMinutes())}${z(d.getSeconds())}`;
 }
 
-async function runProve({
-  repoRoot,
-  url,
-  auth,
-  storageState,
-  fastifyEntry,
-  maxFixRounds = 3,
-  maxMissions = 8,
-  maxSteps = 10,
-  skipReality = false,
-  skipFix = false,
-  headed = false,
-  danger = false,
-  maxPages = 18,
-  maxDepth = 2,
-  timeoutMs = 15000
-} = {}) {
+function printHelp() {
+  console.log(`
+${c.cyan}${c.bold}vibecheck prove${c.reset} - One Command Reality Proof
+
+${c.bold}USAGE${c.reset}
+  vibecheck prove [options]
+
+${c.bold}OPTIONS${c.reset}
+  --url, -u <url>           Base URL for runtime testing
+  --auth <email:pass>       Login credentials for auth verification
+  --storage-state <path>    Playwright session state file
+  --fastify-entry <path>    Fastify entry file for route extraction
+  --max-fix-rounds <n>      Max auto-fix attempts (default: 3)
+  --skip-reality            Skip runtime crawling (static only)
+  --skip-fix                Don't auto-fix, just diagnose
+  --headed                  Run browser in headed mode
+  --danger                  Allow clicking destructive elements
+  --help, -h                Show this help
+
+${c.bold}WHAT IT DOES${c.reset}
+  1. ${c.cyan}ctx${c.reset}      - Refresh truthpack (ground truth)
+  2. ${c.cyan}reality${c.reset}  - Runtime UI proof (if --url provided)
+  3. ${c.cyan}ship${c.reset}     - Static + runtime verdict
+  4. ${c.cyan}fix${c.reset}      - Auto-fix if BLOCK (up to N rounds)
+  5. ${c.cyan}verify${c.reset}   - Re-run to confirm SHIP
+
+${c.bold}EXIT CODES${c.reset}
+  0 = SHIP (ready to deploy)
+  1 = WARN (warnings found)
+  2 = BLOCK (blockers found)
+
+${c.bold}EXAMPLES${c.reset}
+  vibecheck prove --url http://localhost:3000
+  vibecheck prove --url http://localhost:3000 --auth user@test.com:pass
+  vibecheck prove --skip-reality
+  vibecheck prove --url http://localhost:3000 --max-fix-rounds 5
+`);
+}
+
+async function runProve(argsOrOpts = {}) {
+  // Handle array args from CLI
+  if (Array.isArray(argsOrOpts)) {
+    if (argsOrOpts.includes("--help") || argsOrOpts.includes("-h")) {
+      printHelp();
+      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];
+      }
+      return undefined;
+    };
+    argsOrOpts = {
+      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"),
+    };
+  }
+
+  const {
+    repoRoot,
+    url,
+    auth,
+    storageState,
+    fastifyEntry,
+    maxFixRounds = 3,
+    maxMissions = 8,
+    maxSteps = 10,
+    skipReality = false,
+    skipFix = false,
+    headed = false,
+    danger = false,
+    maxPages = 18,
+    maxDepth = 2,
+    timeoutMs = 15000
+  } = argsOrOpts;
+  
   const root = repoRoot || process.cwd();
   const startTime = Date.now();
 

package/bin/runners/runReality.js

@@ -371,21 +371,95 @@ function coverageFromTruthpack({ truthpack, visitedUrls }) {
   return { total, hit, percent: total ? Math.round((hit / total) * 100) : 0, missed: Array.from(uiPaths).filter(p => !visitedPaths.has(p)).slice(0, 50) };
 }
 
-async function runReality({
-  repoRoot,
-  url,
-  auth,
-  storageState,
-  saveStorageState,
-  truthpack,
-  verifyAuth = false,
-  headed = false,
-  maxPages = 18,
-  maxDepth = 2,
-  danger = false,
-  timeoutMs = 15000
-} = {}) {
-  if (!url) throw new Error("--url is required");
+function printHelp() {
+  console.log(`
+vibecheck reality - Runtime UI Verification
+
+USAGE
+  vibecheck reality --url <url> [options]
+
+OPTIONS
+  --url, -u <url>           Base URL for runtime testing (required)
+  --auth <email:pass>       Login credentials for auth verification
+  --storage-state <path>    Playwright session state file
+  --save-storage-state <p>  Save session state after login
+  --truthpack <path>        Custom truthpack path
+  --verify-auth             Enable two-pass auth verification
+  --headed                  Run browser in headed mode (visible)
+  --danger                  Allow clicking potentially destructive elements
+  --max-pages <n>           Max pages to crawl (default: 18)
+  --max-depth <n>           Max crawl depth (default: 2)
+  --timeout <ms>            Page timeout (default: 15000)
+  --help, -h                Show this help
+
+WHAT IT DOES
+  1. Pass A (Anon): Crawls and clicks, records protected routes
+  2. Pass B (Auth): Re-crawls with auth, verifies access
+  3. Detects dead UI (clicks that do nothing)
+  4. Calculates route coverage stats
+
+FINDINGS
+  - Dead UI → FIX_DEAD_UI mission
+  - Auth gaps → ADD_SERVER_AUTH mission
+  - HTTP errors → error findings
+
+EXAMPLES
+  vibecheck reality --url http://localhost:3000
+  vibecheck reality --url http://localhost:3000 --verify-auth --auth user@test.com:pass123
+  vibecheck reality --url http://localhost:3000 --headed --danger
+`);
+}
+
+async function runReality(argsOrOpts = {}) {
+  // Handle array args from CLI
+  if (Array.isArray(argsOrOpts)) {
+    if (argsOrOpts.includes("--help") || argsOrOpts.includes("-h")) {
+      printHelp();
+      return 0;
+    }
+    // Parse args to options
+    const getArg = (flags) => {
+      for (const f of flags) {
+        const idx = argsOrOpts.indexOf(f);
+        if (idx !== -1 && idx < argsOrOpts.length - 1) return argsOrOpts[idx + 1];
+      }
+      return undefined;
+    };
+    argsOrOpts = {
+      url: getArg(["--url", "-u"]),
+      auth: getArg(["--auth"]),
+      storageState: getArg(["--storage-state"]),
+      saveStorageState: getArg(["--save-storage-state"]),
+      truthpack: getArg(["--truthpack"]),
+      verifyAuth: argsOrOpts.includes("--verify-auth"),
+      headed: argsOrOpts.includes("--headed"),
+      danger: argsOrOpts.includes("--danger"),
+      maxPages: parseInt(getArg(["--max-pages"]) || "18", 10),
+      maxDepth: parseInt(getArg(["--max-depth"]) || "2", 10),
+      timeoutMs: parseInt(getArg(["--timeout"]) || "15000", 10),
+    };
+  }
+
+  const {
+    repoRoot,
+    url,
+    auth,
+    storageState,
+    saveStorageState,
+    truthpack,
+    verifyAuth = false,
+    headed = false,
+    maxPages = 18,
+    maxDepth = 2,
+    danger = false,
+    timeoutMs = 15000
+  } = argsOrOpts;
+
+  if (!url) {
+    printHelp();
+    console.log("\n❌ Error: --url is required\n");
+    return 1;
+  }
   if (!chromium) {
     const hint = playwrightError?.includes("Cannot find module") 
       ? "Run: npm i -D playwright && npx playwright install chromium"

package/bin/runners/runScan.js

@@ -88,12 +88,12 @@ const gradientPink = rgb(255, 105, 180);
 const gradientOrange = rgb(255, 165, 0);
 
 const BANNER = `
-${rgb(0, 200, 255)}   ██████╗ ██╗   ██╗ █████╗ ██████╗ ██████╗ ██████╗  █████╗ ██╗██╗     ${c.reset}
-${rgb(30, 180, 255)}  ██╔════╝ ██║   ██║██╔══██╗██╔══██╗██╔══██╗██╔══██╗██╔══██╗██║██║     ${c.reset}
-${rgb(60, 160, 255)}  ██║  ███╗██║   ██║███████║██████╔╝██║  ██║██████╔╝███████║██║██║     ${c.reset}
-${rgb(90, 140, 255)}  ██║   ██║██║   ██║██╔══██║██╔══██╗██║  ██║██╔══██╗██╔══██║██║██║     ${c.reset}
-${rgb(120, 120, 255)}  ╚██████╔╝╚██████╔╝██║  ██║██║  ██║██████╔╝██║  ██║██║  ██║██║███████╗${c.reset}
-${rgb(150, 100, 255)}   ╚═════╝  ╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚══════╝${c.reset}
+${rgb(0, 200, 255)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(30, 180, 255)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
+${rgb(60, 160, 255)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
+${rgb(90, 140, 255)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
+${rgb(120, 120, 255)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
+${rgb(150, 100, 255)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
 
 ${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
 ${c.dim}  │${c.reset}  ${rgb(255, 255, 255)}${c.bold}Route Integrity${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}Security${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}Quality${c.reset} ${c.dim}•${c.reset} ${rgb(100, 100, 100)}Ship with Confidence${c.reset}  ${c.dim}│${c.reset}

package/bin/runners/runShare.js

@@ -3,12 +3,72 @@ const fs = require("fs");
 const path = require("path");
 const { buildSharePack, findLatestMissionDir } = require("./lib/share-pack");
 
-async function runShare({ repoRoot, missionDir, outputDir, prComment } = {}) {
+function printHelp() {
+  console.log(`
+vibecheck share - Generate shareable proof bundles
+
+USAGE
+  vibecheck share [options]
+
+OPTIONS
+  --mission-dir <path>   Specific mission directory to share
+  --output-dir <path>    Output directory for share pack
+  --pr-comment           Print PR comment to stdout
+  --help, -h             Show this help
+
+WHAT IT DOES
+  1. Finds latest mission pack from .vibecheck/missions/
+  2. Generates share bundle with:
+     - share.json (machine readable)
+     - share.md (human readable)
+     - pr_comment.md (GitHub ready)
+
+OUTPUT FILES
+  .vibecheck/missions/<timestamp>/share/share.json
+  .vibecheck/missions/<timestamp>/share/share.md
+  .vibecheck/missions/<timestamp>/share/pr_comment.md
+
+EXAMPLES
+  vibecheck share                    # Share latest mission
+  vibecheck share --pr-comment       # Print PR comment body
+  vibecheck fix --autopilot --share  # Fix then auto-share
+`);
+}
+
+async function runShare(argsOrOpts = {}) {
+  // Handle array args from CLI
+  if (Array.isArray(argsOrOpts)) {
+    if (argsOrOpts.includes("--help") || argsOrOpts.includes("-h")) {
+      printHelp();
+      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];
+      }
+      return undefined;
+    };
+    argsOrOpts = {
+      missionDir: getArg(["--mission-dir"]),
+      outputDir: getArg(["--output-dir"]),
+      prComment: argsOrOpts.includes("--pr-comment"),
+    };
+  }
+
+  const { repoRoot, missionDir, outputDir, prComment } = argsOrOpts;
   const root = repoRoot || process.cwd();
 
-  const resolvedMissionDir = missionDir
-    ? (path.isAbsolute(missionDir) ? missionDir : path.join(root, missionDir))
-    : findLatestMissionDir(root);
+  let resolvedMissionDir;
+  try {
+    resolvedMissionDir = missionDir
+      ? (path.isAbsolute(missionDir) ? missionDir : path.join(root, missionDir))
+      : findLatestMissionDir(root);
+  } catch (e) {
+    console.log(`\n❌ Error: ${e.message}\n`);
+    console.log(`Run 'vibecheck fix --autopilot' first to generate mission packs.\n`);
+    return 1;
+  }
 
   const res = buildSharePack({
     repoRoot: root,

package/bin/runners/runStatus.js

@@ -130,7 +130,9 @@ ${c.bold}Quick Actions${c.reset}
   ${lastShip?.meta?.verdict === "SHIP" ? `${c.green}✓ Ready to deploy!${c.reset}` : ""}
 `);
 
-  return lastShip?.meta?.verdict === "SHIP" ? 0 : lastShip?.meta?.verdict === "BLOCK" ? 2 : 1;
+  // Exit 0 when showing status successfully (even if no ship yet)
+  // Only return non-zero if explicitly checking for BLOCK
+  return 0;
 }
 
 module.exports = { runStatus };

package/bin/vibecheck.js

@@ -447,7 +447,7 @@ async function main() {
     const context = { repoRoot: process.cwd(), config, state, authInfo, version: VERSION, isCI: isCI() };
     
     switch (cmd) {
-      case "prove": exitCode = await runner({ ...context, url: getArgValue(cmdArgs, ["--url", "-u"]), auth: getArgValue(cmdArgs, ["--auth"]), storageState: getArgValue(cmdArgs, ["--storage-state"]), fastifyEntry: getArgValue(cmdArgs, ["--fastify-entry"]), maxFixRounds: parseInt(getArgValue(cmdArgs, ["--max-fix-rounds"]) || "3", 10), skipReality: cmdArgs.includes("--skip-reality"), skipFix: cmdArgs.includes("--skip-fix"), headed: cmdArgs.includes("--headed"), danger: cmdArgs.includes("--danger") }); break;
+      case "prove": exitCode = await runner(cmdArgs); break;
       case "reality": exitCode = await runner({ ...context, url: getArgValue(cmdArgs, ["--url", "-u"]), auth: getArgValue(cmdArgs, ["--auth"]), storageState: getArgValue(cmdArgs, ["--storage-state"]), saveStorageState: getArgValue(cmdArgs, ["--save-storage-state"]), truthpack: getArgValue(cmdArgs, ["--truthpack"]), verifyAuth: cmdArgs.includes("--verify-auth"), headed: cmdArgs.includes("--headed"), danger: cmdArgs.includes("--danger") }); break;
       case "watch": exitCode = await runner({ ...context, fastifyEntry: getArgValue(cmdArgs, ["--fastify-entry"]), debounceMs: parseInt(getArgValue(cmdArgs, ["--debounce"]) || "500", 10), clearScreen: !cmdArgs.includes("--no-clear") }); break;
       case "ctx": case "truthpack":
@@ -457,10 +457,10 @@ async function main() {
         else if (cmdArgs[0] === "search") { const { runContext } = require("./runners/runContext"); exitCode = await runContext(["--search", ...cmdArgs.slice(1)]); }
         else { exitCode = await runner({ ...context, fastifyEntry: getArgValue(cmdArgs, ["--fastify-entry"]), print: cmdArgs.includes("--print") }); }
         break;
-      case "install": exitCode = await runner(context); break;
+      case "install": exitCode = await runner(cmdArgs); break;
       case "status": exitCode = await runner({ ...context, json: cmdArgs.includes("--json") }); break;
       case "pr": exitCode = await runner({ ...context, fastifyEntry: getArgValue(cmdArgs, ["--fastify-entry"]), out: getArgValue(cmdArgs, ["--out"]), failOnWarn: cmdArgs.includes("--fail-on-warn"), maxFindings: parseInt(getArgValue(cmdArgs, ["--max-findings"]) || "12", 10) }); break;
-      case "share": exitCode = await runner({ ...context, missionDir: getArgValue(cmdArgs, ["--mission-dir"]), outputDir: getArgValue(cmdArgs, ["--output-dir"]), prComment: cmdArgs.includes("--pr-comment") }); break;
+      case "share": exitCode = await runner(cmdArgs); break;
       default: exitCode = await runner(cmdArgs);
     }
   } catch (error) { console.error(formatError(error, config)); exitCode = 1; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibecheckai/cli",
-  "version": "3.0.7",
+  "version": "3.0.8",
   "description": "Vibecheck CLI - Ship with confidence. One verdict: SHIP | WARN | BLOCK.",
   "main": "bin/vibecheck.js",
   "bin": {
@@ -18,7 +18,11 @@
     "build:legacy": "node scripts/build.js",
     "dev": "node ../../bin/vibecheck.js",
     "start": "node bin/vibecheck.js",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "vibecheck:ctx": "vibecheck ctx",
+    "vibecheck:ship": "vibecheck ship",
+    "vibecheck:fix": "vibecheck fix --apply",
+    "vibecheck:pr": "vibecheck pr"
   },
   "dependencies": {
     "@babel/parser": "^7.23.0",