oh-my-openagent 4.7.2 → 4.7.4

package/dist/cli/index.js

@@ -61669,7 +61669,7 @@ var {
 // package.json
 var package_default = {
   name: "oh-my-openagent",
-  version: "4.7.2",
+  version: "4.7.4",
   description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   main: "./dist/index.js",
   types: "dist/index.d.ts",
@@ -61804,17 +61804,17 @@ var package_default = {
     zod: "^4.4.3"
   },
   optionalDependencies: {
-    "oh-my-openagent-darwin-arm64": "4.7.2",
-    "oh-my-openagent-darwin-x64": "4.7.2",
-    "oh-my-openagent-darwin-x64-baseline": "4.7.2",
-    "oh-my-openagent-linux-arm64": "4.7.2",
-    "oh-my-openagent-linux-arm64-musl": "4.7.2",
-    "oh-my-openagent-linux-x64": "4.7.2",
-    "oh-my-openagent-linux-x64-baseline": "4.7.2",
-    "oh-my-openagent-linux-x64-musl": "4.7.2",
-    "oh-my-openagent-linux-x64-musl-baseline": "4.7.2",
-    "oh-my-openagent-windows-x64": "4.7.2",
-    "oh-my-openagent-windows-x64-baseline": "4.7.2"
+    "oh-my-openagent-darwin-arm64": "4.7.4",
+    "oh-my-openagent-darwin-x64": "4.7.4",
+    "oh-my-openagent-darwin-x64-baseline": "4.7.4",
+    "oh-my-openagent-linux-arm64": "4.7.4",
+    "oh-my-openagent-linux-arm64-musl": "4.7.4",
+    "oh-my-openagent-linux-x64": "4.7.4",
+    "oh-my-openagent-linux-x64-baseline": "4.7.4",
+    "oh-my-openagent-linux-x64-musl": "4.7.4",
+    "oh-my-openagent-linux-x64-musl-baseline": "4.7.4",
+    "oh-my-openagent-windows-x64": "4.7.4",
+    "oh-my-openagent-windows-x64-baseline": "4.7.4"
   },
   overrides: {
     hono: "^4.12.18",
@@ -62940,6 +62940,8 @@ async function updateCodexConfig(input) {
   config = removeStaleManagedAgentBlocks(config, new Set((input.agentConfigs ?? []).map((agentConfig) => agentConfig.name)));
   config = ensureFeatureEnabled2(config, "plugins");
   config = ensureFeatureEnabled2(config, "plugin_hooks");
+  config = ensureFeatureEnabled2(config, "multi_agent");
+  config = ensureFeatureEnabled2(config, "child_agents_md");
   config = ensureCodexReasoningConfig(config, await readCodexModelCatalog(input.repoRoot));
   config = ensureCodexMultiAgentV2Config(config);
   if (input.autonomousPermissions === true)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-openagent",
-  "version": "4.7.2",
+  "version": "4.7.4",
   "description": "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   "main": "./dist/index.js",
   "types": "dist/index.d.ts",
@@ -135,17 +135,17 @@
     "zod": "^4.4.3"
   },
   "optionalDependencies": {
-    "oh-my-openagent-darwin-arm64": "4.7.2",
-    "oh-my-openagent-darwin-x64": "4.7.2",
-    "oh-my-openagent-darwin-x64-baseline": "4.7.2",
-    "oh-my-openagent-linux-arm64": "4.7.2",
-    "oh-my-openagent-linux-arm64-musl": "4.7.2",
-    "oh-my-openagent-linux-x64": "4.7.2",
-    "oh-my-openagent-linux-x64-baseline": "4.7.2",
-    "oh-my-openagent-linux-x64-musl": "4.7.2",
-    "oh-my-openagent-linux-x64-musl-baseline": "4.7.2",
-    "oh-my-openagent-windows-x64": "4.7.2",
-    "oh-my-openagent-windows-x64-baseline": "4.7.2"
+    "oh-my-openagent-darwin-arm64": "4.7.4",
+    "oh-my-openagent-darwin-x64": "4.7.4",
+    "oh-my-openagent-darwin-x64-baseline": "4.7.4",
+    "oh-my-openagent-linux-arm64": "4.7.4",
+    "oh-my-openagent-linux-arm64-musl": "4.7.4",
+    "oh-my-openagent-linux-x64": "4.7.4",
+    "oh-my-openagent-linux-x64-baseline": "4.7.4",
+    "oh-my-openagent-linux-x64-musl": "4.7.4",
+    "oh-my-openagent-linux-x64-musl-baseline": "4.7.4",
+    "oh-my-openagent-windows-x64": "4.7.4",
+    "oh-my-openagent-windows-x64-baseline": "4.7.4"
   },
   "overrides": {
     "hono": "^4.12.18",

package/packages/omo-codex/plugin/components/rules/README.md

@@ -17,8 +17,6 @@ The runtime has no npm production dependencies, so a clean Codex marketplace cop
 
 Project-level sources:
 
-- `AGENTS.md`
-- `CLAUDE.md`
 - `CONTEXT.md`
 - `.omo/rules/**/*.md`
 - `.claude/rules/**/*.md`
@@ -26,7 +24,7 @@ Project-level sources:
 - `.github/instructions/**/*.md`
 - `.github/copilot-instructions.md`
 
-User-home sources are also supported by the ported engine when available.
+User-home sources are also supported by the ported engine when available. `AGENTS.md` is not part of `auto` source selection because Codex already loads it as native project instructions, so re-injecting it through hooks duplicates context; opt into it explicitly with `CODEX_RULES_ENABLED_SOURCES` if you need hook-level migration behavior. Claude user-home sources (`~/.claude/rules`, `~/.claude/CLAUDE.md`) are also excluded from `auto` because they usually contain Claude Code runtime instructions rather than Codex rules; opt into them explicitly when you want that migration behavior.
 
 Markdown rule files may use frontmatter such as:
 
@@ -58,6 +56,8 @@ It also enables:
 [features]
 plugins = true
 plugin_hooks = true
+multi_agent = true
+child_agents_md = true
 
 [plugins."omo@sisyphuslabs"]
 enabled = true
@@ -73,7 +73,7 @@ Use `CODEX_RULES_*` environment variables:
 | `CODEX_RULES_MODE` | `both`, `static`, `dynamic`, `off` | `both` |
 | `CODEX_RULES_MAX_RULE_CHARS` | positive integer | `12000` |
 | `CODEX_RULES_MAX_RESULT_CHARS` | positive integer | `40000` |
-| `CODEX_RULES_ENABLED_SOURCES` | comma-separated source names | `auto` |
+| `CODEX_RULES_ENABLED_SOURCES` | comma-separated source names or `auto` | `auto` (excludes `AGENTS.md`, `~/.claude/rules`, `~/.claude/CLAUDE.md`) |
 
 For migration from `pi-rules`, equivalent `PI_RULES_*` variables are accepted as fallbacks.
 

package/packages/omo-codex/plugin/components/rules/skills/rules/SKILL.md

@@ -14,10 +14,8 @@ Dynamic `PostToolUse` output is injected as additional context and is deduplicat
 
 Supported project sources:
 
-- `AGENTS.md`
-- `CLAUDE.md`
 - `CONTEXT.md`
-- `.sisyphus/rules/**/*.md`
+- `.omo/rules/**/*.md`
 - `.claude/rules/**/*.md`
 - `.cursor/rules/**/*.md`
 - `.github/instructions/**/*.md`
@@ -29,6 +27,6 @@ Supported environment knobs:
 - `CODEX_RULES_MODE=both|static|dynamic|off`
 - `CODEX_RULES_MAX_RULE_CHARS=<number>`
 - `CODEX_RULES_MAX_RESULT_CHARS=<number>`
-- `CODEX_RULES_ENABLED_SOURCES=AGENTS.md,.sisyphus/rules`
+- `CODEX_RULES_ENABLED_SOURCES=CONTEXT.md,.omo/rules`
 
 The legacy `PI_RULES_*` variables are accepted as fallbacks for users migrating from `pi-rules`.

package/packages/omo-codex/plugin/components/rules/src/config.ts

@@ -77,7 +77,7 @@ function parseEnabledSources(value: string | undefined, disableBundledRules: boo
 		sources.push(source);
 	}
 	const enabledSources = disableBundledRules ? sources.filter((source) => source !== "plugin-bundled") : sources;
-	return enabledSources.length > 0 || sources.length > 0 ? enabledSources : "auto";
+	return enabledSources;
 }
 
 function sourcesWithoutBundledRules(): RuleSource[] {
@@ -91,15 +91,11 @@ function toRuleSource(value: string): RuleSource | null {
 		case ".cursor/rules":
 		case ".github/instructions":
 		case ".github/copilot-instructions.md":
-		case "AGENTS.md":
-		case "CLAUDE.md":
 		case "CONTEXT.md":
 		case "plugin-bundled":
 		case "~/.omo/rules":
 		case "~/.opencode/rules":
 		case "~/.claude/rules":
-		case "~/.config/opencode/AGENTS.md":
-		case "~/.claude/CLAUDE.md":
 			return value;
 		default:
 			return null;

package/packages/omo-codex/plugin/components/rules/src/dynamic-target-fingerprints.ts

@@ -1,11 +1,11 @@
 import { statSync } from "node:fs";
 import { resolve } from "node:path";
 import { isSameOrChildPath, toPosixPath, uniqueStrings } from "./path-utils.js";
-import { SOURCE_PRIORITY } from "./rules/constants.js";
 import { createRuleDiscoveryCache, findRuleCandidates } from "./rules/finder.js";
 import { hashContent } from "./rules/matcher.js";
 import { sortCandidates } from "./rules/ordering.js";
 import { findProjectRoot } from "./rules/project-root.js";
+import { disabledSourcesFromConfig } from "./rules/sources.js";
 import type { PiRulesConfig, RuleCandidate } from "./rules/types.js";
 
 export interface DynamicTargetFingerprint {
@@ -19,7 +19,7 @@ export function fingerprintDynamicTargets(
 	targetPaths: ReadonlyArray<string>,
 	config: PiRulesConfig,
 ): DynamicTargetFingerprint[] {
-	const disabledSources = disabledSourcesFor(config);
+	const disabledSources = disabledSourcesFromConfig(config);
 	const discoveryCache = createRuleDiscoveryCache();
 	const cwdProjectRoot = findProjectRoot(cwd);
 	const fingerprints: DynamicTargetFingerprint[] = [];
@@ -84,15 +84,6 @@ function fileFingerprint(filePath: string): string {
 	}
 }
 
-function disabledSourcesFor(config: PiRulesConfig): ReadonlySet<string> | undefined {
-	if (config.enabledSources === "auto") {
-		return undefined;
-	}
-
-	const enabledSources = new Set(config.enabledSources);
-	return new Set([...SOURCE_PRIORITY.keys()].filter((source) => !enabledSources.has(source)));
-}
-
 function dynamicTargetCacheKey(targetPath: string): string {
 	return toPosixPath(resolve(targetPath));
 }

package/packages/omo-codex/plugin/components/rules/src/rules/constants.ts

@@ -30,8 +30,6 @@ export const PROJECT_RULE_SUBDIRS: ReadonlyArray<readonly [string, string]> = [
  */
 export const PROJECT_SINGLE_FILES: readonly string[] = [
 	".github/copilot-instructions.md",
-	"AGENTS.md",
-	"CLAUDE.md",
 	"CONTEXT.md",
 ];
 
@@ -43,7 +41,7 @@ export const USER_HOME_RULE_SUBDIRS: readonly string[] = [".omo/rules", ".openco
 /**
  * User-home single-file rules. The first one to exist wins per "first-match" semantics.
  */
-export const USER_HOME_SINGLE_FILES: readonly string[] = [".config/opencode/AGENTS.md", ".claude/CLAUDE.md"];
+export const USER_HOME_SINGLE_FILES: readonly string[] = [];
 
 /**
  * Bundled plugin rule directory relative to the rules component root.
@@ -64,14 +62,10 @@ export const SOURCE_PRIORITY: ReadonlyMap<RuleSource, number> = new Map([
 	[".cursor/rules", 2],
 	[".github/instructions", 3],
 	[".github/copilot-instructions.md", 4],
-	["AGENTS.md", 5],
-	["CLAUDE.md", 6],
 	["CONTEXT.md", 7],
 	["~/.omo/rules", 100],
 	["~/.opencode/rules", 101],
 	["~/.claude/rules", 102],
-	["~/.config/opencode/AGENTS.md", 103],
-	["~/.claude/CLAUDE.md", 104],
 	["plugin-bundled", 200],
 ]);
 

package/packages/omo-codex/plugin/components/rules/src/rules/engine.ts

@@ -15,13 +15,13 @@ import {
 	DEFAULT_POST_COMPACT_MAX_RESULT_CHARS,
 	DEFAULT_POST_COMPACT_MAX_RULE_CHARS,
 	PROJECT_SINGLE_FILES,
-	SOURCE_PRIORITY,
 } from "./constants.js";
 import { createRuleDiscoveryCache, type RuleDiscoveryCache } from "./finder.js";
 import { formatDynamicBlock, formatStaticBlock } from "./formatter.js";
 import { hashContent, matchRule } from "./matcher.js";
 import { sortCandidates } from "./ordering.js";
 import { parseRule } from "./parser.js";
+import { disabledSourcesFromConfig } from "./sources.js";
 import type { LoadedRule, MatchReason, PiRulesConfig, RuleCandidate, RuleDiagnostic, SessionState } from "./types.js";
 
 interface LoadedRuleContent {
@@ -97,7 +97,7 @@ export function createEngine(config: PiRulesConfig, deps: EngineDeps): Engine {
 			projectRoot,
 			targetFile: null,
 		};
-		const disabledSources = disabledSourcesFor(config);
+		const disabledSources = disabledSourcesFromConfig(config);
 		if (disabledSources !== undefined) {
 			findOptions.disabledSources = disabledSources;
 		}
@@ -121,7 +121,7 @@ export function createEngine(config: PiRulesConfig, deps: EngineDeps): Engine {
 		const seenRules = new Set<string>();
 		const loadedRuleContent = new Map<string, LoadedRuleContent | null>();
 		const projectMembership = new Map<string, boolean>();
-		const disabledSources = disabledSourcesFor(config);
+		const disabledSources = disabledSourcesFromConfig(config);
 		const discoveryCache = createRuleDiscoveryCache();
 		const candidateDiscoveryCache: CandidateDiscoveryCache = new Map();
 		const cwdProjectRoot = deps.findProjectRoot(cwd);
@@ -442,15 +442,6 @@ function staticMatchReason(rule: LoadedRule): MatchReason | null {
 	return null;
 }
 
-function disabledSourcesFor(config: PiRulesConfig): ReadonlySet<string> | undefined {
-	if (config.enabledSources === "auto") {
-		return undefined;
-	}
-
-	const enabledSources = new Set(config.enabledSources);
-	return new Set([...SOURCE_PRIORITY.keys()].filter((source) => !enabledSources.has(source)));
-}
-
 function isDedupedRootSingleFile(candidate: RuleCandidate, rootSingleFileSelected: boolean): boolean {
 	return rootSingleFileSelected && isRootSingleFile(candidate);
 }

package/packages/omo-codex/plugin/components/rules/src/rules/finder-sources.ts

@@ -17,8 +17,6 @@ export function toProjectRuleSource(parentDirectory: string, subDirectory: strin
 export function toProjectSingleFileSource(ruleFile: string): RuleSource {
 	switch (ruleFile) {
 		case ".github/copilot-instructions.md":
-		case "AGENTS.md":
-		case "CLAUDE.md":
 		case "CONTEXT.md":
 			return ruleFile;
 		default:
@@ -41,9 +39,6 @@ export function toUserHomeRuleSource(ruleSubdir: string): RuleSource {
 export function toUserHomeSingleFileSource(ruleFile: string): RuleSource {
 	const source = `~/${ruleFile}`;
 	switch (source) {
-		case "~/.config/opencode/AGENTS.md":
-		case "~/.claude/CLAUDE.md":
-			return source;
 		default:
 			throw new UnsupportedRuleSourceError(`Unsupported user-home single-file source: ${source}`);
 	}

package/packages/omo-codex/plugin/components/rules/src/rules/sources.ts

@@ -0,0 +1,13 @@
+import { SOURCE_PRIORITY } from "./constants.js";
+import type { PiRulesConfig } from "./types.js";
+
+export const DEFAULT_AUTO_DISABLED_SOURCES: readonly string[] = ["AGENTS.md", "~/.claude/rules", "~/.claude/CLAUDE.md"];
+
+export function disabledSourcesFromConfig(config: PiRulesConfig): ReadonlySet<string> | undefined {
+	if (config.enabledSources === "auto") {
+		return new Set(DEFAULT_AUTO_DISABLED_SOURCES);
+	}
+
+	const enabledSources = new Set(config.enabledSources);
+	return new Set([...SOURCE_PRIORITY.keys()].filter((source) => !enabledSources.has(source)));
+}

package/packages/omo-codex/plugin/components/rules/src/rules/types.ts

@@ -51,7 +51,7 @@ export interface RuleCandidate {
 	distance: number;
 	isGlobal: boolean;
 	/**
-	 * True when this candidate is a SINGLE-FILE rule like AGENTS.md or
+	 * True when this candidate is a SINGLE-FILE rule like
 	 * `.github/copilot-instructions.md` (frontmatter optional, applies always).
 	 */
 	isSingleFile: boolean;
@@ -81,15 +81,11 @@ export type RuleSource =
 	| ".cursor/rules"
 	| ".github/instructions"
 	| ".github/copilot-instructions.md"
-	| "AGENTS.md"
-	| "CLAUDE.md"
 	| "CONTEXT.md"
 	| "plugin-bundled"
 	| "~/.omo/rules"
 	| "~/.opencode/rules"
-	| "~/.claude/rules"
-	| "~/.config/opencode/AGENTS.md"
-	| "~/.claude/CLAUDE.md";
+	| "~/.claude/rules";
 
 /**
  * Why a candidate matched the target file. Surfaced in the injection block so

package/packages/omo-codex/plugin/components/rules/test/agent-doc-sources.test.ts

@@ -0,0 +1,119 @@
+import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+
+import {
+	type CodexPostToolUseInput,
+	type CodexSessionStartInput,
+	runPostToolUseHook,
+	runSessionStartHook,
+} from "../src/codex-hook.js";
+
+const REMOVED_AGENT_DOC_SOURCE_LISTS = ["AGENTS.md", "CLAUDE.md", "AGENTS.md,CLAUDE.md"] as const;
+
+const tempDirectories: string[] = [];
+
+type AgentDocProject = {
+	readonly pluginData: string;
+	readonly root: string;
+	readonly nestedSourceFile: string;
+};
+
+afterEach(() => {
+	for (const directory of tempDirectories.splice(0)) {
+		rmSync(directory, { recursive: true, force: true });
+	}
+});
+
+function makeAgentDocProject(): AgentDocProject {
+	const root = mkdtempSync(path.join(tmpdir(), "codex-rules-agent-docs-"));
+	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-agent-docs-data-"));
+	tempDirectories.push(root, pluginData);
+
+	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
+	writeFileSync(path.join(root, "AGENTS.md"), "Root AGENTS.md must remain Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Root CLAUDE.md must stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), "Context source must not leak through removed-only allowlists.");
+
+	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
+	writeFileSync(
+		path.join(root, ".omo", "rules", "typescript.md"),
+		[
+			"---",
+			"description: TypeScript",
+			'globs: ["**/*.ts"]',
+			"---",
+			"",
+			"Dynamic .omo/rules context must not leak through removed-only allowlists.",
+		].join("\n"),
+	);
+
+	const nestedDirectory = path.join(root, "child", "src");
+	mkdirSync(nestedDirectory, { recursive: true });
+	writeFileSync(path.join(root, "child", "AGENTS.md"), "Child AGENTS.md must remain Codex-native.");
+	const nestedSourceFile = path.join(nestedDirectory, "app.ts");
+	writeFileSync(nestedSourceFile, "export const app = true;\n");
+
+	return { root, pluginData, nestedSourceFile };
+}
+
+function sessionStartInput(root: string): CodexSessionStartInput {
+	return {
+		session_id: "session-1",
+		transcript_path: null,
+		cwd: root,
+		hook_event_name: "SessionStart",
+		model: "gpt-5.5",
+		permission_mode: "default",
+		source: "startup",
+	};
+}
+
+function postToolUseInput(root: string, filePath: string): CodexPostToolUseInput {
+	return {
+		session_id: "session-1",
+		turn_id: "turn-1",
+		transcript_path: null,
+		cwd: root,
+		hook_event_name: "PostToolUse",
+		model: "gpt-5.5",
+		permission_mode: "default",
+		tool_name: "mcp__filesystem__read_file",
+		tool_input: { path: filePath },
+		tool_response: { text: "file contents" },
+		tool_use_id: "call-1",
+	};
+}
+
+describe("agent doc sources", () => {
+	for (const sourceList of REMOVED_AGENT_DOC_SOURCE_LISTS) {
+		it(`#given ${sourceList} removed-only source allowlist #when SessionStart runs #then it emits no OMO rules context`, async () => {
+			// given
+			const { root, pluginData } = makeAgentDocProject();
+
+			// when
+			const output = await runSessionStartHook(sessionStartInput(root), {
+				pluginDataRoot: pluginData,
+				env: { CODEX_RULES_ENABLED_SOURCES: sourceList },
+			});
+
+			// then
+			expect(output).toBe("");
+		});
+	}
+
+	it("#given nested AGENTS.md and removed-only source allowlist #when PostToolUse targets a child file #then it emits no dynamic OMO rules context", async () => {
+		// given
+		const { root, pluginData, nestedSourceFile } = makeAgentDocProject();
+
+		// when
+		const output = await runPostToolUseHook(postToolUseInput(root, nestedSourceFile), {
+			pluginDataRoot: pluginData,
+			env: { CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,CLAUDE.md" },
+		});
+
+		// then
+		expect(output).toBe("");
+	});
+});

package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-budget.test.ts

@@ -13,7 +13,7 @@ import {
 
 const tempDirectories: string[] = [];
 const PROJECT_RULES_ENV = {
-	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
 	CODEX_RULES_MAX_RESULT_CHARS: "50000",
 	CODEX_RULES_MAX_RULE_CHARS: "30000",
 };
@@ -56,7 +56,9 @@ function makeOversizedProject(): { root: string; pluginData: string } {
 	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-post-compact-budget-data-"));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), `Project rule\n${"A".repeat(30_000)}`);
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), `Project rule\n${"A".repeat(30_000)}`);
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),

package/packages/omo-codex/plugin/components/rules/test/codex-hook-post-compact-dedup.test.ts

@@ -15,7 +15,7 @@ import {
 
 const tempDirectories: string[] = [];
 const PROJECT_ONLY_ENV = {
-	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
 };
 
 afterEach(() => {
@@ -145,7 +145,9 @@ function makeTempProject(): { root: string; pluginData: string } {
 	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-compact-dedup-data-"));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), "Always wear safety goggles when refactoring.");
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), "Always wear safety goggles when refactoring.");
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),

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

@@ -55,9 +55,17 @@ function runHookCli(input: string, subcommand = "post-tool-use", env: NodeJS.Pro
 
 const tempDirectories: string[] = [];
 const PROJECT_ONLY_ENV = {
+	CODEX_RULES_ENABLED_SOURCES: "CONTEXT.md,.omo/rules",
+};
+
+const AGENTS_AND_RULES_ENV = {
 	CODEX_RULES_ENABLED_SOURCES: "AGENTS.md,.omo/rules",
 };
 
+const CLAUDE_AND_RULES_ENV = {
+	CODEX_RULES_ENABLED_SOURCES: "CLAUDE.md,.omo/rules",
+};
+
 const RULES_ONLY_ENV = {
 	CODEX_RULES_ENABLED_SOURCES: ".omo/rules",
 };
@@ -73,7 +81,9 @@ function makeTempProject(): { root: string; pluginData: string } {
 	const pluginData = mkdtempSync(path.join(tmpdir(), "codex-rules-data-"));
 	tempDirectories.push(root, pluginData);
 	writeFileSync(path.join(root, "package.json"), JSON.stringify({ name: "fixture" }));
-	writeFileSync(path.join(root, "AGENTS.md"), "Always wear safety goggles when refactoring.");
+	writeFileSync(path.join(root, "AGENTS.md"), "Project AGENTS.md should stay Codex-native.");
+	writeFileSync(path.join(root, "CLAUDE.md"), "Project CLAUDE.md should stay outside rules hook context.");
+	writeFileSync(path.join(root, "CONTEXT.md"), "Always wear safety goggles when refactoring.");
 	mkdirSync(path.join(root, ".omo", "rules"), { recursive: true });
 	writeFileSync(
 		path.join(root, ".omo", "rules", "typescript.md"),
@@ -211,6 +221,50 @@ describe("codex rules hooks", () => {
 		expect(parsed.hookSpecificOutput?.additionalContext).toContain("Always wear safety goggles");
 	});
 
+	it("#given default auto sources #when SessionStart runs #then native Codex AGENTS.md is not duplicated", async () => {
+		// given
+		const { root, pluginData } = makeTempProject();
+
+		// when
+		const output = await runSessionStartHook(sessionStartInput(root), {
+			pluginDataRoot: pluginData,
+		});
+
+		// then
+		const parsed = parseHookOutput(output);
+		expect(parsed.hookSpecificOutput?.additionalContext).toContain("## Project Instructions");
+		expect(parsed.hookSpecificOutput?.additionalContext).not.toContain("Project AGENTS.md should stay Codex-native.");
+		expect(parsed.hookSpecificOutput?.additionalContext).not.toContain("Project CLAUDE.md should stay outside rules hook context.");
+	});
+
+	it("#given project AGENTS.md #when SessionStart runs #then rules hook leaves AGENTS.md to Codex native handling", async () => {
+		// given
+		const { root, pluginData } = makeTempProject();
+
+		// when
+		const output = await runSessionStartHook(sessionStartInput(root), {
+			pluginDataRoot: pluginData,
+			env: AGENTS_AND_RULES_ENV,
+		});
+
+		// then
+		expect(output).toBe("");
+	});
+
+	it("#given project CLAUDE.md #when SessionStart runs #then rules hook leaves CLAUDE.md out of context", async () => {
+		// given
+		const { root, pluginData } = makeTempProject();
+
+		// when
+		const output = await runSessionStartHook(sessionStartInput(root), {
+			pluginDataRoot: pluginData,
+			env: CLAUDE_AND_RULES_ENV,
+		});
+
+		// then
+		expect(output).toBe("");
+	});
+
 	it("#given static context already injected #when UserPromptSubmit runs #then it emits no duplicate context", async () => {
 		// given
 		const { root, pluginData } = makeTempProject();
@@ -351,6 +405,23 @@ describe("codex rules hooks", () => {
 		expect(readSessionCache(pluginData).dynamicTargetFingerprints).toEqual(cachedState.dynamicTargetFingerprints);
 	});
 
+	it("#given default auto sources #when excluded AGENTS.md changes #then PostToolUse fingerprint stays stable", async () => {
+		// given
+		const { root, pluginData } = makeTempProject();
+		const filePath = path.join(root, "src", "app.ts");
+		const input = postToolUseInput(root, filePath);
+		await runPostToolUseHook(input, { pluginDataRoot: pluginData });
+		const cachedState = readSessionCache(pluginData);
+		writeFileSync(path.join(root, "AGENTS.md"), "Native Codex instructions changed outside codex-rules auto.");
+
+		// when
+		const output = await runPostToolUseHook(input, { pluginDataRoot: pluginData });
+
+		// then
+		expect(output).toBe("");
+		expect(readSessionCache(pluginData).dynamicTargetFingerprints).toEqual(cachedState.dynamicTargetFingerprints);
+	});
+
 	it("#given dynamic context remains in transcript but cache is missing #when PostToolUse repeats #then it emits no duplicate context", async () => {
 		// given
 		const { root, pluginData } = makeTempProject();

package/packages/omo-codex/plugin/components/rules/test/config.test.ts

@@ -0,0 +1,22 @@
+import { describe, expect, it } from "vitest";
+
+import { configFromEnvironment } from "../src/config.js";
+
+const REMOVED_AGENT_DOC_SOURCE_LISTS = ["AGENTS.md", "CLAUDE.md", "AGENTS.md,CLAUDE.md"] as const;
+
+describe("rules config", () => {
+	for (const sourceList of REMOVED_AGENT_DOC_SOURCE_LISTS) {
+		it(`#given removed agent-doc source ${sourceList} #when parsing enabled sources #then preserves the explicit empty allowlist`, () => {
+			// given
+			const env = {
+				CODEX_RULES_ENABLED_SOURCES: sourceList,
+			} satisfies NodeJS.ProcessEnv;
+
+			// when
+			const config = configFromEnvironment(env);
+
+			// then
+			expect(config.enabledSources).toEqual([]);
+		});
+	}
+});