@fusengine/harness 0.1.1 → 0.1.3

package/dist/config/index.d.mts

@@ -1,37 +1,2 @@
-//#region src/config/env.d.ts
-/**
-* Robust integer-from-env parser.
-* undefined / empty / whitespace / NaN / float / <= 0 all fall back to `fallback`.
-* `Number("")` is 0, so the empty guard is required before `Number()`.
-*/
-declare function parseEnvInt(raw: string | undefined, fallback: number): number;
-//#endregion
-//#region src/config/ttl.d.ts
-/** Default enforcement-freshness window, in seconds (2 minutes). */
-declare const DEFAULT_TTL_SEC = 120;
-/** Default env var name carrying the TTL override. */
-declare const TTL_ENV_KEY = "FUSE_ENFORCE_TTL_SEC";
-/**
-* Resolve the enforcement TTL (seconds) from an env map.
-* @param env - environment map (defaults to `process.env`)
-* @param key - env var name (defaults to `FUSE_ENFORCE_TTL_SEC`)
-*/
-declare function resolveTtlSec(env?: Record<string, string | undefined>, key?: string): number;
-/** Human label for a TTL: 120 -> "2min", 240 -> "4min", 90 -> "90s". */
-declare function ttlLabel(sec: number): string;
-//#endregion
-//#region src/config/limits.d.ts
-/** Default SOLID max lines per file. */
-declare const DEFAULT_MAX_LINES = 100;
-/** Default env var name carrying the max-lines override. */
-declare const MAX_LINES_ENV_KEY = "FUSE_SOLID_MAX_LINES";
-/**
-* Resolve the SOLID max-lines limit from an env map.
-* @param env - environment map (defaults to `process.env`)
-* @param key - env var name (defaults to `FUSE_SOLID_MAX_LINES`)
-*/
-declare function resolveMaxLines(env?: Record<string, string | undefined>, key?: string): number;
-/** Advisory module-split headroom = `maxLines - 10` (never below 1). */
-declare function splitTarget(maxLines: number): number;
-//#endregion
+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";
 export { DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, MAX_LINES_ENV_KEY, TTL_ENV_KEY, parseEnvInt, resolveMaxLines, resolveTtlSec, splitTarget, ttlLabel };

package/dist/config/index.mjs

@@ -1,20 +1,3 @@
 import { a as parseEnvInt, i as splitTarget, n as MAX_LINES_ENV_KEY, r as resolveMaxLines, t as DEFAULT_MAX_LINES } from "../limits-CHn8AIL1.mjs";
-//#region src/config/ttl.ts
-/** Default enforcement-freshness window, in seconds (2 minutes). */
-const DEFAULT_TTL_SEC = 120;
-/** Default env var name carrying the TTL override. */
-const TTL_ENV_KEY = "FUSE_ENFORCE_TTL_SEC";
-/**
-* Resolve the enforcement TTL (seconds) from an env map.
-* @param env - environment map (defaults to `process.env`)
-* @param key - env var name (defaults to `FUSE_ENFORCE_TTL_SEC`)
-*/
-function resolveTtlSec(env = process.env, key = TTL_ENV_KEY) {
-	return parseEnvInt(env[key], 120);
-}
-/** Human label for a TTL: 120 -> "2min", 240 -> "4min", 90 -> "90s". */
-function ttlLabel(sec) {
-	return sec % 60 === 0 ? `${sec / 60}min` : `${sec}s`;
-}
-//#endregion
+import { i as ttlLabel, n as TTL_ENV_KEY, r as resolveTtlSec, t as DEFAULT_TTL_SEC } from "../config-BG55s6HZ.mjs";
 export { DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, MAX_LINES_ENV_KEY, TTL_ENV_KEY, parseEnvInt, resolveMaxLines, resolveTtlSec, splitTarget, ttlLabel };

package/dist/config-BG55s6HZ.mjs

@@ -0,0 +1,20 @@
+import { a as parseEnvInt } from "./limits-CHn8AIL1.mjs";
+//#region src/config/ttl.ts
+/** Default enforcement-freshness window, in seconds (2 minutes). */
+const DEFAULT_TTL_SEC = 120;
+/** Default env var name carrying the TTL override. */
+const TTL_ENV_KEY = "FUSE_ENFORCE_TTL_SEC";
+/**
+* Resolve the enforcement TTL (seconds) from an env map.
+* @param env - environment map (defaults to `process.env`)
+* @param key - env var name (defaults to `FUSE_ENFORCE_TTL_SEC`)
+*/
+function resolveTtlSec(env = process.env, key = TTL_ENV_KEY) {
+	return parseEnvInt(env[key], 120);
+}
+/** Human label for a TTL: 120 -> "2min", 240 -> "4min", 90 -> "90s". */
+function ttlLabel(sec) {
+	return sec % 60 === 0 ? `${sec / 60}min` : `${sec}s`;
+}
+//#endregion
+export { ttlLabel as i, TTL_ENV_KEY as n, resolveTtlSec as r, DEFAULT_TTL_SEC as t };

package/dist/cursor-Bh7eh9y_.mjs

@@ -0,0 +1,37 @@
+import { t as evaluate } from "./evaluate-CsYyUucy.mjs";
+import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
+//#region src/adapters/cursor/index.ts
+/**
+* Cursor adapter (hook-mode). Schemas per cursor.com/docs/hooks (2026):
+* `beforeShellExecution` can block; `afterFileEdit` is observe-only.
+*/
+function toPermission(kind) {
+	return kind === "block" ? "deny" : kind === "ask" ? "ask" : "allow";
+}
+/** Guard a shell command (git/install policies). */
+function beforeShellExecution(payload) {
+	const r = evaluate({
+		tool: "Bash",
+		command: payload.command
+	});
+	if (r.decision === "allow" || !r.prompt) return { permission: "allow" };
+	const msg = formatPrompt(r.prompt);
+	return {
+		permission: toPermission(r.prompt.kind),
+		continue: false,
+		userMessage: msg,
+		agentMessage: msg
+	};
+}
+/** Observe a file edit (Cursor cannot block here). Returns the verdict for logging. */
+function afterFileEdit(payload) {
+	const content = payload.edits?.map((e) => e.new_string).join("\n") ?? "";
+	const r = evaluate({
+		tool: "Edit",
+		filePath: payload.file_path,
+		content
+	});
+	return { violation: r.decision === "deny" ? r.message : null };
+}
+//#endregion
+export { beforeShellExecution as n, afterFileEdit as t };

package/dist/detect/index.d.mts

@@ -1,31 +1,2 @@
-//#region src/detect/harness.d.ts
-/**
-* Runtime detection of the AI coding harness, and its integration mode.
-* Env-signal names verified 2026 (agentx, agents.md#136, @vercel/detect-agent,
-* official Claude Code / Cursor / Gemini / Codex docs). Presence-based: the
-* value is ignored except for the `AGENT` / `AI_AGENT` standards.
-*/
-/** Known AI coding harnesses detectable at runtime. */
-type HarnessId = "claude-code" | "codex" | "cursor" | "cline" | "gemini-cli" | "opencode" | "windsurf" | "copilot" | "aider" | "kiro" | "goose" | "amp" | "unknown";
-/** Integration mode: `hook` = native lifecycle hooks; `cli` = run as an external step. */
-type HarnessMode = "hook" | "cli";
-/** How the harness was identified. */
-type HarnessVia = "agent-std" | "ai-agent-std" | "env" | "fallback";
-/** Result of {@link detectHarness}. */
-interface HarnessInfo {
-  id: HarnessId;
-  mode: HarnessMode;
-  via: HarnessVia;
-}
-/** Integration mode for a harness id. */
-declare function modeFor(id: HarnessId): HarnessMode;
-/**
-* Detect the current AI coding harness from environment signals.
-* Priority: `AGENT` standard -> `AI_AGENT` standard -> tool-specific vars -> unknown.
-* @param env - environment map (defaults to `process.env`)
-*/
-declare function detectHarness(env?: Record<string, string | undefined>): HarnessInfo;
-/** Convenience: the integration mode of the current harness. */
-declare function detectMode(env?: Record<string, string | undefined>): HarnessMode;
-//#endregion
+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";
 export { HarnessId, HarnessInfo, HarnessMode, HarnessVia, detectHarness, detectMode, modeFor };

package/dist/detect/index.mjs

@@ -1,82 +1,3 @@
-//#region src/detect/harness.ts
-/** Tool-specific env var (presence) -> harness id. Order = detection priority. */
-const ENV_SIGNALS = [
-	["CLAUDECODE", "claude-code"],
-	["CODEX_SANDBOX", "codex"],
-	["CURSOR_AGENT", "cursor"],
-	["CLINE", "cline"],
-	["CLINE_AGENT", "cline"],
-	["GEMINI_CLI", "gemini-cli"],
-	["OPENCODE", "opencode"],
-	["WINDSURF_AGENT", "windsurf"],
-	["CODEIUM_AGENT", "windsurf"],
-	["COPILOT_AGENT", "copilot"],
-	["AIDER", "aider"],
-	["KIRO", "kiro"],
-	["GOOSE", "goose"],
-	["AMP", "amp"]
-];
-/** `AGENT=<name>` / `AI_AGENT=<name>` standard value -> harness id. */
-const STD_NAMES = {
-	goose: "goose",
-	amp: "amp",
-	claude: "claude-code",
-	"claude-code": "claude-code",
-	cursor: "cursor",
-	codex: "codex",
-	cline: "cline",
-	aider: "aider",
-	opencode: "opencode",
-	gemini: "gemini-cli",
-	copilot: "copilot",
-	kiro: "kiro"
-};
-/** Harnesses exposing a native hook system (vs CLI-only integration). */
-const HOOK_CAPABLE = /* @__PURE__ */ new Set([
-	"claude-code",
-	"cursor",
-	"cline",
-	"gemini-cli",
-	"opencode"
-]);
-/** Integration mode for a harness id. */
-function modeFor(id) {
-	return HOOK_CAPABLE.has(id) ? "hook" : "cli";
-}
-/**
-* Detect the current AI coding harness from environment signals.
-* Priority: `AGENT` standard -> `AI_AGENT` standard -> tool-specific vars -> unknown.
-* @param env - environment map (defaults to `process.env`)
-*/
-function detectHarness(env = process.env) {
-	const agent = env.AGENT?.trim().toLowerCase();
-	const agentId = agent ? STD_NAMES[agent] : void 0;
-	if (agentId) return {
-		id: agentId,
-		mode: modeFor(agentId),
-		via: "agent-std"
-	};
-	const ai = env.AI_AGENT?.trim().toLowerCase();
-	const aiId = ai ? STD_NAMES[ai] : void 0;
-	if (aiId) return {
-		id: aiId,
-		mode: modeFor(aiId),
-		via: "ai-agent-std"
-	};
-	for (const [key, id] of ENV_SIGNALS) if (env[key]?.trim()) return {
-		id,
-		mode: modeFor(id),
-		via: "env"
-	};
-	return {
-		id: "unknown",
-		mode: "cli",
-		via: "fallback"
-	};
-}
-/** Convenience: the integration mode of the current harness. */
-function detectMode(env = process.env) {
-	return detectHarness(env).mode;
-}
-//#endregion
+import { n as detectMode, r as modeFor, t as detectHarness } from "../harness-C8Nxxyn_.mjs";
+import "../detect-la_KkjCS.mjs";
 export { detectHarness, detectMode, modeFor };

package/dist/detect-la_KkjCS.mjs

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

package/dist/doc-helpers-Dd_x1-tZ.mjs

@@ -0,0 +1,42 @@
+//#region src/freshness/doc-helpers.ts
+/** Resolve the sessions array from an auth entry (legacy fallback). */
+function resolveSessions(auth) {
+	if (!auth) return [];
+	return auth.sessions ?? (auth.session ? [auth.session] : []);
+}
+function sessionAuthsFor(authorizations, sessionId) {
+	if (!authorizations) return [];
+	return Object.values(authorizations).filter((a) => a.doc_sessions?.includes(sessionId));
+}
+function evaluateDoc(auths) {
+	const sources = auths.flatMap((a) => a.sources ?? [a.source ?? ""]);
+	const readPaths = auths.flatMap((a) => a.read_paths ?? []);
+	const liveC7 = sources.some((s) => /context7/.test(s));
+	const liveExa = sources.some((s) => /exa/.test(s));
+	const cacheC7 = readPaths.some((p) => /\/context\/mcp\/context7-/.test(p));
+	const cacheExa = readPaths.some((p) => /\/context\/mcp\/(exa-search|exa-code-context)-/.test(p));
+	return {
+		context7: liveC7 || cacheC7,
+		exa: liveExa || cacheExa,
+		viaCache: !liveC7 && cacheC7 || !liveExa && cacheExa
+	};
+}
+/** True when BOTH Context7 and Exa were satisfied for the session. */
+function isDocConsulted(authorizations, sessionId) {
+	const s = evaluateDoc(sessionAuthsFor(authorizations, sessionId));
+	return s.context7 && s.exa;
+}
+/** Report how each doc source was satisfied for a session. */
+function formatDocSatisfactionStatus(authorizations, sessionId) {
+	return evaluateDoc(sessionAuthsFor(authorizations, sessionId));
+}
+/** Deny message when online documentation has not been consulted. */
+function formatDocDeny(framework) {
+	return [
+		`APEX: Online documentation not consulted for ${framework}!`,
+		"Use BOTH: 1) mcp__context7__query-docs AND 2) mcp__exa__web_search_exa.",
+		"This check is once per session — after consulting both, Write/Edit will be allowed."
+	].join("\n");
+}
+//#endregion
+export { resolveSessions as i, formatDocSatisfactionStatus as n, isDocConsulted as r, formatDocDeny as t };

package/dist/freshness/index.d.mts

@@ -1,14 +1,3 @@
 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";
-
-//#region src/freshness/trivial-edit-counter.d.ts
-/**
-* Increment a session's trivial-edit counter, evicting timestamps older than
-* `windowMs`. Decoupled + injectable `now` for testability.
-* @param filePath - session state file path
-* @param windowMs - sliding window in ms
-* @param now - current epoch ms (defaults to `Date.now()`)
-* @returns number of trivial edits within the window (including this one)
-*/
-declare function incrementTrivialEditCounter(filePath: string, windowMs: number, now?: number): Promise<number>;
-//#endregion
+import { t as incrementTrivialEditCounter } from "../index-BOBXQ91y.mjs";
 export { AuthEntry, DocSatisfactionStatus, formatDocDeny, formatDocSatisfactionStatus, incrementTrivialEditCounter, isDocConsulted, resolveSessions };

package/dist/freshness/index.mjs

@@ -1,64 +1,3 @@
-import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "../json-io-RH82El2J.mjs";
-import { dirname } from "node:path";
-//#region src/freshness/doc-helpers.ts
-/** Resolve the sessions array from an auth entry (legacy fallback). */
-function resolveSessions(auth) {
-	if (!auth) return [];
-	return auth.sessions ?? (auth.session ? [auth.session] : []);
-}
-function sessionAuthsFor(authorizations, sessionId) {
-	if (!authorizations) return [];
-	return Object.values(authorizations).filter((a) => a.doc_sessions?.includes(sessionId));
-}
-function evaluateDoc(auths) {
-	const sources = auths.flatMap((a) => a.sources ?? [a.source ?? ""]);
-	const readPaths = auths.flatMap((a) => a.read_paths ?? []);
-	const liveC7 = sources.some((s) => /context7/.test(s));
-	const liveExa = sources.some((s) => /exa/.test(s));
-	const cacheC7 = readPaths.some((p) => /\/context\/mcp\/context7-/.test(p));
-	const cacheExa = readPaths.some((p) => /\/context\/mcp\/(exa-search|exa-code-context)-/.test(p));
-	return {
-		context7: liveC7 || cacheC7,
-		exa: liveExa || cacheExa,
-		viaCache: !liveC7 && cacheC7 || !liveExa && cacheExa
-	};
-}
-/** True when BOTH Context7 and Exa were satisfied for the session. */
-function isDocConsulted(authorizations, sessionId) {
-	const s = evaluateDoc(sessionAuthsFor(authorizations, sessionId));
-	return s.context7 && s.exa;
-}
-/** Report how each doc source was satisfied for a session. */
-function formatDocSatisfactionStatus(authorizations, sessionId) {
-	return evaluateDoc(sessionAuthsFor(authorizations, sessionId));
-}
-/** Deny message when online documentation has not been consulted. */
-function formatDocDeny(framework) {
-	return [
-		`APEX: Online documentation not consulted for ${framework}!`,
-		"Use BOTH: 1) mcp__context7__query-docs AND 2) mcp__exa__web_search_exa.",
-		"This check is once per session — after consulting both, Write/Edit will be allowed."
-	].join("\n");
-}
-//#endregion
-//#region src/freshness/trivial-edit-counter.ts
-/**
-* Increment a session's trivial-edit counter, evicting timestamps older than
-* `windowMs`. Decoupled + injectable `now` for testability.
-* @param filePath - session state file path
-* @param windowMs - sliding window in ms
-* @param now - current epoch ms (defaults to `Date.now()`)
-* @returns number of trivial edits within the window (including this one)
-*/
-async function incrementTrivialEditCounter(filePath, windowMs, now = Date.now()) {
-	await ensureDir(dirname(filePath));
-	const state = await readJsonFile(filePath) ?? {};
-	const cutoff = now - windowMs;
-	const edits = (state.trivial_edits ?? []).filter((ts) => ts > cutoff);
-	edits.push(now);
-	state.trivial_edits = edits;
-	await writeJsonFile(filePath, state);
-	return edits.length;
-}
-//#endregion
+import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "../doc-helpers-Dd_x1-tZ.mjs";
+import { t as incrementTrivialEditCounter } from "../freshness-BK9Xg6oG.mjs";
 export { formatDocDeny, formatDocSatisfactionStatus, incrementTrivialEditCounter, isDocConsulted, resolveSessions };

package/dist/freshness-BK9Xg6oG.mjs

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

package/dist/gemini-SrK_fFAr.mjs

@@ -0,0 +1,25 @@
+import { t as evaluate } from "./evaluate-CsYyUucy.mjs";
+import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
+//#region src/adapters/gemini/index.ts
+/**
+* Gemini CLI adapter (hook-mode). Schema per google-gemini/gemini-cli docs/hooks (2026):
+* `BeforeTool` blocks via `{ decision: "deny", reason }` (or exit 2).
+*/
+/** Evaluate a tool use; deny on a hard block, otherwise inject context. */
+function beforeTool(input) {
+	const i = input.tool_input;
+	const r = evaluate({
+		tool: input.tool_name ?? "write_file",
+		filePath: i?.path,
+		content: i?.content,
+		command: i?.command
+	});
+	if (r.decision === "allow" || !r.prompt) return {};
+	const msg = formatPrompt(r.prompt);
+	return r.prompt.kind === "block" ? {
+		decision: "deny",
+		reason: msg
+	} : { hookSpecificOutput: { additionalContext: msg } };
+}
+//#endregion
+export { beforeTool as t };

package/dist/harness-C8Nxxyn_.mjs

@@ -0,0 +1,83 @@
+//#region src/detect/harness.ts
+/** Tool-specific env var (presence) -> harness id. Order = detection priority. */
+const ENV_SIGNALS = [
+	["CLAUDECODE", "claude-code"],
+	["CODEX_SANDBOX", "codex"],
+	["CURSOR_AGENT", "cursor"],
+	["CLINE", "cline"],
+	["CLINE_AGENT", "cline"],
+	["GEMINI_CLI", "gemini-cli"],
+	["OPENCODE", "opencode"],
+	["WINDSURF_AGENT", "windsurf"],
+	["CODEIUM_AGENT", "windsurf"],
+	["COPILOT_AGENT", "copilot"],
+	["AIDER", "aider"],
+	["KIRO", "kiro"],
+	["GOOSE", "goose"],
+	["AMP", "amp"]
+];
+/** `AGENT=<name>` / `AI_AGENT=<name>` standard value -> harness id. */
+const STD_NAMES = {
+	goose: "goose",
+	amp: "amp",
+	claude: "claude-code",
+	"claude-code": "claude-code",
+	cursor: "cursor",
+	codex: "codex",
+	cline: "cline",
+	aider: "aider",
+	opencode: "opencode",
+	gemini: "gemini-cli",
+	copilot: "copilot",
+	kiro: "kiro"
+};
+/** Harnesses exposing a native hook system (vs CLI-only integration). */
+const HOOK_CAPABLE = /* @__PURE__ */ new Set([
+	"claude-code",
+	"codex",
+	"cursor",
+	"cline",
+	"gemini-cli",
+	"opencode"
+]);
+/** Integration mode for a harness id. */
+function modeFor(id) {
+	return HOOK_CAPABLE.has(id) ? "hook" : "cli";
+}
+/**
+* Detect the current AI coding harness from environment signals.
+* Priority: `AGENT` standard -> `AI_AGENT` standard -> tool-specific vars -> unknown.
+* @param env - environment map (defaults to `process.env`)
+*/
+function detectHarness(env = process.env) {
+	const agent = env.AGENT?.trim().toLowerCase();
+	const agentId = agent ? STD_NAMES[agent] : void 0;
+	if (agentId) return {
+		id: agentId,
+		mode: modeFor(agentId),
+		via: "agent-std"
+	};
+	const ai = env.AI_AGENT?.trim().toLowerCase();
+	const aiId = ai ? STD_NAMES[ai] : void 0;
+	if (aiId) return {
+		id: aiId,
+		mode: modeFor(aiId),
+		via: "ai-agent-std"
+	};
+	for (const [key, id] of ENV_SIGNALS) if (env[key]?.trim()) return {
+		id,
+		mode: modeFor(id),
+		via: "env"
+	};
+	return {
+		id: "unknown",
+		mode: "cli",
+		via: "fallback"
+	};
+}
+/** Convenience: the integration mode of the current harness. */
+function detectMode(env = process.env) {
+	return detectHarness(env).mode;
+}
+//#endregion
+export { detectMode as n, modeFor as r, detectHarness as t };

package/dist/harness-DwJskkz_.d.mts

@@ -0,0 +1,31 @@
+//#region src/detect/harness.d.ts
+/**
+* Runtime detection of the AI coding harness, and its integration mode.
+* Env-signal names verified 2026 (agentx, agents.md#136, @vercel/detect-agent,
+* official Claude Code / Cursor / Gemini / Codex docs). Presence-based: the
+* value is ignored except for the `AGENT` / `AI_AGENT` standards.
+*/
+/** Known AI coding harnesses detectable at runtime. */
+type HarnessId = "claude-code" | "codex" | "cursor" | "cline" | "gemini-cli" | "opencode" | "windsurf" | "copilot" | "aider" | "kiro" | "goose" | "amp" | "unknown";
+/** Integration mode: `hook` = native lifecycle hooks; `cli` = run as an external step. */
+type HarnessMode = "hook" | "cli";
+/** How the harness was identified. */
+type HarnessVia = "agent-std" | "ai-agent-std" | "env" | "fallback";
+/** Result of {@link detectHarness}. */
+interface HarnessInfo {
+  id: HarnessId;
+  mode: HarnessMode;
+  via: HarnessVia;
+}
+/** Integration mode for a harness id. */
+declare function modeFor(id: HarnessId): HarnessMode;
+/**
+* Detect the current AI coding harness from environment signals.
+* Priority: `AGENT` standard -> `AI_AGENT` standard -> tool-specific vars -> unknown.
+* @param env - environment map (defaults to `process.env`)
+*/
+declare function detectHarness(env?: Record<string, string | undefined>): HarnessInfo;
+/** Convenience: the integration mode of the current harness. */
+declare function detectMode(env?: Record<string, string | undefined>): HarnessMode;
+//#endregion
+export { detectHarness as a, HarnessVia as i, HarnessInfo as n, detectMode as o, HarnessMode as r, modeFor as s, HarnessId as t };

package/dist/index-B-z0CCiU.d.mts

@@ -0,0 +1,37 @@
+//#region src/config/env.d.ts
+/**
+* Robust integer-from-env parser.
+* undefined / empty / whitespace / NaN / float / <= 0 all fall back to `fallback`.
+* `Number("")` is 0, so the empty guard is required before `Number()`.
+*/
+declare function parseEnvInt(raw: string | undefined, fallback: number): number;
+//#endregion
+//#region src/config/ttl.d.ts
+/** Default enforcement-freshness window, in seconds (2 minutes). */
+declare const DEFAULT_TTL_SEC = 120;
+/** Default env var name carrying the TTL override. */
+declare const TTL_ENV_KEY = "FUSE_ENFORCE_TTL_SEC";
+/**
+* Resolve the enforcement TTL (seconds) from an env map.
+* @param env - environment map (defaults to `process.env`)
+* @param key - env var name (defaults to `FUSE_ENFORCE_TTL_SEC`)
+*/
+declare function resolveTtlSec(env?: Record<string, string | undefined>, key?: string): number;
+/** Human label for a TTL: 120 -> "2min", 240 -> "4min", 90 -> "90s". */
+declare function ttlLabel(sec: number): string;
+//#endregion
+//#region src/config/limits.d.ts
+/** Default SOLID max lines per file. */
+declare const DEFAULT_MAX_LINES = 100;
+/** Default env var name carrying the max-lines override. */
+declare const MAX_LINES_ENV_KEY = "FUSE_SOLID_MAX_LINES";
+/**
+* Resolve the SOLID max-lines limit from an env map.
+* @param env - environment map (defaults to `process.env`)
+* @param key - env var name (defaults to `FUSE_SOLID_MAX_LINES`)
+*/
+declare function resolveMaxLines(env?: Record<string, string | undefined>, key?: string): number;
+/** Advisory module-split headroom = `maxLines - 10` (never below 1). */
+declare function splitTarget(maxLines: number): number;
+//#endregion
+export { DEFAULT_TTL_SEC as a, ttlLabel as c, splitTarget as i, parseEnvInt as l, MAX_LINES_ENV_KEY as n, TTL_ENV_KEY as o, resolveMaxLines as r, resolveTtlSec as s, DEFAULT_MAX_LINES as t };

package/dist/index-B3Ve_bBu.d.mts

@@ -0,0 +1,30 @@
+//#region src/cache/compact.d.ts
+/** Strip HTML entities + boilerplate, normalize blank lines, truncate to ~5KB. */
+declare function compactMarkdown(content: string): string;
+/** 8-char MD5 of `${toolName}::${query}`. */
+declare function queryHash(toolName: string, query: string): string;
+/** Bag-of-words Jaccard similarity strictly greater than `threshold`. */
+declare function jaccardSimilar(a: string, b: string, threshold?: number): boolean;
+//#endregion
+//#region src/cache/io.d.ts
+/** Read a JSON array from `path`; [] on missing/corrupt/non-array. */
+declare function loadIndex(path: string): unknown[];
+/** Summary of a cache index. */
+interface IndexSummary {
+  total: number;
+  byTool: Record<string, number>;
+  oldestTs: string | null;
+  newestTs: string | null;
+}
+/** Summarize an index of `{ tool?, ts? }` entries. */
+declare function summarizeIndex(index: unknown[]): IndexSummary;
+//#endregion
+//#region src/cache/mcp-response.d.ts
+/**
+* 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.
+*/
+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 };

package/dist/index-BEM-mQMC.d.mts

@@ -0,0 +1,30 @@
+//#region src/memory/state.d.ts
+/** Per-project reminder throttle state, stored at `<root>/MEMORY/state.json`. */
+interface ReminderState {
+  lastRemindedAt: number;
+  lastCodeEditAt: number;
+}
+/** Absolute path of the per-project throttle state file. */
+declare function stateFileFor(root: string): string;
+/** Read both throttle timestamps; missing/corrupt fields default to 0. */
+declare function readState(file: string): ReminderState;
+/** Persist one field without clobbering the other (read-modify-write). */
+declare function setStateField(file: string, key: keyof ReminderState, value: number): void;
+/** Local wall-clock timestamp for a lesson bullet: `YYYY-MM-DD HH:MM`. */
+declare function nowStamp(): string;
+/** Throttle window (ms) from `FUSE_LESSONS_THROTTLE_MIN` (default 5 min). */
+declare function throttleMs(env?: Record<string, string | undefined>): number;
+//#endregion
+//#region src/memory/registry.d.ts
+/** Absolute path of the global roots registry, or null when home is unusable. */
+declare function registryFile(home?: string | undefined): string | null;
+/** Read the registered project roots (deduplicated string entries only). */
+declare function readRoots(home?: string): string[];
+/** Register a project root once (deduplicated, read-modify-write, non-throwing). */
+declare function addRoot(root: string, home?: string): void;
+//#endregion
+//#region src/memory/gitignore.d.ts
+/** Ensure `<memoryDir>/.gitignore` ignores the machine-local `state.json`. */
+declare function ensureMemoryGitignore(memoryDir: string): void;
+//#endregion
+export { ReminderState as a, setStateField as c, registryFile as i, stateFileFor as l, addRoot as n, nowStamp as o, readRoots as r, readState as s, ensureMemoryGitignore as t, throttleMs as u };

package/dist/index-BKZ67WMa.d.mts

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

package/dist/index-BOBXQ91y.d.mts

@@ -0,0 +1,12 @@
+//#region src/freshness/trivial-edit-counter.d.ts
+/**
+* Increment a session's trivial-edit counter, evicting timestamps older than
+* `windowMs`. Decoupled + injectable `now` for testability.
+* @param filePath - session state file path
+* @param windowMs - sliding window in ms
+* @param now - current epoch ms (defaults to `Date.now()`)
+* @returns number of trivial edits within the window (including this one)
+*/
+declare function incrementTrivialEditCounter(filePath: string, windowMs: number, now?: number): Promise<number>;
+//#endregion
+export { incrementTrivialEditCounter as t };

package/dist/index-BVVgDSdq.d.mts

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