@fusengine/harness 0.1.46 → 0.1.48

package/README.md

@@ -116,6 +116,8 @@ Ten portable guards + the APEX gate chain, all evaluated before a tool runs:
 | APEX freshness | `explore-codebase` + `research-expert` not run within the window |
 | APEX doc-consulted | no doc source (Context7 / Exa / fuse-browser / WebSearch / WebFetch) consulted this session |
 | APEX solid-read | required SOLID refs (auto-discovered, or `FUSE_HARNESS_REFS`) not read |
+| framework sub-skill | framework / shadcn / Tailwind code whose required skill (`skills/<name>/`) wasn't read this session |
+| Gemini MCP (opt-in) | hand-written Tailwind UI without a `mcp__gemini-design__*` call — only when `FUSE_ENFORCE_GEMINI_MCP` is set |
 | brainstorm | creating a new file without brainstorming (when flagged) |
 | MCP verbosity / cache | caps exa `numResults`; serves a fresh cached MCP/WebFetch result |
 
@@ -131,6 +133,8 @@ through per window without the full APEX gates.
 | `FUSE_HARNESS_MARKETPLACES` | Comma-list of marketplace names whose `solid-*` skill refs are auto-discovered when `FUSE_HARNESS_REFS` is unset (default `fusengine-plugins`; an absent marketplace contributes nothing). Standalone `.claude`/`.codex`/`.cursor`/`.agents` skills are always scanned. |
 | `FUSE_ENFORCE_TTL_SEC` | APEX freshness window in seconds. |
 | `FUSE_LESSONS_THROTTLE_MIN` | Lessons-injection throttle (memory module). |
+| `FUSE_ENFORCE_GEMINI_MCP` | **Opt-in (default off).** `1`/`true` blocks hand-written Tailwind UI (`.tsx/.jsx/.vue/.svelte`, ≥3 utility classes) until a `mcp__gemini-design__*` call is made this session. Read fresh per call. |
+| `RALPH_MODE` | **Opt-in (default off).** `1`/`true` enables autonomous "Ralph" mode: exempts the safe git commands (`add`/`commit`/`checkout -b`/`status`/`diff`/`log`) from the confirmation ASK and auto-approves project installs. Destructive git (force-push, `reset --hard`) and system installs still gate. |
 
 ## Library usage
 

package/dist/adapters/claude/index.mjs

@@ -1,2 +1,2 @@
-import { a as guard, c as toClaudeResponse, i as fileSizeGuard, n as contextResponse, o as readClaudeInput, r as denyResponse, s as systemMessage, t as blockResponse } from "../../claude-DLh0fHWM.mjs";
+import { a as guard, c as toClaudeResponse, i as fileSizeGuard, n as contextResponse, o as readClaudeInput, r as denyResponse, s as systemMessage, t as blockResponse } from "../../claude-U1KTaRG4.mjs";
 export { blockResponse, contextResponse, denyResponse, fileSizeGuard, guard, readClaudeInput, systemMessage, toClaudeResponse };

package/dist/adapters/cline/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-d7Pp8XJH.mjs";
+import { t as evaluate } from "../../evaluate-qYC5xClb.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/cline/index.ts
 /**

package/dist/adapters/codex/index.mjs

@@ -1,2 +1,2 @@
-import { a as guard, n as contextResponse, o as readClaudeInput, r as denyResponse } from "../../claude-DLh0fHWM.mjs";
+import { a as guard, n as contextResponse, o as readClaudeInput, r as denyResponse } from "../../claude-U1KTaRG4.mjs";
 export { contextResponse, denyResponse, guard, readClaudeInput as readCodexInput };

package/dist/adapters/cursor/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-d7Pp8XJH.mjs";
+import { t as evaluate } from "../../evaluate-qYC5xClb.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/cursor/index.ts
 /**

package/dist/adapters/gemini/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-d7Pp8XJH.mjs";
+import { t as evaluate } from "../../evaluate-qYC5xClb.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/gemini/index.ts
 /**

package/dist/{claude-DLh0fHWM.mjs → claude-U1KTaRG4.mjs}

@@ -1,4 +1,4 @@
-import { t as evaluate } from "./evaluate-d7Pp8XJH.mjs";
+import { t as evaluate } from "./evaluate-qYC5xClb.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";

package/dist/cli/bin.mjs

@@ -2,9 +2,9 @@
 import { r as loadDotenv, s as resolveTtlSec } from "../dotenv-B9nM4cuQ.mjs";
 import { t as detectHarness } from "../harness-C8Nxxyn_.mjs";
 import { t as claudeHome } from "../home-state-mKZxP4oZ.mjs";
-import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-DLXtA5DH.mjs";
+import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-CaqeQFYp.mjs";
 import { n as writeInitFile, t as initFor } from "../run-Do2JltgU.mjs";
-import { Mt as todayUtc, t as handleHook } from "../handle-vK4kMxfE.mjs";
+import { Mt as todayUtc, t as handleHook } from "../handle-CCV0ycdr.mjs";
 import { delimiter, dirname, join } from "node:path";
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

package/dist/cli/index.mjs

@@ -1,2 +1,2 @@
-import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-DLXtA5DH.mjs";
+import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-CaqeQFYp.mjs";
 export { checkStaged, stagedContent, stagedFiles };

package/dist/{evaluate-d7Pp8XJH.mjs → evaluate-qYC5xClb.mjs}

@@ -147,6 +147,27 @@ const PROJECT_INSTALL = [
 function matchPatterns(cmd, patterns) {
 	return patterns.some((re) => re.test(cmd));
 }
+/** Git commands exempt from confirmation when Ralph mode is on (parity git-guard.py RALPH_SAFE). */
+const RALPH_SAFE = [
+	"git add",
+	"git commit",
+	"git checkout -b",
+	"git branch --show-current",
+	"git status",
+	"git diff",
+	"git log"
+];
+/**
+* OPT-IN autonomous "Ralph" mode: OFF unless `RALPH_MODE` is `1`/`true`, read
+* fresh on each call. Only the env var activates it — the Python source also
+* auto-enabled on a `.claude/ralph/prd.json` file or a `feature/*` branch, but
+* those silent activations are dropped here: a mode that removes git/install
+* confirmations must never turn on implicitly (owner: default OFF, env opt-in).
+*/
+function isRalphMode() {
+	const v = process.env.RALPH_MODE;
+	return v === "1" || v === "true";
+}
 //#endregion
 //#region src/policy/file-size-scope.ts
 /**
@@ -302,23 +323,32 @@ function stripHeredoc(cmd) {
 	}
 	return out;
 }
-/** Guards against dangerous Bash commands (critical → block, sensitive → ask). */
+/**
+* Guards against dangerous Bash commands. Parity `security_rules.validate_command`
+* + `security-guard.py`: ACCUMULATE every matched violation, then deny when any
+* critical matched else ask, joining all violation labels in the reason. The
+* generic `rm` ask is exempt when the command targets a trash location (parity
+* `not re.search('trash', cmd)`).
+*/
 function securityGuard(ctx) {
 	if (ctx.tool !== "Bash" || !ctx.command) return null;
 	const cmd = stripHeredoc(ctx.command);
-	for (const { re, label } of CRITICAL_PATTERNS) if (re.test(cmd)) return {
+	const hasTrash = /trash/i.test(cmd);
+	const critical = CRITICAL_PATTERNS.filter(({ re }) => re.test(cmd)).map((p) => p.label);
+	const ask = ASK_PATTERNS.filter(({ re, label }) => re.test(cmd) && !(hasTrash && label.startsWith("DELETE: 'rm'"))).map((p) => p.label);
+	if (critical.length === 0 && ask.length === 0) return null;
+	if (critical.length > 0) return {
 		kind: "block",
 		title: "Dangerous command",
-		reason: `${label}.`,
+		reason: `${[...critical, ...ask].join(", ")}.`,
 		actions: ["Remove the destructive command", "Scope the operation to a specific safe path"]
 	};
-	for (const { re, label } of ASK_PATTERNS) if (re.test(cmd)) return {
+	return {
 		kind: "ask",
 		title: "Dangerous command",
-		reason: `${label}.`,
+		reason: `${ask.join(", ")}.`,
 		actions: ["Confirm this command is intended", "Run with least privilege"]
 	};
-	return null;
 }
 //#endregion
 //#region src/policy/guards/protected-path.ts
@@ -611,7 +641,7 @@ function bashWriteGuard(ctx) {
 /** TS/JS component files: top-level `interface`/`type Foo`. */
 const TS_DECL_RE = /^\s*(export\s+)?(interface|type)\s+[A-Z]/m;
 /** Python view models: class subclassing a schema/protocol base. */
-const PY_MODEL_RE = /^\s*class\s+\w+\((BaseModel|TypedDict|Protocol)\)/m;
+const PY_MODEL_RE = /^\s*class\s+\w+\s*\([^)]*\b(?:BaseModel|TypedDict|Protocol)\b/m;
 /**
 * PHP controllers: top-level `interface`, `abstract class`, or a concrete
 * `class …Interface/DTO/Request`. Union of the TS-only `abstract class` rule
@@ -662,16 +692,23 @@ function interfaceSeparationGuard(ctx) {
 }
 //#endregion
 //#region src/policy/guards/install.ts
-/** Asks for confirmation before a dependency or system package install. */
+/**
+* Asks for confirmation before a dependency or system package install. In Ralph
+* mode (opt-in `RALPH_MODE`) a PROJECT install is auto-approved for autonomous
+* runs (parity install-guard.py:52), but a SYSTEM install always asks.
+*/
 function installGuard(ctx) {
 	if (ctx.tool !== "Bash" || !ctx.command) return null;
-	if (matchPatterns(ctx.command, PROJECT_INSTALL) || matchPatterns(ctx.command, SYSTEM_INSTALL)) return {
+	const isSystem = matchPatterns(ctx.command, SYSTEM_INSTALL);
+	const isProject = matchPatterns(ctx.command, PROJECT_INSTALL);
+	if (!isSystem && !isProject) return null;
+	if (!isSystem && isProject && isRalphMode()) return null;
+	return {
 		kind: "ask",
 		title: "Dependency install",
 		reason: `This command installs packages: ${ctx.command.trim()}`,
 		actions: ["Confirm this install is intended"]
 	};
-	return null;
 }
 //#endregion
 //#region src/policy/guards/index.ts
@@ -730,7 +767,9 @@ function evaluate(ctx) {
 		message: guard.reason,
 		prompt: guard
 	};
-	if (ctx.command && matchPatterns(ctx.command, GIT_BLOCKED)) {
+	const cmd = ctx.command;
+	const ralphSafe = !!cmd && isRalphMode() && RALPH_SAFE.some((s) => cmd.startsWith(s));
+	if (!ralphSafe && ctx.command && matchPatterns(ctx.command, GIT_BLOCKED)) {
 		const reason = `Destructive git command: ${ctx.command}`;
 		return {
 			decision: "deny",
@@ -743,7 +782,7 @@ function evaluate(ctx) {
 			}
 		};
 	}
-	if (ctx.command && matchPatterns(ctx.command, GIT_ASK)) return {
+	if (!ralphSafe && ctx.command && matchPatterns(ctx.command, GIT_ASK)) return {
 		decision: "deny",
 		message: `Git operation requires confirmation: ${ctx.command}`,
 		prompt: {
@@ -781,4 +820,4 @@ function evaluate(ctx) {
 	};
 }
 //#endregion
-export { PROJECT_INSTALL as A, PROTECTED_GIT_RE as C, securityGuard as D, CRITICAL_PATTERNS as E, countFrameworkCodeLines as F, countLines as I, evaluateFileSize as L, matchPatterns as M, PLUGINS_DIR as N, GIT_ASK as O, SOLID_REF as P, PROTECTED_FRAGMENTS as S, ASK_PATTERNS as T, CODE_MUTATORS as _, registerGuard as a, SAFE_PREFIXES as b, GO_DECL_RE as c, PY_MODEL_RE as d, SWIFT_PROTO_RE as f, ASK_WRITERS as g, bashWriteGuard as h, clearUserGuards as i, SYSTEM_INSTALL as j, GIT_BLOCKED as k, JAVA_DECL_RE as l, interfaceSeparationGuard as m, FAIL_CLOSED as n, runGuards as o, TS_DECL_RE as p, GUARDS as r, installGuard as s, evaluate as t, PHP_DECL_RE as u, CODE_REDIRECT as v, protectedPathGuard as w, SESSION_STATE_FRAGMENT as x, FILE_REDIRECT as y };
+export { PROJECT_INSTALL as A, PROTECTED_GIT_RE as C, securityGuard as D, CRITICAL_PATTERNS as E, PLUGINS_DIR as F, SOLID_REF as I, countFrameworkCodeLines as L, SYSTEM_INSTALL as M, isRalphMode as N, GIT_ASK as O, matchPatterns as P, countLines as R, PROTECTED_FRAGMENTS as S, ASK_PATTERNS as T, CODE_MUTATORS as _, registerGuard as a, SAFE_PREFIXES as b, GO_DECL_RE as c, PY_MODEL_RE as d, SWIFT_PROTO_RE as f, ASK_WRITERS as g, bashWriteGuard as h, clearUserGuards as i, RALPH_SAFE as j, GIT_BLOCKED as k, JAVA_DECL_RE as l, interfaceSeparationGuard as m, FAIL_CLOSED as n, runGuards as o, TS_DECL_RE as p, GUARDS as r, installGuard as s, evaluate as t, PHP_DECL_RE as u, CODE_REDIRECT as v, protectedPathGuard as w, SESSION_STATE_FRAGMENT as x, FILE_REDIRECT as y, evaluateFileSize as z };

package/dist/{handle-vK4kMxfE.mjs → handle-CCV0ycdr.mjs}

@@ -1,8 +1,8 @@
 import { a as parseEnvInt, i as splitTarget, r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
 import { r as projectLayout } from "./layout-C0jaaCQC.mjs";
 import { i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-3kk7gCOp.mjs";
-import { A as detectCreationIntent, B as detectProjectType$1, C as findMarketplacePlugins, E as frameworkSolidGate, H as requiredArchSkill, L as detectFramework, N as docConsultedGate, P as evaluateApex, _ as scanPlugin, c as EXCLUDE_DIRS$1, d as buildApexTaskInjection, h as buildClaudeMdContext, k as capVerbosity, l as PROJECT_INDICATORS, n as missingSeoElements, o as parseEnrichment, r as descFromText, s as parseEntry, t as isHtmlLike, w as readPluginMeta, x as skillTriggerGate, y as parseField, z as detectModularArchitecture } from "./validate-CjFtMZz0.mjs";
-import { F as countFrameworkCodeLines, I as countLines, N as PLUGINS_DIR, n as FAIL_CLOSED, t as evaluate } from "./evaluate-d7Pp8XJH.mjs";
+import { B as detectFramework, C as resolveSkillPath, D as frameworkSolidGate, G as requiredArchSkill, H as detectModularArchitecture, I as docConsultedGate, L as evaluateApex, M as capVerbosity, N as detectCreationIntent, O as isExcludedJsPath, S as usesTailwindUtilities, T as readPluginMeta, U as detectProjectType$1, _ as scanPlugin, c as EXCLUDE_DIRS$1, d as buildApexTaskInjection, h as buildClaudeMdContext, k as isExcludedSwiftPath, l as PROJECT_INDICATORS, n as missingSeoElements, o as parseEnrichment, r as descFromText, s as parseEntry, t as isHtmlLike, w as findMarketplacePlugins, x as skillTriggerGate, y as parseField } from "./validate-ebDjIyOa.mjs";
+import { F as PLUGINS_DIR, L as countFrameworkCodeLines, R as countLines, n as FAIL_CLOSED, t as evaluate } from "./evaluate-qYC5xClb.mjs";
 import { a as writeJsonFile, i as readJsonFile, r as hashText, t as atomicWrite } from "./json-io-DisYd2fb.mjs";
 import { a as sanitizeSessionId, c as sessionsDir, i as loadSessionState, n as fuseHarnessHome, o as saveSessionState, r as fusengineCache, t as claudeHome } from "./home-state-mKZxP4oZ.mjs";
 import { r as isDocConsulted } from "./doc-helpers-CWZegVdR.mjs";
@@ -10,8 +10,8 @@ import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
 import { a as nowStamp, l as throttleMs, n as readRoots, o as readState, s as setStateField, t as addRoot } from "./registry-CymilZiZ.mjs";
 import { d as loadIndex, i as cacheLookupMeta, n as webfetchCacheWrite, o as cacheLookupSubstringMeta, t as mcpCacheWrite, u as extractText } from "./mcp-store-BkBDmuxN.mjs";
 import { t as loadRefs } from "./loader-AGz4nK7d.mjs";
-import { c as recordDoc, d as trivialCount, i as agentsFresh, l as recordRefRead, n as saveTrack, o as recordAgent, r as verifyTrack, s as recordBrainstormRequired, t as loadTrack, u as recordTrivialEdit } from "./store-CNjFenWe.mjs";
-import { d as readText, f as sleep, l as collectFiles, m as writeText, n as contextResponse, p as spawnCapture, r as denyResponse, s as systemMessage, t as blockResponse, u as pathExists } from "./claude-DLh0fHWM.mjs";
+import { c as recordDoc, d as trivialCount, i as agentsFresh, l as recordRefRead, n as saveTrack, o as recordAgent, r as verifyTrack, s as recordBrainstormRequired, t as loadTrack, u as recordTrivialEdit } from "./store-ARx-GQSQ.mjs";
+import { d as readText, f as sleep, l as collectFiles, m as writeText, n as contextResponse, p as spawnCapture, r as denyResponse, s as systemMessage, t as blockResponse, u as pathExists } from "./claude-U1KTaRG4.mjs";
 import { basename, dirname, extname, join, relative, resolve, sep } from "node:path";
 import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, rmdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
@@ -3537,7 +3537,7 @@ const EXEMPT_PATTERNS = [
 	/\.claude-plugin\//,
 	/CHANGELOG\.md$/,
 	/marketplace\.json$/,
-	/\/\.claude\/(apex|memory|logs)\//,
+	/\/\.claude\/(apex|memory|logs|fusengine-cache)\//,
 	/\/\.fuse-harness\//
 ];
 /**
@@ -3849,11 +3849,12 @@ function nextModular(filePath, content, cwd) {
 }
 /** Laravel FuseCore architecture: `app/` domain ban + module.json + cross-module `use` rules. */
 function fusecore(filePath, content, cwd) {
-	for (const b of PHP_BLOCKED_IN_APP) if (filePath.includes(b)) return block$1(`BLOCKED: FuseCore — domain code in '${b}' must move to FuseCore/{Module}/App/.`);
+	for (const b of PHP_BLOCKED_IN_APP) if (filePath.includes(b)) return block$1(`BLOCKED: FuseCore project. Code in '${b.replace(/^\/|\/$/g, "")}' FORBIDDEN. Move to '${b.replaceAll("/app/", "/FuseCore/{Module}/App/").replace(/^\/|\/$/g, "")}'.`);
 	const mod = filePath.match(/\/FuseCore\/([A-Za-z]+)\//);
 	if (!mod) return null;
 	const name = mod[1] ?? "";
-	if (!existsSync(join(cwd, "FuseCore", name, "module.json"))) return block$1(`BLOCKED: FuseCore module '${name}' is missing module.json — create it first.`);
+	const mj = join(cwd, "FuseCore", name, "module.json");
+	if (!existsSync(mj)) return block$1(`BLOCKED: Module '${name}' missing module.json. Create ${mj} first.`);
 	for (const m of content.matchAll(/use\s+FuseCore\\(\w+)\\/g)) {
 		const imported = m[1] ?? "";
 		if (name === "Core") {
@@ -3873,6 +3874,19 @@ function modularGate(tool, filePath, content, cwd) {
 }
 //#endregion
 //#region src/runtime/framework-skill-gate.ts
+/** PHP paths the Laravel skill check skips — broader than the SOLID vendor-only exclude (parity check-laravel-skill.py `/(vendor|storage|bootstrap/cache)/`). */
+const PHP_SKILL_EXCLUDE_RE = /\/(vendor|storage|bootstrap\/cache)\//;
+/**
+* Whether the sub-skill gate should skip this path — parity with the early return
+* in check-*-skill.py (build/vendor artifacts never require a sub-skill).
+* @param framework - the detected framework ("laravel" | "swift" | JS otherwise).
+* @param filePath - the file being written.
+*/
+function skillGateExcluded(framework, filePath) {
+	if (framework === "laravel") return PHP_SKILL_EXCLUDE_RE.test(filePath);
+	if (framework === "swift") return isExcludedSwiftPath(filePath);
+	return isExcludedJsPath(filePath);
+}
 /**
 * Effective line count for the SOLID size check. On an Edit, `content` is only
 * the `new_string` snippet, so for Next.js — mirroring the base file-size guard
@@ -3912,6 +3926,7 @@ function frameworkSkillGate(input, refsRead, existingCodeLines) {
 	const content = input.content ?? "";
 	const solid = frameworkSolidGate(input.filePath, content, effectiveLines(input.tool, input.framework, content, existingCodeLines));
 	if (solid) return solid;
+	if (skillGateExcluded(input.framework, input.filePath)) return null;
 	const forced = input.cwd ? requiredArchSkill(input.cwd) : null;
 	return skillTriggerGate(input.framework, content, refsRead, forced, input.cwd, input.filePath);
 }
@@ -3979,6 +3994,122 @@ function shadcnSkillGate(tool, filePath, content, ev) {
 	});
 }
 //#endregion
+//#region src/policy/tailwind-skill-gate.ts
+/** Vendored/build paths exempt (parity check-tailwind-skill.py `/(node_modules|dist|build)/`). */
+const TW_EXCLUDE_RE = /(^|\/)(node_modules|dist|build)\//;
+/** A read reference proving a base Tailwind skill was consulted (Phase 1). */
+const TW_BASE_SKILL_RE = /skills\/(tailwindcss-v4|tailwindcss-utilities)\//;
+/**
+* True when this Write/Edit is a `.tsx`/`.jsx` file carrying Tailwind utility
+* classes, outside vendored dirs — the trigger condition of Phase 1.
+* @param tool - the tool name.
+* @param filePath - the file being written.
+* @param content - the written content.
+*/
+function isTailwindWrite(tool, filePath, content) {
+	if (tool !== "Write" && tool !== "Edit") return false;
+	if (TW_EXCLUDE_RE.test(filePath)) return false;
+	return usesTailwindUtilities(filePath, content);
+}
+/** True when `tailwindcss-v4` or `tailwindcss-utilities` was read this session (Phase 1 base skill). */
+function tailwindBaseSkillRead(refsRead) {
+	return refsRead.some((p) => TW_BASE_SKILL_RE.test(p));
+}
+/**
+* Gate a Tailwind-scoped write: block until a base Tailwind skill is read
+* (parity check-tailwind-skill.py Phase 1). Returns `null` when out of scope
+* or already satisfied.
+* @param tool - the tool name.
+* @param filePath - the file being written.
+* @param content - the written content.
+* @param refsRead - in-session read reference paths.
+*/
+function tailwindSkillGate(tool, filePath, content, refsRead) {
+	if (!isTailwindWrite(tool, filePath, content)) return null;
+	if (tailwindBaseSkillRead(refsRead)) return null;
+	return {
+		kind: "block",
+		title: "Tailwind CSS skill",
+		reason: "BLOCKED: Tailwind skill not consulted. Read tailwindcss-v4/SKILL.md or tailwindcss-utilities/SKILL.md, or use mcp__context7__query-docs (topic: tailwindcss), then retry.",
+		actions: [`Read ${resolveSkillPath("tailwindcss-v4")} or ${resolveSkillPath("tailwindcss-utilities")}`]
+	};
+}
+//#endregion
+//#region src/policy/gemini-mcp-gate.ts
+/** UI file extensions the gate polices (parity enforce-gemini-mcp.py UI_EXT). */
+const UI_EXT_RE = /\.(tsx|jsx|vue|svelte)$/;
+/** Paths exempt from the gate (parity EXEMPT_DIRS). */
+const GEMINI_EXEMPT_RE = /(node_modules|dist|build|\.next|\.claude)\//;
+/** A live `mcp__gemini-design__*` call recorded this session proves consultation. */
+const GEMINI_MCP_SOURCE_RE = /gemini-mcp/i;
+/** Tailwind utility patterns (parity TAILWIND_PATTERNS). */
+const TW_PATTERNS = [
+	/\bflex\b/,
+	/\bgrid\b/,
+	/\bp-\d/,
+	/\bpx-\d/,
+	/\bpy-\d/,
+	/\bm-\d/,
+	/\bmx-\d/,
+	/\bmy-\d/,
+	/\bmt-\d/,
+	/\bmb-\d/,
+	/\bbg-\w+/,
+	/\btext-\w+/,
+	/\brounded/,
+	/\bshadow/,
+	/\bborder\b/,
+	/\bgap-\d/,
+	/\bw-\w+/,
+	/\bh-\w+/,
+	/\bjustify-\w+/,
+	/\bitems-\w+/,
+	/\bspace-\w+-\d/
+];
+/** Min distinct Tailwind patterns before the gate fires (parity MIN_TAILWIND_CLASSES). */
+const MIN_TW = 3;
+/** Min newlines an Edit's new_string must have to be gated (parity MIN_LINES_FOR_EDIT). */
+const MIN_LINES_EDIT = 2;
+/** OPT-IN: off unless `FUSE_ENFORCE_GEMINI_MCP` is `1`/`true`. Read fresh each call (dynamic). */
+function geminiMcpEnforced() {
+	const v = process.env.FUSE_ENFORCE_GEMINI_MCP;
+	return v === "1" || v === "true";
+}
+/** Count distinct Tailwind utility patterns present in `content` (parity count_tailwind_classes). */
+function countTailwindClasses(content) {
+	return TW_PATTERNS.reduce((n, re) => re.test(content) ? n + 1 : n, 0);
+}
+/** True when a `mcp__gemini-design__*` call was recorded this session (parity gemini_was_called). */
+function geminiMcpConsulted(authorizations, sessionId) {
+	if (!authorizations) return false;
+	return Object.values(authorizations).some((a) => a.doc_sessions?.includes(sessionId) && (a.sources ?? (a.source ? [a.source] : [])).some((s) => GEMINI_MCP_SOURCE_RE.test(s)));
+}
+/**
+* Gate a UI write when `FUSE_ENFORCE_GEMINI_MCP` is on: block hand-written
+* Tailwind (>= 3 classes) in a `.tsx/.jsx/.vue/.svelte` file unless a Gemini
+* Design MCP call was made this session. Returns `null` when disabled (default),
+* out of scope, or already satisfied.
+* @param tool - the tool name.
+* @param filePath - the file being written.
+* @param content - the written content (new_string on Edit).
+* @param ev - session evidence (authorizations + sessionId).
+*/
+function geminiMcpGate(tool, filePath, content, ev) {
+	if (!geminiMcpEnforced()) return null;
+	if (tool !== "Write" && tool !== "Edit") return null;
+	if (!filePath || !UI_EXT_RE.test(filePath) || GEMINI_EXEMPT_RE.test(filePath)) return null;
+	if (!content) return null;
+	if (tool === "Edit" && (content.match(/\n/g)?.length ?? 0) < MIN_LINES_EDIT) return null;
+	if (countTailwindClasses(content) < MIN_TW) return null;
+	if (geminiMcpConsulted(ev.authorizations, ev.sessionId)) return null;
+	return {
+		kind: "block",
+		title: "Gemini Design MCP",
+		reason: "BLOCKED: UI code with Tailwind detected but Gemini Design MCP not used. Use mcp__gemini-design__create_frontend, modify_frontend, or snippet_frontend BEFORE writing UI code manually.",
+		actions: ["Call mcp__gemini-design__create_frontend / modify_frontend / snippet_frontend, then retry"]
+	};
+}
+//#endregion
 //#region src/freshness/explore-tools.ts
 /** Native exploration tools (parity `apex_constants.EXPLORE_TOOLS`). */
 const EXPLORE_TOOLS = /* @__PURE__ */ new Set(["Glob", "Grep"]);
@@ -4005,9 +4136,17 @@ const EXPLORE_BASH_CMDS = /* @__PURE__ */ new Set([
 	"head",
 	"tail"
 ]);
-/** Cached MCP result reads count as research (parity `CACHE_READ_RE` + doc-helpers). */
+/** Legacy Python cache names still credited (parity `CACHE_READ_RE` + doc-helpers). */
 const CACHE_READ_RE = /\/context\/mcp\/(exa-search|exa-code-context|context7)-/;
 /**
+* Real TS cache stores: `<root>/.harness/cache/<fnv16>.md` (core MCP store,
+* `projectLayout().cacheDir`) and `~/.fuse-harness/cache/**` (ai-pilot doc
+* caches, `cache-base.cacheBaseDir`). Segment-matched — not resolved against
+* `homedir()` — so tilde-prefixed and absolute paths both hit; the `.md`
+* suffix keeps session-state JSON reads from counting as research.
+*/
+const TS_CACHE_READ_RE = /\.(?:fuse-)?harness[\\/]cache[\\/].*\.md$/;
+/**
 * First non-assignment shell token's basename, or "" — mirrors Python
 * `_bash_executable` (skips leading `VAR=value` env prefixes, e.g. `FOO=1 grep`).
 * @param cmd - Raw Bash `command` string.
@@ -4039,7 +4178,7 @@ function classifyExplore(tool, input) {
 	};
 	if (tool === "Read") {
 		const path = String(input?.file_path ?? input?.path ?? "");
-		if (path && CACHE_READ_RE.test(path)) return {
+		if (path && (CACHE_READ_RE.test(path) || TS_CACHE_READ_RE.test(path))) return {
 			phase: "research-expert",
 			cacheHit: true
 		};
@@ -4157,10 +4296,12 @@ async function apexScopedGate(input, track, window) {
 		authorizations: track.authorizations,
 		refs: input.refs,
 		refsRead: track.refsRead,
+		refsReadAt: track.refsReadAt,
+		now: input.now,
 		agentsFresh: freshnessFor([...REQUIRED_AGENTS]),
 		missingAgents: REQUIRED_AGENTS.filter((name) => !freshnessFor([name])),
 		windowMs: window,
-		brainstormRequired: input.tool === "Edit" ? false : track.brainstormRequired,
+		brainstormRequired: input.tool === "Edit" || input.agentId ? false : track.brainstormRequired,
 		brainstormFresh: freshnessFor(["brainstorming"], Number.MAX_SAFE_INTEGER)
 	};
 	try {
@@ -4221,6 +4362,15 @@ async function gate(input) {
 		});
 		if (shadcnBlock) return shadcnBlock;
 	}
+	if (isTailwindWrite(input.tool, filePath, input.content ?? "")) {
+		const twBlock = tailwindSkillGate(input.tool, filePath, input.content ?? "", track.refsRead);
+		if (twBlock) return twBlock;
+	}
+	const geminiBlock = geminiMcpGate(input.tool, filePath, input.content ?? "", {
+		authorizations: track.authorizations,
+		sessionId: input.sessionId
+	});
+	if (geminiBlock) return geminiBlock;
 	if (isApexScoped(input.filePath)) {
 		const apex = await apexScopedGate(input, track, window);
 		if (apex) return apex;
@@ -4343,7 +4493,7 @@ function mcpPostStore(tool, input, response, dir, now = Date.now()) {
 /** Apply an activity to a session's track and persist it (PostToolUse path). */
 async function recordActivity(file, activity) {
 	const track = await loadTrack(file);
-	await saveTrack(file, activity.kind === "agent" ? recordAgent(track, activity.name, activity.ts, activity.quality) : activity.kind === "doc" ? recordDoc(track, activity.framework, activity.sessionId, activity.source) : recordRefRead(track, activity.path));
+	await saveTrack(file, activity.kind === "agent" ? recordAgent(track, activity.name, activity.ts, activity.quality) : activity.kind === "doc" ? recordDoc(track, activity.framework, activity.sessionId, activity.source) : recordRefRead(track, activity.path, activity.ts));
 }
 //#endregion
 //#region src/runtime/respond.ts
@@ -4646,25 +4796,6 @@ function htmlCssOnlyGate(filePath) {
 function stateFileGate(filePath) {
 	return filePath.includes(".design-state-") ? deny("BLOCKED: .design-state files are READ-ONLY for you. Hooks update them automatically as you progress. Do NOT try to modify them — it will not unblock you. Follow the pipeline: Phase 0→1→2→3→4→5→6 in order.") : null;
 }
-/**
-* Ports browser_helpers.is_exempt: design-system.md is NOT exempt (it must meet
-* the quota); other `.md` files and vendored dirs ARE exempt from the check.
-*/
-function screenshotExempt(filePath) {
-	if (filePath.endsWith("design-system.md")) return false;
-	return filePath.endsWith(".md") || EXEMPT_DIRS.some((d) => filePath.includes(d));
-}
-/**
-* Block ANY non-exempt write (html/css/design-system.md) until the per-mode
-* screenshot quota is met. Ports check-browser-browsing.py's "Browse N sites
-* BEFORE writing" deny for the active design agent.
-*/
-function preScreenshotWriteGate(filePath, state) {
-	if (screenshotExempt(filePath)) return null;
-	const needed = MIN_SCREENSHOTS[state.mode];
-	if (state.screenshotsCount < needed) return deny(`BLOCKED: ${state.screenshotsCount}/${needed} fuse-browser screenshots for mode '${state.mode}'. Browse ${needed - state.screenshotsCount} more site(s) BEFORE writing. Read design-inspiration.md, then browser_open + browser_navigate + browser_screenshot.`);
-	return null;
-}
 /** Return the requirements missing from a design-system.md (empty = valid). */
 function validateDesignSystem(content) {
 	const missing = [];
@@ -4759,7 +4890,7 @@ function designGate(payload, event, cacheDir, cwd) {
 	}
 	if (event.tool === "Write" || event.tool === "Edit") {
 		const fp = event.filePath ?? "";
-		const base = stateFileGate(fp) ?? htmlCssOnlyGate(fp) ?? preScreenshotWriteGate(fp, state) ?? designSystemWriteGate(fp, state);
+		const base = stateFileGate(fp) ?? htmlCssOnlyGate(fp) ?? designSystemWriteGate(fp, state);
 		if (base) return base;
 		if (geminiEnabled() && state.geminiCalls === 0 && /\.(html|css)$/.test(fp)) return {
 			kind: "block",
@@ -4775,7 +4906,14 @@ function designGate(payload, event, cacheDir, cwd) {
 		if (!geminiEnabled()) return null;
 		const block = geminiCreateGate(state);
 		if (block) return block;
-		const missing = validateDesignSystem(findDesignSystem(cwd));
+		const ds = findDesignSystem(cwd);
+		if (ds === "") return {
+			kind: "block",
+			title: "Design pipeline",
+			reason: "BLOCKED: design-system.md not found. RECOVERY: 1) Read the identity templates 2) Read design-inspiration.md 3) Browse 4 reference sites 4) Write design-system.md, then retry create_frontend.",
+			actions: ["Create design-system.md via the pipeline, then retry create_frontend"]
+		};
+		const missing = validateDesignSystem(ds);
 		if (missing.length) return {
 			kind: "block",
 			title: "Design pipeline",
@@ -4819,13 +4957,10 @@ async function handlePre(ctx) {
 		stdout: securityAdvisory(event.tool, event.filePath ?? "", opts.now),
 		exit: 0
 	};
-	if (opts.scope === "solid" && event.filePath) {
-		const solidDeny = validateSolidGate(event.tool, event.filePath, event.content ?? "");
-		if (solidDeny) return {
-			stdout: solidDeny,
-			exit: 0
-		};
-	}
+	if (opts.scope === "solid") return {
+		stdout: validateSolidGate(event.tool, event.filePath ?? "", event.content ?? ""),
+		exit: 0
+	};
 	if (event.tool === "Task") {
 		const taskCtx = taskContext(opts.cwd);
 		if (taskCtx) return {
@@ -4844,6 +4979,7 @@ async function handlePre(ctx) {
 		refs: opts.refsDir ? await loadRefs(opts.refsDir) : void 0,
 		isReplaceAll: event.input.replace_all === true,
 		agentType: event.agentType,
+		agentId: typeof payload.agent_id === "string" ? payload.agent_id : void 0,
 		windowMs: opts.windowMs,
 		now: opts.now,
 		trackFile: file,
@@ -4900,6 +5036,7 @@ function docSourceOf(tool) {
 	if (tool === "WebSearch") return "websearch";
 	if (tool === "WebFetch") return "webfetch";
 	if (/^mcp__shadcn__/i.test(tool)) return "shadcn-mcp";
+	if (/^mcp__gemini-design__/i.test(tool)) return "gemini-mcp";
 }
 /**
 * Map a live tool-use to the activity to record, or null when nothing is
@@ -4932,7 +5069,8 @@ function activityFor(event) {
 		const path = String(event.input?.file_path ?? event.input?.path ?? "");
 		if (path.endsWith(".md")) out.push({
 			kind: "ref",
-			path
+			path,
+			ts: event.now
 		});
 	}
 	return out;

package/dist/{index-CVhw7eA0.d.mts → index-BqfOFKm7.d.mts}

@@ -113,6 +113,16 @@ declare const SYSTEM_INSTALL: ReadonlyArray<RegExp>;
 declare const PROJECT_INSTALL: ReadonlyArray<RegExp>;
 /** True when `cmd` matches any pattern in `patterns`. */
 declare function matchPatterns(cmd: string, patterns: ReadonlyArray<RegExp>): boolean;
+/** Git commands exempt from confirmation when Ralph mode is on (parity git-guard.py RALPH_SAFE). */
+declare const RALPH_SAFE: ReadonlyArray<string>;
+/**
+* OPT-IN autonomous "Ralph" mode: OFF unless `RALPH_MODE` is `1`/`true`, read
+* fresh on each call. Only the env var activates it — the Python source also
+* auto-enabled on a `.claude/ralph/prd.json` file or a `feature/*` branch, but
+* those silent activations are dropped here: a mode that removes git/install
+* confirmations must never turn on implicitly (owner: default OFF, env opt-in).
+*/
+declare function isRalphMode(): boolean;
 //#endregion
 //#region src/policy/interfaces/types.d.ts
 /** Harness-agnostic input to {@link evaluate}. */
@@ -146,7 +156,7 @@ interface PolicyResult {
 declare function evaluate(ctx: PolicyContext): PolicyResult;
 //#endregion
 //#region src/policy/apex-gates.d.ts
-/** Gate: the routed SOLID references for this edit must have been read. */
+/** Gate: the routed SOLID references for this edit must have been read within the TTL. */
 declare const solidReadGate: ApexGate;
 /** Gate: the required prior agents (explore + research) must have run within the window. */
 declare const freshnessGate: ApexGate;
@@ -168,11 +178,22 @@ interface ApexContext {
   refs?: RefMeta[];
   /** Absolute paths of SOLID refs already read this session. */
   refsRead?: string[];
+  /**
+  * Epoch-ms read timestamp per `refsRead` path (parity track-solid-reads.py
+  * `solid_reads[].timestamp`). PARITY: the TTL applies ONLY to solidReadGate —
+  * Python TTL-izes SOLID reads exclusively (require-solid-read.py); the
+  * skill-trigger/design/shadcn gates stay session-scoped (no TTL). A path in
+  * `refsRead` with no stamp here (tracks recorded before this field existed)
+  * counts as read — backward compat.
+  */
+  refsReadAt?: Record<string, number>;
+  /** Current epoch ms for the SOLID-read TTL check; absent → reads never expire. */
+  now?: number;
   /** Whether the required prior agents (explore + research) ran within the freshness window. */
   agentsFresh?: boolean;
   /** Names of REQUIRED_AGENTS that have NOT run fresh (subset), for a precise freshnessGate message. Absent → generic wording. */
   missingAgents?: string[];
-  /** Freshness window in ms, used only to label the block message with its TTL (e.g. "2min"). */
+  /** Freshness window in ms: labels the block messages' TTL (e.g. "2min") and bounds the SOLID-read TTL in solidReadGate. */
   windowMs?: number;
   /** Whether brainstorming is required for this edit (creation intent on a new file). */
   brainstormRequired?: boolean;
@@ -214,7 +235,13 @@ interface LabeledPattern {
 declare const CRITICAL_PATTERNS: LabeledPattern[];
 /** Patterns that warrant explicit confirmation before running — parity `security_rules.py`'s ask-level violation names. */
 declare const ASK_PATTERNS: LabeledPattern[];
-/** Guards against dangerous Bash commands (critical → block, sensitive → ask). */
+/**
+* Guards against dangerous Bash commands. Parity `security_rules.validate_command`
+* + `security-guard.py`: ACCUMULATE every matched violation, then deny when any
+* critical matched else ask, joining all violation labels in the reason. The
+* generic `rm` ask is exempt when the command targets a trash location (parity
+* `not re.search('trash', cmd)`).
+*/
 declare function securityGuard(ctx: GuardContext): Prompt | null;
 //#endregion
 //#region src/policy/guards/protected-path.d.ts
@@ -323,7 +350,11 @@ declare const JAVA_DECL_RE: RegExp;
 declare function interfaceSeparationGuard(ctx: GuardContext): Prompt | null;
 //#endregion
 //#region src/policy/guards/install.d.ts
-/** Asks for confirmation before a dependency or system package install. */
+/**
+* Asks for confirmation before a dependency or system package install. In Ralph
+* mode (opt-in `RALPH_MODE`) a PROJECT install is auto-approved for autonomous
+* runs (parity install-guard.py:52), but a SYSTEM install always asks.
+*/
 declare function installGuard(ctx: GuardContext): Prompt | null;
 //#endregion
 //#region src/policy/guards/index.d.ts
@@ -571,4 +602,4 @@ declare function isHtmlLike(path: string): boolean;
 */
 declare function missingSeoElements(html: string): string[];
 //#endregion
-export { ASK_PATTERNS as $, FAIL_CLOSED as A, ProjectType as At, SWIFT_PROTO_RE as B, usesTailwindUtilities as C, SOLID_REF as Ct, MAX_TOKENS as D, detectFramework as Dt, MAX_EXA_RESULTS as E, evaluateFileSize as Et, installGuard as F, CODE_MUTATORS as G, interfaceSeparationGuard as H, GO_DECL_RE as I, SAFE_PREFIXES as J, CODE_REDIRECT as K, JAVA_DECL_RE as L, clearUserGuards as M, detectProjectType as Mt, registerGuard as N, isApexCommand as Nt, capVerbosity as O, DEV_KEYWORDS as Ot, runGuards as P, requiredArchSkill as Pt, protectedPathGuard as Q, PHP_DECL_RE as R, skillTriggerGate as S, PLUGINS_DIR as St, frameworkSolidGate as T, countLines as Tt, bashWriteGuard as U, TS_DECL_RE as V, ASK_WRITERS as W, PROTECTED_FRAGMENTS as X, SESSION_STATE_FRAGMENT as Y, PROTECTED_GIT_RE as Z, DEV_VERBS as _, GIT_BLOCKED as _t, firstHeading as a, APEX_GATES as at, detectClaudeMdProjectType as b, matchPatterns as bt, parseEntry as c, brainstormGate as ct, EXCLUDE_DIRS as d, freshnessGate as dt, CRITICAL_PATTERNS as et, PROJECT_INDICATORS as f, solidReadGate as ft, loadApexTaskState as g, GIT_ASK as gt, buildApexTaskInjection as h, PolicyResult as ht, firstComment as i, GuardContext as it, GUARDS as j, detectModularArchitecture as jt, detectCreationIntent as k, ModularArchitecture as kt, parseBodyDesc as l, docConsultedGate as lt, buildApexTaskContext as m, PolicyContext as mt, missingSeoElements as n, securityGuard as nt, TreeEntry as o, ApexContext as ot, ApexTaskState as p, evaluate as pt, FILE_REDIRECT as q, descFromText as r, Guard as rt, parseEnrichment as s, ApexGate as st, isHtmlLike as t, LabeledPattern as tt, parseField as u, evaluateApex as ut, buildApexInstruction as v, PROJECT_INSTALL as vt, SKILL_TRIGGERS as w, countFrameworkCodeLines as wt, detectRequiredSkills as x, FileSizeVerdict as xt, buildClaudeMdContext as y, SYSTEM_INSTALL as yt, PY_MODEL_RE as z };
+export { ASK_PATTERNS as $, FAIL_CLOSED as A, DEV_KEYWORDS as At, SWIFT_PROTO_RE as B, usesTailwindUtilities as C, FileSizeVerdict as Ct, MAX_TOKENS as D, countLines as Dt, MAX_EXA_RESULTS as E, countFrameworkCodeLines as Et, installGuard as F, isApexCommand as Ft, CODE_MUTATORS as G, interfaceSeparationGuard as H, GO_DECL_RE as I, requiredArchSkill as It, SAFE_PREFIXES as J, CODE_REDIRECT as K, JAVA_DECL_RE as L, clearUserGuards as M, ProjectType as Mt, registerGuard as N, detectModularArchitecture as Nt, capVerbosity as O, evaluateFileSize as Ot, runGuards as P, detectProjectType as Pt, protectedPathGuard as Q, PHP_DECL_RE as R, skillTriggerGate as S, matchPatterns as St, frameworkSolidGate as T, SOLID_REF as Tt, bashWriteGuard as U, TS_DECL_RE as V, ASK_WRITERS as W, PROTECTED_FRAGMENTS as X, SESSION_STATE_FRAGMENT as Y, PROTECTED_GIT_RE as Z, DEV_VERBS as _, GIT_BLOCKED as _t, firstHeading as a, APEX_GATES as at, detectClaudeMdProjectType as b, SYSTEM_INSTALL as bt, parseEntry as c, brainstormGate as ct, EXCLUDE_DIRS as d, freshnessGate as dt, CRITICAL_PATTERNS as et, PROJECT_INDICATORS as f, solidReadGate as ft, loadApexTaskState as g, GIT_ASK as gt, buildApexTaskInjection as h, PolicyResult as ht, firstComment as i, GuardContext as it, GUARDS as j, ModularArchitecture as jt, detectCreationIntent as k, detectFramework as kt, parseBodyDesc as l, docConsultedGate as lt, buildApexTaskContext as m, PolicyContext as mt, missingSeoElements as n, securityGuard as nt, TreeEntry as o, ApexContext as ot, ApexTaskState as p, evaluate as pt, FILE_REDIRECT as q, descFromText as r, Guard as rt, parseEnrichment as s, ApexGate as st, isHtmlLike as t, LabeledPattern as tt, parseField as u, evaluateApex as ut, buildApexInstruction as v, PROJECT_INSTALL as vt, SKILL_TRIGGERS as w, PLUGINS_DIR as wt, detectRequiredSkills as x, isRalphMode as xt, buildClaudeMdContext as y, RALPH_SAFE as yt, PY_MODEL_RE as z };

package/dist/index.d.mts

@@ -5,10 +5,9 @@ import { a as HarnessInfo, i as HarnessId, n as detectMode, o as HarnessMode, r
 import { a as isDocConsulted, i as formatDocSatisfactionStatus, n as DocSatisfactionStatus, o as resolveSessions, r as formatDocDeny, t as AuthEntry } from "./doc-helpers-BNfYWvYv.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 ASK_PATTERNS, A as FAIL_CLOSED, At as ProjectType, B as SWIFT_PROTO_RE, C as usesTailwindUtilities, Ct as SOLID_REF, D as MAX_TOKENS, Dt as detectFramework, E as MAX_EXA_RESULTS, Et as evaluateFileSize, F as installGuard, G as CODE_MUTATORS, H as interfaceSeparationGuard, I as GO_DECL_RE, J as SAFE_PREFIXES, K as CODE_REDIRECT, L as JAVA_DECL_RE, M as clearUserGuards, Mt as detectProjectType, N as registerGuard, Nt as isApexCommand, O as capVerbosity, Ot as DEV_KEYWORDS, P as runGuards, Pt as requiredArchSkill, Q as protectedPathGuard, R as PHP_DECL_RE, S as skillTriggerGate, St as PLUGINS_DIR, T as frameworkSolidGate, Tt as countLines, U as bashWriteGuard, V as TS_DECL_RE, W as ASK_WRITERS, X as PROTECTED_FRAGMENTS, Y as SESSION_STATE_FRAGMENT, Z as PROTECTED_GIT_RE, _ as DEV_VERBS, _t as GIT_BLOCKED, a as firstHeading, at as APEX_GATES, b as detectClaudeMdProjectType, bt as matchPatterns, c as parseEntry, ct as brainstormGate, d as EXCLUDE_DIRS, dt as freshnessGate, et as CRITICAL_PATTERNS, f as PROJECT_INDICATORS, ft as solidReadGate, g as loadApexTaskState, gt as GIT_ASK, h as buildApexTaskInjection, ht as PolicyResult, i as firstComment, it as GuardContext, j as GUARDS, jt as detectModularArchitecture, k as detectCreationIntent, kt as ModularArchitecture, l as parseBodyDesc, lt as docConsultedGate, m as buildApexTaskContext, mt as PolicyContext, n as missingSeoElements, nt as securityGuard, o as TreeEntry, ot as ApexContext, p as ApexTaskState, pt as evaluate, q as FILE_REDIRECT, r as descFromText, rt as Guard, s as parseEnrichment, st as ApexGate, t as isHtmlLike, tt as LabeledPattern, u as parseField, ut as evaluateApex, v as buildApexInstruction, vt as PROJECT_INSTALL, w as SKILL_TRIGGERS, wt as countFrameworkCodeLines, x as detectRequiredSkills, xt as FileSizeVerdict, y as buildClaudeMdContext, yt as SYSTEM_INSTALL, z as PY_MODEL_RE } from "./index-CVhw7eA0.mjs";
+import { $ as ASK_PATTERNS, A as FAIL_CLOSED, At as DEV_KEYWORDS, B as SWIFT_PROTO_RE, C as usesTailwindUtilities, Ct as FileSizeVerdict, D as MAX_TOKENS, Dt as countLines, E as MAX_EXA_RESULTS, Et as countFrameworkCodeLines, F as installGuard, Ft as isApexCommand, G as CODE_MUTATORS, H as interfaceSeparationGuard, I as GO_DECL_RE, It as requiredArchSkill, J as SAFE_PREFIXES, K as CODE_REDIRECT, L as JAVA_DECL_RE, M as clearUserGuards, Mt as ProjectType, N as registerGuard, Nt as detectModularArchitecture, O as capVerbosity, Ot as evaluateFileSize, P as runGuards, Pt as detectProjectType, Q as protectedPathGuard, R as PHP_DECL_RE, S as skillTriggerGate, St as matchPatterns, T as frameworkSolidGate, Tt as SOLID_REF, U as bashWriteGuard, V as TS_DECL_RE, W as ASK_WRITERS, X as PROTECTED_FRAGMENTS, Y as SESSION_STATE_FRAGMENT, Z as PROTECTED_GIT_RE, _ as DEV_VERBS, _t as GIT_BLOCKED, a as firstHeading, at as APEX_GATES, b as detectClaudeMdProjectType, bt as SYSTEM_INSTALL, c as parseEntry, ct as brainstormGate, d as EXCLUDE_DIRS, dt as freshnessGate, et as CRITICAL_PATTERNS, f as PROJECT_INDICATORS, ft as solidReadGate, g as loadApexTaskState, gt as GIT_ASK, h as buildApexTaskInjection, ht as PolicyResult, i as firstComment, it as GuardContext, j as GUARDS, jt as ModularArchitecture, k as detectCreationIntent, kt as detectFramework, l as parseBodyDesc, lt as docConsultedGate, m as buildApexTaskContext, mt as PolicyContext, n as missingSeoElements, nt as securityGuard, o as TreeEntry, ot as ApexContext, p as ApexTaskState, pt as evaluate, q as FILE_REDIRECT, r as descFromText, rt as Guard, s as parseEnrichment, st as ApexGate, t as isHtmlLike, tt as LabeledPattern, u as parseField, ut as evaluateApex, v as buildApexInstruction, vt as PROJECT_INSTALL, w as SKILL_TRIGGERS, wt as PLUGINS_DIR, x as detectRequiredSkills, xt as isRalphMode, y as buildClaudeMdContext, yt as RALPH_SAFE, z as PY_MODEL_RE } from "./index-BqfOFKm7.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-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-BA-SqNR7.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, CacheHit, 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, type HarnessId, type HarnessInfo, type HarnessMode, type HarnessVia, IndexSummary, JAVA_DECL_RE, LabeledPattern, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PLUGINS_DIR, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, Palette, type PolicyContext, type PolicyResult, ProgressBarOptions, ProjectLayout, ProjectType, Prompt, PromptKind, RefMeta, ReminderState, RouteResult, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, 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, cacheLookupMeta, cacheLookupSubstring, cacheLookupSubstringMeta, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countFrameworkCodeLines, 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, usesTailwindUtilities, walkUpFor, webfetchCacheWrite };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, ApexContext, ApexGate, ApexTaskState, AuthEntry, CODE_MUTATORS, CODE_REDIRECT, COLOR_THRESHOLDS, CRITICAL_PATTERNS, CacheHit, 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, type HarnessId, type HarnessInfo, type HarnessMode, type HarnessVia, IndexSummary, JAVA_DECL_RE, LabeledPattern, MAX_EXA_RESULTS, MAX_LINES_ENV_KEY, MAX_TOKENS, ModularArchitecture, PHP_DECL_RE, PLUGINS_DIR, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, Palette, type PolicyContext, type PolicyResult, ProgressBarOptions, ProjectLayout, ProjectType, Prompt, PromptKind, RALPH_SAFE, RefMeta, ReminderState, RouteResult, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, ScoredRef, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, TreeEntry, addRoot, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, cacheLookup, cacheLookupMeta, cacheLookupSubstring, cacheLookupSubstringMeta, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countFrameworkCodeLines, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, 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, isRalphMode, jaccardSimilar, lessonsFileFor, loadApexTaskState, loadDotenv, loadIndex, loadRefs, 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, scoreReferences, securityGuard, setStateField, skillTriggerGate, solidReadGate, splitTarget, stateFileFor, summarizeIndex, throttleMs, toRefMeta, ttlLabel, usesTailwindUtilities, walkUpFor, webfetchCacheWrite };

package/dist/index.mjs

@@ -4,8 +4,8 @@ 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 { 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 detectCreationIntent, B as detectProjectType, D as MAX_EXA_RESULTS, E as frameworkSolidGate, F as freshnessGate, H as requiredArchSkill, I as solidReadGate, L as detectFramework, M as brainstormGate, N as docConsultedGate, O as MAX_TOKENS, P as evaluateApex, R as DEV_KEYWORDS, S as usesTailwindUtilities, T as SKILL_TRIGGERS, V as isApexCommand, a as firstHeading, b as detectRequiredSkills, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as APEX_GATES, k as capVerbosity, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, v as parseBodyDesc, x as skillTriggerGate, y as parseField, z as detectModularArchitecture } from "./validate-CjFtMZz0.mjs";
-import { A as PROJECT_INSTALL, C as PROTECTED_GIT_RE, D as securityGuard, E as CRITICAL_PATTERNS, F as countFrameworkCodeLines, I as countLines, L as evaluateFileSize, M as matchPatterns, N as PLUGINS_DIR, O as GIT_ASK, P as SOLID_REF, S as PROTECTED_FRAGMENTS, T as ASK_PATTERNS, _ as CODE_MUTATORS, a as registerGuard, b as SAFE_PREFIXES, c as GO_DECL_RE, d as PY_MODEL_RE, f as SWIFT_PROTO_RE, g as ASK_WRITERS, h as bashWriteGuard, i as clearUserGuards, j as SYSTEM_INSTALL, k as GIT_BLOCKED, 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 CODE_REDIRECT, w as protectedPathGuard, x as SESSION_STATE_FRAGMENT, y as FILE_REDIRECT } from "./evaluate-d7Pp8XJH.mjs";
+import { A as MAX_EXA_RESULTS, B as detectFramework, D as frameworkSolidGate, E as SKILL_TRIGGERS, F as brainstormGate, G as requiredArchSkill, H as detectModularArchitecture, I as docConsultedGate, L as evaluateApex, M as capVerbosity, N as detectCreationIntent, P as APEX_GATES, R as freshnessGate, S as usesTailwindUtilities, U as detectProjectType, V as DEV_KEYWORDS, W as isApexCommand, a as firstHeading, b as detectRequiredSkills, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as MAX_TOKENS, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, v as parseBodyDesc, x as skillTriggerGate, y as parseField, z as solidReadGate } from "./validate-ebDjIyOa.mjs";
+import { A as PROJECT_INSTALL, C as PROTECTED_GIT_RE, D as securityGuard, E as CRITICAL_PATTERNS, F as PLUGINS_DIR, I as SOLID_REF, L as countFrameworkCodeLines, M as SYSTEM_INSTALL, N as isRalphMode, O as GIT_ASK, P as matchPatterns, R as countLines, S as PROTECTED_FRAGMENTS, T as ASK_PATTERNS, _ as CODE_MUTATORS, a as registerGuard, b as SAFE_PREFIXES, c as GO_DECL_RE, d as PY_MODEL_RE, f as SWIFT_PROTO_RE, g as ASK_WRITERS, h as bashWriteGuard, i as clearUserGuards, j as RALPH_SAFE, k as GIT_BLOCKED, 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 CODE_REDIRECT, w as protectedPathGuard, x as SESSION_STATE_FRAGMENT, y as FILE_REDIRECT, z as evaluateFileSize } from "./evaluate-qYC5xClb.mjs";
 import { i as resolveSessions, n as formatDocSatisfactionStatus, r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-CWZegVdR.mjs";
 import { i as parseFrontmatter, n as scoreReferences, r as globToRe, t as routeReferences } from "./router-PKVNBHge.mjs";
 import { t as formatPrompt } from "./types-ernB1Dy3.mjs";
@@ -13,6 +13,5 @@ import { a as nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs,
 import { a as cacheLookupSubstring, c as cacheStore, d as loadIndex, f as summarizeIndex, h as queryHash, i as cacheLookupMeta, l as mcpCacheKey, m as jaccardSimilar, n as webfetchCacheWrite, o as cacheLookupSubstringMeta, p as compactMarkdown, r as cacheLookup, s as cachePath, t as mcpCacheWrite, u as extractText } from "./mcp-store-BkBDmuxN.mjs";
 import { t as incrementTrivialEditCounter } from "./freshness-BV3PQkDB.mjs";
 import { n as toRefMeta, t as loadRefs } from "./loader-AGz4nK7d.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-9lWvvWk8.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, 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, PLUGINS_DIR, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, 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, cacheLookupMeta, cacheLookupSubstring, cacheLookupSubstringMeta, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countFrameworkCodeLines, 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, usesTailwindUtilities, walkUpFor, webfetchCacheWrite };
+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, PLUGINS_DIR, PROGRESS_BAR_DEFAULTS, PROGRESS_CHARS, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, RALPH_SAFE, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, STATE_GITIGNORE, STATE_ROOT, SWIFT_PROTO_RE, SYSTEM_INSTALL, TIME_INTERVALS, TS_DECL_RE, TTL_ENV_KEY, addRoot, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, cacheLookup, cacheLookupMeta, cacheLookupSubstring, cacheLookupSubstringMeta, cachePath, cacheStore, capVerbosity, clearUserGuards, colors, compactJson, compactMarkdown, countFrameworkCodeLines, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectHarness, detectMode, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, ensureMemoryGitignore, 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, isRalphMode, jaccardSimilar, lessonsFileFor, loadApexTaskState, loadDotenv, loadIndex, loadRefs, 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, scoreReferences, securityGuard, setStateField, skillTriggerGate, solidReadGate, splitTarget, stateFileFor, summarizeIndex, throttleMs, toRefMeta, ttlLabel, usesTailwindUtilities, walkUpFor, webfetchCacheWrite };

package/dist/policy/index.d.mts

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

package/dist/policy/index.mjs

@@ -1,4 +1,4 @@
-import { A as detectCreationIntent, B as detectProjectType, D as MAX_EXA_RESULTS, E as frameworkSolidGate, F as freshnessGate, H as requiredArchSkill, I as solidReadGate, L as detectFramework, M as brainstormGate, N as docConsultedGate, O as MAX_TOKENS, P as evaluateApex, R as DEV_KEYWORDS, S as usesTailwindUtilities, T as SKILL_TRIGGERS, V as isApexCommand, a as firstHeading, b as detectRequiredSkills, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as APEX_GATES, k as capVerbosity, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, v as parseBodyDesc, x as skillTriggerGate, y as parseField, z as detectModularArchitecture } from "../validate-CjFtMZz0.mjs";
-import { A as PROJECT_INSTALL, C as PROTECTED_GIT_RE, D as securityGuard, E as CRITICAL_PATTERNS, F as countFrameworkCodeLines, I as countLines, L as evaluateFileSize, M as matchPatterns, N as PLUGINS_DIR, O as GIT_ASK, P as SOLID_REF, S as PROTECTED_FRAGMENTS, T as ASK_PATTERNS, _ as CODE_MUTATORS, a as registerGuard, b as SAFE_PREFIXES, c as GO_DECL_RE, d as PY_MODEL_RE, f as SWIFT_PROTO_RE, g as ASK_WRITERS, h as bashWriteGuard, i as clearUserGuards, j as SYSTEM_INSTALL, k as GIT_BLOCKED, 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 CODE_REDIRECT, w as protectedPathGuard, x as SESSION_STATE_FRAGMENT, y as FILE_REDIRECT } from "../evaluate-d7Pp8XJH.mjs";
+import { A as MAX_EXA_RESULTS, B as detectFramework, D as frameworkSolidGate, E as SKILL_TRIGGERS, F as brainstormGate, G as requiredArchSkill, H as detectModularArchitecture, I as docConsultedGate, L as evaluateApex, M as capVerbosity, N as detectCreationIntent, P as APEX_GATES, R as freshnessGate, S as usesTailwindUtilities, U as detectProjectType, V as DEV_KEYWORDS, W as isApexCommand, a as firstHeading, b as detectRequiredSkills, c as EXCLUDE_DIRS, d as buildApexTaskInjection, f as loadApexTaskState, g as detectClaudeMdProjectType, h as buildClaudeMdContext, i as firstComment, j as MAX_TOKENS, l as PROJECT_INDICATORS, m as buildApexInstruction, n as missingSeoElements, o as parseEnrichment, p as DEV_VERBS, r as descFromText, s as parseEntry, t as isHtmlLike, u as buildApexTaskContext, v as parseBodyDesc, x as skillTriggerGate, y as parseField, z as solidReadGate } from "../validate-ebDjIyOa.mjs";
+import { A as PROJECT_INSTALL, C as PROTECTED_GIT_RE, D as securityGuard, E as CRITICAL_PATTERNS, F as PLUGINS_DIR, I as SOLID_REF, L as countFrameworkCodeLines, M as SYSTEM_INSTALL, N as isRalphMode, O as GIT_ASK, P as matchPatterns, R as countLines, S as PROTECTED_FRAGMENTS, T as ASK_PATTERNS, _ as CODE_MUTATORS, a as registerGuard, b as SAFE_PREFIXES, c as GO_DECL_RE, d as PY_MODEL_RE, f as SWIFT_PROTO_RE, g as ASK_WRITERS, h as bashWriteGuard, i as clearUserGuards, j as RALPH_SAFE, k as GIT_BLOCKED, 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 CODE_REDIRECT, w as protectedPathGuard, x as SESSION_STATE_FRAGMENT, y as FILE_REDIRECT, z as evaluateFileSize } from "../evaluate-qYC5xClb.mjs";
 import "../policy-la_KkjCS.mjs";
-export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, PHP_DECL_RE, PLUGINS_DIR, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, capVerbosity, clearUserGuards, countFrameworkCodeLines, 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, usesTailwindUtilities };
+export { APEX_GATES, ASK_PATTERNS, ASK_WRITERS, CODE_MUTATORS, CODE_REDIRECT, CRITICAL_PATTERNS, DEV_KEYWORDS, DEV_VERBS, EXCLUDE_DIRS, FAIL_CLOSED, FILE_REDIRECT, GIT_ASK, GIT_BLOCKED, GO_DECL_RE, GUARDS, JAVA_DECL_RE, MAX_EXA_RESULTS, MAX_TOKENS, PHP_DECL_RE, PLUGINS_DIR, PROJECT_INDICATORS, PROJECT_INSTALL, PROTECTED_FRAGMENTS, PROTECTED_GIT_RE, PY_MODEL_RE, RALPH_SAFE, SAFE_PREFIXES, SESSION_STATE_FRAGMENT, SKILL_TRIGGERS, SOLID_REF, SWIFT_PROTO_RE, SYSTEM_INSTALL, TS_DECL_RE, bashWriteGuard, brainstormGate, buildApexInstruction, buildApexTaskContext, buildApexTaskInjection, buildClaudeMdContext, capVerbosity, clearUserGuards, countFrameworkCodeLines, countLines, descFromText, detectClaudeMdProjectType, detectCreationIntent, detectFramework, detectModularArchitecture, detectProjectType, detectRequiredSkills, docConsultedGate, evaluate, evaluateApex, evaluateFileSize, firstComment, firstHeading, frameworkSolidGate, freshnessGate, installGuard, interfaceSeparationGuard, isApexCommand, isHtmlLike, isRalphMode, loadApexTaskState, matchPatterns, missingSeoElements, parseBodyDesc, parseEnrichment, parseEntry, parseField, protectedPathGuard, registerGuard, requiredArchSkill, runGuards, securityGuard, skillTriggerGate, solidReadGate, usesTailwindUtilities };

package/dist/{run-DLXtA5DH.mjs → run-CaqeQFYp.mjs}

@@ -1,5 +1,5 @@
 import { t as isCodeFile } from "./project-root-3kk7gCOp.mjs";
-import { t as evaluate } from "./evaluate-d7Pp8XJH.mjs";
+import { t as evaluate } from "./evaluate-qYC5xClb.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

@@ -1,6 +1,6 @@
 import { t as Prompt } from "../types-D56jSgD9.mjs";
 import { t as RefMeta } from "../types-CY5qT2X1.mjs";
-import { t as AgentQuality } from "../session-state-D4F_Dub6.mjs";
+import { t as AgentQuality } from "../session-state-V8Jp-KE5.mjs";
 
 //#region src/runtime/paths.d.ts
 /**
@@ -53,6 +53,7 @@ type Activity = {
 } | {
   kind: "ref";
   path: string;
+  ts?: number;
 };
 /** Apply an activity to a session's track and persist it (PostToolUse path). */
 declare function recordActivity(file: string, activity: Activity): Promise<void>;
@@ -96,6 +97,8 @@ interface GateInput {
   windowMs?: number;
   isReplaceAll?: boolean;
   agentType?: string;
+  /** Claude `agent_id` when the tool-use comes from a subagent (parity require-apex-agents.py:41 — subagents inherit the lead's brainstorm decision). */
+  agentId?: string;
   /** Absolute path to the session transcript (Claude `transcript_path`) for evidence-based freshness. */
   transcriptPath?: string;
 }

package/dist/runtime/index.mjs

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

package/dist/{session-state-D4F_Dub6.d.mts → session-state-V8Jp-KE5.d.mts}

@@ -7,6 +7,15 @@ type AgentQuality = "sufficient" | "insufficient";
 interface SessionTrack {
   authorizations: Record<string, AuthEntry>;
   refsRead: string[];
+  /**
+  * Epoch-ms timestamp of each reference read, keyed by `refsRead` path (parity
+  * track-solid-reads.py `solid_reads[].timestamp`). Optional: tracks persisted
+  * before this field existed only carry `refsRead`, and such paths count as
+  * read (backward compat). PARITY: only the SOLID-read gate TTL-checks these —
+  * Python TTL-izes SOLID reads exclusively (require-solid-read.py); the other
+  * refsRead consumers (skill-trigger/shadcn/tailwind/design) stay session-scoped.
+  */
+  refsReadAt?: Record<string, number>;
   agents: {
     name: string;
     ts: number;
@@ -19,8 +28,15 @@ interface SessionTrack {
 declare function emptyTrack(): SessionTrack;
 /** Record a doc consultation (Context7/Exa) for a framework in this session. Immutable. */
 declare function recordDoc(track: SessionTrack, framework: string, sessionId: string, source: string): SessionTrack;
-/** Record that a SOLID reference file was read (deduped). Immutable. */
-declare function recordRefRead(track: SessionTrack, path: string): SessionTrack;
+/**
+* Record that a SOLID reference file was read (deduped). Immutable. When `now`
+* (epoch ms — the tool event's own timestamp, never a fresh `Date.now()`) is
+* supplied, the read is stamped in `refsReadAt`, refreshed on re-reads so the
+* LATEST read drives the SOLID TTL (parity track-solid-reads.py, which appends
+* a timestamped entry per read; require-solid-read.py checks the most recent).
+* Callers that omit `now` keep the legacy untimestamped behavior.
+*/
+declare function recordRefRead(track: SessionTrack, path: string, now?: number): SessionTrack;
 /** Record an agent/tool call with a timestamp + optional quality. Immutable. */
 declare function recordAgent(track: SessionTrack, name: string, ts: number, quality?: AgentQuality): SessionTrack;
 /** True when ALL of `names` ran within `windowMs` with non-insufficient quality. */

package/dist/{store-CNjFenWe.mjs → store-ARx-GQSQ.mjs}

@@ -32,11 +32,27 @@ function recordDoc(track, framework, sessionId, source) {
 		}
 	};
 }
-/** Record that a SOLID reference file was read (deduped). Immutable. */
-function recordRefRead(track, path) {
-	return track.refsRead.includes(path) ? track : {
+/**
+* Record that a SOLID reference file was read (deduped). Immutable. When `now`
+* (epoch ms — the tool event's own timestamp, never a fresh `Date.now()`) is
+* supplied, the read is stamped in `refsReadAt`, refreshed on re-reads so the
+* LATEST read drives the SOLID TTL (parity track-solid-reads.py, which appends
+* a timestamped entry per read; require-solid-read.py checks the most recent).
+* Callers that omit `now` keep the legacy untimestamped behavior.
+*/
+function recordRefRead(track, path, now) {
+	const refsRead = track.refsRead.includes(path) ? track.refsRead : [...track.refsRead, path];
+	if (now === void 0) return refsRead === track.refsRead ? track : {
+		...track,
+		refsRead
+	};
+	return {
 		...track,
-		refsRead: [...track.refsRead, path]
+		refsRead,
+		refsReadAt: {
+			...track.refsReadAt,
+			[path]: now
+		}
 	};
 }
 /** Record an agent/tool call with a timestamp + optional quality. Immutable. */

package/dist/tracking/index.d.mts

@@ -1,4 +1,4 @@
-import { a as recordAgent, c as recordRefRead, i as emptyTrack, l as recordTrivialEdit, n as SessionTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as AgentQuality, u as trivialCount } from "../session-state-D4F_Dub6.mjs";
+import { a as recordAgent, c as recordRefRead, i as emptyTrack, l as recordTrivialEdit, n as SessionTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as AgentQuality, u as trivialCount } from "../session-state-V8Jp-KE5.mjs";
 
 //#region src/tracking/store.d.ts
 /**

package/dist/tracking/index.mjs

@@ -1,2 +1,2 @@
-import { a as emptyTrack, c as recordDoc, d as trivialCount, i as agentsFresh, l as recordRefRead, n as saveTrack, o as recordAgent, s as recordBrainstormRequired, t as loadTrack, u as recordTrivialEdit } from "../store-CNjFenWe.mjs";
+import { a as emptyTrack, c as recordDoc, d as trivialCount, i as agentsFresh, l as recordRefRead, n as saveTrack, o as recordAgent, s as recordBrainstormRequired, t as loadTrack, u as recordTrivialEdit } from "../store-ARx-GQSQ.mjs";
 export { agentsFresh, emptyTrack, loadTrack, recordAgent, recordBrainstormRequired, recordDoc, recordRefRead, recordTrivialEdit, saveTrack, trivialCount };

package/dist/{validate-CjFtMZz0.mjs → validate-ebDjIyOa.mjs}

@@ -1,7 +1,7 @@
 import { r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
 import { c as ttlLabel, t as HOME_DIR } from "./dotenv-B9nM4cuQ.mjs";
 import { t as detectHarness } from "./harness-C8Nxxyn_.mjs";
-import { F as countFrameworkCodeLines, N as PLUGINS_DIR, P as SOLID_REF } from "./evaluate-d7Pp8XJH.mjs";
+import { F as PLUGINS_DIR, I as SOLID_REF, L as countFrameworkCodeLines } from "./evaluate-qYC5xClb.mjs";
 import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-CWZegVdR.mjs";
 import { t as routeReferences } from "./router-PKVNBHge.mjs";
 import { extname, join } from "node:path";
@@ -95,7 +95,7 @@ function detectProjectType(dir) {
 */
 function detectFramework(filePath, content) {
 	if (/\.(tsx?|jsx?|vue|svelte)$/.test(filePath) || /from ['"]react|useState|className=/.test(content)) {
-		if (/(page|layout|loading|error|route)\.(ts|tsx)$/.test(filePath) || /use client|use server/.test(content)) return "nextjs";
+		if (/(page|layout|loading|error|route|middleware)\.(ts|tsx)$/.test(filePath) || /use client|use server|NextRequest|NextResponse|from ['"]next|getServerSideProps|getStaticProps/.test(content)) return "nextjs";
 		return "react";
 	}
 	if (/\.swift$/.test(filePath)) return "swift";
@@ -109,11 +109,26 @@ function detectFramework(filePath, content) {
 }
 //#endregion
 //#region src/policy/apex-gates.ts
-/** Gate: the routed SOLID references for this edit must have been read. */
+/**
+* True when the SOLID ref read at `path` still counts. Parity require-solid-read.py
+* `_check_solid_read` (FUSE_ENFORCE_TTL_SEC, default 120s): a SOLID read older than
+* the window has expired and must be redone. PARITY NOTE: the TTL applies ONLY to
+* this gate — Python TTL-izes SOLID reads exclusively; the other refsRead consumers
+* (skillTriggerGate, shadcn/tailwind/design gates) stay session-scoped, so this
+* predicate must never leak into them. Backward compat: a path with no `refsReadAt`
+* stamp (tracks recorded before the field existed) or a context without a clock
+* (`now` absent) counts as read.
+*/
+function refReadFresh(ctx, path, windowMs) {
+	const at = ctx.refsReadAt?.[path];
+	return at === void 0 || ctx.now === void 0 || ctx.now - at < windowMs;
+}
+/** Gate: the routed SOLID references for this edit must have been read within the TTL. */
 const solidReadGate = (ctx) => {
 	if (!ctx.refs?.length) return null;
 	const routed = routeReferences(ctx.refs, ctx.filePath, ctx.content);
-	const ttl = ttlLabel(Math.round((ctx.windowMs ?? 120 * 1e3) / 1e3));
+	const windowMs = ctx.windowMs ?? 120 * 1e3;
+	const ttl = ttlLabel(Math.round(windowMs / 1e3));
 	if (!routed) {
 		const ref = SOLID_REF[ctx.framework] ?? "generic/";
 		return {
@@ -123,7 +138,7 @@ const solidReadGate = (ctx) => {
 			actions: [`Read ${PLUGINS_DIR}/${ref}SKILL.md`]
 		};
 	}
-	const read = new Set(ctx.refsRead ?? []);
+	const read = new Set((ctx.refsRead ?? []).filter((p) => refReadFresh(ctx, p, windowMs)));
 	const missing = !!routed.skillPath && read.has(routed.skillPath) ? [] : routed.required.map((r) => r.meta.filePath).filter((p) => !read.has(p));
 	if (missing.length === 0) return null;
 	const optional = routed.optional.map((r) => r.meta.filePath);
@@ -232,8 +247,8 @@ function capVerbosity(tool, input) {
 }
 //#endregion
 //#region src/policy/framework-solid-exclude.ts
-/** Build-output / dependency paths excluded from React/Next.js SOLID gating. */
-const JS_EXCLUDE_RE = /(node_modules|dist|build|\.next)/;
+/** Build/dep paths excluded from React/Next.js SOLID gating — segment-anchored (parity `r"/(node_modules|dist|build|\.next)/"`), NOT a bare substring, so `distance.ts`/`rebuild/` stay gated. */
+const JS_EXCLUDE_RE = /(^|\/)(node_modules|dist|build|\.next)(\/|$)/;
 /** Vendored dependency paths excluded from Laravel/PHP SOLID gating. */
 const PHP_EXCLUDE_RE = /\/vendor\//;
 /** Derived/build artifact paths excluded from Swift SOLID gating. */
@@ -945,6 +960,12 @@ function usesTailwindUtilities(filePath, content) {
 * @returns a `block` Prompt naming the missing sub-skills, or `null` when satisfied.
 */
 function skillTriggerGate(framework, content, refsRead, forcedSkill, cwd, filePath) {
+	if (forcedSkill === "fusecore" && !refsRead.some((r) => r.includes("skills/fusecore/"))) return {
+		kind: "block",
+		title: "FuseCore skill not consulted",
+		reason: "BLOCKED: FuseCore project detected. Read the FuseCore skill before writing code in FuseCore modules.",
+		actions: [`Read ${resolveSkillPath("fusecore")}`]
+	};
 	let required = detectRequiredSkills(framework, content);
 	if (framework !== "tailwind" && filePath && usesTailwindUtilities(filePath, content)) required = [...required, ...detectRequiredSkills("tailwind", content)];
 	if (forcedSkill && !required.includes(forcedSkill)) required.push(forcedSkill);
@@ -1243,7 +1264,7 @@ function buildClaudeMdContext(prompt, cwd) {
 	} catch {
 		return null;
 	}
-	if (!DEV_VERBS.test(prompt)) return `# CLAUDE.md\n${claudeContent}`;
+	if (!DEV_VERBS.test(prompt) && !DEV_KEYWORDS.test(prompt)) return `# CLAUDE.md\n${claudeContent}`;
 	return `${buildApexInstruction(detectClaudeMdProjectType(cwd), resolveMaxLines())}\n\n# CLAUDE.md\n${claudeContent}`;
 }
 //#endregion
@@ -1539,4 +1560,4 @@ function missingSeoElements(html) {
 	return missing;
 }
 //#endregion
-export { detectCreationIntent as A, detectProjectType as B, findMarketplacePlugins as C, MAX_EXA_RESULTS as D, frameworkSolidGate as E, freshnessGate as F, requiredArchSkill as H, solidReadGate as I, detectFramework as L, brainstormGate as M, docConsultedGate as N, MAX_TOKENS as O, evaluateApex as P, DEV_KEYWORDS as R, usesTailwindUtilities as S, SKILL_TRIGGERS as T, isApexCommand as V, scanPlugin as _, firstHeading as a, detectRequiredSkills as b, EXCLUDE_DIRS as c, buildApexTaskInjection as d, loadApexTaskState as f, detectClaudeMdProjectType as g, buildClaudeMdContext as h, firstComment as i, APEX_GATES as j, capVerbosity as k, PROJECT_INDICATORS as l, buildApexInstruction as m, missingSeoElements as n, parseEnrichment as o, DEV_VERBS as p, descFromText as r, parseEntry as s, isHtmlLike as t, buildApexTaskContext as u, parseBodyDesc as v, readPluginMeta as w, skillTriggerGate as x, parseField as y, detectModularArchitecture as z };
+export { MAX_EXA_RESULTS as A, detectFramework as B, resolveSkillPath as C, frameworkSolidGate as D, SKILL_TRIGGERS as E, brainstormGate as F, requiredArchSkill as G, detectModularArchitecture as H, docConsultedGate as I, evaluateApex as L, capVerbosity as M, detectCreationIntent as N, isExcludedJsPath as O, APEX_GATES as P, freshnessGate as R, usesTailwindUtilities as S, readPluginMeta as T, detectProjectType as U, DEV_KEYWORDS as V, isApexCommand as W, scanPlugin as _, firstHeading as a, detectRequiredSkills as b, EXCLUDE_DIRS as c, buildApexTaskInjection as d, loadApexTaskState as f, detectClaudeMdProjectType as g, buildClaudeMdContext as h, firstComment as i, MAX_TOKENS as j, isExcludedSwiftPath as k, PROJECT_INDICATORS as l, buildApexInstruction as m, missingSeoElements as n, parseEnrichment as o, DEV_VERBS as p, descFromText as r, parseEntry as s, isHtmlLike as t, buildApexTaskContext as u, parseBodyDesc as v, findMarketplacePlugins as w, skillTriggerGate as x, parseField as y, solidReadGate as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.46",
+  "version": "0.1.48",
   "description": "Harness-agnostic toolkit for AI coding agents: runtime harness detection (Claude Code, Codex, Cursor, Cline, Gemini, Aider...), pure policy core (env config, project/framework detection, SOLID/file-size limits, APEX freshness, guard patterns, portable prompts), cache, project memory, ref routing, state/locks, statusline, per-harness adapters (Claude/Cursor/Cline/Gemini) and a cli-mode harness-check binary. Bun-native, with a built dist for Node + bundlers.",
   "type": "module",
   "module": "src/index.ts",
@@ -59,11 +59,6 @@
       "types": "./dist/refs/index.d.mts",
       "import": "./dist/refs/index.mjs"
     },
-    "./state": {
-      "bun": "./src/state/index.ts",
-      "types": "./dist/state/index.d.mts",
-      "import": "./dist/state/index.mjs"
-    },
     "./statusline": {
       "bun": "./src/statusline/index.ts",
       "types": "./dist/statusline/index.d.mts",
@@ -132,7 +127,7 @@
     "test": "bun test",
     "typecheck": "tsc --noEmit",
     "docs:api": "typedoc",
-    "build": "tsdown src/index.ts src/config/index.ts src/util/index.ts src/detect/index.ts src/policy/index.ts src/prompt/index.ts src/memory/index.ts src/cache/index.ts src/freshness/index.ts src/refs/index.ts src/state/index.ts src/statusline/index.ts src/cli/index.ts src/cli/bin.ts src/init/index.ts src/tracking/index.ts src/runtime/index.ts src/adapters/claude/index.ts src/adapters/codex/index.ts src/adapters/cursor/index.ts src/adapters/cline/index.ts src/adapters/gemini/index.ts --dts --format esm --clean --out-dir dist",
+    "build": "tsdown src/index.ts src/config/index.ts src/util/index.ts src/detect/index.ts src/policy/index.ts src/prompt/index.ts src/memory/index.ts src/cache/index.ts src/freshness/index.ts src/refs/index.ts src/statusline/index.ts src/cli/index.ts src/cli/bin.ts src/init/index.ts src/tracking/index.ts src/runtime/index.ts src/adapters/claude/index.ts src/adapters/codex/index.ts src/adapters/cursor/index.ts src/adapters/cline/index.ts src/adapters/gemini/index.ts --dts --format esm --clean --out-dir dist",
     "prepublishOnly": "bun test && tsc --noEmit && bun run build"
   },
   "publishConfig": {

package/dist/index-BA-SqNR7.d.mts

@@ -1,59 +0,0 @@
-import { t as AuthEntry } from "./doc-helpers-BNfYWvYv.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/state/index.d.mts

@@ -1,2 +0,0 @@
-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-BA-SqNR7.mjs";
-export { ApexState, ApexTask, ApexTaskFile, acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart };

package/dist/state/index.mjs

@@ -1,2 +0,0 @@
-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-9lWvvWk8.mjs";
-export { acquireLock, apexStateDir, ensureStateDir, loadState, saveState, stateFilePath, taskComplete, taskCreate, taskStart };

package/dist/state-9lWvvWk8.mjs

@@ -1,104 +0,0 @@
-import { a as writeJsonFile, i as readJsonFile, n as ensureDir } from "./json-io-DisYd2fb.mjs";
-import { mkdir, rmdir } from "node:fs/promises";
-//#region src/state/lock.ts
-const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
-/**
-* 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.
-*/
-async function acquireLock(lockDir, timeoutMs = 5e3) {
-	const start = Date.now();
-	while (Date.now() - start < timeoutMs) try {
-		await mkdir(lockDir, { recursive: false });
-		return async () => {
-			try {
-				await rmdir(lockDir);
-			} catch {}
-		};
-	} catch {
-		await sleep(100);
-	}
-	return null;
-}
-//#endregion
-//#region src/state/apex-state.ts
-const DEFAULT_STATE = {
-	$schema: "apex-state-v1",
-	description: "APEX/SOLID state - sessions[] + 2min expiry",
-	target: {},
-	authorizations: {}
-};
-/** APEX state directory under a home dir. */
-function apexStateDir(home = process.env.HOME ?? "") {
-	return `${home}/.claude/logs/00-apex`;
-}
-/** Daily state file path: `<home>/.claude/logs/00-apex/<YYYY-MM-DD>-state.json`. */
-function stateFilePath(home = process.env.HOME ?? "", today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)) {
-	return `${apexStateDir(home)}/${today}-state.json`;
-}
-/** Ensure the state directory exists and return its path. */
-async function ensureStateDir(home) {
-	const dir = apexStateDir(home);
-	await ensureDir(dir);
-	return dir;
-}
-/** Load APEX state, or a fresh default. */
-async function loadState(path) {
-	return await readJsonFile(path) ?? { ...DEFAULT_STATE };
-}
-/** Save APEX state. */
-async function saveState(path, state) {
-	await writeJsonFile(path, state);
-}
-//#endregion
-//#region src/state/task-helpers.ts
-/** Add a new pending task. */
-async function taskCreate(file, id, subject, desc) {
-	const data = await readJsonFile(file);
-	if (!data) return;
-	data.tasks[id] = {
-		subject,
-		description: desc,
-		status: "pending",
-		phase: "pending",
-		created_at: (/* @__PURE__ */ new Date()).toISOString(),
-		doc_consulted: {},
-		files_modified: [],
-		blockedBy: []
-	};
-	await writeJsonFile(file, data);
-}
-/** Mark a task in_progress (creating a stub if absent). */
-async function taskStart(file, id, subject, desc, blocked) {
-	const data = await readJsonFile(file);
-	if (!data) return;
-	const task = data.tasks[id] ?? {
-		subject: "",
-		description: "",
-		status: "in_progress",
-		phase: "analyze",
-		doc_consulted: {},
-		files_modified: []
-	};
-	data.tasks[id] = task;
-	data.current_task = id;
-	task.status = "in_progress";
-	task.phase = "analyze";
-	task.started_at = (/* @__PURE__ */ new Date()).toISOString();
-	if (subject) task.subject = subject;
-	if (desc) task.description = desc;
-	if (blocked) task.blockedBy = blocked.split(",");
-	await writeJsonFile(file, data);
-}
-/** Mark a task completed. */
-async function taskComplete(file, id) {
-	const data = await readJsonFile(file);
-	const task = data?.tasks[id];
-	if (!data || !task) return;
-	task.status = "completed";
-	task.phase = "completed";
-	task.completed_at = (/* @__PURE__ */ new Date()).toISOString();
-	await writeJsonFile(file, data);
-}
-//#endregion
-export { ensureStateDir as a, stateFilePath as c, apexStateDir as i, acquireLock as l, taskCreate as n, loadState as o, taskStart as r, saveState as s, taskComplete as t };