@fusengine/harness 0.1.1 → 0.1.3

package/dist/index-BWK8slRi.d.mts

@@ -0,0 +1,84 @@
+//#region src/statusline/constants.d.ts
+/** Time interval constants (ms). */
+declare const TIME_INTERVALS: {
+  readonly MINUTE_MS: 60_000;
+  readonly HOUR_MS: 3_600_000;
+};
+/** Percentage thresholds for progressive coloring. */
+declare const COLOR_THRESHOLDS: {
+  readonly WARNING: 70;
+  readonly CRITICAL: 90;
+};
+/** Fill/empty glyphs per progress-bar style. */
+declare const PROGRESS_CHARS: {
+  readonly blocks: {
+    readonly fill: "█";
+    readonly empty: "░";
+  };
+  readonly bars: {
+    readonly fill: "▰";
+    readonly empty: "▱";
+  };
+};
+/** Defaults for {@link generateProgressBar}. */
+declare const PROGRESS_BAR_DEFAULTS: {
+  readonly STYLE: "blocks";
+  readonly LENGTH: 10;
+};
+/** 9 gradient blocks from empty to full. */
+declare const GRADIENT_BLOCKS: readonly [" ", "▏", "▎", "▍", "▌", "▋", "▊", "▉", "█"];
+//#endregion
+//#region src/statusline/colors.d.ts
+/** A text-decorating function. */
+type ColorFn = (text: string) => string;
+/** Forced ANSI palette (every entry is a colorizer, plus reset + support flag). */
+interface Palette {
+  blue: ColorFn;
+  cyan: ColorFn;
+  green: ColorFn;
+  yellow: ColorFn;
+  red: ColorFn;
+  magenta: ColorFn;
+  white: ColorFn;
+  gray: ColorFn;
+  purple: ColorFn;
+  orange: ColorFn;
+  brightRed: ColorFn;
+  brightYellow: ColorFn;
+  brightGreen: ColorFn;
+  bold: ColorFn;
+  dim: ColorFn;
+  reset: string;
+  isSupported: boolean;
+}
+/** Forced ANSI color helpers (ignore TTY detection). */
+declare const colors: Palette;
+/** Color `text` by threshold: green < WARNING <= yellow < CRITICAL <= red. */
+declare function progressiveColor(value: number, text: string): string;
+//#endregion
+//#region src/statusline/formatters.d.ts
+/** Format a path: truncated (default), full, relative (~), or basename. */
+declare function formatPath(path: string, style?: "truncated" | "full" | "relative" | "basename"): string;
+/** Basename of a path. */
+declare function formatBasename(path: string): string;
+/** Humanize a remaining duration in ms (e.g. "2h - 5m"). */
+declare function formatTimeLeft(ms: number): string;
+/** Format a token count as "12K" (or "12.3K" with decimals). */
+declare function formatTokens(tokens: number, showDecimals?: boolean): string;
+/** Format a cost as "$1.23". */
+declare function formatCost(cost: number, decimals?: number): string;
+//#endregion
+//#region src/statusline/progress-bar.d.ts
+/** Options for {@link generateProgressBar}. */
+interface ProgressBarOptions {
+  style?: keyof typeof PROGRESS_CHARS;
+  length?: number;
+  useProgressiveColor?: boolean;
+  showPercentage?: boolean;
+}
+/** Render a fill/empty progress bar. */
+declare function generateProgressBar(percentage: number, options?: ProgressBarOptions): string;
+/** Render a fine-grained gradient bar (sub-block resolution). */
+declare function generateGradientBar(percentage: number, length?: number): string;
+//#endregion
+export { TIME_INTERVALS as _, formatCost as a, formatTokens as c, colors as d, progressiveColor as f, PROGRESS_CHARS as g, PROGRESS_BAR_DEFAULTS as h, formatBasename as i, ColorFn as l, GRADIENT_BLOCKS as m, generateGradientBar as n, formatPath as o, COLOR_THRESHOLDS as p, generateProgressBar as r, formatTimeLeft as s, ProgressBarOptions as t, Palette as u };

package/dist/index-BXBWKbL8.d.mts

@@ -0,0 +1,114 @@
+import { t as Prompt } from "./types-D56jSgD9.mjs";
+import { t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
+import { t as RefMeta } from "./types-CY5qT2X1.mjs";
+
+//#region src/policy/detect-project.d.ts
+/** Project types detected from filesystem indicators. */
+type ProjectType = "nextjs" | "nuxt" | "angular" | "svelte" | "vue" | "react" | "tailwind" | "laravel" | "rails" | "django" | "python" | "go" | "rust" | "swift" | "java" | "scala" | "elixir" | "ruby" | "generic";
+/** Keywords that signal a development task (APEX trigger). */
+declare const DEV_KEYWORDS: RegExp;
+/** True when the prompt invokes the /apex command. */
+declare function isApexCommand(prompt: string): boolean;
+/** Detect the project type by scanning config files in `dir`. */
+declare function detectProjectType(dir: string): ProjectType;
+//#endregion
+//#region src/policy/detect-framework.d.ts
+/**
+* Detect the framework from a file path extension + content patterns.
+* Aligned with the fusengine require-solid-read detection (distinct from
+* {@link detectProjectType}, which scans config files on disk).
+*/
+declare function detectFramework(filePath: string, content: string): string;
+//#endregion
+//#region src/policy/file-size.d.ts
+/** Verdict from {@link evaluateFileSize}. */
+interface FileSizeVerdict {
+  ok: boolean;
+  lines: number;
+  max: number;
+  message: string | null;
+}
+/** Count lines in file content (empty string = 0). */
+declare function countLines(content: string): number;
+/**
+* Evaluate a file's line count against the SOLID limit.
+* @param lines - the file's line count
+* @param max - the limit (defaults to `resolveMaxLines()`)
+*/
+declare function evaluateFileSize(lines: number, max?: number): FileSizeVerdict;
+//#endregion
+//#region src/policy/patterns.d.ts
+/**
+* Guard pattern data, ported verbatim from the fusengine git/install guards.
+* Note (faithful): `git push.*--force` also matches `--force-with-lease` —
+* preserved from the source guard.
+*/
+/** Destructive git operations to block outright. */
+declare const GIT_BLOCKED: ReadonlyArray<RegExp>;
+/** Git operations that warrant a confirmation prompt. */
+declare const GIT_ASK: ReadonlyArray<RegExp>;
+/** System-level package installs (need confirmation). */
+declare const SYSTEM_INSTALL: ReadonlyArray<RegExp>;
+/** Project-level package installs. */
+declare const PROJECT_INSTALL: ReadonlyArray<RegExp>;
+/** True when `cmd` matches any pattern in `patterns`. */
+declare function matchPatterns(cmd: string, patterns: ReadonlyArray<RegExp>): boolean;
+//#endregion
+//#region src/policy/evaluate.d.ts
+/** Harness-agnostic input to {@link evaluate}. */
+interface PolicyContext {
+  /** Tool name (e.g. "Write", "Edit", "Bash"). */
+  tool: string;
+  filePath?: string;
+  content?: string;
+  command?: string;
+  /** Optional override for the SOLID max-lines limit. */
+  maxLines?: number;
+}
+/** Harness-agnostic policy decision (+ a portable prompt for adapters to render). */
+interface PolicyResult {
+  decision: "allow" | "deny" | "warn";
+  message: string | null;
+  prompt?: Prompt;
+  meta?: Record<string, unknown>;
+}
+/**
+* Evaluate a single tool-use against the bundled policies, returning a pure
+* decision plus a portable {@link Prompt}. Adapters translate the prompt into
+* their harness's native response (Claude `permissionDecision`, etc.).
+*/
+declare function evaluate(ctx: PolicyContext): PolicyResult;
+//#endregion
+//#region src/policy/apex.d.ts
+/**
+* Session context for the stateful APEX gates. The harness adapter supplies this
+* (the package owns the gate LOGIC; recording the session activity is the
+* adapter's tracking layer).
+*/
+interface ApexContext {
+  sessionId: string;
+  framework: string;
+  filePath: string;
+  content: string;
+  /** Doc-consultation authorizations from session state (Context7/Exa). */
+  authorizations?: Record<string, AuthEntry>;
+  /** Available SOLID references for the framework's skill. */
+  refs?: RefMeta[];
+  /** Absolute paths of SOLID refs already read this session. */
+  refsRead?: string[];
+}
+/** 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. */
+declare const docConsultedGate: ApexGate;
+/** Gate: the routed SOLID references for this edit must have been read. */
+declare const solidReadGate: ApexGate;
+/** Default APEX gate chain. */
+declare const APEX_GATES: ReadonlyArray<ApexGate>;
+/**
+* Run the APEX gates (chain-of-responsibility): the first failing gate's prompt
+* wins; null means every gate passed (allow).
+*/
+declare function evaluateApex(ctx: ApexContext, gates?: ReadonlyArray<ApexGate>): Prompt | null;
+//#endregion
+export { isApexCommand as S, evaluateFileSize as _, evaluateApex as a, ProjectType as b, PolicyResult as c, GIT_BLOCKED as d, PROJECT_INSTALL as f, countLines as g, FileSizeVerdict as h, docConsultedGate as i, evaluate as l, matchPatterns as m, ApexContext as n, solidReadGate as o, SYSTEM_INSTALL as p, ApexGate as r, PolicyContext as s, APEX_GATES as t, GIT_ASK as u, detectFramework as v, detectProjectType as x, DEV_KEYWORDS as y };

package/dist/index-C1vLIMwN.d.mts

@@ -0,0 +1,20 @@
+//#region src/util/compact-json.d.ts
+/**
+* Compact JSON serializer for cache/state files.
+* Top-level keys are indented one per line; nested objects/arrays render inline.
+* Behaviour preserved from the fusengine hooks.
+*/
+declare function compactJson(data: unknown): string;
+//#endregion
+//#region src/util/project-root.d.ts
+/** True for a source-code file outside generated/vendored directories. */
+declare function isCodeFile(p: string): boolean;
+/**
+* Resolve the project root, preferring the repo boundary (`.git`) over a
+* nested `package.json` — avoids false roots in monorepos. Null if none found.
+*/
+declare function projectRootOrNull(dir: string): string | null;
+/** Like {@link projectRootOrNull} but falls back to `process.cwd()`. */
+declare function projectRoot(dir: string): string;
+//#endregion
+export { compactJson as i, projectRoot as n, projectRootOrNull as r, isCodeFile as t };

package/dist/index-C2Lz-cwJ.d.mts

@@ -0,0 +1,21 @@
+import { n as RouteResult, r as ScoredRef, t as RefMeta } from "./types-CY5qT2X1.mjs";
+
+//#region src/refs/frontmatter.d.ts
+/** Extract frontmatter key/value pairs from markdown content (quotes stripped). */
+declare function parseFrontmatter(content: string): Record<string, string>;
+/** Convert a simple glob (`**`, `*`) to an anchored RegExp. */
+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, +5 per `trigger-on-edit` fragment, +1 per keyword.
+*/
+declare function scoreReferences(refs: RefMeta[], filePath: string, content: string): ScoredRef[];
+/**
+* Route references for a file edit: top-2 required + next-2 optional, ensuring a
+* `principle` and a `template` appear in the top 4. Returns null when nothing scores.
+*/
+declare function routeReferences(refs: RefMeta[], filePath: string, content: string, skillPath?: string): RouteResult | null;
+//#endregion
+export { parseFrontmatter as i, scoreReferences as n, globToRe as r, routeReferences as t };

package/dist/index-CPoF_hLP.d.mts

@@ -0,0 +1,59 @@
+import { t as AuthEntry } from "./doc-helpers-CG1nuf-c.mjs";
+
+//#region src/state/lock.d.ts
+/**
+* Acquire a directory-based lock (atomic `mkdir`, EEXIST = already held) with a timeout.
+* @returns a release function, or null if the lock could not be acquired in time.
+*/
+declare function acquireLock(lockDir: string, timeoutMs?: number): Promise<(() => Promise<void>) | null>;
+//#endregion
+//#region src/state/apex-state.d.ts
+declare const DEFAULT_STATE: {
+  $schema: string;
+  description: string;
+  target: Record<string, string>;
+  authorizations: Record<string, AuthEntry & {
+    doc_consulted?: string;
+  }>;
+};
+/** APEX state shape. */
+type ApexState = typeof DEFAULT_STATE;
+/** APEX state directory under a home dir. */
+declare function apexStateDir(home?: string): string;
+/** Daily state file path: `<home>/.claude/logs/00-apex/<YYYY-MM-DD>-state.json`. */
+declare function stateFilePath(home?: string, today?: string): string;
+/** Ensure the state directory exists and return its path. */
+declare function ensureStateDir(home?: string): Promise<string>;
+/** Load APEX state, or a fresh default. */
+declare function loadState(path: string): Promise<ApexState>;
+/** Save APEX state. */
+declare function saveState(path: string, state: ApexState): Promise<void>;
+//#endregion
+//#region src/state/task-helpers.d.ts
+/** A task entry in task.json. */
+interface ApexTask {
+  subject: string;
+  description: string;
+  status: string;
+  phase: string;
+  started_at?: string;
+  completed_at?: string;
+  created_at?: string;
+  doc_consulted: Record<string, unknown>;
+  files_modified: string[];
+  blockedBy?: string[];
+}
+/** Structure of `.claude/apex/task.json`. */
+interface ApexTaskFile {
+  current_task: string;
+  created_at: string;
+  tasks: Record<string, ApexTask>;
+}
+/** Add a new pending task. */
+declare function taskCreate(file: string, id: string, subject: string, desc: string): Promise<void>;
+/** Mark a task in_progress (creating a stub if absent). */
+declare function taskStart(file: string, id: string, subject?: string, desc?: string, blocked?: string): Promise<void>;
+/** Mark a task completed. */
+declare function taskComplete(file: string, id: string): Promise<void>;
+//#endregion
+export { taskStart as a, ensureStateDir as c, stateFilePath as d, acquireLock as f, taskCreate as i, loadState as l, ApexTaskFile as n, ApexState as o, taskComplete as r, apexStateDir as s, ApexTask as t, saveState as u };

package/dist/index-FrWgmkbP.d.mts

@@ -0,0 +1,36 @@
+import { t as Prompt } from "./types-D56jSgD9.mjs";
+
+//#region src/adapters/claude/index.d.ts
+/** Subset of the Claude Code hook stdin payload we consume. */
+interface ClaudeHookInput {
+  hook_event_name?: string;
+  tool_name?: string;
+  tool_input?: {
+    file_path?: string;
+    content?: string;
+    new_string?: string;
+    command?: string;
+  };
+  cwd?: string;
+}
+/** 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. */
+declare function denyResponse(event: string, reason: string): string;
+/** An `additionalContext` injection response. */
+declare function contextResponse(event: string, text: string): string;
+/**
+* Render a portable {@link Prompt} as a Claude Code hook response:
+* `block` → `permissionDecision: deny`, `ask` → `permissionDecision: ask`
+* (interactive confirm), `inform` → `additionalContext`.
+*/
+declare function toClaudeResponse(event: string, prompt: Prompt): string;
+/**
+* Run the bundled policy over a Claude payload and return the native response
+* string (deny/ask/additionalContext), or null to allow.
+*/
+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 };

package/dist/index.d.mts

@@ -1,13 +1,14 @@
 import { n as PromptKind, r as formatPrompt, t as Prompt } from "./types-D56jSgD9.mjs";
-import { IndexSummary, compactMarkdown, extractText, jaccardSimilar, loadIndex, queryHash, summarizeIndex } from "./cache/index.mjs";
-import { DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, MAX_LINES_ENV_KEY, TTL_ENV_KEY, parseEnvInt, resolveMaxLines, resolveTtlSec, splitTarget, ttlLabel } from "./config/index.mjs";
-import { HarnessId, HarnessInfo, HarnessMode, HarnessVia, detectHarness, detectMode, modeFor } from "./detect/index.mjs";
+import { a as compactMarkdown, i as summarizeIndex, n as IndexSummary, o as jaccardSimilar, r as loadIndex, s as queryHash, t as extractText } from "./index-B3Ve_bBu.mjs";
+import { a as DEFAULT_TTL_SEC, c as ttlLabel, i as splitTarget, l as parseEnvInt, n as MAX_LINES_ENV_KEY, o as TTL_ENV_KEY, r as resolveMaxLines, s as resolveTtlSec, t as DEFAULT_MAX_LINES } from "./index-B-z0CCiU.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 { incrementTrivialEditCounter } from "./freshness/index.mjs";
-import { compactJson, isCodeFile, projectRoot, projectRootOrNull } from "./util/index.mjs";
-import { DEV_KEYWORDS, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, PROJECT_INSTALL, PolicyContext, PolicyResult, ProjectType, SYSTEM_INSTALL, countLines, detectFramework, detectProjectType, evaluate, evaluateFileSize, isApexCommand, matchPatterns } from "./policy/index.mjs";
-import { ReminderState, addRoot, ensureMemoryGitignore, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs } from "./memory/index.mjs";
-import { RefMeta, RouteResult, ScoredRef, globToRe, parseFrontmatter, routeReferences, scoreReferences } from "./refs/index.mjs";
-import { ApexState, ApexTask, ApexTaskFile, acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart } from "./state/index.mjs";
-import { COLOR_THRESHOLDS, ColorFn, GRADIENT_BLOCKS, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, Palette, ProgressBarOptions, TIME_INTERVALS, colors, formatBasename, formatCost, formatPath, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, progressiveColor } from "./statusline/index.mjs";
-export { ApexState, ApexTask, ApexTaskFile, AuthEntry, COLOR_THRESHOLDS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };
+import { t as incrementTrivialEditCounter } from "./index-BOBXQ91y.mjs";
+import { i as compactJson, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./index-C1vLIMwN.mjs";
+import { S as isApexCommand, _ as evaluateFileSize, a as evaluateApex, b as ProjectType, c as PolicyResult, d as GIT_BLOCKED, f as PROJECT_INSTALL, g as countLines, h as FileSizeVerdict, i as docConsultedGate, l as evaluate, m as matchPatterns, n as ApexContext, o as solidReadGate, p as SYSTEM_INSTALL, r as ApexGate, s as PolicyContext, t as APEX_GATES, u as GIT_ASK, v as detectFramework, x as detectProjectType, y as DEV_KEYWORDS } from "./index-BXBWKbL8.mjs";
+import { n as RouteResult, r as ScoredRef, t as RefMeta } from "./types-CY5qT2X1.mjs";
+import { a as ReminderState, c as setStateField, i as registryFile, l as stateFileFor, n as addRoot, o as nowStamp, r as readRoots, s as readState, t as ensureMemoryGitignore, u as throttleMs } from "./index-BEM-mQMC.mjs";
+import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./index-C2Lz-cwJ.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 { _ 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, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, AuthEntry, COLOR_THRESHOLDS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, HarnessId, HarnessInfo, HarnessMode, HarnessVia, IndexSummary, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };

package/dist/index.mjs

@@ -1,17 +1,16 @@
 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 { DEFAULT_TTL_SEC, TTL_ENV_KEY, resolveTtlSec, ttlLabel } from "./config/index.mjs";
+import { i as ttlLabel, n as TTL_ENV_KEY, r as resolveTtlSec, t as DEFAULT_TTL_SEC } from "./config-BG55s6HZ.mjs";
 import { t as compactJson } from "./compact-json-DK2nX-MK.mjs";
 import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-C4ks_q1G.mjs";
-import "./util/index.mjs";
-import { detectHarness, detectMode, modeFor } from "./detect/index.mjs";
+import { n as detectMode, r as modeFor, t as detectHarness } from "./harness-C8Nxxyn_.mjs";
+import { a as DEV_KEYWORDS, i as solidReadGate, n as docConsultedGate, o as detectProjectType, r as evaluateApex, s as isApexCommand, t as APEX_GATES } from "./policy-DMpyaPZ_.mjs";
 import { a as SYSTEM_INSTALL, c as evaluateFileSize, i as PROJECT_INSTALL, l as detectFramework, n as GIT_ASK, o as matchPatterns, r as GIT_BLOCKED, s as countLines, t as evaluate } from "./evaluate-CsYyUucy.mjs";
-import { DEV_KEYWORDS, detectProjectType, isApexCommand } from "./policy/index.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-Dj3AfgBE.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
-import "./prompt/index.mjs";
-import { addRoot, ensureMemoryGitignore, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs } from "./memory/index.mjs";
-import { compactMarkdown, extractText, jaccardSimilar, loadIndex, queryHash, summarizeIndex } from "./cache/index.mjs";
-import { formatDocDeny, formatDocSatisfactionStatus, incrementTrivialEditCounter, isDocConsulted, resolveSessions } from "./freshness/index.mjs";
-import { globToRe, parseFrontmatter, routeReferences, scoreReferences } from "./refs/index.mjs";
-import { acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart } from "./state/index.mjs";
-import { COLOR_THRESHOLDS, GRADIENT_BLOCKS, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, TIME_INTERVALS, colors, formatBasename, formatCost, formatPath, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, progressiveColor } from "./statusline/index.mjs";
-export { COLOR_THRESHOLDS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, SYSTEM_INSTALL, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };
+import { a as readState, c as throttleMs, i as nowStamp, l as ensureMemoryGitignore, n as readRoots, o as setStateField, r as registryFile, s as stateFileFor, t as addRoot } from "./memory-BVNt4Ary.mjs";
+import { a as jaccardSimilar, i as compactMarkdown, n as loadIndex, o as queryHash, r as summarizeIndex, t as extractText } from "./cache-DbPSJ9bC.mjs";
+import { t as incrementTrivialEditCounter } from "./freshness-BK9Xg6oG.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-Bc4wdnCG.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, COLOR_THRESHOLDS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, GIT_ASK, GIT_BLOCKED, GRADIENT_BLOCKS, MAX_LINES_ENV_KEY, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, SYSTEM_INSTALL, TIME_INTERVALS, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, colors, compactJson, compactMarkdown, countLines, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, loadIndex, loadState, matchPatterns, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectRoot, projectRootOrNull, queryHash, readRoots, readState, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, saveState, scoreReferences, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, ttlLabel };

package/dist/init/index.d.mts

@@ -0,0 +1,34 @@
+import { t as HarnessId } from "../harness-DwJskkz_.mjs";
+
+//#region src/init/templates.d.ts
+/**
+* Wiring file templates per harness, to register `harness hook <id>` as a
+* tool-use hook. Formats verified against each harness's 2026 hook docs.
+*/
+/** A file to write during `harness init`. */
+interface InitFile {
+  path: string;
+  content: string;
+  executable?: boolean;
+}
+/** Claude Code: PreToolUse(Write|Edit) -> command. Target: `.claude/settings.json`. */
+declare function claudeInit(command: string): InitFile;
+/** Codex CLI: `.codex/hooks.json` — PreToolUse (Claude-compatible shape). */
+declare function codexInit(command: string): InitFile;
+/** Cursor: `.cursor/hooks.json` (version 1) — shell + file-edit hooks. */
+declare function cursorInit(command: string): InitFile;
+/** Gemini CLI: `.gemini/settings.json` — BeforeTool, timeout in ms. */
+declare function geminiInit(command: string): InitFile;
+/** Cline: an executable `.clinerules/hooks/PreToolUse` that pipes stdin to the command. */
+declare function clineInit(command: string): InitFile;
+//#endregion
+//#region src/init/run.d.ts
+/**
+* Build the wiring file for a harness, or null when it has no hook integration
+* (cli-mode harnesses use `harness check` in a pre-commit step instead).
+*/
+declare function initFor(id: HarnessId, command?: string): InitFile | null;
+/** Write an {@link InitFile} under `root` (creates dirs; `chmod +x` when executable). */
+declare function writeInitFile(root: string, file: InitFile): string;
+//#endregion
+export { InitFile, claudeInit, clineInit, codexInit, cursorInit, geminiInit, initFor, writeInitFile };

package/dist/init/index.mjs

@@ -0,0 +1,2 @@
+import { a as codexInit, i as clineInit, n as writeInitFile, o as cursorInit, r as claudeInit, s as geminiInit, t as initFor } from "../run-Cc98348q.mjs";
+export { claudeInit, clineInit, codexInit, cursorInit, geminiInit, initFor, writeInitFile };

package/dist/memory/index.d.mts

@@ -1,30 +1,2 @@
-//#region src/memory/state.d.ts
-/** Per-project reminder throttle state, stored at `<root>/MEMORY/state.json`. */
-interface ReminderState {
-  lastRemindedAt: number;
-  lastCodeEditAt: number;
-}
-/** Absolute path of the per-project throttle state file. */
-declare function stateFileFor(root: string): string;
-/** Read both throttle timestamps; missing/corrupt fields default to 0. */
-declare function readState(file: string): ReminderState;
-/** Persist one field without clobbering the other (read-modify-write). */
-declare function setStateField(file: string, key: keyof ReminderState, value: number): void;
-/** Local wall-clock timestamp for a lesson bullet: `YYYY-MM-DD HH:MM`. */
-declare function nowStamp(): string;
-/** Throttle window (ms) from `FUSE_LESSONS_THROTTLE_MIN` (default 5 min). */
-declare function throttleMs(env?: Record<string, string | undefined>): number;
-//#endregion
-//#region src/memory/registry.d.ts
-/** Absolute path of the global roots registry, or null when home is unusable. */
-declare function registryFile(home?: string | undefined): string | null;
-/** Read the registered project roots (deduplicated string entries only). */
-declare function readRoots(home?: string): string[];
-/** Register a project root once (deduplicated, read-modify-write, non-throwing). */
-declare function addRoot(root: string, home?: string): void;
-//#endregion
-//#region src/memory/gitignore.d.ts
-/** Ensure `<memoryDir>/.gitignore` ignores the machine-local `state.json`. */
-declare function ensureMemoryGitignore(memoryDir: string): void;
-//#endregion
+import { a as ReminderState, c as setStateField, i as registryFile, l as stateFileFor, n as addRoot, o as nowStamp, r as readRoots, s as readState, t as ensureMemoryGitignore, u as throttleMs } from "../index-BEM-mQMC.mjs";
 export { ReminderState, addRoot, ensureMemoryGitignore, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };

package/dist/memory/index.mjs

@@ -1,94 +1,2 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
-//#region src/memory/gitignore.ts
-/** Ensure `<memoryDir>/.gitignore` ignores the machine-local `state.json`. */
-function ensureMemoryGitignore(memoryDir) {
-	const file = `${memoryDir}/.gitignore`;
-	try {
-		const existing = existsSync(file) ? readFileSync(file, "utf8") : "";
-		if (/^state\.json$/m.test(existing)) return;
-		writeFileSync(file, existing.trim() ? `${existing.trimEnd()}\nstate.json\n` : "state.json\n");
-	} catch {}
-}
-//#endregion
-//#region src/memory/state.ts
-/** Absolute path of the per-project throttle state file. */
-function stateFileFor(root) {
-	return `${root}/MEMORY/state.json`;
-}
-function num(v) {
-	return typeof v === "number" && Number.isFinite(v) ? v : 0;
-}
-/** Read both throttle timestamps; missing/corrupt fields default to 0. */
-function readState(file) {
-	try {
-		const parsed = JSON.parse(readFileSync(file, "utf8"));
-		return {
-			lastRemindedAt: num(parsed?.lastRemindedAt),
-			lastCodeEditAt: num(parsed?.lastCodeEditAt)
-		};
-	} catch {
-		return {
-			lastRemindedAt: 0,
-			lastCodeEditAt: 0
-		};
-	}
-}
-/** Persist one field without clobbering the other (read-modify-write). */
-function setStateField(file, key, value) {
-	const next = {
-		...readState(file),
-		[key]: value
-	};
-	const dir = dirname(file);
-	mkdirSync(dir, { recursive: true });
-	ensureMemoryGitignore(dir);
-	writeFileSync(file, JSON.stringify(next));
-}
-/** Local wall-clock timestamp for a lesson bullet: `YYYY-MM-DD HH:MM`. */
-function nowStamp() {
-	const d = /* @__PURE__ */ new Date();
-	const p = (n) => String(n).padStart(2, "0");
-	return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`;
-}
-/** Throttle window (ms) from `FUSE_LESSONS_THROTTLE_MIN` (default 5 min). */
-function throttleMs(env = process.env) {
-	const raw = env.FUSE_LESSONS_THROTTLE_MIN?.trim();
-	const min = raw ? Number(raw) : 5;
-	return (Number.isFinite(min) ? Math.max(0, min) : 5) * 6e4;
-}
-//#endregion
-//#region src/memory/registry.ts
-/** Registry path relative to the home dir. */
-const SUBPATH = ".claude/fusengine-cache/lessons/roots.json";
-/** Absolute path of the global roots registry, or null when home is unusable. */
-function registryFile(home = process.env.HOME) {
-	const h = home?.trim();
-	if (!h || !h.startsWith("/")) return null;
-	return `${h}/${SUBPATH}`;
-}
-/** Read the registered project roots (deduplicated string entries only). */
-function readRoots(home) {
-	const file = registryFile(home);
-	if (!file) return [];
-	try {
-		const parsed = JSON.parse(readFileSync(file, "utf8"));
-		return Array.isArray(parsed) ? parsed.filter((e) => typeof e === "string") : [];
-	} catch {
-		return [];
-	}
-}
-/** Register a project root once (deduplicated, read-modify-write, non-throwing). */
-function addRoot(root, home) {
-	const file = registryFile(home);
-	if (!file) return;
-	try {
-		const roots = new Set(readRoots(home));
-		if (roots.has(root)) return;
-		roots.add(root);
-		mkdirSync(dirname(file), { recursive: true });
-		writeFileSync(file, JSON.stringify([...roots]));
-	} catch {}
-}
-//#endregion
+import { a as readState, c as throttleMs, i as nowStamp, l as ensureMemoryGitignore, n as readRoots, o as setStateField, r as registryFile, s as stateFileFor, t as addRoot } from "../memory-BVNt4Ary.mjs";
 export { addRoot, ensureMemoryGitignore, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };