@fusengine/harness 0.1.77 → 0.1.79

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,