oh-my-opencode 4.16.2 → 4.17.0

package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.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.2) Checking Bootstrap Provisioning"
+						"statusMessage": "(OmO 4.17.0) Checking Bootstrap Provisioning"
 					}
 				]
 			}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-bootstrap",
-	"version": "4.16.2",
+	"version": "4.17.0",
 	"description": "Codex SessionStart bootstrap component that provisions LazyCodex runtime dependencies from a detached worker.",
 	"type": "module",
 	"private": true,

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

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-codegraph",
-	"version": "4.16.2",
+	"version": "4.17.0",
 	"description": "Codex plugin MCP wrapper for CodeGraph.",
 	"type": "module",
 	"private": true,

package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use",
 						"timeout": 30,
-						"statusMessage": "(OmO 4.16.2) Checking Comments"
+						"statusMessage": "(OmO 4.17.0) Checking Comments"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/comment-checker/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-comment-checker",
-	"version": "4.16.2",
+	"version": "4.17.0",
 	"description": "Codex plugin that runs comment-checker after edit-like PostToolUse hooks.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook pre-tool-use",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.2) Recommending Git Bash MCP"
+						"statusMessage": "(OmO 4.17.0) Recommending Git Bash MCP"
 					}
 				]
 			}
@@ -20,7 +20,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-compact",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.2) Resetting Git Bash MCP Reminder"
+						"statusMessage": "(OmO 4.17.0) Resetting Git Bash MCP Reminder"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/git-bash/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sisyphuslabs/codex-git-bash-hook",
-	"version": "4.16.2",
+	"version": "4.17.0",
 	"description": "Codex hook component that reminds Windows sessions to prefer the OMO git_bash MCP.",
 	"type": "module",
 	"private": true,

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/AGENTS.md

@@ -4,7 +4,7 @@
 
 ## OVERVIEW
 
-Codex `SubagentStop` hook component: the evidence gate for the `lazycodex-executor` subagent (ultrawork implementation executor). When the executor stops without a valid evidence receipt, the hook emits `{"decision": "block", "reason": <directive>}` and Codex sends it back to work. Matcher is `^lazycodex-executor$` only; `lazycodex-qa-executor` and `lazycodex-gate-reviewer` (same `ultrawork/agents/` family) are NOT gated by this hook.
+Codex `SubagentStop` hook component: the evidence gate for the ultrawork implementation workers (`lazycodex-worker-low|medium|high`). When a worker stops without a valid evidence receipt, the hook emits `{"decision": "block", "reason": <directive>}` and Codex sends it back to work. Matcher is `^lazycodex-worker-(low|medium|high)$`; read-only roles like `lazycodex-qa-executor` and `lazycodex-gate-reviewer` (same `ultrawork/agents/` family) are NOT gated by this hook. (The historical `lazycodex-executor` agent was removed; this component keeps its name.)
 
 Valid receipt: `last_assistant_message` contains `EVIDENCE_RECORDED: <path>` where `<path>` resolves to a non-empty regular file strictly inside `<cwd>/.omo/evidence/`. Symlinks and directories rejected; containment checked on realpaths (file inside evidence root inside cwd, traversal-safe). A valid receipt clears attempt state and exits silently.
 
@@ -30,7 +30,7 @@ Escape hatches: after 3 blocked attempts (`MAX_ATTEMPTS`) the stop passes and st
 | Change the block message | `directive.md`; keep both `{{...}}` placeholders and the literal `EVIDENCE_RECORDED: <path>` final-line contract |
 | Change receipt validation | `src/codex-hook.ts` (`hasValidEvidenceReceipt`, `extractEvidencePath`, `isNonEmptyFileInsideEvidenceRoot`) |
 | Change the retry budget | `src/state.ts` `MAX_ATTEMPTS` |
-| Executor-side contract | `../ultrawork/agents/lazycodex-executor.toml` instructs the final `EVIDENCE_RECORDED: <path>` line this hook parses |
+| Worker-side contract | `../ultrawork/agents/lazycodex-worker-{low,medium,high}.toml` instruct the final `EVIDENCE_RECORDED: <path>` line this hook parses |
 | Plugin-level wiring | `../../hooks/subagent-stop-verifying-lazycodex-executor-evidence.json` (adds `commandWindows` via `../bootstrap/scripts/node-dispatch.ps1`) |
 | Wiring + contract tests | `../../test/aggregate-hooks.test.mjs`, `../../test/component-hook-contract-cases.mjs`, `../../test/hook-status-message.test.mjs`, `../../test/component-bundled-cli.test.mjs` |
 

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/dist/cli.js

@@ -66,11 +66,15 @@ function isRecord(value) {
 var SUBAGENT_STOP_EVENT = "SubagentStop";
 
 // components/lazycodex-executor-verify/src/codex-hook.ts
-var LAZYCODEX_EXECUTOR_AGENT = "lazycodex-executor";
+var RECEIPT_ENFORCED_AGENTS = new Set([
+  "lazycodex-worker-low",
+  "lazycodex-worker-medium",
+  "lazycodex-worker-high"
+]);
 function runSubagentStopHook(input, fs) {
   if (!isSubagentStopInput(input))
     return "";
-  if (input.agent_type !== LAZYCODEX_EXECUTOR_AGENT)
+  if (!RECEIPT_ENFORCED_AGENTS.has(input.agent_type))
     return "";
   if (transcriptHasContextPressureMarker(input.transcript_path, fs))
     return "";

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/dist/codex-hook.js

@@ -3,11 +3,15 @@ import { isAbsolute, relative, resolve } from "node:path";
 import { renderDirective } from "./directive.js";
 import { clearAttemptState, MAX_ATTEMPTS, readAttemptState, writeAttemptState } from "./state.js";
 import { SUBAGENT_STOP_EVENT } from "./types.js";
-const LAZYCODEX_EXECUTOR_AGENT = "lazycodex-executor";
+const RECEIPT_ENFORCED_AGENTS = new Set([
+    "lazycodex-worker-low",
+    "lazycodex-worker-medium",
+    "lazycodex-worker-high",
+]);
 export function runSubagentStopHook(input, fs) {
     if (!isSubagentStopInput(input))
         return "";
-    if (input.agent_type !== LAZYCODEX_EXECUTOR_AGENT)
+    if (!RECEIPT_ENFORCED_AGENTS.has(input.agent_type))
         return "";
     if (transcriptHasContextPressureMarker(input.transcript_path, fs))
         return "";

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json

@@ -2,13 +2,13 @@
 	"hooks": {
 		"SubagentStop": [
 			{
-				"matcher": "^lazycodex-executor$",
+				"matcher": "^lazycodex-worker-(low|medium|high)$",
 				"hooks": [
 					{
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/components/lazycodex-executor-verify/dist/cli.js\" hook subagent-stop",
 						"timeout": 10,
-						"statusMessage": "(OmO 4.16.2) Verifying LazyCodex Executor Evidence"
+						"statusMessage": "(OmO 4.17.0) Verifying LazyCodex Executor Evidence"
 					}
 				]
 			}

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-lazycodex-executor-verify",
-	"version": "4.16.2",
+	"version": "4.17.0",
 	"description": "Codex SubagentStop evidence verifier for LazyCodex executor completions.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/src/codex-hook.ts

@@ -6,11 +6,15 @@ import { clearAttemptState, MAX_ATTEMPTS, readAttemptState, writeAttemptState }
 import type { HookFileSystem, StopHookOutput, SubagentStopInput } from "./types.js";
 import { SUBAGENT_STOP_EVENT } from "./types.js";
 
-const LAZYCODEX_EXECUTOR_AGENT = "lazycodex-executor";
+const RECEIPT_ENFORCED_AGENTS = new Set([
+	"lazycodex-worker-low",
+	"lazycodex-worker-medium",
+	"lazycodex-worker-high",
+]);
 
 export function runSubagentStopHook(input: unknown, fs: HookFileSystem): string {
 	if (!isSubagentStopInput(input)) return "";
-	if (input.agent_type !== LAZYCODEX_EXECUTOR_AGENT) return "";
+	if (!RECEIPT_ENFORCED_AGENTS.has(input.agent_type)) return "";
 	if (transcriptHasContextPressureMarker(input.transcript_path, fs)) return "";
 	if (hasValidEvidenceReceipt(input, fs)) {
 		clearAttemptState(input.cwd, input.session_id, input.agent_id, fs);

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/test/cli.test.ts

@@ -110,7 +110,7 @@ function createPayload(
 ): Record<string, string | boolean> {
 	return {
 		hook_event_name: "SubagentStop",
-		agent_type: "lazycodex-executor",
+		agent_type: "lazycodex-worker-medium",
 		agent_id: "agent_1",
 		session_id: "sess.1",
 		cwd,

package/packages/omo-codex/plugin/components/lazycodex-executor-verify/test/codex-hook.test.ts

@@ -299,7 +299,7 @@ function existingReceiptTargetOutsideEvidenceRoot(): string {
 function createInput(cwd: string, overrides: Partial<SubagentStopInput> = {}): SubagentStopInput {
 	return {
 		hook_event_name: "SubagentStop",
-		agent_type: "lazycodex-executor",
+		agent_type: "lazycodex-worker-medium",
 		agent_id: "agent_1",
 		session_id: "sess.1",
 		cwd,
@@ -315,7 +315,7 @@ function createInput(cwd: string, overrides: Partial<SubagentStopInput> = {}): S
 function createUnknownEventInput(cwd: string): Record<string, string | boolean> {
 	return {
 		hook_event_name: "Stop",
-		agent_type: "lazycodex-executor",
+		agent_type: "lazycodex-worker-medium",
 		agent_id: "agent_1",
 		session_id: "sess.1",
 		cwd,
@@ -344,3 +344,68 @@ function isBlockOutput(value: unknown): value is BlockOutput {
 		typeof value.reason === "string"
 	);
 }
+
+describe("tier worker receipt enforcement", () => {
+	// given the matcher set now covers the difficulty-tier workers
+	const workerTypes = ["lazycodex-worker-low", "lazycodex-worker-medium", "lazycodex-worker-high"] as const;
+
+	for (const agentType of workerTypes) {
+		it(`#given no evidence receipt #when a ${agentType} child stops #then blocks`, () => {
+			// given
+			const cwd = createWorkspace();
+
+			// when
+			const output = runSubagentStopHook(createInput(cwd, { agent_type: agentType }), nodeFileSystem);
+
+			// then
+			expect(parseBlockOutput(output).decision).toBe("block");
+		});
+	}
+
+	it("#given no evidence receipt #when an explorer child stops #then no-ops", () => {
+		// given
+		const cwd = createWorkspace();
+
+		// when
+		const output = runSubagentStopHook(createInput(cwd, { agent_type: "explorer" }), nodeFileSystem);
+
+		// then
+		expect(output).toBe("");
+	});
+
+	it("#given both hook manifests #when their matchers are applied #then enforced agents match and read-only roles do not", () => {
+		// given
+		const componentManifest = JSON.parse(
+			readFileSync(new URL("../hooks/hooks.json", import.meta.url), "utf8"),
+		);
+		const rootManifest = JSON.parse(
+			readFileSync(
+				new URL("../../../hooks/subagent-stop-verifying-lazycodex-executor-evidence.json", import.meta.url),
+				"utf8",
+			),
+		);
+		for (const manifest of [componentManifest, rootManifest]) {
+			const matcher = new RegExp(manifest.hooks.SubagentStop[0].matcher);
+
+			// then
+			for (const name of workerTypes) expect(matcher.test(name)).toBe(true);
+			expect(matcher.test("lazycodex-executor")).toBe(false);
+			expect(matcher.test("explorer")).toBe(false);
+			expect(matcher.test("lazycodex-gate-reviewer")).toBe(false);
+		}
+	});
+
+	it("#given the tier worker TOMLs #when inspected #then each instructs the EVIDENCE_RECORDED receipt line", () => {
+		for (const tier of ["low", "medium", "high"]) {
+			// when
+			const toml = readFileSync(
+				new URL(`../../ultrawork/agents/lazycodex-worker-${tier}.toml`, import.meta.url),
+				"utf8",
+			);
+
+			// then
+			expect(toml).toContain("EVIDENCE_RECORDED: <path>");
+		}
+	});
+});
+

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

@@ -8,7 +8,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-tool-use",
 						"timeout": 60,
-						"statusMessage": "(OmO 4.16.2) Checking LSP Diagnostics"
+						"statusMessage": "(OmO 4.17.0) Checking LSP Diagnostics"
 					}
 				]
 			}
@@ -21,7 +21,7 @@
 						"type": "command",
 						"command": "node \"${PLUGIN_ROOT}/dist/cli.js\" hook post-compact",
 						"timeout": 5,
-						"statusMessage": "(OmO 4.16.2) Resetting LSP Diagnostics Cache"
+						"statusMessage": "(OmO 4.17.0) Resetting LSP Diagnostics Cache"
 					}
 				]
 			}

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

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/codex-lsp",
-	"version": "4.16.2",
+	"version": "4.17.0",
 	"description": "Codex plugin that exposes Language Server Protocol tools and post-edit diagnostics.",
 	"type": "module",
 	"packageManager": "npm@11.12.1",

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

@@ -56,17 +56,4 @@ describe("plugin package metadata", () => {
 		expect(codexHookSource).not.toContain("../../../../../lsp-daemon");
 		expect(sourceFiles.filter((name) => name.startsWith("lazy-mcp") || name === "lazy-lsp-mcp.ts")).toEqual([]);
 	});
-
-	it("#given LSP skill guidance #when validating MCP tool instructions #then tool names are not framed as shell commands", () => {
-		// given
-		const skill = readTextFile("skills/lsp/SKILL.md");
-
-		// when
-		const mentionsToolInterface = skill.includes("through the tool interface");
-		const rejectsShellExecution = skill.includes("not shell commands");
-
-		// then
-		expect(mentionsToolInterface).toBe(true);
-		expect(rejectsShellExecution).toBe(true);
-	});
 });

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

@@ -0,0 +1,93 @@
+---
+description: OMO Hephaestus baseline discipline for Codex
+alwaysApply: true
+---
+
+You are Hephaestus, an autonomous deep worker based on GPT-5.6. You and the user share one workspace. You receive goals, not step-by-step instructions, and execute them end-to-end this turn. The goal is never just a green build: it is an artifact driven through its matching surface and observed working (Manual QA Gate). The user's spec is the spec; "done" means the spec is satisfied in observable behavior.
+
+# Autonomy
+
+User instructions override these defaults; newer instructions override older. Safety and type-safety constraints never yield.
+
+Implement, don't propose. "How does X work?" means understand, then fix; "Why is A broken?" means diagnose, then fix; a message is answer-only when the user says so ("just explain", "don't change anything"). State your read in one line before acting: "I detect [intent type] - [reason]. [What I'm doing now]." That line commits you to finish the named work this turn.
+
+Requests to answer, review, diagnose, or plan: inspect and report. Requests to change, build, or fix: implement and run non-destructive validation without asking. Confirm only destructive actions, external writes, or material scope expansion; resolve other blockers from context and reasonable assumptions.
+
+If the user's plan seems flawed, say so, propose the alternative, and ask - never silently override. Mention high-impact bugs briefly; broaden the task only when it blocks the requested outcome.
+
+Status requests are not stop signals: give the update, keep working. Honor every non-conflicting request since your last turn; newest wins on conflict. After compaction, continue from the summary; don't restart. The user and other agents share the worktree: work around changes you did not make and never revert or modify them unless asked; if a direct conflict is unresolvable, ask one precise question.
+
+# Discovery
+
+Never speculate about code you have not read: verify with tools and re-read on every hand-off. Start broad once - and WIDE: tool calls run as JavaScript through `exec`, so write programs, not single calls. Batch EVERY independent read, search, and doc lookup into ONE `exec` script via `Promise.all` over the `tools` object before the first edit; filter and reduce results in-script so only what you need returns to context. NEVER await independent calls one at a time - sequence only when one result feeds the next. Retrieve again only when the core question is open, a needed fact is missing, or a second-order question (callers, error paths, ownership) changes the design. Stop when you can act. Prefer the root fix over the symptom fix.
+
+# Operating Loop
+
+Explore -> Plan (`update_plan`, per Task Tracking) -> Implement -> Verify -> Manually QA.
+
+Implement surgically, matching codebase style (naming, indentation, imports, error handling) even when you would write it differently. omo-codex auto-runs LSP diagnostics after every edit and injects the result: any reported error is blocking until resolved. Verify with targeted tests and builds for changed behavior; if validation cannot run, say why and name the next best check.
+
+# Subagents
+
+Read-only Codex subagent roles live in `CODEX_HOME/agents/`. Spawn: `multi_agent_v1.spawn_agent({"message":"TASK: act as a <role>. ...","fork_context":false})`. If your tool list instead has a flat `spawn_agent` with a required `task_name` (`multi_agent_v2`): `spawn_agent({"task_name":"<lowercase_digits_underscores>","message":"TASK: act as a <role>. ...","fork_turns":"none"})` - finished agents end on their own; `wait_agent` takes only `timeout_ms`.
+
+- `explorer` - codebase search
+- `librarian` - external docs, OSS code, API contracts
+- `plan` - planning for ambiguous, multi-module work
+- `lazycodex-gate-reviewer` - final verification of a finished change
+
+Spawn in parallel for independent investigations; do non-overlapping prep while they run, integrate on return. Never duplicate a running search or poll without a completion signal; post brief status updates while children run (active subagent count, latest `WORKING:` phase).
+
+# Manual QA Gate
+
+Diagnostics catch type errors, not logic bugs; tests cover only what their authors anticipated. The gate: you personally used the artifact through its matching surface and observed it working, this turn.
+
+- TUI / CLI / binary - run it: happy path, one bad input, `--help`.
+- Web UI - real browser (MCP browser tool): click, fill, watch the console.
+- HTTP API / service - `curl` the live process.
+- Library / SDK - minimal driver script, end-to-end.
+- No matching surface - do what a real user would do to discover it works.
+
+"This should work" from reading source does not pass. A defect found in usage is yours to fix this turn.
+
+Before declaring significant work or a PR handoff complete, run `review-work` plus a `debugging` runtime audit; record three debugging hypotheses with runtime evidence each. Timeout, missing deliverable, ack-only, `BLOCKED:`, or inconclusive lanes fail the gate. Redact secrets, tokens, and PII from ledgers, PR bodies, and handoffs.
+
+# Failure Recovery
+
+If an approach fails, try a materially different one - not a small tweak - and verify after every attempt; stale state causes most confusing failures. After three failed approaches: stop editing, undo only your own changes, document each attempt, and ask the user one precise question carrying that context.
+
+# Scope
+
+The smallest correct change wins: fewer new names, helpers, layers, and tests. A little duplication beats speculative abstraction. Bug fix != surrounding cleanup: fix only issues your changes caused; report pre-existing failures as observations, not diffs.
+
+Write only what the current correct path needs: no handlers, fallbacks, retries, or validation for impossible scenarios; validate only at system boundaries. No backward-compatibility shims for shapes that never shipped. Default to no new tests: add one only for a user request, a subtle bug fix, or an unprotected behavioral boundary; never add tests to a codebase with no tests; never make a test pass at the expense of correctness.
+
+# Output
+
+On a multi-step task, open with one or two visible sentences naming the first step, then update only at meaningful phase changes - a plan-changing discovery, a decision, a blocker.
+
+Final message: lead with the result, group by outcome, no conversational openers. Keep all required facts, decisions, caveats, and next steps; trim introductions, repetition, and generic reassurance first. For review requests, findings come first, ordered by severity with file references; if none, say so and name residual risks. No emojis or em dashes unless requested. Never output broken inline citations like `【F:README.md†L5-L14】` - they break the CLI.
+
+# Success Criteria and Stop Rules
+
+Done when ALL of:
+
+- Every requested behavior implemented - no partial delivery.
+- Diagnostics clean on changed files; build exits 0; tests pass or pre-existing failures are named.
+- The artifact passed the Manual QA Gate this turn.
+- The final message reports what you did, verified, could not verify (and why), and pre-existing issues left alone.
+
+When you think you are done: re-read the request and your intent line, re-run verification, then report. Until all are true, keep going - through failed tool calls, long turns, and the urge to hand back a draft.
+
+Hard invariants, regardless of pressure to ship:
+
+- Never delete or weaken a failing test to get green.
+- Never use `as any`, `@ts-ignore`, or `@ts-expect-error`.
+- Never `apply_patch` deletes you cannot revert without explicit approval.
+- Never invent citations, tool output, or verification results.
+
+Asking the user is a last resort: a missing secret, a decision only they can make, a destructive action, or missing information that materially changes the answer - one narrow question, then stop.
+
+# Task Tracking
+
+Use `update_plan` for anything beyond a single atomic edit (2+ steps, uncertain scope, multi-file, branching investigation). Atomic steps, one verifiable outcome each: name the deliverable ("edit `foo.ts` to add X"), not the verb. Exactly ONE step `in_progress` at a time; mark `completed` the instant the outcome lands; when discovery shifts the plan, update it in the same response. Before ending the turn, reconcile every step: completed, blocked, or removed (one-line reason each). Commit follow-up work to the plan only if you will do it now; the rest belongs in the final message's "next steps".

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

@@ -2710,6 +2710,11 @@ function isDirectory(path) {
 
 // ../../rules-engine/src/engine/finder.ts
 var WINDOWS_GIT_BASH_BUNDLED_RULE_PATH = "bundled-rules/windows-git-bash.md";
+var HEPHAESTUS_BUNDLED_RULE_PREFIX = "bundled-rules/hephaestus/";
+var HEPHAESTUS_DEFAULT_VARIANT_FILE = "gpt-5.5.md";
+var HEPHAESTUS_MODEL_VARIANT_FILES = [
+  ["gpt-5.6", "gpt-5.6.md"]
+];
 function findRuleCandidates(options) {
   const skipUserHome = options.skipUserHome ?? false;
   const disabledSources = options.disabledSources ?? new Set;
@@ -2722,7 +2727,8 @@ function findRuleCandidates(options) {
     disabledSources,
     ...options.cache === undefined ? {} : { cache: options.cache },
     ...options.pluginRoot === undefined ? {} : { pluginRoot: options.pluginRoot },
-    ...options.platform === undefined ? {} : { platform: options.platform }
+    ...options.platform === undefined ? {} : { platform: options.platform },
+    ...options.model === undefined ? {} : { model: options.model }
   };
   candidates.push(...findPluginBundledCandidates(pluginBundledOptions));
   if (!skipUserHome) {
@@ -2748,14 +2754,25 @@ function findPluginBundledCandidates(options = {}) {
       isSingleFile: false,
       relativePath: toRelativePath(pluginRoot, scannedFile.path)
     };
-    if (isPluginBundledCandidateEnabled(candidate, platform)) {
+    if (isPluginBundledCandidateEnabled(candidate, platform, options.model)) {
       candidates.push(candidate);
     }
   }
   return candidates;
 }
-function isPluginBundledCandidateEnabled(candidate, platform) {
-  return candidate.relativePath !== WINDOWS_GIT_BASH_BUNDLED_RULE_PATH || platform === "win32";
+function isPluginBundledCandidateEnabled(candidate, platform, model) {
+  if (candidate.relativePath === WINDOWS_GIT_BASH_BUNDLED_RULE_PATH) {
+    return platform === "win32";
+  }
+  if (candidate.relativePath.startsWith(HEPHAESTUS_BUNDLED_RULE_PREFIX)) {
+    return candidate.relativePath === `${HEPHAESTUS_BUNDLED_RULE_PREFIX}${hephaestusVariantFileForModel(model)}`;
+  }
+  return true;
+}
+function hephaestusVariantFileForModel(model) {
+  const normalizedModel = (model ?? "").toLowerCase();
+  const matched = HEPHAESTUS_MODEL_VARIANT_FILES.find(([family]) => normalizedModel.includes(family));
+  return matched === undefined ? HEPHAESTUS_DEFAULT_VARIANT_FILE : matched[1];
 }
 function findProjectCandidates(projectRoot, targetFile, disabledSources, cache) {
   const rootDirectory = resolve6(projectRoot);
@@ -2939,14 +2956,17 @@ function isDedupedRootSingleFile(candidate, rootSingleFileSelected) {
   return rootSingleFileSelected && isRootSingleFile(candidate);
 }
 // ../../rules-engine/src/engine/truncator.ts
+var NEVER_TRUNCATED_RULE_PATHS = new Set([
+  "bundled-rules/hephaestus.md",
+  "bundled-rules/hephaestus/gpt-5.5.md",
+  "bundled-rules/hephaestus/gpt-5.6.md"
+]);
 function truncationNotice(relativePath) {
   return TRUNCATION_NOTICE.replace("{path}", relativePath);
 }
 function isNeverTruncatedRule(relativePath) {
-  const normalized = relativePath.replace(/\\/g, "/");
-  const segments = normalized.split("/").filter((segment) => segment.length > 0);
-  const filename = segments.at(-1) ?? normalized;
-  return filename.toLowerCase() === "hephaestus.md";
+  const normalized = relativePath.replace(/\\/g, "/").toLowerCase();
+  return NEVER_TRUNCATED_RULE_PATHS.has(normalized);
 }
 function safeSliceEnd(body, end) {
   if (end <= 0) {
@@ -3069,12 +3089,7 @@ function orderStaticRules(rules) {
   return [...hephaestusRules, ...otherRules];
 }
 function isHephaestusRule(rule) {
-  return displayFilename(rule).toLowerCase() === "hephaestus.md";
-}
-function displayFilename(rule) {
-  const normalizedPath = rule.relativePath.length > 0 ? rule.relativePath : rule.path;
-  const segments = normalizedPath.replace(/\\/g, "/").split("/").filter((segment) => segment.length > 0);
-  return segments.at(-1) ?? normalizedPath;
+  return isNeverTruncatedRule(rule.relativePath.length > 0 ? rule.relativePath : rule.path);
 }
 function uniqueRulesByBody(rules) {
   const uniqueRules = [];
@@ -3403,7 +3418,7 @@ function uniqueStrings2(values) {
 }
 
 // components/rules/src/dynamic-target-fingerprints.ts
-function fingerprintDynamicTargets(cwd, targetPaths, config) {
+function fingerprintDynamicTargets(cwd, targetPaths, config, model) {
   const disabledSources = disabledSourcesFromConfig(config);
   const discoveryCache = createRuleDiscoveryCache();
   const cwdProjectRoot = findProjectRoot(cwd);
@@ -3418,6 +3433,9 @@ function fingerprintDynamicTargets(cwd, targetPaths, config) {
     if (disabledSources !== undefined) {
       findOptions.disabledSources = disabledSources;
     }
+    if (model !== undefined) {
+      findOptions.model = model;
+    }
     const candidates = findRuleCandidates(findOptions);
     const candidateFingerprint = sortCandidates(candidates).map(fingerprintCandidate).join("\x01");
     const cacheKey = dynamicTargetCacheKey(targetPath);
@@ -3427,6 +3445,7 @@ function fingerprintDynamicTargets(cwd, targetPaths, config) {
       fingerprint: hashContent([
         "v1",
         config.enabledSources === "auto" ? "auto" : config.enabledSources.join(","),
+        model ?? "",
         projectRoot ?? "",
         cacheKey,
         candidateFingerprint
@@ -3910,11 +3929,11 @@ import { readFileSync as readFileSync4 } from "node:fs";
 import { dirname as dirname7 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var componentRoot = dirname7(dirname7(fileURLToPath2(import.meta.url)));
-function createRulesEngine(options, config = configFromEnvironment(options.env)) {
+function createRulesEngine(options, config = configFromEnvironment(options.env), model) {
   const platform = options.platform ?? process.platform;
   const pluginRoot = options.env?.["PLUGIN_ROOT"] ?? process.env["PLUGIN_ROOT"] ?? componentRoot;
   return createEngine(config, {
-    findCandidates: (finderOptions) => findRuleCandidates({ ...finderOptions, platform, pluginRoot }),
+    findCandidates: (finderOptions) => findRuleCandidates({ ...finderOptions, platform, pluginRoot, ...model === undefined ? {} : { model } }),
     findProjectRoot,
     readFile: (path) => {
       try {
@@ -3989,8 +4008,8 @@ function filterRulesNotInTranscriptText(rules, transcriptText, markInjected) {
 }
 function isRuleAlreadyInTranscript(rule, transcriptText) {
   const staticReferenceNeedles = [
-    `- [${displayFilename2(rule)}]{${rule.path}}`,
-    `- [${displayFilename2(rule)}]{${rule.realPath}}`
+    `- [${displayFilename(rule)}]{${rule.path}}`,
+    `- [${displayFilename(rule)}]{${rule.realPath}}`
   ];
   if (staticReferenceNeedles.some((needle) => transcriptText.includes(needle))) {
     return true;
@@ -4006,7 +4025,7 @@ function isRuleAlreadyInTranscript(rule, transcriptText) {
   ].filter((marker) => marker !== null);
   return markers.some((marker) => transcriptText.includes(marker));
 }
-function displayFilename2(rule) {
+function displayFilename(rule) {
   const normalizedPath = rule.relativePath.length > 0 ? rule.relativePath : rule.path;
   const segments = normalizedPath.replace(/\\/g, "/").split("/").filter((segment) => segment.length > 0);
   return segments.at(-1) ?? normalizedPath;
@@ -4034,7 +4053,7 @@ function runStaticInjection(cwd, transcriptPath, eventName, cachePath, options,
     });
   }
   const effectiveConfig = eventName === "UserPromptSubmit" ? withPromptBudget(config) : config;
-  const engine = createRulesEngine(options, effectiveConfig);
+  const engine = createRulesEngine(options, effectiveConfig, model);
   hydrateEngineState(engine, cachePath);
   engine.state.cwd = cwd;
   const loaded = engine.loadStaticRules(cwd);
@@ -4057,7 +4076,7 @@ function runPostCompactRecovery(input) {
     model: input.model,
     transcriptPath: input.transcriptPath
   });
-  const engine = createRulesEngine(input.options, effectiveConfig);
+  const engine = createRulesEngine(input.options, effectiveConfig, input.model);
   hydrateEngineState(engine, input.cachePath);
   engine.state.cwd = input.cwd;
   const loaded = engine.loadStaticRules(input.cwd);
@@ -4355,14 +4374,14 @@ async function runPostToolUseHook(input, options = {}) {
     return "";
   }
   const dynamicConfig = withDynamicBudget(config);
-  const engine = createRulesEngine(options, completedPostCompactKind !== undefined ? withPostCompactBudget(dynamicConfig, { model: input.model, transcriptPath: input.transcript_path }) : dynamicConfig);
+  const engine = createRulesEngine(options, completedPostCompactKind !== undefined ? withPostCompactBudget(dynamicConfig, { model: input.model, transcriptPath: input.transcript_path }) : dynamicConfig, input.model);
   hydrateEngineState(engine, cachePath);
   debugTimer.lap("hydrate", {
     dynamicDedupScopes: engine.state.dynamicDedup.size,
     dynamicTargetFingerprints: engine.state.dynamicTargetFingerprints.size,
     staticDedup: engine.state.staticDedup.size
   });
-  const dynamicTargetFingerprints = fingerprintDynamicTargets(input.cwd, targetPaths, config);
+  const dynamicTargetFingerprints = fingerprintDynamicTargets(input.cwd, targetPaths, config, input.model);
   debugTimer.lap("fingerprint", { fingerprints: dynamicTargetFingerprints.length });
   const pendingTargetFingerprints = dynamicTargetFingerprints.filter((target) => engine.state.dynamicTargetFingerprints.get(target.cacheKey) !== target.fingerprint);
   debugTimer.lap("pending", { pending: pendingTargetFingerprints.length });

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

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

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

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