oh-my-opencode 4.12.1 → 4.14.0

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

@@ -1,5 +1,6 @@
 import type { UlwLoopScope } from "./paths.js";
 import { parseUlwLoopSteeringDirective, steerUlwLoop } from "./steering.js";
+import { buildUltraworkDirectiveOutput } from "./ultrawork-directive.js";
 
 export interface UserPromptSubmitPayload {
 	readonly cwd: string;
@@ -8,10 +9,14 @@ export interface UserPromptSubmitPayload {
 	readonly permission_mode?: string;
 	readonly prompt: string;
 	readonly session_id: string;
-	readonly transcript_path?: string;
+	readonly transcript_path?: string | null;
 	readonly turn_id?: string;
 }
 
+export interface UserPromptSubmitHookOptions {
+	readonly includeUltraworkDirective?: boolean;
+}
+
 export interface PreToolUsePayload {
 	readonly cwd: string;
 	readonly hook_event_name: "PreToolUse";
@@ -60,11 +65,17 @@ export function parsePreToolUsePayload(raw: string): PreToolUsePayload | null {
 	}
 }
 
-export async function applyUserPromptUlwLoopSteering(payload: UserPromptSubmitPayload): Promise<string> {
+export async function applyUserPromptUlwLoopSteering(
+	payload: UserPromptSubmitPayload,
+	options: UserPromptSubmitHookOptions = {},
+): Promise<string> {
 	try {
 		if (payload.hook_event_name !== "UserPromptSubmit") return "";
 		const proposal = parseUlwLoopSteeringDirective(payload.prompt);
-		if (proposal === null) return "";
+		if (proposal === null) {
+			if (hasSteeringDirectiveMarker(payload.prompt)) return "";
+			return options.includeUltraworkDirective ? buildUltraworkDirectiveOutput(payload) : "";
+		}
 		const result = await steerUlwLoop(payload.cwd, proposal, payloadScope(payload));
 		if (!result.accepted) return "";
 		return JSON.stringify({
@@ -79,6 +90,10 @@ export async function applyUserPromptUlwLoopSteering(payload: UserPromptSubmitPa
 	}
 }
 
+function hasSteeringDirectiveMarker(prompt: string): boolean {
+	return /(?:^|\s)(?:OMO_ULW_LOOP_STEER|omo\.ulw-loop\.steer|omo ulw-loop steer):/u.test(prompt);
+}
+
 function payloadScope(payload: UserPromptSubmitPayload): UlwLoopScope {
 	return { sessionId: payload.session_id };
 }
@@ -98,11 +113,15 @@ export function applyPreToolUseGoalBudgetGuard(payload: PreToolUsePayload): stri
 	return `${JSON.stringify(output)}\n`;
 }
 
-export async function runUlwLoopHookCli(stdin: NodeJS.ReadableStream, stdout: NodeJS.WritableStream): Promise<void> {
+export async function runUlwLoopHookCli(
+	stdin: NodeJS.ReadableStream,
+	stdout: NodeJS.WritableStream,
+	options: UserPromptSubmitHookOptions = {},
+): Promise<void> {
 	try {
 		const payload = parseUserPromptSubmitPayload(await readAll(stdin));
 		if (payload === null) return;
-		const output = await applyUserPromptUlwLoopSteering(payload);
+		const output = await applyUserPromptUlwLoopSteering(payload, options);
 		if (output.length > 0) stdout.write(output);
 	} catch (error) {
 		if (error instanceof Error) return;
@@ -132,7 +151,10 @@ function isUserPromptSubmitPayload(value: unknown): value is UserPromptSubmitPay
 		typeof value["cwd"] === "string" &&
 		typeof value["prompt"] === "string" &&
 		typeof value["session_id"] === "string" &&
-		["model", "permission_mode", "transcript_path", "turn_id"].every((key) => optionalString(value[key]))
+		["model", "permission_mode", "turn_id"].every((key) => optionalString(value[key])) &&
+		(value["transcript_path"] === undefined ||
+			value["transcript_path"] === null ||
+			typeof value["transcript_path"] === "string")
 	);
 }
 

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

@@ -0,0 +1,113 @@
+import { readFileSync } from "node:fs";
+
+export interface UltraworkDirectiveInput {
+	readonly prompt: string;
+	readonly transcript_path?: string | null;
+}
+
+interface UserPromptSubmitHookOutput {
+	readonly hookSpecificOutput: {
+		readonly hookEventName: "UserPromptSubmit";
+		readonly additionalContext: string;
+	};
+}
+
+const ULTRAWORK_DIRECTIVE = readFileSync(new URL("../directive.md", import.meta.url), "utf8");
+const ULTRAWORK_CURRENT_PROMPT_PATTERN = /(?:ultrawork|ulw)/i;
+const ULTRAWORK_DIRECTIVE_MARKER = "<ultrawork-mode>";
+const TRANSCRIPT_SEARCH_BYTES = 512_000;
+const CONTEXT_PRESSURE_MARKERS = [
+	"context compacted",
+	"context_length_exceeded",
+	"skill descriptions were shortened",
+	"context_too_large",
+	"codex ran out of room in the model's context window",
+	"your input exceeds the context window",
+	"long threads and multiple compactions",
+] as const;
+
+export function buildUltraworkDirectiveOutput(input: UltraworkDirectiveInput): string {
+	if (isContextPressureRecoveryPrompt(input.prompt)) return "";
+	if (hasUltraworkDirectiveAlreadyInTranscript(input.transcript_path)) return "";
+	if (isContextPressureTranscript(input.transcript_path)) return "";
+	return isUltraworkPrompt(input.prompt) ? formatAdditionalContextOutput(ULTRAWORK_DIRECTIVE) : "";
+}
+
+function hasUltraworkDirectiveAlreadyInTranscript(transcriptPath: string | null | undefined): boolean {
+	if (transcriptPath === undefined || transcriptPath === null) return false;
+	try {
+		const rawTranscript = readTranscriptTail(transcriptPath);
+		for (const line of rawTranscript.split(/\r?\n/)) {
+			const parsed = parseJsonLine(line);
+			if (!isRecord(parsed)) continue;
+			const hookSpecificOutput = parsed["hookSpecificOutput"];
+			if (!isRecord(hookSpecificOutput)) continue;
+			if (hookSpecificOutput["hookEventName"] !== "UserPromptSubmit") continue;
+			if (
+				typeof hookSpecificOutput["additionalContext"] === "string" &&
+				hookSpecificOutput["additionalContext"].includes(ULTRAWORK_DIRECTIVE_MARKER)
+			) {
+				return true;
+			}
+		}
+	} catch (error) {
+		if (error instanceof Error) return false;
+		throw error;
+	}
+	return false;
+}
+
+function readTranscriptTail(transcriptPath: string): string {
+	const rawTranscript = readFileSync(transcriptPath);
+	return rawTranscript.subarray(Math.max(0, rawTranscript.byteLength - TRANSCRIPT_SEARCH_BYTES)).toString("utf8");
+}
+
+function isUltraworkPrompt(prompt: string): boolean {
+	return ULTRAWORK_CURRENT_PROMPT_PATTERN.test(prompt);
+}
+
+function isContextPressureRecoveryPrompt(prompt: string): boolean {
+	const normalizedPrompt = prompt.toLowerCase();
+	return CONTEXT_PRESSURE_MARKERS.some((marker) => normalizedPrompt.includes(marker));
+}
+
+function isContextPressureTranscript(transcriptPath: string | null | undefined): boolean {
+	if (transcriptPath === undefined || transcriptPath === null) return false;
+	try {
+		return isContextPressureRecoveryPrompt(readTranscriptTail(transcriptPath));
+	} catch (error) {
+		if (error instanceof Error) return false;
+		throw error;
+	}
+}
+
+function formatAdditionalContextOutput(additionalContext: string): string {
+	const normalizedContext = normalizeAdditionalContext(additionalContext);
+	if (normalizedContext.length === 0) return "";
+	const output: UserPromptSubmitHookOutput = {
+		hookSpecificOutput: {
+			hookEventName: "UserPromptSubmit",
+			additionalContext: normalizedContext,
+		},
+	};
+	return `${JSON.stringify(output)}\n`;
+}
+
+function normalizeAdditionalContext(additionalContext: string): string {
+	return additionalContext.replace(/\r\n/g, "\n").replace(/\r/g, "\n").trim();
+}
+
+function parseJsonLine(line: string): unknown | null {
+	if (line.trim().length === 0) return null;
+	try {
+		const parsed: unknown = JSON.parse(line);
+		return parsed;
+	} catch (error) {
+		if (error instanceof Error) return null;
+		throw error;
+	}
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/packages/omo-codex/plugin/components/ulw-loop/test/cli-entrypoint.test.ts

@@ -23,6 +23,15 @@ function sanitizedEnv(): NodeJS.ProcessEnv {
 }
 
 async function runProcess(command: string, args: readonly string[], cwd: string): Promise<CliResult> {
+	return runProcessWithInput(command, args, cwd, "");
+}
+
+async function runProcessWithInput(
+	command: string,
+	args: readonly string[],
+	cwd: string,
+	input: string,
+): Promise<CliResult> {
 	return new Promise((resolvePromise, reject) => {
 		const child = spawn(command, [...args], { cwd, env: sanitizedEnv() });
 		const stdout: Buffer[] = [];
@@ -37,13 +46,14 @@ async function runProcess(command: string, args: readonly string[], cwd: string)
 				stderr: Buffer.concat(stderr).toString("utf8"),
 			});
 		});
+		child.stdin.end(input);
 	});
 }
 
 let workspace: string;
 
-async function runCli(args: readonly string[]): Promise<CliResult> {
-	return runProcess(process.execPath, [builtCli, ...args], workspace);
+async function runCli(args: readonly string[], input = ""): Promise<CliResult> {
+	return runProcessWithInput(process.execPath, [builtCli, ...args], workspace, input);
 }
 
 beforeAll(async () => {
@@ -92,4 +102,25 @@ describe("dist/cli.js entrypoint dispatch", () => {
 		expect(result.code).toBe(1);
 		expect(result.stderr).toContain("[omo] unknown command: frobnicate");
 	});
+
+	it("#given standalone ulw-loop hook asks for ultrawork context #when user prompt is ulw #then emits the ultrawork directive", async () => {
+		const payload = {
+			cwd: workspace,
+			hook_event_name: "UserPromptSubmit",
+			model: "gpt-5.5",
+			permission_mode: "default",
+			prompt: "ulw this change",
+			session_id: "s1",
+			transcript_path: null,
+			turn_id: "t1",
+		};
+
+		const result = await runCli(["hook", "user-prompt-submit", "--with-ultrawork"], `${JSON.stringify(payload)}\n`);
+		const parsed = JSON.parse(result.stdout);
+
+		expect(result.code).toBe(0);
+		expect(result.stderr).toBe("");
+		expect(parsed.hookSpecificOutput.hookEventName).toBe("UserPromptSubmit");
+		expect(parsed.hookSpecificOutput.additionalContext).toMatch(/^<ultrawork-mode>/);
+	});
 });

package/packages/omo-codex/plugin/components/ulw-loop/test/cli-steering-kind-guidance.test.ts

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+
+import { parseSteeringKind } from "../src/cli-steering.js";
+
+describe("#given a steering command without --kind", () => {
+	describe("#when parsing the steering kind", () => {
+		it("#then explains allowed kinds and shows a usable example", () => {
+			const action = (): void => {
+				parseSteeringKind([]);
+			};
+
+			expect(action).toThrow(/Allowed --kind values:/);
+			expect(action).toThrow(/annotate_ledger/);
+			expect(action).toThrow(/omo ulw-loop steer --kind annotate_ledger/);
+		});
+	});
+});
+
+describe("#given a steering command with an invalid --kind", () => {
+	describe("#when parsing the steering kind", () => {
+		it("#then reports the invalid value and lists valid kinds", () => {
+			const action = (): void => {
+				parseSteeringKind(["--kind", "bogus"]);
+			};
+
+			expect(action).toThrow(/Invalid --kind: bogus\./);
+			expect(action).toThrow(/revise_criterion/);
+			expect(action).toThrow(/mark_blocked_superseded/);
+		});
+	});
+});

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

@@ -1,3 +1,5 @@
+// allow: SIZE_OK - ULW loop hook tests share one fake Codex stream/process harness; this release adds narrow hook cases and future additions should split by hook lifecycle.
+
 import { mkdir, mkdtemp, readFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -167,6 +169,10 @@ describe("applyUserPromptUlwLoopSteering - non-matching prompts", () => {
 		expect(await applyUserPromptUlwLoopSteering(payload("just a normal user message", "/tmp"))).toBe("");
 	});
 
+	it("#given standalone ultrawork injection is disabled #when prompt is ulw #then aggregate ulw-loop steering stays silent", async () => {
+		expect(await applyUserPromptUlwLoopSteering(payload("ulw this change", "/tmp"))).toBe("");
+	});
+
 	it("returns empty when hook_event_name is not UserPromptSubmit", async () => {
 		expect(await applyUserPromptUlwLoopSteering(payloadWithRuntimeEvent("PostToolUse"))).toBe("");
 	});
@@ -188,6 +194,13 @@ describe("applyUserPromptUlwLoopSteering - error swallowing", () => {
 		const out = await applyUserPromptUlwLoopSteering(payload("OMO_ULW_LOOP_STEER: {bad", "/tmp"));
 		expect(out).toBe("");
 	});
+
+	it("#given malformed steering and standalone ultrawork enabled #when prompt contains OMO_ULW #then hook does not fall through to ultrawork", async () => {
+		const out = await applyUserPromptUlwLoopSteering(payload("OMO_ULW_LOOP_STEER: {bad", "/tmp"), {
+			includeUltraworkDirective: true,
+		});
+		expect(out).toBe("");
+	});
 });
 
 describe("runUlwLoopHookCli (stdin/stdout integration)", () => {

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

@@ -5,6 +5,7 @@ import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { describe, expect, it } from "vitest";
+import { ULW_LOOP_SUBCOMMANDS } from "../src/cli-commands.js";
 
 const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
 
@@ -69,6 +70,7 @@ describe("package.json", () => {
 		const pkg = await readJson("package.json") as Record<string, unknown>;
 		const files = pkg["files"] as readonly string[];
 		expect(files).toContain("dist");
+		expect(files).toContain("directive.md");
 		expect(files).toContain("hooks");
 		expect(files).toContain("skills");
 		expect(files).not.toContain(".codex-plugin");
@@ -90,6 +92,7 @@ describe("hooks/hooks.json", () => {
 		expect(command).toContain(`$${"{PLUGIN_ROOT}"}`);
 		expect(command).toContain("dist/cli.js");
 		expect(command).toContain("hook user-prompt-submit");
+		expect(command).toContain("--with-ultrawork");
 	});
 
 	it("#given ulw-loop component is enabled #when hooks are inspected #then create_goal PreToolUse guard is registered", async () => {
@@ -200,3 +203,36 @@ describe("source LOC budget", () => {
 		}
 	});
 });
+
+describe("README implementation contract", () => {
+	it("#given the README #when subcommands are inspected #then every implemented CLI subcommand is documented", async () => {
+		const readme = await readText("README.md");
+
+		for (const subcommand of ULW_LOOP_SUBCOMMANDS) {
+			expect(readme, `README documents \`omo ulw-loop ${subcommand}\``).toContain(`omo ulw-loop ${subcommand}`);
+		}
+	});
+
+	it("#given the README #when stale scaffold language is checked #then it is absent", async () => {
+		const readme = await readText("README.md");
+
+		expect(readme).not.toMatch(/scaffold only/i);
+		expect(readme).not.toMatch(/Wave 1/i);
+		expect(readme).not.toMatch(/lands in later waves/i);
+	});
+
+	it("#given the README #when hooks are described #then both hook channels are documented", async () => {
+		const readme = await readText("README.md");
+
+		expect(readme).toContain("UserPromptSubmit");
+		expect(readme).toContain("user-prompt-submit");
+		expect(readme).toContain("PreToolUse");
+		expect(readme).toContain("pre-tool-use");
+	});
+
+	it("#given the README #when the quality gate is described #then criteriaCoverage is named", async () => {
+		const readme = await readText("README.md");
+
+		expect(readme).toContain("criteriaCoverage");
+	});
+});

package/packages/omo-codex/plugin/components/ulw-loop/test/skill-contract.test.ts

@@ -33,6 +33,18 @@ describe("ulw-loop skill contract", () => {
 		expect(workflow).toMatch(/none-applicable/);
 	});
 
+	it("#given full workflow #when optimization work is planned #then speed and behavior evidence are required per attempt", async () => {
+		// given
+		const workflow = await readFile(FULL_WORKFLOW_URL, "utf8");
+
+		// then
+		expect(workflow).toMatch(/(?:optimization|performance) work[^.]+baseline speed[^.]+before/i);
+		expect(workflow).toMatch(/baseline speed[^.]+behavior[^.]+regression/i);
+		expect(workflow).toMatch(
+			/(?:each|every) (?:try|attempt)[^.]+speed[^.]+(?:behavior|regression)[^.]+(?:keep|revert|iterate)/i,
+		);
+	});
+
 	it("#given full workflow #when checkpoint guidance is inspected #then non-final and final criteria gates differ", async () => {
 		// given
 		const workflow = await readFile(FULL_WORKFLOW_URL, "utf8");
@@ -52,7 +64,7 @@ describe("ulw-loop skill contract", () => {
 
 		// then
 		expect(workflow.match(/malformed input, prompt injection/g)?.length ?? 0).toBe(1);
-		expect(wordCount(workflow)).toBeLessThanOrEqual(3544);
+		expect(wordCount(workflow)).toBeLessThanOrEqual(3697);
 		expect(wordCount(skill)).toBeLessThanOrEqual(611);
 	});
 });

package/packages/omo-codex/plugin/components/ulw-loop/test/ultrawork-directive.test.ts

@@ -0,0 +1,64 @@
+import { mkdtemp, readFile, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+import { describe, expect, it } from "vitest";
+
+import { applyUserPromptUlwLoopSteering, type UserPromptSubmitPayload } from "../src/codex-hook.js";
+
+const DEFAULT_SESSION_ID = "s1";
+
+function payload(prompt: string, cwd: string): UserPromptSubmitPayload {
+	return { cwd, hook_event_name: "UserPromptSubmit", prompt, session_id: DEFAULT_SESSION_ID };
+}
+
+async function payloadWithTranscript(prompt: string, transcript: string): Promise<UserPromptSubmitPayload> {
+	const repoRoot = await mkdtemp(join(tmpdir(), "ug-hook-transcript-"));
+	const transcriptPath = join(repoRoot, "transcript.jsonl");
+	await writeFile(transcriptPath, transcript);
+	return { ...payload(prompt, repoRoot), transcript_path: transcriptPath };
+}
+
+describe("standalone ultrawork directive injection", () => {
+	it("#given standalone ultrawork injection is enabled #when prompt is ulw #then emits the ultrawork directive", async () => {
+		const output = await applyUserPromptUlwLoopSteering(payload("ulw this change", "/tmp"), {
+			includeUltraworkDirective: true,
+		});
+		const parsed = JSON.parse(output);
+
+		expect(parsed.hookSpecificOutput.hookEventName).toBe("UserPromptSubmit");
+		expect(parsed.hookSpecificOutput.additionalContext).toMatch(/^<ultrawork-mode>/);
+	});
+
+	it("#given transcript already has ultrawork directive #when standalone injection is enabled #then emits no duplicate", async () => {
+		const input = await payloadWithTranscript(
+			"ulw this change",
+			`${JSON.stringify({
+				hookSpecificOutput: {
+					hookEventName: "UserPromptSubmit",
+					additionalContext: "<ultrawork-mode>\nexisting directive",
+				},
+			})}\n`,
+		);
+
+		expect(await applyUserPromptUlwLoopSteering(input, { includeUltraworkDirective: true })).toBe("");
+	});
+
+	it("#given context-pressure marker exists only outside transcript tail #when standalone injection is enabled #then emits the directive", async () => {
+		const input = await payloadWithTranscript(
+			"ulw this change",
+			`context_length_exceeded\n${"old transcript padding\n".repeat(32_000)}`,
+		);
+		const output = await applyUserPromptUlwLoopSteering(input, { includeUltraworkDirective: true });
+		const parsed = JSON.parse(output);
+
+		expect(parsed.hookSpecificOutput.additionalContext).toMatch(/^<ultrawork-mode>/);
+	});
+
+	it("#given ulw-loop bundles the ultrawork directive #when compared to ultrawork #then the copy stays byte-identical", async () => {
+		const ulwLoopDirective = await readFile(new URL("../directive.md", import.meta.url), "utf8");
+		const ultraworkDirective = await readFile(new URL("../../ultrawork/directive.md", import.meta.url), "utf8");
+
+		expect(ulwLoopDirective).toBe(ultraworkDirective);
+	});
+});

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/git-bash/dist/cli.js\" hook post-compact",
 						"timeout": 5,
-						"statusMessage": "(OmO) Resetting Git Bash MCP Reminder"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "manual|auto"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lsp/dist/cli.js\" hook post-compact",
 						"timeout": 5,
-						"statusMessage": "(OmO) Resetting LSP Diagnostics Cache"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "manual|auto"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook post-compact",
 						"timeout": 10,
-						"statusMessage": "(OmO) Resetting Project Rule Cache"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "manual|auto"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/codegraph/dist/cli.js\" hook post-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO) Checking CodeGraph Init Guidance"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^(codegraph[._].*|mcp__codegraph__.*)$"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/comment-checker/dist/cli.js\" hook post-tool-use",
 						"timeout": 30,
-						"statusMessage": "(OmO) Checking Comments"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^(apply_patch|write|Write|edit|Edit|multi_edit|multiedit|MultiEdit)$"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lsp/dist/cli.js\" hook post-tool-use",
 						"timeout": 60,
-						"statusMessage": "(OmO) Checking LSP Diagnostics"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^(apply_patch|write|Write|edit|Edit|multi_edit|multiedit|MultiEdit)$"

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

@@ -8,7 +8,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/teammode/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO) Checking Thread Title Hygiene"
+						"statusMessage": "(OmO) 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,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook post-tool-use",
 						"timeout": 10,
-						"statusMessage": "(OmO) Matching Project Rules"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^apply_patch$"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/ulw-loop/dist/cli.js\" hook pre-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO) Enforcing Unlimited Goal Budget"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^create_goal$"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/git-bash/dist/cli.js\" hook pre-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO) Recommending Git Bash MCP"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^Bash$"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/scripts/auto-update.mjs\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO) Checking Auto Update"
+						"statusMessage": "(OmO) 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"
 					}
 				],
 				"matcher": "^startup$"

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

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/codegraph/dist/cli.js\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO) Checking CodeGraph Bootstrap"
+						"statusMessage": "(OmO) 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,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/rules/dist/cli.js\" hook session-start",
 						"timeout": 10,
-						"statusMessage": "(OmO) Loading Project Rules"
+						"statusMessage": "(OmO) 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,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/telemetry/dist/cli.js\" hook session-start",
 						"timeout": 5,
-						"statusMessage": "(OmO) Recording Session Telemetry"
+						"statusMessage": "(OmO) 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,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/start-work-continuation/dist/cli.js\" hook stop",
 						"timeout": 10,
-						"statusMessage": "(OmO) Checking Start-Work Continuation"
+						"statusMessage": "(OmO) 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/subagent-stop-checking-start-work-continuation.json

@@ -7,7 +7,8 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/start-work-continuation/dist/cli.js\" hook subagent-stop",
 						"timeout": 10,
-						"statusMessage": "(OmO) Checking Start-Work Continuation"
+						"statusMessage": "(OmO) 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"
 					}
 				]
 			}