oh-my-opencode 4.16.3 → 4.17.0

package/packages/omo-codex/plugin/components/ulw-loop/test/spawn-guard.test.ts

@@ -0,0 +1,228 @@
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+
+import type { PreToolUsePayload } from "../src/codex-hook.ts";
+import { applySpawnGuards } from "../src/spawn-guard.ts";
+
+let workDir: string;
+let originalLimit: string | undefined;
+
+beforeEach(async () => {
+	workDir = await mkdtemp(join(tmpdir(), "ulw-spawn-guard-"));
+	originalLimit = process.env["OMO_SPAWN_FANOUT_LIMIT"];
+	delete process.env["OMO_SPAWN_FANOUT_LIMIT"];
+});
+
+afterEach(async () => {
+	if (originalLimit === undefined) delete process.env["OMO_SPAWN_FANOUT_LIMIT"];
+	else process.env["OMO_SPAWN_FANOUT_LIMIT"] = originalLimit;
+	await rm(workDir, { recursive: true, force: true });
+});
+
+function payload(toolName: string, toolInput: Record<string, unknown>): PreToolUsePayload {
+	return {
+		hook_event_name: "PreToolUse",
+		session_id: "s1",
+		turn_id: "t1",
+		transcript_path: null,
+		cwd: workDir,
+		model: "gpt-5.6-sol",
+		permission_mode: "default",
+		tool_name: toolName,
+		tool_use_id: "tu1",
+		tool_input: toolInput,
+	};
+}
+
+function sessionDir(): string {
+	return join(workDir, ".omo", "ulw-loop", "s1");
+}
+
+function criterion(id: string): Record<string, unknown> {
+	return {
+		id,
+		scenario: `scenario ${id}`,
+		userModel: "happy",
+		expectedEvidence: "evidence",
+		capturedEvidence: "captured",
+		status: "pass",
+		capturedAt: "2026-07-11T00:00:00.000Z",
+	};
+}
+
+function writeGoals(planOverrides: Record<string, unknown> = {}): void {
+	mkdirSync(sessionDir(), { recursive: true });
+	writeFileSync(
+		join(sessionDir(), "goals.json"),
+		JSON.stringify({
+			version: 1,
+			createdAt: "2026-07-11T00:00:00.000Z",
+			updatedAt: "2026-07-11T00:00:00.000Z",
+			briefPath: ".omo/ulw-loop/s1/brief.md",
+			goalsPath: ".omo/ulw-loop/s1/goals.json",
+			ledgerPath: ".omo/ulw-loop/s1/ledger.jsonl",
+			codexGoalMode: "aggregate",
+			goals: [
+				{
+					id: "g1",
+					title: "Final goal",
+					objective: "Final goal",
+					status: "in_progress",
+					successCriteria: [criterion("C001"), criterion("C002")],
+					attempt: 1,
+					createdAt: "2026-07-11T00:00:00.000Z",
+					updatedAt: "2026-07-11T00:00:00.000Z",
+				},
+			],
+			activeGoalId: "g1",
+			...planOverrides,
+		}),
+	);
+}
+
+function deny(output: string): { permissionDecision: string; permissionDecisionReason: string } {
+	return JSON.parse(output).hookSpecificOutput;
+}
+
+describe("applySpawnGuards fan-out cap", () => {
+	it("#given spawns under the limit #when guarded #then allows and counts", () => {
+		writeGoals();
+
+		expect(applySpawnGuards(payload("spawn_agent", { message: "scan" }))).toBe("");
+
+		const counter = JSON.parse(readFileSync(join(sessionDir(), "spawn-count.json"), "utf8"));
+		expect(counter.count).toBe(1);
+	});
+
+	it("#given the env limit exceeded #when guarded #then denies naming count/limit", () => {
+		writeGoals();
+		process.env["OMO_SPAWN_FANOUT_LIMIT"] = "3";
+
+		expect(applySpawnGuards(payload("spawn_agent", { message: "scan" }))).toBe("");
+		expect(applySpawnGuards(payload("spawn_agent", { message: "scan" }))).toBe("");
+		expect(applySpawnGuards(payload("spawn_agent", { message: "scan" }))).toBe("");
+		const fourth = applySpawnGuards(payload("spawn_agent", { message: "scan" }));
+
+		const output = deny(fourth);
+		expect(output.permissionDecision).toBe("deny");
+		expect(output.permissionDecisionReason).toContain("4/3");
+	});
+
+	it("#given no ulw-loop session state #when guarded #then no-ops without counting", () => {
+		expect(applySpawnGuards(payload("spawn_agent", { message: "scan" }))).toBe("");
+	});
+
+	it("#given a non-spawn tool #when guarded #then no-ops", () => {
+		writeGoals();
+
+		expect(applySpawnGuards(payload("create_goal", { objective: "x" }))).toBe("");
+	});
+
+	it("#given the observed dotted v2 token #when guarded #then it counts too", () => {
+		writeGoals();
+		process.env["OMO_SPAWN_FANOUT_LIMIT"] = "1";
+
+		expect(applySpawnGuards(payload("collaboration.spawn_agent", { message: "scan" }))).toBe("");
+		const second = applySpawnGuards(payload("collaborationspawn_agent", { message: "scan" }));
+
+		expect(deny(second).permissionDecisionReason).toContain("2/1");
+	});
+});
+
+describe("applySpawnGuards gate-artifact guard", () => {
+	it("#given a gate spawn by agent_type without artifacts #when guarded #then denies naming the missing path", () => {
+		writeGoals();
+
+		const output = applySpawnGuards(
+			payload("collaborationspawn_agent", { agent_type: "lazycodex-gate-reviewer", message: "final gate review" }),
+		);
+
+		const parsed = deny(output);
+		expect(parsed.permissionDecision).toBe("deny");
+		expect(parsed.permissionDecisionReason).toContain("missing");
+		expect(parsed.permissionDecisionReason).toContain("g1-code-review.md");
+	});
+
+	it("#given a gate spawn identified by message only #when guarded #then still denies", () => {
+		writeGoals();
+
+		const output = applySpawnGuards(payload("spawn_agent", { message: "run the FINAL GATE REVIEW now" }));
+
+		expect(deny(output).permissionDecision).toBe("deny");
+	});
+
+	it("#given v1 artifacts on disk #when the gate spawns #then allows", () => {
+		writeGoals();
+		mkdirSync(join(workDir, ".omo", "evidence"), { recursive: true });
+		writeFileSync(join(workDir, ".omo", "evidence", "g1-code-review.md"), "report\n");
+		writeFileSync(join(workDir, ".omo", "evidence", "g1-manual-qa.md"), "matrix\n");
+
+		const output = applySpawnGuards(
+			payload("spawn_agent", { agent_type: "lazycodex-gate-reviewer", message: "final gate review" }),
+		);
+
+		expect(output).toBe("");
+	});
+
+	it("#given a v2 plan #when the gate spawns without attempt-dir artifacts #then denies naming the attempt path", () => {
+		writeGoals({ evidenceLayoutVersion: 2 });
+		mkdirSync(join(workDir, ".omo", "evidence"), { recursive: true });
+		writeFileSync(join(workDir, ".omo", "evidence", "g1-code-review.md"), "stale flat report\n");
+
+		const output = applySpawnGuards(
+			payload("spawn_agent", { agent_type: "lazycodex-gate-reviewer", message: "final gate review" }),
+		);
+
+		expect(deny(output).permissionDecisionReason).toContain(".omo/evidence/ulw/s1/g1/a1/g1-code-review.md");
+	});
+
+	it("#given a v2 plan with attempt-dir artifacts #when the gate spawns #then allows", () => {
+		writeGoals({ evidenceLayoutVersion: 2 });
+		const attemptDir = join(workDir, ".omo", "evidence", "ulw", "s1", "g1", "a1");
+		mkdirSync(attemptDir, { recursive: true });
+		writeFileSync(join(attemptDir, "g1-code-review.md"), "report\n");
+		writeFileSync(join(attemptDir, "g1-manual-qa.md"), "matrix\n");
+
+		const output = applySpawnGuards(
+			payload("spawn_agent", { agent_type: "lazycodex-gate-reviewer", message: "final gate review" }),
+		);
+
+		expect(output).toBe("");
+	});
+
+	it("#given the final goal's criteria are not all pass #when the gate spawns #then no-ops", () => {
+		writeGoals({
+			goals: [
+				{
+					id: "g1",
+					title: "Final goal",
+					objective: "Final goal",
+					status: "in_progress",
+					successCriteria: [criterion("C001"), { ...criterion("C002"), status: "pending" }],
+					attempt: 1,
+					createdAt: "2026-07-11T00:00:00.000Z",
+					updatedAt: "2026-07-11T00:00:00.000Z",
+				},
+			],
+		});
+
+		const output = applySpawnGuards(
+			payload("spawn_agent", { agent_type: "lazycodex-gate-reviewer", message: "final gate review" }),
+		);
+
+		expect(output).toBe("");
+	});
+
+	it("#given a non-gate reviewer spawn #when artifacts are missing #then never denies on the artifact rule", () => {
+		writeGoals();
+
+		const output = applySpawnGuards(
+			payload("spawn_agent", { agent_type: "lazycodex-code-reviewer", message: "review the diff" }),
+		);
+
+		expect(output).toBe("");
+	});
+});

package/packages/omo-codex/plugin/components/ulw-loop/test/stop-resume-hook.test.ts

@@ -0,0 +1,193 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+
+import { runStopResumeHook } from "../src/stop-resume-hook.ts";
+
+let workDir: string;
+
+beforeEach(async () => {
+	workDir = await mkdtemp(join(tmpdir(), "ulw-stop-resume-"));
+});
+
+afterEach(async () => {
+	await rm(workDir, { recursive: true, force: true });
+});
+
+function stopPayload(overrides: Record<string, unknown> = {}): Record<string, unknown> {
+	return {
+		hook_event_name: "Stop",
+		session_id: "s1",
+		turn_id: "t1",
+		transcript_path: join(workDir, "transcript.jsonl"),
+		cwd: workDir,
+		model: "gpt-5.6-sol",
+		permission_mode: "default",
+		stop_hook_active: false,
+		...overrides,
+	};
+}
+
+function sessionDir(): string {
+	return join(workDir, ".omo", "ulw-loop", "s1");
+}
+
+function writeGoals(goals: readonly Record<string, unknown>[], planOverrides: Record<string, unknown> = {}): void {
+	mkdirSync(sessionDir(), { recursive: true });
+	writeFileSync(
+		join(sessionDir(), "goals.json"),
+		JSON.stringify({
+			version: 1,
+			createdAt: "2026-07-11T00:00:00.000Z",
+			updatedAt: "2026-07-11T00:00:00.000Z",
+			briefPath: ".omo/ulw-loop/s1/brief.md",
+			goalsPath: ".omo/ulw-loop/s1/goals.json",
+			ledgerPath: ".omo/ulw-loop/s1/ledger.jsonl",
+			codexGoalMode: "aggregate",
+			goals,
+			...planOverrides,
+		}),
+	);
+	writeFileSync(join(sessionDir(), "ledger.jsonl"), "");
+	writeFileSync(join(workDir, "transcript.jsonl"), "");
+}
+
+function writeBoulderPlan(remaining: boolean): string {
+	mkdirSync(join(workDir, ".omo", "plans"), { recursive: true });
+	writeFileSync(
+		join(workDir, ".omo", "plans", "p.md"),
+		remaining ? "## TODOs\n- [ ] pending task\n" : "## TODOs\n- [x] done task\n",
+	);
+	return ".omo/plans/p.md";
+}
+
+function pendingGoal(id = "g1", status = "pending"): Record<string, unknown> {
+	return {
+		id,
+		title: `Goal ${id}`,
+		objective: `Objective ${id}`,
+		status,
+		successCriteria: [],
+		attempt: 1,
+		createdAt: "2026-07-11T00:00:00.000Z",
+		updatedAt: "2026-07-11T00:00:00.000Z",
+	};
+}
+
+describe("runStopResumeHook", () => {
+	it("#given a pending goal #when the turn stops #then blocks with a resume directive", () => {
+		writeGoals([pendingGoal()]);
+
+		const output = runStopResumeHook(stopPayload());
+
+		const parsed = JSON.parse(output);
+		expect(parsed.decision).toBe("block");
+		expect(parsed.reason).toContain("omo ulw-loop status");
+	});
+
+	it("#given stop_hook_active #when the hook runs #then no-ops", () => {
+		writeGoals([pendingGoal()]);
+
+		expect(runStopResumeHook(stopPayload({ stop_hook_active: true }))).toBe("");
+	});
+
+	it("#given a malformed payload #when the hook runs #then no-ops", () => {
+		writeGoals([pendingGoal()]);
+
+		expect(runStopResumeHook({ hook_event_name: "Stop" })).toBe("");
+	});
+
+	it("#given an active boulder work with remaining plan tasks #when the hook runs #then defers to start-work-continuation", () => {
+		writeGoals([pendingGoal()]);
+		const plan = writeBoulderPlan(true);
+		writeFileSync(
+			join(workDir, ".omo", "boulder.json"),
+			JSON.stringify({ works: { w1: { session_ids: ["codex:s1"], status: "active", active_plan: plan } } }),
+		);
+
+		expect(runStopResumeHook(stopPayload())).toBe("");
+	});
+
+	it("#given an active boulder work whose plan is exhausted #when the hook runs #then resumes instead of deferring", () => {
+		writeGoals([pendingGoal()]);
+		const plan = writeBoulderPlan(false);
+		writeFileSync(
+			join(workDir, ".omo", "boulder.json"),
+			JSON.stringify({ works: { w1: { session_ids: ["codex:s1"], status: "active", active_plan: plan } } }),
+		);
+
+		expect(JSON.parse(runStopResumeHook(stopPayload())).decision).toBe("block");
+	});
+
+	it("#given a flat legacy boulder work with remaining plan tasks #when the hook runs #then still defers", () => {
+		writeGoals([pendingGoal()]);
+		const plan = writeBoulderPlan(true);
+		writeFileSync(
+			join(workDir, ".omo", "boulder.json"),
+			JSON.stringify({ session_ids: ["codex:s1"], status: "active", active_plan: plan }),
+		);
+
+		expect(runStopResumeHook(stopPayload())).toBe("");
+	});
+
+	it("#given a context-pressure marker in the transcript #when the hook runs #then no-ops", () => {
+		writeGoals([pendingGoal()]);
+		writeFileSync(join(workDir, "transcript.jsonl"), "note: context compacted mid-run\n");
+
+		expect(runStopResumeHook(stopPayload())).toBe("");
+	});
+
+	it("#given no ulw-loop state #when the hook runs #then no-ops", () => {
+		expect(runStopResumeHook(stopPayload())).toBe("");
+	});
+
+	it("#given all goals complete #when the hook runs #then no-ops", () => {
+		writeGoals([pendingGoal("g1", "complete"), pendingGoal("g2", "complete")]);
+
+		expect(runStopResumeHook(stopPayload())).toBe("");
+	});
+
+	it("#given blocked and failed goals only #when the hook runs #then no-ops", () => {
+		writeGoals([pendingGoal("g1", "blocked"), pendingGoal("g2", "failed")]);
+
+		expect(runStopResumeHook(stopPayload())).toBe("");
+	});
+
+	it("#given a static ledger #when the hook fires three times #then caps after two and marks stuck", () => {
+		writeGoals([pendingGoal()]);
+
+		const first = runStopResumeHook(stopPayload());
+		const second = runStopResumeHook(stopPayload());
+		const third = runStopResumeHook(stopPayload());
+
+		expect(JSON.parse(first).decision).toBe("block");
+		expect(JSON.parse(second).decision).toBe("block");
+		expect(third).toBe("");
+		const counter = JSON.parse(readFileSync(join(sessionDir(), "auto-resume-g1.json"), "utf8"));
+		expect(counter.count).toBe(2);
+		expect(existsSync(join(sessionDir(), "auto-resume-g1.stuck"))).toBe(true);
+		expect(readFileSync(join(sessionDir(), "ledger.jsonl"), "utf8")).toBe("");
+	});
+
+	it("#given a session id needing normalization #when the hook blocks #then the directive carries the normalized flag", () => {
+		writeGoals([pendingGoal()]);
+
+		const output = runStopResumeHook(stopPayload({ session_id: "s1/" }));
+
+		expect(JSON.parse(output).reason).toContain("--session-id s1");
+	});
+
+	it("#given ledger movement between stops #when the hook fires again #then the cap resets", () => {
+		writeGoals([pendingGoal()]);
+
+		runStopResumeHook(stopPayload());
+		runStopResumeHook(stopPayload());
+		appendFileSync(join(sessionDir(), "ledger.jsonl"), '{"kind":"goal_started"}\n');
+		const third = runStopResumeHook(stopPayload());
+
+		expect(JSON.parse(third).decision).toBe("block");
+		expect(existsSync(join(sessionDir(), "auto-resume-g1.stuck"))).toBe(false);
+	});
+});

package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/git-bash/dist/cli.js\" hook post-compact",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Resetting Git Bash MCP Reminder",
+						"statusMessage": "(OmO 4.17.0) Resetting Git Bash MCP Reminder",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\git-bash\\dist\\cli.js\" hook post-compact"
 					}
 				],

package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lsp/dist/cli.js\" hook post-compact",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Resetting LSP Diagnostics Cache",
+						"statusMessage": "(OmO 4.17.0) Resetting LSP Diagnostics Cache",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\lsp\\dist\\cli.js\" hook post-compact"
 					}
 				],

package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook post-compact",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Resetting Project Rule Cache",
+						"statusMessage": "(OmO 4.17.0) Resetting Project Rule Cache",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\rules\\dist\\cli.js\" hook post-compact"
 					}
 				],

package/packages/omo-codex/plugin/hooks/post-tool-use-checking-codegraph-init-guidance.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/codegraph/dist/cli.js\" hook post-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Checking CodeGraph Init Guidance",
+						"statusMessage": "(OmO 4.17.0) Checking CodeGraph Init Guidance",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\codegraph\\dist\\cli.js\" hook post-tool-use"
 					}
 				],

package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/comment-checker/dist/cli.js\" hook post-tool-use",
 						"timeout": 30,
-						"statusMessage": "(OmO 4.16.3) Checking Comments",
+						"statusMessage": "(OmO 4.17.0) Checking Comments",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\comment-checker\\dist\\cli.js\" hook post-tool-use"
 					}
 				],

package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lsp/dist/cli.js\" hook post-tool-use",
 						"timeout": 60,
-						"statusMessage": "(OmO 4.16.3) Checking LSP Diagnostics",
+						"statusMessage": "(OmO 4.17.0) Checking LSP Diagnostics",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\lsp\\dist\\cli.js\" hook post-tool-use"
 					}
 				],

package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/teammode/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Checking Thread Title Hygiene",
+						"statusMessage": "(OmO 4.17.0) Checking Thread Title Hygiene",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\teammode\\dist\\cli.js\" hook post-tool-use"
 					}
 				]

package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Matching Project Rules",
+						"statusMessage": "(OmO 4.17.0) Matching Project Rules",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\rules\\dist\\cli.js\" hook post-tool-use"
 					}
 				],

package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook pre-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Enforcing Unlimited Goal Budget",
+						"statusMessage": "(OmO 4.17.0) Enforcing Unlimited Goal Budget",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook pre-tool-use"
 					}
 				],

package/packages/omo-codex/plugin/hooks/pre-tool-use-guarding-ulw-loop-spawns.json

@@ -0,0 +1,18 @@
+{
+	"hooks": {
+		"PreToolUse": [
+			{
+				"matcher": "^(spawn_agent|collaborationspawn_agent|collaboration\\.spawn_agent)$",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook pre-tool-use-spawn",
+						"timeout": 5,
+						"statusMessage": "(OmO 4.17.0) Guarding Ulw-Loop Spawns",
+						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook pre-tool-use-spawn"
+					}
+				]
+			}
+		]
+	}
+}

package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/git-bash/dist/cli.js\" hook pre-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Recommending Git Bash MCP",
+						"statusMessage": "(OmO 4.17.0) Recommending Git Bash MCP",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\git-bash\\dist\\cli.js\" hook pre-tool-use"
 					}
 				],

package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/scripts/auto-update.mjs\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Checking Auto Update",
+						"statusMessage": "(OmO 4.17.0) Checking Auto Update",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\scripts\\auto-update.mjs\" hook session-start"
 					}
 				],

package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json

@@ -8,7 +8,7 @@
 						"command": "node \"${PLUGIN_ROOT}/components/bootstrap/dist/cli.js\" hook session-start",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\bootstrap.ps1\"",
 						"timeout": 30,
-						"statusMessage": "(OmO 4.16.3) Checking Bootstrap Provisioning"
+						"statusMessage": "(OmO 4.17.0) Checking Bootstrap Provisioning"
 					}
 				]
 			}

package/packages/omo-codex/plugin/hooks/session-start-checking-codegraph-bootstrap.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/codegraph/dist/cli.js\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Checking CodeGraph Bootstrap",
+						"statusMessage": "(OmO 4.17.0) Checking CodeGraph Bootstrap",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\codegraph\\dist\\cli.js\" hook session-start"
 					}
 				]

package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook session-start",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Loading Project Rules",
+						"statusMessage": "(OmO 4.17.0) Loading Project Rules",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\rules\\dist\\cli.js\" hook session-start"
 					}
 				]

package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/telemetry/dist/cli.js\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.3) Recording Session Telemetry",
+						"statusMessage": "(OmO 4.17.0) Recording Session Telemetry",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\telemetry\\dist\\cli.js\" hook session-start"
 					}
 				]

package/packages/omo-codex/plugin/hooks/stop-checking-start-work-continuation.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/start-work-continuation/dist/cli.js\" hook stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Checking Start-Work Continuation",
+						"statusMessage": "(OmO 4.17.0) Checking Start-Work Continuation",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\start-work-continuation\\dist\\cli.js\" hook stop"
 					}
 				]

package/packages/omo-codex/plugin/hooks/stop-checking-ulw-loop-resume.json

@@ -0,0 +1,17 @@
+{
+	"hooks": {
+		"Stop": [
+			{
+				"hooks": [
+					{
+						"type": "command",
+						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook stop",
+						"timeout": 10,
+						"statusMessage": "(OmO 4.17.0) Checking Ulw-Loop Resume",
+						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook stop"
+					}
+				]
+			}
+		]
+	}
+}

package/packages/omo-codex/plugin/hooks/subagent-stop-checking-start-work-continuation.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/start-work-continuation/dist/cli.js\" hook subagent-stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Checking Start-Work Continuation",
+						"statusMessage": "(OmO 4.17.0) Checking Start-Work Continuation",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\start-work-continuation\\dist\\cli.js\" hook subagent-stop"
 					}
 				]

package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json

@@ -7,11 +7,11 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lazycodex-executor-verify/dist/cli.js\" hook subagent-stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.3) Verifying LazyCodex Executor Evidence",
+						"statusMessage": "(OmO 4.17.0) Verifying LazyCodex Executor Evidence",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\lazycodex-executor-verify\\dist\\cli.js\" hook subagent-stop"
 					}
 				],
-				"matcher": "^lazycodex-executor$"
+				"matcher": "^lazycodex-worker-(low|medium|high)$"
 			}
 		]
 	}