@fusengine/harness 0.1.37 → 0.1.40

package/dist/index-BX-xcvhY.d.mts

@@ -0,0 +1,75 @@
+//#region src/cache/compact.d.ts
+/** Strip HTML entities + boilerplate, normalize blank lines, truncate to ~5KB. */
+declare function compactMarkdown(content: string): string;
+/** 8-char MD5 of `${toolName}::${query}`. */
+declare function queryHash(toolName: string, query: string): string;
+/** Bag-of-words Jaccard similarity strictly greater than `threshold`. */
+declare function jaccardSimilar(a: string, b: string, threshold?: number): boolean;
+//#endregion
+//#region src/cache/io.d.ts
+/** Read a JSON array from `path`; [] on missing/corrupt/non-array. */
+declare function loadIndex(path: string): unknown[];
+/** Summary of a cache index. */
+interface IndexSummary {
+  total: number;
+  byTool: Record<string, number>;
+  oldestTs: string | null;
+  newestTs: string | null;
+}
+/** Summarize an index of `{ tool?, ts? }` entries. */
+declare function summarizeIndex(index: unknown[]): IndexSummary;
+//#endregion
+//#region src/cache/mcp-response.d.ts
+/**
+* Extract usable markdown from an MCP `tool_response`: a string, a list of
+* content blocks (non-text blocks skipped), or any JSON structure (fallback).
+* Recurses up to depth 5 to guard against pathological/cyclic structures.
+*/
+declare function extractText(resp: unknown, depth?: number): string;
+//#endregion
+//#region src/cache/mcp-store.d.ts
+/**
+* Persist an MCP doc result the way `cache-mcp-result.py` does: compact the body,
+* skip Jaccard-duplicate queries, write a front-matter `.md` (exact FNV key, so
+* {@link cacheLookup} still hits) carrying the query for substring lookups, and
+* append the entry to `index.json`. No-op on empty body or duplicate query.
+* @param dir - Cache directory (also holds `index.json`).
+* @param tool - MCP tool id.
+* @param query - Doc query that keys the entry.
+* @param body - Raw response text (compacted before write).
+* @param now - Current epoch ms (timestamp source).
+*/
+declare function mcpCacheWrite(dir: string, tool: string, query: string, body: string, now: number): void;
+/**
+* Persist a WebFetch result the way `webfetch-cache-store.py` does: compact the
+* body, write a front-matter `.md` keyed by `key` (url + prompt[:500]). No index
+* and no dedup — WebFetch entries are exact-key only. No-op on empty body.
+* @param dir - Cache directory.
+* @param tool - Always `WebFetch`.
+* @param key - The url+prompt cache key string.
+* @param body - Raw response text (compacted before write).
+* @param now - Current epoch ms (timestamp source).
+*/
+declare function webfetchCacheWrite(dir: string, tool: string, key: string, body: string, now: number): void;
+//#endregion
+//#region src/cache/store.d.ts
+/** Stable 16-char key from a tool name + query (FNV-1a, non-crypto). */
+declare function mcpCacheKey(tool: string, query: string): string;
+/** Path of a cache entry under `dir`. */
+declare function cachePath(dir: string, tool: string, query: string): string;
+/** Read a cached entry if it exists and is fresh (mtime within `ttlMs`), else null. */
+declare function cacheLookup(dir: string, tool: string, query: string, ttlMs: number, now: number): string | null;
+/**
+* First fresh cache file whose body contains the (normalized, case-insensitive)
+* query substring, else null. Relaxes the exact-key match to lift the hit-rate —
+* parity with `mcp-cache-lookup.py` (`rg -i -F` over the first 80 query chars).
+* @param dir - Cache directory to scan.
+* @param query - Raw query; newlines folded to spaces, truncated to 80 chars.
+* @param ttlMs - Freshness window (mtime-based).
+* @param now - Current epoch ms.
+*/
+declare function cacheLookupSubstring(dir: string, query: string, ttlMs: number, now: number): string | null;
+/** Store a cache entry (creates the dir; no-op on empty content). */
+declare function cacheStore(dir: string, tool: string, query: string, content: string): void;
+//#endregion
+export { mcpCacheKey as a, extractText as c, summarizeIndex as d, compactMarkdown as f, cacheStore as i, IndexSummary as l, queryHash as m, cacheLookupSubstring as n, mcpCacheWrite as o, jaccardSimilar as p, cachePath as r, webfetchCacheWrite as s, cacheLookup as t, loadIndex as u };

package/dist/{index-DLUfyYmU.d.mts → index-COBvvc3L.d.mts}

@@ -70,6 +70,8 @@ interface ProjectLayout {
 declare function projectLayout(root: string): ProjectLayout;
 //#endregion
 //#region src/config/dotenv.d.ts
+/** Home config dir holding the `.env` for each harness (defaults to `.claude`). */
+declare const HOME_DIR: Partial<Record<HarnessId, string>>;
 /** Parse a `.env` file into a key→value map (`export KEY="v"` or `KEY=v`). */
 declare function parseEnvFile(path: string): Record<string, string>;
 /** The `.env` paths probed for a harness: home `.env` then `<cwd>/.env`. */
@@ -85,4 +87,4 @@ declare function envCandidates(id: HarnessId, home?: string, cwd?: string): stri
 */
 declare function loadDotenv(id: HarnessId, env?: NodeJS.ProcessEnv, home?: string, cwd?: string): void;
 //#endregion
-export { STATE_GITIGNORE as a, DEFAULT_MAX_LINES as c, splitTarget as d, DEFAULT_TTL_SEC as f, parseEnvInt as g, ttlLabel as h, ProjectLayout as i, MAX_LINES_ENV_KEY as l, resolveTtlSec as m, loadDotenv as n, STATE_ROOT as o, TTL_ENV_KEY as p, parseEnvFile as r, projectLayout as s, envCandidates as t, resolveMaxLines as u };
+export { parseEnvInt as _, ProjectLayout as a, projectLayout as c, resolveMaxLines as d, splitTarget as f, ttlLabel as g, resolveTtlSec as h, parseEnvFile as i, DEFAULT_MAX_LINES as l, TTL_ENV_KEY as m, envCandidates as n, STATE_GITIGNORE as o, DEFAULT_TTL_SEC as p, loadDotenv as r, STATE_ROOT as s, HOME_DIR as t, MAX_LINES_ENV_KEY as u };

package/dist/{index-FrWgmkbP.d.mts → index-CwOdFBOr.d.mts}

@@ -15,8 +15,17 @@ interface ClaudeHookInput {
 }
 /** Read & parse the Claude hook payload from stdin (empty object on bad input). */
 declare function readClaudeInput(): Promise<ClaudeHookInput>;
-/** A `deny` hook response for a given event. */
+/** A `deny` hook response for a given event. PreToolUse-only field. */
 declare function denyResponse(event: string, reason: string): string;
+/**
+* A PostToolUse (and Stop/UserPromptSubmit) `block` response. These events
+* ignore `hookSpecificOutput.permissionDecision` (a PreToolUse-only field) and
+* only honor the top-level `decision`/`reason` keys, which feed the reason back
+* to Claude as automated feedback.
+* @param reason - The block feedback shown to Claude.
+* @returns The native `{decision:"block",reason}` response string.
+*/
+declare function blockResponse(reason: string): string;
 /** An `additionalContext` injection response. */
 declare function contextResponse(event: string, text: string): string;
 /**
@@ -33,4 +42,4 @@ declare function guard(input: ClaudeHookInput): string | null;
 /** @deprecated use {@link guard}. Kept for back-compat. */
 declare const fileSizeGuard: typeof guard;
 //#endregion
-export { guard as a, fileSizeGuard as i, contextResponse as n, readClaudeInput as o, denyResponse as r, toClaudeResponse as s, ClaudeHookInput as t };
+export { fileSizeGuard as a, toClaudeResponse as c, denyResponse as i, blockResponse as n, guard as o, contextResponse as r, readClaudeInput as s, ClaudeHookInput as t };

package/dist/{index-CPoF_hLP.d.mts → index-D7GpOmkl.d.mts}

@@ -1,4 +1,4 @@
-import { t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
+import { t as AuthEntry } from "./doc-helpers-D14nkD5D.mjs";
 
 //#region src/state/lock.d.ts
 /**

package/dist/{index-QzK2dv0V.d.mts → index-DTrjSNmI.d.mts}

@@ -1,5 +1,5 @@
 import { t as Prompt } from "./types-D56jSgD9.mjs";
-import { t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
+import { t as AuthEntry } from "./doc-helpers-D14nkD5D.mjs";
 import { t as RefMeta } from "./types-CY5qT2X1.mjs";
 
 //#region src/policy/detect-project.d.ts
@@ -49,10 +49,10 @@ interface FileSizeVerdict {
   message: string | null;
 }
 /**
-* Count substantive (code-only) lines — blank lines and comment-only lines
-* (`//`, `*`, `/*` block-comment bodies) don't count toward the SOLID limit, so a
-* well-documented file isn't penalized for its JSDoc. (`#` is intentionally NOT
-* skipped: it is code in Rust `#[derive]` and C `#include`, not a comment.)
+* Count physical lines — parity with the Python `enforce-file-size.py`
+* (`sum(1 for _ in f)`): every line counts (blanks and comments included), and a
+* single trailing newline does not add a phantom line. The SOLID ceiling is
+* measured on raw file length, not substantive code, to match the upstream plugin.
 */
 declare function countLines(content: string): number;
 /**
@@ -134,7 +134,7 @@ interface ApexContext {
 }
 /** A single APEX gate: returns a blocking {@link Prompt}, or null to pass. */
 type ApexGate = (ctx: ApexContext) => Prompt | null;
-/** Gate: Context7 + Exa must have been consulted this session. */
+/** Gate: any one documentation source (Context7, Exa, or web) must have been consulted this session. */
 declare const docConsultedGate: ApexGate;
 /** Gate: the routed SOLID references for this edit must have been read. */
 declare const solidReadGate: ApexGate;
@@ -170,15 +170,27 @@ declare const ASK_PATTERNS: RegExp[];
 declare function securityGuard(ctx: GuardContext): Prompt | null;
 //#endregion
 //#region src/policy/guards/protected-path.d.ts
-/** Path fragments that mark a location as internal/generated state. */
+/**
+* Path fragments that mark a location as internal/generated state.
+*
+* Parity with safe_paths.py: `~/.claude/fusengine-cache` is a *writable* cache
+* the harness owns (lessons, MCP cache, per-type state) — only the
+* `fusengine-cache/sessions` subtree is protected, not the whole cache.
+*/
 declare const PROTECTED_FRAGMENTS: readonly string[];
 /**
+* Matches a real `.git` directory segment (`/.git/`, `~/.git`, leading or
+* trailing `.git`) without matching unrelated names like `foo.git/` or
+* `.github/`. Kept separate from the substring fragments for precise scoping.
+*/
+declare const PROTECTED_GIT_RE: RegExp;
+/**
 * Blocks direct edits to internal/generated state directories.
 *
 * Covers:
 *  - Write / Edit tool calls whose `filePath` targets a protected fragment.
-*  - Bash commands that both reference a protected fragment *and* contain a
-*    recognisable shell write operation (best-effort; see `bashHasWriteOp`).
+*  - Bash commands whose actual write *target* is a protected fragment
+*    (read sources are ignored; see `extractWriteTargets`).
 *
 * @param ctx - The guard context (tool, filePath, command).
 * @returns A blocking {@link Prompt}, or null to allow.
@@ -188,9 +200,13 @@ declare function protectedPathGuard(ctx: GuardContext): Prompt | null;
 //#region src/policy/guards/bash-write.d.ts
 /** Redirect (`>`/`>>`) targeting a code-file extension. */
 declare const CODE_REDIRECT: RegExp;
-/** Interpreters / tools that mutate source in place, plus heredoc-into-file. */
+/** Interpreters / tools that mutate source in place, plus heredoc-into-file.
+* `sed`/`perl`/`awk` allow intervening flags before `-i` (parity bash-write-guard.py). */
 declare const CODE_MUTATORS: RegExp;
-/** Redirect to a non-code file, or other ambiguous file writers (ASK). */
+/** Redirect to a non-code file. Excludes `/dev/null`, `2>`/`N>` and `>&N` fd
+* redirects via the `(?<![0-9&])` lookbehind + `(?!…|&)` (parity has_file_redirect). */
+declare const FILE_REDIRECT: RegExp;
+/** Other ambiguous file writers (ASK): `tee <file>` (not `tee -a`/path) and `dd … of=`. */
 declare const ASK_WRITERS: RegExp;
 /**
 * Blocks shell commands that mutate code files in place (and heredocs/redirects
@@ -204,7 +220,11 @@ declare function bashWriteGuard(ctx: GuardContext): Prompt | null;
 declare const TS_DECL_RE: RegExp;
 /** Python view models: class subclassing a schema/protocol base. */
 declare const PY_MODEL_RE: RegExp;
-/** PHP controllers: top-level `interface` / `abstract class`. */
+/**
+* PHP controllers: top-level `interface`, `abstract class`, or a concrete
+* `class …Interface/DTO/Request`. Union of the TS-only `abstract class` rule
+* and the Python rule (`class [A-Z].*(Interface|DTO|Request)`, enforce-interfaces.py:16).
+*/
 declare const PHP_DECL_RE: RegExp;
 /** Swift views: top-level `protocol Foo`. */
 declare const SWIFT_PROTO_RE: RegExp;
@@ -216,6 +236,11 @@ declare const JAVA_DECL_RE: RegExp;
 * Blocks top-level interface/type/protocol declarations in component, view or
 * controller files (Interface Segregation). Fires only when BOTH the path
 * category AND the content pattern match.
+*
+* Parity note: enforce-interfaces.py only inspects `Write` (tool_input.content).
+* We deliberately also fire on `Edit` — an in-place edit can introduce the same
+* violation — and the path fragments accept singular *and* plural directory
+* names (`view/` + `views/`), mirroring the Python `s?` regexes.
 */
 declare function interfaceSeparationGuard(ctx: GuardContext): Prompt | null;
 //#endregion
@@ -456,4 +481,4 @@ declare function isHtmlLike(path: string): boolean;
 */
 declare function missingSeoElements(html: string): string[];
 //#endregion
-export { APEX_GATES as $, GUARDS as A, TS_DECL_RE as B, SKILL_TRIGGERS as C, detectProjectType as Ct, capVerbosity as D, MAX_TOKENS as E, GO_DECL_RE as F, bashWriteGuard as G, ASK_WRITERS as H, JAVA_DECL_RE as I, ASK_PATTERNS as J, PROTECTED_FRAGMENTS as K, PHP_DECL_RE as L, registerGuard as M, runGuards as N, detectCreationIntent as O, installGuard as P, GuardContext as Q, PY_MODEL_RE as R, skillTriggerGate as S, detectModularArchitecture as St, MAX_EXA_RESULTS as T, requiredArchSkill as Tt, CODE_MUTATORS as U, interfaceSeparationGuard as V, CODE_REDIRECT as W, securityGuard as X, CRITICAL_PATTERNS as Y, Guard as Z, DEV_VERBS as _, evaluateFileSize as _t, firstHeading as a, freshnessGate as at, detectClaudeMdProjectType as b, ModularArchitecture as bt, parseEntry as c, PolicyResult as ct, EXCLUDE_DIRS as d, GIT_BLOCKED as dt, ApexContext as et, PROJECT_INDICATORS as f, PROJECT_INSTALL as ft, loadApexTaskState as g, countLines as gt, buildApexTaskInjection as h, FileSizeVerdict as ht, firstComment as i, evaluateApex as it, clearUserGuards as j, FAIL_CLOSED as k, parseBodyDesc as l, evaluate as lt, buildApexTaskContext as m, matchPatterns as mt, missingSeoElements as n, brainstormGate as nt, TreeEntry as o, solidReadGate as ot, ApexTaskState as p, SYSTEM_INSTALL as pt, protectedPathGuard as q, descFromText as r, docConsultedGate as rt, parseEnrichment as s, PolicyContext as st, isHtmlLike as t, ApexGate as tt, parseField as u, GIT_ASK as ut, buildApexInstruction as v, detectFramework as vt, frameworkSolidGate as w, isApexCommand as wt, detectRequiredSkills as x, ProjectType as xt, buildClaudeMdContext as y, DEV_KEYWORDS as yt, SWIFT_PROTO_RE as z };
+export { Guard as $, GUARDS as A, TS_DECL_RE as B, SKILL_TRIGGERS as C, ProjectType as Ct, capVerbosity as D, requiredArchSkill as Dt, MAX_TOKENS as E, isApexCommand as Et, GO_DECL_RE as F, FILE_REDIRECT as G, ASK_WRITERS as H, JAVA_DECL_RE as I, PROTECTED_GIT_RE as J, bashWriteGuard as K, PHP_DECL_RE as L, registerGuard as M, runGuards as N, detectCreationIntent as O, installGuard as P, securityGuard as Q, PY_MODEL_RE as R, skillTriggerGate as S, ModularArchitecture as St, MAX_EXA_RESULTS as T, detectProjectType as Tt, CODE_MUTATORS as U, interfaceSeparationGuard as V, CODE_REDIRECT as W, ASK_PATTERNS as X, protectedPathGuard as Y, CRITICAL_PATTERNS as Z, DEV_VERBS as _, FileSizeVerdict as _t, firstHeading as a, docConsultedGate as at, detectClaudeMdProjectType as b, detectFramework as bt, parseEntry as c, solidReadGate as ct, EXCLUDE_DIRS as d, evaluate as dt, GuardContext as et, PROJECT_INDICATORS as f, GIT_ASK as ft, loadApexTaskState as g, matchPatterns as gt, buildApexTaskInjection as h, SYSTEM_INSTALL as ht, firstComment as i, brainstormGate as it, clearUserGuards as j, FAIL_CLOSED as k, parseBodyDesc as l, PolicyContext as lt, buildApexTaskContext as m, PROJECT_INSTALL as mt, missingSeoElements as n, ApexContext as nt, TreeEntry as o, evaluateApex as ot, ApexTaskState as p, GIT_BLOCKED as pt, PROTECTED_FRAGMENTS as q, descFromText as r, ApexGate as rt, parseEnrichment as s, freshnessGate as st, isHtmlLike as t, APEX_GATES as tt, parseField as u, PolicyResult as ut, buildApexInstruction as v, countLines as vt, frameworkSolidGate as w, detectModularArchitecture as wt, detectRequiredSkills as x, DEV_KEYWORDS as xt, buildClaudeMdContext as y, evaluateFileSize as yt, SWIFT_PROTO_RE as z };

package/dist/{index-DL8MxjuP.d.mts → index-mmRF3KNp.d.mts}

@@ -8,10 +8,10 @@ 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, weighted by glob SPECIFICITY (+5 per literal path
-* segment) so a more specific skill wins (an app-router glob beats a bare extension
-* glob beats a plain TS glob). +5 per `trigger-on-edit` fragment, +1 per keyword.
+* Score references against a file edit (pure) — flat scoring, parity with the
+* Python `ref_router._score_ref` (comma-split, single award per category):
+* +10 once if ANY `applies-to` glob matches, +5 once if ANY `trigger-on-edit`
+* fragment (trailing `/` stripped) is a substring of the path, +1 per keyword.
 */
 declare function scoreReferences(refs: RefMeta[], filePath: string, content: string): ScoredRef[];
 /**

package/dist/index.d.mts

@@ -1,14 +1,14 @@
 import { n as PromptKind, r as formatPrompt, t as Prompt } from "./types-D56jSgD9.mjs";
-import { a as extractText, c as summarizeIndex, d as queryHash, i as mcpCacheKey, l as compactMarkdown, n as cachePath, o as IndexSummary, r as cacheStore, s as loadIndex, t as cacheLookup, u as jaccardSimilar } from "./index-DPkCX_AR.mjs";
-import { a as STATE_GITIGNORE, c as DEFAULT_MAX_LINES, d as splitTarget, f as DEFAULT_TTL_SEC, g as parseEnvInt, h as ttlLabel, i as ProjectLayout, l as MAX_LINES_ENV_KEY, m as resolveTtlSec, n as loadDotenv, o as STATE_ROOT, p as TTL_ENV_KEY, r as parseEnvFile, s as projectLayout, t as envCandidates, u as resolveMaxLines } from "./index-DLUfyYmU.mjs";
+import { a as mcpCacheKey, c as extractText, d as summarizeIndex, f as compactMarkdown, i as cacheStore, l as IndexSummary, m as queryHash, n as cacheLookupSubstring, o as mcpCacheWrite, p as jaccardSimilar, r as cachePath, s as webfetchCacheWrite, t as cacheLookup, u as loadIndex } from "./index-BX-xcvhY.mjs";
+import { _ as parseEnvInt, a as ProjectLayout, c as projectLayout, d as resolveMaxLines, f as splitTarget, g as ttlLabel, h as resolveTtlSec, i as parseEnvFile, l as DEFAULT_MAX_LINES, m as TTL_ENV_KEY, n as envCandidates, o as STATE_GITIGNORE, p as DEFAULT_TTL_SEC, r as loadDotenv, s as STATE_ROOT, t as HOME_DIR, u as MAX_LINES_ENV_KEY } from "./index-COBvvc3L.mjs";
 import { a as detectHarness, i as HarnessVia, n as HarnessInfo, o as detectMode, r as HarnessMode, s as modeFor, t as HarnessId } from "./harness-DwJskkz_.mjs";
-import { a as isDocConsulted, i as formatDocSatisfactionStatus, n as DocSatisfactionStatus, o as resolveSessions, r as formatDocDeny, t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
+import { a as isDocConsulted, i as formatDocSatisfactionStatus, n as DocSatisfactionStatus, o as resolveSessions, r as formatDocDeny, t as AuthEntry } from "./doc-helpers-D14nkD5D.mjs";
 import { t as incrementTrivialEditCounter } from "./index-BOBXQ91y.mjs";
 import { a as compactJson, i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./index-BEMumjOw.mjs";
-import { $ as APEX_GATES, A as GUARDS, B as TS_DECL_RE, C as SKILL_TRIGGERS, Ct as detectProjectType, D as capVerbosity, E as MAX_TOKENS, F as GO_DECL_RE, G as bashWriteGuard, H as ASK_WRITERS, I as JAVA_DECL_RE, J as ASK_PATTERNS, K as PROTECTED_FRAGMENTS, L as PHP_DECL_RE, M as registerGuard, N as runGuards, O as detectCreationIntent, P as installGuard, Q as GuardContext, R as PY_MODEL_RE, S as skillTriggerGate, St as detectModularArchitecture, T as MAX_EXA_RESULTS, Tt as requiredArchSkill, U as CODE_MUTATORS, V as interfaceSeparationGuard, W as CODE_REDIRECT, X as securityGuard, Y as CRITICAL_PATTERNS, Z as Guard, _ as DEV_VERBS, _t as evaluateFileSize, a as firstHeading, at as freshnessGate, b as detectClaudeMdProjectType, bt as ModularArchitecture, c as parseEntry, ct as PolicyResult, d as EXCLUDE_DIRS, dt as GIT_BLOCKED, et as ApexContext, f as PROJECT_INDICATORS, ft as PROJECT_INSTALL, g as loadApexTaskState, gt as countLines, h as buildApexTaskInjection, ht as FileSizeVerdict, i as firstComment, it as evaluateApex, j as clearUserGuards, k as FAIL_CLOSED, l as parseBodyDesc, lt as evaluate, m as buildApexTaskContext, mt as matchPatterns, n as missingSeoElements, nt as brainstormGate, o as TreeEntry, ot as solidReadGate, p as ApexTaskState, pt as SYSTEM_INSTALL, q as protectedPathGuard, r as descFromText, rt as docConsultedGate, s as parseEnrichment, st as PolicyContext, t as isHtmlLike, tt as ApexGate, u as parseField, ut as GIT_ASK, v as buildApexInstruction, vt as detectFramework, w as frameworkSolidGate, wt as isApexCommand, x as detectRequiredSkills, xt as ProjectType, y as buildClaudeMdContext, yt as DEV_KEYWORDS, z as SWIFT_PROTO_RE } from "./index-QzK2dv0V.mjs";
+import { $ as Guard, A as GUARDS, B as TS_DECL_RE, C as SKILL_TRIGGERS, Ct as ProjectType, D as capVerbosity, Dt as requiredArchSkill, E as MAX_TOKENS, Et as isApexCommand, F as GO_DECL_RE, G as FILE_REDIRECT, H as ASK_WRITERS, I as JAVA_DECL_RE, J as PROTECTED_GIT_RE, K as bashWriteGuard, L as PHP_DECL_RE, M as registerGuard, N as runGuards, O as detectCreationIntent, P as installGuard, Q as securityGuard, R as PY_MODEL_RE, S as skillTriggerGate, St as ModularArchitecture, T as MAX_EXA_RESULTS, Tt as detectProjectType, U as CODE_MUTATORS, V as interfaceSeparationGuard, W as CODE_REDIRECT, X as ASK_PATTERNS, Y as protectedPathGuard, Z as CRITICAL_PATTERNS, _ as DEV_VERBS, _t as FileSizeVerdict, a as firstHeading, at as docConsultedGate, b as detectClaudeMdProjectType, bt as detectFramework, c as parseEntry, ct as solidReadGate, d as EXCLUDE_DIRS, dt as evaluate, et as GuardContext, f as PROJECT_INDICATORS, ft as GIT_ASK, g as loadApexTaskState, gt as matchPatterns, h as buildApexTaskInjection, ht as SYSTEM_INSTALL, i as firstComment, it as brainstormGate, j as clearUserGuards, k as FAIL_CLOSED, l as parseBodyDesc, lt as PolicyContext, m as buildApexTaskContext, mt as PROJECT_INSTALL, n as missingSeoElements, nt as ApexContext, o as TreeEntry, ot as evaluateApex, p as ApexTaskState, pt as GIT_BLOCKED, q as PROTECTED_FRAGMENTS, r as descFromText, rt as ApexGate, s as parseEnrichment, st as freshnessGate, t as isHtmlLike, tt as APEX_GATES, u as parseField, ut as PolicyResult, v as buildApexInstruction, vt as countLines, w as frameworkSolidGate, wt as detectModularArchitecture, x as detectRequiredSkills, xt as DEV_KEYWORDS, y as buildClaudeMdContext, yt as evaluateFileSize, z as SWIFT_PROTO_RE } from "./index-DTrjSNmI.mjs";
 import { n as RouteResult, r as ScoredRef, t as RefMeta } from "./types-CY5qT2X1.mjs";
 import { a as ReminderState, c as readState, d as throttleMs, i as registryFile, l as setStateField, n as addRoot, o as lessonsFileFor, r as readRoots, s as nowStamp, t as ensureMemoryGitignore, u as stateFileFor } from "./index-DLYhervv.mjs";
-import { a as globToRe, i as scoreReferences, n as toRefMeta, o as parseFrontmatter, r as routeReferences, t as loadRefs } from "./index-DL8MxjuP.mjs";
-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";
+import { a as globToRe, i as scoreReferences, n as toRefMeta, o as parseFrontmatter, r as routeReferences, t as loadRefs } from "./index-mmRF3KNp.mjs";
+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-D7GpOmkl.mjs";
 import { _ as TIME_INTERVALS, a as formatCost, c as formatTokens, d as colors, f as progressiveColor, g as PROGRESS_CHARS, h as PROGRESS_BAR_DEFAULTS, i as formatBasename, l as ColorFn, m as GRADIENT_BLOCKS, n as generateGradientBar, o as formatPath, p as COLOR_THRESHOLDS, r as generateProgressBar, s as formatTimeLeft, t as ProgressBarOptions, u as Palette } from "./index-BWK8slRi.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, ApexTaskState, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DEV_VERBS, DocSatisfactionStatus, EXCLUDE_DIRS, FAIL_CLOSED, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GRADIENT_BLOCKS, GUARDS, Guard, GuardContext, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectLayout, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SKILL_TRIGGERS, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, TreeEntry, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, cacheLookup, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, ensureStateDir, envCandidates, evaluate, evaluateApex, evaluateFileSize, extractText, firstComment, firstHeading, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, frameworkSolidGate, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, isHtmlLike, jaccardSimilar, lessonsFileFor, loadApexTaskState, loadDotenv, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, missingSeoElements, modeFor, nowStamp, parseBodyDesc, parseEnrichment, parseEntry, parseEnvFile, parseEnvInt, parseField, parseFrontmatter, progressiveColor, projectLayout, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registerGuard, registryFile, requiredArchSkill, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, skillTriggerGate, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel, walkUpFor };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, ApexTaskState, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DEV_VERBS, DocSatisfactionStatus, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GRADIENT_BLOCKS, GUARDS, Guard, GuardContext, HOME_DIR, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectLayout, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SKILL_TRIGGERS, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, TreeEntry, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, cacheLookup, cacheLookupSubstring, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, ensureStateDir, envCandidates, evaluate, evaluateApex, evaluateFileSize, extractText, firstComment, firstHeading, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, frameworkSolidGate, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, isHtmlLike, jaccardSimilar, lessonsFileFor, loadApexTaskState, loadDotenv, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, mcpCacheWrite, missingSeoElements, modeFor, nowStamp, parseBodyDesc, parseEnrichment, parseEntry, parseEnvFile, parseEnvInt, parseField, parseFrontmatter, progressiveColor, projectLayout, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registerGuard, registryFile, requiredArchSkill, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, skillTriggerGate, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel, walkUpFor, webfetchCacheWrite };

package/dist/index.mjs

@@ -1,19 +1,19 @@
 import { a as parseEnvInt, i as splitTarget, n as MAX_LINES_ENV_KEY, r as resolveMaxLines, t as DEFAULT_MAX_LINES } from "./limits-CHn8AIL1.mjs";
-import { a as TTL_ENV_KEY, i as DEFAULT_TTL_SEC, n as loadDotenv, o as resolveTtlSec, r as parseEnvFile, s as ttlLabel, t as envCandidates } from "./dotenv-TLNMiSjP.mjs";
+import { i as ttlLabel, n as TTL_ENV_KEY, r as resolveTtlSec, t as DEFAULT_TTL_SEC } from "./ttl-BG55s6HZ.mjs";
 import { n as STATE_ROOT, r as projectLayout, t as STATE_GITIGNORE } from "./layout-C0jaaCQC.mjs";
+import { i as parseEnvFile, n as envCandidates, r as loadDotenv, t as HOME_DIR } from "./dotenv-DGyLln7U.mjs";
 import { t as compactJson } from "./compact-json-DK2nX-MK.mjs";
 import { i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-3kk7gCOp.mjs";
 import { n as detectMode, r as modeFor, t as detectHarness } from "./harness-C8Nxxyn_.mjs";
-import { A as evaluateApex, C as MAX_EXA_RESULTS, D as APEX_GATES, E as detectCreationIntent, F as detectProjectType, I as isApexCommand, L as requiredArchSkill, M as solidReadGate, N as DEV_KEYWORDS, O as brainstormGate, P as detectModularArchitecture, S as frameworkSolidGate, T as capVerbosity, _ as buildClaudeMdContext, a as firstHeading, b as skillTriggerGate, c as parseBodyDesc, d as PROJECT_INDICATORS, f as buildApexTaskContext, g as buildApexInstruction, h as DEV_VERBS, i as firstComment, j as freshnessGate, k as docConsultedGate, l as parseField, m as loadApexTaskState, n as missingSeoElements, o as parseEnrichment, p as buildApexTaskInjection, r as descFromText, s as parseEntry, t as isHtmlLike, u as EXCLUDE_DIRS, v as detectClaudeMdProjectType, w as MAX_TOKENS, x as SKILL_TRIGGERS, y as detectRequiredSkills } from "./validate-DLrWtaDR.mjs";
-import { A as evaluateFileSize, C as securityGuard, D as SYSTEM_INSTALL, E as PROJECT_INSTALL, O as matchPatterns, S as CRITICAL_PATTERNS, T as GIT_BLOCKED, _ as CODE_REDIRECT, a as registerGuard, b as protectedPathGuard, c as GO_DECL_RE, d as PY_MODEL_RE, f as SWIFT_PROTO_RE, g as CODE_MUTATORS, h as ASK_WRITERS, i as clearUserGuards, j as detectFramework, k as countLines, l as JAVA_DECL_RE, m as interfaceSeparationGuard, n as FAIL_CLOSED, o as runGuards, p as TS_DECL_RE, r as GUARDS, s as installGuard, t as evaluate, u as PHP_DECL_RE, v as bashWriteGuard, w as GIT_ASK, x as ASK_PATTERNS, y as PROTECTED_FRAGMENTS } from "./evaluate-zyxeVZPB.mjs";
-import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
-import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./router-D8cVrI-s.mjs";
+import { A as evaluateApex, C as MAX_EXA_RESULTS, D as APEX_GATES, E as detectCreationIntent, F as detectProjectType, I as isApexCommand, L as requiredArchSkill, M as solidReadGate, N as DEV_KEYWORDS, O as brainstormGate, P as detectModularArchitecture, S as frameworkSolidGate, T as capVerbosity, _ as buildClaudeMdContext, a as firstHeading, b as skillTriggerGate, c as parseBodyDesc, d as PROJECT_INDICATORS, f as buildApexTaskContext, g as buildApexInstruction, h as DEV_VERBS, i as firstComment, j as freshnessGate, k as docConsultedGate, l as parseField, m as loadApexTaskState, n as missingSeoElements, o as parseEnrichment, p as buildApexTaskInjection, r as descFromText, s as parseEntry, t as isHtmlLike, u as EXCLUDE_DIRS, v as detectClaudeMdProjectType, w as MAX_TOKENS, x as SKILL_TRIGGERS, y as detectRequiredSkills } from "./validate-BCRqp9XG.mjs";
+import { A as matchPatterns, C as ASK_PATTERNS, D as GIT_BLOCKED, E as GIT_ASK, M as evaluateFileSize, N as detectFramework, O as PROJECT_INSTALL, S as protectedPathGuard, T as securityGuard, _ as CODE_REDIRECT, a as registerGuard, b as PROTECTED_FRAGMENTS, c as GO_DECL_RE, d as PY_MODEL_RE, f as SWIFT_PROTO_RE, g as CODE_MUTATORS, h as ASK_WRITERS, i as clearUserGuards, j as countLines, k as SYSTEM_INSTALL, l as JAVA_DECL_RE, m as interfaceSeparationGuard, n as FAIL_CLOSED, o as runGuards, p as TS_DECL_RE, r as GUARDS, s as installGuard, t as evaluate, u as PHP_DECL_RE, v as FILE_REDIRECT, w as CRITICAL_PATTERNS, x as PROTECTED_GIT_RE, y as bashWriteGuard } from "./evaluate-B1n1ti0N.mjs";
+import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-B4XYL1v8.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./router-BfX0hJg8.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs, n as readRoots, o as readState, r as registryFile, s as setStateField, t as addRoot, u as ensureMemoryGitignore } from "./registry-BkoEbdec.mjs";
-import { n as jaccardSimilar, r as queryHash, t as compactMarkdown } from "./cache-C9z9LclL.mjs";
-import { a as extractText, i as mcpCacheKey, n as cachePath, o as loadIndex, r as cacheStore, s as summarizeIndex, t as cacheLookup } from "./store-PrNPm6So.mjs";
+import { a as cachePath, c as extractText, d as compactMarkdown, f as jaccardSimilar, i as cacheLookupSubstring, l as loadIndex, n as webfetchCacheWrite, o as cacheStore, p as queryHash, r as cacheLookup, s as mcpCacheKey, t as mcpCacheWrite, u as summarizeIndex } from "./mcp-store-CDUVqtJ0.mjs";
 import { t as incrementTrivialEditCounter } from "./freshness-43gxYpiX.mjs";
-import { n as toRefMeta, t as loadRefs } from "./loader-CyAoJv2W.mjs";
+import { n as toRefMeta, t as loadRefs } from "./loader-Bn-DbZmt.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-BthKK4Jj.mjs";
 import { a as formatPath, c as colors, d as GRADIENT_BLOCKS, f as PROGRESS_BAR_DEFAULTS, i as formatCost, l as progressiveColor, m as TIME_INTERVALS, n as generateProgressBar, o as formatTimeLeft, p as PROGRESS_CHARS, r as formatBasename, s as formatTokens, t as generateGradientBar, u as COLOR_THRESHOLDS } from "./statusline-D87eUNXl.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GRADIENT_BLOCKS, GUARDS, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, MAX_TOKENS, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, SKILL_TRIGGERS, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, cacheLookup, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, ensureStateDir, envCandidates, evaluate, evaluateApex, evaluateFileSize, extractText, firstComment, firstHeading, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, frameworkSolidGate, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, isHtmlLike, jaccardSimilar, lessonsFileFor, loadApexTaskState, loadDotenv, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, missingSeoElements, modeFor, nowStamp, parseBodyDesc, parseEnrichment, parseEntry, parseEnvFile, parseEnvInt, parseField, parseFrontmatter, progressiveColor, projectLayout, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registerGuard, registryFile, requiredArchSkill, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, skillTriggerGate, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel, walkUpFor };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GRADIENT_BLOCKS, GUARDS, HOME_DIR, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, MAX_TOKENS, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, SKILL_TRIGGERS, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, cacheLookup, cacheLookupSubstring, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, ensureStateDir, envCandidates, evaluate, evaluateApex, evaluateFileSize, extractText, firstComment, firstHeading, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, frameworkSolidGate, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, isHtmlLike, jaccardSimilar, lessonsFileFor, loadApexTaskState, loadDotenv, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, mcpCacheWrite, missingSeoElements, modeFor, nowStamp, parseBodyDesc, parseEnrichment, parseEntry, parseEnvFile, parseEnvInt, parseField, parseFrontmatter, progressiveColor, projectLayout, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registerGuard, registryFile, requiredArchSkill, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, skillTriggerGate, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel, walkUpFor, webfetchCacheWrite };

package/dist/{loader-CyAoJv2W.mjs → loader-Bn-DbZmt.mjs}

@@ -1,4 +1,4 @@
-import { i as parseFrontmatter } from "./router-D8cVrI-s.mjs";
+import { i as parseFrontmatter } from "./router-BfX0hJg8.mjs";
 import { delimiter, join } from "node:path";
 import { readFile, readdir } from "node:fs/promises";
 //#region src/refs/loader.ts

package/dist/mcp-store-CDUVqtJ0.mjs

@@ -0,0 +1,238 @@
+import { t as atomicWrite } from "./json-io-CvSumjtz.mjs";
+import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { createHash } from "node:crypto";
+//#region src/cache/compact.ts
+const HTML_ENTITIES = {
+	"&": "&",
+	"&lt;": "<",
+	"&gt;": ">",
+	"&quot;": "\"",
+	"&#x27;": "'",
+	"&#39;": "'",
+	"&nbsp;": " ",
+	"&apos;": "'"
+};
+const BOILERPLATE = [
+	/^.*cookie.*(accept|consent|banner).*$/gim,
+	/^.*was this (helpful|page helpful|article helpful).*$/gim,
+	/^.*©\s*\d{4}.*all rights reserved.*$/gim,
+	/^\s*(home|about|contact|privacy|terms)\s*\|\s*.*$/gim,
+	/^.*subscribe to (our )?newsletter.*$/gim,
+	/^.*follow us on (twitter|facebook|linkedin).*$/gim
+];
+const MAX_BYTES = 5 * 1024;
+function decodeEntities(text) {
+	let out = text;
+	for (const [ent, ch] of Object.entries(HTML_ENTITIES)) out = out.split(ent).join(ch);
+	out = out.replace(/&#x([0-9a-fA-F]+);/g, (_m, h) => String.fromCodePoint(parseInt(h, 16)));
+	out = out.replace(/&#(\d+);/g, (_m, d) => String.fromCodePoint(parseInt(d, 10)));
+	return out;
+}
+/** Strip HTML entities + boilerplate, normalize blank lines, truncate to ~5KB. */
+function compactMarkdown(content) {
+	let text = decodeEntities(content);
+	for (const re of BOILERPLATE) text = text.replace(re, "");
+	text = text.replace(/\n{3,}/g, "\n\n").trim();
+	const enc = new TextEncoder().encode(text);
+	if (enc.length > MAX_BYTES) {
+		const truncated = new TextDecoder().decode(enc.slice(0, MAX_BYTES));
+		text = `${truncated}\n\n[... truncated, ${text.slice(truncated.length).split("\n").length - 1} lines]`;
+	}
+	return text;
+}
+/** 8-char MD5 of `${toolName}::${query}`. */
+function queryHash(toolName, query) {
+	return createHash("md5").update(`${toolName}::${query}`).digest("hex").slice(0, 8);
+}
+/** Bag-of-words Jaccard similarity strictly greater than `threshold`. */
+function jaccardSimilar(a, b, threshold = .8) {
+	const ta = new Set(a.toLowerCase().split(/\s+/).filter(Boolean));
+	const tb = new Set(b.toLowerCase().split(/\s+/).filter(Boolean));
+	if (ta.size === 0 || tb.size === 0) return false;
+	let inter = 0;
+	for (const t of ta) if (tb.has(t)) inter++;
+	const union = ta.size + tb.size - inter;
+	return inter / union > threshold;
+}
+//#endregion
+//#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;
+/**
+* Extract usable markdown from an MCP `tool_response`: a string, a list of
+* content blocks (non-text blocks skipped), or any JSON structure (fallback).
+* Recurses up to depth 5 to guard against pathological/cyclic structures.
+*/
+function extractText(resp, depth = 0) {
+	if (depth >= MAX_DEPTH) return "";
+	if (typeof resp === "string") return resp;
+	if (Array.isArray(resp)) {
+		const parts = resp.filter((b) => typeof b === "object" && b !== null).filter((b) => b.type === "text").map((b) => b.text ?? "");
+		if (parts.length) return parts.join("\n\n");
+		const joined = resp.filter((b) => Array.isArray(b) || typeof b === "object" && b !== null).map((b) => extractText(b, depth + 1)).filter(Boolean).join("\n\n");
+		if (joined) return joined;
+	}
+	if (!resp) return "";
+	try {
+		return JSON.stringify(resp, (_k, v) => v !== null && typeof v === "object" && !Array.isArray(v) ? Object.fromEntries(Object.entries(v).sort(([a], [b]) => a.localeCompare(b))) : v);
+	} catch {
+		return "";
+	}
+}
+//#endregion
+//#region src/cache/store.ts
+/** Max body bytes read on a substring lookup (parity with mcp-cache-lookup.py MAX_BODY). */
+const MAX_BODY = 8 * 1024;
+/** Needle length scanned on a substring lookup (first 80 query chars, ripgrep-aligned). */
+const NEEDLE_LEN = 80;
+/** Stable 16-char key from a tool name + query (FNV-1a, non-crypto). */
+function mcpCacheKey(tool, query) {
+	const s = `${tool}\n${query}`;
+	let h = 2166136261;
+	for (let i = 0; i < s.length; i++) {
+		h ^= s.charCodeAt(i);
+		h = Math.imul(h, 16777619);
+	}
+	return (h >>> 0).toString(16).padStart(8, "0") + (s.length >>> 0).toString(16).padStart(8, "0");
+}
+/** Path of a cache entry under `dir`. */
+function cachePath(dir, tool, query) {
+	return join(dir, `${mcpCacheKey(tool, query)}.md`);
+}
+/** Read a cached entry if it exists and is fresh (mtime within `ttlMs`), else null. */
+function cacheLookup(dir, tool, query, ttlMs, now) {
+	const path = cachePath(dir, tool, query);
+	try {
+		if (!existsSync(path) || now - statSync(path).mtimeMs > ttlMs) return null;
+		return readFileSync(path, "utf8");
+	} catch {
+		return null;
+	}
+}
+/**
+* First fresh cache file whose body contains the (normalized, case-insensitive)
+* query substring, else null. Relaxes the exact-key match to lift the hit-rate —
+* parity with `mcp-cache-lookup.py` (`rg -i -F` over the first 80 query chars).
+* @param dir - Cache directory to scan.
+* @param query - Raw query; newlines folded to spaces, truncated to 80 chars.
+* @param ttlMs - Freshness window (mtime-based).
+* @param now - Current epoch ms.
+*/
+function cacheLookupSubstring(dir, query, ttlMs, now) {
+	const needle = query.replace(/[\r\n]+/g, " ").slice(0, NEEDLE_LEN).trim().toLowerCase();
+	if (!needle) return null;
+	let names;
+	try {
+		names = readdirSync(dir);
+	} catch {
+		return null;
+	}
+	for (const name of names) {
+		if (!name.endsWith(".md")) continue;
+		const path = join(dir, name);
+		try {
+			if (now - statSync(path).mtimeMs > ttlMs) continue;
+			const body = readFileSync(path, "utf8").slice(0, MAX_BODY);
+			if (body.toLowerCase().includes(needle)) return body;
+		} catch {
+			continue;
+		}
+	}
+	return null;
+}
+/** Store a cache entry (creates the dir; no-op on empty content). */
+function cacheStore(dir, tool, query, content) {
+	if (!content) return;
+	const path = cachePath(dir, tool, query);
+	mkdirSync(dirname(path), { recursive: true });
+	writeFileSync(path, content);
+}
+//#endregion
+//#region src/cache/mcp-store.ts
+/** UTC timestamp `YYYY-MM-DDTHH:MM:SSZ` (no millis), mirroring the Python store. */
+function stamp(now) {
+	return new Date(now).toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+/** True when a Jaccard-similar query already exists for `tool` in `index`. */
+function isDuplicate(index, tool, query) {
+	return index.some((e) => {
+		if (typeof e !== "object" || e === null) return false;
+		const r = e;
+		return r.tool === tool && typeof r.query === "string" && jaccardSimilar(r.query, query);
+	});
+}
+/**
+* Persist an MCP doc result the way `cache-mcp-result.py` does: compact the body,
+* skip Jaccard-duplicate queries, write a front-matter `.md` (exact FNV key, so
+* {@link cacheLookup} still hits) carrying the query for substring lookups, and
+* append the entry to `index.json`. No-op on empty body or duplicate query.
+* @param dir - Cache directory (also holds `index.json`).
+* @param tool - MCP tool id.
+* @param query - Doc query that keys the entry.
+* @param body - Raw response text (compacted before write).
+* @param now - Current epoch ms (timestamp source).
+*/
+function mcpCacheWrite(dir, tool, query, body, now) {
+	const compacted = compactMarkdown(body);
+	if (!compacted) return;
+	const indexPath = join(dir, "index.json");
+	const index = loadIndex(indexPath);
+	if (isDuplicate(index, tool, query)) return;
+	const hash = queryHash(tool, query);
+	const ts = stamp(now);
+	cacheStore(dir, tool, query, `---\ntool: ${tool}\nquery: ${JSON.stringify(query)}\nts: ${ts}\nhash: ${hash}\n---\n\n` + compacted);
+	index.push({
+		tool,
+		query,
+		hash,
+		ts
+	});
+	atomicWrite(indexPath, JSON.stringify(index, null, 2));
+}
+/**
+* Persist a WebFetch result the way `webfetch-cache-store.py` does: compact the
+* body, write a front-matter `.md` keyed by `key` (url + prompt[:500]). No index
+* and no dedup — WebFetch entries are exact-key only. No-op on empty body.
+* @param dir - Cache directory.
+* @param tool - Always `WebFetch`.
+* @param key - The url+prompt cache key string.
+* @param body - Raw response text (compacted before write).
+* @param now - Current epoch ms (timestamp source).
+*/
+function webfetchCacheWrite(dir, tool, key, body, now) {
+	const compacted = compactMarkdown(body);
+	if (!compacted) return;
+	const hash = queryHash(tool, key);
+	cacheStore(dir, tool, key, `---\ntool: ${tool}\nkey: ${JSON.stringify(key)}\nts: ${stamp(now)}\nhash: ${hash}\n---\n\n` + compacted);
+}
+//#endregion
+export { cachePath as a, extractText as c, compactMarkdown as d, jaccardSimilar as f, cacheLookupSubstring as i, loadIndex as l, webfetchCacheWrite as n, cacheStore as o, queryHash as p, cacheLookup as r, mcpCacheKey as s, mcpCacheWrite as t, summarizeIndex as u };

package/dist/policy/index.d.mts

@@ -1,2 +1,2 @@
-import { $ as APEX_GATES, A as GUARDS, B as TS_DECL_RE, C as SKILL_TRIGGERS, Ct as detectProjectType, D as capVerbosity, E as MAX_TOKENS, F as GO_DECL_RE, G as bashWriteGuard, H as ASK_WRITERS, I as JAVA_DECL_RE, J as ASK_PATTERNS, K as PROTECTED_FRAGMENTS, L as PHP_DECL_RE, M as registerGuard, N as runGuards, O as detectCreationIntent, P as installGuard, Q as GuardContext, R as PY_MODEL_RE, S as skillTriggerGate, St as detectModularArchitecture, T as MAX_EXA_RESULTS, Tt as requiredArchSkill, U as CODE_MUTATORS, V as interfaceSeparationGuard, W as CODE_REDIRECT, X as securityGuard, Y as CRITICAL_PATTERNS, Z as Guard, _ as DEV_VERBS, _t as evaluateFileSize, a as firstHeading, at as freshnessGate, b as detectClaudeMdProjectType, bt as ModularArchitecture, c as parseEntry, ct as PolicyResult, d as EXCLUDE_DIRS, dt as GIT_BLOCKED, et as ApexContext, f as PROJECT_INDICATORS, ft as PROJECT_INSTALL, g as loadApexTaskState, gt as countLines, h as buildApexTaskInjection, ht as FileSizeVerdict, i as firstComment, it as evaluateApex, j as clearUserGuards, k as FAIL_CLOSED, l as parseBodyDesc, lt as evaluate, m as buildApexTaskContext, mt as matchPatterns, n as missingSeoElements, nt as brainstormGate, o as TreeEntry, ot as solidReadGate, p as ApexTaskState, pt as SYSTEM_INSTALL, q as protectedPathGuard, r as descFromText, rt as docConsultedGate, s as parseEnrichment, st as PolicyContext, t as isHtmlLike, tt as ApexGate, u as parseField, ut as GIT_ASK, v as buildApexInstruction, vt as detectFramework, w as frameworkSolidGate, wt as isApexCommand, x as detectRequiredSkills, xt as ProjectType, y as buildClaudeMdContext, yt as DEV_KEYWORDS, z as SWIFT_PROTO_RE } from "../index-QzK2dv0V.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexTaskState, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, Guard, GuardContext, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, PolicyContext, PolicyResult, ProjectType, SKILL_TRIGGERS, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, TreeEntry, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, capVerbosity, clearUserGuards, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, firstComment, firstHeading, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, isHtmlLike, loadApexTaskState, matchPatterns, missingSeoElements, parseBodyDesc, parseEnrichment, parseEntry, parseField, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate };
+import { $ as Guard, A as GUARDS, B as TS_DECL_RE, C as SKILL_TRIGGERS, Ct as ProjectType, D as capVerbosity, Dt as requiredArchSkill, E as MAX_TOKENS, Et as isApexCommand, F as GO_DECL_RE, G as FILE_REDIRECT, H as ASK_WRITERS, I as JAVA_DECL_RE, J as PROTECTED_GIT_RE, K as bashWriteGuard, L as PHP_DECL_RE, M as registerGuard, N as runGuards, O as detectCreationIntent, P as installGuard, Q as securityGuard, R as PY_MODEL_RE, S as skillTriggerGate, St as ModularArchitecture, T as MAX_EXA_RESULTS, Tt as detectProjectType, U as CODE_MUTATORS, V as interfaceSeparationGuard, W as CODE_REDIRECT, X as ASK_PATTERNS, Y as protectedPathGuard, Z as CRITICAL_PATTERNS, _ as DEV_VERBS, _t as FileSizeVerdict, a as firstHeading, at as docConsultedGate, b as detectClaudeMdProjectType, bt as detectFramework, c as parseEntry, ct as solidReadGate, d as EXCLUDE_DIRS, dt as evaluate, et as GuardContext, f as PROJECT_INDICATORS, ft as GIT_ASK, g as loadApexTaskState, gt as matchPatterns, h as buildApexTaskInjection, ht as SYSTEM_INSTALL, i as firstComment, it as brainstormGate, j as clearUserGuards, k as FAIL_CLOSED, l as parseBodyDesc, lt as PolicyContext, m as buildApexTaskContext, mt as PROJECT_INSTALL, n as missingSeoElements, nt as ApexContext, o as TreeEntry, ot as evaluateApex, p as ApexTaskState, pt as GIT_BLOCKED, q as PROTECTED_FRAGMENTS, r as descFromText, rt as ApexGate, s as parseEnrichment, st as freshnessGate, t as isHtmlLike, tt as APEX_GATES, u as parseField, ut as PolicyResult, v as buildApexInstruction, vt as countLines, w as frameworkSolidGate, wt as detectModularArchitecture, x as detectRequiredSkills, xt as DEV_KEYWORDS, y as buildClaudeMdContext, yt as evaluateFileSize, z as SWIFT_PROTO_RE } from "../index-DTrjSNmI.mjs";
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexTaskState, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, Guard, GuardContext, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, PolicyContext, PolicyResult, ProjectType, SKILL_TRIGGERS, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, TreeEntry, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, capVerbosity, clearUserGuards, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, firstComment, firstHeading, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, isHtmlLike, loadApexTaskState, matchPatterns, missingSeoElements, parseBodyDesc, parseEnrichment, parseEntry, parseField, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate };