@fusengine/harness 0.1.55 → 0.1.56

package/dist/cli/bin.mjs

@@ -4,7 +4,7 @@ import { t as detectHarness } from "../harness-Cb9xR8dC.mjs";
 import { t as claudeHome } from "../home-state-D0RLWP8J.mjs";
 import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-DZvP_9xB.mjs";
 import { n as writeInitFile, t as initFor } from "../run-Do2JltgU.mjs";
-import { F as runDoctor, I as runningVersion, L as versionBanner, Lt as todayUtc, t as handleHook } from "../handle-L4ZNmpwN.mjs";
+import { F as runDoctor, I as runningVersion, L as versionBanner, Lt as todayUtc, t as handleHook } from "../handle-CoyvRORV.mjs";
 import { delimiter, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/{handle-L4ZNmpwN.mjs → handle-CoyvRORV.mjs}

@@ -2361,20 +2361,29 @@ function firstSentence(s) {
 	return (s.split(/(?<=\.)\s/)[0] ?? s).trim();
 }
 /**
-* Distil the actionable rule from a bullet body. With no "→" the whole bullet is
-* the rule → its first sentence. Otherwise the rule is everything after the FIRST
-* "→"; among its arrow-delimited segments (trimmed, empty dropped) take the first
-* sentence of the LONGEST — the information-dense clause, not whichever short
-* aside the author appended last. When that clause is under {@link MIN_RULE}
-* chars, fall back to the first sentence of the WHOLE rule part (never the
-* narrative), so a short trailing segment never yields an illegible stub yet a
-* legitimately terse rule is still shown intact.
+* The bullet's `narrative → rule` delimiter: a SPACED arrow only. A GLUED arrow
+* between tokens (e.g. `120s→300s`, `s→3`) is prose the author wrote, never a
+* delimiter — matching on `→` alone chopped rules mid-token (bug: `300s) pensant
+* corriger…`). Also used to split rule-internal clauses.
+*/
+const RULE_ARROW = /\s+→\s+/;
+/**
+* Distil the actionable rule from a bullet body. With no spaced arrow the whole
+* bullet is the rule → its first sentence. Otherwise the rule is everything after
+* the FIRST spaced arrow; its spaced-arrow-delimited segments are kept whole
+* except for TRAILING short asides (< {@link MIN_RULE} chars, e.g. `→ (cf.
+* lecture).`) which are dropped — so an arrow used as PROSE inside a rule (`maps
+* X → Y doit…`) is preserved intact rather than chopped at the arrow. When the
+* kept rule is still under {@link MIN_RULE} chars, fall back to the first sentence
+* of the WHOLE rule part (never the narrative), avoiding an illegible stub.
 */
 function distillRule(text) {
-	const arrow = text.indexOf("→");
-	if (arrow < 0) return firstSentence(text);
-	const rulePart = text.slice(arrow + 1);
-	const rule = firstSentence(rulePart.split("→").map((s) => s.trim()).filter(Boolean).reduce((a, b) => b.length > a.length ? b : a, ""));
+	const sep = text.search(RULE_ARROW);
+	if (sep < 0) return firstSentence(text);
+	const rulePart = text.slice(sep).replace(RULE_ARROW, "").trim();
+	const segments = rulePart.split(RULE_ARROW).map((s) => s.trim()).filter(Boolean);
+	while (segments.length > 1 && (segments[segments.length - 1]?.length ?? 0) < 40) segments.pop();
+	const rule = firstSentence(segments.join(" → "));
 	return rule.length >= 40 ? rule : firstSentence(rulePart);
 }
 /** Collapse one older bullet to `- [date] <rule>`: {@link distillRule}, capped. */
@@ -5587,6 +5596,50 @@ function frameworkSkillGate(input, refsRead, existingCodeLines) {
 	return skillTriggerGate(input.framework, content, refsRead, forced, input.cwd, input.filePath);
 }
 //#endregion
+//#region src/freshness/ref-evidence.ts
+/**
+* Platform-transcript reconciliation for `.md` reference reads — the durable
+* counterpart to {@link agentsRanFromTranscript} for agent freshness.
+*
+* WHY: the session track is persisted by a non-atomic load→mutate→save. Under
+* the multi-plugin hook fan-out (one hook process per installed plugin, ×N) plus
+* back-to-back tool events, concurrent writers clobber each other (lost update).
+* `agents`/`authorizations` self-heal — every explore/research/doc call rewrites
+* them, so a lost update lands again on the next of hundreds of writes — but a
+* `refsRead` entry is written ONCE (when the `.md` is Read), so a single lost
+* update erases it permanently, and the lead has no SubagentStop
+* {@link harvestAgentEvidence} pass to reconcile it (sub-agents do, which is why
+* only the LEAD's solidReadGate never credited). The Claude-authored transcript
+* is append-only and race-immune, so folding its `.md` Reads back into the track
+* restores the lost evidence; each gate still applies its own TTL/session policy.
+*/
+/**
+* Fold every `.md` `Read` in the transcript into `track` as a timestamped ref
+* read (immutably). PURE reconciliation — the caller owns the track; each read
+* is stamped with its transcript timestamp (unstamped → `now`, lenient, matching
+* {@link agentsRanFromTranscript}), and an existing MORE-recent stamp is never
+* rolled back. Fail-open: an absent/unreadable transcript returns `track`
+* unchanged (same reference).
+* @param track - The current (possibly race-damaged) session track.
+* @param transcriptPath - Claude `transcript_path` for this session.
+* @param now - Fallback epoch-ms for transcript entries the platform left unstamped.
+* @returns The track with transcript `.md` reads merged into `refsRead`/`refsReadAt`.
+*/
+function reconcileRefReadsFromTranscript(track, transcriptPath, now) {
+	const uses = readAgentToolUses(transcriptPath);
+	if (!uses) return track;
+	let next = track;
+	for (const u of uses) {
+		if (u.name !== "Read") continue;
+		const path = String(u.input?.file_path ?? u.input?.path ?? "");
+		if (!path.endsWith(".md")) continue;
+		const ts = u.ts ?? now;
+		const prev = next.refsReadAt?.[path];
+		if (prev === void 0 || prev < ts) next = recordRefRead(next, path, ts);
+	}
+	return next;
+}
+//#endregion
 //#region src/policy/shadcn-skill-gate.ts
 /** File extensions the shadcn gate polices (source: `\.(tsx|jsx|css|scss|json)$`). */
 const SHADCN_FILE_RE = /\.(tsx|jsx|css|scss|json)$/;
@@ -6048,8 +6101,7 @@ async function runGates(input) {
 	if (modular) return modular;
 	if (!input.filePath) return null;
 	const filePath = input.filePath;
-	const window = input.windowMs ?? 12e4;
-	const track = await loadTrack(input.trackFile);
+	const track = reconcileRefReadsFromTranscript(await loadTrack(input.trackFile), input.transcriptPath, input.now);
 	const solidOrSkill = frameworkSkillGate(input, track.refsRead, existingCodeLines);
 	if (solidOrSkill) return solidOrSkill;
 	if (isShadcnWrite(input.tool, filePath)) {
@@ -6070,7 +6122,7 @@ async function runGates(input) {
 	});
 	if (geminiBlock) return geminiBlock;
 	if (isApexScoped(input.filePath)) {
-		const apex = await apexScopedGate(input, track, window);
+		const apex = await apexScopedGate(input, track, input.windowMs ?? 12e4);
 		if (apex) return apex;
 	}
 	return dryGate(input.tool, input.filePath, input.content, input.cwd);

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

package/package.json

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