BMAD-METHOD/tools/cli/installers/lib/ide/crush.js

const path = require('node:path');
const fs = require('fs-extra');
const { BaseIdeSetup } = require('./_base-ide');
const chalk = require('chalk');
const { AgentCommandGenerator } = require('./shared/agent-command-generator');
const { WorkflowCommandGenerator } = require('./shared/workflow-command-generator');

/**
 * Crush IDE setup handler
 * Creates commands in .crush/commands/ directory structure
 */
class CrushSetup extends BaseIdeSetup {
  constructor() {
    super('crush', 'Crush');
    this.configDir = '.crush';
    this.commandsDir = 'commands';
  }

  /**
   * Setup Crush IDE configuration
   * @param {string} projectDir - Project directory
   * @param {string} bmadDir - BMAD installation directory
   * @param {Object} options - Setup options
   */
  async setup(projectDir, bmadDir, options = {}) {
    console.log(chalk.cyan(`Setting up ${this.name}...`));

    // Create .crush/commands/bmad directory structure
    const crushDir = path.join(projectDir, this.configDir);
    const commandsDir = path.join(crushDir, this.commandsDir, 'bmad');

    await this.ensureDir(commandsDir);

    // Generate agent launchers
    const agentGen = new AgentCommandGenerator(this.bmadFolderName);
    const { artifacts: agentArtifacts } = await agentGen.collectAgentArtifacts(bmadDir, options.selectedModules || []);

    // Get tasks, tools, and workflows (ALL workflows now generate commands)
    const tasks = await this.getTasks(bmadDir, true);
    const tools = await this.getTools(bmadDir, true);

    // Get ALL workflows using the new workflow command generator
    const workflowGenerator = new WorkflowCommandGenerator(this.bmadFolderName);
    const { artifacts: workflowArtifacts, counts: workflowCounts } = await workflowGenerator.collectWorkflowArtifacts(bmadDir);

    // Convert workflow artifacts to expected format for organizeByModule
    const workflows = workflowArtifacts
      .filter((artifact) => artifact.type === 'workflow-command')
      .map((artifact) => ({
        module: artifact.module,
        name: path.basename(artifact.relativePath, '.md'),
        path: artifact.sourcePath,
        content: artifact.content,
      }));

    // Organize by module
    const agentCount = await this.organizeByModule(commandsDir, agentArtifacts, tasks, tools, workflows, projectDir);

    console.log(chalk.green(`✓ ${this.name} configured:`));
    console.log(chalk.dim(`  - ${agentCount.agents} agent commands created`));
    console.log(chalk.dim(`  - ${agentCount.tasks} task commands created`));
    console.log(chalk.dim(`  - ${agentCount.tools} tool commands created`));
    console.log(chalk.dim(`  - ${agentCount.workflows} workflow commands created`));
    console.log(chalk.dim(`  - Commands directory: ${path.relative(projectDir, commandsDir)}`));
    console.log(chalk.dim('\n  Commands can be accessed via Crush command palette'));

    return {
      success: true,
      ...agentCount,
    };
  }

  /**
   * Organize commands by module
   */
  async organizeByModule(commandsDir, agentArtifacts, tasks, tools, workflows, projectDir) {
    // Get unique modules
    const modules = new Set();
    for (const artifact of agentArtifacts) modules.add(artifact.module);
    for (const task of tasks) modules.add(task.module);
    for (const tool of tools) modules.add(tool.module);
    for (const workflow of workflows) modules.add(workflow.module);

    let agentCount = 0;
    let taskCount = 0;
    let toolCount = 0;
    let workflowCount = 0;

    // Create module directories
    for (const module of modules) {
      const moduleDir = path.join(commandsDir, module);
      const moduleAgentsDir = path.join(moduleDir, 'agents');
      const moduleTasksDir = path.join(moduleDir, 'tasks');
      const moduleToolsDir = path.join(moduleDir, 'tools');
      const moduleWorkflowsDir = path.join(moduleDir, 'workflows');

      await this.ensureDir(moduleAgentsDir);
      await this.ensureDir(moduleTasksDir);
      await this.ensureDir(moduleToolsDir);
      await this.ensureDir(moduleWorkflowsDir);

      // Write module-specific agent launchers
      const moduleAgents = agentArtifacts.filter((a) => a.module === module);
      for (const artifact of moduleAgents) {
        const targetPath = path.join(moduleAgentsDir, `${artifact.name}.md`);
        await this.writeFile(targetPath, artifact.content);
        agentCount++;
      }

      // Copy module-specific tasks
      const moduleTasks = tasks.filter((t) => t.module === module);
      for (const task of moduleTasks) {
        const content = await this.readFile(task.path);
        const commandContent = this.createTaskCommand(task, content);
        const targetPath = path.join(moduleTasksDir, `${task.name}.md`);
        await this.writeFile(targetPath, commandContent);
        taskCount++;
      }

      // Copy module-specific tools
      const moduleTools = tools.filter((t) => t.module === module);
      for (const tool of moduleTools) {
        const content = await this.readFile(tool.path);
        const commandContent = this.createToolCommand(tool, content);
        const targetPath = path.join(moduleToolsDir, `${tool.name}.md`);
        await this.writeFile(targetPath, commandContent);
        toolCount++;
      }

      // Copy module-specific workflow commands (already generated)
      const moduleWorkflows = workflows.filter((w) => w.module === module);
      for (const workflow of moduleWorkflows) {
        // Use the pre-generated workflow command content
        const targetPath = path.join(moduleWorkflowsDir, `${workflow.name}.md`);
        await this.writeFile(targetPath, workflow.content);
        workflowCount++;
      }
    }

    return {
      agents: agentCount,
      tasks: taskCount,
      tools: toolCount,
      workflows: workflowCount,
    };
  }

  /**
   * Create task command content
   */
  createTaskCommand(task, content) {
    // Extract task name
    const nameMatch = content.match(/name="([^"]+)"/);
    const taskName = nameMatch ? nameMatch[1] : this.formatTitle(task.name);

    let commandContent = `# /task-${task.name} Command

When this command is used, execute the following task:

## ${taskName} Task

${content}

## Command Usage

This command executes the ${taskName} task from the BMAD ${task.module.toUpperCase()} module.

## Module

Part of the BMAD ${task.module.toUpperCase()} module.
`;

    return commandContent;
  }

  /**
   * Create tool command content
   */
  createToolCommand(tool, content) {
    // Extract tool name
    const nameMatch = content.match(/name="([^"]+)"/);
    const toolName = nameMatch ? nameMatch[1] : this.formatTitle(tool.name);

    let commandContent = `# /tool-${tool.name} Command

When this command is used, execute the following tool:

## ${toolName} Tool

${content}

## Command Usage

This command executes the ${toolName} tool from the BMAD ${tool.module.toUpperCase()} module.

## Module

Part of the BMAD ${tool.module.toUpperCase()} module.
`;

    return commandContent;
  }

  /**
   * Create workflow command content
   */
  createWorkflowCommand(workflow, content) {
    const workflowName = workflow.name ? this.formatTitle(workflow.name) : 'Workflow';

    let commandContent = `# /${workflow.name} Command

When this command is used, execute the following workflow:

## ${workflowName} Workflow

${content}

## Command Usage

This command executes the ${workflowName} workflow from the BMAD ${workflow.module.toUpperCase()} module.

## Module

Part of the BMAD ${workflow.module.toUpperCase()} module.
`;

    return commandContent;
  }

  /**
   * Format name as title
   */
  formatTitle(name) {
    return name
      .split('-')
      .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
      .join(' ');
  }

  /**
   * Cleanup Crush configuration
   */
  async cleanup(projectDir) {
    const fs = require('fs-extra');
    const bmadCommandsDir = path.join(projectDir, this.configDir, this.commandsDir, 'bmad');

    if (await fs.pathExists(bmadCommandsDir)) {
      await fs.remove(bmadCommandsDir);
      console.log(chalk.dim(`Removed BMAD commands from Crush`));
    }
  }

  /**
   * Install a custom agent launcher for Crush
   * @param {string} projectDir - Project directory
   * @param {string} agentName - Agent name (e.g., "fred-commit-poet")
   * @param {string} agentPath - Path to compiled agent (relative to project root)
   * @param {Object} metadata - Agent metadata
   * @returns {Object} Installation result
   */
  async installCustomAgentLauncher(projectDir, agentName, agentPath, metadata) {
    const crushDir = path.join(projectDir, this.configDir);
    const bmadCommandsDir = path.join(crushDir, this.commandsDir, 'bmad');

    // Create .crush/commands/bmad directory if it doesn't exist
    await fs.ensureDir(bmadCommandsDir);

    // Create custom agent launcher
    const launcherContent = `# ${agentName} Custom Agent

**⚠️ IMPORTANT**: Run @${agentPath} first to load the complete agent!

This is a launcher for the custom BMAD agent "${agentName}".

## Usage
1. First run: \`${agentPath}\` to load the complete agent
2. Then use this command to activate ${agentName}

The agent will follow the persona and instructions from the main agent file.

---

*Generated by BMAD Method*`;

    const fileName = `custom-${agentName.toLowerCase()}.md`;
    const launcherPath = path.join(bmadCommandsDir, fileName);

    // Write the launcher file
    await fs.writeFile(launcherPath, launcherContent, 'utf8');

    return {
      ide: 'crush',
      path: path.relative(projectDir, launcherPath),
      command: agentName,
      type: 'custom-agent-launcher',
    };
  }
}

module.exports = { CrushSetup };