bmad-method 5.0.0 → 5.1.0

package/tools/lib/dependency-resolver.js

@@ -1,39 +1,36 @@
-const fs = require('fs').promises;
-const path = require('path');
+const fs = require('node:fs').promises;
+const path = require('node:path');
 const yaml = require('js-yaml');
+const { extractYamlFromAgent } = require('./yaml-utils');
 
 class DependencyResolver {
   constructor(rootDir) {
     this.rootDir = rootDir;
-    this.bmadCore = path.join(rootDir, '.bmad-core');
+    this.bmadCore = path.join(rootDir, 'bmad-core');
+    this.common = path.join(rootDir, 'common');
     this.cache = new Map();
   }
 
   async resolveAgentDependencies(agentId) {
     const agentPath = path.join(this.bmadCore, 'agents', `${agentId}.md`);
     const agentContent = await fs.readFile(agentPath, 'utf8');
-    
-    // Extract YAML from markdown content
-    const yamlMatch = agentContent.match(/```ya?ml\n([\s\S]*?)\n```/);
-    if (!yamlMatch) {
+
+    // Extract YAML from markdown content with command cleaning
+    const yamlContent = extractYamlFromAgent(agentContent, true);
+    if (!yamlContent) {
       throw new Error(`No YAML configuration found in agent ${agentId}`);
     }
-    
-    // Clean up the YAML to handle command descriptions after dashes
-    let yamlContent = yamlMatch[1];
-    // Fix commands section: convert "- command - description" to just "- command"
-    yamlContent = yamlContent.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
-    
+
     const agentConfig = yaml.load(yamlContent);
-    
+
     const dependencies = {
       agent: {
         id: agentId,
-        path: `agents#${agentId}`,
+        path: agentPath,
         content: agentContent,
-        config: agentConfig
+        config: agentConfig,
       },
-      resources: []
+      resources: [],
     };
 
     // Personas are now embedded in agent configs, no need to resolve separately
@@ -52,52 +49,52 @@ class DependencyResolver {
   }
 
   async resolveTeamDependencies(teamId) {
-    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yml`);
+    const teamPath = path.join(this.bmadCore, 'agent-teams', `${teamId}.yaml`);
     const teamContent = await fs.readFile(teamPath, 'utf8');
     const teamConfig = yaml.load(teamContent);
-    
+
     const dependencies = {
       team: {
         id: teamId,
-        path: `agent-teams#${teamId}`,
+        path: teamPath,
         content: teamContent,
-        config: teamConfig
+        config: teamConfig,
       },
       agents: [],
-      resources: new Map() // Use Map to deduplicate resources
+      resources: new Map(), // Use Map to deduplicate resources
     };
 
     // Always add bmad-orchestrator agent first if it's a team
     const bmadAgent = await this.resolveAgentDependencies('bmad-orchestrator');
     dependencies.agents.push(bmadAgent.agent);
-    bmadAgent.resources.forEach(res => {
+    for (const res of bmadAgent.resources) {
       dependencies.resources.set(res.path, res);
-    });
+    }
 
     // Resolve all agents in the team
     let agentsToResolve = teamConfig.agents || [];
-    
+
     // Handle wildcard "*" - include all agents except bmad-master
     if (agentsToResolve.includes('*')) {
       const allAgents = await this.listAgents();
       // Remove wildcard and add all agents except those already in the list and bmad-master
-      agentsToResolve = agentsToResolve.filter(a => a !== '*');
+      agentsToResolve = agentsToResolve.filter((a) => a !== '*');
       for (const agent of allAgents) {
         if (!agentsToResolve.includes(agent) && agent !== 'bmad-master') {
           agentsToResolve.push(agent);
         }
       }
     }
-    
+
     for (const agentId of agentsToResolve) {
       if (agentId === 'bmad-orchestrator' || agentId === 'bmad-master') continue; // Already added or excluded
       const agentDeps = await this.resolveAgentDependencies(agentId);
       dependencies.agents.push(agentDeps.agent);
-      
+
       // Add resources with deduplication
-      agentDeps.resources.forEach(res => {
+      for (const res of agentDeps.resources) {
         dependencies.resources.set(res.path, res);
-      });
+      }
     }
 
     // Resolve workflows
@@ -107,7 +104,7 @@ class DependencyResolver {
     }
 
     // Convert Map back to array
-    dependencies.resources = Array.from(dependencies.resources.values());
+    dependencies.resources = [...dependencies.resources.values()];
 
     return dependencies;
   }
@@ -119,17 +116,20 @@ class DependencyResolver {
     }
 
     try {
-      const extensions = ['.md', '.yml', '.yaml'];
       let content = null;
       let filePath = null;
 
-      for (const ext of extensions) {
+      // First try bmad-core
+      try {
+        filePath = path.join(this.bmadCore, type, id);
+        content = await fs.readFile(filePath, 'utf8');
+      } catch {
+        // If not found in bmad-core, try common folder
         try {
-          filePath = path.join(this.bmadCore, type, `${id}${ext}`);
+          filePath = path.join(this.common, type, id);
           content = await fs.readFile(filePath, 'utf8');
-          break;
-        } catch (e) {
-          // Try next extension
+        } catch {
+          // File not found in either location
         }
       }
 
@@ -141,8 +141,8 @@ class DependencyResolver {
       const resource = {
         type,
         id,
-        path: `${type}#${id}`,
-        content
+        path: filePath,
+        content,
       };
 
       this.cache.set(cacheKey, resource);
@@ -156,10 +156,8 @@ class DependencyResolver {
   async listAgents() {
     try {
       const files = await fs.readdir(path.join(this.bmadCore, 'agents'));
-      return files
-        .filter(f => f.endsWith('.md'))
-        .map(f => f.replace('.md', ''));
-    } catch (error) {
+      return files.filter((f) => f.endsWith('.md')).map((f) => f.replace('.md', ''));
+    } catch {
       return [];
     }
   }
@@ -167,13 +165,11 @@ class DependencyResolver {
   async listTeams() {
     try {
       const files = await fs.readdir(path.join(this.bmadCore, 'agent-teams'));
-      return files
-        .filter(f => f.endsWith('.yml'))
-        .map(f => f.replace('.yml', ''));
-    } catch (error) {
+      return files.filter((f) => f.endsWith('.yaml')).map((f) => f.replace('.yaml', ''));
+    } catch {
       return [];
     }
   }
 }
 
-module.exports = DependencyResolver;
+module.exports = DependencyResolver;

package/tools/lib/yaml-utils.js

@@ -0,0 +1,29 @@
+/**
+ * Utility functions for YAML extraction from agent files
+ */
+
+/**
+ * Extract YAML content from agent markdown files
+ * @param {string} agentContent - The full content of the agent file
+ * @param {boolean} cleanCommands - Whether to clean command descriptions (default: false)
+ * @returns {string|null} - The extracted YAML content or null if not found
+ */
+function extractYamlFromAgent(agentContent, cleanCommands = false) {
+  // Remove carriage returns and match YAML block
+  const yamlMatch = agentContent.replaceAll('\r', '').match(/```ya?ml\n([\s\S]*?)\n```/);
+  if (!yamlMatch) return null;
+
+  let yamlContent = yamlMatch[1].trim();
+
+  // Clean up command descriptions if requested
+  // Converts "- command - description" to just "- command"
+  if (cleanCommands) {
+    yamlContent = yamlContent.replaceAll(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
+  }
+
+  return yamlContent;
+}
+
+module.exports = {
+  extractYamlFromAgent,
+};

package/tools/md-assets/web-agent-startup-instructions.md

@@ -0,0 +1,39 @@
+# Web Agent Bundle Instructions
+
+You are now operating as a specialized AI agent from the BMad-Method framework. This is a bundled web-compatible version containing all necessary resources for your role.
+
+## Important Instructions
+
+### **Follow all startup commands**: Your agent configuration includes startup instructions that define your behavior, personality, and approach. These MUST be followed exactly.
+
+### **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
+
+- `==================== START: .bmad-core/folder/filename.md ====================`
+- `==================== END: .bmad-core/folder/filename.md ====================`
+
+When you need to reference a resource mentioned in your instructions:
+
+- Look for the corresponding START/END tags
+- The format is always the full path with dot prefix (e.g., `.bmad-core/personas/analyst.md`, `.bmad-core/tasks/create-story.md`)
+- If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
+
+**Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
+
+```yaml
+dependencies:
+  utils:
+    - template-format
+  tasks:
+    - create-story
+```
+
+These references map directly to bundle sections:
+
+- `dependencies.utils: template-format` → Look for `==================== START: .bmad-core/utils/template-format.md ====================`
+- `dependencies.utils: create-story` → Look for `==================== START: .bmad-core/tasks/create-story.md ====================`
+
+### **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance. You have no file system to write to, so you will maintain document history being drafted in your memory unless a canvas feature is available and the user confirms its usage.
+
+## **Primary Directive**: Your primary goal is defined in your agent configuration below. Focus on fulfilling your designated role explicitly as defined.
+
+---

package/tools/preview-release-notes.js

@@ -0,0 +1,66 @@
+const { execSync } = require('node:child_process');
+const fs = require('node:fs');
+
+// Get the latest stable tag (exclude beta tags)
+const allTags = execSync('git tag -l | sort -V', { encoding: 'utf8' }).split('\n').filter(Boolean);
+const stableTags = allTags.filter((tag) => !tag.includes('beta'));
+const latestTag = stableTags.at(-1) || 'v5.0.0';
+
+// Get commits since last tag
+const commits = execSync(`git log ${latestTag}..HEAD --pretty=format:"- %s" --reverse`, {
+  encoding: 'utf8',
+})
+  .split('\n')
+  .filter(Boolean);
+
+// Categorize commits
+const features = commits.filter((commit) => /^- (feat|Feature)/.test(commit));
+const fixes = commits.filter((commit) => /^- (fix|Fix)/.test(commit));
+const chores = commits.filter((commit) => /^- (chore|Chore)/.test(commit));
+const others = commits.filter(
+  (commit) => !/^- (feat|Feature|fix|Fix|chore|Chore|release:|Release:)/.test(commit),
+);
+
+// Get next version (you can modify this logic)
+const currentVersion = require('../package.json').version;
+const versionParts = currentVersion.split('.').map(Number);
+const nextVersion = `${versionParts[0]}.${versionParts[1] + 1}.0`; // Default to minor bump
+
+console.log(`## 🚀 What's New in v${nextVersion}\n`);
+
+if (features.length > 0) {
+  console.log('### ✨ New Features');
+  for (const feature of features) console.log(feature);
+  console.log('');
+}
+
+if (fixes.length > 0) {
+  console.log('### 🐛 Bug Fixes');
+  for (const fix of fixes) console.log(fix);
+  console.log('');
+}
+
+if (others.length > 0) {
+  console.log('### 📦 Other Changes');
+  for (const other of others) console.log(other);
+  console.log('');
+}
+
+if (chores.length > 0) {
+  console.log('### 🔧 Maintenance');
+  for (const chore of chores) console.log(chore);
+  console.log('');
+}
+
+console.log('\n## 📦 Installation\n');
+console.log('```bash');
+console.log('npx bmad-method install');
+console.log('```');
+
+console.log(
+  `\n**Full Changelog**: https://github.com/bmadcode/BMAD-METHOD/compare/${latestTag}...v${nextVersion}`,
+);
+
+console.log(`\n---\n📊 **Summary**: ${commits.length} commits since ${latestTag}`);
+console.log(`🏷️ **Previous tag**: ${latestTag}`);
+console.log(`🚀 **Next version**: v${nextVersion} (estimated)`);

package/tools/shared/bannerArt.js

@@ -0,0 +1,105 @@
+// ASCII banner art definitions extracted from banners.js to separate art from logic
+
+const BMAD_TITLE = 'BMAD-METHOD';
+const FLATTENER_TITLE = 'FLATTENER';
+const INSTALLER_TITLE = 'INSTALLER';
+
+// Large ASCII blocks (block-style fonts)
+const BMAD_LARGE = `
+██████╗ ███╗   ███╗ █████╗ ██████╗       ███╗   ███╗███████╗████████╗██╗  ██╗ ██████╗ ██████╗ 
+██╔══██╗████╗ ████║██╔══██╗██╔══██╗      ████╗ ████║██╔════╝╚══██╔══╝██║  ██║██╔═══██╗██╔══██╗
+██████╔╝██╔████╔██║███████║██║  ██║█████╗██╔████╔██║█████╗     ██║   ███████║██║   ██║██║  ██║
+██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║╚════╝██║╚██╔╝██║██╔══╝     ██║   ██╔══██║██║   ██║██║  ██║
+██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝      ██║ ╚═╝ ██║███████╗   ██║   ██║  ██║╚██████╔╝██████╔╝
+╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝       ╚═╝     ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ 
+`;
+
+const FLATTENER_LARGE = `
+███████╗██╗      █████╗ ████████╗████████╗███████╗███╗   ██╗███████╗██████╗ 
+██╔════╝██║     ██╔══██╗╚══██╔══╝╚══██╔══╝██╔════╝████╗  ██║██╔════╝██╔══██╗
+█████╗  ██║     ███████║   ██║      ██║   █████╗  ██╔██╗ ██║█████╗  ██████╔╝
+██╔══╝  ██║     ██╔══██║   ██║      ██║   ██╔══╝  ██║╚██╗██║██╔══╝  ██╔══██╗
+██║     ███████║██║  ██║   ██║      ██║   ███████╗██║ ╚████║███████╗██║  ██║
+╚═╝     ╚══════╝╚═╝  ╚═╝   ╚═╝      ╚═╝   ╚══════╝╚═╝  ╚═══╝╚══════╝╚═╝  ╚═╝
+ `;
+
+const INSTALLER_LARGE = `
+██╗███╗   ██╗███████╗████████╗ █████╗ ██╗     ██╗     ███████╗██████╗ 
+██║████╗  ██║██╔════╝╚══██╔══╝██╔══██╗██║     ██║     ██╔════╝██╔══██╗
+██║██╔██╗ ██║███████╗   ██║   ███████║██║     ██║     █████╗  ██████╔╝
+██║██║╚██╗██║╚════██║   ██║   ██╔══██║██║     ██║     ██╔══╝  ██╔══██╗
+██║██║ ╚████║███████║   ██║   ██║  ██║███████╗███████╗███████╗██║  ██║
+╚═╝╚═╝  ╚═══╝╚══════╝   ╚═╝   ╚═╝  ╚═╝╚══════╝╚══════╝╚══════╝╚═╝  ╚═╝
+`;
+
+// Curated medium/small/tiny variants (fixed art, no runtime scaling)
+// Medium: bold framed title with heavy fill (high contrast, compact)
+const BMAD_MEDIUM = `
+███╗ █╗    █╗ ██╗ ███╗    █╗    █╗███╗█████╗█╗ █╗ ██╗ ███╗ 
+█╔═█╗██╗  ██║█╔═█╗█╔═█╗   ██╗  ██║█╔═╝╚═█╔═╝█║ █║█╔═█╗█╔═█╗
+███╔╝█╔███╔█║████║█║ █║██╗█╔███╔█║██╗   █║  ████║█║ █║█║ █║
+█╔═█╗█║ █╔╝█║█╔═█║█║ █║╚═╝█║ █╔╝█║█╔╝   █║  █╔═█║█║ █║█║ █║
+███╔╝█║ ╚╝ █║█║ █║███╔╝   █║ ╚╝ █║███╗  █║  █║ █║╚██╔╝███╔╝
+╚══╝ ╚╝    ╚╝╚╝ ╚╝╚══╝    ╚╝    ╚╝╚══╝  ╚╝  ╚╝ ╚╝ ╚═╝ ╚══╝ 
+`;
+
+const FLATTENER_MEDIUM = `
+███╗█╗   ██╗ █████╗█████╗███╗█╗  █╗███╗███╗ 
+█╔═╝█║  █╔═█╗╚═█╔═╝╚═█╔═╝█╔═╝██╗ █║█╔═╝█╔═█╗
+██╗ █║  ████║  █║    █║  ██╗ █╔█╗█║██╗ ███╔╝
+█╔╝ █║  █╔═█║  █║    █║  █╔╝ █║ ██║█╔╝ █╔═█╗
+█║  ███║█║ █║  █║    █║  ███╗█║  █║███╗█║ █║
+╚╝  ╚══╝╚╝ ╚╝  ╚╝    ╚╝  ╚══╝╚╝  ╚╝╚══╝╚╝ ╚╝
+ `;
+
+const INSTALLER_MEDIUM = `
+█╗█╗  █╗████╗█████╗ ██╗ █╗  █╗  ███╗███╗ 
+█║██╗ █║█╔══╝╚═█╔═╝█╔═█╗█║  █║  █╔═╝█╔═█╗
+█║█╔█╗█║████╗  █║  ████║█║  █║  ██╗ ███╔╝
+█║█║ ██║╚══█║  █║  █╔═█║█║  █║  █╔╝ █╔═█╗
+█║█║  █║████║  █║  █║ █║███╗███╗███╗█║ █║
+╚╝╚╝  ╚╝╚═══╝  ╚╝  ╚╝ ╚╝╚══╝╚══╝╚══╝╚╝ ╚╝
+`;
+
+// Small: rounded box with bold rule
+// Width: 30 columns total (28 inner)
+const BMAD_SMALL = `
+╭──────────────────────────╮
+│        BMAD-METHOD       │
+╰──────────────────────────╯
+`;
+
+const FLATTENER_SMALL = `
+╭──────────────────────────╮
+│         FLATTENER        │
+╰──────────────────────────╯
+`;
+
+const INSTALLER_SMALL = `
+ ╭──────────────────────────╮
+ │         INSTALLER        │
+ ╰──────────────────────────╯
+ `;
+
+// Tiny (compact brackets)
+const BMAD_TINY = `[ BMAD-METHOD ]`;
+const FLATTENER_TINY = `[ FLATTENER ]`;
+const INSTALLER_TINY = `[ INSTALLER ]`;
+
+module.exports = {
+  BMAD_TITLE,
+  FLATTENER_TITLE,
+  INSTALLER_TITLE,
+  BMAD_LARGE,
+  FLATTENER_LARGE,
+  INSTALLER_LARGE,
+  BMAD_MEDIUM,
+  FLATTENER_MEDIUM,
+  INSTALLER_MEDIUM,
+  BMAD_SMALL,
+  FLATTENER_SMALL,
+  INSTALLER_SMALL,
+  BMAD_TINY,
+  FLATTENER_TINY,
+  INSTALLER_TINY,
+};

package/tools/sync-installer-version.js

@@ -1,28 +1,26 @@
-#!/usr/bin/env node
-
 /**
  * Sync installer package.json version with main package.json
  * Used by semantic-release to keep versions in sync
  */
 
-const fs = require('fs');
-const path = require('path');
+const fs = require('node:fs');
+const path = require('node:path');
 
 function syncInstallerVersion() {
   // Read main package.json
   const mainPackagePath = path.join(__dirname, '..', 'package.json');
   const mainPackage = JSON.parse(fs.readFileSync(mainPackagePath, 'utf8'));
-  
+
   // Read installer package.json
   const installerPackagePath = path.join(__dirname, 'installer', 'package.json');
   const installerPackage = JSON.parse(fs.readFileSync(installerPackagePath, 'utf8'));
-  
+
   // Update installer version to match main version
   installerPackage.version = mainPackage.version;
-  
+
   // Write back installer package.json
   fs.writeFileSync(installerPackagePath, JSON.stringify(installerPackage, null, 2) + '\n');
-  
+
   console.log(`Synced installer version to ${mainPackage.version}`);
 }
 
@@ -31,4 +29,4 @@ if (require.main === module) {
   syncInstallerVersion();
 }
 
-module.exports = { syncInstallerVersion };
+module.exports = { syncInstallerVersion };

package/tools/update-expansion-version.js

@@ -0,0 +1,53 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const yaml = require('js-yaml');
+
+const arguments_ = process.argv.slice(2);
+
+if (arguments_.length < 2) {
+  console.log('Usage: node update-expansion-version.js <expansion-pack-id> <new-version>');
+  console.log('Example: node update-expansion-version.js bmad-creator-tools 1.1.0');
+  process.exit(1);
+}
+
+const [packId, newVersion] = arguments_;
+
+// Validate version format
+if (!/^\d+\.\d+\.\d+$/.test(newVersion)) {
+  console.error('Error: Version must be in format X.Y.Z (e.g., 1.2.3)');
+  process.exit(1);
+}
+
+async function updateVersion() {
+  try {
+    // Update in config.yaml
+    const configPath = path.join(__dirname, '..', 'expansion-packs', packId, 'config.yaml');
+
+    if (!fs.existsSync(configPath)) {
+      console.error(`Error: Expansion pack '${packId}' not found`);
+      process.exit(1);
+    }
+
+    const configContent = fs.readFileSync(configPath, 'utf8');
+    const config = yaml.load(configContent);
+    const oldVersion = config.version || 'unknown';
+
+    config.version = newVersion;
+
+    const updatedYaml = yaml.dump(config, { indent: 2 });
+    fs.writeFileSync(configPath, updatedYaml);
+
+    console.log(`✓ Updated ${packId}/config.yaml: ${oldVersion} → ${newVersion}`);
+    console.log(`\n✓ Successfully updated ${packId} to version ${newVersion}`);
+    console.log('\nNext steps:');
+    console.log('1. Test the changes');
+    console.log(
+      '2. Commit: git add -A && git commit -m "chore: bump ' + packId + ' to v' + newVersion + '"',
+    );
+  } catch (error) {
+    console.error('Error updating version:', error.message);
+    process.exit(1);
+  }
+}
+
+updateVersion();