@vibecheckai/cli 3.4.0 → 3.5.0

package/bin/registry.js

@@ -7,37 +7,45 @@
  * Simple 2-tier model:
  * - FREE ($0): Inspect & Observe
  * - PRO ($69/mo): Fix, Prove & Enforce
+ * 
+ * SCAN = Quick lint (5 core engines, fast, FREE)
+ * SHIP = Comprehensive verdict (all engines + proof cert, PRO)
  */
 
 "use strict";
 
 // ─────────────────────────────────────────────────────────────
-// CLI COMMANDS (2-tier: FREE / PRO)
+// CLI COMMANDS (22 total - 2-tier: FREE / PRO)
 // ─────────────────────────────────────────────────────────────
 const ALLOWED_COMMANDS = new Set([
-  // FREE (10) - Inspect & Observe
-  "init",       // one-time setup
-  "doctor",     // health check
-  "watch",      // continuous mode
-  "scan",       // static analysis
-  "report",     // generate reports
-  "context",    // generate IDE rules
-  "classify",   // Authority: inventory (read-only)
-  "login",      // authenticate
-  "logout",     // remove credentials
-  "whoami",     // show current user
-
-  // PRO (9) - Fix, Prove & Enforce
-  "ship",       // verdict engine (GO/NO-GO)
-  "fix",        // AI-powered fixes
-  "prove",      // runtime proof
-  "reality",    // browser verification
-  "gate",       // CI/CD enforcement
-  "guard",      // AI guardrails
-  "mcp",        // MCP server
-  "checkpoint", // baseline comparison
-  "approve",    // Authority: verdicts
-  "polish",     // production polish
+  // FREE (12) - Inspect & Observe
+  "scan",            // quick lint - 5 core engines
+  "context",         // generate truthpack + IDE rules
+  "watch",           // real-time file watching
+  "doctor",          // environment diagnostics
+  "report",          // generate HTML/SARIF reports
+  "authority",       // authority system main command
+  "authority.list",  // list available authorities
+  "guard",           // agent firewall (observe mode FREE, enforce mode PRO)
+  "login",           // authenticate
+  "logout",          // clear auth
+  "whoami",          // show current user
+  "init",            // one-time setup (legacy, redirects to context)
+
+  // PRO (12) - Fix, Prove & Enforce
+  "ship",               // comprehensive - all engines, verdict, proof cert
+  "fix",                // AI-powered fixes with LLM
+  "polish",             // production hardening
+  "reality",            // playwright browser verification
+  "prove",              // full proof loop with evidence pack
+  "gate",               // CI/CD enforcement
+  "ai-test",            // AI agent for autonomous app testing
+  "authority.approve",  // get authority verdict
+  "conductor.status",   // multi-agent coordination status
+  "conductor.register", // register AI agent
+  "conductor.lock",     // acquire file lock
+  "conductor.unlock",   // release file lock
+  "conductor.propose",  // submit change proposal
 ]);
 
 function assertAllowedOnly(obj) {
@@ -55,39 +63,39 @@ const COMMANDS = {
   // FREE TIER - Inspect & Observe
   // ══════════════════════════════════════════════════════════════
 
-  init: {
-    description: "One-time setup (config + contracts + scripts)",
-    longDescription: "Initialize vibecheck in your project. Creates configuration files, sets up IDE rules, and optionally connects to the dashboard.",
+  scan: {
+    description: "Quick lint - 5 core engines, fast feedback",
+    longDescription: "Fast static analysis using 5 core engines: secrets, mock data, console logs, type issues, and security vulnerabilities. Use for rapid feedback during development.",
     tier: "free",
-    category: "setup",
-    aliases: ["setup", "configure"],
-    runner: () => require("./runners/runInit").runInit,
+    category: "analysis",
+    aliases: ["s", "check", "lint"],
+    runner: () => require("./runners/runScan").runScan,
     examples: [
-      { command: "vibecheck init", description: "Interactive setup wizard" },
-      { command: "vibecheck init --local", description: "Quick local-only setup" },
-      { command: "vibecheck init --quick", description: "Non-interactive defaults" },
+      { command: "vibecheck scan", description: "Quick scan with 5 core engines" },
+      { command: "vibecheck scan --json", description: "JSON output for CI" },
+      { command: "vibecheck scan --allowlist list", description: "View suppressed findings" },
     ],
-    related: ["doctor", "scan"],
+    related: ["ship", "fix", "report"],
   },
 
-  doctor: {
-    description: "Environment + dependency + config health check",
-    longDescription: "Comprehensive diagnostics for your development environment.",
+  context: {
+    description: "Generate truthpack + IDE rules (.cursorrules, MDC, Copilot)",
+    longDescription: "Generate project-aware AI coding rules and truthpack for your IDE. Creates .cursorrules, MDC files, and other IDE configurations.",
     tier: "free",
     category: "setup",
-    aliases: ["health", "diag"],
-    runner: () => require("./runners/runDoctor").runDoctor,
+    aliases: ["rules", "ai-rules", "mdc", "ctx", "init"],
+    runner: () => require("./runners/runContext").runContext,
     examples: [
-      { command: "vibecheck doctor", description: "Run all health checks" },
-      { command: "vibecheck doctor --fix", description: "Auto-fix detected issues" },
-      { command: "vibecheck doctor --json", description: "Output as JSON" },
+      { command: "vibecheck context", description: "Generate all IDE rules + truthpack" },
+      { command: "vibecheck context --format cursor", description: ".cursorrules only" },
+      { command: "vibecheck context --format mdc", description: "MDC files only" },
     ],
-    related: ["init", "scan"],
+    related: ["scan", "guard"],
   },
 
   watch: {
-    description: "Continuous mode - re-runs on changes",
-    longDescription: "File watcher that automatically re-runs scans when your code changes.",
+    description: "Real-time file watching - re-runs scan on changes",
+    longDescription: "File watcher that automatically re-runs quick scan when your code changes.",
     tier: "free",
     category: "setup",
     aliases: ["w", "dev"],
@@ -99,24 +107,24 @@ const COMMANDS = {
     related: ["scan"],
   },
 
-  scan: {
-    description: "Static code analysis; use --allowlist for false positives",
-    longDescription: "Scan your codebase for route integrity issues, security vulnerabilities, and code quality problems.",
+  doctor: {
+    description: "Environment diagnostics - config and dependency health check",
+    longDescription: "Comprehensive diagnostics for your development environment, configuration, and dependencies.",
     tier: "free",
-    category: "proof",
-    aliases: ["s", "check"],
-    runner: () => require("./runners/runScan").runScan,
+    category: "setup",
+    aliases: ["health", "diag"],
+    runner: () => require("./runners/runDoctor").runDoctor,
     examples: [
-      { command: "vibecheck scan", description: "Quick scan" },
-      { command: "vibecheck scan --profile full", description: "Full scan" },
-      { command: "vibecheck scan --allowlist list", description: "View suppressed findings" },
+      { command: "vibecheck doctor", description: "Run all health checks" },
+      { command: "vibecheck doctor --fix", description: "Auto-fix detected issues" },
+      { command: "vibecheck doctor --json", description: "Output as JSON" },
     ],
-    related: ["ship", "fix", "report"],
+    related: ["context", "scan"],
   },
 
   report: {
-    description: "Generate HTML/MD/SARIF reports",
-    longDescription: "Create shareable reports from scan results.",
+    description: "Generate HTML/SARIF reports from scan results",
+    longDescription: "Create shareable reports from scan results in HTML, Markdown, or SARIF format.",
     tier: "free",
     category: "output",
     aliases: ["html", "artifact"],
@@ -126,42 +134,42 @@ const COMMANDS = {
       { command: "vibecheck report --format md", description: "Markdown report" },
       { command: "vibecheck report --format sarif", description: "SARIF for GitHub" },
     ],
-    related: ["scan"],
+    related: ["scan", "ship"],
   },
 
-  context: {
-    description: "Generate IDE rules (.cursorrules, MDC, Copilot)",
-    longDescription: "Generate project-aware AI coding rules for your IDE.",
+  "authority": {
+    description: "Authority System - automated and human approvals",
+    longDescription: "Request approval from built-in authorities (security, architecture, compliance, quality) or human reviewers. Use 'authority list' to see available authorities and 'authority approve' to request approval.",
     tier: "free",
-    category: "truth",
-    aliases: ["rules", "ai-rules", "mdc", "ctx"],
-    runner: () => require("./runners/runContext").runContext,
+    category: "authority",
+    aliases: ["auth"],
+    runner: () => require("./runners/runAuthority").runAuthority,
     examples: [
-      { command: "vibecheck context", description: "Generate all IDE rules" },
-      { command: "vibecheck context --format cursor", description: ".cursorrules only" },
+      { command: "vibecheck authority list", description: "List all authorities" },
+      { command: "vibecheck authority approve --authority security", description: "Security review" },
+      { command: "vibecheck authority approve -a quality -a security", description: "Multi-authority" },
     ],
-    related: ["scan", "guard"],
+    related: ["authority.list", "authority.approve", "ship"],
   },
 
-  classify: {
-    description: "Inventory authority - duplication & legacy code maps",
-    longDescription: "Read-only inventory of your codebase including duplication maps and legacy code detection.",
+  "authority.list": {
+    description: "List available authorities",
+    longDescription: "List all available authorities for code analysis and approval workflows.",
     tier: "free",
     category: "authority",
-    aliases: ["inventory", "audit"],
-    runner: () => require("./runners/runClassify").runClassify,
+    aliases: ["authorities", "auth-list"],
+    runner: () => require("./runners/runAuthority").runAuthority,
     examples: [
-      { command: "vibecheck classify", description: "Quick inventory" },
-      { command: "vibecheck classify --json", description: "JSON output" },
+      { command: "vibecheck authority list", description: "List all authorities" },
     ],
-    related: ["approve", "scan"],
+    related: ["authority", "authority.approve"],
   },
 
   login: {
     description: "Authenticate with API key",
-    longDescription: "Connect your CLI to the vibecheck API.",
+    longDescription: "Connect your CLI to the vibecheck API with your API key.",
     tier: "free",
-    category: "account",
+    category: "auth",
     aliases: ["auth", "signin"],
     runner: () => require("./runners/runAuth").runLogin,
     skipAuth: true,
@@ -173,9 +181,10 @@ const COMMANDS = {
   },
 
   logout: {
-    description: "Remove stored credentials",
+    description: "Clear stored credentials",
+    longDescription: "Remove stored authentication credentials from your system.",
     tier: "free",
-    category: "account",
+    category: "auth",
     aliases: ["signout"],
     runner: () => require("./runners/runAuth").runLogout,
     skipAuth: true,
@@ -187,8 +196,9 @@ const COMMANDS = {
 
   whoami: {
     description: "Show current user and plan",
+    longDescription: "Display information about the currently authenticated user and their subscription plan.",
     tier: "free",
-    category: "account",
+    category: "auth",
     aliases: ["me", "user"],
     runner: () => require("./runners/runAuth").runWhoami,
     skipAuth: true,
@@ -198,16 +208,29 @@ const COMMANDS = {
     related: ["login", "logout"],
   },
 
+  init: {
+    description: "One-time setup (alias for context)",
+    longDescription: "Initialize vibecheck in your project. Alias for 'vibecheck context'.",
+    tier: "free",
+    category: "setup",
+    aliases: ["setup", "configure"],
+    runner: () => require("./runners/runContext").runContext,
+    examples: [
+      { command: "vibecheck init", description: "Initialize project" },
+    ],
+    related: ["context", "doctor"],
+  },
+
   // ══════════════════════════════════════════════════════════════
   // PRO TIER ($69/mo) - Fix, Prove & Enforce
   // ══════════════════════════════════════════════════════════════
 
   ship: {
-    description: "Verdict engine - SHIP / WARN / BLOCK",
-    longDescription: "The final word on whether your code is ready to ship. Combines all scan results and generates a clear verdict.",
+    description: "Comprehensive verdict - ALL engines + route validation + proof cert",
+    longDescription: "The final word on whether your code is ready to ship. Runs ALL 15+ analysis engines, validates routes and contracts, generates proof certificate. SHIP/WARN/BLOCK verdict.",
     tier: "pro",
-    category: "proof",
-    aliases: ["verdict", "go"],
+    category: "analysis",
+    aliases: ["verdict", "go", "full"],
     runner: () => require("./runners/runShip").runShip,
     examples: [
       { command: "vibecheck ship", description: "Get shipping verdict" },
@@ -218,131 +241,199 @@ const COMMANDS = {
   },
 
   fix: {
-    description: "AI-powered auto-fix for findings",
-    longDescription: "Generate AI prompts to fix detected issues. Use --apply to let AI make changes directly.",
+    description: "AI-powered auto-fix with LLM",
+    longDescription: "Generate AI-powered fixes for detected issues. Uses LLM to analyze and fix problems automatically.",
     tier: "pro",
-    category: "proof",
-    aliases: ["f", "repair"],
+    category: "repair",
+    aliases: ["f", "repair", "autofix"],
     runner: () => require("./runners/runFix").runFix,
     examples: [
       { command: "vibecheck fix", description: "Generate fix missions" },
       { command: "vibecheck fix --apply", description: "Apply AI fixes" },
       { command: "vibecheck fix --loop", description: "Fix loop until clean" },
     ],
-    related: ["scan", "ship"],
+    related: ["scan", "ship", "polish"],
   },
 
-  prove: {
-    description: "Full proof loop with runtime verification",
-    longDescription: "Complete verification cycle with runtime testing and evidence generation.",
+  polish: {
+    description: "Production hardening - console removal, dead code, type strengthening",
+    longDescription: "Automated code transformations for production readiness. Removes console statements, unused imports, strengthens types, and more - all without requiring an LLM.",
     tier: "pro",
-    category: "proof",
-    aliases: ["p", "verify"],
-    runner: () => require("./runners/runProve").runProve,
+    category: "repair",
+    aliases: ["prod", "final", "harden"],
+    runner: () => require("./runners/runPolish").runPolish,
     examples: [
-      { command: "vibecheck prove", description: "Run full proof loop" },
-      { command: "vibecheck prove --url http://localhost:3000", description: "With runtime testing" },
-      { command: "vibecheck prove --bundle", description: "Generate evidence pack" },
+      { command: "vibecheck polish", description: "Dry-run - preview changes" },
+      { command: "vibecheck polish --apply", description: "Apply all auto-fixes" },
+      { command: "vibecheck polish --passes remove-consoles,dead-code", description: "Run specific passes" },
+      { command: "vibecheck polish --safe-only --apply", description: "Apply only safe fixes" },
+      { command: "vibecheck polish --list-passes", description: "List available passes" },
     ],
-    related: ["ship", "reality"],
+    related: ["ship", "fix", "scan"],
   },
 
   reality: {
-    description: "Browser-based runtime verification",
-    longDescription: "Verify your app's runtime behavior with Playwright-powered browser testing.",
+    description: "Playwright browser verification - test runtime behavior",
+    longDescription: "Verify your app's runtime behavior with Playwright-powered browser testing. Tests actual API responses, UI behavior, and auth flows.",
     tier: "pro",
-    category: "proof",
-    aliases: ["browser", "e2e"],
+    category: "verification",
+    aliases: ["browser", "e2e", "playwright"],
     runner: () => require("./runners/runReality").runReality,
     examples: [
       { command: "vibecheck reality --url http://localhost:3000", description: "Test localhost" },
       { command: "vibecheck reality --auth email:pass", description: "With authentication" },
-      { command: "vibecheck reality --agent", description: "AI agent testing" },
+      { command: "vibecheck reality --record", description: "Record video evidence" },
     ],
-    related: ["prove", "ship"],
+    related: ["prove", "ship", "ai-test"],
+  },
+
+  "ai-test": {
+    description: "AI agent for autonomous app testing",
+    longDescription: "AI-powered autonomous testing that explores your app like a real user. Supports common scenarios like login, checkout, and signup flows.",
+    tier: "pro",
+    category: "verification",
+    aliases: ["agent", "autonomous"],
+    runner: () => require("./runners/runAIAgent").runAIAgent,
+    examples: [
+      { command: "vibecheck ai-test --url http://localhost:3000", description: "Explore app autonomously" },
+      { command: "vibecheck ai-test --url http://localhost:3000 --scenario login", description: "Test login flow" },
+      { command: "vibecheck ai-test --url http://localhost:3000 --headed", description: "Watch the AI test" },
+    ],
+    related: ["reality", "prove"],
+  },
+
+  prove: {
+    description: "Full proof loop with evidence pack",
+    longDescription: "Complete verification cycle: scan + reality check + evidence generation. Creates cryptographically signed proof pack.",
+    tier: "pro",
+    category: "verification",
+    aliases: ["p", "verify", "evidence"],
+    runner: () => require("./runners/runProve").runProve,
+    examples: [
+      { command: "vibecheck prove", description: "Run full proof loop" },
+      { command: "vibecheck prove --url http://localhost:3000", description: "With runtime testing" },
+      { command: "vibecheck prove --bundle", description: "Generate evidence pack" },
+    ],
+    related: ["ship", "reality"],
   },
 
   gate: {
-    description: "CI/CD enforcement - fail builds on issues",
-    longDescription: "Enforce quality gates in your CI/CD pipeline.",
+    description: "CI/CD enforcement - blocks deploys on issues",
+    longDescription: "Enforce quality gates in your CI/CD pipeline. Returns exit code 1 on failures to block deployments.",
     tier: "pro",
     category: "automation",
-    aliases: ["ci", "enforce"],
+    aliases: ["ci", "enforce", "block"],
     runner: () => require("./runners/runGuard").runGate,
     examples: [
       { command: "vibecheck gate", description: "Run CI gate check" },
-      { command: "vibecheck gate --strict", description: "Strict mode" },
+      { command: "vibecheck gate --strict", description: "Strict mode (fail on warnings)" },
+      { command: "vibecheck gate --threshold 80", description: "Custom score threshold" },
     ],
     related: ["ship", "scan"],
   },
 
   guard: {
-    description: "AI guardrails - prompt firewall & hallucination checking",
-    longDescription: "Validate AI-generated code and prompts. Detects prompt injection and verifies claims.",
-    tier: "pro",
-    category: "truth",
-    aliases: ["ai-guard", "firewall", "validate"],
+    description: "Agent firewall - monitors/blocks AI agent actions",
+    longDescription: "AI agent firewall that validates file writes, command execution, and content. Observe mode (FREE) logs violations. Enforce mode (PRO) blocks violations. Protects against forbidden paths, dangerous commands, and hallucination patterns.",
+    tier: "free",
+    category: "firewall",
+    skipAuth: true,  // Allow observe mode without authentication
+    aliases: ["firewall", "ai-guard"],
     runner: () => require("./runners/runGuard").runGuard,
     examples: [
-      { command: "vibecheck guard", description: "Run all guardrail checks" },
-      { command: "vibecheck guard --claims", description: "Verify AI claims" },
+      { command: "vibecheck guard --init", description: "Initialize firewall config" },
+      { command: "vibecheck guard --mode observe --action write --path .env", description: "Check path (observe)" },
+      { command: "vibecheck guard --mode enforce --action write --path .env", description: "Block write (PRO)" },
+      { command: "vibecheck guard --action execute --command \"rm -rf /\"", description: "Validate command" },
+      { command: "vibecheck guard --claims", description: "Verify AI claims (legacy)" },
     ],
-    related: ["context", "fix"],
+    related: ["context", "fix", "scan"],
   },
 
-  mcp: {
-    description: "Start MCP server for AI IDEs",
-    longDescription: "Launch an MCP server for AI IDE integration.",
+  "authority.approve": {
+    description: "Get authority verdict - APPROVED/REJECTED/PENDING with proofs",
+    longDescription: "Request approval from an authority for a specific action. Returns structured verdict with evidence and findings.",
     tier: "pro",
-    category: "automation",
-    aliases: [],
-    runner: () => require("./runners/runMcp").runMcp,
+    category: "authority",
+    aliases: ["auth-verdict"],
+    runner: () => {
+      const { runAuthority } = require("./runners/runAuthority");
+      return (args, context) => runAuthority(['approve', ...args], context);
+    },
     examples: [
-      { command: "vibecheck mcp", description: "Start MCP server" },
-      { command: "vibecheck mcp --port 3099", description: "Custom port" },
+      { command: "vibecheck authority approve --authority security", description: "Security review" },
+      { command: "vibecheck authority approve -a security -a quality", description: "Multi-authority" },
+      { command: "vibecheck authority approve -a security --json", description: "JSON output" },
     ],
-    related: ["context"],
+    related: ["authority", "authority.list", "ship"],
   },
 
-  checkpoint: {
-    description: "Compare baseline vs current, hallucination scoring",
-    longDescription: "Track changes between scan runs. Detects new issues, resolved issues, and regressions.",
+  "conductor.status": {
+    description: "Multi-agent coordination status",
+    longDescription: "View status of registered AI agents, active locks, and pending proposals.",
     tier: "pro",
-    category: "analysis",
-    aliases: ["cp", "compare", "diff"],
-    runner: () => require("./runners/runCheckpoint").runCheckpoint,
+    category: "coordination",
+    aliases: ["cstatus"],
+    runner: () => require("./runners/runConductor").runConductorStatus,
     examples: [
-      { command: "vibecheck checkpoint", description: "Compare against baseline" },
-      { command: "vibecheck checkpoint --set", description: "Save new baseline" },
+      { command: "vibecheck conductor.status", description: "View coordination status" },
+      { command: "vibecheck conductor.status --json", description: "JSON output" },
     ],
-    related: ["scan", "fix"],
+    related: ["conductor.register", "conductor.lock"],
   },
 
-  approve: {
-    description: "Authority verdicts - PROCEED/STOP/DEFER with proofs",
-    longDescription: "Execute authorities to get structured verdicts with proofs.",
+  "conductor.register": {
+    description: "Register AI agent for coordination",
+    longDescription: "Register an AI agent with the conductor for multi-agent coordination.",
     tier: "pro",
-    category: "authority",
-    aliases: ["auth-verdict", "authority"],
-    runner: () => require("./runners/runApprove").runApprove,
+    category: "coordination",
+    aliases: ["cregister"],
+    runner: () => require("./runners/runConductor").runConductorRegister,
     examples: [
-      { command: "vibecheck approve safe-consolidation", description: "Run authority" },
-      { command: "vibecheck approve --list", description: "List authorities" },
+      { command: "vibecheck conductor.register --name cursor", description: "Register agent" },
     ],
-    related: ["classify", "ship"],
+    related: ["conductor.status", "conductor.lock"],
   },
 
-  polish: {
-    description: "Production polish - final cleanup before deploy",
-    longDescription: "Final production readiness checks and cleanup.",
+  "conductor.lock": {
+    description: "Acquire file lock for exclusive editing",
+    longDescription: "Acquire a lock on files for exclusive editing by an AI agent.",
     tier: "pro",
-    category: "proof",
-    aliases: ["prod", "final"],
-    runner: () => require("./runners/runPolish").runPolish,
+    category: "coordination",
+    aliases: ["clock"],
+    runner: () => require("./runners/runConductor").runConductorLock,
+    examples: [
+      { command: "vibecheck conductor.lock src/file.ts", description: "Lock file" },
+      { command: "vibecheck conductor.lock --agent cursor src/", description: "Lock directory" },
+    ],
+    related: ["conductor.unlock", "conductor.status"],
+  },
+
+  "conductor.unlock": {
+    description: "Release file lock",
+    longDescription: "Release a previously acquired lock on files.",
+    tier: "pro",
+    category: "coordination",
+    aliases: ["cunlock"],
+    runner: () => require("./runners/runConductor").runConductorUnlock,
+    examples: [
+      { command: "vibecheck conductor.unlock src/file.ts", description: "Unlock file" },
+      { command: "vibecheck conductor.unlock --all", description: "Release all locks" },
+    ],
+    related: ["conductor.lock", "conductor.status"],
+  },
+
+  "conductor.propose": {
+    description: "Submit change proposal for review",
+    longDescription: "Submit a proposed change for review by the conductor before applying.",
+    tier: "pro",
+    category: "coordination",
+    aliases: ["cpropose"],
+    runner: () => require("./runners/runConductor").runConductorPropose,
     examples: [
-      { command: "vibecheck polish", description: "Run polish checks" },
+      { command: "vibecheck conductor.propose --diff changes.patch", description: "Submit proposal" },
     ],
-    related: ["ship", "prove"],
+    related: ["conductor.status", "authority.approve"],
   },
 };
 

package/bin/runners/cli-utils.js

@@ -2,39 +2,8 @@
 // vibecheck CLI UTILS - Professional Terminal Styling
 // ═══════════════════════════════════════════════════════════════════════════
 
-// ANSI color codes
-const c = {
-  reset: '\x1b[0m',
-  bold: '\x1b[1m',
-  dim: '\x1b[2m',
-  italic: '\x1b[3m',
-  underline: '\x1b[4m',
-  // Colors
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  magenta: '\x1b[35m',
-  cyan: '\x1b[36m',
-  white: '\x1b[37m',
-  gray: '\x1b[90m',
-  // Bright colors
-  brightRed: '\x1b[91m',
-  brightGreen: '\x1b[92m',
-  brightYellow: '\x1b[93m',
-  brightBlue: '\x1b[94m',
-  brightMagenta: '\x1b[95m',
-  brightCyan: '\x1b[96m',
-  brightWhite: '\x1b[97m',
-  // Background
-  bgRed: '\x1b[41m',
-  bgGreen: '\x1b[42m',
-  bgYellow: '\x1b[43m',
-  bgBlue: '\x1b[44m',
-  bgMagenta: '\x1b[45m',
-  bgCyan: '\x1b[46m',
-  bgGray: '\x1b[100m',
-};
+// Terminal UI - Import from shared module
+const { c, icons, Spinner, rgb, bgRgb } = require("./lib/terminal-ui");
 
 // ASCII Art Banner
 const BANNER = `