bmad-method 6.0.1 → 6.0.2

package/tools/cli/installers/lib/ide/rovodev.js

@@ -0,0 +1,257 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const yaml = require('yaml');
+const { BaseIdeSetup } = require('./_base-ide');
+const prompts = require('../../../lib/prompts');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
+const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');
+const { TaskToolCommandGenerator } = require('./shared/task-tool-command-generator');
+const { toDashPath } = require('./shared/path-utils');
+
+/**
+ * Rovo Dev IDE setup handler
+ *
+ * Custom installer that writes .md workflow files to .rovodev/workflows/
+ * and generates .rovodev/prompts.yml to register them with Rovo Dev's /prompts feature.
+ *
+ * prompts.yml format (per Rovo Dev docs):
+ *   prompts:
+ *     - name: bmad-bmm-create-prd
+ *       description: "PRD workflow..."
+ *       content_file: workflows/bmad-bmm-create-prd.md
+ */
+class RovoDevSetup extends BaseIdeSetup {
+  constructor() {
+    super('rovo-dev', 'Rovo Dev', false);
+    this.rovoDir = '.rovodev';
+    this.workflowsDir = 'workflows';
+    this.promptsFile = 'prompts.yml';
+  }
+
+  /**
+   * Setup Rovo Dev configuration
+   * @param {string} projectDir - Project directory
+   * @param {string} bmadDir - BMAD installation directory
+   * @param {Object} options - Setup options
+   * @returns {Promise<Object>} Setup result with { success, results: { agents, workflows, tasks, tools } }
+   */
+  async setup(projectDir, bmadDir, options = {}) {
+    if (!options.silent) await prompts.log.info(`Setting up ${this.name}...`);
+
+    // Clean up any old BMAD installation first
+    await this.cleanup(projectDir, options);
+
+    const workflowsPath = path.join(projectDir, this.rovoDir, this.workflowsDir);
+    await this.ensureDir(workflowsPath);
+
+    const selectedModules = options.selectedModules || [];
+    const writtenFiles = [];
+
+    // Generate and write agent launchers
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, selectedModules);
+    const agentCount = await agentGen.writeDashArtifacts(workflowsPath, agentArtifacts);
+    this._collectPromptEntries(writtenFiles, agentArtifacts, ['agent-launcher'], 'agent');
+
+    // Generate and write workflow commands
+    const workflowGen = new WorkflowCommandGenerator(this.bmadFolderName);
+    const { artifacts: workflowArtifacts } = await workflowGen.collectWorkflowArtifacts(bmadDir);
+    const workflowCount = await workflowGen.writeDashArtifacts(workflowsPath, workflowArtifacts);
+    this._collectPromptEntries(writtenFiles, workflowArtifacts, ['workflow-command'], 'workflow');
+
+    // Generate and write task/tool commands
+    const taskToolGen = new TaskToolCommandGenerator(this.bmadFolderName);
+    const { artifacts: taskToolArtifacts, counts: taskToolCounts } = await taskToolGen.collectTaskToolArtifacts(bmadDir);
+    await taskToolGen.writeDashArtifacts(workflowsPath, taskToolArtifacts);
+    const taskCount = taskToolCounts.tasks || 0;
+    const toolCount = taskToolCounts.tools || 0;
+    this._collectPromptEntries(writtenFiles, taskToolArtifacts, ['task', 'tool']);
+
+    // Generate prompts.yml manifest (only if we have entries to write)
+    if (writtenFiles.length > 0) {
+      await this.generatePromptsYml(projectDir, writtenFiles);
+    }
+
+    if (!options.silent) {
+      await prompts.log.success(
+        `${this.name} configured: ${agentCount} agents, ${workflowCount} workflows, ${taskCount} tasks, ${toolCount} tools`,
+      );
+    }
+
+    return {
+      success: true,
+      results: {
+        agents: agentCount,
+        workflows: workflowCount,
+        tasks: taskCount,
+        tools: toolCount,
+      },
+    };
+  }
+
+  /**
+   * Collect prompt entries from artifacts into writtenFiles array
+   * @param {Array} writtenFiles - Target array to push entries into
+   * @param {Array} artifacts - Artifacts from a generator's collect method
+   * @param {string[]} acceptedTypes - Artifact types to include (e.g., ['agent-launcher'])
+   * @param {string} [fallbackSuffix] - Suffix for fallback description; defaults to artifact.type
+   */
+  _collectPromptEntries(writtenFiles, artifacts, acceptedTypes, fallbackSuffix) {
+    for (const artifact of artifacts) {
+      if (!acceptedTypes.includes(artifact.type)) continue;
+      const flatName = toDashPath(artifact.relativePath);
+      writtenFiles.push({
+        name: path.basename(flatName, '.md'),
+        description: artifact.description || `${artifact.name} ${fallbackSuffix || artifact.type}`,
+        contentFile: `${this.workflowsDir}/${flatName}`,
+      });
+    }
+  }
+
+  /**
+   * Generate .rovodev/prompts.yml manifest
+   * Merges with existing user entries -- strips entries with names starting 'bmad-',
+   * appends new BMAD entries, and writes back.
+   *
+   * @param {string} projectDir - Project directory
+   * @param {Array<Object>} writtenFiles - Array of { name, description, contentFile }
+   */
+  async generatePromptsYml(projectDir, writtenFiles) {
+    const promptsPath = path.join(projectDir, this.rovoDir, this.promptsFile);
+    let existingPrompts = [];
+
+    // Read existing prompts.yml and preserve non-BMAD entries
+    if (await this.pathExists(promptsPath)) {
+      try {
+        const content = await this.readFile(promptsPath);
+        const parsed = yaml.parse(content);
+        if (parsed && Array.isArray(parsed.prompts)) {
+          // Keep only non-BMAD entries (entries whose name does NOT start with bmad-)
+          existingPrompts = parsed.prompts.filter((entry) => !entry.name || !entry.name.startsWith('bmad-'));
+        }
+      } catch {
+        // If parsing fails, start fresh but preserve file safety
+        existingPrompts = [];
+      }
+    }
+
+    // Build new BMAD entries (prefix description with name so /prompts list is scannable)
+    const bmadEntries = writtenFiles.map((file) => ({
+      name: file.name,
+      description: `${file.name} - ${file.description}`,
+      content_file: file.contentFile,
+    }));
+
+    // Merge: user entries first, then BMAD entries
+    const allPrompts = [...existingPrompts, ...bmadEntries];
+
+    const config = { prompts: allPrompts };
+    const yamlContent = yaml.stringify(config, { lineWidth: 0 });
+    await this.writeFile(promptsPath, yamlContent);
+  }
+
+  /**
+   * Cleanup Rovo Dev configuration
+   * Removes bmad-* files from .rovodev/workflows/ and strips BMAD entries from prompts.yml
+   * @param {string} projectDir - Project directory
+   * @param {Object} options - Cleanup options
+   */
+  async cleanup(projectDir, options = {}) {
+    const workflowsPath = path.join(projectDir, this.rovoDir, this.workflowsDir);
+
+    // Remove all bmad-* entries from workflows dir (aligned with detect() predicate)
+    if (await this.pathExists(workflowsPath)) {
+      const entries = await fs.readdir(workflowsPath);
+      for (const entry of entries) {
+        if (entry.startsWith('bmad-')) {
+          await fs.remove(path.join(workflowsPath, entry));
+        }
+      }
+    }
+
+    // Clean BMAD entries from prompts.yml (preserve user entries)
+    const promptsPath = path.join(projectDir, this.rovoDir, this.promptsFile);
+    if (await this.pathExists(promptsPath)) {
+      try {
+        const content = await this.readFile(promptsPath);
+        const parsed = yaml.parse(content) || {};
+
+        if (Array.isArray(parsed.prompts)) {
+          const originalCount = parsed.prompts.length;
+          parsed.prompts = parsed.prompts.filter((entry) => !entry.name || !entry.name.startsWith('bmad-'));
+          const removedCount = originalCount - parsed.prompts.length;
+
+          if (removedCount > 0) {
+            if (parsed.prompts.length === 0) {
+              // If no entries remain, remove the file entirely
+              await fs.remove(promptsPath);
+            } else {
+              await this.writeFile(promptsPath, yaml.stringify(parsed, { lineWidth: 0 }));
+            }
+            if (!options.silent) {
+              await prompts.log.message(`Removed ${removedCount} BMAD entries from ${this.promptsFile}`);
+            }
+          }
+        }
+      } catch {
+        // If parsing fails, leave file as-is
+        if (!options.silent) {
+          await prompts.log.warn(`Warning: Could not parse ${this.promptsFile} for cleanup`);
+        }
+      }
+    }
+
+    // Remove empty .rovodev directories
+    if (await this.pathExists(workflowsPath)) {
+      const remaining = await fs.readdir(workflowsPath);
+      if (remaining.length === 0) {
+        await fs.remove(workflowsPath);
+      }
+    }
+
+    const rovoDirPath = path.join(projectDir, this.rovoDir);
+    if (await this.pathExists(rovoDirPath)) {
+      const remaining = await fs.readdir(rovoDirPath);
+      if (remaining.length === 0) {
+        await fs.remove(rovoDirPath);
+      }
+    }
+  }
+
+  /**
+   * Detect whether Rovo Dev configuration exists in the project
+   * Checks for .rovodev/ dir with bmad files or bmad entries in prompts.yml
+   * @param {string} projectDir - Project directory
+   * @returns {boolean}
+   */
+  async detect(projectDir) {
+    const workflowsPath = path.join(projectDir, this.rovoDir, this.workflowsDir);
+
+    // Check for bmad files in workflows dir
+    if (await fs.pathExists(workflowsPath)) {
+      const entries = await fs.readdir(workflowsPath);
+      if (entries.some((entry) => entry.startsWith('bmad-'))) {
+        return true;
+      }
+    }
+
+    // Check for bmad entries in prompts.yml
+    const promptsPath = path.join(projectDir, this.rovoDir, this.promptsFile);
+    if (await fs.pathExists(promptsPath)) {
+      try {
+        const content = await fs.readFile(promptsPath, 'utf8');
+        const parsed = yaml.parse(content);
+        if (parsed && Array.isArray(parsed.prompts)) {
+          return parsed.prompts.some((entry) => entry.name && entry.name.startsWith('bmad-'));
+        }
+      } catch {
+        // If parsing fails, check raw content
+        return false;
+      }
+    }
+
+    return false;
+  }
+}
+
+module.exports = { RovoDevSetup };

package/tools/cli/installers/lib/ide/shared/task-tool-command-generator.js

@@ -176,7 +176,6 @@ class TaskToolCommandGenerator {
 
     return `---
 description: '${description.replaceAll("'", "''")}'
-disable-model-invocation: true
 ---
 
 # ${item.displayName || item.name}

package/tools/cli/installers/lib/ide/templates/agent-command-template.md

@@ -1,7 +1,6 @@
 ---
 name: '{{name}}'
 description: '{{description}}'
-disable-model-invocation: true
 ---
 
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.

package/tools/cli/installers/lib/ide/templates/combined/default-agent.md

@@ -1,7 +1,6 @@
 ---
 name: '{{name}}'
 description: '{{description}}'
-disable-model-invocation: true
 ---
 
 You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.

package/tools/cli/installers/lib/ide/templates/combined/default-workflow-yaml.md

@@ -1,7 +1,6 @@
 ---
 name: '{{name}}'
 description: '{{description}}'
-disable-model-invocation: true
 ---
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

package/tools/cli/installers/lib/ide/templates/combined/default-workflow.md

@@ -1,7 +1,6 @@
 ---
 name: '{{name}}'
 description: '{{description}}'
-disable-model-invocation: true
 ---
 
 IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{project-root}/{{bmadFolderName}}/{{path}}, READ its entire contents and follow its directions exactly!

package/tools/cli/installers/lib/ide/templates/workflow-command-template.md

@@ -1,6 +1,5 @@
 ---
 description: '{{description}}'
-disable-model-invocation: true
 ---
 
 IT IS CRITICAL THAT YOU FOLLOW THESE STEPS - while staying in character as the current agent persona you may have loaded:

package/tools/cli/installers/lib/ide/templates/workflow-commander.md

@@ -1,6 +1,5 @@
 ---
 description: '{{description}}'
-disable-model-invocation: true
 ---
 
 IT IS CRITICAL THAT YOU FOLLOW THIS COMMAND: LOAD the FULL @{{workflow_path}}, READ its entire contents and follow its directions exactly!

package/tools/cli/lib/ui.js

@@ -582,7 +582,7 @@ class UI {
   /**
    * Prompt for tool/IDE selection (called after module configuration)
    * Uses a split prompt approach:
-   *   1. Recommended tools - standard multiselect for 3 preferred tools
+   *   1. Recommended tools - standard multiselect for preferred tools
    *   2. Additional tools - autocompleteMultiselect with search capability
    * @param {string} projectDir - Project directory to check for existing IDEs
    * @param {Object} options - Command-line options

package/tools/platform-codes.yaml

@@ -18,12 +18,6 @@ platforms:
     category: cli
     description: "Anthropic's official CLI for Claude"
 
-  windsurf:
-    name: "Windsurf"
-    preferred: true
-    category: ide
-    description: "AI-powered IDE with cascade flows"
-
   cursor:
     name: "Cursor"
     preferred: true
@@ -43,6 +37,12 @@ platforms:
     category: ide
     description: "OpenCode terminal coding assistant"
 
+  codebuddy:
+    name: "CodeBuddy"
+    preferred: false
+    category: ide
+    description: "Tencent Cloud Code Assistant - AI-powered coding companion"
+
   auggie:
     name: "Auggie"
     preferred: false
@@ -55,12 +55,6 @@ platforms:
     category: ide
     description: "Enhanced Cline fork"
 
-  rovo:
-    name: "Rovo"
-    preferred: false
-    category: ide
-    description: "Atlassian's AI coding assistant"
-
   rovo-dev:
     name: "Rovo Dev"
     preferred: false
@@ -127,6 +121,12 @@ platforms:
     category: ide
     description: "AI coding tool"
 
+  windsurf:
+    name: "Windsurf"
+    preferred: false
+    category: ide
+    description: "AI-powered IDE with cascade flows"
+
 # Platform categories
 categories:
   ide:

package/tools/validate-doc-links.js

@@ -51,7 +51,7 @@ function getMarkdownFiles(dir) {
 
       if (entry.isDirectory()) {
         walk(fullPath);
-      } else if (entry.isFile() && entry.name.endsWith('.md')) {
+      } else if (entry.isFile() && (entry.name.endsWith('.md') || entry.name.endsWith('.mdx'))) {
         files.push(fullPath);
       }
     }
@@ -120,10 +120,13 @@ function resolveLink(siteRelativePath, sourceFile) {
     if (!resolved.startsWith(DOCS_ROOT + path.sep) && resolved !== DOCS_ROOT) return null;
     if (fs.existsSync(resolved) && fs.statSync(resolved).isFile()) return resolved;
     if (fs.existsSync(resolved + '.md')) return resolved + '.md';
-    // Directory: check for index.md
+    if (fs.existsSync(resolved + '.mdx')) return resolved + '.mdx';
+    // Directory: check for index.md or index.mdx
     if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
       const indexFile = path.join(resolved, 'index.md');
+      const indexMdxFile = path.join(resolved, 'index.mdx');
       if (fs.existsSync(indexFile)) return indexFile;
+      if (fs.existsSync(indexMdxFile)) return indexMdxFile;
     }
     return null;
   }
@@ -134,12 +137,17 @@ function resolveLink(siteRelativePath, sourceFile) {
   }
 
   if (checkPath.endsWith('/')) {
-    // Could be file.md or directory/index.md
-    const asFile = path.join(DOCS_ROOT, checkPath.slice(0, -1) + '.md');
+    // Could be file.md, file.mdx, or directory/index.md/mdx
+    const baseName = checkPath.slice(0, -1);
+    const asMd = path.join(DOCS_ROOT, baseName + '.md');
+    const asMdx = path.join(DOCS_ROOT, baseName + '.mdx');
     const asIndex = path.join(DOCS_ROOT, checkPath, 'index.md');
+    const asIndexMdx = path.join(DOCS_ROOT, checkPath, 'index.mdx');
 
-    if (fs.existsSync(asFile)) return asFile;
+    if (fs.existsSync(asMd)) return asMd;
+    if (fs.existsSync(asMdx)) return asMdx;
     if (fs.existsSync(asIndex)) return asIndex;
+    if (fs.existsSync(asIndexMdx)) return asIndexMdx;
     return null;
   }
 
@@ -151,10 +159,16 @@ function resolveLink(siteRelativePath, sourceFile) {
   const withMd = direct + '.md';
   if (fs.existsSync(withMd)) return withMd;
 
-  // Directory without trailing slash: check for index.md
+  // Try with .mdx extension
+  const withMdx = direct + '.mdx';
+  if (fs.existsSync(withMdx)) return withMdx;
+
+  // Directory without trailing slash: check for index.md or index.mdx
   if (fs.existsSync(direct) && fs.statSync(direct).isDirectory()) {
     const indexFile = path.join(direct, 'index.md');
+    const indexMdxFile = path.join(direct, 'index.mdx');
     if (fs.existsSync(indexFile)) return indexFile;
+    if (fs.existsSync(indexMdxFile)) return indexMdxFile;
   }
 
   return null;

package/website/astro.config.mjs

@@ -90,6 +90,7 @@ export default defineConfig({
       // Sidebar configuration (Diataxis structure)
       sidebar: [
         { label: 'Welcome', slug: 'index' },
+        { label: 'Roadmap', slug: 'roadmap' },
         {
           label: 'Tutorials',
           collapsed: false,

package/website/src/rehype-markdown-links.js

@@ -101,11 +101,19 @@ export function findFirstDelimiter(str) {
 /** Walk up from a file path to find the content docs directory. */
 export function detectContentDir(filePath) {
   const segments = filePath.split(path.sep);
-  // Look for src/content/docs in the path
+  // Look for src/content/docs in the path (standard Astro)
   for (let i = segments.length - 1; i >= 2; i--) {
     if (segments[i - 2] === 'src' && segments[i - 1] === 'content' && segments[i] === 'docs') {
       return segments.slice(0, i + 1).join(path.sep);
     }
   }
+  // Also check for a standalone 'docs' directory (BMAD project structure)
+  // Path format: .../bmm/docs/file.mdx or .../bmm/website/...
+  for (let i = segments.length - 1; i >= 0; i--) {
+    if (segments[i] === 'docs') {
+      // Found docs directory - use its parent as the content root
+      return segments.slice(0, i + 1).join(path.sep);
+    }
+  }
   return null;
 }