@fusengine/harness 0.1.27 → 0.1.29

package/dist/{index-DNAzITvw.d.mts → index-BqdCjaT9.d.mts}

@@ -9,6 +9,26 @@ type ProjectType = "nextjs" | "nuxt" | "angular" | "svelte" | "vue" | "react" |
 declare const DEV_KEYWORDS: RegExp;
 /** True when the prompt invokes the /apex command. */
 declare function isApexCommand(prompt: string): boolean;
+/** Modular architecture variants layered on top of the framework. */
+type ModularArchitecture = "fusecore" | "nextjs-modular" | null;
+/**
+* Detect a project-internal modular architecture (a sub-architecture the
+* framework-level {@link detectProjectType} doesn't capture): Fusengine's
+* FuseCore (Laravel) or a `modules/`-based Next.js layout.
+*/
+declare function detectModularArchitecture(dir: string): ModularArchitecture;
+/**
+* Resolve the skill a detected modular architecture forces.
+*
+* Ports the Python `check-nextjs-skill.py` / `check-laravel-skill.py` gates:
+* when the project is detected on disk as a modular architecture, a specific
+* skill is required ('solid-nextjs' for nextjs-modular, 'fusecore' for
+* fusecore). Returns `null` when no modular architecture is detected.
+*
+* @param cwd - Project root directory to scan.
+* @returns The forced skill name, or `null` when none applies.
+*/
+declare function requiredArchSkill(cwd: string): string | null;
 /** Detect the project type by scanning config files in `dir`. */
 declare function detectProjectType(dir: string): ProjectType;
 //#endregion
@@ -28,7 +48,12 @@ interface FileSizeVerdict {
   max: number;
   message: string | null;
 }
-/** Count lines in file content (empty string = 0). */
+/**
+* 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.)
+*/
 declare function countLines(content: string): number;
 /**
 * Evaluate a file's line count against the SOLID limit.
@@ -224,4 +249,48 @@ declare const MAX_TOKENS = 2e3;
 */
 declare function capVerbosity(tool: string, input: Record<string, unknown>): Record<string, unknown> | null;
 //#endregion
-export { ApexContext as A, GIT_ASK as B, protectedPathGuard as C, Guard as D, securityGuard as E, freshnessGate as F, FileSizeVerdict as G, PROJECT_INSTALL as H, solidReadGate as I, detectFramework as J, countLines as K, PolicyContext as L, brainstormGate as M, docConsultedGate as N, GuardContext as O, evaluateApex as P, isApexCommand as Q, PolicyResult as R, PROTECTED_FRAGMENTS as S, CRITICAL_PATTERNS as T, SYSTEM_INSTALL as U, GIT_BLOCKED as V, matchPatterns as W, ProjectType as X, DEV_KEYWORDS as Y, detectProjectType as Z, interfaceSeparationGuard as _, FAIL_CLOSED as a, CODE_REDIRECT as b, registerGuard as c, GO_DECL_RE as d, JAVA_DECL_RE as f, TS_DECL_RE as g, SWIFT_PROTO_RE as h, detectCreationIntent as i, ApexGate as j, APEX_GATES as k, runGuards as l, PY_MODEL_RE as m, MAX_TOKENS as n, GUARDS as o, PHP_DECL_RE as p, evaluateFileSize as q, capVerbosity as r, clearUserGuards as s, MAX_EXA_RESULTS as t, installGuard as u, ASK_WRITERS as v, ASK_PATTERNS as w, bashWriteGuard as x, CODE_MUTATORS as y, evaluate as z };
+//#region src/policy/framework-solid.d.ts
+/**
+* Framework-specific SOLID gate. Dispatches by extension/path to the matching
+* validator (React, Next.js, Laravel, Swift) and returns a blocking
+* {@link Prompt} when any BLOCKING rule fires, or `null` when clean. Excluded
+* build/dependency paths (node_modules, dist, build, .next, vendor, .build,
+* DerivedData, Pods) early-return `null` to avoid false positives.
+* @param filePath - absolute path of the file being written/edited
+* @param content - the file (or new) content under validation
+* @param fileLines - full on-disk line count (set on Edit so a partial
+*   `new_string` snippet still judges the whole file, mirroring the base
+*   file-size guard / Python `get_full_file_content`). Omit on Write.
+*/
+declare function frameworkSolidGate(filePath: string, content: string, fileLines?: number): Prompt | null;
+//#endregion
+//#region src/policy/skill-trigger-patterns.d.ts
+/** Map of required sub-skill name → triggering code patterns, keyed by framework. */
+declare const SKILL_TRIGGERS: Readonly<Record<string, Readonly<Record<string, ReadonlyArray<string>>>>>;
+//#endregion
+//#region src/policy/skill-triggers.d.ts
+/**
+* Detect which sub-skills the written `content` requires for a `framework`.
+* Faithful to the Python `detect_required_skills`: first matching pattern per
+* skill wins. Most frameworks match case-insensitively (source `re.IGNORECASE`);
+* `swift` matches case-sensitively (see {@link CASE_SENSITIVE_FRAMEWORKS}).
+* @param framework - "react" | "nextjs" | "laravel" | "swift".
+* @param content - the code being written.
+* @returns required sub-skill names (empty when framework unknown / no match).
+*/
+declare function detectRequiredSkills(framework: string, content: string): string[];
+/**
+* Block when a required sub-skill's `skills/<name>/` path is absent from
+* `refsRead`. Mirrors `specific_skill_consulted`, which confirms a skill was
+* read by checking the tracking file contains `skills/<name>/`.
+* @param framework - "react" | "nextjs" | "laravel".
+* @param content - the code being written.
+* @param refsRead - in-session read reference paths.
+* @param forcedSkill - a skill the detected modular architecture forces (optional).
+* @param cwd - project root; when set and not a shadcn project, `*-shadcn`
+*   requirements are skipped (ports the Python `is_shadcn_project` filter).
+* @returns a `block` Prompt naming the missing sub-skills, or `null` when satisfied.
+*/
+declare function skillTriggerGate(framework: string, content: string, refsRead: string[], forcedSkill?: string | null, cwd?: string): Prompt | null;
+//#endregion
+export { DEV_KEYWORDS as $, securityGuard as A, solidReadGate as B, CODE_MUTATORS as C, protectedPathGuard as D, PROTECTED_FRAGMENTS as E, ApexGate as F, GIT_BLOCKED as G, PolicyResult as H, brainstormGate as I, matchPatterns as J, PROJECT_INSTALL as K, docConsultedGate as L, GuardContext as M, APEX_GATES as N, ASK_PATTERNS as O, ApexContext as P, detectFramework as Q, evaluateApex as R, ASK_WRITERS as S, bashWriteGuard as T, evaluate as U, PolicyContext as V, GIT_ASK as W, countLines as X, FileSizeVerdict as Y, evaluateFileSize as Z, PHP_DECL_RE as _, MAX_EXA_RESULTS as a, requiredArchSkill as at, TS_DECL_RE as b, detectCreationIntent as c, clearUserGuards as d, ModularArchitecture as et, registerGuard as f, JAVA_DECL_RE as g, GO_DECL_RE as h, frameworkSolidGate as i, isApexCommand as it, Guard as j, CRITICAL_PATTERNS as k, FAIL_CLOSED as l, installGuard as m, skillTriggerGate as n, detectModularArchitecture as nt, MAX_TOKENS as o, runGuards as p, SYSTEM_INSTALL as q, SKILL_TRIGGERS as r, detectProjectType as rt, capVerbosity as s, detectRequiredSkills as t, ProjectType as tt, GUARDS as u, PY_MODEL_RE as v, CODE_REDIRECT as w, interfaceSeparationGuard as x, SWIFT_PROTO_RE as y, freshnessGate as z };

package/dist/index.d.mts

@@ -5,10 +5,10 @@ import { a as detectHarness, i as HarnessVia, n as HarnessInfo, o as detectMode,
 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 { 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 { A as ApexContext, B as GIT_ASK, C as protectedPathGuard, D as Guard, E as securityGuard, F as freshnessGate, G as FileSizeVerdict, H as PROJECT_INSTALL, I as solidReadGate, J as detectFramework, K as countLines, L as PolicyContext, M as brainstormGate, N as docConsultedGate, O as GuardContext, P as evaluateApex, Q as isApexCommand, R as PolicyResult, S as PROTECTED_FRAGMENTS, T as CRITICAL_PATTERNS, U as SYSTEM_INSTALL, V as GIT_BLOCKED, W as matchPatterns, X as ProjectType, Y as DEV_KEYWORDS, Z as detectProjectType, _ as interfaceSeparationGuard, a as FAIL_CLOSED, b as CODE_REDIRECT, c as registerGuard, d as GO_DECL_RE, f as JAVA_DECL_RE, g as TS_DECL_RE, h as SWIFT_PROTO_RE, i as detectCreationIntent, j as ApexGate, k as APEX_GATES, l as runGuards, m as PY_MODEL_RE, n as MAX_TOKENS, o as GUARDS, p as PHP_DECL_RE, q as evaluateFileSize, r as capVerbosity, s as clearUserGuards, t as MAX_EXA_RESULTS, u as installGuard, v as ASK_WRITERS, w as ASK_PATTERNS, x as bashWriteGuard, y as CODE_MUTATORS, z as evaluate } from "./index-DNAzITvw.mjs";
+import { $ as DEV_KEYWORDS, A as securityGuard, B as solidReadGate, C as CODE_MUTATORS, D as protectedPathGuard, E as PROTECTED_FRAGMENTS, F as ApexGate, G as GIT_BLOCKED, H as PolicyResult, I as brainstormGate, J as matchPatterns, K as PROJECT_INSTALL, L as docConsultedGate, M as GuardContext, N as APEX_GATES, O as ASK_PATTERNS, P as ApexContext, Q as detectFramework, R as evaluateApex, S as ASK_WRITERS, T as bashWriteGuard, U as evaluate, V as PolicyContext, W as GIT_ASK, X as countLines, Y as FileSizeVerdict, Z as evaluateFileSize, _ as PHP_DECL_RE, a as MAX_EXA_RESULTS, at as requiredArchSkill, b as TS_DECL_RE, c as detectCreationIntent, d as clearUserGuards, et as ModularArchitecture, f as registerGuard, g as JAVA_DECL_RE, h as GO_DECL_RE, i as frameworkSolidGate, it as isApexCommand, j as Guard, k as CRITICAL_PATTERNS, l as FAIL_CLOSED, m as installGuard, n as skillTriggerGate, nt as detectModularArchitecture, o as MAX_TOKENS, p as runGuards, q as SYSTEM_INSTALL, r as SKILL_TRIGGERS, rt as detectProjectType, s as capVerbosity, t as detectRequiredSkills, tt as ProjectType, u as GUARDS, v as PY_MODEL_RE, w as CODE_REDIRECT, x as interfaceSeparationGuard, y as SWIFT_PROTO_RE, z as freshnessGate } from "./index-BqdCjaT9.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 { _ 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, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, 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, PHP_DECL_RE, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, Palette, PolicyContext, PolicyResult, ProgressBarOptions, ProjectLayout, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, cacheLookup, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, lessonsFileFor, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectLayout, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registerGuard, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexState, ApexTask, ApexTaskFile, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, ColorFn, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, DocSatisfactionStatus, 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_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, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, cacheLookup, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, frameworkSolidGate, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, lessonsFileFor, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, 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 };

package/dist/index.mjs

@@ -4,11 +4,10 @@ import { n as STATE_ROOT, r as projectLayout, t as STATE_GITIGNORE } from "./lay
 import { t as compactJson } from "./compact-json-DK2nX-MK.mjs";
 import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-ff0_poWU.mjs";
 import { n as detectMode, r as modeFor, t as detectHarness } from "./harness-C8Nxxyn_.mjs";
-import { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "./policy-EuVJ_5hS.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-BIK60lOR.mjs";
+import { _ as detectProjectType, a as MAX_EXA_RESULTS, c as detectCreationIntent, d as docConsultedGate, f as evaluateApex, g as detectModularArchitecture, h as DEV_KEYWORDS, i as frameworkSolidGate, l as APEX_GATES, m as solidReadGate, n as skillTriggerGate, o as MAX_TOKENS, p as freshnessGate, r as SKILL_TRIGGERS, s as capVerbosity, t as detectRequiredSkills, u as brainstormGate, v as isApexCommand, y as requiredArchSkill } from "./skill-triggers-BZxov1es.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-j3gRJ_ng.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 APEX_GATES, c as evaluateApex, i as detectCreationIntent, l as freshnessGate, n as MAX_TOKENS, o as brainstormGate, r as capVerbosity, s as docConsultedGate, t as MAX_EXA_RESULTS, u as solidReadGate } from "./verbosity-CXpf3aQQ.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 "./memory-BkoEbdec.mjs";
 import { a as queryHash, i as jaccardSimilar, n as summarizeIndex, r as compactMarkdown, t as loadIndex } from "./cache-BzbX-ztL.mjs";
@@ -17,4 +16,4 @@ import { t as incrementTrivialEditCounter } from "./freshness-CezohJHo.mjs";
 import { n as toRefMeta, t as loadRefs } from "./loader-CyAoJv2W.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-Cs0Y0MG_.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, 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_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, acquireLock, addRoot, apexStateDir, bashWriteGuard, brainstormGate, cacheLookup, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectProjectType, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, lessonsFileFor, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, parseFrontmatter, progressiveColor, projectLayout, projectRoot, projectRootOrNull, protectedPathGuard, queryHash, readRoots, readState, registerGuard, registryFile, resolveMaxLines, resolveSessions, resolveTtlSec, routeReferences, runGuards, saveState, scoreReferences, securityGuard, setStateField, solidReadGate, splitTarget, stateFileFor, stateFilePath, summarizeIndex, taskComplete, taskCreate, taskStart, throttleMs, toRefMeta, ttlLabel };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, DEFAULT_MAX_LINES, DEFAULT_TTL_SEC, DEV_KEYWORDS, 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_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, cacheLookup, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countLines, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, ensureStateDir, evaluate, evaluateApex, evaluateFileSize, extractText, formatBasename, formatCost, formatDocDeny, formatDocSatisfactionStatus, formatPath, formatPrompt, formatTimeLeft, formatTokens, frameworkSolidGate, freshnessGate, generateGradientBar, generateProgressBar, globToRe, incrementTrivialEditCounter, installGuard, interfaceSeparationGuard, isApexCommand, isCodeFile, isDocConsulted, jaccardSimilar, lessonsFileFor, loadIndex, loadRefs, loadState, matchPatterns, mcpCacheKey, modeFor, nowStamp, parseEnvInt, 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 };

package/dist/policy/index.d.mts

@@ -1,2 +1,2 @@
-import { A as ApexContext, B as GIT_ASK, C as protectedPathGuard, D as Guard, E as securityGuard, F as freshnessGate, G as FileSizeVerdict, H as PROJECT_INSTALL, I as solidReadGate, J as detectFramework, K as countLines, L as PolicyContext, M as brainstormGate, N as docConsultedGate, O as GuardContext, P as evaluateApex, Q as isApexCommand, R as PolicyResult, S as PROTECTED_FRAGMENTS, T as CRITICAL_PATTERNS, U as SYSTEM_INSTALL, V as GIT_BLOCKED, W as matchPatterns, X as ProjectType, Y as DEV_KEYWORDS, Z as detectProjectType, _ as interfaceSeparationGuard, a as FAIL_CLOSED, b as CODE_REDIRECT, c as registerGuard, d as GO_DECL_RE, f as JAVA_DECL_RE, g as TS_DECL_RE, h as SWIFT_PROTO_RE, i as detectCreationIntent, j as ApexGate, k as APEX_GATES, l as runGuards, m as PY_MODEL_RE, n as MAX_TOKENS, o as GUARDS, p as PHP_DECL_RE, q as evaluateFileSize, r as capVerbosity, s as clearUserGuards, t as MAX_EXA_RESULTS, u as installGuard, v as ASK_WRITERS, w as ASK_PATTERNS, x as bashWriteGuard, y as CODE_MUTATORS, z as evaluate } from "../index-DNAzITvw.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, FAIL_CLOSED, FileSizeVerdict, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, Guard, GuardContext, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, PHP_DECL_RE, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, PolicyContext, PolicyResult, ProjectType, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, capVerbosity, clearUserGuards, countLines, detectCreationIntent, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, registerGuard, runGuards, securityGuard, solidReadGate };
+import { $ as DEV_KEYWORDS, A as securityGuard, B as solidReadGate, C as CODE_MUTATORS, D as protectedPathGuard, E as PROTECTED_FRAGMENTS, F as ApexGate, G as GIT_BLOCKED, H as PolicyResult, I as brainstormGate, J as matchPatterns, K as PROJECT_INSTALL, L as docConsultedGate, M as GuardContext, N as APEX_GATES, O as ASK_PATTERNS, P as ApexContext, Q as detectFramework, R as evaluateApex, S as ASK_WRITERS, T as bashWriteGuard, U as evaluate, V as PolicyContext, W as GIT_ASK, X as countLines, Y as FileSizeVerdict, Z as evaluateFileSize, _ as PHP_DECL_RE, a as MAX_EXA_RESULTS, at as requiredArchSkill, b as TS_DECL_RE, c as detectCreationIntent, d as clearUserGuards, et as ModularArchitecture, f as registerGuard, g as JAVA_DECL_RE, h as GO_DECL_RE, i as frameworkSolidGate, it as isApexCommand, j as Guard, k as CRITICAL_PATTERNS, l as FAIL_CLOSED, m as installGuard, n as skillTriggerGate, nt as detectModularArchitecture, o as MAX_TOKENS, p as runGuards, q as SYSTEM_INSTALL, r as SKILL_TRIGGERS, rt as detectProjectType, s as capVerbosity, t as detectRequiredSkills, tt as ProjectType, u as GUARDS, v as PY_MODEL_RE, w as CODE_REDIRECT, x as interfaceSeparationGuard, y as SWIFT_PROTO_RE, z as freshnessGate } from "../index-BqdCjaT9.mjs";
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, 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_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, PolicyContext, PolicyResult, ProjectType, SKILL_TRIGGERS, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, capVerbosity, clearUserGuards, countLines, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate };

package/dist/policy/index.mjs

@@ -1,4 +1,4 @@
-import { n as detectProjectType, r as isApexCommand, t as DEV_KEYWORDS } from "../policy-EuVJ_5hS.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-BIK60lOR.mjs";
-import { a as APEX_GATES, c as evaluateApex, i as detectCreationIntent, l as freshnessGate, n as MAX_TOKENS, o as brainstormGate, r as capVerbosity, s as docConsultedGate, t as MAX_EXA_RESULTS, u as solidReadGate } from "../verbosity-CXpf3aQQ.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, FAIL_CLOSED, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, PHP_DECL_RE, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, capVerbosity, clearUserGuards, countLines, detectCreationIntent, detectFramework, detectProjectType, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, registerGuard, runGuards, securityGuard, solidReadGate };
+import { _ as detectProjectType, a as MAX_EXA_RESULTS, c as detectCreationIntent, d as docConsultedGate, f as evaluateApex, g as detectModularArchitecture, h as DEV_KEYWORDS, i as frameworkSolidGate, l as APEX_GATES, m as solidReadGate, n as skillTriggerGate, o as MAX_TOKENS, p as freshnessGate, r as SKILL_TRIGGERS, s as capVerbosity, t as detectRequiredSkills, u as brainstormGate, v as isApexCommand, y as requiredArchSkill } from "../skill-triggers-BZxov1es.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-j3gRJ_ng.mjs";
+import "../policy-la_KkjCS.mjs";
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, FAIL_CLOSED, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, PHP_DECL_RE, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PY_MODEL_RE, SKILL_TRIGGERS, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, capVerbosity, clearUserGuards, countLines, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, matchPatterns, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate };

package/dist/policy-la_KkjCS.mjs

@@ -0,0 +1 @@
+export {};

package/dist/{run-BdcSLer0.mjs → run-CXsV-wIJ.mjs}

@@ -1,5 +1,5 @@
 import { t as isCodeFile } from "./project-root-ff0_poWU.mjs";
-import { t as evaluate } from "./evaluate-BIK60lOR.mjs";
+import { t as evaluate } from "./evaluate-j3gRJ_ng.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { execSync } from "node:child_process";
 //#region src/cli/run.ts

package/dist/runtime/index.d.mts

@@ -53,13 +53,7 @@ interface ToolEvent {
 */
 declare function activityFor(event: ToolEvent): Activity | null;
 //#endregion
-//#region src/runtime/gate.d.ts
-/** Prior agents the freshness gate requires before a code edit. */
-declare const REQUIRED_AGENTS: ReadonlyArray<string>;
-/** Default freshness window for {@link REQUIRED_AGENTS} (2 min — matches the plugin's `FUSE_ENFORCE_TTL_SEC` default). */
-declare const DEFAULT_WINDOW_MS = 12e4;
-/** Trivial edits allowed within the window before the full APEX gates apply. */
-declare const TRIVIAL_BUDGET = 4;
+//#region src/runtime/gate-input.d.ts
 /** A tool-use to gate, plus the session pointers needed for the stateful gates. */
 interface GateInput {
   sessionId: string;
@@ -68,6 +62,7 @@ interface GateInput {
   filePath?: string;
   content?: string;
   command?: string;
+  cwd?: string;
   refs?: RefMeta[];
   now: number;
   trackFile: string;
@@ -75,6 +70,14 @@ interface GateInput {
   isReplaceAll?: boolean;
   agentType?: string;
 }
+//#endregion
+//#region src/runtime/gate.d.ts
+/** Prior agents the freshness gate requires before a code edit. */
+declare const REQUIRED_AGENTS: ReadonlyArray<string>;
+/** Default freshness window for {@link REQUIRED_AGENTS} (2 min — matches the plugin's `FUSE_ENFORCE_TTL_SEC` default). */
+declare const DEFAULT_WINDOW_MS = 12e4;
+/** Trivial edits allowed within the window before the full APEX gates apply. */
+declare const TRIVIAL_BUDGET = 4;
 /**
 * Full gate: the stateless guards (file-size, git, security...) first, then a
 * trivial-edit fast path, then the stateful APEX gates fed from the session
@@ -82,6 +85,28 @@ interface GateInput {
 */
 declare function gate(input: GateInput): Promise<Prompt | null>;
 //#endregion
+//#region src/runtime/dry.d.ts
+/** Extract long (>12 char) declared symbol names from new file content. */
+declare function extractSymbols(content: string, ext: string): string[];
+/** Verdict from {@link detectDuplication}. */
+interface DuplicationVerdict {
+  names: string[];
+  duplicates: string[];
+}
+/**
+* Grep the codebase for existing declarations of the symbols a write introduces,
+* honoring module boundaries (cross-`modules/` matches are ignored). Effectful:
+* shells out to `grep`. Fails open (returns no duplicates) on any grep error,
+* timeout, or no-match — matching the original Python hook.
+*/
+declare function detectDuplication(filePath: string, content: string, cwd: string): DuplicationVerdict;
+/** Blocking prompt when a Write/Edit re-declares 2+ existing symbols, else null. */
+declare function dryGate(tool: string, filePath: string, content: string | undefined, cwd: string | undefined): Prompt | null;
+//#endregion
+//#region src/runtime/precommit.d.ts
+/** Block a `git commit` when linters fail (effectful: runs eslint/tsc/prettier/ruff, never auto-fixes). */
+declare function preCommitGate(tool: string, command: string | undefined, cwd: string | undefined): Prompt | null;
+//#endregion
 //#region src/runtime/normalize.d.ts
 /** A hook event normalized across harnesses. */
 interface NormalizedEvent {
@@ -154,4 +179,4 @@ interface HandleOutcome {
 */
 declare function handleHook(id: string, payload: Record<string, unknown>, opts: HandleOptions): Promise<HandleOutcome>;
 //#endregion
-export { Activity, DEFAULT_WINDOW_MS, GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, McpIntercept, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };
+export { Activity, DEFAULT_WINDOW_MS, DuplicationVerdict, type GateInput, HandleOptions, HandleOutcome, MCP_TTL_MS, McpIntercept, NormalizedEvent, REQUIRED_AGENTS, TRIVIAL_BUDGET, ToolEvent, activityFor, detectDuplication, dryGate, extractSymbols, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, preCommitGate, queryOf, recordActivity, respond, trackFile };

package/dist/runtime/index.mjs

@@ -1,5 +1,5 @@
 import { r as projectLayout } from "../layout-C0jaaCQC.mjs";
-import { a as normalizeEvent, c as mcpPostStore, d as DEFAULT_WINDOW_MS, f as REQUIRED_AGENTS, h as activityFor, i as trackFile, l as mcpPreIntercept, m as gate, n as respond, o as MCP_TTL_MS, p as TRIVIAL_BUDGET, r as recordActivity, s as isMcpTool, t as handleHook, u as queryOf } from "../handle-BJ2xdeA-.mjs";
+import { _ as dryGate, a as normalizeEvent, c as mcpPostStore, d as DEFAULT_WINDOW_MS, f as REQUIRED_AGENTS, g as detectDuplication, h as preCommitGate, i as trackFile, l as mcpPreIntercept, m as gate, n as respond, o as MCP_TTL_MS, p as TRIVIAL_BUDGET, r as recordActivity, s as isMcpTool, t as handleHook, u as queryOf, v as extractSymbols, y as activityFor } from "../handle-nu3GYVek.mjs";
 //#region src/runtime/storage.ts
 /**
 * The project's single state dir (`<root>/.harness`) — neutral + harness-agnostic,
@@ -9,4 +9,4 @@ function harnessStateDir(root) {
 	return projectLayout(root).stateDir;
 }
 //#endregion
-export { DEFAULT_WINDOW_MS, MCP_TTL_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, queryOf, recordActivity, respond, trackFile };
+export { DEFAULT_WINDOW_MS, MCP_TTL_MS, REQUIRED_AGENTS, TRIVIAL_BUDGET, activityFor, detectDuplication, dryGate, extractSymbols, gate, handleHook, harnessStateDir, isMcpTool, mcpPostStore, mcpPreIntercept, normalizeEvent, preCommitGate, queryOf, recordActivity, respond, trackFile };