@neriros/ralphy 2.17.1 → 2.17.3

package/dist/cli/index.js

@@ -35029,8 +35029,8 @@ import { readFileSync as readFileSync2 } from "fs";
 import { resolve } from "path";
 function getVersion() {
   try {
-    if ("2.17.1")
-      return "2.17.1";
+    if ("2.17.3")
+      return "2.17.3";
   } catch {}
   const dirsToTry = [];
   try {
@@ -35131,6 +35131,7 @@ async function parseArgs(argv) {
     createPr: false,
     fixCi: false,
     maxTickets: 0,
+    projectRoot: undefined,
     jsonOutput: false
   };
   let expectModel = false;
@@ -35149,6 +35150,7 @@ async function parseArgs(argv) {
   let expectConcurrency = false;
   let expectMaxTickets = false;
   let expectIndicator = false;
+  let expectProjectRoot = false;
   for (const arg of argv) {
     if (expectModel) {
       if (VALID_MODELS.has(arg)) {
@@ -35237,6 +35239,11 @@ async function parseArgs(argv) {
       expectIndicator = false;
       continue;
     }
+    if (expectProjectRoot) {
+      result2.projectRoot = arg;
+      expectProjectRoot = false;
+      continue;
+    }
     switch (arg) {
       case "--claude":
         if (result2.engineSet && result2.engine !== "claude") {
@@ -35325,6 +35332,9 @@ async function parseArgs(argv) {
       case "--from-agent":
         result2.fromAgent = true;
         break;
+      case "--project-root":
+        expectProjectRoot = true;
+        break;
       default:
         if (VALID_MODES.has(arg)) {
           result2.mode = arg;
@@ -39458,6 +39468,99 @@ var init_types2 = __esm(() => {
   });
 });
 
+// apps/cli/src/agent/worktree.ts
+import { basename, join as join3 } from "path";
+import { homedir } from "os";
+import { exists } from "fs/promises";
+function worktreesDir(projectRoot) {
+  return join3(homedir(), ".ralph", basename(projectRoot), "worktrees");
+}
+function branchForChange(changeName) {
+  return `ralph/${changeName}`;
+}
+async function createWorktree(projectRoot, changeName, runner) {
+  const dir = worktreesDir(projectRoot);
+  const cwd2 = join3(dir, changeName);
+  const branch = branchForChange(changeName);
+  const list = await runner.run(["worktree", "list", "--porcelain"], projectRoot);
+  if (list.stdout.includes(`worktree ${cwd2}
+`)) {
+    return { cwd: cwd2, branch };
+  }
+  let branchExists = true;
+  try {
+    await runner.run(["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], projectRoot);
+  } catch {
+    branchExists = false;
+  }
+  const cmd = branchExists ? ["worktree", "add", cwd2, branch] : ["worktree", "add", "-b", branch, cwd2];
+  await runner.run(cmd, projectRoot);
+  return { cwd: cwd2, branch };
+}
+async function removeWorktree(projectRoot, cwd2, runner) {
+  await runner.run(["worktree", "remove", "--force", cwd2], projectRoot);
+}
+async function isWorktreeSafeToRemove(cwd2, base2, runner) {
+  const status = await runner.run(["status", "--porcelain"], cwd2);
+  const dirty = status.stdout.trim();
+  let unpushedCommits = "";
+  try {
+    const log2 = await runner.run(["log", "--oneline", `${base2}..HEAD`, "--no-merges"], cwd2);
+    unpushedCommits = log2.stdout.trim();
+  } catch {
+    unpushedCommits = "<unknown: failed to compare against base>";
+  }
+  if (dirty && unpushedCommits) {
+    return {
+      safe: false,
+      reason: "uncommitted changes AND unpushed commits present",
+      dirty,
+      unpushedCommits
+    };
+  }
+  if (dirty) {
+    return {
+      safe: false,
+      reason: "uncommitted or untracked files present",
+      dirty,
+      unpushedCommits
+    };
+  }
+  if (unpushedCommits) {
+    return {
+      safe: false,
+      reason: `commits ahead of ${base2} were not pushed/PR'd`,
+      dirty,
+      unpushedCommits
+    };
+  }
+  return { safe: true, dirty, unpushedCommits };
+}
+async function seedWorktreeMcpConfig(projectRoot, worktreeCwd) {
+  const dst = join3(worktreeCwd, ".mcp.json");
+  const src = join3(projectRoot, ".mcp.json");
+  const source = await exists(dst) ? dst : await exists(src) ? src : null;
+  if (!source)
+    return;
+  let parsed;
+  try {
+    parsed = await Bun.file(source).json();
+  } catch {
+    return;
+  }
+  const servers = parsed.mcpServers;
+  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/") ? join3(projectRoot, a) : a);
+      }
+    }
+  }
+  await Bun.write(dst, JSON.stringify(parsed, null, 2) + `
+`);
+}
+var init_worktree = () => {};
+
 // node_modules/.bun/react@18.3.1/node_modules/react/cjs/react-jsx-dev-runtime.development.js
 var require_react_jsx_dev_runtime_development = __commonJS((exports) => {
   var React10 = __toESM(require_react());
@@ -59323,8 +59426,8 @@ var init_node = __esm(() => {
 });
 
 // packages/telemetry/src/index.ts
-import { homedir } from "os";
-import { join as join6 } from "path";
+import { homedir as homedir2 } from "os";
+import { join as join7 } from "path";
 import { randomUUID } from "crypto";
 function setDefaultProperties(props) {
   defaultProps = { ...defaultProps, ...props };
@@ -59332,7 +59435,7 @@ function setDefaultProperties(props) {
 async function init() {
   if (!enabled)
     return;
-  const idPath = join6(homedir(), ".ralph", ".telemetry-id");
+  const idPath = join7(homedir2(), ".ralph", ".telemetry-id");
   const idFile = Bun.file(idPath);
   if (await idFile.exists()) {
     distinctId = (await idFile.text()).trim();
@@ -59407,12 +59510,12 @@ ${fence}`;
 }
 
 // apps/cli/src/agent/config.ts
-import { join as join10 } from "path";
+import { join as join11 } from "path";
 function stripJsonComments(text) {
   return text.replace(/\/\/[^\n]*/g, "");
 }
 async function loadRalphyConfig(projectRoot) {
-  const path = join10(projectRoot, "ralphy.config.json");
+  const path = join11(projectRoot, "ralphy.config.json");
   const file = Bun.file(path);
   if (!await file.exists()) {
     return RalphyConfigSchema.parse({});
@@ -59422,7 +59525,7 @@ async function loadRalphyConfig(projectRoot) {
   return RalphyConfigSchema.parse(raw);
 }
 async function ensureRalphyConfig(projectRoot) {
-  const path = join10(projectRoot, "ralphy.config.json");
+  const path = join11(projectRoot, "ralphy.config.json");
   const file = Bun.file(path);
   if (await file.exists())
     return path;
@@ -59624,8 +59727,8 @@ var init_config = __esm(() => {
 
 // packages/log/src/log.ts
 import { appendFile } from "fs/promises";
-import { join as join11, dirname as dirname4 } from "path";
-import { homedir as homedir2 } from "os";
+import { join as join12, dirname as dirname4 } from "path";
+import { homedir as homedir3 } from "os";
 import { mkdir as mkdir2 } from "fs/promises";
 function fmt(type, text) {
   return `[${new Date().toISOString()}] [${type}] ${text}
@@ -59670,25 +59773,25 @@ async function initWorkerLog(logFile) {
 var ANSI_RE, AGENT_LOG_PATH;
 var init_log = __esm(() => {
   ANSI_RE = /\x1b(?:\[[0-9;]*[A-Za-z]|\][^\x07\x1b]*(?:\x07|\x1b\\)|.)/g;
-  AGENT_LOG_PATH = join11(homedir2(), ".ralph", "agent-mode.log");
+  AGENT_LOG_PATH = join12(homedir3(), ".ralph", "agent-mode.log");
   mkdir2(dirname4(AGENT_LOG_PATH), { recursive: true }).catch(() => {
     return;
   });
 });
 
 // packages/core/src/layout.ts
-import { join as join12 } from "path";
+import { join as join13 } from "path";
 function projectLayout(root) {
-  const statesDir = join12(root, ".ralph", "tasks");
-  const tasksDir = join12(root, "openspec", "changes");
+  const statesDir = join13(root, ".ralph", "tasks");
+  const tasksDir = join13(root, "openspec", "changes");
   return {
     root,
     statesDir,
     tasksDir,
-    agentStateFile: join12(root, ".ralph", "agent-state.json"),
-    changeDir: (name) => join12(tasksDir, name),
-    taskStateDir: (name) => join12(statesDir, name),
-    stateFile: (name) => join12(statesDir, name, STATE_FILE2)
+    agentStateFile: join13(root, ".ralph", "agent-state.json"),
+    changeDir: (name) => join13(tasksDir, name),
+    taskStateDir: (name) => join13(statesDir, name),
+    stateFile: (name) => join13(statesDir, name, STATE_FILE2)
   };
 }
 var STATE_FILE2 = ".ralph-state.json";
@@ -59743,7 +59846,15 @@ function buildIssueFilter(spec) {
         where.and = [{ state: current }, noStatus];
     }
     if (labels.length > 0) {
-      where.labels = { ...where.labels, every: { name: { nin: labels } } };
+      const includeLabels = where.labels;
+      const excludeLabels = { every: { name: { nin: labels } } };
+      if (includeLabels === undefined) {
+        where.labels = excludeLabels;
+      } else {
+        const existingAnd = where.and ?? [];
+        where.and = [...existingAnd, { labels: includeLabels }, { labels: excludeLabels }];
+        delete where.labels;
+      }
     }
   }
   return where;
@@ -60298,7 +60409,7 @@ var init_coordinator = __esm(() => {
 });
 
 // apps/cli/src/agent/scaffold.ts
-import { join as join13 } from "path";
+import { join as join14 } from "path";
 import { mkdir as mkdir3 } from "fs/promises";
 function changeNameForIssue(issue) {
   const slug = issue.title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
@@ -60306,10 +60417,10 @@ function changeNameForIssue(issue) {
 }
 async function scaffoldChangeForIssue(tasksDir, statesDir, issue, comments = [], appendPrompt = "") {
   const name = changeNameForIssue(issue);
-  const changeDir = join13(tasksDir, name);
-  const stateDir = join13(statesDir, name);
+  const changeDir = join14(tasksDir, name);
+  const stateDir = join14(statesDir, name);
   await mkdir3(changeDir, { recursive: true });
-  await mkdir3(join13(changeDir, "specs"), { recursive: true });
+  await mkdir3(join14(changeDir, "specs"), { recursive: true });
   await mkdir3(stateDir, { recursive: true });
   const commentsBlock = comments.length > 0 ? [
     "",
@@ -60361,106 +60472,13 @@ async function scaffoldChangeForIssue(tasksDir, statesDir, issue, comments = [],
     ""
   ].join(`
 `);
-  await Bun.write(join13(changeDir, "proposal.md"), proposal);
-  await Bun.write(join13(changeDir, "tasks.md"), tasks);
-  await Bun.write(join13(changeDir, "design.md"), design);
+  await Bun.write(join14(changeDir, "proposal.md"), proposal);
+  await Bun.write(join14(changeDir, "tasks.md"), tasks);
+  await Bun.write(join14(changeDir, "design.md"), design);
   return name;
 }
 var init_scaffold = () => {};
 
-// apps/cli/src/agent/worktree.ts
-import { basename, join as join14 } from "path";
-import { homedir as homedir3 } from "os";
-import { exists } from "fs/promises";
-function worktreesDir(projectRoot) {
-  return join14(homedir3(), ".ralph", basename(projectRoot), "worktrees");
-}
-function branchForChange(changeName) {
-  return `ralph/${changeName}`;
-}
-async function createWorktree(projectRoot, changeName, runner) {
-  const dir = worktreesDir(projectRoot);
-  const cwd2 = join14(dir, changeName);
-  const branch = branchForChange(changeName);
-  const list = await runner.run(["worktree", "list", "--porcelain"], projectRoot);
-  if (list.stdout.includes(`worktree ${cwd2}
-`)) {
-    return { cwd: cwd2, branch };
-  }
-  let branchExists = true;
-  try {
-    await runner.run(["rev-parse", "--verify", "--quiet", `refs/heads/${branch}`], projectRoot);
-  } catch {
-    branchExists = false;
-  }
-  const cmd = branchExists ? ["worktree", "add", cwd2, branch] : ["worktree", "add", "-b", branch, cwd2];
-  await runner.run(cmd, projectRoot);
-  return { cwd: cwd2, branch };
-}
-async function removeWorktree(projectRoot, cwd2, runner) {
-  await runner.run(["worktree", "remove", "--force", cwd2], projectRoot);
-}
-async function isWorktreeSafeToRemove(cwd2, base2, runner) {
-  const status = await runner.run(["status", "--porcelain"], cwd2);
-  const dirty = status.stdout.trim();
-  let unpushedCommits = "";
-  try {
-    const log2 = await runner.run(["log", "--oneline", `${base2}..HEAD`, "--no-merges"], cwd2);
-    unpushedCommits = log2.stdout.trim();
-  } catch {
-    unpushedCommits = "<unknown: failed to compare against base>";
-  }
-  if (dirty && unpushedCommits) {
-    return {
-      safe: false,
-      reason: "uncommitted changes AND unpushed commits present",
-      dirty,
-      unpushedCommits
-    };
-  }
-  if (dirty) {
-    return {
-      safe: false,
-      reason: "uncommitted or untracked files present",
-      dirty,
-      unpushedCommits
-    };
-  }
-  if (unpushedCommits) {
-    return {
-      safe: false,
-      reason: `commits ahead of ${base2} were not pushed/PR'd`,
-      dirty,
-      unpushedCommits
-    };
-  }
-  return { safe: true, dirty, unpushedCommits };
-}
-async function seedWorktreeMcpConfig(projectRoot, worktreeCwd) {
-  const dst = join14(worktreeCwd, ".mcp.json");
-  const src = join14(projectRoot, ".mcp.json");
-  const source = await exists(dst) ? dst : await exists(src) ? src : null;
-  if (!source)
-    return;
-  let parsed;
-  try {
-    parsed = await Bun.file(source).json();
-  } catch {
-    return;
-  }
-  const servers = parsed.mcpServers;
-  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/") ? join14(projectRoot, a) : a);
-      }
-    }
-  }
-  await Bun.write(dst, JSON.stringify(parsed, null, 2) + `
-`);
-}
-var init_worktree = () => {};
-
 // apps/cli/src/agent/pr.ts
 function defaultTitle(issue) {
   return `${issue.identifier}: ${issue.title}`;
@@ -66953,7 +66971,8 @@ function ensureState(changeDir) {
 
 // apps/cli/src/components/TaskList.tsx
 var import_react22 = __toESM(require_react(), 1);
-import { join as join3 } from "path";
+import { join as join4 } from "path";
+init_worktree();
 var jsx_dev_runtime = __toESM(require_jsx_dev_runtime(), 1);
 function countTaskItems(content) {
   const checked = (content.match(/^- \[x\]/gm) ?? []).length;
@@ -66966,10 +66985,10 @@ function buildRows(statesDir, projectRoot) {
   const seenNames = new Set;
   const sources = [{ dir: statesDir, label: "main" }];
   if (projectRoot) {
-    const worktreesRoot = join3(projectRoot, ".ralph", "worktrees");
+    const worktreesRoot = worktreesDir(projectRoot);
     for (const wt of storage.list(worktreesRoot)) {
       sources.push({
-        dir: join3(worktreesRoot, wt, ".ralph", "tasks"),
+        dir: join4(worktreesRoot, wt, ".ralph", "tasks"),
         label: `wt:${wt}`
       });
     }
@@ -66978,7 +66997,7 @@ function buildRows(statesDir, projectRoot) {
     for (const entry of storage.list(dir)) {
       if (seenNames.has(entry))
         continue;
-      const raw = storage.read(join3(dir, entry, ".ralph-state.json"));
+      const raw = storage.read(join4(dir, entry, ".ralph-state.json"));
       if (raw === null)
         continue;
       let state;
@@ -66994,7 +67013,7 @@ function buildRows(statesDir, projectRoot) {
 `).find((l) => l.trim() !== "") ?? "";
       let progress = "\u2014";
       let progressStyled = true;
-      const tasksContent = storage.read(join3(dir, entry, "tasks.md"));
+      const tasksContent = storage.read(join4(dir, entry, "tasks.md"));
       if (tasksContent !== null) {
         const { checked, unchecked } = countTaskItems(tasksContent);
         const total = checked + unchecked;
@@ -67135,7 +67154,7 @@ function TaskList({ statesDir, projectRoot }) {
 }
 
 // apps/cli/src/components/TaskStatus.tsx
-import { join as join4 } from "path";
+import { join as join5 } from "path";
 var jsx_dev_runtime2 = __toESM(require_jsx_dev_runtime(), 1);
 var HEAVY_RULE = "============================================";
 var LIGHT_RULE = "--------------------------------------------";
@@ -67146,7 +67165,7 @@ function TaskStatus({ state, stateDir }) {
   const time = Math.round(state.usage.total_duration_ms / 1000 * 10) / 10 + "s";
   const artifacts = OPENSPEC_ARTIFACTS.map((name) => ({
     name,
-    exists: storage.read(join4(stateDir, name)) !== null
+    exists: storage.read(join5(stateDir, name)) !== null
   }));
   const recent = state.history.slice(-10);
   return /* @__PURE__ */ jsx_dev_runtime2.jsxDEV(Box_default, {
@@ -67289,7 +67308,7 @@ function TaskStatus({ state, stateDir }) {
 
 // apps/cli/src/components/TaskLoop.tsx
 var import_react56 = __toESM(require_react(), 1);
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 
 // node_modules/.bun/@inkjs+ui@2.0.0+5b84dde3d6cd3930/node_modules/@inkjs/ui/build/components/badge/badge.js
 var import_react24 = __toESM(require_react(), 1);
@@ -70853,7 +70872,7 @@ function StopMessage({
 
 // apps/cli/src/hooks/useLoop.ts
 var import_react55 = __toESM(require_react(), 1);
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 
 // packages/engine/src/spawn.ts
 var {spawn: bunSpawn } = globalThis.Bun;
@@ -70863,7 +70882,7 @@ var spawn = bunSpawn;
 import { createWriteStream } from "fs";
 import { mkdtemp, unlink, mkdir } from "fs/promises";
 import { dirname as dirname2 } from "path";
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 import { tmpdir } from "os";
 
 // packages/engine/src/feed-events.ts
@@ -71596,7 +71615,7 @@ function buildCodexArgs() {
   return ["exec", "--json", "--color", "never", "--dangerously-bypass-approvals-and-sandbox", "-"];
 }
 async function runInteractive(model, prompt, taskDir) {
-  const promptFile = taskDir ? join5(taskDir, "_interactive_prompt.md") : join5(await mkdtemp(join5(tmpdir(), "ralph-")), "prompt.md");
+  const promptFile = taskDir ? join6(taskDir, "_interactive_prompt.md") : join6(await mkdtemp(join6(tmpdir(), "ralph-")), "prompt.md");
   await Bun.write(promptFile, prompt);
   try {
     const cmd = [
@@ -71622,7 +71641,7 @@ async function runInteractive(model, prompt, taskDir) {
       stderr: "inherit"
     });
     const exitCode = await proc.exited;
-    const doneFile = taskDir ? join5(taskDir, "_interactive_done") : null;
+    const doneFile = taskDir ? join6(taskDir, "_interactive_done") : null;
     if (doneFile && await Bun.file(doneFile).exists()) {
       return { exitCode: 0, usage: null, sessionId: null, rateLimited: false };
     }
@@ -71839,12 +71858,12 @@ function commitTaskDir(taskDir, message) {
 init_src();
 
 // packages/core/src/loop.ts
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 var STEERING_MAX_LINES = 20;
 function buildTaskPrompt(state, taskDir) {
   const storage = getStorage();
   let prompt = "";
-  const steeringContent = storage.read(join7(taskDir, "steering.md"));
+  const steeringContent = storage.read(join8(taskDir, "steering.md"));
   if (steeringContent !== null) {
     const steeringLines = steeringContent.split(`
 `).filter((line) => !line.startsWith("#")).filter((line) => line.trim()).slice(0, STEERING_MAX_LINES);
@@ -71863,7 +71882,7 @@ function buildTaskPrompt(state, taskDir) {
 `;
     }
   }
-  const tasksContent = storage.read(join7(taskDir, "tasks.md"));
+  const tasksContent = storage.read(join8(taskDir, "tasks.md"));
   if (tasksContent !== null) {
     const section = firstUnchecked(tasksContent);
     if (section) {
@@ -71878,7 +71897,7 @@ function buildTaskPrompt(state, taskDir) {
       prompt += `---
 
 `;
-      prompt += `**Tracking progress**: as you finish each item above, edit ` + `\`${join7(taskDir, "tasks.md")}\` and change its \`- [ ]\` to ` + `\`- [x]\` in the same commit. The loop reads this file between ` + `iterations and stops when no \`- [ ]\` items remain \u2014 if you do ` + `not tick the box, the next iteration will repeat this task.
+      prompt += `**Tracking progress**: as you finish each item above, edit ` + `\`${join8(taskDir, "tasks.md")}\` and change its \`- [ ]\` to ` + `\`- [x]\` in the same commit. The loop reads this file between ` + `iterations and stops when no \`- [ ]\` items remain \u2014 if you do ` + `not tick the box, the next iteration will repeat this task.
 
 `;
     }
@@ -71899,7 +71918,7 @@ function buildTaskPrompt(state, taskDir) {
 `;
   }
   if (state.manualTest) {
-    const tasksContent2 = storage.read(join7(taskDir, "tasks.md"));
+    const tasksContent2 = storage.read(join8(taskDir, "tasks.md"));
     const hasUncheckedTasks = tasksContent2 !== null && /^- \[ \]/m.test(tasksContent2);
     if (!hasUncheckedTasks) {
       const hasManualTestSection = tasksContent2 !== null && /^## Manual Testing/m.test(tasksContent2);
@@ -71948,7 +71967,7 @@ When all tasks are complete and all files are committed, push your branch and op
 }
 function checkStopSignal(taskDir, stateDir) {
   const storage = getStorage();
-  const stopFile = join7(taskDir, "STOP");
+  const stopFile = join8(taskDir, "STOP");
   const reason = storage.read(stopFile);
   if (reason === null)
     return null;
@@ -72023,7 +72042,7 @@ function updateStateIteration(stateDir, result2, startedAt, engine, model, usage
 }
 function appendSteeringMessage(taskDir, message) {
   const storage = getStorage();
-  const steeringPath = join7(taskDir, "steering.md");
+  const steeringPath = join8(taskDir, "steering.md");
   const existing = storage.read(steeringPath);
   const updated = existing ? `${message}
 
@@ -72090,11 +72109,11 @@ function useLoop(opts) {
       setLogLines((prev) => [...prev, { id: nextId(), kind: "feed", event }]);
     };
     runWithContext(createDefaultContext(), async () => {
-      const stateDir = join8(opts.statesDir, opts.name);
-      const tasksDir = join8(opts.tasksDir, opts.name);
+      const stateDir = join9(opts.statesDir, opts.name);
+      const tasksDir = join9(opts.tasksDir, opts.name);
       const storage = getStorage();
       let currentState;
-      const existingStateRaw = storage.read(join8(stateDir, ".ralph-state.json"));
+      const existingStateRaw = storage.read(join9(stateDir, ".ralph-state.json"));
       if (existingStateRaw !== null) {
         currentState = readState(stateDir);
         if (currentState.engine !== opts.engine || currentState.model !== opts.model) {
@@ -72141,7 +72160,7 @@ function useLoop(opts) {
           setStopReason(stop);
           break;
         }
-        const tasksContent = storage.read(join8(tasksDir, "tasks.md"));
+        const tasksContent = storage.read(join9(tasksDir, "tasks.md"));
         if (tasksContent !== null) {
           const remaining = countUnchecked(tasksContent);
           addInfo(`tasks.md: ${remaining} unchecked item${remaining === 1 ? "" : "s"} remaining`);
@@ -72181,7 +72200,7 @@ function useLoop(opts) {
             model: opts.model,
             prompt,
             logFlag: opts.log,
-            logFile: join8(stateDir, "log.json"),
+            logFile: join9(stateDir, "log.json"),
             taskDir: tasksDir,
             interactive: false,
             onFeedEvent: addFeedEvent,
@@ -72204,7 +72223,7 @@ function useLoop(opts) {
               model: opts.model,
               prompt: buildSteeringPrompt(steerMessage),
               logFlag: opts.log,
-              logFile: join8(stateDir, "log.json"),
+              logFile: join9(stateDir, "log.json"),
               taskDir: tasksDir,
               onFeedEvent: addResumeFeedEvent,
               signal: resumeController.signal,
@@ -72399,7 +72418,7 @@ function TaskLoop({ opts }) {
   }, [loop.isRunning, exit]);
   if (!loop.state)
     return null;
-  const stateDir = join9(opts.statesDir, opts.name);
+  const stateDir = join10(opts.statesDir, opts.name);
   return /* @__PURE__ */ jsx_dev_runtime8.jsxDEV(Box_default, {
     flexDirection: "column",
     children: [
@@ -73753,8 +73772,11 @@ init_worktree();
 // apps/cli/src/debug.ts
 init_log();
 import { join as join20 } from "path";
+function fmtTs(d) {
+  return d.toISOString().replace("T", " ").slice(0, 23);
+}
 var LOG_LINE_RE = /^\[(.+?)\] \[(.+?)\] (.+)$/;
-function parseLog(content) {
+function parseTextLog(content) {
   return content.split(`
 `).filter(Boolean).flatMap((line) => {
     const m = LOG_LINE_RE.exec(line);
@@ -73766,23 +73788,154 @@ function parseLog(content) {
     return [{ ts, type: m[2], text: m[3] }];
   });
 }
-function fmtTs(d) {
-  return d.toISOString().replace("T", " ").slice(0, 23);
+function parseJsonlLog(content, filterChangeName) {
+  return content.split(`
+`).filter(Boolean).flatMap((line) => {
+    let entry;
+    try {
+      entry = JSON.parse(line);
+    } catch {
+      return [];
+    }
+    const ts = new Date(entry.ts);
+    if (isNaN(ts.getTime()))
+      return [];
+    if (filterChangeName && entry.changeName && entry.changeName !== filterChangeName) {
+      return [];
+    }
+    const cn = entry.changeName ?? "";
+    switch (entry.type) {
+      case "started":
+        return [{ ts, type: "agent", text: `agent started v${entry.version ?? "?"}` }];
+      case "stopped":
+        return [{ ts, type: "agent", text: "agent stopped" }];
+      case "worker_started":
+        return [{ ts, type: "spawn", text: `${cn}: worker spawned` }];
+      case "worker_phase": {
+        const detail = entry.detail ? ` (${entry.detail})` : "";
+        return [{ ts, type: "phase", text: `${cn}: ${entry.phase}${detail}` }];
+      }
+      case "worker_cmd_start":
+        return [
+          {
+            ts,
+            type: "cmd",
+            text: `${cn}: \u2192 ${(entry.cmd ?? []).slice(0, 4).join(" ")}`
+          }
+        ];
+      case "worker_cmd_end":
+        return [
+          {
+            ts,
+            type: "cmd",
+            text: `${cn}: \u2190 ${(entry.cmd ?? []).slice(0, 2).join(" ")} (${entry.durationMs}ms, ${entry.ok ? "ok" : "err"})`
+          }
+        ];
+      case "worker_pr":
+        return [{ ts, type: "pr", text: `${cn}: PR \u2192 ${entry.prUrl}` }];
+      case "worker_exited":
+        return [
+          {
+            ts,
+            type: "exit",
+            text: `${cn}: exited (code ${entry.exitCode ?? "?"})`
+          }
+        ];
+      case "log":
+        return [{ ts, type: "coord", text: entry.text ?? "" }];
+      case "poll_done":
+        return [
+          {
+            ts,
+            type: "poll",
+            text: `poll: found=${entry.found} added=${entry.added}`
+          }
+        ];
+      default:
+        return [];
+    }
+  });
+}
+function detectStuck(lines) {
+  if (lines.length < 10)
+    return null;
+  const recent = lines.slice(-20).filter((l) => l.type === "phase");
+  if (recent.length < 5)
+    return null;
+  const phaseNames = recent.map((l) => l.text.split(": ").slice(1).join(": "));
+  const unique = new Set(phaseNames);
+  if (unique.size !== 1)
+    return null;
+  const phase = phaseNames[0];
+  const all = lines.filter((l) => l.type === "phase" && l.text.includes(phase));
+  const first = all[0];
+  const last2 = all[all.length - 1];
+  const minutesStuck = (last2.ts.getTime() - first.ts.getTime()) / 60000;
+  const prEntry = lines.find((l) => l.type === "pr");
+  const cmdEntry = lines.find((l) => l.type === "cmd" && l.text.includes("gh") && l.text.includes("mergeable"));
+  const watchingPrUrl = prEntry?.text.split("PR \u2192 ")[1] ?? cmdEntry?.text.match(/https:\/\/github\.com\/[^\s)]+/)?.[0];
+  return {
+    phase,
+    count: all.length,
+    firstSeen: first.ts,
+    lastSeen: last2.ts,
+    minutesStuck,
+    watchingPrUrl
+  };
+}
+async function inspectBinary(projectRoot) {
+  const binPath = join20(projectRoot, ".ralph", "bin", "cli.js");
+  const file = Bun.file(binPath);
+  if (!await file.exists())
+    return null;
+  let embeddedVersion;
+  try {
+    const slice2 = await file.slice(0, 50000).text();
+    const m = /"(\d+\.\d+\.\d+)"/.exec(slice2);
+    if (m)
+      embeddedVersion = m[1];
+  } catch {}
+  let builtAt;
+  try {
+    const r = Bun.spawnSync(["stat", "-f", "%Sm", "-t", "%Y-%m-%dT%H:%M:%S", binPath], {
+      stderr: "ignore"
+    });
+    const s = r.stdout.toString().trim();
+    if (s)
+      builtAt = new Date(s);
+  } catch {}
+  return { path: binPath, embeddedVersion, builtAt };
 }
 var SPAWN_RE = /\u25B6 (\S+) \u2192 (\S+)/;
-async function resolveDebugTarget(opts) {
+async function resolveDebugTarget(projectRoot, opts) {
   const agentLogFile = Bun.file(AGENT_LOG_PATH);
-  const agentLines = await agentLogFile.exists() ? parseLog(await agentLogFile.text()) : [];
+  const textLines = await agentLogFile.exists() ? parseTextLog(await agentLogFile.text()) : [];
+  const jsonlLogFile = Bun.file(join20(projectRoot, ".ralph", "agent.log"));
+  const jsonlLines = await jsonlLogFile.exists() ? parseJsonlLog(await jsonlLogFile.text()) : [];
+  const allLines = [...textLines, ...jsonlLines];
   if (opts.name && !opts.issue) {
-    for (const line of agentLines) {
+    for (const line of allLines) {
       const m = SPAWN_RE.exec(line.text);
       if (m && m[2] === opts.name)
         return { changeName: opts.name, identifier: m[1] };
     }
+    for (const line of allLines) {
+      if (line.text.includes(opts.name) && line.text.includes("COD-")) {
+        const id = /COD-\d+/.exec(line.text)?.[0];
+        if (id)
+          return { changeName: opts.name, identifier: id };
+      }
+    }
     return { changeName: opts.name, identifier: undefined };
   }
   if (opts.issue && !opts.name) {
-    for (const line of agentLines) {
+    const pattern = new RegExp(`(cod-${opts.issue.toLowerCase().replace("cod-", "")}[\\w-]+)`);
+    for (const line of allLines) {
+      const m = pattern.exec(line.text);
+      if (m)
+        return { changeName: m[1], identifier: opts.issue };
+    }
+    for (const line of allLines) {
       const m = SPAWN_RE.exec(line.text);
       if (m && m[1] === opts.issue)
         return { changeName: m[2], identifier: opts.issue };
@@ -73852,34 +74005,33 @@ async function fetchGithubPr(changeName) {
   ]) ?? [];
   return { ...pr, checks };
 }
+function fetchMergeableNow(prUrl) {
+  const result2 = Bun.spawnSync(["gh", "pr", "view", prUrl, "--json", "mergeable", "--jq", ".mergeable"], { stderr: "ignore" });
+  return result2.exitCode === 0 ? result2.stdout.toString().trim() : null;
+}
 async function runDebug(opts) {
   const { projectRoot } = opts;
+  const out = (s) => process.stdout.write(s + `
+`);
   const agentLogFile = Bun.file(AGENT_LOG_PATH);
-  const agentLogContent = await agentLogFile.exists() ? await agentLogFile.text() : "";
-  const agentLines = parseLog(agentLogContent);
-  let { changeName, identifier: issueIdentifier } = await resolveDebugTarget({
+  const textLines = await agentLogFile.exists() ? parseTextLog(await agentLogFile.text()) : [];
+  const jsonlLogPath = join20(projectRoot, ".ralph", "agent.log");
+  const jsonlLogFile = Bun.file(jsonlLogPath);
+  const hasJsonlLog = await jsonlLogFile.exists();
+  let { changeName, identifier: issueIdentifier } = await resolveDebugTarget(projectRoot, {
     ...opts.name !== undefined ? { name: opts.name } : {},
     ...opts.issue !== undefined ? { issue: opts.issue } : {}
   });
   if (!changeName) {
-    process.stderr.write(`! Could not resolve a change name for ${opts.issue ?? opts.name}. Has this issue been started?
+    process.stderr.write(`! Could not resolve change name for ${opts.issue ?? opts.name}.
 `);
     process.exit(1);
   }
-  const relevant = agentLines.filter((l) => l.text.includes(changeName) || issueIdentifier !== undefined && l.text.includes(issueIdentifier));
-  if (!issueIdentifier) {
-    for (const line of relevant) {
-      const m = SPAWN_RE.exec(line.text);
-      if (m && m[2] === changeName) {
-        issueIdentifier = m[1];
-        break;
-      }
-    }
-  }
-  const workerLogPath = join20(projectRoot, ".ralph", "logs", `${changeName}.log`);
-  const workerLogFile = Bun.file(workerLogPath);
-  const workerLines = await workerLogFile.exists() ? parseLog(await workerLogFile.text()) : [];
-  const merged = [...relevant, ...workerLines].sort((a, b) => +a.ts - +b.ts);
+  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 workerLines = await workerLogFile.exists() ? parseTextLog(await workerLogFile.text()) : [];
+  const merged = [...relevantText, ...jsonlLines, ...workerLines].sort((a, b) => +a.ts - +b.ts);
   const seen = new Set;
   const timeline = merged.filter((l) => {
     const key = `${l.ts.getTime()}:${l.type}:${l.text}`;
@@ -73888,8 +74040,24 @@ async function runDebug(opts) {
     seen.add(key);
     return true;
   });
-  const out = (s) => process.stdout.write(s + `
-`);
+  if (!issueIdentifier) {
+    for (const line of timeline) {
+      const m = SPAWN_RE.exec(line.text);
+      if (m && m[2] === changeName) {
+        issueIdentifier = m[1];
+        break;
+      }
+      if (line.text.includes(changeName)) {
+        const id = /(COD|ENG|DEV)-\d+/.exec(line.text)?.[0];
+        if (id) {
+          issueIdentifier = id;
+          break;
+        }
+      }
+    }
+  }
+  const stuck = detectStuck(timeline);
+  const binary = await inspectBinary(projectRoot);
   out(`
 === Ralph Debug: ${changeName}${issueIdentifier ? ` (${issueIdentifier})` : ""} ===
 `);
@@ -73897,12 +74065,30 @@ async function runDebug(opts) {
   if (!timeline.length) {
     out("  (no log entries found)");
   } else {
-    for (const line of timeline) {
-      const prefix = line.type === "output" ? "  \u2502" : "  \xB7";
-      out(`${prefix} ${fmtTs(line.ts)}  [${line.type.padEnd(7)}]  ${line.text}`);
+    if (stuck && timeline.length > 20) {
+      const phaseLines = timeline.filter((l) => l.type === "phase" && l.text.includes(stuck.phase));
+      const nonPhase = timeline.filter((l) => !(l.type === "phase" && l.text.includes(stuck.phase)));
+      for (const line of nonPhase) {
+        const prefix = line.type === "output" ? "  \u2502" : "  \xB7";
+        out(`${prefix} ${fmtTs(line.ts)}  [${line.type.padEnd(7)}]  ${line.text}`);
+      }
+      out(`  \u21BA ... ${phaseLines.length}\xD7 ${stuck.phase} (${stuck.minutesStuck.toFixed(1)} min) ...`);
+    } else {
+      for (const line of timeline) {
+        const prefix = line.type === "output" ? "  \u2502" : "  \xB7";
+        out(`${prefix} ${fmtTs(line.ts)}  [${line.type.padEnd(7)}]  ${line.text}`);
+      }
     }
   }
   out("");
+  if (binary) {
+    out("\u2500\u2500 Installed binary \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
+    out(`  Path             : ${binary.path}`);
+    out(`  Embedded version : ${binary.embeddedVersion ?? "(unknown)"}`);
+    if (binary.builtAt)
+      out(`  Built at         : ${fmtTs(binary.builtAt)}`);
+    out("");
+  }
   out("\u2500\u2500 Current Linear state \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
   if (!issueIdentifier) {
     out("  (unknown identifier \u2014 pass --issue to query Linear directly)");
@@ -73924,7 +74110,13 @@ async function runDebug(opts) {
   out("\u2500\u2500 Current GitHub PR \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
   const pr = await fetchGithubPr(changeName);
   if (!pr) {
-    out(`  (no PR found for branch ralph/${changeName})`);
+    if (stuck?.watchingPrUrl) {
+      const m = fetchMergeableNow(stuck.watchingPrUrl);
+      out(`  Watching : ${stuck.watchingPrUrl}`);
+      out(`  Mergeable: ${m ?? "(error fetching)"}`);
+    } else {
+      out(`  (no PR found for branch ralph/${changeName})`);
+    }
   } else {
     const failing = pr.checks.filter((c) => c.conclusion === "FAILURE" || c.conclusion === "failure");
     const pending = pr.checks.filter((c) => c.state === "PENDING" || c.state === "IN_PROGRESS");
@@ -73946,32 +74138,58 @@ async function runDebug(opts) {
   const lastEvent = timeline.at(-1);
   if (lastEvent)
     out(`  Last event : ${fmtTs(lastEvent.ts)}  ${lastEvent.text}`);
-  const exitLine = relevant.find((l) => /exited \(code \d+\)/.test(l.text));
+  const exitLine = timeline.find((l) => /exited \(code \d+\)/.test(l.text));
   if (exitLine) {
     const code = Number(/code (\d+)/.exec(exitLine.text)?.[1]);
-    const meaning = code === 0 ? "success" : code === 70 ? "CI fix loop exhausted its attempt budget" : code === 71 ? "push or PR creation failed (pre-push hook or remote rejection)" : "worker subprocess failed";
+    const meaning = code === 0 ? "success" : code === 70 ? "CI fix loop exhausted its attempt budget" : code === 71 ? "push or PR creation failed" : "worker subprocess failed";
     out(`  Exit code  : ${code} \u2014 ${meaning}`);
   }
-  const logHas = (s) => relevant.some((l) => l.text.includes(s));
+  if (stuck) {
+    out(`  \u26A0 STUCK in ${stuck.phase} \u2014 ${stuck.count} iterations over ${stuck.minutesStuck.toFixed(1)} min`);
+    if (stuck.watchingPrUrl) {
+      const mergeable = fetchMergeableNow(stuck.watchingPrUrl);
+      out(`    Watching  : ${stuck.watchingPrUrl}`);
+      out(`    Mergeable : ${mergeable ?? "(error)"} (live fetch)`);
+      if (mergeable === "MERGEABLE") {
+        out(`    \u2192 PR is MERGEABLE \u2014 loop should have exited. Likely cause:`);
+        if (binary?.embeddedVersion && binary.embeddedVersion < "2.17.1") {
+          out(`      Local binary is v${binary.embeddedVersion} (fix shipped in v2.17.1). Update with:`);
+          out(`      cd ${projectRoot} && bunx @neriros/ralphy@latest make-install`);
+        } else {
+          out(`      This is the conflict-check infinite loop bug (fixed in v2.17.1).`);
+          out(`      Restart the agent after updating to v2.17.1.`);
+        }
+      }
+    }
+  }
+  if (binary) {
+    const embV = binary.embeddedVersion ?? "?";
+    const logV = timeline.find((l) => l.text.includes("agent started"))?.text.match(/v([\d.]+)/)?.[1];
+    if (logV && embV !== logV) {
+      out(`  \u26A0 Version mismatch: binary says v${embV}, agent reported v${logV}`);
+      out(`    The binary reads version from a package.json at runtime \u2014 the actual`);
+      out(`    running code is v${embV}, not v${logV}. Update the local install.`);
+    }
+  }
+  const logHas = (s) => timeline.some((l) => l.text.includes(s));
   if (logHas("setError applied"))
     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("clearConflicted applied"))
-    out("  \u2713 clearConflicted applied \u2014 conflicts resolved");
+    out("  \u2713 clearConflicted applied");
   if (logHas("setConflicted applied"))
     out("  \u26A0 setConflicted applied \u2014 merge conflicts detected");
   if (logHas("skipping PR phase"))
     out("  \u21A9 PR phase skipped \u2014 worker exited non-zero");
   if (pr?.mergeable === "CONFLICTING")
     out("  \u26A0 PR currently has merge conflicts");
-  if (pr?.checks.some((c) => c.conclusion === "FAILURE" || c.conclusion === "failure")) {
+  if (pr?.checks.some((c) => c.conclusion === "FAILURE"))
     out("  \u26A0 PR has failing CI checks");
-  }
   const worktreePath = join20(projectRoot, ".ralph", "worktrees", changeName);
-  const worktreeExists = await Bun.file(join20(worktreePath, ".git")).exists();
-  if (worktreeExists)
+  if (await Bun.file(join20(worktreePath, ".git")).exists()) {
     out(`  Worktree   : ${worktreePath}`);
+  }
   if (!timeline.length)
     out("  (no log entries \u2014 has this change been started yet?)");
   out("");
@@ -74041,7 +74259,7 @@ try {
 `);
       process.exit(1);
     }
-    await runDebug({ name: args.name, projectRoot });
+    await runDebug({ name: args.name, projectRoot: args.projectRoot ?? projectRoot });
     await shutdown();
     process.exit(0);
   }

package/dist/mcp/index.js

@@ -3047,10 +3047,13 @@ var require_data = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/.bun/fast-uri@3.1.0/node_modules/fast-uri/lib/utils.js
+// node_modules/.bun/fast-uri@3.1.2/node_modules/fast-uri/lib/utils.js
 var require_utils = __commonJS((exports, module) => {
   var isUUID = RegExp.prototype.test.bind(/^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/iu);
   var isIPv4 = RegExp.prototype.test.bind(/^(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)$/u);
+  var isHexPair = RegExp.prototype.test.bind(/^[\da-f]{2}$/iu);
+  var isUnreserved = RegExp.prototype.test.bind(/^[\da-z\-._~]$/iu);
+  var isPathCharacter = RegExp.prototype.test.bind(/^[\da-z\-._~!$&'()*+,;=:@/]$/iu);
   function stringArrayToHexStripped(input) {
     let acc = "";
     let code = 0;
@@ -3244,27 +3247,77 @@ var require_utils = __commonJS((exports, module) => {
     }
     return output.join("");
   }
-  function normalizeComponentEncoding(component, esc2) {
-    const func = esc2 !== true ? escape : unescape;
-    if (component.scheme !== undefined) {
-      component.scheme = func(component.scheme);
-    }
-    if (component.userinfo !== undefined) {
-      component.userinfo = func(component.userinfo);
-    }
-    if (component.host !== undefined) {
-      component.host = func(component.host);
+  var HOST_DELIMS = { "@": "%40", "/": "%2F", "?": "%3F", "#": "%23", ":": "%3A" };
+  var HOST_DELIM_RE = /[@/?#:]/g;
+  var HOST_DELIM_NO_COLON_RE = /[@/?#]/g;
+  function reescapeHostDelimiters(host, isIP) {
+    const re = isIP ? HOST_DELIM_NO_COLON_RE : HOST_DELIM_RE;
+    re.lastIndex = 0;
+    return host.replace(re, (ch) => HOST_DELIMS[ch]);
+  }
+  function normalizePercentEncoding(input, decodeUnreserved = false) {
+    if (input.indexOf("%") === -1) {
+      return input;
     }
-    if (component.path !== undefined) {
-      component.path = func(component.path);
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      if (input[i] === "%" && i + 2 < input.length) {
+        const hex = input.slice(i + 1, i + 3);
+        if (isHexPair(hex)) {
+          const normalizedHex = hex.toUpperCase();
+          const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+          if (decodeUnreserved && isUnreserved(decoded)) {
+            output += decoded;
+          } else {
+            output += "%" + normalizedHex;
+          }
+          i += 2;
+          continue;
+        }
+      }
+      output += input[i];
     }
-    if (component.query !== undefined) {
-      component.query = func(component.query);
+    return output;
+  }
+  function normalizePathEncoding(input) {
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      if (input[i] === "%" && i + 2 < input.length) {
+        const hex = input.slice(i + 1, i + 3);
+        if (isHexPair(hex)) {
+          const normalizedHex = hex.toUpperCase();
+          const decoded = String.fromCharCode(parseInt(normalizedHex, 16));
+          if (decoded !== "." && isUnreserved(decoded)) {
+            output += decoded;
+          } else {
+            output += "%" + normalizedHex;
+          }
+          i += 2;
+          continue;
+        }
+      }
+      if (isPathCharacter(input[i])) {
+        output += input[i];
+      } else {
+        output += escape(input[i]);
+      }
     }
-    if (component.fragment !== undefined) {
-      component.fragment = func(component.fragment);
+    return output;
+  }
+  function escapePreservingEscapes(input) {
+    let output = "";
+    for (let i = 0;i < input.length; i++) {
+      if (input[i] === "%" && i + 2 < input.length) {
+        const hex = input.slice(i + 1, i + 3);
+        if (isHexPair(hex)) {
+          output += "%" + hex.toUpperCase();
+          i += 2;
+          continue;
+        }
+      }
+      output += escape(input[i]);
     }
-    return component;
+    return output;
   }
   function recomposeAuthority(component) {
     const uriTokens = [];
@@ -3279,7 +3332,7 @@ var require_utils = __commonJS((exports, module) => {
         if (ipV6res.isIPV6 === true) {
           host = `[${ipV6res.escapedHost}]`;
         } else {
-          host = component.host;
+          host = reescapeHostDelimiters(host, false);
         }
       }
       uriTokens.push(host);
@@ -3293,7 +3346,10 @@ var require_utils = __commonJS((exports, module) => {
   module.exports = {
     nonSimpleDomain,
     recomposeAuthority,
-    normalizeComponentEncoding,
+    reescapeHostDelimiters,
+    normalizePercentEncoding,
+    normalizePathEncoding,
+    escapePreservingEscapes,
     removeDotSegments,
     isIPv4,
     isUUID,
@@ -3302,7 +3358,7 @@ var require_utils = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/.bun/fast-uri@3.1.0/node_modules/fast-uri/lib/schemes.js
+// node_modules/.bun/fast-uri@3.1.2/node_modules/fast-uri/lib/schemes.js
 var require_schemes = __commonJS((exports, module) => {
   var { isUUID } = require_utils();
   var URN_REG = /([\da-z][\d\-a-z]{0,31}):((?:[\w!$'()*+,\-.:;=@]|%[\da-f]{2})+)/iu;
@@ -3476,13 +3532,13 @@ var require_schemes = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/.bun/fast-uri@3.1.0/node_modules/fast-uri/index.js
+// node_modules/.bun/fast-uri@3.1.2/node_modules/fast-uri/index.js
 var require_fast_uri = __commonJS((exports, module) => {
-  var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizeComponentEncoding, isIPv4, nonSimpleDomain } = require_utils();
+  var { normalizeIPv6, removeDotSegments, recomposeAuthority, normalizePercentEncoding, normalizePathEncoding, escapePreservingEscapes, reescapeHostDelimiters, isIPv4, nonSimpleDomain } = require_utils();
   var { SCHEMES, getSchemeHandler } = require_schemes();
   function normalize(uri, options) {
     if (typeof uri === "string") {
-      uri = serialize(parse6(uri, options), options);
+      uri = normalizeString(uri, options);
     } else if (typeof uri === "object") {
       uri = parse6(serialize(uri, options), options);
     }
@@ -3548,19 +3604,9 @@ var require_fast_uri = __commonJS((exports, module) => {
     return target;
   }
   function equal(uriA, uriB, options) {
-    if (typeof uriA === "string") {
-      uriA = unescape(uriA);
-      uriA = serialize(normalizeComponentEncoding(parse6(uriA, options), true), { ...options, skipEscape: true });
-    } else if (typeof uriA === "object") {
-      uriA = serialize(normalizeComponentEncoding(uriA, true), { ...options, skipEscape: true });
-    }
-    if (typeof uriB === "string") {
-      uriB = unescape(uriB);
-      uriB = serialize(normalizeComponentEncoding(parse6(uriB, options), true), { ...options, skipEscape: true });
-    } else if (typeof uriB === "object") {
-      uriB = serialize(normalizeComponentEncoding(uriB, true), { ...options, skipEscape: true });
-    }
-    return uriA.toLowerCase() === uriB.toLowerCase();
+    const normalizedA = normalizeComparableURI(uriA, options);
+    const normalizedB = normalizeComparableURI(uriB, options);
+    return normalizedA !== undefined && normalizedB !== undefined && normalizedA.toLowerCase() === normalizedB.toLowerCase();
   }
   function serialize(cmpts, opts) {
     const component = {
@@ -3586,12 +3632,12 @@ var require_fast_uri = __commonJS((exports, module) => {
       schemeHandler.serialize(component, options);
     if (component.path !== undefined) {
       if (!options.skipEscape) {
-        component.path = escape(component.path);
+        component.path = escapePreservingEscapes(component.path);
         if (component.scheme !== undefined) {
           component.path = component.path.split("%3A").join(":");
         }
       } else {
-        component.path = unescape(component.path);
+        component.path = normalizePercentEncoding(component.path);
       }
     }
     if (options.reference !== "suffix" && component.scheme) {
@@ -3626,7 +3672,16 @@ var require_fast_uri = __commonJS((exports, module) => {
     return uriTokens.join("");
   }
   var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
-  function parse6(uri, opts) {
+  function getParseError(parsed, matches) {
+    if (matches[2] !== undefined && parsed.path && parsed.path[0] !== "/") {
+      return 'URI path must start with "/" when authority is present.';
+    }
+    if (typeof parsed.port === "number" && (parsed.port < 0 || parsed.port > 65535)) {
+      return "URI port is malformed.";
+    }
+    return;
+  }
+  function parseWithStatus(uri, opts) {
     const options = Object.assign({}, opts);
     const parsed = {
       scheme: undefined,
@@ -3637,6 +3692,7 @@ var require_fast_uri = __commonJS((exports, module) => {
       query: undefined,
       fragment: undefined
     };
+    let malformedAuthorityOrPort = false;
     let isIP = false;
     if (options.reference === "suffix") {
       if (options.scheme) {
@@ -3657,6 +3713,11 @@ var require_fast_uri = __commonJS((exports, module) => {
       if (isNaN(parsed.port)) {
         parsed.port = matches[5];
       }
+      const parseError = getParseError(parsed, matches);
+      if (parseError !== undefined) {
+        parsed.error = parsed.error || parseError;
+        malformedAuthorityOrPort = true;
+      }
       if (parsed.host) {
         const ipv4result = isIPv4(parsed.host);
         if (ipv4result === false) {
@@ -3695,14 +3756,18 @@ var require_fast_uri = __commonJS((exports, module) => {
             parsed.scheme = unescape(parsed.scheme);
           }
           if (parsed.host !== undefined) {
-            parsed.host = unescape(parsed.host);
+            parsed.host = reescapeHostDelimiters(unescape(parsed.host), isIP);
           }
         }
         if (parsed.path) {
-          parsed.path = escape(unescape(parsed.path));
+          parsed.path = normalizePathEncoding(parsed.path);
         }
         if (parsed.fragment) {
-          parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+          try {
+            parsed.fragment = encodeURI(decodeURIComponent(parsed.fragment));
+          } catch {
+            parsed.error = parsed.error || "URI malformed";
+          }
         }
       }
       if (schemeHandler && schemeHandler.parse) {
@@ -3711,7 +3776,29 @@ var require_fast_uri = __commonJS((exports, module) => {
     } else {
       parsed.error = parsed.error || "URI can not be parsed.";
     }
-    return parsed;
+    return { parsed, malformedAuthorityOrPort };
+  }
+  function parse6(uri, opts) {
+    return parseWithStatus(uri, opts).parsed;
+  }
+  function normalizeString(uri, opts) {
+    return normalizeStringWithStatus(uri, opts).normalized;
+  }
+  function normalizeStringWithStatus(uri, opts) {
+    const { parsed, malformedAuthorityOrPort } = parseWithStatus(uri, opts);
+    return {
+      normalized: malformedAuthorityOrPort ? uri : serialize(parsed, opts),
+      malformedAuthorityOrPort
+    };
+  }
+  function normalizeComparableURI(uri, opts) {
+    if (typeof uri === "string") {
+      const { normalized, malformedAuthorityOrPort } = normalizeStringWithStatus(uri, opts);
+      return malformedAuthorityOrPort ? undefined : normalized;
+    }
+    if (typeof uri === "object") {
+      return serialize(uri, opts);
+    }
   }
   var fastUri = {
     SCHEMES,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neriros/ralphy",
-  "version": "2.17.1",
+  "version": "2.17.3",
   "description": "An iterative AI task execution framework. Orchestrates multi-phase autonomous work using Claude or Codex engines.",
   "keywords": [
     "agent",
@@ -57,33 +57,35 @@
     "prepublishOnly": "bun run build:publish"
   },
   "devDependencies": {
-    "@commitlint/cli": "^20.4.3",
-    "@commitlint/config-conventional": "^20.4.3",
+    "@commitlint/cli": "^20.5.3",
+    "@commitlint/config-conventional": "^20.5.3",
     "@fission-ai/openspec": "latest",
-    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "@nx/devkit": "^22.7.1",
     "@nx/js": "^22.7.1",
-    "@secretlint/secretlint-rule-preset-recommend": "^11.3.1",
+    "@secretlint/secretlint-rule-preset-recommend": "^11.7.1",
     "@swc-node/register": "^1.11.1",
-    "@swc/core": "^1.15.18",
+    "@swc/core": "^1.15.33",
     "@total-typescript/ts-reset": "^0.6.1",
-    "@types/node": "^22.0.0",
-    "bun-types": "^1.3.0",
-    "chalk": "^5.4.0",
-    "dependency-cruiser": "^17.3.8",
+    "@types/node": "^22.19.18",
+    "bun-types": "^1.3.13",
+    "chalk": "^5.6.2",
+    "dependency-cruiser": "^17.4.0",
     "husky": "^9.1.7",
-    "knip": "^5.85.0",
-    "lint-staged": "^16.3.2",
+    "knip": "^5.88.1",
+    "lint-staged": "^16.4.0",
     "nx": "22.5.3",
     "oxc-parser": "^0.126.0",
     "oxfmt": "^0.36.0",
-    "oxlint": "^1.51.0",
-    "secretlint": "^11.3.1",
-    "typescript": "^5.8.0",
-    "zod": "^3.24.0"
+    "oxlint": "^1.63.0",
+    "secretlint": "^11.7.1",
+    "typescript": "^5.9.3",
+    "zod": "^3.25.76"
   },
   "overrides": {
+    "@babel/plugin-transform-modules-systemjs": "^7.29.4",
     "axios": "^1.15.1",
+    "fast-uri": "^3.1.2",
     "minimatch": "^10.2.3"
   },
   "engines": {