@fusengine/harness 0.1.31 → 0.1.32

package/dist/adapters/claude/index.mjs

@@ -1,2 +1,2 @@
-import { a as readClaudeInput, i as guard, n as denyResponse, o as toClaudeResponse, r as fileSizeGuard, t as contextResponse } from "../../claude-B9FYp0Yw.mjs";
+import { a as readClaudeInput, i as guard, n as denyResponse, o as toClaudeResponse, r as fileSizeGuard, t as contextResponse } from "../../claude-BWZcrZbS.mjs";
 export { contextResponse, denyResponse, fileSizeGuard, guard, readClaudeInput, toClaudeResponse };

package/dist/adapters/cline/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-j3gRJ_ng.mjs";
+import { t as evaluate } from "../../evaluate-9ch1K2kt.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 readClaudeInput, i as guard, n as denyResponse, t as contextResponse } from "../../claude-B9FYp0Yw.mjs";
+import { a as readClaudeInput, i as guard, n as denyResponse, t as contextResponse } from "../../claude-BWZcrZbS.mjs";
 export { contextResponse, denyResponse, guard, readClaudeInput as readCodexInput };

package/dist/adapters/cursor/index.mjs

@@ -1,4 +1,4 @@
-import { t as evaluate } from "../../evaluate-j3gRJ_ng.mjs";
+import { t as evaluate } from "../../evaluate-9ch1K2kt.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-j3gRJ_ng.mjs";
+import { t as evaluate } from "../../evaluate-9ch1K2kt.mjs";
 import { t as formatPrompt } from "../../types-ernB1Dy3.mjs";
 //#region src/adapters/gemini/index.ts
 /**

package/dist/{claude-B9FYp0Yw.mjs → claude-BWZcrZbS.mjs}

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

package/dist/cli/bin.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { r as resolveTtlSec } from "../ttl-BG55s6HZ.mjs";
 import { t as detectHarness } from "../harness-C8Nxxyn_.mjs";
-import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-CXsV-wIJ.mjs";
+import { n as stagedContent, r as stagedFiles, t as checkStaged } from "../run-CQbtlAKa.mjs";
 import { n as writeInitFile, t as initFor } from "../run-D91N4ul1.mjs";
-import { t as handleHook } from "../handle-DW9cWdVt.mjs";
+import { t as handleHook } from "../handle-DJqHZcml.mjs";
 //#region src/cli/bin.ts
 /**
 * harness — CLI for @fusengine/harness.
@@ -33,7 +33,9 @@ if (cmd === "hook") {
 		"carto",
 		"security",
 		"changelog",
-		"aipilot"
+		"aipilot",
+		"lessons",
+		"seo"
 	])).has(scopeArg) ? scopeArg : "core";
 	const outcome = await handleHook(id, await readStdin(), {
 		now: Date.now(),

package/dist/cli/index.mjs

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

package/dist/{evaluate-j3gRJ_ng.mjs → evaluate-9ch1K2kt.mjs}

@@ -1,5 +1,5 @@
 import { i as splitTarget, r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
-import { t as isCodeFile } from "./project-root-ff0_poWU.mjs";
+import { t as isCodeFile } from "./project-root-3kk7gCOp.mjs";
 //#region src/policy/detect-framework.ts
 /**
 * Detect the framework from a file path extension + content patterns.

package/dist/{handle-DW9cWdVt.mjs → handle-DJqHZcml.mjs}

@@ -1,13 +1,15 @@
 import { r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
 import { r as projectLayout } from "./layout-C0jaaCQC.mjs";
-import { C as capVerbosity, F as requiredArchSkill, M as detectModularArchitecture, O as evaluateApex, a as parseEntry, b as frameworkSolidGate, c as EXCLUDE_DIRS$1, d as buildApexTaskInjection, h as buildClaudeMdContext, i as parseEnrichment, l as PROJECT_INDICATORS, s as parseField, t as descFromText, v as skillTriggerGate, w as detectCreationIntent } from "./describe-BYqhoV4c.mjs";
-import { j as detectFramework, k as countLines, n as FAIL_CLOSED, t as evaluate } from "./evaluate-j3gRJ_ng.mjs";
+import { i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "./project-root-3kk7gCOp.mjs";
+import { A as evaluateApex, E as detectCreationIntent, L as requiredArchSkill, P as detectModularArchitecture, S as frameworkSolidGate, T as capVerbosity, _ as buildClaudeMdContext, b as skillTriggerGate, c as parseBodyDesc, d as PROJECT_INDICATORS, l as parseField, n as missingSeoElements, o as parseEnrichment, p as buildApexTaskInjection, r as descFromText, s as parseEntry, t as isHtmlLike, u as EXCLUDE_DIRS$1 } from "./validate-CccewDwk.mjs";
+import { j as detectFramework, k as countLines, n as FAIL_CLOSED, t as evaluate } from "./evaluate-9ch1K2kt.mjs";
 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-BkoEbdec.mjs";
 import { a as extractText, o as loadIndex, r as cacheStore, t as cacheLookup } from "./store-PrNPm6So.mjs";
 import { i as writeJsonFile, r as readJsonFile, t as atomicWrite } from "./json-io-CAn72gI4.mjs";
 import { t as loadRefs } from "./loader-CyAoJv2W.mjs";
 import { a as recordAgent, c as recordRefRead, l as recordTrivialEdit, n as saveTrack, o as recordBrainstormRequired, r as agentsFresh, s as recordDoc, t as loadTrack, u as trivialCount } from "./store-D-ge2ZPI.mjs";
-import { t as contextResponse } from "./claude-B9FYp0Yw.mjs";
+import { n as denyResponse, t as contextResponse } from "./claude-BWZcrZbS.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, tmpdir } from "node:os";
@@ -1459,22 +1461,417 @@ function generateProjectMap(cwd, outputDir) {
 	return "";
 }
 //#endregion
+//#region src/runtime/lifecycle/cartographer/detect.ts
+/**
+* Plugin discovery (fs). Ports `detect_plugins.py`: marketplace `plugins` dir
+* resolution + `plugin.json` meta reading.
+*/
+/** Sorted entry names of `dir` (alpha, byte-order), or `[]` on error. */
+function sortedNames$1(dir) {
+	try {
+		return readdirSync(dir).sort((a, b) => a.localeCompare(b, "en"));
+	} catch {
+		return [];
+	}
+}
+/**
+* Read `[version, name]` from `<pluginPath>/.claude-plugin/plugin.json`.
+* @param pluginPath - Absolute plugin directory.
+* @returns The `[version, name]` pair (both "" when absent/unreadable).
+*/
+function readPluginMeta(pluginPath) {
+	const pj = join(pluginPath, ".claude-plugin", "plugin.json");
+	if (!existsSync(pj)) return ["", ""];
+	try {
+		const meta = JSON.parse(readFileSync(pj, "utf-8"));
+		return [meta.version ?? "", meta.name ?? ""];
+	} catch {
+		return ["", ""];
+	}
+}
+/**
+* Auto-detect the marketplace `plugins` dir that contains `cartographer`,
+* falling back to the first marketplace with a `plugins` dir, else `cwd`.
+* Ports `find_marketplace_plugins`.
+* @param home - Home directory (defaults to `~`).
+* @returns The resolved plugins directory.
+*/
+function findMarketplacePlugins(home = homedir()) {
+	const mp = join(home, ".claude", "plugins", "marketplaces");
+	const markets = sortedNames$1(mp);
+	for (const m of markets) if (existsSync(join(mp, m, "plugins", "cartographer"))) return join(mp, m, "plugins");
+	for (const m of markets) if (existsSync(join(mp, m, "plugins"))) return join(mp, m, "plugins");
+	return process.cwd();
+}
+//#endregion
+//#region src/runtime/lifecycle/cartographer/scan.ts
+/**
+* Plugin scanning (fs). Ports `scan_plugins.py`: turns a plugin's
+* agents/skills/commands/hooks into ordered `[type, name, desc]` rows.
+*/
+/** Sorted entry names of `dir` (alpha, byte-order), or `[]` on error. */
+function sortedNames(dir) {
+	try {
+		return readdirSync(dir).sort((a, b) => a.localeCompare(b, "en"));
+	} catch {
+		return [];
+	}
+}
+/** Read a `.md` frontmatter field from a file path, "" when missing/unreadable. */
+function fileField(path, field) {
+	try {
+		return parseField(readFileSync(path, "utf-8"), field);
+	} catch {
+		return "";
+	}
+}
+/** Scan `agents/*.md` → `("agent", name, desc[:50])` rows. */
+function scanAgents(root) {
+	const dir = join(root, "agents");
+	return sortedNames(dir).filter((n) => extname(n) === ".md").map((n) => {
+		const f = join(dir, n);
+		return [
+			"agent",
+			fileField(f, "name") || n.replace(/\.md$/, ""),
+			fileField(f, "description").slice(0, 50)
+		];
+	});
+}
+/** Scan `skills/<dir>/SKILL.md` → `("skill", dir, desc)` rows. */
+function scanSkills(root) {
+	const dir = join(root, "skills");
+	const rows = [];
+	for (const name of sortedNames(dir)) {
+		try {
+			if (!statSync(join(dir, name)).isDirectory()) continue;
+		} catch {
+			continue;
+		}
+		const skillMd = join(dir, name, "SKILL.md");
+		let desc = "";
+		if (existsSync(skillMd)) {
+			desc = fileField(skillMd, "description");
+			if (!desc) try {
+				desc = parseBodyDesc(readFileSync(skillMd, "utf-8"));
+			} catch {}
+		}
+		rows.push([
+			"skill",
+			name,
+			desc || "(no description)"
+		]);
+	}
+	return rows;
+}
+/** Scan `commands/*.md` → `("command", "/name", desc[:50])` rows. */
+function scanCommands(root) {
+	const dir = join(root, "commands");
+	return sortedNames(dir).filter((n) => extname(n) === ".md").map((n) => [
+		"command",
+		`/${n.replace(/\.md$/, "")}`,
+		fileField(join(dir, n), "description").slice(0, 50)
+	]);
+}
+/** Scan `hooks/hooks.json` → a single `("hooks", "<events>", "")` row, or none. */
+function scanHooks(root) {
+	const file = join(root, "hooks", "hooks.json");
+	if (!existsSync(file)) return [];
+	try {
+		const raw = JSON.parse(readFileSync(file, "utf-8"));
+		const data = raw && typeof raw === "object" ? raw : {};
+		const hooks = data.hooks && typeof data.hooks === "object" ? data.hooks : data;
+		const events = Object.keys(hooks).filter((k) => !k.startsWith("_")).sort((a, b) => a.localeCompare(b, "en"));
+		return events.length ? [[
+			"hooks",
+			events.join(", "),
+			""
+		]] : [];
+	} catch {
+		return [];
+	}
+}
+/**
+* Scan a single plugin directory into ordered `[type, name, desc]` rows.
+* @param pluginDir - Absolute plugin directory.
+* @returns The agents + skills + commands + hooks rows.
+*/
+function scanPlugin(pluginDir) {
+	return [
+		...scanAgents(pluginDir),
+		...scanSkills(pluginDir),
+		...scanCommands(pluginDir),
+		...scanHooks(pluginDir)
+	];
+}
+//#endregion
+//#region src/policy/cartographer/build-tree.ts
+const SECTION_ORDER = [
+	"agent",
+	"skill",
+	"command"
+];
+/**
+* Format grouped items with tree connectors and optional markdown links.
+* Skill sections link to `./skills/<name>/index.md`; other sections to
+* `./<folder>/<name>.md`; unlinked sections render the bare name.
+* @param prefix - The line prefix (indent + branch glyphs).
+* @param items - The `[name, desc]` pairs to render.
+* @param folder - The link folder ("" disables linking).
+* @param asDirs - Whether items link to a subdirectory `index.md`.
+* @returns The rendered lines.
+*/
+function printItems(prefix, items, folder, asDirs) {
+	return items.map(([name, desc], i) => {
+		const connector = i === items.length - 1 ? "└──" : "├──";
+		const safe = name.replace(/^\/+/, "");
+		let label = name;
+		if (folder && asDirs) label = `[${name}](./${folder}/${safe}/index.md)`;
+		else if (folder) label = `[${name}](./${folder}/${safe}.md)`;
+		const short = desc && desc !== "(no description)" ? ` — ${desc.slice(0, 80)}` : "";
+		return `${prefix}${connector} ${label}${short}`;
+	});
+}
+/**
+* Build an indented tree from scanned items. The `hooks` row renders as a single
+* trailing `└── hooks: …` line; agents/skills/commands render as folder sections.
+* @param items - The scanned `[type, name, desc]` rows.
+* @param linked - When true, leaf names become markdown links.
+* @returns The joined tree text.
+*/
+function buildTree(items, linked = false) {
+	const groups = {};
+	let hooksLine = "";
+	for (const [typ, name, desc] of items) if (typ === "hooks") hooksLine = name;
+	else (groups[typ] ??= []).push([name, desc]);
+	const sections = SECTION_ORDER.filter((s) => s in groups);
+	if (hooksLine) sections.push("hooks");
+	const lines = [];
+	const total = sections.length;
+	for (let idx = 0; idx < total; idx++) {
+		const section = sections[idx] ?? "";
+		if (section === "hooks") {
+			lines.push(`└── hooks: ${hooksLine}`);
+			continue;
+		}
+		const isLast = idx === total - 1;
+		const folder = `${section}s`;
+		const prefix = isLast ? "└──" : "├──";
+		const subPrefix = isLast ? "    " : "│   ";
+		lines.push(`${prefix} ${folder}/`);
+		const linkFolder = linked ? folder : "";
+		const isDirSection = section === "skill";
+		lines.push(...printItems(subPrefix, groups[section] ?? [], linkFolder, linked && isDirSection));
+	}
+	return lines.join("\n");
+}
+//#endregion
+//#region src/runtime/lifecycle/cartographer/write-plugin-map.ts
+/**
+* Per-plugin map writer (fs). Ports `write_plugin_map.py`: writes a level-2
+* `<plugin>/index.md` (indented linked tree) then recurses agents/skills/
+* commands into deeper index trees. Reuses `buildTree`, `mergeLines`, `writeTree`.
+*/
+/** True when `dir` is a real directory. */
+function isDir(dir) {
+	try {
+		return statSync(dir).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/**
+* Write `<outputDir>/<pluginName>/index.md` (indented linked tree) and recurse
+* agents/skills/commands into their own index trees rooted there.
+* @param outputDir - The map root directory.
+* @param pluginName - Display name of the plugin (the index subfolder).
+* @param version - Plugin version ("" to omit).
+* @param items - The scanned `[type, name, desc]` rows.
+* @param pluginPath - Absolute source plugin directory (for recursion).
+*/
+function writePluginMap(outputDir, pluginName, version, items, pluginPath) {
+	const pluginDir = join(outputDir, pluginName);
+	mkdirSync(pluginDir, { recursive: true });
+	const newLines = `# ${pluginName}${version ? ` (v${version})` : ""}\n\n${items.length ? buildTree(items, true) : "└── (empty)"}`.split("\n");
+	const indexPath = join(pluginDir, "index.md");
+	writeFileSync(indexPath, mergeLines(newLines, indexPath).join("\n") + "\n", "utf-8");
+	for (const section of [
+		"agents",
+		"skills",
+		"commands"
+	]) {
+		const src = join(pluginPath, section);
+		if (isDir(src)) writeTree(src, join(pluginDir, section), "../index.md");
+	}
+}
+//#endregion
+//#region src/runtime/lifecycle/cartographer/ecosystem-map.ts
+/**
+* Ecosystem (plugin) map generation (fs). Ports `generate_map.py`: scans every
+* installed plugin into a level-1 `.cartographer/index.md` + per-plugin level-2+
+* trees, preserving enriched descriptions. Reuses `findMarketplacePlugins`,
+* `readPluginMeta`, `scanPlugin`, `mergeLines`, `writePluginMap`.
+*/
+function pluginDirs(dir) {
+	let entries = [];
+	try {
+		entries = readdirSync(dir);
+	} catch {
+		return [];
+	}
+	return entries.filter((n) => !n.startsWith("_") && !n.startsWith(".")).filter((n) => {
+		try {
+			return statSync(join(dir, n)).isDirectory();
+		} catch {
+			return false;
+		}
+	}).sort((a, b) => a.localeCompare(b, "en"));
+}
+function utcStamp(now) {
+	return new Date(now).toISOString().slice(0, 16).replace("T", " ");
+}
+/**
+* Generate the plugin ecosystem map under `<pluginsDir>/.cartographer`.
+* @param now - Clock for the banner timestamp.
+* @param pluginsDirOverride - Override for the marketplace plugins directory.
+* @returns The map navigation context, or "".
+*/
+function generateEcosystemMap(now, pluginsDirOverride) {
+	const pluginsDir = resolve(pluginsDirOverride ?? findMarketplacePlugins());
+	try {
+		if (!statSync(pluginsDir).isDirectory()) return "";
+	} catch {
+		return "";
+	}
+	const outputDir = join(pluginsDir, ".cartographer");
+	mkdirSync(outputDir, { recursive: true });
+	const dirs = pluginDirs(pluginsDir);
+	const lines = [`# Ecosystem Map (${dirs.length} plugins)\n`, `> Auto-generated by cartographer — ${utcStamp(now)}\n`];
+	for (const name of dirs) {
+		const pluginPath = join(pluginsDir, name);
+		const [version, pkgName] = readPluginMeta(pluginPath);
+		const display = pkgName || name;
+		const items = scanPlugin(pluginPath);
+		const agents = items.filter(([t]) => t === "agent").map(([, n]) => n);
+		const ver = version ? ` (v${version})` : "";
+		lines.push(`- [${display}](./${display}/index.md)${ver} → ${agents.length ? agents.join(", ") : "(no agents)"}`);
+		writePluginMap(outputDir, display, version, items, pluginPath);
+		writePluginMap(pluginPath, ".cartographer", version, items, pluginPath);
+	}
+	const indexPath = join(outputDir, "index.md");
+	writeFileSync(indexPath, mergeLines(lines, indexPath).join("\n") + "\n", "utf-8");
+	return `Project map: .cartographer/project/index.md — navigate project files. Plugin skills map: ${outputDir}/index.md — navigate agent skills. Branches link to deeper index.md, leaves link to real files.`;
+}
+//#endregion
 //#region src/runtime/lifecycle/cartographer/session-start.ts
 /**
-* Cartographer SessionStart handler. Ports the project-map half of
-* `generate_project_map.py`: regenerates `.cartographer/project` and emits no
-* additionalContext (the plugin ecosystem map from `generate_map.py` is not
-* ported and stays as Python).
+* Cartographer SessionStart handler. Ports BOTH halves of the Python maps:
+* `generate_project_map.py` (regenerate `.cartographer/project`) and
+* `generate_map.py` (regenerate the plugin ecosystem map), emitting the
+* navigation context from the latter as additionalContext.
 */
 /**
-* Regenerate the project map for `cwd` on SessionStart. Returns "" (side-effect
-* only — no additionalContext).
+* Regenerate the project map + plugin ecosystem map for `cwd` on SessionStart.
+* Emits the ecosystem navigation context as additionalContext (or "").
 * @param cwd - The working directory.
-* @returns "" always.
+* @param now - Clock for the ecosystem map banner timestamp.
+* @returns The SessionStart additionalContext response, or "".
 */
-function cartoSessionStart(cwd) {
+function cartoSessionStart(cwd, now = Date.now()) {
 	generateProjectMap(cwd);
-	return "";
+	const ctx = generateEcosystemMap(now);
+	return ctx ? contextResponse("SessionStart", ctx) : "";
+}
+//#endregion
+//#region src/runtime/lifecycle/lessons/state.ts
+/**
+* Per-project lessons paths. The `fuse-lessons` plugin stores its lessons under
+* `<root>/MEMORY/` (NOT the harness `.harness/memory/`), so these two path
+* helpers override the layout while ALL state/gitignore/throttle logic is
+* reused from `src/memory` (`setStateField`, `ensureMemoryGitignore`,
+* `readState`, `nowStamp`, `throttleMs`).
+*/
+/** Absolute `<root>/MEMORY/LESSON.md` — the curated, committable lessons file. */
+function lessonsFileFor(root) {
+	return join(root, "MEMORY", "LESSON.md");
+}
+/** Absolute `<root>/MEMORY/state.json` — machine-local throttle counter. */
+function lessonsStateFileFor(root) {
+	return join(root, "MEMORY", "state.json");
+}
+//#endregion
+//#region src/runtime/lifecycle/lessons/dispatch.ts
+/**
+* fuse-lessons scope dispatch (TS port of the 4 handler scripts). Routes by
+* event: SessionStart/SubagentStart inject `MEMORY/LESSON.md`; Stop reminds
+* across every project with unsaved code edits; PostToolUse marks the write to
+* arm/silence the per-project throttle. Non-fatal by design.
+*/
+/** Inject `<root>/MEMORY/LESSON.md` as additionalContext for `event`. */
+function injectMemory(cwd, event) {
+	const file = lessonsFileFor(projectRoot(cwd));
+	if (!existsSync(file)) return "";
+	let content = "";
+	try {
+		content = readFileSync(file, "utf-8").trim();
+	} catch {
+		return "";
+	}
+	if (!content) return "";
+	return contextResponse(event, `Project lessons — never reproduce these:\n${content}\nYou may append OR refine/merge/dedupe bullets in MEMORY/LESSON.md — keep it terse.`);
+}
+/** Select roots with unsaved code edits past the throttle, bumping their state. */
+function collectPending(now, window) {
+	const pending = [];
+	for (const root of readRoots()) {
+		const stateFile = lessonsStateFileFor(root);
+		const { lastRemindedAt, lastCodeEditAt } = readState(stateFile);
+		if (lastCodeEditAt <= lastRemindedAt) continue;
+		if (now - lastRemindedAt < window) continue;
+		pending.push(root);
+		setStateField(stateFile, "lastRemindedAt", now);
+	}
+	return pending;
+}
+/** Stop: emit one reminder covering every project with pending lessons. */
+function remindWrite(now) {
+	const pending = collectPending(now, throttleMs());
+	if (pending.length === 0) return "";
+	return contextResponse("Stop", `Before ending: if this session hit a mistake/blocker worth never reproducing, append 1-3 COMPACT bullets OR sharpen/merge existing ones (format \`- [${nowStamp()}] what went wrong → do instead\`, use exactly this timestamp) in each project's lessons file below. Skip if nothing notable.\n${pending.map((r) => `- ${r}/MEMORY/LESSON.md`).join("\n")}`);
+}
+/** PostToolUse: record the relevant throttle timestamp for the edited file. */
+function markWrite(payload, now) {
+	const input = payload.tool_input;
+	if (!input?.file_path) return;
+	const abs = resolve(input.file_path);
+	const root = projectRootOrNull(dirname(abs));
+	if (!root) return;
+	const stateFile = lessonsStateFileFor(root);
+	if (abs === resolve(root, "MEMORY", "LESSON.md")) setStateField(stateFile, "lastRemindedAt", now);
+	else if (isCodeFile(abs)) {
+		setStateField(stateFile, "lastCodeEditAt", now);
+		addRoot(root);
+	}
+}
+/**
+* Route a fuse-lessons event to its handler. Returns the native stdout for
+* context-injecting events (SessionStart/SubagentStart/Stop) or "" for the
+* side-effect-only PostToolUse mark.
+* @param event - The raw hook event name.
+* @param payload - The raw hook payload.
+* @param cwd - Project root for memory injection.
+* @param now - Clock.
+* @returns The native stdout (possibly empty).
+*/
+function dispatchLessons(event, payload, cwd, now) {
+	switch (event) {
+		case "SessionStart":
+		case "SubagentStart": return injectMemory(cwd, event);
+		case "Stop": return remindWrite(now);
+		case "PostToolUse":
+			markWrite(payload, now);
+			return "";
+		default: return "";
+	}
 }
 //#endregion
 //#region src/runtime/lifecycle/aipilot/inject-apex.ts
@@ -2516,7 +2913,8 @@ async function aipilotPostToolUse(payload, cwd) {
 function sessionStart(input) {
 	if (input.scope === "solid") return solidDetectStart();
 	if (input.scope === "rules") return injectRules(process.env.CLAUDE_PLUGIN_ROOT ?? input.cwd);
-	if (input.scope === "carto") return cartoSessionStart(input.cwd);
+	if (input.scope === "carto") return cartoSessionStart(input.cwd, input.now);
+	if (input.scope === "lessons") return dispatchLessons("SessionStart", input.payload, input.cwd, input.now);
 	return sessionStartCore(input.cwd, void 0, input.now);
 }
 /**
@@ -2530,7 +2928,11 @@ function dispatchLifecycle(input) {
 	switch (input.event) {
 		case "SessionStart": return sessionStart(input);
 		case "UserPromptSubmit": return input.scope === "rules" ? injectRules(process.env.CLAUDE_PLUGIN_ROOT ?? input.cwd) : null;
-		case "SubagentStart": return input.scope === "aipilot" ? "" : subagentCacheContext(input.payload.session_id);
+		case "SubagentStart":
+			if (input.scope === "aipilot") return "";
+			if (input.scope === "lessons") return dispatchLessons("SubagentStart", input.payload, input.cwd, input.now);
+			return subagentCacheContext(input.payload.session_id);
+		case "Stop": return input.scope === "lessons" ? dispatchLessons("Stop", input.payload, input.cwd, input.now) : null;
 		case "SubagentStop": return input.scope === "aipilot" ? "" : trackAgentMemory(input.payload, void 0, input.now);
 		case "TeammateIdle": return validateTeammateOutput(input.payload);
 		case "PostToolUseFailure":
@@ -2715,13 +3117,16 @@ function trackWatchResearch(tool, input, now = Date.now(), home = homedir()) {
 /**
 * Dispatch the appropriate PostToolUse tracker for the invoking scope. Carto
 * persists manual enrichments; security records skill reads + MCP research;
-* changelog records watch research. Side-effect only.
+* changelog records watch research; lessons arms the per-project throttle.
+* Side-effect only.
 * @param scope - The invoking plugin scope.
 * @param event - The normalized event.
 * @param input - The raw tool input.
 * @param now - Clock.
+* @param payload - The raw hook payload (for the lessons mark).
+* @param cwd - The project root (for the lessons mark).
 */
-function postTrackingSideEffects(scope, event, input, now) {
+function postTrackingSideEffects(scope, event, input, now, payload = {}, cwd = process.cwd()) {
 	if (scope === "carto" && (event.tool === "Edit" || event.tool === "Write") && event.filePath) {
 		trackEnrichment(event.filePath);
 		return;
@@ -2731,7 +3136,11 @@ function postTrackingSideEffects(scope, event, input, now) {
 		trackMcpResearch(event.tool, input, now);
 		return;
 	}
-	if (scope === "changelog") trackWatchResearch(event.tool, input, now);
+	if (scope === "changelog") {
+		trackWatchResearch(event.tool, input, now);
+		return;
+	}
+	if (scope === "lessons") dispatchLessons("PostToolUse", payload, cwd, now);
 }
 //#endregion
 //#region src/runtime/lifecycle/security/check-skill.ts
@@ -2765,6 +3174,42 @@ function securityAdvisory(tool, filePath, now = Date.now(), home = homedir()) {
 	} });
 }
 //#endregion
+//#region src/runtime/lifecycle/seo/post-tool-use.ts
+/**
+* SEO PostToolUse handler (fs effects). Ports `seo/hooks/validate-seo.ts`: on an
+* edited HTML-like file under a `.fuse-seo` marker, deny when SEO elements are
+* missing. Opt-in only — silent when no marker / non-HTML / file unreadable.
+*/
+/**
+* Validate the edited file's SEO completeness. Returns a deny message (for a
+* `permissionDecision: deny` response) when HTML-like, opted-in, and missing
+* elements; otherwise `null` (allow).
+* @param payload - The raw PostToolUse payload.
+* @returns The deny reason string, or `null` to allow.
+*/
+function seoPostToolUse(payload) {
+	const path = payload.tool_input?.file_path;
+	if (!path || !isHtmlLike(path)) return null;
+	if (!walkUpFor(typeof payload.cwd === "string" ? payload.cwd : dirname(path), ".fuse-seo")) return null;
+	try {
+		const missing = missingSeoElements(readFileSync(path, "utf-8"));
+		if (missing.length === 0) return null;
+		return `fuse-seo: missing SEO elements in ${path}:\n  - ${missing.join("\n  - ")}`;
+	} catch {
+		return null;
+	}
+}
+/**
+* SEO PostToolUse as a ready native response: a `permissionDecision: deny`
+* string when the edited file is missing SEO elements, else `null` (allow).
+* @param payload - The raw PostToolUse payload.
+* @returns The deny response string, or `null` to allow.
+*/
+function seoPostToolUseResponse(payload) {
+	const deny = seoPostToolUse(payload);
+	return deny ? denyResponse("PostToolUse", deny) : null;
+}
+//#endregion
 //#region src/runtime/lifecycle-bridge.ts
 /** Raw event name from a payload (Cline lacks one; lifecycle is Claude-only). */
 function rawEvent(payload) {
@@ -3328,7 +3773,12 @@ async function handleHook(id, payload, opts) {
 			responseLength: extractText(response).length
 		});
 		if (activity) await recordActivity(file, activity);
-		postTrackingSideEffects(opts.scope ?? "core", event, event.input, opts.now);
+		postTrackingSideEffects(opts.scope ?? "core", event, event.input, opts.now, payload, opts.cwd);
+		const seoDeny = opts.scope === "seo" ? seoPostToolUseResponse(payload) : null;
+		if (seoDeny) return {
+			stdout: seoDeny,
+			exit: 0
+		};
 		if (opts.scope === "aipilot" && (event.tool === "TaskCreate" || event.tool === "TaskUpdate")) {
 			const out = await aipilotPostToolUse(payload, opts.cwd);
 			if (out) return {
@@ -3353,4 +3803,4 @@ async function handleHook(id, payload, opts) {
 	});
 }
 //#endregion
-export { purgeTtlTree as $, isProject as A, cleanupSession as B, todayUtc as C, activityFor as Ct, dispatchAipilot as D, aipilotPostToolUse as E, getFileDesc as F, subagentCacheContext as G, logToolFailure as H, listChildren as I, injectRules as J, detectSolidProfile as K, postEditTypescript as L, loadEnriched as M, mergeLines as N, cartoSessionStart as O, countFiles as P, pruneEmptyDirs as Q, trackSessionChanges as R, securityStatePath as S, queryOf as St, dispatchLifecycle as T, validateTeammateOutput as U, saveApexState as V, trackAgentMemory as W, runSessionStartCleanups as X, readRules as Y, sessionStartCore as Z, trackSkillRead as _, normalizeEvent as _t, TRIVIAL_BUDGET as a, claudeHome as at, saveSecurityState as b, mcpPostStore as bt, detectDuplication as c, sanitizeSessionId as ct, lifecycleStdout as d, sessionsDir as dt, removeOldFiles as et, postEditContext as f, promptSubmitContext as ft, trackMcpResearch as g, trackFile as gt, trackWatchResearch as h, recordActivity as ht, REQUIRED_AGENTS as i, projectContext as it, writeTree as j, generateProjectMap as k, dryGate as l, saveSessionState as lt, postTrackingSideEffects as m, respond as mt, handlePre as n, devContext as nt, gate as o, fusengineCache as ot, securityAdvisory as p, taskContext as pt, solidDetectStart as q, DEFAULT_WINDOW_MS as r, gitContext as rt, preCommitGate as s, loadSessionState as st, handleHook as t, trimLogFile as tt, extractSymbols as u, sessionStatePath as ut, isoUtc as v, MCP_TTL_MS as vt, trackEnrichment as w, securityStateDir as x, mcpPreIntercept as xt, loadSecurityState as y, isMcpTool as yt, validateRulesLoaded as z };
+export { detectSolidProfile as $, dispatchLessons as A, activityFor as At, mergeLines as B, securityStateDir as C, trackFile as Ct, dispatchLifecycle as D, mcpPostStore as Dt, trackEnrichment as E, isMcpTool as Et, writePluginMap as F, trackSessionChanges as G, getFileDesc as H, generateProjectMap as I, saveApexState as J, validateRulesLoaded as K, isProject as L, lessonsStateFileFor as M, cartoSessionStart as N, aipilotPostToolUse as O, mcpPreIntercept as Ot, generateEcosystemMap as P, subagentCacheContext as Q, writeTree as R, saveSecurityState as S, recordActivity as St, todayUtc as T, MCP_TTL_MS as Tt, listChildren as U, countFiles as V, postEditTypescript as W, validateTeammateOutput as X, logToolFailure as Y, trackAgentMemory as Z, trackWatchResearch as _, sessionStatePath as _t, TRIVIAL_BUDGET as a, pruneEmptyDirs as at, isoUtc as b, taskContext as bt, detectDuplication as c, trimLogFile as ct, lifecycleStdout as d, projectContext as dt, solidDetectStart as et, postEditContext as f, claudeHome as ft, postTrackingSideEffects as g, saveSessionState as gt, securityAdvisory as h, sanitizeSessionId as ht, REQUIRED_AGENTS as i, sessionStartCore as it, lessonsFileFor as j, dispatchAipilot as k, queryOf as kt, dryGate as l, devContext as lt, seoPostToolUseResponse as m, loadSessionState as mt, handlePre as n, readRules as nt, gate as o, purgeTtlTree as ot, seoPostToolUse as p, fusengineCache as pt, cleanupSession as q, DEFAULT_WINDOW_MS as r, runSessionStartCleanups as rt, preCommitGate as s, removeOldFiles as st, handleHook as t, injectRules as tt, extractSymbols as u, gitContext as ut, trackMcpResearch as v, sessionsDir as vt, securityStatePath as w, normalizeEvent as wt, loadSecurityState as x, respond as xt, trackSkillRead as y, promptSubmitContext as yt, loadEnriched as z };

package/dist/{index-C1vLIMwN.d.mts → index-BEMumjOw.d.mts}

@@ -10,6 +10,13 @@ declare function compactJson(data: unknown): string;
 /** True for a source-code file outside generated/vendored directories. */
 declare function isCodeFile(p: string): boolean;
 /**
+* Walk up from `dir` to the nearest ancestor directory containing `marker`.
+* @param dir - Starting directory.
+* @param marker - Sibling file/dir name to look for at each level.
+* @returns The ancestor holding `marker`, or `null` at filesystem root.
+*/
+declare function walkUpFor(dir: string, marker: string): string | null;
+/**
 * Resolve the project root, preferring the repo boundary (`.git`) over a
 * nested `package.json` — avoids false roots in monorepos. Null if none found.
 */
@@ -17,4 +24,4 @@ declare function projectRootOrNull(dir: string): string | null;
 /** Like {@link projectRootOrNull} but falls back to `process.cwd()`. */
 declare function projectRoot(dir: string): string;
 //#endregion
-export { compactJson as i, projectRoot as n, projectRootOrNull as r, isCodeFile as t };
+export { compactJson as a, walkUpFor as i, projectRoot as n, projectRootOrNull as r, isCodeFile as t };

package/dist/{index-mISsk0ff.d.mts → index-DmbOUJK8.d.mts}

@@ -435,4 +435,15 @@ declare function firstComment(text: string): string;
 */
 declare function descFromText(suffix: string, text: string, mdField: string): string;
 //#endregion
-export { ApexGate as $, registerGuard as A, ASK_WRITERS as B, MAX_EXA_RESULTS as C, requiredArchSkill as Ct, FAIL_CLOSED as D, detectCreationIntent as E, PHP_DECL_RE as F, protectedPathGuard as G, CODE_REDIRECT as H, PY_MODEL_RE as I, securityGuard as J, ASK_PATTERNS as K, SWIFT_PROTO_RE as L, installGuard as M, GO_DECL_RE as N, GUARDS as O, JAVA_DECL_RE as P, ApexContext as Q, TS_DECL_RE as R, frameworkSolidGate as S, isApexCommand as St, capVerbosity as T, bashWriteGuard as U, CODE_MUTATORS as V, PROTECTED_FRAGMENTS as W, GuardContext as X, Guard as Y, APEX_GATES as Z, buildClaudeMdContext as _, DEV_KEYWORDS as _t, parseEnrichment as a, PolicyContext as at, skillTriggerGate as b, detectModularArchitecture as bt, parseField as c, GIT_ASK as ct, ApexTaskState as d, SYSTEM_INSTALL as dt, brainstormGate as et, buildApexTaskContext as f, matchPatterns as ft, buildApexInstruction as g, detectFramework as gt, DEV_VERBS as h, evaluateFileSize as ht, TreeEntry as i, solidReadGate as it, runGuards as j, clearUserGuards as k, EXCLUDE_DIRS as l, GIT_BLOCKED as lt, loadApexTaskState as m, countLines as mt, firstComment as n, evaluateApex as nt, parseEntry as o, PolicyResult as ot, buildApexTaskInjection as p, FileSizeVerdict as pt, CRITICAL_PATTERNS as q, firstHeading as r, freshnessGate as rt, parseBodyDesc as s, evaluate as st, descFromText as t, docConsultedGate as tt, PROJECT_INDICATORS as u, PROJECT_INSTALL as ut, detectClaudeMdProjectType as v, ModularArchitecture as vt, MAX_TOKENS as w, SKILL_TRIGGERS as x, detectProjectType as xt, detectRequiredSkills as y, ProjectType as yt, interfaceSeparationGuard as z };
+//#region src/policy/seo/validate.d.ts
+/** True when `path` is an HTML-like file the SEO hook should validate. */
+declare function isHtmlLike(path: string): boolean;
+/**
+* Report the SEO elements missing from HTML-like content (title, meta
+* description, OG title/description/image, canonical, JSON-LD schema).
+* @param html - The file content.
+* @returns The missing element labels (empty when complete).
+*/
+declare function missingSeoElements(html: string): string[];
+//#endregion
+export { APEX_GATES as $, GUARDS as A, TS_DECL_RE as B, SKILL_TRIGGERS as C, detectProjectType as Ct, capVerbosity as D, MAX_TOKENS as E, GO_DECL_RE as F, bashWriteGuard as G, ASK_WRITERS as H, JAVA_DECL_RE as I, ASK_PATTERNS as J, PROTECTED_FRAGMENTS as K, PHP_DECL_RE as L, registerGuard as M, runGuards as N, detectCreationIntent as O, installGuard as P, GuardContext as Q, PY_MODEL_RE as R, skillTriggerGate as S, detectModularArchitecture as St, MAX_EXA_RESULTS as T, requiredArchSkill as Tt, CODE_MUTATORS as U, interfaceSeparationGuard as V, CODE_REDIRECT as W, securityGuard as X, CRITICAL_PATTERNS as Y, Guard as Z, DEV_VERBS as _, evaluateFileSize as _t, firstHeading as a, freshnessGate as at, detectClaudeMdProjectType as b, ModularArchitecture as bt, parseEntry as c, PolicyResult as ct, EXCLUDE_DIRS as d, GIT_BLOCKED as dt, ApexContext as et, PROJECT_INDICATORS as f, PROJECT_INSTALL as ft, loadApexTaskState as g, countLines as gt, buildApexTaskInjection as h, FileSizeVerdict as ht, firstComment as i, evaluateApex as it, clearUserGuards as j, FAIL_CLOSED as k, parseBodyDesc as l, evaluate as lt, buildApexTaskContext as m, matchPatterns as mt, missingSeoElements as n, brainstormGate as nt, TreeEntry as o, solidReadGate as ot, ApexTaskState as p, SYSTEM_INSTALL as pt, protectedPathGuard as q, descFromText as r, docConsultedGate as rt, parseEnrichment as s, PolicyContext as st, isHtmlLike as t, ApexGate as tt, parseField as u, GIT_ASK as ut, buildApexInstruction as v, detectFramework as vt, frameworkSolidGate as w, isApexCommand as wt, detectRequiredSkills as x, ProjectType as xt, buildClaudeMdContext as y, DEV_KEYWORDS as yt, SWIFT_PROTO_RE as z };

package/dist/index.d.mts

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

package/dist/index.mjs

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

package/dist/memory/index.mjs

@@ -1,2 +1,3 @@
-import { a as nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs, n as readRoots, o as readState, r as registryFile, s as setStateField, t as addRoot, u as ensureMemoryGitignore } from "../memory-BkoEbdec.mjs";
+import { a as nowStamp, c as stateFileFor, i as lessonsFileFor, l as throttleMs, n as readRoots, o as readState, r as registryFile, s as setStateField, t as addRoot, u as ensureMemoryGitignore } from "../registry-BkoEbdec.mjs";
+import "../memory-la_KkjCS.mjs";
 export { addRoot, ensureMemoryGitignore, lessonsFileFor, nowStamp, readRoots, readState, registryFile, setStateField, stateFileFor, throttleMs };

package/dist/memory-la_KkjCS.mjs

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

package/dist/policy/index.d.mts

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

package/dist/policy/index.mjs

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

package/dist/{project-root-ff0_poWU.mjs → project-root-3kk7gCOp.mjs}

@@ -9,6 +9,12 @@ const SKIP_DIRS = /(node_modules|vendor|dist|build|\.next|DerivedData|\.git)/;
 function isCodeFile(p) {
 	return CODE_EXT.test(p) && !SKIP_DIRS.test(p);
 }
+/**
+* Walk up from `dir` to the nearest ancestor directory containing `marker`.
+* @param dir - Starting directory.
+* @param marker - Sibling file/dir name to look for at each level.
+* @returns The ancestor holding `marker`, or `null` at filesystem root.
+*/
 function walkUpFor(dir, marker) {
 	let current = resolve(dir);
 	while (current !== "/") {
@@ -29,4 +35,4 @@ function projectRoot(dir) {
 	return projectRootOrNull(dir) ?? process.cwd();
 }
 //#endregion
-export { projectRoot as n, projectRootOrNull as r, isCodeFile as t };
+export { walkUpFor as i, projectRoot as n, projectRootOrNull as r, isCodeFile as t };

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

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

@@ -366,7 +366,7 @@ declare function aipilotPostToolUse(payload: Record<string, unknown>, cwd: strin
 //#endregion
 //#region src/runtime/lifecycle/dispatch.d.ts
 /** Which plugin's hooks.json invoked the harness (selects SessionStart behavior). */
-type PluginScope = "core" | "solid" | "rules" | "carto" | "security" | "changelog" | "aipilot";
+type PluginScope = "core" | "solid" | "rules" | "carto" | "security" | "changelog" | "aipilot" | "lessons" | "seo";
 /** Inputs the lifecycle dispatcher needs (clock + roots injected). */
 interface LifecycleInput {
   event: string;
@@ -388,13 +388,16 @@ declare function dispatchLifecycle(input: LifecycleInput): string | null;
 /**
 * Dispatch the appropriate PostToolUse tracker for the invoking scope. Carto
 * persists manual enrichments; security records skill reads + MCP research;
-* changelog records watch research. Side-effect only.
+* changelog records watch research; lessons arms the per-project throttle.
+* Side-effect only.
 * @param scope - The invoking plugin scope.
 * @param event - The normalized event.
 * @param input - The raw tool input.
 * @param now - Clock.
+* @param payload - The raw hook payload (for the lessons mark).
+* @param cwd - The project root (for the lessons mark).
 */
-declare function postTrackingSideEffects(scope: PluginScope, event: NormalizedEvent, input: Record<string, unknown>, now: number): void;
+declare function postTrackingSideEffects(scope: PluginScope, event: NormalizedEvent, input: Record<string, unknown>, now: number, payload?: Record<string, unknown>, cwd?: string): void;
 //#endregion
 //#region src/runtime/lifecycle/changelog-research.d.ts
 /**
@@ -409,12 +412,13 @@ declare function trackWatchResearch(tool: string, input: Record<string, unknown>
 //#endregion
 //#region src/runtime/lifecycle/cartographer/session-start.d.ts
 /**
-* Regenerate the project map for `cwd` on SessionStart. Returns "" (side-effect
-* only — no additionalContext).
+* Regenerate the project map + plugin ecosystem map for `cwd` on SessionStart.
+* Emits the ecosystem navigation context as additionalContext (or "").
 * @param cwd - The working directory.
-* @returns "" always.
+* @param now - Clock for the ecosystem map banner timestamp.
+* @returns The SessionStart additionalContext response, or "".
 */
-declare function cartoSessionStart(cwd: string): string;
+declare function cartoSessionStart(cwd: string, now?: number): string;
 //#endregion
 //#region src/runtime/lifecycle/cartographer/project-map.d.ts
 /**
@@ -539,6 +543,71 @@ declare function loadSecurityState(now?: number, home?: string): Record<string,
 /** Persist today's security state (indent 2, no trailing newline). */
 declare function saveSecurityState(state: Record<string, unknown>, now?: number, home?: string): void;
 //#endregion
+//#region src/runtime/lifecycle/lessons/dispatch.d.ts
+/**
+* Route a fuse-lessons event to its handler. Returns the native stdout for
+* context-injecting events (SessionStart/SubagentStart/Stop) or "" for the
+* side-effect-only PostToolUse mark.
+* @param event - The raw hook event name.
+* @param payload - The raw hook payload.
+* @param cwd - Project root for memory injection.
+* @param now - Clock.
+* @returns The native stdout (possibly empty).
+*/
+declare function dispatchLessons(event: string, payload: Record<string, unknown>, cwd: string, now: number): string;
+//#endregion
+//#region src/runtime/lifecycle/lessons/state.d.ts
+/** Absolute `<root>/MEMORY/LESSON.md` — the curated, committable lessons file. */
+declare function lessonsFileFor(root: string): string;
+/** Absolute `<root>/MEMORY/state.json` — machine-local throttle counter. */
+declare function lessonsStateFileFor(root: string): string;
+//#endregion
+//#region src/runtime/lifecycle/seo/post-tool-use.d.ts
+/**
+* Validate the edited file's SEO completeness. Returns a deny message (for a
+* `permissionDecision: deny` response) when HTML-like, opted-in, and missing
+* elements; otherwise `null` (allow).
+* @param payload - The raw PostToolUse payload.
+* @returns The deny reason string, or `null` to allow.
+*/
+declare function seoPostToolUse(payload: Record<string, unknown>): string | null;
+/**
+* SEO PostToolUse as a ready native response: a `permissionDecision: deny`
+* string when the edited file is missing SEO elements, else `null` (allow).
+* @param payload - The raw PostToolUse payload.
+* @returns The deny response string, or `null` to allow.
+*/
+declare function seoPostToolUseResponse(payload: Record<string, unknown>): string | null;
+//#endregion
+//#region src/runtime/lifecycle/cartographer/ecosystem-map.d.ts
+/**
+* Generate the plugin ecosystem map under `<pluginsDir>/.cartographer`.
+* @param now - Clock for the banner timestamp.
+* @param pluginsDirOverride - Override for the marketplace plugins directory.
+* @returns The map navigation context, or "".
+*/
+declare function generateEcosystemMap(now: number, pluginsDirOverride?: string): string;
+//#endregion
+//#region src/policy/cartographer/build-tree.d.ts
+/**
+* Indented Unicode tree from scanned plugin items — pure text in, markdown out
+* (no fs). Ports `build_tree.py`.
+*/
+/** A scanned `[type, name, desc]` plugin item (agent/skill/command/hooks). */
+type ScanRow = readonly [type: string, name: string, desc: string];
+//#endregion
+//#region src/runtime/lifecycle/cartographer/write-plugin-map.d.ts
+/**
+* Write `<outputDir>/<pluginName>/index.md` (indented linked tree) and recurse
+* agents/skills/commands into their own index trees rooted there.
+* @param outputDir - The map root directory.
+* @param pluginName - Display name of the plugin (the index subfolder).
+* @param version - Plugin version ("" to omit).
+* @param items - The scanned `[type, name, desc]` rows.
+* @param pluginPath - Absolute source plugin directory (for recursion).
+*/
+declare function writePluginMap(outputDir: string, pluginName: string, version: string, items: ReadonlyArray<ScanRow>, pluginPath: string): void;
+//#endregion
 //#region src/runtime/lifecycle-bridge.d.ts
 /**
 * Run the ported lifecycle/session/context hooks (SessionStart, SubagentStart/
@@ -609,4 +678,4 @@ interface PreContext {
 */
 declare function handlePre(ctx: PreContext): Promise<HandleOutcome>;
 //#endregion
-export { Activity, DEFAULT_WINDOW_MS, DuplicationVerdict, type GateInput, HandleOptions, HandleOutcome, LifecycleInput, MCP_TTL_MS, McpIntercept, NormalizedEvent, PluginScope, PreContext, REQUIRED_AGENTS, SolidProfile, TRIVIAL_BUDGET, ToolEvent, activityFor, aipilotPostToolUse, cartoSessionStart, claudeHome, cleanupSession, countFiles, detectDuplication, detectSolidProfile, devContext, dispatchAipilot, dispatchLifecycle, dryGate, extractSymbols, fusengineCache, gate, generateProjectMap, getFileDesc, gitContext, handleHook, handlePre, harnessStateDir, injectRules, isMcpTool, isProject, isoUtc, lifecycleStdout, listChildren, loadEnriched, loadSecurityState, loadSessionState, logToolFailure, mcpPostStore, mcpPreIntercept, mergeLines, normalizeEvent, postEditContext, postEditTypescript, postTrackingSideEffects, preCommitGate, projectContext, promptSubmitContext, pruneEmptyDirs, purgeTtlTree, queryOf, readRules, recordActivity, removeOldFiles, respond, runSessionStartCleanups, sanitizeSessionId, saveApexState, saveSecurityState, saveSessionState, securityAdvisory, securityStateDir, securityStatePath, sessionStartCore, sessionStatePath, sessionsDir, solidDetectStart, subagentCacheContext, taskContext, todayUtc, trackAgentMemory, trackEnrichment, trackFile, trackMcpResearch, trackSessionChanges, trackSkillRead, trackWatchResearch, trimLogFile, validateRulesLoaded, validateTeammateOutput, writeTree };
+export { Activity, DEFAULT_WINDOW_MS, DuplicationVerdict, type GateInput, HandleOptions, HandleOutcome, LifecycleInput, MCP_TTL_MS, McpIntercept, NormalizedEvent, PluginScope, PreContext, REQUIRED_AGENTS, SolidProfile, TRIVIAL_BUDGET, ToolEvent, activityFor, aipilotPostToolUse, cartoSessionStart, claudeHome, cleanupSession, countFiles, detectDuplication, detectSolidProfile, devContext, dispatchAipilot, dispatchLessons, dispatchLifecycle, dryGate, extractSymbols, fusengineCache, gate, generateEcosystemMap, generateProjectMap, getFileDesc, gitContext, handleHook, handlePre, harnessStateDir, injectRules, isMcpTool, isProject, isoUtc, lessonsFileFor, lessonsStateFileFor, lifecycleStdout, listChildren, loadEnriched, loadSecurityState, loadSessionState, logToolFailure, mcpPostStore, mcpPreIntercept, mergeLines, normalizeEvent, postEditContext, postEditTypescript, postTrackingSideEffects, preCommitGate, projectContext, promptSubmitContext, pruneEmptyDirs, purgeTtlTree, queryOf, readRules, recordActivity, removeOldFiles, respond, runSessionStartCleanups, sanitizeSessionId, saveApexState, saveSecurityState, saveSessionState, securityAdvisory, securityStateDir, securityStatePath, seoPostToolUse, seoPostToolUseResponse, sessionStartCore, sessionStatePath, sessionsDir, solidDetectStart, subagentCacheContext, taskContext, todayUtc, trackAgentMemory, trackEnrichment, trackFile, trackMcpResearch, trackSessionChanges, trackSkillRead, trackWatchResearch, trimLogFile, validateRulesLoaded, validateTeammateOutput, writePluginMap, writeTree };

package/dist/runtime/index.mjs

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

package/dist/util/index.d.mts

@@ -1,2 +1,2 @@
-import { i as compactJson, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../index-C1vLIMwN.mjs";
-export { compactJson, isCodeFile, projectRoot, projectRootOrNull };
+import { a as compactJson, i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../index-BEMumjOw.mjs";
+export { compactJson, isCodeFile, projectRoot, projectRootOrNull, walkUpFor };

package/dist/util/index.mjs

@@ -1,4 +1,4 @@
 import { t as compactJson } from "../compact-json-DK2nX-MK.mjs";
-import { n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../project-root-ff0_poWU.mjs";
+import { i as walkUpFor, n as projectRoot, r as projectRootOrNull, t as isCodeFile } from "../project-root-3kk7gCOp.mjs";
 import "../util-la_KkjCS.mjs";
-export { compactJson, isCodeFile, projectRoot, projectRootOrNull };
+export { compactJson, isCodeFile, projectRoot, projectRootOrNull, walkUpFor };

package/dist/{describe-BYqhoV4c.mjs → validate-CccewDwk.mjs}

@@ -1,5 +1,5 @@
 import { r as resolveMaxLines } from "./limits-CHn8AIL1.mjs";
-import { k as countLines } from "./evaluate-j3gRJ_ng.mjs";
+import { k as countLines } from "./evaluate-9ch1K2kt.mjs";
 import { r as isDocConsulted, t as formatDocDeny } from "./doc-helpers-Dd_x1-tZ.mjs";
 import { t as routeReferences } from "./router-D8cVrI-s.mjs";
 import { join } from "node:path";
@@ -1034,4 +1034,49 @@ function descFromText(suffix, text, mdField) {
 	return "";
 }
 //#endregion
-export { solidReadGate as A, capVerbosity as C, docConsultedGate as D, brainstormGate as E, requiredArchSkill as F, detectModularArchitecture as M, detectProjectType as N, evaluateApex as O, isApexCommand as P, MAX_TOKENS as S, APEX_GATES as T, detectRequiredSkills as _, parseEntry as a, frameworkSolidGate as b, EXCLUDE_DIRS as c, buildApexTaskInjection as d, loadApexTaskState as f, detectClaudeMdProjectType as g, buildClaudeMdContext as h, parseEnrichment as i, DEV_KEYWORDS as j, freshnessGate as k, PROJECT_INDICATORS as l, buildApexInstruction as m, firstComment as n, parseBodyDesc as o, DEV_VERBS as p, firstHeading as r, parseField as s, descFromText as t, buildApexTaskContext as u, skillTriggerGate as v, detectCreationIntent as w, MAX_EXA_RESULTS as x, SKILL_TRIGGERS as y };
+//#region src/policy/seo/validate.ts
+/**
+* SEO completeness checks — pure text in, missing-items out (no fs). Ports the
+* `validate()` of `seo/hooks/validate-seo.ts` using regex instead of cheerio so
+* the harness keeps zero runtime HTML-parser dependency (presence-only gate).
+*/
+/** Extensions the SEO hook validates (HTML-like rendered output). */
+const HTML_LIKE = /\.(html|astro|tsx|vue|blade\.php)$/;
+/** True when `path` is an HTML-like file the SEO hook should validate. */
+function isHtmlLike(path) {
+	return HTML_LIKE.test(path);
+}
+/** True when a `<tag …>…</tag>` carries non-empty inner text. */
+function hasNonEmptyTag(html, tag) {
+	const m = new RegExp(`<${tag}[\\s>][\\s\\S]*?</${tag}>`, "i").exec(html);
+	return !!m && m[0].replace(/<[^>]*>/g, "").trim().length > 0;
+}
+/** True when a `<meta …>` whose `selAttr=selVal` has a non-empty `content`. */
+function hasMetaContent(html, selAttr, selVal) {
+	const tag = new RegExp(`<meta\\b[^>]*\\b${selAttr}\\s*=\\s*["']${selVal}["'][^>]*>`, "i").exec(html)?.[0] ?? "";
+	return (/\bcontent\s*=\s*["']([^"']*)["']/i.exec(tag)?.[1] ?? "").trim().length > 0;
+}
+/** True when a `<link rel="canonical">` carries a non-empty `href`. */
+function hasCanonical(html) {
+	const tag = /<link\b[^>]*\brel\s*=\s*["']canonical["'][^>]*>/i.exec(html)?.[0] ?? "";
+	return (/\bhref\s*=\s*["']([^"']*)["']/i.exec(tag)?.[1] ?? "").trim().length > 0;
+}
+/**
+* Report the SEO elements missing from HTML-like content (title, meta
+* description, OG title/description/image, canonical, JSON-LD schema).
+* @param html - The file content.
+* @returns The missing element labels (empty when complete).
+*/
+function missingSeoElements(html) {
+	const missing = [];
+	if (!hasNonEmptyTag(html, "title")) missing.push("<title>");
+	if (!hasMetaContent(html, "name", "description")) missing.push("<meta name='description'>");
+	if (!hasMetaContent(html, "property", "og:title")) missing.push("og:title");
+	if (!hasMetaContent(html, "property", "og:description")) missing.push("og:description");
+	if (!hasMetaContent(html, "property", "og:image")) missing.push("og:image");
+	if (!hasCanonical(html)) missing.push("canonical");
+	if (!/<script\b[^>]*type\s*=\s*["']application\/ld\+json["']/i.test(html)) missing.push("JSON-LD schema");
+	return missing;
+}
+//#endregion
+export { evaluateApex as A, MAX_EXA_RESULTS as C, APEX_GATES as D, detectCreationIntent as E, detectProjectType as F, isApexCommand as I, requiredArchSkill as L, solidReadGate as M, DEV_KEYWORDS as N, brainstormGate as O, detectModularArchitecture as P, frameworkSolidGate as S, capVerbosity as T, buildClaudeMdContext as _, firstHeading as a, skillTriggerGate as b, parseBodyDesc as c, PROJECT_INDICATORS as d, buildApexTaskContext as f, buildApexInstruction as g, DEV_VERBS as h, firstComment as i, freshnessGate as j, docConsultedGate as k, parseField as l, loadApexTaskState as m, missingSeoElements as n, parseEnrichment as o, buildApexTaskInjection as p, descFromText as r, parseEntry as s, isHtmlLike as t, EXCLUDE_DIRS as u, detectClaudeMdProjectType as v, MAX_TOKENS as w, SKILL_TRIGGERS as x, detectRequiredSkills as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fusengine/harness",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "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",