@fusengine/harness 0.1.1 → 0.1.3

package/dist/memory-BVNt4Ary.mjs

@@ -0,0 +1,94 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+//#region src/memory/gitignore.ts
+/** Ensure `<memoryDir>/.gitignore` ignores the machine-local `state.json`. */
+function ensureMemoryGitignore(memoryDir) {
+	const file = `${memoryDir}/.gitignore`;
+	try {
+		const existing = existsSync(file) ? readFileSync(file, "utf8") : "";
+		if (/^state\.json$/m.test(existing)) return;
+		writeFileSync(file, existing.trim() ? `${existing.trimEnd()}\nstate.json\n` : "state.json\n");
+	} catch {}
+}
+//#endregion
+//#region src/memory/state.ts
+/** Absolute path of the per-project throttle state file. */
+function stateFileFor(root) {
+	return `${root}/MEMORY/state.json`;
+}
+function num(v) {
+	return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+/** Read both throttle timestamps; missing/corrupt fields default to 0. */
+function readState(file) {
+	try {
+		const parsed = JSON.parse(readFileSync(file, "utf8"));
+		return {
+			lastRemindedAt: num(parsed?.lastRemindedAt),
+			lastCodeEditAt: num(parsed?.lastCodeEditAt)
+		};
+	} catch {
+		return {
+			lastRemindedAt: 0,
+			lastCodeEditAt: 0
+		};
+	}
+}
+/** Persist one field without clobbering the other (read-modify-write). */
+function setStateField(file, key, value) {
+	const next = {
+		...readState(file),
+		[key]: value
+	};
+	const dir = dirname(file);
+	mkdirSync(dir, { recursive: true });
+	ensureMemoryGitignore(dir);
+	writeFileSync(file, JSON.stringify(next));
+}
+/** Local wall-clock timestamp for a lesson bullet: `YYYY-MM-DD HH:MM`. */
+function nowStamp() {
+	const d = /* @__PURE__ */ new Date();
+	const p = (n) => String(n).padStart(2, "0");
+	return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
+}
+/** Throttle window (ms) from `FUSE_LESSONS_THROTTLE_MIN` (default 5 min). */
+function throttleMs(env = process.env) {
+	const raw = env.FUSE_LESSONS_THROTTLE_MIN?.trim();
+	const min = raw ? Number(raw) : 5;
+	return (Number.isFinite(min) ? Math.max(0, min) : 5) * 6e4;
+}
+//#endregion
+//#region src/memory/registry.ts
+/** Registry path relative to the home dir. */
+const SUBPATH = ".claude/fusengine-cache/lessons/roots.json";
+/** Absolute path of the global roots registry, or null when home is unusable. */
+function registryFile(home = process.env.HOME) {
+	const h = home?.trim();
+	if (!h || !h.startsWith("/")) return null;
+	return `${h}/${SUBPATH}`;
+}
+/** Read the registered project roots (deduplicated string entries only). */
+function readRoots(home) {
+	const file = registryFile(home);
+	if (!file) return [];
+	try {
+		const parsed = JSON.parse(readFileSync(file, "utf8"));
+		return Array.isArray(parsed) ? parsed.filter((e) => typeof e === "string") : [];
+	} catch {
+		return [];
+	}
+}
+/** Register a project root once (deduplicated, read-modify-write, non-throwing). */
+function addRoot(root, home) {
+	const file = registryFile(home);
+	if (!file) return;
+	try {
+		const roots = new Set(readRoots(home));
+		if (roots.has(root)) return;
+		roots.add(root);
+		mkdirSync(dirname(file), { recursive: true });
+		writeFileSync(file, JSON.stringify([...roots]));
+	} 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 };

package/dist/policy/index.d.mts

@@ -1,80 +1,2 @@
-import { t as Prompt } from "../types-D56jSgD9.mjs";
-
-//#region src/policy/detect-project.d.ts
-/** Project types detected from filesystem indicators. */
-type ProjectType = "nextjs" | "nuxt" | "angular" | "svelte" | "vue" | "react" | "tailwind" | "laravel" | "rails" | "django" | "python" | "go" | "rust" | "swift" | "java" | "scala" | "elixir" | "ruby" | "generic";
-/** Keywords that signal a development task (APEX trigger). */
-declare const DEV_KEYWORDS: RegExp;
-/** True when the prompt invokes the /apex command. */
-declare function isApexCommand(prompt: string): boolean;
-/** Detect the project type by scanning config files in `dir`. */
-declare function detectProjectType(dir: string): ProjectType;
-//#endregion
-//#region src/policy/detect-framework.d.ts
-/**
-* Detect the framework from a file path extension + content patterns.
-* Aligned with the fusengine require-solid-read detection (distinct from
-* {@link detectProjectType}, which scans config files on disk).
-*/
-declare function detectFramework(filePath: string, content: string): string;
-//#endregion
-//#region src/policy/file-size.d.ts
-/** Verdict from {@link evaluateFileSize}. */
-interface FileSizeVerdict {
-  ok: boolean;
-  lines: number;
-  max: number;
-  message: string | null;
-}
-/** Count lines in file content (empty string = 0). */
-declare function countLines(content: string): number;
-/**
-* Evaluate a file's line count against the SOLID limit.
-* @param lines - the file's line count
-* @param max - the limit (defaults to `resolveMaxLines()`)
-*/
-declare function evaluateFileSize(lines: number, max?: number): FileSizeVerdict;
-//#endregion
-//#region src/policy/patterns.d.ts
-/**
-* Guard pattern data, ported verbatim from the fusengine git/install guards.
-* Note (faithful): `git push.*--force` also matches `--force-with-lease` —
-* preserved from the source guard.
-*/
-/** Destructive git operations to block outright. */
-declare const GIT_BLOCKED: ReadonlyArray<RegExp>;
-/** Git operations that warrant a confirmation prompt. */
-declare const GIT_ASK: ReadonlyArray<RegExp>;
-/** System-level package installs (need confirmation). */
-declare const SYSTEM_INSTALL: ReadonlyArray<RegExp>;
-/** Project-level package installs. */
-declare const PROJECT_INSTALL: ReadonlyArray<RegExp>;
-/** True when `cmd` matches any pattern in `patterns`. */
-declare function matchPatterns(cmd: string, patterns: ReadonlyArray<RegExp>): boolean;
-//#endregion
-//#region src/policy/evaluate.d.ts
-/** Harness-agnostic input to {@link evaluate}. */
-interface PolicyContext {
-  /** Tool name (e.g. "Write", "Edit", "Bash"). */
-  tool: string;
-  filePath?: string;
-  content?: string;
-  command?: string;
-  /** Optional override for the SOLID max-lines limit. */
-  maxLines?: number;
-}
-/** Harness-agnostic policy decision (+ a portable prompt for adapters to render). */
-interface PolicyResult {
-  decision: "allow" | "deny" | "warn";
-  message: string | null;
-  prompt?: Prompt;
-  meta?: Record<string, unknown>;
-}
-/**
-* Evaluate a single tool-use against the bundled policies, returning a pure
-* decision plus a portable {@link Prompt}. Adapters translate the prompt into
-* their harness's native response (Claude `permissionDecision`, etc.).
-*/
-declare function evaluate(ctx: PolicyContext): PolicyResult;
-//#endregion
-export { DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, PolicyContext, PolicyResult, ProjectType, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, evaluate, evaluateFileSize, isApexCommand, matchPatterns };
+import { S as isApexCommand, _ as evaluateFileSize, a as evaluateApex, b as ProjectType, c as PolicyResult, d as GIT_BLOCKED, f as PROJECT_INSTALL, g as countLines, h as FileSizeVerdict, i as docConsultedGate, l as evaluate, m as matchPatterns, n as ApexContext, o as solidReadGate, p as SYSTEM_INSTALL, r as ApexGate, s as PolicyContext, t as APEX_GATES, u as GIT_ASK, v as detectFramework, x as detectProjectType, y as DEV_KEYWORDS } from "../index-BXBWKbL8.mjs";
+export { APEX_GATES, ApexContext, ApexGate, DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, PolicyContext, PolicyResult, ProjectType, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, isApexCommand, matchPatterns, solidReadGate };

package/dist/policy/index.mjs

@@ -1,34 +1,3 @@
+import { a as DEV_KEYWORDS, i as solidReadGate, n as docConsultedGate, o as detectProjectType, r as evaluateApex, s as isApexCommand, t as APEX_GATES } from "../policy-DMpyaPZ_.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 { 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 { DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, evaluate, evaluateFileSize, isApexCommand, matchPatterns };
+export { APEX_GATES, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, isApexCommand, matchPatterns, solidReadGate };

package/dist/policy-DMpyaPZ_.mjs

@@ -0,0 +1,68 @@
+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 : {
+	kind: "block",
+	title: "APEX: documentation not consulted",
+	reason: formatDocDeny(ctx.framework),
+	actions: ["Call mcp__context7__query-docs", "Call mcp__exa__web_search_exa"]
+};
+/** Gate: the routed SOLID references for this edit must have been read. */
+const solidReadGate = (ctx) => {
+	if (!ctx.refs?.length) return null;
+	const routed = routeReferences(ctx.refs, ctx.filePath, ctx.content);
+	if (!routed) return null;
+	const read = new Set(ctx.refsRead ?? []);
+	const missing = routed.required.map((r) => r.meta.filePath).filter((p) => !read.has(p));
+	if (missing.length === 0) return null;
+	return {
+		kind: "block",
+		title: `APEX: read SOLID references for ${ctx.framework}`,
+		reason: `Read these before editing ${ctx.filePath}:`,
+		actions: missing
+	};
+};
+/** Default APEX gate chain. */
+const APEX_GATES = [docConsultedGate, solidReadGate];
+/**
+* Run the APEX gates (chain-of-responsibility): the first failing gate's prompt
+* wins; null means every gate passed (allow).
+*/
+function evaluateApex(ctx, gates = APEX_GATES) {
+	return gates.reduce((hit, gate) => hit ?? gate(ctx), null);
+}
+//#endregion
+export { DEV_KEYWORDS as a, solidReadGate as i, docConsultedGate as n, detectProjectType as o, evaluateApex as r, isApexCommand as s, APEX_GATES as t };

package/dist/prompt/index.mjs

@@ -1,2 +1,3 @@
 import { t as formatPrompt } from "../types-ernB1Dy3.mjs";
+import "../prompt-la_KkjCS.mjs";
 export { formatPrompt };

package/dist/prompt-la_KkjCS.mjs

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

package/dist/refs/index.d.mts

@@ -1,44 +1,3 @@
-//#region src/refs/types.d.ts
-/** Parsed frontmatter metadata from a reference .md file. */
-interface RefMeta {
-  name: string;
-  description: string;
-  keywords: string;
-  priority: string;
-  related: string;
-  appliesTo: string;
-  triggerOnEdit: string;
-  level: string;
-  filePath: string;
-}
-/** A reference with its computed routing score. */
-interface ScoredRef {
-  meta: RefMeta;
-  score: number;
-}
-/** Routing result with categorized references. */
-interface RouteResult {
-  required: ScoredRef[];
-  optional: ScoredRef[];
-  skillPath: string;
-}
-//#endregion
-//#region src/refs/frontmatter.d.ts
-/** Extract frontmatter key/value pairs from markdown content (quotes stripped). */
-declare function parseFrontmatter(content: string): Record<string, string>;
-/** Convert a simple glob (`**`, `*`) to an anchored RegExp. */
-declare function globToRe(g: string): RegExp;
-//#endregion
-//#region src/refs/router.d.ts
-/**
-* Score references against a file edit (pure):
-* +10 per `applies-to` glob match, +5 per `trigger-on-edit` fragment, +1 per keyword.
-*/
-declare function scoreReferences(refs: RefMeta[], filePath: string, content: string): ScoredRef[];
-/**
-* Route references for a file edit: top-2 required + next-2 optional, ensuring a
-* `principle` and a `template` appear in the top 4. Returns null when nothing scores.
-*/
-declare function routeReferences(refs: RefMeta[], filePath: string, content: string, skillPath?: string): RouteResult | null;
-//#endregion
+import { n as RouteResult, r as ScoredRef, t as RefMeta } from "../types-CY5qT2X1.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "../index-C2Lz-cwJ.mjs";
 export { RefMeta, RouteResult, ScoredRef, globToRe, parseFrontmatter, routeReferences, scoreReferences };

package/dist/refs/index.mjs

@@ -1,70 +1,3 @@
-//#region src/refs/frontmatter.ts
-/** Extract frontmatter key/value pairs from markdown content (quotes stripped). */
-function parseFrontmatter(content) {
-	const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-	if (!m?.[1]) return {};
-	const result = {};
-	for (const line of m[1].split("\n")) {
-		const idx = line.indexOf(":");
-		if (idx > 0) result[line.slice(0, idx).trim()] = line.slice(idx + 1).trim().replace(/^["']|["']$/g, "");
-	}
-	return result;
-}
-/** Convert a simple glob (`**`, `*`) to an anchored RegExp. */
-function globToRe(g) {
-	const escaped = g.trim().replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\0/g, ".*");
-	return new RegExp(`^${escaped}$`);
-}
-//#endregion
-//#region src/refs/router.ts
-/**
-* Score references against a file edit (pure):
-* +10 per `applies-to` glob match, +5 per `trigger-on-edit` fragment, +1 per keyword.
-*/
-function scoreReferences(refs, filePath, content) {
-	const scored = [];
-	for (const meta of refs) {
-		let score = 0;
-		if (meta.appliesTo) {
-			for (const g of meta.appliesTo.split(", ")) if (globToRe(g).test(filePath)) score += 10;
-		}
-		if (meta.triggerOnEdit) {
-			for (const frag of meta.triggerOnEdit.split(", ")) if (filePath.includes(frag.trim())) score += 5;
-		}
-		if (meta.keywords) for (const kw of meta.keywords.split(", ")) {
-			const k = kw.trim();
-			if (k && (filePath.includes(k) || content.includes(k))) score += 1;
-		}
-		if (score > 0) scored.push({
-			meta,
-			score
-		});
-	}
-	return scored;
-}
-/**
-* Route references for a file edit: top-2 required + next-2 optional, ensuring a
-* `principle` and a `template` appear in the top 4. Returns null when nothing scores.
-*/
-function routeReferences(refs, filePath, content, skillPath = "") {
-	const scored = scoreReferences(refs, filePath, content);
-	if (!scored.length) return null;
-	scored.sort((a, b) => b.score - a.score);
-	const hoist = (level) => {
-		if (scored.slice(0, 4).some((r) => r.meta.level === level)) return;
-		const found = scored.find((r) => r.meta.level === level);
-		if (found) {
-			scored.splice(scored.indexOf(found), 1);
-			scored.splice(3, 0, found);
-		}
-	};
-	hoist("principle");
-	hoist("template");
-	return {
-		required: scored.slice(0, 2),
-		optional: scored.slice(2, 4),
-		skillPath
-	};
-}
-//#endregion
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "../router-Dj3AfgBE.mjs";
+import "../refs-la_KkjCS.mjs";
 export { globToRe, parseFrontmatter, routeReferences, scoreReferences };

package/dist/refs-la_KkjCS.mjs

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

package/dist/router-Dj3AfgBE.mjs

@@ -0,0 +1,70 @@
+//#region src/refs/frontmatter.ts
+/** Extract frontmatter key/value pairs from markdown content (quotes stripped). */
+function parseFrontmatter(content) {
+	const m = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+	if (!m?.[1]) return {};
+	const result = {};
+	for (const line of m[1].split("\n")) {
+		const idx = line.indexOf(":");
+		if (idx > 0) result[line.slice(0, idx).trim()] = line.slice(idx + 1).trim().replace(/^["']|["']$/g, "");
+	}
+	return result;
+}
+/** Convert a simple glob (`**`, `*`) to an anchored RegExp. */
+function globToRe(g) {
+	const escaped = g.trim().replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*\*/g, "\0").replace(/\*/g, "[^/]*").replace(/\0/g, ".*");
+	return new RegExp(`^${escaped}$`);
+}
+//#endregion
+//#region src/refs/router.ts
+/**
+* Score references against a file edit (pure):
+* +10 per `applies-to` glob match, +5 per `trigger-on-edit` fragment, +1 per keyword.
+*/
+function scoreReferences(refs, filePath, content) {
+	const scored = [];
+	for (const meta of refs) {
+		let score = 0;
+		if (meta.appliesTo) {
+			for (const g of meta.appliesTo.split(", ")) if (globToRe(g).test(filePath)) score += 10;
+		}
+		if (meta.triggerOnEdit) {
+			for (const frag of meta.triggerOnEdit.split(", ")) if (filePath.includes(frag.trim())) score += 5;
+		}
+		if (meta.keywords) for (const kw of meta.keywords.split(", ")) {
+			const k = kw.trim();
+			if (k && (filePath.includes(k) || content.includes(k))) score += 1;
+		}
+		if (score > 0) scored.push({
+			meta,
+			score
+		});
+	}
+	return scored;
+}
+/**
+* Route references for a file edit: top-2 required + next-2 optional, ensuring a
+* `principle` and a `template` appear in the top 4. Returns null when nothing scores.
+*/
+function routeReferences(refs, filePath, content, skillPath = "") {
+	const scored = scoreReferences(refs, filePath, content);
+	if (!scored.length) return null;
+	scored.sort((a, b) => b.score - a.score);
+	const hoist = (level) => {
+		if (scored.slice(0, 4).some((r) => r.meta.level === level)) return;
+		const found = scored.find((r) => r.meta.level === level);
+		if (found) {
+			scored.splice(scored.indexOf(found), 1);
+			scored.splice(3, 0, found);
+		}
+	};
+	hoist("principle");
+	hoist("template");
+	return {
+		required: scored.slice(0, 2),
+		optional: scored.slice(2, 4),
+		skillPath
+	};
+}
+//#endregion
+export { parseFrontmatter as i, scoreReferences as n, globToRe as r, routeReferences as t };

package/dist/run-Cc98348q.mjs

@@ -0,0 +1,94 @@
+import { chmodSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+//#region src/init/templates.ts
+function json(obj) {
+	return `${JSON.stringify(obj, null, 2)}\n`;
+}
+/** Claude Code: PreToolUse(Write|Edit) -> command. Target: `.claude/settings.json`. */
+function claudeInit(command) {
+	return {
+		path: ".claude/settings.json",
+		content: json({ hooks: { PreToolUse: [{
+			matcher: "Write|Edit",
+			hooks: [{
+				type: "command",
+				command
+			}]
+		}] } })
+	};
+}
+/** Codex CLI: `.codex/hooks.json` — PreToolUse (Claude-compatible shape). */
+function codexInit(command) {
+	return {
+		path: ".codex/hooks.json",
+		content: json({ hooks: { PreToolUse: [{
+			matcher: "Bash|apply_patch",
+			hooks: [{
+				type: "command",
+				command
+			}]
+		}] } })
+	};
+}
+/** Cursor: `.cursor/hooks.json` (version 1) — shell + file-edit hooks. */
+function cursorInit(command) {
+	return {
+		path: ".cursor/hooks.json",
+		content: json({
+			version: 1,
+			hooks: {
+				beforeShellExecution: [{ command }],
+				afterFileEdit: [{ command }]
+			}
+		})
+	};
+}
+/** Gemini CLI: `.gemini/settings.json` — BeforeTool, timeout in ms. */
+function geminiInit(command) {
+	return {
+		path: ".gemini/settings.json",
+		content: json({ hooks: { BeforeTool: [{
+			matcher: "write_file|edit_file|replace",
+			hooks: [{
+				type: "command",
+				command,
+				timeout: 3e4
+			}]
+		}] } })
+	};
+}
+/** Cline: an executable `.clinerules/hooks/PreToolUse` that pipes stdin to the command. */
+function clineInit(command) {
+	return {
+		path: ".clinerules/hooks/PreToolUse",
+		content: `#!/usr/bin/env bash\n# fuse-harness Cline hook — evaluate each tool use\ncat | ${command}\n`,
+		executable: true
+	};
+}
+//#endregion
+//#region src/init/run.ts
+const RUNNERS = {
+	"claude-code": claudeInit,
+	codex: codexInit,
+	cursor: cursorInit,
+	"gemini-cli": geminiInit,
+	cline: clineInit
+};
+/**
+* Build the wiring file for a harness, or null when it has no hook integration
+* (cli-mode harnesses use `harness check` in a pre-commit step instead).
+*/
+function initFor(id, command = `npx harness hook ${id}`) {
+	const make = RUNNERS[id];
+	return make ? make(command) : null;
+}
+/** Write an {@link InitFile} under `root` (creates dirs; `chmod +x` when executable). */
+function writeInitFile(root, file) {
+	const full = join(root, file.path);
+	mkdirSync(dirname(full), { recursive: true });
+	writeFileSync(full, file.content);
+	if (file.executable) chmodSync(full, 493);
+	return full;
+}
+//#endregion
+export { codexInit as a, clineInit as i, writeInitFile as n, cursorInit as o, claudeInit as r, geminiInit as s, initFor as t };

package/dist/state/index.d.mts

@@ -1,59 +1,2 @@
-import { t as AuthEntry } from "../doc-helpers-CG1nuf-c.mjs";
-
-//#region src/state/lock.d.ts
-/**
-* Acquire a directory-based lock (atomic `mkdir`, EEXIST = already held) with a timeout.
-* @returns a release function, or null if the lock could not be acquired in time.
-*/
-declare function acquireLock(lockDir: string, timeoutMs?: number): Promise<(() => Promise<void>) | null>;
-//#endregion
-//#region src/state/apex-state.d.ts
-declare const DEFAULT_STATE: {
-  $schema: string;
-  description: string;
-  target: Record<string, string>;
-  authorizations: Record<string, AuthEntry & {
-    doc_consulted?: string;
-  }>;
-};
-/** APEX state shape. */
-type ApexState = typeof DEFAULT_STATE;
-/** APEX state directory under a home dir. */
-declare function apexStateDir(home?: string): string;
-/** Daily state file path: `<home>/.claude/logs/00-apex/<YYYY-MM-DD>-state.json`. */
-declare function stateFilePath(home?: string, today?: string): string;
-/** Ensure the state directory exists and return its path. */
-declare function ensureStateDir(home?: string): Promise<string>;
-/** Load APEX state, or a fresh default. */
-declare function loadState(path: string): Promise<ApexState>;
-/** Save APEX state. */
-declare function saveState(path: string, state: ApexState): Promise<void>;
-//#endregion
-//#region src/state/task-helpers.d.ts
-/** A task entry in task.json. */
-interface ApexTask {
-  subject: string;
-  description: string;
-  status: string;
-  phase: string;
-  started_at?: string;
-  completed_at?: string;
-  created_at?: string;
-  doc_consulted: Record<string, unknown>;
-  files_modified: string[];
-  blockedBy?: string[];
-}
-/** Structure of `.claude/apex/task.json`. */
-interface ApexTaskFile {
-  current_task: string;
-  created_at: string;
-  tasks: Record<string, ApexTask>;
-}
-/** Add a new pending task. */
-declare function taskCreate(file: string, id: string, subject: string, desc: string): Promise<void>;
-/** Mark a task in_progress (creating a stub if absent). */
-declare function taskStart(file: string, id: string, subject?: string, desc?: string, blocked?: string): Promise<void>;
-/** Mark a task completed. */
-declare function taskComplete(file: string, id: string): Promise<void>;
-//#endregion
+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";
 export { ApexState, ApexTask, ApexTaskFile, acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart };