ralphctl 0.7.1 → 0.7.3

package/dist/cli.mjs

@@ -4,7 +4,7 @@
 import { Command } from "commander";
 
 // src/application/ui/tui/launch.ts
-import React65 from "react";
+import React66 from "react";
 
 // src/application/bootstrap/storage-paths.ts
 import { promises as fs } from "fs";
@@ -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.3",
   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");
@@ -5202,7 +5219,7 @@ var getRunInTerminal = () => (fn) => ref.current(fn);
 
 // src/application/ui/tui/App.tsx
 import "react";
-import { Box as Box49 } from "ink";
+import { Box as Box50 } from "ink";
 
 // src/application/ui/tui/runtime/deps-context.tsx
 import { createContext, useContext } from "react";
@@ -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",
@@ -6465,10 +6497,17 @@ var spinnerGlyph = (frame) => glyphs.spinner[frame % glyphs.spinner.length] ?? "
 
 // src/application/ui/tui/components/spinner.tsx
 import { jsxs as jsxs6 } from "react/jsx-runtime";
-var Spinner = ({ label, color = inkColors.info }) => {
-  const frame = useSpinnerFrame();
+var Spinner = ({ label, color = inkColors.info, active = true, dim }) => {
+  const frame = useSpinnerFrame(active);
+  const glyph = spinnerGlyph(frame);
+  if (dim === true) {
+    return /* @__PURE__ */ jsxs6(Text7, { dimColor: true, children: [
+      glyph,
+      label !== void 0 && label.length > 0 ? ` ${label}` : ""
+    ] });
+  }
   return /* @__PURE__ */ jsxs6(Text7, { color, children: [
-    spinnerGlyph(frame),
+    glyph,
     label !== void 0 && label.length > 0 ? ` ${label}` : ""
   ] });
 };
@@ -9176,14 +9215,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 +9243,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 +9705,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 +9807,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 +9880,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 +10624,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 +10715,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 +10769,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 +11682,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 +11693,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 +12822,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 +12855,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 +12863,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 +12937,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 +13240,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 +13309,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 +13552,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 +13816,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 +14049,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 +14063,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 +14192,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 +14245,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 +14311,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 +14494,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 +14558,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 +15176,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 +15221,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 +15569,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 +15809,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 +15874,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(
@@ -17779,20 +17826,20 @@ import { Box as Box34, Text as Text36, useInput as useInput15 } from "ink";
 import { useMemo as useMemo10 } from "react";
 import { Box as Box30, Text as Text32 } from "ink";
 import { jsx as jsx42, jsxs as jsxs31 } from "react/jsx-runtime";
-var glyphFor = (status, frame) => {
+var glyphFor = (status) => {
   switch (status) {
     case "completed":
-      return [glyphs.phaseDone, inkColors.success];
+      return { kind: "static", glyph: glyphs.phaseDone, color: inkColors.success };
     case "failed":
-      return [glyphs.cross, inkColors.error];
+      return { kind: "static", glyph: glyphs.cross, color: inkColors.error };
     case "aborted":
-      return [glyphs.warningGlyph, inkColors.warning];
+      return { kind: "static", glyph: glyphs.warningGlyph, color: inkColors.warning };
     case "skipped":
-      return [glyphs.phaseDisabled, inkColors.muted];
+      return { kind: "static", glyph: glyphs.phaseDisabled, color: inkColors.muted };
     case "running":
-      return [spinnerGlyph(frame), inkColors.info];
+      return { kind: "spinner", color: inkColors.info };
     case "pending":
-      return [glyphs.phasePending, inkColors.muted];
+      return { kind: "static", glyph: glyphs.phasePending, color: inkColors.muted };
   }
 };
 var trailingLabelFor = (status) => {
@@ -17842,7 +17889,6 @@ var StepTrace = ({
   inFlightLabel,
   plan
 }) => {
-  const frame = useSpinnerFrame(running);
   const traceLastEntry = trace[trace.length - 1];
   const merged = useMemo10(
     () => plan !== void 0 ? mergePlanWithTrace(plan, trace, running) : traceToRows(trace),
@@ -17856,11 +17902,11 @@ var StepTrace = ({
   const rows = runningIdx >= 0 ? filtered.slice(Math.max(0, runningIdx - Math.floor(maxRows / 2))).slice(0, maxRows) : filtered.slice(-maxRows);
   return /* @__PURE__ */ jsxs31(Box30, { flexDirection: "column", children: [
     rows.map((row, i) => {
-      const [g, color] = glyphFor(row.status, frame);
+      const instruction = glyphFor(row.status);
       const trailing = trailingLabelFor(row.status);
       const dimRow = row.status === "pending";
       return /* @__PURE__ */ jsxs31(Box30, { paddingX: spacing.indent, children: [
-        /* @__PURE__ */ jsx42(Text32, { color, bold: true, children: g }),
+        instruction.kind === "spinner" ? /* @__PURE__ */ jsx42(Spinner, { active: running, color: instruction.color }) : /* @__PURE__ */ jsx42(Text32, { color: instruction.color, bold: true, children: instruction.glyph }),
         /* @__PURE__ */ jsxs31(Text32, { dimColor: dimRow, children: [
           " ",
           row.name
@@ -17871,7 +17917,7 @@ var StepTrace = ({
           " ",
           fmtDuration(row.durationMs)
         ] }),
-        trailing !== void 0 && /* @__PURE__ */ jsxs31(Text32, { color, children: [
+        trailing !== void 0 && /* @__PURE__ */ jsxs31(Text32, { color: instruction.color, children: [
           "  ",
           glyphs.emDash,
           " ",
@@ -17886,7 +17932,7 @@ var StepTrace = ({
       ] }, `${row.name}-${String(i)}`);
     }),
     plan === void 0 && running && inFlightLabel !== void 0 && /* @__PURE__ */ jsxs31(Box30, { paddingX: spacing.indent, children: [
-      /* @__PURE__ */ jsx42(Text32, { color: inkColors.info, bold: true, children: spinnerGlyph(frame) }),
+      /* @__PURE__ */ jsx42(Spinner, { active: running, color: inkColors.info }),
       /* @__PURE__ */ jsxs31(Text32, { dimColor: true, children: [
         " ",
         inFlightLabel
@@ -17982,30 +18028,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;
@@ -18029,14 +18068,9 @@ var EvaluationLine = ({ evaluation }) => {
     evaluation.dimensions.length > 0 && /* @__PURE__ */ jsx43(Box31, { paddingLeft: 6, children: /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: evaluation.dimensions.map((d) => `${d.dimension}: ${String(d.score)}/5 ${d.passed ? glyphs.check : glyphs.cross}`).join(`  ${glyphs.bullet}  `) }) })
   ] });
 };
-var SubStepLine = ({
-  sub,
-  running,
-  spinner
-}) => {
+var SubStepLine = ({ sub, running }) => {
   const presentation = SUB_STEP_PRESENTATION[sub.status];
   const glyph = running && sub.status === "completed" ? presentation.glyph : presentation.glyph;
-  void spinner;
   return /* @__PURE__ */ jsxs32(Box31, { children: [
     /* @__PURE__ */ jsxs32(Text33, { color: presentation.color, bold: true, children: [
       glyphs.activityArrow,
@@ -18065,15 +18099,20 @@ var TaskBlock = ({
   task,
   running,
   display,
-  maxSignals
+  maxSignals,
+  maxSubSteps,
+  maxEvaluations
 }) => {
   const presentation = STATUS_PRESENTATION[task.status];
-  const frame = useSpinnerFrame(running && task.status === "running");
-  const glyph = task.status === "running" ? spinnerGlyph(frame) : presentation.glyph;
+  const isSpinning = task.status === "running";
   const signalRows = task.signals.slice(-maxSignals);
+  const subStepRows = task.subSteps.slice(-maxSubSteps);
+  const subStepElided = task.subSteps.length - subStepRows.length;
+  const evalRows = task.evaluations.slice(-maxEvaluations);
+  const evalElided = task.evaluations.length - evalRows.length;
   return /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", marginBottom: spacing.section, children: [
     /* @__PURE__ */ jsxs32(Box31, { children: [
-      /* @__PURE__ */ jsx43(Text33, { color: presentation.color, bold: true, children: glyph }),
+      isSpinning ? /* @__PURE__ */ jsx43(Spinner, { active: running, color: presentation.color }) : /* @__PURE__ */ jsx43(Text33, { color: presentation.color, bold: true, children: presentation.glyph }),
       /* @__PURE__ */ jsxs32(Text33, { bold: true, children: [
         " ",
         display
@@ -18099,8 +18138,14 @@ var TaskBlock = ({
       ] })
     ] }),
     task.errorMessage !== void 0 && /* @__PURE__ */ jsx43(Box31, { paddingLeft: 2, children: /* @__PURE__ */ jsx43(Text33, { color: inkColors.error, children: task.errorMessage }) }),
-    task.subSteps.length > 0 && /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, children: task.subSteps.map((s, i) => /* @__PURE__ */ jsx43(SubStepLine, { sub: s, running, spinner: spinnerGlyph(frame) }, `${task.id}-sub-${String(i)}`)) }),
-    task.evaluations.length > 0 && /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: task.evaluations.map((e, i) => /* @__PURE__ */ jsx43(EvaluationLine, { evaluation: e }, `${task.id}-eval-${String(i)}`)) }),
+    subStepRows.length > 0 && /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingLeft: 2, children: [
+      subStepElided > 0 && /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: `\u2026 ${String(subStepElided)} earlier sub-steps` }),
+      subStepRows.map((s, i) => /* @__PURE__ */ jsx43(SubStepLine, { sub: s, running }, `${task.id}-sub-${String(i)}`))
+    ] }),
+    evalRows.length > 0 && /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: [
+      evalElided > 0 && /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: `\u2026 ${String(evalElided)} earlier evaluations` }),
+      evalRows.map((e, i) => /* @__PURE__ */ jsx43(EvaluationLine, { evaluation: e }, `${task.id}-eval-${String(i)}`))
+    ] }),
     signalRows.length > 0 && /* @__PURE__ */ jsxs32(Box31, { flexDirection: "column", paddingLeft: 2, marginTop: 1, children: [
       /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: "signals" }),
       /* @__PURE__ */ jsx43(Box31, { flexDirection: "column", paddingLeft: 2, children: signalRows.map((s, i) => /* @__PURE__ */ jsx43(SignalLine, { signal: s }, `${task.id}-sig-${String(i)}`)) })
@@ -18126,7 +18171,9 @@ var TasksPanel = ({
   running,
   nameById,
   maxSignalsPerTask = 8,
-  maxOrphanSignals = 6
+  maxOrphanSignals = 6,
+  maxSubStepsPerTask = 12,
+  maxEvaluationsPerTask = 6
 }) => {
   if (bucketed.tasks.length === 0 && bucketed.orphanSignals.length === 0) {
     return /* @__PURE__ */ jsx43(Box31, { paddingX: spacing.indent, children: /* @__PURE__ */ jsx43(Text33, { dimColor: true, children: "(no tasks yet)" }) });
@@ -18136,7 +18183,18 @@ var TasksPanel = ({
     /* @__PURE__ */ jsx43(OrphanSignals, { signals: bucketed.orphanSignals, max: maxOrphanSignals }),
     bucketed.tasks.map((task) => {
       const display = nameById?.get(task.id) ?? `${task.id.slice(0, 8)}\u2026`;
-      return /* @__PURE__ */ jsx43(TaskBlock, { task, running, display, maxSignals: maxSignalsPerTask }, task.id);
+      return /* @__PURE__ */ jsx43(
+        TaskBlock,
+        {
+          task,
+          running,
+          display,
+          maxSignals: maxSignalsPerTask,
+          maxSubSteps: maxSubStepsPerTask,
+          maxEvaluations: maxEvaluationsPerTask
+        },
+        task.id
+      );
     })
   ] });
 };
@@ -18447,7 +18505,6 @@ var ExecuteView = () => {
     filter: (e) => "chainId" in e && e.chainId === sessionId2,
     limit: 2e3
   });
-  const frame = useSpinnerFrame(session?.descriptor.status === "running");
   const term = useTerminalSize();
   const isRunning = session?.descriptor.status === "running";
   useViewHints(
@@ -18540,10 +18597,7 @@ var ExecuteView = () => {
           String(tasksTotal)
         ] })
       ] }),
-      isRunning && /* @__PURE__ */ jsx46(Box34, { marginLeft: 2, children: /* @__PURE__ */ jsxs35(Text36, { color: inkColors.info, children: [
-        spinnerGlyph(frame),
-        " live"
-      ] }) })
+      isRunning && /* @__PURE__ */ jsx46(Box34, { marginLeft: 2, children: /* @__PURE__ */ jsx46(Spinner, { active: isRunning, color: inkColors.info, label: "live" }) })
     ] }),
     currentTask !== void 0 && currentTaskName !== void 0 && /* @__PURE__ */ jsxs35(Box34, { children: [
       /* @__PURE__ */ jsxs35(Text36, { dimColor: true, children: [
@@ -18582,7 +18636,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 +19368,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 +19500,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 +19558,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 +19623,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 +19958,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 +19971,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 +20059,7 @@ var PathPickerPrompt = ({
           onSubmit(cwd);
           return;
         }
-        setCwd(join32(cwd, row.entry.name));
+        setCwd(join34(cwd, row.entry.name));
         setCursor(1);
       }
     },
@@ -20087,7 +20141,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 +20357,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) => {
@@ -21087,8 +21141,40 @@ var useGlobalKeys = (opts = {}) => {
   });
 };
 
+// src/application/ui/tui/components/memory-pressure-banner.tsx
+import { useEffect as useEffect34, useState as useState41 } from "react";
+import { Box as Box49, Text as Text51 } from "ink";
+import { jsxs as jsxs50 } from "react/jsx-runtime";
+var formatMb = (bytes) => `${(bytes / 1048576).toFixed(0)} MB`;
+var formatPercent = (ratio) => `${Math.round(ratio * 100)}%`;
+var MemoryPressureBanner = () => {
+  const deps = useDeps();
+  const [latest, setLatest] = useState41(void 0);
+  useEffect34(() => {
+    const unsub = deps.eventBus.subscribe((event) => {
+      if (event.type === "memory-pressure") setLatest(event);
+    });
+    return unsub;
+  }, [deps.eventBus]);
+  if (latest === void 0 || latest.severity === "recovered") return null;
+  const tone = latest.severity === "critical" ? inkColors.error : inkColors.warning;
+  const headline = latest.severity === "critical" ? `memory critical \u2014 ${formatPercent(latest.ratio)} of heap; auto-cleared in-memory buffers` : `memory pressure \u2014 ${formatPercent(latest.ratio)} of heap used; consider aborting and restarting`;
+  const detail = `(${formatMb(latest.heapUsed)} / ${formatMb(latest.heapLimit)})`;
+  return /* @__PURE__ */ jsxs50(Box49, { paddingX: spacing.indent, flexDirection: "row", children: [
+    /* @__PURE__ */ jsxs50(Text51, { bold: true, color: tone, children: [
+      glyphs.warningGlyph,
+      " ",
+      headline
+    ] }),
+    /* @__PURE__ */ jsxs50(Text51, { dimColor: true, children: [
+      " ",
+      detail
+    ] })
+  ] });
+};
+
 // src/application/ui/tui/App.tsx
-import { jsx as jsx62 } from "react/jsx-runtime";
+import { jsx as jsx62, jsxs as jsxs51 } from "react/jsx-runtime";
 var App = ({
   deps,
   storage: storage2,
@@ -21111,7 +21197,10 @@ var Layout = ({ children }) => {
   const ui = useUiState();
   const { rows } = useTerminalSize();
   useGlobalKeys({ disabled: ui.promptActive });
-  return /* @__PURE__ */ jsx62(Box49, { flexDirection: "column", height: rows, children });
+  return /* @__PURE__ */ jsxs51(Box50, { flexDirection: "column", height: rows, children: [
+    /* @__PURE__ */ jsx62(MemoryPressureBanner, {}),
+    children
+  ] });
 };
 
 // src/application/ui/tui/launch-routing.ts
@@ -21138,10 +21227,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 {
@@ -21195,6 +21284,69 @@ var createLogLevelGate = (initial) => {
   };
 };
 
+// src/integration/observability/heap-watchdog.ts
+import * as v8 from "v8";
+var MIN_INTERVAL_MS = 1e3;
+var DEFAULT_INTERVAL_MS = 1e4;
+var DEFAULT_WARNING_RATIO = 0.8;
+var DEFAULT_CRITICAL_RATIO = 0.95;
+var defaultReadHeap = () => {
+  const stats = v8.getHeapStatistics();
+  return { heapUsed: stats.used_heap_size, heapLimit: stats.heap_size_limit };
+};
+var classify = (ratio, warning, critical) => {
+  if (ratio >= critical) return "critical";
+  if (ratio >= warning) return "warning";
+  return "ok";
+};
+var startHeapWatchdog = (deps) => {
+  const intervalMs = Math.max(MIN_INTERVAL_MS, deps.intervalMs ?? DEFAULT_INTERVAL_MS);
+  const warning = deps.warningRatio ?? DEFAULT_WARNING_RATIO;
+  const critical = deps.criticalRatio ?? DEFAULT_CRITICAL_RATIO;
+  const clock = deps.clock ?? IsoTimestamp.now;
+  const readHeap = deps.readHeap ?? defaultReadHeap;
+  let stopped = false;
+  let previousBand = "ok";
+  const emit = (severity, reading, ratio) => {
+    deps.eventBus.publish({
+      type: "memory-pressure",
+      severity,
+      ratio,
+      heapUsed: reading.heapUsed,
+      heapLimit: reading.heapLimit,
+      at: clock()
+    });
+  };
+  const sample = () => {
+    if (stopped) return;
+    const reading = readHeap();
+    const ratio = reading.heapLimit > 0 ? reading.heapUsed / reading.heapLimit : 0;
+    const band = classify(ratio, warning, critical);
+    if (band === previousBand) return;
+    if (band === "warning") emit("warning", reading, ratio);
+    else if (band === "critical") {
+      emit("critical", reading, ratio);
+      try {
+        deps.onCritical?.();
+      } catch (err) {
+        console.warn("[heap-watchdog] onCritical threw:", err);
+      }
+    } else {
+      emit("recovered", reading, ratio);
+    }
+    previousBand = band;
+  };
+  const handle = setInterval(sample, intervalMs);
+  handle.unref?.();
+  return {
+    stop() {
+      if (stopped) return;
+      stopped = true;
+      clearInterval(handle);
+    }
+  };
+};
+
 // src/application/ui/tui/launch.ts
 var bootstrap = async () => {
   const paths = resolveStoragePaths();
@@ -21218,6 +21370,13 @@ var bootstrap = async () => {
   const unsubLogForward = deps.eventBus.subscribe((event) => {
     if (event.type === "log" && passesLogLevel(event.level, logLevelGate.get())) logBus.emit(event);
   });
+  const heapWatchdog = startHeapWatchdog({
+    eventBus: deps.eventBus,
+    onCritical: () => {
+      harnessBus.clear();
+      logBus.clear();
+    }
+  });
   const sessions = createSessionManager();
   const queue = createPromptQueue();
   void createInkInteractivePrompt(queue);
@@ -21254,6 +21413,7 @@ var bootstrap = async () => {
     drain: () => {
       queue.drain(new Error("TUI shutting down"));
       unsubLogForward();
+      heapWatchdog.stop();
     }
   };
 };
@@ -21268,7 +21428,7 @@ var launchTui = async () => {
     process.exitCode = 1;
     return;
   }
-  const appElement = React65.createElement(App, booted.app);
+  const appElement = React66.createElement(App, booted.app);
   const host = createInkHost({ appElement });
   setRunInTerminal(host.runInTerminal);
   try {