ralphctl 0.7.1 → 0.7.2

package/dist/cli.mjs

@@ -2667,24 +2667,16 @@ var buildCodexArgs = (session, opts) => {
   const perms = sandboxFor(session.permissions);
   if (!perms.ok) return Result.error(perms.error);
   const args = ["exec"];
-  if (session.resume !== void 0) {
+  const isResume = session.resume !== void 0;
+  if (isResume) {
     args.push("resume", String(session.resume));
   }
-  args.push(
-    "--ephemeral",
-    "--skip-git-repo-check",
-    "-o",
-    opts.outputFile,
-    "--json",
-    "-m",
-    session.model,
-    "-C",
-    String(session.cwd),
-    "-s",
-    perms.value.sandbox
-  );
-  for (const root of session.additionalRoots ?? []) {
-    args.push("--add-dir", String(root));
+  args.push("--ephemeral", "--skip-git-repo-check", "-o", opts.outputFile, "--json", "-m", session.model);
+  if (!isResume) {
+    args.push("-C", String(session.cwd), "-s", perms.value.sandbox);
+    for (const root of session.additionalRoots ?? []) {
+      args.push("--add-dir", String(root));
+    }
   }
   if (opts.reasoningEffort !== void 0) {
     args.push("-c", `model_reasoning_effort=${opts.reasoningEffort}`);
@@ -2862,6 +2854,18 @@ var spawnAttempt2 = async (input) => {
     const signals = parseHarnessSignals(body, IsoTimestamp.now());
     const wrote = await writeJsonAtomic(String(session.signalsFile), signals);
     if (!wrote.ok) return { kind: "error", error: wrote.error };
+    if (session.bodyFile !== void 0) {
+      const bodyWrote = await writeTextAtomic(String(session.bodyFile), body);
+      if (!bodyWrote.ok) {
+        deps.eventBus.publish({
+          type: "log",
+          level: "warn",
+          message: `codex-provider: failed to write body file \u2014 diagnostic capture skipped`,
+          meta: { bodyFile: String(session.bodyFile), error: bodyWrote.error.message },
+          at: IsoTimestamp.now()
+        });
+      }
+    }
     return {
       kind: "success",
       output: {
@@ -3958,11 +3962,7 @@ var defaultTemplatesDir = () => TEMPLATES_DIR;
 var isNodeErrnoCode2 = (cause, code) => typeof cause === "object" && cause !== null && cause.code === code;
 
 // src/integration/ai/readiness/claude/probe.ts
-import { promises as fs8 } from "fs";
-import { basename, join as join7 } from "path";
-
-// src/domain/value/kebab-case.ts
-var toKebabCase = (input) => input.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replaceAll(/^-+|-+$/g, "");
+import { join as join8 } from "path";
 
 // src/domain/value/error/probe-error.ts
 var ProbeError = class extends Error {
@@ -3983,66 +3983,22 @@ var ProbeError = class extends Error {
   }
 };
 
-// src/integration/ai/readiness/_engine/state.ts
-var unknownState = { kind: "unknown" };
-var absentState = (evaluatedAt) => ({ kind: "absent", evaluatedAt });
-var presentState = (evaluatedAt, artifacts) => ({
-  kind: "present",
-  evaluatedAt,
-  artifacts
-});
+// src/integration/ai/readiness/_engine/probe-fs.ts
+import { promises as fs8 } from "fs";
+import { basename, join as join7 } from "path";
 
-// src/integration/ai/readiness/_engine/predicates.ts
-var isPresent = (state) => state.kind === "present";
-var hasAnyClaudeArtifact = (a) => a.claudeMd !== void 0 || a.agentsMd !== void 0 || a.settings !== void 0 || a.settingsLocal !== void 0 || a.mcpConfig !== void 0 || a.skills.length > 0 || a.commands.length > 0 || a.agents.length > 0 || a.hooks.length > 0;
-var hasAnyCopilotArtifact = (a) => a.copilotInstructions !== void 0;
+// src/domain/value/kebab-case.ts
+var toKebabCase = (input) => input.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replaceAll(/^-+|-+$/g, "");
 
-// src/integration/ai/readiness/claude/probe.ts
-var claudeProbe = {
-  tool: "claude-code",
-  async evaluate(repository, now) {
-    const root = repository.path;
-    const claudeMd = await probeFile(join7(root, "CLAUDE.md"));
-    if (!claudeMd.ok) return Result.error(claudeMd.error);
-    const agentsMd = await probeFile(join7(root, "AGENTS.md"));
-    if (!agentsMd.ok) return Result.error(agentsMd.error);
-    const settings = await probeFile(join7(root, ".claude/settings.json"));
-    if (!settings.ok) return Result.error(settings.error);
-    const settingsLocal = await probeFile(join7(root, ".claude/settings.local.json"));
-    if (!settingsLocal.ok) return Result.error(settingsLocal.error);
-    const mcpConfig = await probeFile(join7(root, ".mcp.json"));
-    if (!mcpConfig.ok) return Result.error(mcpConfig.error);
-    const skills = await probeNamedDirCollection(join7(root, ".claude/skills"), "SKILL.md");
-    if (!skills.ok) return Result.error(skills.error);
-    const commands = await probeNamedFileCollection(join7(root, ".claude/commands"));
-    if (!commands.ok) return Result.error(commands.error);
-    const agents = await probeNamedFileCollection(join7(root, ".claude/agents"));
-    if (!agents.ok) return Result.error(agents.error);
-    const hooks = await readHooks([settings.value, settingsLocal.value]);
-    if (!hooks.ok) return Result.error(hooks.error);
-    const artifacts = {
-      tool: "claude-code",
-      ...claudeMd.value !== void 0 ? { claudeMd: claudeMd.value } : {},
-      ...agentsMd.value !== void 0 ? { agentsMd: agentsMd.value } : {},
-      ...settings.value !== void 0 ? { settings: settings.value } : {},
-      ...settingsLocal.value !== void 0 ? { settingsLocal: settingsLocal.value } : {},
-      ...mcpConfig.value !== void 0 ? { mcpConfig: mcpConfig.value } : {},
-      skills: skills.value,
-      commands: commands.value,
-      agents: agents.value,
-      hooks: hooks.value
-    };
-    return Result.ok(hasAnyClaudeArtifact(artifacts) ? presentState(now, artifacts) : absentState(now));
-  }
-};
+// src/integration/ai/readiness/_engine/probe-fs.ts
 var probeFile = async (path) => {
   try {
     const stat = await fs8.stat(path);
     if (!stat.isFile()) return Result.ok(void 0);
     return Result.ok({ path });
   } catch (cause) {
-    if (isNodeErrnoCode3(cause, "ENOENT")) return Result.ok(void 0);
-    if (isNodeErrnoCode3(cause, "EACCES")) {
+    if (isNodeErrnoCode(cause, "ENOENT")) return Result.ok(void 0);
+    if (isNodeErrnoCode(cause, "EACCES")) {
       return Result.error(
         new ProbeError({ subCode: "fs-permission", message: `permission denied reading ${path}`, path, cause })
       );
@@ -4050,23 +4006,6 @@ var probeFile = async (path) => {
     return Result.error(new ProbeError({ subCode: "fs-read", message: `failed to stat ${path}`, path, cause }));
   }
 };
-var probeNamedFileCollection = async (dir) => {
-  const entries = await listDir2(dir);
-  if (!entries.ok) return Result.error(entries.error);
-  const refs = [];
-  for (const entry of entries.value) {
-    if (!entry.endsWith(".md")) continue;
-    const full = join7(dir, entry);
-    const stat = await statSafely(full);
-    if (!stat.ok) return Result.error(stat.error);
-    if (stat.value === void 0 || !stat.value.isFile()) continue;
-    const baseName = entry.slice(0, -".md".length);
-    const slug = Slug.parse(toKebabCase(baseName));
-    if (!slug.ok) continue;
-    refs.push({ name: slug.value, path: full });
-  }
-  return Result.ok(refs);
-};
 var probeNamedDirCollection = async (dir, childMarker) => {
   const entries = await listDir2(dir);
   if (!entries.ok) return Result.error(entries.error);
@@ -4086,12 +4025,29 @@ var probeNamedDirCollection = async (dir, childMarker) => {
   }
   return Result.ok(refs);
 };
+var probeNamedFileCollection = async (dir) => {
+  const entries = await listDir2(dir);
+  if (!entries.ok) return Result.error(entries.error);
+  const refs = [];
+  for (const entry of entries.value) {
+    if (!entry.endsWith(".md")) continue;
+    const full = join7(dir, entry);
+    const stat = await statSafely(full);
+    if (!stat.ok) return Result.error(stat.error);
+    if (stat.value === void 0 || !stat.value.isFile()) continue;
+    const baseName = entry.slice(0, -".md".length);
+    const slug = Slug.parse(toKebabCase(baseName));
+    if (!slug.ok) continue;
+    refs.push({ name: slug.value, path: full });
+  }
+  return Result.ok(refs);
+};
 var listDir2 = async (dir) => {
   try {
     return Result.ok(await fs8.readdir(dir));
   } catch (cause) {
-    if (isNodeErrnoCode3(cause, "ENOENT") || isNodeErrnoCode3(cause, "ENOTDIR")) return Result.ok([]);
-    if (isNodeErrnoCode3(cause, "EACCES")) {
+    if (isNodeErrnoCode(cause, "ENOENT") || isNodeErrnoCode(cause, "ENOTDIR")) return Result.ok([]);
+    if (isNodeErrnoCode(cause, "EACCES")) {
       return Result.error(
         new ProbeError({ subCode: "fs-permission", message: `permission denied listing ${dir}`, path: dir, cause })
       );
@@ -4103,8 +4059,8 @@ var statSafely = async (path) => {
   try {
     return Result.ok(await fs8.stat(path));
   } catch (cause) {
-    if (isNodeErrnoCode3(cause, "ENOENT")) return Result.ok(void 0);
-    if (isNodeErrnoCode3(cause, "EACCES")) {
+    if (isNodeErrnoCode(cause, "ENOENT")) return Result.ok(void 0);
+    if (isNodeErrnoCode(cause, "EACCES")) {
       return Result.error(
         new ProbeError({ subCode: "fs-permission", message: `permission denied stat ${path}`, path, cause })
       );
@@ -4112,6 +4068,73 @@ var statSafely = async (path) => {
     return Result.error(new ProbeError({ subCode: "fs-read", message: `failed to stat ${path}`, path, cause }));
   }
 };
+var readFileSafely = async (path) => {
+  try {
+    return Result.ok(await fs8.readFile(path, "utf8"));
+  } catch (cause) {
+    if (isNodeErrnoCode(cause, "ENOENT")) return Result.ok(void 0);
+    if (isNodeErrnoCode(cause, "EACCES")) {
+      return Result.error(
+        new ProbeError({ subCode: "fs-permission", message: `permission denied reading ${path}`, path, cause })
+      );
+    }
+    return Result.error(new ProbeError({ subCode: "fs-read", message: `failed to read ${path}`, path, cause }));
+  }
+};
+
+// src/integration/ai/readiness/_engine/state.ts
+var unknownState = { kind: "unknown" };
+var absentState = (evaluatedAt) => ({ kind: "absent", evaluatedAt });
+var presentState = (evaluatedAt, artifacts) => ({
+  kind: "present",
+  evaluatedAt,
+  artifacts
+});
+
+// src/integration/ai/readiness/_engine/predicates.ts
+var isPresent = (state) => state.kind === "present";
+var hasAnyClaudeArtifact = (a) => a.claudeMd !== void 0 || a.agentsMd !== void 0 || a.settings !== void 0 || a.settingsLocal !== void 0 || a.mcpConfig !== void 0 || a.skills.length > 0 || a.commands.length > 0 || a.agents.length > 0 || a.hooks.length > 0;
+var hasAnyCopilotArtifact = (a) => a.copilotInstructions !== void 0;
+var hasAnyCodexArtifact = (a) => a.agentsMd !== void 0 || a.skills.length > 0;
+
+// src/integration/ai/readiness/claude/probe.ts
+var claudeProbe = {
+  tool: "claude-code",
+  async evaluate(repository, now) {
+    const root = repository.path;
+    const claudeMd = await probeFile(join8(root, "CLAUDE.md"));
+    if (!claudeMd.ok) return Result.error(claudeMd.error);
+    const agentsMd = await probeFile(join8(root, "AGENTS.md"));
+    if (!agentsMd.ok) return Result.error(agentsMd.error);
+    const settings = await probeFile(join8(root, ".claude/settings.json"));
+    if (!settings.ok) return Result.error(settings.error);
+    const settingsLocal = await probeFile(join8(root, ".claude/settings.local.json"));
+    if (!settingsLocal.ok) return Result.error(settingsLocal.error);
+    const mcpConfig = await probeFile(join8(root, ".mcp.json"));
+    if (!mcpConfig.ok) return Result.error(mcpConfig.error);
+    const skills = await probeNamedDirCollection(join8(root, ".claude/skills"), "SKILL.md");
+    if (!skills.ok) return Result.error(skills.error);
+    const commands = await probeNamedFileCollection(join8(root, ".claude/commands"));
+    if (!commands.ok) return Result.error(commands.error);
+    const agents = await probeNamedFileCollection(join8(root, ".claude/agents"));
+    if (!agents.ok) return Result.error(agents.error);
+    const hooks = await readHooks([settings.value, settingsLocal.value]);
+    if (!hooks.ok) return Result.error(hooks.error);
+    const artifacts = {
+      tool: "claude-code",
+      ...claudeMd.value !== void 0 ? { claudeMd: claudeMd.value } : {},
+      ...agentsMd.value !== void 0 ? { agentsMd: agentsMd.value } : {},
+      ...settings.value !== void 0 ? { settings: settings.value } : {},
+      ...settingsLocal.value !== void 0 ? { settingsLocal: settingsLocal.value } : {},
+      ...mcpConfig.value !== void 0 ? { mcpConfig: mcpConfig.value } : {},
+      skills: skills.value,
+      commands: commands.value,
+      agents: agents.value,
+      hooks: hooks.value
+    };
+    return Result.ok(hasAnyClaudeArtifact(artifacts) ? presentState(now, artifacts) : absentState(now));
+  }
+};
 var readHooks = async (settingsRefs) => {
   const hooks = [];
   for (const ref2 of settingsRefs) {
@@ -4131,19 +4154,6 @@ var readHooks = async (settingsRefs) => {
   }
   return Result.ok(hooks);
 };
-var readFileSafely = async (path) => {
-  try {
-    return Result.ok(await fs8.readFile(path, "utf8"));
-  } catch (cause) {
-    if (isNodeErrnoCode3(cause, "ENOENT")) return Result.ok(void 0);
-    if (isNodeErrnoCode3(cause, "EACCES")) {
-      return Result.error(
-        new ProbeError({ subCode: "fs-permission", message: `permission denied reading ${path}`, path, cause })
-      );
-    }
-    return Result.error(new ProbeError({ subCode: "fs-read", message: `failed to read ${path}`, path, cause }));
-  }
-};
 var extractHooks = (settings, sink) => {
   if (typeof settings !== "object" || settings === null) return;
   const hooks = settings.hooks;
@@ -4164,33 +4174,41 @@ var extractHooks = (settings, sink) => {
     }
   }
 };
-var isNodeErrnoCode3 = (cause, code) => typeof cause === "object" && cause !== null && cause.code === code;
 
 // src/integration/ai/readiness/codex/probe.ts
+import { join as join9 } from "path";
 var codexProbe = {
   tool: "codex",
-  evaluate(repository, now) {
-    void repository;
-    void now;
-    return Promise.resolve(Result.ok(unknownState));
+  async evaluate(repository, now) {
+    const root = repository.path;
+    const agentsMd = await probeFile(join9(root, "AGENTS.md"));
+    if (!agentsMd.ok) return Result.error(agentsMd.error);
+    const skills = await probeNamedDirCollection(join9(root, ".agents/skills"), "SKILL.md");
+    if (!skills.ok) return Result.error(skills.error);
+    const artifacts = {
+      tool: "codex",
+      ...agentsMd.value !== void 0 ? { agentsMd: agentsMd.value } : {},
+      skills: skills.value
+    };
+    return Result.ok(hasAnyCodexArtifact(artifacts) ? presentState(now, artifacts) : absentState(now));
   }
 };
 
 // src/integration/ai/readiness/copilot/probe.ts
 import { promises as fs9 } from "fs";
-import { join as join8 } from "path";
+import { join as join10 } from "path";
 var copilotProbe = {
   tool: "copilot",
   async evaluate(repository, now) {
-    const path = join8(repository.path, ".github/copilot-instructions.md");
+    const path = join10(repository.path, ".github/copilot-instructions.md");
     try {
       const stat = await fs9.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));
     } catch (cause) {
-      if (isNodeErrnoCode4(cause, "ENOENT")) return Result.ok(absentState(now));
-      if (isNodeErrnoCode4(cause, "EACCES")) {
+      if (isNodeErrnoCode(cause, "ENOENT")) return Result.ok(absentState(now));
+      if (isNodeErrnoCode(cause, "EACCES")) {
         return Result.error(
           new ProbeError({ subCode: "fs-permission", message: `permission denied reading ${path}`, path, cause })
         );
@@ -4199,7 +4217,6 @@ var copilotProbe = {
     }
   }
 };
-var isNodeErrnoCode4 = (cause, code) => typeof cause === "object" && cause !== null && cause.code === code;
 
 // src/integration/observability/in-memory-event-bus.ts
 var createInMemoryEventBus = () => {
@@ -4247,7 +4264,7 @@ var loggerForScope = (deps, scope) => {
 };
 
 // src/integration/version/npm-version-checker.ts
-import { join as join9 } from "path";
+import { join as join11 } from "path";
 import { z as z15 } from "zod";
 
 // src/business/version/version-check.ts
@@ -4289,7 +4306,7 @@ var buildVersionCheck = (current, latest, now) => ({
 var DEFAULT_CACHE_TTL_MS = 60 * 60 * 1e3;
 var DEFAULT_FETCH_TIMEOUT_MS = 3e3;
 var RegistryPayloadSchema = z15.object({ version: z15.string() });
-var cachePath = (stateRoot) => join9(String(stateRoot), "version-check.json");
+var cachePath = (stateRoot) => join11(String(stateRoot), "version-check.json");
 var registryUrl = (packageName) => `https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`;
 var shouldSkip = (env) => env["NO_NETWORK"] !== void 0 || env["VITEST"] !== void 0;
 var readCache = async (path) => {
@@ -4343,7 +4360,7 @@ var createNpmVersionChecker = (deps) => {
 // package.json
 var package_default = {
   name: "ralphctl",
-  version: "0.7.1",
+  version: "0.7.2",
   description: "Agent harness for long-running AI coding tasks \u2014 orchestrates Claude Code & GitHub Copilot across repositories",
   homepage: "https://github.com/lukas-grigis/ralphctl",
   type: "module",
@@ -4445,11 +4462,11 @@ var CLI_METADATA = {
 // src/integration/ai/skills/_engine/filesystem-skills-adapter.ts
 import { existsSync } from "fs";
 import { mkdir, rm, rmdir, writeFile } from "fs/promises";
-import { join as join11 } from "path";
+import { join as join13 } from "path";
 
 // src/integration/io/git-exclude.ts
 import { promises as fs10 } from "fs";
-import { isAbsolute as isAbsolute2, join as join10 } from "path";
+import { isAbsolute as isAbsolute2, join as join12 } from "path";
 var ensureGitExcludeWildcard = async (repoRoot, pattern) => {
   const resolved = await resolveExcludePath(String(repoRoot));
   if (resolved === void 0) return Result.ok(void 0);
@@ -4457,7 +4474,7 @@ var ensureGitExcludeWildcard = async (repoRoot, pattern) => {
   try {
     existing = await fs10.readFile(resolved, "utf8");
   } catch (cause) {
-    if (isNodeErrnoCode5(cause, "ENOENT")) {
+    if (isNodeErrnoCode3(cause, "ENOENT")) {
     } else {
       return Result.error(
         new StorageError({
@@ -4478,16 +4495,16 @@ var ensureGitExcludeWildcard = async (repoRoot, pattern) => {
   return writeTextAtomic(resolved, next);
 };
 var resolveExcludePath = async (repoRoot) => {
-  const gitMarker = join10(repoRoot, ".git");
+  const gitMarker = join12(repoRoot, ".git");
   let stat;
   try {
     stat = await fs10.stat(gitMarker);
   } catch (cause) {
-    if (isNodeErrnoCode5(cause, "ENOENT") || isNodeErrnoCode5(cause, "ENOTDIR")) return void 0;
+    if (isNodeErrnoCode3(cause, "ENOENT") || isNodeErrnoCode3(cause, "ENOTDIR")) return void 0;
     throw cause;
   }
   if (stat.isDirectory()) {
-    return join10(gitMarker, "info", "exclude");
+    return join12(gitMarker, "info", "exclude");
   }
   if (!stat.isFile()) return void 0;
   let pointer;
@@ -4499,10 +4516,10 @@ var resolveExcludePath = async (repoRoot) => {
   const match = /^gitdir:\s*(.+)\s*$/m.exec(pointer);
   if (match === null) return void 0;
   const gitdir = match[1].trim();
-  const absoluteGitdir = isAbsolute2(gitdir) ? gitdir : join10(repoRoot, gitdir);
-  return join10(absoluteGitdir, "info", "exclude");
+  const absoluteGitdir = isAbsolute2(gitdir) ? gitdir : join12(repoRoot, gitdir);
+  return join12(absoluteGitdir, "info", "exclude");
 };
-var isNodeErrnoCode5 = (cause, code) => typeof cause === "object" && cause !== null && cause.code === code;
+var isNodeErrnoCode3 = (cause, code) => typeof cause === "object" && cause !== null && cause.code === code;
 
 // src/integration/ai/skills/_engine/filesystem-skills-adapter.ts
 var renderSkill = (skill) => {
@@ -4525,7 +4542,7 @@ var tryRmdirIfEmpty = async (path) => {
 var createFilesystemSkillsAdapter = (deps) => {
   const installed = /* @__PURE__ */ new Map();
   const excludeAttempted = /* @__PURE__ */ new Set();
-  const skillsSubdir = join11(deps.parentDir, "skills");
+  const skillsSubdir = join13(deps.parentDir, "skills");
   const excludePattern = `${skillsSubdir}/ralphctl-*`;
   const pruneStale = () => {
     for (const key of [...installed.keys()]) {
@@ -4535,14 +4552,14 @@ var createFilesystemSkillsAdapter = (deps) => {
   return {
     async install(sessionDir, skills) {
       pruneStale();
-      const skillsDir = join11(String(sessionDir), skillsSubdir);
+      const skillsDir = join13(String(sessionDir), skillsSubdir);
       const tracked = installed.get(String(sessionDir)) ?? /* @__PURE__ */ new Set();
       for (const skill of skills) {
-        const dst = join11(skillsDir, skill.name);
+        const dst = join13(skillsDir, skill.name);
         if (existsSync(dst)) continue;
         try {
           await mkdir(dst, { recursive: true });
-          await writeFile(join11(dst, "SKILL.md"), renderSkill(skill), "utf-8");
+          await writeFile(join13(dst, "SKILL.md"), renderSkill(skill), "utf-8");
           tracked.add(skill.name);
         } catch (cause) {
           if (tracked.size > 0) installed.set(String(sessionDir), tracked);
@@ -4573,10 +4590,10 @@ var createFilesystemSkillsAdapter = (deps) => {
       const key = String(sessionDir);
       const tracked = installed.get(key);
       if (tracked === void 0 || tracked.size === 0) return Result.ok(void 0);
-      const skillsDir = join11(key, skillsSubdir);
+      const skillsDir = join13(key, skillsSubdir);
       try {
         for (const id of tracked) {
-          await rm(join11(skillsDir, id), { recursive: true, force: true });
+          await rm(join13(skillsDir, id), { recursive: true, force: true });
         }
         installed.delete(key);
       } catch (cause) {
@@ -4590,7 +4607,7 @@ var createFilesystemSkillsAdapter = (deps) => {
         );
       }
       await tryRmdirIfEmpty(skillsDir);
-      await tryRmdirIfEmpty(join11(key, deps.parentDir));
+      await tryRmdirIfEmpty(join13(key, deps.parentDir));
       return Result.ok(void 0);
     }
   };
@@ -4652,7 +4669,7 @@ var createSkillsAdapter = (deps) => {
 };
 
 // src/integration/ai/skills/bundled/source.ts
-import { dirname as dirname7, join as join12 } from "path";
+import { dirname as dirname7, join as join14 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { readFile } from "fs/promises";
 
@@ -4681,7 +4698,7 @@ var skillsForFlow = (flowId) => FLOW_SKILLS[flowId];
 var defaultBundledRoot = (() => {
   const here = dirname7(fileURLToPath2(import.meta.url));
   const isBundled = import.meta.url.endsWith("/cli.mjs") || import.meta.url.endsWith("\\cli.mjs");
-  return isBundled ? join12(here, "skills") : here;
+  return isBundled ? join14(here, "skills") : here;
 })();
 var splitFrontmatter = (raw) => {
   const trimmed = raw.replace(/^\uFEFF/u, "");
@@ -4709,7 +4726,7 @@ var parseSimpleYaml = (input) => {
   return result;
 };
 var readSkill = async (root, name) => {
-  const path = join12(root, name, "SKILL.md");
+  const path = join14(root, name, "SKILL.md");
   let raw;
   try {
     raw = await readFile(path, "utf-8");
@@ -5699,13 +5716,13 @@ var probeGitConfig = async (id, label, key, runCommand2, hint) => {
   }
   return { id, label, status: "warn", detail: `${key} not set`, hint, group: "vcs" };
 };
-var probeCliAuth = async (id, label, binary, args, hint, runCommand2) => {
+var probeCliAuth = async (id, label, binary, args, hint, runCommand2, group = "vcs") => {
   const r = await runCommand2(binary, args);
   if (r.ok) {
-    return { id, label, status: "pass", detail: "authenticated", group: "vcs" };
+    return { id, label, status: "pass", detail: "authenticated", group };
   }
   const detail = r.stderr.split("\n").find((line) => line.trim().length > 0)?.trim() ?? "not authenticated";
-  return { id, label, status: "warn", detail, hint, group: "vcs" };
+  return { id, label, status: "warn", detail, hint, group };
 };
 var createDoctorFlow = (deps) => leaf("doctor", {
   useCase: {
@@ -5817,6 +5834,7 @@ var createDoctorFlow = (deps) => leaf("doctor", {
       }
       const settings = await deps.settingsRepo.load();
       const configuredProvider = settings.ok ? settings.value.ai.provider : void 0;
+      let codexInstalled = false;
       for (const provider of Object.keys(PROVIDER_BINARY)) {
         const binary = PROVIDER_BINARY[provider];
         const isConfigured = provider === configuredProvider;
@@ -5828,12 +5846,26 @@ var createDoctorFlow = (deps) => leaf("doctor", {
           deps.commandExists,
           `install the '${binary}' CLI and ensure it is on your PATH`
         );
+        if (provider === "openai-codex") codexInstalled = probe.status === "pass";
         if (probe.status === "fail") {
           probes.push({ ...probe, status: "warn" });
         } else {
           probes.push(probe);
         }
       }
+      if (configuredProvider === "openai-codex" && codexInstalled) {
+        probes.push(
+          await probeCliAuth(
+            "codex-auth",
+            "OpenAI Codex CLI authenticated",
+            "codex",
+            ["login", "status"],
+            "run `codex login` to sign in",
+            deps.runCommand,
+            "ai"
+          )
+        );
+      }
       const projects = await deps.projectRepo.list();
       probes.push({
         id: "projects-list",
@@ -9176,14 +9208,14 @@ var launchAddTickets = (ctx) => {
 };
 
 // src/application/ui/shared/launch/refine.ts
-import { join as join15 } from "path";
+import { join as join17 } from "path";
 
 // src/application/flows/refine/flow.ts
-import { join as join14 } from "path";
+import { join as join16 } from "path";
 
 // src/application/flows/_shared/build-unit.ts
 import { promises as fs11 } from "fs";
-import { join as join13 } from "path";
+import { join as join15 } from "path";
 var buildUnitLeaf = (opts) => leaf(opts.name, {
   useCase: {
     execute: async (input) => {
@@ -9204,7 +9236,7 @@ var buildUnitLeaf = (opts) => leaf(opts.name, {
       return Result.ok(parsed.value);
     }
   },
-  input: (ctx) => ({ path: join13(String(opts.parent(ctx)), opts.slug(ctx)) }),
+  input: (ctx) => ({ path: join15(String(opts.parent(ctx)), opts.slug(ctx)) }),
   output: (ctx, root) => opts.write(ctx, root)
 });
 
@@ -9666,8 +9698,8 @@ var createRefineFlow = (deps, opts) => {
         parent: () => opts.refinementRoot,
         slug: () => ticketSlug(ticket),
         write: (ctx, root) => {
-          const promptPath = AbsolutePath.parse(join14(String(root), "prompt.md"));
-          const outputPath = AbsolutePath.parse(join14(String(root), "requirements.md"));
+          const promptPath = AbsolutePath.parse(join16(String(root), "prompt.md"));
+          const outputPath = AbsolutePath.parse(join16(String(root), "requirements.md"));
           if (!promptPath.ok || !outputPath.ok) {
             throw promptPath.ok ? outputPath.ok ? new Error("unreachable") : outputPath.error : promptPath.error;
           }
@@ -9768,7 +9800,7 @@ var launchRefine = async (ctx) => {
   if (!snapshot.sprint) return { ok: false, reason: "No sprint selected." };
   const pending = snapshot.sprint.tickets.filter((t) => t.status === "pending");
   const refinementRoot = AbsolutePath.parse(
-    join15(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "refinement")
+    join17(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "refinement")
   );
   if (!refinementRoot.ok) return { ok: false, reason: refinementRoot.error.message };
   let defaultIssueOrigin = snapshot.project?.defaultIssueOrigin;
@@ -9841,10 +9873,10 @@ ${body.trim()}`;
 };
 
 // src/application/ui/shared/launch/plan.ts
-import { join as join17 } from "path";
+import { join as join19 } from "path";
 
 // src/application/flows/plan/flow.ts
-import { join as join16 } from "path";
+import { join as join18 } from "path";
 
 // src/application/flows/_shared/sprint/load-execution.ts
 var loadSprintExecutionLeaf = (deps, name = "load-sprint-execution") => leaf(name, {
@@ -10585,8 +10617,8 @@ var createPlanFlow = (deps, opts) => {
       parent: () => opts.planRoot,
       slug: () => slug,
       write: (ctx, root) => {
-        const promptPath = AbsolutePath.parse(join16(String(root), "prompt.md"));
-        const outputPath = AbsolutePath.parse(join16(String(root), "plan.json"));
+        const promptPath = AbsolutePath.parse(join18(String(root), "prompt.md"));
+        const outputPath = AbsolutePath.parse(join18(String(root), "plan.json"));
         if (!promptPath.ok) throw promptPath.error;
         if (!outputPath.ok) throw outputPath.error;
         return {
@@ -10676,7 +10708,7 @@ var launchPlan = (ctx) => {
   if (!snapshot.project) return { ok: false, reason: "No project loaded." };
   if (!snapshot.sprint) return { ok: false, reason: "No sprint selected." };
   const planRoot = AbsolutePath.parse(
-    join17(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "plan")
+    join19(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "plan")
   );
   if (!planRoot.ok) return { ok: false, reason: planRoot.error.message };
   const reviewBeforeApprove = async (proposedTasks) => {
@@ -10730,7 +10762,7 @@ ${summary}`;
 };
 
 // src/application/ui/shared/launch/implement.ts
-import { join as join21 } from "path";
+import { join as join23 } from "path";
 
 // src/application/chain/build/guard.ts
 var guard = (name, predicate, body) => ({
@@ -11643,9 +11675,9 @@ var implementSession = (sandboxCwd, repoPath, prompt, model, signalsFile) => ({
 });
 
 // src/application/flows/implement/leaves/round-artifacts.ts
-import { join as join18 } from "path";
+import { join as join20 } from "path";
 var nextRoundNum = async (workspaceRoot) => {
-  const entries = await listDir(join18(String(workspaceRoot), "rounds"));
+  const entries = await listDir(join20(String(workspaceRoot), "rounds"));
   if (!entries.ok) return 1;
   let max = 0;
   for (const name of entries.value) {
@@ -11654,12 +11686,12 @@ var nextRoundNum = async (workspaceRoot) => {
   }
   return max + 1;
 };
-var roundSignalsPath = (workspaceRoot, round, role) => join18(String(workspaceRoot), "rounds", String(round), role, "signals.json");
-var roundEvaluationRelativePath = (round) => join18("rounds", String(round), "evaluator", "evaluation.md");
-var roundDir = (workspaceRoot, round, role) => join18(String(workspaceRoot), "rounds", String(round), role);
+var roundSignalsPath = (workspaceRoot, round, role) => join20(String(workspaceRoot), "rounds", String(round), role, "signals.json");
+var roundEvaluationRelativePath = (round) => join20("rounds", String(round), "evaluator", "evaluation.md");
+var roundDir = (workspaceRoot, round, role) => join20(String(workspaceRoot), "rounds", String(round), role);
 var writeEvaluatorRoundArtifacts = async (workspaceRoot, round, signals, logger) => {
   const base = roundDir(workspaceRoot, round, "evaluator");
-  const evaluation = await writeTextAtomic(join18(base, "evaluation.md"), renderEvaluation(findEvaluation2(signals)));
+  const evaluation = await writeTextAtomic(join20(base, "evaluation.md"), renderEvaluation(findEvaluation2(signals)));
   if (!evaluation.ok) {
     logger?.warn("failed to write evaluator round artifact", { round, base, error: evaluation.error.message });
   }
@@ -12783,7 +12815,7 @@ var startAttemptLeaf = (deps, taskId) => leaf(
 
 // src/application/flows/implement/leaves/build-task-workspace.ts
 import { promises as fs16 } from "fs";
-import { join as join19 } from "path";
+import { join as join21 } from "path";
 var renderDoneCriteria = (task) => {
   const header = `# Done criteria \u2014 ${task.name}
 
@@ -12816,7 +12848,7 @@ var buildTaskWorkspaceLeaf = (deps, opts, taskId) => leaf(`build-task-workspace-
   useCase: {
     execute: async (input) => {
       const log = deps.logger.named("implement.workspace");
-      const workspaceRoot = join19(String(opts.sprintDir), "implement", String(input.task.id));
+      const workspaceRoot = join21(String(opts.sprintDir), "implement", String(input.task.id));
       const prompt = await buildImplementPrompt(deps.templateLoader, {
         task: input.task,
         projectPath: String(opts.cwd),
@@ -12824,10 +12856,10 @@ var buildTaskWorkspaceLeaf = (deps, opts, taskId) => leaf(`build-task-workspace-
         ...opts.checkScript !== void 0 ? { checkScript: opts.checkScript } : {}
       });
       if (!prompt.ok) return Result.error(prompt.error);
-      const wrotePrompt = await writeOrError(join19(workspaceRoot, "prompt.md"), String(prompt.value));
+      const wrotePrompt = await writeOrError(join21(workspaceRoot, "prompt.md"), String(prompt.value));
       if (!wrotePrompt.ok) return Result.error(wrotePrompt.error);
       const wroteCriteria = await writeOrError(
-        join19(workspaceRoot, "done-criteria.md"),
+        join21(workspaceRoot, "done-criteria.md"),
         renderDoneCriteria(input.task)
       );
       if (!wroteCriteria.ok) return Result.error(wroteCriteria.error);
@@ -12898,15 +12930,20 @@ var transitionSprintToReviewLeaf = (deps) => leaf("transition-sprint-to-review",
 
 // src/integration/io/lock-paths.ts
 import { createHash } from "crypto";
-import { join as join20 } from "path";
+import { join as join22 } from "path";
 var repoLockFile = (locksRoot, worktreePath) => {
   const hash = createHash("sha1").update(String(worktreePath)).digest("hex").slice(0, 16);
-  return AbsolutePath.parse(join20(String(locksRoot), `repo-${hash}.lock`));
+  return AbsolutePath.parse(join22(String(locksRoot), `repo-${hash}.lock`));
 };
 
 // src/application/flows/implement/leaves/with-repo-lock.ts
 var withRepoLock = (opts, inner) => ({
   name: `with-repo-lock(${inner.name})`,
+  // Expose the wrapped chain through the composite-pattern `children` slot so `flattenLeaves`
+  // walks into it when the TUI builds its planned-leaf list. Without this the wrapper looked
+  // like an opaque single leaf and the Flow-steps panel rendered only "with-repo-lock(…)" —
+  // never the real setup / per-task / teardown sequence inside the lock.
+  children: [inner],
   async execute(ctx, signal, onTrace) {
     const lockPath = repoLockFile(opts.locksRoot, opts.worktreePath);
     if (!lockPath.ok) {
@@ -13196,11 +13233,11 @@ var launchImplement = (ctx) => {
     return a.status === "in_progress" ? -1 : 1;
   });
   if (todoTasks.length === 0) return { ok: false, reason: "No tasks to implement or resume." };
-  const sprintDirPath = AbsolutePath.parse(join21(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id)));
+  const sprintDirPath = AbsolutePath.parse(join23(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id)));
   if (!sprintDirPath.ok) return { ok: false, reason: sprintDirPath.error.message };
-  const progressPath = AbsolutePath.parse(join21(String(sprintDirPath.value), "progress.md"));
+  const progressPath = AbsolutePath.parse(join23(String(sprintDirPath.value), "progress.md"));
   if (!progressPath.ok) return { ok: false, reason: progressPath.error.message };
-  const chainLogPath = AbsolutePath.parse(join21(String(sprintDirPath.value), "chain.log"));
+  const chainLogPath = AbsolutePath.parse(join23(String(sprintDirPath.value), "chain.log"));
   if (!chainLogPath.ok) return { ok: false, reason: chainLogPath.error.message };
   const chainLog = startFileLogSink({ file: chainLogPath.value, bus: deps.app.eventBus });
   const repositories = /* @__PURE__ */ new Map();
@@ -13265,7 +13302,7 @@ var launchImplement = (ctx) => {
 };
 
 // src/application/ui/shared/launch/review.ts
-import { join as join23 } from "path";
+import { join as join25 } from "path";
 
 // src/application/flows/review/leaves/ensure-feedback-file.ts
 import { promises as fs18 } from "fs";
@@ -13508,12 +13545,12 @@ var buildApplyFeedbackPrompt = async (deps, input) => buildPrompt(deps, applyFee
 
 // src/integration/ai/signals/_engine/temp-signals-file.ts
 import { tmpdir as tmpdir2 } from "os";
-import { join as join22 } from "path";
+import { join as join24 } from "path";
 var counter = 0;
 var allocSignalsTempPath = (label) => {
   counter += 1;
   const filename = `ralphctl-signals-${label}-${String(process.pid)}-${String(Date.now())}-${String(counter)}.json`;
-  return AbsolutePath.parse(join22(tmpdir2(), filename));
+  return AbsolutePath.parse(join24(tmpdir2(), filename));
 };
 var withSignalsTempPath = async (label, fn) => {
   const path = allocSignalsTempPath(label);
@@ -13772,11 +13809,11 @@ var launchReview = (ctx) => {
   if (!snapshot.sprint) return { ok: false, reason: "No sprint selected." };
   if (!cwd) return { ok: false, reason: "No repository path resolvable from the project." };
   const feedbackPath = AbsolutePath.parse(
-    join23(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "feedback.md")
+    join25(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "feedback.md")
   );
   if (!feedbackPath.ok) return { ok: false, reason: feedbackPath.error.message };
   const progressPath = AbsolutePath.parse(
-    join23(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "progress.md")
+    join25(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "progress.md")
   );
   if (!progressPath.ok) return { ok: false, reason: progressPath.error.message };
   const checkScript = snapshot.project?.repositories.find((r) => r.checkScript !== void 0)?.checkScript;
@@ -14005,11 +14042,11 @@ var probeReadinessLeaf = (deps) => leaf("probe", {
 import { promises as fs21 } from "fs";
 
 // src/integration/ai/readiness/_engine/setup.ts
-import { join as join25 } from "path";
+import { join as join27 } from "path";
 
 // src/integration/ai/runs/_engine/run-artifacts.ts
 import { promises as fs20 } from "fs";
-import { join as join24 } from "path";
+import { join as join26 } from "path";
 var BODY_PREVIEW_LIMIT = 800;
 var buildRunDirName = () => {
   const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -14019,7 +14056,7 @@ var buildRunDirName = () => {
 var readRunBodyPreview = async (runDir, options) => {
   let raw;
   try {
-    raw = await fs20.readFile(join24(String(runDir), "body.txt"), "utf8");
+    raw = await fs20.readFile(join26(String(runDir), "body.txt"), "utf8");
   } catch (cause) {
     if (isErrnoException(cause) && cause.code === "ENOENT") return void 0;
     const code = isErrnoException(cause) ? cause.code : "unknown";
@@ -14148,11 +14185,11 @@ var setupReadinessUseCase = async (deps, input) => {
     ...input.existingContextFile !== void 0 ? { existingContextFile: input.existingContextFile } : {}
   });
   if (!prompt.ok) return Result.error(prompt.error);
-  const runDir = AbsolutePath.parse(join25(String(deps.runsRoot), "readiness", buildRunDirName()));
+  const runDir = AbsolutePath.parse(join27(String(deps.runsRoot), "readiness", buildRunDirName()));
   if (!runDir.ok) return Result.error(runDir.error);
-  const promptFile = AbsolutePath.parse(join25(String(runDir.value), "prompt.md"));
+  const promptFile = AbsolutePath.parse(join27(String(runDir.value), "prompt.md"));
   if (!promptFile.ok) return Result.error(promptFile.error);
-  const bodyFile = AbsolutePath.parse(join25(String(runDir.value), "body.txt"));
+  const bodyFile = AbsolutePath.parse(join27(String(runDir.value), "body.txt"));
   if (!bodyFile.ok) return Result.error(bodyFile.error);
   const promptWrote = await writeTextAtomic(String(promptFile.value), String(prompt.value));
   if (!promptWrote.ok) return Result.error(promptWrote.error);
@@ -14201,7 +14238,7 @@ var setupReadinessUseCase = async (deps, input) => {
     const verifyScript = signals.value.find(
       (s) => s.type === "verify-script"
     )?.command;
-    const targetPath = AbsolutePath.parse(join25(String(input.repository.path), targetPathFor(input.tool)));
+    const targetPath = AbsolutePath.parse(join27(String(input.repository.path), targetPathFor(input.tool)));
     if (!targetPath.ok) return Result.error(targetPath.error);
     log.info(`proposal ready for repo ${input.repository.name}`, {
       repositoryId: String(input.repository.id),
@@ -14267,6 +14304,9 @@ var pickExistingContextPath = (tool, state) => {
   if (tool === "copilot" && a.tool === "copilot") {
     return a.copilotInstructions !== void 0 ? String(a.copilotInstructions.path) : void 0;
   }
+  if (tool === "codex" && a.tool === "codex") {
+    return a.agentsMd !== void 0 ? String(a.agentsMd.path) : void 0;
+  }
   return void 0;
 };
 var proposeReadinessLeaf = (deps) => leaf("propose", {
@@ -14447,7 +14487,7 @@ var launchReadiness = (ctx) => {
 };
 
 // src/application/flows/detect-skills/leaves/propose.ts
-import { join as join26 } from "path";
+import { join as join28 } from "path";
 
 // src/integration/ai/prompts/detect-skills/definition.ts
 var detectSkillsPromptDef = {
@@ -14511,11 +14551,11 @@ var proposeUseCase = async (deps, input) => {
     skillsConvention: deps.skillsAdapter.describeSkillsConvention()
   });
   if (!prompt.ok) return Result.error(prompt.error);
-  const runDir = AbsolutePath.parse(join26(String(deps.runsRoot), "detect-skills", buildRunDirName()));
+  const runDir = AbsolutePath.parse(join28(String(deps.runsRoot), "detect-skills", buildRunDirName()));
   if (!runDir.ok) return Result.error(runDir.error);
-  const promptFile = AbsolutePath.parse(join26(String(runDir.value), "prompt.md"));
+  const promptFile = AbsolutePath.parse(join28(String(runDir.value), "prompt.md"));
   if (!promptFile.ok) return Result.error(promptFile.error);
-  const bodyFile = AbsolutePath.parse(join26(String(runDir.value), "body.txt"));
+  const bodyFile = AbsolutePath.parse(join28(String(runDir.value), "body.txt"));
   if (!bodyFile.ok) return Result.error(bodyFile.error);
   const promptWrote = await writeTextAtomic(String(promptFile.value), String(prompt.value));
   if (!promptWrote.ok) return Result.error(promptWrote.error);
@@ -15129,7 +15169,7 @@ var launchDetectSkills = (ctx) => {
 };
 
 // src/application/flows/detect-scripts/leaves/propose.ts
-import { join as join27 } from "path";
+import { join as join29 } from "path";
 
 // src/integration/ai/prompts/detect-scripts/definition.ts
 var detectScriptsPromptDef = {
@@ -15174,11 +15214,11 @@ var proposeUseCase2 = async (deps, input) => {
     repositoryPath: String(input.repository.path)
   });
   if (!prompt.ok) return Result.error(prompt.error);
-  const runDir = AbsolutePath.parse(join27(String(deps.runsRoot), "detect-scripts", buildRunDirName()));
+  const runDir = AbsolutePath.parse(join29(String(deps.runsRoot), "detect-scripts", buildRunDirName()));
   if (!runDir.ok) return Result.error(runDir.error);
-  const promptFile = AbsolutePath.parse(join27(String(runDir.value), "prompt.md"));
+  const promptFile = AbsolutePath.parse(join29(String(runDir.value), "prompt.md"));
   if (!promptFile.ok) return Result.error(promptFile.error);
-  const bodyFile = AbsolutePath.parse(join27(String(runDir.value), "body.txt"));
+  const bodyFile = AbsolutePath.parse(join29(String(runDir.value), "body.txt"));
   if (!bodyFile.ok) return Result.error(bodyFile.error);
   const promptWrote = await writeTextAtomic(String(promptFile.value), String(prompt.value));
   if (!promptWrote.ok) return Result.error(promptWrote.error);
@@ -15522,10 +15562,10 @@ var launchDetectScripts = (ctx) => {
 };
 
 // src/application/ui/shared/launch/ideate.ts
-import { join as join29 } from "path";
+import { join as join31 } from "path";
 
 // src/application/flows/ideate/flow.ts
-import { join as join28 } from "path";
+import { join as join30 } from "path";
 
 // 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);
@@ -15762,8 +15802,8 @@ var createIdeateFlow = (deps, opts) => {
       parent: () => opts.ideateRoot,
       slug: () => slug,
       write: (ctx, root) => {
-        const promptPath = AbsolutePath.parse(join28(String(root), "prompt.md"));
-        const outputPath = AbsolutePath.parse(join28(String(root), "ideate.json"));
+        const promptPath = AbsolutePath.parse(join30(String(root), "prompt.md"));
+        const outputPath = AbsolutePath.parse(join30(String(root), "ideate.json"));
         if (!promptPath.ok) throw promptPath.error;
         if (!outputPath.ok) throw outputPath.error;
         return {
@@ -15827,7 +15867,7 @@ var launchIdeate = async (ctx) => {
   const bodyAns = await deps.interactive.askText("Idea description (paste or type)");
   if (!bodyAns.ok) return { ok: false, reason: bodyAns.error.message };
   const ideateRoot = AbsolutePath.parse(
-    join29(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "ideate")
+    join31(String(deps.storage.dataRoot), "sprints", String(snapshot.sprint.id), "ideate")
   );
   if (!ideateRoot.ok) return { ok: false, reason: ideateRoot.error.message };
   const element = createIdeateFlow(
@@ -17982,30 +18022,23 @@ var SignalLine = ({ signal }) => {
     /* @__PURE__ */ jsx43(Text33, { bold: row.bold ?? false, children: truncate2(row.text, 80) })
   ] });
 };
+var LEGEND_ENTRIES = [
+  { label: "change", color: inkColors.info, description: "file/code edit" },
+  { label: "learning", color: inkColors.highlight, description: "cross-task insight" },
+  { label: "decision", color: inkColors.highlight, description: "design choice" },
+  { label: "verified", color: inkColors.success, description: "task self-check passed" },
+  { label: "blocked", color: inkColors.error, description: "task self-blocked" },
+  { label: "commit", color: inkColors.info, description: "proposed commit message" }
+];
 var SignalLegend = () => /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingX: spacing.indent, marginBottom: spacing.section, children: [
-  /* @__PURE__ */ jsxs32(Text33, { dimColor: true, children: [
-    /* @__PURE__ */ jsx43(Text33, { bold: true, children: "legend" }),
-    "  ",
-    /* @__PURE__ */ jsx43(Text33, { color: inkColors.info, children: "change" }),
-    " = file/code edit",
-    "   ",
-    /* @__PURE__ */ jsx43(Text33, { color: inkColors.highlight, children: "learning" }),
-    " = cross-task insight",
-    "   ",
-    /* @__PURE__ */ jsx43(Text33, { color: inkColors.highlight, children: "decision" }),
-    " = design choice"
-  ] }),
-  /* @__PURE__ */ jsxs32(Text33, { dimColor: true, children: [
-    "        ",
-    /* @__PURE__ */ jsx43(Text33, { color: inkColors.success, children: "verified" }),
-    " = task self-check passed",
-    "   ",
-    /* @__PURE__ */ jsx43(Text33, { color: inkColors.error, children: "blocked" }),
-    " = task self-blocked",
-    "   ",
-    /* @__PURE__ */ jsx43(Text33, { color: inkColors.info, children: "commit" }),
-    " = proposed commit message"
-  ] })
+  /* @__PURE__ */ jsx43(Text33, { dimColor: true, bold: true, children: "legend" }),
+  /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, children: LEGEND_ENTRIES.map((entry) => /* @__PURE__ */ jsxs32(Box31, { children: [
+    /* @__PURE__ */ jsx43(Text33, { color: entry.color, bold: true, children: padLabel2(entry.label) }),
+    /* @__PURE__ */ jsxs32(Text33, { dimColor: true, children: [
+      "= ",
+      entry.description
+    ] })
+  ] }, entry.label)) })
 ] });
 var EvaluationLine = ({ evaluation }) => {
   const color = evaluation.status === "passed" ? inkColors.success : evaluation.status === "failed" ? inkColors.error : inkColors.warning;
@@ -18582,7 +18615,7 @@ var ExecuteView = () => {
       ] })
     ] })
   ] }) });
-  const outerFlowFilter = (name) => !isPerTaskLeaf(name);
+  const outerFlowFilter = (name) => !isPerTaskLeaf(name) && !name.startsWith("with-repo-lock(");
   const flowStepsPanel = /* @__PURE__ */ jsx46(
     StepTrace,
     {
@@ -19314,7 +19347,7 @@ var ProbeRow = ({ probe }) => /* @__PURE__ */ jsxs39(Box38, { flexDirection: "co
 // src/application/ui/tui/views/export-context-view.tsx
 import { useCallback as useCallback7, useEffect as useEffect25, useState as useState31 } from "react";
 import { Box as Box39, Text as Text41, useInput as useInput20 } from "ink";
-import { join as join30 } from "path";
+import { join as join32 } from "path";
 
 // src/business/sprint/views/context-md.ts
 var renderSprintContextMarkdown = (input) => {
@@ -19446,7 +19479,7 @@ var ExportContextView = () => {
       return;
     }
     const outputPath = AbsolutePath.parse(
-      join30(String(storage2.dataRoot), "sprints", String(selection.sprintId), "context.md")
+      join32(String(storage2.dataRoot), "sprints", String(selection.sprintId), "context.md")
     );
     if (!outputPath.ok) {
       setRun({ kind: "error", message: outputPath.error.message });
@@ -19504,7 +19537,7 @@ var ExportContextView = () => {
 // src/application/ui/tui/views/export-requirements-view.tsx
 import { useCallback as useCallback8, useEffect as useEffect26, useState as useState32 } from "react";
 import { Box as Box40, Text as Text42, useInput as useInput21 } from "ink";
-import { join as join31 } from "path";
+import { join as join33 } from "path";
 
 // src/business/sprint/views/requirements-md.ts
 var renderSprintRequirementsMarkdown = (sprint) => {
@@ -19569,7 +19602,7 @@ var ExportRequirementsView = () => {
       return;
     }
     const outputPath = AbsolutePath.parse(
-      join31(String(storage2.dataRoot), "sprints", String(selection.sprintId), "requirements.md")
+      join33(String(storage2.dataRoot), "sprints", String(selection.sprintId), "requirements.md")
     );
     if (!outputPath.ok) {
       setRun({ kind: "error", message: outputPath.error.message });
@@ -19904,12 +19937,12 @@ var WelcomeView = () => {
 import { useEffect as useEffect29, useState as useState36 } from "react";
 import { Box as Box44, Text as Text46 } from "ink";
 import { homedir as osHomedir2 } from "os";
-import { basename as basename3, join as join33 } from "path";
+import { basename as basename3, join as join35 } from "path";
 
 // src/application/ui/tui/prompts/path-picker-prompt.tsx
 import { useEffect as useEffect28, useState as useState35 } from "react";
 import { promises as fs24 } from "fs";
-import { dirname as dirname10, join as join32 } from "path";
+import { dirname as dirname10, join as join34 } from "path";
 import { homedir } from "os";
 import { Box as Box43, Text as Text45, useInput as useInput23 } from "ink";
 import { jsx as jsx55, jsxs as jsxs44 } from "react/jsx-runtime";
@@ -19917,7 +19950,7 @@ var VISIBLE_ROWS2 = 12;
 var clamp5 = (n, min, max) => Math.max(min, Math.min(max, n));
 var expandHome = (input) => {
   if (input === "~") return homedir();
-  if (input.startsWith("~/")) return join32(homedir(), input.slice(2));
+  if (input.startsWith("~/")) return join34(homedir(), input.slice(2));
   return input;
 };
 var PathPickerPrompt = ({
@@ -20005,7 +20038,7 @@ var PathPickerPrompt = ({
           onSubmit(cwd);
           return;
         }
-        setCwd(join32(cwd, row.entry.name));
+        setCwd(join34(cwd, row.entry.name));
         setCursor(1);
       }
     },
@@ -20087,7 +20120,7 @@ var labelFor = (row) => {
 import { jsx as jsx56, jsxs as jsxs45 } from "react/jsx-runtime";
 var expandHome2 = (input) => {
   if (input === "~") return osHomedir2();
-  if (input.startsWith("~/")) return join33(osHomedir2(), input.slice(2));
+  if (input.startsWith("~/")) return join35(osHomedir2(), input.slice(2));
   return input;
 };
 var backStep = (step) => {
@@ -20303,11 +20336,11 @@ var StepView = ({ step, onChange, onCancel, onSubmit }) => {
 import { useEffect as useEffect30, useState as useState37 } from "react";
 import { Box as Box45, Text as Text47 } from "ink";
 import { homedir as osHomedir3 } from "os";
-import { basename as basename4, join as join34 } from "path";
+import { basename as basename4, join as join36 } from "path";
 import { jsx as jsx57, jsxs as jsxs46 } from "react/jsx-runtime";
 var expandHome3 = (input) => {
   if (input === "~") return osHomedir3();
-  if (input.startsWith("~/")) return join34(osHomedir3(), input.slice(2));
+  if (input.startsWith("~/")) return join36(osHomedir3(), input.slice(2));
   return input;
 };
 var backStep2 = (step) => {
@@ -21138,10 +21171,10 @@ var resolveInitialState = ({
 
 // src/integration/persistence/selection/last-selection-store.ts
 import { promises as fs25 } from "fs";
-import { join as join35 } from "path";
+import { join as join37 } from "path";
 var FILE_NAME = "last-selection.json";
 var createLastSelectionStore = (stateRoot) => {
-  const path = join35(String(stateRoot), FILE_NAME);
+  const path = join37(String(stateRoot), FILE_NAME);
   return {
     async read() {
       try {

package/dist/manifest.json

@@ -1,6 +1,6 @@
 {
   "version": 1,
-  "generatedAt": "2026-05-19T05:25:59.916Z",
+  "generatedAt": "2026-05-19T19:29:09.887Z",
   "assets": [
     "prompts/_partials/harness-context.md",
     "prompts/_partials/signals-evaluation.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ralphctl",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Agent harness for long-running AI coding tasks — orchestrates Claude Code & GitHub Copilot across repositories",
   "homepage": "https://github.com/lukas-grigis/ralphctl",
   "type": "module",