@fusengine/harness 0.1.77 → 0.1.78

package/dist/cli/bin.mjs

@@ -4,7 +4,7 @@ import { t as detectHarness } from "../harness-Cb9xR8dC.mjs";
 import { t as claudeHome } from "../home-state-BXf38Zi1.mjs";
 import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-3tyTW9Ud.mjs";
 import { n as writeInitFile, t as initFor } from "../run-Do2JltgU.mjs";
-import { $ as runningVersion, Q as runDoctor, Z as notify, et as versionBanner, t as handleHook, zt as todayUtc } from "../handle-BDlk2utY.mjs";
+import { $ as runningVersion, Q as runDoctor, Z as notify, et as versionBanner, t as handleHook, zt as todayUtc } from "../handle-Dthtlp7Z.mjs";
 import { p as readStdin$1 } from "../claude-51RSspJ1.mjs";
 import { delimiter, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";

package/dist/{handle-BDlk2utY.mjs → handle-Dthtlp7Z.mjs}

@@ -6,7 +6,7 @@ import { B as detectProjectType$1, H as requiredArchSkill, L as detectFramework,
 import { a as sanitizeSessionId, c as sessionsDir, d as countFrameworkCodeLines, f as countLines, i as loadSessionState, l as PLUGINS_DIR, n as fuseHarnessHome, o as saveSessionState, r as fusengineCache, t as claudeHome } from "./home-state-BXf38Zi1.mjs";
 import { a as writeJsonFile, i as readJsonFile, r as hashText, t as atomicWrite } from "./json-io-DisYd2fb.mjs";
 import { r as isDocConsulted } from "./doc-helpers-CWZegVdR.mjs";
-import { A as detectCreationIntent, E as isExcludedSwiftPath, F as docConsultedGate, I as evaluateApex, M as POST_AUTH_GATES, N as PRE_AUTH_GATES, S as usesTailwindUtilities, T as isExcludedJsPath, _ as scanPlugin, c as EXCLUDE_DIRS$1, d as buildApexTaskInjection, h as buildClaudeMdContext, k as capVerbosity, l as PROJECT_INDICATORS, n as missingSeoElements, o as parseEnrichment, r as descFromText, s as parseEntry, t as isHtmlLike, w as frameworkSolidGate, x as skillTriggerGate, y as parseField } from "./validate-DnLU4IHy.mjs";
+import { A as capVerbosity, C as usesTailwindUtilities, D as isExcludedSwiftPath, E as isExcludedJsPath, I as docConsultedGate, L as evaluateApex, N as POST_AUTH_GATES, P as PRE_AUTH_GATES, S as skillTriggerGate, T as frameworkSolidGate, _ as harnessHomeSegment, b as parseField, c as EXCLUDE_DIRS$1, d as buildApexTaskInjection, h as buildClaudeMdContext, j as detectCreationIntent, l as PROJECT_INDICATORS, n as missingSeoElements, o as parseEnrichment, r as descFromText, s as parseEntry, t as isHtmlLike, v as scanPlugin } from "./validate-DhOX5hDK.mjs";
 import { n as findMarketplacePlugins, r as readPluginMeta, t as resolveSkillPath } from "./skill-path-BO2N0XvB.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as nowStamp, l as throttleMs, n as readRoots, o as readState, s as setStateField, t as addRoot } from "./registry-CymilZiZ.mjs";
@@ -591,10 +591,11 @@ function claudeMdKey(prompt, ctx) {
 * is emitted on EVERY message" is thus preserved.
 * @param prompt - The raw user prompt.
 * @param cwd - Project root (for project-type detection).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty).
 */
-function promptSubmitContext(prompt, cwd) {
-	const ctx = buildClaudeMdContext(prompt, cwd);
+function promptSubmitContext(prompt, cwd, id = "claude-code") {
+	const ctx = buildClaudeMdContext(prompt, cwd, id);
 	if (!ctx) return "";
 	if (!oncePerWindow(claudeMdKey(prompt, ctx), 3e3)) return "";
 	return attachSystemMessage(contextResponse("UserPromptSubmit", ctx), "CLAUDE.md injected");
@@ -605,10 +606,11 @@ function promptSubmitContext(prompt, cwd) {
 * Harness-produced (not owner CLAUDE.md content), so it is subject to the
 * per-fragment {@link capFragment} budget — unlike {@link promptSubmitContext}.
 * @param cwd - Fallback project root when `CLAUDE_PROJECT_DIR` is unset.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty).
 */
-function taskContext(cwd) {
-	const ctx = buildApexTaskInjection(process.env.CLAUDE_PROJECT_DIR ?? cwd);
+function taskContext(cwd, id = "claude-code") {
+	const ctx = buildApexTaskInjection(process.env.CLAUDE_PROJECT_DIR ?? cwd, id);
 	return ctx ? contextResponse("PreToolUse", capFragment("apex-task", ctx)) : "";
 }
 //#endregion
@@ -1442,14 +1444,17 @@ function stamp$1(now) {
 	return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}${pad(d.getSeconds())}`;
 }
 /**
-* Handle PreCompact: back up `.claude/apex/task.json` to `backups/`, keep only
-* the 5 newest, and emit a confirmation. Ports `pre-compact/save-apex-state.py`.
+* Handle PreCompact: back up the target apex `task.json` (`.claude/apex/`,
+* `.codex/apex/`, ...) to `backups/`, keep only the 5 newest, and emit a
+* confirmation. Ports `pre-compact/save-apex-state.py`.
 * @param cwd - Project root.
 * @param now - Clock (defaults to `Date.now()`).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty when no task.json).
 */
-function saveApexState(cwd, now = Date.now()) {
-	const apexDir = join(cwd, ".claude", "apex");
+function saveApexState(cwd, now = Date.now(), id = "claude-code") {
+	const seg = harnessHomeSegment(id);
+	const apexDir = join(cwd, seg, "apex");
 	const stateFile = join(apexDir, "task.json");
 	if (!existsSync(stateFile)) return "";
 	const backupDir = join(apexDir, "backups");
@@ -1459,7 +1464,7 @@ function saveApexState(cwd, now = Date.now()) {
 	for (const old of backups.slice(5)) try {
 		rmSync(join(backupDir, old), { force: true });
 	} catch {}
-	return JSON.stringify({ additionalContext: "APEX state saved before compaction. Previous task state preserved in .claude/apex/backups/" });
+	return JSON.stringify({ additionalContext: `APEX state saved before compaction. Previous task state preserved in ${seg}/apex/backups/` });
 }
 //#endregion
 //#region src/runtime/lifecycle/session-end.ts
@@ -4074,18 +4079,25 @@ function cartographerContext() {
 	return `\n### 7. Cartographer Maps\nNavigate branches (index.md) -> leaves link to real files:\n- Plugin skills: ${pluginsMap}\n- Project files: .cartographer/project/index.md`;
 }
 /**
-* Build the APEX sub-agent injection for SubagentStart, or "" when the project
-* has no `.claude/apex/` dir. Reads AGENTS.md (first 4KB) + task.json.
+* Build the APEX sub-agent injection for SubagentStart, or "" when the project has no target apex dir (`.claude/apex/`, `.codex/apex/`, ...). Reads AGENTS.md (first 4KB) + task.json.
 * @param cwd - Fallback project root when `CLAUDE_PROJECT_DIR` is unset.
 * @param home - Home dir (unused placeholder; kept for symmetry/testing).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty).
 */
-async function injectApexSubagentContext(cwd, home = homedir()) {
-	const apexDir = join(process.env.CLAUDE_PROJECT_DIR ?? cwd, ".claude", "apex");
+async function injectApexSubagentContext(cwd, home = homedir(), id = "claude-code") {
+	const projectRoot = process.env.CLAUDE_PROJECT_DIR ?? cwd;
+	const seg = harnessHomeSegment(id);
+	const apexDir = join(projectRoot, seg, "apex");
 	if (!existsSync(apexDir)) return "";
 	const agentsPath = join(apexDir, "AGENTS.md");
 	const agents = existsSync(agentsPath) ? readText(agentsPath).slice(0, 4e3) : "";
 	const taskData = await readJsonFile(join(apexDir, "task.json"));
+	const completed = taskData ? completedTasks(taskData.tasks) : "none";
+	const pending = taskData ? pendingTasks(taskData.tasks) : "none";
+	const isCodex = id === "codex";
+	const beforeStart = isCodex ? "Use update_plan → mark the active step in_progress before starting" : "Use TaskUpdate(taskId, status: in_progress) before starting";
+	const whenDone = isCodex ? "update_plan → mark the step completed when done" : "TaskUpdate(taskId, status: completed) triggers auto-commit";
 	return contextResponse("SubagentStart", capFragment("apex-subagent", `## APEX Sub-Agent Instructions
 
 You are a sub-agent in APEX workflow. Follow these rules:
@@ -4094,24 +4106,24 @@ You are a sub-agent in APEX workflow. Follow these rules:
 ${agents}
 
 ### 2. Task Context
-- Last completed: ${taskData ? completedTasks(taskData.tasks) : "none"}
-- Pending: ${taskData ? pendingTasks(taskData.tasks) : "none"}
+- Last completed: ${completed}
+- Pending: ${pending}
 
 ### 3. Before Starting Work
-- Use TaskUpdate(taskId, status: in_progress) before starting
+- ${beforeStart}
 
 ### 4. SOLID Rules
 - Files < ${resolveMaxLines()} lines | Interfaces in src/interfaces/ | JSDoc/PHPDoc required
 
 ### 5. Research Before Code
-- Use Context7/Exa for docs | Write notes to .claude/apex/docs/
+- Use Context7/Exa for docs | Write notes to ${seg}/apex/docs/
 
 ### 6. Before Done (NEVER skip)
 - eLicit: self-review with a NAMED elicitation technique; fix findings first
 - Verify: run/functional-check your changes (references⇔declarations)
 
 ### 7. When Done
-- TaskUpdate(taskId, status: completed) triggers auto-commit${cartographerContext()}`));
+- ${whenDone}${cartographerContext()}`));
 }
 /** 16-char hex SHA-256 of `text` (project hash / doc topic key). */
 function hashText16(text) {
@@ -5047,18 +5059,22 @@ async function onComplete(taskFile, taskId, projectRoot) {
 	return contextResponse("PostToolUse", `Task #${taskId} completed: ${(await readJsonFile(taskFile))?.tasks[taskId]?.subject ?? "Task"}\n\nChanges detected. MANDATORY: Run /fuse-commit-pro:commit to commit with smart detection.`);
 }
 /**
-* PostToolUse TaskCreate/TaskUpdate handler.
+* PostToolUse TaskCreate/TaskUpdate handler. Claude-only by design: Codex never
+* emits these native task tools, so the `toolName` matcher below intentionally
+* stays as-is — only the target apex-dir segment is harness-aware.
 * @param payload - The raw hook payload (`tool_name`, `tool_input`, `tool_response`).
 * @param cwd - Fallback project root (uses `CLAUDE_PROJECT_DIR` first).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty).
 */
-async function syncTaskTracking(payload, cwd) {
+async function syncTaskTracking(payload, cwd, id = "claude-code") {
 	const toolName = String(payload.tool_name ?? "");
 	if (toolName !== "TaskCreate" && toolName !== "TaskUpdate") return "";
 	const projectRoot = process.env.CLAUDE_PROJECT_DIR ?? cwd;
-	const taskFile = join(projectRoot, ".claude", "apex", "task.json");
+	const seg = harnessHomeSegment(id);
+	const taskFile = join(projectRoot, seg, "apex", "task.json");
 	if (!existsSync(taskFile)) return "";
-	const unlock = await acquireLock(join(projectRoot, ".claude", "apex", ".task.lock"), 1e4);
+	const unlock = await acquireLock(join(projectRoot, seg, "apex", ".task.lock"), 1e4);
 	if (!unlock) return "";
 	try {
 		const ti = payload.tool_input ?? {};
@@ -5267,9 +5283,9 @@ async function typeSpecificCache(agent, cwd, now, home) {
 * entries (APEX context + lessons) fire for EVERY sub-agent, then the type-specific
 * cache is concatenated on top — sniper too, hence no early return.
 */
-async function onSubagentStart(payload, cwd, now, home) {
+async function onSubagentStart(payload, cwd, now, home, id) {
 	const agent = agentTypeOf(payload);
-	return combineContext(await injectApexSubagentContext(cwd, home), await injectLessonsCache(cwd, home, now), await typeSpecificCache(agent, cwd, now, home));
+	return combineContext(await injectApexSubagentContext(cwd, home, id), await injectLessonsCache(cwd, home, now), await typeSpecificCache(agent, cwd, now, home));
 }
 /** SubagentStop routing: transcript-driven cache writers, then the universal SOLID check. */
 async function onSubagentStop(payload, cwd, home) {
@@ -5285,10 +5301,10 @@ async function onSubagentStop(payload, cwd, home) {
 /**
 * Dispatch an ai-pilot-scope lifecycle event. Returns the native stdout, or
 * `null` when unhandled (caller falls through to the default pipeline).
-* @param home - Home dir for cache resolution (defaults to `~`; injectable for test isolation).
+* @param home - Home dir for cache resolution (defaults to `~`; injectable for test isolation); `id` selects the harness target (defaults to "claude-code").
 */
-async function dispatchAipilot(event, payload, cwd, now, home = homedir()) {
-	if (event === "SubagentStart") return onSubagentStart(payload, cwd, now, home);
+async function dispatchAipilot(event, payload, cwd, now, home = homedir(), id = "claude-code") {
+	if (event === "SubagentStart") return onSubagentStart(payload, cwd, now, home, id);
 	if (event === "SubagentStop") return onSubagentStop(payload, cwd, home);
 	if (event === "SessionEnd" || event === "Stop") {
 		await cacheAnalyticsSave(home, now);
@@ -5297,9 +5313,9 @@ async function dispatchAipilot(event, payload, cwd, now, home = homedir()) {
 	if (event === "PreToolUse") return docCacheGate(payload, cwd, now, home);
 	return null;
 }
-/** PostToolUse (Write/Edit SOLID check, else TaskCreate/TaskUpdate sync) for the ai-pilot scope. */
-async function aipilotPostToolUse(payload, cwd) {
-	return checkSolidCompliance(payload) || await syncTaskTracking(payload, cwd);
+/** PostToolUse (Write/Edit SOLID check, else TaskCreate/TaskUpdate sync) for the ai-pilot scope; `id` selects the harness target (defaults to "claude-code"). */
+async function aipilotPostToolUse(payload, cwd, id = "claude-code") {
+	return checkSolidCompliance(payload) || await syncTaskTracking(payload, cwd, id);
 }
 //#endregion
 //#region src/runtime/lifecycle/dispatch.ts
@@ -5341,7 +5357,7 @@ function dispatchLifecycle(input) {
 		case "TeammateIdle": return teammateIdleContext(input.payload, input.cwd, void 0, input.now);
 		case "PostToolUseFailure": return failureLessonContext(input.payload, input.cwd, void 0, input.now);
 		case "PostCompact": return input.scope === "core" ? postCompactContext(input.payload, input.cwd, import.meta.url, input.now) : "";
-		case "PreCompact": return saveApexState(input.cwd, input.now);
+		case "PreCompact": return saveApexState(input.cwd, input.now, input.id ?? "claude-code");
 		case "SessionEnd":
 			if (input.scope !== "aipilot") cleanupSession(void 0, input.now);
 			return "";
@@ -5883,19 +5899,22 @@ function docTypeOf(filePath) {
 }
 /**
 * Auto-document a Read of a SKILL.md/README/CLAUDE.md/docs/references file
-* into `.claude/apex/docs/task-<current>-<framework>.md` (skipped when the
-* file is already logged, or no project root is found from `filePath`).
+* into the target apex docs dir (`.claude/apex/docs/`, `.codex/apex/docs/`,
+* ...) as `task-<current>-<framework>.md` (skipped when the file is already
+* logged, or no project root is found from `filePath`).
 * @param filePath - The path passed to the Read tool.
 * @param now - Clock (defaults to `Date.now()`).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native `systemMessage` stdout, or "" when nothing was logged.
 */
-async function autoDocumentRead(filePath, now = Date.now()) {
+async function autoDocumentRead(filePath, now = Date.now(), id = "claude-code") {
 	if (!filePath || !DOC_PATTERNS.some((p) => p.test(filePath))) return "";
 	const root = projectRootOrNull(dirname(filePath));
 	if (!root) return "";
+	const seg = harnessHomeSegment(id);
 	const framework = detectProjectType$1(root);
-	const current = (await readJsonFile(join(root, ".claude", "apex", "task.json")))?.current_task ?? "1";
-	const docDir = join(root, ".claude", "apex", "docs");
+	const current = (await readJsonFile(join(root, seg, "apex", "task.json")))?.current_task ?? "1";
+	const docDir = join(root, seg, "apex", "docs");
 	const docFile = join(docDir, `task-${current}-${framework}.md`);
 	const ts = new Date(now).toISOString().replace(/\.\d{3}Z$/, "Z");
 	const fname = basename(filePath);
@@ -5934,15 +5953,17 @@ function additionalContextOf(stdout) {
 * @param cwd - Project root.
 * @param scope - The invoking plugin scope (defaults to `core`).
 * @param now - Clock.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native stdout, or `null` when unhandled.
 */
-function lifecycleStdout(payload, cwd, scope, now) {
+function lifecycleStdout(payload, cwd, scope, now, id = "claude-code") {
 	return dispatchLifecycle({
 		event: rawEvent(payload),
 		payload,
 		cwd,
 		scope,
-		now
+		now,
+		id
 	});
 }
 /**
@@ -5955,11 +5976,12 @@ function lifecycleStdout(payload, cwd, scope, now) {
 * @param scope - The invoking plugin scope.
 * @param event - The normalized event.
 * @param now - Clock.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The extra stdout (possibly empty).
 */
-async function postEditContext(scope, event, now) {
+async function postEditContext(scope, event, now, id = "claude-code") {
 	if (scope !== "core" || !event.filePath) return "";
-	if (event.tool === "Read") return autoDocumentRead(event.filePath, now);
+	if (event.tool === "Read") return autoDocumentRead(event.filePath, now, id);
 	if (event.tool !== "Write" && event.tool !== "Edit") return "";
 	const sniper = trackSessionChanges(event.sessionId, event.filePath, void 0, now);
 	const lint = postEditTypescript(event.filePath);
@@ -6019,7 +6041,7 @@ const EXEMPT_PATTERNS = [
 	/\.claude-plugin\//,
 	/CHANGELOG\.md$/,
 	/marketplace\.json$/,
-	/\/\.claude\/(apex|memory|logs|fusengine-cache)\//,
+	/\/\.(claude|codex)\/(apex|memory|logs|fusengine-cache)\//,
 	/\/\.fuse-harness\//
 ];
 /**
@@ -7873,7 +7895,7 @@ async function handlePre(ctx) {
 		exit: 0
 	};
 	if (event.tool === "Task") {
-		const taskCtx = taskContext(opts.cwd);
+		const taskCtx = taskContext(opts.cwd, id);
 		if (taskCtx) return {
 			stdout: taskCtx,
 			exit: 0
@@ -8440,7 +8462,7 @@ async function handlePost(ctx) {
 		};
 	}
 	if (opts.scope === "aipilot" && (event.tool === "TaskCreate" || event.tool === "TaskUpdate" || event.tool === "Write" || event.tool === "Edit")) {
-		const out = await aipilotPostToolUse(payload, opts.cwd);
+		const out = await aipilotPostToolUse(payload, opts.cwd, id);
 		if (out) return {
 			stdout: out,
 			exit: 0
@@ -8448,7 +8470,7 @@ async function handlePost(ctx) {
 	}
 	let extra = "";
 	for (const f of files) {
-		extra = await postEditContext(opts.scope ?? "core", f, opts.now);
+		extra = await postEditContext(opts.scope ?? "core", f, opts.now, id);
 		if (extra) break;
 	}
 	const notice = designPassNotice({
@@ -8508,10 +8530,11 @@ async function handlePost(ctx) {
 * @param payload - The raw hook payload.
 * @param cwd - Project root.
 * @param now - Clock.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native stdout when intercepted, or `null` to fall through.
 */
-async function asyncScopeStdout(scope, event, payload, cwd, now) {
-	if (scope === "aipilot") return dispatchAipilot(event, payload, cwd, now);
+async function asyncScopeStdout(scope, event, payload, cwd, now, id = "claude-code") {
+	if (scope === "aipilot") return dispatchAipilot(event, payload, cwd, now, void 0, id);
 	if (scope === "memory") return dispatchMemory(event, payload, cwd, now);
 	return null;
 }
@@ -8925,12 +8948,12 @@ async function handleHook(id, payload, opts) {
 		exit: 0
 	};
 	if (id === "codex" && rawEventName(payload) === "SessionStart") resyncCodexAgents();
-	const asyncOut = await asyncScopeStdout(opts.scope, rawEventName(payload), payload, opts.cwd, opts.now);
+	const asyncOut = await asyncScopeStdout(opts.scope, rawEventName(payload), payload, opts.cwd, opts.now, id);
 	if (asyncOut !== null) return {
 		stdout: asyncOut,
 		exit: 0
 	};
-	const life = lifecycleStdout(payload, opts.cwd, opts.scope ?? "core", opts.now);
+	const life = lifecycleStdout(payload, opts.cwd, opts.scope ?? "core", opts.now, id);
 	if (life !== null) return {
 		stdout: id === "claude-code" ? attachBudgetRecap(life, rawEventName(payload), event.sessionId, opts.cwd, opts.now) : life,
 		exit: 0
@@ -8939,7 +8962,7 @@ async function handleHook(id, payload, opts) {
 	if (userPrompt !== void 0) {
 		await saveTrack(file, recordBrainstormRequired(await loadTrack(file), detectCreationIntent(userPrompt)));
 		return {
-			stdout: promptSubmitContext(userPrompt, opts.cwd),
+			stdout: promptSubmitContext(userPrompt, opts.cwd, id),
 			exit: 0
 		};
 	}

package/dist/{index-DJw1OGwE.d.mts → index-BIGVNQB8.d.mts}

@@ -412,9 +412,7 @@ declare function usesTailwindUtilities(filePath: string, content: string): boole
 */
 declare function skillTriggerGate(framework: string, content: string, refsRead: readonly string[], forcedSkill?: string | null, cwd?: string, filePath?: string): Prompt | null;
 //#endregion
-//#region src/policy/claude-md-context.d.ts
-/** Dev-verb regex (FR/EN) that triggers the APEX preamble (case-insensitive). */
-declare const DEV_VERBS: RegExp;
+//#region src/policy/detect-claude-md-project-type.d.ts
 /**
 * Detect the project type from the cwd, reproducing the legacy Python logic:
 * package.json containing "next" → nextjs, else "react" → react; else
@@ -424,22 +422,29 @@ declare const DEV_VERBS: RegExp;
 * @returns The detected project type label.
 */
 declare function detectClaudeMdProjectType(cwd: string): ProjectType;
+//#endregion
+//#region src/policy/claude-md-context.d.ts
+/** Dev-verb regex (FR/EN) that triggers the APEX preamble (case-insensitive). */
+declare const DEV_VERBS: RegExp;
 /**
 * Build the APEX instruction preamble for a development task.
 * @param projectType - Detected project type label.
 * @param maxLines - SOLID per-file line ceiling.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The APEX instruction text.
 */
-declare function buildApexInstruction(projectType: ProjectType, maxLines: number): string;
+declare function buildApexInstruction(projectType: ProjectType, maxLines: number, id?: string): string;
 /**
-* Build the UserPromptSubmit injection text: read `~/.claude/CLAUDE.md` and,
+* Build the UserPromptSubmit injection text: read the target's root
+* instructions doc (`~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, ...) and,
 * when the prompt matches a dev verb, prepend the APEX instruction. Returns
-* `null` when CLAUDE.md is absent/unreadable (the hook then emits nothing).
+* `null` when the doc is absent/unreadable (the hook then emits nothing).
 * @param prompt - The raw user prompt.
 * @param cwd - Project root (for project-type detection).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The injection text, or `null` to emit nothing.
 */
-declare function buildClaudeMdContext(prompt: string, cwd: string): string | null;
+declare function buildClaudeMdContext(prompt: string, cwd: string, id?: string): string | null;
 //#endregion
 //#region src/policy/apex-task-context.d.ts
 /** Parsed task state injected into a Task sub-agent prompt. */
@@ -464,16 +469,19 @@ declare function loadApexTaskState(taskFile: string): ApexTaskState;
 * Build the APEX context string injected into a Task sub-agent prompt.
 * @param state - The parsed task state.
 * @param maxLines - SOLID per-file line ceiling.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The injection text.
 */
-declare function buildApexTaskContext(state: ApexTaskState, maxLines: number): string;
+declare function buildApexTaskContext(state: ApexTaskState, maxLines: number, id?: string): string;
 /**
-* Build the PreToolUse Task injection, gated on the existence of the project's
-* `.claude/apex/` directory. Returns `null` when APEX is not active (no dir).
+* Build the PreToolUse Task injection, gated on the existence of the
+* project's target apex dir (`.claude/apex/`, `.codex/apex/`, ...). Returns
+* `null` when APEX is not active (no dir).
 * @param projectRoot - `CLAUDE_PROJECT_DIR` or cwd.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The injection text, or `null` to emit nothing.
 */
-declare function buildApexTaskInjection(projectRoot: string): string | null;
+declare function buildApexTaskInjection(projectRoot: string, id?: string): string | null;
 //#endregion
 //#region src/policy/cartographer/indicators.d.ts
 /**

package/dist/index.d.mts

@@ -5,7 +5,7 @@ import { a as HarnessInfo, i as HarnessId, n as detectMode, o as HarnessMode, r
 import { a as isDocConsulted, i as formatDocSatisfactionStatus, n as DocSatisfactionStatus, o as resolveSessions, r as formatDocDeny, t as AuthEntry } from "./doc-helpers-CEKzGg2u.mjs";
 import { t as incrementTrivialEditCounter } from "./index-BOBXQ91y.mjs";
 import { a as compactJson, i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./index-BEMumjOw.mjs";
-import { $ as protectedPathGuard, A as FAIL_CLOSED, B as RUST_DECL_RE, C as usesTailwindUtilities, Ct as DEV_KEYWORDS, D as MAX_TOKENS, Dt as detectProjectType, E as MAX_EXA_RESULTS, Et as detectModularArchitecture, F as installGuard, G as ASK_WRITERS, H as TS_DECL_RE, I as GO_DECL_RE, J as FILE_REDIRECT, K as CODE_MUTATORS, L as JAVA_DECL_RE, M as clearUserGuards, N as registerGuard, O as capVerbosity, Ot as isApexCommand, P as runGuards, Q as PROTECTED_GIT_RE, R as PHP_DECL_RE, S as skillTriggerGate, St as detectFramework, T as frameworkSolidGate, Tt as ProjectType, U as interfaceSeparationGuard, V as SWIFT_PROTO_RE, W as bashWriteGuard, X as SESSION_STATE_FRAGMENT, Y as SAFE_PREFIXES, Z as PROTECTED_FRAGMENTS, _ as DEV_VERBS, _t as PLUGINS_DIR, a as firstHeading, at as GuardContext, b as detectClaudeMdProjectType, bt as countLines, c as parseEntry, ct as PolicyResult, d as EXCLUDE_DIRS, dt as PROJECT_INSTALL, et as ASK_PATTERNS, f as PROJECT_INDICATORS, ft as RALPH_SAFE, g as loadApexTaskState, gt as FileSizeVerdict, h as buildApexTaskInjection, ht as matchPatterns, i as firstComment, it as Guard, j as GUARDS, k as detectCreationIntent, kt as requiredArchSkill, l as parseBodyDesc, lt as GIT_ASK, m as buildApexTaskContext, mt as isRalphMode, n as missingSeoElements, nt as LabeledPattern, o as TreeEntry, ot as evaluate, p as ApexTaskState, pt as SYSTEM_INSTALL, q as CODE_REDIRECT, r as descFromText, rt as securityGuard, s as parseEnrichment, st as PolicyContext, t as isHtmlLike, tt as CRITICAL_PATTERNS, u as parseField, ut as GIT_BLOCKED, v as buildApexInstruction, vt as SOLID_REF, w as SKILL_TRIGGERS, wt as ModularArchitecture, x as detectRequiredSkills, xt as evaluateFileSize, y as buildClaudeMdContext, yt as countFrameworkCodeLines, z as PY_MODEL_RE } from "./index-DJw1OGwE.mjs";
+import { $ as protectedPathGuard, A as FAIL_CLOSED, B as RUST_DECL_RE, C as usesTailwindUtilities, Ct as DEV_KEYWORDS, D as MAX_TOKENS, Dt as detectProjectType, E as MAX_EXA_RESULTS, Et as detectModularArchitecture, F as installGuard, G as ASK_WRITERS, H as TS_DECL_RE, I as GO_DECL_RE, J as FILE_REDIRECT, K as CODE_MUTATORS, L as JAVA_DECL_RE, M as clearUserGuards, N as registerGuard, O as capVerbosity, Ot as isApexCommand, P as runGuards, Q as PROTECTED_GIT_RE, R as PHP_DECL_RE, S as skillTriggerGate, St as detectFramework, T as frameworkSolidGate, Tt as ProjectType, U as interfaceSeparationGuard, V as SWIFT_PROTO_RE, W as bashWriteGuard, X as SESSION_STATE_FRAGMENT, Y as SAFE_PREFIXES, Z as PROTECTED_FRAGMENTS, _ as DEV_VERBS, _t as PLUGINS_DIR, a as firstHeading, at as GuardContext, b as detectClaudeMdProjectType, bt as countLines, c as parseEntry, ct as PolicyResult, d as EXCLUDE_DIRS, dt as PROJECT_INSTALL, et as ASK_PATTERNS, f as PROJECT_INDICATORS, ft as RALPH_SAFE, g as loadApexTaskState, gt as FileSizeVerdict, h as buildApexTaskInjection, ht as matchPatterns, i as firstComment, it as Guard, j as GUARDS, k as detectCreationIntent, kt as requiredArchSkill, l as parseBodyDesc, lt as GIT_ASK, m as buildApexTaskContext, mt as isRalphMode, n as missingSeoElements, nt as LabeledPattern, o as TreeEntry, ot as evaluate, p as ApexTaskState, pt as SYSTEM_INSTALL, q as CODE_REDIRECT, r as descFromText, rt as securityGuard, s as parseEnrichment, st as PolicyContext, t as isHtmlLike, tt as CRITICAL_PATTERNS, u as parseField, ut as GIT_BLOCKED, v as buildApexInstruction, vt as SOLID_REF, w as SKILL_TRIGGERS, wt as ModularArchitecture, x as detectRequiredSkills, xt as evaluateFileSize, y as buildClaudeMdContext, yt as countFrameworkCodeLines, z as PY_MODEL_RE } from "./index-BIGVNQB8.mjs";
 import { n as RouteResult, r as ScoredRef, t as RefMeta } from "./types-CY5qT2X1.mjs";
 import { a as PRE_AUTH_GATES, c as evaluateApex, i as POST_AUTH_GATES, l as freshnessGate, n as ApexContext, o as brainstormGate, r as ApexGate, s as docConsultedGate, t as APEX_GATES, u as solidReadGate } from "./apex-Wdi1nq_w.mjs";
 import { a as ReminderState, c as readState, d as throttleMs, i as registryFile, l as setStateField, n as addRoot, o as lessonsFileFor, r as readRoots, s as nowStamp, t as ensureMemoryGitignore, u as stateFileFor } from "./index-DLYhervv.mjs";

package/dist/index.mjs

@@ -8,7 +8,7 @@ import { A as GIT_ASK, B as detectProjectType, C as SESSION_STATE_FRAGMENT, D as
 import { d as countFrameworkCodeLines, f as countLines, l as PLUGINS_DIR, p as evaluateFileSize, u as SOLID_REF } from "./home-state-BXf38Zi1.mjs";
 import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-CWZegVdR.mjs";
 import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./router-PKVNBHge.mjs";
-import { A as detectCreationIntent, C as SKILL_TRIGGERS, D as MAX_EXA_RESULTS, F as docConsultedGate, I as evaluateApex, L as freshnessGate, M as POST_AUTH_GATES, N as PRE_AUTH_GATES, O as MAX_TOKENS, P as brainstormGate, R as solidReadGate, S as usesTailwindUtilities, a as firstHeading, b as detectRequiredSkills, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as APEX_GATES, k as capVerbosity, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, v as parseBodyDesc, w as frameworkSolidGate, x as skillTriggerGate, y as parseField } from "./validate-DnLU4IHy.mjs";
+import { A as capVerbosity, C as usesTailwindUtilities, F as brainstormGate, I as docConsultedGate, L as evaluateApex, M as APEX_GATES, N as POST_AUTH_GATES, O as MAX_EXA_RESULTS, P as PRE_AUTH_GATES, R as freshnessGate, S as skillTriggerGate, T as frameworkSolidGate, a as firstHeading, b as parseField, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as detectCreationIntent, k as MAX_TOKENS, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, w as SKILL_TRIGGERS, x as detectRequiredSkills, y as parseBodyDesc, z as solidReadGate } from "./validate-DhOX5hDK.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs, n as readRoots, o as readState, r as registryFile, s as setStateField, t as addRoot, u as ensureMemoryGitignore } from "./registry-CymilZiZ.mjs";
 import { a as cacheLookupSubstring, c as cacheStore, d as loadIndex, f as summarizeIndex, h as queryHash, i as cacheLookupMeta, l as mcpCacheKey, m as jaccardSimilar, n as webfetchCacheWrite, o as cacheLookupSubstringMeta, p as compactMarkdown, r as cacheLookup, s as cachePath, t as mcpCacheWrite, u as extractText } from "./mcp-store-BkBDmuxN.mjs";

package/dist/policy/index.d.mts

@@ -1,3 +1,3 @@
-import { $ as protectedPathGuard, A as FAIL_CLOSED, B as RUST_DECL_RE, C as usesTailwindUtilities, Ct as DEV_KEYWORDS, D as MAX_TOKENS, Dt as detectProjectType, E as MAX_EXA_RESULTS, Et as detectModularArchitecture, F as installGuard, G as ASK_WRITERS, H as TS_DECL_RE, I as GO_DECL_RE, J as FILE_REDIRECT, K as CODE_MUTATORS, L as JAVA_DECL_RE, M as clearUserGuards, N as registerGuard, O as capVerbosity, Ot as isApexCommand, P as runGuards, Q as PROTECTED_GIT_RE, R as PHP_DECL_RE, S as skillTriggerGate, St as detectFramework, T as frameworkSolidGate, Tt as ProjectType, U as interfaceSeparationGuard, V as SWIFT_PROTO_RE, W as bashWriteGuard, X as SESSION_STATE_FRAGMENT, Y as SAFE_PREFIXES, Z as PROTECTED_FRAGMENTS, _ as DEV_VERBS, _t as PLUGINS_DIR, a as firstHeading, at as GuardContext, b as detectClaudeMdProjectType, bt as countLines, c as parseEntry, ct as PolicyResult, d as EXCLUDE_DIRS, dt as PROJECT_INSTALL, et as ASK_PATTERNS, f as PROJECT_INDICATORS, ft as RALPH_SAFE, g as loadApexTaskState, gt as FileSizeVerdict, h as buildApexTaskInjection, ht as matchPatterns, i as firstComment, it as Guard, j as GUARDS, k as detectCreationIntent, kt as requiredArchSkill, l as parseBodyDesc, lt as GIT_ASK, m as buildApexTaskContext, mt as isRalphMode, n as missingSeoElements, nt as LabeledPattern, o as TreeEntry, ot as evaluate, p as ApexTaskState, pt as SYSTEM_INSTALL, q as CODE_REDIRECT, r as descFromText, rt as securityGuard, s as parseEnrichment, st as PolicyContext, t as isHtmlLike, tt as CRITICAL_PATTERNS, u as parseField, ut as GIT_BLOCKED, v as buildApexInstruction, vt as SOLID_REF, w as SKILL_TRIGGERS, wt as ModularArchitecture, x as detectRequiredSkills, xt as evaluateFileSize, y as buildClaudeMdContext, yt as countFrameworkCodeLines, z as PY_MODEL_RE } from "../index-DJw1OGwE.mjs";
+import { $ as protectedPathGuard, A as FAIL_CLOSED, B as RUST_DECL_RE, C as usesTailwindUtilities, Ct as DEV_KEYWORDS, D as MAX_TOKENS, Dt as detectProjectType, E as MAX_EXA_RESULTS, Et as detectModularArchitecture, F as installGuard, G as ASK_WRITERS, H as TS_DECL_RE, I as GO_DECL_RE, J as FILE_REDIRECT, K as CODE_MUTATORS, L as JAVA_DECL_RE, M as clearUserGuards, N as registerGuard, O as capVerbosity, Ot as isApexCommand, P as runGuards, Q as PROTECTED_GIT_RE, R as PHP_DECL_RE, S as skillTriggerGate, St as detectFramework, T as frameworkSolidGate, Tt as ProjectType, U as interfaceSeparationGuard, V as SWIFT_PROTO_RE, W as bashWriteGuard, X as SESSION_STATE_FRAGMENT, Y as SAFE_PREFIXES, Z as PROTECTED_FRAGMENTS, _ as DEV_VERBS, _t as PLUGINS_DIR, a as firstHeading, at as GuardContext, b as detectClaudeMdProjectType, bt as countLines, c as parseEntry, ct as PolicyResult, d as EXCLUDE_DIRS, dt as PROJECT_INSTALL, et as ASK_PATTERNS, f as PROJECT_INDICATORS, ft as RALPH_SAFE, g as loadApexTaskState, gt as FileSizeVerdict, h as buildApexTaskInjection, ht as matchPatterns, i as firstComment, it as Guard, j as GUARDS, k as detectCreationIntent, kt as requiredArchSkill, l as parseBodyDesc, lt as GIT_ASK, m as buildApexTaskContext, mt as isRalphMode, n as missingSeoElements, nt as LabeledPattern, o as TreeEntry, ot as evaluate, p as ApexTaskState, pt as SYSTEM_INSTALL, q as CODE_REDIRECT, r as descFromText, rt as securityGuard, s as parseEnrichment, st as PolicyContext, t as isHtmlLike, tt as CRITICAL_PATTERNS, u as parseField, ut as GIT_BLOCKED, v as buildApexInstruction, vt as SOLID_REF, w as SKILL_TRIGGERS, wt as ModularArchitecture, x as detectRequiredSkills, xt as evaluateFileSize, y as buildClaudeMdContext, yt as countFrameworkCodeLines, z as PY_MODEL_RE } from "../index-BIGVNQB8.mjs";
 import { a as PRE_AUTH_GATES, c as evaluateApex, i as POST_AUTH_GATES, l as freshnessGate, n as ApexContext, o as brainstormGate, r as ApexGate, s as docConsultedGate, t as APEX_GATES, u as solidReadGate } from "../apex-Wdi1nq_w.mjs";
 export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexTaskState, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, Guard, GuardContext, JAVA_DECL_RE, LabeledPattern, MAX_EXA_RESULTS, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PLUGINS_DIR, POST_AUTH_GATES, PRE_AUTH_GATES, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, type PolicyContext, type PolicyResult, ProjectType, RALPH_SAFE, RUST_DECL_RE, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, TreeEntry, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, capVerbosity, clearUserGuards, countFrameworkCodeLines, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, firstComment, firstHeading, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, isHtmlLike, isRalphMode, loadApexTaskState, matchPatterns, missingSeoElements, parseBodyDesc, parseEnrichment, parseEntry, parseField, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate, usesTailwindUtilities };

package/dist/policy/index.mjs

@@ -1,5 +1,5 @@
 import { A as GIT_ASK, B as detectProjectType, C as SESSION_STATE_FRAGMENT, D as ASK_PATTERNS, E as protectedPathGuard, F as isRalphMode, H as requiredArchSkill, I as matchPatterns, L as detectFramework, M as PROJECT_INSTALL, N as RALPH_SAFE, O as CRITICAL_PATTERNS, P as SYSTEM_INSTALL, R as DEV_KEYWORDS, S as SAFE_PREFIXES, T as PROTECTED_GIT_RE, V as isApexCommand, _ as bashWriteGuard, a as registerGuard, b as CODE_REDIRECT, c as GO_DECL_RE, d as PY_MODEL_RE, f as RUST_DECL_RE, h as interfaceSeparationGuard, i as clearUserGuards, j as GIT_BLOCKED, k as securityGuard, l as JAVA_DECL_RE, m as TS_DECL_RE, n as FAIL_CLOSED, o as runGuards, p as SWIFT_PROTO_RE, r as GUARDS, s as installGuard, t as evaluate, u as PHP_DECL_RE, v as ASK_WRITERS, w as PROTECTED_FRAGMENTS, x as FILE_REDIRECT, y as CODE_MUTATORS, z as detectModularArchitecture } from "../evaluate-ClfbCDiY.mjs";
 import { d as countFrameworkCodeLines, f as countLines, l as PLUGINS_DIR, p as evaluateFileSize, u as SOLID_REF } from "../home-state-BXf38Zi1.mjs";
-import { A as detectCreationIntent, C as SKILL_TRIGGERS, D as MAX_EXA_RESULTS, F as docConsultedGate, I as evaluateApex, L as freshnessGate, M as POST_AUTH_GATES, N as PRE_AUTH_GATES, O as MAX_TOKENS, P as brainstormGate, R as solidReadGate, S as usesTailwindUtilities, a as firstHeading, b as detectRequiredSkills, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as APEX_GATES, k as capVerbosity, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, v as parseBodyDesc, w as frameworkSolidGate, x as skillTriggerGate, y as parseField } from "../validate-DnLU4IHy.mjs";
+import { A as capVerbosity, C as usesTailwindUtilities, F as brainstormGate, I as docConsultedGate, L as evaluateApex, M as APEX_GATES, N as POST_AUTH_GATES, O as MAX_EXA_RESULTS, P as PRE_AUTH_GATES, R as freshnessGate, S as skillTriggerGate, T as frameworkSolidGate, a as firstHeading, b as parseField, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as detectCreationIntent, k as MAX_TOKENS, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, w as SKILL_TRIGGERS, x as detectRequiredSkills, y as parseBodyDesc, z as solidReadGate } from "../validate-DhOX5hDK.mjs";
 import "../policy-la_KkjCS.mjs";
 export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, PHP_DECL_RE, PLUGINS_DIR, POST_AUTH_GATES, PRE_AUTH_GATES, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, RALPH_SAFE, RUST_DECL_RE, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, capVerbosity, clearUserGuards, countFrameworkCodeLines, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, firstComment, firstHeading, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, isHtmlLike, isRalphMode, loadApexTaskState, matchPatterns, missingSeoElements, parseBodyDesc, parseEnrichment, parseEntry, parseField, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate, usesTailwindUtilities };

package/dist/runtime/index.d.mts

@@ -287,18 +287,20 @@ declare function claudeMdKey(prompt: string, ctx: string): string;
 * is emitted on EVERY message" is thus preserved.
 * @param prompt - The raw user prompt.
 * @param cwd - Project root (for project-type detection).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty).
 */
-declare function promptSubmitContext(prompt: string, cwd: string): string;
+declare function promptSubmitContext(prompt: string, cwd: string, id?: string): string;
 /**
 * PreToolUse Task context injection: render the APEX sub-agent context as a
 * Claude `additionalContext` response when `.claude/apex/` exists, else "".
 * Harness-produced (not owner CLAUDE.md content), so it is subject to the
 * per-fragment {@link capFragment} budget — unlike {@link promptSubmitContext}.
 * @param cwd - Fallback project root when `CLAUDE_PROJECT_DIR` is unset.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty).
 */
-declare function taskContext(cwd: string): string;
+declare function taskContext(cwd: string, id?: string): string;
 //#endregion
 //#region src/runtime/home-state.d.ts
 /** Home `~/.claude` dir — per-harness config (CLAUDE.md, logs, plugins). */
@@ -472,13 +474,15 @@ declare function logToolFailure(data: Record<string, unknown>, home?: string, no
 //#endregion
 //#region src/runtime/lifecycle/pre-compact.d.ts
 /**
-* Handle PreCompact: back up `.claude/apex/task.json` to `backups/`, keep only
-* the 5 newest, and emit a confirmation. Ports `pre-compact/save-apex-state.py`.
+* Handle PreCompact: back up the target apex `task.json` (`.claude/apex/`,
+* `.codex/apex/`, ...) to `backups/`, keep only the 5 newest, and emit a
+* confirmation. Ports `pre-compact/save-apex-state.py`.
 * @param cwd - Project root.
 * @param now - Clock (defaults to `Date.now()`).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native hook stdout (possibly empty when no task.json).
 */
-declare function saveApexState(cwd: string, now?: number): string;
+declare function saveApexState(cwd: string, now?: number, id?: string): string;
 //#endregion
 //#region src/runtime/lifecycle/session-end.d.ts
 /**
@@ -526,11 +530,11 @@ declare function postEditTypescript(filePath: string): string;
 /**
 * Dispatch an ai-pilot-scope lifecycle event. Returns the native stdout, or
 * `null` when unhandled (caller falls through to the default pipeline).
-* @param home - Home dir for cache resolution (defaults to `~`; injectable for test isolation).
+* @param home - Home dir for cache resolution (defaults to `~`; injectable for test isolation); `id` selects the harness target (defaults to "claude-code").
 */
-declare function dispatchAipilot(event: string, payload: Record<string, unknown>, cwd: string, now: number, home?: string): Promise<string | null>;
-/** PostToolUse (Write/Edit SOLID check, else TaskCreate/TaskUpdate sync) for the ai-pilot scope. */
-declare function aipilotPostToolUse(payload: Record<string, unknown>, cwd: string): Promise<string>;
+declare function dispatchAipilot(event: string, payload: Record<string, unknown>, cwd: string, now: number, home?: string, id?: string): Promise<string | null>;
+/** PostToolUse (Write/Edit SOLID check, else TaskCreate/TaskUpdate sync) for the ai-pilot scope; `id` selects the harness target (defaults to "claude-code"). */
+declare function aipilotPostToolUse(payload: Record<string, unknown>, cwd: string, id?: string): Promise<string>;
 //#endregion
 //#region src/runtime/lifecycle/dispatch.d.ts
 /** Which plugin's hooks.json invoked the harness (selects SessionStart behavior). */
@@ -542,6 +546,8 @@ interface LifecycleInput {
   cwd: string;
   scope: PluginScope;
   now: number;
+  /** Harness target id (defaults to "claude-code" — zero-regression default). */
+  id?: string;
 }
 /**
 * Route a lifecycle/session/context hook event to its ported handler. Returns
@@ -815,9 +821,10 @@ declare function writePluginMap(outputDir: string, pluginName: string, version:
 * @param cwd - Project root.
 * @param scope - The invoking plugin scope (defaults to `core`).
 * @param now - Clock.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The native stdout, or `null` when unhandled.
 */
-declare function lifecycleStdout(payload: Record<string, unknown>, cwd: string, scope: PluginScope, now: number): string | null;
+declare function lifecycleStdout(payload: Record<string, unknown>, cwd: string, scope: PluginScope, now: number, id?: string): string | null;
 /**
 * Post-edit additions for core-scope PostToolUse: auto-document a Read of a
 * SKILL.md/README/docs file; else (Write/Edit) track cumulative session
@@ -828,9 +835,10 @@ declare function lifecycleStdout(payload: Record<string, unknown>, cwd: string,
 * @param scope - The invoking plugin scope.
 * @param event - The normalized event.
 * @param now - Clock.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The extra stdout (possibly empty).
 */
-declare function postEditContext(scope: PluginScope, event: NormalizedEvent, now: number): Promise<string>;
+declare function postEditContext(scope: PluginScope, event: NormalizedEvent, now: number, id?: string): Promise<string>;
 //#endregion
 //#region src/runtime/handle-types.d.ts
 /** Options for {@link handleHook} (caller supplies the clock + project root). */

package/dist/runtime/index.mjs

@@ -1,6 +1,6 @@
 import { r as projectLayout } from "../layout-C0jaaCQC.mjs";
 import { a as sanitizeSessionId, c as sessionsDir, i as loadSessionState, n as fuseHarnessHome, o as saveSessionState, r as fusengineCache, s as sessionStatePath, t as claudeHome } from "../home-state-BXf38Zi1.mjs";
-import { A as trackMcpResearch, At as defaultStateDir, B as generateProjectMap, C as seoPostToolUse, Ct as trimLogFile, D as securityAdvisoryForPatch, Dt as claudeMdKey, E as securityAdvisory, Et as projectContext, F as dispatchAipilot, Ft as loadSecurityState, G as countFiles, H as writeTree, I as dispatchLessons, It as saveSecurityState, J as lessonsArchiveFileFor, K as getFileDesc, L as cartoSessionStart, Lt as securityStateDir, M as trackEnrichment, Mt as trackFile, N as dispatchLifecycle, Nt as normalizeEvent, O as postTrackingSideEffects, Ot as promptSubmitContext, P as aipilotPostToolUse, Pt as isoUtc, R as generateEcosystemMap, Rt as securityStatePath, S as postEditContext, St as removeOldFiles, T as dispatchMemory, Tt as gitContext, U as loadEnriched, V as isProject, W as mergeLines, X as lessonsStateFileFor, Y as lessonsFileFor, _ as preCommitGate, _t as readRules, a as recordActivity, at as saveApexState, b as extractSymbols, bt as pruneEmptyDirs, c as MCP_TTL_MS, ct as trackAgentMemory, d as isMcpTool, dt as validateSolidGate, f as queryOf, ft as checkFileSize, g as gate, gt as injectRules, h as TRIVIAL_BUDGET, ht as solidDetectStart, i as respond, it as cleanupSession, j as trackSkillRead, jt as projectHash, k as trackWatchResearch, kt as taskContext, l as WEBFETCH_TTL_MS, lt as subagentCacheContext, m as REQUIRED_AGENTS, mt as detectSolidProfile, n as activityFor, nt as trackSessionChanges, o as mcpPostStore, ot as logToolFailure, p as DEFAULT_WINDOW_MS, pt as countLoc, q as listChildren, r as handlePre, rt as validateRulesLoaded, s as mcpPreIntercept, st as validateTeammateOutput, t as handleHook, tt as postEditTypescript, u as cacheQueryOf, ut as validateTailwind, v as detectDuplication, vt as runSessionStartCleanups, w as seoPostToolUseResponse, wt as devContext, x as lifecycleStdout, xt as purgeTtlTree, y as dryGate, yt as sessionStartCore, z as writePluginMap, zt as todayUtc } from "../handle-BDlk2utY.mjs";
+import { A as trackMcpResearch, At as defaultStateDir, B as generateProjectMap, C as seoPostToolUse, Ct as trimLogFile, D as securityAdvisoryForPatch, Dt as claudeMdKey, E as securityAdvisory, Et as projectContext, F as dispatchAipilot, Ft as loadSecurityState, G as countFiles, H as writeTree, I as dispatchLessons, It as saveSecurityState, J as lessonsArchiveFileFor, K as getFileDesc, L as cartoSessionStart, Lt as securityStateDir, M as trackEnrichment, Mt as trackFile, N as dispatchLifecycle, Nt as normalizeEvent, O as postTrackingSideEffects, Ot as promptSubmitContext, P as aipilotPostToolUse, Pt as isoUtc, R as generateEcosystemMap, Rt as securityStatePath, S as postEditContext, St as removeOldFiles, T as dispatchMemory, Tt as gitContext, U as loadEnriched, V as isProject, W as mergeLines, X as lessonsStateFileFor, Y as lessonsFileFor, _ as preCommitGate, _t as readRules, a as recordActivity, at as saveApexState, b as extractSymbols, bt as pruneEmptyDirs, c as MCP_TTL_MS, ct as trackAgentMemory, d as isMcpTool, dt as validateSolidGate, f as queryOf, ft as checkFileSize, g as gate, gt as injectRules, h as TRIVIAL_BUDGET, ht as solidDetectStart, i as respond, it as cleanupSession, j as trackSkillRead, jt as projectHash, k as trackWatchResearch, kt as taskContext, l as WEBFETCH_TTL_MS, lt as subagentCacheContext, m as REQUIRED_AGENTS, mt as detectSolidProfile, n as activityFor, nt as trackSessionChanges, o as mcpPostStore, ot as logToolFailure, p as DEFAULT_WINDOW_MS, pt as countLoc, q as listChildren, r as handlePre, rt as validateRulesLoaded, s as mcpPreIntercept, st as validateTeammateOutput, t as handleHook, tt as postEditTypescript, u as cacheQueryOf, ut as validateTailwind, v as detectDuplication, vt as runSessionStartCleanups, w as seoPostToolUseResponse, wt as devContext, x as lifecycleStdout, xt as purgeTtlTree, y as dryGate, yt as sessionStartCore, z as writePluginMap, zt as todayUtc } from "../handle-Dthtlp7Z.mjs";
 //#region src/runtime/storage.ts
 /**
 * The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,

package/dist/{validate-DnLU4IHy.mjs → validate-DhOX5hDK.mjs}

@@ -1,5 +1,5 @@
 import { r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
-import { c as ttlLabel } from "./dotenv-Jj8aL1FL.mjs";
+import { c as ttlLabel, t as HOME_DIR } from "./dotenv-Jj8aL1FL.mjs";
 import { R as DEV_KEYWORDS, g as moduleAwarePath } from "./evaluate-ClfbCDiY.mjs";
 import { d as countFrameworkCodeLines, l as PLUGINS_DIR, u as SOLID_REF } from "./home-state-BXf38Zi1.mjs";
 import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-CWZegVdR.mjs";
@@ -1187,9 +1187,48 @@ function getExpertAgent(type, pluginsDirOverride) {
 	return "general-purpose";
 }
 //#endregion
-//#region src/policy/claude-md-context.ts
-/** Dev-verb regex (FR/EN) that triggers the APEX preamble (case-insensitive). */
-const DEV_VERBS = /(cr[ée]er|impl[ée]menter|ajouter|d[ée]velopper|construire|build|refactor|migrer|implement|create|add|develop)/i;
+//#region src/policy/apex-target.ts
+/**
+* Harness-target helpers for the APEX context builders. Single source of
+* truth for the home-dir segment / root doc name / plan-tool idiom that
+* differ between Claude Code and Codex (and beyond), so the builders in
+* `claude-md-context.ts`, `apex-task-context.ts`, and `inject-apex.ts` never
+* hardcode `.claude`/`CLAUDE.md`/`TaskCreate` again. Runtime `id` values flow
+* through the pipeline as plain `string` (see `handleHook(id: string, ...)`),
+* so these helpers accept `string` and narrow internally — same idiom as the
+* existing `HOME_DIR[id] ?? ".claude"` precedent in `cartographer/detect.ts`.
+*/
+/**
+* Home-dir segment for a harness target (".claude", ".codex", ...). Falls
+* back to ".claude" for any harness without a {@link HOME_DIR} entry.
+* @param id - Harness id (e.g. "claude-code", "codex").
+* @returns The home-dir segment, e.g. ".claude".
+*/
+function harnessHomeSegment(id) {
+	return HOME_DIR[id] ?? ".claude";
+}
+/**
+* Root instructions doc name for a harness target: "AGENTS.md" for Codex,
+* "CLAUDE.md" for every other target (including the default/unknown fallback).
+* @param id - Harness id.
+* @returns The doc file name.
+*/
+function apexDocName(id) {
+	return id === "codex" ? "AGENTS.md" : "CLAUDE.md";
+}
+/**
+* Native plan/track tool name for a harness target: Codex's `update_plan` vs
+* Claude's `TaskCreate`. Covers only the PLAN-step line — other Claude-only
+* tool references (`TaskList`, `TaskUpdate`) are branched inline by the
+* builders since their surrounding prose differs structurally, not just by token.
+* @param id - Harness id.
+* @returns The plan-tool name.
+*/
+function apexPlanTool(id) {
+	return id === "codex" ? "update_plan" : "TaskCreate";
+}
+//#endregion
+//#region src/policy/detect-claude-md-project-type.ts
 /**
 * Detect the project type from the cwd, reproducing the legacy Python logic:
 * package.json containing "next" → nextjs, else "react" → react; else
@@ -1212,31 +1251,35 @@ function detectClaudeMdProjectType(cwd) {
 	} catch {}
 	return "generic";
 }
+//#endregion
+//#region src/policy/claude-md-context.ts
+/** Dev-verb regex (FR/EN) that triggers the APEX preamble (case-insensitive). */
+const DEV_VERBS = /(cr[ée]er|impl[ée]menter|ajouter|d[ée]velopper|construire|build|refactor|migrer|implement|create|add|develop)/i;
 /**
 * Build the APEX instruction preamble for a development task.
 * @param projectType - Detected project type label.
 * @param maxLines - SOLID per-file line ceiling.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The APEX instruction text.
 */
-function buildApexInstruction(projectType, maxLines) {
+function buildApexInstruction(projectType, maxLines, id = "claude-code") {
 	const expertAgent = getExpertAgent(projectType);
-	return `INSTRUCTION: This is a development task. Use APEX methodology:
-
-**TRACKING FILE**: [project]/.claude/apex/task.json — create it yourself via apex-methodology Step 0 (init-tracking) if missing
-
-1. **ANALYZE** (MANDATORY - 3 AGENTS IN PARALLEL):
-   - explore-codebase + research-expert + ${expertAgent} (framework expertise)\n   - Project type detected: ${projectType}\n\n2. **PLAN**: Use TaskCreate to break down tasks (<${maxLines} lines per file)\n\n3. **EXECUTE**: ${expertAgent}, follow SOLID principles, split at ${maxLines - 10} lines\n\n4. **eLICIT**: self-review with NAMED elicitation techniques (apex ref 03.5-elicit) — fix findings BEFORE validation\n\n5. **VERIFY**: functional check — run it, confirm references⇔declarations consistency\n\n6. **eXAMINE**: Run sniper agent after ANY modification\n\n**GATE**: eLicit + Verify BEFORE sniper — NEVER skip.\n\n**IMPORTANT**: Read .claude/apex/task.json to check documentation status before writing code.`;
+	const seg = harnessHomeSegment(id);
+	return `INSTRUCTION: This is a development task. Use APEX methodology:\n\n**TRACKING FILE**: [project]/${seg}/apex/task.json — create it yourself via apex-methodology Step 0 (init-tracking) if missing\n\n1. **ANALYZE** (MANDATORY - 3 AGENTS IN PARALLEL):\n   - explore-codebase + research-expert + ${expertAgent} (framework expertise)\n   - Project type detected: ${projectType}\n\n2. **PLAN**: Use ${apexPlanTool(id)} to break down tasks (<${maxLines} lines per file)\n\n3. **EXECUTE**: ${expertAgent}, follow SOLID principles, split at ${maxLines - 10} lines\n\n4. **eLICIT**: self-review with NAMED elicitation techniques (apex ref 03.5-elicit) — fix findings BEFORE validation\n\n5. **VERIFY**: functional check — run it, confirm references⇔declarations consistency\n\n6. **eXAMINE**: Run sniper agent after ANY modification\n\n**GATE**: eLicit + Verify BEFORE sniper — NEVER skip.\n\n**IMPORTANT**: Read ${seg}/apex/task.json to check documentation status before writing code.`;
 }
 /**
-* Build the UserPromptSubmit injection text: read `~/.claude/CLAUDE.md` and,
+* Build the UserPromptSubmit injection text: read the target's root
+* instructions doc (`~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, ...) and,
 * when the prompt matches a dev verb, prepend the APEX instruction. Returns
-* `null` when CLAUDE.md is absent/unreadable (the hook then emits nothing).
+* `null` when the doc is absent/unreadable (the hook then emits nothing).
 * @param prompt - The raw user prompt.
 * @param cwd - Project root (for project-type detection).
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The injection text, or `null` to emit nothing.
 */
-function buildClaudeMdContext(prompt, cwd) {
-	const claudeMd = join(homedir(), ".claude", "CLAUDE.md");
+function buildClaudeMdContext(prompt, cwd, id = "claude-code") {
+	const docName = apexDocName(id);
+	const claudeMd = join(homedir(), harnessHomeSegment(id), docName);
 	if (!existsSync(claudeMd)) return null;
 	let claudeContent;
 	try {
@@ -1244,8 +1287,8 @@ function buildClaudeMdContext(prompt, cwd) {
 	} catch {
 		return null;
 	}
-	if (!DEV_VERBS.test(prompt) && !DEV_KEYWORDS.test(prompt)) return `# CLAUDE.md\n${claudeContent}`;
-	return `${buildApexInstruction(detectClaudeMdProjectType(cwd), resolveMaxLines())}\n\n# CLAUDE.md\n${claudeContent}`;
+	if (!DEV_VERBS.test(prompt) && !DEV_KEYWORDS.test(prompt)) return `# ${docName}\n${claudeContent}`;
+	return `${buildApexInstruction(detectClaudeMdProjectType(cwd), resolveMaxLines(), id)}\n\n# ${docName}\n${claudeContent}`;
 }
 //#endregion
 //#region src/policy/apex-task-context.ts
@@ -1282,21 +1325,29 @@ function loadApexTaskState(taskFile) {
 * Build the APEX context string injected into a Task sub-agent prompt.
 * @param state - The parsed task state.
 * @param maxLines - SOLID per-file line ceiling.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The injection text.
 */
-function buildApexTaskContext(state, maxLines) {
-	return `⚠️ APEX MODE - Read .claude/apex/AGENTS.md for rules\n\nCurrent: Task #${state.id} - ${state.subject} (Phase: ${state.phase})\nDocs consulted: ${state.docs}\n\nAgent must:\n1. Read task.json → find last 3 completed tasks\n2. Read their notes in docs/ (task-{ID}-{subject}.md)\n3. TaskList → see pending tasks\n4. TaskUpdate(in_progress) → before starting\n5. Apply SOLID (files < ${maxLines} lines)\n6. Write notes to docs/task-{ID}-{subject}.md\n7. TaskUpdate(completed) → triggers auto-commit`;
+function buildApexTaskContext(state, maxLines, id = "claude-code") {
+	const seg = harnessHomeSegment(id);
+	const isCodex = id === "codex";
+	const step3 = isCodex ? "update_plan → review the current plan" : "TaskList → see pending tasks";
+	const step4 = isCodex ? "update_plan → mark the active step in_progress before starting" : "TaskUpdate(in_progress) → before starting";
+	const step7 = isCodex ? "update_plan → mark the step completed when done" : "TaskUpdate(completed) → triggers auto-commit";
+	return `⚠️ APEX MODE - Read ${seg}/apex/AGENTS.md for rules\n\nCurrent: Task #${state.id} - ${state.subject} (Phase: ${state.phase})\nDocs consulted: ${state.docs}\n\nAgent must:\n1. Read task.json → find last 3 completed tasks\n2. Read their notes in docs/ (task-{ID}-{subject}.md)\n3. ${step3}\n4. ${step4}\n5. Apply SOLID (files < ${maxLines} lines)\n6. Write notes to docs/task-{ID}-{subject}.md\n7. ${step7}`;
 }
 /**
-* Build the PreToolUse Task injection, gated on the existence of the project's
-* `.claude/apex/` directory. Returns `null` when APEX is not active (no dir).
+* Build the PreToolUse Task injection, gated on the existence of the
+* project's target apex dir (`.claude/apex/`, `.codex/apex/`, ...). Returns
+* `null` when APEX is not active (no dir).
 * @param projectRoot - `CLAUDE_PROJECT_DIR` or cwd.
+* @param id - Harness target id (defaults to "claude-code" — zero-regression default).
 * @returns The injection text, or `null` to emit nothing.
 */
-function buildApexTaskInjection(projectRoot) {
-	const apexDir = join(projectRoot, ".claude", "apex");
+function buildApexTaskInjection(projectRoot, id = "claude-code") {
+	const apexDir = join(projectRoot, harnessHomeSegment(id), "apex");
 	if (!existsSync(apexDir)) return null;
-	return buildApexTaskContext(loadApexTaskState(join(apexDir, "task.json")), resolveMaxLines());
+	return buildApexTaskContext(loadApexTaskState(join(apexDir, "task.json")), resolveMaxLines(), id);
 }
 //#endregion
 //#region src/policy/cartographer/indicators.ts
@@ -1540,4 +1591,4 @@ function missingSeoElements(html) {
 	return missing;
 }
 //#endregion
-export { detectCreationIntent as A, SKILL_TRIGGERS as C, MAX_EXA_RESULTS as D, isExcludedSwiftPath as E, docConsultedGate as F, evaluateApex as I, freshnessGate as L, POST_AUTH_GATES as M, PRE_AUTH_GATES as N, MAX_TOKENS as O, brainstormGate as P, solidReadGate as R, usesTailwindUtilities as S, isExcludedJsPath as T, scanPlugin as _, firstHeading as a, detectRequiredSkills as b, EXCLUDE_DIRS as c, buildApexTaskInjection as d, loadApexTaskState as f, detectClaudeMdProjectType as g, buildClaudeMdContext as h, firstComment as i, APEX_GATES as j, capVerbosity as k, PROJECT_INDICATORS as l, buildApexInstruction as m, missingSeoElements as n, parseEnrichment as o, DEV_VERBS as p, descFromText as r, parseEntry as s, isHtmlLike as t, buildApexTaskContext as u, parseBodyDesc as v, frameworkSolidGate as w, skillTriggerGate as x, parseField as y };
+export { capVerbosity as A, usesTailwindUtilities as C, isExcludedSwiftPath as D, isExcludedJsPath as E, brainstormGate as F, docConsultedGate as I, evaluateApex as L, APEX_GATES as M, POST_AUTH_GATES as N, MAX_EXA_RESULTS as O, PRE_AUTH_GATES as P, freshnessGate as R, skillTriggerGate as S, frameworkSolidGate as T, harnessHomeSegment as _, firstHeading as a, parseField as b, EXCLUDE_DIRS as c, buildApexTaskInjection as d, loadApexTaskState as f, detectClaudeMdProjectType as g, buildClaudeMdContext as h, firstComment as i, detectCreationIntent as j, MAX_TOKENS as k, PROJECT_INDICATORS as l, buildApexInstruction as m, missingSeoElements as n, parseEnrichment as o, DEV_VERBS as p, descFromText as r, parseEntry as s, isHtmlLike as t, buildApexTaskContext as u, scanPlugin as v, SKILL_TRIGGERS as w, detectRequiredSkills as x, parseBodyDesc as y, solidReadGate as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.77",
+  "version": "0.1.78",
   "description": "Harness-agnostic toolkit for AI coding agents: runtime harness detection (Claude Code, Codex, Cursor, Cline, Gemini, Aider...), pure policy core (env config, project/framework detection, SOLID/file-size limits, APEX freshness, guard patterns, portable prompts), cache, project memory, ref routing, state/locks, statusline, per-harness adapters (Claude/Cursor/Cline/Gemini) and a cli-mode harness-check binary. Bun-native, with a built dist for Node + bundlers.",
   "type": "module",
   "module": "src/index.ts",