@fusengine/harness 0.1.3 → 0.1.5

package/dist/apex-gGrHzvM2.mjs

@@ -0,0 +1,47 @@
+import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
+import { t as routeReferences } from "./router-Dj3AfgBE.mjs";
+//#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
+	};
+};
+/** Gate: the required prior agents (explore + research) must have run within the window. */
+const freshnessGate = (ctx) => ctx.agentsFresh === false ? {
+	kind: "block",
+	title: "APEX: explore + research required",
+	reason: `Run explore-codebase and research-expert (within the freshness window) before editing ${ctx.framework}.`,
+	actions: ["Launch the explore-codebase agent", "Launch the research-expert agent"]
+} : null;
+/** Default APEX gate chain (freshness, then docs, then SOLID refs). */
+const APEX_GATES = [
+	freshnessGate,
+	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 { solidReadGate as a, freshnessGate as i, docConsultedGate as n, evaluateApex as r, APEX_GATES as t };

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

@@ -96,6 +96,8 @@ interface ApexContext {
   refs?: RefMeta[];
   /** Absolute paths of SOLID refs already read this session. */
   refsRead?: string[];
+  /** Whether the required prior agents (explore + research) ran within the freshness window. */
+  agentsFresh?: boolean;
 }
 /** A single APEX gate: returns a blocking {@link Prompt}, or null to pass. */
 type ApexGate = (ctx: ApexContext) => Prompt | null;
@@ -103,7 +105,9 @@ type ApexGate = (ctx: ApexContext) => Prompt | null;
 declare const docConsultedGate: ApexGate;
 /** Gate: the routed SOLID references for this edit must have been read. */
 declare const solidReadGate: ApexGate;
-/** Default APEX gate chain. */
+/** Gate: the required prior agents (explore + research) must have run within the window. */
+declare const freshnessGate: ApexGate;
+/** Default APEX gate chain (freshness, then docs, then SOLID refs). */
 declare const APEX_GATES: ReadonlyArray<ApexGate>;
 /**
 * Run the APEX gates (chain-of-responsibility): the first failing gate's prompt
@@ -111,4 +115,4 @@ declare const APEX_GATES: ReadonlyArray<ApexGate>;
 */
 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 };
+export { isApexCommand as C, detectProjectType as S, countLines as _, evaluateApex as a, DEV_KEYWORDS as b, PolicyContext as c, GIT_ASK as d, GIT_BLOCKED as f, FileSizeVerdict as g, matchPatterns as h, docConsultedGate as i, PolicyResult as l, SYSTEM_INSTALL as m, ApexContext as n, freshnessGate as o, PROJECT_INSTALL as p, ApexGate as r, solidReadGate as s, APEX_GATES as t, evaluate as u, evaluateFileSize as v, ProjectType as x, detectFramework as y };

package/dist/index.d.mts

@@ -5,10 +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 { 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 { C as isApexCommand, S as detectProjectType, _ as countLines, a as evaluateApex, b as DEV_KEYWORDS, c as PolicyContext, d as GIT_ASK, f as GIT_BLOCKED, g as FileSizeVerdict, h as matchPatterns, i as docConsultedGate, l as PolicyResult, m as SYSTEM_INSTALL, n as ApexContext, o as freshnessGate, p as PROJECT_INSTALL, r as ApexGate, s as solidReadGate, t as APEX_GATES, u as evaluate, v as evaluateFileSize, x as ProjectType, y as detectFramework } from "./index-BbJucvaG.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 { 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 { 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 };
+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, freshnessGate, 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,14 +3,15 @@ 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 { 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 { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "./policy-C_pXmeNB.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 { a as solidReadGate, i as freshnessGate, n as docConsultedGate, r as evaluateApex, t as APEX_GATES } from "./apex-gGrHzvM2.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 { 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 { 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 };
+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, freshnessGate, 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 { 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 };
+import { C as isApexCommand, S as detectProjectType, _ as countLines, a as evaluateApex, b as DEV_KEYWORDS, c as PolicyContext, d as GIT_ASK, f as GIT_BLOCKED, g as FileSizeVerdict, h as matchPatterns, i as docConsultedGate, l as PolicyResult, m as SYSTEM_INSTALL, n as ApexContext, o as freshnessGate, p as PROJECT_INSTALL, r as ApexGate, s as solidReadGate, t as APEX_GATES, u as evaluate, v as evaluateFileSize, x as ProjectType, y as detectFramework } from "../index-BbJucvaG.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, freshnessGate, isApexCommand, matchPatterns, solidReadGate };

package/dist/policy/index.mjs

@@ -1,3 +1,4 @@
-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 { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "../policy-C_pXmeNB.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 { APEX_GATES, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, isApexCommand, matchPatterns, solidReadGate };
+import { a as solidReadGate, i as freshnessGate, n as docConsultedGate, r as evaluateApex, t as APEX_GATES } from "../apex-gGrHzvM2.mjs";
+export { APEX_GATES, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, isApexCommand, matchPatterns, solidReadGate };

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

@@ -1,5 +1,3 @@
-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
@@ -32,37 +30,4 @@ function detectProjectType(dir) {
 	return "generic";
 }
 //#endregion
-//#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 };
+export { detectProjectType as n, isApexCommand as r, DEV_KEYWORDS as t };

package/dist/runtime/index.d.mts

@@ -0,0 +1,51 @@
+import { t as Prompt } from "../types-D56jSgD9.mjs";
+import { t as RefMeta } from "../types-CY5qT2X1.mjs";
+
+//#region src/runtime/paths.d.ts
+/** Path to a session's track file (under a per-tool base dir). */
+declare function trackFile(sessionId: string, baseDir?: string): string;
+//#endregion
+//#region src/runtime/record.d.ts
+/** A unit of session activity to record (discriminated union on `kind`). */
+type Activity = {
+  kind: "agent";
+  name: string;
+  ts: number;
+} | {
+  kind: "doc";
+  framework: string;
+  sessionId: string;
+  source: string;
+} | {
+  kind: "ref";
+  path: string;
+};
+/** Apply an activity to a session's track and persist it (PostToolUse path). */
+declare function recordActivity(file: string, activity: Activity): Promise<void>;
+//#endregion
+//#region src/runtime/gate.d.ts
+/** Prior agents the freshness gate requires before a code edit. */
+declare const REQUIRED_AGENTS: ReadonlyArray<string>;
+/** Default freshness window for {@link REQUIRED_AGENTS} (4 min, the APEX TTL). */
+declare const DEFAULT_WINDOW_MS = 24e4;
+/** A tool-use to gate, plus the session pointers needed for the stateful gates. */
+interface GateInput {
+  sessionId: string;
+  framework: string;
+  tool: string;
+  filePath?: string;
+  content?: string;
+  command?: string;
+  refs?: RefMeta[];
+  now: number;
+  trackFile: string;
+  windowMs?: number;
+}
+/**
+* Full gate: the stateless guards (file-size, git) first, then the stateful
+* APEX gates fed from the session track. Returns the first blocking prompt, or
+* null to allow. APEX gates apply only to code edits (a `filePath`).
+*/
+declare function gate(input: GateInput): Promise<Prompt | null>;
+//#endregion
+export { Activity, DEFAULT_WINDOW_MS, GateInput, REQUIRED_AGENTS, gate, recordActivity, trackFile };

package/dist/runtime/index.mjs

@@ -0,0 +1,51 @@
+import { t as evaluate } from "../evaluate-CsYyUucy.mjs";
+import { r as evaluateApex } from "../apex-gGrHzvM2.mjs";
+import { a as recordAgent, n as saveTrack, o as recordDoc, r as agentsFresh, s as recordRefRead, t as loadTrack } from "../store-BWvwnnf6.mjs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+//#region src/runtime/paths.ts
+/** Path to a session's track file (under a per-tool base dir). */
+function trackFile(sessionId, baseDir = join(tmpdir(), "fuse-harness")) {
+	return join(baseDir, `track-${sessionId.replace(/[^A-Za-z0-9_-]/g, "_") || "default"}.json`);
+}
+//#endregion
+//#region src/runtime/record.ts
+/** Apply an activity to a session's track and persist it (PostToolUse path). */
+async function recordActivity(file, activity) {
+	const track = await loadTrack(file);
+	await saveTrack(file, activity.kind === "agent" ? recordAgent(track, activity.name, activity.ts) : activity.kind === "doc" ? recordDoc(track, activity.framework, activity.sessionId, activity.source) : recordRefRead(track, activity.path));
+}
+//#endregion
+//#region src/runtime/gate.ts
+/** Prior agents the freshness gate requires before a code edit. */
+const REQUIRED_AGENTS = ["explore-codebase", "research-expert"];
+/** Default freshness window for {@link REQUIRED_AGENTS} (4 min, the APEX TTL). */
+const DEFAULT_WINDOW_MS = 24e4;
+/**
+* Full gate: the stateless guards (file-size, git) first, then the stateful
+* APEX gates fed from the session track. Returns the first blocking prompt, or
+* null to allow. APEX gates apply only to code edits (a `filePath`).
+*/
+async function gate(input) {
+	const quick = evaluate({
+		tool: input.tool,
+		filePath: input.filePath,
+		content: input.content,
+		command: input.command
+	});
+	if (quick.decision !== "allow" && quick.prompt) return quick.prompt;
+	if (!input.filePath) return null;
+	const track = await loadTrack(input.trackFile);
+	return evaluateApex({
+		sessionId: input.sessionId,
+		framework: input.framework,
+		filePath: input.filePath,
+		content: input.content ?? "",
+		authorizations: track.authorizations,
+		refs: input.refs,
+		refsRead: track.refsRead,
+		agentsFresh: agentsFresh(track, [...REQUIRED_AGENTS], input.windowMs ?? 24e4, input.now)
+	});
+}
+//#endregion
+export { DEFAULT_WINDOW_MS, REQUIRED_AGENTS, gate, recordActivity, trackFile };

package/dist/store-BWvwnnf6.mjs

@@ -0,0 +1,63 @@
+import { n as readJsonFile, r as writeJsonFile } from "./json-io-RH82El2J.mjs";
+//#region src/tracking/session-state.ts
+/** A fresh, empty track. */
+function emptyTrack() {
+	return {
+		authorizations: {},
+		refsRead: [],
+		agents: []
+	};
+}
+/** Record a doc consultation (Context7/Exa) for a framework in this session. Immutable. */
+function recordDoc(track, framework, sessionId, source) {
+	const prev = track.authorizations[framework] ?? {};
+	const sessions = new Set(prev.doc_sessions ?? []);
+	sessions.add(sessionId);
+	const sources = new Set(prev.sources ?? (prev.source ? [prev.source] : []));
+	sources.add(source);
+	return {
+		...track,
+		authorizations: {
+			...track.authorizations,
+			[framework]: {
+				...prev,
+				doc_sessions: [...sessions],
+				sources: [...sources]
+			}
+		}
+	};
+}
+/** Record that a SOLID reference file was read (deduped). Immutable. */
+function recordRefRead(track, path) {
+	return track.refsRead.includes(path) ? track : {
+		...track,
+		refsRead: [...track.refsRead, path]
+	};
+}
+/** Record an agent/tool call with a timestamp. Immutable. */
+function recordAgent(track, name, ts) {
+	return {
+		...track,
+		agents: [...track.agents, {
+			name,
+			ts
+		}]
+	};
+}
+/** True when ALL of `names` were called within `windowMs` before `now`. */
+function agentsFresh(track, names, windowMs, now) {
+	const cutoff = now - windowMs;
+	return names.every((n) => track.agents.some((a) => a.name === n && a.ts > cutoff));
+}
+//#endregion
+//#region src/tracking/store.ts
+/** Load a session track from a file (an empty track if absent/corrupt). */
+async function loadTrack(file) {
+	return await readJsonFile(file) ?? emptyTrack();
+}
+/** Persist a session track. */
+async function saveTrack(file, track) {
+	await writeJsonFile(file, track);
+}
+//#endregion
+export { recordAgent as a, emptyTrack as i, saveTrack as n, recordDoc as o, agentsFresh as r, recordRefRead as s, loadTrack as t };

package/dist/tracking/index.d.mts

@@ -0,0 +1,30 @@
+import { t as AuthEntry } from "../doc-helpers-CG1nuf-c.mjs";
+
+//#region src/tracking/session-state.d.ts
+/** Recorded session activity that feeds the APEX gates. */
+interface SessionTrack {
+  authorizations: Record<string, AuthEntry>;
+  refsRead: string[];
+  agents: {
+    name: string;
+    ts: number;
+  }[];
+}
+/** A fresh, empty track. */
+declare function emptyTrack(): SessionTrack;
+/** Record a doc consultation (Context7/Exa) for a framework in this session. Immutable. */
+declare function recordDoc(track: SessionTrack, framework: string, sessionId: string, source: string): SessionTrack;
+/** Record that a SOLID reference file was read (deduped). Immutable. */
+declare function recordRefRead(track: SessionTrack, path: string): SessionTrack;
+/** Record an agent/tool call with a timestamp. Immutable. */
+declare function recordAgent(track: SessionTrack, name: string, ts: number): SessionTrack;
+/** True when ALL of `names` were called within `windowMs` before `now`. */
+declare function agentsFresh(track: SessionTrack, names: string[], windowMs: number, now: number): boolean;
+//#endregion
+//#region src/tracking/store.d.ts
+/** Load a session track from a file (an empty track if absent/corrupt). */
+declare function loadTrack(file: string): Promise<SessionTrack>;
+/** Persist a session track. */
+declare function saveTrack(file: string, track: SessionTrack): Promise<void>;
+//#endregion
+export { SessionTrack, agentsFresh, emptyTrack, loadTrack, recordAgent, recordDoc, recordRefRead, saveTrack };

package/dist/tracking/index.mjs

@@ -0,0 +1,2 @@
+import { a as recordAgent, i as emptyTrack, n as saveTrack, o as recordDoc, r as agentsFresh, s as recordRefRead, t as loadTrack } from "../store-BWvwnnf6.mjs";
+export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordDoc, recordRefRead, saveTrack };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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",
@@ -23,6 +23,8 @@
     "./statusline": { "bun": "./src/statusline/index.ts", "types": "./dist/statusline/index.d.mts", "import": "./dist/statusline/index.mjs" },
     "./cli": { "bun": "./src/cli/index.ts", "types": "./dist/cli/index.d.mts", "import": "./dist/cli/index.mjs" },
     "./init": { "bun": "./src/init/index.ts", "types": "./dist/init/index.d.mts", "import": "./dist/init/index.mjs" },
+    "./tracking": { "bun": "./src/tracking/index.ts", "types": "./dist/tracking/index.d.mts", "import": "./dist/tracking/index.mjs" },
+    "./runtime": { "bun": "./src/runtime/index.ts", "types": "./dist/runtime/index.d.mts", "import": "./dist/runtime/index.mjs" },
     "./adapters/claude": { "bun": "./src/adapters/claude/index.ts", "types": "./dist/adapters/claude/index.d.mts", "import": "./dist/adapters/claude/index.mjs" },
     "./adapters/codex": { "bun": "./src/adapters/codex/index.ts", "types": "./dist/adapters/codex/index.d.mts", "import": "./dist/adapters/codex/index.mjs" },
     "./adapters/cursor": { "bun": "./src/adapters/cursor/index.ts", "types": "./dist/adapters/cursor/index.d.mts", "import": "./dist/adapters/cursor/index.mjs" },
@@ -35,7 +37,7 @@
   "scripts": {
     "test": "bun test",
     "typecheck": "tsc --noEmit",
-    "build": "tsdown src/index.ts src/config/index.ts src/util/index.ts src/detect/index.ts src/policy/index.ts src/prompt/index.ts src/memory/index.ts src/cache/index.ts src/freshness/index.ts src/refs/index.ts src/state/index.ts src/statusline/index.ts src/cli/index.ts src/cli/bin.ts src/init/index.ts src/adapters/claude/index.ts src/adapters/codex/index.ts src/adapters/cursor/index.ts src/adapters/cline/index.ts src/adapters/gemini/index.ts --dts --format esm --clean --out-dir dist",
+    "build": "tsdown src/index.ts src/config/index.ts src/util/index.ts src/detect/index.ts src/policy/index.ts src/prompt/index.ts src/memory/index.ts src/cache/index.ts src/freshness/index.ts src/refs/index.ts src/state/index.ts src/statusline/index.ts src/cli/index.ts src/cli/bin.ts src/init/index.ts src/tracking/index.ts src/runtime/index.ts src/adapters/claude/index.ts src/adapters/codex/index.ts src/adapters/cursor/index.ts src/adapters/cline/index.ts src/adapters/gemini/index.ts --dts --format esm --clean --out-dir dist",
     "prepublishOnly": "bun test && tsc --noEmit && bun run build"
   },
   "publishConfig": {