vibe-forge 0.4.0 → 0.8.1

package/bin/cli.js

@@ -1,325 +1,372 @@
-#!/usr/bin/env node
-
-/**
- * Vibe Forge CLI
- *
- * Usage:
- *   npx vibe-forge init          Initialize Forge in current project
- *   npx vibe-forge update        Update Forge to latest version
- *   npx vibe-forge --help        Show help
- */
-
-const { execSync, spawn } = require('child_process');
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-
-// Read version from package.json (single source of truth)
-const packageJson = require(path.join(__dirname, '..', 'package.json'));
-const VERSION = packageJson.version;
-const REPO_URL = 'https://github.com/SpasticPalate/vibe-forge.git';
-const FORGE_DIR = '_vibe-forge';
-
-// Colors for terminal output
-// NOTE: Intentionally self-contained - cli.js runs standalone via npx before
-// the rest of Vibe Forge is installed, so it cannot share with colors.sh
-const colors = {
-  reset: '\x1b[0m',
-  red: '\x1b[31m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  cyan: '\x1b[36m',
-};
-
-function log(message, color = colors.reset) {
-  console.log(`${color}${message}${colors.reset}`);
-}
-
-function logError(message) {
-  log(`Error: ${message}`, colors.red);
-}
-
-function logSuccess(message) {
-  log(message, colors.green);
-}
-
-function logInfo(message) {
-  log(message, colors.blue);
-}
-
-function showBanner() {
-  console.log(`
-${colors.yellow}🔥 Vibe Forge${colors.reset}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-Multi-agent development orchestration
-`);
-}
-
-function showHelp() {
-  showBanner();
-  console.log(`Usage: npx vibe-forge <command>
-
-Commands:
-  init      Initialize Vibe Forge in the current project
-  update    Update Vibe Forge to the latest version
-  version   Show version information
-  help      Show this help message
-
-Examples:
-  npx vibe-forge init     # Set up Forge in your project
-  npx vibe-forge update   # Update to latest version
-`);
-}
-
-function showVersion() {
-  console.log(`Vibe Forge v${VERSION}`);
-}
-
-function checkPrerequisites() {
-  // Check for git
-  try {
-    execSync('git --version', { stdio: 'pipe' });
-  } catch {
-    logError('Git is not installed. Please install Git first.');
-    logInfo('  Windows: winget install Git.Git');
-    logInfo('  macOS:   brew install git');
-    logInfo('  Linux:   sudo apt install git');
-    process.exit(1);
-  }
-
-  // Check for Claude Code
-  try {
-    execSync('claude --version', { stdio: 'pipe' });
-  } catch {
-    logError('Claude Code CLI is not installed.');
-    logInfo('  Install from: https://claude.ai/download');
-    process.exit(1);
-  }
-}
-
-function isWindows() {
-  return os.platform() === 'win32';
-}
-
-function getBashPath() {
-  if (!isWindows()) {
-    return 'bash';
-  }
-
-  // Common Git Bash paths on Windows
-  const paths = [
-    'C:\\Program Files\\Git\\bin\\bash.exe',
-    'C:\\Program Files (x86)\\Git\\bin\\bash.exe',
-    path.join(process.env.LOCALAPPDATA || '', 'Programs', 'Git', 'bin', 'bash.exe'),
-  ];
-
-  for (const p of paths) {
-    if (fs.existsSync(p)) {
-      return p;
-    }
-  }
-
-  // Try to find via where command
-  try {
-    const gitPath = execSync('where git', { stdio: 'pipe' }).toString().trim().split('\n')[0];
-    const gitDir = path.dirname(path.dirname(gitPath));
-    const bashPath = path.join(gitDir, 'bin', 'bash.exe');
-    if (fs.existsSync(bashPath)) {
-      return bashPath;
-    }
-  } catch {
-    // Ignore
-  }
-
-  return null;
-}
-
-function runBashScript(scriptPath, args = []) {
-  const bashPath = getBashPath();
-
-  if (!bashPath) {
-    logError('Could not find bash. Please install Git Bash on Windows.');
-    process.exit(1);
-  }
-
-  return new Promise((resolve, reject) => {
-    const child = spawn(bashPath, [scriptPath, ...args], {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-      env: {
-        ...process.env,
-        CLAUDE_CODE_GIT_BASH_PATH: bashPath,
-      },
-    });
-
-    child.on('close', (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Script exited with code ${code}`));
-      }
-    });
-
-    child.on('error', (err) => {
-      reject(err);
-    });
-  });
-}
-
-async function initCommand() {
-  showBanner();
-
-  const targetDir = path.join(process.cwd(), FORGE_DIR);
-
-  // Check if already initialized
-  if (fs.existsSync(targetDir)) {
-    logInfo(`Vibe Forge already exists at ${FORGE_DIR}/`);
-    log('');
-    log('To update, run: npx vibe-forge update');
-    log('To reinitialize, delete the _vibe-forge folder first.');
-    return;
-  }
-
-  logInfo('Checking prerequisites...');
-  checkPrerequisites();
-  logSuccess('Prerequisites OK');
-  log('');
-
-  // Clone the repository
-  logInfo(`Cloning Vibe Forge into ${FORGE_DIR}/...`);
-  try {
-    execSync(`git clone --depth 1 ${REPO_URL} ${FORGE_DIR}`, {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-    });
-    logSuccess('Clone complete');
-  } catch {
-    logError('Failed to clone repository');
-    process.exit(1);
-  }
-
-  log('');
-
-  // Update project's .gitignore to ignore tool internals but keep project data
-  updateGitignore();
-
-  // Run the setup script
-  logInfo('Running setup...');
-  log('');
-
-  try {
-    const setupScript = path.join(targetDir, 'bin', 'forge-setup.sh');
-    await runBashScript(setupScript);
-  } catch (err) {
-    logError(`Setup failed: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-function updateGitignore() {
-  const gitignorePath = path.join(process.cwd(), '.gitignore');
-  const forgeIgnoreMarker = '# Vibe Forge';
-  const forgeIgnoreBlock = `
-# Vibe Forge
-# Tool internals (regenerated on update)
-_vibe-forge/.git/
-_vibe-forge/bin/
-_vibe-forge/agents/
-_vibe-forge/config/
-_vibe-forge/docs/
-_vibe-forge/tests/
-_vibe-forge/src/
-_vibe-forge/node_modules/
-_vibe-forge/package*.json
-_vibe-forge/*.md
-_vibe-forge/LICENSE
-_vibe-forge/.github/
-
-# Keep project data (tasks, context) - these ARE committed
-# !_vibe-forge/tasks/
-# !_vibe-forge/context/
-# !_vibe-forge/.claude/
-`;
-
-  try {
-    let content = '';
-    if (fs.existsSync(gitignorePath)) {
-      content = fs.readFileSync(gitignorePath, 'utf8');
-      // Check if already has forge entries
-      if (content.includes(forgeIgnoreMarker)) {
-        return; // Already configured
-      }
-    }
-
-    // Append forge ignore block
-    const newContent = content.trimEnd() + '\n' + forgeIgnoreBlock;
-    fs.writeFileSync(gitignorePath, newContent);
-    logSuccess('Updated .gitignore for Vibe Forge');
-  } catch (err) {
-    logError(`Warning: Could not update .gitignore: ${err.message}`);
-  }
-}
-
-async function updateCommand() {
-  showBanner();
-
-  const targetDir = path.join(process.cwd(), FORGE_DIR);
-
-  // Check if initialized
-  if (!fs.existsSync(targetDir)) {
-    logError('Vibe Forge is not initialized in this project.');
-    log('');
-    log('Run: npx vibe-forge init');
-    process.exit(1);
-  }
-
-  logInfo('Updating Vibe Forge...');
-
-  try {
-    // Fetch and reset to origin/main - works even without tracking branch
-    execSync('git fetch origin', {
-      stdio: 'inherit',
-      cwd: targetDir,
-    });
-    execSync('git reset --hard origin/main', {
-      stdio: 'inherit',
-      cwd: targetDir,
-    });
-    logSuccess('Update complete');
-  } catch {
-    logError('Failed to update. Check your network connection or try deleting _vibe-forge and running init again.');
-    process.exit(1);
-  }
-}
-
-// Main entry point
-async function main() {
-  const args = process.argv.slice(2);
-  const command = args[0] || 'help';
-
-  switch (command) {
-    case 'init':
-      await initCommand();
-      break;
-    case 'update':
-      await updateCommand();
-      break;
-    case 'version':
-    case '--version':
-    case '-v':
-      showVersion();
-      break;
-    case 'help':
-    case '--help':
-    case '-h':
-    default:
-      showHelp();
-      break;
-  }
-}
-
-main().catch((err) => {
-  logError(err.message);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * Vibe Forge CLI
+ *
+ * Usage:
+ *   npx @sugar-crash-studios/vibe-forge init          Initialize Forge in current project
+ *   npx @sugar-crash-studios/vibe-forge update        Update Forge to latest version
+ *   npx @sugar-crash-studios/vibe-forge --help        Show help
+ */
+
+const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// Read version from package.json (single source of truth)
+const packageJson = require(path.join(__dirname, '..', 'package.json'));
+const VERSION = packageJson.version;
+const REPO_URL = 'https://github.com/sugar-crash-studios/vibe-forge.git';
+const FORGE_DIR = '_vibe-forge';
+
+// Colors for terminal output
+// NOTE: Intentionally duplicated from bin/lib/colors.sh
+// This is by design: cli.js runs standalone via npx before the rest of Vibe Forge
+// is installed, so it cannot import colors.sh. If you update colors here,
+// also update bin/lib/colors.sh to keep them in sync.
+const colors = {
+  reset: '\x1b[0m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m',
+};
+
+function log(message, color = colors.reset) {
+  console.log(`${color}${message}${colors.reset}`);
+}
+
+function logError(message) {
+  log(`Error: ${message}`, colors.red);
+}
+
+function logSuccess(message) {
+  log(message, colors.green);
+}
+
+function logInfo(message) {
+  log(message, colors.blue);
+}
+
+function showBanner() {
+  console.log(`
+${colors.yellow}🔥 Vibe Forge${colors.reset}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Multi-agent development orchestration
+`);
+}
+
+function showHelp() {
+  showBanner();
+  console.log(`Usage: npx @sugar-crash-studios/vibe-forge <command>
+
+Commands:
+  init      Initialize Vibe Forge in the current project
+  update    Update Vibe Forge to the latest version
+  agents    List all agents, roles, and aliases
+  version   Show version information
+  help      Show this help message
+
+Examples:
+  npx @sugar-crash-studios/vibe-forge init     # Set up Forge in your project
+  npx @sugar-crash-studios/vibe-forge update   # Update to latest version
+  npx @sugar-crash-studios/vibe-forge agents   # Show agent roster
+`);
+}
+
+function showAgents() {
+  const agentsFile = path.join(__dirname, '..', 'config', 'agents.json');
+  let agents = {};
+  try {
+    const data = JSON.parse(fs.readFileSync(agentsFile, 'utf8'));
+    agents = data.agents || {};
+  } catch (e) {
+    logError('Could not read agents.json');
+    logInfo('Run from inside a Vibe Forge installation, or run: npx @sugar-crash-studios/vibe-forge init');
+    return;
+  }
+
+  showBanner();
+  console.log(`${colors.yellow}Agent Roster${colors.reset}`);
+  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+  console.log('');
+
+  const typeOrder = ['core', 'worker', 'specialist', 'advisor'];
+  const typeLabels = {
+    core: 'Core (Always Running)',
+    worker: 'Workers (Per-Task)',
+    specialist: 'Specialists (On-Demand)',
+    advisor: 'Advisors',
+  };
+
+  for (const type of typeOrder) {
+    const group = Object.entries(agents).filter(([, a]) => a.type === type);
+    if (group.length === 0) continue;
+    console.log(`  ${colors.cyan}${typeLabels[type] || type}${colors.reset}`);
+    for (const [name, agent] of group) {
+      console.log(`    ${agent.icon || '  '} ${colors.yellow}${name}${colors.reset} — ${agent.role}`);
+      if (agent.aliases && agent.aliases.length > 0) {
+        console.log(`       aliases: ${agent.aliases.join(', ')}`);
+      }
+    }
+    console.log('');
+  }
+
+  console.log(`Spawn an agent:`);
+  console.log(`  ${colors.yellow}./bin/forge.sh spawn <agent-name-or-alias>${colors.reset}`);
+  console.log('');
+}
+
+function showVersion() {
+  console.log(`Vibe Forge v${VERSION}`);
+}
+
+function checkPrerequisites() {
+  // Check for git
+  try {
+    execSync('git --version', { stdio: 'pipe' });
+  } catch {
+    logError('Git is not installed. Please install Git first.');
+    logInfo('  Windows: winget install Git.Git');
+    logInfo('  macOS:   brew install git');
+    logInfo('  Linux:   sudo apt install git');
+    process.exit(1);
+  }
+
+  // Check for Claude Code
+  try {
+    execSync('claude --version', { stdio: 'pipe' });
+  } catch {
+    logError('Claude Code CLI is not installed.');
+    logInfo('  Install from: https://claude.ai/download');
+    process.exit(1);
+  }
+}
+
+function isWindows() {
+  return os.platform() === 'win32';
+}
+
+function getBashPath() {
+  if (!isWindows()) {
+    return 'bash';
+  }
+  // Delegate to shared terminal utility for Windows Git Bash detection
+  const { findGitBash } = require('./lib/terminal.js');
+  return findGitBash() || null;
+}
+
+function runBashScript(scriptPath, args = []) {
+  const bashPath = getBashPath();
+
+  if (!bashPath) {
+    logError('Could not find bash. Please install Git Bash on Windows.');
+    process.exit(1);
+  }
+
+  return new Promise((resolve, reject) => {
+    const child = spawn(bashPath, [scriptPath, ...args], {
+      stdio: 'inherit',
+      cwd: process.cwd(),
+      env: {
+        ...process.env,
+        CLAUDE_CODE_GIT_BASH_PATH: bashPath,
+      },
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Script exited with code ${code}`));
+      }
+    });
+
+    child.on('error', (err) => {
+      reject(err);
+    });
+  });
+}
+
+async function initCommand() {
+  showBanner();
+
+  const targetDir = path.join(process.cwd(), FORGE_DIR);
+
+  // Check if already initialized
+  if (fs.existsSync(targetDir)) {
+    logInfo(`Vibe Forge already exists at ${FORGE_DIR}/`);
+    log('');
+    log('To update, run: npx @sugar-crash-studios/vibe-forge update');
+    log('To reinitialize, delete the _vibe-forge folder first.');
+    return;
+  }
+
+  logInfo('Checking prerequisites...');
+  checkPrerequisites();
+  logSuccess('Prerequisites OK');
+  log('');
+
+  // Clone the repository
+  logInfo(`Cloning Vibe Forge into ${FORGE_DIR}/...`);
+  try {
+    execSync(`git clone --depth 1 ${REPO_URL} ${FORGE_DIR}`, {
+      stdio: 'inherit',
+      cwd: process.cwd(),
+    });
+    logSuccess('Clone complete');
+  } catch {
+    logError('Failed to clone repository');
+    process.exit(1);
+  }
+
+  log('');
+
+  // Validate agents.json (alias collisions)
+  validateAgentsConfig(targetDir);
+
+  // Update project's .gitignore to ignore tool internals but keep project data
+  updateGitignore();
+
+  // Run the setup script
+  logInfo('Running setup...');
+  log('');
+
+  try {
+    const setupScript = path.join(targetDir, 'bin', 'forge-setup.sh');
+    await runBashScript(setupScript);
+  } catch (err) {
+    logError(`Setup failed: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function validateAgentsConfig(forgeDir) {
+  const checkScript = path.join(forgeDir, 'bin', 'lib', 'check-aliases.js');
+  if (!fs.existsSync(checkScript)) return;
+
+  try {
+    const agentsFile = path.join(forgeDir, 'config', 'agents.json');
+    execSync(`node "${checkScript}" "${agentsFile}"`, { stdio: 'pipe' });
+    const config = JSON.parse(fs.readFileSync(agentsFile, 'utf8'));
+    const agentCount = Object.keys(config.agents || {}).length;
+    logSuccess(`Agent config valid (${agentCount} agents, no alias collisions)`);
+  } catch (err) {
+    logError('Agent alias collisions detected in config/agents.json');
+    logInfo(err.stderr ? err.stderr.toString().trim() : 'Run node bin/lib/check-aliases.js for details');
+    logError('Fix collisions before using Vibe Forge.');
+    process.exit(1);
+  }
+}
+
+function updateGitignore() {
+  const gitignorePath = path.join(process.cwd(), '.gitignore');
+  const forgeIgnoreMarker = '# Vibe Forge';
+  const forgeIgnoreBlock = `
+# Vibe Forge
+# Tool internals (regenerated on update)
+_vibe-forge/.git/
+_vibe-forge/bin/
+_vibe-forge/agents/
+_vibe-forge/config/
+_vibe-forge/docs/
+_vibe-forge/tests/
+_vibe-forge/src/
+_vibe-forge/node_modules/
+_vibe-forge/package*.json
+_vibe-forge/*.md
+_vibe-forge/LICENSE
+_vibe-forge/.github/
+
+# Keep project data (tasks, context) - these ARE committed
+# !_vibe-forge/tasks/
+# !_vibe-forge/context/
+# !_vibe-forge/.claude/
+`;
+
+  try {
+    let content = '';
+    if (fs.existsSync(gitignorePath)) {
+      content = fs.readFileSync(gitignorePath, 'utf8');
+      // Check if already has forge entries
+      if (content.includes(forgeIgnoreMarker)) {
+        return; // Already configured
+      }
+    }
+
+    // Append forge ignore block
+    const newContent = content.trimEnd() + '\n' + forgeIgnoreBlock;
+    fs.writeFileSync(gitignorePath, newContent);
+    logSuccess('Updated .gitignore for Vibe Forge');
+  } catch (err) {
+    logError(`Warning: Could not update .gitignore: ${err.message}`);
+  }
+}
+
+async function updateCommand() {
+  showBanner();
+
+  const targetDir = path.join(process.cwd(), FORGE_DIR);
+
+  // Check if initialized
+  if (!fs.existsSync(targetDir)) {
+    logError('Vibe Forge is not initialized in this project.');
+    log('');
+    log('Run: npx @sugar-crash-studios/vibe-forge init');
+    process.exit(1);
+  }
+
+  logInfo('Updating Vibe Forge...');
+
+  try {
+    // Fetch and reset to origin/main - works even without tracking branch
+    execSync('git fetch origin', {
+      stdio: 'inherit',
+      cwd: targetDir,
+    });
+    execSync('git reset --hard origin/main', {
+      stdio: 'inherit',
+      cwd: targetDir,
+    });
+    logSuccess('Update complete');
+  } catch {
+    logError('Failed to update. Check your network connection or try deleting _vibe-forge and running init again.');
+    process.exit(1);
+  }
+}
+
+// Main entry point
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] || 'help';
+
+  switch (command) {
+    case 'init':
+      await initCommand();
+      break;
+    case 'update':
+      await updateCommand();
+      break;
+    case 'agents':
+      showAgents();
+      break;
+    case 'version':
+    case '--version':
+    case '-v':
+      showVersion();
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+    default:
+      showHelp();
+      break;
+  }
+}
+
+main().catch((err) => {
+  logError(err.message);
+  process.exit(1);
+});