@fusengine/harness 0.1.7 → 0.1.9

package/dist/cli/bin.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 import { t as detectHarness } from "../harness-C8Nxxyn_.mjs";
 import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-h_2LNEA8.mjs";
-import { n as writeInitFile, t as initFor } from "../run-Cc98348q.mjs";
-import { t as handleHook } from "../handle-BGe0QZvQ.mjs";
+import { n as writeInitFile, t as initFor } from "../run-Cdp2Ef9B.mjs";
+import { t as handleHook } from "../handle-Lz_thVKr.mjs";
 //#region src/cli/bin.ts
 /**
 * harness — CLI for @fusengine/harness.
@@ -26,18 +26,20 @@ const cmd = process.argv[2];
 if (cmd === "hook") {
 	const outcome = await handleHook(process.argv[3] ?? detectHarness().id, await readStdin(), {
 		now: Date.now(),
-		cwd: process.cwd()
+		cwd: process.cwd(),
+		refsDir: process.env.FUSE_HARNESS_REFS
 	});
 	if (outcome.stdout) process.stdout.write(outcome.stdout);
 	process.exit(outcome.exit);
 } else if (cmd === "init") {
 	const id = process.argv[3] ?? detectHarness().id;
-	const file = initFor(id);
-	if (!file) {
+	const files = initFor(id);
+	if (!files) {
 		process.stderr.write(`harness: no hook integration for "${id}" — use \`harness check\` in a pre-commit step\n`);
 		process.exit(1);
 	}
-	process.stdout.write(`harness: wired ${id} -> ${writeInitFile(process.cwd(), file)}\n`);
+	const written = files.map((f) => writeInitFile(process.cwd(), f));
+	process.stdout.write(`harness: wired ${id} -> ${written.join(", ")}\n`);
 	process.exit(0);
 } else {
 	const files = stagedFiles();

package/dist/{handle-BGe0QZvQ.mjs → handle-Lz_thVKr.mjs}

@@ -1,6 +1,7 @@
 import { l as detectFramework, t as evaluate } from "./evaluate-CsYyUucy.mjs";
 import { r as evaluateApex } from "./apex-gGrHzvM2.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
+import { t as loadRefs } from "./loader-BephwI8n.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";
@@ -209,6 +210,7 @@ async function handleHook(id, payload, opts) {
 		filePath: event.filePath,
 		content: event.content,
 		command: event.command,
+		refs: opts.refsDir ? await loadRefs(opts.refsDir) : void 0,
 		now: opts.now,
 		trackFile: file
 	});

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

@@ -18,4 +18,14 @@ declare function scoreReferences(refs: RefMeta[], filePath: string, content: str
 */
 declare function routeReferences(refs: RefMeta[], filePath: string, content: string, skillPath?: string): RouteResult | null;
 //#endregion
-export { parseFrontmatter as i, scoreReferences as n, globToRe as r, routeReferences as t };
+//#region src/refs/loader.d.ts
+/** Build a {@link RefMeta} from parsed frontmatter, tolerant of kebab/camel keys. */
+declare function toRefMeta(fm: Record<string, string>, filePath: string): RefMeta;
+/**
+* Scan a directory recursively for `.md` reference files and parse each into a
+* {@link RefMeta}. The content is entirely the consumer's — point this at any
+* refs dir (`FUSE_HARNESS_REFS`). Returns an empty list when the dir is absent.
+*/
+declare function loadRefs(dir: string): Promise<RefMeta[]>;
+//#endregion
+export { globToRe as a, scoreReferences as i, toRefMeta as n, parseFrontmatter as o, routeReferences as r, loadRefs as t };

package/dist/index.d.mts

@@ -8,7 +8,7 @@ import { i as compactJson, n as projectRoot, r as projectRootOrNull, t as isCode
 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 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, 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 };
+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, loadRefs, 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, toRefMeta, ttlLabel };

package/dist/index.mjs

@@ -12,6 +12,7 @@ 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 { 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, 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 };
+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, loadRefs, 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, toRefMeta, ttlLabel };

package/dist/init/index.d.mts

@@ -2,8 +2,9 @@ import { t as HarnessId } from "../harness-DwJskkz_.mjs";
 
 //#region src/init/templates.d.ts
 /**
-* Wiring file templates per harness, to register `harness hook <id>` as a
-* tool-use hook. Formats verified against each harness's 2026 hook docs.
+* Wiring file templates per harness, registering `harness hook <id>` for BOTH
+* phases: PRE (gate the edit) and POST (catch-all → `activityFor` filters what
+* to record). Formats verified against each harness's 2026 hook docs.
 */
 /** A file to write during `harness init`. */
 interface InitFile {
@@ -11,23 +12,23 @@ interface InitFile {
   content: string;
   executable?: boolean;
 }
-/** Claude Code: PreToolUse(Write|Edit) -> command. Target: `.claude/settings.json`. */
-declare function claudeInit(command: string): InitFile;
-/** Codex CLI: `.codex/hooks.json` — PreToolUse (Claude-compatible shape). */
-declare function codexInit(command: string): InitFile;
-/** Cursor: `.cursor/hooks.json` (version 1) — shell + file-edit hooks. */
-declare function cursorInit(command: string): InitFile;
-/** Gemini CLI: `.gemini/settings.json` — BeforeTool, timeout in ms. */
-declare function geminiInit(command: string): InitFile;
-/** Cline: an executable `.clinerules/hooks/PreToolUse` that pipes stdin to the command. */
-declare function clineInit(command: string): InitFile;
+/** Claude Code: `.claude/settings.json` — PreToolUse(Write|Edit) + PostToolUse(all). */
+declare function claudeInit(command: string): InitFile[];
+/** Codex CLI: `.codex/hooks.json` (Claude-compatible shape). */
+declare function codexInit(command: string): InitFile[];
+/** Cursor: `.cursor/hooks.json` (version 1) — shell + tool gate + file-edit observe. */
+declare function cursorInit(command: string): InitFile[];
+/** Gemini CLI: `.gemini/settings.json` — BeforeTool(edits) + AfterTool(all, regex). */
+declare function geminiInit(command: string): InitFile[];
+/** Cline: executable `.clinerules/hooks/PreToolUse` + `PostToolUse` piping stdin. */
+declare function clineInit(command: string): InitFile[];
 //#endregion
 //#region src/init/run.d.ts
 /**
-* Build the wiring file for a harness, or null when it has no hook integration
-* (cli-mode harnesses use `harness check` in a pre-commit step instead).
+* Build the wiring file(s) for a harness, or null when it has no hook
+* integration (cli-mode harnesses use `harness check` in a pre-commit step).
 */
-declare function initFor(id: HarnessId, command?: string): InitFile | null;
+declare function initFor(id: HarnessId, command?: string): InitFile[] | null;
 /** Write an {@link InitFile} under `root` (creates dirs; `chmod +x` when executable). */
 declare function writeInitFile(root: string, file: InitFile): string;
 //#endregion

package/dist/init/index.mjs

@@ -1,2 +1,2 @@
-import { a as codexInit, i as clineInit, n as writeInitFile, o as cursorInit, r as claudeInit, s as geminiInit, t as initFor } from "../run-Cc98348q.mjs";
+import { a as codexInit, i as clineInit, n as writeInitFile, o as cursorInit, r as claudeInit, s as geminiInit, t as initFor } from "../run-Cdp2Ef9B.mjs";
 export { claudeInit, clineInit, codexInit, cursorInit, geminiInit, initFor, writeInitFile };

package/dist/loader-BephwI8n.mjs

@@ -0,0 +1,47 @@
+import { i as parseFrontmatter } from "./router-Dj3AfgBE.mjs";
+import { join } from "node:path";
+import { readFile, readdir } from "node:fs/promises";
+//#region src/refs/loader.ts
+function pick(fm, ...keys) {
+	for (const k of keys) {
+		const v = fm[k];
+		if (v) return v;
+	}
+	return "";
+}
+/** Build a {@link RefMeta} from parsed frontmatter, tolerant of kebab/camel keys. */
+function toRefMeta(fm, filePath) {
+	return {
+		name: pick(fm, "name") || filePath,
+		description: pick(fm, "description"),
+		keywords: pick(fm, "keywords"),
+		priority: pick(fm, "priority"),
+		related: pick(fm, "related"),
+		appliesTo: pick(fm, "appliesTo", "applies-to", "applies_to"),
+		triggerOnEdit: pick(fm, "triggerOnEdit", "trigger-on-edit", "trigger_on_edit"),
+		level: pick(fm, "level"),
+		filePath
+	};
+}
+/**
+* Scan a directory recursively for `.md` reference files and parse each into a
+* {@link RefMeta}. The content is entirely the consumer's — point this at any
+* refs dir (`FUSE_HARNESS_REFS`). Returns an empty list when the dir is absent.
+*/
+async function loadRefs(dir) {
+	let entries;
+	try {
+		entries = await readdir(dir, { recursive: true });
+	} catch {
+		return [];
+	}
+	const refs = [];
+	for (const rel of entries) {
+		if (!rel.endsWith(".md")) continue;
+		const filePath = join(dir, rel);
+		refs.push(toRefMeta(parseFrontmatter(await readFile(filePath, "utf8")), filePath));
+	}
+	return refs;
+}
+//#endregion
+export { toRefMeta as n, loadRefs as t };

package/dist/refs/index.d.mts

@@ -1,3 +1,3 @@
 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 };
+import { a as globToRe, i as scoreReferences, n as toRefMeta, o as parseFrontmatter, r as routeReferences, t as loadRefs } from "../index-hL_r6tlc.mjs";
+export { RefMeta, RouteResult, ScoredRef, globToRe, loadRefs, parseFrontmatter, routeReferences, scoreReferences, toRefMeta };

package/dist/refs/index.mjs

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

package/dist/run-Cdp2Ef9B.mjs

@@ -0,0 +1,128 @@
+import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/init/templates.ts
+function json(obj) {
+	return `${JSON.stringify(obj, null, 2)}\n`;
+}
+/** Claude Code: `.claude/settings.json` — PreToolUse(Write|Edit) + PostToolUse(all). */
+function claudeInit(command) {
+	return [{
+		path: ".claude/settings.json",
+		content: json({ hooks: {
+			PreToolUse: [{
+				matcher: "Write|Edit",
+				hooks: [{
+					type: "command",
+					command
+				}]
+			}],
+			PostToolUse: [{
+				matcher: "",
+				hooks: [{
+					type: "command",
+					command
+				}]
+			}]
+		} })
+	}];
+}
+/** Codex CLI: `.codex/hooks.json` (Claude-compatible shape). */
+function codexInit(command) {
+	return [{
+		path: ".codex/hooks.json",
+		content: json({ hooks: {
+			PreToolUse: [{
+				matcher: "Bash|apply_patch",
+				hooks: [{
+					type: "command",
+					command
+				}]
+			}],
+			PostToolUse: [{
+				matcher: "",
+				hooks: [{
+					type: "command",
+					command
+				}]
+			}]
+		} })
+	}];
+}
+/** Cursor: `.cursor/hooks.json` (version 1) — shell + tool gate + file-edit observe. */
+function cursorInit(command) {
+	return [{
+		path: ".cursor/hooks.json",
+		content: json({
+			version: 1,
+			hooks: {
+				beforeShellExecution: [{ command }],
+				preToolUse: [{ command }],
+				afterFileEdit: [{ command }]
+			}
+		})
+	}];
+}
+/** Gemini CLI: `.gemini/settings.json` — BeforeTool(edits) + AfterTool(all, regex). */
+function geminiInit(command) {
+	return [{
+		path: ".gemini/settings.json",
+		content: json({ hooks: {
+			BeforeTool: [{
+				matcher: "write_file|edit_file|replace",
+				hooks: [{
+					type: "command",
+					command,
+					timeout: 3e4
+				}]
+			}],
+			AfterTool: [{
+				matcher: ".*",
+				hooks: [{
+					type: "command",
+					command,
+					timeout: 3e4
+				}]
+			}]
+		} })
+	}];
+}
+/** Cline: executable `.clinerules/hooks/PreToolUse` + `PostToolUse` piping stdin. */
+function clineInit(command) {
+	const script = (phase) => `#!/usr/bin/env bash\n# fuse-harness Cline ${phase} hook\ncat | ${command}\n`;
+	return [{
+		path: ".clinerules/hooks/PreToolUse",
+		content: script("pre"),
+		executable: true
+	}, {
+		path: ".clinerules/hooks/PostToolUse",
+		content: script("post"),
+		executable: true
+	}];
+}
+//#endregion
+//#region src/init/run.ts
+const RUNNERS = {
+	"claude-code": claudeInit,
+	codex: codexInit,
+	cursor: cursorInit,
+	"gemini-cli": geminiInit,
+	cline: clineInit
+};
+/**
+* Build the wiring file(s) for a harness, or null when it has no hook
+* integration (cli-mode harnesses use `harness check` in a pre-commit step).
+*/
+function initFor(id, command = `npx harness hook ${id}`) {
+	const make = RUNNERS[id];
+	return make ? make(command) : null;
+}
+/** Write an {@link InitFile} under `root` (creates dirs; `chmod +x` when executable). */
+function writeInitFile(root, file) {
+	const full = join(root, file.path);
+	mkdirSync(dirname(full), { recursive: true });
+	writeFileSync(full, file.content);
+	if (file.executable) chmodSync(full, 493);
+	return full;
+}
+//#endregion
+export { codexInit as a, clineInit as i, writeInitFile as n, cursorInit as o, claudeInit as r, geminiInit as s, initFor as t };

package/dist/runtime/index.d.mts

@@ -107,6 +107,8 @@ declare function respond(id: string, prompt: Prompt): string;
 interface HandleOptions {
   now: number;
   cwd: string;
+  /** Directory of SOLID reference `.md` files for `solidReadGate` (else inert). */
+  refsDir?: string;
 }
 /** What the hook bin should print + exit with. */
 interface HandleOutcome {

package/dist/runtime/index.mjs

@@ -1,2 +1,2 @@
-import { a as trackFile, c as REQUIRED_AGENTS, i as recordActivity, l as gate, n as harnessTrackDir, o as normalizeEvent, r as respond, s as DEFAULT_WINDOW_MS, t as handleHook, u as activityFor } from "../handle-BGe0QZvQ.mjs";
+import { a as trackFile, c as REQUIRED_AGENTS, i as recordActivity, l as gate, n as harnessTrackDir, o as normalizeEvent, r as respond, s as DEFAULT_WINDOW_MS, t as handleHook, u as activityFor } from "../handle-Lz_thVKr.mjs";
 export { DEFAULT_WINDOW_MS, REQUIRED_AGENTS, activityFor, gate, handleHook, harnessTrackDir, normalizeEvent, recordActivity, respond, trackFile };

package/package.json

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

package/dist/run-Cc98348q.mjs

@@ -1,94 +0,0 @@
-import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-//#region src/init/templates.ts
-function json(obj) {
-	return `${JSON.stringify(obj, null, 2)}\n`;
-}
-/** Claude Code: PreToolUse(Write|Edit) -> command. Target: `.claude/settings.json`. */
-function claudeInit(command) {
-	return {
-		path: ".claude/settings.json",
-		content: json({ hooks: { PreToolUse: [{
-			matcher: "Write|Edit",
-			hooks: [{
-				type: "command",
-				command
-			}]
-		}] } })
-	};
-}
-/** Codex CLI: `.codex/hooks.json` — PreToolUse (Claude-compatible shape). */
-function codexInit(command) {
-	return {
-		path: ".codex/hooks.json",
-		content: json({ hooks: { PreToolUse: [{
-			matcher: "Bash|apply_patch",
-			hooks: [{
-				type: "command",
-				command
-			}]
-		}] } })
-	};
-}
-/** Cursor: `.cursor/hooks.json` (version 1) — shell + file-edit hooks. */
-function cursorInit(command) {
-	return {
-		path: ".cursor/hooks.json",
-		content: json({
-			version: 1,
-			hooks: {
-				beforeShellExecution: [{ command }],
-				afterFileEdit: [{ command }]
-			}
-		})
-	};
-}
-/** Gemini CLI: `.gemini/settings.json` — BeforeTool, timeout in ms. */
-function geminiInit(command) {
-	return {
-		path: ".gemini/settings.json",
-		content: json({ hooks: { BeforeTool: [{
-			matcher: "write_file|edit_file|replace",
-			hooks: [{
-				type: "command",
-				command,
-				timeout: 3e4
-			}]
-		}] } })
-	};
-}
-/** Cline: an executable `.clinerules/hooks/PreToolUse` that pipes stdin to the command. */
-function clineInit(command) {
-	return {
-		path: ".clinerules/hooks/PreToolUse",
-		content: `#!/usr/bin/env bash\n# fuse-harness Cline hook — evaluate each tool use\ncat | ${command}\n`,
-		executable: true
-	};
-}
-//#endregion
-//#region src/init/run.ts
-const RUNNERS = {
-	"claude-code": claudeInit,
-	codex: codexInit,
-	cursor: cursorInit,
-	"gemini-cli": geminiInit,
-	cline: clineInit
-};
-/**
-* Build the wiring file for a harness, or null when it has no hook integration
-* (cli-mode harnesses use `harness check` in a pre-commit step instead).
-*/
-function initFor(id, command = `npx harness hook ${id}`) {
-	const make = RUNNERS[id];
-	return make ? make(command) : null;
-}
-/** Write an {@link InitFile} under `root` (creates dirs; `chmod +x` when executable). */
-function writeInitFile(root, file) {
-	const full = join(root, file.path);
-	mkdirSync(dirname(full), { recursive: true });
-	writeFileSync(full, file.content);
-	if (file.executable) chmodSync(full, 493);
-	return full;
-}
-//#endregion
-export { codexInit as a, clineInit as i, writeInitFile as n, cursorInit as o, claudeInit as r, geminiInit as s, initFor as t };