@pi-unipi/ralph 2.6.0 → 2.6.2

package/index.ts

@@ -15,6 +15,7 @@ import {
   RALPH_TOOLS,
   emitEvent,
   getPackageVersion,
+  parseArgs,
 } from "@pi-unipi/core";
 
 // Get info registry from global
@@ -67,17 +68,7 @@ export default function (pi: ExtensionAPI) {
     emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {
       name: MODULES.RALPH,
       version: VERSION,
-      commands: [
-        "unipi:ralph-start",
-        "unipi:ralph-stop",
-        "unipi:ralph-resume",
-        "unipi:ralph-status",
-        "unipi:ralph-cancel",
-        "unipi:ralph-archive",
-        "unipi:ralph-clean",
-        "unipi:ralph-list",
-        "unipi:ralph-nuke",
-      ],
+      commands: ["unipi:ralph", "unipi:ralph-stop"],
       tools: [RALPH_TOOLS.START, RALPH_TOOLS.DONE],
     });
 
@@ -142,12 +133,7 @@ export default function (pi: ExtensionAPI) {
         : "";
 
     if (text.includes(RALPH_COMPLETE_MARKER)) {
-      mgr.completeLoop(
-        state,
-        `───────────────────────────────────────────────────────────────────────
-✅ RALPH LOOP COMPLETE: ${state.name} | ${state.iteration} iterations
-───────────────────────────────────────────────────────────────────────`,
-      );
+      mgr.completeLoop(state);
     }
   });
 
@@ -215,7 +201,7 @@ To stop: press ESC to interrupt, then run /unipi:ralph-stop when idle`;
   pi.registerCommand("unipi:ralph", {
     description: "Ralph loop commands (start, stop, resume, status, etc.)",
     handler: async (args, ctx) => {
-      const parts = args.trim().split(/\s+/);
+      const parts = parseArgs(args);
       const cmd = parts[0];
       const rest = parts.slice(1).join(" ");
 
@@ -302,25 +288,14 @@ function handleStart(rest: string, ctx: ExtensionContext, pi: ExtensionAPI): voi
     return;
   }
 
-  // Check if task file exists, create if not
+  // Check if task file exists; startLoop writes the task content to disk.
   const fullPath = require("node:path").resolve(ctx.cwd, taskFile);
-  const fs = require("node:fs");
-  if (!fs.existsSync(fullPath)) {
-    const { ensureDir } = require("@pi-unipi/core");
-    ensureDir(fullPath);
-    fs.writeFileSync(
-      fullPath,
-      `# Task\n\nDescribe your task here.\n\n## Goals\n- Goal 1\n\n## Checklist\n- [ ] Item 1\n\n## Notes\n(Update this as you work)\n`,
-      "utf-8",
-    );
-    if (ctx.hasUI) ctx.ui.notify(`Created task file: ${taskFile}`, "info");
-  }
-
   const { tryRead } = require("@pi-unipi/core");
-  const content = tryRead(fullPath);
+  let content = tryRead(fullPath);
   if (!content) {
-    if (ctx.hasUI) ctx.ui.notify(`Could not read task file: ${taskFile}`, "error");
-    return;
+    // File doesn't exist yet — pass the template through so startLoop creates it.
+    content = `# Task\n\nDescribe your task here.\n\n## Goals\n- Goal 1\n\n## Checklist\n- [ ] Item 1\n\n## Notes\n(Update this as you work)\n`;
+    if (ctx.hasUI) ctx.ui.notify(`Created task file: ${taskFile}`, "info");
   }
 
   const state = mgr.startLoop(loopName, taskFile, content, {
@@ -362,8 +337,9 @@ function handleStop(ctx: ExtensionContext, pi: ExtensionAPI): void {
     return;
   }
 
-  mgr.stopLoop(
+  mgr.completeLoop(
     state,
+    "cancelled",
     `Stopped Ralph loop: ${state.name} (iteration ${state.iteration})`,
   );
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ralph",
-  "version": "2.6.0",
+  "version": "2.6.2",
   "description": "Long-running iterative development loops for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -20,6 +20,7 @@
   ],
   "files": [
     "*.ts",
+    "!*.test.ts",
     "SKILL.md",
     "README.md"
   ],
@@ -30,8 +31,8 @@
     "test": "npx tsx --test reminder.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.6.0",
-    "@pi-unipi/info-screen": "2.6.0"
+    "@pi-unipi/core": "2.6.1",
+    "@pi-unipi/info-screen": "2.6.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.80.0",
@@ -40,8 +41,12 @@
     "typebox": "^1.1.38"
   },
   "pi": {
-    "extensions": [],
-    "skills": [],
+    "extensions": [
+      "./index.ts"
+    ],
+    "skills": [
+      "./SKILL.md"
+    ],
     "prompts": [],
     "themes": []
   }

package/ralph-loop.ts

@@ -57,23 +57,6 @@ Pause and reflect on your progress:
 
 Update the task file with your reflection, then continue working.`;
 
-/** Default task template */
-export const DEFAULT_TEMPLATE = `# Task
-
-Describe your task here.
-
-## Goals
-- Goal 1
-- Goal 2
-
-## Checklist
-- [ ] Item 1
-- [ ] Item 2
-
-## Notes
-(Update this as you work)
-`;
-
 /** Ralph loop manager */
 export class RalphLoopManager {
   private currentLoop: string | null = null;
@@ -144,7 +127,7 @@ export class RalphLoopManager {
     if (message && this.ctx.hasUI) this.ctx.ui.notify(message, "info");
   }
 
-  completeLoop(state: LoopState, banner: string): void {
+  completeLoop(state: LoopState, reason: "completed" | "cancelled" = "completed", message?: string): void {
     state.status = "completed";
     state.completedAt = now();
     state.active = false;
@@ -156,26 +139,7 @@ export class RalphLoopManager {
       iteration: state.iteration,
       maxIterations: state.maxIterations,
       status: "completed",
-      reason: "completed",
-    } satisfies UnipiRalphLoopEvent);
-
-    this.currentLoop = null;
-    this.updateUI();
-  }
-
-  stopLoop(state: LoopState, message?: string): void {
-    state.status = "completed";
-    state.completedAt = now();
-    state.active = false;
-    this.saveState(state);
-
-    // Emit event
-    this.emitFn(UNIPI_EVENTS.RALPH_LOOP_END, {
-      name: state.name,
-      iteration: state.iteration,
-      maxIterations: state.maxIterations,
-      status: "completed",
-      reason: "cancelled",
+      reason,
     } satisfies UnipiRalphLoopEvent);
 
     this.currentLoop = null;
@@ -365,12 +329,7 @@ export class RalphLoopManager {
 
     // Check max iterations
     if (state.maxIterations > 0 && state.iteration > state.maxIterations) {
-      this.completeLoop(
-        state,
-        `───────────────────────────────────────────────────────────────────────
-⚠️ RALPH LOOP STOPPED: ${state.name} | Max iterations (${state.maxIterations}) reached
-───────────────────────────────────────────────────────────────────────`,
-      );
+      this.completeLoop(state);
       return null;
     }
 

package/reminder.test.ts

@@ -1,66 +0,0 @@
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-import {
-  buildRalphLoopReminder,
-  latestRalphReminder,
-  RALPH_REMINDER_TYPE,
-} from "./reminder.ts";
-
-const state = {
-  name: "cache-rollout",
-  iteration: 3,
-  maxIterations: 10,
-  taskFile: ".unipi/ralph/cache-rollout.md",
-  itemsPerIteration: 2,
-};
-
-function context(branch: any[]) {
-  return { sessionManager: { getBranch: () => branch } } as any;
-}
-
-function custom(content: string) {
-  return {
-    type: "custom_message",
-    customType: RALPH_REMINDER_TYPE,
-    content,
-    id: "r1",
-    parentId: null,
-    timestamp: "2026-08-14T00:00:00.000Z",
-    display: false,
-  };
-}
-
-describe("Ralph append-only reminder snapshots", () => {
-  it("is deterministic and explicitly supersedes older reminders", () => {
-    const first = buildRalphLoopReminder(state);
-    const second = buildRalphLoopReminder({ ...state });
-    assert.equal(first, second);
-    assert.match(first, /supersedes all earlier Ralph loop reminders/);
-  });
-
-  it("finds an unchanged retained snapshot for deduplication", () => {
-    const content = buildRalphLoopReminder(state);
-    assert.equal(latestRalphReminder(context([custom(content)])), content);
-  });
-
-  it("returns the newest retained snapshot when state changes", () => {
-    const old = buildRalphLoopReminder({ ...state, iteration: 2 });
-    const current = buildRalphLoopReminder(state);
-    assert.equal(latestRalphReminder(context([custom(old), { ...custom(current), id: "r2" }])), current);
-    assert.notEqual(old, current);
-  });
-
-  it("stops at compaction so current state is reinjected once in the new epoch", () => {
-    const old = buildRalphLoopReminder({ ...state, iteration: 2 });
-    const compaction = {
-      type: "compaction",
-      id: "c1",
-      parentId: "r1",
-      timestamp: "2026-08-14T00:00:01.000Z",
-      summary: `folded: ${old}`,
-      firstKeptEntryId: "r1",
-      tokensBefore: 1000,
-    };
-    assert.equal(latestRalphReminder(context([custom(old), compaction])), null);
-  });
-});