opencode-ralph-rlm 0.1.10 → 0.1.12

package/dist/ralph-rlm.js

@@ -23522,7 +23522,22 @@ var DEFAULT_TEMPLATES = {
     "- The supervisor owns the lifecycle only. It never edits files or runs rlm_grep/rlm_slice.",
     "- All implementation happens in RLM worker sessions spawned per attempt.",
     "- Strategy changes must be written to PLAN.md / RLM_INSTRUCTIONS.md so each new worker sees them.",
-    "- Stop the loop explicitly with ralph_end_supervision() when the user is done or verification passed."
+    "- Stop the loop explicitly with ralph_end_supervision() when the user is done or verification passed.",
+    "",
+    "Onboarding checklist (supervisor):",
+    "- If setup is incomplete, run ralph_doctor(autofix=true).",
+    "- If PLAN.md is missing or weak, run ralph_quickstart_wizard(...) or ralph_bootstrap_plan(...) + ralph_validate_plan().",
+    "- Start supervision with ralph_create_supervisor_session(start_loop=true) unless autoStartOnMainIdle is enabled.",
+    "- Use ralph_supervision_status() to confirm current attempt and active sessions.",
+    "",
+    "Protocol files (purpose):",
+    "- PLAN.md: goals, milestones, definition of done (authoritative).",
+    "- RLM_INSTRUCTIONS.md: inner loop operating manual (authoritative, updated between attempts).",
+    "- CURRENT_STATE.md: scratch for the current attempt only.",
+    "- PREVIOUS_STATE.md: snapshot of last attempt's scratch.",
+    "- NOTES_AND_LEARNINGS.md: durable learnings across attempts.",
+    "- CONVERSATION.md / SUPERVISOR_LOG.md: status feed and timeline for the supervisor.",
+    "- CONTEXT_FOR_RLM.md: large reference; workers must use rlm_grep/rlm_slice."
   ].join(`
 `),
   systemPromptAppend: "",
@@ -23536,7 +23551,12 @@ var DEFAULT_TEMPLATES = {
     "- NOTES_AND_LEARNINGS.md          \u2014 append-only durable learnings",
     "- CONVERSATION.md                 \u2014 append-only supervisor-visible status feed",
     "- CONTEXT_FOR_RLM.md              \u2014 large reference; access via rlm_grep + rlm_slice",
-    "- .opencode/agents/<name>/        \u2014 sub-agent state directories"
+    "- .opencode/agents/<name>/        \u2014 sub-agent state directories",
+    "",
+    "## Loop control",
+    "- ralph_create_supervisor_session(start_loop=true) to start",
+    "- ralph_pause_supervision() / ralph_resume_supervision() to pause/resume",
+    "- ralph_end_supervision() to stop and clean up"
   ].join(`
 `),
   continuePrompt: [
@@ -24238,6 +24258,27 @@ var RalphRLM = async ({ client, $, worktree }) => {
       }).catch(() => {});
     }
   };
+  const sendPromptWithFallback = async (sessionId, text, label, originSessionId) => {
+    try {
+      await client.session.promptAsync({
+        path: { id: sessionId },
+        body: { parts: [{ type: "text", text }] }
+      });
+      return true;
+    } catch (err) {
+      await notifySupervisor("supervisor", `${label} promptAsync failed: ${err instanceof Error ? err.message : String(err)}`, "warning", true, originSessionId);
+    }
+    try {
+      await client.session.prompt({
+        path: { id: sessionId },
+        body: { parts: [{ type: "text", text }] }
+      });
+      return true;
+    } catch (err) {
+      await notifySupervisor("supervisor", `${label} prompt fallback failed: ${err instanceof Error ? err.message : String(err)}`, "error", true, originSessionId);
+      return false;
+    }
+  };
   const detectProjectDefaults = (root) => exports_Effect.gen(function* () {
     const j = (f) => NodePath.join(root, f);
     const hasBunLock = (yield* fileExists(j("bun.lockb"))) || (yield* fileExists(j("bun.lock")));
@@ -25134,6 +25175,10 @@ No pending questions found.`));
       supervisor.activeReviewerSessionId = undefined;
       supervisor.activeReviewerOutputPath = undefined;
       await persistReviewerState();
+      if (supervisor.ralphHandoffTimer) {
+        clearTimeout(supervisor.ralphHandoffTimer);
+        supervisor.ralphHandoffTimer = undefined;
+      }
       if (args2.clear_binding === true) {
         supervisor.sessionId = undefined;
       }
@@ -25575,7 +25620,8 @@ Set a new goal and run again.
     const st = sessionMap.get(sessionId);
     sessionMap.delete(sessionId);
     let didUpdate = false;
-    if (supervisor.currentRalphSessionId === sessionId) {
+    const clearedRalph = supervisor.currentRalphSessionId === sessionId;
+    if (clearedRalph) {
       supervisor.currentRalphSessionId = undefined;
       didUpdate = true;
     }
@@ -25591,6 +25637,10 @@ Set a new goal and run again.
       didUpdate = true;
       await persistReviewerState();
     }
+    if (supervisor.ralphHandoffTimer && clearedRalph) {
+      clearTimeout(supervisor.ralphHandoffTimer);
+      supervisor.ralphHandoffTimer = undefined;
+    }
     if (didUpdate && st) {
       await notifySupervisor(`${st.role}/attempt-${st.attempt}`, `${st.role} session ended (${reason}).`, "info", true, sessionId);
     }
@@ -25651,10 +25701,18 @@ ${interpolate(templates.continuePrompt, { attempt: String(attemptN), verdict })}
       attempt: String(attempt),
       nextAttempt: String(attempt + 1)
     });
-    await client.session.promptAsync({
-      path: { id: workerId },
-      body: { parts: [{ type: "text", text: promptText }] }
-    }).catch(() => {});
+    const promptOk = await sendPromptWithFallback(workerId, promptText, `Worker prompt (attempt ${attempt})`, workerId);
+    if (!promptOk) {
+      mutateSession(workerId, (s) => {
+        s.reportedStatus = "error";
+        s.reportedStatusNote = "Worker prompt failed";
+      });
+      supervisor.currentWorkerSessionId = undefined;
+      await client.session.abort({ path: { id: workerId } }).catch(() => {});
+      await notifySupervisor(`worker/attempt-${attempt}`, "Worker prompt failed; supervision paused. Retry with ralph_create_supervisor_session(restart_if_done=true).", "error", true);
+      supervisor.paused = true;
+      throw new Error("Worker prompt failed");
+    }
     await notifySupervisor(`supervisor/attempt-${attempt}`, `Spawned worker session ${workerId}.`, "info", true);
     return workerId;
   };
@@ -25667,10 +25725,14 @@ ${interpolate(templates.continuePrompt, { attempt: String(attemptN), verdict })}
     if (st.workerSpawned) {
       throw new Error("ralph_spawn_worker() has already been called for this attempt.");
     }
+    if (supervisor.ralphHandoffTimer) {
+      clearTimeout(supervisor.ralphHandoffTimer);
+      supervisor.ralphHandoffTimer = undefined;
+    }
+    const workerId = await spawnRlmWorker(st.attempt);
     mutateSession(sessionID, (s) => {
       s.workerSpawned = true;
     });
-    const workerId = await spawnRlmWorker(st.attempt);
     await notifySupervisor(`ralph/attempt-${st.attempt}`, `Delegated coding to worker session ${workerId}.`, "info", true, sessionID);
     return JSON.stringify({ ok: true, workerSessionId: workerId, attempt: st.attempt }, null, 2);
   };
@@ -25688,10 +25750,29 @@ ${interpolate(templates.continuePrompt, { attempt: String(attemptN), verdict })}
       attempt: String(attempt),
       nextAttempt: String(attempt + 1)
     });
-    await client.session.promptAsync({
-      path: { id: ralphId },
-      body: { parts: [{ type: "text", text: promptText }] }
-    }).catch(() => {});
+    const promptOk = await sendPromptWithFallback(ralphId, promptText, `Strategist prompt (attempt ${attempt})`, ralphId);
+    if (!promptOk) {
+      supervisor.currentRalphSessionId = undefined;
+      await client.session.abort({ path: { id: ralphId } }).catch(() => {});
+      await notifySupervisor(`supervisor/attempt-${attempt}`, "Strategist prompt failed; supervision paused. Retry with ralph_create_supervisor_session(restart_if_done=true).", "error", true);
+      supervisor.paused = true;
+      return;
+    }
+    if (supervisor.ralphHandoffTimer) {
+      clearTimeout(supervisor.ralphHandoffTimer);
+    }
+    const cfg = await run(getConfig());
+    const timeoutMs = Math.max(cfg.heartbeatMinutes, 1) * 60000;
+    supervisor.ralphHandoffTimer = setTimeout(async () => {
+      if (supervisor.done || supervisor.paused)
+        return;
+      if (supervisor.currentRalphSessionId !== ralphId)
+        return;
+      const st = sessionMap.get(ralphId);
+      if (st?.workerSpawned)
+        return;
+      await notifySupervisor(`ralph/attempt-${attempt}`, "Strategist did not hand off to a worker within the heartbeat window. Re-check prompt delivery or restart supervision.", "warning", true, ralphId);
+    }, timeoutMs);
     await notifySupervisor(`supervisor/attempt-${attempt}`, `Spawned Ralph strategist session ${ralphId}.`, "info", true);
   };
   const handleWorkerIdle = async (workerSessionId) => {
@@ -25702,8 +25783,6 @@ ${interpolate(templates.continuePrompt, { attempt: String(attemptN), verdict })}
     const cfg = await run(getConfig());
     if (!cfg.enabled)
       return;
-    if (!cfg.autoStartOnMainIdle)
-      return;
     const workerState = sessionMap.get(workerSessionId);
     supervisor.currentWorkerSessionId = undefined;
     if (!workerState?.reportedStatus) {
@@ -25823,7 +25902,7 @@ ${interpolate(templates.continuePrompt, { attempt: String(attemptN), verdict })}
     },
     "experimental.chat.system.transform": async (input, output) => {
       output.system = output.system ?? [];
-      const sessionID = input.sessionID ?? input.session_id;
+      const sessionID = input.sessionID ?? input.session_id ?? input.session?.id;
       const role = sessionMap.get(sessionID ?? "")?.role;
       const base = role === "worker" || role === "subagent" ? templates.workerSystemPrompt : role === "ralph" ? templates.ralphSessionSystemPrompt : templates.systemPrompt;
       const full = templates.systemPromptAppend ? `${base}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ralph-rlm",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "OpenCode plugin: Ralph outer loop + RLM inner loop. Iterative AI development with file-first discipline and sub-agent support.",
   "type": "module",
   "main": "./dist/ralph-rlm.js",