bmad-method 6.0.0-alpha.15 → 6.0.0-alpha.17

package/tools/cli/installers/lib/core/post-install-sidecar-replacement.js

@@ -1,79 +0,0 @@
-/**
- * Post-installation sidecar folder replacement utility
- * Replaces {agent_sidecar_folder} placeholders in all installed agents
- */
-
-const fs = require('fs-extra');
-const path = require('node:path');
-const yaml = require('yaml');
-const glob = require('glob');
-const chalk = require('chalk');
-
-/**
- * Replace {agent_sidecar_folder} placeholders in all agent files
- * @param {string} bmadDir - Path to .bmad directory
- * @returns {Object} Statistics about replacements made
- */
-async function replaceAgentSidecarFolders(bmadDir) {
-  const results = {
-    filesScanned: 0,
-    filesReplaced: 0,
-    totalReplacements: 0,
-    errors: [],
-  };
-
-  try {
-    // Load core config to get agent_sidecar_folder value
-    const coreConfigPath = path.join(bmadDir, 'bmb', 'config.yaml');
-
-    if (!(await fs.pathExists(coreConfigPath))) {
-      throw new Error(`Core config not found at ${coreConfigPath}`);
-    }
-
-    const coreConfigContent = await fs.readFile(coreConfigPath, 'utf8');
-    const coreConfig = yaml.parse(coreConfigContent);
-    const agentSidecarFolder = coreConfig.agent_sidecar_folder;
-
-    // Use the literal value from config, don't resolve the placeholders
-    console.log(chalk.dim(`\n  Replacing {agent_sidecar_folder} with: ${agentSidecarFolder}`));
-
-    // Find all agent .md files
-    const agentPattern = path.join(bmadDir, '**/*.md');
-    const agentFiles = glob.sync(agentPattern);
-
-    for (const agentFile of agentFiles) {
-      results.filesScanned++;
-
-      try {
-        let content = await fs.readFile(agentFile, 'utf8');
-
-        // Check if file contains {agent_sidecar_folder}
-        if (content.includes('{agent_sidecar_folder}')) {
-          // Replace all occurrences
-          const originalContent = content;
-          content = content.replaceAll('{agent_sidecar_folder}', agentSidecarFolder);
-
-          // Only write if content changed
-          if (content !== originalContent) {
-            await fs.writeFile(agentFile, content, 'utf8');
-
-            const replacementCount = (originalContent.match(/{agent_sidecar_folder}/g) || []).length;
-            results.filesReplaced++;
-            results.totalReplacements += replacementCount;
-
-            console.log(chalk.dim(`    ✓ Replaced ${replacementCount} occurrence(s) in ${path.relative(bmadDir, agentFile)}`));
-          }
-        }
-      } catch (error) {
-        results.errors.push(`Error processing ${agentFile}: ${error.message}`);
-      }
-    }
-
-    return results;
-  } catch (error) {
-    results.errors.push(`Fatal error: ${error.message}`);
-    return results;
-  }
-}
-
-module.exports = { replaceAgentSidecarFolders };

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

@@ -1,239 +0,0 @@
-/**
- * Utility function to replace {project-root} placeholders with actual installation target
- * Used during BMAD installation to set correct paths in agent and task files
- */
-
-const fs = require('node:fs');
-const path = require('node:path');
-
-/**
- * Replace {project-root} and {output_folder}/ placeholders in a single file
- * @param {string} filePath - Path to the file to process
- * @param {string} projectRoot - The actual project root path to substitute (must include trailing slash)
- * @param {string} docOut - The document output path (with leading slash)
- * @param {boolean} removeCompletely - If true, removes placeholders entirely instead of replacing
- * @returns {boolean} - True if replacements were made, false otherwise
- */
-function replacePlaceholdersInFile(filePath, projectRoot, docOut = '/docs', removeCompletely = false) {
-  try {
-    let content = fs.readFileSync(filePath, 'utf8');
-    const originalContent = content;
-
-    if (removeCompletely) {
-      // Remove placeholders entirely (for bundling)
-      content = content.replaceAll('{project-root}', '');
-      content = content.replaceAll('{output_folder}/', '');
-    } else {
-      // Handle the combined pattern first to avoid double slashes
-      if (projectRoot && docOut) {
-        // Replace {project-root}{output_folder}/ combinations first
-        // Remove leading slash from docOut since projectRoot has trailing slash
-        // Add trailing slash to docOut
-        const docOutNoLeadingSlash = docOut.replace(/^\//, '');
-        const docOutWithTrailingSlash = docOutNoLeadingSlash.endsWith('/') ? docOutNoLeadingSlash : docOutNoLeadingSlash + '/';
-        content = content.replaceAll('{project-root}{output_folder}/', projectRoot + docOutWithTrailingSlash);
-      }
-
-      // Then replace remaining individual placeholders
-      if (projectRoot) {
-        content = content.replaceAll('{project-root}', projectRoot);
-      }
-
-      if (docOut) {
-        // For standalone {output_folder}/, keep the leading slash and add trailing slash
-        const docOutWithTrailingSlash = docOut.endsWith('/') ? docOut : docOut + '/';
-        content = content.replaceAll('{output_folder}/', docOutWithTrailingSlash);
-      }
-    }
-
-    if (content !== originalContent) {
-      fs.writeFileSync(filePath, content, 'utf8');
-      return true;
-    }
-
-    return false;
-  } catch (error) {
-    console.error(`Error processing file ${filePath}:`, error.message);
-    return false;
-  }
-}
-
-/**
- * Legacy function name for backward compatibility
- */
-function replaceProjectRootInFile(filePath, projectRoot, removeCompletely = false) {
-  return replacePlaceholdersInFile(filePath, projectRoot, '/docs', removeCompletely);
-}
-
-/**
- * Recursively replace {project-root} and {output_folder}/ in all files in a directory
- * @param {string} dirPath - Directory to process
- * @param {string} projectRoot - The actual project root path to substitute (or null to remove)
- * @param {string} docOut - The document output path (with leading slash)
- * @param {Array<string>} extensions - File extensions to process (default: ['.md', '.xml', '.yaml'])
- * @param {boolean} removeCompletely - If true, removes placeholders entirely instead of replacing
- * @param {boolean} verbose - If true, show detailed output for each file
- * @returns {Object} - Stats object with counts of files processed and modified
- */
-function replacePlaceholdersInDirectory(
-  dirPath,
-  projectRoot,
-  docOut = '/docs',
-  extensions = ['.md', '.xml', '.yaml'],
-  removeCompletely = false,
-  verbose = false,
-) {
-  const stats = {
-    processed: 0,
-    modified: 0,
-    errors: 0,
-  };
-
-  function processDirectory(currentPath) {
-    try {
-      const items = fs.readdirSync(currentPath, { withFileTypes: true });
-
-      for (const item of items) {
-        const fullPath = path.join(currentPath, item.name);
-
-        if (item.isDirectory()) {
-          // Skip node_modules and .git directories
-          if (item.name !== 'node_modules' && item.name !== '.git') {
-            processDirectory(fullPath);
-          }
-        } else if (item.isFile()) {
-          // Check if file has one of the target extensions
-          const ext = path.extname(item.name).toLowerCase();
-          if (extensions.includes(ext)) {
-            stats.processed++;
-            if (replacePlaceholdersInFile(fullPath, projectRoot, docOut, removeCompletely)) {
-              stats.modified++;
-              if (verbose) {
-                console.log(`✓ Updated: ${fullPath}`);
-              }
-            }
-          }
-        }
-      }
-    } catch (error) {
-      console.error(`Error processing directory ${currentPath}:`, error.message);
-      stats.errors++;
-    }
-  }
-
-  processDirectory(dirPath);
-  return stats;
-}
-
-/**
- * Legacy function for backward compatibility
- */
-function replaceProjectRootInDirectory(dirPath, projectRoot, extensions = ['.md', '.xml'], removeCompletely = false) {
-  return replacePlaceholdersInDirectory(dirPath, projectRoot, '/docs', extensions, removeCompletely);
-}
-
-/**
- * Replace placeholders in a list of specific files
- * @param {Array<string>} filePaths - Array of file paths to process
- * @param {string} projectRoot - The actual project root path to substitute (or null to remove)
- * @param {string} docOut - The document output path (with leading slash)
- * @param {boolean} removeCompletely - If true, removes placeholders entirely instead of replacing
- * @returns {Object} - Stats object with counts of files processed and modified
- */
-function replacePlaceholdersInFiles(filePaths, projectRoot, docOut = '/docs', removeCompletely = false) {
-  const stats = {
-    processed: 0,
-    modified: 0,
-    errors: 0,
-  };
-
-  for (const filePath of filePaths) {
-    stats.processed++;
-    try {
-      if (replacePlaceholdersInFile(filePath, projectRoot, docOut, removeCompletely)) {
-        stats.modified++;
-        console.log(`✓ Updated: ${filePath}`);
-      }
-    } catch (error) {
-      console.error(`Error processing file ${filePath}:`, error.message);
-      stats.errors++;
-    }
-  }
-
-  return stats;
-}
-
-/**
- * Legacy function for backward compatibility
- */
-function replaceProjectRootInFiles(filePaths, projectRoot, removeCompletely = false) {
-  return replacePlaceholdersInFiles(filePaths, projectRoot, '/docs', removeCompletely);
-}
-
-/**
- * Main installation helper - replaces {project-root} and {output_folder}/ during BMAD installation
- * @param {string} installPath - Path where BMAD is being installed
- * @param {string} targetProjectRoot - The project root to set in the files (slash will be added)
- * @param {string} docsOutputPath - The documentation output path (relative to project root)
- * @param {boolean} verbose - If true, show detailed output
- * @returns {Object} - Installation stats
- */
-function processInstallation(installPath, targetProjectRoot, docsOutputPath = 'docs', verbose = false) {
-  // Ensure project root has trailing slash since usage is like {project-root}/bmad
-  const projectRootWithSlash = targetProjectRoot.endsWith('/') ? targetProjectRoot : targetProjectRoot + '/';
-
-  // Ensure docs path has leading slash (for internal use) but will add trailing slash during replacement
-  const normalizedDocsPath = docsOutputPath.replaceAll(/^\/+|\/+$/g, '');
-  const docOutPath = normalizedDocsPath ? `/${normalizedDocsPath}` : '/docs';
-
-  if (verbose) {
-    console.log(`\nReplacing {project-root} with: ${projectRootWithSlash}`);
-    console.log(`Replacing {output_folder}/ with: ${docOutPath}/`);
-    console.log(`Processing files in: ${installPath}\n`);
-  }
-
-  const stats = replacePlaceholdersInDirectory(installPath, projectRootWithSlash, docOutPath, ['.md', '.xml', '.yaml'], false, verbose);
-
-  if (verbose) {
-    console.log('\n--- Installation Processing Complete ---');
-  }
-  console.log(`Files processed: ${stats.processed}`);
-  console.log(`Files modified: ${stats.modified}`);
-  if (stats.errors > 0) {
-    console.log(`Errors encountered: ${stats.errors}`);
-  }
-
-  return stats;
-}
-
-/**
- * Bundle helper - removes {project-root}/ references for web bundling
- * @param {string} bundlePath - Path where files are being bundled
- * @returns {Object} - Bundle stats
- */
-function processBundleRemoval(bundlePath) {
-  console.log(`\nRemoving {project-root}/ references for bundling`);
-  console.log(`Processing files in: ${bundlePath}\n`);
-
-  const stats = replaceProjectRootInDirectory(bundlePath, null, ['.md', '.xml'], true);
-
-  console.log('\n--- Bundle Processing Complete ---');
-  console.log(`Files processed: ${stats.processed}`);
-  console.log(`Files modified: ${stats.modified}`);
-  if (stats.errors > 0) {
-    console.log(`Errors encountered: ${stats.errors}`);
-  }
-
-  return stats;
-}
-
-module.exports = {
-  replacePlaceholdersInFile,
-  replacePlaceholdersInDirectory,
-  replacePlaceholdersInFiles,
-  replaceProjectRootInFile,
-  replaceProjectRootInDirectory,
-  replaceProjectRootInFiles,
-  processInstallation,
-  processBundleRemoval,
-};

package/tools/cli/regenerate-manifests.js

@@ -1,28 +0,0 @@
-const path = require('node:path');
-const { ManifestGenerator } = require('./installers/lib/core/manifest-generator');
-
-async function regenerateManifests() {
-  const generator = new ManifestGenerator();
-  const targetDir = process.argv[2] || 'z1';
-  const bmadDir = path.join(process.cwd(), targetDir, 'bmad');
-
-  // List of modules to include in manifests
-  const selectedModules = ['bmb', 'bmm', 'cis'];
-
-  console.log('Regenerating manifests with relative paths...');
-  console.log('Target directory:', bmadDir);
-
-  try {
-    const result = await generator.generateManifests(bmadDir, selectedModules, [], { ides: [] });
-    console.log('✓ Manifests generated successfully:');
-    console.log(`  - ${result.workflows} workflows`);
-    console.log(`  - ${result.agents} agents`);
-    console.log(`  - ${result.tasks} tasks`);
-    console.log(`  - ${result.files} files in files-manifest.csv`);
-  } catch (error) {
-    console.error('Error generating manifests:', error);
-    process.exit(1);
-  }
-}
-
-regenerateManifests();

package/tools/cli/test-yaml-builder.js

@@ -1,43 +0,0 @@
-/**
- * Test script for YAML → XML agent builder
- * Usage: node tools/cli/test-yaml-builder.js
- */
-
-const path = require('node:path');
-const { YamlXmlBuilder } = require('./lib/yaml-xml-builder');
-const { getProjectRoot } = require('./lib/project-root');
-
-async function test() {
-  console.log('Testing YAML → XML Agent Builder\n');
-
-  const builder = new YamlXmlBuilder();
-  const projectRoot = getProjectRoot();
-
-  // Paths
-  const agentYamlPath = path.join(projectRoot, 'src/modules/bmm/agents/pm.agent.yaml');
-  const outputPath = path.join(projectRoot, 'test-output-pm.md');
-
-  console.log(`Source: ${agentYamlPath}`);
-  console.log(`Output: ${outputPath}\n`);
-
-  try {
-    const result = await builder.buildAgent(
-      agentYamlPath,
-      null, // No customize file for this test
-      outputPath,
-      { includeMetadata: true },
-    );
-
-    console.log('✓ Build successful!');
-    console.log(`  Output: ${result.outputPath}`);
-    console.log(`  Source hash: ${result.sourceHash}`);
-    console.log('\nGenerated XML file at:', outputPath);
-    console.log('Review the output to verify correctness.\n');
-  } catch (error) {
-    console.error('✗ Build failed:', error.message);
-    console.error(error.stack);
-    process.exit(1);
-  }
-}
-
-test();