bmalph 2.7.5 → 2.7.6

package/dist/installer/commands.js

@@ -0,0 +1,324 @@
+import { cp, mkdir, readFile, readdir, rm } from "node:fs/promises";
+import { join } from "node:path";
+import { atomicWriteFile } from "../utils/file-system.js";
+import { isEnoent } from "../utils/errors.js";
+import { SKILLS_DIR, SKILLS_PREFIX } from "../utils/constants.js";
+const AGENT_DESCRIPTIONS = {
+    analyst: "Research, briefs, discovery",
+    architect: "Technical design, architecture",
+    pm: "PRDs, epics, stories",
+    sm: "Sprint planning, status, coordination",
+    dev: "Implementation, coding",
+    "ux-designer": "User experience, wireframes",
+    qa: "Test automation, quality assurance",
+    "tech-writer": "Documentation, technical writing",
+    "quick-flow-solo-dev": "Quick one-off tasks, small changes",
+};
+const BMALPH_COMMANDS = {
+    bmalph: {
+        description: "BMAD master agent — navigate phases",
+        howToRun: "Read and follow the master agent instructions in this file",
+    },
+    "bmalph-implement": {
+        description: "Transition planning artifacts to Ralph format",
+        howToRun: "Run `bmalph implement`",
+    },
+    "bmalph-status": {
+        description: "Show current phase, Ralph progress, version info",
+        howToRun: "Run `bmalph status`",
+    },
+    "bmalph-upgrade": {
+        description: "Update bundled assets to current version",
+        howToRun: "Run `bmalph upgrade`",
+    },
+    "bmalph-doctor": {
+        description: "Check project health and report issues",
+        howToRun: "Run `bmalph doctor`",
+    },
+    "bmalph-watch": {
+        description: "Launch Ralph live dashboard",
+        howToRun: "Run `bmalph run`",
+    },
+};
+const PHASE_SECTIONS = [
+    { key: "1-analysis", label: "Phase 1: Analysis" },
+    { key: "2-planning", label: "Phase 2: Planning" },
+    { key: "3-solutioning", label: "Phase 3: Solutioning" },
+    { key: "4-implementation", label: "Phase 4: Implementation" },
+    { key: "anytime", label: "Utilities" },
+];
+// CSV column indices for bmad-help.csv
+const CSV_COL_PHASE = 1;
+const CSV_COL_NAME = 2;
+const CSV_COL_WORKFLOW_FILE = 5;
+const CSV_COL_DESCRIPTION = 10;
+const FALLBACK_PHASE = "anytime";
+/** CLI-pointer bmalph commands are all bmalph-* except the master "bmalph" command. */
+function isCliPointer(cmd) {
+    return cmd.kind === "bmalph" && cmd.name !== "bmalph";
+}
+/**
+ * Parse a CSV row handling double-quoted fields.
+ */
+function parseCsvRow(row) {
+    const fields = [];
+    let current = "";
+    let inQuotes = false;
+    for (let i = 0; i < row.length; i++) {
+        const ch = row[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (i + 1 < row.length && row[i + 1] === '"') {
+                    current += '"';
+                    i++;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"') {
+            inQuotes = true;
+        }
+        else if (ch === ",") {
+            fields.push(current);
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    fields.push(current);
+    return fields;
+}
+/**
+ * Deliver slash commands based on the platform's command delivery strategy.
+ *
+ * - "directory": Copy command files to a directory (e.g., .claude/commands/)
+ * - "skills": No-op — commands are generated as skills by generateSkills()
+ * - "index": No-op — commands are discoverable via _bmad/COMMANDS.md
+ */
+export async function deliverCommands(projectDir, platform, slashCommandsDir) {
+    const delivery = platform.commandDelivery;
+    if (delivery.kind !== "directory") {
+        return [];
+    }
+    const slashFiles = await readdir(slashCommandsDir);
+    const bundledCommandNames = new Set(slashFiles.filter((f) => f.endsWith(".md")));
+    const commandsDir = join(projectDir, delivery.dir);
+    await mkdir(commandsDir, { recursive: true });
+    // Clean stale bmalph-owned commands before copying (preserve user-created commands)
+    try {
+        const existingCommands = await readdir(commandsDir);
+        for (const file of existingCommands) {
+            if (file.endsWith(".md") && bundledCommandNames.has(file)) {
+                await rm(join(commandsDir, file), { force: true });
+            }
+        }
+    }
+    catch (err) {
+        if (!isEnoent(err))
+            throw err;
+    }
+    for (const file of bundledCommandNames) {
+        await cp(join(slashCommandsDir, file), join(commandsDir, file), { dereference: false });
+    }
+    return [`${delivery.dir}/`];
+}
+/**
+ * Classify all slash commands by reading CSV metadata and file contents.
+ * Shared by generateCommandIndex() and generateSkills().
+ */
+export async function classifyCommands(projectDir, slashCmdsDir) {
+    const helpCsvPath = join(projectDir, "_bmad/_config/bmad-help.csv");
+    const helpCsv = await readFile(helpCsvPath, "utf-8");
+    // Parse CSV: build workflow-file → {phase, description} lookup
+    const csvLines = helpCsv.trimEnd().split(/\r?\n/);
+    const workflowLookup = new Map();
+    for (const line of csvLines.slice(1)) {
+        if (!line.trim())
+            continue;
+        const fields = parseCsvRow(line);
+        const workflowFile = fields[CSV_COL_WORKFLOW_FILE]?.trim();
+        if (workflowFile) {
+            workflowLookup.set(workflowFile, {
+                phase: fields[CSV_COL_PHASE]?.trim() ?? FALLBACK_PHASE,
+                description: fields[CSV_COL_DESCRIPTION]?.trim() ?? fields[CSV_COL_NAME]?.trim() ?? "",
+            });
+        }
+    }
+    // Read slash command files
+    const slashFiles = (await readdir(slashCmdsDir)).filter((f) => f.endsWith(".md")).sort();
+    const results = [];
+    for (const file of slashFiles) {
+        const name = file.replace(/\.md$/, "");
+        const body = (await readFile(join(slashCmdsDir, file), "utf-8")).trim();
+        const firstLine = body.split("\n")[0].trim();
+        // Extract _bmad/ file references from content
+        const fileRefs = [...body.matchAll(/`(_bmad\/[^`]+)`/g)].map((m) => m[1]);
+        const agentRef = fileRefs.find((ref) => ref.includes("/agents/"));
+        const workflowRef = fileRefs.find((ref) => ref.includes("/workflows/") || ref.includes("/tasks/"));
+        // Classify: bmalph CLI commands
+        if (name.startsWith("bmalph")) {
+            const known = BMALPH_COMMANDS[name];
+            const desc = known?.description ?? name.replace(/-/g, " ");
+            const howToRun = known?.howToRun ?? `Run \`bmalph ${name.replace("bmalph-", "")}\``;
+            results.push({
+                name,
+                description: desc,
+                invocation: firstLine,
+                body,
+                kind: "bmalph",
+                howToRun,
+            });
+            continue;
+        }
+        // Classify: workflow/task commands (matched via CSV)
+        if (workflowRef && workflowLookup.has(workflowRef)) {
+            const csv = workflowLookup.get(workflowRef);
+            results.push({
+                name,
+                description: csv.description,
+                invocation: firstLine,
+                body,
+                kind: "workflow",
+                phase: csv.phase,
+            });
+            continue;
+        }
+        // Classify: pure agent commands
+        if (agentRef && !workflowRef) {
+            results.push({
+                name,
+                description: AGENT_DESCRIPTIONS[name] ?? name,
+                invocation: firstLine,
+                body,
+                kind: "agent",
+            });
+            continue;
+        }
+        // Fallback: unmatched commands go to utilities
+        results.push({
+            name,
+            description: name.replace(/-/g, " "),
+            invocation: firstLine,
+            body,
+            kind: "utility",
+            phase: FALLBACK_PHASE,
+        });
+    }
+    return results;
+}
+/**
+ * Generate _bmad/COMMANDS.md from pre-classified slash commands.
+ * Provides command discoverability for platforms without native slash command support.
+ */
+export async function generateCommandIndex(projectDir, classified) {
+    const agents = [];
+    const phaseGroups = {};
+    const bmalpEntries = [];
+    for (const cmd of classified) {
+        if (cmd.kind === "bmalph") {
+            bmalpEntries.push({
+                name: cmd.name,
+                description: cmd.description,
+                howToRun: cmd.howToRun,
+            });
+        }
+        else if (cmd.kind === "agent") {
+            agents.push({ name: cmd.name, description: cmd.description, invocation: cmd.invocation });
+        }
+        else if (cmd.kind === "workflow") {
+            const phase = cmd.phase;
+            if (!phaseGroups[phase])
+                phaseGroups[phase] = [];
+            phaseGroups[phase].push({
+                name: cmd.name,
+                description: cmd.description,
+                invocation: cmd.invocation,
+            });
+        }
+        else {
+            const phase = cmd.phase ?? FALLBACK_PHASE;
+            if (!phaseGroups[phase])
+                phaseGroups[phase] = [];
+            phaseGroups[phase].push({
+                name: cmd.name,
+                description: cmd.description,
+                invocation: cmd.invocation,
+            });
+        }
+    }
+    // Build markdown
+    const sections = ["# BMAD Commands\n\n> Auto-generated by bmalph. Do not edit.\n"];
+    if (agents.length > 0) {
+        sections.push(formatCommandTable("Agents", agents));
+    }
+    for (const { key, label } of PHASE_SECTIONS) {
+        const entries = phaseGroups[key];
+        if (entries && entries.length > 0) {
+            sections.push(formatCommandTable(label, entries));
+        }
+    }
+    if (bmalpEntries.length > 0) {
+        sections.push(formatCommandTable("bmalph CLI", bmalpEntries.map((b) => ({
+            name: b.name,
+            description: b.description,
+            invocation: b.howToRun,
+        })), "How to run"));
+    }
+    await atomicWriteFile(join(projectDir, "_bmad/COMMANDS.md"), sections.join("\n"));
+}
+/**
+ * Generate Codex Skills from pre-classified slash commands.
+ * Creates .agents/skills/bmad-<name>/SKILL.md for each non-CLI-pointer command.
+ */
+export async function generateSkills(projectDir, classified) {
+    const skillsBaseDir = join(projectDir, SKILLS_DIR);
+    // Cleanup: remove existing bmad-* skill directories
+    try {
+        const existingDirs = await readdir(skillsBaseDir);
+        for (const dir of existingDirs) {
+            if (dir.startsWith(SKILLS_PREFIX)) {
+                await rm(join(skillsBaseDir, dir), { recursive: true, force: true });
+            }
+        }
+    }
+    catch (err) {
+        if (!isEnoent(err))
+            throw err;
+    }
+    // Generate skills for non-CLI-pointer commands
+    for (const cmd of classified) {
+        if (isCliPointer(cmd))
+            continue;
+        const skillDir = join(skillsBaseDir, `${SKILLS_PREFIX}${cmd.name}`);
+        await mkdir(skillDir, { recursive: true });
+        const skillContent = `---
+name: ${cmd.name}
+description: >
+  ${cmd.description}. Use when the user asks about ${cmd.name.replace(/-/g, " ")}.
+metadata:
+  managed-by: bmalph
+---
+
+${cmd.body}
+`;
+        await atomicWriteFile(join(skillDir, "SKILL.md"), skillContent);
+    }
+}
+function formatCommandTable(heading, entries, thirdCol = "Invocation") {
+    const lines = [
+        `## ${heading}\n`,
+        `| Command | Description | ${thirdCol} |`,
+        "|---------|-------------|------------|",
+    ];
+    for (const e of entries) {
+        lines.push(`| ${e.name} | ${e.description} | ${e.invocation} |`);
+    }
+    return lines.join("\n") + "\n";
+}
+//# sourceMappingURL=commands.js.map

package/dist/installer/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/installer/commands.ts"],"names":[],"mappings":"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"}

package/dist/installer/install.js

@@ -0,0 +1,42 @@
+import { mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { exists } from "../utils/file-system.js";
+import { STATE_DIR } from "../utils/constants.js";
+import { deliverCommands, generateSkills } from "./commands.js";
+import { installBmadAssets } from "./bmad-assets.js";
+import { getBundledBmadDir, getBundledRalphDir, getDefaultPlatform, getPackageVersion, getSlashCommandsDir, } from "./metadata.js";
+import { updateGitignore } from "./project-files.js";
+import { installRalphAssets } from "./ralph-assets.js";
+export async function copyBundledAssets(projectDir, platform) {
+    const p = platform ?? (await getDefaultPlatform());
+    const bmadDir = getBundledBmadDir();
+    const ralphDir = getBundledRalphDir();
+    const slashCommandsDir = getSlashCommandsDir();
+    if (!(await exists(bmadDir))) {
+        throw new Error(`BMAD source directory not found at ${bmadDir}. Package may be corrupted.`);
+    }
+    if (!(await exists(ralphDir))) {
+        throw new Error(`Ralph source directory not found at ${ralphDir}. Package may be corrupted.`);
+    }
+    if (!(await exists(slashCommandsDir))) {
+        throw new Error(`Slash commands directory not found at ${slashCommandsDir}. Package may be corrupted.`);
+    }
+    const classified = await installBmadAssets(projectDir, bmadDir, slashCommandsDir, p);
+    if (p.commandDelivery.kind === "skills") {
+        await generateSkills(projectDir, classified);
+    }
+    const ralphAssets = await installRalphAssets(projectDir, ralphDir, p, await getPackageVersion());
+    const commandPaths = await deliverCommands(projectDir, p, slashCommandsDir);
+    await updateGitignore(projectDir);
+    return {
+        updatedPaths: ["_bmad/", ...ralphAssets.updatedPaths, ...commandPaths, ".gitignore"],
+    };
+}
+export async function installProject(projectDir, platform) {
+    await mkdir(join(projectDir, STATE_DIR), { recursive: true });
+    await mkdir(join(projectDir, ".ralph/specs"), { recursive: true });
+    await mkdir(join(projectDir, ".ralph/logs"), { recursive: true });
+    await mkdir(join(projectDir, ".ralph/docs/generated"), { recursive: true });
+    await copyBundledAssets(projectDir, platform);
+}
+//# sourceMappingURL=install.js.map

package/dist/installer/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../src/installer/install.ts"],"names":[],"mappings":"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"}

package/dist/installer/metadata.js

@@ -0,0 +1,56 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { debug } from "../utils/logger.js";
+import { formatError, isEnoent } from "../utils/errors.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export async function getPackageVersion() {
+    const pkgPath = join(__dirname, "..", "..", "package.json");
+    try {
+        const pkg = JSON.parse(await readFile(pkgPath, "utf-8"));
+        return pkg.version ?? "unknown";
+    }
+    catch (err) {
+        if (!isEnoent(err)) {
+            debug(`Failed to read package.json: ${formatError(err)}`);
+        }
+        return "unknown";
+    }
+}
+export async function getBundledVersions() {
+    const versionsPath = join(__dirname, "..", "..", "bundled-versions.json");
+    try {
+        const versions = JSON.parse(await readFile(versionsPath, "utf-8"));
+        if (!versions || typeof versions.bmadCommit !== "string") {
+            throw new Error("Invalid bundled-versions.json structure: missing bmadCommit");
+        }
+        return {
+            bmadCommit: versions.bmadCommit,
+        };
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("Invalid bundled-versions.json")) {
+            throw err;
+        }
+        throw new Error(`Failed to read bundled-versions.json at ${versionsPath}`, { cause: err });
+    }
+}
+export function getBundledBmadDir() {
+    return join(__dirname, "..", "..", "bmad");
+}
+export function getBundledRalphDir() {
+    return join(__dirname, "..", "..", "ralph");
+}
+export function getSlashCommandsDir() {
+    return join(__dirname, "..", "..", "slash-commands");
+}
+/**
+ * Lazily loads the default (claude-code) platform to avoid circular imports
+ * and keep backward compatibility for callers that don't pass a platform.
+ */
+export async function getDefaultPlatform() {
+    const { claudeCodePlatform } = await import("../platform/claude-code.js");
+    return claudeCodePlatform;
+}
+//# sourceMappingURL=metadata.js.map

package/dist/installer/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/installer/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI3D,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;IAC5D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACzD,OAAO,GAAG,CAAC,OAAO,IAAI,SAAS,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,CAAC,gCAAgC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC1E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,OAAO;YACL,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;YAClF,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;IAC1E,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/installer/project-files.js

@@ -0,0 +1,169 @@
+import { mkdir, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { atomicWriteFile, exists, parseGitignoreLines, replaceSection, } from "../utils/file-system.js";
+import { isEnoent } from "../utils/errors.js";
+import { CONFIG_FILE, SKILLS_DIR, STATE_DIR } from "../utils/constants.js";
+import { getDefaultPlatform } from "./metadata.js";
+import { isTemplateCustomized } from "./template-files.js";
+export async function updateGitignore(projectDir) {
+    const gitignorePath = join(projectDir, ".gitignore");
+    let existing = "";
+    try {
+        existing = await readFile(gitignorePath, "utf-8");
+    }
+    catch (err) {
+        if (!isEnoent(err))
+            throw err;
+    }
+    const existingLines = parseGitignoreLines(existing);
+    const entries = [".ralph/logs/", "_bmad-output/"];
+    const newEntries = entries.filter((e) => !existingLines.has(e));
+    if (newEntries.length === 0)
+        return;
+    const suffix = existing.length > 0 && !existing.endsWith("\n")
+        ? "\n" + newEntries.join("\n") + "\n"
+        : newEntries.join("\n") + "\n";
+    await atomicWriteFile(gitignorePath, existing + suffix);
+}
+/**
+ * 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 async function mergeInstructionsFile(projectDir, platform) {
+    const p = platform ?? (await getDefaultPlatform());
+    const instructionsPath = join(projectDir, p.instructionsFile);
+    const snippet = p.generateInstructionsSnippet();
+    const marker = p.instructionsSectionMarker;
+    // Ensure parent directory exists for nested paths (e.g. .cursor/rules/)
+    await mkdir(dirname(instructionsPath), { recursive: true });
+    let existing = "";
+    try {
+        existing = await readFile(instructionsPath, "utf-8");
+    }
+    catch (err) {
+        if (!isEnoent(err))
+            throw err;
+    }
+    if (existing.includes(marker)) {
+        await atomicWriteFile(instructionsPath, replaceSection(existing, marker, "\n" + snippet));
+        return;
+    }
+    await atomicWriteFile(instructionsPath, existing + snippet);
+}
+export async function isInitialized(projectDir) {
+    return exists(join(projectDir, CONFIG_FILE));
+}
+export async function previewInstall(projectDir, platform) {
+    const p = platform ?? (await getDefaultPlatform());
+    const wouldCreate = [];
+    const wouldModify = [];
+    const wouldSkip = [];
+    // Directories that would be created
+    const dirsToCreate = [
+        `${STATE_DIR}/`,
+        ".ralph/specs/",
+        ".ralph/logs/",
+        ".ralph/docs/generated/",
+        "_bmad/",
+    ];
+    if (p.commandDelivery.kind === "directory") {
+        dirsToCreate.push(`${p.commandDelivery.dir}/`);
+    }
+    else if (p.commandDelivery.kind === "skills") {
+        dirsToCreate.push(`${SKILLS_DIR}/`);
+    }
+    for (const dir of dirsToCreate) {
+        if (await exists(join(projectDir, dir))) {
+            if (dir === "_bmad/" ||
+                (p.commandDelivery.kind === "directory" && dir === `${p.commandDelivery.dir}/`) ||
+                (p.commandDelivery.kind === "skills" && dir === `${SKILLS_DIR}/`)) {
+                wouldModify.push(dir);
+            }
+        }
+        else {
+            wouldCreate.push(dir);
+        }
+    }
+    const filesToCheck = [
+        { path: ".ralph/PROMPT.md", isTemplate: true },
+        { path: ".ralph/@AGENT.md", isTemplate: true },
+        { path: ".ralph/.ralphrc", isTemplate: true },
+        { path: ".ralph/ralph_loop.sh", isTemplate: false },
+        { path: CONFIG_FILE, isTemplate: false },
+    ];
+    for (const file of filesToCheck) {
+        if (await exists(join(projectDir, file.path))) {
+            if (file.isTemplate) {
+                wouldModify.push(file.path);
+            }
+        }
+        else {
+            wouldCreate.push(file.path);
+        }
+    }
+    if (await exists(join(projectDir, ".gitignore"))) {
+        wouldModify.push(".gitignore");
+    }
+    else {
+        wouldCreate.push(".gitignore");
+    }
+    try {
+        const content = await readFile(join(projectDir, p.instructionsFile), "utf-8");
+        if (content.includes(p.instructionsSectionMarker)) {
+            wouldSkip.push(`${p.instructionsFile} (already integrated)`);
+        }
+        else {
+            wouldModify.push(p.instructionsFile);
+        }
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            wouldCreate.push(p.instructionsFile);
+        }
+        else {
+            throw err;
+        }
+    }
+    return { wouldCreate, wouldModify, wouldSkip };
+}
+export async function previewUpgrade(projectDir, platform) {
+    const p = platform ?? (await getDefaultPlatform());
+    const managedPaths = [
+        { path: "_bmad/", isDir: true },
+        { path: ".ralph/ralph_loop.sh", isDir: false },
+        { path: ".ralph/ralph_import.sh", isDir: false },
+        { path: ".ralph/ralph_monitor.sh", isDir: false },
+        { path: ".ralph/lib/", isDir: true },
+        { path: ".ralph/PROMPT.md", isDir: false, templateName: "PROMPT.md" },
+        { path: ".ralph/@AGENT.md", isDir: false, templateName: "AGENT.md" },
+        { path: ".ralph/.ralphrc", isDir: false, templateName: "RALPHRC" },
+        { path: ".ralph/RALPH-REFERENCE.md", isDir: false },
+        { path: ".gitignore", isDir: false },
+    ];
+    if (p.commandDelivery.kind === "directory") {
+        managedPaths.push({ path: `${p.commandDelivery.dir}/`, isDir: true });
+    }
+    else if (p.commandDelivery.kind === "skills") {
+        managedPaths.push({ path: `${SKILLS_DIR}/`, isDir: true });
+    }
+    const wouldUpdate = [];
+    const wouldCreate = [];
+    const wouldPreserve = [];
+    for (const { path: pathStr, templateName } of managedPaths) {
+        const fullPath = join(projectDir, pathStr.replace(/\/$/, ""));
+        if (await exists(fullPath)) {
+            if (templateName &&
+                (await isTemplateCustomized(fullPath, templateName, { platformId: p.id }))) {
+                wouldPreserve.push(pathStr);
+            }
+            else {
+                wouldUpdate.push(pathStr);
+            }
+        }
+        else {
+            wouldCreate.push(pathStr);
+        }
+    }
+    return { wouldUpdate, wouldCreate, wouldPreserve };
+}
+//# sourceMappingURL=project-files.js.map

package/dist/installer/project-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-files.js","sourceRoot":"","sources":["../../src/installer/project-files.ts"],"names":[],"mappings":"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"}