bmalph 2.7.4 → 2.7.6

package/dist/transition/artifact-scan.js.map

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

package/dist/transition/context-output.js

@@ -0,0 +1,85 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { debug, info, warn } from "../utils/logger.js";
+import { isEnoent, formatError } from "../utils/errors.js";
+import { atomicWriteFile, exists } from "../utils/file-system.js";
+import { readConfig } from "../utils/config.js";
+import { combineArtifactContents } from "./artifact-collection.js";
+import { extractProjectContext, generateProjectContextMd, generatePrompt, detectTruncation, } from "./context.js";
+import { detectTechStack, customizeAgentMd } from "./tech-stack.js";
+export async function generateContextOutputs(projectDir, inputs) {
+    const generatedFiles = [];
+    let projectName = "project";
+    try {
+        const config = await readConfig(projectDir);
+        if (config?.name) {
+            projectName = config.name;
+        }
+    }
+    catch (err) {
+        debug(`Could not read config for project name: ${formatError(err)}`);
+    }
+    info("Generating PROJECT_CONTEXT.md...");
+    const projectContextPath = join(projectDir, ".ralph/PROJECT_CONTEXT.md");
+    const projectContextExisted = await exists(projectContextPath);
+    let projectContext = null;
+    let truncationWarnings = [];
+    if (inputs.artifactContents.size > 0) {
+        const { context, truncated } = extractProjectContext(inputs.artifactContents);
+        projectContext = context;
+        truncationWarnings = detectTruncation(truncated);
+        const contextMd = generateProjectContextMd(projectContext, projectName);
+        await atomicWriteFile(projectContextPath, contextMd);
+        generatedFiles.push({
+            path: ".ralph/PROJECT_CONTEXT.md",
+            action: projectContextExisted ? "updated" : "created",
+        });
+        debug("Generated PROJECT_CONTEXT.md");
+    }
+    info("Generating PROMPT.md...");
+    let prompt;
+    let promptExisted = false;
+    try {
+        const existingPrompt = await readFile(join(projectDir, ".ralph/PROMPT.md"), "utf-8");
+        promptExisted = true;
+        if (existingPrompt.includes("[YOUR PROJECT NAME]")) {
+            prompt = existingPrompt.replace(/\[YOUR PROJECT NAME\]/g, projectName);
+        }
+        else {
+            prompt = generatePrompt(projectName, projectContext ?? undefined);
+        }
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            debug("No existing PROMPT.md found, generating from template");
+        }
+        else {
+            warn(`Could not read existing PROMPT.md: ${formatError(err)}`);
+        }
+        prompt = generatePrompt(projectName, projectContext ?? undefined);
+    }
+    await atomicWriteFile(join(projectDir, ".ralph/PROMPT.md"), prompt);
+    generatedFiles.push({ path: ".ralph/PROMPT.md", action: promptExisted ? "updated" : "created" });
+    const combinedArchitectureContent = combineArtifactContents(inputs.collectedArtifacts.architectureFiles, inputs.artifactContents);
+    if (combinedArchitectureContent) {
+        try {
+            const stack = detectTechStack(combinedArchitectureContent);
+            if (stack) {
+                const agentPath = join(projectDir, ".ralph/@AGENT.md");
+                const agentTemplate = await readFile(agentPath, "utf-8");
+                const customized = customizeAgentMd(agentTemplate, stack);
+                await atomicWriteFile(agentPath, customized);
+                generatedFiles.push({ path: ".ralph/@AGENT.md", action: "updated" });
+                debug("Customized @AGENT.md with detected tech stack");
+            }
+        }
+        catch (err) {
+            warn(`Could not customize @AGENT.md: ${formatError(err)}`);
+        }
+    }
+    return {
+        warnings: truncationWarnings,
+        generatedFiles,
+    };
+}
+//# sourceMappingURL=context-output.js.map

package/dist/transition/context-output.js.map

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

package/dist/transition/fix-plan-sync.js

@@ -0,0 +1,119 @@
+import { readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+import { debug, info, warn } from "../utils/logger.js";
+import { isEnoent, formatError } from "../utils/errors.js";
+import { atomicWriteFile, exists } from "../utils/file-system.js";
+import { generateFixPlan, parseFixPlan, mergeFixPlanProgress, detectOrphanedCompletedStories, detectRenumberedStories, buildCompletedTitleMap, normalizeTitle, } from "./fix-plan.js";
+import { parseSprintStatus } from "./sprint-status.js";
+export async function syncFixPlan(projectDir, inputs) {
+    let completedIds = new Set();
+    let existingItems = [];
+    let orphanWarnings = [];
+    let renumberWarnings = [];
+    const completionWarnings = [];
+    let useTitleBasedMerge = true;
+    let fixPlanPreserved = false;
+    const fixPlanPath = join(projectDir, ".ralph/@fix_plan.md");
+    const fixPlanExisted = await exists(fixPlanPath);
+    try {
+        const existingFixPlan = await readFile(fixPlanPath, "utf-8");
+        existingItems = parseFixPlan(existingFixPlan);
+        debug(`Found ${existingItems.filter((item) => item.completed).length} completed stories in existing fix_plan`);
+    }
+    catch (err) {
+        if (isEnoent(err)) {
+            debug("No existing fix_plan found, starting fresh");
+        }
+        else {
+            warn(`Could not read existing fix_plan: ${formatError(err)}`);
+        }
+    }
+    const sprintStatusSource = await resolveSprintStatusSource(projectDir, inputs);
+    if (sprintStatusSource) {
+        useTitleBasedMerge = false;
+        if (sprintStatusSource.readError) {
+            completionWarnings.push(`Sprint status file "${sprintStatusSource.displayPath}" could not be read: ${sprintStatusSource.readError}. All stories were left unchecked.`);
+        }
+        else if (!sprintStatusSource.content) {
+            completionWarnings.push(`Sprint status file "${sprintStatusSource.displayPath}" could not be read. All stories were left unchecked.`);
+        }
+        else {
+            const sprintStatus = parseSprintStatus(sprintStatusSource.content);
+            completionWarnings.push(...sprintStatus.warnings);
+            if (sprintStatus.valid) {
+                completedIds = new Set(inputs.stories
+                    .filter((story) => sprintStatus.storyStatusById.get(story.id) === "done")
+                    .map((story) => story.id));
+                fixPlanPreserved = completedIds.size > 0;
+                for (const story of inputs.stories) {
+                    if (!sprintStatus.storyStatusById.has(story.id)) {
+                        completionWarnings.push(`Sprint status is missing story ${story.id} (${story.title}); leaving it unchecked.`);
+                    }
+                }
+            }
+        }
+    }
+    else {
+        completedIds = new Set(existingItems.filter((item) => item.completed).map((item) => item.id));
+        fixPlanPreserved = completedIds.size > 0;
+        const newStoryIds = new Set(inputs.stories.map((story) => story.id));
+        orphanWarnings = detectOrphanedCompletedStories(existingItems, newStoryIds);
+        const completedTitles = buildCompletedTitleMap(existingItems);
+        const newTitleMap = new Map(inputs.stories.map((story) => [story.id, story.title]));
+        const preservedIds = new Set();
+        for (const [id, title] of newTitleMap) {
+            if (!completedIds.has(id) && completedTitles.has(normalizeTitle(title))) {
+                preservedIds.add(id);
+            }
+        }
+        renumberWarnings = detectRenumberedStories(existingItems, inputs.stories, preservedIds);
+    }
+    const completedTitles = buildCompletedTitleMap(existingItems);
+    const newTitleMap = new Map(inputs.stories.map((story) => [story.id, story.title]));
+    info(`Generating fix plan for ${inputs.stories.length} stories...`);
+    const newFixPlan = generateFixPlan(inputs.stories, undefined, inputs.planningSpecsSubpath);
+    const mergedFixPlan = mergeFixPlanProgress(newFixPlan, completedIds, useTitleBasedMerge ? newTitleMap : undefined, useTitleBasedMerge ? completedTitles : undefined);
+    await atomicWriteFile(fixPlanPath, mergedFixPlan);
+    return {
+        warnings: [...completionWarnings, ...orphanWarnings, ...renumberWarnings],
+        fixPlanPreserved,
+        generatedFile: {
+            path: ".ralph/@fix_plan.md",
+            action: fixPlanExisted ? "updated" : "created",
+        },
+    };
+}
+async function resolveSprintStatusSource(projectDir, inputs) {
+    const canonicalCandidates = [
+        "_bmad-output/implementation-artifacts/sprint-status.yaml",
+        "_bmad-output/implementation_artifacts/sprint-status.yaml",
+    ];
+    for (const candidate of canonicalCandidates) {
+        const candidatePath = join(projectDir, candidate);
+        if (!(await exists(candidatePath))) {
+            continue;
+        }
+        try {
+            return {
+                displayPath: candidate,
+                content: await readFile(candidatePath, "utf-8"),
+            };
+        }
+        catch (err) {
+            return {
+                displayPath: candidate,
+                content: null,
+                readError: formatError(err),
+            };
+        }
+    }
+    if (!inputs.collectedArtifacts.sprintStatusFile) {
+        return null;
+    }
+    const artifactsRelativeDir = relative(projectDir, inputs.artifactsDir).replace(/\\/g, "/");
+    return {
+        displayPath: `${artifactsRelativeDir}/${inputs.collectedArtifacts.sprintStatusFile}`,
+        content: inputs.artifactContents.get(inputs.collectedArtifacts.sprintStatusFile) ?? null,
+    };
+}
+//# sourceMappingURL=fix-plan-sync.js.map

package/dist/transition/fix-plan-sync.js.map

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

package/dist/transition/orchestration.js

@@ -1,372 +1,35 @@
-import { readFile, rm, rename } from "node:fs/promises";
-import { join, relative } from "node:path";
-import { debug, info, warn } from "../utils/logger.js";
-import { isEnoent, formatError } from "../utils/errors.js";
-import { atomicWriteFile, exists, getFilesRecursive } from "../utils/file-system.js";
-import { readConfig } from "../utils/config.js";
+import { join } from "node:path";
+import { info } from "../utils/logger.js";
 import { readState, writeState } from "../utils/state.js";
-import { parseStoriesWithWarnings } from "./story-parsing.js";
-import { generateFixPlan, parseFixPlan, mergeFixPlanProgress, detectOrphanedCompletedStories, detectRenumberedStories, buildCompletedTitleMap, normalizeTitle, } from "./fix-plan.js";
-import { detectTechStack, customizeAgentMd } from "./tech-stack.js";
-import { findArtifactsDir, resolvePlanningSpecsSubpath } from "./artifacts.js";
-import { runPreflight, PreflightValidationError } from "./preflight.js";
-import { collectTransitionArtifacts, combineArtifactContents } from "./artifact-collection.js";
-import { compareStoryIds } from "./story-id.js";
-import { extractProjectContext, generateProjectContextMd, generatePrompt, detectTruncation, } from "./context.js";
-import { generateSpecsChangelog, formatChangelog } from "./specs-changelog.js";
-import { generateSpecsIndex, formatSpecsIndexMd } from "./specs-index.js";
-import { parseSprintStatus } from "./sprint-status.js";
-import { prepareSpecsDirectory } from "./specs-sync.js";
-async function swapSpecsDirectory(specsDir, specsTmpDir) {
-    const specsOldDir = `${specsDir}.old`;
-    let hasBackup = false;
-    if (await exists(specsDir)) {
-        await rm(specsOldDir, { recursive: true, force: true });
-        await rename(specsDir, specsOldDir);
-        hasBackup = true;
-    }
-    else if (await exists(specsOldDir)) {
-        hasBackup = true;
-        debug("Found existing .ralph/specs.old from previous failed transition, preserving backup");
-    }
-    else {
-        debug("No existing .ralph/specs to preserve (first transition)");
-    }
-    try {
-        await rename(specsTmpDir, specsDir);
-    }
-    catch (err) {
-        if (hasBackup) {
-            debug(`Specs swap failed, restoring original: ${formatError(err)}`);
-            try {
-                await rename(specsOldDir, specsDir);
-            }
-            catch (restoreErr) {
-                if (!isEnoent(restoreErr)) {
-                    debug(`Could not restore .ralph/specs.old: ${formatError(restoreErr)}`);
-                }
-            }
-        }
-        throw err;
-    }
-    if (hasBackup) {
-        await rm(specsOldDir, { recursive: true, force: true });
-    }
-}
-function ensureUniqueStoryIds(stories) {
-    const sourceById = new Map();
-    for (const story of stories) {
-        const existingSource = sourceById.get(story.id);
-        if (existingSource) {
-            throw new Error(`Duplicate story ID "${story.id}" found in ${existingSource} and ${story.sourceFile}`);
-        }
-        sourceById.set(story.id, story.sourceFile);
-    }
-}
-async function resolveSprintStatusSource(projectDir, artifactsDir, collectedArtifacts, artifactContents) {
-    const canonicalCandidates = [
-        "_bmad-output/implementation-artifacts/sprint-status.yaml",
-        "_bmad-output/implementation_artifacts/sprint-status.yaml",
-    ];
-    for (const candidate of canonicalCandidates) {
-        const candidatePath = join(projectDir, candidate);
-        if (!(await exists(candidatePath))) {
-            continue;
-        }
-        try {
-            return {
-                displayPath: candidate,
-                content: await readFile(candidatePath, "utf-8"),
-            };
-        }
-        catch (err) {
-            return {
-                displayPath: candidate,
-                content: null,
-                readError: formatError(err),
-            };
-        }
-    }
-    if (!collectedArtifacts.sprintStatusFile) {
-        return null;
-    }
-    const artifactsRelativeDir = relative(projectDir, artifactsDir).replace(/\\/g, "/");
-    return {
-        displayPath: `${artifactsRelativeDir}/${collectedArtifacts.sprintStatusFile}`,
-        content: artifactContents.get(collectedArtifacts.sprintStatusFile) ?? null,
-    };
-}
+import { loadTransitionInputs } from "./artifact-loading.js";
+import { generateContextOutputs } from "./context-output.js";
+import { syncFixPlan } from "./fix-plan-sync.js";
+import { prepareSpecsDirectory, syncPreparedSpecsDirectory } from "./specs-sync.js";
 export async function runTransition(projectDir, options) {
-    info("Locating BMAD artifacts...");
-    const artifactsDir = await findArtifactsDir(projectDir);
-    if (!artifactsDir) {
-        throw new Error("No BMAD artifacts found. Run BMAD planning phases first (at minimum: Create PRD, Create Architecture, Create Epics and Stories).");
-    }
-    const files = await getFilesRecursive(artifactsDir);
-    const collectedArtifacts = collectTransitionArtifacts(files);
-    // Read artifact contents early for preflight validation and later use
-    const artifactContents = new Map();
-    for (const file of collectedArtifacts.files) {
-        if (!/\.(?:md|ya?ml)$/i.test(file)) {
-            continue;
-        }
-        try {
-            const content = await readFile(join(artifactsDir, file), "utf-8");
-            artifactContents.set(file, content);
-        }
-        catch (err) {
-            warn(`Could not read artifact ${file}: ${formatError(err)}`);
-        }
-    }
-    if (collectedArtifacts.storyFiles.length === 0) {
-        debug(`Files in artifacts dir: ${collectedArtifacts.files.join(", ")}`);
-        throw new Error(`No epics/stories file found in ${artifactsDir}. Available files: ${collectedArtifacts.files.join(", ")}. Run 'CE' (Create Epics and Stories) first.`);
-    }
-    debug(`Using stories files: ${collectedArtifacts.storyFiles.join(", ")}`);
-    info("Parsing stories...");
-    const stories = [];
-    const parseWarnings = [];
-    for (const storyFile of collectedArtifacts.storyFiles) {
-        const storiesContent = artifactContents.get(storyFile);
-        if (!storiesContent) {
-            warn(`Could not read stories artifact ${storyFile}`);
-            continue;
-        }
-        const parsedStories = parseStoriesWithWarnings(storiesContent, storyFile);
-        stories.push(...parsedStories.stories);
-        parseWarnings.push(...parsedStories.warnings);
-    }
-    ensureUniqueStoryIds(stories);
-    stories.sort((left, right) => compareStoryIds(left.id, right.id) ||
-        left.sourceFile.localeCompare(right.sourceFile) ||
-        left.title.localeCompare(right.title));
-    if (stories.length === 0) {
-        throw new Error("No stories parsed from the epics files. Ensure stories follow the format: ### Story N.M: Title");
-    }
-    // Pre-flight validation
-    info("Pre-flight validation...");
-    const preflightResult = runPreflight(artifactContents, collectedArtifacts.files, stories, parseWarnings);
-    const preflightIssues = options?.force
-        ? preflightResult.issues.map((issue) => issue.severity === "error" ? { ...issue, severity: "warning" } : issue)
-        : preflightResult.issues;
-    if (!preflightResult.pass) {
-        if (options?.force) {
-            warn("Pre-flight validation has errors but --force was used, continuing...");
-        }
-        else {
-            throw new PreflightValidationError(preflightResult.issues);
-        }
-    }
-    // Track generated files for summary output
+    const inputs = await loadTransitionInputs(projectDir, options);
     const generatedFiles = [];
-    // Check existing fix_plan for completed items (smart merge)
-    let completedIds = new Set();
-    let existingItems = [];
-    let orphanWarnings = [];
-    let renumberWarnings = [];
-    const completionWarnings = [];
-    let useTitleBasedMerge = true;
-    let fixPlanPreserved = false;
-    const fixPlanPath = join(projectDir, ".ralph/@fix_plan.md");
-    const fixPlanExisted = await exists(fixPlanPath);
-    try {
-        const existingFixPlan = await readFile(fixPlanPath, "utf-8");
-        existingItems = parseFixPlan(existingFixPlan);
-        debug(`Found ${existingItems.filter((item) => item.completed).length} completed stories in existing fix_plan`);
-    }
-    catch (err) {
-        if (isEnoent(err)) {
-            debug("No existing fix_plan found, starting fresh");
-        }
-        else {
-            warn(`Could not read existing fix_plan: ${formatError(err)}`);
-        }
-    }
-    const sprintStatusSource = await resolveSprintStatusSource(projectDir, artifactsDir, collectedArtifacts, artifactContents);
-    if (sprintStatusSource) {
-        useTitleBasedMerge = false;
-        if (sprintStatusSource.readError) {
-            completionWarnings.push(`Sprint status file "${sprintStatusSource.displayPath}" could not be read: ${sprintStatusSource.readError}. All stories were left unchecked.`);
-        }
-        else if (!sprintStatusSource.content) {
-            completionWarnings.push(`Sprint status file "${sprintStatusSource.displayPath}" could not be read. All stories were left unchecked.`);
-        }
-        else {
-            const sprintStatus = parseSprintStatus(sprintStatusSource.content);
-            completionWarnings.push(...sprintStatus.warnings);
-            if (sprintStatus.valid) {
-                completedIds = new Set(stories
-                    .filter((story) => sprintStatus.storyStatusById.get(story.id) === "done")
-                    .map((story) => story.id));
-                fixPlanPreserved = completedIds.size > 0;
-                for (const story of stories) {
-                    if (!sprintStatus.storyStatusById.has(story.id)) {
-                        completionWarnings.push(`Sprint status is missing story ${story.id} (${story.title}); leaving it unchecked.`);
-                    }
-                }
-            }
-        }
-    }
-    else {
-        completedIds = new Set(existingItems.filter((item) => item.completed).map((item) => item.id));
-        fixPlanPreserved = completedIds.size > 0;
-        // Detect orphaned completed stories (Bug #2)
-        const newStoryIds = new Set(stories.map((story) => story.id));
-        orphanWarnings = detectOrphanedCompletedStories(existingItems, newStoryIds);
-        // Build title maps for title-based merge (Gap 3: renumbered story preservation)
-        const completedTitles = buildCompletedTitleMap(existingItems);
-        const newTitleMap = new Map(stories.map((story) => [story.id, story.title]));
-        // Detect which stories were preserved via title match (for renumber warning suppression)
-        const preservedIds = new Set();
-        for (const [id, title] of newTitleMap) {
-            if (!completedIds.has(id) && completedTitles.has(normalizeTitle(title))) {
-                preservedIds.add(id);
-            }
-        }
-        // Detect renumbered stories (Bug #3), skipping auto-preserved ones
-        renumberWarnings = detectRenumberedStories(existingItems, stories, preservedIds);
-    }
-    const completedTitles = buildCompletedTitleMap(existingItems);
-    const newTitleMap = new Map(stories.map((story) => [story.id, story.title]));
-    // Generate new fix_plan from current stories, preserving completion status
-    info(`Generating fix plan for ${stories.length} stories...`);
-    const planningSpecsSubpath = resolvePlanningSpecsSubpath(projectDir, artifactsDir);
-    const newFixPlan = generateFixPlan(stories, undefined, planningSpecsSubpath);
-    const mergedFixPlan = mergeFixPlanProgress(newFixPlan, completedIds, useTitleBasedMerge ? newTitleMap : undefined, useTitleBasedMerge ? completedTitles : undefined);
-    await atomicWriteFile(fixPlanPath, mergedFixPlan);
-    generatedFiles.push({
-        path: ".ralph/@fix_plan.md",
-        action: fixPlanExisted ? "updated" : "created",
-    });
+    const fixPlanSync = await syncFixPlan(projectDir, inputs);
+    generatedFiles.push(fixPlanSync.generatedFile);
     const specsDir = join(projectDir, ".ralph/specs");
     const specsTmpDir = join(projectDir, ".ralph/specs.new");
     info("Preparing specs tree...");
-    await prepareSpecsDirectory(projectDir, artifactsDir, collectedArtifacts.files, specsTmpDir);
-    try {
-        const changes = await generateSpecsChangelog(specsDir, specsTmpDir);
-        if (changes.length > 0) {
-            const changelog = formatChangelog(changes, new Date().toISOString());
-            await atomicWriteFile(join(projectDir, ".ralph/SPECS_CHANGELOG.md"), changelog);
-            generatedFiles.push({ path: ".ralph/SPECS_CHANGELOG.md", action: "updated" });
-            debug(`Generated SPECS_CHANGELOG.md with ${changes.length} changes`);
-        }
-    }
-    catch (err) {
-        warn(`Could not generate SPECS_CHANGELOG.md: ${formatError(err)}`);
-    }
-    info("Copying specs to .ralph/specs/...");
-    await swapSpecsDirectory(specsDir, specsTmpDir);
-    generatedFiles.push({ path: ".ralph/specs/", action: "updated" });
-    // Generate SPECS_INDEX.md for intelligent spec reading
-    info("Generating SPECS_INDEX.md...");
-    const specsIndexPath = join(projectDir, ".ralph/SPECS_INDEX.md");
-    const specsIndexExisted = await exists(specsIndexPath);
-    try {
-        const specsIndex = await generateSpecsIndex(specsDir);
-        if (specsIndex.totalFiles > 0) {
-            await atomicWriteFile(specsIndexPath, formatSpecsIndexMd(specsIndex));
-            generatedFiles.push({
-                path: ".ralph/SPECS_INDEX.md",
-                action: specsIndexExisted ? "updated" : "created",
-            });
-            debug(`Generated SPECS_INDEX.md with ${specsIndex.totalFiles} files`);
-        }
-    }
-    catch (err) {
-        warn(`Could not generate SPECS_INDEX.md: ${formatError(err)}`);
-    }
-    // Generate PROJECT_CONTEXT.md from planning artifacts
-    let projectName = "project";
-    try {
-        const config = await readConfig(projectDir);
-        if (config?.name) {
-            projectName = config.name;
-        }
-    }
-    catch (err) {
-        debug(`Could not read config for project name: ${formatError(err)}`);
-    }
-    // Extract project context for both PROJECT_CONTEXT.md and PROMPT.md
-    info("Generating PROJECT_CONTEXT.md...");
-    const projectContextPath = join(projectDir, ".ralph/PROJECT_CONTEXT.md");
-    const projectContextExisted = await exists(projectContextPath);
-    let projectContext = null;
-    let truncationWarnings = [];
-    if (artifactContents.size > 0) {
-        const { context, truncated } = extractProjectContext(artifactContents);
-        projectContext = context;
-        truncationWarnings = detectTruncation(truncated);
-        const contextMd = generateProjectContextMd(projectContext, projectName);
-        await atomicWriteFile(projectContextPath, contextMd);
-        generatedFiles.push({
-            path: ".ralph/PROJECT_CONTEXT.md",
-            action: projectContextExisted ? "updated" : "created",
-        });
-        debug("Generated PROJECT_CONTEXT.md");
-    }
-    // Generate PROMPT.md with embedded context
-    info("Generating PROMPT.md...");
-    // Try to preserve rich PROMPT.md template if it has the placeholder
-    let prompt;
-    let promptExisted = false;
-    try {
-        const existingPrompt = await readFile(join(projectDir, ".ralph/PROMPT.md"), "utf-8");
-        promptExisted = true;
-        if (existingPrompt.includes("[YOUR PROJECT NAME]")) {
-            prompt = existingPrompt.replace(/\[YOUR PROJECT NAME\]/g, projectName);
-        }
-        else {
-            // Pass context to embed critical specs directly in PROMPT.md
-            prompt = generatePrompt(projectName, projectContext ?? undefined);
-        }
-    }
-    catch (err) {
-        if (isEnoent(err)) {
-            debug("No existing PROMPT.md found, generating from template");
-        }
-        else {
-            warn(`Could not read existing PROMPT.md: ${formatError(err)}`);
-        }
-        prompt = generatePrompt(projectName, projectContext ?? undefined);
-    }
-    await atomicWriteFile(join(projectDir, ".ralph/PROMPT.md"), prompt);
-    generatedFiles.push({ path: ".ralph/PROMPT.md", action: promptExisted ? "updated" : "created" });
-    // Customize @AGENT.md based on detected tech stack from architecture
-    const combinedArchitectureContent = combineArtifactContents(collectedArtifacts.architectureFiles, artifactContents);
-    if (combinedArchitectureContent) {
-        try {
-            const stack = detectTechStack(combinedArchitectureContent);
-            if (stack) {
-                const agentPath = join(projectDir, ".ralph/@AGENT.md");
-                const agentTemplate = await readFile(agentPath, "utf-8");
-                const customized = customizeAgentMd(agentTemplate, stack);
-                await atomicWriteFile(agentPath, customized);
-                generatedFiles.push({ path: ".ralph/@AGENT.md", action: "updated" });
-                debug("Customized @AGENT.md with detected tech stack");
-            }
-        }
-        catch (err) {
-            warn(`Could not customize @AGENT.md: ${formatError(err)}`);
-        }
-    }
-    // Collect warnings from all sources
-    const preflightWarnings = preflightIssues
-        .filter((i) => i.severity === "warning")
-        .map((i) => i.message);
-    // Keep parse warnings not already covered by preflight.
-    const nonPreflightParseWarnings = parseWarnings.filter((w) => !/malformed story id/i.test(w) &&
-        !/has no acceptance criteria/i.test(w) &&
-        !/has no description/i.test(w) &&
-        !/not under an epic/i.test(w));
+    await prepareSpecsDirectory(projectDir, inputs.artifactsDir, inputs.collectedArtifacts.files, specsTmpDir);
+    generatedFiles.push(...(await syncPreparedSpecsDirectory(projectDir, specsDir, specsTmpDir)));
+    const contextOutput = await generateContextOutputs(projectDir, inputs);
+    generatedFiles.push(...contextOutput.generatedFiles);
+    const preflightWarnings = inputs.preflightIssues
+        .filter((issue) => issue.severity === "warning")
+        .map((issue) => issue.message);
+    const nonPreflightParseWarnings = inputs.parseWarnings.filter((warning) => !/malformed story id/i.test(warning) &&
+        !/has no acceptance criteria/i.test(warning) &&
+        !/has no description/i.test(warning) &&
+        !/not under an epic/i.test(warning));
     const warnings = [
         ...preflightWarnings,
         ...nonPreflightParseWarnings,
-        ...completionWarnings,
-        ...orphanWarnings,
-        ...renumberWarnings,
-        ...truncationWarnings,
+        ...fixPlanSync.warnings,
+        ...contextOutput.warnings,
     ];
-    // Update phase state to 4 (Implementation) - Bug #1
     const now = new Date().toISOString();
     const currentState = await readState(projectDir);
     const newState = {
@@ -378,10 +41,10 @@ export async function runTransition(projectDir, options) {
     await writeState(projectDir, newState);
     info("Transition complete: phase 4 (implementing)");
     return {
-        storiesCount: stories.length,
+        storiesCount: inputs.stories.length,
         warnings,
-        fixPlanPreserved,
-        preflightIssues,
+        fixPlanPreserved: fixPlanSync.fixPlanPreserved,
+        preflightIssues: inputs.preflightIssues,
         generatedFiles,
     };
 }