@fusengine/harness 0.1.18 → 0.1.19

package/dist/cli/bin.mjs

@@ -3,7 +3,7 @@ import { r as resolveTtlSec } from "../ttl-BG55s6HZ.mjs";
 import { t as detectHarness } from "../harness-C8Nxxyn_.mjs";
 import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-_Cy9-Tgv.mjs";
 import { n as writeInitFile, t as initFor } from "../run-D91N4ul1.mjs";
-import { t as handleHook } from "../handle-SPlcCQYl.mjs";
+import { t as handleHook } from "../handle-DYF2Fju8.mjs";
 //#region src/cli/bin.ts
 /**
 * harness — CLI for @fusengine/harness.

package/dist/{handle-SPlcCQYl.mjs → handle-DYF2Fju8.mjs}

@@ -142,6 +142,11 @@ function mutateWith(id, input) {
 	if (id === "gemini-cli") return JSON.stringify({ hookSpecificOutput: { tool_input: input } });
 	return "";
 }
+/** The doc provider a served cache-hit satisfies (`exa`/`context7`), else undefined. */
+function docSourceOf(tool) {
+	if (/exa/i.test(tool)) return "exa";
+	if (/context7/i.test(tool)) return "context7";
+}
 /**
 * Pre-event MCP interception: serve a fresh cache hit (deny + cached content),
 * else cap exa verbosity (allow + mutated input), else null to allow normally.
@@ -152,12 +157,15 @@ function mcpPreIntercept(id, tool, input, dir, ttlMs, now) {
 	const cached = cacheLookup(dir, tool, queryOf(input), ttlMs, now);
 	if (cached) {
 		const served = denyWith(id, cached);
-		if (served) return served;
+		if (served) return {
+			stdout: served,
+			docSource: docSourceOf(tool)
+		};
 	}
 	const capped = capVerbosity(tool, input);
 	if (capped) {
 		const mutated = mutateWith(id, capped);
-		if (mutated) return mutated;
+		if (mutated) return { stdout: mutated };
 	}
 	return null;
 }
@@ -291,10 +299,18 @@ async function handleHook(id, payload, opts) {
 		};
 	}
 	const intercept = mcpPreIntercept(id, event.tool, event.input, mcpDir, MCP_TTL_MS, opts.now);
-	if (intercept !== null) return {
-		stdout: intercept,
-		exit: 0
-	};
+	if (intercept !== null) {
+		if (intercept.docSource) await recordActivity(file, {
+			kind: "doc",
+			framework,
+			sessionId: event.sessionId,
+			source: intercept.docSource
+		});
+		return {
+			stdout: intercept.stdout,
+			exit: 0
+		};
+	}
 	const prompt = await gate({
 		sessionId: event.sessionId,
 		framework,

package/dist/runtime/index.d.mts

@@ -117,12 +117,17 @@ declare const MCP_TTL_MS = 1728e5;
 declare function isMcpTool(tool: string): boolean;
 /** The query/url that keys the cache. */
 declare function queryOf(input: Record<string, unknown>): string;
+/** A pre-event MCP interception: the native response + any doc source it satisfied. */
+interface McpIntercept {
+  stdout: string;
+  docSource?: string;
+}
 /**
 * Pre-event MCP interception: serve a fresh cache hit (deny + cached content),
 * else cap exa verbosity (allow + mutated input), else null to allow normally.
 * Harnesses without input-mutation/cache support fall through to null.
 */
-declare function mcpPreIntercept(id: string, tool: string, input: Record<string, unknown>, dir: string, ttlMs: number, now: number): string | null;
+declare function mcpPreIntercept(id: string, tool: string, input: Record<string, unknown>, dir: string, ttlMs: number, now: number): McpIntercept | null;
 /** Post-event: store the MCP/WebFetch response (extracted to markdown) in the cache. */
 declare function mcpPostStore(tool: string, input: Record<string, unknown>, response: unknown, dir: string): void;
 //#endregion
@@ -149,4 +154,4 @@ interface HandleOutcome {
 */
 declare function handleHook(id: string, payload: Record<string, unknown>, opts: HandleOptions): Promise<HandleOutcome>;
 //#endregion
-export { Activity, DEFAULT_WINDOW_MS, GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };
+export { Activity, DEFAULT_WINDOW_MS, GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, McpIntercept, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };

package/dist/runtime/index.mjs

@@ -1,5 +1,5 @@
 import { r as projectLayout } from "../layout-C0jaaCQC.mjs";
-import { a as normalizeEvent, c as mcpPostStore, d as DEFAULT_WINDOW_MS, f as REQUIRED_AGENTS, h as activityFor, i as trackFile, l as mcpPreIntercept, m as gate, n as respond, o as MCP_TTL_MS, p as TRIVIAL_BUDGET, r as recordActivity, s as isMcpTool, t as handleHook, u as queryOf } from "../handle-SPlcCQYl.mjs";
+import { a as normalizeEvent, c as mcpPostStore, d as DEFAULT_WINDOW_MS, f as REQUIRED_AGENTS, h as activityFor, i as trackFile, l as mcpPreIntercept, m as gate, n as respond, o as MCP_TTL_MS, p as TRIVIAL_BUDGET, r as recordActivity, s as isMcpTool, t as handleHook, u as queryOf } from "../handle-DYF2Fju8.mjs";
 //#region src/runtime/storage.ts
 /**
 * The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,

package/package.json

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