@fusengine/harness 0.1.12 → 0.1.14

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 `<project>/.harness/` (track, cache, memory).
 
-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/adapters/claude/index.mjs

@@ -1,2 +1,2 @@
-import { a as readClaudeInput, i as guard, n as denyResponse, o as toClaudeResponse, r as fileSizeGuard, t as contextResponse } from "../../claude-B3aJwu6O.mjs";
+import { a as readClaudeInput, i as guard, n as denyResponse, o as toClaudeResponse, r as fileSizeGuard, t as contextResponse } from "../../claude-BoZuNxXl.mjs";
 export { contextResponse, denyResponse, fileSizeGuard, guard, readClaudeInput, toClaudeResponse };

package/dist/adapters/cline/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-DkTgwHNh.mjs";
+import { t as evaluate } from "../../evaluate-qGG2Ul0W.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/cline/index.ts
 /**

package/dist/adapters/codex/index.mjs

@@ -1,2 +1,2 @@
-import { a as readClaudeInput, i as guard, n as denyResponse, t as contextResponse } from "../../claude-B3aJwu6O.mjs";
+import { a as readClaudeInput, i as guard, n as denyResponse, t as contextResponse } from "../../claude-BoZuNxXl.mjs";
 export { contextResponse, denyResponse, guard, readClaudeInput as readCodexInput };

package/dist/adapters/cursor/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-DkTgwHNh.mjs";
+import { t as evaluate } from "../../evaluate-qGG2Ul0W.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/cursor/index.ts
 /**

package/dist/adapters/gemini/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-DkTgwHNh.mjs";
+import { t as evaluate } from "../../evaluate-qGG2Ul0W.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/gemini/index.ts
 /**

package/dist/cache/index.mjs

@@ -1,3 +1,3 @@
 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 { a as extractText, i as mcpCacheKey, n as cachePath, r as cacheStore, t as cacheLookup } from "../store-DeIsfMg5.mjs";
 export { cacheLookup, cachePath, cacheStore, compactMarkdown, extractText, jaccardSimilar, loadIndex, mcpCacheKey, queryHash, summarizeIndex };

package/dist/{claude-B3aJwu6O.mjs → claude-BoZuNxXl.mjs}

@@ -1,4 +1,4 @@
-import { t as evaluate } from "./evaluate-DkTgwHNh.mjs";
+import { t as evaluate } from "./evaluate-qGG2Ul0W.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 //#region src/adapters/claude/index.ts
 /**

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-D2na7Z2Z.mjs";
-import { n as writeInitFile, t as initFor } from "../run-Cdp2Ef9B.mjs";
-import { t as handleHook } from "../handle-o5np-3T_.mjs";
+import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-B-_9dPR6.mjs";
+import { n as writeInitFile, t as initFor } from "../run-D91N4ul1.mjs";
+import { t as handleHook } from "../handle-D-DClzB2.mjs";
 //#region src/cli/bin.ts
 /**
 * harness — CLI for @fusengine/harness.

package/dist/cli/index.mjs

@@ -1,2 +1,2 @@
-import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-D2na7Z2Z.mjs";
+import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-B-_9dPR6.mjs";
 export { checkStaged, stagedContent, stagedFiles };

package/dist/config/index.d.mts

@@ -1,2 +1,2 @@
-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 };
+import { a as DEFAULT_MAX_LINES, c as splitTarget, d as resolveTtlSec, f as ttlLabel, i as projectLayout, l as DEFAULT_TTL_SEC, n as STATE_GITIGNORE, o as MAX_LINES_ENV_KEY, p as parseEnvInt, r as STATE_ROOT, s as resolveMaxLines, t as ProjectLayout, u as TTL_ENV_KEY } from "../index-C8dk1Alr.mjs";
+export { DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, MAX_LINES_ENV_KEY, ProjectLayout, STATE_GITIGNORE, STATE_ROOT, TTL_ENV_KEY, parseEnvInt, projectLayout, resolveMaxLines, resolveTtlSec, splitTarget, ttlLabel };

package/dist/config/index.mjs

@@ -1,3 +1,4 @@
 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";
 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 };
+import { n as STATE_ROOT, r as projectLayout, t as STATE_GITIGNORE } from "../layout-C0jaaCQC.mjs";
+export { DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, MAX_LINES_ENV_KEY, STATE_GITIGNORE, STATE_ROOT, TTL_ENV_KEY, parseEnvInt, projectLayout, resolveMaxLines, resolveTtlSec, splitTarget, ttlLabel };

package/dist/{evaluate-DkTgwHNh.mjs → evaluate-qGG2Ul0W.mjs}

@@ -1,5 +1,5 @@
 import { i as splitTarget, r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
-import { t as isCodeFile } from "./project-root-C4ks_q1G.mjs";
+import { t as isCodeFile } from "./project-root-ff0_poWU.mjs";
 //#region src/policy/detect-framework.ts
 /**
 * Detect the framework from a file path extension + content patterns.

package/dist/freshness/index.mjs

@@ -1,3 +1,3 @@
 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";
+import { t as incrementTrivialEditCounter } from "../freshness-CezohJHo.mjs";
 export { formatDocDeny, formatDocSatisfactionStatus, incrementTrivialEditCounter, isDocConsulted, resolveSessions };

package/dist/{freshness-BK9Xg6oG.mjs → freshness-CezohJHo.mjs}

@@ -1,4 +1,4 @@
-import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-RH82El2J.mjs";
+import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-xpTDuvtn.mjs";
 import { dirname } from "node:path";
 //#region src/freshness/trivial-edit-counter.ts
 /**

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

@@ -1,9 +1,10 @@
-import { O as detectFramework, t as evaluate } from "./evaluate-DkTgwHNh.mjs";
+import { r as projectLayout } from "./layout-C0jaaCQC.mjs";
+import { O as detectFramework, t as evaluate } from "./evaluate-qGG2Ul0W.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 { a as extractText, r as cacheStore, t as cacheLookup } from "./store-DeIsfMg5.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 { 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-BnHpq2ZB.mjs";
 import { join } from "node:path";
 import { tmpdir } from "node:os";
 //#region src/runtime/activity.ts
@@ -229,24 +230,6 @@ function respond(id, prompt) {
 	}
 }
 //#endregion
-//#region src/runtime/storage.ts
-/** Per-harness config dir (relative to the project root) where state lives. */
-const STATE_DIR = {
-	"claude-code": ".claude",
-	codex: ".codex",
-	cursor: ".cursor",
-	"gemini-cli": ".gemini",
-	cline: ".clinerules"
-};
-/**
-* Directory where a harness's fuse-harness track files live — under that
-* harness's own config dir (`.claude`, `.codex`, …) so state sits next to its
-* hooks. Falls back to `.fuse-harness` for harnesses without a known config dir.
-*/
-function harnessTrackDir(id, projectRoot) {
-	return join(projectRoot, STATE_DIR[id] ?? ".fuse-harness", "harness");
-}
-//#endregion
 //#region src/runtime/handle.ts
 /**
 * The full hook handler: on a PRE event it gates the tool-use (stateless guards
@@ -256,9 +239,9 @@ function harnessTrackDir(id, projectRoot) {
 */
 async function handleHook(id, payload, opts) {
 	const event = normalizeEvent(id, payload);
-	const dir = harnessTrackDir(id, opts.cwd);
-	const file = trackFile(event.sessionId, dir);
-	const mcpDir = join(dir, "mcp");
+	const layout = projectLayout(opts.cwd);
+	const file = trackFile(event.sessionId, layout.trackDir);
+	const mcpDir = layout.cacheDir;
 	const framework = detectFramework(event.filePath ?? "", event.content ?? "");
 	if (event.phase === "post") {
 		mcpPostStore(event.tool, event.input, payload.tool_response ?? payload.tool_output, mcpDir);
@@ -301,4 +284,4 @@ async function handleHook(id, payload, opts) {
 	};
 }
 //#endregion
-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 };
+export { normalizeEvent as a, mcpPostStore as c, DEFAULT_WINDOW_MS as d, REQUIRED_AGENTS as f, activityFor as h, trackFile as i, mcpPreIntercept as l, gate as m, respond as n, MCP_TTL_MS as o, TRIVIAL_BUDGET as p, recordActivity as r, isMcpTool as s, handleHook as t, queryOf as u };

package/dist/index-C8dk1Alr.d.mts

@@ -0,0 +1,70 @@
+//#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
+//#region src/config/layout.d.ts
+/** Top-level project state dir — neutral + harness-agnostic (not `.claude/…`). */
+declare const STATE_ROOT = ".harness";
+/**
+* The selective `.gitignore` for `.harness/`: ignore the machine-local session
+* state (track, cache, throttle) but keep the curated `memory/LESSON.md`.
+*/
+declare const STATE_GITIGNORE = "track/\ncache/\nmemory/state.json\n";
+/** Every project-state path the package uses, derived from one project root. */
+interface ProjectLayout {
+  root: string;
+  /** `<root>/.harness` — the single state dir. */
+  stateDir: string;
+  /** `<root>/.harness/track` — session track files. */
+  trackDir: string;
+  /** `<root>/.harness/cache` — MCP/WebFetch cache. */
+  cacheDir: string;
+  /** `<root>/.harness/memory` — lessons + throttle. */
+  memoryDir: string;
+  /** `<root>/.harness/memory/LESSON.md` — curated, committable. */
+  lessonsFile: string;
+  /** `<root>/.harness/memory/state.json` — machine-local throttle. */
+  memoryStateFile: string;
+  /** `<root>/.harness/.gitignore`. */
+  gitignoreFile: string;
+}
+/**
+* The single source of truth for where every package file lives under a project
+* root. All modules (runtime storage, memory, init) derive their paths here —
+* nothing hardcodes a directory name elsewhere.
+*/
+declare function projectLayout(root: string): ProjectLayout;
+//#endregion
+export { DEFAULT_MAX_LINES as a, splitTarget as c, resolveTtlSec as d, ttlLabel as f, projectLayout as i, DEFAULT_TTL_SEC as l, STATE_GITIGNORE as n, MAX_LINES_ENV_KEY as o, parseEnvInt as p, STATE_ROOT as r, resolveMaxLines as s, ProjectLayout as t, TTL_ENV_KEY as u };

package/dist/{index-BEM-mQMC.d.mts → index-DLYhervv.d.mts}

@@ -6,6 +6,8 @@ interface ReminderState {
 }
 /** Absolute path of the per-project throttle state file. */
 declare function stateFileFor(root: string): string;
+/** Absolute path of the per-project curated lessons file (committable). */
+declare function lessonsFileFor(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). */
@@ -27,4 +29,4 @@ declare function addRoot(root: string, home?: string): void;
 /** 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 };
+export { ReminderState as a, readState as c, throttleMs as d, registryFile as i, setStateField as l, addRoot as n, lessonsFileFor as o, readRoots as r, nowStamp as s, ensureMemoryGitignore as t, stateFileFor 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 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 DEFAULT_MAX_LINES, c as splitTarget, d as resolveTtlSec, f as ttlLabel, i as projectLayout, l as DEFAULT_TTL_SEC, n as STATE_GITIGNORE, o as MAX_LINES_ENV_KEY, p as parseEnvInt, r as STATE_ROOT, s as resolveMaxLines, t as ProjectLayout, u as TTL_ENV_KEY } from "./index-C8dk1Alr.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 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 ReminderState, c as readState, d as throttleMs, i as registryFile, l as setStateField, n as addRoot, o as lessonsFileFor, r as readRoots, s as nowStamp, t as ensureMemoryGitignore, u as stateFileFor } from "./index-DLYhervv.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_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 };
+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, ProjectLayout, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, STATE_GITIGNORE, STATE_ROOT, 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, lessonsFileFor, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectLayout, 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

@@ -1,19 +1,20 @@
 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";
 import { i as ttlLabel, n as TTL_ENV_KEY, r as resolveTtlSec, t as DEFAULT_TTL_SEC } from "./config-BG55s6HZ.mjs";
+import { n as STATE_ROOT, r as projectLayout, t as STATE_GITIGNORE } from "./layout-C0jaaCQC.mjs";
 import { t as compactJson } from "./compact-json-DK2nX-MK.mjs";
-import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-C4ks_q1G.mjs";
+import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-ff0_poWU.mjs";
 import { n as detectMode, r as modeFor, t as detectHarness } from "./harness-C8Nxxyn_.mjs";
-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 { i as isApexCommand, n as DEV_KEYWORDS, r as detectProjectType, t as detectCreationIntent } from "./policy-Cpa5aWek.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-qGG2Ul0W.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 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 nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs, n as readRoots, o as readState, r as registryFile, s as setStateField, t as addRoot, u as ensureMemoryGitignore } from "./memory-BkoEbdec.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 { a as extractText, i as mcpCacheKey, n as cachePath, r as cacheStore, t as cacheLookup } from "./store-DeIsfMg5.mjs";
+import { t as incrementTrivialEditCounter } from "./freshness-CezohJHo.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 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-Cs0Y0MG_.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_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 };
+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, STATE_GITIGNORE, STATE_ROOT, 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, lessonsFileFor, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectLayout, 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/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-Cdp2Ef9B.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-D91N4ul1.mjs";
 export { claudeInit, clineInit, codexInit, cursorInit, geminiInit, initFor, writeInitFile };

package/dist/layout-C0jaaCQC.mjs

@@ -0,0 +1,30 @@
+import { join } from "node:path";
+//#region src/config/layout.ts
+/** Top-level project state dir — neutral + harness-agnostic (not `.claude/…`). */
+const STATE_ROOT = ".harness";
+/**
+* The selective `.gitignore` for `.harness/`: ignore the machine-local session
+* state (track, cache, throttle) but keep the curated `memory/LESSON.md`.
+*/
+const STATE_GITIGNORE = "track/\ncache/\nmemory/state.json\n";
+/**
+* The single source of truth for where every package file lives under a project
+* root. All modules (runtime storage, memory, init) derive their paths here —
+* nothing hardcodes a directory name elsewhere.
+*/
+function projectLayout(root) {
+	const stateDir = join(root, STATE_ROOT);
+	const memoryDir = join(stateDir, "memory");
+	return {
+		root,
+		stateDir,
+		trackDir: join(stateDir, "track"),
+		cacheDir: join(stateDir, "cache"),
+		memoryDir,
+		lessonsFile: join(memoryDir, "LESSON.md"),
+		memoryStateFile: join(memoryDir, "state.json"),
+		gitignoreFile: join(stateDir, ".gitignore")
+	};
+}
+//#endregion
+export { STATE_ROOT as n, projectLayout as r, STATE_GITIGNORE as t };

package/dist/memory/index.d.mts

@@ -1,2 +1,2 @@
-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";
-export { ReminderState, addRoot, ensureMemoryGitignore, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };
+import { a as ReminderState, c as readState, d as throttleMs, i as registryFile, l as setStateField, n as addRoot, o as lessonsFileFor, r as readRoots, s as nowStamp, t as ensureMemoryGitignore, u as stateFileFor } from "../index-DLYhervv.mjs";
+export { ReminderState, addRoot, ensureMemoryGitignore, lessonsFileFor, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };

package/dist/memory/index.mjs

@@ -1,2 +1,2 @@
-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";
-export { addRoot, ensureMemoryGitignore, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };
+import { a as nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs, n as readRoots, o as readState, r as registryFile, s as setStateField, t as addRoot, u as ensureMemoryGitignore } from "../memory-BkoEbdec.mjs";
+export { addRoot, ensureMemoryGitignore, lessonsFileFor, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };

package/dist/{memory-BVNt4Ary.mjs → memory-BkoEbdec.mjs}

@@ -1,5 +1,6 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { r as projectLayout } from "./layout-C0jaaCQC.mjs";
 import { dirname } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 //#region src/memory/gitignore.ts
 /** Ensure `<memoryDir>/.gitignore` ignores the machine-local `state.json`. */
 function ensureMemoryGitignore(memoryDir) {
@@ -14,7 +15,11 @@ function ensureMemoryGitignore(memoryDir) {
 //#region src/memory/state.ts
 /** Absolute path of the per-project throttle state file. */
 function stateFileFor(root) {
-	return `${root}/MEMORY/state.json`;
+	return projectLayout(root).memoryStateFile;
+}
+/** Absolute path of the per-project curated lessons file (committable). */
+function lessonsFileFor(root) {
+	return projectLayout(root).lessonsFile;
 }
 function num(v) {
 	return typeof v === "number" && Number.isFinite(v) ? v : 0;
@@ -91,4 +96,4 @@ function addRoot(root, home) {
 	} catch {}
 }
 //#endregion
-export { readState as a, throttleMs as c, nowStamp as i, ensureMemoryGitignore as l, readRoots as n, setStateField as o, registryFile as r, stateFileFor as s, addRoot as t };
+export { nowStamp as a, stateFileFor as c, lessonsFileFor as i, throttleMs as l, readRoots as n, readState as o, registryFile as r, setStateField as s, addRoot as t, ensureMemoryGitignore as u };

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 { i as isApexCommand, n as DEV_KEYWORDS, r as detectProjectType, t as detectCreationIntent } from "../policy-Cpa5aWek.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-qGG2Ul0W.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";
 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/{run-D2na7Z2Z.mjs → run-B-_9dPR6.mjs}

@@ -1,5 +1,5 @@
-import { t as isCodeFile } from "./project-root-C4ks_q1G.mjs";
-import { t as evaluate } from "./evaluate-DkTgwHNh.mjs";
+import { t as isCodeFile } from "./project-root-ff0_poWU.mjs";
+import { t as evaluate } from "./evaluate-qGG2Ul0W.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { execSync } from "node:child_process";
 //#region src/cli/run.ts

package/dist/{run-Cdp2Ef9B.mjs → run-D91N4ul1.mjs}

@@ -1,5 +1,6 @@
-import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
+import { n as STATE_ROOT, t as STATE_GITIGNORE } from "./layout-C0jaaCQC.mjs";
 import { dirname, join } from "node:path";
+import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
 //#region src/init/templates.ts
 function json(obj) {
 	return `${JSON.stringify(obj, null, 2)}\n`;
@@ -114,7 +115,11 @@ const RUNNERS = {
 */
 function initFor(id, command = `npx harness hook ${id}`) {
 	const make = RUNNERS[id];
-	return make ? make(command) : null;
+	if (!make) return null;
+	return [...make(command), {
+		path: `${STATE_ROOT}/.gitignore`,
+		content: STATE_GITIGNORE
+	}];
 }
 /** Write an {@link InitFile} under `root` (creates dirs; `chmod +x` when executable). */
 function writeInitFile(root, file) {

package/dist/runtime/index.d.mts

@@ -1,5 +1,4 @@
 import { t as Prompt } from "../types-D56jSgD9.mjs";
-import { t as HarnessId } from "../harness-DwJskkz_.mjs";
 import { t as RefMeta } from "../types-CY5qT2X1.mjs";
 
 //#region src/runtime/paths.d.ts
@@ -8,11 +7,10 @@ declare function trackFile(sessionId: string, baseDir?: string): string;
 //#endregion
 //#region src/runtime/storage.d.ts
 /**
-* Directory where a harness's fuse-harness track files live — under that
-* harness's own config dir (`.claude`, `.codex`, …) so state sits next to its
-* hooks. Falls back to `.fuse-harness` for harnesses without a known config dir.
+* The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,
+* derived from {@link projectLayout}. (Was the per-harness `.claude/harness`.)
 */
-declare function harnessTrackDir(id: HarnessId, projectRoot: string): string;
+declare function harnessStateDir(root: string): string;
 //#endregion
 //#region src/runtime/record.d.ts
 /** A unit of session activity to record (discriminated union on `kind`). */
@@ -142,4 +140,4 @@ interface HandleOutcome {
 */
 declare function handleHook(id: string, payload: Record<string, unknown>, opts: HandleOptions): Promise<HandleOutcome>;
 //#endregion
-export { Activity, DEFAULT_WINDOW_MS, GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessTrackDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };
+export { Activity, DEFAULT_WINDOW_MS, GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };

package/dist/runtime/index.mjs

@@ -1,2 +1,12 @@
-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 };
+import { r as projectLayout } from "../layout-C0jaaCQC.mjs";
+import { a as normalizeEvent, c as mcpPostStore, d as DEFAULT_WINDOW_MS, f as REQUIRED_AGENTS, h as activityFor, i as trackFile, l as mcpPreIntercept, m as gate, n as respond, o as MCP_TTL_MS, p as TRIVIAL_BUDGET, r as recordActivity, s as isMcpTool, t as handleHook, u as queryOf } from "../handle-D-DClzB2.mjs";
+//#region src/runtime/storage.ts
+/**
+* The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,
+* derived from {@link projectLayout}. (Was the per-harness `.claude/harness`.)
+*/
+function harnessStateDir(root) {
+	return projectLayout(root).stateDir;
+}
+//#endregion
+export { DEFAULT_WINDOW_MS, MCP_TTL_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };

package/dist/state/index.mjs

@@ -1,2 +1,2 @@
-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 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-Cs0Y0MG_.mjs";
 export { acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart };

package/dist/{state-Bc4wdnCG.mjs → state-Cs0Y0MG_.mjs}

@@ -1,4 +1,4 @@
-import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-RH82El2J.mjs";
+import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-xpTDuvtn.mjs";
 import { mkdir, rmdir } from "node:fs/promises";
 //#region src/state/lock.ts
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{store-gtbP-Bv9.mjs → store-BnHpq2ZB.mjs}

@@ -1,4 +1,4 @@
-import { n as readJsonFile, r as writeJsonFile } from "./json-io-RH82El2J.mjs";
+import { n as readJsonFile, r as writeJsonFile } from "./json-io-xpTDuvtn.mjs";
 //#region src/tracking/session-state.ts
 /** A fresh, empty track. */
 function emptyTrack() {

package/dist/tracking/index.mjs

@@ -1,2 +1,2 @@
-import { a as recordAgent, c as recordRefRead, i as emptyTrack, l as recordTrivialEdit, n as saveTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as loadTrack, u as trivialCount } from "../store-gtbP-Bv9.mjs";
+import { a as recordAgent, c as recordRefRead, i as emptyTrack, l as recordTrivialEdit, n as saveTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as loadTrack, u as trivialCount } from "../store-BnHpq2ZB.mjs";
 export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTrivialEdit, saveTrack, trivialCount };

package/dist/util/index.mjs

@@ -1,4 +1,4 @@
 import { t as compactJson } from "../compact-json-DK2nX-MK.mjs";
-import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../project-root-C4ks_q1G.mjs";
+import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../project-root-ff0_poWU.mjs";
 import "../util-la_KkjCS.mjs";
 export { compactJson, isCodeFile, projectRoot, projectRootOrNull };

package/package.json

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

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

@@ -1,37 +0,0 @@
-//#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/{json-io-RH82El2J.mjs → json-io-xpTDuvtn.mjs}

@@ -1,6 +1,6 @@
 import { t as compactJson } from "./compact-json-DK2nX-MK.mjs";
-import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
+import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { randomUUID } from "node:crypto";
 import { mkdir } from "node:fs/promises";
 //#region src/util/json-io.ts

package/dist/{policy-Djmqxow2.mjs → policy-Cpa5aWek.mjs}

@@ -1,5 +1,5 @@
-import { existsSync } from "node:fs";
 import { join } from "node:path";
+import { existsSync } from "node:fs";
 //#region src/policy/detect-project.ts
 /** Keywords that signal a development task (APEX trigger). */
 const DEV_KEYWORDS = /\b(implement|create|build|fix|add|refactor|develop|feature|bug|update|modify|change|write|code)\b/i;

package/dist/{project-root-C4ks_q1G.mjs → project-root-ff0_poWU.mjs}

@@ -1,5 +1,5 @@
-import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
+import { existsSync } from "node:fs";
 //#region src/util/project-root.ts
 /** Source-code file extensions worth tracking as "code was written". */
 const CODE_EXT = /\.(ts|tsx|js|jsx|py|php|swift|go|rs|rb|java|vue|svelte|astro|css|kt|dart|cpp|c)$/;

package/dist/{store-BlaEhjab.mjs → store-DeIsfMg5.mjs}

@@ -1,5 +1,5 @@
-import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 //#region src/cache/mcp-response.ts
 const MAX_DEPTH = 5;
 /**