@fusengine/harness 0.1.29 → 0.1.31

package/dist/runtime/index.d.mts

@@ -156,6 +156,414 @@ declare function mcpPreIntercept(id: string, tool: string, input: Record<string,
 /** Post-event: store the MCP/WebFetch response (extracted to markdown) in the cache. */
 declare function mcpPostStore(tool: string, input: Record<string, unknown>, response: unknown, dir: string): void;
 //#endregion
+//#region src/runtime/inject-context.d.ts
+/**
+* UserPromptSubmit context injection: render the CLAUDE.md (+ optional APEX)
+* preamble as a Claude `additionalContext` response, or "" when nothing to emit.
+* @param prompt - The raw user prompt.
+* @param cwd - Project root (for project-type detection).
+* @returns The native hook stdout (possibly empty).
+*/
+declare function promptSubmitContext(prompt: string, cwd: string): string;
+/**
+* PreToolUse Task context injection: render the APEX sub-agent context as a
+* Claude `additionalContext` response when `.claude/apex/` exists, else "".
+* @param cwd - Fallback project root when `CLAUDE_PROJECT_DIR` is unset.
+* @returns The native hook stdout (possibly empty).
+*/
+declare function taskContext(cwd: string): string;
+//#endregion
+//#region src/runtime/home-state.d.ts
+/** Home `~/.claude` dir (single source for every home-based hook path). */
+declare function claudeHome(home?: string): string;
+/** `~/.claude/fusengine-cache` base dir for legacy session/cache state. */
+declare function fusengineCache(home?: string): string;
+/** `~/.claude/fusengine-cache/sessions` — per-session JSON state dir. */
+declare function sessionsDir(home?: string): string;
+/** Validate a session id (1-128 url-safe chars); null when invalid. */
+declare function sanitizeSessionId(sid: unknown): string | null;
+/** Unified per-session state file path: `sessions/session-<sid>.json`. */
+declare function sessionStatePath(sid: string, home?: string): string;
+/** Load a session-state dict, or `{}` when missing/corrupt (mirrors Python). */
+declare function loadSessionState(sid: string, home?: string): Record<string, unknown>;
+/** Atomically persist a session-state dict (0o600 via atomicWrite, indent 2). */
+declare function saveSessionState(sid: string, state: Record<string, unknown>, home?: string): void;
+//#endregion
+//#region src/runtime/fs-cleanup.d.ts
+/** Remove files directly under `dir` matching `test` older than `maxAgeSec`. */
+declare function removeOldFiles(dir: string, test: (name: string) => boolean, maxAgeSec: number, now?: number): void;
+/** Trim `file` to its last `keepLines` lines when it exceeds `maxBytes`. */
+declare function trimLogFile(file: string, maxBytes: number, keepLines: number): void;
+/** Recursively purge files under `root/<top>` older than `ttls[top]` seconds. */
+declare function purgeTtlTree(root: string, ttls: Record<string, number>, now?: number): void;
+/** Bottom-up removal of empty subdirs under each `root/<top>` (best effort). */
+declare function pruneEmptyDirs(root: string, tops: string[]): void;
+//#endregion
+//#region src/runtime/dev-context.d.ts
+/** Build the git portion of the dev context (branch + up to 5 changed files). */
+declare function gitContext(cwd: string): string[];
+/** Build the project-type portion (mirrors load-dev-context.py exactly). */
+declare function projectContext(cwd: string): string[];
+/**
+* Build the SessionStart dev-context block (git + project type), or "" when
+* nothing applies. Ports `core-guards/scripts/session-start/load-dev-context.py`.
+* @param cwd - Project root to inspect.
+* @returns The joined additionalContext text (possibly empty).
+*/
+declare function devContext(cwd: string): string;
+//#endregion
+//#region src/runtime/lifecycle/session-start.d.ts
+/** Run the legacy SessionStart cleanups (stale states, caches, log trim). */
+declare function runSessionStartCleanups(home?: string, now?: number): void;
+/**
+* Handle core-guards SessionStart: inject CLAUDE.md + dev context as
+* `additionalContext`, then run the cache/state cleanups. Ports the four
+* `session-start/*.py` scripts into one harness call.
+* @param cwd - Project root for dev-context detection.
+* @param home - Home dir (defaults to `~`).
+* @param now - Clock for TTL cleanup (defaults to `Date.now()`).
+* @returns The native hook stdout (possibly empty).
+*/
+declare function sessionStartCore(cwd: string, home?: string, now?: number): string;
+//#endregion
+//#region src/runtime/lifecycle/inject-rules.d.ts
+/** Read & concatenate all `*.md` files (sorted) under `rulesDir`. */
+declare function readRules(rulesDir: string): string;
+/**
+* Build the rules injection for claude-rules (SessionStart + UserPromptSubmit):
+* read `<pluginRoot>/rules/*.md` and emit as `additionalContext`, or "" when no
+* rules. Ports `claude-rules/scripts/inject-rules.py` (which always tags the
+* output `hookEventName: "SessionStart"`, even on UserPromptSubmit).
+* @param pluginRoot - `CLAUDE_PLUGIN_ROOT` of the claude-rules plugin.
+* @returns The native hook stdout (possibly empty).
+*/
+declare function injectRules(pluginRoot: string): string;
+//#endregion
+//#region src/runtime/lifecycle/solid-detect.d.ts
+/** A SOLID project profile: type label, per-file line limit, interface dir. */
+interface SolidProfile {
+  type: string;
+  limit: number;
+  ifaceDir: string;
+}
+/** Detect the SOLID profile for `projectDir`, defaulting to `unknown`. */
+declare function detectSolidProfile(projectDir: string): SolidProfile;
+/**
+* Handle solid SessionStart: detect the profile, append SOLID_* exports to
+* `CLAUDE_ENV_FILE`, and return the `SOLID: …` stdout line (or "" for unknown).
+* Ports `solid/scripts/detect-project.py`.
+* @param env - Environment (defaults to `process.env`).
+* @returns The plain-text stdout line (possibly empty).
+*/
+declare function solidDetectStart(env?: Record<string, string | undefined>): string;
+//#endregion
+//#region src/runtime/lifecycle/subagent-cache.d.ts
+/**
+* Handle SubagentStart: surface fresh MCP cache entries for the session as
+* `additionalContext`. Ports `subagent-start/inject-context-cache.py`.
+* @param sessionIdRaw - Raw session id from the payload.
+* @param home - Home dir (defaults to `~`).
+* @param env - Environment (defaults to `process.env`).
+* @param now - Clock (defaults to `Date.now()`).
+* @returns The native hook stdout (possibly empty).
+*/
+declare function subagentCacheContext(sessionIdRaw: unknown, home?: string, env?: Record<string, string | undefined>, now?: number): string;
+//#endregion
+//#region src/runtime/lifecycle/agent-memory.d.ts
+/**
+* Handle SubagentStop: append the completion to agent-history.jsonl and, for a
+* non-skipped agent that touched code, emit the sniper reminder + reset the
+* counter. Ports `subagent-stop/track-agent-memory.py`.
+* @param data - The raw hook payload.
+* @param home - Home dir (defaults to `~`).
+* @param now - Clock (defaults to `Date.now()`).
+* @returns The native hook stdout (always a JSON message).
+*/
+declare function trackAgentMemory(data: Record<string, unknown>, home?: string, now?: number): string;
+//#endregion
+//#region src/runtime/lifecycle/teammate-idle.d.ts
+/**
+* Handle TeammateIdle: when the teammate's session-changes file shows code was
+* modified, suggest sniper validation as `additionalContext`. Ports
+* `teammate-idle/validate-teammate-output.py`.
+* @param data - The raw hook payload.
+* @param home - Home dir (defaults to `~`).
+* @returns The native hook stdout (possibly empty).
+*/
+declare function validateTeammateOutput(data: Record<string, unknown>, home?: string): string;
+//#endregion
+//#region src/runtime/lifecycle/tool-failure.d.ts
+/**
+* Handle PostToolUseFailure: append a `TOOL_FAILURE` line to
+* `~/.claude/logs/tool-failures.log`, skipping user interrupts. Ports
+* `post-tool-use/log-tool-failure.py`. No stdout (logging only).
+* @param data - The raw hook payload.
+* @param home - Home dir (defaults to `~`).
+* @param now - Clock (defaults to `Date.now()`).
+*/
+declare function logToolFailure(data: Record<string, unknown>, home?: string, now?: number): void;
+//#endregion
+//#region src/runtime/lifecycle/pre-compact.d.ts
+/**
+* Handle PreCompact: back up `.claude/apex/task.json` to `backups/`, keep only
+* the 5 newest, and emit a confirmation. Ports `pre-compact/save-apex-state.py`.
+* @param cwd - Project root.
+* @param now - Clock (defaults to `Date.now()`).
+* @returns The native hook stdout (possibly empty when no task.json).
+*/
+declare function saveApexState(cwd: string, now?: number): string;
+//#endregion
+//#region src/runtime/lifecycle/session-end.d.ts
+/**
+* Handle SessionEnd: remove stale `*.tmp` (>1h) under `session-tmp/` and stale
+* legacy `claude_solid_reads_*` / `claude_session_changes_*` files (>2h) under
+* `fusengine-cache`. Ports `session-end/cleanup-session.py`. No stdout.
+* @param home - Home dir (defaults to `~`).
+* @param now - Clock (defaults to `Date.now()`).
+*/
+declare function cleanupSession(home?: string, now?: number): void;
+//#endregion
+//#region src/runtime/lifecycle/instructions-loaded.d.ts
+/**
+* Handle InstructionsLoaded: append `load_reason | memory_type | file_path` to
+* the per-session debug log. Ports `instructions-loaded/validate-rules-loaded.py`.
+* No stdout (logging only; InstructionsLoaded has no decision control).
+* @param data - The raw hook payload.
+* @param home - Home dir (defaults to `~`).
+*/
+declare function validateRulesLoaded(data: Record<string, unknown>, home?: string): void;
+//#endregion
+//#region src/runtime/lifecycle/track-changes.d.ts
+/**
+* Handle PostToolUse Write/Edit: track the cumulative set of modified code
+* files per session and emit the mandatory "SNIPER VALIDATION REQUIRED"
+* additionalContext. Ports `post-tool-use/track-session-changes.py`.
+* @param sessionIdRaw - Raw session id from the payload.
+* @param filePath - The edited file path.
+* @param home - Home dir (defaults to `~`).
+* @param now - Clock (defaults to `Date.now()`).
+* @returns The native hook stdout (possibly empty when not a code file).
+*/
+declare function trackSessionChanges(sessionIdRaw: unknown, filePath: string, home?: string, now?: number): string;
+//#endregion
+//#region src/runtime/lifecycle/post-edit-ts.d.ts
+/**
+* Handle PostToolUse for TS/TSX: report eslint/prettier issues (never fixes) as
+* additionalContext. Ports `post-tool-use/post-edit-typescript.py`.
+* @param filePath - The edited file path.
+* @returns The native hook stdout (possibly empty).
+*/
+declare function postEditTypescript(filePath: string): string;
+//#endregion
+//#region src/runtime/lifecycle/aipilot/dispatch-aipilot.d.ts
+/**
+* Dispatch an ai-pilot-scope lifecycle event. Returns the native stdout, or
+* `null` when unhandled (caller falls through to the default pipeline).
+*/
+declare function dispatchAipilot(event: string, payload: Record<string, unknown>, cwd: string, now: number): Promise<string | null>;
+/** PostToolUse (TaskCreate/TaskUpdate) sync for the ai-pilot scope. */
+declare function aipilotPostToolUse(payload: Record<string, unknown>, cwd: string): Promise<string>;
+//#endregion
+//#region src/runtime/lifecycle/dispatch.d.ts
+/** Which plugin's hooks.json invoked the harness (selects SessionStart behavior). */
+type PluginScope = "core" | "solid" | "rules" | "carto" | "security" | "changelog" | "aipilot";
+/** Inputs the lifecycle dispatcher needs (clock + roots injected). */
+interface LifecycleInput {
+  event: string;
+  payload: Record<string, unknown>;
+  cwd: string;
+  scope: PluginScope;
+  now: number;
+}
+/**
+* Route a lifecycle/session/context hook event to its ported handler. Returns
+* the native stdout when handled, or `null` when the event is not a lifecycle
+* event (so the caller falls through to the PreToolUse/PostToolUse pipeline).
+* @param input - The dispatch input.
+* @returns The native hook stdout, or `null` when unhandled.
+*/
+declare function dispatchLifecycle(input: LifecycleInput): string | null;
+//#endregion
+//#region src/runtime/lifecycle/post-tracking.d.ts
+/**
+* Dispatch the appropriate PostToolUse tracker for the invoking scope. Carto
+* persists manual enrichments; security records skill reads + MCP research;
+* changelog records watch research. Side-effect only.
+* @param scope - The invoking plugin scope.
+* @param event - The normalized event.
+* @param input - The raw tool input.
+* @param now - Clock.
+*/
+declare function postTrackingSideEffects(scope: PluginScope, event: NormalizedEvent, input: Record<string, unknown>, now: number): void;
+//#endregion
+//#region src/runtime/lifecycle/changelog-research.d.ts
+/**
+* Append an exa/WebFetch/WebSearch query to today's changelog research log.
+* No-op for other tools. No stdout (errors swallowed).
+* @param tool - The tool name.
+* @param input - The tool input (query/url/prompt).
+* @param now - Clock.
+* @param home - Home dir.
+*/
+declare function trackWatchResearch(tool: string, input: Record<string, unknown>, now?: number, home?: string): void;
+//#endregion
+//#region src/runtime/lifecycle/cartographer/session-start.d.ts
+/**
+* Regenerate the project map for `cwd` on SessionStart. Returns "" (side-effect
+* only — no additionalContext).
+* @param cwd - The working directory.
+* @returns "" always.
+*/
+declare function cartoSessionStart(cwd: string): string;
+//#endregion
+//#region src/runtime/lifecycle/cartographer/project-map.d.ts
+/**
+* True when `dir` looks like a project root (has an indicator file) and is not
+* the home directory or filesystem root.
+* @param dir - Directory to test.
+* @returns Whether `dir` is a project root.
+*/
+declare function isProject(dir: string): boolean;
+/**
+* Generate the `.cartographer/project` index tree for `cwd` when it is a real
+* project directory. Always returns "" (no additionalContext emitted).
+* @param cwd - The working directory.
+* @param outputDir - Override for the output tree root.
+* @returns "" (side-effect only).
+*/
+declare function generateProjectMap(cwd: string, outputDir?: string): string;
+//#endregion
+//#region src/runtime/lifecycle/cartographer/track-enrichment.d.ts
+/**
+* Record manually-edited descriptions from a cartographer `index.md` into the
+* adjacent `.enriched.json` sidecar. No-op for unrelated paths. No stdout.
+* @param filePath - The edited file path.
+*/
+declare function trackEnrichment(filePath: string): void;
+//#endregion
+//#region src/runtime/lifecycle/cartographer/write-tree.d.ts
+/**
+* Write `index.md` files mirroring `source` under `output`, recursing into
+* subdirectories. Directory lines carry a file-count hint; file lines carry a
+* derived description and link to the real absolute source path.
+* @param source - Absolute source directory.
+* @param output - Absolute output directory for the index tree.
+* @param back - Relative `← back` link target ("" at the root).
+* @param exclude - Directory/name set to skip.
+*/
+declare function writeTree(source: string, output: string, back?: string, exclude?: ReadonlySet<string>): void;
+//#endregion
+//#region src/runtime/lifecycle/cartographer/merge.d.ts
+/**
+* Load the `.enriched.json` sidecar's `entries` map for an output index.
+* @param outputIndexPath - Path to the index.md being written.
+* @returns The path→desc enrichment map (possibly empty).
+*/
+declare function loadEnriched(outputIndexPath: string): Record<string, string>;
+/**
+* Merge freshly generated lines with prior descriptions: enriched sidecar wins,
+* else a longer pre-existing description is preserved.
+* @param newLines - The freshly generated index lines.
+* @param outputIndexPath - Path to the existing index.md (if any).
+* @returns The merged lines.
+*/
+declare function mergeLines(newLines: string[], outputIndexPath: string): string[];
+//#endregion
+//#region src/runtime/lifecycle/cartographer/fs-util.d.ts
+/**
+* Read a file and derive its one-line description (frontmatter / heading /
+* comment). "" on any error or when nothing is found.
+* @param filePath - Absolute path to the file.
+* @returns The description, or "".
+*/
+declare function getFileDesc(filePath: string): string;
+/**
+* Recursively count files whose relative path parts are all visible (no leading
+* "." or "_") and none excluded. Best-effort (partial count on errors).
+* @param dir - Directory to count under.
+* @param exclude - Directory/name set to skip.
+* @returns The file count.
+*/
+declare function countFiles(dir: string, exclude: ReadonlySet<string>): number;
+/** Absolute children of `source`, split into dirs/files, sorted by full path. */
+declare function listChildren(source: string, exclude: ReadonlySet<string>): {
+  dirs: string[];
+  files: string[];
+};
+//#endregion
+//#region src/runtime/lifecycle/security/check-skill.d.ts
+/**
+* Build a non-blocking PreToolUse `allow` response with a security advisory when
+* editing a code file before the security skill has been read. "" otherwise.
+* @param tool - The tool name (`Write`/`Edit`).
+* @param filePath - The target file path.
+* @param now - Clock.
+* @param home - Home dir.
+* @returns The advisory response JSON, or "".
+*/
+declare function securityAdvisory(tool: string, filePath: string, now?: number, home?: string): string;
+//#endregion
+//#region src/runtime/lifecycle/security/track-skill-read.d.ts
+/**
+* Mark the security skill as read when a Read hits a security skill reference.
+* No-op for other tools/paths. No stdout.
+* @param tool - The tool name.
+* @param filePath - The read file path.
+* @param now - Clock.
+* @param home - Home dir.
+*/
+declare function trackSkillRead(tool: string, filePath: string, now?: number, home?: string): void;
+//#endregion
+//#region src/runtime/lifecycle/security/track-mcp.d.ts
+/**
+* Append a context7/exa research call to today's security state. No-op for other
+* tools. No stdout.
+* @param tool - The tool name.
+* @param input - The tool input (query/libraryId/libraryName).
+* @param now - Clock.
+* @param home - Home dir.
+*/
+declare function trackMcpResearch(tool: string, input: Record<string, unknown>, now?: number, home?: string): void;
+//#endregion
+//#region src/runtime/lifecycle/security/skill-state.d.ts
+/** `~/.claude/logs/00-security` state directory. */
+declare function securityStateDir(home?: string): string;
+/** Current UTC date as `YYYY-MM-DD`. */
+declare function todayUtc(now?: number): string;
+/** Current UTC instant as `YYYY-MM-DDTHH:MM:SSZ` (seconds, no millis). */
+declare function isoUtc(now?: number): string;
+/** Today's security-state file path. */
+declare function securityStatePath(now?: number, home?: string): string;
+/** Load today's security state, or `{}` when missing/corrupt. */
+declare function loadSecurityState(now?: number, home?: string): Record<string, unknown>;
+/** Persist today's security state (indent 2, no trailing newline). */
+declare function saveSecurityState(state: Record<string, unknown>, now?: number, home?: string): void;
+//#endregion
+//#region src/runtime/lifecycle-bridge.d.ts
+/**
+* Run the ported lifecycle/session/context hooks (SessionStart, SubagentStart/
+* Stop, TeammateIdle, PostToolUseFailure, PreCompact, SessionEnd,
+* InstructionsLoaded, rules-scope UserPromptSubmit). Returns the native stdout
+* when handled, or `null` to fall through to the tool-use pipeline.
+* @param payload - The raw hook payload.
+* @param cwd - Project root.
+* @param scope - The invoking plugin scope (defaults to `core`).
+* @param now - Clock.
+* @returns The native stdout, or `null` when unhandled.
+*/
+declare function lifecycleStdout(payload: Record<string, unknown>, cwd: string, scope: PluginScope, now: number): string | null;
+/**
+* Post-edit additions for core-scope PostToolUse Write/Edit: track cumulative
+* session changes (sniper reminder) + report eslint/prettier issues. Returns the
+* combined extra stdout (track-changes wins; lint appended only when no track
+* output), or "" when nothing to emit.
+* @param scope - The invoking plugin scope.
+* @param event - The normalized event.
+* @param now - Clock.
+* @returns The extra stdout (possibly empty).
+*/
+declare function postEditContext(scope: PluginScope, event: NormalizedEvent, now: number): string;
+//#endregion
 //#region src/runtime/handle.d.ts
 /** Options for {@link handleHook} (caller supplies the clock + project root). */
 interface HandleOptions {
@@ -165,6 +573,8 @@ interface HandleOptions {
   refsDir?: string;
   /** APEX freshness window in ms (from `FUSE_ENFORCE_TTL_SEC`). */
   windowMs?: number;
+  /** Which plugin's hooks.json invoked the harness (selects lifecycle behavior). */
+  scope?: PluginScope;
 }
 /** What the hook bin should print + exit with. */
 interface HandleOutcome {
@@ -179,4 +589,24 @@ interface HandleOutcome {
 */
 declare function handleHook(id: string, payload: Record<string, unknown>, opts: HandleOptions): Promise<HandleOutcome>;
 //#endregion
-export { Activity, DEFAULT_WINDOW_MS, DuplicationVerdict, type GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, McpIntercept, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, detectDuplication, dryGate, extractSymbols, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, preCommitGate, queryOf, recordActivity, respond, trackFile };
+//#region src/runtime/handle-pre.d.ts
+/** Context the PreToolUse pipeline needs (resolved once by {@link handleHook}). */
+interface PreContext {
+  id: string;
+  payload: Record<string, unknown>;
+  event: NormalizedEvent;
+  framework: string;
+  mcpDir: string;
+  file: string;
+  opts: HandleOptions;
+}
+/**
+* Run the PreToolUse pipeline: MCP/WebFetch cache intercept, design gate, APEX
+* Task context injection, then the stateless+APEX gate chain. Returns the native
+* hook outcome (deny/ask/inject or allow).
+* @param ctx - The resolved pre-context.
+* @returns The hook outcome.
+*/
+declare function handlePre(ctx: PreContext): Promise<HandleOutcome>;
+//#endregion
+export { Activity, DEFAULT_WINDOW_MS, DuplicationVerdict, type GateInput, HandleOptions, HandleOutcome, LifecycleInput, MCP_TTL_MS, McpIntercept, NormalizedEvent, PluginScope, PreContext, REQUIRED_AGENTS, SolidProfile, TRIVIAL_BUDGET, ToolEvent, activityFor, aipilotPostToolUse, cartoSessionStart, claudeHome, cleanupSession, countFiles, detectDuplication, detectSolidProfile, devContext, dispatchAipilot, dispatchLifecycle, dryGate, extractSymbols, fusengineCache, gate, generateProjectMap, getFileDesc, gitContext, handleHook, handlePre, harnessStateDir, injectRules, isMcpTool, isProject, isoUtc, lifecycleStdout, listChildren, loadEnriched, loadSecurityState, loadSessionState, logToolFailure, mcpPostStore, mcpPreIntercept, mergeLines, normalizeEvent, postEditContext, postEditTypescript, postTrackingSideEffects, preCommitGate, projectContext, promptSubmitContext, pruneEmptyDirs, purgeTtlTree, queryOf, readRules, recordActivity, removeOldFiles, respond, runSessionStartCleanups, sanitizeSessionId, saveApexState, saveSecurityState, saveSessionState, securityAdvisory, securityStateDir, securityStatePath, sessionStartCore, sessionStatePath, sessionsDir, solidDetectStart, subagentCacheContext, taskContext, todayUtc, trackAgentMemory, trackEnrichment, trackFile, trackMcpResearch, trackSessionChanges, trackSkillRead, trackWatchResearch, trimLogFile, validateRulesLoaded, validateTeammateOutput, writeTree };

package/dist/runtime/index.mjs

@@ -1,5 +1,5 @@
 import { r as projectLayout } from "../layout-C0jaaCQC.mjs";
-import { _ as dryGate, a as normalizeEvent, c as mcpPostStore, d as DEFAULT_WINDOW_MS, f as REQUIRED_AGENTS, g as detectDuplication, h as preCommitGate, i as trackFile, l as mcpPreIntercept, m as gate, n as respond, o as MCP_TTL_MS, p as TRIVIAL_BUDGET, r as recordActivity, s as isMcpTool, t as handleHook, u as queryOf, v as extractSymbols, y as activityFor } from "../handle-nu3GYVek.mjs";
+import { $ as purgeTtlTree, A as isProject, B as cleanupSession, C as todayUtc, Ct as activityFor, D as dispatchAipilot, E as aipilotPostToolUse, F as getFileDesc, G as subagentCacheContext, H as logToolFailure, I as listChildren, J as injectRules, K as detectSolidProfile, L as postEditTypescript, M as loadEnriched, N as mergeLines, O as cartoSessionStart, P as countFiles, Q as pruneEmptyDirs, R as trackSessionChanges, S as securityStatePath, St as queryOf, T as dispatchLifecycle, U as validateTeammateOutput, V as saveApexState, W as trackAgentMemory, X as runSessionStartCleanups, Y as readRules, Z as sessionStartCore, _ as trackSkillRead, _t as normalizeEvent, a as TRIVIAL_BUDGET, at as claudeHome, b as saveSecurityState, bt as mcpPostStore, c as detectDuplication, ct as sanitizeSessionId, d as lifecycleStdout, dt as sessionsDir, et as removeOldFiles, f as postEditContext, ft as promptSubmitContext, g as trackMcpResearch, gt as trackFile, h as trackWatchResearch, ht as recordActivity, i as REQUIRED_AGENTS, it as projectContext, j as writeTree, k as generateProjectMap, l as dryGate, lt as saveSessionState, m as postTrackingSideEffects, mt as respond, n as handlePre, nt as devContext, o as gate, ot as fusengineCache, p as securityAdvisory, pt as taskContext, q as solidDetectStart, r as DEFAULT_WINDOW_MS, rt as gitContext, s as preCommitGate, st as loadSessionState, t as handleHook, tt as trimLogFile, u as extractSymbols, ut as sessionStatePath, v as isoUtc, vt as MCP_TTL_MS, w as trackEnrichment, x as securityStateDir, xt as mcpPreIntercept, y as loadSecurityState, yt as isMcpTool, z as validateRulesLoaded } from "../handle-DW9cWdVt.mjs";
 //#region src/runtime/storage.ts
 /**
 * The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,
@@ -9,4 +9,4 @@ function harnessStateDir(root) {
 	return projectLayout(root).stateDir;
 }
 //#endregion
-export { DEFAULT_WINDOW_MS, MCP_TTL_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, detectDuplication, dryGate, extractSymbols, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, preCommitGate, queryOf, recordActivity, respond, trackFile };
+export { DEFAULT_WINDOW_MS, MCP_TTL_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, aipilotPostToolUse, cartoSessionStart, claudeHome, cleanupSession, countFiles, detectDuplication, detectSolidProfile, devContext, dispatchAipilot, dispatchLifecycle, dryGate, extractSymbols, fusengineCache, gate, generateProjectMap, getFileDesc, gitContext, handleHook, handlePre, harnessStateDir, injectRules, isMcpTool, isProject, isoUtc, lifecycleStdout, listChildren, loadEnriched, loadSecurityState, loadSessionState, logToolFailure, mcpPostStore, mcpPreIntercept, mergeLines, normalizeEvent, postEditContext, postEditTypescript, postTrackingSideEffects, preCommitGate, projectContext, promptSubmitContext, pruneEmptyDirs, purgeTtlTree, queryOf, readRules, recordActivity, removeOldFiles, respond, runSessionStartCleanups, sanitizeSessionId, saveApexState, saveSecurityState, saveSessionState, securityAdvisory, securityStateDir, securityStatePath, sessionStartCore, sessionStatePath, sessionsDir, solidDetectStart, subagentCacheContext, taskContext, todayUtc, trackAgentMemory, trackEnrichment, trackFile, trackMcpResearch, trackSessionChanges, trackSkillRead, trackWatchResearch, trimLogFile, validateRulesLoaded, validateTeammateOutput, writeTree };

package/dist/state/index.mjs

@@ -1,2 +1,2 @@
-import { a as ensureStateDir, c as stateFilePath, i as apexStateDir, l as acquireLock, n as taskCreate, o as loadState, r as taskStart, s as saveState, t as taskComplete } from "../state-Cs0Y0MG_.mjs";
+import { a as ensureStateDir, c as stateFilePath, i as apexStateDir, l as acquireLock, n as taskCreate, o as loadState, r as taskStart, s as saveState, t as taskComplete } from "../state-ByhLeKyD.mjs";
 export { acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart };

package/dist/{state-Cs0Y0MG_.mjs → state-ByhLeKyD.mjs}

@@ -1,4 +1,4 @@
-import { n as readJsonFile, r as writeJsonFile, t as ensureDir } from "./json-io-xpTDuvtn.mjs";
+import { i as writeJsonFile, n as ensureDir, r as readJsonFile } from "./json-io-CAn72gI4.mjs";
 import { mkdir, rmdir } from "node:fs/promises";
 //#region src/state/lock.ts
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));

package/dist/{store-BnHpq2ZB.mjs → store-D-ge2ZPI.mjs}

@@ -1,4 +1,4 @@
-import { n as readJsonFile, r as writeJsonFile } from "./json-io-xpTDuvtn.mjs";
+import { i as writeJsonFile, r as readJsonFile } from "./json-io-CAn72gI4.mjs";
 //#region src/tracking/session-state.ts
 /** A fresh, empty track. */
 function emptyTrack() {

package/dist/{store-DeIsfMg5.mjs → store-PrNPm6So.mjs}

@@ -1,5 +1,34 @@
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+//#region src/cache/io.ts
+/** Read a JSON array from `path`; [] on missing/corrupt/non-array. */
+function loadIndex(path) {
+	try {
+		if (!existsSync(path)) return [];
+		const data = JSON.parse(readFileSync(path, "utf8"));
+		return Array.isArray(data) ? data : [];
+	} catch {
+		return [];
+	}
+}
+/** Summarize an index of `{ tool?, ts? }` entries. */
+function summarizeIndex(index) {
+	const byTool = {};
+	const timestamps = [];
+	for (const entry of index) {
+		if (typeof entry !== "object" || entry === null) continue;
+		const e = entry;
+		if (typeof e.tool === "string") byTool[e.tool] = (byTool[e.tool] ?? 0) + 1;
+		if (typeof e.ts === "string") timestamps.push(e.ts);
+	}
+	return {
+		total: index.length,
+		byTool,
+		oldestTs: timestamps.length ? timestamps.reduce((a, b) => a < b ? a : b) : null,
+		newestTs: timestamps.length ? timestamps.reduce((a, b) => a > b ? a : b) : null
+	};
+}
+//#endregion
 //#region src/cache/mcp-response.ts
 const MAX_DEPTH = 5;
 /**
@@ -57,4 +86,4 @@ function cacheStore(dir, tool, query, content) {
 	writeFileSync(path, content);
 }
 //#endregion
-export { extractText as a, mcpCacheKey as i, cachePath as n, cacheStore as r, cacheLookup as t };
+export { extractText as a, mcpCacheKey as i, cachePath as n, loadIndex as o, cacheStore as r, summarizeIndex as s, cacheLookup as t };

package/dist/tracking/index.mjs

@@ -1,2 +1,2 @@
-import { a as recordAgent, c as recordRefRead, i as emptyTrack, 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 { a as recordAgent, c as recordRefRead, i as emptyTrack, l as recordTrivialEdit, n as saveTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as loadTrack, u as trivialCount } from "../store-D-ge2ZPI.mjs";
 export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTrivialEdit, saveTrack, trivialCount };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.29",
+  "version": "0.1.31",
   "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",
@@ -115,9 +115,16 @@
       "import": "./dist/adapters/gemini/index.mjs"
     }
   },
-  "files": ["dist", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/fusengine/harness.git" },
+  "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,