@fusengine/harness 0.1.79 → 0.1.81

package/dist/runtime/index.mjs

@@ -1,6 +1,6 @@
-import { r as projectLayout } from "../layout-C0jaaCQC.mjs";
-import { a as sanitizeSessionId, c as sessionsDir, i as loadSessionState, n as fuseHarnessHome, o as saveSessionState, r as fusengineCache, s as sessionStatePath, t as claudeHome } from "../home-state-BXf38Zi1.mjs";
-import { A as trackMcpResearch, At as defaultStateDir, B as generateProjectMap, C as seoPostToolUse, Ct as trimLogFile, D as securityAdvisoryForPatch, Dt as claudeMdKey, E as securityAdvisory, Et as projectContext, F as dispatchAipilot, Ft as loadSecurityState, G as countFiles, H as writeTree, I as dispatchLessons, It as saveSecurityState, J as lessonsArchiveFileFor, K as getFileDesc, L as cartoSessionStart, Lt as securityStateDir, M as trackEnrichment, Mt as trackFile, N as dispatchLifecycle, Nt as normalizeEvent, O as postTrackingSideEffects, Ot as promptSubmitContext, P as aipilotPostToolUse, Pt as isoUtc, R as generateEcosystemMap, Rt as securityStatePath, S as postEditContext, St as removeOldFiles, T as dispatchMemory, Tt as gitContext, U as loadEnriched, V as isProject, W as mergeLines, X as lessonsStateFileFor, Y as lessonsFileFor, _ as preCommitGate, _t as readRules, a as recordActivity, at as saveApexState, b as extractSymbols, bt as pruneEmptyDirs, c as MCP_TTL_MS, ct as trackAgentMemory, d as isMcpTool, dt as validateSolidGate, f as queryOf, ft as checkFileSize, g as gate, gt as injectRules, h as TRIVIAL_BUDGET, ht as solidDetectStart, i as respond, it as cleanupSession, j as trackSkillRead, jt as projectHash, k as trackWatchResearch, kt as taskContext, l as WEBFETCH_TTL_MS, lt as subagentCacheContext, m as REQUIRED_AGENTS, mt as detectSolidProfile, n as activityFor, nt as trackSessionChanges, o as mcpPostStore, ot as logToolFailure, p as DEFAULT_WINDOW_MS, pt as countLoc, q as listChildren, r as handlePre, rt as validateRulesLoaded, s as mcpPreIntercept, st as validateTeammateOutput, t as handleHook, tt as postEditTypescript, u as cacheQueryOf, ut as validateTailwind, v as detectDuplication, vt as runSessionStartCleanups, w as seoPostToolUseResponse, wt as devContext, x as lifecycleStdout, xt as purgeTtlTree, y as dryGate, yt as sessionStartCore, z as writePluginMap, zt as todayUtc } from "../handle-Dthtlp7Z.mjs";
+import { r as projectLayout } from "../layout-KWoE_Mqn.mjs";
+import { a as sanitizeSessionId, c as sessionsDir, i as loadSessionState, n as fuseHarnessHome, o as saveSessionState, r as fusengineCache, s as sessionStatePath, t as claudeHome } from "../home-state-oUGFB4ds.mjs";
+import { A as trackMcpResearch, At as defaultStateDir, B as generateProjectMap, C as seoPostToolUse, Ct as trimLogFile, D as securityAdvisoryForPatch, Dt as claudeMdKey, E as securityAdvisory, Et as projectContext, F as dispatchAipilot, Ft as loadSecurityState, G as countFiles, H as writeTree, I as dispatchLessons, It as saveSecurityState, J as lessonsArchiveFileFor, K as getFileDesc, L as cartoSessionStart, Lt as securityStateDir, M as trackEnrichment, Mt as trackFile, N as dispatchLifecycle, Nt as normalizeEvent, O as postTrackingSideEffects, Ot as promptSubmitContext, P as aipilotPostToolUse, Pt as isoUtc, R as generateEcosystemMap, Rt as securityStatePath, S as postEditContext, St as removeOldFiles, T as dispatchMemory, Tt as gitContext, U as loadEnriched, V as isProject, W as mergeLines, X as lessonsStateFileFor, Y as lessonsFileFor, _ as preCommitGate, _t as readRules, a as recordActivity, at as saveApexState, b as extractSymbols, bt as pruneEmptyDirs, c as MCP_TTL_MS, ct as trackAgentMemory, d as isMcpTool, dt as validateSolidGate, f as queryOf, ft as checkFileSize, g as gate, gt as injectRules, h as TRIVIAL_BUDGET, ht as solidDetectStart, i as respond, it as cleanupSession, j as trackSkillRead, jt as projectHash, k as trackWatchResearch, kt as taskContext, l as WEBFETCH_TTL_MS, lt as subagentCacheContext, m as REQUIRED_AGENTS, mt as detectSolidProfile, n as activityFor, nt as trackSessionChanges, o as mcpPostStore, ot as logToolFailure, p as DEFAULT_WINDOW_MS, pt as countLoc, q as listChildren, r as handlePre, rt as validateRulesLoaded, s as mcpPreIntercept, st as validateTeammateOutput, t as handleHook, tt as postEditTypescript, u as cacheQueryOf, ut as validateTailwind, v as detectDuplication, vt as runSessionStartCleanups, w as seoPostToolUseResponse, wt as devContext, x as lifecycleStdout, xt as purgeTtlTree, y as dryGate, yt as sessionStartCore, z as writePluginMap, zt as todayUtc } from "../handle-J5r2f_O_.mjs";
 //#region src/runtime/storage.ts
 /**
 * The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,

package/dist/{session-state-CY4iohn_.d.mts → session-state-D5gLr66m.d.mts}

@@ -1,5 +1,4 @@
-import { t as AuthEntry } from "./doc-helpers-CEKzGg2u.mjs";
-
+import { t as AuthEntry } from "./doc-helpers-BGCzP9VF.mjs";
 //#region src/policy/apex-authorization.d.ts
 /** Pending doc-credit target written on a Check-1 deny (parity enforce-apex-phases.ts:80 `state.target`). */
 interface SessionTarget {
@@ -11,11 +10,11 @@ interface SessionTarget {
 //#endregion
 //#region src/tracking/receipts.d.ts
 /**
-* A verification receipt captured at PostToolUse from a Bash verification
-* command. Feeds the TaskCompleted receipt gate: a "done" over modified code
-* files is refused unless a fresh, passing receipt (`exitCode === 0`, `fail === 0`)
-* exists. `pass`/`fail` are parsed only for test runs; `tsc` carries the code alone.
-*/
+ * A verification receipt captured at PostToolUse from a Bash verification
+ * command. Feeds the TaskCompleted receipt gate: a "done" over modified code
+ * files is refused unless a fresh, passing receipt (`exitCode === 0`, `fail === 0`)
+ * exists. `pass`/`fail` are parsed only for test runs; `tsc` carries the code alone.
+ */
 interface Receipt {
   kind: "tsc" | "test";
   exitCode: number;
@@ -32,13 +31,13 @@ interface SessionTrack {
   authorizations: Record<string, AuthEntry>;
   refsRead: string[];
   /**
-  * Epoch-ms timestamp of each reference read, keyed by `refsRead` path (parity
-  * track-solid-reads.py `solid_reads[].timestamp`). Optional: tracks persisted
-  * before this field existed only carry `refsRead`, and such paths count as
-  * read (backward compat). PARITY: only the SOLID-read gate TTL-checks these —
-  * Python TTL-izes SOLID reads exclusively (require-solid-read.py); the other
-  * refsRead consumers (skill-trigger/shadcn/tailwind/design) stay session-scoped.
-  */
+   * Epoch-ms timestamp of each reference read, keyed by `refsRead` path (parity
+   * track-solid-reads.py `solid_reads[].timestamp`). Optional: tracks persisted
+   * before this field existed only carry `refsRead`, and such paths count as
+   * read (backward compat). PARITY: only the SOLID-read gate TTL-checks these —
+   * Python TTL-izes SOLID reads exclusively (require-solid-read.py); the other
+   * refsRead consumers (skill-trigger/shadcn/tailwind/design) stay session-scoped.
+   */
   refsReadAt?: Record<string, number>;
   /** Framework awaiting doc credit after a Check-1 deny. PERSISTS — {@link recordDoc} cross-credits it on EVERY consultation, never clears it; only the next deny replaces it via {@link recordTarget} (parity track-doc-consultation.py:62). */
   target?: SessionTarget;
@@ -55,26 +54,26 @@ interface SessionTrack {
 /** A fresh, empty track. */
 declare function emptyTrack(): SessionTrack;
 /**
-* Record a doc consultation (Context7/Exa/web) for a framework in this session:
-* the Check-2 credit (`doc_sessions` + `sources`) plus the Check-1 stamp
-* (`sessions` + `doc_consulted` = ISO of `now`). PARITY track-doc-consultation.py
-* :62-70 — a `target` left by a Check-1 deny (enforce-apex-phases.ts:80) is
-* cross-credited on EVERY consultation, with NO TTL on `target.set_at`, and the
-* target PERSISTS (only the next deny replaces it via {@link recordTarget});
-* single-shot clearing or TTL-gating the target re-opened the deny loop when a
-* consultation landed > TTL after the deny. Immutable.
-*/
+ * Record a doc consultation (Context7/Exa/web) for a framework in this session:
+ * the Check-2 credit (`doc_sessions` + `sources`) plus the Check-1 stamp
+ * (`sessions` + `doc_consulted` = ISO of `now`). PARITY track-doc-consultation.py
+ * :62-70 — a `target` left by a Check-1 deny (enforce-apex-phases.ts:80) is
+ * cross-credited on EVERY consultation, with NO TTL on `target.set_at`, and the
+ * target PERSISTS (only the next deny replaces it via {@link recordTarget});
+ * single-shot clearing or TTL-gating the target re-opened the deny loop when a
+ * consultation landed > TTL after the deny. Immutable.
+ */
 declare function recordDoc(track: SessionTrack, framework: string, sessionId: string, source: string, now?: number): SessionTrack;
 /** Set the pending doc-credit target (written by the runtime on a Check-1 deny). Immutable. */
 declare function recordTarget(track: SessionTrack, target: SessionTarget): SessionTrack;
 /**
-* Record that a SOLID reference file was read (deduped). Immutable. When `now`
-* (epoch ms — the tool event's own timestamp, never a fresh `Date.now()`) is
-* supplied, the read is stamped in `refsReadAt`, refreshed on re-reads so the
-* LATEST read drives the SOLID TTL (parity track-solid-reads.py, which appends
-* a timestamped entry per read; require-solid-read.py checks the most recent).
-* Callers that omit `now` keep the legacy untimestamped behavior.
-*/
+ * Record that a SOLID reference file was read (deduped). Immutable. When `now`
+ * (epoch ms — the tool event's own timestamp, never a fresh `Date.now()`) is
+ * supplied, the read is stamped in `refsReadAt`, refreshed on re-reads so the
+ * LATEST read drives the SOLID TTL (parity track-solid-reads.py, which appends
+ * a timestamped entry per read; require-solid-read.py checks the most recent).
+ * Callers that omit `now` keep the legacy untimestamped behavior.
+ */
 declare function recordRefRead(track: SessionTrack, path: string, now?: number): SessionTrack;
 /** Record an agent/tool call with a timestamp + optional quality. Immutable. */
 declare function recordAgent(track: SessionTrack, name: string, ts: number, quality?: AgentQuality): SessionTrack;

package/dist/{skill-path-BO2N0XvB.mjs → skill-path-DhBGlQe3.mjs}

@@ -1,6 +1,6 @@
-import { t as HOME_DIR } from "./dotenv-Jj8aL1FL.mjs";
-import { t as detectHarness } from "./harness-Cb9xR8dC.mjs";
-import { l as PLUGINS_DIR } from "./home-state-BXf38Zi1.mjs";
+import { t as HOME_DIR } from "./dotenv-DoqNlALG.mjs";
+import { t as detectHarness } from "./harness-BMuLJ9lm.mjs";
+import { l as PLUGINS_DIR } from "./home-state-oUGFB4ds.mjs";
 import { join } from "node:path";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/{store-Bcn08y9m.mjs → store-yr_QFsZY.mjs}

@@ -1,11 +1,11 @@
-import { c as ttlLabel } from "./dotenv-Jj8aL1FL.mjs";
-import { n as fuseHarnessHome } from "./home-state-BXf38Zi1.mjs";
+import { c as ttlLabel } from "./dotenv-DoqNlALG.mjs";
+import { n as fuseHarnessHome } from "./home-state-oUGFB4ds.mjs";
 import { a as writeJsonFile, i as readJsonFile } from "./json-io-DisYd2fb.mjs";
 import { i as resolveSessions } from "./doc-helpers-CWZegVdR.mjs";
 import { t as routeReferences } from "./router-PKVNBHge.mjs";
-import { t as resolveSkillPath } from "./skill-path-BO2N0XvB.mjs";
-import { join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { t as resolveSkillPath } from "./skill-path-DhBGlQe3.mjs";
+import { dirname, join } from "node:path";
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { createHmac, randomBytes } from "node:crypto";
 //#region src/policy/skill-source.ts
 /**
@@ -132,7 +132,7 @@ const apexAuthorizationGate = (ctx) => {
 		kind: "block",
 		title,
 		reason: [
-			`APEX: Read specific SOLID references (expires every ${ttl}) for ${ctx.framework}.`,
+			`APEX: Read ALL SOLID references below (including Optional), then retry (expires every ${ttl}) for ${ctx.framework}.`,
 			`Editing: ${ctx.filePath}`,
 			...optional.length ? [`Optional: ${optional.join(", ")}`] : [],
 			`Full skill: ${routed.skillPath}`
@@ -268,15 +268,26 @@ const NONCE_PATH = join(HARNESS_DIR, ".nonce");
 /** Load (or create on first use) the per-machine HMAC key stored at mode 0600. */
 function loadOrCreateKey() {
 	mkdirSync(HARNESS_DIR, { recursive: true });
-	if (!existsSync(KEY_PATH)) {
-		const key = randomBytes(32).toString("hex");
-		writeFileSync(KEY_PATH, key, {
+	if (existsSync(KEY_PATH)) return readFileSync(KEY_PATH, "utf8").trim();
+	const candidate = randomBytes(32).toString("hex");
+	try {
+		writeFileSync(KEY_PATH, candidate, {
 			encoding: "utf8",
-			mode: 384
+			mode: 384,
+			flag: "wx"
 		});
-		return key;
+		return candidate;
+	} catch (e) {
+		if (e.code !== "EEXIST") throw e;
+	}
+	for (let i = 0; i < 5; i++) {
+		const existing = readFileSync(KEY_PATH, "utf8").trim();
+		if (existing) return existing;
+		Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 5);
 	}
-	return readFileSync(KEY_PATH, "utf8").trim();
+	const key = readFileSync(KEY_PATH, "utf8").trim();
+	if (!key) throw new Error("fuse: empty .key after write contention");
+	return key;
 }
 /**
 * Persist the last-seen nonce for advisory diagnostics (mode 0600).
@@ -322,6 +333,69 @@ function verifyTrack(envelope) {
 	}
 }
 //#endregion
+//#region src/tracking/track-lock.ts
+/**
+* Cross-process lock for session-track read-modify-write. The ~11-hook
+* fan-out races plain `loadTrack → mutate → saveTrack` (writes silently
+* lost — `refsRead` was the only mitigated channel, via its journal). This
+* lockfile (`wx`, atomic create) serializes the whole RMW:
+* - retry is bounded in TOTAL time (400 ms, far under any hook timeout);
+* - after the budget, NEVER crash: stderr is logged and the caller skips the
+*   write — a named lost write beats a fail-open crash (hook fail-open
+*   semantics preserved);
+* - an orphaned lockfile (dead process) is reclaimed after a 10 s TTL, so a
+*   crash mid-write never blocks a project forever.
+*/
+/** Orphaned lockfile lifetime before reclamation. */
+const LOCK_TTL_MS = 1e4;
+/** Delay between two lock acquisition attempts. */
+const RETRY_STEP_MS = 8;
+/** Sentinel returned by {@link withTrackLock} when the lock could not be taken. */
+const LOCK_FAILED = Symbol("track-lock-failed");
+/** True when the lockfile is older than the TTL (orphaned by a dead process). */
+function isStale(lock) {
+	try {
+		return Date.now() - statSync(lock).mtimeMs > LOCK_TTL_MS;
+	} catch {
+		return false;
+	}
+}
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/**
+* Run `fn` under the track lock of `dir`, or skip with a stderr note.
+* @param dir - The track state directory (lockfile lives inside).
+* @param fn - The protected read-modify-write.
+* @returns `fn`'s result, or {@link LOCK_FAILED} when the lock stayed busy.
+*/
+async function withTrackLock(dir, fn) {
+	mkdirSync(dir, { recursive: true });
+	const lock = join(dir, "track.lock");
+	const deadline = Date.now() + 400;
+	for (;;) try {
+		closeSync(openSync(lock, "wx"));
+		break;
+	} catch {
+		if (isStale(lock)) {
+			try {
+				unlinkSync(lock);
+			} catch {}
+			continue;
+		}
+		if (Date.now() >= deadline) {
+			process.stderr.write(`harness: track lock busy, write skipped (${lock})\n`);
+			return LOCK_FAILED;
+		}
+		await sleep(RETRY_STEP_MS);
+	}
+	try {
+		return await fn();
+	} finally {
+		try {
+			unlinkSync(lock);
+		} catch {}
+	}
+}
+//#endregion
 //#region src/tracking/store.ts
 /**
 * Load and verify a session track from a signed envelope file.
@@ -345,5 +419,19 @@ async function saveTrack(file, track) {
 	await writeJsonFile(file, envelope);
 	writeLastNonce(envelope.nonce);
 }
+/**
+* Locked read-modify-write on a session track (the fan-out-safe way to mutate
+* it): loads under the lock, applies `mutate`, persists atomically. On lock
+* contention the write is SKIPPED (fail-open, stderr already logged) and
+* `false` is returned — a named lost write, never a crash.
+* @param file - The session track file.
+* @param mutate - Pure mutation over the freshly loaded track.
+* @returns True when the write landed.
+*/
+async function withTrack(file, mutate) {
+	return await withTrackLock(dirname(file), async () => {
+		await saveTrack(file, await mutate(await loadTrack(file)));
+	}) !== LOCK_FAILED;
+}
 //#endregion
-export { writeLastNonce as a, recordAgent as c, recordRefRead as d, recordTarget as f, apexAuthorizationGate as h, verifyTrack as i, recordBrainstormRequired as l, trivialCount as m, saveTrack as n, agentsFresh as o, recordTrivialEdit as p, signTrack as r, emptyTrack as s, loadTrack as t, recordDoc as u };
+export { trivialCount as _, LOCK_TTL_MS as a, writeLastNonce as c, recordAgent as d, recordBrainstormRequired as f, recordTrivialEdit as g, recordTarget as h, LOCK_FAILED as i, agentsFresh as l, recordRefRead as m, saveTrack as n, signTrack as o, recordDoc as p, withTrack as r, verifyTrack as s, loadTrack as t, emptyTrack as u, apexAuthorizationGate as v };

package/dist/tracking/index.d.mts

@@ -1,19 +1,28 @@
-import { a as recordAgent, c as recordRefRead, d as trivialCount, i as emptyTrack, l as recordTarget, n as SessionTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as AgentQuality, u as recordTrivialEdit } from "../session-state-CY4iohn_.mjs";
-
+import { a as recordAgent, c as recordRefRead, d as trivialCount, i as emptyTrack, l as recordTarget, n as SessionTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as AgentQuality, u as recordTrivialEdit } from "../session-state-D5gLr66m.mjs";
 //#region src/tracking/store.d.ts
 /**
-* Load and verify a session track from a signed envelope file.
-*
-* Returns {@link emptyTrack} (fail closed) when the file is absent, corrupt, or
-* fails MAC validation — so the gates re-require real agents rather than trust a
-* forged track. Only a MAC mismatch triggers fail-closed; the nonce is advisory
-* and is never checked during load.
-*/
+ * Load and verify a session track from a signed envelope file.
+ *
+ * Returns {@link emptyTrack} (fail closed) when the file is absent, corrupt, or
+ * fails MAC validation — so the gates re-require real agents rather than trust a
+ * forged track. Only a MAC mismatch triggers fail-closed; the nonce is advisory
+ * and is never checked during load.
+ */
 declare function loadTrack(file: string): Promise<SessionTrack>;
 /**
-* Sign and persist a session track as a tamper-evident envelope, then write the
-* advisory nonce watermark.
-*/
+ * Sign and persist a session track as a tamper-evident envelope, then write the
+ * advisory nonce watermark.
+ */
 declare function saveTrack(file: string, track: SessionTrack): Promise<void>;
+/**
+ * Locked read-modify-write on a session track (the fan-out-safe way to mutate
+ * it): loads under the lock, applies `mutate`, persists atomically. On lock
+ * contention the write is SKIPPED (fail-open, stderr already logged) and
+ * `false` is returned — a named lost write, never a crash.
+ * @param file - The session track file.
+ * @param mutate - Pure mutation over the freshly loaded track.
+ * @returns True when the write landed.
+ */
+declare function withTrack(file: string, mutate: (track: SessionTrack) => SessionTrack | Promise<SessionTrack>): Promise<boolean>;
 //#endregion
-export { AgentQuality, SessionTrack, agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTarget, recordTrivialEdit, saveTrack, trivialCount };
+export { AgentQuality, SessionTrack, agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTarget, recordTrivialEdit, saveTrack, trivialCount, withTrack };

package/dist/tracking/index.mjs

@@ -1,2 +1,2 @@
-import { c as recordAgent, d as recordRefRead, f as recordTarget, l as recordBrainstormRequired, m as trivialCount, n as saveTrack, o as agentsFresh, p as recordTrivialEdit, s as emptyTrack, t as loadTrack, u as recordDoc } from "../store-Bcn08y9m.mjs";
-export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTarget, recordTrivialEdit, saveTrack, trivialCount };
+import { _ as trivialCount, d as recordAgent, f as recordBrainstormRequired, g as recordTrivialEdit, h as recordTarget, l as agentsFresh, m as recordRefRead, n as saveTrack, p as recordDoc, r as withTrack, t as loadTrack, u as emptyTrack } from "../store-yr_QFsZY.mjs";
+export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTarget, recordTrivialEdit, saveTrack, trivialCount, withTrack };

package/dist/{types-DVbIl9md.d.mts → types-C0-igRKr.d.mts}

@@ -2,10 +2,10 @@
 /** How a policy outcome should surface in a harness. */
 type PromptKind = "ask" | "block" | "inform";
 /**
-* Portable, harness-agnostic representation of a policy outcome as a prompt.
-* Adapters render this into their harness's native shape (a Claude
-* `permissionDecision`, a Cursor block, a CLI exit + message, ...).
-*/
+ * Portable, harness-agnostic representation of a policy outcome as a prompt.
+ * Adapters render this into their harness's native shape (a Claude
+ * `permissionDecision`, a Cursor block, a CLI exit + message, ...).
+ */
 interface Prompt {
   kind: PromptKind;
   /** Short title, e.g. "SOLID file-size limit". */
@@ -15,10 +15,10 @@ interface Prompt {
   /** Concrete next actions to proceed. */
   actions?: string[];
   /**
-  * User-facing notice (Python `hook_output.allow_pass`/`post_pass` parity):
-  * shown to the HUMAN — Claude Code's `systemMessage` — never to the agent,
-  * unlike `reason`/additionalContext. Excluded from {@link formatPrompt}.
-  */
+   * User-facing notice (Python `hook_output.allow_pass`/`post_pass` parity):
+   * shown to the HUMAN — Claude Code's `systemMessage` — never to the agent,
+   * unlike `reason`/additionalContext. Excluded from {@link formatPrompt}.
+   */
   userMessage?: string;
 }
 /** Render a {@link Prompt} as a consistent, agent-readable memo block. */

package/dist/types-DvXTI71X.d.mts

@@ -0,0 +1,15 @@
+//#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
+export { HarnessVia as i, HarnessInfo as n, HarnessMode as r, HarnessId as t };

package/dist/util/index.d.mts

@@ -1,2 +1,2 @@
-import { a as compactJson, i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../index-BEMumjOw.mjs";
+import { a as compactJson, i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../index-p9fLrSOD.mjs";
 export { compactJson, isCodeFile, projectRoot, projectRootOrNull, walkUpFor };