@fusengine/harness 0.1.5 → 0.1.6

package/dist/runtime/index.d.mts

@@ -1,10 +1,19 @@
 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 = {
@@ -23,6 +32,25 @@ type Activity = {
 /** 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>;
@@ -48,4 +76,4 @@ interface GateInput {
 */
 declare function gate(input: GateInput): Promise<Prompt | null>;
 //#endregion
-export { Activity, DEFAULT_WINDOW_MS, GateInput, REQUIRED_AGENTS, gate, recordActivity, trackFile };
+export { Activity, DEFAULT_WINDOW_MS, GateInput, REQUIRED_AGENTS, ToolEvent, activityFor, gate, harnessTrackDir, recordActivity, trackFile };

package/dist/runtime/index.mjs

@@ -9,6 +9,24 @@ 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) {
@@ -16,6 +34,45 @@ async function recordActivity(file, activity) {
 	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"];
@@ -48,4 +105,4 @@ async function gate(input) {
 	});
 }
 //#endregion
-export { DEFAULT_WINDOW_MS, REQUIRED_AGENTS, gate, recordActivity, trackFile };
+export { DEFAULT_WINDOW_MS, REQUIRED_AGENTS, activityFor, gate, harnessTrackDir, recordActivity, trackFile };

package/package.json

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