@fusengine/harness 0.1.77 → 0.1.79

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.79",
   "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",