vibecheck-ai 2.0.1 → 5.0.0

package/bin/runners/runLabs.js

@@ -0,0 +1,424 @@
+/**
+ * vibecheck labs - Experimental Features
+ *
+ * Access to experimental, internal, and beta features.
+ * These may change or be removed without notice.
+ *
+ * @module runners/runLabs
+ */
+
+"use strict";
+
+// Colors
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+};
+
+const rgb = (r, g, b) => `\x1b[38;2;${r};${g};${b}m`;
+
+const colors = {
+  accent: rgb(0, 212, 255),
+  success: rgb(16, 185, 129),
+  warning: rgb(245, 158, 11),
+  error: rgb(239, 68, 68),
+  purple: rgb(168, 85, 247),
+};
+
+const sym = {
+  check: '✓',
+  cross: '✗',
+  warning: '⚠',
+  info: 'ℹ',
+  pending: '○',
+  lightning: '⚡',
+  star: '★',
+  arrow: '→',
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// LABS FEATURE REGISTRY
+// ═══════════════════════════════════════════════════════════════════════════════
+const LABS_FEATURES = {
+  // Experimental - Working but API may change
+  "ai-agent": {
+    status: "experimental",
+    description: "AI autonomous testing agent",
+    docs: "https://docs.vibecheckai.dev/labs/ai-agent",
+    runner: () => require("./runAIAgent").runAIAgent,
+  },
+  "deep-scan": {
+    status: "experimental",
+    description: "Extended static analysis with ML patterns",
+    runner: async (args, ctx) => {
+      const { runScan } = require("./runScan");
+      return runScan(["--profile", "deep", ...args], ctx);
+    },
+  },
+  "hallucination-check": {
+    status: "experimental",
+    description: "Detect AI-generated code hallucinations",
+    runner: async (args, ctx) => {
+      const { runCheckpoint } = require("./runCheckpoint");
+      return runCheckpoint(["--hallucination", ...args], ctx);
+    },
+  },
+  "truth-diff": {
+    status: "experimental",
+    description: "Diff truthpack changes across commits",
+    runner: async (args) => {
+      console.log(`\n  ${c.yellow}${sym.warning} truth-diff${c.reset} is coming soon.\n`);
+      console.log(`  ${c.dim}This feature will compare truthpack snapshots across git commits.${c.reset}\n`);
+      return 0;
+    },
+  },
+
+  // Beta - Feature complete, gathering feedback
+  "smart-fix": {
+    status: "beta",
+    description: "AI-powered intelligent fix suggestions",
+    runner: async (args, ctx) => {
+      const { runFix } = require("./runFix");
+      return runFix(["--smart", ...args], ctx);
+    },
+  },
+  "security-audit": {
+    status: "beta",
+    description: "Comprehensive security audit mode",
+    runner: async (args, ctx) => {
+      const { runScan } = require("./runScan");
+      return runScan(["--profile", "security", ...args], ctx);
+    },
+  },
+
+  // Stubs - Planned but not implemented
+  "autopilot": {
+    status: "stub",
+    description: "Continuous protection mode (auto-fix on commit)",
+    eta: "Q2 2026",
+  },
+  "certify": {
+    status: "stub",
+    description: "Generate compliance certification badges",
+    eta: "Q2 2026",
+  },
+  "audit-trail": {
+    status: "stub",
+    description: "Full audit trail for compliance (SOC2, HIPAA)",
+    eta: "Q3 2026",
+  },
+  "natural-language": {
+    status: "stub",
+    description: "Natural language command interface",
+    eta: "Q2 2026",
+  },
+  "fix-packs": {
+    status: "stub",
+    description: "Downloadable fix pack templates",
+    eta: "Q2 2026",
+  },
+  "dashboard-live": {
+    status: "stub",
+    description: "Real-time live monitoring dashboard",
+    eta: "Q3 2026",
+  },
+
+  // Aliases - Redirect to main commands
+  "ship-strict": {
+    status: "alias",
+    target: "ship --strict",
+    description: "Enhanced ship mode (use: vibecheck ship --strict)",
+  },
+  "reality-agent": {
+    status: "alias",
+    target: "reality --agent",
+    description: "Reality with AI agent (use: vibecheck reality --agent)",
+  },
+};
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// 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() {
+  console.log(`
+  ${colors.accent}${c.bold}vibecheck labs${c.reset} - Experimental & Internal Features
+
+  ${c.yellow}${sym.warning} These features are experimental and may change without notice.${c.reset}
+`);
+
+  // 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`);
+    
+    for (const feature of groups.stub) {
+      const eta = feature.eta ? `${c.dim}(ETA: ${feature.eta})${c.reset}` : '';
+      console.log(`    ${c.dim}${feature.name}${c.reset}  ${feature.description} ${eta}`);
+    }
+    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}
+
+    vibecheck labs <feature> [options]
+
+  ${c.bold}Examples${c.reset}
+
+    ${c.dim}# Run AI agent testing${c.reset}
+    vibecheck labs ai-agent --url http://localhost:3000
+
+    ${c.dim}# Deep security scan${c.reset}
+    vibecheck labs security-audit
+
+    ${c.dim}# Smart AI fixes${c.reset}
+    vibecheck labs smart-fix
+
+  ${c.dim}${"─".repeat(60)}${c.reset}
+
+  ${c.bold}Feedback${c.reset}
+
+    Want a feature prioritized? Let us know:
+    ${c.cyan}https://github.com/vibecheckai/vibecheck/discussions${c.reset}
+`);
+}
+
+function printFeatureStub(name, feature) {
+  console.log(`
+  ${c.yellow}╭${"─".repeat(58)}╮${c.reset}
+  ${c.yellow}│${c.reset}  ${c.bold}vibecheck labs ${name}${c.reset}${" ".repeat(58 - 18 - name.length)}${c.yellow}│${c.reset}
+  ${c.yellow}╰${"─".repeat(58)}╯${c.reset}
+
+  ${feature.description}
+
+  ${c.dim}This feature is not yet implemented.${c.reset}
+  ${feature.eta ? `${c.dim}Expected: ${feature.eta}${c.reset}` : ""}
+
+  ${c.dim}Want this feature? Vote for it:${c.reset}
+  ${c.cyan}https://github.com/vibecheckai/vibecheck/discussions${c.reset}
+`);
+}
+
+function printAliasWarning(name, feature) {
+  console.log(`\n  ${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 = [], context = {}) {
+  // Filter out global flags that are passed through from main CLI
+  const GLOBAL_FLAGS = new Set([
+    '--offline', '--local', '--json', '--ci', '--quiet', '-q',
+    '--verbose', '--debug', '--strict', '--no-banner',
+  ]);
+  
+  // Find first non-flag argument as subcommand
+  let subCmd = null;
+  const subArgs = [];
+  let skipNext = false;
+  
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    
+    if (skipNext) {
+      skipNext = false;
+      continue;
+    }
+    
+    // Skip global flags (and their values for --path, --output)
+    if (GLOBAL_FLAGS.has(arg)) continue;
+    if (arg === '--path' || arg === '-p' || arg === '--output' || arg === '-o') {
+      skipNext = true;
+      continue;
+    }
+    if (arg.startsWith('--path=') || arg.startsWith('--output=')) continue;
+    
+    // First non-flag arg is the subcommand
+    if (!subCmd && !arg.startsWith('-')) {
+      subCmd = arg;
+    } else {
+      subArgs.push(arg);
+    }
+  }
+  
+  // Show help if no command
+  if (!subCmd || subCmd === "--help" || subCmd === "-h") {
+    printHelp();
+    return 0;
+  }
+  
+  // List all features
+  if (subCmd === "--list" || subCmd === "-l") {
+    console.log(`\n  ${c.bold}Labs Features${c.reset}\n`);
+    
+    for (const [name, f] of Object.entries(LABS_FEATURES)) {
+      if (f.status !== 'stub' && f.status !== 'alias') {
+        console.log(`  ${formatStatus(f.status).padEnd(30)} ${c.cyan}${name.padEnd(20)}${c.reset} ${c.dim}${f.description}${c.reset}`);
+      }
+    }
+    console.log("");
+    return 0;
+  }
+  
+  // Find feature
+  const feature = LABS_FEATURES[subCmd];
+  
+  if (!feature) {
+    console.log(`\n  ${c.red}${sym.cross}${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" && 
+      LABS_FEATURES[k].status !== "alias"
+    ).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 {
+      if (cmd === "ship") {
+        const { runShip } = require("./runShip");
+        return await runShip([...aliasArgs, ...subArgs], context);
+      }
+      if (cmd === "reality") {
+        const { runReality } = require("./runReality");
+        return await runReality([...aliasArgs, ...subArgs], context);
+      }
+    } 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(`\n  ${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(`\n  ${c.cyan}${sym.star} BETA:${c.reset} ${c.dim}Feedback welcome! github.com/vibecheckai/vibecheck${c.reset}\n`);
+    }
+    
+    return await runner(subArgs, context);
+  } catch (e) {
+    if (e.code === "MODULE_NOT_FOUND") {
+      console.log(`\n  ${c.red}${sym.cross}${c.reset} Feature '${subCmd}' is not available in this version.\n`);
+      console.log(`  ${c.dim}Try updating: npm update -g @vibecheck/cli${c.reset}\n`);
+    } else {
+      console.error(`\n  ${c.red}${sym.cross}${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 };