oh-my-opencode 5.1.12 → 5.1.14

package/packages/omo-codex/plugin/components/lsp/test/codex-hook-not-installed.test.ts

@@ -0,0 +1,203 @@
+import { mkdtempSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+import { runLspPostToolUseHook } from "../src/codex-hook.js";
+
+interface DaemonResult {
+	readonly content: readonly { readonly type: string; readonly text?: string }[];
+	readonly details?: unknown;
+}
+
+const daemonResults = vi.hoisted(() => new Map<string, DaemonResult>());
+
+vi.mock("@code-yeongyu/lsp-daemon/client", async (importOriginal) => ({
+	...(await importOriginal<Record<string, unknown>>()),
+	callDiagnosticsViaDaemon: async (filePath: string) => {
+		const result = daemonResults.get(filePath);
+		if (result === undefined) throw new Error(`unexpected diagnostics request for ${filePath}`);
+		return result;
+	},
+}));
+
+const UNDECIDED_TEXT = [
+	"LSP server 'biome' for .json, .jsonc is NOT INSTALLED.",
+	"",
+	"Command not found: biome",
+	"",
+	"To install, run:",
+	"  npm install -g @biomejs/biome",
+].join("\n");
+const DECLINED_TEXT =
+	"LSP server 'biome' (.json, .jsonc) is NOT INSTALLED; user previously declined installation — proceed without LSP.";
+const TS_ERROR = "error[typescript] (2322) at 1:7: Type 'string' is not assignable to type 'number'.";
+
+const tempDirs: string[] = [];
+
+afterEach(() => {
+	daemonResults.clear();
+	for (const tempDir of tempDirs.splice(0)) rmSync(tempDir, { recursive: true, force: true });
+});
+
+describe("codex PostToolUse hook with a language server that is not installed", () => {
+	it("#given biome is not installed and the user has not decided #when a .json file is edited #then the install guidance is a note, not a block", async () => {
+		// given
+		daemonAnswering({ "config.json": biomeNotInstalled(null, UNDECIDED_TEXT) });
+
+		// when
+		const output = await withPluginData(() => runLspPostToolUseHook(editOf("s-undecided", "config.json")));
+
+		// then
+		const parsed = parseHookOutput(output);
+		expect(parsed["decision"]).toBeUndefined();
+		expect(parsed["reason"]).toBeUndefined();
+		expect(additionalContext(parsed)).toContain("npm install -g @biomejs/biome");
+	});
+
+	it("#given the user declined biome #when a .json file is edited #then the hook does not block", async () => {
+		// given
+		daemonAnswering({ "config.json": biomeNotInstalled("declined", DECLINED_TEXT) });
+
+		// when
+		const output = await withPluginData(() => runLspPostToolUseHook(editOf("s-declined", "config.json")));
+
+		// then
+		const parsed = parseHookOutput(output);
+		expect(parsed["decision"]).toBeUndefined();
+		expect(additionalContext(parsed)).toContain("proceed without LSP");
+	});
+
+	it("#given biome is not installed #when the same session edits .json twice #then neither edit is blocked", async () => {
+		// given
+		daemonAnswering({ "config.json": biomeNotInstalled(null, UNDECIDED_TEXT) });
+
+		// when
+		const outputs = await withPluginData(async () => [
+			await runLspPostToolUseHook(editOf("s-repeat", "config.json")),
+			await runLspPostToolUseHook(editOf("s-repeat", "config.json")),
+		]);
+
+		// then
+		for (const output of outputs) expect(parseHookOutput(output)["decision"]).toBeUndefined();
+	});
+
+	it("#given one edit touches a .json without biome and a .ts with a type error #when the hook runs #then the type error still blocks", async () => {
+		// given
+		daemonAnswering({
+			"config.json": biomeNotInstalled(null, UNDECIDED_TEXT),
+			"src/value.ts": diagnosticsText(TS_ERROR),
+		});
+
+		// when
+		const output = await withPluginData(() =>
+			runLspPostToolUseHook(patchOf("s-mixed", ["config.json", "src/value.ts"])),
+		);
+
+		// then
+		const parsed = parseHookOutput(output);
+		expect(parsed["decision"]).toBe("block");
+		expect(parsed["reason"]).toContain(TS_ERROR);
+	});
+
+	it("#given only a real type error #when a .ts file is edited #then the hook blocks with the diagnostic", async () => {
+		// given
+		daemonAnswering({ "src/value.ts": diagnosticsText(TS_ERROR) });
+
+		// when
+		const output = await withPluginData(() => runLspPostToolUseHook(editOf("s-real", "src/value.ts")));
+
+		// then
+		const parsed = parseHookOutput(output);
+		expect(parsed["decision"]).toBe("block");
+		expect(parsed["reason"]).toContain(TS_ERROR);
+	});
+});
+
+function daemonAnswering(results: Readonly<Record<string, DaemonResult>>): void {
+	for (const [filePath, result] of Object.entries(results)) daemonResults.set(filePath, result);
+}
+
+function biomeNotInstalled(decision: "declined" | null, text: string): DaemonResult {
+	return {
+		content: [{ type: "text", text }],
+		details: {
+			error: text,
+			errorKind: "missing_dependency",
+			availability: {
+				kind: "not_installed",
+				serverId: "biome",
+				command: ["biome", "lsp-proxy"],
+				extensions: [".json", ".jsonc"],
+				installHint: "npm install -g @biomejs/biome",
+				installDecisionTool: true,
+				installDecisionsPath: "/codex-home/lsp-install-decisions.json",
+				decision,
+			},
+		},
+	};
+}
+
+function diagnosticsText(text: string): DaemonResult {
+	return { content: [{ type: "text", text }] };
+}
+
+function editOf(sessionId: string, filePath: string) {
+	return hookInput(sessionId, "write", { path: filePath });
+}
+
+function patchOf(sessionId: string, filePaths: readonly string[]) {
+	const command = [
+		"*** Begin Patch",
+		...filePaths.flatMap((file) => [`*** Update File: ${file}`, "@@", "-a", "+b"]),
+		"*** End Patch",
+	];
+	return hookInput(sessionId, "apply_patch", { command: command.join("\n") });
+}
+
+function hookInput(sessionId: string, toolName: string, toolInput: Record<string, unknown>) {
+	return {
+		cwd: "/repo",
+		hook_event_name: "PostToolUse",
+		model: "gpt-5.5",
+		permission_mode: "default",
+		session_id: sessionId,
+		tool_input: toolInput,
+		tool_name: toolName,
+		tool_response: { ok: true },
+		tool_use_id: "tool-use-1",
+		transcript_path: null,
+		turn_id: "turn-1",
+	};
+}
+
+async function withPluginData<T>(fn: () => Promise<T>): Promise<T> {
+	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-lsp-not-installed-"));
+	tempDirs.push(pluginData);
+	const previous = process.env["PLUGIN_DATA"];
+	process.env["PLUGIN_DATA"] = pluginData;
+	try {
+		return await fn();
+	} finally {
+		if (previous === undefined) delete process.env["PLUGIN_DATA"];
+		else process.env["PLUGIN_DATA"] = previous;
+	}
+}
+
+function parseHookOutput(output: string): Record<string, unknown> {
+	expect(output).not.toBe("");
+	const parsed: unknown = JSON.parse(output);
+	if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
+		throw new Error(`hook output is not an object: ${output}`);
+	return { ...parsed };
+}
+
+function additionalContext(parsed: Record<string, unknown>): string {
+	const specific = parsed["hookSpecificOutput"];
+	if (typeof specific !== "object" || specific === null) throw new Error("hookSpecificOutput missing");
+	const context = Reflect.get(specific, "additionalContext");
+	const eventName = Reflect.get(specific, "hookEventName");
+	expect(eventName).toBe("PostToolUse");
+	if (typeof context !== "string") throw new Error("additionalContext missing");
+	return context;
+}

package/packages/omo-codex/plugin/components/rules/CHANGELOG.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 
+- Align the Hephaestus GPT-6 rule's delegation paragraph with the senpi GPT-6 preset (oh-my-openagent#9499): reading, lookups and own-change checks stay in the session however many calls they take; a subagent is for a track that runs beside the session's own and lands the task sooner.
 - Restrict the default `PostToolUse` hook matcher to Codex's canonical `apply_patch` tool name.
 - Add opt-in `NODE_DEBUG=codex-rules` phase timing logs for `PostToolUse` debugging.
 - Harden dynamic hook coverage for additional-context JSON output, disabled/static modes, failed tool responses, and duplicate suppression.

package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus/gpt-5.5.md

@@ -41,7 +41,7 @@ omo-codex auto-runs LSP diagnostics after every edit and injects the result: any
 
 # Subagents
 
-Read-only Codex subagent roles live in `CODEX_HOME/agents/`. Spawn: `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. ...","agent_type":"<role>","fork_context":false})`. If your tool list instead has a flat `spawn_agent` with a required `task_name` (`multi_agent_v2`): `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":"TASK: act as a <role>. ...","fork_turns":"none"})` — finished agents end on their own; `wait_agent` takes only `timeout_ms`.
+Read-only Codex subagent roles live in `CODEX_HOME/agents/`. Spawn: `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. ...","agent_type":"<role>","fork_context":false})`. If your tool list instead has a flat `spawn_agent` with a required `task_name` (`multi_agent_v2`): `spawn_agent({"task_name":"<lowercase_digits_underscores>","agent_type":"<role>","message":"TASK: act as a <role>. ...","fork_turns":"none"})` — finished agents end on their own; `wait_agent` takes only `timeout_ms`.
 
 - `explorer` - codebase search
 - `librarian` - external docs, OSS code, API contracts

package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus/gpt-5.6.md

@@ -31,7 +31,7 @@ Waiting is not free: a status poll replays the whole accumulated context through
 
 # Subagents
 
-Read-only Codex subagent roles live in `CODEX_HOME/agents/`. Spawn: `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","agent_type":"<role>","fork_context":false})`. If your tool list instead has a flat `spawn_agent` with a required `task_name` (`multi_agent_v2`): `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","fork_turns":"none"})` - finished agents end on their own; `wait_agent` takes only `timeout_ms`.
+Read-only Codex subagent roles live in `CODEX_HOME/agents/`. Spawn: `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","agent_type":"<role>","fork_context":false})`. If your tool list instead has a flat `spawn_agent` with a required `task_name` (`multi_agent_v2`): `spawn_agent({"task_name":"<lowercase_digits_underscores>","agent_type":"<role>","message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","fork_turns":"none"})` - finished agents end on their own; `wait_agent` takes only `timeout_ms`.
 
 - `explorer` - codebase search
 - `librarian` - external docs, OSS code, API contracts

package/packages/omo-codex/plugin/components/rules/bundled-rules/hephaestus/gpt-6.md

@@ -37,7 +37,7 @@ Use direct calls when batching buys nothing: a lone call, an already-small resul
 
 Memory of file contents is unreliable: read before claiming and re-read before editing or accepting a hand-off. Where LSP tools exist, use them for definitions, callers, rename impact, workspace symbols, and diagnostics on touched files. Text search is for literal strings, filenames, and commit history. Stop searching once a wave answers the question or two waves add nothing new. A finding that looks too simple deserves one more layer of callers or dependencies; prefer the root fix over the symptom.
 
-Do the work yourself by default. Whatever closes in a handful of calls is yours, and a follow-up on delegated work is yours to take back, not forward. Only a sizeable track independent of your own earns a subagent. Spawn those tracks together in the background, each brief stating its output, allowed edit paths, observable stop condition, and evidence to return. Do non-overlapping work while they run, then check their evidence and integrate the results. Never duplicate a running search. Agent messages and final answers are read by people: full sentences, proper spaces between words and numbers, no private shorthand. Concrete spawn contracts are below.
+Do the work yourself by default: reading, lookups, and checks on your own change are yours however many calls they take, and a follow-up on delegated work is yours to take back, not forward. A subagent is for a track that runs beside yours and lands the task sooner - a wide investigation across many files, or an implementation unit beyond one coherent edit in files you are not touching. Spawn those tracks together in the background, each brief naming its output, allowed edit paths, stop condition, and returned evidence. Do non-overlapping work while they run, then check their evidence and integrate the results. Never duplicate a running search. Agent messages and final answers are read by people: full sentences, proper spaces between words and numbers, no private shorthand. Concrete spawn contracts are below.
 
 Use `update_plan` for multi-step work, uncertain scope, multiple files, or branching investigation. Cut items into the smallest standalone outcomes, each pairing an edit with its proof. A one-step ask carries no list. Keep exactly one item `in_progress`; move each item the instant it opens, finishes, is discovered and appended, or is abandoned and removed. Update the plan in the same response when discovery changes it. Before ending, reconcile every item as completed, blocked with a reason, or removed with a reason. Commit follow-up work to the plan only if you will do it now.
 
@@ -78,7 +78,7 @@ When an approach fails, change something material - an algorithm, library, or pa
 
 ## Codex tool and skills notes
 
-The actual Codex tool list and schemas determine the route. Read-only subagent roles live in `CODEX_HOME/agents/`. For `multi_agent_v1`, use `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","agent_type":"<role>","fork_context":false})`. If the tool list instead exposes a flat `spawn_agent` requiring `task_name` (`multi_agent_v2`), use `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","fork_turns":"none"})`. Finished agents end on their own; `wait_agent` takes only `timeout_ms`. Keep the two payloads distinct and do not send v1 fields to v2 or vice versa.
+The actual Codex tool list and schemas determine the route. Read-only subagent roles live in `CODEX_HOME/agents/`. For `multi_agent_v1`, use `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","agent_type":"<role>","fork_context":false})`. If the tool list instead exposes a flat `spawn_agent` requiring `task_name` (`multi_agent_v2`), use `spawn_agent({"task_name":"<lowercase_digits_underscores>","agent_type":"<role>","message":"TASK: act as a <role>. GOAL: ... STOP WHEN: ... EVIDENCE: ...","fork_turns":"none"})`. Finished agents end on their own; `wait_agent` takes only `timeout_ms`. Keep the two payloads distinct and do not send v1 fields to v2 or vice versa.
 
 - `explorer`: codebase search.
 - `librarian`: external docs, OSS code, and API contracts.

package/packages/omo-codex/plugin/components/rules/hooks/hooks.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook session-start",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.1.12) Loading Project Rules"
+						"statusMessage": "(OmO 5.1.14) Loading Project Rules"
 					}
 				]
 			}
@@ -19,7 +19,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook user-prompt-submit",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.1.12) Loading Project Rules"
+						"statusMessage": "(OmO 5.1.14) Loading Project Rules"
 					}
 				]
 			}
@@ -32,7 +32,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.1.12) Matching Project Rules"
+						"statusMessage": "(OmO 5.1.14) Matching Project Rules"
 					}
 				]
 			}
@@ -45,7 +45,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-compact",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.1.12) Resetting Project Rule Cache"
+						"statusMessage": "(OmO 5.1.14) Resetting Project Rule Cache"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/rules/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-rules",
-	"version": "5.1.12",
+	"version": "5.1.14",
 	"description": "Codex plugin that injects project rule files into model context through lifecycle hooks.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.1.12) Checking Thread Title Hygiene"
+						"statusMessage": "(OmO 5.1.14) Checking Thread Title Hygiene"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/teammode/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-teammode",
-	"version": "5.1.12",
+	"version": "5.1.14",
 	"description": "Codex team-mode hook component that keeps background thread titles descriptive after create_thread.",
 	"type": "module",
 	"private": true,

package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO 5.1.12) Recording Session Telemetry"
+						"statusMessage": "(OmO 5.1.14) Recording Session Telemetry"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/telemetry/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-telemetry",
-	"version": "5.1.12",
+	"version": "5.1.14",
 	"description": "Codex plugin component that emits omo-codex anonymous daily-active telemetry on SessionStart.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook user-prompt-submit",
 						"timeout": 5,
-						"statusMessage": "(OmO 5.1.12) Checking Ultrawork Trigger"
+						"statusMessage": "(OmO 5.1.14) Checking Ultrawork Trigger"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/ultrawork/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ultrawork",
-	"version": "5.1.12",
+	"version": "5.1.14",
 	"description": "Codex plugin that injects the ultrawork orchestration directive and ships LazyCodex planning, review, QA, and gate agent roles.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/ulw-execute-continuation/hooks/hooks.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/ulw-execute-continuation/dist/cli.js\" hook stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.1.12) Checking Ulw-Execute Continuation"
+						"statusMessage": "(OmO 5.1.14) Checking Ulw-Execute Continuation"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/ulw-execute-continuation/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ulw-execute-continuation",
-	"version": "5.1.12",
+	"version": "5.1.14",
 	"description": "Codex Stop hook continuation injector for omo-codex ulw-execute plans.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/ulw-loop/dist/cli.js

@@ -4360,25 +4360,82 @@ function readAll(stdin) {
 
 // components/ulw-loop/src/spawn-guard.ts
 import { mkdirSync as mkdirSync3 } from "node:fs";
-import { join as join7 } from "node:path";
+import { join as join8 } from "node:path";
+
+// components/ulw-loop/src/registered-agent-roles.ts
+import { readdirSync as readdirSync3, readFileSync as readFileSync6 } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname as dirname3, join as join6, resolve as resolve5 } from "node:path";
+var NAME_LINE = /^\s*name\s*=\s*"([^"\n]+)"\s*(?:#.*)?$/m;
+var AGENT_TABLE = /^\s*\[agents\.(?:"([^"\n]+)"|([A-Za-z0-9_-]+))\]\s*(?:#.*)?$/gm;
+function readText(path) {
+  try {
+    return readFileSync6(path, "utf8");
+  } catch {
+    return null;
+  }
+}
+function standaloneRoleNames(agentsDir) {
+  let entries;
+  try {
+    entries = readdirSync3(agentsDir);
+  } catch {
+    return [];
+  }
+  const names = [];
+  for (const entry of entries) {
+    if (!entry.endsWith(".toml"))
+      continue;
+    const text = readText(join6(agentsDir, entry));
+    if (text === null)
+      continue;
+    names.push(text.match(NAME_LINE)?.[1] ?? basename(entry, ".toml"));
+  }
+  return names;
+}
+function configTableRoleNames(configPath) {
+  const text = readText(configPath);
+  if (text === null)
+    return [];
+  return [...text.matchAll(AGENT_TABLE)].map((match) => match[1] ?? match[2] ?? "").filter(Boolean);
+}
+function codexDirs(cwd, env) {
+  const dirs = [resolve5(env["CODEX_HOME"]?.trim() || join6(homedir(), ".codex"))];
+  for (let dir = resolve5(cwd);; dir = dirname3(dir)) {
+    dirs.push(join6(dir, ".codex"));
+    if (dirname3(dir) === dir)
+      break;
+  }
+  return [...new Set(dirs)];
+}
+function registeredAgentRoles(cwd, env = process.env) {
+  const names = new Set;
+  for (const dir of codexDirs(cwd, env)) {
+    for (const name of standaloneRoleNames(join6(dir, "agents")))
+      names.add(name);
+    for (const name of configTableRoleNames(join6(dir, "config.toml")))
+      names.add(name);
+  }
+  return names;
+}
 
 // components/ulw-loop/src/spawn-budget-io.ts
 import { randomBytes } from "node:crypto";
-import { existsSync as existsSync7, readFileSync as readFileSync6, renameSync as renameSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "node:fs";
-import { dirname as dirname3, join as join6 } from "node:path";
+import { existsSync as existsSync7, readFileSync as readFileSync7, renameSync as renameSync2, statSync as statSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname4, join as join7 } from "node:path";
 function readAdmissionBreaker(sessionId) {
   const dataDir = process.env["PLUGIN_DATA"];
   if (typeof dataDir !== "string")
     return null;
   try {
-    const value = JSON.parse(readFileSync6(join6(dataDir, "spawn-breaker", `${sessionId}.json`), "utf8"));
+    const value = JSON.parse(readFileSync7(join7(dataDir, "spawn-breaker", `${sessionId}.json`), "utf8"));
     return typeof value === "object" && value !== null && "reason" in value && typeof value.reason === "string" ? value.reason : "capacity limit";
   } catch {
     return null;
   }
 }
 function atomicWriteJson(targetPath, data) {
-  const tmp = join6(dirname3(targetPath), `.tmp-${randomBytes(6).toString("hex")}`);
+  const tmp = join7(dirname4(targetPath), `.tmp-${randomBytes(6).toString("hex")}`);
   writeFileSync2(tmp, JSON.stringify(data));
   renameSync2(tmp, targetPath);
 }
@@ -4393,7 +4450,7 @@ function isNonEmptyFile(path) {
 }
 function readCount(counterPath) {
   try {
-    const parsed = JSON.parse(readFileSync6(counterPath, "utf8"));
+    const parsed = JSON.parse(readFileSync7(counterPath, "utf8"));
     return typeof parsed === "object" && parsed !== null && "count" in parsed && typeof parsed.count === "number" && parsed.count >= 0 ? parsed.count : 0;
   } catch (error) {
     if (error instanceof Error)
@@ -4403,7 +4460,7 @@ function readCount(counterPath) {
 }
 function readCounts(counterPath) {
   try {
-    const parsed = JSON.parse(readFileSync6(counterPath, "utf8"));
+    const parsed = JSON.parse(readFileSync7(counterPath, "utf8"));
     if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed))
       return {};
     const counts = {};
@@ -4433,11 +4490,15 @@ var LAZYCODEX_SPAWN_ROLES = new Set([
   "momus",
   "plan"
 ]);
-function spawnRoleDenial(input) {
+function spawnRoleDenial(input, registeredRoles = () => new Set) {
   const role = typeof input === "object" && input !== null && "agent_type" in input ? input.agent_type : undefined;
   if (typeof role === "string" && LAZYCODEX_SPAWN_ROLES.has(role))
     return null;
-  return `LazyCodex requires an explicit registered agent_type: ${[...LAZYCODEX_SPAWN_ROLES].join(", ")}. Received ${JSON.stringify(role) ?? "no agent_type"}. Use the matching role and fork_turns: "none" (V2) or fork_context: false (V1), unless full history is deliberately required. The hook cannot see the tool schema; if agent_type is unavailable, stop and report incompatible role routing rather than spawning a generic agent. Describing a role in message does not select its TOML.`;
+  const registered = typeof role === "string" && role.trim() !== "" ? registeredRoles() : new Set;
+  if (typeof role === "string" && registered.has(role))
+    return null;
+  const known = [...new Set([...LAZYCODEX_SPAWN_ROLES, ...registered])];
+  return `LazyCodex requires an explicit registered agent_type: ${known.join(", ")}. Received ${JSON.stringify(role) ?? "no agent_type"}. Use the matching role and fork_turns: "none" (V2) or fork_context: false (V1), unless full history is deliberately required. The hook cannot see the tool schema; if agent_type is unavailable, stop and report incompatible role routing rather than spawning a generic agent. Describing a role in message does not select its TOML.`;
 }
 
 // components/ulw-loop/src/spawn-guard.ts
@@ -4461,7 +4522,7 @@ function applySpawnGuards(payload, options = {}) {
   if (payload.hook_event_name !== "PreToolUse" || !SPAWN_TOOL_TOKENS.has(payload.tool_name))
     return "";
   if (resolveToolkitSurface() === "lazycodex") {
-    const reason = spawnRoleDenial(payload.tool_input);
+    const reason = spawnRoleDenial(payload.tool_input, () => registeredAgentRoles(payload.cwd));
     if (reason !== null)
       return deny(reason);
   }
@@ -4514,10 +4575,10 @@ async function runSpawnAdmissionRecorderCli(stdin, stdout) {
     const dataDir = process.env["PLUGIN_DATA"];
     if (typeof dataDir !== "string" || typeof payload["session_id"] !== "string")
       return;
-    const markerDir = join7(dataDir, "spawn-breaker");
+    const markerDir = join8(dataDir, "spawn-breaker");
     try {
       mkdirSync3(markerDir, { recursive: true });
-      atomicWriteJson(join7(markerDir, `${payload["session_id"]}.json`), {
+      atomicWriteJson(join8(markerDir, `${payload["session_id"]}.json`), {
         reason: response,
         at: new Date().toISOString()
       });
@@ -4546,7 +4607,7 @@ async function runSpawnGuardCli(stdin, stdout) {
   }
 }
 function peekFanOutBudget(stateDir) {
-  const counterPath = join7(stateDir, "spawn-count.json");
+  const counterPath = join8(stateDir, "spawn-count.json");
   const count = readCount(counterPath) + 1;
   const limit = fanOutLimit();
   if (count <= limit)
@@ -4554,7 +4615,7 @@ function peekFanOutBudget(stateDir) {
   return `ulw-loop spawn fan-out cap reached (${count}/${limit}). Consolidate work into the agents already running, or raise OMO_SPAWN_FANOUT_LIMIT if this volume is intentional.`;
 }
 function consumeFanOutBudget(stateDir) {
-  const counterPath = join7(stateDir, "spawn-count.json");
+  const counterPath = join8(stateDir, "spawn-count.json");
   const count = readCount(counterPath) + 1;
   atomicWriteJson(counterPath, { count });
   const limit = fanOutLimit();
@@ -4569,7 +4630,7 @@ function consumeReviewSpawnBudget(payload, plan, stateDir) {
   const goal = plan.goals.find((candidate) => candidate.id === plan.activeGoalId) ?? plan.goals.find((candidate) => isFinalRunCompletionCandidate(plan, candidate));
   if (goal === undefined)
     return null;
-  const counterPath = join7(stateDir, "review-spawn-counts.json");
+  const counterPath = join8(stateDir, "review-spawn-counts.json");
   const limit = reviewSpawnLimit();
   const counts = readCounts(counterPath);
   const key = `${agentType}:${goal.id}:a${goal.attempt}`;
@@ -4594,13 +4655,13 @@ function missingGateArtifact(payload, plan) {
     const attemptDir = ulwLoopAttemptEvidenceDir(goal.id, goal.attempt, scope);
     for (const name of requiredArtifacts) {
       const relative = `${attemptDir}/${name}`;
-      if (!isNonEmptyFile(join7(payload.cwd, relative)))
+      if (!isNonEmptyFile(join8(payload.cwd, relative)))
         return relative;
     }
     return null;
   }
   const manualQa = `.omo/evidence/${goal.id}-manual-qa.md`;
-  return isNonEmptyFile(join7(payload.cwd, manualQa)) ? null : manualQa;
+  return isNonEmptyFile(join8(payload.cwd, manualQa)) ? null : manualQa;
 }
 function isGateReviewerSpawn(toolInput) {
   const agentType = reviewAgentType(toolInput);
@@ -4684,8 +4745,8 @@ function readPlan(repoRoot, sessionId) {
 }
 
 // components/ulw-loop/src/stop-resume-hook.ts
-import { existsSync as existsSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync3 } from "node:fs";
-import { isAbsolute as isAbsolute3, join as join8, resolve as resolve5, sep as sep3 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync3 } from "node:fs";
+import { isAbsolute as isAbsolute3, join as join9, resolve as resolve6, sep as sep3 } from "node:path";
 var RESUME_CAP = 2;
 var CONTEXT_PRESSURE_MARKERS2 = [
   "context compacted",
@@ -4753,8 +4814,8 @@ function consumeResumeBudgetLocked(lockPath, stateDir, goalId) {
 }
 function consumeResumeBudget(stateDir, goalId) {
   const ledgerLineCount = readLedgerAt(stateDir).length;
-  const counterPath = resolve5(stateDir, `auto-resume-${goalId}.json`);
-  const stuckPath = resolve5(stateDir, `auto-resume-${goalId}.stuck`);
+  const counterPath = resolve6(stateDir, `auto-resume-${goalId}.json`);
+  const stuckPath = resolve6(stateDir, `auto-resume-${goalId}.stuck`);
   if (!isInsideDir(stateDir, counterPath) || !isInsideDir(stateDir, stuckPath))
     return false;
   const previous = readCounter(counterPath);
@@ -4768,7 +4829,7 @@ function consumeResumeBudget(stateDir, goalId) {
   return true;
 }
 function isInsideDir(dir, candidate) {
-  return candidate.startsWith(resolve5(dir) + sep3);
+  return candidate.startsWith(resolve6(dir) + sep3);
 }
 function renderResumeDirective(plan, goal, sessionId) {
   const normalized = normalizeUlwLoopSessionId(sessionId);
@@ -4796,7 +4857,7 @@ function readCounter(counterPath) {
   try {
     if (!existsSync8(counterPath))
       return null;
-    const parsed = JSON.parse(readFileSync7(counterPath, "utf8"));
+    const parsed = JSON.parse(readFileSync8(counterPath, "utf8"));
     if (typeof parsed["count"] !== "number" || typeof parsed["ledgerLineCount"] !== "number")
       return null;
     return { count: parsed["count"], ledgerLineCount: parsed["ledgerLineCount"] };
@@ -4808,7 +4869,7 @@ function readCounter(counterPath) {
 }
 function boulderContinuationWillFire(cwd, sessionId) {
   try {
-    const raw = JSON.parse(readFileSync7(join8(cwd, ".omo", "boulder.json"), "utf8"));
+    const raw = JSON.parse(readFileSync8(join9(cwd, ".omo", "boulder.json"), "utf8"));
     const works = raw["works"];
     const entries = typeof works === "object" && works !== null ? Object.values(works) : [raw];
     return entries.some((work) => {
@@ -4827,7 +4888,7 @@ function boulderContinuationWillFire(cwd, sessionId) {
 }
 function transcriptShowsContextPressure(transcriptPath) {
   try {
-    const transcript = readFileSync7(transcriptPath, "utf8").toLowerCase();
+    const transcript = readFileSync8(transcriptPath, "utf8").toLowerCase();
     return CONTEXT_PRESSURE_MARKERS2.some((marker) => transcript.includes(marker));
   } catch (error) {
     if (error instanceof Error)
@@ -4839,12 +4900,12 @@ function boulderPlanHasChecklist(cwd, entry) {
   const activePlan = entry["active_plan"];
   if (typeof activePlan !== "string" || activePlan.trim().length === 0)
     return false;
-  const planPath = isAbsolute3(activePlan) ? activePlan : join8(cwd, activePlan);
+  const planPath = isAbsolute3(activePlan) ? activePlan : join9(cwd, activePlan);
   const worktree = entry["worktree_path"];
-  const candidates = typeof worktree === "string" && worktree.trim().length > 0 && !isAbsolute3(activePlan) ? [join8(isAbsolute3(worktree) ? worktree : join8(cwd, worktree), activePlan), planPath] : [planPath];
+  const candidates = typeof worktree === "string" && worktree.trim().length > 0 && !isAbsolute3(activePlan) ? [join9(isAbsolute3(worktree) ? worktree : join9(cwd, worktree), activePlan), planPath] : [planPath];
   for (const candidate of candidates) {
     try {
-      return readFileSync7(candidate, "utf8").split(/\r?\n/).some((line) => line.startsWith("- [ ] ") || line.startsWith("- [x] ") || line.startsWith("- [X] "));
+      return readFileSync8(candidate, "utf8").split(/\r?\n/).some((line) => line.startsWith("- [ ] ") || line.startsWith("- [x] ") || line.startsWith("- [X] "));
     } catch (error) {
       if (!(error instanceof Error))
         throw error;

package/packages/omo-codex/plugin/components/ulw-loop/dist/registered-agent-roles.d.ts

@@ -0,0 +1 @@
+export declare function registeredAgentRoles(cwd: string, env?: NodeJS.ProcessEnv): ReadonlySet<string>;