bmad-method 6.0.0-alpha.11 → 6.0.0-alpha.13

package/tools/cli/bundlers/web-bundler.js

@@ -748,10 +748,9 @@ class WebBundler {
       }
     }
 
-    // Extract workflow references - both 'workflow' and 'run-workflow' attributes
+    // Extract workflow references from agent files
     const workflowPatterns = [
       /workflow="([^"]+)"/g, // Menu items with workflow attribute
-      /run-workflow="([^"]+)"/g, // Commands with run-workflow attribute
       /validate-workflow="([^"]+)"/g, // Validation workflow references
     ];
 
@@ -789,16 +788,6 @@ class WebBundler {
       // Match: <item cmd="..." workflow="workflowPath">...</item>
       const itemWorkflowPattern = new RegExp(`\\s*<item\\s+[^>]*workflow="[^"]*${escapedPath}"[^>]*>.*?</item>\\s*`, 'gs');
       modifiedXml = modifiedXml.replace(itemWorkflowPattern, '');
-
-      // Pattern 2: Remove <item> tags with run-workflow attribute
-      // Match: <item cmd="..." run-workflow="workflowPath">...</item>
-      const itemRunWorkflowPattern = new RegExp(`\\s*<item\\s+[^>]*run-workflow="[^"]*${escapedPath}"[^>]*>.*?</item>\\s*`, 'gs');
-      modifiedXml = modifiedXml.replace(itemRunWorkflowPattern, '');
-
-      // Pattern 3: Remove <c> tags with run-workflow attribute (legacy)
-      // Match: <c cmd="..." run-workflow="workflowPath">...</c>
-      const cPattern = new RegExp(`\\s*<c\\s+[^>]*run-workflow="[^"]*${escapedPath}"[^>]*>.*?</c>\\s*`, 'gs');
-      modifiedXml = modifiedXml.replace(cPattern, '');
     }
 
     return modifiedXml;
@@ -1421,11 +1410,11 @@ class WebBundler {
     const menuItems = [];
 
     if (!hasHelp) {
-      menuItems.push(`${indent}<item cmd="*help">Show numbered menu</item>`);
+      menuItems.push(`${indent}<item cmd="*menu">[M] Redisplay Menu Options</item>`);
     }
 
     if (!hasExit) {
-      menuItems.push(`${indent}<item cmd="*exit">Exit with confirmation</item>`);
+      menuItems.push(`${indent}<item cmd="*dismiss">[D] Dismiss Agent</item>`);
     }
 
     if (menuItems.length === 0) {

package/tools/cli/commands/agent-install.js

@@ -22,9 +22,9 @@ module.exports = {
   command: 'agent-install',
   description: 'Install and compile BMAD agents with personalization',
   options: [
-    ['-p, --path <path>', 'Path to specific agent YAML file or folder'],
+    ['-s, --source <path>', 'Path to specific agent YAML file or folder'],
     ['-d, --defaults', 'Use default values without prompting'],
-    ['-t, --target <path>', 'Target installation directory (default: .bmad/agents)'],
+    ['-t, --destination <path>', 'Target installation directory (default: current project BMAD installation)'],
   ],
   action: async (options) => {
     try {
@@ -43,9 +43,9 @@ module.exports = {
 
       let selectedAgent = null;
 
-      // If path provided, use it directly
-      if (options.path) {
-        const providedPath = path.resolve(options.path);
+      // If source provided, use it directly
+      if (options.source) {
+        const providedPath = path.resolve(options.source);
 
         if (!fs.existsSync(providedPath)) {
           console.log(chalk.red(`Path not found: ${providedPath}`));
@@ -82,7 +82,7 @@ module.exports = {
         // Discover agents from custom location
         const customAgentLocation = config.custom_agent_location
           ? resolvePath(config.custom_agent_location, config)
-          : path.join(config.bmadFolder, 'custom', 'agents');
+          : path.join(config.bmadFolder, 'custom', 'src', 'agents');
 
         console.log(chalk.dim(`Searching for agents in: ${customAgentLocation}\n`));
 
@@ -192,11 +192,11 @@ module.exports = {
       }
 
       // Determine target directory
-      let targetDir = options.target ? path.resolve(options.target) : null;
+      let targetDir = options.destination ? path.resolve(options.destination) : null;
 
       // If no target specified, prompt for it
       if (targetDir) {
-        // If target provided via --target, check if it's a project root and adjust
+        // If target provided via --destination, check if it's a project root and adjust
         const otherProject = detectBmadProject(targetDir);
         if (otherProject && !targetDir.includes('agents')) {
           // User specified project root, redirect to custom agents folder

package/tools/cli/commands/cleanup.js

@@ -0,0 +1,141 @@
+const chalk = require('chalk');
+const nodePath = require('node:path');
+const { Installer } = require('../installers/lib/core/installer');
+
+module.exports = {
+  command: 'cleanup',
+  description: 'Clean up obsolete files from BMAD installation',
+  options: [
+    ['-d, --dry-run', 'Show what would be deleted without actually deleting'],
+    ['-a, --auto-delete', 'Automatically delete non-retained files without prompts'],
+    ['-l, --list-retained', 'List currently retained files'],
+    ['-c, --clear-retained', 'Clear retained files list'],
+  ],
+  action: async (options) => {
+    try {
+      // Create installer and let it find the BMAD directory
+      const installer = new Installer();
+      const bmadDir = await installer.findBmadDir(process.cwd());
+
+      if (!bmadDir) {
+        console.error(chalk.red('❌ BMAD installation not found'));
+        process.exit(1);
+      }
+
+      const retentionPath = nodePath.join(bmadDir, '_cfg', 'user-retained-files.yaml');
+
+      // Handle list-retained option
+      if (options.listRetained) {
+        const fs = require('fs-extra');
+        const yaml = require('js-yaml');
+
+        if (await fs.pathExists(retentionPath)) {
+          const retentionContent = await fs.readFile(retentionPath, 'utf8');
+          const retentionData = yaml.load(retentionContent) || { retainedFiles: [] };
+
+          if (retentionData.retainedFiles.length > 0) {
+            console.log(chalk.cyan('\n📋 Retained Files:\n'));
+            for (const file of retentionData.retainedFiles) {
+              console.log(chalk.dim(`  - ${file}`));
+            }
+            console.log();
+          } else {
+            console.log(chalk.yellow('\n✨ No retained files found\n'));
+          }
+        } else {
+          console.log(chalk.yellow('\n✨ No retained files found\n'));
+        }
+
+        return;
+      }
+
+      // Handle clear-retained option
+      if (options.clearRetained) {
+        const fs = require('fs-extra');
+
+        if (await fs.pathExists(retentionPath)) {
+          await fs.remove(retentionPath);
+          console.log(chalk.green('\n✅ Cleared retained files list\n'));
+        } else {
+          console.log(chalk.yellow('\n✨ No retained files list to clear\n'));
+        }
+
+        return;
+      }
+
+      // Handle cleanup operations
+      if (options.dryRun) {
+        console.log(chalk.cyan('\n🔍 Legacy File Scan (Dry Run)\n'));
+
+        const legacyFiles = await installer.scanForLegacyFiles(bmadDir);
+        const allLegacyFiles = [
+          ...legacyFiles.backup,
+          ...legacyFiles.documentation,
+          ...legacyFiles.deprecated_task,
+          ...legacyFiles.unknown,
+        ];
+
+        if (allLegacyFiles.length === 0) {
+          console.log(chalk.green('✨ No legacy files found\n'));
+          return;
+        }
+
+        // Group files by category
+        const categories = [];
+        if (legacyFiles.backup.length > 0) {
+          categories.push({ name: 'Backup Files (.bak)', files: legacyFiles.backup });
+        }
+        if (legacyFiles.documentation.length > 0) {
+          categories.push({ name: 'Documentation', files: legacyFiles.documentation });
+        }
+        if (legacyFiles.deprecated_task.length > 0) {
+          categories.push({ name: 'Deprecated Task Files', files: legacyFiles.deprecated_task });
+        }
+        if (legacyFiles.unknown.length > 0) {
+          categories.push({ name: 'Unknown Files', files: legacyFiles.unknown });
+        }
+
+        for (const category of categories) {
+          console.log(chalk.yellow(`${category.name}:`));
+          for (const file of category.files) {
+            const size = (file.size / 1024).toFixed(1);
+            const date = file.mtime.toLocaleDateString();
+            let line = `  - ${file.relativePath} (${size}KB, ${date})`;
+            if (file.suggestedAlternative) {
+              line += chalk.dim(` → ${file.suggestedAlternative}`);
+            }
+            console.log(chalk.dim(line));
+          }
+          console.log();
+        }
+
+        console.log(chalk.cyan(`Found ${allLegacyFiles.length} legacy file(s) that could be cleaned up.\n`));
+        console.log(chalk.dim('Run "bmad cleanup" to actually delete these files.\n'));
+
+        return;
+      }
+
+      // Perform actual cleanup
+      console.log(chalk.cyan('\n🧹 Cleaning up legacy files...\n'));
+
+      const result = await installer.performCleanup(bmadDir, options.autoDelete);
+
+      if (result.message) {
+        console.log(chalk.dim(result.message));
+      } else {
+        if (result.deleted > 0) {
+          console.log(chalk.green(`✅ Deleted ${result.deleted} legacy file(s)`));
+        }
+        if (result.retained > 0) {
+          console.log(chalk.yellow(`⏭️  Retained ${result.retained} file(s)`));
+          console.log(chalk.dim('Run "bmad cleanup --list-retained" to see retained files\n'));
+        }
+      }
+
+      console.log();
+    } catch (error) {
+      console.error(chalk.red(`❌ Error: ${error.message}`));
+      process.exit(1);
+    }
+  },
+};

package/tools/cli/commands/install.js

@@ -9,8 +9,8 @@ const ui = new UI();
 module.exports = {
   command: 'install',
   description: 'Install BMAD Core agents and tools',
-  options: [],
-  action: async () => {
+  options: [['--skip-cleanup', 'Skip automatic cleanup of legacy files']],
+  action: async (options) => {
     try {
       const config = await ui.promptInstall();
 
@@ -44,6 +44,11 @@ module.exports = {
         config._requestedReinstall = true;
       }
 
+      // Add skip cleanup flag if option provided
+      if (options && options.skipCleanup) {
+        config.skipCleanup = true;
+      }
+
       // Regular install/update flow
       const result = await installer.install(config);
 
@@ -58,7 +63,47 @@ module.exports = {
         console.log(chalk.green('\n✨ Installation complete!'));
         console.log(chalk.cyan('BMAD Core and Selected Modules have been installed to:'), chalk.bold(result.path));
         console.log(chalk.yellow('\nThank you for helping test the early release version of the new BMad Core and BMad Method!'));
-        console.log(chalk.cyan('Stable Beta coming soon - please read the full readme.md and linked documentation to get started!'));
+        console.log(chalk.cyan('Stable Beta coming soon - please read the full README.md and linked documentation to get started!'));
+
+        // Run AgentVibes installer if needed
+        if (result.needsAgentVibes) {
+          console.log(chalk.magenta('\n🎙️  AgentVibes TTS Setup'));
+          console.log(chalk.cyan('AgentVibes provides voice synthesis for BMAD agents with:'));
+          console.log(chalk.dim('  • ElevenLabs AI (150+ premium voices)'));
+          console.log(chalk.dim('  • Piper TTS (50+ free voices)\n'));
+
+          const readline = require('node:readline');
+          const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+          });
+
+          await new Promise((resolve) => {
+            rl.question(chalk.green('Press Enter to start AgentVibes installer...'), () => {
+              rl.close();
+              resolve();
+            });
+          });
+
+          console.log('');
+
+          // Run AgentVibes installer
+          const { execSync } = require('node:child_process');
+          try {
+            execSync('npx agentvibes@latest install', {
+              cwd: result.projectDir,
+              stdio: 'inherit',
+              shell: true,
+            });
+            console.log(chalk.green('\n✓ AgentVibes installation complete'));
+          } catch {
+            console.log(chalk.yellow('\n⚠ AgentVibes installation was interrupted or failed'));
+            console.log(chalk.cyan('You can run it manually later with:'));
+            console.log(chalk.green(`  cd ${result.projectDir}`));
+            console.log(chalk.green('  npx agentvibes install\n'));
+          }
+        }
+
         process.exit(0);
       }
     } catch (error) {

package/tools/cli/installers/lib/core/config-collector.js

@@ -359,6 +359,25 @@ class ConfigCollector {
     return result;
   }
 
+  /**
+   * Get the default username from the system
+   * @returns {string} Capitalized username\
+   */
+  getDefaultUsername() {
+    let result = 'BMad';
+    try {
+      const os = require('node:os');
+      const userInfo = os.userInfo();
+      if (userInfo && userInfo.username) {
+        const username = userInfo.username;
+        result = username.charAt(0).toUpperCase() + username.slice(1);
+      }
+    } catch {
+      // Do nothing, just return 'BMad'
+    }
+    return result;
+  }
+
   /**
    * Collect configuration for a single module
    * @param {string} moduleName - Module name
@@ -604,6 +623,11 @@ class ConfigCollector {
       }
     }
 
+    // Special handling for user_name: default to system user
+    if (moduleName === 'core' && key === 'user_name' && !existingValue) {
+      item.default = this.getDefaultUsername();
+    }
+
     // Determine question type and default value
     let questionType = 'input';
     let defaultValue = item.default;