bmad-method 4.2.0 → 4.4.0

package/tools/installer/bin/bmad.js

@@ -1,24 +1,34 @@
 #!/usr/bin/env node
 
 const { program } = require('commander');
-const inquirer = require('inquirer');
-const chalk = require('chalk');
-const path = require('path');
+
+// Dynamic imports for ES modules
+let chalk, inquirer;
+
+// Initialize ES modules
+async function initializeModules() {
+  if (!chalk) {
+    chalk = (await import('chalk')).default;
+    inquirer = (await import('inquirer')).default;
+  }
+}
 
 // Handle both execution contexts (from root via npx or from installer directory)
-let version, installer;
+let version;
+let installer;
 try {
   // Try installer context first (when run from tools/installer/)
   version = require('../package.json').version;
   installer = require('../lib/installer');
 } catch (e) {
   // Fall back to root context (when run via npx from GitHub)
+  console.log(`Installer context not found (${e.message}), trying root context...`);
   try {
     version = require('../../../package.json').version;
     installer = require('../../../tools/installer/lib/installer');
   } catch (e2) {
-    console.error(chalk.red('Error: Could not load required modules. Please ensure you are running from the correct directory.'));
-    console.error(chalk.yellow('Debug info:'), {
+    console.error('Error: Could not load required modules. Please ensure you are running from the correct directory.');
+    console.error('Debug info:', {
       __dirname,
       cwd: process.cwd(),
       error: e2.message
@@ -36,25 +46,27 @@ program
   .description('Install BMAD Method agents and tools')
   .option('-f, --full', 'Install complete .bmad-core folder')
   .option('-a, --agent <agent>', 'Install specific agent with dependencies')
-  .option('-d, --directory <path>', 'Installation directory (default: ./bmad-core)')
-  .option('-i, --ide <ide>', 'Configure for specific IDE (cursor, claude-code, windsurf, roo)')
+  .option('-d, --directory <path>', 'Installation directory (default: .bmad-core)')
+  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, roo)')
   .action(async (options) => {
     try {
+      await initializeModules();
       if (!options.full && !options.agent) {
         // Interactive mode
-        const answers = await promptInstallation(options);
+        const answers = await promptInstallation();
         await installer.install(answers);
       } else {
         // Direct mode
         const config = {
           installType: options.full ? 'full' : 'single-agent',
           agent: options.agent,
-          directory: options.directory || './.bmad-core',
-          ide: options.ide
+          directory: options.directory || '.bmad-core',
+          ides: options.ide || []
         };
         await installer.install(config);
       }
     } catch (error) {
+      if (!chalk) await initializeModules();
       console.error(chalk.red('Installation failed:'), error.message);
       process.exit(1);
     }
@@ -65,10 +77,11 @@ program
   .description('Update existing BMAD installation')
   .option('--force', 'Force update, overwriting modified files')
   .option('--dry-run', 'Show what would be updated without making changes')
-  .action(async (options) => {
+  .action(async () => {
     try {
-      await installer.update(options);
+      await installer.update();
     } catch (error) {
+      if (!chalk) await initializeModules();
       console.error(chalk.red('Update failed:'), error.message);
       process.exit(1);
     }
@@ -81,6 +94,7 @@ program
     try {
       await installer.listAgents();
     } catch (error) {
+      if (!chalk) await initializeModules();
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }
@@ -93,27 +107,29 @@ program
     try {
       await installer.showStatus();
     } catch (error) {
+      if (!chalk) await initializeModules();
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }
   });
 
-async function promptInstallation(options) {
+async function promptInstallation() {
+  await initializeModules();
   console.log(chalk.bold.blue(`\nWelcome to BMAD Method Installer v${version}\n`));
-  
+
   const answers = {};
-  
+
   // Ask for installation directory
   const { directory } = await inquirer.prompt([
     {
       type: 'input',
       name: 'directory',
       message: 'Where would you like to install BMAD?',
-      default: './.bmad-core'
+      default: '.bmad-core'
     }
   ]);
   answers.directory = directory;
-  
+
   // Ask for installation type
   const { installType } = await inquirer.prompt([
     {
@@ -133,7 +149,7 @@ async function promptInstallation(options) {
     }
   ]);
   answers.installType = installType;
-  
+
   // If single agent, ask which one
   if (installType === 'single-agent') {
     const agents = await installer.getAvailableAgents();
@@ -150,24 +166,29 @@ async function promptInstallation(options) {
     ]);
     answers.agent = agent;
   }
-  
+
   // Ask for IDE configuration
-  const { ide } = await inquirer.prompt([
+  const { ides } = await inquirer.prompt([
     {
-      type: 'list',
-      name: 'ide',
-      message: 'Which IDE are you using?',
+      type: 'checkbox',
+      name: 'ides',
+      message: 'Which IDE(s) are you using? (Select all that apply)',
       choices: [
         { name: 'Cursor', value: 'cursor' },
         { name: 'Claude Code', value: 'claude-code' },
         { name: 'Windsurf', value: 'windsurf' },
-        { name: 'Roo Code', value: 'roo' },
-        { name: 'Other/Manual setup', value: null }
-      ]
+        { name: 'Roo Code', value: 'roo' }
+      ],
+      validate: (answer) => {
+        if (answer.length < 1) {
+          return 'You must choose at least one IDE, or press Ctrl+C to skip IDE setup.';
+        }
+        return true;
+      }
     }
   ]);
-  answers.ide = ide;
-  
+  answers.ides = ides;
+
   return answers;
 }
 

package/tools/installer/lib/file-manager.js

@@ -2,7 +2,16 @@ const fs = require("fs-extra");
 const path = require("path");
 const crypto = require("crypto");
 const glob = require("glob");
-const chalk = require("chalk");
+
+// Dynamic import for ES module
+let chalk;
+
+// Initialize ES modules
+async function initializeModules() {
+  if (!chalk) {
+    chalk = (await import("chalk")).default;
+  }
+}
 
 class FileManager {
   constructor() {
@@ -16,6 +25,7 @@ class FileManager {
       await fs.copy(source, destination);
       return true;
     } catch (error) {
+      await initializeModules();
       console.error(chalk.red(`Failed to copy ${source}:`), error.message);
       return false;
     }
@@ -27,6 +37,7 @@ class FileManager {
       await fs.copy(source, destination);
       return true;
     } catch (error) {
+      await initializeModules();
       console.error(
         chalk.red(`Failed to copy directory ${source}:`),
         error.message
@@ -72,11 +83,12 @@ class FileManager {
     );
 
     const manifest = {
-      version: require("../package.json").version,
+      version: require("../../../package.json").version,
       installed_at: new Date().toISOString(),
       install_type: config.installType,
       agent: config.agent || null,
       ide_setup: config.ide || null,
+      ides_setup: config.ides || [],
       files: [],
     };
 
@@ -145,7 +157,12 @@ class FileManager {
   }
 
   async ensureDirectory(dirPath) {
-    await fs.ensureDir(dirPath);
+    try {
+      await fs.ensureDir(dirPath);
+      return true;
+    } catch (error) {
+      throw error;
+    }
   }
 
   async pathExists(filePath) {

package/tools/installer/lib/ide-setup.js

@@ -1,10 +1,20 @@
 const path = require("path");
 const fileManager = require("./file-manager");
 const configLoader = require("./config-loader");
-const chalk = require("chalk");
+
+// Dynamic import for ES module
+let chalk;
+
+// Initialize ES modules
+async function initializeModules() {
+  if (!chalk) {
+    chalk = (await import("chalk")).default;
+  }
+}
 
 class IdeSetup {
   async setup(ide, installDir, selectedAgent = null) {
+    await initializeModules();
     const ideConfig = await configLoader.getIdeConfiguration(ide);
 
     if (!ideConfig) {

package/tools/installer/lib/installer.js

@@ -1,18 +1,94 @@
-const path = require("path");
-const chalk = require("chalk");
-const ora = require("ora");
-const inquirer = require("inquirer");
+const path = require("node:path");
 const fileManager = require("./file-manager");
 const configLoader = require("./config-loader");
 const ideSetup = require("./ide-setup");
 
+// Dynamic imports for ES modules
+let chalk, ora, inquirer;
+
+// Initialize ES modules
+async function initializeModules() {
+  if (!chalk) {
+    chalk = (await import("chalk")).default;
+    ora = (await import("ora")).default;
+    inquirer = (await import("inquirer")).default;
+  }
+}
+
 class Installer {
   async install(config) {
+    // Initialize ES modules
+    await initializeModules();
+    
     const spinner = ora("Analyzing installation directory...").start();
 
     try {
       // Resolve installation directory
-      const installDir = path.resolve(config.directory);
+      let installDir = path.resolve(config.directory);
+      if (path.basename(installDir) === '.bmad-core') {
+        // If user points directly to .bmad-core, treat its parent as the project root
+        installDir = path.dirname(installDir);
+      }
+
+      // Check if directory exists and handle non-existent directories
+      if (!(await fileManager.pathExists(installDir))) {
+        spinner.stop();
+        console.log(chalk.yellow(`\nThe directory ${chalk.bold(installDir)} does not exist.`));
+        
+        const { action } = await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'action',
+            message: 'What would you like to do?',
+            choices: [
+              {
+                name: 'Create the directory and continue',
+                value: 'create'
+              },
+              {
+                name: 'Choose a different directory',
+                value: 'change'
+              },
+              {
+                name: 'Cancel installation',
+                value: 'cancel'
+              }
+            ]
+          }
+        ]);
+
+        if (action === 'cancel') {
+          console.log(chalk.red('Installation cancelled.'));
+          process.exit(0);
+        } else if (action === 'change') {
+          const { newDirectory } = await inquirer.prompt([
+            {
+              type: 'input',
+              name: 'newDirectory',
+              message: 'Enter the new directory path:',
+              validate: (input) => {
+                if (!input.trim()) {
+                  return 'Please enter a valid directory path';
+                }
+                return true;
+              }
+            }
+          ]);
+          config.directory = newDirectory;
+          return await this.install(config); // Recursive call with new directory
+        } else if (action === 'create') {
+          try {
+            await fileManager.ensureDirectory(installDir);
+            console.log(chalk.green(`✓ Created directory: ${installDir}`));
+          } catch (error) {
+            console.error(chalk.red(`Failed to create directory: ${error.message}`));
+            console.error(chalk.yellow('You may need to check permissions or use a different path.'));
+            process.exit(1);
+          }
+        }
+        
+        spinner.start("Analyzing installation directory...");
+      }
 
       // Detect current state
       const state = await this.detectInstallationState(installDir);
@@ -53,6 +129,8 @@ class Installer {
   }
 
   async detectInstallationState(installDir) {
+    // Ensure modules are initialized
+    await initializeModules();
     const state = {
       type: "clean",
       hasV4Manifest: false,
@@ -75,7 +153,7 @@ class Installer {
       state.type = "v4_existing";
       state.hasV4Manifest = true;
       state.hasBmadCore = true;
-      state.manifest = await fileManager.readManifest(bmadCorePath);
+      state.manifest = await fileManager.readManifest(installDir);
       return state;
     }
 
@@ -103,15 +181,17 @@ class Installer {
     });
 
     if (files.length > 0) {
-      state.type = "unknown_existing";
+      // Directory has other files, but no BMAD installation.
+      // Treat as clean install but record that it isn't empty.
       state.hasOtherFiles = true;
-      return state;
     }
 
     return state; // clean install
   }
 
   async performFreshInstall(config, installDir, spinner) {
+    // Ensure modules are initialized
+    await initializeModules();
     spinner.text = "Installing BMAD Method...";
 
     let files = [];
@@ -182,9 +262,12 @@ class Installer {
     }
 
     // Set up IDE integration if requested
-    if (config.ide) {
-      spinner.text = `Setting up ${config.ide} integration...`;
-      await ideSetup.setup(config.ide, installDir, config.agent);
+    const ides = config.ides || (config.ide ? [config.ide] : []);
+    if (ides.length > 0) {
+      for (const ide of ides) {
+        spinner.text = `Setting up ${ide} integration...`;
+        await ideSetup.setup(ide, installDir, config.agent);
+      }
     }
 
     // Create manifest
@@ -196,6 +279,8 @@ class Installer {
   }
 
   async handleExistingV4Installation(config, installDir, state, spinner) {
+    // Ensure modules are initialized
+    await initializeModules();
     spinner.stop();
 
     console.log(chalk.yellow("\n🔍 Found existing BMAD v4 installation"));
@@ -222,7 +307,7 @@ class Installer {
 
     switch (action) {
       case "update":
-        return await this.performUpdate(installDir, state.manifest, spinner);
+        return await this.performUpdate(config, installDir, state.manifest, spinner);
       case "reinstall":
         return await this.performReinstall(config, installDir, spinner);
       case "cancel":
@@ -232,6 +317,8 @@ class Installer {
   }
 
   async handleV3Installation(config, installDir, state, spinner) {
+    // Ensure modules are initialized
+    await initializeModules();
     spinner.stop();
 
     console.log(
@@ -253,11 +340,12 @@ class Installer {
     ]);
 
     switch (action) {
-      case "upgrade":
+      case "upgrade": {
         console.log(chalk.cyan("\n📦 Starting v3 to v4 upgrade process..."));
         const V3ToV4Upgrader = require("../../upgraders/v3-to-v4-upgrader");
         const upgrader = new V3ToV4Upgrader();
         return await upgrader.upgrade({ projectPath: installDir });
+      }
       case "alongside":
         return await this.performFreshInstall(config, installDir, spinner);
       case "cancel":
@@ -267,6 +355,8 @@ class Installer {
   }
 
   async handleUnknownInstallation(config, installDir, state, spinner) {
+    // Ensure modules are initialized
+    await initializeModules();
     spinner.stop();
 
     console.log(chalk.yellow("\n⚠️  Directory contains existing files"));
@@ -295,7 +385,7 @@ class Installer {
     switch (action) {
       case "force":
         return await this.performFreshInstall(config, installDir, spinner);
-      case "different":
+      case "different": {
         const { newDir } = await inquirer.prompt([
           {
             type: "input",
@@ -306,13 +396,14 @@ class Installer {
         ]);
         config.directory = newDir;
         return await this.install(config);
+      }
       case "cancel":
         console.log("Installation cancelled.");
         return;
     }
   }
 
-  async performUpdate(installDir, manifest, spinner) {
+  async performUpdate(newConfig, installDir, manifest, spinner) {
     spinner.start("Checking for updates...");
 
     try {
@@ -326,7 +417,9 @@ class Installer {
       if (modifiedFiles.length > 0) {
         spinner.warn("Found modified files");
         console.log(chalk.yellow("\nThe following files have been modified:"));
-        modifiedFiles.forEach((file) => console.log(`  - ${file}`));
+        for (const file of modifiedFiles) {
+          console.log(`  - ${file}`);
+        }
 
         const { action } = await inquirer.prompt([
           {
@@ -364,7 +457,7 @@ class Installer {
         installType: manifest.install_type,
         agent: manifest.agent,
         directory: installDir,
-        ide: manifest.ide_setup,
+        ide: newConfig.ide || manifest.ide_setup, // Use new IDE choice if provided
       };
 
       await this.performFreshInstall(config, installDir, spinner);
@@ -389,13 +482,16 @@ class Installer {
   showSuccessMessage(config, installDir) {
     console.log(chalk.green("\n✓ BMAD Method installed successfully!\n"));
 
-    if (config.ide) {
-      const ideConfig = configLoader.getIdeConfiguration(config.ide);
-      if (ideConfig && ideConfig.instructions) {
-        console.log(
-          chalk.bold("To use BMAD agents in " + ideConfig.name + ":")
-        );
-        console.log(ideConfig.instructions);
+    const ides = config.ides || (config.ide ? [config.ide] : []);
+    if (ides.length > 0) {
+      for (const ide of ides) {
+        const ideConfig = configLoader.getIdeConfiguration(ide);
+        if (ideConfig?.instructions) {
+          console.log(
+            chalk.bold(`To use BMAD agents in ${ideConfig.name}:`)
+          );
+          console.log(ideConfig.instructions);
+        }
       }
     } else {
       console.log(chalk.yellow("No IDE configuration was set up."));
@@ -405,6 +501,25 @@ class Installer {
       );
     }
 
+    // Information about installation components
+    console.log(chalk.bold("\n🎯 Installation Summary:"));
+    console.log(chalk.green("✓ .bmad-core framework installed with all agents and workflows"));
+    
+    if (ides.length > 0) {
+      const ideNames = ides.map(ide => {
+        const ideConfig = configLoader.getIdeConfiguration(ide);
+        return ideConfig?.name || ide;
+      }).join(", ");
+      console.log(chalk.green(`✓ IDE rules and configurations set up for: ${ideNames}`));
+    }
+
+    // Information about web bundles
+    console.log(chalk.bold("\n📦 Web Bundles Available:"));
+    console.log("Self-contained web bundles have been included in your installation:");
+    console.log(chalk.cyan(`  ${installDir}/.bmad-core/web-bundles/`));
+    console.log("These bundles work independently without this installation and can be");
+    console.log("shared, moved, or used in other projects as standalone files.");
+
     if (config.installType === "single-agent") {
       console.log(
         chalk.dim(
@@ -418,7 +533,9 @@ class Installer {
   }
 
   // Legacy method for backward compatibility
-  async update(options) {
+  async update() {
+    // Initialize ES modules
+    await initializeModules();
     console.log(chalk.yellow('The "update" command is deprecated.'));
     console.log(
       'Please use "install" instead - it will detect and offer to update existing installations.'
@@ -432,19 +549,20 @@ class Installer {
         ide: null,
       };
       return await this.install(config);
-    } else {
-      console.log(chalk.red("No BMAD installation found."));
     }
+    console.log(chalk.red("No BMAD installation found."));
   }
 
   async listAgents() {
+    // Initialize ES modules
+    await initializeModules();
     const agents = await configLoader.getAvailableAgents();
 
     console.log(chalk.bold("\nAvailable BMAD Agents:\n"));
 
-    agents.forEach((agent) => {
+    for (const agent of agents) {
       console.log(chalk.cyan(`  ${agent.id.padEnd(20)}`), agent.description);
-    });
+    }
 
     console.log(
       chalk.dim("\nInstall with: npx bmad-method install --agent=<id>\n")
@@ -452,6 +570,8 @@ class Installer {
   }
 
   async showStatus() {
+    // Initialize ES modules
+    await initializeModules();
     const installDir = await this.findInstallation();
 
     if (!installDir) {