@vibecheckai/cli 3.5.0 → 3.5.2

package/bin/runners/runConductor.js

@@ -1,772 +0,0 @@
-/**
- * vibecheck conductor - Multi-Agent Coordination
- * 
- * ═══════════════════════════════════════════════════════════════════════════════
- * ENTERPRISE EDITION - Agent Orchestration
- * ═══════════════════════════════════════════════════════════════════════════════
- * 
- * Manages multiple AI agents working on the same codebase:
- * - Agent registration and status tracking
- * - File locking to prevent concurrent edits
- * - Change proposals with conflict detection
- * 
- * Commands:
- *   vibecheck conductor status        - Show coordination status
- *   vibecheck conductor register      - Register a new agent
- *   vibecheck conductor unregister    - Unregister an agent
- *   vibecheck conductor lock          - Acquire a file lock
- *   vibecheck conductor unlock        - Release a file lock
- *   vibecheck conductor propose       - Submit a change proposal
- *   vibecheck conductor proposals     - List proposals
- *   vibecheck conductor agents        - List registered agents
- *   vibecheck conductor locks         - List active locks
- *   vibecheck conductor history       - Show recent events
- *   vibecheck conductor cleanup       - Clean up stale state
- */
-
-"use strict";
-
-const { Conductor } = require("./lib/conductor");
-const { parseGlobalFlags, shouldShowBanner, isJsonMode } = require("./lib/global-flags");
-const { EXIT } = require("./lib/exit-codes");
-const { c, rgb, icons } = require("./lib/terminal-ui");
-
-// Unified Output System
-const { output } = require("./lib/output/index.js");
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// TERMINAL STYLING
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const colors = {
-  primary: rgb(150, 200, 255),
-  success: rgb(100, 255, 150),
-  warning: rgb(255, 200, 100),
-  error: rgb(255, 100, 100),
-  muted: rgb(120, 120, 140),
-  accent: rgb(200, 150, 255),
-  agent: rgb(100, 200, 255),
-  lock: rgb(255, 180, 100),
-  proposal: rgb(150, 255, 200),
-};
-
-const ICONS = {
-  conductor: '🎭',
-  agent: '🤖',
-  lock: '🔒',
-  unlock: '🔓',
-  proposal: '📝',
-  conflict: '⚠️',
-  check: '✓',
-  cross: '✗',
-  bullet: '•',
-  arrow: '→',
-  clock: '⏱️',
-  sparkle: '✨',
-};
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// BANNER
-// ═══════════════════════════════════════════════════════════════════════════════
-
-const CONDUCTOR_BANNER = `
-${rgb(150, 200, 255)}   ██████╗ ██████╗ ███╗   ██╗██████╗ ██╗   ██╗ ██████╗████████╗ ██████╗ ██████╗ ${c.reset}
-${rgb(130, 180, 255)}  ██╔════╝██╔═══██╗████╗  ██║██╔══██╗██║   ██║██╔════╝╚══██╔══╝██╔═══██╗██╔══██╗${c.reset}
-${rgb(110, 160, 255)}  ██║     ██║   ██║██╔██╗ ██║██║  ██║██║   ██║██║        ██║   ██║   ██║██████╔╝${c.reset}
-${rgb(90, 140, 255)}  ██║     ██║   ██║██║╚██╗██║██║  ██║██║   ██║██║        ██║   ██║   ██║██╔══██╗${c.reset}
-${rgb(70, 120, 255)}  ╚██████╗╚██████╔╝██║ ╚████║██████╔╝╚██████╔╝╚██████╗   ██║   ╚██████╔╝██║  ██║${c.reset}
-${rgb(50, 100, 255)}   ╚═════╝ ╚═════╝ ╚═╝  ╚═══╝╚═════╝  ╚═════╝  ╚═════╝   ╚═╝    ╚═════╝ ╚═╝  ╚═╝${c.reset}
-`;
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// OUTPUT HELPERS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-function printBanner() {
-  console.log(CONDUCTOR_BANNER);
-  console.log(`${c.dim}  ┌─────────────────────────────────────────────────────────────────────────┐${c.reset}`);
-  console.log(`${c.dim}  │${c.reset}  ${ICONS.conductor} ${c.bold}CONDUCTOR${c.reset} ${c.dim}•${c.reset} ${colors.muted}Multi-Agent Coordination${c.reset} ${c.dim}•${c.reset} ${colors.muted}Conflict Prevention${c.reset}  ${c.dim}│${c.reset}`);
-  console.log(`${c.dim}  └─────────────────────────────────────────────────────────────────────────┘${c.reset}`);
-  console.log();
-}
-
-function printHeader(text, icon = ICONS.conductor) {
-  console.log();
-  console.log(`${colors.primary}${icon} ${c.bold}${text}${c.reset}`);
-  console.log(`${c.dim}${'─'.repeat(60)}${c.reset}`);
-}
-
-function printSuccess(message) {
-  console.log(`${colors.success}${ICONS.check}${c.reset} ${message}`);
-}
-
-function printError(message) {
-  console.log(`${colors.error}${ICONS.cross}${c.reset} ${message}`);
-}
-
-function printWarning(message) {
-  console.log(`${colors.warning}${ICONS.conflict}${c.reset} ${message}`);
-}
-
-function printInfo(label, value) {
-  console.log(`  ${colors.muted}${label}:${c.reset} ${value}`);
-}
-
-function formatDuration(ms) {
-  if (ms < 1000) return `${ms}ms`;
-  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
-  if (ms < 3600000) return `${Math.floor(ms / 60000)}m ${Math.floor((ms % 60000) / 1000)}s`;
-  return `${Math.floor(ms / 3600000)}h ${Math.floor((ms % 3600000) / 60000)}m`;
-}
-
-function formatTimestamp(iso) {
-  const date = new Date(iso);
-  const now = new Date();
-  const diff = now - date;
-  
-  if (diff < 60000) return "just now";
-  if (diff < 3600000) return `${Math.floor(diff / 60000)}m ago`;
-  if (diff < 86400000) return `${Math.floor(diff / 3600000)}h ago`;
-  return date.toLocaleDateString();
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// SUBCOMMANDS
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Show conductor status overview
- */
-async function runStatus(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  const status = conductor.getStatus();
-  
-  if (options.json) {
-    console.log(JSON.stringify(status, null, 2));
-    return { exitCode: EXIT.OK, status };
-  }
-  
-  if (shouldShowBanner(options)) {
-    printBanner();
-  }
-  
-  printHeader("Conductor Status", ICONS.conductor);
-  
-  // Agents
-  console.log();
-  console.log(`  ${ICONS.agent} ${c.bold}Agents${c.reset}`);
-  printInfo("    Active", `${colors.success}${status.activeAgents}${c.reset}`);
-  printInfo("    Total", `${status.totalAgents}`);
-  
-  // Locks
-  console.log();
-  console.log(`  ${ICONS.lock} ${c.bold}Locks${c.reset}`);
-  printInfo("    Active", `${colors.lock}${status.activeLocks}${c.reset}`);
-  printInfo("    Total", `${status.totalLocks}`);
-  
-  // Proposals
-  console.log();
-  console.log(`  ${ICONS.proposal} ${c.bold}Proposals${c.reset}`);
-  printInfo("    Pending", `${colors.proposal}${status.pendingProposals}${c.reset}`);
-  printInfo("    Conflicts", status.conflictProposals > 0 
-    ? `${colors.warning}${status.conflictProposals}${c.reset}` 
-    : `${colors.muted}0${c.reset}`);
-  printInfo("    Total", `${status.totalProposals}`);
-  
-  // Metadata
-  console.log();
-  console.log(`  ${ICONS.clock} ${c.bold}Timeline${c.reset}`);
-  if (status.stateCreated) {
-    printInfo("    Created", formatTimestamp(status.stateCreated));
-  }
-  if (status.lastUpdated) {
-    printInfo("    Updated", formatTimestamp(status.lastUpdated));
-  }
-  printInfo("    Events", `${status.historyCount}`);
-  
-  console.log();
-  
-  return { exitCode: EXIT.OK, status };
-}
-
-/**
- * Register a new agent
- */
-async function runRegister(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const agentInfo = {
-    name: options.name || options._[0] || `agent-${Date.now()}`,
-    type: options.type || "ai-assistant",
-    capabilities: options.capabilities ? options.capabilities.split(",") : [],
-    metadata: options.metadata ? JSON.parse(options.metadata) : {}
-  };
-  
-  const agentId = await conductor.registerAgent(agentInfo);
-  
-  if (options.json) {
-    console.log(JSON.stringify({ success: true, agentId, ...agentInfo }, null, 2));
-    return { exitCode: EXIT.OK, agentId };
-  }
-  
-  printHeader("Agent Registered", ICONS.agent);
-  printSuccess(`Agent registered successfully`);
-  console.log();
-  printInfo("Agent ID", `${colors.accent}${agentId}${c.reset}`);
-  printInfo("Name", agentInfo.name);
-  printInfo("Type", agentInfo.type);
-  console.log();
-  console.log(`${c.dim}  Use this ID for lock/propose operations${c.reset}`);
-  console.log();
-  
-  return { exitCode: EXIT.OK, agentId };
-}
-
-/**
- * Unregister an agent
- */
-async function runUnregister(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const agentId = options.agentId || options._[0];
-  
-  if (!agentId) {
-    printError("Agent ID required. Use --agent-id <id> or provide as argument.");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  const result = await conductor.unregisterAgent(agentId);
-  
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return { exitCode: result.success ? EXIT.OK : EXIT.ERROR, result };
-  }
-  
-  if (result.success) {
-    printHeader("Agent Unregistered", ICONS.agent);
-    printSuccess(`Agent ${agentId} unregistered`);
-    if (result.releasedLocks.length > 0) {
-      console.log();
-      console.log(`${c.dim}  Released locks:${c.reset}`);
-      for (const lock of result.releasedLocks) {
-        console.log(`    ${ICONS.unlock} ${lock}`);
-      }
-    }
-  } else {
-    printError(`Failed to unregister: ${result.reason}`);
-  }
-  
-  console.log();
-  return { exitCode: result.success ? EXIT.OK : EXIT.ERROR, result };
-}
-
-/**
- * Acquire a file lock
- */
-async function runLock(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const agentId = options.agentId || options["agent-id"];
-  const filePath = options.file || options._[0];
-  const reason = options.reason || "editing";
-  
-  if (!agentId) {
-    printError("Agent ID required. Use --agent-id <id>");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  if (!filePath) {
-    printError("File path required. Use --file <path> or provide as argument.");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  const result = await conductor.acquireLock(agentId, filePath, reason);
-  
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return { exitCode: result.success ? EXIT.OK : EXIT.ERROR, result };
-  }
-  
-  if (result.success) {
-    printHeader("Lock Acquired", ICONS.lock);
-    printSuccess(`Lock acquired on ${filePath}`);
-    printInfo("Lock ID", result.lockId);
-    printInfo("Agent", agentId);
-    printInfo("Reason", reason);
-  } else {
-    printHeader("Lock Failed", ICONS.lock);
-    printError(`Cannot acquire lock: ${result.reason}`);
-    if (result.holder) {
-      printInfo("Current holder", result.holderName || result.holder);
-      printInfo("Holder reason", result.holderReason || "not specified");
-      printInfo("Expires in", formatDuration(result.expiresIn));
-    }
-  }
-  
-  console.log();
-  return { exitCode: result.success ? EXIT.OK : EXIT.ERROR, result };
-}
-
-/**
- * Release a file lock
- */
-async function runUnlock(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const agentId = options.agentId || options["agent-id"];
-  const filePath = options.file || options._[0];
-  
-  if (!agentId) {
-    printError("Agent ID required. Use --agent-id <id>");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  if (!filePath) {
-    printError("File path required. Use --file <path> or provide as argument.");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  const result = await conductor.releaseLock(agentId, filePath);
-  
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return { exitCode: result.success ? EXIT.OK : EXIT.ERROR, result };
-  }
-  
-  if (result.success) {
-    printHeader("Lock Released", ICONS.unlock);
-    printSuccess(`Lock released on ${filePath}`);
-  } else {
-    printError(`Cannot release lock: ${result.reason}`);
-    if (result.holder) {
-      printInfo("Current holder", result.holder);
-    }
-  }
-  
-  console.log();
-  return { exitCode: result.success ? EXIT.OK : EXIT.ERROR, result };
-}
-
-/**
- * Submit a change proposal
- */
-async function runPropose(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const agentId = options.agentId || options["agent-id"];
-  const description = options.description || options._[0] || "";
-  const files = options.files ? options.files.split(",") : [];
-  const priority = options.priority || "normal";
-  
-  if (!agentId) {
-    printError("Agent ID required. Use --agent-id <id>");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  if (!description) {
-    printError("Description required. Use --description <text> or provide as argument.");
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  const proposal = await conductor.propose(agentId, {
-    description,
-    files,
-    priority
-  });
-  
-  if (options.json) {
-    console.log(JSON.stringify(proposal, null, 2));
-    return { exitCode: proposal.status === "conflict" ? EXIT.WARN : EXIT.OK, proposal };
-  }
-  
-  printHeader("Proposal Created", ICONS.proposal);
-  
-  if (proposal.status === "conflict") {
-    printWarning("Proposal has conflicts with existing proposals");
-  } else {
-    printSuccess("Proposal submitted successfully");
-  }
-  
-  console.log();
-  printInfo("Proposal ID", `${colors.accent}${proposal.id}${c.reset}`);
-  printInfo("Status", proposal.status === "conflict" 
-    ? `${colors.warning}${proposal.status}${c.reset}` 
-    : `${colors.success}${proposal.status}${c.reset}`);
-  printInfo("Description", description);
-  
-  if (files.length > 0) {
-    console.log();
-    console.log(`  ${c.dim}Files:${c.reset}`);
-    for (const file of files) {
-      console.log(`    ${ICONS.bullet} ${file}`);
-    }
-  }
-  
-  if (proposal.conflicts && proposal.conflicts.length > 0) {
-    console.log();
-    console.log(`  ${colors.warning}Conflicts:${c.reset}`);
-    for (const conflict of proposal.conflicts) {
-      console.log(`    ${ICONS.conflict} Proposal ${conflict.proposalId.slice(0, 8)}... (${conflict.agentName})`);
-      console.log(`      ${c.dim}Files: ${conflict.files.join(", ")}${c.reset}`);
-    }
-  }
-  
-  console.log();
-  return { exitCode: proposal.status === "conflict" ? EXIT.WARN : EXIT.OK, proposal };
-}
-
-/**
- * List proposals
- */
-async function runProposals(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const filter = {};
-  if (options.status) filter.status = options.status;
-  if (options.agentId) filter.agentId = options.agentId;
-  if (options.conflicts) filter.hasConflicts = true;
-  
-  const proposals = conductor.listProposals(filter);
-  
-  if (options.json) {
-    console.log(JSON.stringify(proposals, null, 2));
-    return { exitCode: EXIT.OK, proposals };
-  }
-  
-  printHeader("Proposals", ICONS.proposal);
-  
-  if (proposals.length === 0) {
-    console.log(`  ${c.dim}No proposals found${c.reset}`);
-  } else {
-    for (const p of proposals) {
-      const statusColor = p.status === "conflict" ? colors.warning :
-                          p.status === "pending" ? colors.proposal :
-                          p.status === "approved" ? colors.success : colors.muted;
-      
-      console.log();
-      console.log(`  ${ICONS.proposal} ${c.bold}${p.id.slice(0, 8)}...${c.reset}`);
-      printInfo("    Status", `${statusColor}${p.status}${c.reset}`);
-      printInfo("    Agent", p.agentName);
-      printInfo("    Description", p.description || "(none)");
-      printInfo("    Created", formatTimestamp(p.createdAt));
-      
-      if (p.files && p.files.length > 0) {
-        printInfo("    Files", p.files.join(", "));
-      }
-      
-      if (p.conflicts && p.conflicts.length > 0) {
-        printInfo("    Conflicts", `${colors.warning}${p.conflicts.length}${c.reset}`);
-      }
-    }
-  }
-  
-  console.log();
-  return { exitCode: EXIT.OK, proposals };
-}
-
-/**
- * List registered agents
- */
-async function runAgents(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const activeOnly = options.active || false;
-  const agents = conductor.listAgents(activeOnly);
-  
-  if (options.json) {
-    console.log(JSON.stringify(agents, null, 2));
-    return { exitCode: EXIT.OK, agents };
-  }
-  
-  printHeader("Registered Agents", ICONS.agent);
-  
-  if (agents.length === 0) {
-    console.log(`  ${c.dim}No agents registered${c.reset}`);
-  } else {
-    for (const agent of agents) {
-      const statusColor = agent.status === "active" ? colors.success :
-                          agent.status === "inactive" ? colors.warning : colors.muted;
-      
-      console.log();
-      console.log(`  ${ICONS.agent} ${c.bold}${agent.name}${c.reset}`);
-      printInfo("    ID", `${colors.muted}${agent.id}${c.reset}`);
-      printInfo("    Type", agent.type);
-      printInfo("    Status", `${statusColor}${agent.status}${c.reset}`);
-      printInfo("    Last seen", formatTimestamp(agent.lastSeen));
-    }
-  }
-  
-  console.log();
-  return { exitCode: EXIT.OK, agents };
-}
-
-/**
- * List active locks
- */
-async function runLocks(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const locks = conductor.listLocks();
-  
-  if (options.json) {
-    console.log(JSON.stringify(locks, null, 2));
-    return { exitCode: EXIT.OK, locks };
-  }
-  
-  printHeader("Active Locks", ICONS.lock);
-  
-  const activeLocks = locks.filter(l => !l.stale);
-  const staleLocks = locks.filter(l => l.stale);
-  
-  if (activeLocks.length === 0 && staleLocks.length === 0) {
-    console.log(`  ${c.dim}No active locks${c.reset}`);
-  } else {
-    if (activeLocks.length > 0) {
-      console.log();
-      console.log(`  ${colors.success}Active (${activeLocks.length})${c.reset}`);
-      for (const lock of activeLocks) {
-        console.log();
-        console.log(`    ${ICONS.lock} ${c.bold}${lock.filePath}${c.reset}`);
-        printInfo("      Holder", lock.agentName);
-        printInfo("      Reason", lock.reason || "(none)");
-        printInfo("      Age", formatDuration(lock.lockAge));
-      }
-    }
-    
-    if (staleLocks.length > 0) {
-      console.log();
-      console.log(`  ${colors.warning}Stale (${staleLocks.length})${c.reset}`);
-      for (const lock of staleLocks) {
-        console.log();
-        console.log(`    ${ICONS.unlock} ${c.dim}${lock.filePath}${c.reset}`);
-        printInfo("      Former holder", lock.agentName);
-        printInfo("      Age", `${colors.warning}${formatDuration(lock.lockAge)}${c.reset} (expired)`);
-      }
-    }
-  }
-  
-  console.log();
-  return { exitCode: EXIT.OK, locks };
-}
-
-/**
- * Show recent history
- */
-async function runHistory(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const limit = options.limit || 20;
-  const history = conductor.getHistory(limit);
-  
-  if (options.json) {
-    console.log(JSON.stringify(history, null, 2));
-    return { exitCode: EXIT.OK, history };
-  }
-  
-  printHeader("Recent Events", ICONS.clock);
-  
-  if (history.length === 0) {
-    console.log(`  ${c.dim}No events recorded${c.reset}`);
-  } else {
-    for (const event of history) {
-      const icon = event.type.includes("lock") ? ICONS.lock :
-                   event.type.includes("agent") ? ICONS.agent :
-                   event.type.includes("proposal") ? ICONS.proposal : ICONS.bullet;
-      
-      console.log();
-      console.log(`  ${icon} ${c.bold}${event.type}${c.reset} ${c.dim}${formatTimestamp(event.timestamp)}${c.reset}`);
-      
-      // Show relevant details based on event type
-      if (event.agentId) printInfo("    Agent", event.agentId.slice(0, 8) + "...");
-      if (event.filePath) printInfo("    File", event.filePath);
-      if (event.proposalId) printInfo("    Proposal", event.proposalId.slice(0, 8) + "...");
-      if (event.reason) printInfo("    Reason", event.reason);
-    }
-  }
-  
-  console.log();
-  return { exitCode: EXIT.OK, history };
-}
-
-/**
- * Clean up stale state
- */
-async function runCleanup(options) {
-  const conductor = new Conductor(options.projectPath || process.cwd());
-  await conductor.load();
-  
-  const result = await conductor.cleanup();
-  
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-    return { exitCode: EXIT.OK, result };
-  }
-  
-  printHeader("Cleanup Complete", ICONS.sparkle);
-  printInfo("Stale locks removed", result.locks);
-  printInfo("Inactive agents marked", result.agents);
-  
-  console.log();
-  return { exitCode: EXIT.OK, result };
-}
-
-// ═══════════════════════════════════════════════════════════════════════════════
-// MAIN ENTRY POINT
-// ═══════════════════════════════════════════════════════════════════════════════
-
-/**
- * Main conductor command router
- */
-async function runConductor(args = [], options = {}) {
-  const globalFlags = parseGlobalFlags(args);
-  const mergedOptions = { ...options, ...globalFlags };
-  
-  // Get subcommand from args
-  const subcommand = (mergedOptions._ && mergedOptions._[0]) || args[0] || "status";
-  
-  // Remove subcommand from positional args
-  if (mergedOptions._ && mergedOptions._[0] === subcommand) {
-    mergedOptions._ = mergedOptions._.slice(1);
-  }
-  
-  // Route to appropriate subcommand
-  const commands = {
-    status: runStatus,
-    register: runRegister,
-    unregister: runUnregister,
-    lock: runLock,
-    unlock: runUnlock,
-    propose: runPropose,
-    proposals: runProposals,
-    agents: runAgents,
-    locks: runLocks,
-    history: runHistory,
-    cleanup: runCleanup,
-    help: () => runHelp(mergedOptions)
-  };
-  
-  const handler = commands[subcommand];
-  
-  if (!handler) {
-    printError(`Unknown subcommand: ${subcommand}`);
-    console.log();
-    console.log(`${c.dim}Available commands: ${Object.keys(commands).join(", ")}${c.reset}`);
-    console.log();
-    return { exitCode: EXIT.ERROR };
-  }
-  
-  try {
-    return await handler(mergedOptions);
-  } catch (error) {
-    printError(`Error: ${error.message}`);
-    if (mergedOptions.debug) {
-      console.error(error.stack);
-    }
-    return { exitCode: EXIT.ERROR, error: error.message };
-  }
-}
-
-/**
- * Show help
- */
-function runHelp(options) {
-  if (!options.json) {
-    printBanner();
-  }
-  
-  const help = {
-    name: "conductor",
-    description: "Multi-agent coordination for AI assistants",
-    commands: {
-      status: "Show coordination status overview",
-      register: "Register a new agent (--name, --type)",
-      unregister: "Unregister an agent (--agent-id)",
-      lock: "Acquire a file lock (--agent-id, --file, --reason)",
-      unlock: "Release a file lock (--agent-id, --file)",
-      propose: "Submit a change proposal (--agent-id, --description, --files)",
-      proposals: "List proposals (--status, --conflicts)",
-      agents: "List registered agents (--active)",
-      locks: "List active file locks",
-      history: "Show recent events (--limit)",
-      cleanup: "Clean up stale locks and agents"
-    },
-    examples: [
-      "vibecheck conductor status",
-      "vibecheck conductor register --name cursor-agent --type ai-assistant",
-      "vibecheck conductor lock --agent-id <id> --file src/app.ts --reason 'adding feature'",
-      "vibecheck conductor propose --agent-id <id> --description 'Add auth' --files 'src/auth.ts,src/middleware.ts'",
-      "vibecheck conductor proposals --status conflict"
-    ]
-  };
-  
-  if (options.json) {
-    console.log(JSON.stringify(help, null, 2));
-    return { exitCode: EXIT.OK };
-  }
-  
-  console.log(`${c.bold}Commands:${c.reset}`);
-  for (const [cmd, desc] of Object.entries(help.commands)) {
-    console.log(`  ${colors.primary}${cmd.padEnd(14)}${c.reset} ${desc}`);
-  }
-  
-  console.log();
-  console.log(`${c.bold}Examples:${c.reset}`);
-  for (const example of help.examples) {
-    console.log(`  ${c.dim}$${c.reset} ${example}`);
-  }
-  
-  console.log();
-  return { exitCode: EXIT.OK };
-}
-
-// Named exports for registry
-async function runConductorStatus(args = [], options = {}) {
-  return runStatus({ ...options, _: args });
-}
-
-async function runConductorRegister(args = [], options = {}) {
-  return runRegister({ ...options, _: args });
-}
-
-async function runConductorLock(args = [], options = {}) {
-  return runLock({ ...options, _: args });
-}
-
-async function runConductorUnlock(args = [], options = {}) {
-  return runUnlock({ ...options, _: args });
-}
-
-async function runConductorPropose(args = [], options = {}) {
-  return runPropose({ ...options, _: args });
-}
-
-module.exports = {
-  runConductor,
-  runStatus,
-  runRegister,
-  runUnregister,
-  runLock,
-  runUnlock,
-  runPropose,
-  runProposals,
-  runAgents,
-  runLocks,
-  runHistory,
-  runCleanup,
-  // Registry exports
-  runConductorStatus,
-  runConductorRegister,
-  runConductorLock,
-  runConductorUnlock,
-  runConductorPropose,
-};