ralphctl 0.8.4 → 0.8.6

package/dist/cli.mjs

@@ -778,8 +778,11 @@ var createJsonSettingsRepository = (deps) => {
   };
 };
 
+// src/integration/io/cross-platform-spawn.ts
+import spawn from "cross-spawn";
+var crossPlatformSpawn = (command, args, options) => spawn(command, [...args], options);
+
 // src/integration/io/git-runner.ts
-import { spawn as nodeSpawn } from "child_process";
 var DEFAULT_GIT_TIMEOUT_MS = 3e4;
 var createGitRunner = (deps = {}) => {
   const spawn3 = deps.spawn ?? defaultSpawn;
@@ -857,11 +860,11 @@ var createGitRunner = (deps = {}) => {
   });
   return { run };
 };
-var defaultSpawn = (command, args, options) => nodeSpawn(command, [...args], { ...options, stdio: [...options.stdio] });
+var defaultSpawn = (command, args, options) => crossPlatformSpawn(command, args, { ...options, stdio: [...options.stdio] });
 var stringifyError = (cause) => cause instanceof Error ? cause.message : String(cause);
 
 // src/integration/io/shell-script-runner.ts
-import { spawn as nodeSpawn2 } from "child_process";
+import { spawn as nodeSpawn } from "child_process";
 var DEFAULT_SHELL_TIMEOUT_MS = 5 * 6e4;
 var MAX_OUTPUT_BYTES = 50 * 1024 * 1024;
 var createShellScriptRunner = (deps = {}) => {
@@ -987,7 +990,7 @@ ${marker}` : marker : base;
   });
   return { run };
 };
-var defaultSpawn2 = (command, args, options) => nodeSpawn2(command, [...args], { ...options, stdio: [...options.stdio] });
+var defaultSpawn2 = (command, args, options) => nodeSpawn(command, [...args], { ...options, stdio: [...options.stdio] });
 var stringifyError2 = (cause) => cause instanceof Error ? cause.message : String(cause);
 
 // src/integration/persistence/project/project.schema.ts
@@ -2217,12 +2220,6 @@ var createAppendFile = () => {
   };
 };
 
-// src/application/bootstrap/wire.ts
-import { spawn as nodeSpawn9 } from "child_process";
-
-// src/integration/ai/providers/claude/headless.ts
-import { spawn as nodeSpawn3 } from "child_process";
-
 // src/integration/ai/providers/_engine/resolve-roots.ts
 var resolveWritableRoots = (session) => {
   const declared = session.additionalRoots ?? [];
@@ -2908,13 +2905,12 @@ var spawnAttempt = async (input) => {
     onSuccess
   });
 };
-var defaultSpawn3 = (command, args, options) => nodeSpawn3(command, [...args], {
+var defaultSpawn3 = (command, args, options) => crossPlatformSpawn(command, args, {
   stdio: [...options.stdio],
   ...options.cwd !== void 0 ? { cwd: options.cwd } : {}
 });
 
 // src/integration/ai/providers/codex/headless.ts
-import { spawn as nodeSpawn4 } from "child_process";
 import { promises as fs6 } from "fs";
 import { tmpdir } from "os";
 import { join as join6 } from "path";
@@ -3291,14 +3287,11 @@ var spawnAttempt2 = async (input) => {
     onSuccess
   });
 };
-var defaultSpawn4 = (command, args, options) => nodeSpawn4(command, [...args], {
+var defaultSpawn4 = (command, args, options) => crossPlatformSpawn(command, args, {
   stdio: [...options.stdio],
   ...options.cwd !== void 0 ? { cwd: options.cwd } : {}
 });
 
-// src/integration/ai/providers/copilot/headless.ts
-import { spawn as nodeSpawn5 } from "child_process";
-
 // src/integration/ai/providers/copilot/parse-stream.ts
 var stringField3 = (obj, ...names) => {
   for (const name of names) {
@@ -3650,7 +3643,7 @@ var spawnAttempt3 = async (input) => {
     onSuccess
   });
 };
-var defaultSpawn5 = (command, args, options) => nodeSpawn5(command, [...args], {
+var defaultSpawn5 = (command, args, options) => crossPlatformSpawn(command, args, {
   stdio: [...options.stdio],
   ...options.cwd !== void 0 ? { cwd: options.cwd } : {}
 });
@@ -3689,12 +3682,20 @@ var createAiProvider = (deps) => {
 };
 
 // src/integration/ai/providers/claude/interactive.ts
-import { spawn as nodeSpawn6 } from "child_process";
+import { promises as fs7 } from "fs";
+import "child_process";
 import { dirname as dirname5 } from "path";
-var defaultSpawn6 = (command, args, options) => nodeSpawn6(command, [...args], { stdio: options.stdio, cwd: options.cwd });
+var defaultSpawn6 = (command, args, options) => (
+  // Route through the shared cross-platform primitive so `claude.cmd` shims resolve on
+  // Windows and the positional prompt argument (which may contain spaces or shell
+  // metacharacters) is escaped correctly — without a shell. See cross-platform-spawn.ts.
+  crossPlatformSpawn(command, args, { stdio: options.stdio, cwd: options.cwd })
+);
+var defaultReadFile = (path) => fs7.readFile(path, "utf8");
 var createInteractiveClaudeProvider = (deps) => {
   const spawnFn = deps.spawn ?? defaultSpawn6;
-  const command = deps.command ?? "bash";
+  const command = deps.command ?? "claude";
+  const readFile2 = deps.readFile ?? defaultReadFile;
   const newSessionId = deps.newSessionId ?? uuidv7;
   return {
     async run(input) {
@@ -3708,6 +3709,18 @@ var createInteractiveClaudeProvider = (deps) => {
           })
         );
       }
+      let prompt;
+      try {
+        prompt = await readFile2(String(input.promptFile));
+      } catch (cause) {
+        return Result.error(
+          new StorageError({
+            subCode: "io",
+            message: `interactive-claude: failed to read prompt file ${String(input.promptFile)} \u2014 ${stringifyError4(cause)}`,
+            cause
+          })
+        );
+      }
       const allRoots = [
         String(input.cwd),
         ...input.additionalRoots?.map((r) => String(r)) ?? [],
@@ -3719,19 +3732,18 @@ var createInteractiveClaudeProvider = (deps) => {
         if (seen.has(p)) return false;
         seen.add(p);
         return true;
-      }).flatMap((p) => ["--add-dir", shellQuote(p)]);
+      }).flatMap((p) => ["--add-dir", p]);
       const sessionId2 = newSessionId();
-      const inner = [
-        "claude",
+      const args = [
         ...dirFlags,
         "--model",
-        shellQuote(input.model),
+        input.model,
         "--permission-mode",
         "acceptEdits",
         "--session-id",
-        shellQuote(sessionId2),
-        `"$(cat ${shellQuote(String(input.promptFile))})"`
-      ].join(" ");
+        sessionId2,
+        prompt
+      ];
       deps.eventBus.publish({
         type: "log",
         level: "info",
@@ -3741,7 +3753,7 @@ var createInteractiveClaudeProvider = (deps) => {
       });
       let child;
       try {
-        child = spawnFn(command, ["-lc", inner], { stdio: "inherit", cwd: String(input.cwd) });
+        child = spawnFn(command, args, { stdio: "inherit", cwd: String(input.cwd) });
       } catch (cause) {
         return Result.error(
           new StorageError({
@@ -3785,16 +3797,23 @@ var createInteractiveClaudeProvider = (deps) => {
     }
   };
 };
-var shellQuote = (s) => `'${s.replace(/'/g, `'\\''`)}'`;
 var stringifyError4 = (cause) => cause instanceof Error ? cause.message : String(cause);
 
 // src/integration/ai/providers/codex/interactive.ts
-import { spawn as nodeSpawn7 } from "child_process";
+import { promises as fs8 } from "fs";
+import "child_process";
 import { dirname as dirname6 } from "path";
-var defaultSpawn7 = (command, args, options) => nodeSpawn7(command, [...args], { stdio: options.stdio, cwd: options.cwd });
+var defaultSpawn7 = (command, args, options) => (
+  // Route through the shared cross-platform primitive so `codex.cmd` shims resolve on
+  // Windows and the positional prompt argument is escaped correctly — without a shell.
+  // See cross-platform-spawn.ts.
+  crossPlatformSpawn(command, args, { stdio: options.stdio, cwd: options.cwd })
+);
+var defaultReadFile2 = (path) => fs8.readFile(path, "utf8");
 var createInteractiveCodexProvider = (deps) => {
   const spawnFn = deps.spawn ?? defaultSpawn7;
-  const command = deps.command ?? "bash";
+  const command = deps.command ?? "codex";
+  const readFile2 = deps.readFile ?? defaultReadFile2;
   return {
     async run(input) {
       if (!isCodexModel(input.model)) {
@@ -3807,6 +3826,18 @@ var createInteractiveCodexProvider = (deps) => {
           })
         );
       }
+      let prompt;
+      try {
+        prompt = await readFile2(String(input.promptFile));
+      } catch (cause) {
+        return Result.error(
+          new StorageError({
+            subCode: "io",
+            message: `interactive-codex: failed to read prompt file ${String(input.promptFile)} \u2014 ${stringifyError5(cause)}`,
+            cause
+          })
+        );
+      }
       const allRoots = [
         String(input.cwd),
         ...input.additionalRoots?.map((r) => String(r)) ?? [],
@@ -3818,20 +3849,19 @@ var createInteractiveCodexProvider = (deps) => {
         if (seen.has(p)) return false;
         seen.add(p);
         return true;
-      }).flatMap((p) => ["--add-dir", shellQuote2(p)]);
-      const inner = [
-        "codex",
+      }).flatMap((p) => ["--add-dir", p]);
+      const args = [
         "--cd",
-        shellQuote2(String(input.cwd)),
+        String(input.cwd),
         ...dirFlags,
         "--model",
-        shellQuote2(input.model),
+        input.model,
         "-s",
         "workspace-write",
         "-a",
         "never",
-        `"$(cat ${shellQuote2(String(input.promptFile))})"`
-      ].join(" ");
+        prompt
+      ];
       deps.eventBus.publish({
         type: "log",
         level: "info",
@@ -3841,7 +3871,7 @@ var createInteractiveCodexProvider = (deps) => {
       });
       let child;
       try {
-        child = spawnFn(command, ["-lc", inner], { stdio: "inherit", cwd: String(input.cwd) });
+        child = spawnFn(command, args, { stdio: "inherit", cwd: String(input.cwd) });
       } catch (cause) {
         return Result.error(
           new StorageError({
@@ -3873,19 +3903,23 @@ var createInteractiveCodexProvider = (deps) => {
     }
   };
 };
-var shellQuote2 = (s) => `'${s.replace(/'/g, `'\\''`)}'`;
 var stringifyError5 = (cause) => cause instanceof Error ? cause.message : String(cause);
 
 // src/integration/ai/providers/copilot/interactive.ts
-import { promises as fs7 } from "fs";
-import { spawn as nodeSpawn8 } from "child_process";
+import { promises as fs9 } from "fs";
+import "child_process";
 import { dirname as dirname7 } from "path";
-var defaultSpawn8 = (command, args, options) => nodeSpawn8(command, [...args], { stdio: options.stdio, cwd: options.cwd });
-var defaultReadFile = (path) => fs7.readFile(path, "utf8");
+var defaultSpawn8 = (command, args, options) => (
+  // Route through the shared cross-platform primitive so `copilot.cmd` shims resolve on
+  // Windows and the seeded prompt argument is escaped correctly — without a shell.
+  // See cross-platform-spawn.ts.
+  crossPlatformSpawn(command, args, { stdio: options.stdio, cwd: options.cwd })
+);
+var defaultReadFile3 = (path) => fs9.readFile(path, "utf8");
 var createInteractiveCopilotProvider = (deps) => {
   const spawnFn = deps.spawn ?? defaultSpawn8;
   const command = deps.command ?? "copilot";
-  const readFile2 = deps.readFile ?? defaultReadFile;
+  const readFile2 = deps.readFile ?? defaultReadFile3;
   const newSessionId = deps.newSessionId ?? uuidv7;
   return {
     async run(input) {
@@ -4512,7 +4546,7 @@ var createPullRequestCreator = (deps) => async (input) => {
 };
 
 // src/integration/ai/prompts/_engine/fs-template-loader.ts
-import { promises as fs8 } from "fs";
+import { promises as fs10 } from "fs";
 import { dirname as dirname8, join as join7 } from "path";
 import { fileURLToPath } from "url";
 var createFsTemplateLoader = (templatesDir) => ({
@@ -4536,7 +4570,7 @@ var createFsTemplateLoader = (templatesDir) => ({
 });
 var tryRead = async (path) => {
   try {
-    const content = await fs8.readFile(path, "utf8");
+    const content = await fs10.readFile(path, "utf8");
     return { kind: "ok", value: content };
   } catch (cause) {
     if (isNodeErrnoCode2(cause, "ENOENT")) return { kind: "missing" };
@@ -4582,7 +4616,7 @@ var ProbeError = class extends Error {
 };
 
 // src/integration/ai/readiness/_engine/probe-fs.ts
-import { promises as fs9 } from "fs";
+import { promises as fs11 } from "fs";
 import { basename, join as join8 } from "path";
 
 // src/domain/value/kebab-case.ts
@@ -4591,7 +4625,7 @@ var toKebabCase = (input) => input.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").
 // src/integration/ai/readiness/_engine/probe-fs.ts
 var probeFile = async (path) => {
   try {
-    const stat = await fs9.stat(path);
+    const stat = await fs11.stat(path);
     if (!stat.isFile()) return Result.ok(void 0);
     return Result.ok({ path });
   } catch (cause) {
@@ -4642,7 +4676,7 @@ var probeNamedFileCollection = async (dir) => {
 };
 var listDir2 = async (dir) => {
   try {
-    return Result.ok(await fs9.readdir(dir));
+    return Result.ok(await fs11.readdir(dir));
   } catch (cause) {
     if (isNodeErrnoCode(cause, "ENOENT") || isNodeErrnoCode(cause, "ENOTDIR")) return Result.ok([]);
     if (isNodeErrnoCode(cause, "EACCES")) {
@@ -4655,7 +4689,7 @@ var listDir2 = async (dir) => {
 };
 var statSafely = async (path) => {
   try {
-    return Result.ok(await fs9.stat(path));
+    return Result.ok(await fs11.stat(path));
   } catch (cause) {
     if (isNodeErrnoCode(cause, "ENOENT")) return Result.ok(void 0);
     if (isNodeErrnoCode(cause, "EACCES")) {
@@ -4668,7 +4702,7 @@ var statSafely = async (path) => {
 };
 var readFileSafely = async (path) => {
   try {
-    return Result.ok(await fs9.readFile(path, "utf8"));
+    return Result.ok(await fs11.readFile(path, "utf8"));
   } catch (cause) {
     if (isNodeErrnoCode(cause, "ENOENT")) return Result.ok(void 0);
     if (isNodeErrnoCode(cause, "EACCES")) {
@@ -4793,14 +4827,14 @@ var codexProbe = {
 };
 
 // src/integration/ai/readiness/copilot/probe.ts
-import { promises as fs10 } from "fs";
+import { promises as fs12 } from "fs";
 import { join as join11 } from "path";
 var copilotProbe = {
   tool: "copilot",
   async evaluate(repository, now) {
     const path = join11(repository.path, ".github/copilot-instructions.md");
     try {
-      const stat = await fs10.stat(path);
+      const stat = await fs12.stat(path);
       if (!stat.isFile()) return Result.ok(absentState(now));
       const artifacts = { tool: "copilot", copilotInstructions: { path } };
       return Result.ok(hasAnyCopilotArtifact(artifacts) ? presentState(now, artifacts) : absentState(now));
@@ -4958,7 +4992,7 @@ var createNpmVersionChecker = (deps) => {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.8.4",
+  version: "0.8.6",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code, GitHub Copilot, and OpenAI Codex across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -5019,6 +5053,7 @@ var package_default = {
   },
   dependencies: {
     commander: "^14.0.3",
+    "cross-spawn": "^7.0.6",
     ink: "^7.0.3",
     react: "^19.2.6",
     "typescript-result": "^3.5.2",
@@ -5026,6 +5061,7 @@ var package_default = {
   },
   devDependencies: {
     "@eslint/js": "^10.0.1",
+    "@types/cross-spawn": "^6.0.6",
     "@types/node": "^25.8.0",
     "@types/react": "^19.2.14",
     "@vitest/coverage-v8": "^4.1.6",
@@ -5087,14 +5123,14 @@ import { mkdir, rm, rmdir, writeFile } from "fs/promises";
 import { join as join14 } from "path";
 
 // src/integration/io/git-exclude.ts
-import { promises as fs11 } from "fs";
+import { promises as fs13 } from "fs";
 import { isAbsolute as isAbsolute2, join as join13 } from "path";
 var ensureGitExcludeWildcard = async (repoRoot, pattern) => {
   const resolved = await resolveExcludePath(String(repoRoot));
   if (resolved === void 0) return Result.ok(void 0);
   let existing = "";
   try {
-    existing = await fs11.readFile(resolved, "utf8");
+    existing = await fs13.readFile(resolved, "utf8");
   } catch (cause) {
     if (isNodeErrnoCode3(cause, "ENOENT")) {
     } else {
@@ -5120,7 +5156,7 @@ var resolveExcludePath = async (repoRoot) => {
   const gitMarker = join13(repoRoot, ".git");
   let stat;
   try {
-    stat = await fs11.stat(gitMarker);
+    stat = await fs13.stat(gitMarker);
   } catch (cause) {
     if (isNodeErrnoCode3(cause, "ENOENT") || isNodeErrnoCode3(cause, "ENOTDIR")) return void 0;
     throw cause;
@@ -5131,7 +5167,7 @@ var resolveExcludePath = async (repoRoot) => {
   if (!stat.isFile()) return void 0;
   let pointer;
   try {
-    pointer = await fs11.readFile(gitMarker, "utf8");
+    pointer = await fs13.readFile(gitMarker, "utf8");
   } catch {
     return void 0;
   }
@@ -5582,7 +5618,7 @@ var NOOP_CHAIN_LOG_SINK = {
   }
 };
 var isTruthyEnvFlag = (value) => typeof value === "string" && value.length > 0;
-var defaultPipeSpawn = (command, args, options) => nodeSpawn9(command, [...args], {
+var defaultPipeSpawn = (command, args, options) => crossPlatformSpawn(command, args, {
   ...options,
   stdio: [...options.stdio]
 });
@@ -6626,6 +6662,103 @@ var UnknownViewFallback = ({ id }) => /* @__PURE__ */ jsxs(Box, { flexDirection:
 // src/application/ui/tui/runtime/system-status-context.tsx
 import { createContext as createContext10, useCallback as useCallback5, useContext as useContext10, useEffect as useEffect4, useState as useState6 } from "react";
 
+// src/integration/io/command-exists.ts
+import { spawn as spawn2 } from "child_process";
+var commandExists = (name) => new Promise((resolve) => {
+  const child = process.platform === "win32" ? spawn2("where", [name], { stdio: "ignore" }) : spawn2("command", ["-v", name], { stdio: "ignore", shell: true });
+  let settled = false;
+  const settle = (value) => {
+    if (settled) return;
+    settled = true;
+    resolve(value);
+  };
+  child.on("error", () => settle(false));
+  child.on("exit", (code) => settle(code === 0));
+});
+
+// src/integration/system/detect-cli.ts
+var PROVIDER_BINARY = {
+  "claude-code": "claude",
+  "github-copilot": "copilot",
+  "openai-codex": "codex"
+};
+var PROVIDER_INSTALL_GUIDANCE = {
+  "claude-code": {
+    docsUrl: "https://docs.claude.com/en/docs/claude-code/setup",
+    commandsByPlatform: {
+      darwin: [
+        "brew install --cask claude-code",
+        "curl -fsSL https://claude.ai/install.sh | bash",
+        "npm install -g @anthropic-ai/claude-code"
+      ],
+      linux: ["curl -fsSL https://claude.ai/install.sh | bash", "npm install -g @anthropic-ai/claude-code"],
+      win32: [
+        "winget install Anthropic.ClaudeCode",
+        "irm https://claude.ai/install.ps1 | iex",
+        "npm install -g @anthropic-ai/claude-code"
+      ]
+    }
+  },
+  "github-copilot": {
+    docsUrl: "https://docs.github.com/en/copilot/how-tos/copilot-cli/set-up-copilot-cli/install-copilot-cli",
+    commandsByPlatform: {
+      darwin: ["brew install copilot-cli", "npm install -g @github/copilot"],
+      linux: ["npm install -g @github/copilot", "brew install copilot-cli"],
+      win32: ["winget install GitHub.Copilot", "npm install -g @github/copilot"]
+    }
+  },
+  "openai-codex": {
+    docsUrl: "https://github.com/openai/codex",
+    commandsByPlatform: {
+      darwin: [
+        "brew install --cask codex",
+        "curl -fsSL https://chatgpt.com/codex/install.sh | sh",
+        "npm install -g @openai/codex"
+      ],
+      linux: ["curl -fsSL https://chatgpt.com/codex/install.sh | sh", "npm install -g @openai/codex"],
+      win32: [
+        'powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"',
+        "npm install -g @openai/codex"
+      ]
+    }
+  }
+};
+var resolveInstallPlatform = (platform = process.platform) => {
+  if (platform === "darwin" || platform === "win32") return platform;
+  return "linux";
+};
+var primaryInstallCommand = (provider, platform = process.platform) => {
+  const os = resolveInstallPlatform(platform);
+  const list = PROVIDER_INSTALL_GUIDANCE[provider].commandsByPlatform[os];
+  const first = list[0];
+  if (first === void 0) {
+    throw new Error(`No install command registered for ${provider} on ${os}`);
+  }
+  return first;
+};
+var renderProviderInstallGuidance = (provider, platform = process.platform) => {
+  const os = resolveInstallPlatform(platform);
+  const guidance = PROVIDER_INSTALL_GUIDANCE[provider];
+  const commands = guidance.commandsByPlatform[os];
+  const header = `${provider} CLI (${PROVIDER_BINARY[provider]}) not on PATH`;
+  const bullets = commands.map((c) => `  \u2022 ${c}`).join("\n");
+  return `${header}
+Install options (${os}):
+${bullets}
+Docs: ${guidance.docsUrl}`;
+};
+var defaultWhich = commandExists;
+var detectInstalledProviders = async (options = {}) => {
+  const which = options.which ?? defaultWhich;
+  const providers = Object.keys(PROVIDER_BINARY);
+  const results = await Promise.all(providers.map(async (p) => [p, await which(PROVIDER_BINARY[p])]));
+  const installed = /* @__PURE__ */ new Set();
+  for (const [provider, present] of results) {
+    if (present) installed.add(provider);
+  }
+  return installed;
+};
+
 // src/application/chain/trace.ts
 var abortedEntry = (elementName, reason) => ({
   elementName,
@@ -6707,11 +6840,6 @@ var isDomainError = (cause) => cause instanceof Error && typeof cause.code === "
 var MIN_NODE_MAJOR = 24;
 
 // src/application/flows/doctor/flow.ts
-var PROVIDER_BINARY = {
-  "claude-code": "claude",
-  "github-copilot": "copilot",
-  "openai-codex": "codex"
-};
 var PROVIDER_LABEL = {
   "claude-code": "Claude Code",
   "github-copilot": "GitHub Copilot",
@@ -7066,30 +7194,47 @@ var probeSprintExecutionPairing = async (sprints, sprintExecutionRepo) => {
   };
 };
 
-// src/integration/io/command-exists.ts
-import { spawn } from "child_process";
-var commandExists = (name) => new Promise((resolve) => {
-  const child = spawn(name, ["--version"], { stdio: "ignore" });
+// src/integration/io/run-command.ts
+var PROBE_TIMEOUT_MS = 5e3;
+var runCommand = (name, args) => new Promise((resolve) => {
+  let child;
+  try {
+    child = crossPlatformSpawn(name, args, { stdio: ["ignore", "pipe", "pipe"] });
+  } catch {
+    resolve({ ok: false, code: null, stdout: "", stderr: "" });
+    return;
+  }
+  const stdoutChunks = [];
+  const stderrChunks = [];
   let settled = false;
-  const settle = (value) => {
+  const settle = (result) => {
     if (settled) return;
     settled = true;
-    resolve(value);
+    clearTimeout(timer);
+    resolve(result);
   };
-  child.on("error", () => settle(false));
-  child.on("exit", () => settle(true));
-});
-
-// src/integration/io/run-command.ts
-import { execFile } from "child_process";
-var runCommand = (name, args) => new Promise((resolve) => {
-  execFile(name, [...args], { timeout: 5e3, encoding: "utf8" }, (err, stdout, stderr) => {
-    if (err === null) {
-      resolve({ ok: true, code: 0, stdout, stderr });
-      return;
+  const timer = setTimeout(() => {
+    try {
+      child.kill("SIGTERM");
+    } catch {
     }
-    const code = typeof err.code === "number" ? err.code : null;
-    resolve({ ok: false, code, stdout, stderr });
+    settle({
+      ok: false,
+      code: null,
+      stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+      stderr: Buffer.concat(stderrChunks).toString("utf8")
+    });
+  }, PROBE_TIMEOUT_MS);
+  child.stdout?.on("data", (c) => stdoutChunks.push(c));
+  child.stderr?.on("data", (c) => stderrChunks.push(c));
+  child.on("error", () => settle({ ok: false, code: null, stdout: "", stderr: "" }));
+  child.on("close", (code) => {
+    settle({
+      ok: code === 0,
+      code,
+      stdout: Buffer.concat(stdoutChunks).toString("utf8"),
+      stderr: Buffer.concat(stderrChunks).toString("utf8")
+    });
   });
 });
 
@@ -11206,16 +11351,16 @@ import { join as join23 } from "path";
 
 // src/application/flows/refine/flow.ts
 import { dirname as dirname11, join as join22 } from "path";
-import { promises as fs15 } from "fs";
+import { promises as fs17 } from "fs";
 
 // src/application/flows/_shared/build-unit.ts
-import { promises as fs12 } from "fs";
+import { promises as fs14 } from "fs";
 import { join as join17 } from "path";
 var buildUnitLeaf = (opts) => leaf(opts.name, {
   useCase: {
     execute: async (input) => {
       try {
-        await fs12.mkdir(input.path, { recursive: true });
+        await fs14.mkdir(input.path, { recursive: true });
       } catch (cause) {
         return Result.error(
           new StorageError({
@@ -11327,7 +11472,7 @@ var fetchIssueContextLeaf = (deps, ticket) => leaf(`fetch-issue-context-${String
 });
 
 // src/application/flows/refine/leaves/refine-ticket-interactive.ts
-import { promises as fs14 } from "fs";
+import { promises as fs16 } from "fs";
 import { dirname as dirname10, join as join20 } from "path";
 
 // src/business/ticket/refine-ticket.ts
@@ -11425,14 +11570,14 @@ var renderFilename = (filename, index, multiplicity) => {
 };
 
 // src/integration/ai/contract/_engine/validate-signals-file.ts
-import { promises as fs13 } from "fs";
+import { promises as fs15 } from "fs";
 import { join as join19 } from "path";
 var SIGNALS_FILENAME = "signals.json";
 var validateSignalsFile = async (outputDir, contract) => {
   const path = join19(String(outputDir), SIGNALS_FILENAME);
   let bytes;
   try {
-    bytes = await fs13.readFile(path, "utf8");
+    bytes = await fs15.readFile(path, "utf8");
   } catch (cause) {
     if (isNodeErrnoCode(cause, "ENOENT") || isNodeErrnoCode(cause, "ENOTDIR")) {
       return Result.error(
@@ -11608,7 +11753,7 @@ var remapRefineSignalsError = (error) => {
 };
 var warnDroppedSignals = async (deps, outputDir) => {
   try {
-    const bytes = await fs14.readFile(join20(String(outputDir), "signals.json"), "utf8");
+    const bytes = await fs16.readFile(join20(String(outputDir), "signals.json"), "utf8");
     const raw = JSON.parse(bytes);
     const inner = Array.isArray(raw) ? raw : raw.signals;
     if (!Array.isArray(inner)) return;
@@ -11999,7 +12144,7 @@ var stampSessionMetaLeaf = (deps, opts) => leaf(opts.name, {
 var readSprintProgress = async (refinementRoot) => {
   const sprintDir2 = dirname11(String(refinementRoot));
   try {
-    return await fs15.readFile(join22(sprintDir2, "progress.md"), "utf8");
+    return await fs17.readFile(join22(sprintDir2, "progress.md"), "utf8");
   } catch {
     return "";
   }
@@ -12138,106 +12283,6 @@ var createRefineFlow = (deps, opts) => {
   ]);
 };
 
-// src/integration/system/detect-cli.ts
-import { spawn as spawn2 } from "child_process";
-var PROVIDER_BINARY2 = {
-  "claude-code": "claude",
-  "github-copilot": "gh",
-  "openai-codex": "codex"
-};
-var PROVIDER_INSTALL_GUIDANCE = {
-  "claude-code": {
-    docsUrl: "https://docs.claude.com/en/docs/claude-code/setup",
-    commandsByPlatform: {
-      darwin: [
-        "brew install --cask claude-code",
-        "curl -fsSL https://claude.ai/install.sh | bash",
-        "npm install -g @anthropic-ai/claude-code"
-      ],
-      linux: ["curl -fsSL https://claude.ai/install.sh | bash", "npm install -g @anthropic-ai/claude-code"],
-      win32: [
-        "winget install Anthropic.ClaudeCode",
-        "irm https://claude.ai/install.ps1 | iex",
-        "npm install -g @anthropic-ai/claude-code"
-      ]
-    }
-  },
-  "github-copilot": {
-    docsUrl: "https://docs.github.com/en/copilot/how-tos/use-copilot-agents/use-copilot-in-the-cli",
-    commandsByPlatform: {
-      darwin: ["brew install gh && gh extension install github/gh-copilot", "gh extension install github/gh-copilot"],
-      linux: [
-        "install gh from https://github.com/cli/cli/blob/trunk/docs/install_linux.md, then: gh extension install github/gh-copilot",
-        "gh extension install github/gh-copilot"
-      ],
-      win32: [
-        "winget install --id GitHub.cli && gh extension install github/gh-copilot",
-        "gh extension install github/gh-copilot"
-      ]
-    }
-  },
-  "openai-codex": {
-    docsUrl: "https://github.com/openai/codex",
-    commandsByPlatform: {
-      darwin: [
-        "brew install --cask codex",
-        "curl -fsSL https://chatgpt.com/codex/install.sh | sh",
-        "npm install -g @openai/codex"
-      ],
-      linux: ["curl -fsSL https://chatgpt.com/codex/install.sh | sh", "npm install -g @openai/codex"],
-      win32: [
-        'powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"',
-        "npm install -g @openai/codex"
-      ]
-    }
-  }
-};
-var resolveInstallPlatform = (platform = process.platform) => {
-  if (platform === "darwin" || platform === "win32") return platform;
-  return "linux";
-};
-var primaryInstallCommand = (provider, platform = process.platform) => {
-  const os = resolveInstallPlatform(platform);
-  const list = PROVIDER_INSTALL_GUIDANCE[provider].commandsByPlatform[os];
-  const first = list[0];
-  if (first === void 0) {
-    throw new Error(`No install command registered for ${provider} on ${os}`);
-  }
-  return first;
-};
-var renderProviderInstallGuidance = (provider, platform = process.platform) => {
-  const os = resolveInstallPlatform(platform);
-  const guidance = PROVIDER_INSTALL_GUIDANCE[provider];
-  const commands = guidance.commandsByPlatform[os];
-  const header = `${provider} CLI (${PROVIDER_BINARY2[provider]}) not on PATH`;
-  const bullets = commands.map((c) => `  \u2022 ${c}`).join("\n");
-  return `${header}
-Install options (${os}):
-${bullets}
-Docs: ${guidance.docsUrl}`;
-};
-var defaultWhich = (binary) => new Promise((resolve) => {
-  const child = spawn2("command", ["-v", binary], { stdio: "pipe", shell: true });
-  let settled = false;
-  const settle = (value) => {
-    if (settled) return;
-    settled = true;
-    resolve(value);
-  };
-  child.on("error", () => settle(false));
-  child.on("exit", (code) => settle(code === 0));
-});
-var detectInstalledProviders = async (options = {}) => {
-  const which = options.which ?? defaultWhich;
-  const providers = Object.keys(PROVIDER_BINARY2);
-  const results = await Promise.all(providers.map(async (p) => [p, await which(PROVIDER_BINARY2[p])]));
-  const installed = /* @__PURE__ */ new Set();
-  for (const [provider, present] of results) {
-    if (present) installed.add(provider);
-  }
-  return installed;
-};
-
 // src/application/ui/shared/launch/check-cli.ts
 var aiFlowIdForCheck = (flowId) => {
   switch (flowId) {
@@ -12283,7 +12328,7 @@ var rowExpectationsFor = (aiFlow, settings, options) => {
 };
 var renderMissing = (missing, aiFlow) => {
   const formatOne = (m) => {
-    const binary = PROVIDER_BINARY2[m.provider];
+    const binary = PROVIDER_BINARY[m.provider];
     const installHint = primaryInstallCommand(m.provider);
     const docsUrl = PROVIDER_INSTALL_GUIDANCE[m.provider].docsUrl;
     const roleSuffix = m.role !== void 0 ? ` (${m.role})` : "";
@@ -12402,7 +12447,7 @@ import { join as join25 } from "path";
 
 // src/application/flows/plan/flow.ts
 import { dirname as dirname13, join as join24 } from "path";
-import { promises as fs16 } from "fs";
+import { promises as fs18 } from "fs";
 
 // src/application/flows/_shared/sprint/load-execution.ts
 var loadSprintExecutionLeaf = (deps, name = "load-sprint-execution") => leaf(name, {
@@ -13183,7 +13228,7 @@ var callPlannerInteractiveLeaf = (deps) => leaf("call-planner-interactive", {
 var readSprintProgress2 = async (planRoot) => {
   const sprintDir2 = dirname13(String(planRoot));
   try {
-    return await fs16.readFile(join24(sprintDir2, "progress.md"), "utf8");
+    return await fs18.readFile(join24(sprintDir2, "progress.md"), "utf8");
   } catch {
     return "";
   }
@@ -13688,7 +13733,7 @@ var branchPreflightLeaf = (deps, opts, name = "branch-preflight") => leaf(name,
 });
 
 // src/application/flows/implement/leaves/build-task-workspace.ts
-import { promises as fs17 } from "fs";
+import { promises as fs19 } from "fs";
 import { join as join26 } from "path";
 
 // src/integration/ai/prompts/_engine/renderers/task.ts
@@ -13998,8 +14043,8 @@ ${body}
 // src/application/flows/implement/leaves/build-task-workspace.ts
 var writeOrError = async (path, content) => {
   try {
-    await fs17.mkdir(path.slice(0, path.lastIndexOf("/")), { recursive: true });
-    await fs17.writeFile(path, content, "utf8");
+    await fs19.mkdir(path.slice(0, path.lastIndexOf("/")), { recursive: true });
+    await fs19.writeFile(path, content, "utf8");
     return Result.ok(void 0);
   } catch (cause) {
     return Result.error(
@@ -14723,7 +14768,7 @@ var loop = (name, body, opts = {}) => ({
 
 // src/application/flows/implement/leaves/evaluator.ts
 import { dirname as dirname15, join as join28 } from "path";
-import { promises as fs19 } from "fs";
+import { promises as fs21 } from "fs";
 
 // src/business/task/plateau-detection.ts
 var failedDimensions = (signal) => {
@@ -15174,7 +15219,7 @@ var evaluatorOutputContract = {
 };
 
 // src/application/flows/implement/leaves/round-artifacts.ts
-import { promises as fs18 } from "fs";
+import { promises as fs20 } from "fs";
 import { join as join27 } from "path";
 var nextRoundNum = async (workspaceRoot) => {
   const entries = await listDir(join27(String(workspaceRoot), "rounds"));
@@ -15191,7 +15236,7 @@ var readRoundSessionId = async (workspaceRoot, round, role) => {
   const path = join27(String(workspaceRoot), "rounds", String(round), role, "session-id.txt");
   let content;
   try {
-    content = await fs18.readFile(path, "utf8");
+    content = await fs20.readFile(path, "utf8");
   } catch {
     return void 0;
   }
@@ -15211,7 +15256,7 @@ var writeRoundPrompt = async (workspaceRoot, round, role, prompt, logger) => {
 // src/application/flows/implement/leaves/evaluator.ts
 var readProgressFile = async (path) => {
   try {
-    return await fs19.readFile(path, "utf8");
+    return await fs21.readFile(path, "utf8");
   } catch {
     return "";
   }
@@ -15335,7 +15380,7 @@ var evaluatorLeaf = (deps, taskId) => leaf(`evaluator-${String(taskId)}`, {
 
 // src/application/flows/implement/leaves/generator.ts
 import { dirname as dirname16, join as join29 } from "path";
-import { promises as fs20 } from "fs";
+import { promises as fs22 } from "fs";
 
 // src/business/task/run-generator-turn.ts
 var findTaskBlocked = (signals) => signals.find((s) => s.type === "task-blocked")?.reason;
@@ -15402,7 +15447,7 @@ var latestCritique = (task) => {
 // src/application/flows/implement/leaves/generator.ts
 var readProgressFile2 = async (path) => {
   try {
-    return await fs20.readFile(path, "utf8");
+    return await fs22.readFile(path, "utf8");
   } catch {
     return "";
   }
@@ -18036,7 +18081,7 @@ var launchImplement = async (ctx) => {
 import { join as join38 } from "path";
 
 // src/application/flows/review/leaves/ensure-feedback-file.ts
-import { promises as fs21 } from "fs";
+import { promises as fs23 } from "fs";
 
 // src/business/feedback/md-parser.ts
 var ROUND_HEADING_RE = /^##\s+Round\s+(\d+)\s*$/;
@@ -18096,12 +18141,12 @@ var ensureFeedbackFileLeaf = (feedbackFile) => leaf("ensure-feedback-file", {
   useCase: {
     execute: async (path) => {
       try {
-        await fs21.access(String(path));
+        await fs23.access(String(path));
         return Result.ok(void 0);
       } catch {
       }
       try {
-        await fs21.writeFile(String(path), TEMPLATE, { flag: "wx" });
+        await fs23.writeFile(String(path), TEMPLATE, { flag: "wx" });
         return Result.ok(void 0);
       } catch (cause) {
         if (typeof cause === "object" && cause !== null && cause.code === "EEXIST") {
@@ -18123,7 +18168,7 @@ var ensureFeedbackFileLeaf = (feedbackFile) => leaf("ensure-feedback-file", {
 });
 
 // src/application/flows/review/leaves/review-round.ts
-import { promises as fs22 } from "fs";
+import { promises as fs24 } from "fs";
 import { join as join37 } from "path";
 
 // src/business/feedback/apply-feedback.ts
@@ -18306,7 +18351,7 @@ var reviewRoundOutputContract = {
 var readProgressSnippet = async (path) => {
   if (path === void 0) return "_(no progress file)_";
   try {
-    const content = await fs22.readFile(String(path), "utf8");
+    const content = await fs24.readFile(String(path), "utf8");
     return content.length > 4e3 ? `${content.slice(0, 4e3)}
 [truncated]` : content;
   } catch {
@@ -18322,7 +18367,7 @@ ${renderEmptyRound(nextIndex)}${ROUND_SEPARATOR}
 };
 var writeRoundBody = async (path, body) => {
   try {
-    const content = await fs22.readFile(String(path), "utf8");
+    const content = await fs24.readFile(String(path), "utf8");
     const lastMarker = content.lastIndexOf(MARKER_COMMENT);
     if (lastMarker === -1) {
       return Result.error(
@@ -18339,7 +18384,7 @@ var writeRoundBody = async (path, body) => {
     const next = `${head}
 ${body.replace(/\s+$/u, "")}
 ${tail}`;
-    await fs22.writeFile(String(path), next, "utf8");
+    await fs24.writeFile(String(path), next, "utf8");
     return Result.ok(void 0);
   } catch (cause) {
     return Result.error(
@@ -18363,7 +18408,7 @@ var allocateRoundPaths = (reviewRoot, roundIndex) => {
 };
 var ensureRoundDir = async (dir) => {
   try {
-    await fs22.mkdir(String(dir), { recursive: true });
+    await fs24.mkdir(String(dir), { recursive: true });
     return Result.ok(void 0);
   } catch (cause) {
     return Result.error(
@@ -18397,7 +18442,7 @@ var reviewRoundLeaf = (deps, opts) => leaf("review-round", {
           if (!wrote.ok) return Result.error(wrote.error);
           return Result.ok(void 0);
         },
-        readFeedbackFile: () => fs22.readFile(String(input.feedbackFile), "utf8"),
+        readFeedbackFile: () => fs24.readFile(String(input.feedbackFile), "utf8"),
         readProgressSnippet: () => readProgressSnippet(input.progressFile),
         buildPrompt: async (params) => {
           const outputContractSection = renderContractSectionFor(reviewRoundOutputContract, paths.value.outputDir);
@@ -18875,7 +18920,7 @@ var probeReadinessLeaf = (deps, tool) => leaf(`probe-${tool}`, {
 });
 
 // src/application/flows/readiness/leaves/propose.ts
-import { promises as fs23 } from "fs";
+import { promises as fs25 } from "fs";
 
 // src/integration/ai/readiness/_engine/setup.ts
 import { join as join40 } from "path";
@@ -19174,7 +19219,7 @@ var proposeReadinessUseCase = async (deps, tool, input) => {
   let existingBody;
   if (existingPath !== void 0) {
     try {
-      existingBody = await fs23.readFile(existingPath, "utf8");
+      existingBody = await fs25.readFile(existingPath, "utf8");
     } catch {
       existingBody = void 0;
     }
@@ -19292,7 +19337,7 @@ var proposeReadinessLeaf = (deps, tool) => leaf(`propose-${tool}`, {
 });
 
 // src/application/flows/readiness/leaves/write.ts
-import { promises as fs24 } from "fs";
+import { promises as fs26 } from "fs";
 var writeReadinessUseCase = async (deps, tool, input) => {
   const log = deps.logger.named(`readiness.write-${tool}`);
   if (!input.accepted || input.proposal === void 0) {
@@ -19326,7 +19371,7 @@ var makeBackupPath = (targetPath, now) => {
 };
 var fileExists = async (path) => {
   try {
-    const stat = await fs24.stat(path);
+    const stat = await fs26.stat(path);
     return stat.isFile();
   } catch {
     return false;
@@ -19334,7 +19379,7 @@ var fileExists = async (path) => {
 };
 var safeReadText = async (path) => {
   try {
-    return await fs24.readFile(path, "utf8");
+    return await fs26.readFile(path, "utf8");
   } catch {
     return void 0;
   }
@@ -19359,11 +19404,11 @@ var writeReadinessLeaf = (deps, tool) => leaf(`write-${tool}`, {
 });
 
 // src/application/flows/_shared/allocate-run-dir.ts
-import { promises as fs26 } from "fs";
+import { promises as fs28 } from "fs";
 import { join as join42 } from "path";
 
 // src/integration/ai/runs/_engine/run-artifacts.ts
-import { promises as fs25 } from "fs";
+import { promises as fs27 } from "fs";
 import { join as join41 } from "path";
 var BODY_PREVIEW_LIMIT = 800;
 var buildRunDirName = () => {
@@ -19374,7 +19419,7 @@ var buildRunDirName = () => {
 var readRunBodyPreview = async (runDir, options) => {
   let raw;
   try {
-    raw = await fs25.readFile(join41(String(runDir), "body.txt"), "utf8");
+    raw = await fs27.readFile(join41(String(runDir), "body.txt"), "utf8");
   } catch (cause) {
     if (isErrnoException(cause) && cause.code === "ENOENT") return void 0;
     const code = isErrnoException(cause) ? cause.code : "unknown";
@@ -19394,7 +19439,7 @@ var allocateRunDirLeaf = (opts) => leaf(opts.name, {
   useCase: {
     execute: async (input) => {
       try {
-        await fs26.mkdir(input.path, { recursive: true });
+        await fs28.mkdir(input.path, { recursive: true });
       } catch (cause) {
         return Result.error(
           new StorageError({
@@ -20868,7 +20913,7 @@ import { join as join46 } from "path";
 
 // src/application/flows/ideate/flow.ts
 import { dirname as dirname19, join as join45 } from "path";
-import { promises as fs27 } from "fs";
+import { promises as fs29 } from "fs";
 
 // src/integration/ai/prompts/ideate/definition.ts
 var nonEmpty2 = (field) => (v) => v.trim().length === 0 ? Result.error(new ValidationError({ field, value: v, message: `${field} must not be empty` })) : Result.ok(v);
@@ -21143,7 +21188,7 @@ var ideateAndPlanLeaf = (deps) => leaf("ideate-and-plan", {
 var readSprintProgress3 = async (ideateRoot) => {
   const sprintDir2 = dirname19(String(ideateRoot));
   try {
-    return await fs27.readFile(join45(sprintDir2, "progress.md"), "utf8");
+    return await fs29.readFile(join45(sprintDir2, "progress.md"), "utf8");
   } catch {
     return "";
   }
@@ -27087,7 +27132,7 @@ var createSettingsSetProviderFlow = (deps) => leaf("settings-set-provider", {
           new ValidationError({
             field: settingsKey,
             value: input.provider,
-            message: `${input.provider} CLI (${PROVIDER_BINARY2[input.provider]}) not on PATH \u2014 cannot set ${settingsKey}`,
+            message: `${input.provider} CLI (${PROVIDER_BINARY[input.provider]}) not on PATH \u2014 cannot set ${settingsKey}`,
             hint: renderProviderInstallGuidance(input.provider)
           })
         );
@@ -28788,7 +28833,7 @@ import { basename as basename5, join as join52 } from "path";
 
 // src/application/ui/tui/prompts/path-picker-prompt.tsx
 import { useEffect as useEffect38, useState as useState44 } from "react";
-import { promises as fs28 } from "fs";
+import { promises as fs30 } from "fs";
 import { dirname as dirname20, join as join51 } from "path";
 import { homedir } from "os";
 import { Box as Box70, Text as Text69, useInput as useInput28 } from "ink";
@@ -28815,7 +28860,7 @@ var PathPickerPrompt = ({
   useEffect38(() => {
     const load = async () => {
       try {
-        const items = await fs28.readdir(cwd, { withFileTypes: true });
+        const items = await fs30.readdir(cwd, { withFileTypes: true });
         const filtered = items.filter((d) => showHidden || !d.name.startsWith(".")).filter((d) => d.isDirectory()).map((d) => ({ name: d.name, isDirectory: true })).sort((a, b) => a.name.localeCompare(b.name));
         setEntries(filtered);
         setError(void 0);
@@ -28898,7 +28943,7 @@ var PathPickerPrompt = ({
       return;
     }
     try {
-      const stat = await fs28.stat(expanded);
+      const stat = await fs30.stat(expanded);
       if (!stat.isDirectory()) {
         setError(`${expanded} is not a directory`);
         setTyping(false);
@@ -30225,7 +30270,7 @@ import { useEffect as useEffect45, useMemo as useMemo26, useRef as useRef13 } fr
 import { useApp, useInput as useInput32 } from "ink";
 
 // src/integration/io/clipboard.ts
-import { spawn as nodeSpawn10 } from "child_process";
+import { spawn as nodeSpawn2 } from "child_process";
 var resolveHelpers = ({ platform, env }) => {
   if (platform === "darwin") return [{ cmd: "pbcopy", args: [] }];
   if (platform === "win32") return [{ cmd: "clip.exe", args: [] }];
@@ -30290,7 +30335,7 @@ var runHelper = (spawn3, helper, text) => new Promise((resolve) => {
   }
 });
 var createCopyToClipboard = (opts = {}) => {
-  const spawn3 = opts.spawn ?? nodeSpawn10;
+  const spawn3 = opts.spawn ?? nodeSpawn2;
   const platform = opts.platform ?? process.platform;
   const env = opts.env ?? process.env;
   const helpers = resolveHelpers({ platform, env });
@@ -30497,7 +30542,7 @@ var ChainLogDegradedBanner = () => {
 };
 
 // src/application/ui/tui/components/progress-overlay.tsx
-import { promises as fs29 } from "fs";
+import { promises as fs31 } from "fs";
 import { join as join54 } from "path";
 import { useEffect as useEffect48, useMemo as useMemo27, useState as useState53 } from "react";
 import { Box as Box82, Text as Text80, useInput as useInput33 } from "ink";
@@ -30528,7 +30573,7 @@ var ProgressOverlay = () => {
     }
     const load = async () => {
       try {
-        const [stat, content] = await Promise.all([fs29.stat(progressPath), fs29.readFile(progressPath, "utf8")]);
+        const [stat, content] = await Promise.all([fs31.stat(progressPath), fs31.readFile(progressPath, "utf8")]);
         if (cancelled) return;
         const modifiedAtMs = stat.mtimeMs;
         if (content.trim().length === 0) {
@@ -30733,7 +30778,7 @@ var resolveInitialState = ({
 };
 
 // src/integration/persistence/selection/last-selection-store.ts
-import { promises as fs30 } from "fs";
+import { promises as fs32 } from "fs";
 import { join as join55 } from "path";
 var FILE_NAME = "last-selection.json";
 var createLastSelectionStore = (stateRoot) => {
@@ -30741,7 +30786,7 @@ var createLastSelectionStore = (stateRoot) => {
   return {
     async read() {
       try {
-        const raw = await fs30.readFile(path, "utf8");
+        const raw = await fs32.readFile(path, "utf8");
         const parsed = JSON.parse(raw);
         if (typeof parsed !== "object" || parsed === null) return void 0;
         const rec = parsed;
@@ -30759,10 +30804,10 @@ var createLastSelectionStore = (stateRoot) => {
     async write(value) {
       try {
         if (value === void 0) {
-          await fs30.rm(path, { force: true });
+          await fs32.rm(path, { force: true });
           return;
         }
-        await fs30.writeFile(path, JSON.stringify(value, null, 2), "utf8");
+        await fs32.writeFile(path, JSON.stringify(value, null, 2), "utf8");
       } catch {
       }
     }
@@ -30858,7 +30903,7 @@ var startHeapWatchdog = (deps) => {
 import { execFile as execFileCb } from "child_process";
 import { promisify } from "util";
 import { platform as osPlatform } from "os";
-var execFile2 = promisify(execFileCb);
+var execFile = promisify(execFileCb);
 var SHELL_TIMEOUT_MS = 5e3;
 var BELL = "\x07";
 var defaultEmitBell = () => {
@@ -30867,7 +30912,7 @@ var defaultEmitBell = () => {
   } catch {
   }
 };
-var defaultExecFile = (command, args, options) => execFile2(command, [...args], { timeout: options.timeout }).then((r) => ({
+var defaultExecFile = (command, args, options) => execFile(command, [...args], { timeout: options.timeout }).then((r) => ({
   stdout: r.stdout.toString(),
   stderr: r.stderr.toString()
 }));
@@ -31987,11 +32032,11 @@ var formatTaskLine = (t) => {
 };
 
 // src/application/ui/cli/commands/runs.ts
-import { promises as fs32 } from "fs";
+import { promises as fs34 } from "fs";
 import { createInterface } from "readline";
 
 // src/integration/ai/runs/_engine/run-enumeration.ts
-import { promises as fs31 } from "fs";
+import { promises as fs33 } from "fs";
 import { join as join57 } from "path";
 var parseRunTimestamp = (runDirName) => {
   const match = /^(\d{4})-(\d{2})-(\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z-/.exec(runDirName);
@@ -32091,7 +32136,7 @@ var listRuns = async (runsRoot) => {
   const root = String(runsRoot);
   let flowDirs;
   try {
-    flowDirs = await fs31.readdir(root, { withFileTypes: true });
+    flowDirs = await fs33.readdir(root, { withFileTypes: true });
   } catch (cause) {
     if (isErrnoException2(cause) && cause.code === "ENOENT") return Result.ok([]);
     return Result.error(
@@ -32108,7 +32153,7 @@ var listRuns = async (runsRoot) => {
     const flowPath = join57(root, flowDir.name);
     let runDirs;
     try {
-      runDirs = await fs31.readdir(flowPath, { withFileTypes: true });
+      runDirs = await fs33.readdir(flowPath, { withFileTypes: true });
     } catch (cause) {
       if (isErrnoException2(cause) && cause.code === "ENOENT") continue;
       return Result.error(
@@ -32153,7 +32198,7 @@ var computeDirSize = async (dir) => {
   let total = 0;
   let entries;
   try {
-    entries = await fs31.readdir(dir, { withFileTypes: true });
+    entries = await fs33.readdir(dir, { withFileTypes: true });
   } catch {
     return 0;
   }
@@ -32164,7 +32209,7 @@ var computeDirSize = async (dir) => {
       continue;
     }
     try {
-      const stat = await fs31.lstat(entryPath);
+      const stat = await fs33.lstat(entryPath);
       if (stat.isFile()) total += stat.size;
     } catch {
     }
@@ -32459,7 +32504,7 @@ var performPrune = async (candidates) => {
   let freedCount = 0;
   for (const candidate of candidates) {
     try {
-      await fs32.rm(String(candidate.path), { recursive: true, force: false });
+      await fs34.rm(String(candidate.path), { recursive: true, force: false });
       freedBytes += candidate.sizeBytes;
       freedCount += 1;
     } catch (cause) {

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-05-28T21:15:32.467Z",
+  "generatedAt": "2026-05-29T12:47:39.138Z",
   "assets": [
     "prompts/_partials/conventions-agents-md.md",
     "prompts/_partials/conventions-claude-md.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralphctl",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "Agent harness for long-running AI coding tasks — orchestrates Claude Code, GitHub Copilot, and OpenAI Codex across repositories",
   "homepage": "https://github.com/lukas-grigis/ralphctl",
   "type": "module",
@@ -39,6 +39,7 @@
   },
   "dependencies": {
     "commander": "^14.0.3",
+    "cross-spawn": "^7.0.6",
     "ink": "^7.0.3",
     "react": "^19.2.6",
     "typescript-result": "^3.5.2",
@@ -46,6 +47,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "@types/cross-spawn": "^6.0.6",
     "@types/node": "^25.8.0",
     "@types/react": "^19.2.14",
     "@vitest/coverage-v8": "^4.1.6",