@neriros/ralphy 3.10.6 → 3.10.8

package/dist/shell/index.js

@@ -18928,8 +18928,8 @@ import { readFileSync } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("3.10.6")
-      return "3.10.6";
+    if ("3.10.8")
+      return "3.10.8";
   } catch {}
   const dirsToTry = [];
   try {
@@ -80519,7 +80519,7 @@ function foldLegacyAssignee(v) {
   }
   return rest2;
 }
-var CURRENT_WORKFLOW_VERSION = 3, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
+var CURRENT_WORKFLOW_VERSION = 4, MarkerSchema, SET_INDICATOR_KEYS, GetIndicatorSchema, SetIndicatorSchema, IndicatorsSchema, ProjectSchema, CommandsSchema, DEFAULT_META_ONLY_FILES, BoundariesSchema, WorkflowConfigSchema;
 var init_schema = __esm(() => {
   init_zod();
   MarkerSchema = exports_external.discriminatedUnion("type", [
@@ -80533,7 +80533,13 @@ var init_schema = __esm(() => {
     exports_external.object({ type: exports_external.literal("project"), value: exports_external.string().min(1) }).strict(),
     exports_external.object({ type: exports_external.literal("comment"), value: exports_external.string().min(1) }).strict()
   ]);
-  SET_INDICATOR_KEYS = ["setInProgress", "setDone", "setError", "clearApproved"];
+  SET_INDICATOR_KEYS = [
+    "setInProgress",
+    "setDone",
+    "setPrReady",
+    "setError",
+    "clearApproved"
+  ];
   GetIndicatorSchema = exports_external.object({
     filter: exports_external.array(MarkerSchema).default([])
   });
@@ -80547,6 +80553,7 @@ var init_schema = __esm(() => {
     getAutoApprove: GetIndicatorSchema.optional(),
     setInProgress: SetIndicatorSchema.optional(),
     setDone: SetIndicatorSchema.optional(),
+    setPrReady: SetIndicatorSchema.optional(),
     setError: SetIndicatorSchema.optional(),
     setAwaitingConfirmation: SetIndicatorSchema.optional(),
     clearApproved: SetIndicatorSchema.optional(),
@@ -80851,6 +80858,9 @@ linear:
     # setDone:           # status/label to set when the PR is opened
     #   type: status
     #   value: In Review
+    # setPrReady:        # additive: marker set when the PR is ready for human review
+    #   type: status     # (fires unless the PR is auto-merged immediately; does not replace setDone)
+    #   value: In Review
     # setError:          # label applied when a task is quarantined
     #   type: label
     #   value: "ralph:error"
@@ -81072,7 +81082,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 +81446,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 +82926,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) {
@@ -83931,6 +83963,12 @@ var init_SetupWizard = __esm(async () => {
       description: "Set when the task finishes and its pull request is opened.",
       slots: ["setDone"]
     },
+    {
+      key: "prReady",
+      label: "PR ready",
+      description: "Optional, additive: set when the PR is marked ready for human review (non-draft), layered on top of Done. Skipped only on the immediate non-draft auto-merge path.",
+      slots: ["setPrReady"]
+    },
     {
       key: "error",
       label: "Error",
@@ -84019,6 +84057,11 @@ var init_migrations = __esm(() => {
       version: 3,
       description: "The per-workflow `linear.assignee` setting is replaced by a global " + "`linear.filter` expression (e.g. `assignee = me`) applied to every " + "ticket fetch. Existing `assignee` values are folded in automatically; " + "note that an empty filter now defaults to `assignee = me` (it previously " + "meant unassigned-only).",
       fields: ["linear.filter"]
+    },
+    {
+      version: 4,
+      description: "A new additive `setPrReady` Linear indicator marks a ticket the moment its " + "PR is human-mergeable (ready, non-draft), layered on top of `setDone`. " + "Re-run the indicator builder to add it, or keep your current indicators.",
+      fields: ["linear.indicators"]
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max2, migration) => Math.max(max2, migration.version), 0);
@@ -85044,6 +85087,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 +89273,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 +89301,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 +89347,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 +89361,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 +89381,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 +89390,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 +89413,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 +98137,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 +98159,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 +98186,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 +99225,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 +99689,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 +99712,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 +99789,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 +99863,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 +99961,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 +100026,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 +100086,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 +100136,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 +100198,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 +100208,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 +100252,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 +100290,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 +100319,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 +100393,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 +100414,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 +100437,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 +100744,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 +100797,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 +100851,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 +100900,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 +101019,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 +101044,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 +101149,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 +101163,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;
@@ -101190,6 +101310,8 @@ async function runDebug(opts) {
     out("  \u26A0 setError applied \u2014 issue is quarantined in Linear");
   if (logHas("setDone applied"))
     out("  \u2713 setDone applied \u2014 issue marked done in Linear");
+  if (logHas("setPrReady applied"))
+    out("  \u2713 setPrReady applied \u2014 PR is ready for human review");
   if (logHas("clearConflicted applied"))
     out("  \u2713 clearConflicted applied");
   if (logHas("setConflicted applied"))
@@ -101200,8 +101322,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 +101343,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 +101415,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 +101468,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 +101497,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, {
@@ -101639,6 +101761,7 @@ var init_cli2 = __esm(() => {
     "getAutoMerge",
     "setInProgress",
     "setDone",
+    "setPrReady",
     "setError"
   ]);
   GET_KEYS = new Set(["getTodo", "getInProgress", "getAutoMerge"]);
@@ -101677,9 +101800,10 @@ var init_cli2 = __esm(() => {
     "  --worktree              Run each task in its own git worktree",
     "  --indicator <k>:<t>:<v> Override an indicator (repeatable).",
     "                          Keys: getTodo, getInProgress, getAutoMerge,",
-    "                                setInProgress, setDone, setError",
+    "                                setInProgress, setDone, setPrReady, setError",
     "                          Types: label, status, attachment, project, comment",
     "                          --indicator setInProgress:attachment:In Progress",
+    "                          --indicator setPrReady:status:In Review (additive ready marker)",
     "                          (attachment upserts a single 'Ralphy' entry; value = subtitle)",
     "  --create-pr             Push the worker branch and open a GitHub PR on success (needs --worktree)",
     "  --fix-ci                After opening the PR, re-run on CI failures until green (needs --create-pr)",
@@ -101773,7 +101897,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(() => {
@@ -101786,11 +101910,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 = {
@@ -101808,7 +101932,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}
@@ -101823,11 +101947,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}`;
@@ -101846,7 +101970,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}
@@ -101871,7 +101995,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;
@@ -101917,8 +102041,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;
@@ -101932,7 +102056,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);
       }
     }
   }
@@ -103782,7 +103906,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);
@@ -103854,7 +103978,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
     });
@@ -104149,6 +104273,7 @@ async function runPrPhase(input, deps) {
     emit: emit3,
     respawnWorker,
     registerPr,
+    onPrReady,
     checkPrConflict,
     resolveDependencyBaseBranch
   } = deps;
@@ -104343,6 +104468,9 @@ ${indented}${suffix}`, "yellow");
       log3(`! manual merge failed for ${prUrl}: ${e.stderr?.trim() || e.message}`, "yellow");
     }
   }
+  if (!(wantAutoMerge && !prReadyNeeded)) {
+    await onPrReady?.(prUrl);
+  }
   return 0;
 }
 async function runWorktreeCleanupPhase(input, deps) {
@@ -104401,7 +104529,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;
@@ -104412,7 +104540,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(`
@@ -104425,7 +104553,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;
@@ -104548,6 +104676,7 @@ async function runPostTask(input, deps) {
       emit: emit3,
       respawnWorker,
       ...deps.registerPr !== undefined ? { registerPr: deps.registerPr } : {},
+      ...deps.onPrReady !== undefined ? { onPrReady: deps.onPrReady } : {},
       ...deps.checkPrConflict !== undefined ? { checkPrConflict: deps.checkPrConflict } : {},
       ...deps.resolveDependencyBaseBranch !== undefined ? { resolveDependencyBaseBranch: deps.resolveDependencyBaseBranch } : {}
     });
@@ -105831,15 +105960,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",
@@ -105892,8 +106021,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(`
@@ -105975,19 +106104,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,
@@ -105995,14 +106127,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 = [
@@ -106012,8 +106143,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
 
@@ -106025,6 +106156,7 @@ async function appendSteeringNote(changeDir, message) {
   await runCapability(fsChange.appendSteering, { changeDir, message });
 }
 var init_state2 = __esm(() => {
+  init_store();
   init_fs_change();
 });
 
@@ -106242,8 +106374,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)
@@ -106251,12 +106382,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;
@@ -106276,17 +106407,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;
@@ -106297,16 +106419,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");
   }
@@ -106330,10 +106444,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);
@@ -106341,6 +106487,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);
@@ -106369,9 +106522,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)
@@ -106455,6 +106608,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,
@@ -106529,6 +106683,7 @@ var init_awaiting = __esm(() => {
   init_worktree();
   init_scaffold();
   init_linear();
+  init_types2();
   init_workflow();
   init_state2();
   init_inspect();
@@ -106603,9 +106758,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/;
@@ -106895,8 +107067,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,
@@ -106960,7 +107132,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) {
@@ -106999,8 +107171,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);
@@ -107038,7 +107210,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;
@@ -107331,21 +107503,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 {
@@ -107557,7 +107732,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,
@@ -107723,7 +107898,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);
@@ -107747,9 +107922,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+/;
@@ -107810,16 +107985,16 @@ var init_default2 = __esm(() => {
 });
 
 // apps/agent/src/agent/state/agent-run-state.ts
-import { basename as basename3, join as join29 } from "path";
+import { basename as basename3, join as join30 } from "path";
 import { homedir as homedir6 } from "os";
-import { mkdir as mkdir11, writeFile } from "fs/promises";
+import { mkdir as mkdir9, writeFile } from "fs/promises";
 function agentRunStatePath(projectRoot) {
-  return join29(homedir6(), ".ralph", basename3(projectRoot), "agent-state.json");
+  return join30(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 mkdir9(join30(homedir6(), ".ralph", basename3(state.projectRoot)), { recursive: true });
     await writeFile(path, JSON.stringify(state, null, 2) + `
 `, "utf-8");
   } catch {}
@@ -107845,18 +108020,18 @@ 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";
+import { mkdir as mkdir10 } from "fs/promises";
+import { join as join31 } from "path";
 function retroDir() {
-  return join30(homedir7(), ".ralph", "retro");
+  return join31(homedir7(), ".ralph", "retro");
 }
 async function resolveRetroOutputPath(identifier, date5, dir = retroDir()) {
-  await mkdir12(dir, { recursive: true });
-  const base2 = join30(dir, `${identifier}-${date5}.md`);
+  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 = join30(dir, `${identifier}-${date5}-${n}.md`);
+    const candidate = join31(dir, `${identifier}-${date5}-${n}.md`);
     if (!await Bun.file(candidate).exists())
       return candidate;
   }
@@ -107970,7 +108145,7 @@ var init_retro = __esm(() => {
 });
 
 // apps/agent/src/agent/wire/spawn/worker.ts
-import { join as join31 } from "path";
+import { join as join32 } from "path";
 function localDateStamp(d) {
   const y = d.getFullYear();
   const m = String(d.getMonth() + 1).padStart(2, "0");
@@ -108005,6 +108180,8 @@ function createSpawnWorker(input) {
     indicators,
     cmdRunner,
     gitRunner,
+    applyIndicator,
+    bus,
     onLog,
     diag,
     runners,
@@ -108099,7 +108276,7 @@ function createSpawnWorker(input) {
         paths: {
           changeDir: info.changeDir,
           stateFilePath: info.stateFilePath,
-          logFile: join31(logsDir, `${info.changeName}.log`),
+          logFile: join32(logsDir, `${info.changeName}.log`),
           jsonLogFile: args.jsonLogFile ?? null,
           agentStateFile: agentRunStatePath(projectRoot)
         }
@@ -108116,7 +108293,7 @@ function createSpawnWorker(input) {
   return function spawnWorker(changeName, _issue, trigger) {
     const cwd2 = cwdByChange.get(changeName) ?? projectRoot;
     const injected = runners?.spawnWorker;
-    const missionTasksPath = join31(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() : "";
@@ -108124,7 +108301,7 @@ function createSpawnWorker(input) {
     let logFilePath;
     let handle;
     if (injected) {
-      logFilePath = join31(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()}`);
@@ -108146,7 +108323,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 = join31(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) {
@@ -108233,6 +108410,23 @@ function createSpawnWorker(input) {
         runScript,
         ...retroDepEntry(args.agentDebug, runRetrospectiveHook),
         registerPr: (cn, url2) => onPrRegistered(cn, url2),
+        ...issueForChange && indicators.setPrReady ? {
+          onPrReady: async () => {
+            const issue2 = issueForChange;
+            const marker = indicators.setPrReady;
+            try {
+              await applyIndicator(issue2, marker);
+              onLog(`  ${issue2.identifier}: setPrReady applied`, "gray");
+            } catch (err) {
+              onLog(`! Linear setPrReady failed for ${issue2.identifier}: ${err.message}`, "yellow");
+              emitCapture(bus, "agent_indicator_failed", {
+                indicator: "setPrReady",
+                issue_identifier: issue2.identifier,
+                error: err.message
+              });
+            }
+          }
+        } : {},
         ...onWorkerPhase && {
           onPhase: (phase2, detail) => onWorkerPhase(changeName, phase2, detail)
         },
@@ -108270,6 +108464,7 @@ var init_worker = __esm(() => {
   init_agent_run_state();
   init_retro();
   init_engine();
+  init_coordinator();
 });
 
 // apps/agent/src/agent/baseline/runner.ts
@@ -108612,44 +108807,33 @@ var init_linear_sync = __esm(() => {
 });
 
 // apps/agent/src/agent/linear-sync/comment-sync.ts
-import { dirname as dirname13, join as join32 } from "path";
-import { mkdir as mkdir13, 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 mkdir13(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)
@@ -108664,7 +108848,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(join32(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;
@@ -108685,8 +108869,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");
@@ -108762,8 +108945,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);
@@ -108772,14 +108954,14 @@ async function postPlanCommentOnce(deps) {
   const check2 = parsePlanningSection(tasksMd);
   if (!check2.allChecked)
     return null;
-  const proposalPath = join32(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(join32(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);
@@ -108817,8 +108999,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);
@@ -108841,8 +109022,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();
 });
 
@@ -261055,7 +261237,7 @@ var init_render_pdf = __esm(() => {
 });
 
 // apps/agent/src/agent/linear-sync/spec-attachments.ts
-import { dirname as dirname14, join as join33 } from "path";
+import { dirname as dirname13, join as join34 } from "path";
 function describeLinearError(err) {
   const e = err;
   const parts = [e.message ?? String(err)];
@@ -261070,25 +261252,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,
@@ -261142,12 +261328,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(join33(deps.changeDir, primaryName));
+  const primary = Bun.file(join34(deps.changeDir, primaryName));
   if (!await primary.exists()) {
     deps.log(`  spec-attachments: ${primaryName} missing, skipping`, "gray");
     return;
@@ -261166,24 +261365,28 @@ async function syncSlot(deps, slot) {
   const parts = [primaryBytes];
   const enc = new TextEncoder;
   for (const name of trailingNames) {
-    const f2 = Bun.file(join33(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);
@@ -261252,8 +261455,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);
@@ -261431,9 +261633,9 @@ var init_comment_sync2 = __esm(() => {
 });
 
 // apps/agent/src/features/pr-tracker/state.ts
-import { join as join34 } from "path";
+import { join as join35 } from "path";
 async function readState2(projectRoot) {
-  const path = join34(projectRoot, PR_TRACKER_STATE_RELPATH);
+  const path = join35(projectRoot, PR_TRACKER_STATE_RELPATH);
   const file2 = Bun.file(path);
   if (!await file2.exists())
     return {};
@@ -261449,7 +261651,7 @@ async function readState2(projectRoot) {
   }
 }
 async function writeState2(projectRoot, state) {
-  const path = join34(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";
@@ -261528,7 +261730,7 @@ var init_pr_tracker = __esm(() => {
 });
 
 // apps/agent/src/agent/wire.ts
-import { join as join35 } from "path";
+import { join as join36 } from "path";
 function buildAgentCoordinator(input) {
   const {
     args,
@@ -261547,7 +261749,7 @@ function buildAgentCoordinator(input) {
     onWorkerCmd,
     onAwaitingTicket
   } = input;
-  const logsDir = join35(projectRoot, ".ralph", "logs");
+  const logsDir = join36(projectRoot, ".ralph", "logs");
   const bus = createBus();
   subscribeAgentDiag(bus, onLog);
   const diag = (area, message, color) => {
@@ -261657,6 +261859,8 @@ function buildAgentCoordinator(input) {
     indicators,
     cmdRunner,
     gitRunner,
+    applyIndicator: resolvers.applyIndicator,
+    bus,
     onLog,
     diag,
     runners: input.runners,
@@ -261682,6 +261886,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,
@@ -261694,6 +261905,7 @@ function buildAgentCoordinator(input) {
       reapForAwaiting: (cn) => coordRef.current?.reapForAwaiting(cn),
       applyIndicator: resolvers.applyIndicator,
       applyMarker: resolvers.applyMarker,
+      openDraftPr,
       ...onAwaitingTicket ? { onAwaitingTicket } : {},
       onLog
     }),
@@ -261768,7 +261980,7 @@ function buildAgentCoordinator(input) {
       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));
+        const file2 = Bun.file(join36(changeDir, name));
         if (!await file2.exists())
           continue;
         parts.push(`${name}:${file2.lastModified}:${file2.size}`);
@@ -261813,7 +262025,7 @@ function buildAgentCoordinator(input) {
     getGaveUpTotal: async () => {
       let total = 0;
       for (const [changeName, root] of cwdByChange) {
-        const file2 = Bun.file(join35(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 {
@@ -261848,14 +262060,14 @@ var init_wire = __esm(() => {
 });
 
 // apps/agent/src/agent/json-log/json-log-file.ts
-import { mkdir as mkdir14, 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 mkdir14(dirname15(path), { recursive: true });
+      await mkdir11(dirname14(path), { recursive: true });
       await Bun.write(path, "");
     } catch {}
   })();
@@ -262101,7 +262313,7 @@ var init_output_utils = __esm(() => {
 });
 
 // apps/agent/src/agent/state/worker-state-poll.ts
-import { join as join36 } from "path";
+import { join as join37 } from "path";
 function parseSubtasks(tasksMd) {
   const out = [];
   let skipSection = false;
@@ -262134,7 +262346,7 @@ function initialWorkerSnapshot() {
 async function readWorkerSnapshot(input) {
   const next = { ...input.prev };
   try {
-    const file2 = Bun.file(join36(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;
@@ -262143,10 +262355,10 @@ async function readWorkerSnapshot(input) {
   } catch {}
   if (input.changeDir) {
     try {
-      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 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),
@@ -262209,7 +262421,7 @@ var init_worker_state_poll = __esm(() => {
 });
 
 // apps/agent/src/components/AgentMode.tsx
-import { join as join37 } from "path";
+import { join as join38 } from "path";
 async function appendSteeringImpl(changeDir, message) {
   await runWithContext(createDefaultContext(), async () => {
     appendSteeringMessage(changeDir, message);
@@ -263782,7 +263994,7 @@ function AgentMode({
                     },
                     onSubmit: async (message) => {
                       try {
-                        await appendSteering2(join37(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;
@@ -264086,7 +264298,7 @@ __export(exports_list, {
   buildBuckets: () => buildBuckets,
   backlogRankByIssueId: () => backlogRankByIssueId
 });
-import { join as join38 } from "path";
+import { join as join39 } from "path";
 function countTaskItems(content) {
   const checked = (content.match(/^- \[x\]/gm) ?? []).length;
   const unchecked = (content.match(/^- \[ \]/gm) ?? []).length;
@@ -264102,13 +264314,13 @@ function buildLocalRows() {
   const sources = [{ dir: statesDir, label: "main" }];
   const worktreesRoot = worktreesDir2(projectRoot);
   for (const wt of storage.list(worktreesRoot)) {
-    sources.push({ dir: join38(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(join38(dir, entry, ".ralph-state.json"));
+      const raw = storage.read(join39(dir, entry, ".ralph-state.json"));
       if (raw === null)
         continue;
       let state;
@@ -264123,7 +264335,7 @@ function buildLocalRows() {
       const firstLine = promptRaw.split(`
 `).find((l3) => l3.trim() !== "") ?? "";
       let progress = "\u2014";
-      const tasksContent = storage.read(join38(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;
@@ -264623,8 +264835,8 @@ var exports_json_runner = {};
 __export(exports_json_runner, {
   runAgentJson: () => runAgentJson
 });
-import { join as join39 } from "path";
-import { mkdir as mkdir15 } from "fs/promises";
+import { join as join40 } from "path";
+import { mkdir as mkdir12 } from "fs/promises";
 import { homedir as homedir8 } from "os";
 function makeEmit(fileSink) {
   return (event) => {
@@ -264645,7 +264857,7 @@ async function runAgentJson({
   tasksDir,
   runPreflight: runPreflight2 = runPreflight
 }) {
-  await mkdir15(join39(homedir8(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir12(join40(homedir8(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const fileSink = createJsonLogFileSink(args.jsonLogFile);
@@ -264861,8 +265073,8 @@ var exports_src3 = {};
 __export(exports_src3, {
   main: () => main3
 });
-import { mkdir as mkdir16 } from "fs/promises";
-import { join as join40 } 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();
@@ -264926,9 +265138,9 @@ async function main3(argv) {
       return 1;
     }
   }
-  await mkdir16(statesDir, { recursive: true });
-  await mkdir16(tasksDir, { recursive: true });
-  await mkdir16(join40(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.
 `);