bmad-method 4.2.0 → 4.4.1

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,29 @@ 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, other)')
+  .option('-e, --expansion-packs <packs...>', 'Install specific expansion packs (can specify multiple)')
   .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 || []).filter(ide => ide !== 'other'),
+          expansionPacks: options.expansionPacks || []
         };
         await installer.install(config);
       }
     } catch (error) {
+      if (!chalk) await initializeModules();
       console.error(chalk.red('Installation failed:'), error.message);
       process.exit(1);
     }
@@ -65,10 +79,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 +96,20 @@ program
     try {
       await installer.listAgents();
     } catch (error) {
+      if (!chalk) await initializeModules();
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+program
+  .command('list:expansions')
+  .description('List available expansion packs')
+  .action(async () => {
+    try {
+      await installer.listExpansionPacks();
+    } catch (error) {
+      if (!chalk) await initializeModules();
       console.error(chalk.red('Error:'), error.message);
       process.exit(1);
     }
@@ -93,27 +122,34 @@ 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'
+      message: 'Enter the full path to your project directory where BMAD should be installed:',
+      validate: (input) => {
+        if (!input.trim()) {
+          return 'Please enter a valid project path';
+        }
+        return true;
+      }
     }
   ]);
   answers.directory = directory;
-  
+
   // Ask for installation type
   const { installType } = await inquirer.prompt([
     {
@@ -133,7 +169,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 +186,67 @@ async function promptInstallation(options) {
     ]);
     answers.agent = agent;
   }
-  
+
+  // Ask for expansion pack selection (only for full installation)
+  if (installType === 'full') {
+    try {
+      const availableExpansionPacks = await installer.getAvailableExpansionPacks();
+      
+      if (availableExpansionPacks.length > 0) {
+        const { expansionPacks } = await inquirer.prompt([
+          {
+            type: 'checkbox',
+            name: 'expansionPacks',
+            message: 'Select expansion packs to install (optional):',
+            choices: [
+              { name: 'BMAD Core only (no expansion packs)', value: 'none', checked: true },
+              new inquirer.Separator(' --- Expansion Packs ---'),
+              ...availableExpansionPacks.map(pack => ({
+                name: `${pack.name} - ${pack.description}`,
+                value: pack.id
+              }))
+            ]
+          }
+        ]);
+        
+        // Filter out 'none' selection and only include actual expansion packs
+        answers.expansionPacks = expansionPacks.filter(pack => pack !== 'none');
+      } else {
+        answers.expansionPacks = [];
+      }
+    } catch (error) {
+      console.warn(chalk.yellow('Warning: Could not load expansion packs. Continuing without them.'));
+      answers.expansionPacks = [];
+    }
+  } else {
+    answers.expansionPacks = [];
+  }
+
   // 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: 'Other (skip IDE setup)', value: 'other' }
+      ],
+      validate: (answer) => {
+        if (answer.length < 1) {
+          return 'You must choose at least one IDE option.';
+        }
+        return true;
+      }
     }
   ]);
-  answers.ide = ide;
   
+  // Filter out 'other' from the list and only include actual IDEs
+  answers.ides = ides.filter(ide => ide !== 'other');
+
   return answers;
 }
 

package/tools/installer/config/install.config.yml

@@ -3,55 +3,55 @@ installation-options:
     name: Complete BMAD Core
     description: Copy the entire .bmad-core folder with all agents, templates, and tools
     action: copy-folder
-    source: .bmad-core
+    source: bmad-core
   single-agent:
     name: Single Agent
     description: Select and install a single agent with its dependencies
     action: copy-agent
 agent-dependencies:
   core-files:
-    - .bmad-core/utils/template-format.md
+    - bmad-core/utils/template-format.md
   dev:
-    - .bmad-core/templates/story-tmpl.md
-    - .bmad-core/checklists/story-dod-checklist.md
+    - bmad-core/templates/story-tmpl.md
+    - bmad-core/checklists/story-dod-checklist.md
   pm:
-    - .bmad-core/templates/prd-tmpl.md
-    - .bmad-core/templates/brownfield-prd-tmpl.md
-    - .bmad-core/checklists/pm-checklist.md
-    - .bmad-core/checklists/change-checklist.md
-    - .bmad-core/tasks/advanced-elicitation.md
-    - .bmad-core/tasks/create-doc.md
-    - .bmad-core/tasks/correct-course.md
-    - .bmad-core/tasks/create-deep-research-prompt.md
-    - .bmad-core/tasks/brownfield-create-epic.md
-    - .bmad-core/tasks/brownfield-create-story.md
-    - .bmad-core/tasks/execute-checklist.md
-    - .bmad-core/tasks/shard-doc.md
+    - bmad-core/templates/prd-tmpl.md
+    - bmad-core/templates/brownfield-prd-tmpl.md
+    - bmad-core/checklists/pm-checklist.md
+    - bmad-core/checklists/change-checklist.md
+    - bmad-core/tasks/advanced-elicitation.md
+    - bmad-core/tasks/create-doc.md
+    - bmad-core/tasks/correct-course.md
+    - bmad-core/tasks/create-deep-research-prompt.md
+    - bmad-core/tasks/brownfield-create-epic.md
+    - bmad-core/tasks/brownfield-create-story.md
+    - bmad-core/tasks/execute-checklist.md
+    - bmad-core/tasks/shard-doc.md
   architect:
-    - .bmad-core/templates/architecture-tmpl.md
-    - .bmad-core/checklists/architect-checklist.md
+    - bmad-core/templates/architecture-tmpl.md
+    - bmad-core/checklists/architect-checklist.md
   sm:
-    - .bmad-core/templates/story-tmpl.md
-    - .bmad-core/checklists/story-draft-checklist.md
-    - .bmad-core/workflows/*.yml
+    - bmad-core/templates/story-tmpl.md
+    - bmad-core/checklists/story-draft-checklist.md
+    - bmad-core/workflows/*.yml
   po:
-    - .bmad-core/checklists/po-master-checklist.md
-    - .bmad-core/templates/acceptance-criteria-tmpl.md
+    - bmad-core/checklists/po-master-checklist.md
+    - bmad-core/templates/acceptance-criteria-tmpl.md
   analyst:
-    - .bmad-core/templates/prd-tmpl.md
-    - .bmad-core/tasks/advanced-elicitation.md
+    - bmad-core/templates/prd-tmpl.md
+    - bmad-core/tasks/advanced-elicitation.md
   qa:
-    - .bmad-core/checklists/story-dod-checklist.md
-    - .bmad-core/templates/test-plan-tmpl.md
+    - bmad-core/checklists/story-dod-checklist.md
+    - bmad-core/templates/test-plan-tmpl.md
   ux-expert:
-    - .bmad-core/templates/ux-tmpl.md
+    - bmad-core/templates/ux-tmpl.md
   bmad-master:
-    - .bmad-core/templates/*.md
-    - .bmad-core/tasks/*.md
-    - .bmad-core/schemas/*.yml
+    - bmad-core/templates/*.md
+    - bmad-core/tasks/*.md
+    - bmad-core/schemas/*.yml
   bmad-orchestrator:
-    - .bmad-core/agent-teams/*.yml
-    - .bmad-core/workflows/*.yml
+    - bmad-core/agent-teams/*.yml
+    - bmad-core/workflows/*.yml
 ide-configurations:
   cursor:
     name: Cursor
@@ -99,41 +99,41 @@ ide-configurations:
 available-agents:
   - id: analyst
     name: Business Analyst
-    file: .bmad-core/agents/analyst.md
+    file: bmad-core/agents/analyst.md
     description: Requirements gathering and analysis
   - id: pm
     name: Product Manager
-    file: .bmad-core/agents/pm.md
+    file: bmad-core/agents/pm.md
     description: Product strategy and roadmap planning
   - id: architect
     name: Solution Architect
-    file: .bmad-core/agents/architect.md
+    file: bmad-core/agents/architect.md
     description: Technical design and architecture
   - id: po
     name: Product Owner
-    file: .bmad-core/agents/po.md
+    file: bmad-core/agents/po.md
     description: Backlog management and prioritization
   - id: sm
     name: Scrum Master
-    file: .bmad-core/agents/sm.md
+    file: bmad-core/agents/sm.md
     description: Agile process and story creation
   - id: dev
     name: Developer
-    file: .bmad-core/agents/dev.md
+    file: bmad-core/agents/dev.md
     description: Code implementation and testing
   - id: qa
     name: QA Engineer
-    file: .bmad-core/agents/qa.md
+    file: bmad-core/agents/qa.md
     description: Quality assurance and testing
   - id: ux-expert
     name: UX Expert
-    file: .bmad-core/agents/ux-expert.md
+    file: bmad-core/agents/ux-expert.md
     description: User experience design
   - id: bmad-master
     name: BMAD Master
-    file: .bmad-core/agents/bmad-master.md
+    file: bmad-core/agents/bmad-master.md
     description: BMAD framework expert and guide
   - id: bmad-orchestrator
     name: BMAD Orchestrator
-    file: .bmad-core/agents/bmad-orchestrator.md
+    file: bmad-core/agents/bmad-orchestrator.md
     description: Multi-agent workflow coordinator

package/tools/installer/lib/config-loader.js

@@ -30,6 +30,43 @@ class ConfigLoader {
     return config['available-agents'] || [];
   }
 
+  async getAvailableExpansionPacks() {
+    const expansionPacksDir = path.join(this.getBmadCorePath(), '..', 'expansion-packs');
+    
+    try {
+      const entries = await fs.readdir(expansionPacksDir, { withFileTypes: true });
+      const expansionPacks = [];
+      
+      for (const entry of entries) {
+        if (entry.isDirectory()) {
+          const manifestPath = path.join(expansionPacksDir, entry.name, 'manifest.yml');
+          
+          try {
+            const manifestContent = await fs.readFile(manifestPath, 'utf8');
+            const manifest = yaml.load(manifestContent);
+            
+            expansionPacks.push({
+              id: entry.name,
+              name: manifest.name || entry.name,
+              description: manifest.description || 'No description available',
+              version: manifest.version || '1.0.0',
+              author: manifest.author || 'Unknown',
+              manifestPath: manifestPath,
+              dependencies: manifest.dependencies || []
+            });
+          } catch (error) {
+            console.warn(`Failed to read manifest for expansion pack ${entry.name}: ${error.message}`);
+          }
+        }
+      }
+      
+      return expansionPacks;
+    } catch (error) {
+      console.warn(`Failed to read expansion packs directory: ${error.message}`);
+      return [];
+    }
+  }
+
   async getAgentDependencies(agentId) {
     // Use DependencyResolver to dynamically parse agent dependencies
     const DependencyResolver = require('../../lib/dependency-resolver');
@@ -77,8 +114,8 @@ class ConfigLoader {
   }
 
   getBmadCorePath() {
-    // Get the path to .bmad-core relative to the installer (now under tools)
-    return path.join(__dirname, '..', '..', '..', '.bmad-core');
+    // Get the path to bmad-core relative to the installer (now under tools)
+    return path.join(__dirname, '..', '..', '..', 'bmad-core');
   }
 
   getAgentPath(agentId) {

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