@fusengine/harness 0.1.2 → 0.1.3

package/dist/{freshness-DzGoBKKj.mjs → doc-helpers-Dd_x1-tZ.mjs}

@@ -1,5 +1,3 @@
-import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-RH82El2J.mjs";
-import { dirname } from "node:path";
 //#region src/freshness/doc-helpers.ts
 /** Resolve the sessions array from an auth entry (legacy fallback). */
 function resolveSessions(auth) {
@@ -41,24 +39,4 @@ function formatDocDeny(framework) {
 	].join("\n");
 }
 //#endregion
-//#region src/freshness/trivial-edit-counter.ts
-/**
-* Increment a session's trivial-edit counter, evicting timestamps older than
-* `windowMs`. Decoupled + injectable `now` for testability.
-* @param filePath - session state file path
-* @param windowMs - sliding window in ms
-* @param now - current epoch ms (defaults to `Date.now()`)
-* @returns number of trivial edits within the window (including this one)
-*/
-async function incrementTrivialEditCounter(filePath, windowMs, now = Date.now()) {
-	await ensureDir(dirname(filePath));
-	const state = await readJsonFile(filePath) ?? {};
-	const cutoff = now - windowMs;
-	const edits = (state.trivial_edits ?? []).filter((ts) => ts > cutoff);
-	edits.push(now);
-	state.trivial_edits = edits;
-	await writeJsonFile(filePath, state);
-	return edits.length;
-}
-//#endregion
-export { resolveSessions as a, isDocConsulted as i, formatDocDeny as n, formatDocSatisfactionStatus as r, incrementTrivialEditCounter as t };
+export { resolveSessions as i, formatDocSatisfactionStatus as n, isDocConsulted as r, formatDocDeny as t };

package/dist/freshness/index.mjs

@@ -1,2 +1,3 @@
-import { a as resolveSessions, i as isDocConsulted, n as formatDocDeny, r as formatDocSatisfactionStatus, t as incrementTrivialEditCounter } from "../freshness-DzGoBKKj.mjs";
+import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "../doc-helpers-Dd_x1-tZ.mjs";
+import { t as incrementTrivialEditCounter } from "../freshness-BK9Xg6oG.mjs";
 export { formatDocDeny, formatDocSatisfactionStatus, incrementTrivialEditCounter, isDocConsulted, resolveSessions };

package/dist/freshness-BK9Xg6oG.mjs

@@ -0,0 +1,23 @@
+import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-RH82El2J.mjs";
+import { dirname } from "node:path";
+//#region src/freshness/trivial-edit-counter.ts
+/**
+* Increment a session's trivial-edit counter, evicting timestamps older than
+* `windowMs`. Decoupled + injectable `now` for testability.
+* @param filePath - session state file path
+* @param windowMs - sliding window in ms
+* @param now - current epoch ms (defaults to `Date.now()`)
+* @returns number of trivial edits within the window (including this one)
+*/
+async function incrementTrivialEditCounter(filePath, windowMs, now = Date.now()) {
+	await ensureDir(dirname(filePath));
+	const state = await readJsonFile(filePath) ?? {};
+	const cutoff = now - windowMs;
+	const edits = (state.trivial_edits ?? []).filter((ts) => ts > cutoff);
+	edits.push(now);
+	state.trivial_edits = edits;
+	await writeJsonFile(filePath, state);
+	return edits.length;
+}
+//#endregion
+export { incrementTrivialEditCounter as t };

package/dist/{index-D7MkQNdc.d.mts → index-BXBWKbL8.d.mts}

@@ -1,4 +1,6 @@
 import { t as Prompt } from "./types-D56jSgD9.mjs";
+import { t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
+import { t as RefMeta } from "./types-CY5qT2X1.mjs";
 
 //#region src/policy/detect-project.d.ts
 /** Project types detected from filesystem indicators. */
@@ -77,4 +79,36 @@ interface PolicyResult {
 */
 declare function evaluate(ctx: PolicyContext): PolicyResult;
 //#endregion
-export { GIT_BLOCKED as a, matchPatterns as c, evaluateFileSize as d, detectFramework as f, isApexCommand as g, detectProjectType as h, GIT_ASK as i, FileSizeVerdict as l, ProjectType as m, PolicyResult as n, PROJECT_INSTALL as o, DEV_KEYWORDS as p, evaluate as r, SYSTEM_INSTALL as s, PolicyContext as t, countLines as u };
+//#region src/policy/apex.d.ts
+/**
+* Session context for the stateful APEX gates. The harness adapter supplies this
+* (the package owns the gate LOGIC; recording the session activity is the
+* adapter's tracking layer).
+*/
+interface ApexContext {
+  sessionId: string;
+  framework: string;
+  filePath: string;
+  content: string;
+  /** Doc-consultation authorizations from session state (Context7/Exa). */
+  authorizations?: Record<string, AuthEntry>;
+  /** Available SOLID references for the framework's skill. */
+  refs?: RefMeta[];
+  /** Absolute paths of SOLID refs already read this session. */
+  refsRead?: string[];
+}
+/** A single APEX gate: returns a blocking {@link Prompt}, or null to pass. */
+type ApexGate = (ctx: ApexContext) => Prompt | null;
+/** Gate: Context7 + Exa must have been consulted this session. */
+declare const docConsultedGate: ApexGate;
+/** Gate: the routed SOLID references for this edit must have been read. */
+declare const solidReadGate: ApexGate;
+/** Default APEX gate chain. */
+declare const APEX_GATES: ReadonlyArray<ApexGate>;
+/**
+* Run the APEX gates (chain-of-responsibility): the first failing gate's prompt
+* wins; null means every gate passed (allow).
+*/
+declare function evaluateApex(ctx: ApexContext, gates?: ReadonlyArray<ApexGate>): Prompt | null;
+//#endregion
+export { isApexCommand as S, evaluateFileSize as _, evaluateApex as a, ProjectType as b, PolicyResult as c, GIT_BLOCKED as d, PROJECT_INSTALL as f, countLines as g, FileSizeVerdict as h, docConsultedGate as i, evaluate as l, matchPatterns as m, ApexContext as n, solidReadGate as o, SYSTEM_INSTALL as p, ApexGate as r, PolicyContext as s, APEX_GATES as t, GIT_ASK as u, detectFramework as v, detectProjectType as x, DEV_KEYWORDS as y };

package/dist/{index-DqNKW8Ki.d.mts → index-C2Lz-cwJ.d.mts}

@@ -1,28 +1,5 @@
-//#region src/refs/types.d.ts
-/** Parsed frontmatter metadata from a reference .md file. */
-interface RefMeta {
-  name: string;
-  description: string;
-  keywords: string;
-  priority: string;
-  related: string;
-  appliesTo: string;
-  triggerOnEdit: string;
-  level: string;
-  filePath: string;
-}
-/** A reference with its computed routing score. */
-interface ScoredRef {
-  meta: RefMeta;
-  score: number;
-}
-/** Routing result with categorized references. */
-interface RouteResult {
-  required: ScoredRef[];
-  optional: ScoredRef[];
-  skillPath: string;
-}
-//#endregion
+import { n as RouteResult, r as ScoredRef, t as RefMeta } from "./types-CY5qT2X1.mjs";
+
 //#region src/refs/frontmatter.d.ts
 /** Extract frontmatter key/value pairs from markdown content (quotes stripped). */
 declare function parseFrontmatter(content: string): Record<string, string>;
@@ -41,4 +18,4 @@ declare function scoreReferences(refs: RefMeta[], filePath: string, content: str
 */
 declare function routeReferences(refs: RefMeta[], filePath: string, content: string, skillPath?: string): RouteResult | null;
 //#endregion
-export { RefMeta as a, parseFrontmatter as i, scoreReferences as n, RouteResult as o, globToRe as r, ScoredRef as s, routeReferences as t };
+export { parseFrontmatter as i, scoreReferences as n, globToRe as r, routeReferences as t };

package/dist/index.d.mts

@@ -5,9 +5,10 @@ import { a as detectHarness, i as HarnessVia, n as HarnessInfo, o as detectMode,
 import { a as isDocConsulted, i as formatDocSatisfactionStatus, n as DocSatisfactionStatus, o as resolveSessions, r as formatDocDeny, t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
 import { t as incrementTrivialEditCounter } from "./index-BOBXQ91y.mjs";
 import { i as compactJson, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./index-C1vLIMwN.mjs";
-import { a as GIT_BLOCKED, c as matchPatterns, d as evaluateFileSize, f as detectFramework, g as isApexCommand, h as detectProjectType, i as GIT_ASK, l as FileSizeVerdict, m as ProjectType, n as PolicyResult, o as PROJECT_INSTALL, p as DEV_KEYWORDS, r as evaluate, s as SYSTEM_INSTALL, t as PolicyContext, u as countLines } from "./index-D7MkQNdc.mjs";
+import { S as isApexCommand, _ as evaluateFileSize, a as evaluateApex, b as ProjectType, c as PolicyResult, d as GIT_BLOCKED, f as PROJECT_INSTALL, g as countLines, h as FileSizeVerdict, i as docConsultedGate, l as evaluate, m as matchPatterns, n as ApexContext, o as solidReadGate, p as SYSTEM_INSTALL, r as ApexGate, s as PolicyContext, t as APEX_GATES, u as GIT_ASK, v as detectFramework, x as detectProjectType, y as DEV_KEYWORDS } from "./index-BXBWKbL8.mjs";
+import { n as RouteResult, r as ScoredRef, t as RefMeta } from "./types-CY5qT2X1.mjs";
 import { a as ReminderState, c as setStateField, i as registryFile, l as stateFileFor, n as addRoot, o as nowStamp, r as readRoots, s as readState, t as ensureMemoryGitignore, u as throttleMs } from "./index-BEM-mQMC.mjs";
-import { a as RefMeta, i as parseFrontmatter, n as scoreReferences, o as RouteResult, r as globToRe, s as ScoredRef, t as routeReferences } from "./index-DqNKW8Ki.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./index-C2Lz-cwJ.mjs";
 import { a as taskStart, c as ensureStateDir, d as stateFilePath, f as acquireLock, i as taskCreate, l as loadState, n as ApexTaskFile, o as ApexState, r as taskComplete, s as apexStateDir, t as ApexTask, u as saveState } from "./index-CPoF_hLP.mjs";
 import { _ as TIME_INTERVALS, a as formatCost, c as formatTokens, d as colors, f as progressiveColor, g as PROGRESS_CHARS, h as PROGRESS_BAR_DEFAULTS, i as formatBasename, l as ColorFn, m as GRADIENT_BLOCKS, n as generateGradientBar, o as formatPath, p as COLOR_THRESHOLDS, r as generateProgressBar, s as formatTimeLeft, t as ProgressBarOptions, u as Palette } from "./index-BWK8slRi.mjs";
-export { ApexState, ApexTask, ApexTaskFile, AuthEntry, COLOR_THRESHOLDS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };
+export { APEX_GATES, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, AuthEntry, COLOR_THRESHOLDS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };

package/dist/index.mjs

@@ -3,13 +3,14 @@ import { i as ttlLabel, n as TTL_ENV_KEY, r as resolveTtlSec, t as DEFAULT_TTL_S
 import { t as compactJson } from "./compact-json-DK2nX-MK.mjs";
 import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-C4ks_q1G.mjs";
 import { n as detectMode, r as modeFor, t as detectHarness } from "./harness-C8Nxxyn_.mjs";
-import { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "./policy-C_pXmeNB.mjs";
+import { a as DEV_KEYWORDS, i as solidReadGate, n as docConsultedGate, o as detectProjectType, r as evaluateApex, s as isApexCommand, t as APEX_GATES } from "./policy-DMpyaPZ_.mjs";
 import { a as SYSTEM_INSTALL, c as evaluateFileSize, i as PROJECT_INSTALL, l as detectFramework, n as GIT_ASK, o as matchPatterns, r as GIT_BLOCKED, s as countLines, t as evaluate } from "./evaluate-CsYyUucy.mjs";
+import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./router-Dj3AfgBE.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as readState, c as throttleMs, i as nowStamp, l as ensureMemoryGitignore, n as readRoots, o as setStateField, r as registryFile, s as stateFileFor, t as addRoot } from "./memory-BVNt4Ary.mjs";
 import { a as jaccardSimilar, i as compactMarkdown, n as loadIndex, o as queryHash, r as summarizeIndex, t as extractText } from "./cache-DbPSJ9bC.mjs";
-import { a as resolveSessions, i as isDocConsulted, n as formatDocDeny, r as formatDocSatisfactionStatus, t as incrementTrivialEditCounter } from "./freshness-DzGoBKKj.mjs";
-import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./refs-Dj3AfgBE.mjs";
+import { t as incrementTrivialEditCounter } from "./freshness-BK9Xg6oG.mjs";
 import { a as ensureStateDir, c as stateFilePath, i as apexStateDir, l as acquireLock, n as taskCreate, o as loadState, r as taskStart, s as saveState, t as taskComplete } from "./state-Bc4wdnCG.mjs";
 import { a as formatPath, c as colors, d as GRADIENT_BLOCKS, f as PROGRESS_BAR_DEFAULTS, i as formatCost, l as progressiveColor, m as TIME_INTERVALS, n as generateProgressBar, o as formatTimeLeft, p as PROGRESS_CHARS, r as formatBasename, s as formatTokens, t as generateGradientBar, u as COLOR_THRESHOLDS } from "./statusline-D87eUNXl.mjs";
-export { COLOR_THRESHOLDS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, SYSTEM_INSTALL, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };
+export { APEX_GATES, COLOR_THRESHOLDS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, SYSTEM_INSTALL, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };

package/dist/policy/index.d.mts

@@ -1,2 +1,2 @@
-import { a as GIT_BLOCKED, c as matchPatterns, d as evaluateFileSize, f as detectFramework, g as isApexCommand, h as detectProjectType, i as GIT_ASK, l as FileSizeVerdict, m as ProjectType, n as PolicyResult, o as PROJECT_INSTALL, p as DEV_KEYWORDS, r as evaluate, s as SYSTEM_INSTALL, t as PolicyContext, u as countLines } from "../index-D7MkQNdc.mjs";
-export { DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, PolicyContext, PolicyResult, ProjectType, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, evaluate, evaluateFileSize, isApexCommand, matchPatterns };
+import { S as isApexCommand, _ as evaluateFileSize, a as evaluateApex, b as ProjectType, c as PolicyResult, d as GIT_BLOCKED, f as PROJECT_INSTALL, g as countLines, h as FileSizeVerdict, i as docConsultedGate, l as evaluate, m as matchPatterns, n as ApexContext, o as solidReadGate, p as SYSTEM_INSTALL, r as ApexGate, s as PolicyContext, t as APEX_GATES, u as GIT_ASK, v as detectFramework, x as detectProjectType, y as DEV_KEYWORDS } from "../index-BXBWKbL8.mjs";
+export { APEX_GATES, ApexContext, ApexGate, DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, PolicyContext, PolicyResult, ProjectType, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, isApexCommand, matchPatterns, solidReadGate };

package/dist/policy/index.mjs

@@ -1,3 +1,3 @@
-import { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "../policy-C_pXmeNB.mjs";
+import { a as DEV_KEYWORDS, i as solidReadGate, n as docConsultedGate, o as detectProjectType, r as evaluateApex, s as isApexCommand, t as APEX_GATES } from "../policy-DMpyaPZ_.mjs";
 import { a as SYSTEM_INSTALL, c as evaluateFileSize, i as PROJECT_INSTALL, l as detectFramework, n as GIT_ASK, o as matchPatterns, r as GIT_BLOCKED, s as countLines, t as evaluate } from "../evaluate-CsYyUucy.mjs";
-export { DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, evaluate, evaluateFileSize, isApexCommand, matchPatterns };
+export { APEX_GATES, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, isApexCommand, matchPatterns, solidReadGate };

package/dist/{policy-C_pXmeNB.mjs → policy-DMpyaPZ_.mjs}

@@ -1,3 +1,5 @@
+import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
+import { t as routeReferences } from "./router-Dj3AfgBE.mjs";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
 //#region src/policy/detect-project.ts
@@ -30,4 +32,37 @@ function detectProjectType(dir) {
 	return "generic";
 }
 //#endregion
-export { detectProjectType as n, isApexCommand as r, DEV_KEYWORDS as t };
+//#region src/policy/apex.ts
+/** Gate: Context7 + Exa must have been consulted this session. */
+const docConsultedGate = (ctx) => isDocConsulted(ctx.authorizations, ctx.sessionId) ? null : {
+	kind: "block",
+	title: "APEX: documentation not consulted",
+	reason: formatDocDeny(ctx.framework),
+	actions: ["Call mcp__context7__query-docs", "Call mcp__exa__web_search_exa"]
+};
+/** Gate: the routed SOLID references for this edit must have been read. */
+const solidReadGate = (ctx) => {
+	if (!ctx.refs?.length) return null;
+	const routed = routeReferences(ctx.refs, ctx.filePath, ctx.content);
+	if (!routed) return null;
+	const read = new Set(ctx.refsRead ?? []);
+	const missing = routed.required.map((r) => r.meta.filePath).filter((p) => !read.has(p));
+	if (missing.length === 0) return null;
+	return {
+		kind: "block",
+		title: `APEX: read SOLID references for ${ctx.framework}`,
+		reason: `Read these before editing ${ctx.filePath}:`,
+		actions: missing
+	};
+};
+/** Default APEX gate chain. */
+const APEX_GATES = [docConsultedGate, solidReadGate];
+/**
+* Run the APEX gates (chain-of-responsibility): the first failing gate's prompt
+* wins; null means every gate passed (allow).
+*/
+function evaluateApex(ctx, gates = APEX_GATES) {
+	return gates.reduce((hit, gate) => hit ?? gate(ctx), null);
+}
+//#endregion
+export { DEV_KEYWORDS as a, solidReadGate as i, docConsultedGate as n, detectProjectType as o, evaluateApex as r, isApexCommand as s, APEX_GATES as t };

package/dist/refs/index.d.mts

@@ -1,2 +1,3 @@
-import { a as RefMeta, i as parseFrontmatter, n as scoreReferences, o as RouteResult, r as globToRe, s as ScoredRef, t as routeReferences } from "../index-DqNKW8Ki.mjs";
+import { n as RouteResult, r as ScoredRef, t as RefMeta } from "../types-CY5qT2X1.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "../index-C2Lz-cwJ.mjs";
 export { RefMeta, RouteResult, ScoredRef, globToRe, parseFrontmatter, routeReferences, scoreReferences };

package/dist/refs/index.mjs

@@ -1,2 +1,3 @@
-import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "../refs-Dj3AfgBE.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "../router-Dj3AfgBE.mjs";
+import "../refs-la_KkjCS.mjs";
 export { globToRe, parseFrontmatter, routeReferences, scoreReferences };

package/dist/refs-la_KkjCS.mjs

@@ -0,0 +1 @@
+export {};

package/dist/types-CY5qT2X1.d.mts

@@ -0,0 +1,26 @@
+//#region src/refs/types.d.ts
+/** Parsed frontmatter metadata from a reference .md file. */
+interface RefMeta {
+  name: string;
+  description: string;
+  keywords: string;
+  priority: string;
+  related: string;
+  appliesTo: string;
+  triggerOnEdit: string;
+  level: string;
+  filePath: string;
+}
+/** A reference with its computed routing score. */
+interface ScoredRef {
+  meta: RefMeta;
+  score: number;
+}
+/** Routing result with categorized references. */
+interface RouteResult {
+  required: ScoredRef[];
+  optional: ScoredRef[];
+  skillPath: string;
+}
+//#endregion
+export { RouteResult as n, ScoredRef as r, RefMeta as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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",