codeharness 0.17.6 → 0.18.0

package/dist/index.js

@@ -19,8 +19,8 @@ import {
 import { Command } from "commander";
 
 // src/commands/init.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
-import { join as join6, basename as basename2 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
+import { join as join7, basename as basename2 } from "path";
 
 // src/lib/output.ts
 function ok(message, options) {
@@ -865,8 +865,8 @@ function configureHookCoexistence(dir) {
 
 // src/lib/bmad.ts
 import { execFileSync as execFileSync4 } from "child_process";
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
+import { join as join6 } from "path";
 
 // src/lib/patch-engine.ts
 import { readFileSync as readFileSync4, writeFileSync as writeFileSync4 } from "fs";
@@ -935,133 +935,81 @@ function removePatch(filePath, patchName) {
 }
 
 // src/templates/bmad-patches.ts
+import { readFileSync as readFileSync5, existsSync as existsSync5 } from "fs";
+import { join as join5, dirname as dirname2 } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname2(fileURLToPath(import.meta.url));
+function readPatchFile(name) {
+  const projectRoot = join5(__dirname, "..", "..");
+  const projectPath = join5(projectRoot, "patches", `${name}.md`);
+  if (existsSync5(projectPath)) {
+    return readFileSync5(projectPath, "utf-8").trim();
+  }
+  const pkgPath = join5(__dirname, "..", "..", "patches", `${name}.md`);
+  if (existsSync5(pkgPath)) {
+    return readFileSync5(pkgPath, "utf-8").trim();
+  }
+  return null;
+}
 function storyVerificationPatch() {
-  return `## Verification Requirements
+  return readPatchFile("story-verification") ?? `## Verification Requirements
 
-- [ ] Showboat proof document created (\`docs/exec-plans/active/<story-key>.proof.md\`)
-- [ ] All acceptance criteria verified with real-world evidence
+- [ ] Showboat proof document created (verification/<story-key>-proof.md)
+- [ ] All acceptance criteria verified with real-world evidence via docker exec
 - [ ] Test coverage meets target (100%)
 
-### Verification Tags
-
-For each AC, append a verification tag to indicate how it can be verified:
-- \`<!-- verification: cli-verifiable -->\` \u2014 AC can be verified by running CLI commands in a subprocess
-- \`<!-- verification: integration-required -->\` \u2014 AC requires integration testing, multi-system interaction, or manual verification
-
-ACs referencing workflows, sprint planning, user sessions, or external system interactions should be tagged as \`integration-required\`. If no tag is present, a heuristic classifier will attempt to determine verifiability at runtime.
-
 ## Documentation Requirements
 
-- [ ] Relevant AGENTS.md files updated (list modules touched)
-- [ ] Exec-plan created in \`docs/exec-plans/active/<story-key>.md\`
+- [ ] Relevant AGENTS.md files updated
+- [ ] Exec-plan created in docs/exec-plans/active/<story-key>.md
 
 ## Testing Requirements
 
 - [ ] Unit tests written for all new/changed code
-- [ ] Integration tests for cross-module interactions
 - [ ] Coverage target: 100%`;
 }
 function devEnforcementPatch() {
-  return `## Codeharness Enforcement
+  return readPatchFile("dev-enforcement") ?? `## Codeharness Enforcement
 
 ### Observability Check
 - [ ] Query VictoriaLogs after test runs to verify telemetry flows
-- [ ] Confirm logs, metrics, and traces are being collected
 
 ### Documentation Update
 - [ ] AGENTS.md updated for all changed modules
-- [ ] Exec-plan reflects current implementation state
 
 ### Test Enforcement
-- [ ] All tests pass (\`npm test\` / \`pytest\`)
-- [ ] Coverage gate: 100% of new/changed code
-- [ ] No skipped or pending tests without justification`;
+- [ ] All tests pass
+- [ ] Coverage gate: 100% of new/changed code`;
 }
 function reviewEnforcementPatch() {
-  return `## Codeharness Review Gates
+  return readPatchFile("review-enforcement") ?? `## Codeharness Review Gates
 
 ### Verification
-- [ ] Showboat proof document exists and passes \`showboat verify\`
+- [ ] Proof document exists and passes codeharness verify
 - [ ] All acceptance criteria have evidence in proof document
 
-### Documentation Freshness
-- [ ] AGENTS.md is current for all changed modules
-- [ ] No stale references to removed or renamed modules
-
 ### Coverage
-- [ ] Coverage delta reported (before vs after)
-- [ ] No coverage regression in changed files
-- [ ] Overall coverage meets project target`;
+- [ ] No coverage regression in changed files`;
 }
 function retroEnforcementPatch() {
-  return `## Codeharness Quality Metrics
+  return readPatchFile("retro-enforcement") ?? `## Codeharness Quality Metrics
 
 ### Verification Effectiveness
 - [ ] How many ACs were caught by verification vs manual review?
-- [ ] Were there any false positives in Showboat proofs?
-- [ ] Time spent on verification vs value delivered
-
-### Documentation Health
-- [ ] AGENTS.md accuracy grade (A/B/C/D/F)
-- [ ] Exec-plans completeness \u2014 are all active stories documented?
-- [ ] Stale documentation identified and cleaned up
+- [ ] Were there any false positives in proofs?
 
 ### Test Quality
-- [ ] Coverage trend (improving, stable, declining)
-- [ ] Test reliability \u2014 any flaky tests introduced?
-- [ ] Integration test coverage for cross-module interactions`;
+- [ ] Coverage trend (improving, stable, declining)`;
 }
 function sprintBeadsPatch() {
-  return `## Codeharness Backlog Integration
-
-### Pre-Triage Import Verification
-- [ ] Confirm \`codeharness retro-import\` was run for all completed retrospectives
-- [ ] Confirm \`codeharness github-import\` was run to pull labeled GitHub issues
-- [ ] Verify all sources are reflected in beads before starting triage
-
-### Beads Issue Status
-- [ ] Run \`bd ready\` to display issues ready for development
-- [ ] Review beads issue counts by status (open, in-progress, done)
-- [ ] Verify issues from all sources are visible: retro (\`[gap:retro:...]\`), GitHub (\`[source:github:...]\`), and manual
-- [ ] Verify no blocked issues without documented reason
+  return readPatchFile("sprint-planning") ?? `## Codeharness Sprint Planning
 
-### Sprint Readiness
-- [ ] All selected stories have corresponding beads issues
-- [ ] Dependencies between stories are reflected in beads deps
-- [ ] Capacity aligns with estimated story complexity`;
+- [ ] Review unresolved retrospective action items
+- [ ] Import from all backlog sources before triage
+- [ ] Verify story ACs are testable via CLI + Docker`;
 }
 function sprintPlanningRetroPatch() {
-  return `## Retrospective Action Items Review
-
-### Unresolved Action Items from Previous Retrospectives
-
-Before starting sprint planning, review all completed retrospectives for unresolved action items:
-
-1. **Scan for retrospective files:** Look for all \`epic-N-retrospective.md\` files in \`_bmad-output/implementation-artifacts/\`
-2. **Import retro findings to beads:** For each retrospective not yet imported, run \`codeharness retro-import --epic N\` to classify findings and create beads issues with \`[gap:retro:epic-N-item-M]\` gap-ids
-3. **Import GitHub issues to beads:** Run \`codeharness github-import\` to pull labeled issues into beads with \`[source:github:owner/repo#N]\` gap-ids
-4. **Display combined backlog:** Run \`bd ready\` to present the unified backlog containing retro findings, GitHub issues, and manually created issues
-5. **Identify unresolved items:** Filter for action items that are NOT marked as completed/done
-6. **Surface during planning:** Present unresolved items to the team before selecting stories for the sprint
-
-### Source-Aware Backlog Presentation
-
-When presenting the backlog during triage, issues should be identifiable by source:
-
-- **Retro findings** have gap-ids matching \`[gap:retro:...]\` \u2014 originated from retrospective action items
-- **GitHub issues** have gap-ids matching \`[source:github:...]\` \u2014 imported from GitHub via label query
-- **Manual issues** have no gap-id prefix \u2014 created directly in beads
-
-### Integration with Sprint Planning
-
-- [ ] All \`epic-N-retrospective.md\` files scanned for action items
-- [ ] \`codeharness retro-import --epic N\` run for each unimported retrospective
-- [ ] \`codeharness github-import\` run to pull labeled GitHub issues
-- [ ] \`bd ready\` run to display combined backlog from all sources
-- [ ] Unresolved action items listed and reviewed
-- [ ] Relevant action items incorporated into sprint goals or new stories
-- [ ] Recurring issues from multiple retros flagged for systemic fixes
-- [ ] All sources (retro, GitHub, manual) triaged uniformly \u2014 no source left unreviewed`;
+  return sprintBeadsPatch();
 }
 var PATCH_TEMPLATES = {
   "story-verification": storyVerificationPatch,
@@ -1090,15 +1038,15 @@ var PATCH_TARGETS = {
   "sprint-retro": "bmm/workflows/4-implementation/sprint-planning/instructions.md"
 };
 function isBmadInstalled(dir) {
-  const bmadDir = join5(dir ?? process.cwd(), "_bmad");
-  return existsSync5(bmadDir);
+  const bmadDir = join6(dir ?? process.cwd(), "_bmad");
+  return existsSync6(bmadDir);
 }
 function detectBmadVersion(dir) {
   const root = dir ?? process.cwd();
-  const moduleYamlPath = join5(root, "_bmad", "core", "module.yaml");
-  if (existsSync5(moduleYamlPath)) {
+  const moduleYamlPath = join6(root, "_bmad", "core", "module.yaml");
+  if (existsSync6(moduleYamlPath)) {
     try {
-      const content = readFileSync5(moduleYamlPath, "utf-8");
+      const content = readFileSync6(moduleYamlPath, "utf-8");
       const versionMatch = content.match(/version:\s*["']?([^\s"']+)["']?/);
       if (versionMatch) {
         return versionMatch[1];
@@ -1106,17 +1054,17 @@ function detectBmadVersion(dir) {
     } catch {
     }
   }
-  const versionFilePath = join5(root, "_bmad", "VERSION");
-  if (existsSync5(versionFilePath)) {
+  const versionFilePath = join6(root, "_bmad", "VERSION");
+  if (existsSync6(versionFilePath)) {
     try {
-      return readFileSync5(versionFilePath, "utf-8").trim() || null;
+      return readFileSync6(versionFilePath, "utf-8").trim() || null;
     } catch {
     }
   }
-  const packageJsonPath = join5(root, "_bmad", "package.json");
-  if (existsSync5(packageJsonPath)) {
+  const packageJsonPath = join6(root, "_bmad", "package.json");
+  if (existsSync6(packageJsonPath)) {
     try {
-      const pkg = JSON.parse(readFileSync5(packageJsonPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync6(packageJsonPath, "utf-8"));
       return pkg.version ?? null;
     } catch {
     }
@@ -1134,15 +1082,27 @@ function installBmad(dir) {
     };
   }
   const cmdStr = "npx bmad-method install";
-  try {
-    execFileSync4("npx", ["bmad-method", "install"], {
-      stdio: "pipe",
-      timeout: 6e4,
-      cwd: root
-    });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    throw new BmadError(cmdStr, message);
+  const maxAttempts = 3;
+  let lastError = "";
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      execFileSync4("npx", ["bmad-method", "install"], {
+        stdio: "pipe",
+        timeout: 12e4,
+        // 2 min — npx may download the package
+        cwd: root
+      });
+      lastError = "";
+      break;
+    } catch (err) {
+      lastError = err instanceof Error ? err.message : String(err);
+      if (attempt < maxAttempts) {
+        execFileSync4("sleep", ["2"]);
+      }
+    }
+  }
+  if (lastError) {
+    throw new BmadError(cmdStr, lastError);
   }
   if (!isBmadInstalled(root)) {
     throw new BmadError(cmdStr, "_bmad/ directory was not created after successful npx bmad-method install");
@@ -1158,8 +1118,8 @@ function applyAllPatches(dir) {
   const root = dir ?? process.cwd();
   const results = [];
   for (const [patchName, relativePath] of Object.entries(PATCH_TARGETS)) {
-    const targetFile = join5(root, "_bmad", relativePath);
-    if (!existsSync5(targetFile)) {
+    const targetFile = join6(root, "_bmad", relativePath);
+    if (!existsSync6(targetFile)) {
       warn(`Patch target not found: ${relativePath}`);
       results.push({
         patchName,
@@ -1206,12 +1166,12 @@ function applyAllPatches(dir) {
 function detectBmalph(dir) {
   const root = dir ?? process.cwd();
   const files = [];
-  const ralphRcPath = join5(root, ".ralph", ".ralphrc");
-  if (existsSync5(ralphRcPath)) {
+  const ralphRcPath = join6(root, ".ralph", ".ralphrc");
+  if (existsSync6(ralphRcPath)) {
     files.push(".ralph/.ralphrc");
   }
-  const dotRalphDir = join5(root, ".ralph");
-  if (existsSync5(dotRalphDir)) {
+  const dotRalphDir = join6(root, ".ralph");
+  if (existsSync6(dotRalphDir)) {
     if (files.length === 0) {
       files.push(".ralph/");
     }
@@ -1226,10 +1186,10 @@ function getStoryFilePath(storyKey) {
   return `_bmad-output/implementation-artifacts/${storyKey}.md`;
 }
 function parseEpicsFile(filePath) {
-  if (!existsSync5(filePath)) {
+  if (!existsSync6(filePath)) {
     return [];
   }
-  const content = readFileSync5(filePath, "utf-8");
+  const content = readFileSync6(filePath, "utf-8");
   if (!content.trim()) {
     return [];
   }
@@ -1443,12 +1403,12 @@ function getInstallCommand(stack) {
 }
 
 // src/commands/init.ts
-var HARNESS_VERSION = true ? "0.17.6" : "0.0.0-dev";
+var HARNESS_VERSION = true ? "0.18.0" : "0.0.0-dev";
 function getProjectName(projectDir) {
   try {
-    const pkgPath = join6(projectDir, "package.json");
-    if (existsSync6(pkgPath)) {
-      const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
+    const pkgPath = join7(projectDir, "package.json");
+    if (existsSync7(pkgPath)) {
+      const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
       if (pkg.name && typeof pkg.name === "string") {
         return pkg.name;
       }
@@ -1558,7 +1518,7 @@ function registerInitCommand(program) {
       }
     };
     const statePath = getStatePath(projectDir);
-    if (existsSync6(statePath)) {
+    if (existsSync7(statePath)) {
       try {
         const existingState = readState(projectDir);
         const legacyObsDisabled = existingState.enforcement.observability === false;
@@ -1820,27 +1780,27 @@ function registerInitCommand(program) {
     if (!isJson) {
       ok("State file: .claude/codeharness.local.md created");
     }
-    const agentsMdPath = join6(projectDir, "AGENTS.md");
-    if (!existsSync6(agentsMdPath)) {
+    const agentsMdPath = join7(projectDir, "AGENTS.md");
+    if (!existsSync7(agentsMdPath)) {
       const agentsMdContent = generateAgentsMdContent(projectDir, stack);
       generateFile(agentsMdPath, agentsMdContent);
       result.documentation.agents_md = "created";
     } else {
       result.documentation.agents_md = "exists";
     }
-    const docsDir = join6(projectDir, "docs");
-    if (!existsSync6(docsDir)) {
-      generateFile(join6(docsDir, "index.md"), generateDocsIndexContent());
-      generateFile(join6(docsDir, "exec-plans", "active", ".gitkeep"), "");
-      generateFile(join6(docsDir, "exec-plans", "completed", ".gitkeep"), "");
-      generateFile(join6(docsDir, "quality", ".gitkeep"), DO_NOT_EDIT_HEADER);
-      generateFile(join6(docsDir, "generated", ".gitkeep"), DO_NOT_EDIT_HEADER);
+    const docsDir = join7(projectDir, "docs");
+    if (!existsSync7(docsDir)) {
+      generateFile(join7(docsDir, "index.md"), generateDocsIndexContent());
+      generateFile(join7(docsDir, "exec-plans", "active", ".gitkeep"), "");
+      generateFile(join7(docsDir, "exec-plans", "completed", ".gitkeep"), "");
+      generateFile(join7(docsDir, "quality", ".gitkeep"), DO_NOT_EDIT_HEADER);
+      generateFile(join7(docsDir, "generated", ".gitkeep"), DO_NOT_EDIT_HEADER);
       result.documentation.docs_scaffold = "created";
     } else {
       result.documentation.docs_scaffold = "exists";
     }
-    const readmePath = join6(projectDir, "README.md");
-    if (!existsSync6(readmePath)) {
+    const readmePath = join7(projectDir, "README.md");
+    if (!existsSync7(readmePath)) {
       let cliHelpOutput = "";
       try {
         const { execFileSync: execFileSync8 } = await import("child_process");
@@ -2047,7 +2007,7 @@ function registerInitCommand(program) {
 }
 
 // src/commands/bridge.ts
-import { existsSync as existsSync7 } from "fs";
+import { existsSync as existsSync8 } from "fs";
 function registerBridgeCommand(program) {
   program.command("bridge").description("Bridge BMAD epics/stories into beads task store").option("--epics <path>", "Path to BMAD epics markdown file").option("--dry-run", "Parse and display without creating beads issues").action((opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
@@ -2059,7 +2019,7 @@ function registerBridgeCommand(program) {
       process.exitCode = 2;
       return;
     }
-    if (!existsSync7(epicsPath)) {
+    if (!existsSync8(epicsPath)) {
       fail(`Epics file not found: ${epicsPath}`, { json: isJson });
       process.exitCode = 1;
       return;
@@ -2132,13 +2092,13 @@ function registerBridgeCommand(program) {
 
 // src/commands/run.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync9, mkdirSync as mkdirSync3, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
-import { join as join8, dirname as dirname2 } from "path";
-import { fileURLToPath } from "url";
+import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync9, writeFileSync as writeFileSync6 } from "fs";
+import { join as join9, dirname as dirname3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/lib/beads-sync.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
+import { join as join8 } from "path";
 import { parse as parse2 } from "yaml";
 var BEADS_TO_STORY_STATUS = {
   open: "in-progress",
@@ -2169,10 +2129,10 @@ function resolveStoryFilePath(beadsIssue) {
   return trimmed;
 }
 function readStoryFileStatus(filePath) {
-  if (!existsSync8(filePath)) {
+  if (!existsSync9(filePath)) {
     return null;
   }
-  const content = readFileSync7(filePath, "utf-8");
+  const content = readFileSync8(filePath, "utf-8");
   const match = content.match(/^Status:\s*(.+)$/m);
   if (!match) {
     return null;
@@ -2180,7 +2140,7 @@ function readStoryFileStatus(filePath) {
   return match[1].trim();
 }
 function updateStoryFileStatus(filePath, newStatus) {
-  const content = readFileSync7(filePath, "utf-8");
+  const content = readFileSync8(filePath, "utf-8");
   const statusRegex = /^Status:\s*.+$/m;
   if (statusRegex.test(content)) {
     const updated = content.replace(statusRegex, `Status: ${newStatus}`);
@@ -2199,12 +2159,12 @@ function updateStoryFileStatus(filePath, newStatus) {
 var SPRINT_STATUS_PATH = "_bmad-output/implementation-artifacts/sprint-status.yaml";
 function readSprintStatus(dir) {
   const root = dir ?? process.cwd();
-  const filePath = join7(root, SPRINT_STATUS_PATH);
-  if (!existsSync8(filePath)) {
+  const filePath = join8(root, SPRINT_STATUS_PATH);
+  if (!existsSync9(filePath)) {
     return {};
   }
   try {
-    const content = readFileSync7(filePath, "utf-8");
+    const content = readFileSync8(filePath, "utf-8");
     const parsed = parse2(content);
     if (!parsed || typeof parsed !== "object") {
       return {};
@@ -2220,12 +2180,12 @@ function readSprintStatus(dir) {
 }
 function updateSprintStatus(storyKey, newStatus, dir) {
   const root = dir ?? process.cwd();
-  const filePath = join7(root, SPRINT_STATUS_PATH);
-  if (!existsSync8(filePath)) {
+  const filePath = join8(root, SPRINT_STATUS_PATH);
+  if (!existsSync9(filePath)) {
     warn(`sprint-status.yaml not found at ${filePath}, skipping update`);
     return;
   }
-  const content = readFileSync7(filePath, "utf-8");
+  const content = readFileSync8(filePath, "utf-8");
   const keyPattern = new RegExp(`^(\\s*${escapeRegExp(storyKey)}:\\s*)\\S+(.*)$`, "m");
   if (!keyPattern.test(content)) {
     return;
@@ -2252,8 +2212,8 @@ function slugify(title) {
 }
 function appendOnboardingEpicToSprint(stories, dir) {
   const root = dir ?? process.cwd();
-  const filePath = join7(root, SPRINT_STATUS_PATH);
-  if (!existsSync8(filePath)) {
+  const filePath = join8(root, SPRINT_STATUS_PATH);
+  if (!existsSync9(filePath)) {
     warn(`sprint-status.yaml not found at ${filePath}, cannot append onboarding epic`);
     return { epicNumber: -1, storyKeys: [] };
   }
@@ -2270,7 +2230,7 @@ function appendOnboardingEpicToSprint(stories, dir) {
   }
   lines.push(`  epic-${epicNum}-retrospective: optional`);
   lines.push("");
-  const content = readFileSync7(filePath, "utf-8");
+  const content = readFileSync8(filePath, "utf-8");
   const updated = content.trimEnd() + "\n" + lines.join("\n");
   writeFileSync5(filePath, updated, "utf-8");
   return { epicNumber: epicNum, storyKeys };
@@ -2305,7 +2265,7 @@ function syncBeadsToStoryFile(beadsId, beadsFns, dir) {
     };
   }
   const storyKey = storyKeyFromPath(storyFilePath);
-  const fullPath = join7(root, storyFilePath);
+  const fullPath = join8(root, storyFilePath);
   const currentStoryStatus = readStoryFileStatus(fullPath);
   if (currentStoryStatus === null) {
     return {
@@ -2350,7 +2310,7 @@ function syncBeadsToStoryFile(beadsId, beadsFns, dir) {
 function syncStoryFileToBeads(storyKey, beadsFns, dir) {
   const root = dir ?? process.cwd();
   const storyFilePath = `_bmad-output/implementation-artifacts/${storyKey}.md`;
-  const fullPath = join7(root, storyFilePath);
+  const fullPath = join8(root, storyFilePath);
   const currentStoryStatus = readStoryFileStatus(fullPath);
   if (currentStoryStatus === null) {
     return {
@@ -2439,10 +2399,10 @@ function syncClose(beadsId, beadsFns, dir) {
     };
   }
   const storyKey = storyKeyFromPath(storyFilePath);
-  const fullPath = join7(root, storyFilePath);
+  const fullPath = join8(root, storyFilePath);
   const previousStatus = readStoryFileStatus(fullPath);
   if (previousStatus === null) {
-    if (!existsSync8(fullPath)) {
+    if (!existsSync9(fullPath)) {
       return {
         storyKey,
         beadsId,
@@ -2587,16 +2547,16 @@ function generateRalphPrompt(config) {
 var SPRINT_STATUS_REL = "_bmad-output/implementation-artifacts/sprint-status.yaml";
 var STORY_KEY_PATTERN = /^\d+-\d+-/;
 function resolveRalphPath() {
-  const currentFile = fileURLToPath(import.meta.url);
-  const currentDir = dirname2(currentFile);
-  let root = dirname2(currentDir);
+  const currentFile = fileURLToPath2(import.meta.url);
+  const currentDir = dirname3(currentFile);
+  let root = dirname3(currentDir);
   if (root.endsWith("/src") || root.endsWith("\\src")) {
-    root = dirname2(root);
+    root = dirname3(root);
   }
-  return join8(root, "ralph", "ralph.sh");
+  return join9(root, "ralph", "ralph.sh");
 }
 function resolvePluginDir() {
-  return join8(process.cwd(), ".claude");
+  return join9(process.cwd(), ".claude");
 }
 function countStories(statuses) {
   let total = 0;
@@ -2647,19 +2607,19 @@ function registerRunCommand(program) {
     const isJson = !!globalOpts.json;
     const outputOpts = { json: isJson };
     const ralphPath = resolveRalphPath();
-    if (!existsSync9(ralphPath)) {
+    if (!existsSync10(ralphPath)) {
       fail("Ralph loop not found \u2014 reinstall codeharness", outputOpts);
       process.exitCode = 1;
       return;
     }
     const pluginDir = resolvePluginDir();
-    if (!existsSync9(pluginDir)) {
+    if (!existsSync10(pluginDir)) {
       fail("Plugin directory not found \u2014 run codeharness init first", outputOpts);
       process.exitCode = 1;
       return;
     }
     const projectDir = process.cwd();
-    const sprintStatusPath = join8(projectDir, SPRINT_STATUS_REL);
+    const sprintStatusPath = join9(projectDir, SPRINT_STATUS_REL);
     const statuses = readSprintStatus(projectDir);
     const counts = countStories(statuses);
     if (counts.total === 0) {
@@ -2678,12 +2638,12 @@ function registerRunCommand(program) {
       process.exitCode = 1;
       return;
     }
-    const promptFile = join8(projectDir, "ralph", ".harness-prompt.md");
-    const flaggedFilePath = join8(projectDir, "ralph", ".flagged_stories");
+    const promptFile = join9(projectDir, "ralph", ".harness-prompt.md");
+    const flaggedFilePath = join9(projectDir, "ralph", ".flagged_stories");
     let flaggedStories;
-    if (existsSync9(flaggedFilePath)) {
+    if (existsSync10(flaggedFilePath)) {
       try {
-        const flaggedContent = readFileSync8(flaggedFilePath, "utf-8");
+        const flaggedContent = readFileSync9(flaggedFilePath, "utf-8");
         flaggedStories = flaggedContent.split("\n").filter((s) => s.trim().length > 0);
       } catch {
       }
@@ -2694,7 +2654,7 @@ function registerRunCommand(program) {
       flaggedStories
     });
     try {
-      mkdirSync3(dirname2(promptFile), { recursive: true });
+      mkdirSync3(dirname3(promptFile), { recursive: true });
       writeFileSync6(promptFile, promptContent, "utf-8");
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
@@ -2733,10 +2693,10 @@ function registerRunCommand(program) {
         });
       });
       if (isJson) {
-        const statusFile = join8(projectDir, "ralph", "status.json");
-        if (existsSync9(statusFile)) {
+        const statusFile = join9(projectDir, "ralph", "status.json");
+        if (existsSync10(statusFile)) {
           try {
-            const statusData = JSON.parse(readFileSync8(statusFile, "utf-8"));
+            const statusData = JSON.parse(readFileSync9(statusFile, "utf-8"));
             const finalStatuses = readSprintStatus(projectDir);
             const finalCounts = countStories(finalStatuses);
             jsonOutput({
@@ -2786,11 +2746,11 @@ function registerRunCommand(program) {
 }
 
 // src/commands/verify.ts
-import { existsSync as existsSync13, readFileSync as readFileSync12 } from "fs";
-import { join as join11 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync13 } from "fs";
+import { join as join12 } from "path";
 
 // src/lib/verify-parser.ts
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync10 } from "fs";
 var UI_KEYWORDS = [
   "agent-browser",
   "screenshot",
@@ -2860,12 +2820,12 @@ function classifyAC(description) {
   return "general";
 }
 function parseStoryACs(storyFilePath) {
-  if (!existsSync10(storyFilePath)) {
+  if (!existsSync11(storyFilePath)) {
     throw new Error(
       `Story file not found: ${storyFilePath}. Ensure the story file exists at the expected path.`
     );
   }
-  const content = readFileSync9(storyFilePath, "utf-8");
+  const content = readFileSync10(storyFilePath, "utf-8");
   const lines = content.split("\n");
   let acSectionStart = -1;
   for (let i = 0; i < lines.length; i++) {
@@ -2926,21 +2886,21 @@ function parseStoryACs(storyFilePath) {
 
 // src/lib/verify.ts
 import { execFileSync as execFileSync5 } from "child_process";
-import { existsSync as existsSync12, mkdirSync as mkdirSync5, readFileSync as readFileSync11, writeFileSync as writeFileSync8 } from "fs";
-import { join as join10 } from "path";
+import { existsSync as existsSync13, mkdirSync as mkdirSync5, readFileSync as readFileSync12, writeFileSync as writeFileSync8 } from "fs";
+import { join as join11 } from "path";
 
 // src/lib/doc-health.ts
 import { execSync } from "child_process";
 import {
-  existsSync as existsSync11,
+  existsSync as existsSync12,
   mkdirSync as mkdirSync4,
-  readFileSync as readFileSync10,
+  readFileSync as readFileSync11,
   readdirSync as readdirSync2,
   statSync,
   unlinkSync,
   writeFileSync as writeFileSync7
 } from "fs";
-import { join as join9, relative } from "path";
+import { join as join10, relative } from "path";
 var DO_NOT_EDIT_HEADER2 = "<!-- DO NOT EDIT MANUALLY";
 var SOURCE_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".js", ".py"]);
 var DEFAULT_MODULE_THRESHOLD = 3;
@@ -2962,7 +2922,7 @@ function findModules(dir, threshold) {
     let sourceCount = 0;
     const subdirs = [];
     for (const entry of entries) {
-      const fullPath = join9(current, entry);
+      const fullPath = join10(current, entry);
       let stat;
       try {
         stat = statSync(fullPath);
@@ -2999,8 +2959,8 @@ function isTestFile(filename) {
   return filename.includes(".test.") || filename.includes(".spec.") || filename.includes("__tests__") || filename.startsWith("test_");
 }
 function isDocStale(docPath, codeDir) {
-  if (!existsSync11(docPath)) return true;
-  if (!existsSync11(codeDir)) return false;
+  if (!existsSync12(docPath)) return true;
+  if (!existsSync12(codeDir)) return false;
   const docMtime = statSync(docPath).mtime;
   const newestCode = getNewestSourceMtime(codeDir);
   if (newestCode === null) return false;
@@ -3018,7 +2978,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 = join10(current, entry);
       let stat;
       try {
         stat = statSync(fullPath);
@@ -3054,7 +3014,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 = join9(current, entry);
+      const fullPath = join10(current, entry);
       let stat;
       try {
         stat = statSync(fullPath);
@@ -3075,8 +3035,8 @@ function getSourceFilesInModule(modulePath) {
   return files;
 }
 function getMentionedFilesInAgentsMd(agentsPath) {
-  if (!existsSync11(agentsPath)) return [];
-  const content = readFileSync10(agentsPath, "utf-8");
+  if (!existsSync12(agentsPath)) return [];
+  const content = readFileSync11(agentsPath, "utf-8");
   const mentioned = /* @__PURE__ */ new Set();
   const filenamePattern = /[\w./-]*[\w-]+\.(?:ts|js|py)\b/g;
   let match;
@@ -3100,12 +3060,12 @@ function checkAgentsMdCompleteness(agentsPath, modulePath) {
 }
 function checkAgentsMdForModule(modulePath, dir) {
   const root = dir ?? process.cwd();
-  const fullModulePath = join9(root, modulePath);
-  let agentsPath = join9(fullModulePath, "AGENTS.md");
-  if (!existsSync11(agentsPath)) {
-    agentsPath = join9(root, "AGENTS.md");
+  const fullModulePath = join10(root, modulePath);
+  let agentsPath = join10(fullModulePath, "AGENTS.md");
+  if (!existsSync12(agentsPath)) {
+    agentsPath = join10(root, "AGENTS.md");
   }
-  if (!existsSync11(agentsPath)) {
+  if (!existsSync12(agentsPath)) {
     return {
       path: relative(root, agentsPath),
       grade: "missing",
@@ -3136,9 +3096,9 @@ function checkAgentsMdForModule(modulePath, dir) {
   };
 }
 function checkDoNotEditHeaders(docPath) {
-  if (!existsSync11(docPath)) return false;
+  if (!existsSync12(docPath)) return false;
   try {
-    const content = readFileSync10(docPath, "utf-8");
+    const content = readFileSync11(docPath, "utf-8");
     if (content.length === 0) return false;
     return content.trimStart().startsWith(DO_NOT_EDIT_HEADER2);
   } catch {
@@ -3150,17 +3110,17 @@ function scanDocHealth(dir) {
   const root = dir ?? process.cwd();
   const documents = [];
   const modules = findModules(root);
-  const rootAgentsPath = join9(root, "AGENTS.md");
-  if (existsSync11(rootAgentsPath)) {
+  const rootAgentsPath = join10(root, "AGENTS.md");
+  if (existsSync12(rootAgentsPath)) {
     if (modules.length > 0) {
       const docMtime = statSync(rootAgentsPath).mtime;
       let allMissing = [];
       let staleModule = "";
       let newestCode = null;
       for (const mod of modules) {
-        const fullModPath = join9(root, mod);
-        const modAgentsPath = join9(fullModPath, "AGENTS.md");
-        if (existsSync11(modAgentsPath)) continue;
+        const fullModPath = join10(root, mod);
+        const modAgentsPath = join10(fullModPath, "AGENTS.md");
+        if (existsSync12(modAgentsPath)) continue;
         const { missing } = checkAgentsMdCompleteness(rootAgentsPath, fullModPath);
         if (missing.length > 0 && staleModule === "") {
           staleModule = mod;
@@ -3208,8 +3168,8 @@ function scanDocHealth(dir) {
     });
   }
   for (const mod of modules) {
-    const modAgentsPath = join9(root, mod, "AGENTS.md");
-    if (existsSync11(modAgentsPath)) {
+    const modAgentsPath = join10(root, mod, "AGENTS.md");
+    if (existsSync12(modAgentsPath)) {
       const result = checkAgentsMdForModule(mod, root);
       if (result.path !== "AGENTS.md") {
         documents.push(result);
@@ -3217,9 +3177,9 @@ function scanDocHealth(dir) {
       }
     }
   }
-  const indexPath = join9(root, "docs", "index.md");
-  if (existsSync11(indexPath)) {
-    const content = readFileSync10(indexPath, "utf-8");
+  const indexPath = join10(root, "docs", "index.md");
+  if (existsSync12(indexPath)) {
+    const content = readFileSync11(indexPath, "utf-8");
     const hasAbsolutePaths = /https?:\/\/|file:\/\//i.test(content);
     documents.push({
       path: "docs/index.md",
@@ -3229,11 +3189,11 @@ function scanDocHealth(dir) {
       reason: hasAbsolutePaths ? "Contains absolute URLs (may violate NFR25)" : "Uses relative paths"
     });
   }
-  const activeDir = join9(root, "docs", "exec-plans", "active");
-  if (existsSync11(activeDir)) {
+  const activeDir = join10(root, "docs", "exec-plans", "active");
+  if (existsSync12(activeDir)) {
     const files = readdirSync2(activeDir).filter((f) => f.endsWith(".md"));
     for (const file of files) {
-      const filePath = join9(activeDir, file);
+      const filePath = join10(activeDir, file);
       documents.push({
         path: `docs/exec-plans/active/${file}`,
         grade: "fresh",
@@ -3244,11 +3204,11 @@ function scanDocHealth(dir) {
     }
   }
   for (const subdir of ["quality", "generated"]) {
-    const dirPath = join9(root, "docs", subdir);
-    if (!existsSync11(dirPath)) continue;
+    const dirPath = join10(root, "docs", subdir);
+    if (!existsSync12(dirPath)) continue;
     const files = readdirSync2(dirPath).filter((f) => !f.startsWith("."));
     for (const file of files) {
-      const filePath = join9(dirPath, file);
+      const filePath = join10(dirPath, file);
       let stat;
       try {
         stat = statSync(filePath);
@@ -3281,7 +3241,7 @@ function scanDocHealth(dir) {
 }
 function checkAgentsMdLineCount(filePath, docPath, documents) {
   try {
-    const content = readFileSync10(filePath, "utf-8");
+    const content = readFileSync11(filePath, "utf-8");
     const lineCount = content.split("\n").length;
     if (lineCount > 100) {
       documents.push({
@@ -3319,15 +3279,15 @@ function checkStoryDocFreshness(storyId, dir) {
   for (const mod of modulesToCheck) {
     const result = checkAgentsMdForModule(mod, root);
     documents.push(result);
-    const moduleAgentsPath = join9(root, mod, "AGENTS.md");
-    const actualAgentsPath = existsSync11(moduleAgentsPath) ? moduleAgentsPath : join9(root, "AGENTS.md");
-    if (existsSync11(actualAgentsPath)) {
+    const moduleAgentsPath = join10(root, mod, "AGENTS.md");
+    const actualAgentsPath = existsSync12(moduleAgentsPath) ? moduleAgentsPath : join10(root, "AGENTS.md");
+    if (existsSync12(actualAgentsPath)) {
       checkAgentsMdLineCount(actualAgentsPath, result.path, documents);
     }
   }
   if (modulesToCheck.length === 0) {
-    const rootAgentsPath = join9(root, "AGENTS.md");
-    if (existsSync11(rootAgentsPath)) {
+    const rootAgentsPath = join10(root, "AGENTS.md");
+    if (existsSync12(rootAgentsPath)) {
       documents.push({
         path: "AGENTS.md",
         grade: "fresh",
@@ -3365,11 +3325,11 @@ function getRecentlyChangedFiles(dir) {
 }
 function completeExecPlan(storyId, dir) {
   const root = dir ?? process.cwd();
-  const activePath = join9(root, "docs", "exec-plans", "active", `${storyId}.md`);
-  if (!existsSync11(activePath)) {
+  const activePath = join10(root, "docs", "exec-plans", "active", `${storyId}.md`);
+  if (!existsSync12(activePath)) {
     return null;
   }
-  let content = readFileSync10(activePath, "utf-8");
+  let content = readFileSync11(activePath, "utf-8");
   content = content.replace(/^Status:\s*active$/m, "Status: completed");
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   content = content.replace(
@@ -3377,9 +3337,9 @@ function completeExecPlan(storyId, dir) {
     `$1
 Completed: ${timestamp}`
   );
-  const completedDir = join9(root, "docs", "exec-plans", "completed");
+  const completedDir = join10(root, "docs", "exec-plans", "completed");
   mkdirSync4(completedDir, { recursive: true });
-  const completedPath = join9(completedDir, `${storyId}.md`);
+  const completedPath = join10(completedDir, `${storyId}.md`);
   writeFileSync7(completedPath, content, "utf-8");
   try {
     unlinkSync(activePath);
@@ -3571,8 +3531,8 @@ function checkPreconditions(dir, storyId) {
 }
 function createProofDocument(storyId, storyTitle, acs, dir) {
   const root = dir ?? process.cwd();
-  const verificationDir = join10(root, "verification");
-  const screenshotsDir = join10(verificationDir, "screenshots");
+  const verificationDir = join11(root, "verification");
+  const screenshotsDir = join11(verificationDir, "screenshots");
   mkdirSync5(verificationDir, { recursive: true });
   mkdirSync5(screenshotsDir, { recursive: true });
   const criteria = acs.map((ac) => ({
@@ -3586,7 +3546,7 @@ function createProofDocument(storyId, storyTitle, acs, dir) {
     storyTitle,
     acceptanceCriteria: criteria
   });
-  const proofPath = join10(verificationDir, `${storyId}-proof.md`);
+  const proofPath = join11(verificationDir, `${storyId}-proof.md`);
   writeFileSync8(proofPath, content, "utf-8");
   return proofPath;
 }
@@ -3620,10 +3580,10 @@ function validateProofQuality(proofPath) {
     otherCount: 0,
     blackBoxPass: false
   };
-  if (!existsSync12(proofPath)) {
+  if (!existsSync13(proofPath)) {
     return emptyResult;
   }
-  const content = readFileSync11(proofPath, "utf-8");
+  const content = readFileSync12(proofPath, "utf-8");
   const bbEnforcement = checkBlackBoxEnforcement(content);
   function buildResult(base) {
     const basePassed = base.pending === 0 && base.verified > 0;
@@ -3827,8 +3787,8 @@ function verifyRetro(opts, isJson, root) {
     return;
   }
   const retroFile = `epic-${epicNum}-retrospective.md`;
-  const retroPath = join11(root, STORY_DIR, retroFile);
-  if (!existsSync13(retroPath)) {
+  const retroPath = join12(root, STORY_DIR, retroFile);
+  if (!existsSync14(retroPath)) {
     if (isJson) {
       jsonOutput({ status: "fail", epic: epicNum, retroFile, message: `${retroFile} not found` });
     } else {
@@ -3845,7 +3805,7 @@ function verifyRetro(opts, isJson, root) {
     warn(`Failed to update sprint status: ${message}`);
   }
   if (isJson) {
-    jsonOutput({ status: "ok", epic: epicNum, retroFile: join11(STORY_DIR, retroFile) });
+    jsonOutput({ status: "ok", epic: epicNum, retroFile: join12(STORY_DIR, retroFile) });
   } else {
     ok(`Epic ${epicNum} retrospective: marked done`);
   }
@@ -3856,8 +3816,8 @@ function verifyStory(storyId, isJson, root) {
     process.exitCode = 1;
     return;
   }
-  const readmePath = join11(root, "README.md");
-  if (!existsSync13(readmePath)) {
+  const readmePath = join12(root, "README.md");
+  if (!existsSync14(readmePath)) {
     if (isJson) {
       jsonOutput({ status: "fail", message: "No README.md found \u2014 verification requires user documentation" });
     } else {
@@ -3866,8 +3826,8 @@ function verifyStory(storyId, isJson, root) {
     process.exitCode = 1;
     return;
   }
-  const storyFilePath = join11(root, STORY_DIR, `${storyId}.md`);
-  if (!existsSync13(storyFilePath)) {
+  const storyFilePath = join12(root, STORY_DIR, `${storyId}.md`);
+  if (!existsSync14(storyFilePath)) {
     fail(`Story file not found: ${storyFilePath}`, { json: isJson });
     process.exitCode = 1;
     return;
@@ -3907,8 +3867,8 @@ function verifyStory(storyId, isJson, root) {
     return;
   }
   const storyTitle = extractStoryTitle(storyFilePath);
-  const expectedProofPath = join11(root, "verification", `${storyId}-proof.md`);
-  const proofPath = existsSync13(expectedProofPath) ? expectedProofPath : createProofDocument(storyId, storyTitle, acs, root);
+  const expectedProofPath = join12(root, "verification", `${storyId}-proof.md`);
+  const proofPath = existsSync14(expectedProofPath) ? expectedProofPath : createProofDocument(storyId, storyTitle, acs, root);
   const proofQuality = validateProofQuality(proofPath);
   if (!proofQuality.passed) {
     if (isJson) {
@@ -4002,7 +3962,7 @@ function verifyStory(storyId, isJson, root) {
 }
 function extractStoryTitle(filePath) {
   try {
-    const content = readFileSync12(filePath, "utf-8");
+    const content = readFileSync13(filePath, "utf-8");
     const match = /^#\s+(.+)$/m.exec(content);
     return match ? match[1] : "Unknown Story";
   } catch {
@@ -4011,14 +3971,14 @@ function extractStoryTitle(filePath) {
 }
 
 // src/lib/onboard-checks.ts
-import { existsSync as existsSync15 } from "fs";
-import { join as join13, dirname as dirname3 } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { existsSync as existsSync16 } from "fs";
+import { join as join14, dirname as dirname4 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/lib/coverage.ts
 import { execSync as execSync2 } from "child_process";
-import { existsSync as existsSync14, readFileSync as readFileSync13 } from "fs";
-import { join as join12 } from "path";
+import { existsSync as existsSync15, readFileSync as readFileSync14 } from "fs";
+import { join as join13 } from "path";
 function detectCoverageTool(dir) {
   const baseDir = dir ?? process.cwd();
   const stateHint = getStateToolHint(baseDir);
@@ -4041,16 +4001,16 @@ function getStateToolHint(dir) {
   }
 }
 function detectNodeCoverageTool(dir, stateHint) {
-  const hasVitestConfig = existsSync14(join12(dir, "vitest.config.ts")) || existsSync14(join12(dir, "vitest.config.js"));
-  const pkgPath = join12(dir, "package.json");
+  const hasVitestConfig = existsSync15(join13(dir, "vitest.config.ts")) || existsSync15(join13(dir, "vitest.config.js"));
+  const pkgPath = join13(dir, "package.json");
   let hasVitestCoverageV8 = false;
   let hasVitestCoverageIstanbul = false;
   let hasC8 = false;
   let hasJest = false;
   let pkgScripts = {};
-  if (existsSync14(pkgPath)) {
+  if (existsSync15(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync14(pkgPath, "utf-8"));
       const allDeps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
       hasVitestCoverageV8 = "@vitest/coverage-v8" in allDeps;
       hasVitestCoverageIstanbul = "@vitest/coverage-istanbul" in allDeps;
@@ -4103,10 +4063,10 @@ function getNodeTestCommand(scripts, runner) {
   return "npm test";
 }
 function detectPythonCoverageTool(dir) {
-  const reqPath = join12(dir, "requirements.txt");
-  if (existsSync14(reqPath)) {
+  const reqPath = join13(dir, "requirements.txt");
+  if (existsSync15(reqPath)) {
     try {
-      const content = readFileSync13(reqPath, "utf-8");
+      const content = readFileSync14(reqPath, "utf-8");
       if (content.includes("pytest-cov") || content.includes("coverage")) {
         return {
           tool: "coverage.py",
@@ -4117,10 +4077,10 @@ function detectPythonCoverageTool(dir) {
     } catch {
     }
   }
-  const pyprojectPath = join12(dir, "pyproject.toml");
-  if (existsSync14(pyprojectPath)) {
+  const pyprojectPath = join13(dir, "pyproject.toml");
+  if (existsSync15(pyprojectPath)) {
     try {
-      const content = readFileSync13(pyprojectPath, "utf-8");
+      const content = readFileSync14(pyprojectPath, "utf-8");
       if (content.includes("pytest-cov") || content.includes("coverage")) {
         return {
           tool: "coverage.py",
@@ -4202,7 +4162,7 @@ function parseVitestCoverage(dir) {
     return 0;
   }
   try {
-    const report = JSON.parse(readFileSync13(reportPath, "utf-8"));
+    const report = JSON.parse(readFileSync14(reportPath, "utf-8"));
     return report.total?.statements?.pct ?? 0;
   } catch {
     warn("Failed to parse coverage report");
@@ -4210,13 +4170,13 @@ function parseVitestCoverage(dir) {
   }
 }
 function parsePythonCoverage(dir) {
-  const reportPath = join12(dir, "coverage.json");
-  if (!existsSync14(reportPath)) {
+  const reportPath = join13(dir, "coverage.json");
+  if (!existsSync15(reportPath)) {
     warn("Coverage report not found at coverage.json");
     return 0;
   }
   try {
-    const report = JSON.parse(readFileSync13(reportPath, "utf-8"));
+    const report = JSON.parse(readFileSync14(reportPath, "utf-8"));
     return report.totals?.percent_covered ?? 0;
   } catch {
     warn("Failed to parse coverage report");
@@ -4317,7 +4277,7 @@ function checkPerFileCoverage(floor, dir) {
   }
   let report;
   try {
-    report = JSON.parse(readFileSync13(reportPath, "utf-8"));
+    report = JSON.parse(readFileSync14(reportPath, "utf-8"));
   } catch {
     warn("Failed to parse coverage-summary.json");
     return { floor, violations: [], totalFiles: 0 };
@@ -4347,11 +4307,11 @@ function checkPerFileCoverage(floor, dir) {
 }
 function findCoverageSummary(dir) {
   const candidates = [
-    join12(dir, "coverage", "coverage-summary.json"),
-    join12(dir, "src", "coverage", "coverage-summary.json")
+    join13(dir, "coverage", "coverage-summary.json"),
+    join13(dir, "src", "coverage", "coverage-summary.json")
   ];
   for (const p of candidates) {
-    if (existsSync14(p)) return p;
+    if (existsSync15(p)) return p;
   }
   return null;
 }
@@ -4376,16 +4336,16 @@ function printCoverageOutput(result, evaluation) {
 // src/lib/onboard-checks.ts
 function checkHarnessInitialized(dir) {
   const statePath = getStatePath(dir ?? process.cwd());
-  return { ok: existsSync15(statePath) };
+  return { ok: existsSync16(statePath) };
 }
 function checkBmadInstalled(dir) {
   return { ok: isBmadInstalled(dir) };
 }
 function checkHooksRegistered(dir) {
-  const __filename = fileURLToPath2(import.meta.url);
-  const __dirname = dirname3(__filename);
-  const hooksPath = join13(__dirname, "..", "..", "hooks", "hooks.json");
-  return { ok: existsSync15(hooksPath) };
+  const __filename = fileURLToPath3(import.meta.url);
+  const __dirname2 = dirname4(__filename);
+  const hooksPath = join14(__dirname2, "..", "..", "hooks", "hooks.json");
+  return { ok: existsSync16(hooksPath) };
 }
 function runPreconditions(dir) {
   const harnessCheck = checkHarnessInitialized(dir);
@@ -4425,8 +4385,8 @@ function findVerificationGaps(dir) {
   for (const [key, status] of Object.entries(statuses)) {
     if (status !== "done") continue;
     if (!STORY_KEY_PATTERN2.test(key)) continue;
-    const proofPath = join13(root, "verification", `${key}-proof.md`);
-    if (!existsSync15(proofPath)) {
+    const proofPath = join14(root, "verification", `${key}-proof.md`);
+    if (!existsSync16(proofPath)) {
       unverified.push(key);
     }
   }
@@ -4632,29 +4592,18 @@ function handleFullStatus(isJson) {
       const composeFile = state.docker?.compose_file ?? "docker-compose.harness.yml";
       const stackDir = getStackDir();
       const isShared = composeFile.startsWith(stackDir);
-      if (isShared) {
-        console.log(`Docker: shared stack at ~/.codeharness/stack/`);
-        const sharedComposeFile = getComposeFilePath();
-        const health = getStackHealth(sharedComposeFile, "codeharness-shared");
-        for (const svc of health.services) {
-          console.log(`  ${svc.name}: ${svc.running ? "running" : "stopped"}`);
-        }
-        if (health.healthy) {
-          console.log(
-            `  Endpoints: logs=${DEFAULT_ENDPOINTS.logs} metrics=${DEFAULT_ENDPOINTS.metrics} traces=${DEFAULT_ENDPOINTS.traces}`
-          );
-        }
-      } else {
-        const health = getStackHealth(composeFile);
-        console.log("Docker:");
-        for (const svc of health.services) {
-          console.log(`  ${svc.name}: ${svc.running ? "running" : "stopped"}`);
-        }
-        if (health.healthy) {
-          console.log(
-            `  Endpoints: logs=${DEFAULT_ENDPOINTS.logs} metrics=${DEFAULT_ENDPOINTS.metrics} traces=${DEFAULT_ENDPOINTS.traces}`
-          );
-        }
+      const resolvedComposeFile = isShared ? getComposeFilePath() : composeFile;
+      const projectName = isShared ? "codeharness-shared" : void 0;
+      const header = isShared ? "Docker: shared stack at ~/.codeharness/stack/" : "Docker:";
+      console.log(header);
+      const health = getStackHealth(resolvedComposeFile, projectName);
+      for (const svc of health.services) {
+        console.log(`  ${svc.name}: ${svc.running ? "running" : "stopped"}`);
+      }
+      if (health.healthy) {
+        console.log(
+          `  Endpoints: logs=${DEFAULT_ENDPOINTS.logs} metrics=${DEFAULT_ENDPOINTS.metrics} traces=${DEFAULT_ENDPOINTS.traces}`
+        );
       }
     }
   }
@@ -5011,16 +4960,16 @@ function getBeadsData() {
 }
 
 // src/commands/onboard.ts
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 
 // src/lib/scanner.ts
 import {
-  existsSync as existsSync16,
+  existsSync as existsSync17,
   readdirSync as readdirSync3,
-  readFileSync as readFileSync14,
+  readFileSync as readFileSync15,
   statSync as statSync2
 } from "fs";
-import { join as join14, relative as relative2 } from "path";
+import { join as join15, relative as relative2 } from "path";
 var SOURCE_EXTENSIONS2 = /* @__PURE__ */ new Set([".ts", ".js", ".py"]);
 var DEFAULT_MIN_MODULE_SIZE = 3;
 function getExtension2(filename) {
@@ -5045,7 +4994,7 @@ function countSourceFiles(dir) {
     for (const entry of entries) {
       if (isSkippedDir(entry)) continue;
       if (entry.startsWith(".") && current !== dir) continue;
-      const fullPath = join14(current, entry);
+      const fullPath = join15(current, entry);
       let stat;
       try {
         stat = statSync2(fullPath);
@@ -5068,7 +5017,7 @@ function countSourceFiles(dir) {
   return count;
 }
 function countModuleFiles(modulePath, rootDir) {
-  const fullModulePath = join14(rootDir, modulePath);
+  const fullModulePath = join15(rootDir, modulePath);
   let sourceFiles = 0;
   let testFiles = 0;
   function walk(current) {
@@ -5080,7 +5029,7 @@ function countModuleFiles(modulePath, rootDir) {
     }
     for (const entry of entries) {
       if (isSkippedDir(entry)) continue;
-      const fullPath = join14(current, entry);
+      const fullPath = join15(current, entry);
       let stat;
       try {
         stat = statSync2(fullPath);
@@ -5105,8 +5054,8 @@ function countModuleFiles(modulePath, rootDir) {
   return { sourceFiles, testFiles };
 }
 function detectArtifacts(dir) {
-  const bmadPath = join14(dir, "_bmad");
-  const hasBmad = existsSync16(bmadPath);
+  const bmadPath = join15(dir, "_bmad");
+  const hasBmad = existsSync17(bmadPath);
   return {
     hasBmad,
     bmadPath: hasBmad ? relative2(dir, bmadPath) || "_bmad" : null
@@ -5188,10 +5137,10 @@ function readPerFileCoverage(dir, format) {
   return null;
 }
 function readVitestPerFileCoverage(dir) {
-  const reportPath = join14(dir, "coverage", "coverage-summary.json");
-  if (!existsSync16(reportPath)) return null;
+  const reportPath = join15(dir, "coverage", "coverage-summary.json");
+  if (!existsSync17(reportPath)) return null;
   try {
-    const report = JSON.parse(readFileSync14(reportPath, "utf-8"));
+    const report = JSON.parse(readFileSync15(reportPath, "utf-8"));
     const result = /* @__PURE__ */ new Map();
     for (const [key, value] of Object.entries(report)) {
       if (key === "total") continue;
@@ -5203,10 +5152,10 @@ function readVitestPerFileCoverage(dir) {
   }
 }
 function readPythonPerFileCoverage(dir) {
-  const reportPath = join14(dir, "coverage.json");
-  if (!existsSync16(reportPath)) return null;
+  const reportPath = join15(dir, "coverage.json");
+  if (!existsSync17(reportPath)) return null;
   try {
-    const report = JSON.parse(readFileSync14(reportPath, "utf-8"));
+    const report = JSON.parse(readFileSync15(reportPath, "utf-8"));
     if (!report.files) return null;
     const result = /* @__PURE__ */ new Map();
     for (const [key, value] of Object.entries(report.files)) {
@@ -5222,13 +5171,13 @@ function auditDocumentation(dir) {
   const root = dir ?? process.cwd();
   const documents = [];
   for (const docName of AUDIT_DOCUMENTS) {
-    const docPath = join14(root, docName);
-    if (!existsSync16(docPath)) {
+    const docPath = join15(root, docName);
+    if (!existsSync17(docPath)) {
       documents.push({ name: docName, grade: "missing", path: null });
       continue;
     }
-    const srcDir = join14(root, "src");
-    const codeDir = existsSync16(srcDir) ? srcDir : root;
+    const srcDir = join15(root, "src");
+    const codeDir = existsSync17(srcDir) ? srcDir : root;
     const stale = isDocStale(docPath, codeDir);
     documents.push({
       name: docName,
@@ -5236,8 +5185,8 @@ function auditDocumentation(dir) {
       path: docName
     });
   }
-  const docsDir = join14(root, "docs");
-  if (existsSync16(docsDir)) {
+  const docsDir = join15(root, "docs");
+  if (existsSync17(docsDir)) {
     try {
       const stat = statSync2(docsDir);
       if (stat.isDirectory()) {
@@ -5249,10 +5198,10 @@ function auditDocumentation(dir) {
   } else {
     documents.push({ name: "docs/", grade: "missing", path: null });
   }
-  const indexPath = join14(root, "docs", "index.md");
-  if (existsSync16(indexPath)) {
-    const srcDir = join14(root, "src");
-    const indexCodeDir = existsSync16(srcDir) ? srcDir : root;
+  const indexPath = join15(root, "docs", "index.md");
+  if (existsSync17(indexPath)) {
+    const srcDir = join15(root, "src");
+    const indexCodeDir = existsSync17(srcDir) ? srcDir : root;
     const indexStale = isDocStale(indexPath, indexCodeDir);
     documents.push({
       name: "docs/index.md",
@@ -5269,8 +5218,8 @@ function auditDocumentation(dir) {
 
 // src/lib/epic-generator.ts
 import { createInterface } from "readline";
-import { existsSync as existsSync17, mkdirSync as mkdirSync6, writeFileSync as writeFileSync9 } from "fs";
-import { dirname as dirname4, join as join15 } from "path";
+import { existsSync as existsSync18, mkdirSync as mkdirSync6, writeFileSync as writeFileSync9 } from "fs";
+import { dirname as dirname5, join as join16 } from "path";
 var PRIORITY_BY_TYPE = {
   observability: 1,
   coverage: 2,
@@ -5308,8 +5257,8 @@ function generateOnboardingEpic(scan, coverage, audit, rootDir) {
     storyNum++;
   }
   for (const mod of scan.modules) {
-    const agentsPath = join15(root, mod.path, "AGENTS.md");
-    if (!existsSync17(agentsPath)) {
+    const agentsPath = join16(root, mod.path, "AGENTS.md");
+    if (!existsSync18(agentsPath)) {
       stories.push({
         key: `0.${storyNum}`,
         title: `Create ${mod.path}/AGENTS.md`,
@@ -5375,7 +5324,7 @@ function generateOnboardingEpic(scan, coverage, audit, rootDir) {
   };
 }
 function writeOnboardingEpic(epic, outputPath) {
-  mkdirSync6(dirname4(outputPath), { recursive: true });
+  mkdirSync6(dirname5(outputPath), { recursive: true });
   const lines = [];
   lines.push(`# ${epic.title}`);
   lines.push("");
@@ -5507,29 +5456,29 @@ function getGapIdFromTitle(title) {
 }
 
 // src/lib/scan-cache.ts
-import { existsSync as existsSync18, mkdirSync as mkdirSync7, readFileSync as readFileSync15, writeFileSync as writeFileSync10 } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync19, mkdirSync as mkdirSync7, readFileSync as readFileSync16, writeFileSync as writeFileSync10 } from "fs";
+import { join as join17 } from "path";
 var CACHE_DIR = ".harness";
 var CACHE_FILE = "last-onboard-scan.json";
 var DEFAULT_MAX_AGE_MS = 864e5;
 function saveScanCache(entry, dir) {
   try {
     const root = dir ?? process.cwd();
-    const cacheDir = join16(root, CACHE_DIR);
+    const cacheDir = join17(root, CACHE_DIR);
     mkdirSync7(cacheDir, { recursive: true });
-    const cachePath = join16(cacheDir, CACHE_FILE);
+    const cachePath = join17(cacheDir, CACHE_FILE);
     writeFileSync10(cachePath, JSON.stringify(entry, null, 2), "utf-8");
   } catch {
   }
 }
 function loadScanCache(dir) {
   const root = dir ?? process.cwd();
-  const cachePath = join16(root, CACHE_DIR, CACHE_FILE);
-  if (!existsSync18(cachePath)) {
+  const cachePath = join17(root, CACHE_DIR, CACHE_FILE);
+  if (!existsSync19(cachePath)) {
     return null;
   }
   try {
-    const raw = readFileSync15(cachePath, "utf-8");
+    const raw = readFileSync16(cachePath, "utf-8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -5702,7 +5651,7 @@ function registerOnboardCommand(program) {
     }
     coverage = lastCoverageResult ?? runCoverageAnalysis(scan);
     audit = lastAuditResult ?? runAudit();
-    const epicPath = join17(process.cwd(), "ralph", "onboarding-epic.md");
+    const epicPath = join18(process.cwd(), "ralph", "onboarding-epic.md");
     const epic = generateOnboardingEpic(scan, coverage, audit);
     mergeExtendedGaps(epic);
     if (!isFull) {
@@ -5775,7 +5724,7 @@ function registerOnboardCommand(program) {
       coverage,
       audit
     });
-    const epicPath = join17(process.cwd(), "ralph", "onboarding-epic.md");
+    const epicPath = join18(process.cwd(), "ralph", "onboarding-epic.md");
     const epic = generateOnboardingEpic(scan, coverage, audit);
     mergeExtendedGaps(epic);
     if (!isFull) {
@@ -5883,8 +5832,8 @@ function printEpicOutput(epic) {
 }
 
 // src/commands/teardown.ts
-import { existsSync as existsSync19, unlinkSync as unlinkSync2, readFileSync as readFileSync16, writeFileSync as writeFileSync11, rmSync } from "fs";
-import { join as join18 } from "path";
+import { existsSync as existsSync20, unlinkSync as unlinkSync2, readFileSync as readFileSync17, writeFileSync as writeFileSync11, rmSync } from "fs";
+import { join as join19 } from "path";
 function buildDefaultResult() {
   return {
     status: "ok",
@@ -5987,16 +5936,16 @@ function registerTeardownCommand(program) {
           info("Docker stack: not running, skipping");
         }
       }
-      const composeFilePath = join18(projectDir, composeFile);
-      if (existsSync19(composeFilePath)) {
+      const composeFilePath = join19(projectDir, composeFile);
+      if (existsSync20(composeFilePath)) {
         unlinkSync2(composeFilePath);
         result.removed.push(composeFile);
         if (!isJson) {
           ok(`Removed: ${composeFile}`);
         }
       }
-      const otelConfigPath = join18(projectDir, "otel-collector-config.yaml");
-      if (existsSync19(otelConfigPath)) {
+      const otelConfigPath = join19(projectDir, "otel-collector-config.yaml");
+      if (existsSync20(otelConfigPath)) {
         unlinkSync2(otelConfigPath);
         result.removed.push("otel-collector-config.yaml");
         if (!isJson) {
@@ -6006,8 +5955,8 @@ function registerTeardownCommand(program) {
     }
     let patchesRemoved = 0;
     for (const [patchName, relativePath] of Object.entries(PATCH_TARGETS)) {
-      const filePath = join18(projectDir, "_bmad", relativePath);
-      if (!existsSync19(filePath)) {
+      const filePath = join19(projectDir, "_bmad", relativePath);
+      if (!existsSync20(filePath)) {
         continue;
       }
       try {
@@ -6027,10 +5976,10 @@ function registerTeardownCommand(program) {
       }
     }
     if (state.otlp?.enabled && state.stack === "nodejs") {
-      const pkgPath = join18(projectDir, "package.json");
-      if (existsSync19(pkgPath)) {
+      const pkgPath = join19(projectDir, "package.json");
+      if (existsSync20(pkgPath)) {
         try {
-          const raw = readFileSync16(pkgPath, "utf-8");
+          const raw = readFileSync17(pkgPath, "utf-8");
           const pkg = JSON.parse(raw);
           const scripts = pkg["scripts"];
           if (scripts) {
@@ -6070,8 +6019,8 @@ function registerTeardownCommand(program) {
         }
       }
     }
-    const harnessDir = join18(projectDir, ".harness");
-    if (existsSync19(harnessDir)) {
+    const harnessDir = join19(projectDir, ".harness");
+    if (existsSync20(harnessDir)) {
       rmSync(harnessDir, { recursive: true, force: true });
       result.removed.push(".harness/");
       if (!isJson) {
@@ -6079,7 +6028,7 @@ function registerTeardownCommand(program) {
       }
     }
     const statePath = getStatePath(projectDir);
-    if (existsSync19(statePath)) {
+    if (existsSync20(statePath)) {
       unlinkSync2(statePath);
       result.removed.push(".claude/codeharness.local.md");
       if (!isJson) {
@@ -6823,8 +6772,8 @@ function registerQueryCommand(program) {
 }
 
 // src/commands/retro-import.ts
-import { existsSync as existsSync20, readFileSync as readFileSync17 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync21, readFileSync as readFileSync18 } from "fs";
+import { join as join20 } from "path";
 
 // src/lib/retro-parser.ts
 var KNOWN_TOOLS = ["showboat", "ralph", "beads", "bmad"];
@@ -6993,15 +6942,15 @@ function registerRetroImportCommand(program) {
       return;
     }
     const retroFile = `epic-${epicNum}-retrospective.md`;
-    const retroPath = join19(root, STORY_DIR2, retroFile);
-    if (!existsSync20(retroPath)) {
+    const retroPath = join20(root, STORY_DIR2, retroFile);
+    if (!existsSync21(retroPath)) {
       fail(`Retro file not found: ${retroFile}`, { json: isJson });
       process.exitCode = 1;
       return;
     }
     let content;
     try {
-      content = readFileSync17(retroPath, "utf-8");
+      content = readFileSync18(retroPath, "utf-8");
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
       fail(`Failed to read retro file: ${message}`, { json: isJson });
@@ -7269,8 +7218,8 @@ function registerGithubImportCommand(program) {
 
 // src/lib/verify-env.ts
 import { execFileSync as execFileSync7 } from "child_process";
-import { existsSync as existsSync21, mkdirSync as mkdirSync8, readdirSync as readdirSync4, readFileSync as readFileSync18, cpSync, rmSync as rmSync2, statSync as statSync3 } from "fs";
-import { join as join20, basename as basename3 } from "path";
+import { existsSync as existsSync22, mkdirSync as mkdirSync8, readdirSync as readdirSync4, readFileSync as readFileSync19, cpSync, rmSync as rmSync2, statSync as statSync3 } from "fs";
+import { join as join21, basename as basename3 } from "path";
 import { createHash } from "crypto";
 var IMAGE_TAG = "codeharness-verify";
 var STORY_DIR3 = "_bmad-output/implementation-artifacts";
@@ -7283,14 +7232,14 @@ function isValidStoryKey(storyKey) {
   return /^[a-zA-Z0-9_-]+$/.test(storyKey);
 }
 function computeDistHash(projectDir) {
-  const distDir = join20(projectDir, "dist");
-  if (!existsSync21(distDir)) {
+  const distDir = join21(projectDir, "dist");
+  if (!existsSync22(distDir)) {
     return null;
   }
   const hash = createHash("sha256");
   const files = collectFiles(distDir).sort();
   for (const file of files) {
-    const content = readFileSync18(file);
+    const content = readFileSync19(file);
     hash.update(file.slice(distDir.length));
     hash.update(content);
   }
@@ -7300,7 +7249,7 @@ function collectFiles(dir) {
   const results = [];
   const entries = readdirSync4(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const fullPath = join20(dir, entry.name);
+    const fullPath = join21(dir, entry.name);
     if (entry.isDirectory()) {
       results.push(...collectFiles(fullPath));
     } else {
@@ -7372,13 +7321,13 @@ function buildNodeImage(projectDir) {
     throw new Error("npm pack produced no output \u2014 cannot determine tarball filename.");
   }
   const tarballName = basename3(lastLine);
-  const tarballPath = join20("/tmp", tarballName);
-  const buildContext = join20("/tmp", `codeharness-verify-build-${Date.now()}`);
+  const tarballPath = join21("/tmp", tarballName);
+  const buildContext = join21("/tmp", `codeharness-verify-build-${Date.now()}`);
   mkdirSync8(buildContext, { recursive: true });
   try {
-    cpSync(tarballPath, join20(buildContext, tarballName));
+    cpSync(tarballPath, join21(buildContext, tarballName));
     const dockerfileSrc = resolveDockerfileTemplate(projectDir);
-    cpSync(dockerfileSrc, join20(buildContext, "Dockerfile"));
+    cpSync(dockerfileSrc, join21(buildContext, "Dockerfile"));
     execFileSync7("docker", [
       "build",
       "-t",
@@ -7397,7 +7346,7 @@ function buildNodeImage(projectDir) {
   }
 }
 function buildPythonImage(projectDir) {
-  const distDir = join20(projectDir, "dist");
+  const distDir = join21(projectDir, "dist");
   const distFiles = readdirSync4(distDir).filter(
     (f) => f.endsWith(".tar.gz") || f.endsWith(".whl")
   );
@@ -7405,12 +7354,12 @@ function buildPythonImage(projectDir) {
     throw new Error("No distribution files found in dist/. Run your build command first (e.g., python -m build).");
   }
   const distFile = distFiles.filter((f) => f.endsWith(".tar.gz"))[0] ?? distFiles[0];
-  const buildContext = join20("/tmp", `codeharness-verify-build-${Date.now()}`);
+  const buildContext = join21("/tmp", `codeharness-verify-build-${Date.now()}`);
   mkdirSync8(buildContext, { recursive: true });
   try {
-    cpSync(join20(distDir, distFile), join20(buildContext, distFile));
+    cpSync(join21(distDir, distFile), join21(buildContext, distFile));
     const dockerfileSrc = resolveDockerfileTemplate(projectDir);
-    cpSync(dockerfileSrc, join20(buildContext, "Dockerfile"));
+    cpSync(dockerfileSrc, join21(buildContext, "Dockerfile"));
     execFileSync7("docker", [
       "build",
       "-t",
@@ -7432,25 +7381,25 @@ function prepareVerifyWorkspace(storyKey, projectDir) {
   if (!isValidStoryKey(storyKey)) {
     throw new Error(`Invalid story key: ${storyKey}. Keys must contain only alphanumeric characters, hyphens, and underscores.`);
   }
-  const storyFile = join20(root, STORY_DIR3, `${storyKey}.md`);
-  if (!existsSync21(storyFile)) {
+  const storyFile = join21(root, STORY_DIR3, `${storyKey}.md`);
+  if (!existsSync22(storyFile)) {
     throw new Error(`Story file not found: ${storyFile}`);
   }
   const workspace = `${TEMP_PREFIX}${storyKey}`;
-  if (existsSync21(workspace)) {
+  if (existsSync22(workspace)) {
     rmSync2(workspace, { recursive: true, force: true });
   }
   mkdirSync8(workspace, { recursive: true });
-  cpSync(storyFile, join20(workspace, "story.md"));
-  const readmePath = join20(root, "README.md");
-  if (existsSync21(readmePath)) {
-    cpSync(readmePath, join20(workspace, "README.md"));
+  cpSync(storyFile, join21(workspace, "story.md"));
+  const readmePath = join21(root, "README.md");
+  if (existsSync22(readmePath)) {
+    cpSync(readmePath, join21(workspace, "README.md"));
   }
-  const docsDir = join20(root, "docs");
-  if (existsSync21(docsDir) && statSync3(docsDir).isDirectory()) {
-    cpSync(docsDir, join20(workspace, "docs"), { recursive: true });
+  const docsDir = join21(root, "docs");
+  if (existsSync22(docsDir) && statSync3(docsDir).isDirectory()) {
+    cpSync(docsDir, join21(workspace, "docs"), { recursive: true });
   }
-  mkdirSync8(join20(workspace, "verification"), { recursive: true });
+  mkdirSync8(join21(workspace, "verification"), { recursive: true });
   return workspace;
 }
 function checkVerifyEnv() {
@@ -7499,7 +7448,7 @@ function cleanupVerifyEnv(storyKey) {
   }
   const workspace = `${TEMP_PREFIX}${storyKey}`;
   const containerName = `codeharness-verify-${storyKey}`;
-  if (existsSync21(workspace)) {
+  if (existsSync22(workspace)) {
     rmSync2(workspace, { recursive: true, force: true });
   }
   try {
@@ -7518,11 +7467,11 @@ function cleanupVerifyEnv(storyKey) {
   }
 }
 function resolveDockerfileTemplate(projectDir) {
-  const local = join20(projectDir, "templates", "Dockerfile.verify");
-  if (existsSync21(local)) return local;
+  const local = join21(projectDir, "templates", "Dockerfile.verify");
+  if (existsSync22(local)) return local;
   const pkgDir = new URL("../../", import.meta.url).pathname;
-  const pkg = join20(pkgDir, "templates", "Dockerfile.verify");
-  if (existsSync21(pkg)) return pkg;
+  const pkg = join21(pkgDir, "templates", "Dockerfile.verify");
+  if (existsSync22(pkg)) return pkg;
   throw new Error("Dockerfile.verify not found. Ensure templates/Dockerfile.verify exists in the project or installed package.");
 }
 function dockerImageExists(tag) {
@@ -7668,26 +7617,26 @@ function registerVerifyEnvCommand(program) {
 }
 
 // src/commands/retry.ts
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 
 // src/lib/retry-state.ts
-import { existsSync as existsSync22, readFileSync as readFileSync19, writeFileSync as writeFileSync12 } from "fs";
-import { join as join21 } from "path";
+import { existsSync as existsSync23, readFileSync as readFileSync20, writeFileSync as writeFileSync12 } from "fs";
+import { join as join22 } from "path";
 var RETRIES_FILE = ".story_retries";
 var FLAGGED_FILE = ".flagged_stories";
 var LINE_PATTERN = /^([^=]+)=(\d+)$/;
 function retriesPath(dir) {
-  return join21(dir, RETRIES_FILE);
+  return join22(dir, RETRIES_FILE);
 }
 function flaggedPath(dir) {
-  return join21(dir, FLAGGED_FILE);
+  return join22(dir, FLAGGED_FILE);
 }
 function readRetries(dir) {
   const filePath = retriesPath(dir);
-  if (!existsSync22(filePath)) {
+  if (!existsSync23(filePath)) {
     return /* @__PURE__ */ new Map();
   }
-  const raw = readFileSync19(filePath, "utf-8");
+  const raw = readFileSync20(filePath, "utf-8");
   const result = /* @__PURE__ */ new Map();
   for (const line of raw.split("\n")) {
     const trimmed = line.trim();
@@ -7724,10 +7673,10 @@ function resetRetry(dir, storyKey) {
 }
 function readFlaggedStories(dir) {
   const filePath = flaggedPath(dir);
-  if (!existsSync22(filePath)) {
+  if (!existsSync23(filePath)) {
     return [];
   }
-  const raw = readFileSync19(filePath, "utf-8");
+  const raw = readFileSync20(filePath, "utf-8");
   return raw.split("\n").map((l) => l.trim()).filter((l) => l !== "");
 }
 function writeFlaggedStories(dir, stories) {
@@ -7752,7 +7701,7 @@ function registerRetryCommand(program) {
   program.command("retry").description("Manage retry state for stories").option("--reset", "Clear retry counters and flagged stories").option("--story <key>", "Target a specific story key (used with --reset or --status)").option("--status", "Show retry status for all stories").action((_options, cmd) => {
     const opts = cmd.optsWithGlobals();
     const isJson = opts.json === true;
-    const dir = join22(process.cwd(), RALPH_SUBDIR);
+    const dir = join23(process.cwd(), RALPH_SUBDIR);
     if (opts.story && !isValidStoryKey3(opts.story)) {
       if (isJson) {
         jsonOutput({ status: "fail", message: `Invalid story key: ${opts.story}` });
@@ -7826,7 +7775,7 @@ function handleStatus(dir, isJson, filterStory) {
 }
 
 // src/index.ts
-var VERSION = true ? "0.17.6" : "0.0.0-dev";
+var VERSION = true ? "0.18.0" : "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");