bmad-method 4.37.0 → 4.39.1

package/tools/lib/dependency-resolver.js

@@ -1,5 +1,5 @@
-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');
 
@@ -14,23 +14,23 @@ class DependencyResolver {
   async resolveAgentDependencies(agentId) {
     const agentPath = path.join(this.bmadCore, 'agents', `${agentId}.md`);
     const agentContent = await fs.readFile(agentPath, 'utf8');
-    
+
     // 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}`);
     }
-    
+
     const agentConfig = yaml.load(yamlContent);
-    
+
     const dependencies = {
       agent: {
         id: agentId,
         path: agentPath,
         content: agentContent,
-        config: agentConfig
+        config: agentConfig,
       },
-      resources: []
+      resources: [],
     };
 
     // Personas are now embedded in agent configs, no need to resolve separately
@@ -52,49 +52,49 @@ class DependencyResolver {
     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: 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
@@ -104,7 +104,7 @@ class DependencyResolver {
     }
 
     // Convert Map back to array
-    dependencies.resources = Array.from(dependencies.resources.values());
+    dependencies.resources = [...dependencies.resources.values()];
 
     return dependencies;
   }
@@ -123,12 +123,12 @@ class DependencyResolver {
       try {
         filePath = path.join(this.bmadCore, type, id);
         content = await fs.readFile(filePath, 'utf8');
-      } catch (e) {
+      } catch {
         // If not found in bmad-core, try common folder
         try {
           filePath = path.join(this.common, type, id);
           content = await fs.readFile(filePath, 'utf8');
-        } catch (e2) {
+        } catch {
           // File not found in either location
         }
       }
@@ -142,7 +142,7 @@ class DependencyResolver {
         type,
         id,
         path: filePath,
-        content
+        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,10 +165,8 @@ class DependencyResolver {
   async listTeams() {
     try {
       const files = await fs.readdir(path.join(this.bmadCore, 'agent-teams'));
-      return files
-        .filter(f => f.endsWith('.yaml'))
-        .map(f => f.replace('.yaml', ''));
-    } catch (error) {
+      return files.filter((f) => f.endsWith('.yaml')).map((f) => f.replace('.yaml', ''));
+    } catch {
       return [];
     }
   }

package/tools/lib/yaml-utils.js

@@ -10,20 +10,20 @@
  */
 function extractYamlFromAgent(agentContent, cleanCommands = false) {
   // Remove carriage returns and match YAML block
-  const yamlMatch = agentContent.replace(/\r/g, "").match(/```ya?ml\n([\s\S]*?)\n```/);
+  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.replace(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
+    yamlContent = yamlContent.replaceAll(/^(\s*-)(\s*"[^"]+")(\s*-\s*.*)$/gm, '$1$2');
   }
-  
+
   return yamlContent;
 }
 
 module.exports = {
-  extractYamlFromAgent
-};
+  extractYamlFromAgent,
+};

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

@@ -1,8 +1,8 @@
 // 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";
+const BMAD_TITLE = 'BMAD-METHOD';
+const FLATTENER_TITLE = 'FLATTENER';
+const INSTALLER_TITLE = 'INSTALLER';
 
 // Large ASCII blocks (block-style fonts)
 const BMAD_LARGE = `

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

@@ -1,18 +1,16 @@
-#!/usr/bin/env node
-
-const fs = require('fs');
-const path = require('path');
+const fs = require('node:fs');
+const path = require('node:path');
 const yaml = require('js-yaml');
 
-const args = process.argv.slice(2);
+const arguments_ = process.argv.slice(2);
 
-if (args.length < 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] = args;
+const [packId, newVersion] = arguments_;
 
 // Validate version format
 if (!/^\d+\.\d+\.\d+$/.test(newVersion)) {
@@ -24,31 +22,32 @@ 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 + '"');
-    
+    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();
+updateVersion();