@vibecheckai/cli 3.4.0 → 3.5.1

package/bin/runners/runInstall.js

@@ -0,0 +1,281 @@
+/**
+ * vibecheck install - Zero-friction Onboarding
+ * 
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ENTERPRISE EDITION - World-Class Terminal Experience
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
+
+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");
+const { writeEnvTemplateFromTruthpack } = require("./lib/env-template");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// ADVANCED TERMINAL - ANSI CODES & UTILITIES
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  italic: '\x1b[3m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  gray: '\x1b[90m',
+  clearLine: '\x1b[2K',
+  hideCursor: '\x1b[?25l',
+  showCursor: '\x1b[?25h',
+};
+
+const rgb = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
+
+const colors = {
+  gradient1: rgb(255, 200, 100),
+  gradient2: rgb(255, 180, 80),
+  gradient3: rgb(255, 160, 60),
+  shipGreen: rgb(0, 255, 150),
+  warnAmber: rgb(255, 200, 0),
+  blockRed: rgb(255, 80, 80),
+  accent: rgb(255, 200, 100),
+  muted: rgb(120, 120, 140),
+  next: rgb(100, 200, 255),
+  fastify: rgb(255, 150, 200),
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// PREMIUM BANNER
+// ═══════════════════════════════════════════════════════════════════════════════
+
+const INSTALL_BANNER = `
+${rgb(255, 200, 100)}  ██╗███╗   ██╗███████╗████████╗ █████╗ ██╗     ██╗     ${c.reset}
+${rgb(255, 180, 80)}  ██║████╗  ██║██╔════╝╚══██╔══╝██╔══██╗██║     ██║     ${c.reset}
+${rgb(255, 160, 60)}  ██║██╔██╗ ██║███████╗   ██║   ███████║██║     ██║     ${c.reset}
+${rgb(255, 140, 40)}  ██║██║╚██╗██║╚════██║   ██║   ██╔══██║██║     ██║     ${c.reset}
+${rgb(255, 120, 20)}  ██║██║ ╚████║███████║   ██║   ██║  ██║███████╗███████╗${c.reset}
+${rgb(255, 100, 0)}  ╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚══════╝${c.reset}
+`;
+
+const BANNER_FULL = `
+${rgb(255, 200, 100)}  ██╗   ██╗██╗██████╗ ███████╗ ██████╗██╗  ██╗███████╗ ██████╗██╗  ██╗${c.reset}
+${rgb(255, 190, 90)}  ██║   ██║██║██╔══██╗██╔════╝██╔════╝██║  ██║██╔════╝██╔════╝██║ ██╔╝${c.reset}
+${rgb(255, 180, 80)}  ██║   ██║██║██████╔╝█████╗  ██║     ███████║█████╗  ██║     █████╔╝ ${c.reset}
+${rgb(255, 160, 60)}  ╚██╗ ██╔╝██║██╔══██╗██╔══╝  ██║     ██╔══██║██╔══╝  ██║     ██╔═██╗ ${c.reset}
+${rgb(255, 140, 40)}   ╚████╔╝ ██║██████╔╝███████╗╚██████╗██║  ██║███████╗╚██████╗██║  ██╗${c.reset}
+${rgb(255, 120, 20)}    ╚═══╝  ╚═╝╚═════╝ ╚══════╝ ╚═════╝╚═╝  ╚═╝╚══════╝ ╚═════╝╚═╝  ╚═╝${c.reset}
+
+${c.dim}  ┌─────────────────────────────────────────────────────────────────────┐${c.reset}
+${c.dim}  │${c.reset}  ${rgb(255, 200, 100)}📥${c.reset} ${c.bold}INSTALL${c.reset} ${c.dim}•${c.reset} ${rgb(200, 200, 200)}Zero-Friction${c.reset} ${c.dim}•${c.reset} ${rgb(150, 150, 150)}Auto-Detect${c.reset} ${c.dim}•${c.reset} ${rgb(100, 100, 100)}Onboarding${c.reset}   ${c.dim}│${c.reset}
+${c.dim}  └─────────────────────────────────────────────────────────────────────┘${c.reset}
+`;
+
+const ICONS = {
+  install: '📥',
+  package: '📦',
+  file: '📄',
+  check: '✓',
+  cross: '✗',
+  warning: '⚠',
+  arrow: '→',
+  bullet: '•',
+  sparkle: '✨',
+  folder: '📁',
+  next: '▲',
+  fastify: '⚡',
+  npm: '📦',
+  gear: '⚙️',
+};
+
+const SPINNER_DOTS = ['⣾', '⣽', '⣻', '⢿', '⡿', '⣟', '⣯', '⣷'];
+let spinnerIndex = 0;
+let spinnerInterval = null;
+let spinnerStartTime = null;
+
+function formatDuration(ms) {
+  if (ms < 1000) return `${ms}ms`;
+  return `${(ms / 1000).toFixed(1)}s`;
+}
+
+function startSpinner(message) {
+  spinnerStartTime = Date.now();
+  process.stdout.write(c.hideCursor);
+  spinnerInterval = setInterval(() => {
+    const elapsed = formatDuration(Date.now() - spinnerStartTime);
+    process.stdout.write(`\r${c.clearLine}  ${colors.accent}${SPINNER_DOTS[spinnerIndex]}${c.reset} ${message} ${c.dim}${elapsed}${c.reset}`);
+    spinnerIndex = (spinnerIndex + 1) % SPINNER_DOTS.length;
+  }, 80);
+}
+
+function stopSpinner(message, success = true) {
+  if (spinnerInterval) {
+    clearInterval(spinnerInterval);
+    spinnerInterval = null;
+  }
+  const elapsed = spinnerStartTime ? formatDuration(Date.now() - spinnerStartTime) : '';
+  const icon = success ? `${colors.shipGreen}${ICONS.check}${c.reset}` : `${colors.blockRed}${ICONS.cross}${c.reset}`;
+  process.stdout.write(`\r${c.clearLine}  ${icon} ${message} ${c.dim}${elapsed}${c.reset}\n`);
+  process.stdout.write(c.showCursor);
+  spinnerStartTime = null;
+}
+
+function printDivider(char = '─', width = 69, color = c.dim) {
+  console.log(`${color}  ${char.repeat(width)}${c.reset}`);
+}
+
+function printSection(title, icon = '◆') {
+  console.log();
+  console.log(`  ${colors.accent}${icon}${c.reset} ${c.bold}${title}${c.reset}`);
+  printDivider();
+}
+
+function printHelp(opts = {}) {
+  if (shouldShowBanner(opts)) {
+    console.log(BANNER_FULL);
+  }
+  console.log(`
+  ${c.bold}Usage:${c.reset} vibecheck install [options]
+
+  ${c.bold}Zero-Friction Onboarding${c.reset} — Auto-detect and configure your project.
+
+  ${c.bold}Options:${c.reset}
+    ${colors.accent}--path, -p <dir>${c.reset}    Project path ${c.dim}(default: current directory)${c.reset}
+    ${colors.accent}--help, -h${c.reset}          Show this help
+
+  ${c.bold}What It Does:${c.reset}
+    ${colors.shipGreen}1.${c.reset} Detects package manager ${c.dim}(npm, yarn, pnpm)${c.reset}
+    ${colors.shipGreen}2.${c.reset} Detects frameworks ${c.dim}(Next.js, Fastify)${c.reset}
+    ${colors.shipGreen}3.${c.reset} Builds initial truthpack
+    ${colors.shipGreen}4.${c.reset} Creates .vibecheck/config.json
+    ${colors.shipGreen}5.${c.reset} Generates env template from truthpack
+    ${colors.shipGreen}6.${c.reset} Adds vibecheck scripts to package.json
+
+  ${c.bold}Created Files:${c.reset}
+    ${ICONS.file} ${colors.accent}.vibecheck/config.json${c.reset}     ${c.dim}Local configuration${c.reset}
+    ${ICONS.file} ${colors.accent}.vibecheck/truthpack.json${c.reset}  ${c.dim}Ground truth for AI agents${c.reset}
+    ${ICONS.file} ${colors.accent}.env.template${c.reset}              ${c.dim}Env vars from truthpack${c.reset}
+
+  ${c.bold}Examples:${c.reset}
+    ${c.dim}# Install in current directory${c.reset}
+    vibecheck install
+
+    ${c.dim}# Install in specific directory${c.reset}
+    vibecheck install --path ./my-app
+  `);
+}
+
+function ensureDir(p) {
+  fs.mkdirSync(p, { recursive: true });
+}
+
+async function runInstall(argsOrContext = {}) {
+  // Handle array args from CLI
+  let opts = { noBanner: false, json: false, quiet: false, ci: false };
+  if (Array.isArray(argsOrContext)) {
+    const { flags } = parseGlobalFlags(argsOrContext);
+    opts = { ...opts, ...flags };
+    if (opts.help) {
+      printHelp(opts);
+      return 0;
+    }
+    argsOrContext = { repoRoot: opts.path || process.cwd() };
+  }
+  
+  const { repoRoot } = argsOrContext;
+  const root = repoRoot || process.cwd();
+  const projectName = path.basename(root);
+
+  // Print banner
+  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();
+
+  const { path: pkgPath, json: pkg } = readPkg(root);
+
+  // Detect environment
+  startSpinner('Detecting environment...');
+  const pm = detectPackageManager(root);
+  const next = detectNext(root, pkg);
+  const fastify = detectFastify(root, pkg);
+  const fastifyEntry = fastify.enabled ? await detectFastifyEntry(root) : null;
+  stopSpinner('Environment detected', true);
+
+  // Build truthpack
+  startSpinner('Building truthpack...');
+  const truthpack = await buildTruthpack({ repoRoot: root, fastifyEntry: fastifyEntry || undefined });
+  writeTruthpack(root, truthpack);
+  stopSpinner('Truthpack built', true);
+
+  // Write config
+  startSpinner('Writing configuration...');
+  const cfgDir = path.join(root, ".vibecheck");
+  ensureDir(cfgDir);
+
+  const cfg = {
+    version: 1,
+    detected: {
+      packageManager: pm,
+      next: next.enabled,
+      fastify: fastify.enabled
+    },
+    fastifyEntry: fastifyEntry || null
+  };
+
+  fs.writeFileSync(path.join(cfgDir, "config.json"), JSON.stringify(cfg, null, 2), "utf8");
+  stopSpinner('Configuration written', true);
+
+  // Generate env template
+  startSpinner('Generating env template...');
+  const envRes = writeEnvTemplateFromTruthpack(root, truthpack);
+  stopSpinner(envRes.wrote ? `Env template generated (+${envRes.added.length} vars)` : 'Env template up to date', true);
+
+  // Add scripts
+  startSpinner('Updating package.json scripts...');
+  const scriptsToAdd = {
+    "vibecheck:ctx": "vibecheck ctx",
+    "vibecheck:ship": "vibecheck ship",
+    "vibecheck:fix": "vibecheck fix --apply",
+    "vibecheck:pr": "vibecheck pr"
+  };
+  const changedScripts = upsertScripts(pkg, scriptsToAdd);
+  if (changedScripts.length) writePkg(pkgPath, pkg);
+  stopSpinner(changedScripts.length ? `Added ${changedScripts.length} scripts` : 'Scripts up to date', true);
+
+  // Summary
+  printSection('DETECTED', ICONS.gear);
+  console.log();
+  console.log(`  ${ICONS.npm} ${c.bold}Package Manager:${c.reset} ${colors.accent}${pm}${c.reset}`);
+  console.log(`  ${colors.next}${ICONS.next}${c.reset} ${c.bold}Next.js:${c.reset}         ${next.enabled ? `${colors.shipGreen}yes${c.reset}` : `${c.dim}no${c.reset}`}`);
+  console.log(`  ${colors.fastify}${ICONS.fastify}${c.reset} ${c.bold}Fastify:${c.reset}         ${fastify.enabled ? `${colors.shipGreen}yes${c.reset}` : `${c.dim}no${c.reset}`}`);
+  if (fastifyEntry) {
+    console.log(`  ${c.dim}   Entry:${c.reset}          ${colors.accent}${fastifyEntry}${c.reset}`);
+  }
+
+  printSection('CREATED FILES', ICONS.folder);
+  console.log();
+  console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}.vibecheck/config.json${c.reset}`);
+  console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}.vibecheck/truthpack.json${c.reset}`);
+  if (envRes.wrote) {
+    console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}${envRes.outRel}${c.reset} ${c.dim}(+${envRes.added.length} vars)${c.reset}`);
+  }
+  if (changedScripts.length) {
+    console.log(`  ${colors.shipGreen}${ICONS.check}${c.reset} ${ICONS.file} ${colors.accent}package.json${c.reset} ${c.dim}(${changedScripts.join(', ')})${c.reset}`);
+  }
+
+  // Installation complete
+  console.log();
+  console.log(`  ${colors.shipGreen}${ICONS.sparkle}${c.reset} Installation complete!`);
+  console.log();
+}
+
+module.exports = { runInstall };

package/bin/runners/runLabs.js

@@ -0,0 +1,341 @@
+/**
+ * vibecheck labs - Experimental Features
+ *
+ * Access to experimental, internal, and beta features.
+ * These may change or be removed without notice.
+ *
+ * @module runners/runLabs
+ */
+
+"use strict";
+
+const { c, sym, box, printHeader, table } = require("./lib/ui");
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// LABS FEATURE REGISTRY
+// ═══════════════════════════════════════════════════════════════════════════════
+const LABS_FEATURES = {
+  // Experimental - Working but API may change
+  "ai-test": {
+    status: "experimental",
+    description: "AI agent for autonomous app testing",
+    docs: "https://docs.vibecheckai.dev/labs/ai-test",
+    runner: () => require("./runAIAgent").runAIAgent,
+  },
+  "launch": {
+    status: "experimental",
+    description: "Pre-launch checklist wizard",
+    docs: "https://docs.vibecheckai.dev/labs/launch",
+    runner: () => require("./runLaunch").runLaunch,
+  },
+  "dashboard": {
+    status: "stub",
+    description: "Real-time monitoring dashboard (coming soon)",
+    eta: "Q2 2025",
+  },
+  "permissions": {
+    status: "experimental",
+    description: "AuthZ matrix & IDOR vulnerability prover",
+    runner: () => require("./runPermissions").runPermissions,
+  },
+  "replay": {
+    status: "experimental",
+    description: "Record and replay user sessions for testing",
+    runner: () => require("./runReplay").runReplay,
+  },
+  "graph": {
+    status: "experimental",
+    description: "Reality proof graph visualization",
+    runner: () => require("./runGraph").runGraph,
+  },
+  
+  // Beta - Feature complete, gathering feedback
+  "ctx-diff": {
+    status: "beta",
+    description: "Diff truthpack changes across commits",
+    runner: () => require("./runCtxDiff").main,
+  },
+  
+  // Stubs - Planned but not implemented
+  "autopilot": {
+    status: "stub",
+    description: "Continuous protection mode (auto-fix on commit)",
+    eta: "Q2 2025",
+  },
+  "certify": {
+    status: "stub",
+    description: "Generate compliance certification badges",
+    eta: "Q2 2025",
+  },
+  "audit": {
+    status: "stub",
+    description: "Full audit trail for compliance (SOC2, HIPAA)",
+    eta: "Q3 2025",
+  },
+  "natural-language": {
+    status: "stub",
+    description: "Natural language command parsing",
+    eta: "Q2 2025",
+  },
+  "fix-packs": {
+    status: "stub",
+    description: "Downloadable fix pack templates",
+    eta: "Q2 2025",
+  },
+  "mdc": {
+    status: "stub",
+    description: "MDC documentation generator",
+    eta: "Q3 2025",
+  },
+  
+  // Aliases - Redirect to main commands
+  "enhanced-ship": {
+    status: "alias",
+    target: "ship --strict",
+    description: "Enhanced ship mode (use: vibecheck ship --strict)",
+  },
+  "sniff": {
+    status: "alias",
+    target: "reality --sniff",
+    description: "Reality sniff mode (use: vibecheck reality --sniff)",
+  },
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// STATUS DISPLAY
+// ═══════════════════════════════════════════════════════════════════════════════
+const STATUS_CONFIG = {
+  experimental: {
+    icon: sym.lightning,
+    color: c.yellow,
+    label: "EXPERIMENTAL",
+    description: "Working but API may change",
+  },
+  beta: {
+    icon: sym.star,
+    color: c.cyan,
+    label: "BETA",
+    description: "Feature complete, gathering feedback",
+  },
+  stub: {
+    icon: sym.pending,
+    color: c.dim,
+    label: "PLANNED",
+    description: "Not yet implemented",
+  },
+  alias: {
+    icon: sym.arrow,
+    color: c.dim,
+    label: "ALIAS",
+    description: "Use the main command instead",
+  },
+};
+
+function formatStatus(status) {
+  const config = STATUS_CONFIG[status];
+  if (!config) return status;
+  return `${config.color}${config.icon} ${config.label}${c.reset}`;
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// HELP DISPLAY
+// ═══════════════════════════════════════════════════════════════════════════════
+function printHelp() {
+  printHeader("LABS", { 
+    icon: sym.lightning, 
+    subtitle: "Experimental & Internal Features" 
+  });
+  
+  console.log(`${c.yellow}${sym.warning} These features are experimental and may change without notice.${c.reset}\n`);
+  
+  // Group by status
+  const groups = {
+    experimental: [],
+    beta: [],
+    stub: [],
+    alias: [],
+  };
+  
+  for (const [name, feature] of Object.entries(LABS_FEATURES)) {
+    if (groups[feature.status]) {
+      groups[feature.status].push({ name, ...feature });
+    }
+  }
+  
+  // Experimental
+  if (groups.experimental.length > 0) {
+    console.log(`${c.yellow}${sym.lightning} EXPERIMENTAL${c.reset} ${c.dim}(working, API may change)${c.reset}\n`);
+    
+    for (const feature of groups.experimental) {
+      console.log(`  ${c.cyan}vibecheck labs ${feature.name}${c.reset}`);
+      console.log(`    ${c.dim}${feature.description}${c.reset}`);
+      if (feature.docs) {
+        console.log(`    ${c.dim}Docs: ${feature.docs}${c.reset}`);
+      }
+      console.log("");
+    }
+  }
+  
+  // Beta
+  if (groups.beta.length > 0) {
+    console.log(`${c.cyan}${sym.star} BETA${c.reset} ${c.dim}(feature complete, gathering feedback)${c.reset}\n`);
+    
+    for (const feature of groups.beta) {
+      console.log(`  ${c.cyan}vibecheck labs ${feature.name}${c.reset}`);
+      console.log(`    ${c.dim}${feature.description}${c.reset}`);
+      console.log("");
+    }
+  }
+  
+  // Stubs
+  if (groups.stub.length > 0) {
+    console.log(`${c.dim}${sym.pending} PLANNED${c.reset} ${c.dim}(not yet implemented)${c.reset}\n`);
+    
+    const stubData = groups.stub.map(f => [
+      `${c.dim}${f.name}${c.reset}`,
+      `${c.dim}${f.description}${c.reset}`,
+      f.eta ? `${c.dim}ETA: ${f.eta}${c.reset}` : "",
+    ]);
+    
+    console.log(table(stubData, { indent: 2 }));
+    console.log("");
+  }
+  
+  // Aliases
+  if (groups.alias.length > 0) {
+    console.log(`${c.dim}${sym.arrow} ALIASES${c.reset} ${c.dim}(use the main command instead)${c.reset}\n`);
+    
+    for (const feature of groups.alias) {
+      console.log(`  ${c.dim}labs ${feature.name}${c.reset} ${sym.arrow} ${c.cyan}vibecheck ${feature.target}${c.reset}`);
+    }
+    console.log("");
+  }
+  
+  // Usage
+  console.log(`${c.dim}${"─".repeat(60)}${c.reset}`);
+  console.log(`${c.bold}Usage${c.reset}\n`);
+  console.log(`  vibecheck labs <feature> [options]\n`);
+  console.log(`${c.dim}Example:${c.reset}`);
+  console.log(`  vibecheck labs ai-test --url http://localhost:3000`);
+  console.log("");
+  
+  // Feedback
+  console.log(`${c.dim}${"─".repeat(60)}${c.reset}`);
+  console.log(`${c.bold}Feedback${c.reset}\n`);
+  console.log(`  ${c.dim}Want a feature prioritized? Let us know:${c.reset}`);
+  console.log(`  ${c.cyan}https://github.com/vibecheckai/vibecheck/discussions${c.reset}`);
+  console.log("");
+}
+
+function printFeatureStub(name, feature) {
+  console.log(box(
+    `${c.bold}vibecheck labs ${name}${c.reset}\n\n` +
+    `${feature.description}\n\n` +
+    `${c.dim}This feature is not yet implemented.${c.reset}\n` +
+    (feature.eta ? `${c.dim}Expected: ${feature.eta}${c.reset}\n` : "") +
+    `\n${c.dim}Want this feature? Vote for it:${c.reset}\n` +
+    `${c.cyan}https://github.com/vibecheckai/vibecheck/discussions${c.reset}`,
+    { title: "PLANNED", borderColor: c.yellow }
+  ));
+  console.log("");
+}
+
+function printAliasWarning(name, feature) {
+  console.log(`${c.yellow}${sym.warning}${c.reset} '${name}' is now available as: ${c.cyan}vibecheck ${feature.target}${c.reset}\n`);
+  console.log(`${c.dim}The labs alias will be removed in a future version.${c.reset}\n`);
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// MAIN RUNNER
+// ═══════════════════════════════════════════════════════════════════════════════
+async function runLabs(args = []) {
+  const subCmd = args[0];
+  const subArgs = args.slice(1);
+  
+  // Show help if no command
+  if (!subCmd || subCmd === "--help" || subCmd === "-h") {
+    printHelp();
+    return 0;
+  }
+  
+  // List all features
+  if (subCmd === "--list" || subCmd === "-l") {
+    const features = Object.entries(LABS_FEATURES).map(([name, f]) => [
+      name,
+      formatStatus(f.status),
+      f.description.slice(0, 40),
+    ]);
+    
+    console.log(table(features, { 
+      headers: ["Feature", "Status", "Description"],
+      indent: 2,
+    }));
+    console.log("");
+    return 0;
+  }
+  
+  // Find feature
+  const feature = LABS_FEATURES[subCmd];
+  
+  if (!feature) {
+    console.log(`${c.red}${sym.error}${c.reset} Unknown labs feature: ${c.yellow}${subCmd}${c.reset}\n`);
+    console.log(`${c.dim}Available features:${c.reset}`);
+    console.log(`  ${Object.keys(LABS_FEATURES).filter(k => LABS_FEATURES[k].status !== "stub").join(", ")}`);
+    console.log(`\n${c.dim}Run 'vibecheck labs --help' for details.${c.reset}\n`);
+    return 1;
+  }
+  
+  // Handle stubs
+  if (feature.status === "stub") {
+    printFeatureStub(subCmd, feature);
+    return 0;
+  }
+  
+  // Handle aliases
+  if (feature.status === "alias") {
+    printAliasWarning(subCmd, feature);
+    
+    // Try to run the aliased command
+    const [cmd, ...aliasArgs] = feature.target.split(" ");
+    try {
+      const { runShip } = require("./runShip");
+      if (cmd === "ship") {
+        return await runShip([...aliasArgs, ...subArgs]);
+      }
+      const { runReality } = require("./runReality");
+      if (cmd === "reality") {
+        return await runReality([...aliasArgs, ...subArgs]);
+      }
+    } catch (e) {
+      console.log(`${c.dim}Please run the command directly: vibecheck ${feature.target}${c.reset}\n`);
+    }
+    return 0;
+  }
+  
+  // Run the feature
+  try {
+    const runner = feature.runner();
+    
+    // Show experimental warning
+    if (feature.status === "experimental") {
+      console.log(`${c.yellow}${sym.warning} EXPERIMENTAL:${c.reset} ${c.dim}This feature may change without notice.${c.reset}\n`);
+    } else if (feature.status === "beta") {
+      console.log(`${c.cyan}${sym.star} BETA:${c.reset} ${c.dim}Feedback welcome! Report issues at github.com/vibecheckai/vibecheck${c.reset}\n`);
+    }
+    
+    return await runner(subArgs);
+  } catch (e) {
+    if (e.code === "MODULE_NOT_FOUND") {
+      console.log(`${c.red}${sym.error}${c.reset} Feature '${subCmd}' is not available in this version.\n`);
+      console.log(`${c.dim}Try updating: npm update -g @vibecheckai/cli${c.reset}\n`);
+    } else {
+      console.error(`${c.red}${sym.error}${c.reset} Error running labs ${subCmd}: ${e.message}`);
+      if (process.env.VIBECHECK_DEBUG) {
+        console.error(c.dim + e.stack + c.reset);
+      }
+    }
+    return 1;
+  }
+}
+
+module.exports = { runLabs, LABS_FEATURES };