oh-my-opencode 4.12.0 → 4.12.1

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

@@ -0,0 +1,125 @@
+export interface PostToolUsePayload {
+	readonly hook_event_name: "PostToolUse";
+	readonly session_id: string;
+	readonly turn_id?: string;
+	readonly transcript_path?: string | null;
+	readonly cwd?: string;
+	readonly model?: string;
+	readonly permission_mode?: string;
+	readonly tool_name: string;
+	readonly tool_use_id?: string;
+	readonly tool_input: unknown;
+	readonly tool_response: unknown;
+}
+
+interface PostToolUseHookOutput {
+	readonly hookSpecificOutput: {
+		readonly hookEventName: "PostToolUse";
+		readonly additionalContext: string;
+	};
+}
+
+type ThreadCreationReference =
+	| { readonly kind: "thread"; readonly id: string }
+	| { readonly kind: "pendingWorktree"; readonly id: string };
+
+const CREATE_THREAD_TOOL_NAMES = new Set(["create_thread", "codex_app.create_thread"]);
+
+export function parsePostToolUsePayload(raw: string): PostToolUsePayload | null {
+	if (raw.trim().length === 0) return null;
+	try {
+		const parsed: unknown = JSON.parse(raw);
+		return isPostToolUsePayload(parsed) ? parsed : null;
+	} catch (error) {
+		if (error instanceof SyntaxError) return null;
+		return null;
+	}
+}
+
+export function runPostToolUseHook(payload: PostToolUsePayload): string {
+	if (payload.hook_event_name !== "PostToolUse") return "";
+	if (!CREATE_THREAD_TOOL_NAMES.has(payload.tool_name)) return "";
+	const threadReference = extractThreadCreationReference(payload.tool_response);
+	if (threadReference === null) return "";
+	const output: PostToolUseHookOutput = {
+		hookSpecificOutput: {
+			hookEventName: "PostToolUse",
+			additionalContext: threadTitleReminder(threadReference),
+		},
+	};
+	return `${JSON.stringify(output)}\n`;
+}
+
+export async function runTeammodeHookCli(
+	stdin: NodeJS.ReadableStream,
+	stdout: NodeJS.WritableStream,
+): Promise<void> {
+	const payload = parsePostToolUsePayload(await readAll(stdin));
+	if (payload === null) return;
+	const output = runPostToolUseHook(payload);
+	if (output.length > 0) stdout.write(output);
+}
+
+function threadTitleReminder(threadReference: ThreadCreationReference): string {
+	const id = formatIdentifier(threadReference.id);
+	return threadReference.kind === "thread"
+		? `THREAD ID ${id}: CALL codex_app.set_thread_title NOW. USE THE REAL TASK/ROLE.`
+		: `PENDING WORKTREE ID ${id}: CALL codex_app.set_thread_title AS SOON AS THREAD ID EXISTS. USE THE REAL TASK/ROLE.`;
+}
+
+function formatIdentifier(value: string): string {
+	const normalized = value.replace(/\s+/g, " ").trim();
+	return normalized.length <= 200 ? normalized : `${normalized.slice(0, 197)}...`;
+}
+
+function extractThreadCreationReference(toolResponse: unknown): ThreadCreationReference | null {
+	if (!isRecord(toolResponse)) return null;
+	const threadId = toolResponse["threadId"];
+	if (typeof threadId === "string" && threadId.trim().length > 0) {
+		return { kind: "thread", id: threadId };
+	}
+	const pendingWorktreeId = toolResponse["pendingWorktreeId"];
+	if (typeof pendingWorktreeId === "string" && pendingWorktreeId.trim().length > 0) {
+		return { kind: "pendingWorktree", id: pendingWorktreeId };
+	}
+	return null;
+}
+
+function isPostToolUsePayload(value: unknown): value is PostToolUsePayload {
+	if (!isRecord(value)) return false;
+	return (
+		value["hook_event_name"] === "PostToolUse" &&
+		typeof value["session_id"] === "string" &&
+		typeof value["tool_name"] === "string" &&
+		Object.hasOwn(value, "tool_input") &&
+		Object.hasOwn(value, "tool_response") &&
+		optionalString(value["turn_id"]) &&
+		optionalString(value["cwd"]) &&
+		optionalString(value["model"]) &&
+		optionalString(value["permission_mode"]) &&
+		optionalString(value["tool_use_id"]) &&
+		(value["transcript_path"] === undefined ||
+			value["transcript_path"] === null ||
+			typeof value["transcript_path"] === "string")
+	);
+}
+
+function optionalString(value: unknown): boolean {
+	return value === undefined || typeof value === "string";
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function readAll(stdin: NodeJS.ReadableStream): Promise<string> {
+	return new Promise((resolve, reject) => {
+		let data = "";
+		stdin.setEncoding("utf8");
+		stdin.on("data", (chunk: unknown) => {
+			data += chunk instanceof Buffer ? chunk.toString() : String(chunk);
+		});
+		stdin.once("error", reject);
+		stdin.once("end", () => resolve(data));
+	});
+}

package/packages/omo-codex/plugin/components/teammode/test/thread-title-hook.test.ts

@@ -0,0 +1,116 @@
+import { describe, expect, it } from "vitest";
+
+import { runPostToolUseHook } from "../src/codex-hook.js";
+
+describe("thread title PostToolUse guidance", () => {
+	it("#given codex_app.create_thread completed #when the hook runs #then it asks Codex to immediately set a descriptive title", () => {
+		// given
+		const output = runPostToolUseHook({
+			hook_event_name: "PostToolUse",
+			session_id: "s-team",
+			turn_id: "t-team",
+			transcript_path: null,
+			cwd: "/repo",
+			model: "gpt-5.5",
+			permission_mode: "default",
+			tool_name: "create_thread",
+			tool_use_id: "tool-create-thread",
+			tool_input: {
+				prompt: "Investigate package install failures",
+				target: { type: "project", projectId: "/repo", environment: { type: "local" } },
+			},
+			tool_response: { threadId: "thread-123" },
+		});
+
+		// when
+		const parsed: unknown = JSON.parse(output);
+
+		// then
+		expect(isHookOutput(parsed)).toBe(true);
+		if (!isHookOutput(parsed)) return;
+		expect(parsed.hookSpecificOutput.hookEventName).toBe("PostToolUse");
+		expect(parsed.hookSpecificOutput.additionalContext).toBe(
+			"THREAD ID thread-123: CALL codex_app.set_thread_title NOW. USE THE REAL TASK/ROLE.",
+		);
+	});
+
+	it("#given an unrelated tool completed #when the hook runs #then it stays silent", () => {
+		// given
+		const output = runPostToolUseHook({
+			hook_event_name: "PostToolUse",
+			session_id: "s-team",
+			turn_id: "t-team",
+			transcript_path: null,
+			cwd: "/repo",
+			model: "gpt-5.5",
+			permission_mode: "default",
+			tool_name: "read_thread",
+			tool_use_id: "tool-read-thread",
+			tool_input: { threadId: "thread-123" },
+			tool_response: { status: "ok" },
+		});
+
+		// when
+		const actual = output;
+
+		// then
+		expect(actual).toBe("");
+	});
+
+	it("#given worktree-backed thread creation is pending #when the hook runs #then it tells Codex to title the thread once the thread id exists", () => {
+		// given
+		const output = runPostToolUseHook({
+			hook_event_name: "PostToolUse",
+			session_id: "s-team",
+			turn_id: "t-team",
+			transcript_path: null,
+			cwd: "/repo",
+			model: "gpt-5.5",
+			permission_mode: "default",
+			tool_name: "codex_app.create_thread",
+			tool_use_id: "tool-create-thread",
+			tool_input: {
+				prompt: "Fix CodeGraph provisioned launcher skip on Node 25",
+				target: {
+					type: "project",
+					projectId: "/repo",
+					environment: { type: "worktree", startingState: { type: "working-tree" } },
+				},
+			},
+			tool_response: {
+				pendingWorktreeId: "remote-control:env:test-worktree",
+			},
+		});
+
+		// when
+		const parsed: unknown = JSON.parse(output);
+
+		// then
+		expect(isHookOutput(parsed)).toBe(true);
+		if (!isHookOutput(parsed)) return;
+		expect(parsed.hookSpecificOutput.additionalContext).toBe(
+			"PENDING WORKTREE ID remote-control:env:test-worktree: CALL codex_app.set_thread_title AS SOON AS THREAD ID EXISTS. USE THE REAL TASK/ROLE.",
+		);
+	});
+});
+
+interface HookOutput {
+	readonly hookSpecificOutput: {
+		readonly hookEventName: "PostToolUse";
+		readonly additionalContext: string;
+	};
+}
+
+function isHookOutput(value: unknown): value is HookOutput {
+	if (!isRecord(value)) return false;
+	const hookSpecificOutput = value["hookSpecificOutput"];
+	return (
+		isRecord(hookSpecificOutput) &&
+		hookSpecificOutput["hookEventName"] === "PostToolUse" &&
+		typeof hookSpecificOutput["additionalContext"] === "string"
+	);
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}

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

@@ -0,0 +1,25 @@
+{
+	"compilerOptions": {
+		"target": "ES2022",
+		"module": "Node16",
+		"moduleResolution": "Node16",
+		"lib": ["ES2022"],
+		"strict": true,
+		"exactOptionalPropertyTypes": true,
+		"noUncheckedIndexedAccess": true,
+		"noPropertyAccessFromIndexSignature": true,
+		"verbatimModuleSyntax": true,
+		"noImplicitOverride": true,
+		"noImplicitReturns": true,
+		"noFallthroughCasesInSwitch": true,
+		"noUnusedLocals": true,
+		"noUnusedParameters": true,
+		"esModuleInterop": true,
+		"allowImportingTsExtensions": true,
+		"skipLibCheck": true,
+		"forceConsistentCasingInFileNames": true,
+		"types": ["node", "bun-types"],
+		"noEmit": true
+	},
+	"include": ["src/**/*", "test/**/*"]
+}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-telemetry",
-	"version": "4.12.0",
+	"version": "4.12.1",
 	"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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ultrawork",
-	"version": "4.12.0",
+	"version": "4.12.1",
 	"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-loop/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-ulw-loop",
-	"version": "4.12.0",
+	"version": "4.12.1",
 	"description": "Codex plugin: durable repo-native multi-goal orchestration with embedded success criteria and observable evidence audit.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

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

@@ -0,0 +1,17 @@
+{
+	"hooks": {
+		"PostToolUse": [
+			{
+				"hooks": [
+					{
+						"type": "command",
+						"command": "node \"${PLUGIN_ROOT}/components/codegraph/dist/cli.js\" hook post-tool-use",
+						"timeout": 5,
+						"statusMessage": "(OmO) Checking CodeGraph Init Guidance"
+					}
+				],
+				"matcher": "^(codegraph[._].*|mcp__codegraph__.*)$"
+			}
+		]
+	}
+}

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

@@ -0,0 +1,17 @@
+{
+	"hooks": {
+		"PostToolUse": [
+			{
+				"matcher": "^(create_thread|codex_app\\.create_thread)$",
+				"hooks": [
+					{
+						"type": "command",
+						"command": "node \"${PLUGIN_ROOT}/components/teammode/dist/cli.js\" hook post-tool-use",
+						"timeout": 10,
+						"statusMessage": "(OmO) Checking Thread Title Hygiene"
+					}
+				]
+			}
+		]
+	}
+}

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) Checking Codegraph Bootstrap"
+						"statusMessage": "(OmO) Checking CodeGraph Bootstrap"
 					}
 				]
 			}

package/packages/omo-codex/plugin/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "@sisyphuslabs/omo-codex-plugin",
-	"version": "4.11.1",
+	"version": "4.12.0",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@sisyphuslabs/omo-codex-plugin",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"workspaces": [
 				"components/codegraph",
 				"components/comment-checker",
@@ -15,6 +15,7 @@
 				"components/rules",
 				"components/lsp",
 				"components/telemetry",
+				"components/teammode",
 				"components/start-work-continuation",
 				"components/ulw-loop",
 				"components/ultrawork"
@@ -92,7 +93,7 @@
 		},
 		"components/codegraph": {
 			"name": "@sisyphuslabs/codex-codegraph",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"bin": {
 				"omo-codegraph": "dist/cli.js"
 			},
@@ -108,7 +109,7 @@
 		},
 		"components/comment-checker": {
 			"name": "@code-yeongyu/codex-comment-checker",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"bin": {
 				"omo-comment-checker": "dist/cli.js"
@@ -129,7 +130,7 @@
 		},
 		"components/git-bash": {
 			"name": "@sisyphuslabs/codex-git-bash-hook",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"bin": {
 				"omo-git-bash-hook": "dist/cli.js"
 			},
@@ -144,7 +145,7 @@
 		},
 		"components/lazycodex-executor-verify": {
 			"name": "@code-yeongyu/codex-lazycodex-executor-verify",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"bin": {
 				"lazycodex-executor-verify": "dist/cli.js"
@@ -161,7 +162,7 @@
 		},
 		"components/lsp": {
 			"name": "@code-yeongyu/codex-lsp",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"dependencies": {
 				"@code-yeongyu/lsp-daemon": "file:../../../../lsp-daemon"
@@ -181,7 +182,7 @@
 		},
 		"components/rules": {
 			"name": "@code-yeongyu/codex-rules",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"dependencies": {
 				"picomatch": "^4.0.3"
@@ -203,7 +204,7 @@
 		},
 		"components/start-work-continuation": {
 			"name": "@code-yeongyu/codex-start-work-continuation",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"bin": {
 				"omo-start-work-continuation": "dist/cli.js"
@@ -218,9 +219,22 @@
 				"node": ">=20.0.0"
 			}
 		},
+		"components/teammode": {
+			"name": "@sisyphuslabs/codex-teammode",
+			"version": "4.12.0",
+			"devDependencies": {
+				"@types/node": "^25.9.3",
+				"bun-types": "^1.3.1",
+				"typescript": "^6.0.3",
+				"vitest": "^4.1.8"
+			},
+			"engines": {
+				"node": ">=20.0.0"
+			}
+		},
 		"components/telemetry": {
 			"name": "@code-yeongyu/codex-telemetry",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"bin": {
 				"omo-telemetry": "dist/cli.js"
@@ -238,7 +252,7 @@
 		},
 		"components/ultrawork": {
 			"name": "@code-yeongyu/codex-ultrawork",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"bin": {
 				"omo-ultrawork": "dist/cli.js"
@@ -256,7 +270,7 @@
 		},
 		"components/ulw-loop": {
 			"name": "@code-yeongyu/codex-ulw-loop",
-			"version": "4.11.1",
+			"version": "4.12.0",
 			"license": "MIT",
 			"bin": {
 				"omo-ulw-loop": "dist/cli.js"
@@ -880,6 +894,10 @@
 			"resolved": "components/git-bash",
 			"link": true
 		},
+		"node_modules/@sisyphuslabs/codex-teammode": {
+			"resolved": "components/teammode",
+			"link": true
+		},
 		"node_modules/@standard-schema/spec": {
 			"version": "1.1.0",
 			"resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",

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

@@ -1,6 +1,6 @@
 {
   "name": "@sisyphuslabs/omo-codex-plugin",
-  "version": "4.12.0",
+  "version": "4.12.1",
   "description": "Aggregate Codex plugin root for OMO components.",
   "type": "module",
   "packageManager": "npm@11.12.1",
@@ -13,6 +13,7 @@
     "components/rules",
     "components/lsp",
     "components/telemetry",
+    "components/teammode",
     "components/start-work-continuation",
     "components/ulw-loop",
     "components/ultrawork"

package/packages/omo-codex/plugin/scripts/hook-status-message.mjs

@@ -1,6 +1,7 @@
 const PRODUCT_PREFIX = "(OmO)";
 
 const WORD_OVERRIDES = new Map([
+	["codegraph", "CodeGraph"],
 	["lazycodex", "LazyCodex"],
 	["lsp", "LSP"],
 	["mcp", "MCP"],

package/packages/omo-codex/plugin/skills/ultraresearch/SKILL.md

@@ -49,6 +49,14 @@ The research is done when all of these hold:
 - Every claim in the deliverable cites a source or a verification artifact.
 - The session journal reconstructs what was searched, found, and expanded, wave by wave.
 
+## Run the swarm as a cooperating team
+
+Saturation research is the textbook case for a cooperating team, not isolated fire-and-forget workers: a lead one worker surfaces almost always reshapes what another should search next. So when your harness gives you real cooperating members — Codex: the `teammode` skill (`codex_app` threads); OpenCode: `team_mode` — run this swarm as a team. Fall back to the background-worker swarm below only when team mode is unavailable, or the axes are genuinely independent with no cross-pollination expected.
+
+- **One member per axis — by part, ownership, or perspective, never a job title.** Each Phase 0 axis is one member owning one concrete slice: a codebase part, a source territory, or a question lens. No two members share an angle. "Backend researcher" or "the web person" gives no real boundary and invites overlap — name what the member owns.
+- **The raise law — broadcast every lead the instant it surfaces.** Members over-communicate relentlessly: every new lead, finding, contradiction, and dead end is raised to you the moment it surfaces, never hoarded for a final dump. Through long passes they send `WORKING: <axis> - <phase>`, and `BLOCKED: <reason>` the moment progress stops, so you always know a member is alive. Too many small updates is correct here; going quiet is the only failure.
+- **You lead; expand on each raised lead.** Members raise via message text, never write session files. Journal each lead and spawn its expansion the instant it lands (Phase 2), not only when a member's final reply arrives.
+
 ## Worker ground rules
 
 Research workers (explore, librarian, browsing) differ by harness, but assume:
@@ -104,7 +112,7 @@ Append each digest the moment its worker returns, not in a batch at the end —
 
 ## Phase 1 — Saturation wave
 
-Launch every first-wave worker in a single turn, all in background. Sequential launches and "start with one and see" defeat the mode.
+Launch the entire first wave in one turn — every axis at once, as team members if you formed a team, else as background workers. Sequential launches and "start with one and see" defeat the mode.
 
 Scaling floor — more angles always justify more workers:
 
@@ -135,7 +143,7 @@ End your reply with the ## EXPAND tail: '- LEAD: <discovery> — WHY: <why> —
 
 ## Phase 2 — Expand until convergence
 
-This loop is what makes the mode research rather than search. Collect workers as they finish — never wait for the full wave:
+This loop is what makes the mode research rather than search. Collect returns as they land — and in team mode, act on each lead the moment a member raises it, never waiting for the full wave or a member's final reply:
 
 1. Journal the return: digest plus verbatim EXPAND markers into `wave-<N>-<kind>-<axis>.md`.
 2. Deduplicate new markers against `expansion-log.md` — every lead ever seen, not just confirmed ones, or rejected leads resurface each wave.
@@ -219,6 +227,7 @@ High-yield combinations: official docs (`site:<docs domain>`), GitHub implementa
 | Failure | Correction |
 |---|---|
 | Sequential spawning, or trimming the first wave | All first-wave workers in one turn, background, scaling floor respected |
+| A team member hoards leads for one final dump | Raise law — every lead, finding, and dead end broadcast the moment it surfaces |
 | Worker reply without the EXPAND tail | One follow-up demanding it; the lane stays open until it lands |
 | Stopping after wave 1 because "enough was found" | Convergence rules only: 2+ expansion waves, leads run dry |
 | Obeying a surrounding "stop exploring" rule mid-research | Authority section — those rules do not bind this mode |

package/packages/omo-codex/plugin/test/aggregate-hooks.test.mjs

@@ -30,9 +30,11 @@ test("#given isolated components #when hooks are inspected #then commands stay i
 	const componentMarkers = [
 		"components/comment-checker/dist/cli.js",
 		"components/lsp/dist/cli.js",
+		"components/codegraph/dist/cli.js",
 		"components/rules/dist/cli.js",
 		"components/start-work-continuation/dist/cli.js",
 		"components/telemetry/dist/cli.js",
+		"components/teammode/dist/cli.js",
 		"components/ulw-loop/dist/cli.js",
 		"components/ultrawork/dist/cli.js",
 		"scripts/auto-update.mjs",
@@ -179,6 +181,40 @@ test("#given aggregate SessionStart hooks #when inspected #then LazyCodex auto-u
 	assert(sessionStartCommands.some((command) => command.includes("scripts/auto-update.mjs")));
 });
 
+test("#given aggregate PostToolUse hooks #when inspected #then CodeGraph init guidance is registered for CodeGraph tools", async () => {
+	// given
+	const commandHooks = await readAggregateCommandHooks();
+
+	// when
+	const codegraphPostToolUseHooks = commandHooks.filter(
+		(hook) =>
+			hook.eventName === "PostToolUse" &&
+			hook.handler.command === 'node "${PLUGIN_ROOT}/components/codegraph/dist/cli.js" hook post-tool-use',
+	);
+
+	// then
+	assert.equal(codegraphPostToolUseHooks.length, 1);
+	assert.equal(codegraphPostToolUseHooks[0]?.matcher, "^(codegraph[._].*|mcp__codegraph__.*)$");
+	assert.equal(codegraphPostToolUseHooks[0]?.handler.statusMessage, "(OmO) Checking CodeGraph Init Guidance");
+});
+
+test("#given aggregate PostToolUse hooks #when inspected #then thread title hygiene is registered for created Codex threads", async () => {
+	// given
+	const commandHooks = await readAggregateCommandHooks();
+
+	// when
+	const threadTitleHooks = commandHooks.filter(
+		(hook) =>
+			hook.eventName === "PostToolUse" &&
+			hook.handler.command === 'node "${PLUGIN_ROOT}/components/teammode/dist/cli.js" hook post-tool-use',
+	);
+
+	// then
+	assert.equal(threadTitleHooks.length, 1);
+	assert.equal(threadTitleHooks[0]?.matcher, "^(create_thread|codex_app\\.create_thread)$");
+	assert.equal(threadTitleHooks[0]?.handler.statusMessage, "(OmO) Checking Thread Title Hygiene");
+});
+
 test("#given aggregate plugin packaging #when inspected #then hooks and compatibility sentinels stay Python-free", async () => {
 	// given
 	const hooksText = (await Promise.all((await readAggregateHookManifests()).map(({ source }) => readFile(join(root, source), "utf8")))).join("\n");

package/packages/omo-codex/plugin/test/aggregate-manifest.test.mjs

@@ -17,7 +17,7 @@ test("#given aggregate plugin manifest #when inspected #then it owns the omo nam
 	// then
 	assert.equal(manifest.name, "omo");
 	assert(Array.isArray(hookPaths));
-	assert.equal(hookPaths.length, 19);
+	assert.equal(hookPaths.length, 21);
 	assert(hookPaths.every((hookPath) => typeof hookPath === "string" && hookPath.startsWith("./hooks/")));
 	assert(!hookPaths.includes("./hooks/hooks.json"));
 	assert.equal(skillsPath, "./skills/");
@@ -60,6 +60,7 @@ test("#given component directories #when scanned #then only intentional resource
 		"lsp",
 		"rules",
 		"start-work-continuation",
+		"teammode",
 		"telemetry",
 		"ultrawork",
 		"ulw-loop",

package/packages/omo-codex/plugin/test/aggregate-plugin-fixture.mjs

@@ -68,7 +68,7 @@ export function collectCommandHooks(hooks, source) {
 			}
 			group.hooks.forEach((handler, handlerIndex) => {
 				if (typeof handler !== "object" || handler === null || handler.type !== "command") return;
-				commandHooks.push({ source, eventName, groupIndex, handlerIndex, handler });
+				commandHooks.push({ source, eventName, groupIndex, handlerIndex, matcher: group.matcher, handler });
 			});
 		});
 	}

package/packages/omo-codex/plugin/test/component-bundled-cli.test.mjs

@@ -17,6 +17,7 @@ const HOOK_EVENTS_BY_COMPONENT = {
 	rules: "session-start",
 	"start-work-continuation": "stop",
 	telemetry: "session-start",
+	teammode: "post-tool-use",
 	ultrawork: "user-prompt-submit",
 	"ulw-loop": "pre-tool-use",
 };

package/packages/omo-codex/plugin/test/component-hook-contract-cases.mjs

@@ -138,6 +138,30 @@ export function componentHookContractCases(tempRoot) {
 				assert.equal(stdout, "");
 			},
 		},
+		{
+			name: "teammode post-tool-use create-thread title reminder",
+			component: "teammode",
+			event: "post-tool-use",
+			payload: {
+				hook_event_name: "PostToolUse",
+				session_id: "s-task12",
+				turn_id: "t-task12",
+				transcript_path: null,
+				cwd: tempRoot,
+				model: "gpt-5.5",
+				permission_mode: "default",
+				tool_name: "create_thread",
+				tool_use_id: "tool-task12",
+				tool_input: { prompt: "Investigate flaky release packaging" },
+				tool_response: { threadId: "thread-task12" },
+			},
+			assertOutput(stdout) {
+				const output = JSON.parse(stdout);
+				assert.equal(output.hookSpecificOutput.hookEventName, "PostToolUse");
+				assert.match(output.hookSpecificOutput.additionalContext, /codex_app\.set_thread_title/);
+				assert.match(output.hookSpecificOutput.additionalContext, /thread-task12/);
+			},
+		},
 		{
 			name: "lsp post-compact reset",
 			component: "lsp",