codeharness 0.25.5 → 0.25.6

package/dist/index.js

@@ -51,7 +51,7 @@ import {
   validateDockerfile,
   warn,
   writeState
-} from "./chunk-ZFM7IU3A.js";
+} from "./chunk-6RL5EK57.js";
 
 // src/index.ts
 import { Command } from "commander";
@@ -169,600 +169,254 @@ function registerBridgeCommand(program) {
 }
 
 // src/commands/run.ts
-import { existsSync as existsSync11, mkdirSync as mkdirSync2, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
-import { join as join8, dirname as dirname3 } from "path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync2, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "fs";
+import { join as join6, dirname as dirname3 } from "path";
 import { StringDecoder as StringDecoder2 } from "string_decoder";
 
-// src/lib/sync/story-files.ts
-import { existsSync as existsSync2, readFileSync, writeFileSync } from "fs";
-var BEADS_TO_STORY_STATUS = {
-  open: "in-progress",
-  closed: "done"
-};
-var STORY_TO_BEADS_STATUS = {
-  backlog: "open",
-  "ready-for-dev": "open",
-  "in-progress": "open",
-  review: "open",
-  done: "closed"
+// src/modules/sprint/state.ts
+import { readFileSync as readFileSync2, writeFileSync, renameSync, existsSync as existsSync3, unlinkSync } from "fs";
+import { join as join2, dirname } from "path";
+
+// src/modules/sprint/migration.ts
+import { readFileSync, existsSync as existsSync2 } from "fs";
+import { join } from "path";
+var OLD_FILES = {
+  storyRetries: "ralph/.story_retries",
+  flaggedStories: "ralph/.flagged_stories",
+  ralphStatus: "ralph/status.json",
+  sprintStatusYaml: "_bmad-output/implementation-artifacts/sprint-status.yaml",
+  sessionIssues: "_bmad-output/implementation-artifacts/.session-issues.md"
 };
-function beadsStatusToStoryStatus(beadsStatus) {
-  return BEADS_TO_STORY_STATUS[beadsStatus] ?? null;
-}
-function storyStatusToBeadsStatus(storyStatus) {
-  return STORY_TO_BEADS_STATUS[storyStatus] ?? null;
-}
-function storyKeyFromPath(filePath) {
-  const base = filePath.split("/").pop() ?? filePath;
-  return base.replace(/\.md$/, "");
+function resolve(relative3) {
+  return join(process.cwd(), relative3);
 }
-function resolveStoryFilePath(beadsIssue) {
-  const desc = beadsIssue.description;
-  if (!desc || !desc.trim()) {
-    return null;
-  }
-  const trimmed = desc.trim();
-  if (!trimmed.endsWith(".md")) {
+function readIfExists(relative3) {
+  const p = resolve(relative3);
+  if (!existsSync2(p)) return null;
+  try {
+    return readFileSync(p, "utf-8");
+  } catch {
     return null;
   }
-  return trimmed;
 }
-function readStoryFileStatus(filePath) {
-  if (!existsSync2(filePath)) {
-    return null;
-  }
-  const content = readFileSync(filePath, "utf-8");
-  const match = content.match(/^#{0,2}\s*Status:\s*(.+)$/m);
-  if (!match) {
-    return null;
-  }
-  return match[1].trim();
+function emptyStory() {
+  return {
+    status: "backlog",
+    attempts: 0,
+    lastAttempt: null,
+    lastError: null,
+    proofPath: null,
+    acResults: null
+  };
 }
-function updateStoryFileStatus(filePath, newStatus) {
-  const content = readFileSync(filePath, "utf-8");
-  const statusRegex = /^(#{0,2}\s*)Status:\s*.+$/m;
-  if (statusRegex.test(content)) {
-    const updated = content.replace(statusRegex, `$1Status: ${newStatus}`);
-    writeFileSync(filePath, updated, "utf-8");
-  } else {
-    const lines = content.split("\n");
-    const titleIndex = lines.findIndex((l) => l.startsWith("# "));
-    if (titleIndex !== -1) {
-      lines.splice(titleIndex + 1, 0, "", `Status: ${newStatus}`);
-    } else {
-      lines.unshift(`Status: ${newStatus}`, "");
-    }
-    writeFileSync(filePath, lines.join("\n"), "utf-8");
+function upsertStory(stories, key, patch) {
+  stories[key] = { ...stories[key] ?? emptyStory(), ...patch };
+}
+function parseStoryRetries(content, stories) {
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    const parts = trimmed.split(/\s+/);
+    if (parts.length < 2) continue;
+    const count = parseInt(parts[1], 10);
+    if (!isNaN(count)) upsertStory(stories, parts[0], { attempts: count });
   }
 }
-
-// src/lib/sync/sprint-yaml.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
-import { join } from "path";
-import { parse } from "yaml";
-var SPRINT_STATUS_PATH = "_bmad-output/implementation-artifacts/sprint-status.yaml";
-function readSprintStatus(dir) {
-  const root = dir ?? process.cwd();
-  const filePath = join(root, SPRINT_STATUS_PATH);
-  if (!existsSync3(filePath)) {
-    return {};
+function parseStoryRetriesRecord(content) {
+  const result = {};
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    const parts = trimmed.split(/\s+/);
+    if (parts.length < 2) continue;
+    const count = parseInt(parts[1], 10);
+    if (!isNaN(count) && count >= 0) result[parts[0]] = count;
   }
-  try {
-    const content = readFileSync2(filePath, "utf-8");
-    const parsed = parse(content);
-    if (!parsed || typeof parsed !== "object") {
-      return {};
-    }
-    const devStatus = parsed.development_status;
-    if (!devStatus || typeof devStatus !== "object") {
-      return {};
+  return result;
+}
+function parseFlaggedStoriesList(content) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed !== "" && !seen.has(trimmed)) {
+      seen.add(trimmed);
+      result.push(trimmed);
     }
-    return devStatus;
-  } catch {
-    return {};
   }
+  return result;
 }
-function updateSprintStatus(storyKey, newStatus, dir) {
-  const root = dir ?? process.cwd();
-  const filePath = join(root, SPRINT_STATUS_PATH);
-  if (!existsSync3(filePath)) {
-    warn(`sprint-status.yaml not found at ${filePath}, skipping update`);
-    return;
-  }
-  const content = readFileSync2(filePath, "utf-8");
-  const keyPattern = new RegExp(`^(\\s*${escapeRegExp(storyKey)}:\\s*)\\S+(.*)$`, "m");
-  if (!keyPattern.test(content)) {
-    return;
+function parseFlaggedStories(content, stories) {
+  for (const line of content.split("\n")) {
+    const key = line.trim();
+    if (key) upsertStory(stories, key, { status: "blocked" });
   }
-  const updated = content.replace(keyPattern, `$1${newStatus}$2`);
-  writeFileSync2(filePath, updated, "utf-8");
 }
-function escapeRegExp(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+function mapYamlStatus(value) {
+  const mapping = {
+    done: "done",
+    backlog: "backlog",
+    verifying: "verifying",
+    "in-progress": "in-progress",
+    "ready-for-dev": "ready",
+    blocked: "blocked",
+    failed: "failed",
+    review: "review",
+    ready: "ready"
+  };
+  return mapping[value.trim().toLowerCase()] ?? null;
 }
-
-// src/lib/sync/beads.ts
-import { existsSync as existsSync4 } from "fs";
-import { join as join2 } from "path";
-function syncBeadsToStoryFile(beadsId, beadsFns, dir) {
-  const root = dir ?? process.cwd();
-  const issues = beadsFns.listIssues();
-  const issue = issues.find((i) => i.id === beadsId);
-  if (!issue) {
-    return {
-      storyKey: "",
-      beadsId,
-      previousStatus: "",
-      newStatus: "",
-      synced: false,
-      error: `Beads issue not found: ${beadsId}`
-    };
-  }
-  const storyFilePath = resolveStoryFilePath(issue);
-  if (!storyFilePath) {
-    return {
-      storyKey: "",
-      beadsId,
-      previousStatus: issue.status,
-      newStatus: "",
-      synced: false,
-      error: `No story file path in beads issue description: ${beadsId}`
-    };
-  }
-  const storyKey = storyKeyFromPath(storyFilePath);
-  const fullPath = join2(root, storyFilePath);
-  const currentStoryStatus = readStoryFileStatus(fullPath);
-  if (currentStoryStatus === null) {
-    return {
-      storyKey,
-      beadsId,
-      previousStatus: issue.status,
-      newStatus: "",
-      synced: false,
-      error: `Story file not found or has no Status line: ${storyFilePath}`
-    };
-  }
-  const targetStoryStatus = beadsStatusToStoryStatus(issue.status);
-  if (!targetStoryStatus) {
-    return {
-      storyKey,
-      beadsId,
-      previousStatus: currentStoryStatus,
-      newStatus: "",
-      synced: false,
-      error: `Unknown beads status: ${issue.status}`
-    };
+function parseSprintStatusYaml(content, stories) {
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const match = trimmed.match(/^([a-zA-Z0-9_-]+):\s*(.+)$/);
+    if (!match) continue;
+    const key = match[1];
+    if (key === "development_status" || key.startsWith("epic-")) continue;
+    const status = mapYamlStatus(match[2]);
+    if (status) upsertStory(stories, key, { status });
   }
-  if (currentStoryStatus === targetStoryStatus) {
+}
+function parseRalphStatus(content) {
+  try {
+    const data = JSON.parse(content);
     return {
-      storyKey,
-      beadsId,
-      previousStatus: currentStoryStatus,
-      newStatus: currentStoryStatus,
-      synced: false
+      active: data.status === "running",
+      startedAt: null,
+      iteration: data.loop_count ?? 0,
+      cost: 0,
+      completed: [],
+      failed: [],
+      currentStory: null,
+      currentPhase: null,
+      lastAction: null,
+      acProgress: null
     };
+  } catch {
+    return null;
   }
-  updateStoryFileStatus(fullPath, targetStoryStatus);
-  updateSprintStatus(storyKey, targetStoryStatus, root);
-  return {
-    storyKey,
-    beadsId,
-    previousStatus: currentStoryStatus,
-    newStatus: targetStoryStatus,
-    synced: true
-  };
 }
-function syncStoryFileToBeads(storyKey, beadsFns, dir) {
-  const root = dir ?? process.cwd();
-  const storyFilePath = `_bmad-output/implementation-artifacts/${storyKey}.md`;
-  const fullPath = join2(root, storyFilePath);
-  const currentStoryStatus = readStoryFileStatus(fullPath);
-  if (currentStoryStatus === null) {
+function parseRalphStatusToSession(content) {
+  try {
+    const data = JSON.parse(content);
     return {
-      storyKey,
-      beadsId: "",
-      previousStatus: "",
-      newStatus: "",
-      synced: false,
-      error: `Story file not found or has no Status line: ${storyFilePath}`
+      active: data.status === "running",
+      startedAt: null,
+      iteration: data.loop_count ?? 0,
+      elapsedSeconds: data.elapsed_seconds ?? 0
     };
+  } catch {
+    return null;
   }
-  const issues = beadsFns.listIssues();
-  const issue = issues.find((i) => {
-    const path = resolveStoryFilePath(i);
-    if (!path) return false;
-    return storyKeyFromPath(path) === storyKey;
-  });
-  if (!issue) {
-    return {
-      storyKey,
-      beadsId: "",
-      previousStatus: currentStoryStatus,
-      newStatus: "",
-      synced: false,
-      error: `No beads issue found for story: ${storyKey}`
-    };
-  }
-  const targetBeadsStatus = storyStatusToBeadsStatus(currentStoryStatus);
-  if (!targetBeadsStatus) {
-    return {
-      storyKey,
-      beadsId: issue.id,
-      previousStatus: currentStoryStatus,
-      newStatus: "",
-      synced: false,
-      error: `Unknown story status: ${currentStoryStatus}`
-    };
-  }
-  if (issue.status === targetBeadsStatus) {
-    return {
-      storyKey,
-      beadsId: issue.id,
-      previousStatus: currentStoryStatus,
-      newStatus: currentStoryStatus,
-      synced: false
-    };
-  }
-  if (targetBeadsStatus === "closed") {
-    beadsFns.closeIssue(issue.id);
-  } else {
-    beadsFns.updateIssue(issue.id, { status: targetBeadsStatus });
-  }
-  updateSprintStatus(storyKey, currentStoryStatus, root);
-  return {
-    storyKey,
-    beadsId: issue.id,
-    previousStatus: issue.status,
-    newStatus: targetBeadsStatus,
-    synced: true
-  };
 }
-function syncClose(beadsId, beadsFns, dir) {
-  const root = dir ?? process.cwd();
-  const issues = beadsFns.listIssues();
-  const issue = issues.find((i) => i.id === beadsId);
-  beadsFns.closeIssue(beadsId);
-  if (!issue) {
-    return {
-      storyKey: "",
-      beadsId,
-      previousStatus: "",
-      newStatus: "closed",
-      synced: false,
-      error: `Beads issue not found: ${beadsId}`
-    };
-  }
-  const storyFilePath = resolveStoryFilePath(issue);
-  if (!storyFilePath) {
-    return {
-      storyKey: "",
-      beadsId,
-      previousStatus: issue.status,
-      newStatus: "closed",
-      synced: false,
-      error: `No story file path in beads issue description: ${beadsId}`
-    };
-  }
-  const storyKey = storyKeyFromPath(storyFilePath);
-  const fullPath = join2(root, storyFilePath);
-  const previousStatus = readStoryFileStatus(fullPath);
-  if (previousStatus === null) {
-    if (!existsSync4(fullPath)) {
-      return {
-        storyKey,
-        beadsId,
-        previousStatus: "",
-        newStatus: "closed",
-        synced: false,
-        error: `Story file not found: ${storyFilePath}`
-      };
+function parseSessionIssues(content) {
+  const items = [];
+  let currentStory = "";
+  let itemId = 0;
+  for (const line of content.split("\n")) {
+    const headerMatch = line.match(/^###\s+([a-zA-Z0-9_-]+)\s*[—-]/);
+    if (headerMatch) {
+      currentStory = headerMatch[1];
+      continue;
+    }
+    const bulletMatch = line.match(/^-\s+(.+)/);
+    if (bulletMatch && currentStory) {
+      itemId++;
+      items.push({
+        id: `migrated-${itemId}`,
+        story: currentStory,
+        description: bulletMatch[1],
+        source: "retro",
+        resolved: false
+      });
     }
   }
-  updateStoryFileStatus(fullPath, "done");
-  updateSprintStatus(storyKey, "done", root);
+  return items;
+}
+function migrateV1ToV2(v1) {
+  const defaults = defaultState();
+  const retriesContent = readIfExists(OLD_FILES.storyRetries);
+  const retries = retriesContent ? parseStoryRetriesRecord(retriesContent) : {};
+  const flaggedContent = readIfExists(OLD_FILES.flaggedStories);
+  const flagged = flaggedContent ? parseFlaggedStoriesList(flaggedContent) : [];
+  const statusContent = readIfExists(OLD_FILES.ralphStatus);
+  const session = statusContent ? parseRalphStatusToSession(statusContent) ?? defaults.session : defaults.session;
   return {
-    storyKey,
-    beadsId,
-    previousStatus: previousStatus ?? "",
-    newStatus: "done",
-    synced: true
+    version: 2,
+    sprint: v1.sprint,
+    stories: v1.stories,
+    retries,
+    flagged,
+    epics: {},
+    session,
+    observability: defaults.observability,
+    run: {
+      ...defaults.run,
+      ...v1.run
+    },
+    actionItems: v1.actionItems
   };
 }
-function syncAll(direction, beadsFns, dir) {
-  const root = dir ?? process.cwd();
-  const results = [];
-  let issues;
+function migrateFromOldFormat() {
+  const hasAnyOldFile = Object.values(OLD_FILES).some((rel) => existsSync2(resolve(rel)));
+  if (!hasAnyOldFile) return fail2("No old format files found for migration");
   try {
-    issues = beadsFns.listIssues();
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return [{
-      storyKey: "",
-      beadsId: "",
-      previousStatus: "",
-      newStatus: "",
-      synced: false,
-      error: `Failed to list beads issues: ${message}`
-    }];
-  }
-  const cachedListIssues = () => issues;
-  for (const issue of issues) {
-    const storyFilePath = resolveStoryFilePath(issue);
-    if (!storyFilePath) {
-      continue;
-    }
-    const storyKey = storyKeyFromPath(storyFilePath);
-    try {
-      if (direction === "beads-to-files" || direction === "bidirectional") {
-        const result = syncBeadsToStoryFile(issue.id, { listIssues: cachedListIssues }, root);
-        results.push(result);
-      } else if (direction === "files-to-beads") {
-        const result = syncStoryFileToBeads(storyKey, {
-          listIssues: cachedListIssues,
-          updateIssue: beadsFns.updateIssue,
-          closeIssue: beadsFns.closeIssue
-        }, root);
-        results.push(result);
-      }
-    } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      results.push({
-        storyKey,
-        beadsId: issue.id,
-        previousStatus: "",
-        newStatus: "",
-        synced: false,
-        error: message
-      });
+    const stories = {};
+    let run = defaultState().run;
+    let actionItems = [];
+    const yamlContent = readIfExists(OLD_FILES.sprintStatusYaml);
+    if (yamlContent) parseSprintStatusYaml(yamlContent, stories);
+    const retriesContent = readIfExists(OLD_FILES.storyRetries);
+    if (retriesContent) parseStoryRetries(retriesContent, stories);
+    const flaggedContent = readIfExists(OLD_FILES.flaggedStories);
+    if (flaggedContent) parseFlaggedStories(flaggedContent, stories);
+    const statusContent = readIfExists(OLD_FILES.ralphStatus);
+    let session = defaultState().session;
+    if (statusContent) {
+      const parsed = parseRalphStatus(statusContent);
+      if (parsed) run = parsed;
+      const parsedSession = parseRalphStatusToSession(statusContent);
+      if (parsedSession) session = parsedSession;
     }
+    const issuesContent = readIfExists(OLD_FILES.sessionIssues);
+    if (issuesContent) actionItems = parseSessionIssues(issuesContent);
+    const sprint = computeSprintCounts(stories);
+    const retries = retriesContent ? parseStoryRetriesRecord(retriesContent) : {};
+    const flagged = flaggedContent ? parseFlaggedStoriesList(flaggedContent) : [];
+    const migrated = {
+      version: 2,
+      sprint,
+      stories,
+      retries,
+      flagged,
+      epics: {},
+      session,
+      observability: defaultState().observability,
+      run,
+      actionItems
+    };
+    const writeResult = writeStateAtomic(migrated);
+    if (!writeResult.success) return fail2(writeResult.error);
+    return ok2(migrated);
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return fail2(`Migration failed: ${msg}`);
   }
-  return results;
 }
 
 // src/modules/sprint/state.ts
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync3, renameSync, existsSync as existsSync6, unlinkSync } from "fs";
-import { join as join4, dirname } from "path";
-
-// src/modules/sprint/migration.ts
-import { readFileSync as readFileSync3, existsSync as existsSync5 } from "fs";
-import { join as join3 } from "path";
-var OLD_FILES = {
-  storyRetries: "ralph/.story_retries",
-  flaggedStories: "ralph/.flagged_stories",
-  ralphStatus: "ralph/status.json",
-  sprintStatusYaml: "_bmad-output/implementation-artifacts/sprint-status.yaml",
-  sessionIssues: "_bmad-output/implementation-artifacts/.session-issues.md"
-};
-function resolve(relative3) {
-  return join3(process.cwd(), relative3);
+function projectRoot() {
+  return process.cwd();
 }
-function readIfExists(relative3) {
-  const p = resolve(relative3);
-  if (!existsSync5(p)) return null;
-  try {
-    return readFileSync3(p, "utf-8");
-  } catch {
-    return null;
-  }
+function statePath() {
+  return join2(projectRoot(), "sprint-state.json");
 }
-function emptyStory() {
-  return {
-    status: "backlog",
-    attempts: 0,
-    lastAttempt: null,
-    lastError: null,
-    proofPath: null,
-    acResults: null
-  };
+function tmpPath() {
+  return join2(projectRoot(), ".sprint-state.json.tmp");
 }
-function upsertStory(stories, key, patch) {
-  stories[key] = { ...stories[key] ?? emptyStory(), ...patch };
-}
-function parseStoryRetries(content, stories) {
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    const parts = trimmed.split(/\s+/);
-    if (parts.length < 2) continue;
-    const count = parseInt(parts[1], 10);
-    if (!isNaN(count)) upsertStory(stories, parts[0], { attempts: count });
-  }
-}
-function parseStoryRetriesRecord(content) {
-  const result = {};
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed) continue;
-    const parts = trimmed.split(/\s+/);
-    if (parts.length < 2) continue;
-    const count = parseInt(parts[1], 10);
-    if (!isNaN(count) && count >= 0) result[parts[0]] = count;
-  }
-  return result;
-}
-function parseFlaggedStoriesList(content) {
-  const seen = /* @__PURE__ */ new Set();
-  const result = [];
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (trimmed !== "" && !seen.has(trimmed)) {
-      seen.add(trimmed);
-      result.push(trimmed);
-    }
-  }
-  return result;
-}
-function parseFlaggedStories(content, stories) {
-  for (const line of content.split("\n")) {
-    const key = line.trim();
-    if (key) upsertStory(stories, key, { status: "blocked" });
-  }
-}
-function mapYamlStatus(value) {
-  const mapping = {
-    done: "done",
-    backlog: "backlog",
-    verifying: "verifying",
-    "in-progress": "in-progress",
-    "ready-for-dev": "ready",
-    blocked: "blocked",
-    failed: "failed",
-    review: "review",
-    ready: "ready"
-  };
-  return mapping[value.trim().toLowerCase()] ?? null;
-}
-function parseSprintStatusYaml(content, stories) {
-  for (const line of content.split("\n")) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith("#")) continue;
-    const match = trimmed.match(/^([a-zA-Z0-9_-]+):\s*(.+)$/);
-    if (!match) continue;
-    const key = match[1];
-    if (key === "development_status" || key.startsWith("epic-")) continue;
-    const status = mapYamlStatus(match[2]);
-    if (status) upsertStory(stories, key, { status });
-  }
-}
-function parseRalphStatus(content) {
-  try {
-    const data = JSON.parse(content);
-    return {
-      active: data.status === "running",
-      startedAt: null,
-      iteration: data.loop_count ?? 0,
-      cost: 0,
-      completed: [],
-      failed: [],
-      currentStory: null,
-      currentPhase: null,
-      lastAction: null,
-      acProgress: null
-    };
-  } catch {
-    return null;
-  }
-}
-function parseRalphStatusToSession(content) {
-  try {
-    const data = JSON.parse(content);
-    return {
-      active: data.status === "running",
-      startedAt: null,
-      iteration: data.loop_count ?? 0,
-      elapsedSeconds: data.elapsed_seconds ?? 0
-    };
-  } catch {
-    return null;
-  }
-}
-function parseSessionIssues(content) {
-  const items = [];
-  let currentStory = "";
-  let itemId = 0;
-  for (const line of content.split("\n")) {
-    const headerMatch = line.match(/^###\s+([a-zA-Z0-9_-]+)\s*[—-]/);
-    if (headerMatch) {
-      currentStory = headerMatch[1];
-      continue;
-    }
-    const bulletMatch = line.match(/^-\s+(.+)/);
-    if (bulletMatch && currentStory) {
-      itemId++;
-      items.push({
-        id: `migrated-${itemId}`,
-        story: currentStory,
-        description: bulletMatch[1],
-        source: "retro",
-        resolved: false
-      });
-    }
-  }
-  return items;
-}
-function migrateV1ToV2(v1) {
-  const defaults = defaultState();
-  const retriesContent = readIfExists(OLD_FILES.storyRetries);
-  const retries = retriesContent ? parseStoryRetriesRecord(retriesContent) : {};
-  const flaggedContent = readIfExists(OLD_FILES.flaggedStories);
-  const flagged = flaggedContent ? parseFlaggedStoriesList(flaggedContent) : [];
-  const statusContent = readIfExists(OLD_FILES.ralphStatus);
-  const session = statusContent ? parseRalphStatusToSession(statusContent) ?? defaults.session : defaults.session;
-  return {
-    version: 2,
-    sprint: v1.sprint,
-    stories: v1.stories,
-    retries,
-    flagged,
-    epics: {},
-    session,
-    observability: defaults.observability,
-    run: {
-      ...defaults.run,
-      ...v1.run
-    },
-    actionItems: v1.actionItems
-  };
-}
-function migrateFromOldFormat() {
-  const hasAnyOldFile = Object.values(OLD_FILES).some((rel) => existsSync5(resolve(rel)));
-  if (!hasAnyOldFile) return fail2("No old format files found for migration");
-  try {
-    const stories = {};
-    let run = defaultState().run;
-    let actionItems = [];
-    const yamlContent = readIfExists(OLD_FILES.sprintStatusYaml);
-    if (yamlContent) parseSprintStatusYaml(yamlContent, stories);
-    const retriesContent = readIfExists(OLD_FILES.storyRetries);
-    if (retriesContent) parseStoryRetries(retriesContent, stories);
-    const flaggedContent = readIfExists(OLD_FILES.flaggedStories);
-    if (flaggedContent) parseFlaggedStories(flaggedContent, stories);
-    const statusContent = readIfExists(OLD_FILES.ralphStatus);
-    let session = defaultState().session;
-    if (statusContent) {
-      const parsed = parseRalphStatus(statusContent);
-      if (parsed) run = parsed;
-      const parsedSession = parseRalphStatusToSession(statusContent);
-      if (parsedSession) session = parsedSession;
-    }
-    const issuesContent = readIfExists(OLD_FILES.sessionIssues);
-    if (issuesContent) actionItems = parseSessionIssues(issuesContent);
-    const sprint = computeSprintCounts(stories);
-    const retries = retriesContent ? parseStoryRetriesRecord(retriesContent) : {};
-    const flagged = flaggedContent ? parseFlaggedStoriesList(flaggedContent) : [];
-    const migrated = {
-      version: 2,
-      sprint,
-      stories,
-      retries,
-      flagged,
-      epics: {},
-      session,
-      observability: defaultState().observability,
-      run,
-      actionItems
-    };
-    const writeResult = writeStateAtomic(migrated);
-    if (!writeResult.success) return fail2(writeResult.error);
-    return ok2(migrated);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return fail2(`Migration failed: ${msg}`);
-  }
-}
-
-// src/modules/sprint/state.ts
-function projectRoot() {
-  return process.cwd();
-}
-function statePath() {
-  return join4(projectRoot(), "sprint-state.json");
-}
-function tmpPath() {
-  return join4(projectRoot(), ".sprint-state.json.tmp");
-}
-function sprintStatusYamlPath() {
-  return join4(projectRoot(), "_bmad-output", "implementation-artifacts", "sprint-status.yaml");
+function sprintStatusYamlPath() {
+  return join2(projectRoot(), "_bmad-output", "implementation-artifacts", "sprint-status.yaml");
 }
 function defaultState() {
   return {
@@ -884,9 +538,9 @@ function writeSprintStatusYaml(state) {
   try {
     const yamlPath = sprintStatusYamlPath();
     const dir = dirname(yamlPath);
-    if (!existsSync6(dir)) return;
+    if (!existsSync3(dir)) return;
     const content = generateSprintStatusYaml(state);
-    writeFileSync3(yamlPath, content, "utf-8");
+    writeFileSync(yamlPath, content, "utf-8");
   } catch {
   }
 }
@@ -895,7 +549,7 @@ function writeStateAtomic(state) {
     const data = JSON.stringify(state, null, 2) + "\n";
     const tmp = tmpPath();
     const final = statePath();
-    writeFileSync3(tmp, data, "utf-8");
+    writeFileSync(tmp, data, "utf-8");
     renameSync(tmp, final);
     writeSprintStatusYaml(state);
     return ok2(void 0);
@@ -906,9 +560,9 @@ function writeStateAtomic(state) {
 }
 function getSprintState() {
   const fp = statePath();
-  if (existsSync6(fp)) {
+  if (existsSync3(fp)) {
     try {
-      const raw = readFileSync4(fp, "utf-8");
+      const raw = readFileSync2(fp, "utf-8");
       const parsed = JSON.parse(raw);
       const version = parsed.version;
       if (version === 2) {
@@ -1048,10 +702,10 @@ function reconcileState() {
     const state = JSON.parse(JSON.stringify(stateResult.data));
     const corrections = [];
     let changed = false;
-    const retriesPath = join4(projectRoot(), "ralph", ".story_retries");
-    if (existsSync6(retriesPath)) {
+    const retriesPath = join2(projectRoot(), "ralph", ".story_retries");
+    if (existsSync3(retriesPath)) {
       try {
-        const content = readFileSync4(retriesPath, "utf-8");
+        const content = readFileSync2(retriesPath, "utf-8");
         const fileRetries = parseStoryRetriesRecord(content);
         const mergedRetries = { ...state.retries };
         for (const [key, count] of Object.entries(fileRetries)) {
@@ -1071,10 +725,10 @@ function reconcileState() {
         corrections.push("removed malformed .story_retries file");
       }
     }
-    const flaggedPath = join4(projectRoot(), "ralph", ".flagged_stories");
-    if (existsSync6(flaggedPath)) {
+    const flaggedPath = join2(projectRoot(), "ralph", ".flagged_stories");
+    if (existsSync3(flaggedPath)) {
       try {
-        const content = readFileSync4(flaggedPath, "utf-8");
+        const content = readFileSync2(flaggedPath, "utf-8");
         const fileKeys = parseFlaggedStoriesList(content);
         const existing = new Set(state.flagged);
         const merged = [...state.flagged];
@@ -1361,9 +1015,9 @@ function generateReport(state, now) {
 }
 
 // src/modules/sprint/timeout.ts
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync7, mkdirSync, readdirSync } from "fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, existsSync as existsSync4, mkdirSync, readdirSync } from "fs";
 import { execSync } from "child_process";
-import { join as join5 } from "path";
+import { join as join3 } from "path";
 var GIT_TIMEOUT_MS = 5e3;
 var DEFAULT_MAX_LINES = 100;
 function captureGitDiff() {
@@ -1392,14 +1046,14 @@ function captureGitDiff() {
 }
 function captureStateDelta(beforePath, afterPath) {
   try {
-    if (!existsSync7(beforePath)) {
+    if (!existsSync4(beforePath)) {
       return fail2(`State snapshot not found: ${beforePath}`);
     }
-    if (!existsSync7(afterPath)) {
+    if (!existsSync4(afterPath)) {
       return fail2(`Current state file not found: ${afterPath}`);
     }
-    const beforeRaw = readFileSync5(beforePath, "utf-8");
-    const afterRaw = readFileSync5(afterPath, "utf-8");
+    const beforeRaw = readFileSync3(beforePath, "utf-8");
+    const afterRaw = readFileSync3(afterPath, "utf-8");
     const before = JSON.parse(beforeRaw);
     const after = JSON.parse(afterRaw);
     const beforeStories = before.stories ?? {};
@@ -1424,10 +1078,10 @@ function captureStateDelta(beforePath, afterPath) {
 }
 function capturePartialStderr(outputFile, maxLines = DEFAULT_MAX_LINES) {
   try {
-    if (!existsSync7(outputFile)) {
+    if (!existsSync4(outputFile)) {
       return fail2(`Output file not found: ${outputFile}`);
     }
-    const content = readFileSync5(outputFile, "utf-8");
+    const content = readFileSync3(outputFile, "utf-8");
     const lines = content.split("\n");
     if (lines.length > 0 && lines[lines.length - 1] === "") {
       lines.pop();
@@ -1475,7 +1129,7 @@ function captureTimeoutReport(opts) {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString();
     const gitResult = captureGitDiff();
     const gitDiff = gitResult.success ? gitResult.data : `(unavailable: ${gitResult.error})`;
-    const statePath2 = join5(process.cwd(), "sprint-state.json");
+    const statePath2 = join3(process.cwd(), "sprint-state.json");
     const deltaResult = captureStateDelta(opts.stateSnapshotPath, statePath2);
     const stateDelta = deltaResult.success ? deltaResult.data : `(unavailable: ${deltaResult.error})`;
     const stderrResult = capturePartialStderr(opts.outputFile);
@@ -1489,15 +1143,15 @@ function captureTimeoutReport(opts) {
       partialStderr,
       timestamp
     };
-    const reportDir = join5(process.cwd(), "ralph", "logs");
+    const reportDir = join3(process.cwd(), "ralph", "logs");
     const safeStoryKey = opts.storyKey.replace(/[^a-zA-Z0-9._-]/g, "_");
     const reportFileName = `timeout-report-${opts.iteration}-${safeStoryKey}.md`;
-    const reportPath = join5(reportDir, reportFileName);
-    if (!existsSync7(reportDir)) {
+    const reportPath = join3(reportDir, reportFileName);
+    if (!existsSync4(reportDir)) {
       mkdirSync(reportDir, { recursive: true });
     }
     const reportContent = formatReport(capture);
-    writeFileSync4(reportPath, reportContent, "utf-8");
+    writeFileSync2(reportPath, reportContent, "utf-8");
     return ok2({
       filePath: reportPath,
       capture
@@ -1509,8 +1163,8 @@ function captureTimeoutReport(opts) {
 }
 function findLatestTimeoutReport(storyKey) {
   try {
-    const reportDir = join5(process.cwd(), "ralph", "logs");
-    if (!existsSync7(reportDir)) {
+    const reportDir = join3(process.cwd(), "ralph", "logs");
+    if (!existsSync4(reportDir)) {
       return ok2(null);
     }
     const safeStoryKey = storyKey.replace(/[^a-zA-Z0-9._-]/g, "_");
@@ -1532,8 +1186,8 @@ function findLatestTimeoutReport(storyKey) {
     }
     matches.sort((a, b) => b.iteration - a.iteration);
     const latest = matches[0];
-    const reportPath = join5(reportDir, latest.fileName);
-    const content = readFileSync5(reportPath, "utf-8");
+    const reportPath = join3(reportDir, latest.fileName);
+    const content = readFileSync3(reportPath, "utf-8");
     let durationMinutes = 0;
     let filesChanged = 0;
     const durationMatch = content.match(/\*\*Duration:\*\*\s*(\d+)\s*minutes/);
@@ -1562,12 +1216,12 @@ function findLatestTimeoutReport(storyKey) {
 }
 
 // src/modules/sprint/feedback.ts
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
-import { existsSync as existsSync8 } from "fs";
-import { join as join6 } from "path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
+import { existsSync as existsSync5 } from "fs";
+import { join as join4 } from "path";
 
 // src/modules/sprint/validator.ts
-import { readFileSync as readFileSync7, existsSync as existsSync9 } from "fs";
+import { readFileSync as readFileSync5, existsSync as existsSync6 } from "fs";
 var VALID_STATUSES = /* @__PURE__ */ new Set([
   "backlog",
   "ready",
@@ -1598,10 +1252,10 @@ function parseSprintStatusKeys(content) {
 }
 function parseStateFile(statePath2) {
   try {
-    if (!existsSync9(statePath2)) {
+    if (!existsSync6(statePath2)) {
       return fail2(`State file not found: ${statePath2}`);
     }
-    const raw = readFileSync7(statePath2, "utf-8");
+    const raw = readFileSync5(statePath2, "utf-8");
     const parsed = JSON.parse(raw);
     return ok2(parsed);
   } catch (err) {
@@ -1616,10 +1270,10 @@ function validateStateConsistency(statePath2, sprintStatusPath) {
       return fail2(stateResult.error);
     }
     const state = stateResult.data;
-    if (!existsSync9(sprintStatusPath)) {
+    if (!existsSync6(sprintStatusPath)) {
       return fail2(`Sprint status file not found: ${sprintStatusPath}`);
     }
-    const statusContent = readFileSync7(sprintStatusPath, "utf-8");
+    const statusContent = readFileSync5(sprintStatusPath, "utf-8");
     const keysResult = parseSprintStatusKeys(statusContent);
     if (!keysResult.success) {
       return fail2(keysResult.error);
@@ -1770,12 +1424,7 @@ function readSprintStatusFromState() {
   const stateResult = getSprintState();
   if (!stateResult.success) return {};
   const statuses = getStoryStatusesFromState(stateResult.data);
-  if (Object.keys(statuses).length > 0) return statuses;
-  try {
-    return readSprintStatus(process.cwd());
-  } catch {
-    return {};
-  }
+  return statuses;
 }
 function shouldDeferPhase2(phase, remainingMinutes) {
   return shouldDeferPhase(phase, remainingMinutes);
@@ -2276,8 +1925,8 @@ function parseResultEvent(parsed) {
 
 // src/lib/agents/ralph.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync10 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync7 } from "fs";
+import { join as join5 } from "path";
 var ANSI_ESCAPE = /\x1b\[[0-9;]*m/g;
 var TIMESTAMP_PREFIX = /^\[[\d-]+\s[\d:]+\]\s*/;
 var SUCCESS_STORY = /\[SUCCESS\]\s+Story\s+([\w-]+):\s+DONE(.*)/;
@@ -2365,17 +2014,17 @@ function buildSpawnArgs(opts) {
   return args;
 }
 function resolveRalphPath() {
-  return join7(getPackageRoot(), "ralph", "ralph.sh");
+  return join5(getPackageRoot(), "ralph", "ralph.sh");
 }
 var RalphDriver = class {
   name = "ralph";
   config;
   constructor(config) {
-    this.config = config ?? { pluginDir: join7(process.cwd(), ".claude") };
+    this.config = config ?? { pluginDir: join5(process.cwd(), ".claude") };
   }
   spawn(opts) {
     const ralphPath = resolveRalphPath();
-    if (!existsSync10(ralphPath)) {
+    if (!existsSync7(ralphPath)) {
       throw new Error(`Ralph loop not found at ${ralphPath} \u2014 reinstall codeharness`);
     }
     const args = buildSpawnArgs({
@@ -2517,7 +2166,7 @@ function getDriver(name, config) {
 
 // src/commands/run.ts
 function resolvePluginDir() {
-  return join8(process.cwd(), ".claude");
+  return join6(process.cwd(), ".claude");
 }
 function handleAgentEvent(event, rendererHandle, state) {
   switch (event.type) {
@@ -2571,7 +2220,7 @@ function registerRunCommand(program) {
     const isJson = !!globalOpts.json;
     const outputOpts = { json: isJson };
     const pluginDir = resolvePluginDir();
-    if (!existsSync11(pluginDir)) {
+    if (!existsSync8(pluginDir)) {
       fail("Plugin directory not found \u2014 run codeharness init first", outputOpts);
       process.exitCode = 1;
       return;
@@ -2596,7 +2245,7 @@ function registerRunCommand(program) {
       info(`[WARN] Container cleanup failed: ${cleanup.error}`, outputOpts);
     }
     const projectDir = process.cwd();
-    const sprintStatusPath = join8(projectDir, "_bmad-output", "implementation-artifacts", "sprint-status.yaml");
+    const sprintStatusPath = join6(projectDir, "_bmad-output", "implementation-artifacts", "sprint-status.yaml");
     const statuses = readSprintStatusFromState();
     const counts = countStories(statuses);
     if (counts.total === 0) {
@@ -2615,7 +2264,7 @@ function registerRunCommand(program) {
       process.exitCode = 1;
       return;
     }
-    const promptFile = join8(projectDir, "ralph", ".harness-prompt.md");
+    const promptFile = join6(projectDir, "ralph", ".harness-prompt.md");
     let flaggedStories;
     const flaggedState = getSprintState2();
     if (flaggedState.success && flaggedState.data.flagged?.length > 0) {
@@ -2628,7 +2277,7 @@ function registerRunCommand(program) {
     });
     try {
       mkdirSync2(dirname3(promptFile), { recursive: true });
-      writeFileSync6(promptFile, promptContent, "utf-8");
+      writeFileSync4(promptFile, promptContent, "utf-8");
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       fail(`Failed to write prompt file: ${message}`, outputOpts);
@@ -2733,12 +2382,12 @@ function registerRunCommand(program) {
         });
       });
       if (isJson) {
-        const statusFile = join8(projectDir, driver.getStatusFile());
+        const statusFile = join6(projectDir, driver.getStatusFile());
         let statusData = null;
         let exitReason = "status_file_missing";
-        if (existsSync11(statusFile)) {
+        if (existsSync8(statusFile)) {
           try {
-            statusData = JSON.parse(readFileSync8(statusFile, "utf-8"));
+            statusData = JSON.parse(readFileSync6(statusFile, "utf-8"));
             exitReason = "";
           } catch {
             exitReason = "status_file_unreadable";
@@ -2775,7 +2424,7 @@ import { join as join20 } from "path";
 import { readFileSync as readFileSync18 } from "fs";
 
 // src/modules/verify/proof.ts
-import { existsSync as existsSync12, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
 function classifyEvidenceCommands(proofContent) {
   const results = [];
   const codeBlockPattern = /```(?:bash|shell)\n([\s\S]*?)```/g;
@@ -2861,10 +2510,10 @@ function validateProofQuality(proofPath) {
     otherCount: 0,
     blackBoxPass: false
   };
-  if (!existsSync12(proofPath)) {
+  if (!existsSync9(proofPath)) {
     return emptyResult;
   }
-  const content = readFileSync9(proofPath, "utf-8");
+  const content = readFileSync7(proofPath, "utf-8");
   const bbTierMatch = /\*\*Tier:\*\*\s*(unit-testable|black-box)/i.exec(content);
   const bbIsUnitTestable = bbTierMatch ? bbTierMatch[1].toLowerCase() === "unit-testable" : false;
   const bbEnforcement = bbIsUnitTestable ? { blackBoxPass: true, grepSrcCount: 0, dockerExecCount: 0, observabilityCount: 0, otherCount: 0, grepRatio: 0, acsMissingDockerExec: [] } : checkBlackBoxEnforcement(content);
@@ -3012,7 +2661,7 @@ import { join as join13 } from "path";
 
 // src/lib/doc-health/types.ts
 import { readdirSync as readdirSync2, statSync } from "fs";
-import { join as join9 } from "path";
+import { join as join7 } from "path";
 var SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".js", ".py"]);
 function getExtension(filename) {
   const dot = filename.lastIndexOf(".");
@@ -3033,7 +2682,7 @@ function getNewestSourceMtime(dir) {
     const dirName = current.split("/").pop() ?? "";
     if (dirName === "node_modules" || dirName === ".git") return;
     for (const entry of entries) {
-      const fullPath = join9(current, entry);
+      const fullPath = join7(current, entry);
       let stat;
       try {
         stat = statSync(fullPath);
@@ -3060,22 +2709,22 @@ function getNewestSourceMtime(dir) {
 
 // src/lib/doc-health/scanner.ts
 import {
-  existsSync as existsSync14,
-  readFileSync as readFileSync11,
+  existsSync as existsSync11,
+  readFileSync as readFileSync9,
   readdirSync as readdirSync4,
   statSync as statSync3
 } from "fs";
-import { join as join11, relative as relative2 } from "path";
+import { join as join9, relative as relative2 } from "path";
 
 // src/lib/doc-health/staleness.ts
 import { execSync as execSync2 } from "child_process";
 import {
-  existsSync as existsSync13,
-  readFileSync as readFileSync10,
+  existsSync as existsSync10,
+  readFileSync as readFileSync8,
   readdirSync as readdirSync3,
   statSync as statSync2
 } from "fs";
-import { join as join10, relative } from "path";
+import { join as join8, relative } from "path";
 var SOURCE_EXTENSIONS2 = /* @__PURE__ */ new Set([".ts", ".js", ".py"]);
 var DO_NOT_EDIT_HEADER = "<!-- DO NOT EDIT MANUALLY";
 function getSourceFilesInModule(modulePath) {
@@ -3090,7 +2739,7 @@ function getSourceFilesInModule(modulePath) {
     const dirName = current.split("/").pop() ?? "";
     if (dirName === "node_modules" || dirName === ".git" || dirName === "__tests__" || dirName === "dist" || dirName === "coverage" || dirName.startsWith(".") && current !== modulePath) return;
     for (const entry of entries) {
-      const fullPath = join10(current, entry);
+      const fullPath = join8(current, entry);
       let stat;
       try {
         stat = statSync2(fullPath);
@@ -3111,8 +2760,8 @@ function getSourceFilesInModule(modulePath) {
   return files;
 }
 function getMentionedFilesInAgentsMd(agentsPath) {
-  if (!existsSync13(agentsPath)) return [];
-  const content = readFileSync10(agentsPath, "utf-8");
+  if (!existsSync10(agentsPath)) return [];
+  const content = readFileSync8(agentsPath, "utf-8");
   const mentioned = /* @__PURE__ */ new Set();
   const filenamePattern = /[\w./-]*[\w-]+\.(?:ts|js|py)\b/g;
   let match;
@@ -3136,12 +2785,12 @@ function checkAgentsMdCompleteness(agentsPath, modulePath) {
 }
 function checkAgentsMdForModule(modulePath, dir) {
   const root = dir ?? process.cwd();
-  const fullModulePath = join10(root, modulePath);
-  let agentsPath = join10(fullModulePath, "AGENTS.md");
-  if (!existsSync13(agentsPath)) {
-    agentsPath = join10(root, "AGENTS.md");
+  const fullModulePath = join8(root, modulePath);
+  let agentsPath = join8(fullModulePath, "AGENTS.md");
+  if (!existsSync10(agentsPath)) {
+    agentsPath = join8(root, "AGENTS.md");
   }
-  if (!existsSync13(agentsPath)) {
+  if (!existsSync10(agentsPath)) {
     return {
       path: relative(root, agentsPath),
       grade: "missing",
@@ -3172,9 +2821,9 @@ function checkAgentsMdForModule(modulePath, dir) {
   };
 }
 function checkDoNotEditHeaders(docPath) {
-  if (!existsSync13(docPath)) return false;
+  if (!existsSync10(docPath)) return false;
   try {
-    const content = readFileSync10(docPath, "utf-8");
+    const content = readFileSync8(docPath, "utf-8");
     if (content.length === 0) return false;
     return content.trimStart().startsWith(DO_NOT_EDIT_HEADER);
   } catch {
@@ -3204,15 +2853,15 @@ function checkStoryDocFreshness(storyId, dir) {
   for (const mod of modulesToCheck) {
     const result = checkAgentsMdForModule(mod, root);
     documents.push(result);
-    const moduleAgentsPath = join10(root, mod, "AGENTS.md");
-    const actualAgentsPath = existsSync13(moduleAgentsPath) ? moduleAgentsPath : join10(root, "AGENTS.md");
-    if (existsSync13(actualAgentsPath)) {
+    const moduleAgentsPath = join8(root, mod, "AGENTS.md");
+    const actualAgentsPath = existsSync10(moduleAgentsPath) ? moduleAgentsPath : join8(root, "AGENTS.md");
+    if (existsSync10(actualAgentsPath)) {
       checkAgentsMdLineCountInternal(actualAgentsPath, result.path, documents);
     }
   }
   if (modulesToCheck.length === 0) {
-    const rootAgentsPath = join10(root, "AGENTS.md");
-    if (existsSync13(rootAgentsPath)) {
+    const rootAgentsPath = join8(root, "AGENTS.md");
+    if (existsSync10(rootAgentsPath)) {
       documents.push({
         path: "AGENTS.md",
         grade: "fresh",
@@ -3250,7 +2899,7 @@ function getRecentlyChangedFiles(dir) {
 }
 function checkAgentsMdLineCountInternal(filePath, docPath, documents) {
   try {
-    const content = readFileSync10(filePath, "utf-8");
+    const content = readFileSync8(filePath, "utf-8");
     const lineCount = content.split("\n").length;
     if (lineCount > 100) {
       documents.push({
@@ -3286,7 +2935,7 @@ function findModules(dir, threshold) {
     let sourceCount = 0;
     const subdirs = [];
     for (const entry of entries) {
-      const fullPath = join11(current, entry);
+      const fullPath = join9(current, entry);
       let stat;
       try {
         stat = statSync3(fullPath);
@@ -3320,17 +2969,17 @@ function scanDocHealth(dir) {
   const root = dir ?? process.cwd();
   const documents = [];
   const modules = findModules(root);
-  const rootAgentsPath = join11(root, "AGENTS.md");
-  if (existsSync14(rootAgentsPath)) {
+  const rootAgentsPath = join9(root, "AGENTS.md");
+  if (existsSync11(rootAgentsPath)) {
     if (modules.length > 0) {
       const docMtime = statSync3(rootAgentsPath).mtime;
       let allMissing = [];
       let staleModule = "";
       let newestCode = null;
       for (const mod of modules) {
-        const fullModPath = join11(root, mod);
-        const modAgentsPath = join11(fullModPath, "AGENTS.md");
-        if (existsSync14(modAgentsPath)) continue;
+        const fullModPath = join9(root, mod);
+        const modAgentsPath = join9(fullModPath, "AGENTS.md");
+        if (existsSync11(modAgentsPath)) continue;
         const { missing } = checkAgentsMdCompleteness(rootAgentsPath, fullModPath);
         if (missing.length > 0 && staleModule === "") {
           staleModule = mod;
@@ -3378,8 +3027,8 @@ function scanDocHealth(dir) {
     });
   }
   for (const mod of modules) {
-    const modAgentsPath = join11(root, mod, "AGENTS.md");
-    if (existsSync14(modAgentsPath)) {
+    const modAgentsPath = join9(root, mod, "AGENTS.md");
+    if (existsSync11(modAgentsPath)) {
       const result = checkAgentsMdForModule(mod, root);
       if (result.path !== "AGENTS.md") {
         documents.push(result);
@@ -3387,9 +3036,9 @@ function scanDocHealth(dir) {
       }
     }
   }
-  const indexPath = join11(root, "docs", "index.md");
-  if (existsSync14(indexPath)) {
-    const content = readFileSync11(indexPath, "utf-8");
+  const indexPath = join9(root, "docs", "index.md");
+  if (existsSync11(indexPath)) {
+    const content = readFileSync9(indexPath, "utf-8");
     const hasAbsolutePaths = /https?:\/\/|file:\/\//i.test(content);
     documents.push({
       path: "docs/index.md",
@@ -3399,11 +3048,11 @@ function scanDocHealth(dir) {
       reason: hasAbsolutePaths ? "Contains absolute URLs (may violate NFR25)" : "Uses relative paths"
     });
   }
-  const activeDir = join11(root, "docs", "exec-plans", "active");
-  if (existsSync14(activeDir)) {
+  const activeDir = join9(root, "docs", "exec-plans", "active");
+  if (existsSync11(activeDir)) {
     const files = readdirSync4(activeDir).filter((f) => f.endsWith(".md"));
     for (const file of files) {
-      const filePath = join11(activeDir, file);
+      const filePath = join9(activeDir, file);
       documents.push({
         path: `docs/exec-plans/active/${file}`,
         grade: "fresh",
@@ -3414,11 +3063,11 @@ function scanDocHealth(dir) {
     }
   }
   for (const subdir of ["quality", "generated"]) {
-    const dirPath = join11(root, "docs", subdir);
-    if (!existsSync14(dirPath)) continue;
+    const dirPath = join9(root, "docs", subdir);
+    if (!existsSync11(dirPath)) continue;
     const files = readdirSync4(dirPath).filter((f) => !f.startsWith("."));
     for (const file of files) {
-      const filePath = join11(dirPath, file);
+      const filePath = join9(dirPath, file);
       let stat;
       try {
         stat = statSync3(filePath);
@@ -3451,7 +3100,7 @@ function scanDocHealth(dir) {
 }
 function checkAgentsMdLineCount(filePath, docPath, documents) {
   try {
-    const content = readFileSync11(filePath, "utf-8");
+    const content = readFileSync9(filePath, "utf-8");
     const lineCount = content.split("\n").length;
     if (lineCount > 100) {
       documents.push({
@@ -3468,13 +3117,13 @@ function checkAgentsMdLineCount(filePath, docPath, documents) {
 
 // src/lib/doc-health/report.ts
 import {
-  existsSync as existsSync15,
+  existsSync as existsSync12,
   mkdirSync as mkdirSync3,
-  readFileSync as readFileSync12,
+  readFileSync as readFileSync10,
   unlinkSync as unlinkSync2,
-  writeFileSync as writeFileSync7
+  writeFileSync as writeFileSync5
 } from "fs";
-import { join as join12 } from "path";
+import { join as join10 } from "path";
 function printDocHealthOutput(report) {
   for (const doc of report.documents) {
     switch (doc.grade) {
@@ -3495,11 +3144,11 @@ function printDocHealthOutput(report) {
 }
 function completeExecPlan(storyId, dir) {
   const root = dir ?? process.cwd();
-  const activePath = join12(root, "docs", "exec-plans", "active", `${storyId}.md`);
-  if (!existsSync15(activePath)) {
+  const activePath = join10(root, "docs", "exec-plans", "active", `${storyId}.md`);
+  if (!existsSync12(activePath)) {
     return null;
   }
-  let content = readFileSync12(activePath, "utf-8");
+  let content = readFileSync10(activePath, "utf-8");
   content = content.replace(/^Status:\s*active$/m, "Status: completed");
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   content = content.replace(
@@ -3507,10 +3156,10 @@ function completeExecPlan(storyId, dir) {
     `$1
 Completed: ${timestamp}`
   );
-  const completedDir = join12(root, "docs", "exec-plans", "completed");
+  const completedDir = join10(root, "docs", "exec-plans", "completed");
   mkdirSync3(completedDir, { recursive: true });
-  const completedPath = join12(completedDir, `${storyId}.md`);
-  writeFileSync7(completedPath, content, "utf-8");
+  const completedPath = join10(completedDir, `${storyId}.md`);
+  writeFileSync5(completedPath, content, "utf-8");
   try {
     unlinkSync2(activePath);
   } catch {
@@ -3518,6 +3167,331 @@ Completed: ${timestamp}`
   return completedPath;
 }
 
+// src/lib/sync/story-files.ts
+import { existsSync as existsSync13, readFileSync as readFileSync11, writeFileSync as writeFileSync6 } from "fs";
+var BEADS_TO_STORY_STATUS = {
+  open: "in-progress",
+  closed: "done"
+};
+var STORY_TO_BEADS_STATUS = {
+  backlog: "open",
+  "ready-for-dev": "open",
+  "in-progress": "open",
+  review: "open",
+  done: "closed"
+};
+function beadsStatusToStoryStatus(beadsStatus) {
+  return BEADS_TO_STORY_STATUS[beadsStatus] ?? null;
+}
+function storyStatusToBeadsStatus(storyStatus) {
+  return STORY_TO_BEADS_STATUS[storyStatus] ?? null;
+}
+function storyKeyFromPath(filePath) {
+  const base = filePath.split("/").pop() ?? filePath;
+  return base.replace(/\.md$/, "");
+}
+function resolveStoryFilePath(beadsIssue) {
+  const desc = beadsIssue.description;
+  if (!desc || !desc.trim()) {
+    return null;
+  }
+  const trimmed = desc.trim();
+  if (!trimmed.endsWith(".md")) {
+    return null;
+  }
+  return trimmed;
+}
+function readStoryFileStatus(filePath) {
+  if (!existsSync13(filePath)) {
+    return null;
+  }
+  const content = readFileSync11(filePath, "utf-8");
+  const match = content.match(/^#{0,2}\s*Status:\s*(.+)$/m);
+  if (!match) {
+    return null;
+  }
+  return match[1].trim();
+}
+function updateStoryFileStatus(filePath, newStatus) {
+  const content = readFileSync11(filePath, "utf-8");
+  const statusRegex = /^(#{0,2}\s*)Status:\s*.+$/m;
+  if (statusRegex.test(content)) {
+    const updated = content.replace(statusRegex, `$1Status: ${newStatus}`);
+    writeFileSync6(filePath, updated, "utf-8");
+  } else {
+    const lines = content.split("\n");
+    const titleIndex = lines.findIndex((l) => l.startsWith("# "));
+    if (titleIndex !== -1) {
+      lines.splice(titleIndex + 1, 0, "", `Status: ${newStatus}`);
+    } else {
+      lines.unshift(`Status: ${newStatus}`, "");
+    }
+    writeFileSync6(filePath, lines.join("\n"), "utf-8");
+  }
+}
+
+// src/lib/sync/sprint-yaml.ts
+import { existsSync as existsSync14, readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "fs";
+import { join as join11 } from "path";
+import { parse } from "yaml";
+var SPRINT_STATUS_PATH = "_bmad-output/implementation-artifacts/sprint-status.yaml";
+function updateSprintStatus(storyKey, newStatus, dir) {
+  const root = dir ?? process.cwd();
+  const filePath = join11(root, SPRINT_STATUS_PATH);
+  if (!existsSync14(filePath)) {
+    warn(`sprint-status.yaml not found at ${filePath}, skipping update`);
+    return;
+  }
+  const content = readFileSync12(filePath, "utf-8");
+  const keyPattern = new RegExp(`^(\\s*${escapeRegExp(storyKey)}:\\s*)\\S+(.*)$`, "m");
+  if (!keyPattern.test(content)) {
+    return;
+  }
+  const updated = content.replace(keyPattern, `$1${newStatus}$2`);
+  writeFileSync7(filePath, updated, "utf-8");
+}
+function escapeRegExp(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// src/lib/sync/beads.ts
+import { existsSync as existsSync15 } from "fs";
+import { join as join12 } from "path";
+function syncBeadsToStoryFile(beadsId, beadsFns, dir) {
+  const root = dir ?? process.cwd();
+  const issues = beadsFns.listIssues();
+  const issue = issues.find((i) => i.id === beadsId);
+  if (!issue) {
+    return {
+      storyKey: "",
+      beadsId,
+      previousStatus: "",
+      newStatus: "",
+      synced: false,
+      error: `Beads issue not found: ${beadsId}`
+    };
+  }
+  const storyFilePath = resolveStoryFilePath(issue);
+  if (!storyFilePath) {
+    return {
+      storyKey: "",
+      beadsId,
+      previousStatus: issue.status,
+      newStatus: "",
+      synced: false,
+      error: `No story file path in beads issue description: ${beadsId}`
+    };
+  }
+  const storyKey = storyKeyFromPath(storyFilePath);
+  const fullPath = join12(root, storyFilePath);
+  const currentStoryStatus = readStoryFileStatus(fullPath);
+  if (currentStoryStatus === null) {
+    return {
+      storyKey,
+      beadsId,
+      previousStatus: issue.status,
+      newStatus: "",
+      synced: false,
+      error: `Story file not found or has no Status line: ${storyFilePath}`
+    };
+  }
+  const targetStoryStatus = beadsStatusToStoryStatus(issue.status);
+  if (!targetStoryStatus) {
+    return {
+      storyKey,
+      beadsId,
+      previousStatus: currentStoryStatus,
+      newStatus: "",
+      synced: false,
+      error: `Unknown beads status: ${issue.status}`
+    };
+  }
+  if (currentStoryStatus === targetStoryStatus) {
+    return {
+      storyKey,
+      beadsId,
+      previousStatus: currentStoryStatus,
+      newStatus: currentStoryStatus,
+      synced: false
+    };
+  }
+  updateStoryFileStatus(fullPath, targetStoryStatus);
+  updateSprintStatus(storyKey, targetStoryStatus, root);
+  return {
+    storyKey,
+    beadsId,
+    previousStatus: currentStoryStatus,
+    newStatus: targetStoryStatus,
+    synced: true
+  };
+}
+function syncStoryFileToBeads(storyKey, beadsFns, dir) {
+  const root = dir ?? process.cwd();
+  const storyFilePath = `_bmad-output/implementation-artifacts/${storyKey}.md`;
+  const fullPath = join12(root, storyFilePath);
+  const currentStoryStatus = readStoryFileStatus(fullPath);
+  if (currentStoryStatus === null) {
+    return {
+      storyKey,
+      beadsId: "",
+      previousStatus: "",
+      newStatus: "",
+      synced: false,
+      error: `Story file not found or has no Status line: ${storyFilePath}`
+    };
+  }
+  const issues = beadsFns.listIssues();
+  const issue = issues.find((i) => {
+    const path = resolveStoryFilePath(i);
+    if (!path) return false;
+    return storyKeyFromPath(path) === storyKey;
+  });
+  if (!issue) {
+    return {
+      storyKey,
+      beadsId: "",
+      previousStatus: currentStoryStatus,
+      newStatus: "",
+      synced: false,
+      error: `No beads issue found for story: ${storyKey}`
+    };
+  }
+  const targetBeadsStatus = storyStatusToBeadsStatus(currentStoryStatus);
+  if (!targetBeadsStatus) {
+    return {
+      storyKey,
+      beadsId: issue.id,
+      previousStatus: currentStoryStatus,
+      newStatus: "",
+      synced: false,
+      error: `Unknown story status: ${currentStoryStatus}`
+    };
+  }
+  if (issue.status === targetBeadsStatus) {
+    return {
+      storyKey,
+      beadsId: issue.id,
+      previousStatus: currentStoryStatus,
+      newStatus: currentStoryStatus,
+      synced: false
+    };
+  }
+  if (targetBeadsStatus === "closed") {
+    beadsFns.closeIssue(issue.id);
+  } else {
+    beadsFns.updateIssue(issue.id, { status: targetBeadsStatus });
+  }
+  updateSprintStatus(storyKey, currentStoryStatus, root);
+  return {
+    storyKey,
+    beadsId: issue.id,
+    previousStatus: issue.status,
+    newStatus: targetBeadsStatus,
+    synced: true
+  };
+}
+function syncClose(beadsId, beadsFns, dir) {
+  const root = dir ?? process.cwd();
+  const issues = beadsFns.listIssues();
+  const issue = issues.find((i) => i.id === beadsId);
+  beadsFns.closeIssue(beadsId);
+  if (!issue) {
+    return {
+      storyKey: "",
+      beadsId,
+      previousStatus: "",
+      newStatus: "closed",
+      synced: false,
+      error: `Beads issue not found: ${beadsId}`
+    };
+  }
+  const storyFilePath = resolveStoryFilePath(issue);
+  if (!storyFilePath) {
+    return {
+      storyKey: "",
+      beadsId,
+      previousStatus: issue.status,
+      newStatus: "closed",
+      synced: false,
+      error: `No story file path in beads issue description: ${beadsId}`
+    };
+  }
+  const storyKey = storyKeyFromPath(storyFilePath);
+  const fullPath = join12(root, storyFilePath);
+  const previousStatus = readStoryFileStatus(fullPath);
+  if (previousStatus === null) {
+    if (!existsSync15(fullPath)) {
+      return {
+        storyKey,
+        beadsId,
+        previousStatus: "",
+        newStatus: "closed",
+        synced: false,
+        error: `Story file not found: ${storyFilePath}`
+      };
+    }
+  }
+  updateStoryFileStatus(fullPath, "done");
+  updateSprintStatus(storyKey, "done", root);
+  return {
+    storyKey,
+    beadsId,
+    previousStatus: previousStatus ?? "",
+    newStatus: "done",
+    synced: true
+  };
+}
+function syncAll(direction, beadsFns, dir) {
+  const root = dir ?? process.cwd();
+  const results = [];
+  let issues;
+  try {
+    issues = beadsFns.listIssues();
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return [{
+      storyKey: "",
+      beadsId: "",
+      previousStatus: "",
+      newStatus: "",
+      synced: false,
+      error: `Failed to list beads issues: ${message}`
+    }];
+  }
+  const cachedListIssues = () => issues;
+  for (const issue of issues) {
+    const storyFilePath = resolveStoryFilePath(issue);
+    if (!storyFilePath) {
+      continue;
+    }
+    const storyKey = storyKeyFromPath(storyFilePath);
+    try {
+      if (direction === "beads-to-files" || direction === "bidirectional") {
+        const result = syncBeadsToStoryFile(issue.id, { listIssues: cachedListIssues }, root);
+        results.push(result);
+      } else if (direction === "files-to-beads") {
+        const result = syncStoryFileToBeads(storyKey, {
+          listIssues: cachedListIssues,
+          updateIssue: beadsFns.updateIssue,
+          closeIssue: beadsFns.closeIssue
+        }, root);
+        results.push(result);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      results.push({
+        storyKey,
+        beadsId: issue.id,
+        previousStatus: "",
+        newStatus: "",
+        synced: false,
+        error: message
+      });
+    }
+  }
+  return results;
+}
+
 // src/templates/showboat-template.ts
 function verificationSummaryBlock(criteria) {
   const total = criteria.length;
@@ -7558,7 +7532,7 @@ function registerTeardownCommand(program) {
     } else if (otlpMode === "remote-routed") {
       if (!options.keepDocker) {
         try {
-          const { stopCollectorOnly: stopCollectorOnly2 } = await import("./docker-XPXVRUOR.js");
+          const { stopCollectorOnly: stopCollectorOnly2 } = await import("./docker-F4U5KY6M.js");
           stopCollectorOnly2();
           result.docker.stopped = true;
           if (!isJson) {
@@ -7590,7 +7564,7 @@ function registerTeardownCommand(program) {
         info("Shared stack: kept running (other projects may use it)");
       }
     } else if (isLegacyStack) {
-      const { isStackRunning: isStackRunning2, stopStack } = await import("./docker-XPXVRUOR.js");
+      const { isStackRunning: isStackRunning2, stopStack } = await import("./docker-F4U5KY6M.js");
       let stackRunning = false;
       try {
         stackRunning = isStackRunning2(composeFile);
@@ -9489,7 +9463,7 @@ function registerAuditCommand(program) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.25.5" : "0.0.0-dev";
+var VERSION = true ? "0.25.6" : "0.0.0-dev";
 function createProgram() {
   const program = new Command();
   program.name("codeharness").description("Makes autonomous coding agents produce software that actually works").version(VERSION).option("--json", "Output in machine-readable JSON format");