lazycodex-ai 5.0.0-beta.48 → 5.0.0-beta.49

package/packages/omo-codex/plugin/components/ulw-loop/src/surface.ts

@@ -36,17 +36,29 @@ export type UlwLoopGateSection = "codeReview" | "manualQa" | "gateReview" | "ite
 
 export const REQUIRED_GATE_SECTIONS_BY_SURFACE: Readonly<Record<UlwLoopToolkitSurface, readonly UlwLoopGateSection[]>> =
 	{
-		lazycodex: ["codeReview", "manualQa", "gateReview", "iteration", "criteriaCoverage"],
+		lazycodex: ["manualQa", "gateReview", "iteration", "criteriaCoverage"],
 		"omo-senpi": ["manualQa", "gateReview", "iteration", "criteriaCoverage"],
 	};
 
+export const OPTIONAL_GATE_SECTIONS_BY_SURFACE: Readonly<Record<UlwLoopToolkitSurface, readonly UlwLoopGateSection[]>> =
+	{
+		lazycodex: ["codeReview"],
+		"omo-senpi": [],
+	};
+
 export const GATE_SECTION_BY_ACCEPTOR: Readonly<
 	Record<UlwLoopToolkitSurface, Readonly<Partial<Record<UlwLoopGateSection, readonly string[]>>>>
 > = {
 	lazycodex: {
-		codeReview: [REVIEWER_ROLES_BY_SURFACE.lazycodex.codeReview],
-		manualQa: [REVIEWER_ROLES_BY_SURFACE.lazycodex.manualQa],
-		gateReview: [REVIEWER_ROLES_BY_SURFACE.lazycodex.gateReview],
+		codeReview: [REVIEWER_ROLES_BY_SURFACE.lazycodex.codeReview, "main-session"],
+		manualQa: [REVIEWER_ROLES_BY_SURFACE.lazycodex.manualQa, "main-session"],
+		gateReview: [
+			REVIEWER_ROLES_BY_SURFACE.lazycodex.gateReview,
+			"category:deep",
+			"category:unspecified-high",
+			"category:unspecified-low",
+			"main-session",
+		],
 	},
 	"omo-senpi": {
 		manualQa: ["main-session"],

package/packages/omo-codex/plugin/components/ulw-loop/test/checkpoint-final.test.ts

@@ -47,7 +47,7 @@ describe("checkpointUlwLoop final story surface resolution", () => {
 		expect(result.plan.aggregateCompletion?.status).toBe("complete");
 	});
 
-	it("#given the same codeReview-free gate #when the surface is lazycodex #then the final story is rejected", async () => {
+	it("#given the same codeReview-free gate #when the surface is lazycodex #then the final story completes", async () => {
 		const repo = await repoWith(
 			plan([passGoal("G001", { status: "complete" }), passGoal("G002")], { activeGoalId: "G002" }),
 		);
@@ -59,17 +59,16 @@ describe("checkpointUlwLoop final story surface resolution", () => {
 		requiredSection(gate, "manualQa")["by"] = "main-session";
 		requiredSection(gate, "gateReview")["by"] = "category:deep";
 
-		await expectCode(
-			() =>
-				checkpointUlwLoop(repo, {
-					goalId: "G002",
-					status: "complete",
-					evidence: "final work complete and validation passed",
-					codexGoalJson: snapshot("complete"),
-					qualityGateJson: JSON.stringify(gate),
-				}),
-			"ULW_LOOP_QUALITY_GATE_INVALID",
-		);
+		const result = await checkpointUlwLoop(repo, {
+			goalId: "G002",
+			status: "complete",
+			evidence: "final work complete and validation passed",
+			codexGoalJson: snapshot("complete"),
+			qualityGateJson: JSON.stringify(gate),
+		});
+
+		expect(result.aggregateCompletion?.status).toBe("complete");
+		expect(result.plan.aggregateCompletion?.status).toBe("complete");
 	});
 
 	it("#given the omo-senpi surface #when the gate includes codeReview #then the final story is rejected", async () => {

package/packages/omo-codex/plugin/components/ulw-loop/test/quality-gate-fields-messages.test.ts

@@ -0,0 +1,98 @@
+import { describe, expect, it } from "vitest";
+
+import { ULW_LOOP_HELP } from "../src/cli-output.js";
+import { validateQualityGate } from "../src/quality-gate.js";
+import { statusNextActions } from "../src/status-next-actions.js";
+import type { UlwLoopPlan } from "../src/types.js";
+
+const NOW = "2026-05-23T00:00:00.000Z";
+
+const GATE_WITHOUT_MANUAL_QA = {
+	codeReview: {
+		by: "lazycodex-code-reviewer",
+		recommendation: "APPROVE",
+		codeQualityStatus: "CLEAR",
+		reportPath: "code-review.md",
+		evidence: "Reviewed the diff; no blocking issues remain.",
+		blockers: [],
+	},
+	gateReview: {
+		by: "lazycodex-gate-reviewer",
+		recommendation: "APPROVE",
+		reportPath: "gate-review.md",
+		evidence: "Gate is approved.",
+		blockers: [],
+	},
+	iteration: {
+		fullRerun: true,
+		status: "passed",
+		rerunCommands: ["true"],
+		evidence: "Rerun passed.",
+	},
+	criteriaCoverage: {
+		totalCriteria: 1,
+		passCount: 1,
+		originalIntent: "Ship a complete gate.",
+		desiredOutcome: "The gate names accepted input forms.",
+		userOutcomeReview: "Outcome matches the request.",
+		adversarialClassesCovered: ["malformed_input"],
+	},
+};
+
+function thrownMessage(run: () => unknown): string {
+	try {
+		run();
+	} catch (error) {
+		return error instanceof Error ? error.message : String(error);
+	}
+	return "";
+}
+
+describe("quality-gate field and status messages", () => {
+	it("missing-manualQa error contains accepted input and names bare-object and top-level qualityGate forms", () => {
+		const message = thrownMessage(() => validateQualityGate(GATE_WITHOUT_MANUAL_QA));
+
+		expect(message).toContain("accepted input");
+		expect(message).toContain("bare object");
+		expect(message).toContain('top-level "qualityGate" key');
+	});
+
+	it("status next-action text mentions currentAttemptDir", () => {
+		const plan: UlwLoopPlan = {
+			version: 1,
+			createdAt: NOW,
+			updatedAt: NOW,
+			briefPath: ".omo/ulw-loop/brief.md",
+			goalsPath: ".omo/ulw-loop/goals.json",
+			ledgerPath: ".omo/ulw-loop/ledger.jsonl",
+			activeGoalId: "G001",
+			goals: [
+				{
+					id: "G001",
+					title: "Goal one",
+					objective: "Complete goal one",
+					status: "in_progress",
+					successCriteria: [
+						{
+							id: "C001",
+							scenario: "works",
+							userModel: "happy",
+							expectedEvidence: "proof",
+							capturedEvidence: "passed",
+							status: "pass",
+						},
+					],
+					attempt: 1,
+					createdAt: NOW,
+					updatedAt: NOW,
+				},
+			],
+		};
+
+		expect(statusNextActions(plan).join("\n")).toContain("currentAttemptDir");
+	});
+
+	it("CLI help mentions currentAttemptDir", () => {
+		expect(ULW_LOOP_HELP).toContain("currentAttemptDir");
+	});
+});

package/packages/omo-codex/plugin/components/ulw-loop/test/quality-gate-lazycodex-surface.test.ts

@@ -0,0 +1,93 @@
+import { expect, it } from "vitest";
+import { validateQualityGate } from "../src/quality-gate.js";
+
+const base = {
+	manualQa: {
+		by: "main-session",
+		status: "passed",
+		evidence: "qa",
+		surfaceEvidence: [
+			{ id: "s", criterionRef: "C1", surface: "cli", invocation: "true", verdict: "passed", artifactRefs: ["a"] },
+		],
+		adversarialCases: [
+			{
+				id: "x",
+				criterionRef: "C1",
+				scenario: "x",
+				expectedBehavior: "x",
+				verdict: "not_applicable",
+				reason: "x",
+				artifactRefs: ["a"],
+			},
+		],
+		artifactRefs: [{ id: "a", kind: "cli-transcript", description: "a", path: "qa.txt" }],
+	},
+	gateReview: {
+		by: "category:unspecified-high",
+		recommendation: "APPROVE",
+		reportPath: "gate.md",
+		evidence: "gate",
+		blockers: [],
+	},
+	iteration: { fullRerun: true, status: "passed", rerunCommands: ["true"], evidence: "rerun" },
+	criteriaCoverage: {
+		totalCriteria: 1,
+		passCount: 1,
+		originalIntent: "i",
+		desiredOutcome: "d",
+		userOutcomeReview: "u",
+		adversarialClassesCovered: ["x"],
+	},
+};
+it("accepts lazycodex self-review gate without codeReview", () =>
+	expect(() => validateQualityGate(base)).not.toThrow());
+it("accepts wrapped and optional codeReview forms", () => {
+	expect(() => validateQualityGate({ qualityGate: base })).not.toThrow();
+	expect(() =>
+		validateQualityGate({
+			...base,
+			codeReview: {
+				by: "lazycodex-code-reviewer",
+				recommendation: "APPROVE",
+				codeQualityStatus: "CLEAR",
+				reportPath: "code.md",
+				evidence: "review",
+				blockers: [],
+			},
+		}),
+	).not.toThrow();
+});
+it("#given main-session codeReview #when validated #then preserves the accepted author", () => {
+	const gate = validateQualityGate({
+		...base,
+		codeReview: {
+			by: "main-session",
+			recommendation: "APPROVE",
+			codeQualityStatus: "CLEAR",
+			reportPath: "code.md",
+			evidence: "review",
+			blockers: [],
+		},
+	});
+	expect(gate.surface).toBe("lazycodex");
+	if (gate.surface === "lazycodex") expect(gate.codeReview?.by).toBe("main-session");
+});
+it("#given random codeReview author #when validated #then rejects the lane", () => {
+	expect(() =>
+		validateQualityGate({
+			...base,
+			codeReview: {
+				by: "random",
+				recommendation: "APPROVE",
+				codeQualityStatus: "CLEAR",
+				reportPath: "code.md",
+				evidence: "review",
+				blockers: [],
+			},
+		}),
+	).toThrow(/codeReview\.by/);
+});
+it("rejects an unknown gate acceptor", () =>
+	expect(() => validateQualityGate({ ...base, gateReview: { ...base.gateReview, by: "random-agent" } })).toThrow(
+		/gateReview\.by/,
+	));

package/packages/omo-codex/plugin/components/ulw-loop/test/quality-gate-roles.test.ts

@@ -132,10 +132,15 @@ describe("validateQualityGate reviewer roles", () => {
 		expect(error.message).toContain("no codeReview lane");
 	});
 
-	it("#given a four-section senpi gate #when validated on the default lazycodex surface #then codeReview is required", () => {
-		const error = qualityGateError(senpiGate());
-		expect(error.code).toBe("ULW_LOOP_QUALITY_GATE_INVALID");
-		expect(error.message).toContain("codeReview");
+	it("#given a four-section gate #when validated on the default lazycodex surface #then codeReview is optional", () => {
+		expect(() =>
+			validateQualityGate(
+				senpiGate({
+					manualQa: { ...BASE_GATE.manualQa, by: "main-session" },
+					gateReview: { ...BASE_GATE.gateReview, by: "category:deep" },
+				}),
+			),
+		).not.toThrow();
 	});
 
 	it("#given swapped omo-senpi reviewer roles #when validated on the omo-senpi surface #then section-specific roles are enforced", () => {

package/packages/omo-codex/plugin/components/ulw-loop/test/quality-gate.test.ts

@@ -136,6 +136,16 @@ describe("validateQualityGate", () => {
 		expect(gate.manualQa.artifactRefs).toHaveLength(5);
 	});
 
+	it("#given missing manualQa section #when validated #then it explains accepted input forms", () => {
+		const input = makeGate();
+		delete input["manualQa"];
+
+		const error = getQualityGateError(input);
+
+		expect(error.message).toContain("accepted input");
+		expect(error.message).toContain('top-level "qualityGate" key');
+	});
+
 	it("#given missing manualQa surface evidence #when validated #then it fails closed", () => {
 		// given
 		const input = makeGate({

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

@@ -2,18 +2,22 @@ import { 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 { Readable, Writable } from "node:stream";
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
 
 import type { PreToolUsePayload } from "../src/codex-hook.ts";
-import { applySpawnGuards } from "../src/spawn-guard.ts";
+import { applySpawnGuards, DEFAULT_FANOUT_LIMIT, runSpawnAdmissionRecorderCli } from "../src/spawn-guard.ts";
 
 let workDir: string;
 let originalLimit: string | undefined;
 let originalReviewLimit: string | undefined;
 let originalToolkitSurface: string | undefined;
+let originalPluginData: string | undefined;
 
 beforeEach(async () => {
 	workDir = await mkdtemp(join(tmpdir(), "ulw-spawn-guard-"));
+	originalPluginData = process.env["PLUGIN_DATA"];
+	process.env["PLUGIN_DATA"] = join(workDir, "plugin-data");
 	originalLimit = process.env["OMO_SPAWN_FANOUT_LIMIT"];
 	originalReviewLimit = process.env["OMO_ULW_LOOP_REVIEW_SPAWN_LIMIT"];
 	originalToolkitSurface = process.env["OMO_AGENT_TOOLKIT_SURFACE"];
@@ -30,6 +34,8 @@ afterEach(async () => {
 	else process.env["OMO_ULW_LOOP_REVIEW_SPAWN_LIMIT"] = originalReviewLimit;
 	if (originalToolkitSurface === undefined) delete process.env["OMO_AGENT_TOOLKIT_SURFACE"];
 	else process.env["OMO_AGENT_TOOLKIT_SURFACE"] = originalToolkitSurface;
+	if (originalPluginData === undefined) delete process.env["PLUGIN_DATA"];
+	else process.env["PLUGIN_DATA"] = originalPluginData;
 	await rm(workDir, { recursive: true, force: true });
 });
 
@@ -98,7 +104,66 @@ function deny(output: string): { permissionDecision: string; permissionDecisionR
 	return JSON.parse(output).hookSpecificOutput;
 }
 
+describe("spawn admission breaker", () => {
+	async function record(response: unknown): Promise<string> {
+		let output = "";
+		const stdout = new Writable({
+			write(chunk, _encoding, callback) {
+				output += chunk.toString();
+				callback();
+			},
+		});
+		await runSpawnAdmissionRecorderCli(
+			Readable.from([
+				JSON.stringify({
+					...payload("spawn_agent", { message: "scan" }),
+					hook_event_name: "PostToolUse",
+					tool_response: response,
+				}),
+			]),
+			stdout,
+		);
+		return output;
+	}
+
+	it.each(["too many active cells", "AgentLimitReached", "max_threads", "max_concurrent_threads_per_session"])(
+		"records %s silently and denies without a plan while isolating other sessions",
+		async (reason) => {
+			expect(await record(reason)).toBe("");
+			const marker = JSON.parse(readFileSync(join(workDir, "plugin-data", "spawn-breaker", "s1.json"), "utf8"));
+			expect(Object.keys(marker).sort()).toEqual(["at", "reason"]);
+			expect(marker.reason).toBe(reason);
+			expect(Number.isFinite(Date.parse(marker.at))).toBe(true);
+			expect(deny(applySpawnGuards(payload("spawn_agent", {}))).permissionDecision).toBe("deny");
+			expect(applySpawnGuards({ ...payload("spawn_agent", {}), session_id: "clean" })).toBe("");
+		},
+	);
+
+	it("does not record a successful admission", async () => {
+		expect(await record({ agent_id: "worker-1" })).toBe("");
+		expect(existsSync(join(workDir, "plugin-data", "spawn-breaker", "s1.json"))).toBe(false);
+	});
+
+	it("denies before artifact, quota, and state lock guards", async () => {
+		writeGoals();
+		writeFileSync(
+			join(sessionDir(), ".state.lock"),
+			JSON.stringify({ pid: process.pid, createdAt: new Date().toISOString(), token: "live" }),
+		);
+		await record("AgentLimitReached");
+		const output = deny(
+			applySpawnGuards(payload("spawn_agent", { agent_type: "lazycodex-gate-reviewer" }), { lockTimeoutMs: 0 }),
+		);
+		expect(output.permissionDecisionReason).toContain("AgentLimitReached");
+		expect(existsSync(join(sessionDir(), "spawn-count.json"))).toBe(false);
+		expect(existsSync(join(sessionDir(), "review-spawn-counts.json"))).toBe(false);
+	});
+});
+
 describe("applySpawnGuards fan-out cap", () => {
+	it("defaults to 24 spawns", () => {
+		expect(DEFAULT_FANOUT_LIMIT).toBe(24);
+	});
 	it("#given spawns under the limit #when guarded #then allows and counts", () => {
 		writeGoals();
 
@@ -251,7 +316,7 @@ describe("applySpawnGuards gate-artifact guard", () => {
 		);
 
 		expect(output).not.toBe("");
-		expect(deny(output).permissionDecisionReason).toContain("g1-code-review.md");
+		expect(deny(output).permissionDecisionReason).toContain("g1-manual-qa.md");
 		expect(existsSync(join(sessionDir(), "review-spawn-counts.json"))).toBe(false);
 	});
 
@@ -265,7 +330,7 @@ describe("applySpawnGuards gate-artifact guard", () => {
 		const parsed = deny(output);
 		expect(parsed.permissionDecision).toBe("deny");
 		expect(parsed.permissionDecisionReason).toContain("missing");
-		expect(parsed.permissionDecisionReason).toContain("g1-code-review.md");
+		expect(parsed.permissionDecisionReason).toContain("g1-manual-qa.md");
 	});
 
 	it("#given senpi main-session QA is present but code review is absent #when the gate reviewer spawns #then the self-check allows it", () => {
@@ -366,10 +431,9 @@ describe("applySpawnGuards gate-artifact guard", () => {
 		expect(counters["lazycodex-code-reviewer:g1:a1"]).toBeUndefined();
 	});
 
-	it("#given v1 artifacts on disk #when the gate spawns #then allows", () => {
+	it("#given only v1 manual QA 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(
@@ -388,14 +452,13 @@ describe("applySpawnGuards gate-artifact guard", () => {
 			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");
+		expect(deny(output).permissionDecisionReason).toContain(".omo/evidence/ulw/s1/g1/a1/g1-manual-qa.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(

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 5.0.0-beta.48) Resetting Git Bash MCP Reminder",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Resetting LSP Diagnostics Cache",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Resetting Project Rule Cache",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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-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 5.0.0-beta.48) Checking Comments",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Checking LSP Diagnostics",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Checking Thread Title Hygiene",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Matching Project Rules",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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/post-tool-use-recording-spawn-admission.json

@@ -0,0 +1,18 @@
+{
+	"hooks": {
+		"PostToolUse": [
+			{
+				"matcher": "^(spawn_agent|collaborationspawn_agent|collaboration\\.spawn_agent)$",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook post-tool-use-spawn",
+						"timeout": 5,
+						"statusMessage": "(OmO 5.0.0-beta.49) Recording Spawn Admission",
+						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-loop\\dist\\cli.js\" hook post-tool-use-spawn"
+					}
+				]
+			}
+		]
+	}
+}

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 5.0.0-beta.48) Enforcing Unlimited Goal Budget",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook pre-tool-use-spawn",
 						"timeout": 5,
-						"statusMessage": "(OmO 5.0.0-beta.48) Guarding Ulw-Loop Spawns",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Recommending Git Bash MCP",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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": 15,
-						"statusMessage": "(OmO 5.0.0-beta.48) Checking Auto Update",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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 5.0.0-beta.48) Checking Bootstrap Provisioning"
+						"statusMessage": "(OmO 5.0.0-beta.49) Checking Bootstrap Provisioning"
 					}
 				]
 			}

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 5.0.0-beta.48) Loading Project Rules",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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": 15,
-						"statusMessage": "(OmO 5.0.0-beta.48) Recording Session Telemetry",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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-ulw-execute-continuation.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.0.0-beta.48) Checking Ulw-Execute Continuation",
+						"statusMessage": "(OmO 5.0.0-beta.49) Checking Ulw-Execute Continuation",
 						"commandWindows": "powershell -NoProfile -ExecutionPolicy Bypass -File \"${PLUGIN_ROOT}\\components\\bootstrap\\scripts\\node-dispatch.ps1\" \"${PLUGIN_ROOT}\\components\\ulw-execute-continuation\\dist\\cli.js\" hook stop"
 					}
 				]

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

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.0.0-beta.48) Checking Ulw-Loop Resume",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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-verifying-lazycodex-executor-evidence.json

@@ -7,7 +7,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lazycodex-executor-verify/dist/cli.js\" hook subagent-stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 5.0.0-beta.48) Verifying LazyCodex Executor Evidence",
+						"statusMessage": "(OmO 5.0.0-beta.49) 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"
 					}
 				],