@neriros/ralphy 3.10.5 → 3.10.7

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.7")
+      return "3.10.7";
   } catch {}
   const dirsToTry = [];
   try {
@@ -81072,7 +81072,7 @@ function modelOptionValues() {
   const field = findField("model");
   return field && field.spec.kind === "select" ? field.spec.options.map((o) => o.value) : [];
 }
-var PROMPT_BODY_FIELD_ID = "promptBody", REPO_LINK_FIELD_ID = "repo.link", yes = () => ({ kind: "confirm", defaultChoice: "confirm" }), no = () => ({ kind: "confirm", defaultChoice: "cancel" }), PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_FILTER, QUICK_FIELDS, isOn = (id) => (answers) => answers[id] === true, CUSTOMIZED_FIELDS, COMMON_CLI_OPTIONS, FIELD_DESCRIPTIONS;
+var PROMPT_BODY_FIELD_ID = "promptBody", REPO_LINK_FIELD_ID = "repo.link", AWAITING_STATUS_FIELD_ID = "linear.confirmationMode.awaitingStatus", yes = () => ({ kind: "confirm", defaultChoice: "confirm" }), no = () => ({ kind: "confirm", defaultChoice: "cancel" }), PROJECT_NAME, LINEAR_TEAM, REPO_LINK, LINEAR_FILTER, QUICK_FIELDS, isOn = (id) => (answers) => answers[id] === true, CUSTOMIZED_FIELDS, COMMON_CLI_OPTIONS, FIELD_DESCRIPTIONS;
 var init_fields = __esm(() => {
   PROJECT_NAME = {
     id: "project.name",
@@ -81436,6 +81436,14 @@ var init_fields = __esm(() => {
       spec: { kind: "number", placeholder: "3" },
       when: isOn("linear.confirmationMode.enabled")
     },
+    {
+      id: AWAITING_STATUS_FIELD_ID,
+      label: "Park awaiting-approval tickets in a status?",
+      hint: "e.g. Planned \u2014 blank keeps them In Progress",
+      description: "When the confirmation gate opens, move the ticket to this Linear status so the board shows it waiting on a human (it must be a real status in your team). Ralphy also adds it to the in-progress pickup filter so the parked ticket keeps being polled, and re-asserts In Progress on approval. Leave blank to keep parked tickets in In Progress. Pairs with status-based indicators.",
+      spec: { kind: "text", placeholder: "Planned" },
+      when: isOn("linear.confirmationMode.enabled")
+    },
     {
       id: "linear.indicators",
       label: "Linear lifecycle indicators",
@@ -82908,6 +82916,20 @@ function buildFromAnswers(mode, answers, build = buildWorkflowMarkdown) {
       values2["linear.indicators"] = map3;
     }
   }
+  const parkStatusRaw = values2[AWAITING_STATUS_FIELD_ID];
+  const parkStatus = typeof parkStatusRaw === "string" ? parkStatusRaw.trim() : "";
+  if (values2["linear.confirmationMode.enabled"] === true && parkStatus && values2["linear.indicators"] && typeof values2["linear.indicators"] === "object") {
+    const map3 = { ...values2["linear.indicators"] };
+    map3.setAwaitingConfirmation = { type: "status", value: parkStatus };
+    const existing = map3.getInProgress;
+    const filter2 = existing && !Array.isArray(existing) && "filter" in existing ? [...existing.filter] : [];
+    if (!filter2.some((m) => m.type === "status" && m.value === parkStatus)) {
+      filter2.push({ type: "status", value: parkStatus });
+    }
+    map3.getInProgress = { filter: filter2 };
+    values2["linear.indicators"] = map3;
+  }
+  delete values2[AWAITING_STATUS_FIELD_ID];
   const linkRepo = values2[REPO_LINK_FIELD_ID] === true;
   delete values2[REPO_LINK_FIELD_ID];
   if (!linkRepo) {
@@ -85044,6 +85066,89 @@ var init_schema2 = __esm(() => {
   ALL_OWNED_SLOTS = new Set(Object.values(OWNERSHIP).flatMap((slots) => [...slots]));
 });
 
+// packages/core/src/state/sidecar.ts
+import { dirname as dirname5, join as join9 } from "path";
+import { mkdir as mkdir3, rename, unlink } from "fs/promises";
+function slotSidecarPath(changeDir, slot) {
+  return join9(changeDir, `${CORE_STATE_FILE.replace(/\.json$/, "")}.${slot}.json`);
+}
+function parseObject(text) {
+  if (text === null)
+    return null;
+  try {
+    const parsed = JSON.parse(text);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      return parsed;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+function deepSet(target, path, value) {
+  if (path === "") {
+    for (const k of Object.keys(target))
+      delete target[k];
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      Object.assign(target, value);
+    }
+    return;
+  }
+  const segments = path.split(".");
+  let cursor = target;
+  for (let i = 0;i < segments.length - 1; i++) {
+    const key = segments[i];
+    const existing = cursor[key];
+    if (existing === null || typeof existing !== "object" || Array.isArray(existing)) {
+      const next = {};
+      cursor[key] = next;
+      cursor = next;
+    } else {
+      cursor = existing;
+    }
+  }
+  cursor[segments[segments.length - 1]] = value;
+}
+async function atomicWrite(path, content) {
+  await mkdir3(dirname5(path), { recursive: true });
+  const tmp = `${path}.tmp-${process.pid}-${writeSeq++}`;
+  try {
+    await Bun.write(tmp, content);
+    await rename(tmp, path);
+  } catch (err) {
+    await unlink(tmp).catch(() => {});
+    throw err;
+  }
+}
+async function readSlotSidecar(changeDir, slot) {
+  const file2 = Bun.file(slotSidecarPath(changeDir, slot));
+  if (!await file2.exists())
+    return;
+  const obj = parseObject(await file2.text().catch(() => null));
+  return obj ?? undefined;
+}
+async function writeSlotField(changeDir, path, value, seedInline) {
+  const [slot, ...rest2] = path.split(".");
+  const sidecarPath = slotSidecarPath(changeDir, slot);
+  const existing = parseObject(await Bun.file(sidecarPath).text().catch(() => null));
+  const obj = existing ?? (seedInline ? structuredClone(seedInline) : {});
+  deepSet(obj, rest2.join("."), value);
+  await atomicWrite(sidecarPath, JSON.stringify(obj, null, 2) + `
+`);
+}
+function overlaySidecarsSync(changeDir, target, read) {
+  for (const slot of ALL_OWNED_SLOTS) {
+    const obj = parseObject(read(slotSidecarPath(changeDir, slot)));
+    if (obj !== undefined && obj !== null)
+      target[slot] = obj;
+  }
+  return target;
+}
+var CORE_STATE_FILE = ".ralph-state.json", writeSeq = 0;
+var init_sidecar = __esm(() => {
+  init_schema2();
+});
+
 // node_modules/.bun/zod@3.25.76/node_modules/zod/v3/helpers/util.js
 var util, objectUtil, ZodParsedType, getParsedType2 = (data) => {
   const t = typeof data;
@@ -89147,16 +89252,24 @@ function formatTaskName(name) {
 }
 
 // packages/core/src/state.ts
-import { join as join9 } from "path";
+import { join as join10 } from "path";
+function stripOwnedSlots(state) {
+  const out = { ...state };
+  for (const slot of ALL_OWNED_SLOTS)
+    delete out[slot];
+  return out;
+}
 function readState(changeDir) {
-  const filePath = join9(changeDir, STATE_FILE2);
+  const filePath = join10(changeDir, STATE_FILE2);
   const raw = getStorage().read(filePath);
   if (raw === null)
     throw new Error(".ralph-state.json not found");
-  return StateSchema.parse(JSON.parse(raw));
+  const base2 = JSON.parse(raw);
+  overlaySidecarsSync(changeDir, base2, (p) => getStorage().read(p));
+  return StateSchema.parse(base2);
 }
 function tryReadStateRaw(changeDir) {
-  const filePath = join9(changeDir, STATE_FILE2);
+  const filePath = join10(changeDir, STATE_FILE2);
   const text = getStorage().read(filePath);
   if (text === null)
     return { state: null, raw: null };
@@ -89167,12 +89280,14 @@ function tryReadStateRaw(changeDir) {
     return { state: null, raw: null };
   }
   const raw = parsed && typeof parsed === "object" ? parsed : {};
-  const result2 = StateSchema.safeParse(parsed);
+  overlaySidecarsSync(changeDir, raw, (p) => getStorage().read(p));
+  const result2 = StateSchema.safeParse(raw);
   return { state: result2.success ? result2.data : null, raw };
 }
 function writeState(changeDir, state) {
-  const filePath = join9(changeDir, STATE_FILE2);
-  getStorage().write(filePath, JSON.stringify(state, null, 2) + `
+  const filePath = join10(changeDir, STATE_FILE2);
+  const core2 = stripOwnedSlots(state);
+  getStorage().write(filePath, JSON.stringify(core2, null, 2) + `
 `);
 }
 function updateState(changeDir, updater) {
@@ -89211,7 +89326,7 @@ function buildInitialState(options) {
   });
 }
 function ensureState(changeDir) {
-  const filePath = join9(changeDir, STATE_FILE2);
+  const filePath = join10(changeDir, STATE_FILE2);
   const storage = getStorage();
   if (storage.read(filePath) !== null) {
     return readState(changeDir);
@@ -89225,11 +89340,12 @@ var STATE_FILE2 = ".ralph-state.json";
 var init_state = __esm(() => {
   init_types2();
   init_context();
+  init_schema2();
+  init_sidecar();
 });
 
 // packages/core/src/state/store.ts
-import { dirname as dirname5, join as join10 } from "path";
-import { mkdir as mkdir3 } from "fs/promises";
+import { join as join11 } from "path";
 async function readJson(filePath) {
   const file2 = Bun.file(filePath);
   if (!await file2.exists())
@@ -89244,22 +89360,6 @@ async function readJson(filePath) {
     return {};
   }
 }
-function deepSet(target, path, value) {
-  const segments = path.split(".");
-  let cursor = target;
-  for (let i = 0;i < segments.length - 1; i++) {
-    const key = segments[i];
-    const existing = cursor[key];
-    if (existing === undefined || existing === null || typeof existing !== "object" || Array.isArray(existing)) {
-      const next = {};
-      cursor[key] = next;
-      cursor = next;
-    } else {
-      cursor = existing;
-    }
-  }
-  cursor[segments[segments.length - 1]] = value;
-}
 async function writeField(changeDir, featureName, path, value) {
   const allowed = OWNERSHIP[featureName];
   if (!allowed) {
@@ -89269,16 +89369,15 @@ async function writeField(changeDir, featureName, path, value) {
   if (!allowed.includes(topSlot)) {
     throw new OwnershipError(featureName, path, `feature '${featureName}' may not write '${path}' (owns ${allowed.join(", ")})`);
   }
-  const filePath = join10(changeDir, STATE_FILE3);
-  const existing = await readJson(filePath);
-  deepSet(existing, path, value);
-  await mkdir3(dirname5(filePath), { recursive: true });
-  await Bun.write(filePath, JSON.stringify(existing, null, 2) + `
-`);
+  const inline = (await readJson(join11(changeDir, STATE_FILE3)))[topSlot];
+  const seed = inline && typeof inline === "object" && !Array.isArray(inline) ? inline : undefined;
+  await writeSlotField(changeDir, path, value, seed);
 }
 var STATE_FILE3 = ".ralph-state.json", OwnershipError;
 var init_store = __esm(() => {
   init_schema2();
+  init_sidecar();
+  init_sidecar();
   init_state();
   OwnershipError = class OwnershipError extends Error {
     featureName;
@@ -89293,14 +89392,14 @@ var init_store = __esm(() => {
 });
 
 // apps/loop/src/components/TaskStatus.tsx
-import { join as join11 } from "path";
+import { join as join12 } from "path";
 function TaskStatus({ state, stateDir }) {
   const storage = getStorage();
   const cost = Math.round(state.usage.total_cost_usd * 100) / 100;
   const time3 = Math.round(state.usage.total_duration_ms / 1000 * 10) / 10 + "s";
   const artifacts = OPENSPEC_ARTIFACTS.map((name) => ({
     name,
-    exists: storage.read(join11(stateDir, name)) !== null
+    exists: storage.read(join12(stateDir, name)) !== null
   }));
   const recent = state.history.slice(-10);
   return /* @__PURE__ */ jsx_dev_runtime2.jsxDEV(Box_default, {
@@ -98017,8 +98116,8 @@ var init_rate_limit_detection = __esm(() => {
 });
 
 // packages/engine/src/agents/claude.ts
-import { mkdtemp, unlink } from "fs/promises";
-import { join as join12 } from "path";
+import { mkdtemp, unlink as unlink2 } from "fs/promises";
+import { join as join13 } from "path";
 import { tmpdir } from "os";
 function buildClaudeArgs(model, resumeSessionId, reviewerContextStrategy, reviewerModel) {
   const effectiveModel = reviewerModel ?? model;
@@ -98039,7 +98138,7 @@ function buildClaudeArgs(model, resumeSessionId, reviewerContextStrategy, review
 }
 async function runInteractive(req) {
   const { model, prompt, taskDir } = req;
-  const promptFile = taskDir ? join12(taskDir, "_interactive_prompt.md") : join12(await mkdtemp(join12(tmpdir(), "ralph-")), "prompt.md");
+  const promptFile = taskDir ? join13(taskDir, "_interactive_prompt.md") : join13(await mkdtemp(join13(tmpdir(), "ralph-")), "prompt.md");
   await Bun.write(promptFile, prompt);
   try {
     const cmd = [
@@ -98066,14 +98165,14 @@ async function runInteractive(req) {
       env: scrubClaudeEnv(process.env)
     });
     const exitCode = await proc.exited;
-    const doneFile = taskDir ? join12(taskDir, "_interactive_done") : null;
+    const doneFile = taskDir ? join13(taskDir, "_interactive_done") : null;
     if (doneFile && await Bun.file(doneFile).exists()) {
       return { exitCode: 0, usage: null, sessionId: null, rateLimited: false };
     }
     return { exitCode, usage: null, sessionId: null, rateLimited: false };
   } finally {
     try {
-      await unlink(promptFile);
+      await unlink2(promptFile);
     } catch {}
   }
 }
@@ -99105,6 +99204,12 @@ class FlowActorStore {
     return typeof s.value === "string" || typeof s.status === "string";
   }
   async loadSnapshot(changeDir) {
+    const sidecar = await readSlotSidecar(changeDir, "flow");
+    if (sidecar && typeof sidecar === "object") {
+      const snap = sidecar.actorSnapshot;
+      if (snap !== undefined && snap !== null)
+        return snap;
+    }
     const filePath = `${changeDir}/${STATE_FILE4}`;
     const file2 = Bun.file(filePath);
     if (!await file2.exists())
@@ -99563,11 +99668,11 @@ var init_meta_prompt = __esm(() => {
 });
 
 // packages/core/src/loop.ts
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 function buildTaskPrompt(state, taskDir, reviewPhase) {
   const storage = getStorage();
   let prompt = "";
-  const steeringContent = storage.read(join13(taskDir, "steering.md"));
+  const steeringContent = storage.read(join14(taskDir, "steering.md"));
   if (steeringContent !== null) {
     const steeringLines = steeringContent.split(`
 `).filter((line) => !line.startsWith("#")).filter((line) => line.trim()).slice(0, STEERING_MAX_LINES);
@@ -99586,8 +99691,8 @@ function buildTaskPrompt(state, taskDir, reviewPhase) {
 `;
     }
   }
-  const agentTasksPath = join13(taskDir, AGENT_TASKS_FILENAME);
-  const missionTasksPath = join13(taskDir, MISSION_TASKS_FILENAME);
+  const agentTasksPath = join14(taskDir, AGENT_TASKS_FILENAME);
+  const missionTasksPath = join14(taskDir, MISSION_TASKS_FILENAME);
   const agentTasksContent = storage.read(agentTasksPath);
   const missionTasksContent = storage.read(missionTasksPath);
   let activePath = null;
@@ -99663,7 +99768,7 @@ function buildTaskPrompt(state, taskDir, reviewPhase) {
     }
   }
   if (reviewPhase?.enabled) {
-    const reviewFindingsPath = join13(taskDir, "review-findings.md");
+    const reviewFindingsPath = join14(taskDir, "review-findings.md");
     const reviewFindingsContent = storage.read(reviewFindingsPath);
     const hasUncheckedMission = missionTasksContent !== null && /^- \[ \]/m.test(missionTasksContent);
     const hasUncheckedAgent = agentTasksContent !== null && /^- \[ \]/m.test(agentTasksContent);
@@ -99737,7 +99842,7 @@ When all tasks are complete and all files are committed, push your branch and op
 }
 function buildSteeringBlock(taskDir) {
   const storage = getStorage();
-  const steeringContent = storage.read(join13(taskDir, "steering.md"));
+  const steeringContent = storage.read(join14(taskDir, "steering.md"));
   if (steeringContent === null)
     return "";
   const steeringLines = steeringContent.split(`
@@ -99835,7 +99940,7 @@ function buildPlanPrompt(state, taskDir) {
   return prompt;
 }
 function buildReviewPrompt(state, taskDir) {
-  const reviewFindingsPath = join13(taskDir, "review-findings.md");
+  const reviewFindingsPath = join14(taskDir, "review-findings.md");
   let prompt = buildSteeringBlock(taskDir);
   prompt += `---
 
@@ -99900,7 +100005,7 @@ function buildPhasePrompt(phase, state, taskDir, reviewPhase, metaPromptOptions)
 }
 function checkStopSignal(taskDir, stateDir) {
   const storage = getStorage();
-  const stopFile = join13(taskDir, "STOP");
+  const stopFile = join14(taskDir, "STOP");
   const reason = storage.read(stopFile);
   if (reason === null)
     return null;
@@ -99960,7 +100065,7 @@ function updateStateIteration(stateDir, result2, startedAt, engine, model, usage
 }
 function appendSteeringMessage(taskDir, message) {
   const storage = getStorage();
-  const steeringPath = join13(taskDir, "steering.md");
+  const steeringPath = join14(taskDir, "steering.md");
   const existing = storage.read(steeringPath);
   const updated = existing ? `${message}
 
@@ -100010,7 +100115,7 @@ var init_loop2 = __esm(() => {
 });
 
 // apps/loop/src/hooks/useLoop.ts
-import { join as join14 } from "path";
+import { join as join15 } from "path";
 function sleep(seconds) {
   return new Promise((resolve3) => setTimeout(resolve3, seconds * 1000));
 }
@@ -100072,7 +100177,7 @@ function useLoop(opts) {
         }
       } else {
         if (rawState !== null) {
-          addInfo(`.ralph-state.json was malformed \u2014 reinitialising. External fields (linearComments, specAttachments) preserved.`);
+          addInfo(`.ralph-state.json was malformed \u2014 reinitialising. Feature-owned slots (linearComments, specAttachments, \u2026) live in their own sidecar files and are unaffected.`);
         }
         currentState = buildInitialState({
           name: opts.name,
@@ -100082,12 +100187,6 @@ function useLoop(opts) {
           manualTest: opts.manualTest,
           createPr: opts.createPr ?? false
         });
-        if (rawState !== null && rawState.linearComments) {
-          currentState.linearComments = rawState.linearComments;
-        }
-        if (rawState !== null && rawState.specAttachments) {
-          currentState.specAttachments = rawState.specAttachments;
-        }
         writeState(stateDir, currentState);
       }
       const isResume2 = currentState.iteration > 0;
@@ -100132,8 +100231,8 @@ function useLoop(opts) {
         setState(currentState);
         if (!actor.getSnapshot().matches("running"))
           break;
-        const tasksContent = storage.read(join14(tasksDir, MISSION_TASKS_FILENAME));
-        const agentTasksContent = storage.read(join14(tasksDir, AGENT_TASKS_FILENAME));
+        const tasksContent = storage.read(join15(tasksDir, MISSION_TASKS_FILENAME));
+        const agentTasksContent = storage.read(join15(tasksDir, AGENT_TASKS_FILENAME));
         if (tasksContent === null && currentState.iteration > 0 && typeof opts.changeStore.listChanges === "function") {
           let stillActive = true;
           try {
@@ -100170,7 +100269,7 @@ function useLoop(opts) {
         const agentDone = agentTasksContent === null || allCompleted(agentTasksContent);
         if (missionDone && agentDone && tasksContent !== null) {
           if (opts.reviewPhase?.enabled) {
-            const reviewFindingsPath = join14(tasksDir, "review-findings.md");
+            const reviewFindingsPath = join15(tasksDir, "review-findings.md");
             const reviewFindingsFile = Bun.file(reviewFindingsPath);
             const findingsExists = await reviewFindingsFile.exists();
             const findingsContent = findingsExists ? await reviewFindingsFile.text() : null;
@@ -100199,7 +100298,7 @@ function useLoop(opts) {
                 model: opts.reviewPhase.reviewerModel ?? opts.model,
                 prompt: reviewPrompt,
                 logFlag: opts.log,
-                logFile: join14(stateDir, `log-review-${roundNum}.json`),
+                logFile: join15(stateDir, `log-review-${roundNum}.json`),
                 taskDir: tasksDir,
                 reviewerContextStrategy: opts.reviewPhase.reviewerContextStrategy ?? "fresh",
                 onFeedEvent: addFeedEvent
@@ -100273,8 +100372,8 @@ function useLoop(opts) {
         const time3 = new Date().toLocaleTimeString("en-US", { hour12: false });
         addIterationHeader(localIter, time3);
         addInfo(`Iteration ${localIter} (total: ${currentState.iteration})`);
-        const proposalContent = storage.read(join14(tasksDir, "proposal.md"));
-        const designContent = storage.read(join14(tasksDir, "design.md"));
+        const proposalContent = storage.read(join15(tasksDir, "proposal.md"));
+        const designContent = storage.read(join15(tasksDir, "design.md"));
         const routedPhase = routeTaskPhase(opts.phase, {
           proposal: proposalContent,
           design: designContent,
@@ -100294,7 +100393,7 @@ function useLoop(opts) {
             model: opts.model,
             prompt,
             logFlag: opts.log,
-            logFile: join14(stateDir, "log.json"),
+            logFile: join15(stateDir, "log.json"),
             taskDir: tasksDir,
             interactive: false,
             onFeedEvent: addFeedEvent,
@@ -100317,7 +100416,7 @@ function useLoop(opts) {
               model: opts.model,
               prompt: buildSteeringPrompt(steerMessage),
               logFlag: opts.log,
-              logFile: join14(stateDir, "log.json"),
+              logFile: join15(stateDir, "log.json"),
               taskDir: tasksDir,
               onFeedEvent: addResumeFeedEvent,
               signal: resumeController.signal,
@@ -100624,7 +100723,7 @@ var init_TaskLoop = __esm(async () => {
 });
 
 // apps/loop/src/components/App.tsx
-import { join as join15 } from "path";
+import { join as join16 } from "path";
 function ExitAfterRender({ children }) {
   const { exit } = use_app_default();
   import_react59.useEffect(() => {
@@ -100677,7 +100776,7 @@ function App2({ args, taskPhase }) {
       }
       const layout = getLayout();
       const stateDir = layout.taskStateDir(args.name);
-      if (getStorage().read(join15(stateDir, ".ralph-state.json")) === null) {
+      if (getStorage().read(join16(stateDir, ".ralph-state.json")) === null) {
         return /* @__PURE__ */ jsx_dev_runtime9.jsxDEV(ErrorMessage, {
           message: `Error: change '${args.name}' not found`
         }, undefined, false, undefined, this);
@@ -100731,7 +100830,7 @@ var init_App2 = __esm(async () => {
 
 // packages/log/src/log.ts
 import { appendFile } from "fs/promises";
-import { join as join16, dirname as dirname7 } from "path";
+import { join as join17, dirname as dirname7 } from "path";
 import { homedir as homedir4 } from "os";
 import { mkdir as mkdir5 } from "fs/promises";
 function fmt(type, text) {
@@ -100780,14 +100879,14 @@ var init_log = __esm(() => {
   init_version();
   jsonLogChains = new Map;
   ANSI_RE = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
-  AGENT_LOG_PATH = join16(homedir4(), ".ralph", "agent-mode.log");
+  AGENT_LOG_PATH = join17(homedir4(), ".ralph", "agent-mode.log");
   mkdir5(dirname7(AGENT_LOG_PATH), { recursive: true }).catch(() => {
     return;
   });
 });
 
 // apps/loop/src/debug.ts
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 function fmtTs(d) {
   return d.toISOString().replace("T", " ").slice(0, 23);
 }
@@ -100899,7 +100998,7 @@ function detectDebugStuck(lines) {
   };
 }
 async function inspectBinary(projectRoot) {
-  const binPath = join17(projectRoot, ".ralph", "bin", "cli.js");
+  const binPath = join18(projectRoot, ".ralph", "bin", "cli.js");
   const file2 = Bun.file(binPath);
   if (!await file2.exists())
     return null;
@@ -100924,7 +101023,7 @@ async function inspectBinary(projectRoot) {
 async function resolveDebugTarget(projectRoot, opts) {
   const agentLogFile = Bun.file(AGENT_LOG_PATH);
   const textLines = await agentLogFile.exists() ? parseTextLog(await agentLogFile.text()) : [];
-  const jsonlLogFile = Bun.file(join17(projectRoot, ".ralph", "agent.log"));
+  const jsonlLogFile = Bun.file(join18(projectRoot, ".ralph", "agent.log"));
   const jsonlLines = await jsonlLogFile.exists() ? parseJsonlLog(await jsonlLogFile.text()) : [];
   const allLines = [...textLines, ...jsonlLines];
   if (opts.name && !opts.issue) {
@@ -101029,7 +101128,7 @@ async function runDebug(opts) {
 `);
   const agentLogFile = Bun.file(AGENT_LOG_PATH);
   const textLines = await agentLogFile.exists() ? parseTextLog(await agentLogFile.text()) : [];
-  const jsonlLogPath = join17(projectRoot, ".ralph", "agent.log");
+  const jsonlLogPath = join18(projectRoot, ".ralph", "agent.log");
   const jsonlLogFile = Bun.file(jsonlLogPath);
   const hasJsonlLog = await jsonlLogFile.exists();
   let { changeName, identifier: issueIdentifier } = await resolveDebugTarget(projectRoot, {
@@ -101043,7 +101142,7 @@ async function runDebug(opts) {
   }
   const jsonlLines = hasJsonlLog ? parseJsonlLog(await jsonlLogFile.text(), changeName) : [];
   const relevantText = textLines.filter((l) => l.text.includes(changeName) || issueIdentifier !== undefined && l.text.includes(issueIdentifier));
-  const workerLogFile = Bun.file(join17(projectRoot, ".ralph", "logs", `${changeName}.log`));
+  const workerLogFile = Bun.file(join18(projectRoot, ".ralph", "logs", `${changeName}.log`));
   const workerLines = await workerLogFile.exists() ? parseTextLog(await workerLogFile.text()) : [];
   const merged = [...relevantText, ...jsonlLines, ...workerLines].sort((a, b) => +a.ts - +b.ts);
   const seen = new Set;
@@ -101200,8 +101299,8 @@ async function runDebug(opts) {
     out("  \u26A0 PR currently has merge conflicts");
   if (pr?.checks.some((c) => c.conclusion === "FAILURE"))
     out("  \u26A0 PR has failing CI checks");
-  const worktreePath = join17(projectRoot, ".ralph", "worktrees", changeName);
-  if (await Bun.file(join17(worktreePath, ".git")).exists()) {
+  const worktreePath = join18(projectRoot, ".ralph", "worktrees", changeName);
+  if (await Bun.file(join18(worktreePath, ".git")).exists()) {
     out(`  Worktree   : ${worktreePath}`);
   }
   if (!timeline.length)
@@ -101221,12 +101320,12 @@ __export(exports_src2, {
   taskMain: () => taskMain,
   main: () => main2
 });
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 import { exists as exists2, mkdir as mkdir6, rm as rm2 } from "fs/promises";
 async function ensureRalphGitignore(projectRoot) {
-  const ralphDir = join18(projectRoot, ".ralph");
+  const ralphDir = join19(projectRoot, ".ralph");
   await mkdir6(ralphDir, { recursive: true });
-  const gitignorePath = join18(ralphDir, ".gitignore");
+  const gitignorePath = join19(ralphDir, ".gitignore");
   const file2 = Bun.file(gitignorePath);
   if (await file2.exists()) {
     const existing = await file2.text();
@@ -101293,9 +101392,9 @@ async function main2(argv) {
 `);
       return 1;
     }
-    const worktreeDir = join18(worktreesDir(projectRoot), args.name);
-    const changeDir = join18(tasksDir, args.name);
-    const stateDir = join18(statesDir, args.name);
+    const worktreeDir = join19(worktreesDir(projectRoot), args.name);
+    const changeDir = join19(tasksDir, args.name);
+    const stateDir = join19(statesDir, args.name);
     const branch = `ralph/${args.name}`;
     const removed = [];
     if (await exists2(worktreeDir)) {
@@ -101346,8 +101445,8 @@ async function main2(argv) {
     return 0;
   }
   if (args.mode === "task" && args.name) {
-    await mkdir6(join18(statesDir, args.name), { recursive: true });
-    await mkdir6(join18(tasksDir, args.name), { recursive: true });
+    await mkdir6(join19(statesDir, args.name), { recursive: true });
+    await mkdir6(join19(tasksDir, args.name), { recursive: true });
     await ensureRalphGitignore(projectRoot);
   }
   await runWithContext(createDefaultContext({ layout, args }), async () => {
@@ -101375,8 +101474,8 @@ async function taskMain(argv) {
   const layout = projectLayout(projectRoot);
   const statesDir = layout.statesDir;
   const tasksDir = layout.tasksDir;
-  await mkdir6(join18(statesDir, args.name), { recursive: true });
-  await mkdir6(join18(tasksDir, args.name), { recursive: true });
+  await mkdir6(join19(statesDir, args.name), { recursive: true });
+  await mkdir6(join19(tasksDir, args.name), { recursive: true });
   await ensureRalphGitignore(projectRoot);
   await runWithContext(createDefaultContext({ layout, args }), async () => {
     const { waitUntilExit } = render_default(import_react60.createElement(App2, {
@@ -101471,6 +101570,7 @@ async function parseAgentArgs(argv) {
     noTmux: false,
     checks: false,
     review: false,
+    agentDebug: false,
     ticketTokens: []
   };
   const state = emptyParseState();
@@ -101593,6 +101693,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 +101795,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:",
@@ -101768,7 +101872,7 @@ function formatError2(err) {
 }
 
 // apps/agent/src/shared/capabilities/fs-change.ts
-import { join as join19, dirname as dirname8 } from "path";
+import { join as join20, dirname as dirname8 } from "path";
 import { mkdir as mkdir7 } from "fs/promises";
 var scaffold, prependTask, appendSteering, fsChange;
 var init_fs_change = __esm(() => {
@@ -101781,11 +101885,11 @@ var init_fs_change = __esm(() => {
     errorFormatter: formatError2,
     run: async (args) => {
       await mkdir7(args.changeDir, { recursive: true });
-      await mkdir7(join19(args.changeDir, "specs"), { recursive: true });
+      await mkdir7(join20(args.changeDir, "specs"), { recursive: true });
       await mkdir7(args.stateDir, { recursive: true });
-      await Bun.write(join19(args.changeDir, "proposal.md"), args.proposal);
-      await Bun.write(join19(args.changeDir, "tasks.md"), args.tasks);
-      await Bun.write(join19(args.changeDir, "design.md"), args.design);
+      await Bun.write(join20(args.changeDir, "proposal.md"), args.proposal);
+      await Bun.write(join20(args.changeDir, "tasks.md"), args.tasks);
+      await Bun.write(join20(args.changeDir, "design.md"), args.design);
     }
   };
   prependTask = {
@@ -101803,7 +101907,7 @@ var init_fs_change = __esm(() => {
     retryPolicy: NO_RETRY,
     errorFormatter: formatError2,
     run: async (args) => {
-      const path = join19(args.changeDir, "steering.md");
+      const path = join20(args.changeDir, "steering.md");
       const f2 = Bun.file(path);
       const existing = await f2.exists() ? await f2.text() : null;
       const updated = existing ? `${args.message}
@@ -101818,11 +101922,11 @@ ${existing.trimStart()}` : `${args.message}
 });
 
 // apps/agent/src/agent/worktree.ts
-import { basename as basename2, join as join20 } from "path";
+import { basename as basename2, join as join21 } from "path";
 import { homedir as homedir5 } from "os";
 import { exists as exists3 } from "fs/promises";
 function worktreesDir2(projectRoot) {
-  return join20(homedir5(), ".ralph", basename2(projectRoot), "worktrees");
+  return join21(homedir5(), ".ralph", basename2(projectRoot), "worktrees");
 }
 function branchForChange(changeName) {
   return `ralph/${changeName}`;
@@ -101841,7 +101945,7 @@ function createWorktree(projectRoot, changeName, baseBranch, runner) {
 }
 async function provisionWorktree(projectRoot, changeName, baseBranch, runner) {
   const dir = worktreesDir2(projectRoot);
-  const cwd2 = join20(dir, changeName);
+  const cwd2 = join21(dir, changeName);
   const branch = branchForChange(changeName);
   const list = await runner.run(["worktree", "list", "--porcelain"], projectRoot);
   if (list.stdout.includes(`worktree ${cwd2}
@@ -101866,7 +101970,7 @@ async function provisionWorktree(projectRoot, changeName, baseBranch, runner) {
   return { cwd: cwd2, branch };
 }
 async function installPrePushHook(cwd2, runner) {
-  const hookPath = join20(cwd2, ".ralph-hooks", "pre-push");
+  const hookPath = join21(cwd2, ".ralph-hooks", "pre-push");
   await Bun.write(hookPath, PRE_PUSH_HOOK_SCRIPT);
   const chmod = Bun.spawn(["chmod", "+x", hookPath]);
   await chmod.exited;
@@ -101912,8 +102016,8 @@ async function isWorktreeSafeToRemove(cwd2, base2, runner) {
   return { safe: true, dirty, unpushedCommits };
 }
 async function seedWorktreeMcpConfig(projectRoot, worktreeCwd) {
-  const dst = join20(worktreeCwd, ".mcp.json");
-  const src = join20(projectRoot, ".mcp.json");
+  const dst = join21(worktreeCwd, ".mcp.json");
+  const src = join21(projectRoot, ".mcp.json");
   const source = await exists3(dst) ? dst : await exists3(src) ? src : null;
   if (!source)
     return;
@@ -101927,7 +102031,7 @@ async function seedWorktreeMcpConfig(projectRoot, worktreeCwd) {
   if (servers && typeof servers === "object") {
     for (const cfg of Object.values(servers)) {
       if (Array.isArray(cfg.args)) {
-        cfg.args = cfg.args.map((a) => typeof a === "string" && a.startsWith(".ralph/") ? join20(projectRoot, a) : a);
+        cfg.args = cfg.args.map((a) => typeof a === "string" && a.startsWith(".ralph/") ? join21(projectRoot, a) : a);
       }
     }
   }
@@ -103777,7 +103881,7 @@ function emitFeatureSkipped(bus, id, reason) {
 var init_run_feature = () => {};
 
 // apps/agent/src/agent/post-task.ts
-import { join as join21, dirname as dirname9 } from "path";
+import { join as join22, dirname as dirname9 } from "path";
 function summarizeUncommittedStatus(stdout) {
   const lines = stdout.split(`
 `).filter((line) => line.length > 0);
@@ -103849,7 +103953,7 @@ async function reactivateState(stateFilePath, log3, changeName) {
 async function runWorkerWithFixTask(ctx, heading, body) {
   try {
     await runCapability(fsChange.prependTask, {
-      tasksPath: join21(ctx.changeDir, AGENT_TASKS_FILENAME),
+      tasksPath: join22(ctx.changeDir, AGENT_TASKS_FILENAME),
       heading,
       failureOutput: body
     });
@@ -104396,7 +104500,7 @@ async function runValidateOnlyPhase(input, deps) {
         emit3("validate-fix", command);
         log3(`! validation check failed: ${command}`, "yellow");
         try {
-          await prependFixTask(join21(changeDir, AGENT_TASKS_FILENAME), `Fix failing validation: ${command}`, output || `Command exited with code ${exitCode}`);
+          await prependFixTask(join22(changeDir, AGENT_TASKS_FILENAME), `Fix failing validation: ${command}`, output || `Command exited with code ${exitCode}`);
         } catch (err) {
           log3(`! could not prepend fix task: ${err.message}`, "red");
           return 1;
@@ -104407,7 +104511,7 @@ async function runValidateOnlyPhase(input, deps) {
     }
   }
   try {
-    await prependFixTask(join21(changeDir, AGENT_TASKS_FILENAME), "Run openspec validation", [
+    await prependFixTask(join22(changeDir, AGENT_TASKS_FILENAME), "Run openspec validation", [
       `Run \`bunx openspec validate ${changeName}\` to validate the change artifacts.`,
       `Commit any pending changes before running the validation command.`
     ].join(`
@@ -104420,7 +104524,7 @@ async function runValidateOnlyPhase(input, deps) {
   return respawnWorker();
 }
 async function recordGaveUp(stateFilePath, log3, changeName) {
-  const path = join21(dirname9(stateFilePath), GAVEUP_COUNT_FILE);
+  const path = join22(dirname9(stateFilePath), GAVEUP_COUNT_FILE);
   try {
     const file2 = Bun.file(path);
     const current = await file2.exists() ? Number.parseInt(await file2.text(), 10) || 0 : 0;
@@ -104551,6 +104655,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 +105331,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 +105636,7 @@ class AgentCoordinator {
       kill: handle.kill,
       lastReportedIteration: 0,
       lastSyncedIteration: 0,
+      lastSyncedTasksFingerprint: null,
       restarting: false,
       reapedForAwaiting: false
     };
@@ -105660,6 +105800,7 @@ class AgentCoordinator {
         kill: () => {},
         lastReportedIteration: 0,
         lastSyncedIteration: 0,
+        lastSyncedTasksFingerprint: null,
         restarting: false,
         reapedForAwaiting: false
       };
@@ -105789,15 +105930,15 @@ var init_coordinator2 = __esm(() => {
 });
 
 // apps/agent/src/agent/scaffold.ts
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 function changeNameForIssue(issue2) {
   const slug = issue2.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").slice(0, 40).replace(/^-+|-+$/g, "");
   return slug ? `${issue2.identifier.toLowerCase()}-${slug}` : issue2.identifier.toLowerCase();
 }
 async function scaffoldChangeForIssue(tasksDir, statesDir, issue2, comments = [], appendPrompt = "", attachments = []) {
   const name = changeNameForIssue(issue2);
-  const changeDir = join22(tasksDir, name);
-  const stateDir = join22(statesDir, name);
+  const changeDir = join23(tasksDir, name);
+  const stateDir = join23(statesDir, name);
   const commentsBlock = comments.length > 0 ? [
     "",
     "## Linear comments",
@@ -105850,8 +105991,8 @@ async function scaffoldChangeForIssue(tasksDir, statesDir, issue2, comments = []
     `- [ ] Refine proposal.md with the problem statement, approach, and acceptance criteria derived from the research`,
     `- [ ] Fill in \`## Why\` and \`## What Changes\` in proposal.md so \`openspec validate\` passes (these sections are required by the validator)`,
     `- [ ] Add at least one spec delta under \`specs/<capability>/spec.md\` describing the behavior added/modified/removed by this change`,
-    `- [ ] Fill in design.md with the technical design (files to touch, data flow, edge cases)`,
-    `- [ ] Append an \`## Implementation\` section below with concrete mission-specific tasks derived from the plan, including tests and \`bun run lint\` / \`bun run test\`. Every item in the new section MUST start as \`- [ ]\` (unchecked) \u2014 do not pre-check items even if you already did the work during planning. The loop ticks them off in later iterations after each one is verified.`,
+    `- [ ] Fill in design.md with the technical design (files to touch, data flow, edge cases). design.md holds prose and tables ONLY \u2014 never a task checklist; the implementation tasks belong in this tasks.md file (next item).`,
+    `- [ ] Append an \`## Implementation\` section to **this tasks.md file** (below the \`## Planning\` section above \u2014 NOT in design.md) with concrete mission-specific tasks derived from the plan, including tests and \`bun run lint\` / \`bun run test\`. Every item in the new section MUST start as \`- [ ]\` (unchecked) \u2014 do not pre-check items even if you already did the work during planning. The loop ticks them off in later iterations after each one is verified.`,
     `- [ ] Is there anything else to add? Review the complete change context and document any additional edge cases, constraints, or open questions not captured above.`,
     ""
   ].join(`
@@ -105933,19 +106074,22 @@ var init_detections = __esm(() => {
 });
 
 // apps/agent/src/features/confirmation/state.ts
-import { dirname as dirname10, join as join23 } from "path";
-import { mkdir as mkdir8 } from "fs/promises";
-async function readConfirmationState(statePath) {
+import { dirname as dirname10, join as join24 } from "path";
+async function readInlineConfirmation(statePath) {
   const f2 = Bun.file(statePath);
-  let stateObj = {};
-  if (await f2.exists()) {
-    try {
-      stateObj = await f2.json();
-    } catch {
-      stateObj = {};
-    }
+  if (!await f2.exists())
+    return null;
+  try {
+    const obj = await f2.json();
+    return obj.confirmation ?? null;
+  } catch {
+    return null;
   }
-  const existing = stateObj.confirmation ?? null;
+}
+async function readConfirmationState(statePath) {
+  const changeDir = dirname10(statePath);
+  const sidecar = await readSlotSidecar(changeDir, "confirmation");
+  const existing = sidecar ?? await readInlineConfirmation(statePath) ?? null;
   const confirmation = {
     askedAt: existing?.askedAt ?? null,
     lastReminderAt: existing?.lastReminderAt ?? null,
@@ -105953,14 +106097,13 @@ async function readConfirmationState(statePath) {
     rounds: existing?.rounds ?? 0,
     stuckPostedAt: existing?.stuckPostedAt ?? null,
     lastReviseConsumedAt: existing?.lastReviseConsumedAt ?? null,
-    awaitingMarkerAppliedAt: existing?.awaitingMarkerAppliedAt ?? null
+    awaitingMarkerAppliedAt: existing?.awaitingMarkerAppliedAt ?? null,
+    earlyDraftPrAt: existing?.earlyDraftPrAt ?? null
   };
-  return { stateObj, confirmation };
+  return { stateObj: {}, confirmation };
 }
-async function writeConfirmationState(statePath, stateObj, confirmation) {
-  await mkdir8(dirname10(statePath), { recursive: true });
-  await Bun.write(statePath, JSON.stringify({ ...stateObj, confirmation }, null, 2) + `
-`);
+async function writeConfirmationState(statePath, _stateObj, confirmation) {
+  await writeSlotField(dirname10(statePath), "confirmation", confirmation);
 }
 async function restartFromDesign(changeDir, changeName) {
   const designStub = [
@@ -105970,8 +106113,8 @@ async function restartFromDesign(changeDir, changeName) {
     ""
   ].join(`
 `);
-  await Bun.write(join23(changeDir, "design.md"), designStub);
-  const tasksPath = join23(changeDir, "tasks.md");
+  await Bun.write(join24(changeDir, "design.md"), designStub);
+  const tasksPath = join24(changeDir, "tasks.md");
   if (await Bun.file(tasksPath).exists()) {
     await Bun.write(tasksPath, `# Tasks
 
@@ -105983,6 +106126,7 @@ async function appendSteeringNote(changeDir, message) {
   await runCapability(fsChange.appendSteering, { changeDir, message });
 }
 var init_state2 = __esm(() => {
+  init_store();
   init_fs_change();
 });
 
@@ -106200,8 +106344,7 @@ var init_inspect = __esm(() => {
 });
 
 // apps/agent/src/features/confirmation/awaiting.ts
-import { join as join24, dirname as dirname11 } from "path";
-import { mkdir as mkdir9 } from "fs/promises";
+import { join as join25 } from "path";
 async function resolveChangeCwdForIssue(issue2, changeName, deps) {
   const tracked = deps.cwdOf(changeName);
   if (tracked)
@@ -106209,12 +106352,12 @@ async function resolveChangeCwdForIssue(issue2, changeName, deps) {
   if (!deps.useWorktree)
     return deps.projectRoot;
   const root = worktreesDir2(deps.projectRoot);
-  const canonical = join24(root, worktreeDirNameForIssue(issue2));
-  if (await Bun.file(join24(canonical, "openspec", "changes", changeName, "tasks.md")).exists()) {
+  const canonical = join25(root, worktreeDirNameForIssue(issue2));
+  if (await Bun.file(join25(canonical, "openspec", "changes", changeName, "tasks.md")).exists()) {
     return canonical;
   }
-  const legacy = join24(root, changeName);
-  if (await Bun.file(join24(legacy, "openspec", "changes", changeName, "tasks.md")).exists()) {
+  const legacy = join25(root, changeName);
+  if (await Bun.file(join25(legacy, "openspec", "changes", changeName, "tasks.md")).exists()) {
     return legacy;
   }
   return deps.projectRoot;
@@ -106234,17 +106377,8 @@ async function postPlanReadyCommentOnce(issue2, statePath, changeName, deps) {
     return;
   if (deps.cfg.linear.postComments === false)
     return;
-  let stateObj = {};
-  const f2 = Bun.file(statePath);
-  if (await f2.exists()) {
-    try {
-      stateObj = await f2.json();
-    } catch {
-      stateObj = {};
-    }
-  }
-  const confirmation = stateObj.confirmation ?? null;
-  if (confirmation?.askedAt)
+  const { confirmation } = await readConfirmationState(statePath);
+  if (confirmation.askedAt)
     return;
   const approvalSentence = describeApprovalMarker(deps.cfg.linear.indicators.getApproved);
   const handle = deps.cfg.linear.mentionHandle;
@@ -106255,16 +106389,8 @@ async function postPlanReadyCommentOnce(issue2, statePath, changeName, deps) {
     deps.onLog(`! Linear plan-ready comment failed for ${issue2.identifier}: ${err.message}`, "yellow");
     return;
   }
-  const nextConfirmation = {
-    askedAt: new Date().toISOString(),
-    lastReminderAt: confirmation?.lastReminderAt ?? null,
-    confirmedAt: confirmation?.confirmedAt ?? null,
-    rounds: confirmation?.rounds ?? 0
-  };
   try {
-    await mkdir9(dirname11(statePath), { recursive: true });
-    await Bun.write(statePath, JSON.stringify({ ...stateObj, confirmation: nextConfirmation }, null, 2) + `
-`);
+    await writeConfirmationState(statePath, {}, { ...confirmation, askedAt: new Date().toISOString() });
   } catch (err) {
     deps.onLog(`! could not persist confirmation.askedAt for ${issue2.identifier}: ${err.message}`, "yellow");
   }
@@ -106288,10 +106414,42 @@ async function applyAwaitingMarkerOnce(issue2, statePath, state, deps) {
     deps.onLog(`! persist awaitingMarkerAppliedAt for ${issue2.identifier}: ${err.message}`, "yellow");
   }
 }
+async function openDraftPrOnce(issue2, statePath, changeName, cwd2, state, deps) {
+  if (deps.cfg.prDraft !== true)
+    return;
+  if (!deps.openDraftPr)
+    return;
+  if (state.confirmation.earlyDraftPrAt)
+    return;
+  let url2 = null;
+  try {
+    url2 = await deps.openDraftPr(issue2, changeName, cwd2);
+  } catch (err) {
+    deps.onLog(`! early draft PR open failed for ${issue2.identifier}: ${err.message}`, "yellow");
+  }
+  state.confirmation.earlyDraftPrAt = new Date().toISOString();
+  try {
+    await writeConfirmationState(statePath, state.stateObj, state.confirmation);
+  } catch (err) {
+    deps.onLog(`! persist earlyDraftPrAt for ${issue2.identifier}: ${err.message}`, "yellow");
+  }
+  if (url2)
+    deps.onLog(`  ${issue2.identifier}: opened draft PR for design \u2014 ${url2}`, "gray");
+}
+function issueInAwaitingStatus(issue2, indicators) {
+  const set3 = indicators.setAwaitingConfirmation;
+  if (!set3)
+    return false;
+  const current = issue2.state?.name;
+  if (!current)
+    return false;
+  return markersOf(set3).some((m) => m.type === "status" && m.value === current);
+}
 async function releaseAwaitingMarker(issue2, statePath, deps) {
   const { stateObj, confirmation } = await readConfirmationState(statePath);
-  if (!confirmation.awaitingMarkerAppliedAt)
+  if (!confirmation.awaitingMarkerAppliedAt && !issueInAwaitingStatus(issue2, deps.indicators)) {
     return;
+  }
   if (deps.indicators.clearAwaitingConfirmation) {
     try {
       await deps.applyIndicator(issue2, deps.indicators.clearAwaitingConfirmation);
@@ -106299,6 +106457,13 @@ async function releaseAwaitingMarker(issue2, statePath, deps) {
       deps.onLog(`! clearAwaitingConfirmation failed for ${issue2.identifier}: ${err.message}`, "yellow");
     }
   }
+  if (deps.indicators.setInProgress) {
+    try {
+      await deps.applyIndicator(issue2, deps.indicators.setInProgress);
+    } catch (err) {
+      deps.onLog(`! restore setInProgress after awaiting release failed for ${issue2.identifier}: ${err.message}`, "yellow");
+    }
+  }
   confirmation.awaitingMarkerAppliedAt = null;
   try {
     await writeConfirmationState(statePath, stateObj, confirmation);
@@ -106327,9 +106492,9 @@ async function processAwaitingForIssue(issue2, deps) {
     const layout = projectLayout(cwd2);
     const changeDir = layout.changeDir(changeName);
     const statePath = layout.stateFile(changeName);
-    const tasks2 = await readTextOrNull(join24(changeDir, "tasks.md"));
-    const proposal = await readTextOrNull(join24(changeDir, "proposal.md"));
-    const design = await readTextOrNull(join24(changeDir, "design.md"));
+    const tasks2 = await readTextOrNull(join25(changeDir, "tasks.md"));
+    const proposal = await readTextOrNull(join25(changeDir, "proposal.md"));
+    const design = await readTextOrNull(join25(changeDir, "design.md"));
     let commentsCache = null;
     const getComments = async () => {
       if (commentsCache)
@@ -106413,6 +106578,7 @@ async function processAwaitingForIssue(issue2, deps) {
       cfg,
       onLog: deps.onLog
     });
+    await openDraftPrOnce(issue2, statePath, changeName, cwd2, { stateObj, confirmation }, { cfg, openDraftPr: deps.openDraftPr, onLog: deps.onLog });
     const { stateObj: state2, confirmation: confirmation2 } = await readConfirmationState(statePath);
     const { outcome, next } = await inspectAwaitingTicket(confirmation2, {
       mentionHandle: cfg.linear.mentionHandle,
@@ -106487,6 +106653,7 @@ var init_awaiting = __esm(() => {
   init_worktree();
   init_scaffold();
   init_linear();
+  init_types2();
   init_workflow();
   init_state2();
   init_inspect();
@@ -106561,9 +106728,26 @@ async function resolveDependencyBaseBranchImpl(issue2, runner, runnerCwd, deps)
   }
   return null;
 }
+function createOpenDraftPr(deps) {
+  const create3 = deps.createPr ?? createPullRequest;
+  return async (issue2, changeName, cwd2) => {
+    const branch = deps.branchByChange.get(changeName);
+    if (!branch)
+      return null;
+    const base2 = baseBranchFromLabels(issue2.labels) ?? deps.prBaseBranch;
+    const result2 = await create3({ cwd: cwd2, branch, issue: issue2, base: base2, draft: true }, deps.cmdRunner);
+    const url2 = result2?.url ?? null;
+    if (url2) {
+      deps.prByChange.set(changeName, url2);
+      deps.invalidatePrUrlForIssue(issue2.id);
+    }
+    return url2;
+  };
+}
 var GITHUB_PR_URL_RE, PR_NUMBER_RE, TICKET_IN_TITLE_RE;
 var init_pr_helpers = __esm(() => {
   init_linear();
+  init_pr();
   GITHUB_PR_URL_RE = /^https:\/\/github\.com\/[^/]+\/[^/]+\/pull\/\d+/;
   PR_NUMBER_RE = /\/pull\/(\d+)/;
   TICKET_IN_TITLE_RE = /^([A-Za-z][A-Za-z0-9]*-\d+)\b/;
@@ -106853,8 +107037,8 @@ var init_linear_resolvers = __esm(() => {
 });
 
 // apps/agent/src/agent/wire/prepare.ts
-import { mkdir as mkdir10 } from "fs/promises";
-import { join as join25 } from "path";
+import { mkdir as mkdir8 } from "fs/promises";
+import { join as join26 } from "path";
 function createPrepareHelpers(input) {
   const {
     args,
@@ -106918,7 +107102,7 @@ function createPrepareHelpers(input) {
     let changeName;
     const wtLayoutPre = projectLayout(workerCwd);
     const derivedName = changeNameForIssue(issue2);
-    const tasksMdPath = join25(wtLayoutPre.changeDir(derivedName), "tasks.md");
+    const tasksMdPath = join26(wtLayoutPre.changeDir(derivedName), "tasks.md");
     const tasksMdExists = await Bun.file(tasksMdPath).exists();
     const isFresh = !tasksMdExists;
     if (isFresh) {
@@ -106957,8 +107141,8 @@ function createPrepareHelpers(input) {
       changeName = await scaffoldChangeForIssue(scaffoldTasksDir, scaffoldStatesDir, issue2, comments, appendPrompt, attachments);
     } else {
       changeName = derivedName;
-      await mkdir10(wtLayoutPre.changeDir(changeName), { recursive: true });
-      await mkdir10(wtLayoutPre.taskStateDir(changeName), { recursive: true });
+      await mkdir8(wtLayoutPre.changeDir(changeName), { recursive: true });
+      await mkdir8(wtLayoutPre.taskStateDir(changeName), { recursive: true });
     }
     maps.cwdByChange.set(changeName, workerCwd);
     maps.statesDirByChange.set(changeName, scaffoldStatesDir);
@@ -106996,7 +107180,7 @@ function createPrepareHelpers(input) {
     if (!workerCwd)
       return;
     const wtLayout = projectLayout(workerCwd);
-    const tasksFile = join25(wtLayout.changeDir(changeName), AGENT_TASKS_FILENAME);
+    const tasksFile = join26(wtLayout.changeDir(changeName), AGENT_TASKS_FILENAME);
     if (trigger === "review") {
       let body2;
       let heading;
@@ -107289,21 +107473,24 @@ var init_pr_discovery = __esm(() => {
 });
 
 // apps/agent/src/features/review-followup/scan.ts
-import { dirname as dirname12, join as join26 } from "path";
+import { dirname as dirname11, join as join27 } from "path";
 async function resolveReviewStateDir(changeName, deps) {
   const root = deps.cwdOf(changeName);
   if (root)
-    return dirname12(projectLayout(root).stateFile(changeName));
+    return dirname11(projectLayout(root).stateFile(changeName));
   if (!deps.useWorktree)
-    return dirname12(projectLayout(deps.projectRoot).stateFile(changeName));
-  const wtPath = join26(worktreesDir2(deps.projectRoot), changeName);
+    return dirname11(projectLayout(deps.projectRoot).stateFile(changeName));
+  const wtPath = join27(worktreesDir2(deps.projectRoot), changeName);
   const statePath = projectLayout(wtPath).stateFile(changeName);
   if (await Bun.file(statePath).exists())
-    return dirname12(statePath);
+    return dirname11(statePath);
   return null;
 }
 async function readReviewWatermark(stateDir) {
-  const file2 = Bun.file(join26(stateDir, ".ralph-state.json"));
+  const sidecar = await readSlotSidecar(stateDir, "review");
+  if (sidecar)
+    return sidecar.lastConsumedCommentAt ?? null;
+  const file2 = Bun.file(join27(stateDir, ".ralph-state.json"));
   if (!await file2.exists())
     return null;
   try {
@@ -107515,7 +107702,7 @@ var init_github = __esm(() => {
 
 // apps/agent/src/agent/wire/mention-scan.ts
 import { readdir as readdir2 } from "fs/promises";
-import { join as join27 } from "path";
+import { join as join28 } from "path";
 function createMentionScanner(input) {
   const {
     apiKey,
@@ -107681,7 +107868,7 @@ function createMentionScanner(input) {
 async function isChangeArchivedForIssue(issue2, cwdByChange, projectRoot) {
   const changeName = changeNameForIssue(issue2);
   const root = cwdByChange.get(changeName) ?? projectRoot;
-  const archiveDir = join27(projectLayout(root).tasksDir, "archive");
+  const archiveDir = join28(projectLayout(root).tasksDir, "archive");
   let entries;
   try {
     entries = await readdir2(archiveDir);
@@ -107705,9 +107892,9 @@ var init_mention_scan = __esm(() => {
 });
 
 // apps/agent/src/agent/wire/spawn/default.ts
-import { join as join28 } from "path";
+import { join as join29 } from "path";
 function defaultSpawn(changeName, cmd, cwd2, logsDir, onWorkerOutput, note) {
-  const logFilePath = join28(logsDir, `${changeName}.log`);
+  const logFilePath = join29(logsDir, `${changeName}.log`);
   const ANSI_RE2 = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
   const BOX_ONLY_RE = /^[\s\u2500\u2502\u256D\u256E\u2570\u256F\u254C\u2504\u2501\u2503]+$/;
   const STATUS_BAR_LINE_RE = /^[\u280B\u2819\u2839\u2838\u283C\u2834\u2826\u2827\u2807\u280F\u2713\u2717]\s+iter\s+\d+/;
@@ -107767,8 +107954,190 @@ var init_default2 = __esm(() => {
   init_log();
 });
 
+// apps/agent/src/agent/state/agent-run-state.ts
+import { basename as basename3, join as join30 } from "path";
+import { homedir as homedir6 } from "os";
+import { mkdir as mkdir9, writeFile } from "fs/promises";
+function agentRunStatePath(projectRoot) {
+  return join30(homedir6(), ".ralph", basename3(projectRoot), "agent-state.json");
+}
+async function writeAgentRunState(state) {
+  const path = agentRunStatePath(state.projectRoot);
+  try {
+    await mkdir9(join30(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 mkdir10 } from "fs/promises";
+import { join as join31 } from "path";
+function retroDir() {
+  return join31(homedir7(), ".ralph", "retro");
+}
+async function resolveRetroOutputPath(identifier, date5, dir = retroDir()) {
+  await mkdir10(dir, { recursive: true });
+  const base2 = join31(dir, `${identifier}-${date5}.md`);
+  if (!await Bun.file(base2).exists())
+    return base2;
+  for (let n = 2;; n++) {
+    const candidate = join31(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 join32 } 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 +108216,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: join32(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 = join32(projectLayout(cwd2).changeDir(changeName), MISSION_TASKS_FILENAME);
     const prevTasksPromise = (async () => {
       const f2 = Bun.file(missionTasksPath);
       return await f2.exists() ? await f2.text() : "";
@@ -107858,7 +108269,7 @@ function createSpawnWorker(input) {
     let logFilePath;
     let handle;
     if (injected) {
-      logFilePath = join29(logsDir, `${changeName}.log`);
+      logFilePath = join32(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 +108291,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 = join32(workerLayout.changeDir(changeName), "specs", "validate.md");
       const hasValidateSpec = await Bun.file(validateSpecPath).exists();
       const wantValidateOnly = hasValidateSpec && !wantPrBase;
       if (hasValidateSpec) {
@@ -107965,6 +108376,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 +108412,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,44 +108757,33 @@ 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";
-async function readStateJson(statePath) {
+import { dirname as dirname12, join as join33 } from "path";
+async function readInlineLinearComments(statePath) {
   const file2 = Bun.file(statePath);
   if (!await file2.exists())
-    return null;
+    return;
   try {
-    return await file2.json();
+    const obj = await file2.json();
+    return obj.linearComments ?? undefined;
   } catch {
-    return null;
-  }
-}
-async function writeStateJson(statePath, state) {
-  await mkdir11(dirname13(statePath), { recursive: true });
-  const tmp = `${statePath}.tmp-${process.pid}-${writeStateSeq++}`;
-  try {
-    await Bun.write(tmp, JSON.stringify(state, null, 2) + `
-`);
-    await rename(tmp, statePath);
-  } catch (err) {
-    await unlink2(tmp).catch(() => {});
-    throw err;
+    return;
   }
 }
-function readComments(state) {
-  const raw = state?.linearComments ?? {};
+async function readComments(statePath) {
+  const changeDir = dirname12(statePath);
+  const raw = await readSlotSidecar(changeDir, "linearComments") ?? await readInlineLinearComments(statePath) ?? {};
+  const r = raw;
   return {
-    planCommentId: raw?.planCommentId ?? null,
-    tasksCommentId: raw?.tasksCommentId ?? null,
-    planPostedAt: raw?.planPostedAt ?? null,
-    tasksCommentSha256: raw?.tasksCommentSha256 ?? null
+    planCommentId: r.planCommentId ?? null,
+    tasksCommentId: r.tasksCommentId ?? null,
+    planPostedAt: r.planPostedAt ?? null,
+    tasksCommentSha256: r.tasksCommentSha256 ?? null
   };
 }
 async function patchComments(statePath, patch) {
-  const existing = await readStateJson(statePath) ?? {};
-  const current = readComments(existing);
+  const current = await readComments(statePath);
   const next = { ...current, ...patch };
-  await writeStateJson(statePath, { ...existing, linearComments: next });
+  await writeSlotField(dirname12(statePath), "linearComments", next);
 }
 function isCommentNotFoundError(err) {
   if (!err)
@@ -108394,7 +108798,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(join33(changeDir, "tasks.md"));
   if (!await file2.exists()) {
     log3(`  comment-sync: tasks.md missing in ${changeDir}, skipping`, "gray");
     return null;
@@ -108415,8 +108819,7 @@ async function postOrUpdateTasksComment(deps) {
     return null;
   const body = renderTasksCommentBody(tasksMd, deps.changeName, deps.iteration);
   const hash2 = sha256Hex(tasksMd);
-  const state = await readStateJson(deps.statePath);
-  const comments = readComments(state);
+  const comments = await readComments(deps.statePath);
   if (comments.tasksCommentId) {
     if (comments.tasksCommentSha256 === hash2) {
       deps.log(`  comment-sync: tasks.md unchanged for ${deps.changeName}, skipping`, "gray");
@@ -108492,8 +108895,7 @@ async function readSection(path, heading) {
   return body.trim() || null;
 }
 async function postPlanCommentOnce(deps) {
-  const state = await readStateJson(deps.statePath);
-  const comments = readComments(state);
+  const comments = await readComments(deps.statePath);
   if (comments.planCommentId)
     return null;
   const tasksMd = await readTasksMd(deps.changeDir, deps.log);
@@ -108502,14 +108904,14 @@ async function postPlanCommentOnce(deps) {
   const check2 = parsePlanningSection(tasksMd);
   if (!check2.allChecked)
     return null;
-  const proposalPath = join30(deps.changeDir, "proposal.md");
+  const proposalPath = join33(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(join33(deps.changeDir, "design.md"));
   const parts = [`### ${PLAN_COMMENT_TITLE} \u2014 \`${deps.changeName}\``];
   if (why) {
     parts.push("", "**Why**", "", why);
@@ -108547,8 +108949,7 @@ ${deps.message.trim()}`;
   } catch (err) {
     deps.log(`! comment-sync: steering comment create failed: ${err.message}`, "yellow");
   }
-  const state = await readStateJson(deps.statePath);
-  const comments = readComments(state);
+  const comments = await readComments(deps.statePath);
   if (comments.tasksCommentId) {
     try {
       await deps.mutations.deleteIssueComment(deps.apiKey, comments.tasksCommentId);
@@ -108571,8 +108972,9 @@ ${deps.message.trim()}`;
     iteration: deps.iteration
   });
 }
-var PLAN_COMMENT_TITLE = "\uD83D\uDCCB Ralph plan", STEERING_COMMENT_TITLE = "\uD83E\uDDED Ralph steering", writeStateSeq = 0;
+var PLAN_COMMENT_TITLE = "\uD83D\uDCCB Ralph plan", STEERING_COMMENT_TITLE = "\uD83E\uDDED Ralph steering";
 var init_comment_sync = __esm(() => {
+  init_store();
   init_linear_sync();
 });
 
@@ -260785,7 +261187,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 dirname13, join as join34 } from "path";
 function describeLinearError(err) {
   const e = err;
   const parts = [e.message ?? String(err)];
@@ -260800,25 +261202,29 @@ function describeLinearError(err) {
   return parts.join(" ");
 }
 function stateDirOf(statePath) {
-  return dirname14(statePath);
+  return dirname13(statePath);
 }
-async function readRawState(statePath) {
+async function readInlineSpecAttachments(statePath) {
   const file2 = Bun.file(statePath);
   if (!await file2.exists())
     return {};
   try {
     const parsed = await file2.json();
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-      return parsed;
+      const sa = parsed.specAttachments;
+      return sa && typeof sa === "object" && !Array.isArray(sa) ? sa : {};
     }
     return {};
   } catch {
     return {};
   }
 }
+async function readSpecAttachmentsSubtree(statePath) {
+  const sidecar = await readSlotSidecar(dirname13(statePath), "specAttachments");
+  return sidecar ?? await readInlineSpecAttachments(statePath);
+}
 async function readSpecAttachments(statePath) {
-  const raw = await readRawState(statePath);
-  const sa = raw.specAttachments ?? {};
+  const sa = await readSpecAttachmentsSubtree(statePath);
   return {
     proposal: {
       attachmentId: sa.proposal?.attachmentId ?? null,
@@ -260872,12 +261278,25 @@ function hasMeaningfulContent(bytes) {
   }
   return false;
 }
+function extractImplementationSection(tasksMarkdown) {
+  const captured = [];
+  let capturing = false;
+  for (const line of tasksMarkdown.split(/\r?\n/)) {
+    const heading = /^##\s+(.+?)\s*$/.exec(line)?.[1];
+    if (heading !== undefined)
+      capturing = heading.trim().toLowerCase() === "implementation";
+    if (capturing)
+      captured.push(line);
+  }
+  return captured.join(`
+`).trim();
+}
 async function syncSlot(deps, slot) {
   const spec = SLOT_SPECS[slot];
   const [primaryName, ...trailingNames] = spec.sourceFiles;
   if (!primaryName)
     return;
-  const primary = Bun.file(join31(deps.changeDir, primaryName));
+  const primary = Bun.file(join34(deps.changeDir, primaryName));
   if (!await primary.exists()) {
     deps.log(`  spec-attachments: ${primaryName} missing, skipping`, "gray");
     return;
@@ -260896,24 +261315,28 @@ 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(join34(deps.changeDir, name));
     if (!await f2.exists())
       continue;
+    let raw;
     try {
-      const bytes = await f2.bytes();
-      if (bytes.length === 0)
-        continue;
-      parts.push(enc.encode(`
+      raw = await f2.bytes();
+    } catch (err) {
+      deps.log(`! spec-attachments: read ${name} failed (continuing without it): ${err.message}`, "yellow");
+      continue;
+    }
+    if (raw.length === 0)
+      continue;
+    const decoded = new TextDecoder().decode(raw);
+    const body = name === "tasks.md" ? extractImplementationSection(decoded) : decoded.trim();
+    if (!body)
+      continue;
+    parts.push(enc.encode(`
 
 ---
 
-# ${name}
-
+${body}
 `));
-      parts.push(bytes);
-    } catch (err) {
-      deps.log(`! spec-attachments: read ${name} failed (continuing without it): ${err.message}`, "yellow");
-    }
   }
   const totalLen = parts.reduce((n, p) => n + p.length, 0);
   const sourceBytes = new Uint8Array(totalLen);
@@ -260982,8 +261405,7 @@ async function syncSlot(deps, slot) {
   deps.log(`  spec-attachments: created ${spec.uploadFilename} attachment`, "gray");
 }
 async function purgeLegacyProposalSlots(deps) {
-  const raw = await readRawState(deps.statePath);
-  const sa = raw.specAttachments ?? {};
+  const sa = await readSpecAttachmentsSubtree(deps.statePath);
   if (sa.legacyProposalPurged === true)
     return;
   const state = await readSpecAttachments(deps.statePath);
@@ -261161,9 +261583,9 @@ var init_comment_sync2 = __esm(() => {
 });
 
 // apps/agent/src/features/pr-tracker/state.ts
-import { join as join32 } from "path";
+import { join as join35 } from "path";
 async function readState2(projectRoot) {
-  const path = join32(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join35(projectRoot, PR_TRACKER_STATE_RELPATH);
   const file2 = Bun.file(path);
   if (!await file2.exists())
     return {};
@@ -261179,7 +261601,7 @@ async function readState2(projectRoot) {
   }
 }
 async function writeState2(projectRoot, state) {
-  const path = join32(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join35(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 +261680,7 @@ var init_pr_tracker = __esm(() => {
 });
 
 // apps/agent/src/agent/wire.ts
-import { join as join33 } from "path";
+import { join as join36 } from "path";
 function buildAgentCoordinator(input) {
   const {
     args,
@@ -261277,7 +261699,7 @@ function buildAgentCoordinator(input) {
     onWorkerCmd,
     onAwaitingTicket
   } = input;
-  const logsDir = join33(projectRoot, ".ralph", "logs");
+  const logsDir = join36(projectRoot, ".ralph", "logs");
   const bus = createBus();
   subscribeAgentDiag(bus, onLog);
   const diag = (area, message, color) => {
@@ -261412,6 +261834,13 @@ function buildAgentCoordinator(input) {
     ...onWorkerOutput ? { onWorkerOutput } : {},
     ...onWorkerCmd ? { onWorkerCmd } : {}
   });
+  const openDraftPr = createOpenDraftPr({
+    branchByChange,
+    prByChange,
+    cmdRunner,
+    prBaseBranch: cfg.prBaseBranch,
+    invalidatePrUrlForIssue: (issueId) => prDiscovery.invalidatePrUrlForIssue(issueId)
+  });
   const confirmationCaps = {
     detect: (issue2) => processAwaitingForIssue(issue2, {
       cfg,
@@ -261424,6 +261853,7 @@ function buildAgentCoordinator(input) {
       reapForAwaiting: (cn) => coordRef.current?.reapForAwaiting(cn),
       applyIndicator: resolvers.applyIndicator,
       applyMarker: resolvers.applyMarker,
+      openDraftPr,
       ...onAwaitingTicket ? { onAwaitingTicket } : {},
       onLog
     }),
@@ -261493,6 +261923,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(join36(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 +261973,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(join36(projectLayout(root).taskStateDir(changeName), GAVEUP_COUNT_FILE));
         if (!await file2.exists())
           continue;
         try {
@@ -261566,14 +262008,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 { dirname as dirname15 } from "path";
+import { mkdir as mkdir11, appendFile as appendFile2 } from "fs/promises";
+import { dirname as dirname14 } from "path";
 function createJsonLogFileSink(path) {
   if (!path)
     return { emit: () => {} };
   let chain = (async () => {
     try {
-      await mkdir12(dirname15(path), { recursive: true });
+      await mkdir11(dirname14(path), { recursive: true });
       await Bun.write(path, "");
     } catch {}
   })();
@@ -261819,7 +262261,7 @@ var init_output_utils = __esm(() => {
 });
 
 // apps/agent/src/agent/state/worker-state-poll.ts
-import { join as join34 } from "path";
+import { join as join37 } from "path";
 function parseSubtasks(tasksMd) {
   const out = [];
   let skipSection = false;
@@ -261852,7 +262294,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(join37(input.statesDir, input.changeName, ".ralph-state.json"));
     if (await file2.exists()) {
       const json2 = await file2.json();
       next.iter = json2.iteration ?? next.iter;
@@ -261861,10 +262303,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(join37(input.changeDir, "tasks.md"));
+      const proposalFile = Bun.file(join37(input.changeDir, "proposal.md"));
+      const designFile = Bun.file(join37(input.changeDir, "design.md"));
+      const reviewFindingsFile = Bun.file(join37(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 +262369,7 @@ var init_worker_state_poll = __esm(() => {
 });
 
 // apps/agent/src/components/AgentMode.tsx
-import { join as join35 } from "path";
+import { join as join38 } from "path";
 async function appendSteeringImpl(changeDir, message) {
   await runWithContext(createDefaultContext(), async () => {
     appendSteeringMessage(changeDir, message);
@@ -263500,7 +263942,7 @@ function AgentMode({
                     },
                     onSubmit: async (message) => {
                       try {
-                        await appendSteering2(join35(tasksDir, w2.changeName), message);
+                        await appendSteering2(join38(tasksDir, w2.changeName), message);
                         fileEmit({ type: "steering_submitted", changeName: w2.changeName, message });
                       } catch (err) {
                         const text = err.message;
@@ -263614,7 +264056,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 +264065,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 +264246,7 @@ __export(exports_list, {
   buildBuckets: () => buildBuckets,
   backlogRankByIssueId: () => backlogRankByIssueId
 });
-import { join as join36 } from "path";
+import { join as join39 } from "path";
 function countTaskItems(content) {
   const checked = (content.match(/^- \[x\]/gm) ?? []).length;
   const unchecked = (content.match(/^- \[ \]/gm) ?? []).length;
@@ -263820,13 +264262,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: join39(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(join39(dir, entry, ".ralph-state.json"));
       if (raw === null)
         continue;
       let state;
@@ -263841,7 +264283,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(join39(dir, entry, "tasks.md"));
       if (tasksContent !== null) {
         const { checked, unchecked } = countTaskItems(tasksContent);
         const total = checked + unchecked;
@@ -264336,31 +264778,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 join40 } from "path";
+import { mkdir as mkdir12 } from "fs/promises";
+import { homedir as homedir8 } from "os";
 function makeEmit(fileSink) {
   return (event) => {
     const payload = { ts: Date.now(), ...event };
@@ -264380,7 +264805,7 @@ async function runAgentJson({
   tasksDir,
   runPreflight: runPreflight2 = runPreflight
 }) {
-  await mkdir14(join38(homedir7(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir12(join40(homedir8(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const fileSink = createJsonLogFileSink(args.jsonLogFile);
@@ -264596,8 +265021,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 mkdir13 } from "fs/promises";
+import { join as join41 } from "path";
 async function main3(argv) {
   if (argv.includes("--help") || argv.includes("-h")) {
     printAgentHelp();
@@ -264661,9 +265086,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 mkdir13(statesDir, { recursive: true });
+  await mkdir13(tasksDir, { recursive: true });
+  await mkdir13(join41(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.
 `);