bmad-method 4.37.0 → 5.0.0-beta.2

package/tools/flattener/test-matrix.js

@@ -0,0 +1,405 @@
+#!/usr/bin/env node
+/* deno-lint-ignore-file */
+/*
+ Automatic test matrix for project root detection.
+ Creates temporary fixtures for various ecosystems and validates findProjectRoot().
+ No external options or flags required. Safe to run multiple times.
+*/
+
+const os = require("node:os");
+const path = require("node:path");
+const fs = require("fs-extra");
+const { promisify } = require("node:util");
+const { execFile } = require("node:child_process");
+const process = require("node:process");
+const execFileAsync = promisify(execFile);
+
+const { findProjectRoot } = require("./projectRoot.js");
+
+async function cmdAvailable(cmd) {
+  try {
+    await execFileAsync(cmd, ["--version"], { timeout: 500, windowsHide: true });
+    return true;
+  } catch {
+    return false;
+  }
+
+async function testSvnMarker() {
+  const root = await mkTmpDir("svn");
+  const nested = path.join(root, "proj", "code");
+  await fs.ensureDir(nested);
+  await fs.ensureDir(path.join(root, ".svn"));
+  const found = await findProjectRoot(nested);
+  assertEqual(found, root, ".svn marker should be detected");
+  return { name: "svn-marker", ok: true };
+}
+
+async function testSymlinkStart() {
+  const root = await mkTmpDir("symlink-start");
+  const nested = path.join(root, "a", "b");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, ".project-root"), "\n");
+  const tmp = await mkTmpDir("symlink-tmp");
+  const link = path.join(tmp, "link-to-b");
+  try {
+    await fs.symlink(nested, link);
+  } catch {
+    // symlink may not be permitted on some systems; skip
+    return { name: "symlink-start", ok: true, skipped: true };
+  }
+  const found = await findProjectRoot(link);
+  assertEqual(found, root, "should resolve symlinked start to real root");
+  return { name: "symlink-start", ok: true };
+}
+
+async function testSubmoduleLikeInnerGitFile() {
+  const root = await mkTmpDir("submodule-like");
+  const mid = path.join(root, "mid");
+  const leaf = path.join(mid, "leaf");
+  await fs.ensureDir(leaf);
+  // outer repo
+  await fs.ensureDir(path.join(root, ".git"));
+  // inner submodule-like .git file
+  await fs.writeFile(path.join(mid, ".git"), "gitdir: ../.git/modules/mid\n");
+  const found = await findProjectRoot(leaf);
+  assertEqual(found, root, "outermost .git should win on tie weight");
+  return { name: "submodule-like-gitfile", ok: true };
+}
+}
+
+async function mkTmpDir(name) {
+  const base = await fs.realpath(os.tmpdir());
+  const dir = await fs.mkdtemp(path.join(base, `flattener-${name}-`));
+  return dir;
+}
+
+function assertEqual(actual, expected, msg) {
+  if (actual !== expected) {
+    throw new Error(`${msg}: expected=\"${expected}\" actual=\"${actual}\"`);
+  }
+}
+
+async function testSentinel() {
+  const root = await mkTmpDir("sentinel");
+  const nested = path.join(root, "a", "b", "c");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, ".project-root"), "\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "sentinel .project-root should win");
+  return { name: "sentinel", ok: true };
+}
+
+async function testOtherSentinels() {
+  const root = await mkTmpDir("other-sentinels");
+  const nested = path.join(root, "x", "y");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, ".workspace-root"), "\n");
+  const found1 = await findProjectRoot(nested);
+  assertEqual(found1, root, "sentinel .workspace-root should win");
+
+  await fs.remove(path.join(root, ".workspace-root"));
+  await fs.writeFile(path.join(root, ".repo-root"), "\n");
+  const found2 = await findProjectRoot(nested);
+  assertEqual(found2, root, "sentinel .repo-root should win");
+  return { name: "other-sentinels", ok: true };
+}
+
+async function testGitCliAndMarker() {
+  const hasGit = await cmdAvailable("git");
+  if (!hasGit) return { name: "git-cli", ok: true, skipped: true };
+
+  const root = await mkTmpDir("git");
+  const nested = path.join(root, "pkg", "src");
+  await fs.ensureDir(nested);
+  await execFileAsync("git", ["init"], { cwd: root, timeout: 2000 });
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "git toplevel should be detected");
+  return { name: "git-cli", ok: true };
+}
+
+async function testHgMarkerOrCli() {
+  // Prefer simple marker test to avoid requiring Mercurial install
+  const root = await mkTmpDir("hg");
+  const nested = path.join(root, "lib");
+  await fs.ensureDir(nested);
+  await fs.ensureDir(path.join(root, ".hg"));
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, ".hg marker should be detected");
+  return { name: "hg-marker", ok: true };
+}
+
+async function testWorkspacePnpm() {
+  const root = await mkTmpDir("pnpm-workspace");
+  const pkgA = path.join(root, "packages", "a");
+  await fs.ensureDir(pkgA);
+  await fs.writeFile(path.join(root, "pnpm-workspace.yaml"), "packages:\n  - packages/*\n");
+  const found = await findProjectRoot(pkgA);
+  await assertEqual(found, root, "pnpm-workspace.yaml should be detected");
+  return { name: "pnpm-workspace", ok: true };
+}
+
+async function testPackageJsonWorkspaces() {
+  const root = await mkTmpDir("package-workspaces");
+  const pkgA = path.join(root, "packages", "a");
+  await fs.ensureDir(pkgA);
+  await fs.writeJson(path.join(root, "package.json"), { private: true, workspaces: ["packages/*"] }, { spaces: 2 });
+  const found = await findProjectRoot(pkgA);
+  await assertEqual(found, root, "package.json workspaces should be detected");
+  return { name: "package.json-workspaces", ok: true };
+}
+
+async function testLockfiles() {
+  const root = await mkTmpDir("lockfiles");
+  const nested = path.join(root, "src");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "yarn.lock"), "\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "yarn.lock should be detected");
+  return { name: "lockfiles", ok: true };
+}
+
+async function testLanguageConfigs() {
+  const root = await mkTmpDir("lang-configs");
+  const nested = path.join(root, "x", "y");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "pyproject.toml"), "[tool.poetry]\nname='tmp'\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "pyproject.toml should be detected");
+  return { name: "language-configs", ok: true };
+}
+
+async function testPreferOuterOnTie() {
+  const root = await mkTmpDir("tie");
+  const mid = path.join(root, "mid");
+  const leaf = path.join(mid, "leaf");
+  await fs.ensureDir(leaf);
+  // same weight marker at two levels
+  await fs.writeFile(path.join(root, "requirements.txt"), "\n");
+  await fs.writeFile(path.join(mid, "requirements.txt"), "\n");
+  const found = await findProjectRoot(leaf);
+  await assertEqual(found, root, "outermost directory should win on equal weight");
+  return { name: "prefer-outermost-tie", ok: true };
+}
+
+// Additional coverage: Bazel, Nx/Turbo/Rush, Go workspaces, Deno, Java/Scala, PHP, Rust, Nix, Changesets, env markers,
+// and priority interaction between package.json and lockfiles.
+
+async function testBazelWorkspace() {
+  const root = await mkTmpDir("bazel");
+  const nested = path.join(root, "apps", "svc");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "WORKSPACE"), "workspace(name=\"tmp\")\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "Bazel WORKSPACE should be detected");
+  return { name: "bazel-workspace", ok: true };
+}
+
+async function testNx() {
+  const root = await mkTmpDir("nx");
+  const nested = path.join(root, "apps", "web");
+  await fs.ensureDir(nested);
+  await fs.writeJson(path.join(root, "nx.json"), { npmScope: "tmp" }, { spaces: 2 });
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "nx.json should be detected");
+  return { name: "nx", ok: true };
+}
+
+async function testTurbo() {
+  const root = await mkTmpDir("turbo");
+  const nested = path.join(root, "packages", "x");
+  await fs.ensureDir(nested);
+  await fs.writeJson(path.join(root, "turbo.json"), { pipeline: {} }, { spaces: 2 });
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "turbo.json should be detected");
+  return { name: "turbo", ok: true };
+}
+
+async function testRush() {
+  const root = await mkTmpDir("rush");
+  const nested = path.join(root, "apps", "a");
+  await fs.ensureDir(nested);
+  await fs.writeJson(path.join(root, "rush.json"), { projectFolderMinDepth: 1 }, { spaces: 2 });
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "rush.json should be detected");
+  return { name: "rush", ok: true };
+}
+
+async function testGoWorkAndMod() {
+  const root = await mkTmpDir("gowork");
+  const mod = path.join(root, "modA");
+  const nested = path.join(mod, "pkg");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "go.work"), "go 1.22\nuse ./modA\n");
+  await fs.writeFile(path.join(mod, "go.mod"), "module example.com/a\ngo 1.22\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "go.work should define the workspace root");
+  return { name: "go-work", ok: true };
+}
+
+async function testDenoJson() {
+  const root = await mkTmpDir("deno");
+  const nested = path.join(root, "src");
+  await fs.ensureDir(nested);
+  await fs.writeJson(path.join(root, "deno.json"), { tasks: {} }, { spaces: 2 });
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "deno.json should be detected");
+  return { name: "deno-json", ok: true };
+}
+
+async function testGradleSettings() {
+  const root = await mkTmpDir("gradle");
+  const nested = path.join(root, "app");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "settings.gradle"), "rootProject.name='tmp'\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "settings.gradle should be detected");
+  return { name: "gradle-settings", ok: true };
+}
+
+async function testMavenPom() {
+  const root = await mkTmpDir("maven");
+  const nested = path.join(root, "module");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "pom.xml"), "<project></project>\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "pom.xml should be detected");
+  return { name: "maven-pom", ok: true };
+}
+
+async function testSbtBuild() {
+  const root = await mkTmpDir("sbt");
+  const nested = path.join(root, "sub");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "build.sbt"), "name := \"tmp\"\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "build.sbt should be detected");
+  return { name: "sbt-build", ok: true };
+}
+
+async function testComposer() {
+  const root = await mkTmpDir("composer");
+  const nested = path.join(root, "src");
+  await fs.ensureDir(nested);
+  await fs.writeJson(path.join(root, "composer.json"), { name: "tmp/pkg" }, { spaces: 2 });
+  await fs.writeFile(path.join(root, "composer.lock"), "{}\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "composer.{json,lock} should be detected");
+  return { name: "composer", ok: true };
+}
+
+async function testCargo() {
+  const root = await mkTmpDir("cargo");
+  const nested = path.join(root, "src");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "Cargo.toml"), "[package]\nname='tmp'\nversion='0.0.0'\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "Cargo.toml should be detected");
+  return { name: "cargo", ok: true };
+}
+
+async function testNixFlake() {
+  const root = await mkTmpDir("nix");
+  const nested = path.join(root, "work");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "flake.nix"), "{ }\n");
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, "flake.nix should be detected");
+  return { name: "nix-flake", ok: true };
+}
+
+async function testChangesetConfig() {
+  const root = await mkTmpDir("changeset");
+  const nested = path.join(root, "pkg");
+  await fs.ensureDir(nested);
+  await fs.ensureDir(path.join(root, ".changeset"));
+  await fs.writeJson(path.join(root, ".changeset", "config.json"), { $schema: "https://unpkg.com/@changesets/config@2.3.1/schema.json" }, { spaces: 2 });
+  const found = await findProjectRoot(nested);
+  await assertEqual(found, root, ".changeset/config.json should be detected");
+  return { name: "changesets", ok: true };
+}
+
+async function testEnvCustomMarker() {
+  const root = await mkTmpDir("env-marker");
+  const nested = path.join(root, "dir");
+  await fs.ensureDir(nested);
+  await fs.writeFile(path.join(root, "MY_ROOT"), "\n");
+  const prev = process.env.PROJECT_ROOT_MARKERS;
+  process.env.PROJECT_ROOT_MARKERS = "MY_ROOT";
+  try {
+    const found = await findProjectRoot(nested);
+    await assertEqual(found, root, "custom env marker should be honored");
+  } finally {
+    if (prev === undefined) delete process.env.PROJECT_ROOT_MARKERS; else process.env.PROJECT_ROOT_MARKERS = prev;
+  }
+  return { name: "env-custom-marker", ok: true };
+}
+
+async function testPackageLowPriorityVsLock() {
+  const root = await mkTmpDir("pkg-vs-lock");
+  const nested = path.join(root, "nested");
+  await fs.ensureDir(path.join(nested, "deep"));
+  await fs.writeJson(path.join(nested, "package.json"), { name: "nested" }, { spaces: 2 });
+  await fs.writeFile(path.join(root, "yarn.lock"), "\n");
+  const found = await findProjectRoot(path.join(nested, "deep"));
+  await assertEqual(found, root, "lockfile at root should outrank nested package.json");
+  return { name: "package-vs-lock-priority", ok: true };
+}
+
+async function run() {
+  const tests = [
+    testSentinel,
+    testOtherSentinels,
+    testGitCliAndMarker,
+    testHgMarkerOrCli,
+    testWorkspacePnpm,
+    testPackageJsonWorkspaces,
+    testLockfiles,
+    testLanguageConfigs,
+    testPreferOuterOnTie,
+    testBazelWorkspace,
+    testNx,
+    testTurbo,
+    testRush,
+    testGoWorkAndMod,
+    testDenoJson,
+    testGradleSettings,
+    testMavenPom,
+    testSbtBuild,
+    testComposer,
+    testCargo,
+    testNixFlake,
+    testChangesetConfig,
+    testEnvCustomMarker,
+    testPackageLowPriorityVsLock,
+    testSvnMarker,
+    testSymlinkStart,
+    testSubmoduleLikeInnerGitFile,
+  ];
+
+  const results = [];
+  for (const t of tests) {
+    try {
+      const r = await t();
+      results.push({ ...r, ok: true });
+      console.log(`✔ ${r.name}${r.skipped ? " (skipped)" : ""}`);
+    } catch (err) {
+      console.error(`✖ ${t.name}:`, err && err.message ? err.message : err);
+      results.push({ name: t.name, ok: false, error: String(err) });
+    }
+  }
+
+  const failed = results.filter((r) => !r.ok);
+  console.log("\nSummary:");
+  for (const r of results) {
+    console.log(`- ${r.name}: ${r.ok ? "ok" : "FAIL"}${r.skipped ? " (skipped)" : ""}`);
+  }
+
+  if (failed.length) {
+    process.exitCode = 1;
+  }
+}
+
+run().catch((e) => {
+  console.error("Fatal error:", e);
+  process.exit(1);
+});

package/tools/installer/bin/bmad.js

@@ -4,8 +4,8 @@ const { program } = require('commander');
 const path = require('path');
 const fs = require('fs').promises;
 const yaml = require('js-yaml');
-const chalk = require('chalk');
-const inquirer = require('inquirer');
+const chalk = require('chalk').default || require('chalk');
+const inquirer = require('inquirer').default || require('inquirer');
 const semver = require('semver');
 const https = require('https');
 
@@ -45,7 +45,7 @@ program
   .option('-f, --full', 'Install complete BMad Method')
   .option('-x, --expansion-only', 'Install only expansion packs (no bmad-core)')
   .option('-d, --directory <path>', 'Installation directory')
-  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, kilo, cline, gemini, qwen-code, github-copilot, other)')
+  .option('-i, --ide <ide...>', 'Configure for specific IDE(s) - can specify multiple (cursor, claude-code, windsurf, trae, roo, kilo, cline, gemini, qwen-code, github-copilot, crush, other)')
   .option('-e, --expansion-packs <packs...>', 'Install specific expansion packs (can specify multiple)')
   .action(async (options) => {
     try {
@@ -183,17 +183,17 @@ program
   });
 
 async function promptInstallation() {
-  
+
   // Display ASCII logo
   console.log(chalk.bold.cyan(`
-██████╗ ███╗   ███╗ █████╗ ██████╗       ███╗   ███╗███████╗████████╗██╗  ██╗ ██████╗ ██████╗ 
+██████╗ ███╗   ███╗ █████╗ ██████╗       ███╗   ███╗███████╗████████╗██╗  ██╗ ██████╗ ██████╗
 ██╔══██╗████╗ ████║██╔══██╗██╔══██╗      ████╗ ████║██╔════╝╚══██╔══╝██║  ██║██╔═══██╗██╔══██╗
 ██████╔╝██╔████╔██║███████║██║  ██║█████╗██╔████╔██║█████╗     ██║   ███████║██║   ██║██║  ██║
 ██╔══██╗██║╚██╔╝██║██╔══██║██║  ██║╚════╝██║╚██╔╝██║██╔══╝     ██║   ██╔══██║██║   ██║██║  ██║
 ██████╔╝██║ ╚═╝ ██║██║  ██║██████╔╝      ██║ ╚═╝ ██║███████╗   ██║   ██║  ██║╚██████╔╝██████╔╝
-╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝       ╚═╝     ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝ 
+╚═════╝ ╚═╝     ╚═╝╚═╝  ╚═╝╚═════╝       ╚═╝     ╚═╝╚══════╝   ╚═╝   ╚═╝  ╚═╝ ╚═════╝ ╚═════╝
   `));
-  
+
   console.log(chalk.bold.magenta('🚀 Universal AI Agent Framework for Any Domain'));
   console.log(chalk.bold.blue(`✨ Installer v${version}\n`));
 
@@ -218,63 +218,63 @@ async function promptInstallation() {
   // Detect existing installations
   const installDir = path.resolve(directory);
   const state = await installer.detectInstallationState(installDir);
-  
+
   // Check for existing expansion packs
   const existingExpansionPacks = state.expansionPacks || {};
-  
+
   // Get available expansion packs
   const availableExpansionPacks = await installer.getAvailableExpansionPacks();
-  
+
   // Build choices list
   const choices = [];
-  
+
   // Load core config to get short-title
   const coreConfigPath = path.join(__dirname, '..', '..', '..', 'bmad-core', 'core-config.yaml');
   const coreConfig = yaml.load(await fs.readFile(coreConfigPath, 'utf8'));
   const coreShortTitle = coreConfig['short-title'] || 'BMad Agile Core System';
-  
+
   // Add BMad core option
   let bmadOptionText;
   if (state.type === 'v4_existing') {
     const currentVersion = state.manifest?.version || 'unknown';
     const newVersion = version; // Always use package.json version
-    const versionInfo = currentVersion === newVersion 
+    const versionInfo = currentVersion === newVersion
       ? `(v${currentVersion} - reinstall)`
       : `(v${currentVersion} → v${newVersion})`;
     bmadOptionText = `Update ${coreShortTitle} ${versionInfo} .bmad-core`;
   } else {
     bmadOptionText = `${coreShortTitle} (v${version}) .bmad-core`;
   }
-  
+
   choices.push({
     name: bmadOptionText,
     value: 'bmad-core',
     checked: true
   });
-  
+
   // Add expansion pack options
   for (const pack of availableExpansionPacks) {
     const existing = existingExpansionPacks[pack.id];
     let packOptionText;
-    
+
     if (existing) {
       const currentVersion = existing.manifest?.version || 'unknown';
       const newVersion = pack.version;
-      const versionInfo = currentVersion === newVersion 
+      const versionInfo = currentVersion === newVersion
         ? `(v${currentVersion} - reinstall)`
         : `(v${currentVersion} → v${newVersion})`;
       packOptionText = `Update ${pack.shortTitle} ${versionInfo} .${pack.id}`;
     } else {
       packOptionText = `${pack.shortTitle} (v${pack.version}) .${pack.id}`;
     }
-    
+
     choices.push({
       name: packOptionText,
       value: pack.id,
       checked: false
     });
   }
-  
+
   // Ask what to install
   const { selectedItems } = await inquirer.prompt([
     {
@@ -290,7 +290,7 @@ async function promptInstallation() {
       }
     }
   ]);
-  
+
   // Process selections
   answers.installType = selectedItems.includes('bmad-core') ? 'full' : 'expansion-only';
   answers.expansionPacks = selectedItems.filter(item => item !== 'bmad-core');
@@ -299,7 +299,7 @@ async function promptInstallation() {
   if (selectedItems.includes('bmad-core')) {
     console.log(chalk.cyan('\n📋 Document Organization Settings'));
     console.log(chalk.dim('Configure how your project documentation should be organized.\n'));
-    
+
     // Ask about PRD sharding
     const { prdSharded } = await inquirer.prompt([
       {
@@ -310,7 +310,7 @@ async function promptInstallation() {
       }
     ]);
     answers.prdSharded = prdSharded;
-    
+
     // Ask about architecture sharding
     const { architectureSharded } = await inquirer.prompt([
       {
@@ -321,7 +321,7 @@ async function promptInstallation() {
       }
     ]);
     answers.architectureSharded = architectureSharded;
-    
+
     // Show warning if architecture sharding is disabled
     if (!architectureSharded) {
       console.log(chalk.yellow.bold('\n⚠️  IMPORTANT: Architecture Sharding Disabled'));
@@ -330,7 +330,7 @@ async function promptInstallation() {
       console.log(chalk.yellow('as these are used by the dev agent at runtime.'));
       console.log(chalk.yellow('\nAlternatively, you can remove these files from the devLoadAlwaysFiles list'));
       console.log(chalk.yellow('in your core-config.yaml after installation.'));
-      
+
       const { acknowledge } = await inquirer.prompt([
         {
           type: 'confirm',
@@ -339,7 +339,7 @@ async function promptInstallation() {
           default: false
         }
       ]);
-      
+
       if (!acknowledge) {
         console.log(chalk.red('Installation cancelled.'));
         process.exit(0);
@@ -350,14 +350,14 @@ async function promptInstallation() {
   // Ask for IDE configuration
   let ides = [];
   let ideSelectionComplete = false;
-  
+
   while (!ideSelectionComplete) {
     console.log(chalk.cyan('\n🛠️  IDE Configuration'));
     console.log(chalk.bold.yellow.bgRed(' ⚠️  IMPORTANT: This is a MULTISELECT! Use SPACEBAR to toggle each IDE! '));
     console.log(chalk.bold.magenta('🔸 Use arrow keys to navigate'));
     console.log(chalk.bold.magenta('🔸 Use SPACEBAR to select/deselect IDEs'));
     console.log(chalk.bold.magenta('🔸 Press ENTER when finished selecting\n'));
-    
+
     const ideResponse = await inquirer.prompt([
       {
         type: 'checkbox',
@@ -373,11 +373,12 @@ async function promptInstallation() {
           { name: 'Cline', value: 'cline' },
           { name: 'Gemini CLI', value: 'gemini' },
           { name: 'Qwen Code', value: 'qwen-code' },
+          { name: 'Crush', value: 'crush' },
           { name: 'Github Copilot', value: 'github-copilot' }
         ]
       }
     ]);
-    
+
     ides = ideResponse.ides;
 
     // Confirm no IDE selection if none selected
@@ -390,13 +391,13 @@ async function promptInstallation() {
           default: false
         }
       ]);
-      
+
       if (!confirmNoIde) {
         console.log(chalk.bold.red('\n🔄 Returning to IDE selection. Remember to use SPACEBAR to select IDEs!\n'));
         continue; // Go back to IDE selection only
       }
     }
-    
+
     ideSelectionComplete = true;
   }
 
@@ -407,7 +408,7 @@ async function promptInstallation() {
   if (ides.includes('github-copilot')) {
     console.log(chalk.cyan('\n🔧 GitHub Copilot Configuration'));
     console.log(chalk.dim('BMad works best with specific VS Code settings for optimal agent experience.\n'));
-    
+
     const { configChoice } = await inquirer.prompt([
       {
         type: 'list',
@@ -430,7 +431,7 @@ async function promptInstallation() {
         default: 'defaults'
       }
     ]);
-    
+
     answers.githubCopilotConfig = { configChoice };
   }
 

package/tools/installer/config/install.config.yaml

@@ -28,6 +28,16 @@ ide-configurations:
       # To use BMad agents in Claude Code:
       # 1. Type /agent-name (e.g., "/dev", "/pm", "/architect")
       # 2. Claude will switch to that agent's persona
+  crush:
+    name: Crush
+    rule-dir: .crush/commands/BMad/
+    format: multi-file
+    command-suffix: .md
+    instructions: |
+      # To use BMad agents in Crush:
+      # 1. Press CTRL + P and press TAB
+      # 2. Select agent or task
+      # 3. Crush will switch to that agent's persona / task
   windsurf:
     name: Windsurf
     rule-dir: .windsurf/rules/
@@ -110,4 +120,4 @@ ide-configurations:
       # 1. The installer creates a .qwen/bmad-method/ directory in your project.
       # 2. It concatenates all agent files into a single QWEN.md file.
       # 3. Simply mention the agent in your prompt (e.g., "As *dev, ...").
-      # 4. The Qwen Code CLI will automatically have the context for that agent.
+      # 4. The Qwen Code CLI will automatically have the context for that agent.

package/tools/installer/lib/file-manager.js

@@ -2,7 +2,7 @@ const fs = require("fs-extra");
 const path = require("path");
 const crypto = require("crypto");
 const yaml = require("js-yaml");
-const chalk = require("chalk");
+const chalk = require("chalk").default || require("chalk");
 const { createReadStream, createWriteStream, promises: fsPromises } = require('fs');
 const { pipeline } = require('stream/promises');
 const resourceLocator = require('./resource-locator');

package/tools/installer/lib/ide-base-setup.js

@@ -6,7 +6,7 @@
 const path = require("path");
 const fs = require("fs-extra");
 const yaml = require("js-yaml");
-const chalk = require("chalk");
+const chalk = require("chalk").default || require("chalk");
 const fileManager = require("./file-manager");
 const resourceLocator = require("./resource-locator");
 const { extractYamlFromAgent } = require("../../lib/yaml-utils");