@fusengine/harness 0.1.11 → 0.1.13

package/README.md

@@ -1,68 +1,133 @@
 # @fusengine/harness
 
-Harness-agnostic toolkit for AI coding agents. One package, modular subpaths,
-**Bun-native** (the `exports` map points at the TypeScript source — no build step).
+A **harness-agnostic enforcement engine** for AI coding agents. It ports the
+guard/gate logic of a Claude Code plugin into one reusable, **Bun-native** npm
+package that runs on **any** harness — Claude Code, OpenAI Codex, Cursor, Cline,
+Gemini CLI — plus a cli-mode fallback for Aider / Windsurf / OpenHands.
 
-It splits cleanly into a **pure policy core** (no harness coupling) and **thin
-adapters** that wire it into a specific harness's hook system.
+It splits cleanly into a **pure policy core** (no harness coupling, fully tested)
+and **thin per-harness adapters** that map a hook payload to the policy and back
+to that harness's native response.
 
-## Why
-
-The same guard logic (file-size limits, APEX freshness, framework detection,
-git guards, project memory) was duplicated across Python + TypeScript hooks and
-bound to one harness. This package is the single, tested source of truth — and
-it knows which harness it's running in.
+```
+detect → init (pre+post hooks) → `harness hook` → guards + APEX gates → native deny/ask
+```
 
 ## Install
 
 ```sh
-bun add @fusengine/harness
+npm i -g @fusengine/harness     # for the CLI (harness init/hook/check)
+# or, as a library:
+bun add @fusengine/harness      # Bun reads the TS source directly — no build step
 ```
 
-## Modules
+## Quickstart
 
-| Subpath | What |
-|---------|------|
-| `@fusengine/harness/detect` | `detectHarness()` / `detectMode()` — Claude Code, Codex, Cursor, Cline, Gemini, opencode, Windsurf, Copilot, Aider, Kiro, Goose, Amp (env signals + `AGENT`/`AI_AGENT` standards). `mode` is `hook` or `cli`. |
-| `@fusengine/harness/policy` | `evaluate(ctx)` → `{ decision, message }`; `evaluateFileSize`, `detectProjectType`, `detectFramework`, git/install guard patterns. |
-| `@fusengine/harness/config` | `resolveTtlSec` / `resolveMaxLines` (env-driven, robust parse), `ttlLabel`, `splitTarget`. |
-| `@fusengine/harness/memory` | Per-project "never reproduce" lessons: throttle state, multi-project registry by git root. |
-| `@fusengine/harness/cache` | `compactMarkdown`, `queryHash`, `jaccardSimilar`, atomic JSON I/O, MCP response extraction. |
-| `@fusengine/harness/freshness` | `isDocConsulted` (Context7 + Exa), trivial-edit counter. |
-| `@fusengine/harness/refs` | Frontmatter parsing, glob→regex, SOLID reference scoring/routing. |
-| `@fusengine/harness/state` | Directory locks, daily APEX state, task.json helpers. |
-| `@fusengine/harness/statusline` | Formatters, ANSI colors, progress/gradient bars. |
-| `@fusengine/harness/adapters/claude` | Claude Code adapter: read stdin → policy → `hookSpecificOutput`. |
-
-## Usage
+```sh
+cd your-project
+harness init                              # detects the harness, writes its pre+post hooks
+export FUSE_HARNESS_REFS=.claude/skills   # (optional) activate the SOLID-read gate
+```
 
-```ts
-import { detectHarness, detectMode } from "@fusengine/harness/detect";
-import { evaluate } from "@fusengine/harness/policy";
+That's it. `init` writes the wiring file for the detected harness
+(`.claude/settings.json`, `.codex/hooks.json`, `.cursor/hooks.json`,
+`.gemini/settings.json`, or `.clinerules/hooks/PreToolUse`+`PostToolUse`), each
+pointing at `harness hook <id>`. From then on every tool-use is gated, and the
+session activity (agents run, docs consulted, refs read) is recorded
+automatically under `<harness-dir>/harness/`.
 
-const { id, mode } = detectHarness();        // e.g. { id: "cursor", mode: "hook" }
+### CLI
 
-const verdict = evaluate({ tool: "Write", filePath: "src/big.ts", content });
-if (verdict.decision === "deny") console.error(verdict.message);
+| Command | What it does |
+|---------|--------------|
+| `harness init [id]` | Write the pre+post hook wiring for the detected (or named) harness. |
+| `harness hook <id>` | Runtime: read a hook payload on stdin, gate (pre) or record (post), print the native response. (Hooks call this — you don't.) |
+| `harness check` | cli-mode: check staged files in a pre-commit step, exit non-zero on a violation. For harnesses without hooks. |
+
+cli-mode (Aider / Windsurf / OpenHands), as a pre-commit step:
+
+```sh
+# .husky/pre-commit
+npx harness check
 ```
 
-Claude Code hook (thin adapter):
+## What it enforces
+
+Ten portable guards + the APEX gate chain, all evaluated before a tool runs:
+
+| Guard / gate | Fires on |
+|---|---|
+| file-size (SOLID) | a code file over `FUSE_SOLID_MAX_LINES` (default 100) |
+| git | destructive git (`push --force`, `reset --hard`, …) |
+| bash-write | `python3 -c` / `sed -i` / redirects to code files |
+| install | `npm/pip/brew/...` installs (asks) |
+| security | `rm -rf /`, fork bombs, `curl \| sh`; `sudo` (asks) |
+| interface-separation | top-level interface/type/protocol in a component/controller |
+| protected-path | edits to `.claude/plugins\|logs\|cache`, `.git/` |
+| APEX freshness | `explore-codebase` + `research-expert` not run within the window |
+| APEX doc-consulted | Context7 **and** Exa not consulted this session |
+| APEX solid-read | required SOLID refs (from `FUSE_HARNESS_REFS`) not read |
+| brainstorm | creating a new file without brainstorming (when flagged) |
+| MCP verbosity / cache | caps exa `numResults`; serves a fresh cached MCP/WebFetch result |
+
+A trivial-edit fast path lets a few tiny (< 5-line, non-`replace_all`) edits
+through per window without the full APEX gates.
+
+### Environment
+
+| Var | Effect |
+|---|---|
+| `FUSE_SOLID_MAX_LINES` | SOLID file-size limit (default `100`). |
+| `FUSE_HARNESS_REFS` | Directory of `.md` SOLID references → activates `solidReadGate`. |
+| `FUSE_ENFORCE_TTL_SEC` | APEX freshness window in seconds. |
+| `FUSE_LESSONS_THROTTLE_MIN` | Lessons-injection throttle (memory module). |
+
+## Library usage
 
 ```ts
-import { readClaudeInput, fileSizeGuard } from "@fusengine/harness/adapters/claude";
+import { detectHarness } from "@fusengine/harness/detect";
+import { evaluate } from "@fusengine/harness/policy";
+import { gate } from "@fusengine/harness/runtime";
+
+const { id, mode } = detectHarness();            // { id: "cursor", mode: "hook" }
 
-const deny = fileSizeGuard(await readClaudeInput());
-if (deny) { console.log(deny); process.exit(2); }
+// stateless guards (file-size, git, security, …)
+const verdict = evaluate({ tool: "Write", filePath: "src/big.ts", content });
+if (verdict.decision !== "allow") console.error(verdict.prompt?.reason);
+
+// full gate (stateless + stateful APEX, fed from the session track)
+const prompt = await gate({ sessionId, framework: "react", tool: "Write",
+  filePath: "src/Button.tsx", content, now: Date.now(), trackFile });
 ```
 
-Harness without hooks (Aider/Windsurf/OpenHands) → `cli` mode: run the same
-`evaluate()` from a pre-commit step instead.
+The `Prompt` it returns (`{ kind: "block" | "ask" | "inform", title, reason, actions? }`)
+is portable; each adapter maps it to the harness's native shape.
+
+## Subpath exports
+
+| Subpath | What |
+|---------|------|
+| `./detect` | `detectHarness()` / `detectMode()` — 13 harnesses, `hook` vs `cli`. |
+| `./policy` | `evaluate(ctx)`, the 10 guards, `evaluateApex`, framework detection. |
+| `./runtime` | `handleHook`, `gate`, `recordActivity`, `activityFor`, per-harness storage + MCP intercept. |
+| `./tracking` | Session track: `recordAgent/Doc/RefRead`, `agentsFresh`, trivial-edit counter. |
+| `./refs` | Frontmatter parse, `loadRefs(dir)`, SOLID ref scoring/routing. |
+| `./prompt` | The portable `Prompt` type + `formatPrompt`. |
+| `./cache` | MCP/WebFetch cache: key, lookup/store, compaction, response extraction. |
+| `./memory` | Per-project "never reproduce" lessons. |
+| `./config` `./util` `./state` `./statusline` `./freshness` `./init` `./cli` | env config, project-root, locks, statusline, doc-freshness, wiring templates, staged checks. |
+| `./adapters/{claude,codex,cursor,cline,gemini}` | Thin per-harness adapters. |
+
+See [`docs/`](./docs) for per-module guides, and run `bun run docs:api` for the
+generated typedoc API reference.
 
 ## Develop
 
 ```sh
-bun test          # test suite
-bunx tsc --noEmit # typecheck
+bun test            # 105 tests
+bunx tsc --noEmit   # typecheck (isolatedDeclarations)
+bun run build       # dist + .d.mts via tsdown (for Node/bundler consumers)
+bun run docs:api    # generate the typedoc API reference
 ```
 
-CI runs both on every PR. MIT licensed.
+CI runs test + typecheck on every PR. MIT licensed.

package/dist/cache/index.d.mts

@@ -1,2 +1,2 @@
-import { a as compactMarkdown, i as summarizeIndex, n as IndexSummary, o as jaccardSimilar, r as loadIndex, s as queryHash, t as extractText } from "../index-B3Ve_bBu.mjs";
-export { IndexSummary, compactMarkdown, extractText, jaccardSimilar, loadIndex, queryHash, summarizeIndex };
+import { a as extractText, c as summarizeIndex, d as queryHash, i as mcpCacheKey, l as compactMarkdown, n as cachePath, o as IndexSummary, r as cacheStore, s as loadIndex, t as cacheLookup, u as jaccardSimilar } from "../index-DPkCX_AR.mjs";
+export { IndexSummary, cacheLookup, cachePath, cacheStore, compactMarkdown, extractText, jaccardSimilar, loadIndex, mcpCacheKey, queryHash, summarizeIndex };

package/dist/cache/index.mjs

@@ -1,2 +1,3 @@
-import { a as jaccardSimilar, i as compactMarkdown, n as loadIndex, o as queryHash, r as summarizeIndex, t as extractText } from "../cache-DbPSJ9bC.mjs";
-export { compactMarkdown, extractText, jaccardSimilar, loadIndex, queryHash, summarizeIndex };
+import { a as queryHash, i as jaccardSimilar, n as summarizeIndex, r as compactMarkdown, t as loadIndex } from "../cache-BzbX-ztL.mjs";
+import { a as extractText, i as mcpCacheKey, n as cachePath, r as cacheStore, t as cacheLookup } from "../store-BlaEhjab.mjs";
+export { cacheLookup, cachePath, cacheStore, compactMarkdown, extractText, jaccardSimilar, loadIndex, mcpCacheKey, queryHash, summarizeIndex };

package/dist/{cache-DbPSJ9bC.mjs → cache-BzbX-ztL.mjs}

@@ -83,28 +83,4 @@ function summarizeIndex(index) {
 	};
 }
 //#endregion
-//#region src/cache/mcp-response.ts
-const MAX_DEPTH = 5;
-/**
-* Extract usable markdown from an MCP `tool_response`: a string, a list of
-* content blocks (non-text blocks skipped), or any JSON structure (fallback).
-* Recurses up to depth 5 to guard against pathological/cyclic structures.
-*/
-function extractText(resp, depth = 0) {
-	if (depth >= MAX_DEPTH) return "";
-	if (typeof resp === "string") return resp;
-	if (Array.isArray(resp)) {
-		const parts = resp.filter((b) => typeof b === "object" && b !== null).filter((b) => b.type === "text").map((b) => b.text ?? "");
-		if (parts.length) return parts.join("\n\n");
-		const joined = resp.filter((b) => Array.isArray(b) || typeof b === "object" && b !== null).map((b) => extractText(b, depth + 1)).filter(Boolean).join("\n\n");
-		if (joined) return joined;
-	}
-	if (!resp) return "";
-	try {
-		return JSON.stringify(resp);
-	} catch {
-		return "";
-	}
-}
-//#endregion
-export { jaccardSimilar as a, compactMarkdown as i, loadIndex as n, queryHash as o, summarizeIndex as r, extractText as t };
+export { queryHash as a, jaccardSimilar as i, summarizeIndex as n, compactMarkdown as r, loadIndex as t };

package/dist/cli/bin.mjs

@@ -2,7 +2,7 @@
 import { t as detectHarness } from "../harness-C8Nxxyn_.mjs";
 import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-D2na7Z2Z.mjs";
 import { n as writeInitFile, t as initFor } from "../run-Cdp2Ef9B.mjs";
-import { t as handleHook } from "../handle-Cr0YQYz-.mjs";
+import { t as handleHook } from "../handle-o5np-3T_.mjs";
 //#region src/cli/bin.ts
 /**
 * harness — CLI for @fusengine/harness.

package/dist/{handle-Cr0YQYz-.mjs → handle-o5np-3T_.mjs}

@@ -1,6 +1,7 @@
 import { O as detectFramework, t as evaluate } from "./evaluate-DkTgwHNh.mjs";
-import { i as evaluateApex } from "./apex-BcJSE-VL.mjs";
+import { n as capVerbosity, o as evaluateApex } from "./verbosity-ZYT7tLCw.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
+import { a as extractText, r as cacheStore, t as cacheLookup } from "./store-BlaEhjab.mjs";
 import { t as loadRefs } from "./loader-BephwI8n.mjs";
 import { a as recordAgent, c as recordRefRead, l as recordTrivialEdit, n as saveTrack, r as agentsFresh, s as recordDoc, t as loadTrack, u as trivialCount } from "./store-gtbP-Bv9.mjs";
 import { join } from "node:path";
@@ -86,6 +87,64 @@ async function gate(input) {
 	});
 }
 //#endregion
+//#region src/runtime/mcp.ts
+/** Default freshness for cached MCP/WebFetch results (48h). */
+const MCP_TTL_MS = 1728e5;
+/** MCP doc tools + WebFetch whose calls are cached / verbosity-capped. */
+function isMcpTool(tool) {
+	return /context7|exa|webfetch|web_fetch/i.test(tool) || tool === "WebFetch";
+}
+/** The query/url that keys the cache. */
+function queryOf(input) {
+	const q = input.query ?? input.url ?? input.libraryId ?? "";
+	return typeof q === "string" ? q : JSON.stringify(q);
+}
+function denyWith(id, content) {
+	if (id === "claude-code" || id === "codex") return JSON.stringify({ hookSpecificOutput: {
+		hookEventName: "PreToolUse",
+		permissionDecision: "deny",
+		permissionDecisionReason: content
+	} });
+	if (id === "gemini-cli") return JSON.stringify({
+		decision: "deny",
+		reason: content
+	});
+	return "";
+}
+function mutateWith(id, input) {
+	if (id === "claude-code" || id === "codex") return JSON.stringify({ hookSpecificOutput: {
+		hookEventName: "PreToolUse",
+		permissionDecision: "allow",
+		updatedInput: input
+	} });
+	if (id === "gemini-cli") return JSON.stringify({ hookSpecificOutput: { tool_input: input } });
+	return "";
+}
+/**
+* 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.
+*/
+function mcpPreIntercept(id, tool, input, dir, ttlMs, now) {
+	if (!isMcpTool(tool)) return null;
+	const cached = cacheLookup(dir, tool, queryOf(input), ttlMs, now);
+	if (cached) {
+		const served = denyWith(id, cached);
+		if (served) return served;
+	}
+	const capped = capVerbosity(tool, input);
+	if (capped) {
+		const mutated = mutateWith(id, capped);
+		if (mutated) return mutated;
+	}
+	return null;
+}
+/** Post-event: store the MCP/WebFetch response (extracted to markdown) in the cache. */
+function mcpPostStore(tool, input, response, dir) {
+	if (!isMcpTool(tool)) return;
+	cacheStore(dir, tool, queryOf(input), extractText(response));
+}
+//#endregion
 //#region src/runtime/normalize.ts
 function str(v) {
 	return typeof v === "string" ? v : void 0;
@@ -197,9 +256,12 @@ function harnessTrackDir(id, projectRoot) {
 */
 async function handleHook(id, payload, opts) {
 	const event = normalizeEvent(id, payload);
-	const file = trackFile(event.sessionId, harnessTrackDir(id, opts.cwd));
+	const dir = harnessTrackDir(id, opts.cwd);
+	const file = trackFile(event.sessionId, dir);
+	const mcpDir = join(dir, "mcp");
 	const framework = detectFramework(event.filePath ?? "", event.content ?? "");
 	if (event.phase === "post") {
+		mcpPostStore(event.tool, event.input, payload.tool_response ?? payload.tool_output, mcpDir);
 		const activity = activityFor({
 			tool: event.tool,
 			input: event.input,
@@ -213,6 +275,11 @@ async function handleHook(id, payload, opts) {
 			exit: 0
 		};
 	}
+	const intercept = mcpPreIntercept(id, event.tool, event.input, mcpDir, MCP_TTL_MS, opts.now);
+	if (intercept !== null) return {
+		stdout: intercept,
+		exit: 0
+	};
 	const prompt = await gate({
 		sessionId: event.sessionId,
 		framework,
@@ -234,4 +301,4 @@ async function handleHook(id, payload, opts) {
 	};
 }
 //#endregion
-export { trackFile as a, REQUIRED_AGENTS as c, activityFor as d, recordActivity as i, TRIVIAL_BUDGET as l, harnessTrackDir as n, normalizeEvent as o, respond as r, DEFAULT_WINDOW_MS as s, handleHook as t, gate as u };
+export { trackFile as a, isMcpTool as c, queryOf as d, DEFAULT_WINDOW_MS as f, activityFor as g, gate as h, recordActivity as i, mcpPostStore as l, TRIVIAL_BUDGET as m, harnessTrackDir as n, normalizeEvent as o, REQUIRED_AGENTS as p, respond as r, MCP_TTL_MS as s, handleHook as t, mcpPreIntercept as u };

package/dist/{index-CGFPvQ69.d.mts → index-CQOPshSM.d.mts}

@@ -198,4 +198,13 @@ declare function runGuards(ctx: GuardContext): Prompt | null;
 */
 declare function detectCreationIntent(prompt: string): boolean;
 //#endregion
-export { solidReadGate as A, countLines as B, APEX_GATES as C, docConsultedGate as D, brainstormGate as E, GIT_BLOCKED as F, detectProjectType as G, detectFramework as H, PROJECT_INSTALL as I, isApexCommand as K, SYSTEM_INSTALL as L, PolicyResult as M, evaluate as N, evaluateApex as O, GIT_ASK as P, matchPatterns as R, GuardContext as S, ApexGate as T, DEV_KEYWORDS as U, evaluateFileSize as V, ProjectType as W, protectedPathGuard as _, SYSTEM_INSTALL_RE as a, securityGuard as b, PY_MODEL_RE as c, interfaceSeparationGuard as d, ASK_WRITERS as f, PROTECTED_FRAGMENTS as g, bashWriteGuard as h, PROJECT_INSTALL_RE as i, PolicyContext as j, freshnessGate as k, SWIFT_PROTO_RE as l, CODE_REDIRECT as m, GUARDS as n, installGuard as o, CODE_MUTATORS as p, runGuards as r, PHP_DECL_RE as s, detectCreationIntent as t, TS_DECL_RE as u, ASK_PATTERNS as v, ApexContext as w, Guard as x, CRITICAL_PATTERNS as y, FileSizeVerdict as z };
+//#region src/policy/verbosity.d.ts
+/** Max results an exa MCP call may request. */
+declare const MAX_EXA_RESULTS = 3;
+/**
+* Cap an exa MCP call to {@link MAX_EXA_RESULTS} results. Returns the capped
+* input (a mutation for the harness to apply) when a cap is needed, else null.
+*/
+declare function capVerbosity(tool: string, input: Record<string, unknown>): Record<string, unknown> | null;
+//#endregion
+export { evaluateApex as A, matchPatterns as B, Guard as C, ApexGate as D, ApexContext as E, evaluate as F, DEV_KEYWORDS as G, countLines as H, GIT_ASK as I, isApexCommand as J, ProjectType as K, GIT_BLOCKED as L, solidReadGate as M, PolicyContext as N, brainstormGate as O, PolicyResult as P, PROJECT_INSTALL as R, securityGuard as S, APEX_GATES as T, evaluateFileSize as U, FileSizeVerdict as V, detectFramework as W, bashWriteGuard as _, runGuards as a, ASK_PATTERNS as b, installGuard as c, SWIFT_PROTO_RE as d, TS_DECL_RE as f, CODE_REDIRECT as g, CODE_MUTATORS as h, GUARDS as i, freshnessGate as j, docConsultedGate as k, PHP_DECL_RE as l, ASK_WRITERS as m, capVerbosity as n, PROJECT_INSTALL_RE as o, interfaceSeparationGuard as p, detectProjectType as q, detectCreationIntent as r, SYSTEM_INSTALL_RE as s, MAX_EXA_RESULTS as t, PY_MODEL_RE as u, PROTECTED_FRAGMENTS as v, GuardContext as w, CRITICAL_PATTERNS as x, protectedPathGuard as y, SYSTEM_INSTALL as z };

package/dist/{index-B3Ve_bBu.d.mts → index-DPkCX_AR.d.mts}

@@ -27,4 +27,14 @@ declare function summarizeIndex(index: unknown[]): IndexSummary;
 */
 declare function extractText(resp: unknown, depth?: number): string;
 //#endregion
-export { compactMarkdown as a, summarizeIndex as i, IndexSummary as n, jaccardSimilar as o, loadIndex as r, queryHash as s, extractText as t };
+//#region src/cache/store.d.ts
+/** Stable 16-char key from a tool name + query (FNV-1a, non-crypto). */
+declare function mcpCacheKey(tool: string, query: string): string;
+/** Path of a cache entry under `dir`. */
+declare function cachePath(dir: string, tool: string, query: string): string;
+/** Read a cached entry if it exists and is fresh (mtime within `ttlMs`), else null. */
+declare function cacheLookup(dir: string, tool: string, query: string, ttlMs: number, now: number): string | null;
+/** Store a cache entry (creates the dir; no-op on empty content). */
+declare function cacheStore(dir: string, tool: string, query: string, content: string): void;
+//#endregion
+export { extractText as a, summarizeIndex as c, queryHash as d, mcpCacheKey as i, compactMarkdown as l, cachePath as n, IndexSummary as o, cacheStore as r, loadIndex as s, cacheLookup as t, jaccardSimilar as u };

package/dist/index.d.mts

@@ -1,14 +1,14 @@
 import { n as PromptKind, r as formatPrompt, t as Prompt } from "./types-D56jSgD9.mjs";
-import { a as compactMarkdown, i as summarizeIndex, n as IndexSummary, o as jaccardSimilar, r as loadIndex, s as queryHash, t as extractText } from "./index-B3Ve_bBu.mjs";
+import { a as extractText, c as summarizeIndex, d as queryHash, i as mcpCacheKey, l as compactMarkdown, n as cachePath, o as IndexSummary, r as cacheStore, s as loadIndex, t as cacheLookup, u as jaccardSimilar } from "./index-DPkCX_AR.mjs";
 import { a as DEFAULT_TTL_SEC, c as ttlLabel, i as splitTarget, l as parseEnvInt, n as MAX_LINES_ENV_KEY, o as TTL_ENV_KEY, r as resolveMaxLines, s as resolveTtlSec, t as DEFAULT_MAX_LINES } from "./index-B-z0CCiU.mjs";
 import { a as detectHarness, i as HarnessVia, n as HarnessInfo, o as detectMode, r as HarnessMode, s as modeFor, t as HarnessId } from "./harness-DwJskkz_.mjs";
 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 solidReadGate, B as countLines, C as APEX_GATES, D as docConsultedGate, E as brainstormGate, F as GIT_BLOCKED, G as detectProjectType, H as detectFramework, I as PROJECT_INSTALL, K as isApexCommand, L as SYSTEM_INSTALL, M as PolicyResult, N as evaluate, O as evaluateApex, P as GIT_ASK, R as matchPatterns, S as GuardContext, T as ApexGate, U as DEV_KEYWORDS, V as evaluateFileSize, W as ProjectType, _ as protectedPathGuard, a as SYSTEM_INSTALL_RE, b as securityGuard, c as PY_MODEL_RE, d as interfaceSeparationGuard, f as ASK_WRITERS, g as PROTECTED_FRAGMENTS, h as bashWriteGuard, i as PROJECT_INSTALL_RE, j as PolicyContext, k as freshnessGate, l as SWIFT_PROTO_RE, m as CODE_REDIRECT, n as GUARDS, o as installGuard, p as CODE_MUTATORS, r as runGuards, s as PHP_DECL_RE, t as detectCreationIntent, u as TS_DECL_RE, v as ASK_PATTERNS, w as ApexContext, x as Guard, y as CRITICAL_PATTERNS, z as FileSizeVerdict } from "./index-CGFPvQ69.mjs";
+import { A as evaluateApex, B as matchPatterns, C as Guard, D as ApexGate, E as ApexContext, F as evaluate, G as DEV_KEYWORDS, H as countLines, I as GIT_ASK, J as isApexCommand, K as ProjectType, L as GIT_BLOCKED, M as solidReadGate, N as PolicyContext, O as brainstormGate, P as PolicyResult, R as PROJECT_INSTALL, S as securityGuard, T as APEX_GATES, U as evaluateFileSize, V as FileSizeVerdict, W as detectFramework, _ as bashWriteGuard, a as runGuards, b as ASK_PATTERNS, c as installGuard, d as SWIFT_PROTO_RE, f as TS_DECL_RE, g as CODE_REDIRECT, h as CODE_MUTATORS, i as GUARDS, j as freshnessGate, k as docConsultedGate, l as PHP_DECL_RE, m as ASK_WRITERS, n as capVerbosity, o as PROJECT_INSTALL_RE, p as interfaceSeparationGuard, q as detectProjectType, r as detectCreationIntent, s as SYSTEM_INSTALL_RE, t as MAX_EXA_RESULTS, u as PY_MODEL_RE, v as PROTECTED_FRAGMENTS, w as GuardContext, x as CRITICAL_PATTERNS, y as protectedPathGuard, z as SYSTEM_INSTALL } from "./index-CQOPshSM.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 globToRe, i as scoreReferences, n as toRefMeta, o as parseFrontmatter, r as routeReferences, t as loadRefs } from "./index-hL_r6tlc.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, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, GUARDS, Guard, GuardContext, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, MAX_LINES_ENV_KEY, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, ScoredRef, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadRefs, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, GUARDS, Guard, GuardContext, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, ScoredRef, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, cacheLookup, cachePath, cacheStore, capVerbosity, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel };

package/dist/index.mjs

@@ -7,12 +7,13 @@ import { i as isApexCommand, n as DEV_KEYWORDS, r as detectProjectType, t as det
 import { C as PROJECT_INSTALL, D as evaluateFileSize, E as countLines, O as detectFramework, S as GIT_BLOCKED, T as matchPatterns, _ as protectedPathGuard, a as SYSTEM_INSTALL_RE, b as securityGuard, c as PY_MODEL_RE, d as interfaceSeparationGuard, f as ASK_WRITERS, g as PROTECTED_FRAGMENTS, h as bashWriteGuard, i as PROJECT_INSTALL_RE, l as SWIFT_PROTO_RE, m as CODE_REDIRECT, n as GUARDS, o as installGuard, p as CODE_MUTATORS, r as runGuards, s as PHP_DECL_RE, t as evaluate, u as TS_DECL_RE, v as ASK_PATTERNS, w as SYSTEM_INSTALL, x as GIT_ASK, y as CRITICAL_PATTERNS } from "./evaluate-DkTgwHNh.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 freshnessGate, i as evaluateApex, n as brainstormGate, o as solidReadGate, r as docConsultedGate, t as APEX_GATES } from "./apex-BcJSE-VL.mjs";
+import { a as docConsultedGate, c as solidReadGate, i as brainstormGate, n as capVerbosity, o as evaluateApex, r as APEX_GATES, s as freshnessGate, t as MAX_EXA_RESULTS } from "./verbosity-ZYT7tLCw.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 queryHash, i as jaccardSimilar, n as summarizeIndex, r as compactMarkdown, t as loadIndex } from "./cache-BzbX-ztL.mjs";
+import { a as extractText, i as mcpCacheKey, n as cachePath, r as cacheStore, t as cacheLookup } from "./store-BlaEhjab.mjs";
 import { t as incrementTrivialEditCounter } from "./freshness-BK9Xg6oG.mjs";
 import { n as toRefMeta, t as loadRefs } from "./loader-BephwI8n.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, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, GUARDS, MAX_LINES_ENV_KEY, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadRefs, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, GUARDS, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, cacheLookup, cachePath, cacheStore, capVerbosity, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel };

package/dist/policy/index.d.mts

@@ -1,2 +1,2 @@
-import { A as solidReadGate, B as countLines, C as APEX_GATES, D as docConsultedGate, E as brainstormGate, F as GIT_BLOCKED, G as detectProjectType, H as detectFramework, I as PROJECT_INSTALL, K as isApexCommand, L as SYSTEM_INSTALL, M as PolicyResult, N as evaluate, O as evaluateApex, P as GIT_ASK, R as matchPatterns, S as GuardContext, T as ApexGate, U as DEV_KEYWORDS, V as evaluateFileSize, W as ProjectType, _ as protectedPathGuard, a as SYSTEM_INSTALL_RE, b as securityGuard, c as PY_MODEL_RE, d as interfaceSeparationGuard, f as ASK_WRITERS, g as PROTECTED_FRAGMENTS, h as bashWriteGuard, i as PROJECT_INSTALL_RE, j as PolicyContext, k as freshnessGate, l as SWIFT_PROTO_RE, m as CODE_REDIRECT, n as GUARDS, o as installGuard, p as CODE_MUTATORS, r as runGuards, s as PHP_DECL_RE, t as detectCreationIntent, u as TS_DECL_RE, v as ASK_PATTERNS, w as ApexContext, x as Guard, y as CRITICAL_PATTERNS, z as FileSizeVerdict } from "../index-CGFPvQ69.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GUARDS, Guard, GuardContext, PHP_DECL_RE, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, PolicyContext, PolicyResult, ProjectType, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, TS_DECL_RE, bashWriteGuard, brainstormGate, countLines, detectCreationIntent, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, runGuards, securityGuard, solidReadGate };
+import { A as evaluateApex, B as matchPatterns, C as Guard, D as ApexGate, E as ApexContext, F as evaluate, G as DEV_KEYWORDS, H as countLines, I as GIT_ASK, J as isApexCommand, K as ProjectType, L as GIT_BLOCKED, M as solidReadGate, N as PolicyContext, O as brainstormGate, P as PolicyResult, R as PROJECT_INSTALL, S as securityGuard, T as APEX_GATES, U as evaluateFileSize, V as FileSizeVerdict, W as detectFramework, _ as bashWriteGuard, a as runGuards, b as ASK_PATTERNS, c as installGuard, d as SWIFT_PROTO_RE, f as TS_DECL_RE, g as CODE_REDIRECT, h as CODE_MUTATORS, i as GUARDS, j as freshnessGate, k as docConsultedGate, l as PHP_DECL_RE, m as ASK_WRITERS, n as capVerbosity, o as PROJECT_INSTALL_RE, p as interfaceSeparationGuard, q as detectProjectType, r as detectCreationIntent, s as SYSTEM_INSTALL_RE, t as MAX_EXA_RESULTS, u as PY_MODEL_RE, v as PROTECTED_FRAGMENTS, w as GuardContext, x as CRITICAL_PATTERNS, y as protectedPathGuard, z as SYSTEM_INSTALL } from "../index-CQOPshSM.mjs";
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GUARDS, Guard, GuardContext, MAX_EXA_RESULTS, PHP_DECL_RE, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, PolicyContext, PolicyResult, ProjectType, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, TS_DECL_RE, bashWriteGuard, brainstormGate, capVerbosity, countLines, detectCreationIntent, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, runGuards, securityGuard, solidReadGate };

package/dist/policy/index.mjs

@@ -1,4 +1,4 @@
 import { i as isApexCommand, n as DEV_KEYWORDS, r as detectProjectType, t as detectCreationIntent } from "../policy-Djmqxow2.mjs";
 import { C as PROJECT_INSTALL, D as evaluateFileSize, E as countLines, O as detectFramework, S as GIT_BLOCKED, T as matchPatterns, _ as protectedPathGuard, a as SYSTEM_INSTALL_RE, b as securityGuard, c as PY_MODEL_RE, d as interfaceSeparationGuard, f as ASK_WRITERS, g as PROTECTED_FRAGMENTS, h as bashWriteGuard, i as PROJECT_INSTALL_RE, l as SWIFT_PROTO_RE, m as CODE_REDIRECT, n as GUARDS, o as installGuard, p as CODE_MUTATORS, r as runGuards, s as PHP_DECL_RE, t as evaluate, u as TS_DECL_RE, v as ASK_PATTERNS, w as SYSTEM_INSTALL, x as GIT_ASK, y as CRITICAL_PATTERNS } from "../evaluate-DkTgwHNh.mjs";
-import { a as freshnessGate, i as evaluateApex, n as brainstormGate, o as solidReadGate, r as docConsultedGate, t as APEX_GATES } from "../apex-BcJSE-VL.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GUARDS, PHP_DECL_RE, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, TS_DECL_RE, bashWriteGuard, brainstormGate, countLines, detectCreationIntent, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, runGuards, securityGuard, solidReadGate };
+import { a as docConsultedGate, c as solidReadGate, i as brainstormGate, n as capVerbosity, o as evaluateApex, r as APEX_GATES, s as freshnessGate, t as MAX_EXA_RESULTS } from "../verbosity-ZYT7tLCw.mjs";
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GUARDS, MAX_EXA_RESULTS, PHP_DECL_RE, PROJECT_INSTALL, PROJECT_INSTALL_RE, PROTECTED_FRAGMENTS, PY_MODEL_RE, SWIFT_PROTO_RE, SYSTEM_INSTALL, SYSTEM_INSTALL_RE, TS_DECL_RE, bashWriteGuard, brainstormGate, capVerbosity, countLines, detectCreationIntent, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, runGuards, securityGuard, solidReadGate };

package/dist/runtime/index.d.mts

@@ -105,6 +105,22 @@ declare function normalizeEvent(id: string, payload: Record<string, unknown>): N
 */
 declare function respond(id: string, prompt: Prompt): string;
 //#endregion
+//#region src/runtime/mcp.d.ts
+/** Default freshness for cached MCP/WebFetch results (48h). */
+declare const MCP_TTL_MS = 1728e5;
+/** MCP doc tools + WebFetch whose calls are cached / verbosity-capped. */
+declare function isMcpTool(tool: string): boolean;
+/** The query/url that keys the cache. */
+declare function queryOf(input: Record<string, unknown>): 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;
+/** 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
 //#region src/runtime/handle.d.ts
 /** Options for {@link handleHook} (caller supplies the clock + project root). */
 interface HandleOptions {
@@ -126,4 +142,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, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessTrackDir, normalizeEvent, recordActivity, respond, trackFile };
+export { Activity, DEFAULT_WINDOW_MS, GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessTrackDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };

package/dist/runtime/index.mjs

@@ -1,2 +1,2 @@
-import { a as trackFile, c as REQUIRED_AGENTS, d as activityFor, i as recordActivity, l as TRIVIAL_BUDGET, n as harnessTrackDir, o as normalizeEvent, r as respond, s as DEFAULT_WINDOW_MS, t as handleHook, u as gate } from "../handle-Cr0YQYz-.mjs";
-export { DEFAULT_WINDOW_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, gate, handleHook, harnessTrackDir, normalizeEvent, recordActivity, respond, trackFile };
+import { a as trackFile, c as isMcpTool, d as queryOf, f as DEFAULT_WINDOW_MS, g as activityFor, h as gate, i as recordActivity, l as mcpPostStore, m as TRIVIAL_BUDGET, n as harnessTrackDir, o as normalizeEvent, p as REQUIRED_AGENTS, r as respond, s as MCP_TTL_MS, t as handleHook, u as mcpPreIntercept } from "../handle-o5np-3T_.mjs";
+export { DEFAULT_WINDOW_MS, MCP_TTL_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, gate, handleHook, harnessTrackDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };

package/dist/store-BlaEhjab.mjs

@@ -0,0 +1,60 @@
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/cache/mcp-response.ts
+const MAX_DEPTH = 5;
+/**
+* Extract usable markdown from an MCP `tool_response`: a string, a list of
+* content blocks (non-text blocks skipped), or any JSON structure (fallback).
+* Recurses up to depth 5 to guard against pathological/cyclic structures.
+*/
+function extractText(resp, depth = 0) {
+	if (depth >= MAX_DEPTH) return "";
+	if (typeof resp === "string") return resp;
+	if (Array.isArray(resp)) {
+		const parts = resp.filter((b) => typeof b === "object" && b !== null).filter((b) => b.type === "text").map((b) => b.text ?? "");
+		if (parts.length) return parts.join("\n\n");
+		const joined = resp.filter((b) => Array.isArray(b) || typeof b === "object" && b !== null).map((b) => extractText(b, depth + 1)).filter(Boolean).join("\n\n");
+		if (joined) return joined;
+	}
+	if (!resp) return "";
+	try {
+		return JSON.stringify(resp);
+	} catch {
+		return "";
+	}
+}
+//#endregion
+//#region src/cache/store.ts
+/** Stable 16-char key from a tool name + query (FNV-1a, non-crypto). */
+function mcpCacheKey(tool, query) {
+	const s = `${tool}\n${query}`;
+	let h = 2166136261;
+	for (let i = 0; i < s.length; i++) {
+		h ^= s.charCodeAt(i);
+		h = Math.imul(h, 16777619);
+	}
+	return (h >>> 0).toString(16).padStart(8, "0") + (s.length >>> 0).toString(16).padStart(8, "0");
+}
+/** Path of a cache entry under `dir`. */
+function cachePath(dir, tool, query) {
+	return join(dir, `${mcpCacheKey(tool, query)}.md`);
+}
+/** Read a cached entry if it exists and is fresh (mtime within `ttlMs`), else null. */
+function cacheLookup(dir, tool, query, ttlMs, now) {
+	const path = cachePath(dir, tool, query);
+	try {
+		if (!existsSync(path) || now - statSync(path).mtimeMs > ttlMs) return null;
+		return readFileSync(path, "utf8");
+	} catch {
+		return null;
+	}
+}
+/** Store a cache entry (creates the dir; no-op on empty content). */
+function cacheStore(dir, tool, query, content) {
+	if (!content) return;
+	const path = cachePath(dir, tool, query);
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, content);
+}
+//#endregion
+export { extractText as a, mcpCacheKey as i, cachePath as n, cacheStore as r, cacheLookup as t };

package/dist/{apex-BcJSE-VL.mjs → verbosity-ZYT7tLCw.mjs}

@@ -52,4 +52,23 @@ function evaluateApex(ctx, gates = APEX_GATES) {
 	return gates.reduce((hit, gate) => hit ?? gate(ctx), null);
 }
 //#endregion
-export { freshnessGate as a, evaluateApex as i, brainstormGate as n, solidReadGate as o, docConsultedGate as r, APEX_GATES as t };
+//#region src/policy/verbosity.ts
+/** Exa MCP tools whose result count is capped (Context7 has no verbosity knob). */
+const EXA_TOOLS = /exa__web_search|exa__get_code_context|exa_web_search|exa_get_code_context/i;
+/** Max results an exa MCP call may request. */
+const MAX_EXA_RESULTS = 3;
+/**
+* Cap an exa MCP call to {@link MAX_EXA_RESULTS} results. Returns the capped
+* input (a mutation for the harness to apply) when a cap is needed, else null.
+*/
+function capVerbosity(tool, input) {
+	if (!EXA_TOOLS.test(tool)) return null;
+	const n = input.numResults;
+	if (typeof n === "number" && n <= 3) return null;
+	return {
+		...input,
+		numResults: 3
+	};
+}
+//#endregion
+export { docConsultedGate as a, solidReadGate as c, brainstormGate as i, capVerbosity as n, evaluateApex as o, APEX_GATES as r, freshnessGate as s, MAX_EXA_RESULTS as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "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",
@@ -9,27 +9,111 @@
     "harness": "./dist/cli/bin.mjs"
   },
   "exports": {
-    ".": { "bun": "./src/index.ts", "types": "./dist/index.d.mts", "import": "./dist/index.mjs" },
-    "./config": { "bun": "./src/config/index.ts", "types": "./dist/config/index.d.mts", "import": "./dist/config/index.mjs" },
-    "./util": { "bun": "./src/util/index.ts", "types": "./dist/util/index.d.mts", "import": "./dist/util/index.mjs" },
-    "./detect": { "bun": "./src/detect/index.ts", "types": "./dist/detect/index.d.mts", "import": "./dist/detect/index.mjs" },
-    "./policy": { "bun": "./src/policy/index.ts", "types": "./dist/policy/index.d.mts", "import": "./dist/policy/index.mjs" },
-    "./prompt": { "bun": "./src/prompt/index.ts", "types": "./dist/prompt/index.d.mts", "import": "./dist/prompt/index.mjs" },
-    "./memory": { "bun": "./src/memory/index.ts", "types": "./dist/memory/index.d.mts", "import": "./dist/memory/index.mjs" },
-    "./cache": { "bun": "./src/cache/index.ts", "types": "./dist/cache/index.d.mts", "import": "./dist/cache/index.mjs" },
-    "./freshness": { "bun": "./src/freshness/index.ts", "types": "./dist/freshness/index.d.mts", "import": "./dist/freshness/index.mjs" },
-    "./refs": { "bun": "./src/refs/index.ts", "types": "./dist/refs/index.d.mts", "import": "./dist/refs/index.mjs" },
-    "./state": { "bun": "./src/state/index.ts", "types": "./dist/state/index.d.mts", "import": "./dist/state/index.mjs" },
-    "./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" },
-    "./adapters/cline": { "bun": "./src/adapters/cline/index.ts", "types": "./dist/adapters/cline/index.d.mts", "import": "./dist/adapters/cline/index.mjs" },
-    "./adapters/gemini": { "bun": "./src/adapters/gemini/index.ts", "types": "./dist/adapters/gemini/index.d.mts", "import": "./dist/adapters/gemini/index.mjs" }
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    },
+    "./config": {
+      "bun": "./src/config/index.ts",
+      "types": "./dist/config/index.d.mts",
+      "import": "./dist/config/index.mjs"
+    },
+    "./util": {
+      "bun": "./src/util/index.ts",
+      "types": "./dist/util/index.d.mts",
+      "import": "./dist/util/index.mjs"
+    },
+    "./detect": {
+      "bun": "./src/detect/index.ts",
+      "types": "./dist/detect/index.d.mts",
+      "import": "./dist/detect/index.mjs"
+    },
+    "./policy": {
+      "bun": "./src/policy/index.ts",
+      "types": "./dist/policy/index.d.mts",
+      "import": "./dist/policy/index.mjs"
+    },
+    "./prompt": {
+      "bun": "./src/prompt/index.ts",
+      "types": "./dist/prompt/index.d.mts",
+      "import": "./dist/prompt/index.mjs"
+    },
+    "./memory": {
+      "bun": "./src/memory/index.ts",
+      "types": "./dist/memory/index.d.mts",
+      "import": "./dist/memory/index.mjs"
+    },
+    "./cache": {
+      "bun": "./src/cache/index.ts",
+      "types": "./dist/cache/index.d.mts",
+      "import": "./dist/cache/index.mjs"
+    },
+    "./freshness": {
+      "bun": "./src/freshness/index.ts",
+      "types": "./dist/freshness/index.d.mts",
+      "import": "./dist/freshness/index.mjs"
+    },
+    "./refs": {
+      "bun": "./src/refs/index.ts",
+      "types": "./dist/refs/index.d.mts",
+      "import": "./dist/refs/index.mjs"
+    },
+    "./state": {
+      "bun": "./src/state/index.ts",
+      "types": "./dist/state/index.d.mts",
+      "import": "./dist/state/index.mjs"
+    },
+    "./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"
+    },
+    "./adapters/cline": {
+      "bun": "./src/adapters/cline/index.ts",
+      "types": "./dist/adapters/cline/index.d.mts",
+      "import": "./dist/adapters/cline/index.mjs"
+    },
+    "./adapters/gemini": {
+      "bun": "./src/adapters/gemini/index.ts",
+      "types": "./dist/adapters/gemini/index.d.mts",
+      "import": "./dist/adapters/gemini/index.mjs"
+    }
   },
   "files": ["dist", "README.md", "LICENSE"],
   "license": "MIT",
@@ -37,6 +121,7 @@
   "scripts": {
     "test": "bun test",
     "typecheck": "tsc --noEmit",
+    "docs:api": "typedoc",
     "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"
   },
@@ -47,11 +132,14 @@
     "@vercel/detect-agent": "*"
   },
   "peerDependenciesMeta": {
-    "@vercel/detect-agent": { "optional": true }
+    "@vercel/detect-agent": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/bun": "latest",
     "tsdown": "^0.22.3",
+    "typedoc": "^0.28.19",
     "typescript": "^6.0.3"
   }
 }