opencode-ralph-rlm 0.1.6 → 0.1.8

package/README.md

@@ -265,6 +265,28 @@ If you are setting up a repo from scratch, use this sequence:
 
 If setup is incomplete, auto-start is skipped and the plugin emits a warning with next actions.
 
+## Recommended OpenCode agent setup
+
+The plugin already manages the core loop roles (`main` / `ralph` / `worker` / `subagent`).
+Use OpenCode agents to control posture and delegation, not to replace loop orchestration.
+
+Recommended split:
+
+- `supervisor` (primary): your default top-level operator for safe orchestration.
+- built-in `plan` (primary): dry analysis/planning without edits.
+- built-in `build` (primary): full manual implementation when needed.
+- project subagents (optional): focused review/docs/security helpers.
+
+This repo now includes project-local agent files under `.opencode/agents/`:
+
+- `.opencode/agents/supervisor.md`
+- `.opencode/agents/ralph-reviewer.md`
+- `.opencode/agents/docs-writer.md`
+- `.opencode/agents/security-auditor.md`
+
+These profiles intentionally keep loop ownership in `ralph-rlm`.
+Do not model Ralph strategist/worker as OpenCode primary/subagent replacements.
+
 
 ## Protocol files
 
@@ -416,6 +438,7 @@ Bind the current session as the supervisor and optionally start attempt 1 immedi
 Stop supervision for the current process. This prevents further auto-loop orchestration until restarted.
 
 - Use this when you want to pause/stop Ralph from spawning more sessions.
+- Use this after verification passes and the user confirms they are done, or when the user asks to stop the loop.
 - Resume later with `ralph_create_supervisor_session(restart_if_done=true)`.
 
 #### `ralph_supervision_status()`
@@ -550,6 +573,16 @@ args:
   post_to_conversation boolean  optional  Post to main conversation (default: true)
 ```
 
+#### `ralph_peek_worker(maxLines?, post_to_conversation?)`
+
+Snapshot the active worker's `CURRENT_STATE.md` and optionally post it into the main conversation for quick "peek" access in the TUI.
+
+```
+args:
+  maxLines            number   optional  Max lines to include (default: 120)
+  post_to_conversation boolean optional  Post to main conversation (default: true)
+```
+
 #### `ralph_ask(question, context?, timeout_minutes?)`
 
 Ask a question and **block** until you respond via `ralph_respond()`. The question is written to `.opencode/pending_input.json`, a toast appears in the main session, and the main conversation is prompted with the question ID and response instruction. The calling session polls every 5 seconds.

package/dist/ralph-rlm.js

@@ -23509,6 +23509,7 @@ var DEFAULT_TEMPLATES = {
     "  When you receive one, call ralph_respond(id, answer) to unblock the session.",
     "- Use ralph_doctor() to check setup, ralph_bootstrap_plan() to generate PLAN/TODOS,",
     "  ralph_create_supervisor_session() to bind/start explicitly, ralph_pause_supervision()/ralph_resume_supervision() to control execution, and ralph_end_supervision() to stop.",
+    "- End supervision when verification has passed and the user confirms they are done, or when the user explicitly asks to stop the loop.",
     "- Optional reviewer flow: worker marks readiness with ralph_request_review(); supervisor runs ralph_run_reviewer().",
     "- Monitor progress in SUPERVISOR_LOG.md, CONVERSATION.md, or via toast notifications."
   ].join(`
@@ -24102,7 +24103,21 @@ var RalphRLM = async ({ client, $, worktree }) => {
 - ${nowISO()} rotated
 `)).catch(() => {});
   };
+  const DEDUPE_WINDOW_MS = 5000;
+  const recentNotices = new Map;
+  const shouldDedupe = (key) => {
+    const now2 = Date.now();
+    const last3 = recentNotices.get(key);
+    if (last3 && now2 - last3 < DEDUPE_WINDOW_MS)
+      return true;
+    if (recentNotices.size > 200)
+      recentNotices.clear();
+    recentNotices.set(key, now2);
+    return false;
+  };
   const appendConversationEntry = async (source, message) => {
+    if (shouldDedupe(`conv|${source}|${message}`))
+      return;
     const cfg = await run(getConfig());
     await rotateConversationLogIfNeeded(cfg);
     const ts = nowISO();
@@ -24113,6 +24128,8 @@ var RalphRLM = async ({ client, $, worktree }) => {
     });
   };
   const notifySupervisor = async (source, message, level = "info", postToConversation = true, originSessionId) => {
+    if (shouldDedupe(`sup|${source}|${level}|${message}`))
+      return;
     const cfg = await run(getConfig());
     if (!messagePassesVerbosity(cfg.statusVerbosity, level))
       return;
@@ -24137,6 +24154,34 @@ var RalphRLM = async ({ client, $, worktree }) => {
       }).catch(() => {});
     }
   };
+  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")));
+    if (hasBunLock)
+      return { verify: ["bun", "run", "verify"], install: "bun install" };
+    const hasYarnLock = yield* fileExists(j("yarn.lock"));
+    if (hasYarnLock)
+      return { verify: ["yarn", "test"], install: "yarn install" };
+    const hasPnpmLock = yield* fileExists(j("pnpm-lock.yaml"));
+    if (hasPnpmLock)
+      return { verify: ["pnpm", "test"], install: "pnpm install" };
+    const hasPkg = yield* fileExists(j("package.json"));
+    if (hasPkg)
+      return { verify: ["npm", "test"], install: "npm install" };
+    const hasCargo = yield* fileExists(j("Cargo.toml"));
+    if (hasCargo)
+      return { verify: ["cargo", "test"], install: "cargo build" };
+    const hasPy = yield* fileExists(j("pyproject.toml"));
+    const hasReq = yield* fileExists(j("requirements.txt"));
+    if (hasReq)
+      return { verify: ["python", "-m", "pytest"], install: "pip install -r requirements.txt" };
+    if (hasPy)
+      return { verify: ["python", "-m", "pytest"], install: "pip install ." };
+    const hasMake = yield* fileExists(j("Makefile"));
+    if (hasMake)
+      return { verify: ["make", "test"], install: "make" };
+    return { verify: ["bun", "run", "verify"], install: "bun install" };
+  });
   const checkSetup = async (root, cfg) => {
     const diagnostics = {
       ready: true,
@@ -24148,7 +24193,8 @@ var RalphRLM = async ({ client, $, worktree }) => {
     if (!cfg.verify || cfg.verify.command.length === 0) {
       diagnostics.ready = false;
       diagnostics.issues.push("Missing verify.command in .opencode/ralph.json.");
-      diagnostics.suggestions.push('Set verify.command, e.g. ["bun", "run", "verify"].');
+      const defaults = await run(detectProjectDefaults(root));
+      diagnostics.suggestions.push(`Set verify.command, e.g. ${JSON.stringify(defaults.verify)}.`);
     }
     const planExists = await run(fileExists(j(FILES.PLAN)));
     if (!planExists) {
@@ -24502,6 +24548,41 @@ ${args2.nextStep}
       return run(runVerify(root));
     }
   });
+  const tool_ralph_peek_worker = tool({
+    description: "Snapshot the active RLM worker's CURRENT_STATE.md and optionally post it into the main conversation.",
+    args: {
+      maxLines: tool.schema.number().int().min(20).max(400).optional(),
+      post_to_conversation: tool.schema.boolean().optional().describe("Whether to post the peek into the main conversation (default: true).")
+    },
+    async execute(args2, ctx) {
+      const root = ctx.worktree ?? worktree;
+      const currPath = NodePath.join(root, FILES.CURR);
+      const ok = await run(fileExists(currPath));
+      if (!ok)
+        return JSON.stringify({ ok: false, missing: FILES.CURR }, null, 2);
+      const raw = await run(readFile(currPath).pipe(exports_Effect.orElseSucceed(() => "")));
+      const text = clampLines(raw, args2.maxLines ?? 120);
+      const attempt = supervisor.attempt;
+      const workerId = supervisor.currentWorkerSessionId;
+      const header = `Worker peek${attempt ? ` (attempt ${attempt})` : ""}${workerId ? ` \u2014 ${workerId}` : ""}`;
+      await notifySupervisor("peek", header, "info", false, ctx.sessionID);
+      const postToConv = args2.post_to_conversation !== false;
+      if (postToConv && supervisor.sessionId && supervisor.sessionId !== ctx.sessionID) {
+        await client.session.promptAsync({
+          path: { id: supervisor.sessionId },
+          body: { parts: [{ type: "text", text: `[peek] ${header}
+
+${text}` }] }
+        }).catch(() => {});
+      }
+      return JSON.stringify({
+        ok: true,
+        attempt: attempt || null,
+        workerSessionId: workerId ?? null,
+        text
+      }, null, 2);
+    }
+  });
   const tool_subagent_peek = tool({
     description: "Read file-first state from a sub-agent directory (.opencode/agents/<name>/).",
     args: {
@@ -24777,6 +24858,7 @@ No pending questions found.`));
       const diagnosticsBefore = await checkSetup(root, cfg);
       const actions = [];
       if (args2.autofix) {
+        const defaults = await run(detectProjectDefaults(root));
         const configPath = NodePath.join(root, ".opencode", "ralph.json");
         const configExists = await run(fileExists(configPath));
         if (!configExists) {
@@ -24786,7 +24868,7 @@ No pending questions found.`));
             statusVerbosity: "normal",
             maxAttempts: 25,
             heartbeatMinutes: 15,
-            verify: { command: ["bun", "run", "verify"], cwd: "." },
+            verify: { command: defaults.verify, cwd: "." },
             gateDestructiveToolsUntilContextLoaded: true,
             maxRlmSliceLines: 200,
             requireGrepBeforeLargeSlice: true,
@@ -24814,8 +24896,8 @@ No pending questions found.`));
             "# Project Agent Rules",
             "",
             "## Build and verify",
-            "- Install: bun install",
-            "- Verify: bun run verify",
+            `- Install: ${defaults.install}`,
+            `- Verify: ${defaults.verify.join(" ")}`,
             "",
             "## Loop note",
             "- This project uses ralph-rlm.",
@@ -25149,13 +25231,14 @@ Set a new goal and run again.
         const configPath = NodePath.join(root, ".opencode", "ralph.json");
         const configExists = await run(fileExists(configPath));
         if (!configExists) {
+          const defaults = await run(detectProjectDefaults(root));
           const defaultCfg = {
             enabled: true,
             autoStartOnMainIdle: false,
             statusVerbosity: "normal",
             maxAttempts: 25,
             heartbeatMinutes: 15,
-            verify: { command: ["bun", "run", "verify"], cwd: "." },
+            verify: { command: defaults.verify, cwd: "." },
             gateDestructiveToolsUntilContextLoaded: true,
             maxRlmSliceLines: 200,
             requireGrepBeforeLargeSlice: true,
@@ -25592,6 +25675,7 @@ ${interpolate(templates.continuePrompt, { attempt: String(attemptN), verdict })}
       ralph_update_rlm_instructions: tool_ralph_update_rlm_instructions,
       ralph_rollover: tool_ralph_rollover,
       ralph_verify: tool_ralph_verify,
+      ralph_peek_worker: tool_ralph_peek_worker,
       ralph_spawn_worker: tool_ralph_spawn_worker,
       subagent_peek: tool_subagent_peek,
       subagent_spawn: tool_subagent_spawn,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-ralph-rlm",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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",