@neriros/ralphy 2.21.1 → 2.21.3

package/README.md

@@ -181,10 +181,16 @@ Example `ralphy.config.json`:
     "codeReviewStaleHours": 24,
     "indicators": {
       "getTodo": { "filter": [{ "type": "status", "value": "Todo" }] },
-      "getInProgress": { "filter": [{ "type": "status", "value": "In Progress" }] },
-      "getConflicted": { "filter": [{ "type": "label", "value": "ralph:conflicted" }] },
+      "getInProgress": {
+        "filter": [{ "type": "status", "value": "In Progress" }],
+      },
+      "getConflicted": {
+        "filter": [{ "type": "label", "value": "ralph:conflicted" }],
+      },
       "getReview": { "filter": [{ "type": "label", "value": "ralph:review" }] },
-      "getAutoMerge": { "filter": [{ "type": "label", "value": "ralph:auto-merge" }] },
+      "getAutoMerge": {
+        "filter": [{ "type": "label", "value": "ralph:auto-merge" }],
+      },
       "setInProgress": { "type": "status", "value": "In Progress" },
       "setDone": {
         "apply": [
@@ -243,6 +249,9 @@ With `useWorktree: true` (or `--worktree`) each task runs in an isolated worktre
 
 - **`setupScript`** — `sh -c`-run inside the worktree right after scaffolding (e.g. `bun install`, `cp .env.example .env`).
 - **`teardownScript`** — `sh -c`-run after the loop exits and (optional) worktree cleanup.
+
+Both scripts receive `WORKSPACE_ROOT` in their environment — the absolute path to the origin repository (the parent of the worktree). Use it to reference project-root files from inside a worktree, e.g. `cp "$WORKSPACE_ROOT/.env.example" .env`.
+
 - **`cleanupWorktreeOnSuccess`** — remove the worktree on clean exit. Failed workers always keep their worktree + branch for human inspection.
 
 Both scripts log failures but never block the loop. **`appendPrompt`** (or `--prompt` in agent mode) is appended to every scaffolded `proposal.md` under `## Additional instructions` — use it for cross-cutting guidance every task should see.

package/dist/cli/index.js

@@ -35029,8 +35029,8 @@ import { readFileSync as readFileSync2 } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("2.21.1")
-      return "2.21.1";
+    if ("2.21.3")
+      return "2.21.3";
   } catch {}
   const dirsToTry = [];
   try {
@@ -61460,6 +61460,7 @@ function buildAgentCoordinator(input) {
     const proc = Bun.spawn({
       cmd: ["sh", "-c", cmd],
       cwd: cwd2,
+      env: { ...process.env, WORKSPACE_ROOT: projectRoot },
       stdout: "ignore",
       stderr: "pipe",
       stdin: "ignore"
@@ -62245,7 +62246,7 @@ var exports_json_runner = {};
 __export(exports_json_runner, {
   runAgentJson: () => runAgentJson
 });
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 import { mkdir as mkdir6 } from "fs/promises";
 import { homedir as homedir4 } from "os";
 function cleanOutputLine2(raw) {
@@ -62270,7 +62271,7 @@ async function runAgentJson({
   statesDir,
   tasksDir
 }) {
-  await mkdir6(join21(homedir4(), ".ralph"), { recursive: true }).catch(() => {
+  await mkdir6(join22(homedir4(), ".ralph"), { recursive: true }).catch(() => {
     return;
   });
   const cfgPath = await ensureRalphyConfig(projectRoot);
@@ -62409,7 +62410,7 @@ var init_json_runner = __esm(() => {
 });
 
 // apps/cli/src/index.ts
-import { resolve as resolve2, join as join22, dirname as dirname6 } from "path";
+import { resolve as resolve2, join as join23 } from "path";
 import { exists as exists2, mkdir as mkdir7, rm } from "fs/promises";
 
 // node_modules/.bun/ink@5.2.1+1f88f629f0141b18/node_modules/ink/build/render.js
@@ -67532,7 +67533,7 @@ function createDefaultContext() {
 
 // apps/cli/src/components/App.tsx
 var import_react58 = __toESM(require_react(), 1);
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 
 // packages/core/src/state.ts
 init_types2();
@@ -74236,16 +74237,79 @@ function AgentMode({ args, projectRoot, statesDir, tasksDir }) {
 }
 
 // packages/openspec/src/openspec-change-store.ts
-import { join as join18, dirname as dirname5 } from "path";
+import { dirname as dirname6, join as join19 } from "path";
 import { readdir, mkdir as mkdir5 } from "fs/promises";
-function resolveOpenspecBin() {
-  const pkgJsonPath = Bun.resolveSync("@fission-ai/openspec/package.json", import.meta.dir);
-  return join18(dirname5(pkgJsonPath), "bin", "openspec.js");
+
+// packages/openspec/src/openspec-bin.ts
+import { dirname as dirname5, join as join18 } from "path";
+var bunInstallRunner = {
+  spawnSync: (cmd, cwd2) => {
+    const proc = Bun.spawnSync({
+      cmd,
+      cwd: cwd2,
+      stdio: ["ignore", "inherit", "inherit"]
+    });
+    return { exitCode: proc.exitCode };
+  },
+  resolveSync: (specifier, fromDir) => Bun.resolveSync(specifier, fromDir),
+  log: (text) => {
+    process.stderr.write(text);
+  }
+};
+function findPackageRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0;i < 8; i++) {
+    if (Bun.file(join18(dir, "package.json")).size >= 0) {
+      try {
+        if (Bun.file(join18(dir, "package.json")).size > 0)
+          return dir;
+      } catch {}
+    }
+    const parent = dirname5(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  return startDir;
 }
+function ensureOpenspecInstalled(fromDir, runner) {
+  const installDir = findPackageRoot(fromDir);
+  runner.log(`[ralphy] @fission-ai/openspec not found in ${installDir} \u2014 installing automatically...
+`);
+  const candidates = [
+    ["npm", "install", "--no-save", "--no-audit", "--no-fund", "@fission-ai/openspec@latest"],
+    ["bun", "add", "@fission-ai/openspec@latest"]
+  ];
+  for (const cmd of candidates) {
+    try {
+      const result2 = runner.spawnSync(cmd, installDir);
+      if (result2.exitCode === 0) {
+        runner.log(`[ralphy] installed @fission-ai/openspec via ${cmd[0]}.
+`);
+        return;
+      }
+    } catch {}
+  }
+  const err = new Error("openspec auto-install failed");
+  err.installDir = installDir;
+  throw err;
+}
+function resolveOpenspecBin(fromDir, runner = bunInstallRunner) {
+  try {
+    const pkgJsonPath = runner.resolveSync("@fission-ai/openspec/package.json", fromDir);
+    return join18(dirname5(pkgJsonPath), "bin", "openspec.js");
+  } catch {
+    ensureOpenspecInstalled(fromDir, runner);
+    const pkgJsonPath = runner.resolveSync("@fission-ai/openspec/package.json", fromDir);
+    return join18(dirname5(pkgJsonPath), "bin", "openspec.js");
+  }
+}
+
+// packages/openspec/src/openspec-change-store.ts
 function runOpenspec(args, options = {}) {
   const stdio = options.inherit ? ["inherit", "inherit", "inherit"] : ["ignore", "pipe", "pipe"];
   const proc = Bun.spawnSync({
-    cmd: [process.execPath, resolveOpenspecBin(), ...args],
+    cmd: [process.execPath, resolveOpenspecBin(import.meta.dir), ...args],
     stdio
   });
   const decoder = new TextDecoder;
@@ -74266,7 +74330,7 @@ class OpenSpecChangeStore {
     }
   }
   getChangeDirectory(name) {
-    return join18("openspec", "changes", name);
+    return join19("openspec", "changes", name);
   }
   async listChanges() {
     const result2 = runOpenspec(["list", "--json"]);
@@ -74280,7 +74344,7 @@ class OpenSpecChangeStore {
         }
       } catch {}
     }
-    const changesDir = join18("openspec", "changes");
+    const changesDir = join19("openspec", "changes");
     if (!await Bun.file(changesDir).exists())
       return [];
     try {
@@ -74291,29 +74355,29 @@ class OpenSpecChangeStore {
     }
   }
   async readTaskList(name) {
-    const file = Bun.file(join18("openspec", "changes", name, "tasks.md"));
+    const file = Bun.file(join19("openspec", "changes", name, "tasks.md"));
     if (!await file.exists())
       return "";
     return await file.text();
   }
   async writeTaskList(name, content) {
-    const path = join18("openspec", "changes", name, "tasks.md");
-    await mkdir5(dirname5(path), { recursive: true });
+    const path = join19("openspec", "changes", name, "tasks.md");
+    await mkdir5(dirname6(path), { recursive: true });
     await Bun.write(path, content);
   }
   async appendSteering(name, message) {
-    const path = join18("openspec", "changes", name, "steering.md");
+    const path = join19("openspec", "changes", name, "steering.md");
     const file = Bun.file(path);
     const existing = await file.exists() ? await file.text() : null;
     const updated = existing ? `${message}
 
 ${existing.trimStart()}` : `${message}
 `;
-    await mkdir5(dirname5(path), { recursive: true });
+    await mkdir5(dirname6(path), { recursive: true });
     await Bun.write(path, updated);
   }
   async readSection(name, artifact, heading) {
-    const file = Bun.file(join18("openspec", "changes", name, artifact));
+    const file = Bun.file(join19("openspec", "changes", name, artifact));
     if (!await file.exists())
       return "";
     const content = await file.text();
@@ -74432,8 +74496,8 @@ function App2({ args, statesDir, tasksDir, projectRoot }) {
           message: "Error: --name is required for status mode"
         }, undefined, false, undefined, this);
       }
-      const stateDir = join19(statesDir, args.name);
-      if (getStorage().read(join19(stateDir, ".ralph-state.json")) === null) {
+      const stateDir = join20(statesDir, args.name);
+      if (getStorage().read(join20(stateDir, ".ralph-state.json")) === null) {
         return /* @__PURE__ */ jsx_dev_runtime10.jsxDEV(ErrorMessage, {
           message: `Error: change '${args.name}' not found`
         }, undefined, false, undefined, this);
@@ -74480,7 +74544,7 @@ init_worktree();
 
 // apps/cli/src/debug.ts
 init_log();
-import { join as join20 } from "path";
+import { join as join21 } from "path";
 function fmtTs(d) {
   return d.toISOString().replace("T", " ").slice(0, 23);
 }
@@ -74593,7 +74657,7 @@ function detectStuck(lines) {
   };
 }
 async function inspectBinary(projectRoot) {
-  const binPath = join20(projectRoot, ".ralph", "bin", "cli.js");
+  const binPath = join21(projectRoot, ".ralph", "bin", "cli.js");
   const file = Bun.file(binPath);
   if (!await file.exists())
     return null;
@@ -74619,7 +74683,7 @@ var SPAWN_RE = /\u25B6 (\S+) \u2192 (\S+)/;
 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(join20(projectRoot, ".ralph", "agent.log"));
+  const jsonlLogFile = Bun.file(join21(projectRoot, ".ralph", "agent.log"));
   const jsonlLines = await jsonlLogFile.exists() ? parseJsonlLog(await jsonlLogFile.text()) : [];
   const allLines = [...textLines, ...jsonlLines];
   if (opts.name && !opts.issue) {
@@ -74724,7 +74788,7 @@ async function runDebug(opts) {
 `);
   const agentLogFile = Bun.file(AGENT_LOG_PATH);
   const textLines = await agentLogFile.exists() ? parseTextLog(await agentLogFile.text()) : [];
-  const jsonlLogPath = join20(projectRoot, ".ralph", "agent.log");
+  const jsonlLogPath = join21(projectRoot, ".ralph", "agent.log");
   const jsonlLogFile = Bun.file(jsonlLogPath);
   const hasJsonlLog = await jsonlLogFile.exists();
   let { changeName, identifier: issueIdentifier } = await resolveDebugTarget(projectRoot, {
@@ -74738,7 +74802,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(join20(projectRoot, ".ralph", "logs", `${changeName}.log`));
+  const workerLogFile = Bun.file(join21(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;
@@ -74895,8 +74959,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 = join20(projectRoot, ".ralph", "worktrees", changeName);
-  if (await Bun.file(join20(worktreePath, ".git")).exists()) {
+  const worktreePath = join21(projectRoot, ".ralph", "worktrees", changeName);
+  if (await Bun.file(join21(worktreePath, ".git")).exists()) {
     out(`  Worktree   : ${worktreePath}`);
   }
   if (!timeline.length)
@@ -74914,7 +74978,7 @@ if (typeof globalThis.Bun === "undefined") {
 async function findProjectRoot() {
   let dir = process.cwd();
   while (dir !== "/") {
-    if (await exists2(join22(dir, "openspec")))
+    if (await exists2(join23(dir, "openspec")))
       return dir;
     dir = resolve2(dir, "..");
   }
@@ -74955,7 +75019,7 @@ try {
   const tasksDir = layout.tasksDir;
   if (args.mode === "init") {
     await mkdir7(statesDir, { recursive: true });
-    const openspecBin = join22(dirname6(Bun.resolveSync("@fission-ai/openspec/package.json", import.meta.dir)), "bin", "openspec.js");
+    const openspecBin = resolveOpenspecBin(import.meta.dir);
     Bun.spawnSync({
       cmd: [process.execPath, openspecBin, "init", "--tools", "none", "--force"],
       stdio: ["inherit", "inherit", "inherit"],
@@ -74978,9 +75042,9 @@ try {
 `);
       process.exit(1);
     }
-    const worktreeDir = join22(worktreesDir(projectRoot), args.name);
-    const changeDir = join22(tasksDir, args.name);
-    const stateDir = join22(statesDir, args.name);
+    const worktreeDir = join23(worktreesDir(projectRoot), args.name);
+    const changeDir = join23(tasksDir, args.name);
+    const stateDir = join23(statesDir, args.name);
     const branch = `ralph/${args.name}`;
     const removed = [];
     if (await exists2(worktreeDir)) {
@@ -75032,13 +75096,13 @@ try {
     process.exit(0);
   }
   if (args.mode === "task" && args.name) {
-    await mkdir7(join22(statesDir, args.name), { recursive: true });
-    await mkdir7(join22(tasksDir, args.name), { recursive: true });
+    await mkdir7(join23(statesDir, args.name), { recursive: true });
+    await mkdir7(join23(tasksDir, args.name), { recursive: true });
   }
   if (args.mode === "agent") {
     await mkdir7(statesDir, { recursive: true });
     await mkdir7(tasksDir, { recursive: true });
-    await mkdir7(join22(projectRoot, ".ralph"), { recursive: true });
+    await mkdir7(join23(projectRoot, ".ralph"), { recursive: true });
   }
   if (args.mode === "agent" && args.jsonOutput) {
     const { runAgentJson: runAgentJson2 } = await Promise.resolve().then(() => (init_json_runner(), exports_json_runner));

package/dist/mcp/index.js

@@ -6605,7 +6605,7 @@ var require_dist = __commonJS((exports, module) => {
 });
 
 // apps/mcp/src/index.ts
-import { resolve, join as join4 } from "path";
+import { resolve, join as join5 } from "path";
 import { exists } from "fs/promises";
 
 // packages/context/src/context.ts
@@ -24900,16 +24900,79 @@ function error2(msg) {
 }
 
 // packages/openspec/src/openspec-change-store.ts
-import { join as join3, dirname as dirname2 } from "path";
+import { dirname as dirname3, join as join4 } from "path";
 import { readdir, mkdir } from "fs/promises";
-function resolveOpenspecBin() {
-  const pkgJsonPath = Bun.resolveSync("@fission-ai/openspec/package.json", import.meta.dir);
-  return join3(dirname2(pkgJsonPath), "bin", "openspec.js");
+
+// packages/openspec/src/openspec-bin.ts
+import { dirname as dirname2, join as join3 } from "path";
+var bunInstallRunner = {
+  spawnSync: (cmd, cwd) => {
+    const proc = Bun.spawnSync({
+      cmd,
+      cwd,
+      stdio: ["ignore", "inherit", "inherit"]
+    });
+    return { exitCode: proc.exitCode };
+  },
+  resolveSync: (specifier, fromDir) => Bun.resolveSync(specifier, fromDir),
+  log: (text) => {
+    process.stderr.write(text);
+  }
+};
+function findPackageRoot(startDir) {
+  let dir = startDir;
+  for (let i = 0;i < 8; i++) {
+    if (Bun.file(join3(dir, "package.json")).size >= 0) {
+      try {
+        if (Bun.file(join3(dir, "package.json")).size > 0)
+          return dir;
+      } catch {}
+    }
+    const parent = dirname2(dir);
+    if (parent === dir)
+      break;
+    dir = parent;
+  }
+  return startDir;
+}
+function ensureOpenspecInstalled(fromDir, runner) {
+  const installDir = findPackageRoot(fromDir);
+  runner.log(`[ralphy] @fission-ai/openspec not found in ${installDir} \u2014 installing automatically...
+`);
+  const candidates = [
+    ["npm", "install", "--no-save", "--no-audit", "--no-fund", "@fission-ai/openspec@latest"],
+    ["bun", "add", "@fission-ai/openspec@latest"]
+  ];
+  for (const cmd of candidates) {
+    try {
+      const result = runner.spawnSync(cmd, installDir);
+      if (result.exitCode === 0) {
+        runner.log(`[ralphy] installed @fission-ai/openspec via ${cmd[0]}.
+`);
+        return;
+      }
+    } catch {}
+  }
+  const err = new Error("openspec auto-install failed");
+  err.installDir = installDir;
+  throw err;
 }
+function resolveOpenspecBin(fromDir, runner = bunInstallRunner) {
+  try {
+    const pkgJsonPath = runner.resolveSync("@fission-ai/openspec/package.json", fromDir);
+    return join3(dirname2(pkgJsonPath), "bin", "openspec.js");
+  } catch {
+    ensureOpenspecInstalled(fromDir, runner);
+    const pkgJsonPath = runner.resolveSync("@fission-ai/openspec/package.json", fromDir);
+    return join3(dirname2(pkgJsonPath), "bin", "openspec.js");
+  }
+}
+
+// packages/openspec/src/openspec-change-store.ts
 function runOpenspec(args, options = {}) {
   const stdio = options.inherit ? ["inherit", "inherit", "inherit"] : ["ignore", "pipe", "pipe"];
   const proc = Bun.spawnSync({
-    cmd: [process.execPath, resolveOpenspecBin(), ...args],
+    cmd: [process.execPath, resolveOpenspecBin(import.meta.dir), ...args],
     stdio
   });
   const decoder = new TextDecoder;
@@ -24930,7 +24993,7 @@ class OpenSpecChangeStore {
     }
   }
   getChangeDirectory(name) {
-    return join3("openspec", "changes", name);
+    return join4("openspec", "changes", name);
   }
   async listChanges() {
     const result = runOpenspec(["list", "--json"]);
@@ -24944,7 +25007,7 @@ class OpenSpecChangeStore {
         }
       } catch {}
     }
-    const changesDir = join3("openspec", "changes");
+    const changesDir = join4("openspec", "changes");
     if (!await Bun.file(changesDir).exists())
       return [];
     try {
@@ -24955,29 +25018,29 @@ class OpenSpecChangeStore {
     }
   }
   async readTaskList(name) {
-    const file = Bun.file(join3("openspec", "changes", name, "tasks.md"));
+    const file = Bun.file(join4("openspec", "changes", name, "tasks.md"));
     if (!await file.exists())
       return "";
     return await file.text();
   }
   async writeTaskList(name, content) {
-    const path = join3("openspec", "changes", name, "tasks.md");
-    await mkdir(dirname2(path), { recursive: true });
+    const path = join4("openspec", "changes", name, "tasks.md");
+    await mkdir(dirname3(path), { recursive: true });
     await Bun.write(path, content);
   }
   async appendSteering(name, message) {
-    const path = join3("openspec", "changes", name, "steering.md");
+    const path = join4("openspec", "changes", name, "steering.md");
     const file = Bun.file(path);
     const existing = await file.exists() ? await file.text() : null;
     const updated = existing ? `${message}
 
 ${existing.trimStart()}` : `${message}
 `;
-    await mkdir(dirname2(path), { recursive: true });
+    await mkdir(dirname3(path), { recursive: true });
     await Bun.write(path, updated);
   }
   async readSection(name, artifact, heading) {
-    const file = Bun.file(join3("openspec", "changes", name, artifact));
+    const file = Bun.file(join4("openspec", "changes", name, artifact));
     if (!await file.exists())
       return "";
     const content = await file.text();
@@ -25021,7 +25084,7 @@ ${existing.trimStart()}` : `${message}
 async function findProjectRoot(startDir) {
   let dir = startDir;
   while (dir !== "/") {
-    if (await exists(join4(dir, "openspec")))
+    if (await exists(join5(dir, "openspec")))
       return dir;
     dir = resolve(dir, "..");
   }
@@ -25035,8 +25098,8 @@ async function main() {
     startDir = resolve(args[dirIdx + 1]);
   }
   const projectRoot = await findProjectRoot(startDir);
-  const changesDir = join4(projectRoot, ".ralph", "tasks");
-  const taskFilesDir = join4(projectRoot, "openspec", "changes");
+  const changesDir = join5(projectRoot, ".ralph", "tasks");
+  const taskFilesDir = join5(projectRoot, "openspec", "changes");
   const changeStore = new OpenSpecChangeStore;
   const server = new McpServer({
     name: "ralph",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "2.21.1",
+  "version": "2.21.3",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",
@@ -56,10 +56,12 @@
     "copy-assets": "bun scripts/copy-assets.ts",
     "prepublishOnly": "bun run build:publish"
   },
+  "dependencies": {
+    "@fission-ai/openspec": "latest"
+  },
   "devDependencies": {
     "@commitlint/cli": "^20.5.3",
     "@commitlint/config-conventional": "^20.5.3",
-    "@fission-ai/openspec": "latest",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@nx/devkit": "^22.7.1",
     "@nx/js": "^22.7.1",