bmalph 2.2.0 → 2.3.0

package/dist/commands/init.js

@@ -1,13 +1,60 @@
 import chalk from "chalk";
 import inquirer from "inquirer";
 import { writeConfig } from "../utils/config.js";
-import { installProject, mergeClaudeMd, isInitialized, previewInstall, getBundledVersions, } from "../installer.js";
+import { installProject, mergeInstructionsFile, isInitialized, hasExistingBmadDir, previewInstall, getBundledVersions, } from "../installer.js";
 import { formatDryRunSummary } from "../utils/dryrun.js";
 import { validateProjectName } from "../utils/validate.js";
 import { withErrorHandling } from "../utils/errors.js";
+import { isPlatformId, getPlatform } from "../platform/registry.js";
+import { detectPlatform } from "../platform/detect.js";
 export async function initCommand(options) {
     await withErrorHandling(() => runInit(options));
 }
+/**
+ * Resolve which platform to use:
+ * 1. Explicit --platform flag
+ * 2. Auto-detect from filesystem markers
+ * 3. Interactive prompt (if TTY)
+ * 4. Default to claude-code (non-interactive)
+ */
+async function resolvePlatform(projectDir, explicit) {
+    // 1. Explicit flag
+    if (explicit) {
+        if (!isPlatformId(explicit)) {
+            throw new Error(`Unknown platform: "${explicit}". ` +
+                `Valid platforms: claude-code, codex, cursor, windsurf, copilot, aider`);
+        }
+        return getPlatform(explicit);
+    }
+    // 2. Auto-detect
+    const detection = await detectPlatform(projectDir);
+    if (detection.detected) {
+        return getPlatform(detection.detected);
+    }
+    // 3. Interactive prompt if multiple candidates or none detected
+    if (process.stdin.isTTY) {
+        const choices = [
+            { name: "Claude Code", value: "claude-code" },
+            { name: "OpenAI Codex", value: "codex" },
+            { name: "Cursor", value: "cursor" },
+            { name: "Windsurf", value: "windsurf" },
+            { name: "GitHub Copilot", value: "copilot" },
+            { name: "Aider", value: "aider" },
+        ];
+        const { platformId } = await inquirer.prompt([
+            {
+                type: "list",
+                name: "platformId",
+                message: "Which platform are you using?",
+                choices,
+                default: detection.candidates[0] ?? "claude-code",
+            },
+        ]);
+        return getPlatform(platformId);
+    }
+    // 4. Non-interactive default
+    return getPlatform("claude-code");
+}
 async function runInit(options) {
     const projectDir = options.projectDir;
     if (await isInitialized(projectDir)) {
@@ -15,9 +62,16 @@ async function runInit(options) {
         console.log("Use 'bmalph upgrade' to update bundled assets to the latest version.");
         return;
     }
+    if (await hasExistingBmadDir(projectDir)) {
+        console.log(chalk.cyan("Existing BMAD installation detected."));
+        console.log("Framework files in _bmad/ will be replaced with the managed version.");
+        console.log("Planning artifacts in _bmad-output/ will not be modified.\n");
+    }
+    // Resolve platform
+    const platform = await resolvePlatform(projectDir, options.platform);
     // Handle dry-run mode
     if (options.dryRun) {
-        const preview = await previewInstall(projectDir);
+        const preview = await previewInstall(projectDir, platform);
         const actions = [
             ...preview.wouldCreate.map((p) => ({ type: "create", path: p })),
             ...preview.wouldModify.map((p) => ({ type: "modify", path: p })),
@@ -64,31 +118,43 @@ async function runInit(options) {
         throw new Error("Project name cannot be empty");
     }
     const validatedName = validateProjectName(name);
-    console.log(chalk.blue("\nInstalling BMAD + Ralph..."));
-    await installProject(projectDir);
+    console.log(chalk.blue(`\nInstalling BMAD + Ralph for ${platform.displayName}...`));
+    await installProject(projectDir, platform);
     const bundledVersions = getBundledVersions();
     const config = {
         name: validatedName,
         description: description ?? "",
         createdAt: new Date().toISOString(),
+        platform: platform.id,
         upstreamVersions: bundledVersions,
     };
     try {
         await writeConfig(projectDir, config);
-        await mergeClaudeMd(projectDir);
+        await mergeInstructionsFile(projectDir, platform);
     }
     catch (err) {
         throw new Error(`Partial installation: files were copied but configuration failed. ` +
-            `Run 'bmalph init' again to retry. ` +
-            `Cause: ${err instanceof Error ? err.message : String(err)}`);
+            `Run 'bmalph init' again to retry.`, { cause: err });
     }
     console.log(chalk.green("\nbmalph initialized successfully!"));
     console.log(`\n  Project: ${chalk.bold(config.name)}`);
+    console.log(`  Platform: ${chalk.bold(platform.displayName)}`);
     console.log(`\nInstalled:`);
     console.log(`  _bmad/             BMAD agents and workflows`);
     console.log(`  .ralph/            Ralph loop and templates`);
-    console.log(`  .claude/commands/  Slash command (/bmalph)`);
+    if (platform.commandDelivery.kind === "directory") {
+        console.log(`  ${platform.commandDelivery.dir}/  Slash commands`);
+    }
     console.log(`  bmalph/            State management`);
+    // Platform-specific next step guidance
     console.log(`\nNext step:`);
-    console.log(`  Use ${chalk.cyan("/bmalph")} in Claude Code to see your current phase and commands.`);
+    if (platform.id === "claude-code") {
+        console.log(`  Use ${chalk.cyan("/bmalph")} in Claude Code to see your current phase and commands.`);
+    }
+    else if (platform.id === "codex") {
+        console.log(`  Ask Codex to ${chalk.cyan("run the BMAD master agent")} to navigate phases.`);
+    }
+    else {
+        console.log(`  Ask your AI assistant to ${chalk.cyan("use the BMAD agents")} defined in ${chalk.cyan(platform.instructionsFile)}.`);
+    }
 }

package/dist/commands/upgrade.js

@@ -1,9 +1,10 @@
 import chalk from "chalk";
 import inquirer from "inquirer";
-import { isInitialized, copyBundledAssets, mergeClaudeMd, previewUpgrade, getBundledVersions, } from "../installer.js";
+import { isInitialized, copyBundledAssets, mergeInstructionsFile, previewUpgrade, getBundledVersions, } from "../installer.js";
 import { readConfig, writeConfig } from "../utils/config.js";
 import { formatDryRunSummary } from "../utils/dryrun.js";
 import { withErrorHandling } from "../utils/errors.js";
+import { resolveProjectPlatform } from "../platform/resolve.js";
 export async function upgradeCommand(options) {
     await withErrorHandling(() => runUpgrade(options));
 }
@@ -13,9 +14,11 @@ async function runUpgrade(options) {
         console.log(chalk.red("bmalph is not initialized. Run 'bmalph init' first."));
         return;
     }
+    // Read platform from existing config
+    const platform = await resolveProjectPlatform(projectDir);
     // Handle dry-run mode
     if (options.dryRun) {
-        const preview = await previewUpgrade(projectDir);
+        const preview = await previewUpgrade(projectDir, platform);
         const actions = [
             ...preview.wouldUpdate.map((p) => ({ type: "modify", path: p })),
             ...preview.wouldCreate.map((p) => ({ type: "create", path: p })),
@@ -41,9 +44,9 @@ async function runUpgrade(options) {
             return;
         }
     }
-    console.log(chalk.blue("Upgrading bundled assets..."));
-    const result = await copyBundledAssets(projectDir);
-    await mergeClaudeMd(projectDir);
+    console.log(chalk.blue(`Upgrading bundled assets for ${platform.displayName}...`));
+    const result = await copyBundledAssets(projectDir, platform);
+    await mergeInstructionsFile(projectDir, platform);
     // Update upstreamVersions in config to match bundled versions
     const config = await readConfig(projectDir);
     if (config) {

package/dist/installer.d.ts

@@ -1,7 +1,7 @@
+import type { Platform } from "./platform/types.js";
 export declare function getPackageVersion(): string;
 export interface BundledVersions {
     bmadCommit: string;
-    ralphCommit: string;
 }
 export declare function getBundledVersions(): BundledVersions;
 export declare function getBundledBmadDir(): string;
@@ -18,11 +18,22 @@ export interface PreviewInstallResult {
 export interface PreviewUpgradeResult {
     wouldUpdate: string[];
     wouldCreate: string[];
+    wouldPreserve: string[];
 }
-export declare function copyBundledAssets(projectDir: string): Promise<UpgradeResult>;
-export declare function installProject(projectDir: string): Promise<void>;
+export declare function copyBundledAssets(projectDir: string, platform?: Platform): Promise<UpgradeResult>;
+export declare function installProject(projectDir: string, platform?: Platform): Promise<void>;
 export declare function generateManifests(projectDir: string): Promise<void>;
+/**
+ * Merge the BMAD instructions snippet into the platform's instructions file.
+ * Creates the file if it doesn't exist, replaces an existing BMAD section on upgrade.
+ */
+export declare function mergeInstructionsFile(projectDir: string, platform?: Platform): Promise<void>;
+/**
+ * @deprecated Use `mergeInstructionsFile(projectDir)` instead.
+ * Kept for backward compatibility during migration.
+ */
 export declare function mergeClaudeMd(projectDir: string): Promise<void>;
 export declare function isInitialized(projectDir: string): Promise<boolean>;
-export declare function previewInstall(projectDir: string): Promise<PreviewInstallResult>;
-export declare function previewUpgrade(projectDir: string): Promise<PreviewUpgradeResult>;
+export declare function hasExistingBmadDir(projectDir: string): Promise<boolean>;
+export declare function previewInstall(projectDir: string, platform?: Platform): Promise<PreviewInstallResult>;
+export declare function previewUpgrade(projectDir: string, platform?: Platform): Promise<PreviewUpgradeResult>;