@fusengine/harness 0.1.80 → 0.1.81

package/package.json

@@ -1,165 +1,165 @@
 {
-  "name": "@fusengine/harness",
-  "version": "0.1.80",
-  "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",
-  "types": "dist/index.d.mts",
-  "bin": {
-    "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"
-    },
-    "./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"
-    },
-    "./adapters/hermes": {
-      "bun": "./src/adapters/hermes/index.ts",
-      "types": "./dist/adapters/hermes/index.d.mts",
-      "import": "./dist/adapters/hermes/index.mjs"
-    },
-    "./adapters/kimi": {
-      "bun": "./src/adapters/kimi/index.ts",
-      "types": "./dist/adapters/kimi/index.d.mts",
-      "import": "./dist/adapters/kimi/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "assets",
-    "README.md",
-    "LICENSE"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/fusengine/harness.git"
-  },
-  "homepage": "https://github.com/fusengine/harness#readme",
-  "bugs": "https://github.com/fusengine/harness/issues",
-  "sideEffects": false,
-  "scripts": {
-    "test": "bun test",
-    "sim": "bun test test/sim/",
-    "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/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 src/adapters/hermes/index.ts src/adapters/kimi/index.ts --dts --format esm --clean --out-dir dist",
-    "prepublishOnly": "bun test && tsc --noEmit && bun run build"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "peerDependencies": {
-    "@vercel/detect-agent": "*"
-  },
-  "peerDependenciesMeta": {
-    "@vercel/detect-agent": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/bun": "latest",
-    "tsdown": "^0.22.3",
-    "typedoc": "^0.28.19",
-    "typescript": "^6.0.3"
-  },
-  "dependencies": {
-    "figures": "^6.1.0"
-  }
+	"name": "@fusengine/harness",
+	"version": "0.1.81",
+	"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",
+	"types": "dist/index.d.mts",
+	"bin": {
+		"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"
+		},
+		"./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"
+		},
+		"./adapters/hermes": {
+			"bun": "./src/adapters/hermes/index.ts",
+			"types": "./dist/adapters/hermes/index.d.mts",
+			"import": "./dist/adapters/hermes/index.mjs"
+		},
+		"./adapters/kimi": {
+			"bun": "./src/adapters/kimi/index.ts",
+			"types": "./dist/adapters/kimi/index.d.mts",
+			"import": "./dist/adapters/kimi/index.mjs"
+		}
+	},
+	"files": [
+		"dist",
+		"assets",
+		"README.md",
+		"LICENSE"
+	],
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/fusengine/harness.git"
+	},
+	"homepage": "https://github.com/fusengine/harness#readme",
+	"bugs": "https://github.com/fusengine/harness/issues",
+	"sideEffects": false,
+	"scripts": {
+		"test": "bun test",
+		"sim": "bun test test/sim/",
+		"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/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 src/adapters/hermes/index.ts src/adapters/kimi/index.ts --dts --format esm --clean --out-dir dist",
+		"prepublishOnly": "bun test && tsc --noEmit && bun run build"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"peerDependencies": {
+		"@vercel/detect-agent": "*"
+	},
+	"peerDependenciesMeta": {
+		"@vercel/detect-agent": {
+			"optional": true
+		}
+	},
+	"devDependencies": {
+		"@types/bun": "latest",
+		"tsdown": "^0.22.13",
+		"typedoc": "^0.28.20",
+		"typescript": "^7.0.2"
+	},
+	"dependencies": {
+		"figures": "^6.1.0"
+	}
 }

package/dist/apex-Wdi1nq_w.d.mts

@@ -1,73 +0,0 @@
-import { t as Prompt } from "./types-DVbIl9md.mjs";
-import { t as AuthEntry } from "./doc-helpers-CEKzGg2u.mjs";
-import { t as RefMeta } from "./types-CY5qT2X1.mjs";
-
-//#region src/policy/apex-gates.d.ts
-/** Gate: the routed SOLID references for this edit must have been read within the TTL. */
-declare const solidReadGate: ApexGate;
-/** Gate: the required prior agents (explore + research) must have run within the window. */
-declare const freshnessGate: ApexGate;
-//#endregion
-//#region src/policy/apex.d.ts
-/**
-* Session context for the stateful APEX gates. The harness adapter supplies this
-* (the package owns the gate LOGIC; recording the session activity is the
-* adapter's tracking layer).
-*/
-interface ApexContext {
-  sessionId: string;
-  framework: string;
-  filePath: string;
-  content: string;
-  /** Doc-consultation authorizations from session state (Context7/Exa). */
-  authorizations?: Record<string, AuthEntry>;
-  /** Available SOLID references for the framework's skill. */
-  refs?: RefMeta[];
-  /** Absolute paths of SOLID refs already read this session. */
-  refsRead?: string[];
-  /**
-  * Epoch-ms read timestamp per `refsRead` path (parity track-solid-reads.py
-  * `solid_reads[].timestamp`). PARITY: the TTL applies ONLY to solidReadGate —
-  * Python TTL-izes SOLID reads exclusively (require-solid-read.py); the
-  * skill-trigger/design/shadcn gates stay session-scoped (no TTL). A path in
-  * `refsRead` with no stamp here (tracks recorded before this field existed)
-  * counts as read — backward compat.
-  */
-  refsReadAt?: Record<string, number>;
-  /** Current epoch ms for the SOLID-read TTL check; absent → reads never expire. */
-  now?: number;
-  /** Whether the required prior agents (explore + research) ran within the freshness window. */
-  agentsFresh?: boolean;
-  /** Names of REQUIRED_AGENTS that have NOT run fresh (subset), for a precise freshnessGate message. Absent → generic wording. */
-  missingAgents?: string[];
-  /** Freshness window in ms: labels the block messages' TTL (e.g. "2min") and bounds the SOLID-read TTL in solidReadGate. */
-  windowMs?: number;
-  /** Whether brainstorming is required for this edit (creation intent on a new file). */
-  brainstormRequired?: boolean;
-  /** Whether the brainstorming agent ran within the window. */
-  brainstormFresh?: boolean;
-}
-/** A single APEX gate: returns a blocking {@link Prompt}, or null to pass. */
-type ApexGate = (ctx: ApexContext) => Prompt | null;
-/** Gate: BOTH Context7 AND Exa (or a web fallback alone) must have been consulted this session. */
-declare const docConsultedGate: ApexGate;
-/** Gate: brainstorming must precede creating new files when flagged. */
-declare const brainstormGate: ApexGate;
-/** Gates that run BEFORE Check 1 (harness-specific brainstorm + agent freshness, pre-dating enforce-apex-phases). */
-declare const PRE_AUTH_GATES: ReadonlyArray<ApexGate>;
-/** Gates that run AFTER Check 1: Check 2 (doc consulted once per session) then the SOLID refs. */
-declare const POST_AUTH_GATES: ReadonlyArray<ApexGate>;
-/**
-* Default APEX gate chain (brainstorm, freshness, docs, SOLID refs). Check 1
-* (`apexAuthorizationGate`, policy/apex-authorization.ts) is wired BETWEEN the
-* PRE and POST sub-chains by the runtime (gate-apex.ts), which owns its
-* target-write side effect — parity enforce-apex-phases.ts Check1 -> Check2.
-*/
-declare const APEX_GATES: ReadonlyArray<ApexGate>;
-/**
-* Run the APEX gates (chain-of-responsibility): the first failing gate's prompt
-* wins; null means every gate passed (allow).
-*/
-declare function evaluateApex(ctx: ApexContext, gates?: ReadonlyArray<ApexGate>): Prompt | null;
-//#endregion
-export { PRE_AUTH_GATES as a, evaluateApex as c, POST_AUTH_GATES as i, freshnessGate as l, ApexContext as n, brainstormGate as o, ApexGate as r, docConsultedGate as s, APEX_GATES as t, solidReadGate as u };

package/dist/harness-BQ5_Wnva.d.mts

@@ -1,27 +0,0 @@
-//#region src/detect/interfaces/types.d.ts
-/** Known AI coding harnesses detectable at runtime. */
-type HarnessId = "claude-code" | "codex" | "cursor" | "cline" | "gemini-cli" | "opencode" | "windsurf" | "copilot" | "aider" | "kiro" | "goose" | "amp" | "hermes" | "kimi" | "unknown";
-/** Integration mode: `hook` = native lifecycle hooks; `cli` = run as an external step. */
-type HarnessMode = "hook" | "cli";
-/** How the harness was identified. */
-type HarnessVia = "agent-std" | "ai-agent-std" | "env" | "fallback";
-/** Result of {@link detectHarness}. */
-interface HarnessInfo {
-  id: HarnessId;
-  mode: HarnessMode;
-  via: HarnessVia;
-}
-//#endregion
-//#region src/detect/harness.d.ts
-/** Integration mode for a harness id. */
-declare function modeFor(id: HarnessId): HarnessMode;
-/**
-* Detect the current AI coding harness from environment signals.
-* Priority: `AGENT` standard -> `AI_AGENT` standard -> tool-specific vars -> unknown.
-* @param env - environment map (defaults to `process.env`)
-*/
-declare function detectHarness(env?: Record<string, string | undefined>): HarnessInfo;
-/** Convenience: the integration mode of the current harness. */
-declare function detectMode(env?: Record<string, string | undefined>): HarnessMode;
-//#endregion
-export { HarnessInfo as a, HarnessId as i, detectMode as n, HarnessMode as o, modeFor as r, HarnessVia as s, detectHarness as t };

package/dist/index-BEMumjOw.d.mts

@@ -1,27 +0,0 @@
-//#region src/util/compact-json.d.ts
-/**
-* Compact JSON serializer for cache/state files.
-* Top-level keys are indented one per line; nested objects/arrays render inline.
-* Behaviour preserved from the fusengine hooks.
-*/
-declare function compactJson(data: unknown): string;
-//#endregion
-//#region src/util/project-root.d.ts
-/** True for a source-code file outside generated/vendored directories. */
-declare function isCodeFile(p: string): boolean;
-/**
-* Walk up from `dir` to the nearest ancestor directory containing `marker`.
-* @param dir - Starting directory.
-* @param marker - Sibling file/dir name to look for at each level.
-* @returns The ancestor holding `marker`, or `null` at filesystem root.
-*/
-declare function walkUpFor(dir: string, marker: string): string | null;
-/**
-* Resolve the project root, preferring the repo boundary (`.git`) over a
-* nested `package.json` — avoids false roots in monorepos. Null if none found.
-*/
-declare function projectRootOrNull(dir: string): string | null;
-/** Like {@link projectRootOrNull} but falls back to `process.cwd()`. */
-declare function projectRoot(dir: string): string;
-//#endregion
-export { compactJson as a, walkUpFor as i, projectRoot as n, projectRootOrNull as r, isCodeFile as t };