@neriros/ralphy 3.10.5 → 3.10.6

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.10.5")
-      return "3.10.5";
+    if ("3.10.6")
+      return "3.10.6";
   } catch {}
   const dirsToTry = [];
   try {
@@ -101471,6 +101471,7 @@ async function parseAgentArgs(argv) {
     noTmux: false,
     checks: false,
     review: false,
+    agentDebug: false,
     ticketTokens: []
   };
   const state = emptyParseState();
@@ -101593,6 +101594,9 @@ async function parseAgentArgs(argv) {
       case "--debug":
         result2.debug = true;
         break;
+      case "--agent-debug":
+        result2.agentDebug = true;
+        break;
       case "--pre-existing-error-check":
         result2.preExistingErrorCheck = true;
         break;
@@ -101692,6 +101696,7 @@ var init_cli2 = __esm(() => {
     "  --checks                List mode: show failing CI check names per PR",
     "  --review                List mode: show unresolved review comment count per PR",
     "  --debug                 List mode: explain why a Linear ticket was not picked up (use with --name)",
+    "  --agent-debug           After each ticket finishes, run a one-shot self-review and write a report to ~/.ralph/retro/",
     "  --help, -h              Show this help message",
     "",
     "Examples:",
@@ -104551,6 +104556,15 @@ async function runPostTask(input, deps) {
   emit3(succeeded ? "done" : "gave-up", succeeded ? undefined : `exit ${effectiveCode}`);
   if (!succeeded)
     await recordGaveUp(stateFilePath, log3, changeName);
+  await deps.runRetrospective?.({
+    changeName,
+    cwd: cwd2,
+    changeDir,
+    stateFilePath,
+    branch,
+    issue: issue2,
+    effectiveCode
+  });
   await runWorktreeCleanupPhase({ changeName, cwd: cwd2, projectRoot, useWorktree, effectiveCode, cfg }, { git: git2, log: log3, emit: emit3 });
   await runTeardownPhase({ cwd: cwd2, teardownScript: cfg.teardownScript }, { runScript, log: log3, emit: emit3 });
   return effectiveCode;
@@ -105218,6 +105232,32 @@ class AgentCoordinator {
     if (!this.deps.syncTasks || !this.deps.getIterationCount)
       return;
     for (const w of this.workers) {
+      if (this.deps.getTasksFingerprint) {
+        let fingerprint;
+        try {
+          fingerprint = await this.deps.getTasksFingerprint(w.changeName);
+        } catch (err) {
+          this.deps.onLog(`! tasks fingerprint read failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+          continue;
+        }
+        if (fingerprint === null || fingerprint === w.lastSyncedTasksFingerprint) {
+          continue;
+        }
+        let iteration;
+        try {
+          iteration = await this.deps.getIterationCount(w.changeName);
+        } catch (err) {
+          this.deps.onLog(`! iteration count read failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+          continue;
+        }
+        try {
+          await this.deps.syncTasks(w, iteration);
+          w.lastSyncedTasksFingerprint = fingerprint;
+        } catch (err) {
+          this.deps.onLog(`! sync-tasks (poll) failed for ${w.issueIdentifier}: ${err.message}`, "yellow");
+        }
+        continue;
+      }
       let count;
       try {
         count = await this.deps.getIterationCount(w.changeName);
@@ -105497,6 +105537,7 @@ class AgentCoordinator {
       kill: handle.kill,
       lastReportedIteration: 0,
       lastSyncedIteration: 0,
+      lastSyncedTasksFingerprint: null,
       restarting: false,
       reapedForAwaiting: false
     };
@@ -105660,6 +105701,7 @@ class AgentCoordinator {
         kill: () => {},
         lastReportedIteration: 0,
         lastSyncedIteration: 0,
+        lastSyncedTasksFingerprint: null,
         restarting: false,
         reapedForAwaiting: false
       };
@@ -107767,8 +107809,190 @@ var init_default2 = __esm(() => {
   init_log();
 });
 
+// apps/agent/src/agent/state/agent-run-state.ts
+import { basename as basename3, join as join29 } from "path";
+import { homedir as homedir6 } from "os";
+import { mkdir as mkdir11, writeFile } from "fs/promises";
+function agentRunStatePath(projectRoot) {
+  return join29(homedir6(), ".ralph", basename3(projectRoot), "agent-state.json");
+}
+async function writeAgentRunState(state) {
+  const path = agentRunStatePath(state.projectRoot);
+  try {
+    await mkdir11(join29(homedir6(), ".ralph", basename3(state.projectRoot)), { recursive: true });
+    await writeFile(path, JSON.stringify(state, null, 2) + `
+`, "utf-8");
+  } catch {}
+}
+var init_agent_run_state = () => {};
+
+// packages/retro/src/disposition.ts
+function dispositionFromExitCode(code) {
+  switch (code) {
+    case 0:
+      return "done";
+    case NO_CHANGES_EXIT2:
+      return "no-changes";
+    case CI_FAILED_EXIT2:
+      return "ci-failed";
+    case PR_FAILED_EXIT2:
+      return "pr-failed";
+    default:
+      return "error";
+  }
+}
+var CI_FAILED_EXIT2 = 70, PR_FAILED_EXIT2 = 71, NO_CHANGES_EXIT2 = 72;
+
+// packages/retro/src/paths.ts
+import { homedir as homedir7 } from "os";
+import { mkdir as mkdir12 } from "fs/promises";
+import { join as join30 } from "path";
+function retroDir() {
+  return join30(homedir7(), ".ralph", "retro");
+}
+async function resolveRetroOutputPath(identifier, date5, dir = retroDir()) {
+  await mkdir12(dir, { recursive: true });
+  const base2 = join30(dir, `${identifier}-${date5}.md`);
+  if (!await Bun.file(base2).exists())
+    return base2;
+  for (let n = 2;; n++) {
+    const candidate = join30(dir, `${identifier}-${date5}-${n}.md`);
+    if (!await Bun.file(candidate).exists())
+      return candidate;
+  }
+}
+var init_paths2 = () => {};
+
+// packages/retro/src/prompt.ts
+function buildRetroPrompt(ctx, outputPath) {
+  const disposition = dispositionFromExitCode(ctx.exitCode);
+  const { paths } = ctx;
+  const line = (label, value) => value ? `- ${label}: ${value}` : `- ${label}: (unavailable \u2014 note this in the report)`;
+  return [
+    `You are a retrospective analysis agent reviewing a finished automated ticket run.`,
+    `Your job is to read the run's artifacts and write a thorough, honest self-review`,
+    `to a markdown file. You are NOT fixing anything \u2014 this is analysis only.`,
+    ``,
+    `## Ticket`,
+    ``,
+    `- Identifier: ${ctx.identifier}`,
+    `- Change name: ${ctx.changeName}`,
+    `- Terminal disposition: ${disposition} (worker exit code ${ctx.exitCode})`,
+    ctx.prUrl ? `- Pull request: ${ctx.prUrl}` : `- Pull request: none was opened`,
+    `- Date: ${ctx.date}`,
+    ``,
+    `### Ticket details`,
+    ``,
+    ctx.ticketDigest,
+    ``,
+    `## Data sources`,
+    ``,
+    `Read whatever of the following exist. If a path is missing or empty, say so`,
+    `explicitly in the report rather than guessing.`,
+    ``,
+    line("Change directory (proposal/design/tasks/specs)", paths.changeDir),
+    line("Loop state file", paths.stateFilePath),
+    line("Worker log", paths.logFile),
+    line("JSON event log", paths.jsonLogFile),
+    line("Agent run state", paths.agentStateFile),
+    ctx.prUrl ? `- You may inspect the PR read-only with \`gh pr view ${ctx.prUrl}\` and \`gh pr diff ${ctx.prUrl}\`.` : `- No PR exists; skip the PR section and note "no PR".`,
+    ``,
+    `## Required report structure`,
+    ``,
+    `Write GitHub-flavored markdown with these sections:`,
+    `1. **Summary** \u2014 what the ticket asked for and how the run ended.`,
+    `2. **What went well** \u2014 concrete things the run did right.`,
+    `3. **What went wrong / friction** \u2014 failures, retries, wasted iterations,`,
+    `   wrong turns, anything that cost time or quality.`,
+    `4. **Root-cause analysis** \u2014 for each problem, why it happened.`,
+    `5. **Recommendations** \u2014 specific, actionable improvements (to the prompt,`,
+    `   the tasks, the codebase, or the workflow).`,
+    `6. **Data gaps** \u2014 which data sources were unavailable or unread.`,
+    ``,
+    `## Output`,
+    ``,
+    `Write the complete report to this exact path using your file-write tool:`,
+    ``,
+    `    ${outputPath}`,
+    ``,
+    `## Hard rules`,
+    ``,
+    `- Do NOT run any git mutation: no commit, add, push, rebase, reset, checkout,`,
+    `  branch, merge, tag, or stash.`,
+    `- Do NOT create, edit, comment on, close, or merge any pull request or issue.`,
+    `- Do NOT modify any source file. The ONLY file you may write is the report at`,
+    `  the path above.`,
+    `- Read-only inspection commands (\`git log\`, \`git diff\`, \`gh pr view\`,`,
+    `  \`gh pr diff\`, reading files) are allowed.`
+  ].join(`
+`);
+}
+var init_prompt = () => {};
+
+// packages/retro/src/retro.ts
+async function runRetrospective(ctx, deps) {
+  const { log: log3, runEngine: runEngine2, seen } = deps;
+  const disposition = dispositionFromExitCode(ctx.exitCode);
+  const key = `${ctx.identifier}:${disposition}:${ctx.date}`;
+  if (seen.has(key)) {
+    log3(`  retrospective skipped for ${ctx.identifier} (already generated this run)`, "gray");
+    return { written: false, skipped: "duplicate", disposition };
+  }
+  seen.add(key);
+  try {
+    const outputPath = await resolveRetroOutputPath(ctx.identifier, ctx.date);
+    const prompt = buildRetroPrompt(ctx, outputPath);
+    log3(`  running retrospective for ${ctx.identifier} (${disposition}) \u2192 ${outputPath}`, "cyan");
+    await runEngine2({
+      engine: ctx.engine,
+      model: ctx.model,
+      prompt,
+      cwd: ctx.cwd,
+      onOutput: (l) => log3(l, "gray")
+    });
+    const written = await Bun.file(outputPath).exists();
+    if (written) {
+      log3(`  retrospective written: ${outputPath}`, "green");
+    } else {
+      log3(`! retrospective engine finished but no report was written at ${outputPath}`, "yellow");
+    }
+    return { written, outputPath, disposition };
+  } catch (err) {
+    log3(`! retrospective failed for ${ctx.identifier}: ${err.message}`, "yellow");
+    return { written: false, disposition };
+  }
+}
+var init_retro = __esm(() => {
+  init_paths2();
+  init_prompt();
+  init_paths2();
+  init_prompt();
+});
+
 // apps/agent/src/agent/wire/spawn/worker.ts
-import { join as join29 } from "path";
+import { join as join31 } from "path";
+function localDateStamp(d) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+function buildTicketDigest(issue2, comments) {
+  if (!issue2)
+    return "(ticket details unavailable)";
+  const lines = [`Title: ${issue2.title}`, "", issue2.description?.trim() || "(no description)"];
+  if (comments.length > 0) {
+    lines.push("", "Comments:");
+    for (const c of comments) {
+      lines.push(`- ${c.user?.name ?? "unknown"}: ${c.body}`);
+    }
+  }
+  return lines.join(`
+`);
+}
+function retroDepEntry(agentDebug, hook) {
+  return agentDebug ? { runRetrospective: hook } : {};
+}
 function createSpawnWorker(input) {
   const {
     args,
@@ -107847,10 +108071,52 @@ function createSpawnWorker(input) {
     c.push("--from-agent");
     return c;
   }
+  const retroSeen = new Set;
+  const runRetrospectiveHook = async (info) => {
+    try {
+      const identifier = info.issue?.identifier ?? info.changeName;
+      const prUrl = prByChange?.get(info.changeName) ?? null;
+      let digest = "(ticket details unavailable)";
+      if (info.issue) {
+        let comments = [];
+        try {
+          comments = await fetchIssueComments(apiKey, info.issue.id);
+        } catch {}
+        digest = buildTicketDigest(info.issue, comments);
+      }
+      const engine = args.engineSet ? args.engine : cfg.engine;
+      const model = args.engineSet ? args.model : cfg.model;
+      const ctx = {
+        identifier,
+        changeName: info.changeName,
+        cwd: info.cwd,
+        engine,
+        model,
+        exitCode: info.effectiveCode,
+        prUrl,
+        date: localDateStamp(new Date),
+        ticketDigest: digest,
+        paths: {
+          changeDir: info.changeDir,
+          stateFilePath: info.stateFilePath,
+          logFile: join31(logsDir, `${info.changeName}.log`),
+          jsonLogFile: args.jsonLogFile ?? null,
+          agentStateFile: agentRunStatePath(projectRoot)
+        }
+      };
+      await runRetrospective(ctx, {
+        runEngine: (opts) => runEngine(opts),
+        log: onLog,
+        seen: retroSeen
+      });
+    } catch (err) {
+      onLog(`! retrospective failed: ${err.message}`, "yellow");
+    }
+  };
   return function spawnWorker(changeName, _issue, trigger) {
     const cwd2 = cwdByChange.get(changeName) ?? projectRoot;
     const injected = runners?.spawnWorker;
-    const missionTasksPath = join29(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
+    const missionTasksPath = join31(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
     const prevTasksPromise = (async () => {
       const f2 = Bun.file(missionTasksPath);
       return await f2.exists() ? await f2.text() : "";
@@ -107858,7 +108124,7 @@ function createSpawnWorker(input) {
     let logFilePath;
     let handle;
     if (injected) {
-      logFilePath = join29(logsDir, `${changeName}.log`);
+      logFilePath = join31(logsDir, `${changeName}.log`);
       handle = injected(buildTaskCmdFor(changeName), cwd2);
     } else {
       const r = defaultSpawn(changeName, buildTaskCmdFor(changeName), cwd2, logsDir, onWorkerOutput, `spawn at ${new Date().toISOString()}`);
@@ -107880,7 +108146,7 @@ function createSpawnWorker(input) {
     const wantAutoMerge = issueForChange ? issueMatchesGetIndicator(issueForChange, indicators.getAutoMerge) : false;
     const wrapped = handle.exited.then(async (code) => {
       const workerLayout = projectLayout(cwd2);
-      const validateSpecPath = join29(workerLayout.changeDir(changeName), "specs", "validate.md");
+      const validateSpecPath = join31(workerLayout.changeDir(changeName), "specs", "validate.md");
       const hasValidateSpec = await Bun.file(validateSpecPath).exists();
       const wantValidateOnly = hasValidateSpec && !wantPrBase;
       if (hasValidateSpec) {
@@ -107965,6 +108231,7 @@ function createSpawnWorker(input) {
         git: gitRunner,
         log: onLog,
         runScript,
+        ...retroDepEntry(args.agentDebug, runRetrospectiveHook),
         registerPr: (cn, url2) => onPrRegistered(cn, url2),
         ...onWorkerPhase && {
           onPhase: (phase2, detail) => onWorkerPhase(changeName, phase2, detail)
@@ -108000,6 +108267,9 @@ var init_worker = __esm(() => {
   init_runners();
   init_pr_helpers();
   init_wait_for_mergeability();
+  init_agent_run_state();
+  init_retro();
+  init_engine();
 });
 
 // apps/agent/src/agent/baseline/runner.ts
@@ -108342,8 +108612,8 @@ var init_linear_sync = __esm(() => {
 });
 
 // apps/agent/src/agent/linear-sync/comment-sync.ts
-import { dirname as dirname13, join as join30 } from "path";
-import { mkdir as mkdir11, rename, unlink as unlink2 } from "fs/promises";
+import { dirname as dirname13, join as join32 } from "path";
+import { mkdir as mkdir13, rename, unlink as unlink2 } from "fs/promises";
 async function readStateJson(statePath) {
   const file2 = Bun.file(statePath);
   if (!await file2.exists())
@@ -108355,7 +108625,7 @@ async function readStateJson(statePath) {
   }
 }
 async function writeStateJson(statePath, state) {
-  await mkdir11(dirname13(statePath), { recursive: true });
+  await mkdir13(dirname13(statePath), { recursive: true });
   const tmp = `${statePath}.tmp-${process.pid}-${writeStateSeq++}`;
   try {
     await Bun.write(tmp, JSON.stringify(state, null, 2) + `
@@ -108394,7 +108664,7 @@ function isCommentNotFoundError(err) {
   return text.includes("not found") || text.includes("could not find") || text.includes("entity not found");
 }
 async function readTasksMd(changeDir, log3) {
-  const file2 = Bun.file(join30(changeDir, "tasks.md"));
+  const file2 = Bun.file(join32(changeDir, "tasks.md"));
   if (!await file2.exists()) {
     log3(`  comment-sync: tasks.md missing in ${changeDir}, skipping`, "gray");
     return null;
@@ -108502,14 +108772,14 @@ async function postPlanCommentOnce(deps) {
   const check2 = parsePlanningSection(tasksMd);
   if (!check2.allChecked)
     return null;
-  const proposalPath = join30(deps.changeDir, "proposal.md");
+  const proposalPath = join32(deps.changeDir, "proposal.md");
   const why = await readSection(proposalPath, "Why");
   const whatChanges = await readSection(proposalPath, "What Changes");
   if (!why && !whatChanges) {
     deps.log(`  comment-sync: proposal.md has no Why/What Changes, skipping plan comment`, "gray");
     return null;
   }
-  const designSummary = await readFirstParagraph(join30(deps.changeDir, "design.md"));
+  const designSummary = await readFirstParagraph(join32(deps.changeDir, "design.md"));
   const parts = [`### ${PLAN_COMMENT_TITLE} \u2014 \`${deps.changeName}\``];
   if (why) {
     parts.push("", "**Why**", "", why);
@@ -260785,7 +261055,7 @@ var init_render_pdf = __esm(() => {
 });
 
 // apps/agent/src/agent/linear-sync/spec-attachments.ts
-import { dirname as dirname14, join as join31 } from "path";
+import { dirname as dirname14, join as join33 } from "path";
 function describeLinearError(err) {
   const e = err;
   const parts = [e.message ?? String(err)];
@@ -260877,7 +261147,7 @@ async function syncSlot(deps, slot) {
   const [primaryName, ...trailingNames] = spec.sourceFiles;
   if (!primaryName)
     return;
-  const primary = Bun.file(join31(deps.changeDir, primaryName));
+  const primary = Bun.file(join33(deps.changeDir, primaryName));
   if (!await primary.exists()) {
     deps.log(`  spec-attachments: ${primaryName} missing, skipping`, "gray");
     return;
@@ -260896,7 +261166,7 @@ async function syncSlot(deps, slot) {
   const parts = [primaryBytes];
   const enc = new TextEncoder;
   for (const name of trailingNames) {
-    const f2 = Bun.file(join31(deps.changeDir, name));
+    const f2 = Bun.file(join33(deps.changeDir, name));
     if (!await f2.exists())
       continue;
     try {
@@ -261161,9 +261431,9 @@ var init_comment_sync2 = __esm(() => {
 });
 
 // apps/agent/src/features/pr-tracker/state.ts
-import { join as join32 } from "path";
+import { join as join34 } from "path";
 async function readState2(projectRoot) {
-  const path = join32(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join34(projectRoot, PR_TRACKER_STATE_RELPATH);
   const file2 = Bun.file(path);
   if (!await file2.exists())
     return {};
@@ -261179,7 +261449,7 @@ async function readState2(projectRoot) {
   }
 }
 async function writeState2(projectRoot, state) {
-  const path = join32(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join34(projectRoot, PR_TRACKER_STATE_RELPATH);
   await Bun.write(path, JSON.stringify(state, null, 2));
 }
 var PR_TRACKER_STATE_RELPATH = ".ralph/pr-tracker-state.json";
@@ -261258,7 +261528,7 @@ var init_pr_tracker = __esm(() => {
 });
 
 // apps/agent/src/agent/wire.ts
-import { join as join33 } from "path";
+import { join as join35 } from "path";
 function buildAgentCoordinator(input) {
   const {
     args,
@@ -261277,7 +261547,7 @@ function buildAgentCoordinator(input) {
     onWorkerCmd,
     onAwaitingTicket
   } = input;
-  const logsDir = join33(projectRoot, ".ralph", "logs");
+  const logsDir = join35(projectRoot, ".ralph", "logs");
   const bus = createBus();
   subscribeAgentDiag(bus, onLog);
   const diag = (area, message, color) => {
@@ -261493,6 +261763,18 @@ function buildAgentCoordinator(input) {
       const json2 = await file2.json();
       return json2.iteration ?? 0;
     },
+    getTasksFingerprint: async (changeName) => {
+      const root = cwdByChange.get(changeName) ?? projectRoot;
+      const changeDir = projectLayout(root).changeDir(changeName);
+      const parts = [];
+      for (const name of ["tasks.md", "proposal.md", "design.md"]) {
+        const file2 = Bun.file(join35(changeDir, name));
+        if (!await file2.exists())
+          continue;
+        parts.push(`${name}:${file2.lastModified}:${file2.size}`);
+      }
+      return parts.length > 0 ? parts.join("|") : null;
+    },
     ...commentSync.enabled && commentSync.syncTasks ? { syncTasks: commentSync.syncTasks } : {},
     ...commentSync.enabled && commentSync.onSteeringAppended ? { onSteeringAppended: commentSync.onSteeringAppended } : {}
   }, {
@@ -261531,7 +261813,7 @@ function buildAgentCoordinator(input) {
     getGaveUpTotal: async () => {
       let total = 0;
       for (const [changeName, root] of cwdByChange) {
-        const file2 = Bun.file(join33(projectLayout(root).taskStateDir(changeName), GAVEUP_COUNT_FILE));
+        const file2 = Bun.file(join35(projectLayout(root).taskStateDir(changeName), GAVEUP_COUNT_FILE));
         if (!await file2.exists())
           continue;
         try {
@@ -261566,14 +261848,14 @@ var init_wire = __esm(() => {
 });
 
 // apps/agent/src/agent/json-log/json-log-file.ts
-import { mkdir as mkdir12, appendFile as appendFile2 } from "fs/promises";
+import { mkdir as mkdir14, appendFile as appendFile2 } from "fs/promises";
 import { dirname as dirname15 } from "path";
 function createJsonLogFileSink(path) {
   if (!path)
     return { emit: () => {} };
   let chain = (async () => {
     try {
-      await mkdir12(dirname15(path), { recursive: true });
+      await mkdir14(dirname15(path), { recursive: true });
       await Bun.write(path, "");
     } catch {}
   })();
@@ -261819,7 +262101,7 @@ var init_output_utils = __esm(() => {
 });
 
 // apps/agent/src/agent/state/worker-state-poll.ts
-import { join as join34 } from "path";
+import { join as join36 } from "path";
 function parseSubtasks(tasksMd) {
   const out = [];
   let skipSection = false;
@@ -261852,7 +262134,7 @@ function initialWorkerSnapshot() {
 async function readWorkerSnapshot(input) {
   const next = { ...input.prev };
   try {
-    const file2 = Bun.file(join34(input.statesDir, input.changeName, ".ralph-state.json"));
+    const file2 = Bun.file(join36(input.statesDir, input.changeName, ".ralph-state.json"));
     if (await file2.exists()) {
       const json2 = await file2.json();
       next.iter = json2.iteration ?? next.iter;
@@ -261861,10 +262143,10 @@ async function readWorkerSnapshot(input) {
   } catch {}
   if (input.changeDir) {
     try {
-      const tasksFile = Bun.file(join34(input.changeDir, "tasks.md"));
-      const proposalFile = Bun.file(join34(input.changeDir, "proposal.md"));
-      const designFile = Bun.file(join34(input.changeDir, "design.md"));
-      const reviewFindingsFile = Bun.file(join34(input.changeDir, "review-findings.md"));
+      const tasksFile = Bun.file(join36(input.changeDir, "tasks.md"));
+      const proposalFile = Bun.file(join36(input.changeDir, "proposal.md"));
+      const designFile = Bun.file(join36(input.changeDir, "design.md"));
+      const reviewFindingsFile = Bun.file(join36(input.changeDir, "review-findings.md"));
       const [tasksText, proposalText, designText, reviewFindingsText] = await Promise.all([
         tasksFile.exists().then((ok) => ok ? tasksFile.text() : null),
         proposalFile.exists().then((ok) => ok ? proposalFile.text() : null),
@@ -261927,7 +262209,7 @@ var init_worker_state_poll = __esm(() => {
 });
 
 // apps/agent/src/components/AgentMode.tsx
-import { join as join35 } from "path";
+import { join as join37 } from "path";
 async function appendSteeringImpl(changeDir, message) {
   await runWithContext(createDefaultContext(), async () => {
     appendSteeringMessage(changeDir, message);
@@ -263500,7 +263782,7 @@ function AgentMode({
                     },
                     onSubmit: async (message) => {
                       try {
-                        await appendSteering2(join35(tasksDir, w2.changeName), message);
+                        await appendSteering2(join37(tasksDir, w2.changeName), message);
                         fileEmit({ type: "steering_submitted", changeName: w2.changeName, message });
                       } catch (err) {
                         const text = err.message;
@@ -263614,7 +263896,7 @@ function shouldFallbackToJsonOutput(args, stdinIsTty) {
 }
 
 // apps/agent/src/runtime/tmux.ts
-import { basename as basename3 } from "path";
+import { basename as basename4 } from "path";
 function tmuxAvailable() {
   const result2 = Bun.spawnSync({ cmd: ["tmux", "-V"], stderr: "pipe" });
   return result2.exitCode === 0;
@@ -263623,7 +263905,7 @@ function sessionName(projectRoot) {
   const override = process.env["RALPH_SESSION_NAME"];
   if (override)
     return override;
-  return `ralphy-agent-${basename3(projectRoot)}`;
+  return `ralphy-agent-${basename4(projectRoot)}`;
 }
 function sessionExists(name) {
   const result2 = Bun.spawnSync({ cmd: ["tmux", "has-session", "-t", name], stderr: "pipe" });
@@ -263804,7 +264086,7 @@ __export(exports_list, {
   buildBuckets: () => buildBuckets,
   backlogRankByIssueId: () => backlogRankByIssueId
 });
-import { join as join36 } from "path";
+import { join as join38 } from "path";
 function countTaskItems(content) {
   const checked = (content.match(/^- \[x\]/gm) ?? []).length;
   const unchecked = (content.match(/^- \[ \]/gm) ?? []).length;
@@ -263820,13 +264102,13 @@ function buildLocalRows() {
   const sources = [{ dir: statesDir, label: "main" }];
   const worktreesRoot = worktreesDir2(projectRoot);
   for (const wt of storage.list(worktreesRoot)) {
-    sources.push({ dir: join36(worktreesRoot, wt, ".ralph", "tasks"), label: `wt:${wt}` });
+    sources.push({ dir: join38(worktreesRoot, wt, ".ralph", "tasks"), label: `wt:${wt}` });
   }
   for (const { dir, label } of sources) {
     for (const entry of storage.list(dir)) {
       if (seen.has(entry))
         continue;
-      const raw = storage.read(join36(dir, entry, ".ralph-state.json"));
+      const raw = storage.read(join38(dir, entry, ".ralph-state.json"));
       if (raw === null)
         continue;
       let state;
@@ -263841,7 +264123,7 @@ function buildLocalRows() {
       const firstLine = promptRaw.split(`
 `).find((l3) => l3.trim() !== "") ?? "";
       let progress = "\u2014";
-      const tasksContent = storage.read(join36(dir, entry, "tasks.md"));
+      const tasksContent = storage.read(join38(dir, entry, "tasks.md"));
       if (tasksContent !== null) {
         const { checked, unchecked } = countTaskItems(tasksContent);
         const total = checked + unchecked;
@@ -264336,31 +264618,14 @@ var init_list = __esm(() => {
   };
 });
 
-// apps/agent/src/agent/state/agent-run-state.ts
-import { basename as basename4, join as join37 } from "path";
-import { homedir as homedir6 } from "os";
-import { mkdir as mkdir13, writeFile } from "fs/promises";
-function agentRunStatePath(projectRoot) {
-  return join37(homedir6(), ".ralph", basename4(projectRoot), "agent-state.json");
-}
-async function writeAgentRunState(state) {
-  const path = agentRunStatePath(state.projectRoot);
-  try {
-    await mkdir13(join37(homedir6(), ".ralph", basename4(state.projectRoot)), { recursive: true });
-    await writeFile(path, JSON.stringify(state, null, 2) + `
-`, "utf-8");
-  } catch {}
-}
-var init_agent_run_state = () => {};
-
 // apps/agent/src/agent/json-runner.ts
 var exports_json_runner = {};
 __export(exports_json_runner, {
   runAgentJson: () => runAgentJson
 });
-import { join as join38 } from "path";
-import { mkdir as mkdir14 } from "fs/promises";
-import { homedir as homedir7 } from "os";
+import { join as join39 } from "path";
+import { mkdir as mkdir15 } from "fs/promises";
+import { homedir as homedir8 } from "os";
 function makeEmit(fileSink) {
   return (event) => {
     const payload = { ts: Date.now(), ...event };
@@ -264380,7 +264645,7 @@ async function runAgentJson({
   tasksDir,
   runPreflight: runPreflight2 = runPreflight
 }) {
-  await mkdir14(join38(homedir7(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir15(join39(homedir8(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const fileSink = createJsonLogFileSink(args.jsonLogFile);
@@ -264596,8 +264861,8 @@ var exports_src3 = {};
 __export(exports_src3, {
   main: () => main3
 });
-import { mkdir as mkdir15 } from "fs/promises";
-import { join as join39 } from "path";
+import { mkdir as mkdir16 } from "fs/promises";
+import { join as join40 } from "path";
 async function main3(argv) {
   if (argv.includes("--help") || argv.includes("-h")) {
     printAgentHelp();
@@ -264661,9 +264926,9 @@ async function main3(argv) {
       return 1;
     }
   }
-  await mkdir15(statesDir, { recursive: true });
-  await mkdir15(tasksDir, { recursive: true });
-  await mkdir15(join39(projectRoot, ".ralph"), { recursive: true });
+  await mkdir16(statesDir, { recursive: true });
+  await mkdir16(tasksDir, { recursive: true });
+  await mkdir16(join40(projectRoot, ".ralph"), { recursive: true });
   if (shouldFallbackToJsonOutput(args, process.stdin.isTTY)) {
     process.stderr.write(`agent: stdin is not a TTY \u2014 falling back to --json-output mode.
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "3.10.5",
+  "version": "3.10.6",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",