@fusengine/harness 0.1.4 → 0.1.6

package/dist/{policy-C4zmyZR-.mjs → apex-gGrHzvM2.mjs}

@@ -1,37 +1,5 @@
 import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
 import { t as routeReferences } from "./router-Dj3AfgBE.mjs";
-import { existsSync } from "node:fs";
-import { join } from "node:path";
-//#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;
-/** True when the prompt invokes the /apex command. */
-function isApexCommand(prompt) {
-	return /(?:^|\s)\/apex|\/fuse-ai-pilot:apex/i.test(prompt);
-}
-/** Detect the project type by scanning config files in `dir`. */
-function detectProjectType(dir) {
-	const has = (f) => existsSync(join(dir, f));
-	if (has("next.config.js") || has("next.config.ts") || has("next.config.mjs")) return "nextjs";
-	if (has("nuxt.config.ts") || has("nuxt.config.js")) return "nuxt";
-	if (has("angular.json")) return "angular";
-	if (has("svelte.config.js") || has("svelte.config.ts")) return "svelte";
-	if (has("vite.config.ts") && has("src/App.vue")) return "vue";
-	if (has("vite.config.ts") || has("vite.config.js")) return "react";
-	if (has("tailwind.config.js") || has("tailwind.config.ts")) return "tailwind";
-	if (has("composer.json") && has("artisan")) return "laravel";
-	if (has("Gemfile") && has("config/routes.rb")) return "rails";
-	if (has("requirements.txt") || has("pyproject.toml") || has("setup.py")) return has("manage.py") ? "django" : "python";
-	if (has("go.mod")) return "go";
-	if (has("Cargo.toml")) return "rust";
-	if (has("Package.swift")) return "swift";
-	if (has("pom.xml") || has("build.gradle") || has("build.gradle.kts")) return "java";
-	if (has("build.sbt")) return "scala";
-	if (has("mix.exs")) return "elixir";
-	if (has("Gemfile")) return "ruby";
-	return "generic";
-}
-//#endregion
 //#region src/policy/apex.ts
 /** Gate: Context7 + Exa must have been consulted this session. */
 const docConsultedGate = (ctx) => isDocConsulted(ctx.authorizations, ctx.sessionId) ? null : {
@@ -76,4 +44,4 @@ function evaluateApex(ctx, gates = APEX_GATES) {
 	return gates.reduce((hit, gate) => hit ?? gate(ctx), null);
 }
 //#endregion
-export { solidReadGate as a, isApexCommand as c, freshnessGate as i, docConsultedGate as n, DEV_KEYWORDS as o, evaluateApex as r, detectProjectType as s, APEX_GATES as t };
+export { solidReadGate as a, freshnessGate as i, docConsultedGate as n, evaluateApex as r, APEX_GATES as t };

package/dist/index.mjs

@@ -3,10 +3,11 @@ import { i as ttlLabel, n as TTL_ENV_KEY, r as resolveTtlSec, t as DEFAULT_TTL_S
 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 detectMode, r as modeFor, t as detectHarness } from "./harness-C8Nxxyn_.mjs";
-import { a as solidReadGate, c as isApexCommand, i as freshnessGate, n as docConsultedGate, o as DEV_KEYWORDS, r as evaluateApex, s as detectProjectType, t as APEX_GATES } from "./policy-C4zmyZR-.mjs";
+import { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "./policy-C_pXmeNB.mjs";
 import { a as SYSTEM_INSTALL, c as evaluateFileSize, i as PROJECT_INSTALL, l as detectFramework, n as GIT_ASK, o as matchPatterns, r as GIT_BLOCKED, s as countLines, t as evaluate } from "./evaluate-CsYyUucy.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 solidReadGate, i as freshnessGate, n as docConsultedGate, r as evaluateApex, t as APEX_GATES } from "./apex-gGrHzvM2.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as readState, c as throttleMs, i as nowStamp, l as ensureMemoryGitignore, n as readRoots, o as setStateField, r as registryFile, s as stateFileFor, t as addRoot } from "./memory-BVNt4Ary.mjs";
 import { a as jaccardSimilar, i as compactMarkdown, n as loadIndex, o as queryHash, r as summarizeIndex, t as extractText } from "./cache-DbPSJ9bC.mjs";

package/dist/policy/index.mjs

@@ -1,3 +1,4 @@
-import { a as solidReadGate, c as isApexCommand, i as freshnessGate, n as docConsultedGate, o as DEV_KEYWORDS, r as evaluateApex, s as detectProjectType, t as APEX_GATES } from "../policy-C4zmyZR-.mjs";
+import { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "../policy-C_pXmeNB.mjs";
 import { a as SYSTEM_INSTALL, c as evaluateFileSize, i as PROJECT_INSTALL, l as detectFramework, n as GIT_ASK, o as matchPatterns, r as GIT_BLOCKED, s as countLines, t as evaluate } from "../evaluate-CsYyUucy.mjs";
+import { a as solidReadGate, i as freshnessGate, n as docConsultedGate, r as evaluateApex, t as APEX_GATES } from "../apex-gGrHzvM2.mjs";
 export { APEX_GATES, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, isApexCommand, matchPatterns, solidReadGate };

package/dist/policy-C_pXmeNB.mjs

@@ -0,0 +1,33 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+//#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;
+/** True when the prompt invokes the /apex command. */
+function isApexCommand(prompt) {
+	return /(?:^|\s)\/apex|\/fuse-ai-pilot:apex/i.test(prompt);
+}
+/** Detect the project type by scanning config files in `dir`. */
+function detectProjectType(dir) {
+	const has = (f) => existsSync(join(dir, f));
+	if (has("next.config.js") || has("next.config.ts") || has("next.config.mjs")) return "nextjs";
+	if (has("nuxt.config.ts") || has("nuxt.config.js")) return "nuxt";
+	if (has("angular.json")) return "angular";
+	if (has("svelte.config.js") || has("svelte.config.ts")) return "svelte";
+	if (has("vite.config.ts") && has("src/App.vue")) return "vue";
+	if (has("vite.config.ts") || has("vite.config.js")) return "react";
+	if (has("tailwind.config.js") || has("tailwind.config.ts")) return "tailwind";
+	if (has("composer.json") && has("artisan")) return "laravel";
+	if (has("Gemfile") && has("config/routes.rb")) return "rails";
+	if (has("requirements.txt") || has("pyproject.toml") || has("setup.py")) return has("manage.py") ? "django" : "python";
+	if (has("go.mod")) return "go";
+	if (has("Cargo.toml")) return "rust";
+	if (has("Package.swift")) return "swift";
+	if (has("pom.xml") || has("build.gradle") || has("build.gradle.kts")) return "java";
+	if (has("build.sbt")) return "scala";
+	if (has("mix.exs")) return "elixir";
+	if (has("Gemfile")) return "ruby";
+	return "generic";
+}
+//#endregion
+export { detectProjectType as n, isApexCommand as r, DEV_KEYWORDS as t };

package/dist/runtime/index.d.mts

@@ -0,0 +1,79 @@
+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
+/** Path to a session's track file (under a per-tool base dir). */
+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.
+*/
+declare function harnessTrackDir(id: HarnessId, projectRoot: string): string;
+//#endregion
+//#region src/runtime/record.d.ts
+/** A unit of session activity to record (discriminated union on `kind`). */
+type Activity = {
+  kind: "agent";
+  name: string;
+  ts: number;
+} | {
+  kind: "doc";
+  framework: string;
+  sessionId: string;
+  source: string;
+} | {
+  kind: "ref";
+  path: string;
+};
+/** Apply an activity to a session's track and persist it (PostToolUse path). */
+declare function recordActivity(file: string, activity: Activity): Promise<void>;
+//#endregion
+//#region src/runtime/activity.d.ts
+/** A live tool-use, already normalized to `tool` + `input` by the adapter. */
+interface ToolEvent {
+  /** The harness's `tool_name` (Cline: `preToolUse.toolName`), as a plain string. */
+  tool: string;
+  input?: Record<string, unknown>;
+  sessionId: string;
+  framework: string;
+  now: number;
+}
+/**
+* Map a live tool-use to the activity to record, or null when nothing is
+* tracked. Works across harnesses — tool names are globally distinct:
+* - MCP doc calls (`context7` / `exa`, any separator) → `doc`
+* - `Task` + `subagent_type` (Claude/Cursor) → `agent` (bare agent name)
+* - a read tool opening a `.md` reference → `ref`
+*/
+declare function activityFor(event: ToolEvent): Activity | null;
+//#endregion
+//#region src/runtime/gate.d.ts
+/** Prior agents the freshness gate requires before a code edit. */
+declare const REQUIRED_AGENTS: ReadonlyArray<string>;
+/** Default freshness window for {@link REQUIRED_AGENTS} (4 min, the APEX TTL). */
+declare const DEFAULT_WINDOW_MS = 24e4;
+/** A tool-use to gate, plus the session pointers needed for the stateful gates. */
+interface GateInput {
+  sessionId: string;
+  framework: string;
+  tool: string;
+  filePath?: string;
+  content?: string;
+  command?: string;
+  refs?: RefMeta[];
+  now: number;
+  trackFile: string;
+  windowMs?: number;
+}
+/**
+* Full gate: the stateless guards (file-size, git) first, then the stateful
+* APEX gates fed from the session track. Returns the first blocking prompt, or
+* null to allow. APEX gates apply only to code edits (a `filePath`).
+*/
+declare function gate(input: GateInput): Promise<Prompt | null>;
+//#endregion
+export { Activity, DEFAULT_WINDOW_MS, GateInput, REQUIRED_AGENTS, ToolEvent, activityFor, gate, harnessTrackDir, recordActivity, trackFile };

package/dist/runtime/index.mjs

@@ -0,0 +1,108 @@
+import { t as evaluate } from "../evaluate-CsYyUucy.mjs";
+import { r as evaluateApex } from "../apex-gGrHzvM2.mjs";
+import { a as recordAgent, n as saveTrack, o as recordDoc, r as agentsFresh, s as recordRefRead, t as loadTrack } from "../store-BWvwnnf6.mjs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+//#region src/runtime/paths.ts
+/** Path to a session's track file (under a per-tool base dir). */
+function trackFile(sessionId, baseDir = join(tmpdir(), "fuse-harness")) {
+	return join(baseDir, `track-${sessionId.replace(/[^A-Za-z0-9_-]/g, "_") || "default"}.json`);
+}
+//#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/record.ts
+/** Apply an activity to a session's track and persist it (PostToolUse path). */
+async function recordActivity(file, activity) {
+	const track = await loadTrack(file);
+	await saveTrack(file, activity.kind === "agent" ? recordAgent(track, activity.name, activity.ts) : activity.kind === "doc" ? recordDoc(track, activity.framework, activity.sessionId, activity.source) : recordRefRead(track, activity.path));
+}
+//#endregion
+//#region src/runtime/activity.ts
+/** Read tools across harnesses (Claude `Read`, Gemini/Cline `read_file`, …). */
+const READ_TOOLS = /* @__PURE__ */ new Set([
+	"Read",
+	"read_file",
+	"read_many_files"
+]);
+/**
+* Map a live tool-use to the activity to record, or null when nothing is
+* tracked. Works across harnesses — tool names are globally distinct:
+* - MCP doc calls (`context7` / `exa`, any separator) → `doc`
+* - `Task` + `subagent_type` (Claude/Cursor) → `agent` (bare agent name)
+* - a read tool opening a `.md` reference → `ref`
+*/
+function activityFor(event) {
+	if (/context7|exa/i.test(event.tool)) return {
+		kind: "doc",
+		framework: event.framework,
+		sessionId: event.sessionId,
+		source: /exa/i.test(event.tool) ? "exa" : "context7"
+	};
+	if (event.tool === "Task") {
+		const name = String(event.input?.subagent_type ?? "").split(":").pop() ?? "";
+		return name ? {
+			kind: "agent",
+			name,
+			ts: event.now
+		} : null;
+	}
+	if (READ_TOOLS.has(event.tool)) {
+		const path = String(event.input?.file_path ?? event.input?.path ?? "");
+		if (path.endsWith(".md")) return {
+			kind: "ref",
+			path
+		};
+	}
+	return null;
+}
+//#endregion
+//#region src/runtime/gate.ts
+/** Prior agents the freshness gate requires before a code edit. */
+const REQUIRED_AGENTS = ["explore-codebase", "research-expert"];
+/** Default freshness window for {@link REQUIRED_AGENTS} (4 min, the APEX TTL). */
+const DEFAULT_WINDOW_MS = 24e4;
+/**
+* Full gate: the stateless guards (file-size, git) first, then the stateful
+* APEX gates fed from the session track. Returns the first blocking prompt, or
+* null to allow. APEX gates apply only to code edits (a `filePath`).
+*/
+async function gate(input) {
+	const quick = evaluate({
+		tool: input.tool,
+		filePath: input.filePath,
+		content: input.content,
+		command: input.command
+	});
+	if (quick.decision !== "allow" && quick.prompt) return quick.prompt;
+	if (!input.filePath) return null;
+	const track = await loadTrack(input.trackFile);
+	return evaluateApex({
+		sessionId: input.sessionId,
+		framework: input.framework,
+		filePath: input.filePath,
+		content: input.content ?? "",
+		authorizations: track.authorizations,
+		refs: input.refs,
+		refsRead: track.refsRead,
+		agentsFresh: agentsFresh(track, [...REQUIRED_AGENTS], input.windowMs ?? 24e4, input.now)
+	});
+}
+//#endregion
+export { DEFAULT_WINDOW_MS, REQUIRED_AGENTS, activityFor, gate, harnessTrackDir, recordActivity, trackFile };

package/dist/store-BWvwnnf6.mjs

@@ -0,0 +1,63 @@
+import { n as readJsonFile, r as writeJsonFile } from "./json-io-RH82El2J.mjs";
+//#region src/tracking/session-state.ts
+/** A fresh, empty track. */
+function emptyTrack() {
+	return {
+		authorizations: {},
+		refsRead: [],
+		agents: []
+	};
+}
+/** Record a doc consultation (Context7/Exa) for a framework in this session. Immutable. */
+function recordDoc(track, framework, sessionId, source) {
+	const prev = track.authorizations[framework] ?? {};
+	const sessions = new Set(prev.doc_sessions ?? []);
+	sessions.add(sessionId);
+	const sources = new Set(prev.sources ?? (prev.source ? [prev.source] : []));
+	sources.add(source);
+	return {
+		...track,
+		authorizations: {
+			...track.authorizations,
+			[framework]: {
+				...prev,
+				doc_sessions: [...sessions],
+				sources: [...sources]
+			}
+		}
+	};
+}
+/** Record that a SOLID reference file was read (deduped). Immutable. */
+function recordRefRead(track, path) {
+	return track.refsRead.includes(path) ? track : {
+		...track,
+		refsRead: [...track.refsRead, path]
+	};
+}
+/** Record an agent/tool call with a timestamp. Immutable. */
+function recordAgent(track, name, ts) {
+	return {
+		...track,
+		agents: [...track.agents, {
+			name,
+			ts
+		}]
+	};
+}
+/** True when ALL of `names` were called within `windowMs` before `now`. */
+function agentsFresh(track, names, windowMs, now) {
+	const cutoff = now - windowMs;
+	return names.every((n) => track.agents.some((a) => a.name === n && a.ts > cutoff));
+}
+//#endregion
+//#region src/tracking/store.ts
+/** Load a session track from a file (an empty track if absent/corrupt). */
+async function loadTrack(file) {
+	return await readJsonFile(file) ?? emptyTrack();
+}
+/** Persist a session track. */
+async function saveTrack(file, track) {
+	await writeJsonFile(file, track);
+}
+//#endregion
+export { recordAgent as a, emptyTrack as i, saveTrack as n, recordDoc as o, agentsFresh as r, recordRefRead as s, loadTrack as t };

package/dist/tracking/index.mjs

@@ -1,63 +1,2 @@
-import { n as readJsonFile, r as writeJsonFile } from "../json-io-RH82El2J.mjs";
-//#region src/tracking/session-state.ts
-/** A fresh, empty track. */
-function emptyTrack() {
-	return {
-		authorizations: {},
-		refsRead: [],
-		agents: []
-	};
-}
-/** Record a doc consultation (Context7/Exa) for a framework in this session. Immutable. */
-function recordDoc(track, framework, sessionId, source) {
-	const prev = track.authorizations[framework] ?? {};
-	const sessions = new Set(prev.doc_sessions ?? []);
-	sessions.add(sessionId);
-	const sources = new Set(prev.sources ?? (prev.source ? [prev.source] : []));
-	sources.add(source);
-	return {
-		...track,
-		authorizations: {
-			...track.authorizations,
-			[framework]: {
-				...prev,
-				doc_sessions: [...sessions],
-				sources: [...sources]
-			}
-		}
-	};
-}
-/** Record that a SOLID reference file was read (deduped). Immutable. */
-function recordRefRead(track, path) {
-	return track.refsRead.includes(path) ? track : {
-		...track,
-		refsRead: [...track.refsRead, path]
-	};
-}
-/** Record an agent/tool call with a timestamp. Immutable. */
-function recordAgent(track, name, ts) {
-	return {
-		...track,
-		agents: [...track.agents, {
-			name,
-			ts
-		}]
-	};
-}
-/** True when ALL of `names` were called within `windowMs` before `now`. */
-function agentsFresh(track, names, windowMs, now) {
-	const cutoff = now - windowMs;
-	return names.every((n) => track.agents.some((a) => a.name === n && a.ts > cutoff));
-}
-//#endregion
-//#region src/tracking/store.ts
-/** Load a session track from a file (an empty track if absent/corrupt). */
-async function loadTrack(file) {
-	return await readJsonFile(file) ?? emptyTrack();
-}
-/** Persist a session track. */
-async function saveTrack(file, track) {
-	await writeJsonFile(file, track);
-}
-//#endregion
+import { a as recordAgent, i as emptyTrack, n as saveTrack, o as recordDoc, r as agentsFresh, s as recordRefRead, t as loadTrack } from "../store-BWvwnnf6.mjs";
 export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordDoc, recordRefRead, saveTrack };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "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",
@@ -24,6 +24,7 @@
     "./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" },
@@ -36,7 +37,7 @@
   "scripts": {
     "test": "bun test",
     "typecheck": "tsc --noEmit",
-    "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/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",
+    "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"
   },
   "publishConfig": {