@fusengine/harness 0.1.31 → 0.1.33

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

@@ -1,20 +1,21 @@
 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 { c as pathExists, d as spawnCapture, f as writeText, l as readText, n as denyResponse, s as collectFiles, t as contextResponse, u as sleep } from "./claude-BatVYnAf.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";
 import { createHash } from "node:crypto";
 import { mkdir, rmdir } from "node:fs/promises";
 import { execFileSync } from "node:child_process";
-import { Glob } from "bun";
 //#region src/runtime/activity.ts
 /** Min response length (chars) for a lead agent call to count as `sufficient`. */
 const AGENT_QUALITY_MIN = 500;
@@ -1459,22 +1460,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
@@ -1513,8 +1909,8 @@ function cartographerContext() {
 async function injectApexSubagentContext(cwd, home = homedir()) {
 	const apexDir = join(process.env.CLAUDE_PROJECT_DIR ?? cwd, ".claude", "apex");
 	if (!existsSync(apexDir)) return "";
-	const agentsFile = Bun.file(join(apexDir, "AGENTS.md"));
-	const agents = await agentsFile.exists() ? (await agentsFile.text()).slice(0, 4e3) : "";
+	const agentsPath = join(apexDir, "AGENTS.md");
+	const agents = existsSync(agentsPath) ? readText(agentsPath).slice(0, 4e3) : "";
 	const taskData = await readJsonFile(join(apexDir, "task.json"));
 	return contextResponse("SubagentStart", `## APEX Sub-Agent Instructions
 
@@ -1570,7 +1966,7 @@ function cacheAge(ts, now = Date.now()) {
 /** Full SHA-256 hex checksum of a file's text; "" when unreadable. */
 async function fileChecksum(path) {
 	try {
-		return createHash("sha256").update(await Bun.file(path).text()).digest("hex");
+		return createHash("sha256").update(readText(path)).digest("hex");
 	} catch {
 		return "";
 	}
@@ -1639,9 +2035,8 @@ function parseEntries(raw) {
 async function cacheAnalyticsSave(home = homedir(), now = Date.now()) {
 	const dir = join(cacheBaseDir(home), "analytics");
 	const sessionsFile = join(dir, "sessions.jsonl");
-	const file = Bun.file(sessionsFile);
-	if (!await file.exists()) return;
-	const raw = await file.text();
+	if (!pathExists(sessionsFile)) return;
+	const raw = readText(sessionsFile);
 	if (!raw.trim()) return;
 	const entries = parseEntries(raw);
 	if (entries.length === 0) return;
@@ -1669,8 +2064,7 @@ async function cacheAnalyticsSave(home = homedir(), now = Date.now()) {
 	}
 	await writeJsonFile(join(dir, "summary.json"), merged, true);
 	const cutoff = (/* @__PURE__ */ new Date(now - 30 * 864e5)).toISOString();
-	const kept = entries.filter((e) => e.ts >= cutoff);
-	await Bun.write(sessionsFile, kept.map((e) => JSON.stringify(e)).join("\n") + "\n");
+	writeText(sessionsFile, entries.filter((e) => e.ts >= cutoff).map((e) => JSON.stringify(e)).join("\n") + "\n");
 }
 //#endregion
 //#region src/runtime/lifecycle/aipilot/inject-explore.ts
@@ -1694,17 +2088,11 @@ const CONFIG_FILES = [
 /** Compute a config hash from git-tracked config files; "noconfig" on failure. */
 async function configHash(cwd) {
 	try {
-		const proc = Bun.spawn([
-			"git",
+		const output = spawnCapture("git", [
 			"ls-tree",
 			"HEAD",
 			...CONFIG_FILES
-		], {
-			cwd,
-			stdout: "pipe",
-			stderr: "ignore"
-		});
-		const output = await new Response(proc.stdout).text();
+		], cwd);
 		return output.trim() ? hashText16(output) : "noconfig";
 	} catch {
 		return "noconfig";
@@ -1730,8 +2118,7 @@ async function injectExploreCache(cwd, home = homedir(), now = Date.now()) {
 	const cfgHash = await configHash(projPath);
 	let context = "";
 	const meta = await readJsonFile(metaFile);
-	const snapBunFile = Bun.file(snapFile);
-	const snapshot = await snapBunFile.exists() ? await snapBunFile.text() : "";
+	const snapshot = pathExists(snapFile) ? readText(snapFile) : "";
 	if (meta?.timestamp && snapshot) {
 		const age = cacheAge(meta.timestamp, now);
 		if (age < TTL_SECONDS$2 && meta.config_hash === cfgHash) {
@@ -1767,9 +2154,9 @@ async function buildDocsContext(entries, docsDir, now) {
 		if (age > maxAge) maxAge = age;
 		if (!entry.hash || seen.has(entry.hash)) continue;
 		seen.add(entry.hash);
-		const file = Bun.file(join(docsDir, `${entry.hash}.md`));
-		if (!await file.exists()) continue;
-		const content = await file.text();
+		const docPath = join(docsDir, `${entry.hash}.md`);
+		if (!pathExists(docPath)) continue;
+		const content = readText(docPath);
 		if (!content) continue;
 		ctx += `\n${content}\n`;
 		count++;
@@ -1805,32 +2192,36 @@ async function injectDocCache(cwd, home = homedir(), now = Date.now()) {
 * Ported from the ai-pilot plugin's `cache/source-collector.ts` +
 * the stack detection in `cache/lesson-helpers.ts` (now removed).
 */
-/** Source file glob patterns (monorepo-aware; separate to avoid brace-wildcards). */
-const SRC_PATTERNS = [
-	"src/**/*.{ts,tsx,js,jsx}",
-	"app/**/*.{ts,tsx,js,jsx}",
-	"apps/*/src/**/*.{ts,tsx,js,jsx}",
-	"packages/*/src/**/*.{ts,tsx,js,jsx}"
-];
+/** Source extensions to collect (monorepo-aware, dot-prefixed for matching). */
+const SRC_EXTS = /* @__PURE__ */ new Set([
+	".ts",
+	".tsx",
+	".js",
+	".jsx"
+]);
+/** Roots walked: `src`, `app`, plus each child `src` under `apps/` and `packages/`. */
+const TOP_DIRS = ["src", "app"];
+const NESTED_PARENTS = ["apps", "packages"];
+/** Collect the existing monorepo `src` roots nested under `apps/` and `packages/`. */
+function nestedRoots(projectPath) {
+	const roots = [];
+	for (const parent of NESTED_PARENTS) try {
+		for (const e of readdirSync(join(projectPath, parent), { withFileTypes: true })) if (e.isDirectory()) roots.push(join(projectPath, parent, e.name, "src"));
+	} catch {}
+	return roots;
+}
 /**
 * Scan source files in `projectPath` (monorepo-aware), capped at `maxFiles`.
+* Node+Bun portable: walks `node:fs` recursively (replaces the Bun `Glob`).
 * @param projectPath - Absolute project root.
 * @param maxFiles - Max files to collect (default 200).
-* @returns Absolute paths matching the source patterns.
+* @returns Absolute paths matching the source extensions.
 */
 async function scanSourceFiles(projectPath, maxFiles = 200) {
 	const files = [];
-	for (const pattern of SRC_PATTERNS) {
-		try {
-			for await (const p of new Glob(pattern).scan({
-				cwd: projectPath,
-				absolute: true
-			})) {
-				if (p.includes("node_modules")) continue;
-				files.push(p);
-				if (files.length >= maxFiles) break;
-			}
-		} catch {}
+	const roots = [...TOP_DIRS.map((d) => join(projectPath, d)), ...nestedRoots(projectPath)];
+	for (const root of roots) {
+		collectFiles(root, SRC_EXTS, files, maxFiles);
 		if (files.length >= maxFiles) break;
 	}
 	return files;
@@ -2058,7 +2449,7 @@ function projectRootFromPaths(filePaths) {
 }
 /** Extract all absolute file paths from tool_use entries in a JSONL transcript. */
 async function transcriptFilePaths(transcriptPath) {
-	const text = await Bun.file(transcriptPath).text();
+	const text = readText(transcriptPath);
 	const paths = /* @__PURE__ */ new Set();
 	for (const line of text.split("\n").filter(Boolean)) try {
 		const content = JSON.parse(line)?.message?.content;
@@ -2073,7 +2464,7 @@ async function transcriptFilePaths(transcriptPath) {
 }
 /** Extract deduplicated Edit tool_use entries (keyed by basename) from a transcript. */
 async function transcriptEdits(transcriptPath) {
-	const text = await Bun.file(transcriptPath).text();
+	const text = readText(transcriptPath);
 	const edits = [];
 	for (const line of text.split("\n").filter(Boolean)) try {
 		const content = JSON.parse(line)?.message?.content;
@@ -2090,7 +2481,7 @@ async function transcriptEdits(transcriptPath) {
 }
 /** Extract the last assistant text report (first 500 lines) from a transcript. */
 async function transcriptReport(transcriptPath) {
-	const text = await Bun.file(transcriptPath).text();
+	const text = readText(transcriptPath);
 	let lastReport = "";
 	for (const line of text.split("\n").filter(Boolean)) try {
 		const entry = JSON.parse(line);
@@ -2118,7 +2509,7 @@ const RETRY_DELAYS = [
 ];
 /** Extract the longest assistant synthesis + queried library ids from a transcript. */
 async function extractSynthesis(path) {
-	const lines = (await Bun.file(path).text()).split("\n").filter(Boolean);
+	const lines = readText(path).split("\n").filter(Boolean);
 	const libraries = [];
 	let synthesis = "";
 	for (const line of lines) try {
@@ -2146,14 +2537,14 @@ async function extractSynthesis(path) {
 * @param home - Home dir (defaults to `~`).
 */
 async function cacheDocFromTranscript(transcript, cwd, home = homedir()) {
-	if (!transcript || !await Bun.file(transcript).exists()) return;
+	if (!transcript || !pathExists(transcript)) return;
 	const projPath = projectRootFromPaths(await transcriptFilePaths(transcript)) ?? process.env.CLAUDE_PROJECT_DIR ?? cwd;
 	const cacheDir = cacheDirFor("doc", projPath, home);
 	const docsDir = join(cacheDir, "docs");
 	let result = await extractSynthesis(transcript);
 	for (const delay of RETRY_DELAYS) {
 		if (result.text.length >= MIN_TEXT_SIZE && result.libraries.length > 0) break;
-		await Bun.sleep(delay);
+		await sleep(delay);
 		result = await extractSynthesis(transcript);
 	}
 	const { text, libraries } = result;
@@ -2167,7 +2558,7 @@ async function cacheDocFromTranscript(transcript, cwd, home = homedir()) {
 	const content = text.slice(0, MAX_DOC_SIZE);
 	const topic = libraries.join(", ");
 	const docHash = hashText16(topic);
-	await Bun.write(join(docsDir, `${docHash}.md`), content);
+	writeText(join(docsDir, `${docHash}.md`), content);
 	const sizeKb = Math.floor(content.length / 1024);
 	for (const lib of libraries) {
 		index.docs = index.docs.filter((d) => d.library !== lib);
@@ -2197,7 +2588,7 @@ async function cacheDocFromTranscript(transcript, cwd, home = homedir()) {
 * @param home - Home dir (defaults to `~`).
 */
 async function cacheSniperLessons(transcript, cwd, home = homedir()) {
-	if (!transcript || !await Bun.file(transcript).exists()) return;
+	if (!transcript || !pathExists(transcript)) return;
 	const edits = await transcriptEdits(transcript);
 	if (edits.length === 0) return;
 	const projectPath = projectRootFromPaths(edits.map((e) => e.file)) ?? process.env.CLAUDE_PROJECT_DIR ?? cwd;
@@ -2236,7 +2627,7 @@ async function cacheSniperLessons(transcript, cwd, home = homedir()) {
 */
 /** Extract linter-related command/output text from a JSONL transcript. */
 async function extractLinterOutput(path) {
-	const text = await Bun.file(path).text();
+	const text = readText(path);
 	const outputs = [];
 	for (const line of text.split("\n").filter(Boolean)) try {
 		const content = JSON.parse(line)?.message?.content;
@@ -2258,7 +2649,7 @@ async function extractLinterOutput(path) {
 * @param home - Home dir (defaults to `~`).
 */
 async function cacheTestResults(transcript, cwd, home = homedir()) {
-	if (!transcript || !await Bun.file(transcript).exists()) return;
+	if (!transcript || !pathExists(transcript)) return;
 	const projectPath = projectRootFromPaths(await transcriptFilePaths(transcript)) ?? process.env.CLAUDE_PROJECT_DIR ?? cwd;
 	const pHash = projectHash(projectPath);
 	const cacheDir = cacheDirFor("tests", projectPath, home);
@@ -2318,7 +2709,7 @@ async function acquireLock(lockDir, timeoutMs = 5e3) {
 			} catch {}
 		};
 	} catch {
-		await Bun.sleep(100);
+		await sleep(100);
 	}
 	return null;
 }
@@ -2384,16 +2775,7 @@ async function taskComplete(file, id) {
 /** True when the project has uncommitted git changes. */
 async function hasGitChanges(cwd) {
 	try {
-		const proc = Bun.spawn([
-			"git",
-			"status",
-			"--porcelain"
-		], {
-			cwd,
-			stdout: "pipe",
-			stderr: "ignore"
-		});
-		return (await new Response(proc.stdout).text()).trim().length > 0;
+		return spawnCapture("git", ["status", "--porcelain"], cwd).trim().length > 0;
 	} catch {
 		return false;
 	}
@@ -2516,7 +2898,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 +2913,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 +3102,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 +3121,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 +3159,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 +3758,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 +3788,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 };