bmad-method 4.37.0 → 4.39.1

package/tools/bump-all-versions.js

@@ -1,11 +1,9 @@
-#!/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 bumpType = args[0] || 'minor'; // default to minor
+const arguments_ = process.argv.slice(2);
+const bumpType = arguments_[0] || 'minor'; // default to minor
 
 if (!['major', 'minor', 'patch'].includes(bumpType)) {
   console.log('Usage: node bump-all-versions.js [major|minor|patch]');
@@ -15,22 +13,26 @@ if (!['major', 'minor', 'patch'].includes(bumpType)) {
 
 function bumpVersion(currentVersion, type) {
   const [major, minor, patch] = currentVersion.split('.').map(Number);
-  
+
   switch (type) {
-    case 'major':
+    case 'major': {
       return `${major + 1}.0.0`;
-    case 'minor':
+    }
+    case 'minor': {
       return `${major}.${minor + 1}.0`;
-    case 'patch':
+    }
+    case 'patch': {
       return `${major}.${minor}.${patch + 1}`;
-    default:
+    }
+    default: {
       return currentVersion;
+    }
   }
 }
 
 async function bumpAllVersions() {
   const updatedItems = [];
-  
+
   // First, bump the core version (package.json)
   const packagePath = path.join(__dirname, '..', 'package.json');
   try {
@@ -38,69 +40,76 @@ async function bumpAllVersions() {
     const packageJson = JSON.parse(packageContent);
     const oldCoreVersion = packageJson.version || '1.0.0';
     const newCoreVersion = bumpVersion(oldCoreVersion, bumpType);
-    
+
     packageJson.version = newCoreVersion;
-    
+
     fs.writeFileSync(packagePath, JSON.stringify(packageJson, null, 2) + '\n');
-    
-    updatedItems.push({ type: 'core', name: 'BMad Core', oldVersion: oldCoreVersion, newVersion: newCoreVersion });
+
+    updatedItems.push({
+      type: 'core',
+      name: 'BMad Core',
+      oldVersion: oldCoreVersion,
+      newVersion: newCoreVersion,
+    });
     console.log(`✓ BMad Core (package.json): ${oldCoreVersion} → ${newCoreVersion}`);
   } catch (error) {
     console.error(`✗ Failed to update BMad Core: ${error.message}`);
   }
-  
+
   // Then, bump all expansion packs
   const expansionPacksDir = path.join(__dirname, '..', 'expansion-packs');
-  
+
   try {
     const entries = fs.readdirSync(expansionPacksDir, { withFileTypes: true });
-    
+
     for (const entry of entries) {
       if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'README.md') {
         const packId = entry.name;
         const configPath = path.join(expansionPacksDir, packId, 'config.yaml');
-        
+
         if (fs.existsSync(configPath)) {
           try {
             const configContent = fs.readFileSync(configPath, 'utf8');
             const config = yaml.load(configContent);
             const oldVersion = config.version || '1.0.0';
             const newVersion = bumpVersion(oldVersion, bumpType);
-            
+
             config.version = newVersion;
-            
+
             const updatedYaml = yaml.dump(config, { indent: 2 });
             fs.writeFileSync(configPath, updatedYaml);
-            
+
             updatedItems.push({ type: 'expansion', name: packId, oldVersion, newVersion });
             console.log(`✓ ${packId}: ${oldVersion} → ${newVersion}`);
-            
           } catch (error) {
             console.error(`✗ Failed to update ${packId}: ${error.message}`);
           }
         }
       }
     }
-    
+
     if (updatedItems.length > 0) {
-      const coreCount = updatedItems.filter(i => i.type === 'core').length;
-      const expansionCount = updatedItems.filter(i => i.type === 'expansion').length;
-      
-      console.log(`\n✓ Successfully bumped ${updatedItems.length} item(s) with ${bumpType} version bump`);
+      const coreCount = updatedItems.filter((index) => index.type === 'core').length;
+      const expansionCount = updatedItems.filter((index) => index.type === 'expansion').length;
+
+      console.log(
+        `\n✓ Successfully bumped ${updatedItems.length} item(s) with ${bumpType} version bump`,
+      );
       if (coreCount > 0) console.log(`  - ${coreCount} core`);
       if (expansionCount > 0) console.log(`  - ${expansionCount} expansion pack(s)`);
-      
+
       console.log('\nNext steps:');
       console.log('1. Test the changes');
-      console.log('2. Commit: git add -A && git commit -m "chore: bump all versions (' + bumpType + ')"');
+      console.log(
+        '2. Commit: git add -A && git commit -m "chore: bump all versions (' + bumpType + ')"',
+      );
     } else {
       console.log('No items found to update');
     }
-    
   } catch (error) {
     console.error('Error reading expansion packs directory:', error.message);
     process.exit(1);
   }
 }
 
-bumpAllVersions();
+bumpAllVersions();

package/tools/bump-expansion-version.js

@@ -1,17 +1,15 @@
-#!/usr/bin/env node
-
 // Load required modules
-const fs = require('fs');
-const path = require('path');
+const fs = require('node:fs');
+const path = require('node:path');
 const yaml = require('js-yaml');
 
 // Parse CLI arguments
-const args = process.argv.slice(2);
-const packId = args[0];
-const bumpType = args[1] || 'minor';
+const arguments_ = process.argv.slice(2);
+const packId = arguments_[0];
+const bumpType = arguments_[1] || 'minor';
 
 // Validate arguments
-if (!packId || args.length > 2) {
+if (!packId || arguments_.length > 2) {
   console.log('Usage: node bump-expansion-version.js <expansion-pack-id> [major|minor|patch]');
   console.log('Default: minor');
   console.log('Example: node bump-expansion-version.js bmad-creator-tools patch');
@@ -28,10 +26,18 @@ function bumpVersion(currentVersion, type) {
   const [major, minor, patch] = currentVersion.split('.').map(Number);
 
   switch (type) {
-    case 'major': return `${major + 1}.0.0`;
-    case 'minor': return `${major}.${minor + 1}.0`;
-    case 'patch': return `${major}.${minor}.${patch + 1}`;
-    default: return currentVersion;
+    case 'major': {
+      return `${major + 1}.0.0`;
+    }
+    case 'minor': {
+      return `${major}.${minor + 1}.0`;
+    }
+    case 'patch': {
+      return `${major}.${minor}.${patch + 1}`;
+    }
+    default: {
+      return currentVersion;
+    }
   }
 }
 
@@ -47,11 +53,11 @@ async function updateVersion() {
     const packsDir = path.join(__dirname, '..', 'expansion-packs');
     const entries = fs.readdirSync(packsDir, { withFileTypes: true });
 
-    entries.forEach(entry => {
+    for (const entry of entries) {
       if (entry.isDirectory() && !entry.name.startsWith('.')) {
         console.log(`  - ${entry.name}`);
       }
-    });
+    }
 
     process.exit(1);
   }
@@ -72,8 +78,9 @@ async function updateVersion() {
     console.log(`\n✓ Successfully bumped ${packId} with ${bumpType} version bump`);
     console.log('\nNext steps:');
     console.log(`1. Test the changes`);
-    console.log(`2. Commit: git add -A && git commit -m "chore: bump ${packId} version (${bumpType})"`);
-
+    console.log(
+      `2. Commit: git add -A && git commit -m "chore: bump ${packId} version (${bumpType})"`,
+    );
   } catch (error) {
     console.error('Error updating version:', error.message);
     process.exit(1);

package/tools/cli.js

@@ -1,10 +1,8 @@
-#!/usr/bin/env node
-
 const { Command } = require('commander');
 const WebBuilder = require('./builders/web-builder');
 const V3ToV4Upgrader = require('./upgraders/v3-to-v4-upgrader');
 const IdeSetup = require('./installer/lib/ide-setup');
-const path = require('path');
+const path = require('node:path');
 
 const program = new Command();
 
@@ -23,7 +21,7 @@ program
   .option('--no-clean', 'Skip cleaning output directories')
   .action(async (options) => {
     const builder = new WebBuilder({
-      rootDir: process.cwd()
+      rootDir: process.cwd(),
     });
 
     try {
@@ -66,7 +64,7 @@ program
   .option('--no-clean', 'Skip cleaning output directories')
   .action(async (options) => {
     const builder = new WebBuilder({
-      rootDir: process.cwd()
+      rootDir: process.cwd(),
     });
 
     try {
@@ -92,7 +90,7 @@ program
     const builder = new WebBuilder({ rootDir: process.cwd() });
     const agents = await builder.resolver.listAgents();
     console.log('Available agents:');
-    agents.forEach(agent => console.log(`  - ${agent}`));
+    for (const agent of agents) console.log(`  - ${agent}`);
     process.exit(0);
   });
 
@@ -103,7 +101,7 @@ program
     const builder = new WebBuilder({ rootDir: process.cwd() });
     const expansions = await builder.listExpansionPacks();
     console.log('Available expansion packs:');
-    expansions.forEach(expansion => console.log(`  - ${expansion}`));
+    for (const expansion of expansions) console.log(`  - ${expansion}`);
     process.exit(0);
   });
 
@@ -116,19 +114,19 @@ program
       // Validate by attempting to build all agents and teams
       const agents = await builder.resolver.listAgents();
       const teams = await builder.resolver.listTeams();
-      
+
       console.log('Validating agents...');
       for (const agent of agents) {
         await builder.resolver.resolveAgentDependencies(agent);
         console.log(`  ✓ ${agent}`);
       }
-      
+
       console.log('\nValidating teams...');
       for (const team of teams) {
         await builder.resolver.resolveTeamDependencies(team);
         console.log(`  ✓ ${team}`);
       }
-      
+
       console.log('\nAll configurations are valid!');
     } catch (error) {
       console.error('Validation failed:', error.message);
@@ -147,8 +145,8 @@ program
     await upgrader.upgrade({
       projectPath: options.project,
       dryRun: options.dryRun,
-      backup: options.backup
+      backup: options.backup,
     });
   });
 
-program.parse();
+program.parse();

package/tools/flattener/aggregate.js

@@ -1,7 +1,7 @@
-const fs = require("fs-extra");
-const path = require("node:path");
-const os = require("node:os");
-const { isBinaryFile } = require("./binary.js");
+const fs = require('fs-extra');
+const path = require('node:path');
+const os = require('node:os');
+const { isBinaryFile } = require('./binary.js');
 
 /**
  * Aggregate file contents with bounded concurrency.
@@ -22,7 +22,7 @@ async function aggregateFileContents(files, rootDir, spinner = null) {
   // Automatic concurrency selection based on CPU count and workload size.
   // - Base on 2x logical CPUs, clamped to [2, 64]
   // - For very small workloads, avoid excessive parallelism
-  const cpuCount = (os.cpus && Array.isArray(os.cpus()) ? os.cpus().length : (os.cpus?.length || 4));
+  const cpuCount = os.cpus && Array.isArray(os.cpus()) ? os.cpus().length : os.cpus?.length || 4;
   let concurrency = Math.min(64, Math.max(2, (Number(cpuCount) || 4) * 2));
   if (files.length > 0 && files.length < concurrency) {
     concurrency = Math.max(1, Math.min(concurrency, Math.ceil(files.length / 2)));
@@ -37,16 +37,16 @@ async function aggregateFileContents(files, rootDir, spinner = null) {
 
       const binary = await isBinaryFile(filePath);
       if (binary) {
-        const size = (await fs.stat(filePath)).size;
+        const { size } = await fs.stat(filePath);
         results.binaryFiles.push({ path: relativePath, absolutePath: filePath, size });
       } else {
-        const content = await fs.readFile(filePath, "utf8");
+        const content = await fs.readFile(filePath, 'utf8');
         results.textFiles.push({
           path: relativePath,
           absolutePath: filePath,
           content,
           size: content.length,
-          lines: content.split("\n").length,
+          lines: content.split('\n').length,
         });
       }
     } catch (error) {
@@ -63,8 +63,8 @@ async function aggregateFileContents(files, rootDir, spinner = null) {
     }
   }
 
-  for (let i = 0; i < files.length; i += concurrency) {
-    const slice = files.slice(i, i + concurrency);
+  for (let index = 0; index < files.length; index += concurrency) {
+    const slice = files.slice(index, index + concurrency);
     await Promise.all(slice.map(processOne));
   }
 

package/tools/flattener/binary.js

@@ -1,6 +1,6 @@
-const fsp = require("node:fs/promises");
-const path = require("node:path");
-const { Buffer } = require("node:buffer");
+const fsp = require('node:fs/promises');
+const path = require('node:path');
+const { Buffer } = require('node:buffer');
 
 /**
  * Efficiently determine if a file is binary without reading the whole file.
@@ -13,25 +13,54 @@ async function isBinaryFile(filePath) {
   try {
     const stats = await fsp.stat(filePath);
     if (stats.isDirectory()) {
-      throw new Error("EISDIR: illegal operation on a directory");
+      throw new Error('EISDIR: illegal operation on a directory');
     }
 
     const binaryExtensions = new Set([
-      ".jpg", ".jpeg", ".png", ".gif", ".bmp", ".ico", ".svg",
-      ".pdf", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
-      ".zip", ".tar", ".gz", ".rar", ".7z",
-      ".exe", ".dll", ".so", ".dylib",
-      ".mp3", ".mp4", ".avi", ".mov", ".wav",
-      ".ttf", ".otf", ".woff", ".woff2",
-      ".bin", ".dat", ".db", ".sqlite",
+      '.jpg',
+      '.jpeg',
+      '.png',
+      '.gif',
+      '.bmp',
+      '.ico',
+      '.svg',
+      '.pdf',
+      '.doc',
+      '.docx',
+      '.xls',
+      '.xlsx',
+      '.ppt',
+      '.pptx',
+      '.zip',
+      '.tar',
+      '.gz',
+      '.rar',
+      '.7z',
+      '.exe',
+      '.dll',
+      '.so',
+      '.dylib',
+      '.mp3',
+      '.mp4',
+      '.avi',
+      '.mov',
+      '.wav',
+      '.ttf',
+      '.otf',
+      '.woff',
+      '.woff2',
+      '.bin',
+      '.dat',
+      '.db',
+      '.sqlite',
     ]);
 
-    const ext = path.extname(filePath).toLowerCase();
-    if (binaryExtensions.has(ext)) return true;
+    const extension = path.extname(filePath).toLowerCase();
+    if (binaryExtensions.has(extension)) return true;
     if (stats.size === 0) return false;
 
     const sampleSize = Math.min(4096, stats.size);
-    const fd = await fsp.open(filePath, "r");
+    const fd = await fsp.open(filePath, 'r');
     try {
       const buffer = Buffer.allocUnsafe(sampleSize);
       const { bytesRead } = await fd.read(buffer, 0, sampleSize, 0);
@@ -41,9 +70,7 @@ async function isBinaryFile(filePath) {
       await fd.close();
     }
   } catch (error) {
-    console.warn(
-      `Warning: Could not determine if file is binary: ${filePath} - ${error.message}`,
-    );
+    console.warn(`Warning: Could not determine if file is binary: ${filePath} - ${error.message}`);
     return false;
   }
 }

package/tools/flattener/discovery.js

@@ -1,18 +1,21 @@
-const path = require("node:path");
-const { execFile } = require("node:child_process");
-const { promisify } = require("node:util");
-const { glob } = require("glob");
-const { loadIgnore } = require("./ignoreRules.js");
+const path = require('node:path');
+const { execFile } = require('node:child_process');
+const { promisify } = require('node:util');
+const { glob } = require('glob');
+const { loadIgnore } = require('./ignoreRules.js');
 
 const pExecFile = promisify(execFile);
 
 async function isGitRepo(rootDir) {
   try {
-    const { stdout } = await pExecFile("git", [
-      "rev-parse",
-      "--is-inside-work-tree",
-    ], { cwd: rootDir });
-    return String(stdout || "").toString().trim() === "true";
+    const { stdout } = await pExecFile('git', ['rev-parse', '--is-inside-work-tree'], {
+      cwd: rootDir,
+    });
+    return (
+      String(stdout || '')
+        .toString()
+        .trim() === 'true'
+    );
   } catch {
     return false;
   }
@@ -20,12 +23,10 @@ async function isGitRepo(rootDir) {
 
 async function gitListFiles(rootDir) {
   try {
-    const { stdout } = await pExecFile("git", [
-      "ls-files",
-      "-co",
-      "--exclude-standard",
-    ], { cwd: rootDir });
-    return String(stdout || "")
+    const { stdout } = await pExecFile('git', ['ls-files', '-co', '--exclude-standard'], {
+      cwd: rootDir,
+    });
+    return String(stdout || '')
       .split(/\r?\n/)
       .map((s) => s.trim())
       .filter(Boolean);
@@ -48,14 +49,14 @@ async function discoverFiles(rootDir, options = {}) {
   const { filter } = await loadIgnore(rootDir);
 
   // Try git first
-  if (preferGit && await isGitRepo(rootDir)) {
+  if (preferGit && (await isGitRepo(rootDir))) {
     const relFiles = await gitListFiles(rootDir);
     const filteredRel = relFiles.filter((p) => filter(p));
     return filteredRel.map((p) => path.resolve(rootDir, p));
   }
 
   // Glob fallback
-  const globbed = await glob("**/*", {
+  const globbed = await glob('**/*', {
     cwd: rootDir,
     nodir: true,
     dot: true,

package/tools/flattener/files.js

@@ -1,8 +1,8 @@
-const path = require("node:path");
-const discovery = require("./discovery.js");
-const ignoreRules = require("./ignoreRules.js");
-const { isBinaryFile } = require("./binary.js");
-const { aggregateFileContents } = require("./aggregate.js");
+const path = require('node:path');
+const discovery = require('./discovery.js');
+const ignoreRules = require('./ignoreRules.js');
+const { isBinaryFile } = require('./binary.js');
+const { aggregateFileContents } = require('./aggregate.js');
 
 // Backward-compatible signature; delegate to central loader
 async function parseGitignore(gitignorePath) {
@@ -14,7 +14,7 @@ async function discoverFiles(rootDir) {
     // Delegate to discovery module which respects .gitignore and defaults
     return await discovery.discoverFiles(rootDir, { preferGit: true });
   } catch (error) {
-    console.error("Error discovering files:", error.message);
+    console.error('Error discovering files:', error.message);
     return [];
   }
 }