bmad-method 6.0.0-alpha.0 → 6.0.0-alpha.10

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

@@ -1,16 +1,19 @@
 const path = require('node:path');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
+const { getAgentsFromBmad, getTasksFromBmad } = require('./shared/bmad-artifacts');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Qwen Code setup handler
- * Creates concatenated QWEN.md file in .qwen/bmad-method/ (similar to Gemini)
+ * Creates TOML command files in .qwen/commands/BMad/
  */
 class QwenSetup extends BaseIdeSetup {
   constructor() {
     super('qwen', 'Qwen Code');
     this.configDir = '.qwen';
-    this.bmadDir = 'bmad-method';
+    this.commandsDir = 'commands';
+    this.bmadDir = 'bmad';
   }
 
   /**
@@ -22,54 +25,118 @@ class QwenSetup extends BaseIdeSetup {
   async setup(projectDir, bmadDir, options = {}) {
     console.log(chalk.cyan(`Setting up ${this.name}...`));
 
-    // Create .qwen/bmad-method directory
+    // Create .qwen/commands/BMad directory structure
     const qwenDir = path.join(projectDir, this.configDir);
-    const bmadMethodDir = path.join(qwenDir, this.bmadDir);
-    await this.ensureDir(bmadMethodDir);
+    const commandsDir = path.join(qwenDir, this.commandsDir);
+    const bmadCommandsDir = path.join(commandsDir, this.bmadDir);
+
+    await this.ensureDir(bmadCommandsDir);
 
     // Update existing settings.json if present
     await this.updateSettings(qwenDir);
 
-    // Clean up old agents directory if exists
-    await this.cleanupOldAgents(qwenDir);
-
-    // Get agents
-    const agents = await this.getAgents(bmadDir);
+    // Clean up old configuration if exists
+    await this.cleanupOldConfig(qwenDir);
 
-    // Create concatenated content for all agents
-    let concatenatedContent = `# BMAD Method - Qwen Code Configuration
+    // Generate agent launchers
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-This file contains all BMAD agents configured for use with Qwen Code.
-Agents can be activated by typing \`*{agent-name}\` in your prompts.
+    // Get tasks, tools, and workflows (standalone only for tools/workflows)
+    const tasks = await getTasksFromBmad(bmadDir, options.selectedModules || []);
+    const tools = await this.getTools(bmadDir, true);
+    const workflows = await this.getWorkflows(bmadDir, true);
 
----
+    // Create directories for each module (including standalone)
+    const modules = new Set();
+    for (const item of [...agentArtifacts, ...tasks, ...tools, ...workflows]) modules.add(item.module);
 
-`;
+    for (const module of modules) {
+      await this.ensureDir(path.join(bmadCommandsDir, module));
+      await this.ensureDir(path.join(bmadCommandsDir, module, 'agents'));
+      await this.ensureDir(path.join(bmadCommandsDir, module, 'tasks'));
+      await this.ensureDir(path.join(bmadCommandsDir, module, 'tools'));
+      await this.ensureDir(path.join(bmadCommandsDir, module, 'workflows'));
+    }
 
+    // Create TOML files for each agent launcher
     let agentCount = 0;
-    for (const agent of agents) {
-      const content = await this.readFile(agent.path);
-      const agentSection = this.createAgentSection(agent, content, projectDir);
+    for (const artifact of agentArtifacts) {
+      // Convert markdown launcher content to TOML format
+      const tomlContent = this.processAgentLauncherContent(artifact.content, {
+        module: artifact.module,
+        name: artifact.name,
+      });
+
+      const targetPath = path.join(bmadCommandsDir, artifact.module, 'agents', `${artifact.name}.toml`);
+
+      await this.writeFile(targetPath, tomlContent);
 
-      concatenatedContent += agentSection;
-      concatenatedContent += '\n\n---\n\n';
       agentCount++;
+      console.log(chalk.green(`  ✓ Added agent: /bmad:${artifact.module}:agents:${artifact.name}`));
+    }
+
+    // Create TOML files for each task
+    let taskCount = 0;
+    for (const task of tasks) {
+      const content = await this.readAndProcess(task.path, {
+        module: task.module,
+        name: task.name,
+      });
+
+      const targetPath = path.join(bmadCommandsDir, task.module, 'tasks', `${task.name}.toml`);
+
+      await this.writeFile(targetPath, content);
+
+      taskCount++;
+      console.log(chalk.green(`  ✓ Added task: /bmad:${task.module}:tasks:${task.name}`));
+    }
+
+    // Create TOML files for each tool
+    let toolCount = 0;
+    for (const tool of tools) {
+      const content = await this.readAndProcess(tool.path, {
+        module: tool.module,
+        name: tool.name,
+      });
 
-      console.log(chalk.green(`  ✓ Added agent: *${agent.name}`));
+      const targetPath = path.join(bmadCommandsDir, tool.module, 'tools', `${tool.name}.toml`);
+
+      await this.writeFile(targetPath, content);
+
+      toolCount++;
+      console.log(chalk.green(`  ✓ Added tool: /bmad:${tool.module}:tools:${tool.name}`));
     }
 
-    // Write QWEN.md
-    const qwenMdPath = path.join(bmadMethodDir, 'QWEN.md');
-    await this.writeFile(qwenMdPath, concatenatedContent);
+    // Create TOML files for each workflow
+    let workflowCount = 0;
+    for (const workflow of workflows) {
+      const content = await this.readAndProcess(workflow.path, {
+        module: workflow.module,
+        name: workflow.name,
+      });
+
+      const targetPath = path.join(bmadCommandsDir, workflow.module, 'workflows', `${workflow.name}.toml`);
+
+      await this.writeFile(targetPath, content);
+
+      workflowCount++;
+      console.log(chalk.green(`  ✓ Added workflow: /bmad:${workflow.module}:workflows:${workflow.name}`));
+    }
 
     console.log(chalk.green(`✓ ${this.name} configured:`));
     console.log(chalk.dim(`  - ${agentCount} agents configured`));
-    console.log(chalk.dim(`  - Configuration file: ${path.relative(projectDir, qwenMdPath)}`));
-    console.log(chalk.dim(`  - Agents activated with: *{agent-name}`));
+    console.log(chalk.dim(`  - ${taskCount} tasks configured`));
+    console.log(chalk.dim(`  - ${toolCount} tools configured`));
+    console.log(chalk.dim(`  - ${workflowCount} workflows configured`));
+    console.log(chalk.dim(`  - Commands directory: ${path.relative(projectDir, bmadCommandsDir)}`));
 
     return {
       success: true,
       agents: agentCount,
+      tasks: taskCount,
+      tools: toolCount,
+      workflows: workflowCount,
     };
   }
 
@@ -89,7 +156,9 @@ Agents can be activated by typing \`*{agent-name}\` in your prompts.
         // Remove agent file references from contextFileName
         if (settings.contextFileName && Array.isArray(settings.contextFileName)) {
           const originalLength = settings.contextFileName.length;
-          settings.contextFileName = settings.contextFileName.filter((fileName) => !fileName.startsWith('agents/'));
+          settings.contextFileName = settings.contextFileName.filter(
+            (fileName) => !fileName.startsWith('agents/') && !fileName.startsWith('bmad-method/'),
+          );
 
           if (settings.contextFileName.length !== originalLength) {
             updated = true;
@@ -107,58 +176,107 @@ Agents can be activated by typing \`*{agent-name}\` in your prompts.
   }
 
   /**
-   * Clean up old agents directory
+   * Clean up old configuration directories
    */
-  async cleanupOldAgents(qwenDir) {
+  async cleanupOldConfig(qwenDir) {
     const fs = require('fs-extra');
     const agentsDir = path.join(qwenDir, 'agents');
+    const bmadMethodDir = path.join(qwenDir, 'bmad-method');
+    const bmadDir = path.join(qwenDir, 'bmadDir');
 
     if (await fs.pathExists(agentsDir)) {
       await fs.remove(agentsDir);
       console.log(chalk.green('  ✓ Removed old agents directory'));
     }
+
+    if (await fs.pathExists(bmadMethodDir)) {
+      await fs.remove(bmadMethodDir);
+      console.log(chalk.green('  ✓ Removed old bmad-method directory'));
+    }
+
+    if (await fs.pathExists(bmadDir)) {
+      await fs.remove(bmadDir);
+      console.log(chalk.green('  ✓ Removed old BMad directory'));
+    }
   }
 
   /**
-   * Create agent section for concatenated file
+   * Read and process file content
    */
-  createAgentSection(agent, content, projectDir) {
-    // Extract metadata
-    const titleMatch = content.match(/title="([^"]+)"/);
-    const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
-
-    // Extract YAML content
-    const yamlMatch = content.match(/```ya?ml\r?\n([\s\S]*?)```/);
-    const yamlContent = yamlMatch ? yamlMatch[1] : content;
-
-    // Get relative path
-    const relativePath = path.relative(projectDir, agent.path).replaceAll('\\', '/');
-
-    let section = `# ${agent.name.toUpperCase()} Agent Rule
-
-This rule is triggered when the user types \`*${agent.name}\` and activates the ${title} agent persona.
-
-## Agent Activation
-
-CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
-
-\`\`\`yaml
-${yamlContent}
-\`\`\`
-
-## File Reference
-
-The complete agent definition is available in [${relativePath}](${relativePath}).
-
-## Usage
-
-When the user types \`*${agent.name}\`, activate this ${title} persona and follow all instructions defined in the YAML configuration above.
+  async readAndProcess(filePath, metadata) {
+    const fs = require('fs-extra');
+    const content = await fs.readFile(filePath, 'utf8');
+    return this.processContent(content, metadata);
+  }
 
-## Module
+  /**
+   * Process agent launcher content and convert to TOML format
+   * @param {string} launcherContent - Launcher markdown content
+   * @param {Object} metadata - File metadata
+   * @returns {string} TOML formatted content
+   */
+  processAgentLauncherContent(launcherContent, metadata = {}) {
+    // Strip frontmatter from launcher content
+    const frontmatterRegex = /^---\s*\n[\s\S]*?\n---\s*\n/;
+    const contentWithoutFrontmatter = launcherContent.replace(frontmatterRegex, '');
+
+    // Extract title for TOML description
+    const titleMatch = launcherContent.match(/description:\s*"([^"]+)"/);
+    const title = titleMatch ? titleMatch[1] : metadata.name;
+
+    // Create TOML with launcher content (without frontmatter)
+    return `description = "BMAD ${metadata.module.toUpperCase()} Agent: ${title}"
+prompt = """
+${contentWithoutFrontmatter.trim()}
+"""
+`;
+  }
 
-Part of the BMAD ${agent.module.toUpperCase()} module.`;
+  /**
+   * Override processContent to add TOML metadata header for Qwen
+   * @param {string} content - File content
+   * @param {Object} metadata - File metadata
+   * @returns {string} Processed content with Qwen template
+   */
+  processContent(content, metadata = {}) {
+    // First apply base processing (includes activation injection for agents)
+    let prompt = super.processContent(content, metadata);
+
+    // Determine the type and description based on content
+    const isAgent = content.includes('<agent');
+    const isTask = content.includes('<task');
+    const isTool = content.includes('<tool');
+    const isWorkflow = content.includes('workflow:') || content.includes('name:');
+
+    let description = '';
+
+    if (isAgent) {
+      // Extract agent title if available
+      const titleMatch = content.match(/title="([^"]+)"/);
+      const title = titleMatch ? titleMatch[1] : metadata.name;
+      description = `BMAD ${metadata.module.toUpperCase()} Agent: ${title}`;
+    } else if (isTask) {
+      // Extract task name if available
+      const nameMatch = content.match(/name="([^"]+)"/);
+      const taskName = nameMatch ? nameMatch[1] : metadata.name;
+      description = `BMAD ${metadata.module.toUpperCase()} Task: ${taskName}`;
+    } else if (isTool) {
+      // Extract tool name if available
+      const nameMatch = content.match(/name="([^"]+)"/);
+      const toolName = nameMatch ? nameMatch[1] : metadata.name;
+      description = `BMAD ${metadata.module.toUpperCase()} Tool: ${toolName}`;
+    } else if (isWorkflow) {
+      // Workflow
+      description = `BMAD ${metadata.module.toUpperCase()} Workflow: ${metadata.name}`;
+    } else {
+      description = `BMAD ${metadata.module.toUpperCase()}: ${metadata.name}`;
+    }
 
-    return section;
+    return `description = "${description}"
+prompt = """
+${prompt}
+"""
+`;
   }
 
   /**
@@ -176,12 +294,24 @@ Part of the BMAD ${agent.module.toUpperCase()} module.`;
    */
   async cleanup(projectDir) {
     const fs = require('fs-extra');
-    const bmadMethodDir = path.join(projectDir, this.configDir, this.bmadDir);
+    const bmadCommandsDir = path.join(projectDir, this.configDir, this.commandsDir, this.bmadDir);
+    const oldBmadMethodDir = path.join(projectDir, this.configDir, 'bmad-method');
+    const oldBMadDir = path.join(projectDir, this.configDir, 'BMad');
 
-    if (await fs.pathExists(bmadMethodDir)) {
-      await fs.remove(bmadMethodDir);
+    if (await fs.pathExists(bmadCommandsDir)) {
+      await fs.remove(bmadCommandsDir);
       console.log(chalk.dim(`Removed BMAD configuration from Qwen Code`));
     }
+
+    if (await fs.pathExists(oldBmadMethodDir)) {
+      await fs.remove(oldBmadMethodDir);
+      console.log(chalk.dim(`Removed old BMAD configuration from Qwen Code`));
+    }
+
+    if (await fs.pathExists(oldBMadDir)) {
+      await fs.remove(oldBMadDir);
+      console.log(chalk.dim(`Removed old BMAD configuration from Qwen Code`));
+    }
   }
 }
 

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

@@ -1,7 +1,7 @@
 const path = require('node:path');
 const { BaseIdeSetup } = require('./_base-ide');
 const chalk = require('chalk');
-const inquirer = require('inquirer');
+const { AgentCommandGenerator } = require('./shared/agent-command-generator');
 
 /**
  * Roo IDE setup handler
@@ -35,31 +35,6 @@ class RooSetup extends BaseIdeSetup {
     };
   }
 
-  /**
-   * Collect configuration choices before installation
-   * @param {Object} options - Configuration options
-   * @returns {Object} Collected configuration
-   */
-  async collectConfiguration(options = {}) {
-    const response = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'permissions',
-        message: 'Select default file edit permissions for BMAD agents:',
-        choices: [
-          { name: 'Development files only (js, ts, py, etc.)', value: 'dev' },
-          { name: 'Configuration files only (json, yaml, xml, etc.)', value: 'config' },
-          { name: 'Documentation files only (md, txt, doc, etc.)', value: 'docs' },
-          { name: 'All files (unrestricted access)', value: 'all' },
-          { name: 'Custom per agent (will be configured individually)', value: 'custom' },
-        ],
-        default: 'dev',
-      },
-    ]);
-
-    return { permissions: response.permissions };
-  }
-
   /**
    * Setup Roo IDE configuration
    * @param {string} projectDir - Project directory
@@ -84,20 +59,20 @@ class RooSetup extends BaseIdeSetup {
       console.log(chalk.yellow(`Found existing .roomodes file with ${existingModes.length} modes`));
     }
 
-    // Get agents
-    const agents = await this.getAgents(bmadDir);
+    // Generate agent launchers (though Roo will reference the actual .bmad agents)
+    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
+    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);
 
-    // Use pre-collected configuration if available
-    const config = options.preCollectedConfig || {};
-    let permissionChoice = config.permissions || options.permissions || 'dev';
+    // Always use 'all' permissions - users can customize in .roomodes file
+    const permissionChoice = 'all';
 
     // Create modes content
     let newModesContent = '';
     let addedCount = 0;
     let skippedCount = 0;
 
-    for (const agent of agents) {
-      const slug = `bmad-${agent.module}-${agent.name}`;
+    for (const artifact of agentArtifacts) {
+      const slug = `bmad-${artifact.module}-${artifact.name}`;
 
       // Skip if already exists
       if (existingModes.includes(slug)) {
@@ -106,8 +81,17 @@ class RooSetup extends BaseIdeSetup {
         continue;
       }
 
-      const content = await this.readFile(agent.path);
-      const modeEntry = this.createModeEntry(agent, content, permissionChoice, projectDir);
+      // Read the actual agent file from .bmad for metadata extraction
+      const agentPath = path.join(bmadDir, artifact.module, 'agents', `${artifact.name}.md`);
+      const content = await this.readFile(agentPath);
+
+      // Create mode entry that references the actual .bmad agent
+      const modeEntry = await this.createModeEntry(
+        { module: artifact.module, name: artifact.name, path: agentPath },
+        content,
+        permissionChoice,
+        projectDir,
+      );
 
       newModesContent += modeEntry;
       addedCount++;
@@ -133,8 +117,9 @@ class RooSetup extends BaseIdeSetup {
       console.log(chalk.dim(`  - ${skippedCount} modes skipped (already exist)`));
     }
     console.log(chalk.dim(`  - Configuration file: ${this.configFile}`));
-    console.log(chalk.dim(`  - Permission level: ${permissionChoice}`));
-    console.log(chalk.dim('\n  Modes will be available when you open this project in Roo Code'));
+    console.log(chalk.dim(`  - Permission level: all (unrestricted)`));
+    console.log(chalk.yellow(`\n  💡 Tip: Edit ${this.configFile} to customize file permissions per agent`));
+    console.log(chalk.dim(`  Modes will be available when you open this project in Roo Code`));
 
     return {
       success: true,
@@ -143,33 +128,10 @@ class RooSetup extends BaseIdeSetup {
     };
   }
 
-  /**
-   * Ask user about permission configuration
-   */
-  async askPermissions() {
-    const response = await inquirer.prompt([
-      {
-        type: 'list',
-        name: 'permissions',
-        message: 'Select default file edit permissions for BMAD agents:',
-        choices: [
-          { name: 'Development files only (js, ts, py, etc.)', value: 'dev' },
-          { name: 'Configuration files only (json, yaml, xml, etc.)', value: 'config' },
-          { name: 'Documentation files only (md, txt, doc, etc.)', value: 'docs' },
-          { name: 'All files (unrestricted access)', value: 'all' },
-          { name: 'Custom per agent (will be configured individually)', value: 'custom' },
-        ],
-        default: 'dev',
-      },
-    ]);
-
-    return response.permissions;
-  }
-
   /**
    * Create a mode entry for an agent
    */
-  createModeEntry(agent, content, permissionChoice, projectDir) {
+  async createModeEntry(agent, content, permissionChoice, projectDir) {
     // Extract metadata from agent content
     const titleMatch = content.match(/title="([^"]+)"/);
     const title = titleMatch ? titleMatch[1] : this.formatTitle(agent.name);
@@ -180,6 +142,9 @@ class RooSetup extends BaseIdeSetup {
     const whenToUseMatch = content.match(/whenToUse="([^"]+)"/);
     const whenToUse = whenToUseMatch ? whenToUseMatch[1] : `Use for ${title} tasks`;
 
+    // Get the activation header from central template
+    const activationHeader = await this.getAgentCommandHeader();
+
     const roleDefinitionMatch = content.match(/roleDefinition="([^"]+)"/);
     const roleDefinition = roleDefinitionMatch
       ? roleDefinitionMatch[1]
@@ -202,7 +167,7 @@ class RooSetup extends BaseIdeSetup {
 
     modeEntry += `   roleDefinition: ${roleDefinition}\n`;
     modeEntry += `   whenToUse: ${whenToUse}\n`;
-    modeEntry += `   customInstructions: CRITICAL Read the full YAML from ${relativePath} start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode\n`;
+    modeEntry += `   customInstructions: ${activationHeader} Read the full YAML from ${relativePath} start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode\n`;
     modeEntry += `   groups:\n`;
     modeEntry += `    - read\n`;
 

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

@@ -0,0 +1,90 @@
+const path = require('node:path');
+const fs = require('fs-extra');
+const chalk = require('chalk');
+
+/**
+ * Generates launcher command files for each agent
+ * Similar to WorkflowCommandGenerator but for agents
+ */
+class AgentCommandGenerator {
+  constructor(bmadFolderName = 'bmad') {
+    this.templatePath = path.join(__dirname, '../templates/agent-command-template.md');
+    this.bmadFolderName = bmadFolderName;
+  }
+
+  /**
+   * Collect agent artifacts for IDE installation
+   * @param {string} bmadDir - BMAD installation directory
+   * @param {Array} selectedModules - Modules to include
+   * @returns {Object} Artifacts array with metadata
+   */
+  async collectAgentArtifacts(bmadDir, selectedModules = []) {
+    const { getAgentsFromBmad } = require('./bmad-artifacts');
+
+    // Get agents from INSTALLED bmad/ directory
+    const agents = await getAgentsFromBmad(bmadDir, selectedModules);
+
+    const artifacts = [];
+
+    for (const agent of agents) {
+      const launcherContent = await this.generateLauncherContent(agent);
+      artifacts.push({
+        type: 'agent-launcher',
+        module: agent.module,
+        name: agent.name,
+        relativePath: path.join(agent.module, 'agents', `${agent.name}.md`),
+        content: launcherContent,
+        sourcePath: agent.path,
+      });
+    }
+
+    return {
+      artifacts,
+      counts: {
+        agents: agents.length,
+      },
+    };
+  }
+
+  /**
+   * Generate launcher content for an agent
+   * @param {Object} agent - Agent metadata
+   * @returns {string} Launcher file content
+   */
+  async generateLauncherContent(agent) {
+    // Load the template
+    const template = await fs.readFile(this.templatePath, 'utf8');
+
+    // Replace template variables
+    return template
+      .replaceAll('{{name}}', agent.name)
+      .replaceAll('{{module}}', agent.module)
+      .replaceAll('{{description}}', agent.description || `${agent.name} agent`)
+      .replaceAll('{bmad_folder}', this.bmadFolderName);
+  }
+
+  /**
+   * Write agent launcher artifacts to IDE commands directory
+   * @param {string} baseCommandsDir - Base commands directory for the IDE
+   * @param {Array} artifacts - Agent launcher artifacts
+   * @returns {number} Count of launchers written
+   */
+  async writeAgentLaunchers(baseCommandsDir, artifacts) {
+    let writtenCount = 0;
+
+    for (const artifact of artifacts) {
+      if (artifact.type === 'agent-launcher') {
+        const moduleAgentsDir = path.join(baseCommandsDir, artifact.module, 'agents');
+        await fs.ensureDir(moduleAgentsDir);
+
+        const launcherPath = path.join(moduleAgentsDir, `${artifact.name}.md`);
+        await fs.writeFile(launcherPath, artifact.content);
+        writtenCount++;
+      }
+    }
+
+    return writtenCount;
+  }
+}
+
+module.exports = { AgentCommandGenerator };