bmad-method 1.1.0 → 4.4.0

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) {