@fusengine/harness 0.1.27 → 0.1.29

package/dist/handle-BJ2xdeA-.mjs

@@ -1,347 +0,0 @@
-import { r as projectLayout } from "./layout-C0jaaCQC.mjs";
-import { j as detectFramework, n as FAIL_CLOSED, t as evaluate } from "./evaluate-BIK60lOR.mjs";
-import { c as evaluateApex, i as detectCreationIntent, r as capVerbosity } from "./verbosity-CXpf3aQQ.mjs";
-import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
-import { a as extractText, r as cacheStore, t as cacheLookup } from "./store-DeIsfMg5.mjs";
-import { t as loadRefs } from "./loader-CyAoJv2W.mjs";
-import { a as recordAgent, c as recordRefRead, 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";
-import { join } from "node:path";
-import { existsSync, readFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-//#region src/runtime/activity.ts
-/** Min response length (chars) for a lead agent call to count as `sufficient`. */
-const AGENT_QUALITY_MIN = 500;
-/** 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() ?? "";
-		if (!name) return null;
-		const quality = event.responseLength === void 0 ? void 0 : event.responseLength > AGENT_QUALITY_MIN ? "sufficient" : "insufficient";
-		return quality ? {
-			kind: "agent",
-			name,
-			ts: event.now,
-			quality
-		} : {
-			kind: "agent",
-			name,
-			ts: event.now
-		};
-	}
-	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} (2 min — matches the plugin's `FUSE_ENFORCE_TTL_SEC` default). */
-const DEFAULT_WINDOW_MS = 12e4;
-/** Trivial edits allowed within the window before the full APEX gates apply. */
-const TRIVIAL_BUDGET = 4;
-/** Line count of the existing on-disk file (undefined if absent/unreadable). */
-function existingLineCount(path) {
-	if (!path) return void 0;
-	try {
-		return existsSync(path) ? readFileSync(path, "utf8").split("\n").length : void 0;
-	} catch {
-		return;
-	}
-}
-/**
-* Full gate: the stateless guards (file-size, git, security...) first, then a
-* trivial-edit fast path, then the stateful APEX gates fed from the session
-* track. Returns the first blocking prompt, or null to allow.
-*/
-async function gate(input) {
-	let quick;
-	try {
-		quick = evaluate({
-			tool: input.tool,
-			filePath: input.filePath,
-			content: input.content,
-			command: input.command,
-			agentType: input.agentType,
-			existingLines: existingLineCount(input.filePath)
-		});
-	} catch {
-		return FAIL_CLOSED;
-	}
-	if (quick.decision !== "allow" && quick.prompt) return quick.prompt;
-	if (!input.filePath) return null;
-	const window = input.windowMs ?? 12e4;
-	const track = await loadTrack(input.trackFile);
-	const lineCount = input.content === void 0 ? Number.POSITIVE_INFINITY : input.content.split("\n").length;
-	if (!input.isReplaceAll && lineCount < 5 && trivialCount(track, window, input.now) < 4) {
-		await saveTrack(input.trackFile, recordTrivialEdit(track, input.now, window, input.now));
-		return null;
-	}
-	const ctx = {
-		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], window, input.now),
-		brainstormRequired: track.brainstormRequired,
-		brainstormFresh: agentsFresh(track, ["brainstorming"], window, input.now)
-	};
-	try {
-		return evaluateApex(ctx);
-	} catch {
-		return FAIL_CLOSED;
-	}
-}
-//#endregion
-//#region src/runtime/mcp.ts
-/** Default freshness for cached MCP/WebFetch results (48h). */
-const MCP_TTL_MS = 1728e5;
-/** MCP doc tools + WebFetch whose calls are cached / verbosity-capped. */
-function isMcpTool(tool) {
-	return /context7|exa|webfetch|web_fetch/i.test(tool) || tool === "WebFetch";
-}
-/** The query/url that keys the cache. */
-function queryOf(input) {
-	const q = input.query ?? input.url ?? input.libraryId ?? "";
-	return typeof q === "string" ? q : JSON.stringify(q);
-}
-function denyWith(id, content) {
-	if (id === "claude-code" || id === "codex") return JSON.stringify({ hookSpecificOutput: {
-		hookEventName: "PreToolUse",
-		permissionDecision: "deny",
-		permissionDecisionReason: content
-	} });
-	if (id === "gemini-cli") return JSON.stringify({
-		decision: "deny",
-		reason: content
-	});
-	return "";
-}
-function mutateWith(id, input) {
-	if (id === "claude-code" || id === "codex") return JSON.stringify({ hookSpecificOutput: {
-		hookEventName: "PreToolUse",
-		permissionDecision: "allow",
-		updatedInput: input
-	} });
-	if (id === "gemini-cli") return JSON.stringify({ hookSpecificOutput: { tool_input: input } });
-	return "";
-}
-/** The doc provider a served cache-hit satisfies (`exa`/`context7`), else undefined. */
-function docSourceOf(tool) {
-	if (/exa/i.test(tool)) return "exa";
-	if (/context7/i.test(tool)) return "context7";
-}
-/**
-* Pre-event MCP interception: serve a fresh cache hit (deny + cached content),
-* else cap exa verbosity (allow + mutated input), else null to allow normally.
-* Harnesses without input-mutation/cache support fall through to null.
-*/
-function mcpPreIntercept(id, tool, input, dir, ttlMs, now) {
-	if (!isMcpTool(tool)) return null;
-	const cached = cacheLookup(dir, tool, queryOf(input), ttlMs, now);
-	if (cached) {
-		const served = denyWith(id, cached);
-		if (served) return {
-			stdout: served,
-			docSource: docSourceOf(tool)
-		};
-	}
-	const capped = capVerbosity(tool, input);
-	if (capped) {
-		const mutated = mutateWith(id, capped);
-		if (mutated) return { stdout: mutated };
-	}
-	return null;
-}
-/** Post-event: store the MCP/WebFetch response (extracted to markdown) in the cache. */
-function mcpPostStore(tool, input, response, dir) {
-	if (!isMcpTool(tool)) return;
-	cacheStore(dir, tool, queryOf(input), extractText(response));
-}
-//#endregion
-//#region src/runtime/normalize.ts
-function str(v) {
-	return typeof v === "string" ? v : void 0;
-}
-/**
-* Normalize a harness hook payload into a uniform event. Handles Cline's nested
-* `preToolUse`/`postToolUse` shape and the top-level `tool_name`/`tool_input`
-* shape used by Claude, Codex, Gemini, and Cursor.
-*/
-function normalizeEvent(id, payload) {
-	if (id === "cline") {
-		const post = payload.postToolUse;
-		const node = post ?? payload.preToolUse ?? {};
-		const params = node.parameters ?? {};
-		return {
-			phase: post ? "post" : "pre",
-			tool: str(node.toolName) ?? "",
-			input: params,
-			sessionId: str(payload.taskId) ?? "",
-			filePath: str(params.path),
-			content: str(params.content),
-			command: str(params.command)
-		};
-	}
-	const event = str(payload.hook_event_name) ?? "";
-	const input = payload.tool_input ?? payload;
-	return {
-		phase: /post|after/i.test(event) ? "post" : "pre",
-		tool: str(payload.tool_name) ?? "",
-		input,
-		sessionId: str(payload.session_id) ?? str(payload.conversation_id) ?? "",
-		filePath: str(input.file_path) ?? str(input.path) ?? str(payload.file_path),
-		content: str(input.content) ?? str(input.new_string),
-		command: str(input.command) ?? str(payload.command),
-		agentType: str(payload.agent_type) ?? str(input.subagent_type)
-	};
-}
-//#endregion
-//#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/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.quality) : activity.kind === "doc" ? recordDoc(track, activity.framework, activity.sessionId, activity.source) : recordRefRead(track, activity.path));
-}
-//#endregion
-//#region src/runtime/respond.ts
-/**
-* Map a portable {@link Prompt} to a harness's native hook response. `block`
-* denies; anything else asks/injects context. (Codex/Cursor parse but ignore
-* `ask` — they only honor deny.)
-*/
-function respond(id, prompt) {
-	const message = formatPrompt(prompt);
-	const deny = prompt.kind === "block";
-	switch (id) {
-		case "claude-code":
-		case "codex": return JSON.stringify({ hookSpecificOutput: {
-			hookEventName: "PreToolUse",
-			permissionDecision: deny ? "deny" : "ask",
-			permissionDecisionReason: message
-		} });
-		case "gemini-cli": return JSON.stringify(deny ? {
-			decision: "deny",
-			reason: message
-		} : { hookSpecificOutput: { additionalContext: message } });
-		case "cursor": return JSON.stringify({
-			permission: deny ? "deny" : "ask",
-			continue: false,
-			userMessage: message,
-			agentMessage: message
-		});
-		case "cline": return JSON.stringify(deny ? {
-			cancel: true,
-			errorMessage: message
-		} : { contextModification: message });
-		default: return "";
-	}
-}
-//#endregion
-//#region src/runtime/handle.ts
-/**
-* The full hook handler: on a PRE event it gates the tool-use (stateless guards
-* then APEX gates from the session track) and returns the native response; on a
-* POST event it records the activity into the track. The loop that makes the
-* package behave like the Claude plugin, on any harness.
-*/
-async function handleHook(id, payload, opts) {
-	const event = normalizeEvent(id, payload);
-	const layout = projectLayout(opts.cwd);
-	const file = trackFile(event.sessionId, layout.trackDir);
-	const mcpDir = layout.cacheDir;
-	const framework = detectFramework(event.filePath ?? "", event.content ?? "");
-	const userPrompt = typeof payload.prompt === "string" ? payload.prompt : void 0;
-	if (userPrompt !== void 0) {
-		await saveTrack(file, recordBrainstormRequired(await loadTrack(file), detectCreationIntent(userPrompt)));
-		return {
-			stdout: "",
-			exit: 0
-		};
-	}
-	if (event.phase === "post") {
-		const response = payload.tool_response ?? payload.tool_output;
-		mcpPostStore(event.tool, event.input, response, mcpDir);
-		const activity = activityFor({
-			tool: event.tool,
-			input: event.input,
-			sessionId: event.sessionId,
-			framework,
-			now: opts.now,
-			responseLength: extractText(response).length
-		});
-		if (activity) await recordActivity(file, activity);
-		return {
-			stdout: "",
-			exit: 0
-		};
-	}
-	const intercept = mcpPreIntercept(id, event.tool, event.input, mcpDir, MCP_TTL_MS, opts.now);
-	if (intercept !== null) {
-		if (intercept.docSource) await recordActivity(file, {
-			kind: "doc",
-			framework,
-			sessionId: event.sessionId,
-			source: intercept.docSource
-		});
-		return {
-			stdout: intercept.stdout,
-			exit: 0
-		};
-	}
-	const prompt = await gate({
-		sessionId: event.sessionId,
-		framework,
-		tool: event.tool,
-		filePath: event.filePath,
-		content: event.content,
-		command: event.command,
-		refs: opts.refsDir ? await loadRefs(opts.refsDir) : void 0,
-		isReplaceAll: event.input.replace_all === true,
-		agentType: event.agentType,
-		windowMs: opts.windowMs,
-		now: opts.now,
-		trackFile: file
-	});
-	return prompt ? {
-		stdout: respond(id, prompt),
-		exit: 0
-	} : {
-		stdout: "",
-		exit: 0
-	};
-}
-//#endregion
-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/policy-EuVJ_5hS.mjs

@@ -1,33 +0,0 @@
-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;
-/** 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/verbosity-CXpf3aQQ.mjs

@@ -1,98 +0,0 @@
-import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
-import { t as routeReferences } from "./router-D8cVrI-s.mjs";
-//#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
-	};
-};
-/** Gate: the required prior agents (explore + research) must have run within the window. */
-const freshnessGate = (ctx) => ctx.agentsFresh === false ? {
-	kind: "block",
-	title: "APEX: explore + research required",
-	reason: `Run explore-codebase and research-expert (within the freshness window) before editing ${ctx.framework}.`,
-	actions: ["Launch the explore-codebase agent", "Launch the research-expert agent"]
-} : null;
-/** Gate: brainstorming must precede creating new files when flagged. */
-const brainstormGate = (ctx) => ctx.brainstormRequired && ctx.brainstormFresh === false ? {
-	kind: "block",
-	title: "APEX: brainstorm first",
-	reason: `Creation intent detected — brainstorm before creating new ${ctx.framework} files.`,
-	actions: ["Launch the brainstorming agent"]
-} : null;
-/** Default APEX gate chain (brainstorm, freshness, docs, SOLID refs). */
-const APEX_GATES = [
-	brainstormGate,
-	freshnessGate,
-	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
-//#region src/policy/creation-intent.ts
-const CREATE_RE = /\b(?:create|implement|add|build|new|feature|component|generate|make|develop|scaffold)\b/i;
-const SKIP_RE = /\b(?:fix|bug|debug|update|refactor|rename|move|delete|remove|commit|push|edit|modify|change)\b/i;
-/**
-* True when a prompt expresses creation intent (a new feature/component) and is
-* not a fix/refactor — the signal that brainstorming should precede creation.
-* The harness calls this on UserPromptSubmit, then `recordBrainstormRequired`.
-*/
-function detectCreationIntent(prompt) {
-	return CREATE_RE.test(prompt) && !SKIP_RE.test(prompt);
-}
-//#endregion
-//#region src/policy/verbosity.ts
-/** Exa MCP tools whose result count + token budget are capped. */
-const EXA_TOOLS = /exa__web_search|exa__get_code_context|exa_web_search|exa_get_code_context/i;
-/** Context7 doc tool whose token budget is capped. */
-const CONTEXT7_TOOLS = /context7__query-docs|context7_query-docs|query-docs/i;
-/** Max results an exa MCP call may request. */
-const MAX_EXA_RESULTS = 3;
-/** Max token budget for exa `tokensNum` / context7 `tokens`. */
-const MAX_TOKENS = 2e3;
-/**
-* Cap an MCP call's verbosity — exa `numResults` ≤ 3 (+ `tokensNum` ≤ 2000),
-* Context7 `tokens` ≤ 2000. Returns the capped input (a mutation for the harness
-* to apply) when a change is needed, else null.
-*/
-function capVerbosity(tool, input) {
-	const out = { ...input };
-	let changed = false;
-	const cap = (key, max, force) => {
-		const v = out[key];
-		if (typeof v === "number" && v > max || force && typeof v !== "number") {
-			out[key] = max;
-			changed = true;
-		}
-	};
-	if (EXA_TOOLS.test(tool)) {
-		cap("numResults", 3, true);
-		cap("tokensNum", MAX_TOKENS, false);
-	} else if (CONTEXT7_TOOLS.test(tool)) cap("tokens", MAX_TOKENS, false);
-	return changed ? out : null;
-}
-//#endregion
-export { APEX_GATES as a, evaluateApex as c, detectCreationIntent as i, freshnessGate as l, MAX_TOKENS as n, brainstormGate as o, capVerbosity as r, docConsultedGate as s, MAX_EXA_RESULTS as t, solidReadGate as u };