bmad-method 6.0.0-alpha.9 → 6.0.1

package/tools/cli/lib/agent/template-engine.js

@@ -0,0 +1,152 @@
+/**
+ * Template Engine for BMAD Agent Install Configuration
+ * Processes {{variable}}, {{#if}}, {{#unless}}, and {{/if}} blocks
+ */
+
+/**
+ * Process all template syntax in a string
+ * @param {string} content - Content with template syntax
+ * @param {Object} variables - Key-value pairs from install_config answers
+ * @returns {string} Processed content
+ */
+function processTemplate(content, variables = {}) {
+  let result = content;
+
+  // Process conditionals first (they may contain variables)
+  result = processConditionals(result, variables);
+
+  // Then process simple variable replacements
+  result = processVariables(result, variables);
+
+  // Clean up any empty lines left by removed conditionals
+  result = cleanupEmptyLines(result);
+
+  return result;
+}
+
+/**
+ * Process {{#if}}, {{#unless}}, {{/if}}, {{/unless}} blocks
+ */
+function processConditionals(content, variables) {
+  let result = content;
+
+  // Process {{#if variable == "value"}} blocks
+  // Handle both regular quotes and JSON-escaped quotes (\")
+  const ifEqualsPattern = /\{\{#if\s+(\w+)\s*==\s*\\?"([^"\\]+)\\?"\s*\}\}([\s\S]*?)\{\{\/if\}\}/g;
+  result = result.replaceAll(ifEqualsPattern, (match, varName, value, block) => {
+    return variables[varName] === value ? block : '';
+  });
+
+  // Process {{#if variable}} blocks (boolean or truthy check)
+  const ifBoolPattern = /\{\{#if\s+(\w+)\s*\}\}([\s\S]*?)\{\{\/if\}\}/g;
+  result = result.replaceAll(ifBoolPattern, (match, varName, block) => {
+    const val = variables[varName];
+    // Treat as truthy: true, non-empty string, non-zero number
+    const isTruthy = val === true || (typeof val === 'string' && val.length > 0) || (typeof val === 'number' && val !== 0);
+    return isTruthy ? block : '';
+  });
+
+  // Process {{#unless variable}} blocks (inverse of if)
+  const unlessPattern = /\{\{#unless\s+(\w+)\s*\}\}([\s\S]*?)\{\{\/unless\}\}/g;
+  result = result.replaceAll(unlessPattern, (match, varName, block) => {
+    const val = variables[varName];
+    const isFalsy = val === false || val === '' || val === null || val === undefined || val === 0;
+    return isFalsy ? block : '';
+  });
+
+  return result;
+}
+
+/**
+ * Process {{variable}} replacements
+ */
+function processVariables(content, variables) {
+  let result = content;
+
+  // Replace {{variable}} with value
+  const varPattern = /\{\{(\w+)\}\}/g;
+  result = result.replaceAll(varPattern, (match, varName) => {
+    if (Object.hasOwn(variables, varName)) {
+      return String(variables[varName]);
+    }
+    // If variable not found, leave as-is (might be runtime variable like {user_name})
+    return match;
+  });
+
+  return result;
+}
+
+/**
+ * Clean up excessive empty lines left after removing conditional blocks
+ */
+function cleanupEmptyLines(content) {
+  // Replace 3+ consecutive newlines with 2
+  return content.replaceAll(/\n{3,}/g, '\n\n');
+}
+
+/**
+ * Extract install_config from agent YAML object
+ * @param {Object} agentYaml - Parsed agent YAML
+ * @returns {Object|null} install_config section or null
+ */
+function extractInstallConfig(agentYaml) {
+  return agentYaml?.agent?.install_config || null;
+}
+
+/**
+ * Remove install_config from agent YAML (after processing)
+ * @param {Object} agentYaml - Parsed agent YAML
+ * @returns {Object} Agent YAML without install_config
+ */
+function stripInstallConfig(agentYaml) {
+  const result = structuredClone(agentYaml);
+  if (result.agent) {
+    delete result.agent.install_config;
+  }
+  return result;
+}
+
+/**
+ * Process entire agent YAML object with template variables
+ * @param {Object} agentYaml - Parsed agent YAML
+ * @param {Object} variables - Answers from install_config questions
+ * @returns {Object} Processed agent YAML
+ */
+function processAgentYaml(agentYaml, variables) {
+  // Convert to JSON string, process templates, parse back
+  const jsonString = JSON.stringify(agentYaml, null, 2);
+  const processed = processTemplate(jsonString, variables);
+  return JSON.parse(processed);
+}
+
+/**
+ * Get default values from install_config questions
+ * @param {Object} installConfig - install_config section
+ * @returns {Object} Default values keyed by variable name
+ */
+function getDefaultValues(installConfig) {
+  const defaults = {};
+
+  if (!installConfig?.questions) {
+    return defaults;
+  }
+
+  for (const question of installConfig.questions) {
+    if (question.var && question.default !== undefined) {
+      defaults[question.var] = question.default;
+    }
+  }
+
+  return defaults;
+}
+
+module.exports = {
+  processTemplate,
+  processConditionals,
+  processVariables,
+  extractInstallConfig,
+  stripInstallConfig,
+  processAgentYaml,
+  getDefaultValues,
+  cleanupEmptyLines,
+};

package/tools/cli/lib/agent-analyzer.js

@@ -1,4 +1,4 @@
-const yaml = require('js-yaml');
+const yaml = require('yaml');
 const fs = require('fs-extra');
 
 /**
@@ -29,24 +29,52 @@ class AgentAnalyzer {
       // Track the menu item
       profile.menuItems.push(item);
 
-      // Check for each possible attribute
-      if (item.workflow) {
-        profile.usedAttributes.add('workflow');
-      }
-      if (item['validate-workflow']) {
-        profile.usedAttributes.add('validate-workflow');
-      }
-      if (item.exec) {
-        profile.usedAttributes.add('exec');
-      }
-      if (item.tmpl) {
-        profile.usedAttributes.add('tmpl');
-      }
-      if (item.data) {
-        profile.usedAttributes.add('data');
-      }
-      if (item.action) {
-        profile.usedAttributes.add('action');
+      // Check for multi format items
+      if (item.multi && item.triggers) {
+        profile.usedAttributes.add('multi');
+
+        // Also check attributes in nested handlers
+        for (const triggerGroup of item.triggers) {
+          for (const [triggerName, execArray] of Object.entries(triggerGroup)) {
+            if (Array.isArray(execArray)) {
+              for (const exec of execArray) {
+                if (exec.route) {
+                  // Check if route is a workflow or exec
+                  if (exec.route.endsWith('.yaml') || exec.route.endsWith('.yml')) {
+                    profile.usedAttributes.add('workflow');
+                  } else {
+                    profile.usedAttributes.add('exec');
+                  }
+                }
+                if (exec.workflow) profile.usedAttributes.add('workflow');
+                if (exec.action) profile.usedAttributes.add('action');
+                if (exec.type && ['exec', 'action', 'workflow'].includes(exec.type)) {
+                  profile.usedAttributes.add(exec.type);
+                }
+              }
+            }
+          }
+        }
+      } else {
+        // Check for each possible attribute in legacy items
+        if (item.workflow) {
+          profile.usedAttributes.add('workflow');
+        }
+        if (item['validate-workflow']) {
+          profile.usedAttributes.add('validate-workflow');
+        }
+        if (item.exec) {
+          profile.usedAttributes.add('exec');
+        }
+        if (item.tmpl) {
+          profile.usedAttributes.add('tmpl');
+        }
+        if (item.data) {
+          profile.usedAttributes.add('data');
+        }
+        if (item.action) {
+          profile.usedAttributes.add('action');
+        }
       }
     }
 
@@ -63,7 +91,7 @@ class AgentAnalyzer {
    */
   async analyzeAgentFile(filePath) {
     const content = await fs.readFile(filePath, 'utf8');
-    const agentYaml = yaml.load(content);
+    const agentYaml = yaml.parse(content);
     return this.analyzeAgentObject(agentYaml);
   }
 

package/tools/cli/lib/agent-party-generator.js

@@ -1,5 +1,6 @@
 const path = require('node:path');
 const fs = require('fs-extra');
+const { escapeXml } = require('../../lib/xml-utils');
 
 const AgentPartyGenerator = {
   /**
@@ -28,7 +29,7 @@ const AgentPartyGenerator = {
     let xmlContent = `<!-- Powered by BMAD-CORE™ -->
 <!-- Agent Manifest - Generated during BMAD ${forWeb ? 'bundling' : 'installation'} -->
 <!-- This file contains a summary of all ${forWeb ? 'bundled' : 'installed'} agents for quick reference -->
-<manifest id="bmad/_cfg/agent-manifest.csv" version="1.0" generated="${new Date().toISOString()}">
+<manifest id="bmad/_config/agent-manifest.csv" version="1.0" generated="${new Date().toISOString()}">
   <description>
     Complete roster of ${forWeb ? 'bundled' : 'installed'} BMAD agents with summarized personas for efficient multi-agent orchestration.
     Used by party-mode and other multi-agent coordination features.
@@ -47,9 +48,9 @@ const AgentPartyGenerator = {
       for (const agent of agents) {
         xmlContent += `  <agent id="${agent.id}" name="${agent.name}" title="${agent.title || ''}" icon="${agent.icon || ''}">
     <persona>
-      <role>${this.escapeXml(agent.role || '')}</role>
-      <identity>${this.escapeXml(agent.identity || '')}</identity>
-      <communication_style>${this.escapeXml(agent.communicationStyle || '')}</communication_style>
+      <role>${escapeXml(agent.role || '')}</role>
+      <identity>${escapeXml(agent.identity || '')}</identity>
+      <communication_style>${escapeXml(agent.communicationStyle || '')}</communication_style>
       <principles>${agent.principles || ''}</principles>
     </persona>
   </agent>\n`;
@@ -124,19 +125,6 @@ const AgentPartyGenerator = {
     return match ? match[1] : '';
   },
 
-  /**
-   * Escape XML special characters
-   */
-  escapeXml(text) {
-    if (!text) return '';
-    return text
-      .replaceAll('&', '&amp;')
-      .replaceAll('<', '&lt;')
-      .replaceAll('>', '&gt;')
-      .replaceAll('"', '&quot;')
-      .replaceAll("'", '&apos;');
-  },
-
   /**
    * Apply config overrides to agent details
    * @param {Object} details - Original agent details

package/tools/cli/lib/cli-utils.js

@@ -1,8 +1,6 @@
-const chalk = require('chalk');
-const boxen = require('boxen');
-const wrapAnsi = require('wrap-ansi');
-const figlet = require('figlet');
 const path = require('node:path');
+const os = require('node:os');
+const prompts = require('./prompts');
 
 const CLIUtils = {
   /**
@@ -18,27 +16,32 @@ const CLIUtils = {
   },
 
   /**
-   * Display BMAD logo
-   * @param {boolean} clearScreen - Whether to clear the screen first (default: true for initial display only)
+   * Display BMAD logo using @clack intro + box
+   * @param {boolean} _clearScreen - Deprecated, ignored (no longer clears screen)
    */
-  displayLogo(clearScreen = true) {
-    if (clearScreen) {
-      console.clear();
-    }
-
+  async displayLogo(_clearScreen = true) {
     const version = this.getVersion();
+    const color = await prompts.getColor();
 
     // ASCII art logo
-    const logo = `
-    ██████╗ ███╗   ███╗ █████╗ ██████╗ ™
-    ██╔══██╗████╗ ████║██╔══██╗██╔══██╗
-    ██████╔╝██╔████╔██║███████║██║  ██║
-    ██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║
-    ██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝
-    ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝`;
-
-    console.log(chalk.cyan(logo));
-    console.log(chalk.dim(`    Build More, Architect Dreams`) + chalk.cyan.bold(` v${version}`) + '\n');
+    const logo = [
+      '    ██████╗ ███╗   ███╗ █████╗ ██████╗ ™',
+      '    ██╔══██╗████╗ ████║██╔══██╗██╔══██╗',
+      '    ██████╔╝██╔████╔██║███████║██║  ██║',
+      '    ██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║',
+      '    ██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝',
+      '    ╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝',
+    ]
+      .map((line) => color.yellow(line))
+      .join('\n');
+
+    const tagline = '    Build More, Architect Dreams';
+
+    await prompts.box(`${logo}\n${tagline}`, `v${version}`, {
+      contentAlign: 'center',
+      rounded: true,
+      formatBorder: color.blue,
+    });
   },
 
   /**
@@ -46,13 +49,8 @@ const CLIUtils = {
    * @param {string} title - Section title
    * @param {string} subtitle - Optional subtitle
    */
-  displaySection(title, subtitle = null) {
-    console.log('\n' + chalk.cyan('═'.repeat(80)));
-    console.log(chalk.cyan.bold(` ${title}`));
-    if (subtitle) {
-      console.log(chalk.dim(` ${subtitle}`));
-    }
-    console.log(chalk.cyan('═'.repeat(80)) + '\n');
+  async displaySection(title, subtitle = null) {
+    await prompts.note(subtitle || '', title);
   },
 
   /**
@@ -60,57 +58,43 @@ const CLIUtils = {
    * @param {string|Array} content - Content to display
    * @param {Object} options - Box options
    */
-  displayBox(content, options = {}) {
-    const defaultOptions = {
-      padding: 1,
-      margin: 1,
-      borderStyle: 'round',
-      borderColor: 'cyan',
-      ...options,
-    };
-
-    // Handle array content
+  async displayBox(content, options = {}) {
     let text = content;
     if (Array.isArray(content)) {
       text = content.join('\n\n');
     }
 
-    // Wrap text to prevent overflow
-    const wrapped = wrapAnsi(text, 76, { hard: true, wordWrap: true });
+    const color = await prompts.getColor();
+    const borderColor = options.borderColor || 'cyan';
+    const colorMap = { green: color.green, red: color.red, yellow: color.yellow, cyan: color.cyan, blue: color.blue };
+    const formatBorder = colorMap[borderColor] || color.cyan;
 
-    console.log(boxen(wrapped, defaultOptions));
+    await prompts.box(text, options.title, {
+      rounded: options.borderStyle === 'round' || options.borderStyle === undefined,
+      formatBorder,
+    });
   },
 
   /**
    * Display module configuration header
    * @param {string} moduleName - Module name (fallback if no custom header)
-   * @param {string} header - Custom header from install-config.yaml
-   * @param {string} subheader - Custom subheader from install-config.yaml
+   * @param {string} header - Custom header from module.yaml
+   * @param {string} subheader - Custom subheader from module.yaml
    */
-  displayModuleConfigHeader(moduleName, header = null, subheader = null) {
-    // Simple blue banner with custom header/subheader if provided
-    console.log('\n' + chalk.cyan('─'.repeat(80)));
-    console.log(chalk.cyan(header || `Configuring ${moduleName.toUpperCase()} Module`));
-    if (subheader) {
-      console.log(chalk.dim(`${subheader}`));
-    }
-    console.log(chalk.cyan('─'.repeat(80)) + '\n');
+  async displayModuleConfigHeader(moduleName, header = null, subheader = null) {
+    const title = header || `Configuring ${moduleName.toUpperCase()} Module`;
+    await prompts.note(subheader || '', title);
   },
 
   /**
    * Display module with no custom configuration
    * @param {string} moduleName - Module name (fallback if no custom header)
-   * @param {string} header - Custom header from install-config.yaml
-   * @param {string} subheader - Custom subheader from install-config.yaml
+   * @param {string} header - Custom header from module.yaml
+   * @param {string} subheader - Custom subheader from module.yaml
    */
-  displayModuleNoConfig(moduleName, header = null, subheader = null) {
-    // Show full banner with header/subheader, just like modules with config
-    console.log('\n' + chalk.cyan('─'.repeat(80)));
-    console.log(chalk.cyan(header || `${moduleName.toUpperCase()} Module - No Custom Configuration`));
-    if (subheader) {
-      console.log(chalk.dim(`${subheader}`));
-    }
-    console.log(chalk.cyan('─'.repeat(80)) + '\n');
+  async displayModuleNoConfig(moduleName, header = null, subheader = null) {
+    const title = header || `${moduleName.toUpperCase()} Module - No Custom Configuration`;
+    await prompts.note(subheader || '', title);
   },
 
   /**
@@ -119,42 +103,33 @@ const CLIUtils = {
    * @param {number} total - Total steps
    * @param {string} description - Step description
    */
-  displayStep(current, total, description) {
+  async displayStep(current, total, description) {
     const progress = `[${current}/${total}]`;
-    console.log('\n' + chalk.cyan(progress) + ' ' + chalk.bold(description));
-    console.log(chalk.dim('─'.repeat(80 - progress.length - 1)) + '\n');
+    await prompts.log.step(`${progress} ${description}`);
   },
 
   /**
    * Display completion message
    * @param {string} message - Completion message
    */
-  displayComplete(message) {
-    console.log(
-      '\n' +
-        boxen(chalk.green('✨ ' + message), {
-          padding: 1,
-          margin: 1,
-          borderStyle: 'round',
-          borderColor: 'green',
-        }),
-    );
+  async displayComplete(message) {
+    const color = await prompts.getColor();
+    await prompts.box(`\u2728 ${message}`, 'Complete', {
+      rounded: true,
+      formatBorder: color.green,
+    });
   },
 
   /**
    * Display error message
    * @param {string} message - Error message
    */
-  displayError(message) {
-    console.log(
-      '\n' +
-        boxen(chalk.red('✗ ' + message), {
-          padding: 1,
-          margin: 1,
-          borderStyle: 'round',
-          borderColor: 'red',
-        }),
-    );
+  async displayError(message) {
+    const color = await prompts.getColor();
+    await prompts.box(`\u2717 ${message}`, 'Error', {
+      rounded: true,
+      formatBorder: color.red,
+    });
   },
 
   /**
@@ -162,7 +137,7 @@ const CLIUtils = {
    * @param {Array} items - Items to display
    * @param {string} prefix - Item prefix
    */
-  formatList(items, prefix = '•') {
+  formatList(items, prefix = '\u2022') {
     return items.map((item) => `  ${prefix} ${item}`).join('\n');
   },
 
@@ -177,25 +152,6 @@ const CLIUtils = {
     }
   },
 
-  /**
-   * Display table
-   * @param {Array} data - Table data
-   * @param {Object} options - Table options
-   */
-  displayTable(data, options = {}) {
-    const Table = require('cli-table3');
-    const table = new Table({
-      style: {
-        head: ['cyan'],
-        border: ['dim'],
-      },
-      ...options,
-    });
-
-    for (const row of data) table.push(row);
-    console.log(table.toString());
-  },
-
   /**
    * Display module completion message
    * @param {string} moduleName - Name of the completed module
@@ -205,6 +161,22 @@ const CLIUtils = {
     // No longer clear screen or show boxes - just a simple completion message
     // This is deprecated but kept for backwards compatibility
   },
+
+  /**
+   * Expand path with ~ expansion
+   * @param {string} inputPath - Path to expand
+   * @returns {string} Expanded path
+   */
+  expandPath(inputPath) {
+    if (!inputPath) return inputPath;
+
+    // Expand ~ to home directory
+    if (inputPath.startsWith('~')) {
+      return path.join(os.homedir(), inputPath.slice(1));
+    }
+
+    return inputPath;
+  },
 };
 
 module.exports = { CLIUtils };

package/tools/cli/lib/config.js

@@ -1,6 +1,7 @@
 const fs = require('fs-extra');
-const yaml = require('js-yaml');
+const yaml = require('yaml');
 const path = require('node:path');
+const packageJson = require('../../../package.json');
 
 /**
  * Configuration utility class
@@ -17,7 +18,7 @@ class Config {
     }
 
     const content = await fs.readFile(configPath, 'utf8');
-    return yaml.load(content);
+    return yaml.parse(content);
   }
 
   /**
@@ -50,7 +51,7 @@ class Config {
     const standardReplacements = {
       '{project-root}': replacements.root || '',
       '{module}': replacements.module || '',
-      '{version}': replacements.version || '5.0.0',
+      '{version}': replacements.version || packageJson.version,
       '{date}': new Date().toISOString().split('T')[0],
     };
 

package/tools/cli/lib/platform-codes.js

@@ -1,6 +1,6 @@
 const fs = require('fs-extra');
 const path = require('node:path');
-const yaml = require('js-yaml');
+const yaml = require('yaml');
 const { getProjectRoot } = require('./project-root');
 
 /**
@@ -20,7 +20,7 @@ class PlatformCodes {
     try {
       if (fs.existsSync(this.configPath)) {
         const content = fs.readFileSync(this.configPath, 'utf8');
-        this.config = yaml.load(content);
+        this.config = yaml.parse(content);
       } else {
         console.warn(`Platform codes config not found at ${this.configPath}`);
         this.config = { platforms: {} };

package/tools/cli/lib/project-root.js

@@ -55,11 +55,17 @@ function getSourcePath(...segments) {
 
 /**
  * Get path to a module's directory
+ * bmm is a built-in module directly under src/
+ * core is also directly under src/
+ * All other modules are stored remote
  */
 function getModulePath(moduleName, ...segments) {
   if (moduleName === 'core') {
     return getSourcePath('core', ...segments);
   }
+  if (moduleName === 'bmm') {
+    return getSourcePath('bmm', ...segments);
+  }
   return getSourcePath('modules', moduleName, ...segments);
 }