vibe-splain 3.5.0 → 4.0.0

package/dist/index.js

@@ -11,14 +11,14 @@ var __export = (target, all) => {
 
 // ../brain/dist/pipeline/inventory.js
 import Parser from "web-tree-sitter";
-import { join as join2, dirname as dirname2, relative, extname, basename, sep } from "path";
-import { fileURLToPath as fileURLToPath2 } from "url";
+import { join as join2, dirname, relative, extname, basename, sep } from "path";
+import { fileURLToPath } from "url";
 import { createRequire } from "module";
 import { readFile as readFile2, readdir, writeFile as writeFile2, mkdir } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
 function resolveWasm(file) {
   try {
-    const wasmsDir = dirname2(require2.resolve("tree-sitter-wasms/package.json"));
+    const wasmsDir = dirname(require2.resolve("tree-sitter-wasms/package.json"));
     const p = join2(wasmsDir, "out", file);
     if (existsSync2(p))
       return p;
@@ -33,7 +33,7 @@ async function getLanguage(lang) {
     return cached;
   const wasm = resolveWasm(LANG_WASM[lang]);
   if (!wasm) {
-    console.error(`[vibe-splain] grammar missing for ${lang} (${LANG_WASM[lang]}); skipping`);
+    console.error(`[vibesplain] grammar missing for ${lang} (${LANG_WASM[lang]}); skipping`);
     return null;
   }
   try {
@@ -41,7 +41,7 @@ async function getLanguage(lang) {
     langCache.set(lang, loaded);
     return loaded;
   } catch (err) {
-    console.error(`[vibe-splain] failed to load grammar for ${lang}:`, err instanceof Error ? err.message : err);
+    console.error(`[vibesplain] failed to load grammar for ${lang}:`, err instanceof Error ? err.message : err);
     return null;
   }
 }
@@ -57,10 +57,13 @@ async function initParser() {
 }
 async function parseAs(lang, source) {
   const p = await initParser();
-  const language = await getLanguage(lang);
-  if (!language)
-    return null;
-  p.setLanguage(language);
+  if (_parserCurrentLang !== lang) {
+    const language = await getLanguage(lang);
+    if (!language)
+      return null;
+    p.setLanguage(language);
+    _parserCurrentLang = lang;
+  }
   try {
     return p.parse(source);
   } catch {
@@ -85,8 +88,8 @@ async function collectFiles(dir, projectRoot, acc) {
     if (entry.isDirectory()) {
       await collectFiles(fullPath, projectRoot, acc);
     } else if (entry.isFile()) {
-      const ext2 = extname(entry.name);
-      if (!SUPPORTED_EXTENSIONS.has(ext2))
+      const ext = extname(entry.name);
+      if (!SUPPORTED_EXTENSIONS.has(ext))
         continue;
       if (EXCLUDE_FILE_PATTERNS.some((p) => p.test(entry.name)))
         continue;
@@ -420,7 +423,7 @@ async function detectStackAndEntrypoints(projectRoot, files) {
     const b = basename(r);
     if (b === "main.py" || b === "__main__.py")
       entrypoints.add(r);
-    if (/^index\.(ts|tsx|js|jsx|mjs|cjs)$/.test(b) && dirname2(r).split(sep).length <= 2)
+    if (/^index\.(ts|tsx|js|jsx|mjs|cjs)$/.test(b) && dirname(r).split(sep).length <= 2)
       entrypoints.add(r);
     if (b === "main.go" && r.includes("cmd" + sep))
       entrypoints.add(r);
@@ -759,8 +762,8 @@ async function runInventory(projectRoot) {
   const work = [];
   for (const file of abs) {
     const rel = relative(projectRoot, file);
-    const ext2 = extname(file);
-    const lang = EXT_LANG[ext2];
+    const ext = extname(file);
+    const lang = EXT_LANG[ext];
     if (!lang)
       continue;
     let source;
@@ -786,7 +789,6 @@ async function runInventory(projectRoot) {
       lang,
       source,
       ast,
-      tree,
       importSpecs,
       rawNamedImports,
       pathDemote: pathDemoteReason(rel),
@@ -794,7 +796,7 @@ async function runInventory(projectRoot) {
       productDomain
     });
   }
-  const dir = join2(projectRoot, ".vibe-splainer");
+  const dir = join2(projectRoot, ".vibesplain");
   await mkdir(dir, { recursive: true });
   const stage01 = {
     files: work.map((w) => ({
@@ -806,20 +808,23 @@ async function runInventory(projectRoot) {
     totalCount: work.length,
     realSourceCount: work.filter((w) => !w.pathDemote).length
   };
-  await writeFile2(join2(dir, "stage-01-inventory.json"), JSON.stringify(stage01, null, 2), "utf8");
   const stage02 = Object.fromEntries(work.map((w) => [w.rel, w.frameworkRole]));
-  await writeFile2(join2(dir, "stage-02-framework-roles.json"), JSON.stringify(stage02, null, 2), "utf8");
   const stage03 = Object.fromEntries(work.map((w) => [w.rel, w.productDomain]));
-  await writeFile2(join2(dir, "stage-03-domains.json"), JSON.stringify(stage03, null, 2), "utf8");
+  await Promise.all([
+    writeFile2(join2(dir, "stage-01-inventory.json"), JSON.stringify(stage01, null, 2), "utf8"),
+    writeFile2(join2(dir, "stage-02-framework-roles.json"), JSON.stringify(stage02, null, 2), "utf8"),
+    writeFile2(join2(dir, "stage-03-domains.json"), JSON.stringify(stage03, null, 2), "utf8")
+  ]);
   return { projectRoot, work, stack, entrypoints, fileSet, basenameIndex };
 }
-var __dirname, require2, _parser, langCache, EXT_LANG, LANG_WASM, SUPPORTED_EXTENSIONS, EXCLUDE_DIRS, EXCLUDE_FILE_PATTERNS, DEMOTE_SEGMENTS, VENDOR_SEGMENTS, PILLAR_KEYWORDS, PILLAR_PATH_PATTERNS, MEANINGLESS_SEGMENTS, FUNCTION_TYPES, NESTING_TYPES, DECISION_TYPES, CATCH_TYPES, LONG_FN_LOC, DEEP_NESTING, GOD_FILE_LOC, GOD_FILE_EXPORTS, TODO_RE, SUPPRESS_RE, SMELL_WEIGHT;
+var __dirname, require2, _parser, _parserCurrentLang, langCache, EXT_LANG, LANG_WASM, SUPPORTED_EXTENSIONS, EXCLUDE_DIRS, EXCLUDE_FILE_PATTERNS, DEMOTE_SEGMENTS, VENDOR_SEGMENTS, PILLAR_KEYWORDS, PILLAR_PATH_PATTERNS, MEANINGLESS_SEGMENTS, FUNCTION_TYPES, NESTING_TYPES, DECISION_TYPES, CATCH_TYPES, LONG_FN_LOC, DEEP_NESTING, GOD_FILE_LOC, GOD_FILE_EXPORTS, TODO_RE, SUPPRESS_RE, SMELL_WEIGHT;
 var init_inventory = __esm({
   "../brain/dist/pipeline/inventory.js"() {
     "use strict";
-    __dirname = dirname2(fileURLToPath2(import.meta.url));
+    __dirname = dirname(fileURLToPath(import.meta.url));
     require2 = createRequire(import.meta.url);
     _parser = null;
+    _parserCurrentLang = null;
     langCache = /* @__PURE__ */ new Map();
     EXT_LANG = {
       ".ts": "typescript",
@@ -849,7 +854,7 @@ var init_inventory = __esm({
       "build",
       ".next",
       "out",
-      ".vibe-splainer",
+      ".vibesplain",
       ".git",
       ".venv",
       "venv",
@@ -1084,7 +1089,7 @@ var init_inventory = __esm({
 });
 
 // ../brain/dist/pipeline/resolution.js
-import { join as join3, dirname as dirname3, relative as relative2, extname as extname2, sep as sep2 } from "path";
+import { join as join3, dirname as dirname2, relative as relative2, extname as extname2, sep as sep2 } from "path";
 import { readFile as readFile3, writeFile as writeFile3, mkdir as mkdir2 } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
 function parseJsonLenient(text) {
@@ -1109,7 +1114,7 @@ async function discoverAllTsConfigs(dir, projectRoot, maxDepth = 4) {
   for (const entry of entries) {
     const fullPath = join3(dir, entry.name);
     if (entry.isDirectory()) {
-      if (entry.name === "node_modules" || entry.name === ".git")
+      if (TSCONFIG_SKIP_DIRS.has(entry.name))
         continue;
       const sub = await discoverAllTsConfigs(fullPath, projectRoot, maxDepth - 1);
       Object.assign(result, sub);
@@ -1136,9 +1141,9 @@ async function extractTsConfigPaths(tsconfigPath, projectRoot, depth = 0) {
   if (typeof parsed.extends === "string") {
     let baseFile = parsed.extends;
     if (baseFile.startsWith(".")) {
-      baseFile = join3(dirname3(tsconfigPath), baseFile);
+      baseFile = join3(dirname2(tsconfigPath), baseFile);
     } else {
-      let currentDir = dirname3(tsconfigPath);
+      let currentDir = dirname2(tsconfigPath);
       let found = false;
       while (currentDir.length >= projectRoot.length || currentDir === projectRoot) {
         const candidate = join3(currentDir, "node_modules", baseFile + (baseFile.endsWith(".json") ? "" : ".json"));
@@ -1147,7 +1152,7 @@ async function extractTsConfigPaths(tsconfigPath, projectRoot, depth = 0) {
           found = true;
           break;
         }
-        const parent = dirname3(currentDir);
+        const parent = dirname2(currentDir);
         if (parent === currentDir)
           break;
         currentDir = parent;
@@ -1162,7 +1167,7 @@ async function extractTsConfigPaths(tsconfigPath, projectRoot, depth = 0) {
     Object.assign(result, base);
   }
   const opts = parsed.compilerOptions || {};
-  const baseUrl = typeof opts.baseUrl === "string" ? join3(dirname3(tsconfigPath), opts.baseUrl) : dirname3(tsconfigPath);
+  const baseUrl = typeof opts.baseUrl === "string" ? join3(dirname2(tsconfigPath), opts.baseUrl) : dirname2(tsconfigPath);
   if (typeof opts.baseUrl === "string") {
     const relBase = relative2(projectRoot, baseUrl);
     if (relBase && relBase !== ".") {
@@ -1236,10 +1241,10 @@ async function buildAliasMap(projectRoot) {
 function tryJsCandidates(base, projectRoot, fileSet) {
   const candidates = [];
   candidates.unshift(base);
-  for (const ext2 of JS_EXTS)
-    candidates.push(base + ext2);
-  for (const ext2 of JS_EXTS)
-    candidates.push(join3(base, "index" + ext2));
+  for (const ext of JS_EXTS)
+    candidates.push(base + ext);
+  for (const ext of JS_EXTS)
+    candidates.push(join3(base, "index" + ext));
   for (const c of candidates) {
     const rel = relative2(projectRoot, c);
     if (fileSet.has(rel))
@@ -1251,9 +1256,9 @@ function resolvePython(spec, fromAbs, projectRoot, fileSet) {
   let modulePath;
   if (spec.startsWith(".")) {
     const dots = spec.match(/^\.+/)[0].length;
-    let dir = dirname3(fromAbs);
+    let dir = dirname2(fromAbs);
     for (let i = 1; i < dots; i++)
-      dir = dirname3(dir);
+      dir = dirname2(dir);
     const rest = spec.slice(dots).replace(/\./g, sep2);
     modulePath = rest ? join3(dir, rest) : dir;
   } else {
@@ -1287,7 +1292,7 @@ function resolveImportWithAliasMap(spec, fromAbs, lang, projectRoot, fileSet, ba
   }
   if (lang === "typescript" || lang === "tsx" || lang === "javascript") {
     if (spec.startsWith(".")) {
-      const base = join3(dirname3(fromAbs), spec);
+      const base = join3(dirname2(fromAbs), spec);
       return { resolved: tryJsCandidates(base, projectRoot, fileSet), isAlias: false };
     }
     for (const [prefix, replacement] of Object.entries(aliasMap.resolvedAliases)) {
@@ -1352,11 +1357,18 @@ async function runResolution(projectRoot, inv) {
   const resolutionFailuresByFile = {};
   const resolutionFailureReasons = {};
   const unresolvedSet = /* @__PURE__ */ new Set();
+  const resolveCache = /* @__PURE__ */ new Map();
   for (const w of work) {
     const distinctModules = /* @__PURE__ */ new Set();
     for (const spec of w.importSpecs) {
       distinctModules.add(spec);
-      const { resolved, isAlias, reason } = resolveImportWithAliasMap(spec, w.abs, w.lang, projectRoot, fileSet, basenameIndex, aliasMap);
+      const cacheKey = `${w.abs}\0${spec}`;
+      let cached = resolveCache.get(cacheKey);
+      if (!cached) {
+        cached = resolveImportWithAliasMap(spec, w.abs, w.lang, projectRoot, fileSet, basenameIndex, aliasMap);
+        resolveCache.set(cacheKey, cached);
+      }
+      const { resolved, isAlias, reason } = cached;
       if (resolved && resolved !== w.rel && importedBy.has(resolved)) {
         importedBy.get(resolved).add(w.rel);
         importsResolved.get(w.rel).add(resolved);
@@ -1376,7 +1388,7 @@ async function runResolution(projectRoot, inv) {
     fanOut.set(w.rel, distinctModules.size);
   }
   const unresolvedImports = [...unresolvedSet];
-  const dir = join3(projectRoot, ".vibe-splainer");
+  const dir = join3(projectRoot, ".vibesplain");
   await mkdir2(dir, { recursive: true });
   const stage04 = {
     resolvedAliases: aliasMap.resolvedAliases,
@@ -1398,10 +1410,30 @@ async function runResolution(projectRoot, inv) {
     resolutionFailureReasons
   };
 }
-var CONVENTIONAL_ALIASES, JS_EXTS;
+var TSCONFIG_SKIP_DIRS, CONVENTIONAL_ALIASES, JS_EXTS;
 var init_resolution = __esm({
   "../brain/dist/pipeline/resolution.js"() {
     "use strict";
+    TSCONFIG_SKIP_DIRS = /* @__PURE__ */ new Set([
+      "node_modules",
+      ".git",
+      "dist",
+      "build",
+      ".next",
+      "out",
+      ".cache",
+      ".vibesplain",
+      "__pycache__",
+      "target",
+      ".mypy_cache",
+      ".pytest_cache",
+      ".tox",
+      "venv",
+      ".venv",
+      "env",
+      "site-packages",
+      "vendor"
+    ]);
     CONVENTIONAL_ALIASES = [
       { prefix: "~/", replacement: "modules/" },
       { prefix: "~/", replacement: "" },
@@ -1617,32 +1649,32 @@ function inferGenericWriteIntents(sideEffectProfile) {
   return intents;
 }
 function inferRiskTypesPass1(rel, frameworkRole, productDomain, sideEffectProfile, gravitySignals, smellKinds) {
-  const types2 = [];
+  const types = [];
   const smThreshold = ["provider", "store"].includes(frameworkRole) ? 8 : 20;
   if (gravitySignals.cyclomatic > smThreshold)
-    types2.push("state_machine");
+    types.push("state_machine");
   if (smellKinds.has("god-file")) {
     if (frameworkRole === "hook")
-      types2.push("god_hook");
+      types.push("god_hook");
     else
-      types2.push("god_component");
+      types.push("god_component");
   }
   if (sideEffectProfile.length > 3 && !sideEffectProfile.includes("none_detected")) {
-    types2.push("side_effect_coupling");
+    types.push("side_effect_coupling");
   }
   if (productDomain === "forms" && (gravitySignals.fanIn > 3 || gravitySignals.publicSurface > 5))
-    types2.push("registry_bottleneck");
+    types.push("registry_bottleneck");
   if (sideEffectProfile.some((s) => ["database_write", "trpc_mutation", "external_api_call"].includes(s)) && gravitySignals.cyclomatic > 10)
-    types2.push("mutation_orchestration");
+    types.push("mutation_orchestration");
   if (ENTRYPOINT_ROLES.has(frameworkRole) && sideEffectProfile.includes("database_write")) {
-    types2.push("route_handler_write_path");
+    types.push("route_handler_write_path");
   }
   if (smellKinds.has("swallowed-catch"))
-    types2.push("error_swallowing");
+    types.push("error_swallowing");
   if (sideEffectProfile.includes("local_storage") || sideEffectProfile.includes("indexed_db")) {
-    types2.push("storage_persistence_risk");
+    types.push("storage_persistence_risk");
   }
-  return types2;
+  return types;
 }
 function findRuntimeEntrypoints(relPath, importedByMap, persisted, maxDepth = 8) {
   const results = [];
@@ -2116,16 +2148,16 @@ async function runClassification(projectRoot, inv, res) {
     const gs = gravitySignalsByFile.get(w.rel);
     const smellKinds = new Set(w.ast.smells.map((s) => s.kind));
     const effects = sideEffectsByFile.get(w.rel);
-    const types2 = inferRiskTypesPass1(w.rel, w.frameworkRole, w.productDomain, effects, gs, smellKinds);
-    riskTypesByFile.set(w.rel, types2);
+    const types = inferRiskTypesPass1(w.rel, w.frameworkRole, w.productDomain, effects, gs, smellKinds);
+    riskTypesByFile.set(w.rel, types);
   }
   for (const w of work) {
     if (w.productDomain === "forms" && (w.frameworkRole === "component" || w.frameworkRole === "hook")) {
       const importsResolved_w = importsResolved.get(w.rel) || /* @__PURE__ */ new Set();
       const importsAny = [...importsResolved_w, ...w.importSpecs.filter((s) => s.startsWith("@"))];
       const consumesBottleneck = importsAny.some((dep) => {
-        const types3 = riskTypesByFile.get(dep);
-        return types3?.includes("registry_bottleneck");
+        const types2 = riskTypesByFile.get(dep);
+        return types2?.includes("registry_bottleneck");
       });
       if (consumesBottleneck) {
         const existing = riskTypesByFile.get(w.rel);
@@ -2138,9 +2170,9 @@ async function runClassification(projectRoot, inv, res) {
           existing.splice(idx, 1);
       }
     }
-    const types2 = riskTypesByFile.get(w.rel);
-    if (types2.length === 0)
-      types2.push("complexity_hotspot");
+    const types = riskTypesByFile.get(w.rel);
+    if (types.length === 0)
+      types.push("complexity_hotspot");
   }
   const adapterCtx = {
     projectRoot,
@@ -2178,7 +2210,7 @@ async function runClassification(projectRoot, inv, res) {
   }
   const staticGravityByFile = new Map(gravityByFile);
   if (adapterStage.firedAdapterIds.length > 0) {
-    console.error(`[vibe-splain] adapters fired: ${adapterStage.firedAdapterIds.join(", ")}`);
+    console.error(`[vibesplain] adapters fired: ${adapterStage.firedAdapterIds.join(", ")}`);
     for (const w of work) {
       const lift = adapterStage.liftByFile.get(w.rel) ?? 0;
       if (lift > 0) {
@@ -2258,7 +2290,7 @@ async function runClassification(projectRoot, inv, res) {
       adapterPillarLabel: adapterStage.pillarLabelsByFile.get(w.rel)
     });
   }
-  const dir = join4(projectRoot, ".vibe-splainer");
+  const dir = join4(projectRoot, ".vibesplain");
   await mkdir3(dir, { recursive: true });
   const stage05 = Object.fromEntries(classified.map((f) => [f.rel, f.sideEffectProfile]));
   await writeFile4(join4(dir, "stage-05-side-effects.json"), JSON.stringify(stage05, null, 2), "utf8");
@@ -2395,7 +2427,7 @@ function deriveConfidence(fanIn, gravity) {
   return "low";
 }
 async function runScoring(projectRoot, cr) {
-  const dir = join5(projectRoot, ".vibe-splainer");
+  const dir = join5(projectRoot, ".vibesplain");
   await mkdir4(dir, { recursive: true });
   const persisted = {};
   const severityBreakdowns = {};
@@ -2460,7 +2492,7 @@ async function runScoring(projectRoot, cr) {
     severityBreakdowns[f.rel] = `severity=${pf.canonicalSeverity} loadBearing=${pf.canonicalLoadBearing} effects=${pf.sideEffectProfile.join(",")} domain=${pf.productDomain}`;
   }
   if (adapterFired) {
-    console.error(`[vibe-splain] severity bridge: ${sevBridgeChecked - sevBridgeMismatch}/${sevBridgeChecked} domain contributions match core (${sevBridgeMismatch} mismatch)`);
+    console.error(`[vibesplain] severity bridge: ${sevBridgeChecked - sevBridgeMismatch}/${sevBridgeChecked} domain contributions match core (${sevBridgeMismatch} mismatch)`);
   }
   const store = {
     files: persisted,
@@ -2470,10 +2502,10 @@ async function runScoring(projectRoot, cr) {
   const validationReport = await buildValidationReport(store, projectRoot, cr);
   store.validationReport = validationReport;
   for (const e of validationReport.errors) {
-    console.error(`[vibe-splain] VALIDATION ERROR [${e.rule}] ${e.file}: ${e.detail}`);
+    console.error(`[vibesplain] VALIDATION ERROR [${e.rule}] ${e.file}: ${e.detail}`);
   }
   for (const w of validationReport.warnings) {
-    console.error(`[vibe-splain] VALIDATION WARN [${w.rule}] ${w.file}: ${w.detail}`);
+    console.error(`[vibesplain] VALIDATION WARN [${w.rule}] ${w.file}: ${w.detail}`);
   }
   return { store, validationReport };
 }
@@ -2614,39 +2646,34 @@ async function runPipeline(projectRoot) {
   const res = await runResolution(projectRoot, inv);
   const cr = await runClassification(projectRoot, inv, res);
   const scoring = await runScoring(projectRoot, cr);
-  const files = cr.classified.filter((f) => f.isRealSource).sort((a, b) => b.gravity - a.gravity).map((f) => ({
-    path: f.abs,
-    relativePath: f.rel,
-    language: f.lang,
-    isRealSource: f.isRealSource,
-    demoteReason: f.demoteReason,
-    gravity: Math.round(f.gravity),
-    heat: Math.round(f.heat),
-    gravitySignals: f.gravitySignals,
-    heatSignals: f.heatSignals,
-    smells: f.smells,
-    pillarHint: f.pillarHint,
-    frameworkRole: f.executionRole ?? f.frameworkRole,
-    productDomain: f.domainTags?.[0] ?? f.adapterDomain ?? f.productDomain,
-    sideEffectProfile: f.adapterSideEffects ?? f.sideEffectProfile
-  }));
-  const wildCandidates = cr.classified.filter((f) => f.isRealSource && (f.heat >= 60 || f.smells.some((s) => s.severity >= 4))).sort((a, b) => b.heat - a.heat).map((f) => ({
-    path: f.abs,
-    relativePath: f.rel,
-    language: f.lang,
-    isRealSource: f.isRealSource,
-    demoteReason: f.demoteReason,
-    gravity: Math.round(f.gravity),
-    heat: Math.round(f.heat),
-    gravitySignals: f.gravitySignals,
-    heatSignals: f.heatSignals,
-    smells: f.smells,
-    pillarHint: f.pillarHint,
-    frameworkRole: f.executionRole ?? f.frameworkRole,
-    productDomain: f.domainTags?.[0] ?? f.adapterDomain ?? f.productDomain,
-    sideEffectProfile: f.adapterSideEffects ?? f.sideEffectProfile
-  }));
-  const uiUrl = `file://${join6(projectRoot, ".vibe-splainer", "ui", "index.html")}`;
+  const files = [];
+  const wildCandidates = [];
+  for (const f of cr.classified) {
+    if (!f.isRealSource)
+      continue;
+    const fa = {
+      path: f.abs,
+      relativePath: f.rel,
+      language: f.lang,
+      isRealSource: f.isRealSource,
+      demoteReason: f.demoteReason,
+      gravity: Math.round(f.gravity),
+      heat: Math.round(f.heat),
+      gravitySignals: f.gravitySignals,
+      heatSignals: f.heatSignals,
+      smells: f.smells,
+      pillarHint: f.pillarHint,
+      frameworkRole: f.executionRole ?? f.frameworkRole,
+      productDomain: f.domainTags?.[0] ?? f.adapterDomain ?? f.productDomain,
+      sideEffectProfile: f.adapterSideEffects ?? f.sideEffectProfile
+    };
+    files.push(fa);
+    if (f.heat >= 60 || f.smells.some((s) => s.severity >= 4))
+      wildCandidates.push(fa);
+  }
+  files.sort((a, b) => b.gravity - a.gravity);
+  wildCandidates.sort((a, b) => b.heat - a.heat);
+  const uiUrl = `file://${join6(projectRoot, ".vibesplain", "ui", "index.html")}`;
   return {
     projectRoot,
     totalFilesScanned: cr.classified.length,
@@ -2661,7 +2688,7 @@ async function runPipeline(projectRoot) {
       passed: scoring.validationReport.passed,
       errors: scoring.validationReport.summary.errorCount,
       warnings: scoring.validationReport.summary.warningCount,
-      reportPath: ".vibe-splainer/validation_report.json"
+      reportPath: ".vibesplain/validation_report.json"
     },
     fullValidationReport: scoring.validationReport
   };
@@ -2686,8 +2713,8 @@ async function scanProject(projectRoot) {
   return runPipeline(projectRoot);
 }
 async function getFileAnalysis(absPath) {
-  const ext2 = extname4(absPath);
-  const lang = EXT_LANG[ext2];
+  const ext = extname4(absPath);
+  const lang = EXT_LANG[ext];
   if (!lang)
     return null;
   let source;
@@ -2742,7 +2769,7 @@ var init_scanner = __esm({
 import { join as join7 } from "path";
 import { readFile as readFile5, writeFile as writeFile5, mkdir as mkdir5 } from "fs/promises";
 async function readAnalysis(projectRoot) {
-  const p = join7(projectRoot, ".vibe-splainer", "analysis.json");
+  const p = join7(projectRoot, ".vibesplain", "analysis.json");
   try {
     const raw = await readFile5(p, "utf8");
     return JSON.parse(raw);
@@ -2760,7 +2787,7 @@ var init_analysis = __esm({
 import { join as join8 } from "path";
 import { readFile as readFile6 } from "fs/promises";
 async function readDossier(projectRoot) {
-  const dossierPath = join8(projectRoot, ".vibe-splainer", "dossier.json");
+  const dossierPath = join8(projectRoot, ".vibesplain", "dossier.json");
   try {
     const raw = await readFile6(dossierPath, "utf8");
     return JSON.parse(raw);
@@ -2774,10 +2801,10 @@ function validateMermaidNodeCount(diagram) {
   const nodePattern = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*[\[({|>]/gm;
   const statePattern = /^\s*([A-Za-z_][A-Za-z0-9_]*)\s*:/gm;
   const nodes = /* @__PURE__ */ new Set();
-  for (const match2 of diagram.matchAll(nodePattern))
-    nodes.add(match2[1]);
-  for (const match2 of diagram.matchAll(statePattern))
-    nodes.add(match2[1]);
+  for (const match of diagram.matchAll(nodePattern))
+    nodes.add(match[1]);
+  for (const match of diagram.matchAll(statePattern))
+    nodes.add(match[1]);
   if (diagram.includes("[*]"))
     nodes.add("[*]");
   return nodes.size <= 7;
@@ -2788,95 +2815,6 @@ var init_dossier = __esm({
   }
 });
 
-// ../brain/dist/policy/RecommendationEngine.js
-function getEffortValue(effort) {
-  if (effort === "low")
-    return 1;
-  if (effort === "medium")
-    return 2;
-  return 3;
-}
-function getImpactValue(impact) {
-  if (impact === "low")
-    return 1;
-  if (impact === "medium")
-    return 2;
-  return 3;
-}
-var RecommendationEngine;
-var init_RecommendationEngine = __esm({
-  "../brain/dist/policy/RecommendationEngine.js"() {
-    "use strict";
-    RecommendationEngine = class {
-      static generateRecommendations(file) {
-        const recommendations = [];
-        if (file.riskTypes.includes("mutation_orchestration")) {
-          recommendations.push({
-            strategy: "Extract Decision Logic",
-            description: "Do not rewrite inline. Extract pure decision logic into a tested reducer or state machine first. Preserve all side-effect call sites (redirect URLs, SDK event names, response shapes) as invariants.",
-            effort: "high",
-            impact: "high"
-          });
-        }
-        if (file.riskTypes.includes("registry_bottleneck")) {
-          recommendations.push({
-            strategy: "Append-Only Registry Updates",
-            description: "Add new entries without removing existing keys. Treat the registry map as append-only until all consumers are verified.",
-            effort: "low",
-            impact: "medium"
-          });
-        }
-        if (file.riskTypes.includes("registry_consumer")) {
-          recommendations.push({
-            strategy: "Verify Registry Contract",
-            description: "Verify the registry contract before patching. Changes to field types must be reflected in both the registry and all rendering paths.",
-            effort: "medium",
-            impact: "low"
-          });
-        }
-        if (file.riskTypes.includes("route_handler_write_path")) {
-          recommendations.push({
-            strategy: "Integration Testing First",
-            description: "Add integration tests covering success and failure paths before modifying. Verify HTTP status codes and response shapes are preserved.",
-            effort: "medium",
-            impact: "high"
-          });
-        }
-        if (file.riskTypes.includes("god_component") || file.riskTypes.includes("god_hook")) {
-          recommendations.push({
-            strategy: "Extract Sub-Concerns",
-            description: "Extract sub-concerns into separate modules first. Only refactor the extraction points after tests confirm equivalence.",
-            effort: "high",
-            impact: "high"
-          });
-        }
-        if (file.sideEffectProfile.includes("database_write")) {
-          recommendations.push({
-            strategy: "Feature Flags & Staging",
-            description: "Wrap changes in a transaction or use a feature flag. Run against a staging database before production.",
-            effort: "medium",
-            impact: "high"
-          });
-        }
-        if (recommendations.length === 0 && file.importedBy.length >= 5) {
-          recommendations.push({
-            strategy: "Review Blast Radius",
-            description: "Review importedBy before patching. Run affected integration tests.",
-            effort: "medium",
-            impact: "medium"
-          });
-        }
-        recommendations.sort((a, b) => {
-          const ratioA = getImpactValue(a.impact) / getEffortValue(a.effort);
-          const ratioB = getImpactValue(b.impact) / getEffortValue(b.effort);
-          return ratioB - ratioA;
-        });
-        return recommendations;
-      }
-    };
-  }
-});
-
 // ../brain/dist/graph.js
 var init_graph = __esm({
   "../brain/dist/graph.js"() {
@@ -2884,246 +2822,6 @@ var init_graph = __esm({
   }
 });
 
-// ../brain/dist/network/gateIndex.js
-function isDenoisedImporter(relPath) {
-  if (!relPath)
-    return false;
-  const norm = relPath.replace(/\\/g, "/");
-  const segs = norm.split("/");
-  const excludedDirs = /* @__PURE__ */ new Set([
-    "node_modules",
-    "vendor",
-    "vendored",
-    "site-packages",
-    "third_party",
-    "third-party",
-    ".yarn",
-    "bower_components",
-    "venv",
-    ".venv",
-    "env",
-    "virtualenv",
-    ".git",
-    ".vibe-splainer",
-    "dist",
-    "build",
-    "out",
-    "target",
-    ".next",
-    ".nuxt",
-    ".docusaurus",
-    "coverage",
-    ".nyc_output",
-    ".cache"
-  ]);
-  for (const s of segs) {
-    const sLower = s.toLowerCase();
-    if (excludedDirs.has(sLower)) {
-      return false;
-    }
-    if (sLower.endsWith(".venv")) {
-      return false;
-    }
-  }
-  const fileName = segs[segs.length - 1];
-  const fileNameLower = fileName.toLowerCase();
-  if (/\.min\.[a-z]+$/.test(fileNameLower) || fileNameLower.includes(".min.")) {
-    return false;
-  }
-  if (/\.generated\./.test(fileNameLower) || fileNameLower.includes("__generated__")) {
-    return false;
-  }
-  if (fileNameLower.endsWith(".lock")) {
-    return false;
-  }
-  if (norm.startsWith("virtual:") || norm.startsWith("__virtual:") || norm.startsWith("webpack:")) {
-    return false;
-  }
-  return true;
-}
-function hasBehavioralSubstance(file) {
-  const isTypeDefinition = file.frameworkRole === "type_definition";
-  const cyclomatic = file.gravitySignals?.cyclomatic ?? 0;
-  const hasSideEffects = (file.sideEffectProfile ?? []).some((e) => e !== "none_detected");
-  const hasStrongRiskType = (file.riskTypes ?? []).some((r) => r === "state_machine" || r === "mutation_orchestration" || r === "registry_bottleneck" || r === "side_effect_coupling");
-  return !isTypeDefinition && (cyclomatic >= 5 || hasSideEffects || hasStrongRiskType);
-}
-function buildGateIndex(store) {
-  const files = {};
-  if (store && store.files) {
-    for (const [key, file] of Object.entries(store.files)) {
-      const dependents = (file.importedBy ?? []).filter(isDenoisedImporter);
-      const sideEffects = (file.sideEffectProfile ?? []).filter((e) => e !== "none_detected");
-      files[key] = {
-        relativePath: file.relativePath,
-        gravity: file.gravity ?? 0,
-        demoteReason: file.demoteReason,
-        hasBehavioralSubstance: hasBehavioralSubstance(file),
-        dependents,
-        fanIn: file.gravitySignals?.fanIn ?? dependents.length,
-        fanOut: file.gravitySignals?.fanOut ?? 0,
-        centrality: file.gravitySignals?.centrality ?? 0,
-        severity: file.canonicalSeverity ?? 1,
-        sideEffects,
-        riskTypes: file.riskTypes ?? []
-      };
-    }
-  }
-  return { files };
-}
-var init_gateIndex = __esm({
-  "../brain/dist/network/gateIndex.js"() {
-    "use strict";
-  }
-});
-
-// ../brain/dist/network/escalation.js
-function buildEscalationContext(targetFile, gateIndex) {
-  const file = lookupFile(targetFile, gateIndex);
-  if (!file)
-    return null;
-  const rel = file.relativePath;
-  const gravity = file.gravity;
-  const dependents = file.dependents;
-  const dependentsCount = dependents.length;
-  const sideEffects = file.sideEffects;
-  const riskTypes = file.riskTypes;
-  const severity = file.severity;
-  const gravity_tier = gravity > 70 ? "high" : gravity > 40 ? "medium" : "low";
-  const raw_substance_tier = file.hasBehavioralSubstance && dependentsCount >= 10 ? "high" : file.hasBehavioralSubstance && dependentsCount >= 4 ? "medium" : "low";
-  const tierOrder = { low: 1, medium: 2, high: 3 };
-  let blastRadius = tierOrder[gravity_tier] >= tierOrder[raw_substance_tier] ? gravity_tier : raw_substance_tier;
-  const isGeneratedOrVendored = !isDenoisedImporter(targetFile) || file.demoteReason !== null && file.demoteReason !== "no inbound references from application code";
-  if (isGeneratedOrVendored) {
-    blastRadius = "low";
-  }
-  const riskWarnings = buildRiskWarnings(rel, gravity, dependentsCount, severity, sideEffects, riskTypes);
-  return {
-    targetFile: rel,
-    gravity,
-    blastRadius,
-    dependents,
-    dependentCount: dependentsCount,
-    fanIn: file.fanIn,
-    fanOut: file.fanOut,
-    centrality: file.centrality,
-    severity,
-    sideEffects,
-    riskTypes,
-    riskWarnings,
-    smallestSafeChange: buildSafeChangePolicy(blastRadius)
-  };
-}
-function lookupFile(targetFile, gateIndex) {
-  const files = gateIndex?.files;
-  if (!files)
-    return null;
-  const norm = targetFile.replace(/\\/g, "/");
-  if (files[norm])
-    return files[norm];
-  const suffixHits = [];
-  for (const [key, rec] of Object.entries(files)) {
-    if (norm === key || norm.endsWith("/" + key) || key.endsWith("/" + norm)) {
-      suffixHits.push(rec);
-    }
-  }
-  return suffixHits.length === 1 ? suffixHits[0] : null;
-}
-function buildRiskWarnings(rel, gravity, dependentCount, severity, sideEffects, riskTypes) {
-  const warnings = [];
-  if (gravity > 70) {
-    warnings.push({
-      id: `rw_${rel}_blast_radius`,
-      level: "critical",
-      message: `Central file \u2014 editing it has a large blast radius. ${dependentCount} file(s) depend on it.`,
-      reason: `Gravity ${gravity}/100; fan-in ${dependentCount}.`
-    });
-  }
-  if (severity >= 4) {
-    warnings.push({
-      id: `rw_${rel}_severity`,
-      level: "warning",
-      message: "High-severity smells already present here. Avoid making them worse.",
-      reason: `Canonical severity ${severity}/5.`
-    });
-  }
-  if (SECURITY_PATH.test(rel)) {
-    warnings.push({
-      id: `rw_${rel}_security_path`,
-      level: "critical",
-      message: "Security-sensitive file (auth/credential/webhook/payment). Do not alter auth or credential handling unless that is the explicit task.",
-      reason: `Path matches security-sensitive pattern.`
-    });
-  }
-  const sensitive = sideEffects.filter((e) => SENSITIVE_EFFECTS.has(e));
-  if (sensitive.length > 0) {
-    warnings.push({
-      id: `rw_${rel}_side_effects`,
-      level: "warning",
-      message: `This file performs side effects (${sensitive.join(", ")}). Preserve existing behavior; do not drop or reorder them.`,
-      reason: `Side-effect profile: ${sensitive.join(", ")}.`
-    });
-  }
-  const notable = riskTypes.filter((r) => NOTABLE_RISKS.has(r));
-  if (notable.length > 0) {
-    warnings.push({
-      id: `rw_${rel}_risk_types`,
-      level: "info",
-      message: `Structural risk patterns detected (${notable.join(", ")}). Trace the affected paths before editing.`,
-      reason: `Risk types: ${notable.join(", ")}.`
-    });
-  }
-  return warnings;
-}
-function buildSafeChangePolicy(blastRadius) {
-  const rules = [
-    "Locate the exact failure site before editing.",
-    "Make the smallest localized change that addresses the task.",
-    "Do not perform general cleanup or refactoring.",
-    "Do not modify unrelated files, credentials, or auth configuration."
-  ];
-  if (blastRadius === "high") {
-    rules.push("This file is load-bearing: verify each dependent still type-checks against the changed surface.");
-  }
-  return {
-    summary: "Make the smallest localized change that addresses the requested task. Do not modify unrelated files, credentials, auth configuration, or neighboring modules unless the task explicitly requires it.",
-    rules,
-    forbiddenEditClasses: ["credentials", "auth_configuration", "global_refactoring"]
-  };
-}
-var SECURITY_PATH, SENSITIVE_EFFECTS, NOTABLE_RISKS;
-var init_escalation = __esm({
-  "../brain/dist/network/escalation.js"() {
-    "use strict";
-    init_gateIndex();
-    SECURITY_PATH = /\b(auth|credential|secret|token|webhook|payment|password|oauth|session)\b/i;
-    SENSITIVE_EFFECTS = /* @__PURE__ */ new Set([
-      "database_write",
-      "server_action",
-      "trpc_mutation",
-      "email_send",
-      "external_api_call"
-    ]);
-    NOTABLE_RISKS = /* @__PURE__ */ new Set([
-      "state_machine",
-      "mutation_orchestration",
-      "side_effect_coupling",
-      "async_race_risk",
-      "registry_bottleneck",
-      "error_swallowing"
-    ]);
-  }
-});
-
-// ../brain/dist/network/index.js
-var init_network = __esm({
-  "../brain/dist/network/index.js"() {
-    "use strict";
-    init_escalation();
-    init_gateIndex();
-  }
-});
-
 // ../brain/dist/index.js
 var init_dist = __esm({
   "../brain/dist/index.js"() {
@@ -3133,10 +2831,8 @@ var init_dist = __esm({
     init_scoring();
     init_classification();
     init_dossier();
-    init_RecommendationEngine();
     init_graph();
     init_adapters();
-    init_network();
   }
 });
 
@@ -3154,15 +2850,15 @@ var init_ArtifactBundleWriter = __esm({
         this.projectRoot = projectRoot;
       }
       async writeBundle(artifacts) {
-        const outputDir = join9(this.projectRoot, ".vibe-splainer");
-        const stagingDir = join9(this.projectRoot, ".vibe-splainer.tmp");
-        const oldDir = join9(this.projectRoot, ".vibe-splainer.old");
+        const outputDir = join9(this.projectRoot, ".vibesplain");
+        const stagingDir = join9(this.projectRoot, ".vibesplain.tmp");
+        const oldDir = join9(this.projectRoot, ".vibesplain.old");
         try {
           await rm(stagingDir, { recursive: true, force: true });
           await rm(oldDir, { recursive: true, force: true });
-          const { existsSync: existsSync7 } = await import("fs");
+          const { existsSync: existsSync5 } = await import("fs");
           const { cp } = await import("fs/promises");
-          if (existsSync7(outputDir)) {
+          if (existsSync5(outputDir)) {
             await cp(outputDir, stagingDir, { recursive: true });
           } else {
             await mkdir6(stagingDir, { recursive: true });
@@ -3189,7 +2885,7 @@ var init_ArtifactBundleWriter = __esm({
           };
           await writeFile6(join9(stagingDir, "artifact_manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
           let swapped = false;
-          if (existsSync7(outputDir)) {
+          if (existsSync5(outputDir)) {
             await rename(outputDir, oldDir);
             swapped = true;
           }
@@ -3233,8 +2929,8 @@ var init_JsonRenderer = __esm({
 });
 
 // dist/export/renderers/HtmlRenderer.js
-import { join as join10, dirname as dirname4, relative as relative3 } from "path";
-import { fileURLToPath as fileURLToPath3 } from "url";
+import { join as join10, dirname as dirname3, relative as relative3 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import { existsSync as existsSync4, readFileSync, readdirSync, statSync } from "fs";
 function getAllFiles(dirPath, arrayOfFiles = []) {
   const files = readdirSync(dirPath);
@@ -3252,7 +2948,7 @@ var __dirname2, HtmlRenderer;
 var init_HtmlRenderer = __esm({
   "dist/export/renderers/HtmlRenderer.js"() {
     "use strict";
-    __dirname2 = dirname4(fileURLToPath3(import.meta.url));
+    __dirname2 = dirname3(fileURLToPath2(import.meta.url));
     HtmlRenderer = class {
       render(viewModel, _store) {
         const candidatePaths = [
@@ -3285,7 +2981,7 @@ var init_HtmlRenderer = __esm({
           }
         }
         if (!templateDir) {
-          console.error("[vibe-splain] UI template not found. Checked:", candidatePaths);
+          console.error("[vibesplain] UI template not found. Checked:", candidatePaths);
           return [];
         }
         const artifacts = [];
@@ -3367,11 +3063,11 @@ ${viewModel.map.brief}
         md += `## Tier 1: Critical Files & Risks
 
 `;
-        for (const path2 of tier1) {
-          const f = store.files[path2];
-          const card = uniqueDecisions.get(path2);
-          const recs = viewModel.recommendations[path2] || [];
-          md += `### ${path2}
+        for (const path of tier1) {
+          const f = store.files[path];
+          const card = uniqueDecisions.get(path);
+          const recs = viewModel.recommendations[path] || [];
+          md += `### ${path}
 `;
           md += `- Gravity: ${Math.round(f.gravity)} | Heat: ${Math.round(f.heat)}
 `;
@@ -3403,10 +3099,10 @@ ${viewModel.map.brief}
         md += `## Tier 2: Important Files
 
 `;
-        for (const path2 of tier2) {
-          const f = store.files[path2];
-          const card = uniqueDecisions.get(path2);
-          md += `- **${path2}** (Gravity: ${Math.round(f.gravity)})`;
+        for (const path of tier2) {
+          const f = store.files[path];
+          const card = uniqueDecisions.get(path);
+          md += `- **${path}** (Gravity: ${Math.round(f.gravity)})`;
           if (card) {
             md += ` \u2014 ${card.thesis}`;
           }
@@ -3418,9 +3114,9 @@ ${viewModel.map.brief}
         md += `## Tier 3: Index
 
 `;
-        for (const path2 of tier3) {
-          const f = store.files[path2];
-          md += `- ${path2} (Gravity: ${Math.round(f.gravity)})
+        for (const path of tier3) {
+          const f = store.files[path];
+          md += `- ${path} (Gravity: ${Math.round(f.gravity)})
 `;
         }
         return [
@@ -3501,750 +3197,111 @@ var init_GraphRenderer = __esm({
   }
 });
 
-// dist/store/BlobStore.js
-import { createHash as createHash2 } from "crypto";
-import { mkdir as mkdir7, writeFile as writeFile7, open, rename as rename2, stat } from "fs/promises";
-import { existsSync as existsSync5 } from "fs";
-import { join as join11 } from "path";
-async function hashFile(filePath) {
-  const { readFile: readFile12 } = await import("fs/promises");
-  const buf = await readFile12(filePath);
-  return `sha256:${createHash2("sha256").update(buf).digest("hex")}`;
-}
-var BlobStore;
-var init_BlobStore = __esm({
-  "dist/store/BlobStore.js"() {
+// dist/export/ExportOrchestrator.js
+var ExportOrchestrator;
+var init_ExportOrchestrator = __esm({
+  "dist/export/ExportOrchestrator.js"() {
     "use strict";
-    BlobStore = class {
-      blobsDir;
-      tmpDir;
+    init_dist();
+    init_ArtifactBundleWriter();
+    init_JsonRenderer();
+    init_HtmlRenderer();
+    init_AgentMarkdownRenderer();
+    init_ValidationRenderer();
+    init_RawAnalysisRenderer();
+    init_GraphRenderer();
+    ExportOrchestrator = class {
+      projectRoot;
       constructor(projectRoot) {
-        this.blobsDir = join11(projectRoot, ".vibe-splainer", "blobs");
-        this.tmpDir = join11(projectRoot, ".vibe-splainer", "tmp");
-      }
-      async ensureDirs() {
-        await mkdir7(this.blobsDir, { recursive: true });
-        await mkdir7(this.tmpDir, { recursive: true });
+        this.projectRoot = projectRoot;
       }
-      async writeAtomic(payload) {
-        await this.ensureDirs();
-        const buf = typeof payload === "string" ? Buffer.from(payload, "utf8") : payload;
-        const hex = createHash2("sha256").update(buf).digest("hex");
-        const contentHash = `sha256:${hex}`;
-        const blobPath = join11(this.blobsDir, `sha256_${hex}`);
-        if (existsSync5(blobPath)) {
-          return { contentHash, blobPath };
+      async writeBundle(dossier, options = {}, store, graph) {
+        const finalStore = store || await readAnalysis(this.projectRoot);
+        if (!finalStore) {
+          throw new Error("Analysis store not found. Scan the project first.");
         }
-        const tmpPath = join11(this.tmpDir, `tmp_${hex}_${Date.now()}`);
-        await writeFile7(tmpPath, buf);
-        const fh = await open(tmpPath, "r");
-        try {
-          await fh.datasync();
-        } finally {
-          await fh.close();
+        for (const p of dossier.pillars) {
+          p.decisions = p.decisions.filter((c) => !(c.severity === 1 && c.category === "Convention"));
+          p.cardCount = p.decisions.length;
         }
-        await rename2(tmpPath, blobPath);
-        return { contentHash, blobPath };
-      }
-      async readBlob(blobPath) {
-        const { readFile: readFile12 } = await import("fs/promises");
-        return readFile12(blobPath);
-      }
-      async blobExists(contentHash) {
-        const hex = contentHash.replace("sha256:", "");
-        const blobPath = join11(this.blobsDir, `sha256_${hex}`);
-        return existsSync5(blobPath);
-      }
-      blobPathForHash(contentHash) {
-        const hex = contentHash.replace("sha256:", "");
-        return join11(this.blobsDir, `sha256_${hex}`);
-      }
-      async verifyIntegrity(blobPath, expectedHash) {
-        try {
-          const { readFile: readFile12 } = await import("fs/promises");
-          const buf = await readFile12(blobPath);
-          const hex = createHash2("sha256").update(buf).digest("hex");
-          return `sha256:${hex}` === expectedHash;
-        } catch {
-          return false;
+        const viewModel = this.buildViewModel(dossier, finalStore);
+        const artifacts = [];
+        artifacts.push(...await new JsonRenderer().render(viewModel, finalStore));
+        artifacts.push(...await new ValidationRenderer().render(viewModel, finalStore));
+        artifacts.push(...await new RawAnalysisRenderer().render(viewModel, finalStore));
+        if (graph) {
+          artifacts.push(...await new GraphRenderer(graph).render(viewModel, finalStore));
         }
-      }
-      /** List all blob paths for GC reference counting */
-      async listBlobPaths() {
-        try {
-          const { readdir: readdir2 } = await import("fs/promises");
-          const files = await readdir2(this.blobsDir);
-          return files.filter((f) => f.startsWith("sha256_")).map((f) => join11(this.blobsDir, f));
-        } catch {
-          return [];
+        const formats = ["html", "markdown"];
+        if (options.format && options.format !== "json" && options.format !== "delta") {
+          formats.length = 0;
+          formats.push(options.format);
         }
-      }
-      async getBlobSize(blobPath) {
-        try {
-          const info = await stat(blobPath);
-          return info.size;
-        } catch {
-          return 0;
+        if (formats.includes("html")) {
+          artifacts.push(...await new HtmlRenderer().render(viewModel, finalStore));
+        }
+        if (formats.includes("markdown")) {
+          artifacts.push(...await new AgentMarkdownRenderer(options.budget).render(viewModel, finalStore));
         }
+        const writer = new ArtifactBundleWriter(this.projectRoot);
+        await writer.writeBundle(artifacts);
+      }
+      buildViewModel(dossier, _store) {
+        return { ...dossier, recommendations: {} };
       }
     };
   }
 });
 
-// ../../node_modules/async-mutex/index.mjs
-function insertSorted(a, v) {
-  const i = findIndexFromEnd(a, (other) => v.priority <= other.priority);
-  a.splice(i + 1, 0, v);
-}
-function findIndexFromEnd(a, predicate) {
-  for (let i = a.length - 1; i >= 0; i--) {
-    if (predicate(a[i])) {
-      return i;
-    }
+// dist/export/Watcher.js
+import chokidar from "chokidar";
+import { createHash as createHash2 } from "crypto";
+import { readFile as readFile7 } from "fs/promises";
+import { join as join11 } from "path";
+async function startWatcher(projectRoot, watchedPaths) {
+  const existing = activeWatchers.get(projectRoot);
+  if (existing) {
+    await existing.close();
+    activeWatchers.delete(projectRoot);
   }
-  return -1;
-}
-var E_TIMEOUT, E_ALREADY_LOCKED, E_CANCELED, __awaiter$2, Semaphore, __awaiter$1, Mutex;
-var init_async_mutex = __esm({
-  "../../node_modules/async-mutex/index.mjs"() {
-    E_TIMEOUT = new Error("timeout while waiting for mutex to become available");
-    E_ALREADY_LOCKED = new Error("mutex already locked");
-    E_CANCELED = new Error("request for lock canceled");
-    __awaiter$2 = function(thisArg, _arguments, P, generator) {
-      function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve2) {
-          resolve2(value);
-        });
-      }
-      return new (P || (P = Promise))(function(resolve2, reject) {
-        function fulfilled(value) {
-          try {
-            step(generator.next(value));
-          } catch (e) {
-            reject(e);
-          }
-        }
-        function rejected(value) {
-          try {
-            step(generator["throw"](value));
-          } catch (e) {
-            reject(e);
-          }
-        }
-        function step(result) {
-          result.done ? resolve2(result.value) : adopt(result.value).then(fulfilled, rejected);
-        }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-      });
-    };
-    Semaphore = class {
-      constructor(_value, _cancelError = E_CANCELED) {
-        this._value = _value;
-        this._cancelError = _cancelError;
-        this._queue = [];
-        this._weightedWaiters = [];
-      }
-      acquire(weight = 1, priority = 0) {
-        if (weight <= 0)
-          throw new Error(`invalid weight ${weight}: must be positive`);
-        return new Promise((resolve2, reject) => {
-          const task = { resolve: resolve2, reject, weight, priority };
-          const i = findIndexFromEnd(this._queue, (other) => priority <= other.priority);
-          if (i === -1 && weight <= this._value) {
-            this._dispatchItem(task);
-          } else {
-            this._queue.splice(i + 1, 0, task);
-          }
-        });
-      }
-      runExclusive(callback_1) {
-        return __awaiter$2(this, arguments, void 0, function* (callback, weight = 1, priority = 0) {
-          const [value, release] = yield this.acquire(weight, priority);
-          try {
-            return yield callback(value);
-          } finally {
-            release();
-          }
-        });
-      }
-      waitForUnlock(weight = 1, priority = 0) {
-        if (weight <= 0)
-          throw new Error(`invalid weight ${weight}: must be positive`);
-        if (this._couldLockImmediately(weight, priority)) {
-          return Promise.resolve();
-        } else {
-          return new Promise((resolve2) => {
-            if (!this._weightedWaiters[weight - 1])
-              this._weightedWaiters[weight - 1] = [];
-            insertSorted(this._weightedWaiters[weight - 1], { resolve: resolve2, priority });
-          });
-        }
-      }
-      isLocked() {
-        return this._value <= 0;
-      }
-      getValue() {
-        return this._value;
-      }
-      setValue(value) {
-        this._value = value;
-        this._dispatchQueue();
-      }
-      release(weight = 1) {
-        if (weight <= 0)
-          throw new Error(`invalid weight ${weight}: must be positive`);
-        this._value += weight;
-        this._dispatchQueue();
-      }
-      cancel() {
-        this._queue.forEach((entry) => entry.reject(this._cancelError));
-        this._queue = [];
-      }
-      _dispatchQueue() {
-        this._drainUnlockWaiters();
-        while (this._queue.length > 0 && this._queue[0].weight <= this._value) {
-          this._dispatchItem(this._queue.shift());
-          this._drainUnlockWaiters();
-        }
-      }
-      _dispatchItem(item) {
-        const previousValue = this._value;
-        this._value -= item.weight;
-        item.resolve([previousValue, this._newReleaser(item.weight)]);
-      }
-      _newReleaser(weight) {
-        let called = false;
-        return () => {
-          if (called)
-            return;
-          called = true;
-          this.release(weight);
-        };
-      }
-      _drainUnlockWaiters() {
-        if (this._queue.length === 0) {
-          for (let weight = this._value; weight > 0; weight--) {
-            const waiters = this._weightedWaiters[weight - 1];
-            if (!waiters)
-              continue;
-            waiters.forEach((waiter) => waiter.resolve());
-            this._weightedWaiters[weight - 1] = [];
-          }
-        } else {
-          const queuedPriority = this._queue[0].priority;
-          for (let weight = this._value; weight > 0; weight--) {
-            const waiters = this._weightedWaiters[weight - 1];
-            if (!waiters)
-              continue;
-            const i = waiters.findIndex((waiter) => waiter.priority <= queuedPriority);
-            (i === -1 ? waiters : waiters.splice(0, i)).forEach(((waiter) => waiter.resolve()));
+  const watcher = chokidar.watch(watchedPaths.length > 0 ? watchedPaths : projectRoot, {
+    ignoreInitial: true,
+    ignored: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.vibesplain/**"],
+    persistent: true
+  });
+  watcher.on("change", async (filepath) => {
+    try {
+      const dossier = await readDossier(projectRoot);
+      if (!dossier)
+        return;
+      const content = await readFile7(filepath, "utf8");
+      const newHash = createHash2("sha256").update(content).digest("hex");
+      let mutated = false;
+      for (const pillar of dossier.pillars) {
+        for (const card of pillar.decisions) {
+          if (!card.primaryFile)
+            continue;
+          const absMatch = filepath === join11(projectRoot, card.primaryFile) || filepath.endsWith("/" + card.primaryFile);
+          if (absMatch && card.lastScannedHash !== newHash) {
+            card.status = "stale";
+            const rel = card.primaryFile;
+            if (!dossier.stalePaths.includes(rel))
+              dossier.stalePaths.push(rel);
+            mutated = true;
           }
         }
       }
-      _couldLockImmediately(weight, priority) {
-        return (this._queue.length === 0 || this._queue[0].priority < priority) && weight <= this._value;
-      }
-    };
-    __awaiter$1 = function(thisArg, _arguments, P, generator) {
-      function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve2) {
-          resolve2(value);
-        });
-      }
-      return new (P || (P = Promise))(function(resolve2, reject) {
-        function fulfilled(value) {
-          try {
-            step(generator.next(value));
-          } catch (e) {
-            reject(e);
-          }
-        }
-        function rejected(value) {
-          try {
-            step(generator["throw"](value));
-          } catch (e) {
-            reject(e);
-          }
-        }
-        function step(result) {
-          result.done ? resolve2(result.value) : adopt(result.value).then(fulfilled, rejected);
-        }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-      });
-    };
-    Mutex = class {
-      constructor(cancelError) {
-        this._semaphore = new Semaphore(1, cancelError);
-      }
-      acquire() {
-        return __awaiter$1(this, arguments, void 0, function* (priority = 0) {
-          const [, releaser] = yield this._semaphore.acquire(1, priority);
-          return releaser;
-        });
-      }
-      runExclusive(callback, priority = 0) {
-        return this._semaphore.runExclusive(() => callback(), 1, priority);
-      }
-      isLocked() {
-        return this._semaphore.isLocked();
-      }
-      waitForUnlock(priority = 0) {
-        return this._semaphore.waitForUnlock(1, priority);
-      }
-      release() {
-        if (this._semaphore.isLocked())
-          this._semaphore.release();
-      }
-      cancel() {
-        return this._semaphore.cancel();
-      }
-    };
-  }
-});
-
-// dist/store/PointerStore.js
-import Database from "better-sqlite3";
-import { join as join12 } from "path";
-import { mkdirSync } from "fs";
-var instance, PointerStore;
-var init_PointerStore = __esm({
-  "dist/store/PointerStore.js"() {
-    "use strict";
-    init_async_mutex();
-    instance = null;
-    PointerStore = class _PointerStore {
-      db;
-      writeMutex = new Mutex();
-      constructor(projectRoot) {
-        const dir = join12(projectRoot, ".vibe-splainer");
-        mkdirSync(dir, { recursive: true });
-        this.db = new Database(join12(dir, "pointer_store.db"), { timeout: 1e4 });
-        let retries = 5;
-        while (retries > 0) {
-          try {
-            this.db.pragma("journal_mode = WAL");
-            this.db.pragma("foreign_keys = ON");
-            break;
-          } catch (e) {
-            if (e.code === "SQLITE_BUSY" && retries > 1) {
-              retries--;
-              const delay = 100 + Math.random() * 200;
-              const start = Date.now();
-              while (Date.now() - start < delay) {
-              }
-              continue;
-            }
-            throw e;
-          }
-        }
-        this._migrate();
-      }
-      static open(projectRoot) {
-        if (!instance)
-          instance = new _PointerStore(projectRoot);
-        return instance;
-      }
-      static reset() {
-        instance = null;
-      }
-      _migrate() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS pointers (
-        pointerId     TEXT PRIMARY KEY,
-        scanId        TEXT NOT NULL,
-        artifactName  TEXT NOT NULL,
-        contentHash   TEXT NOT NULL,
-        blobPath      TEXT NOT NULL,
-        schemaVersion TEXT NOT NULL DEFAULT '1.0.0',
-        createdAt     INTEGER NOT NULL,
-        expiresAt     INTEGER
-      );
-      CREATE INDEX IF NOT EXISTS idx_pointers_scan ON pointers(scanId);
-      CREATE INDEX IF NOT EXISTS idx_pointers_hash ON pointers(contentHash);
-
-      CREATE TABLE IF NOT EXISTS work_orders (
-        workOrderId   TEXT PRIMARY KEY,
-        intent        TEXT NOT NULL,
-        allowedFiles  TEXT NOT NULL DEFAULT '[]',
-        allowedGlobs  TEXT NOT NULL DEFAULT '[]',
-        deniedGlobs   TEXT NOT NULL DEFAULT '[]',
-        requiredProof TEXT NOT NULL DEFAULT '[]',
-        status        TEXT NOT NULL DEFAULT 'pending',
-        createdAt     INTEGER NOT NULL
-      );
-
-      CREATE TABLE IF NOT EXISTS receipts (
-        receiptId     TEXT PRIMARY KEY,
-        workOrderId   TEXT NOT NULL REFERENCES work_orders(workOrderId),
-        status        TEXT NOT NULL,
-        proofPointers TEXT NOT NULL DEFAULT '[]',
-        changedFiles  TEXT NOT NULL DEFAULT '[]',
-        summary       TEXT NOT NULL DEFAULT '',
-        createdAt     INTEGER NOT NULL,
-        FOREIGN KEY (workOrderId) REFERENCES work_orders(workOrderId)
-      );
-    `);
-      }
-      async insertPointer(row) {
-        await this.writeMutex.runExclusive(() => {
-          this.db.prepare(`
-        INSERT OR REPLACE INTO pointers
-          (pointerId, scanId, artifactName, contentHash, blobPath, schemaVersion, createdAt, expiresAt)
-        VALUES
-          (@pointerId, @scanId, @artifactName, @contentHash, @blobPath, @schemaVersion, @createdAt, @expiresAt)
-      `).run(row);
-        });
-      }
-      getPointer(pointerId) {
-        return this.db.prepare("SELECT * FROM pointers WHERE pointerId = ?").get(pointerId) ?? null;
-      }
-      listPointersByScan(scanId) {
-        return this.db.prepare("SELECT * FROM pointers WHERE scanId = ?").all(scanId);
-      }
-      async insertWorkOrder(row) {
-        await this.writeMutex.runExclusive(() => {
-          this.db.prepare(`
-        INSERT OR REPLACE INTO work_orders
-          (workOrderId, intent, allowedFiles, allowedGlobs, deniedGlobs, requiredProof, status, createdAt)
-        VALUES
-          (@workOrderId, @intent, @allowedFiles, @allowedGlobs, @deniedGlobs, @requiredProof, @status, @createdAt)
-      `).run(row);
-        });
-      }
-      getWorkOrder(workOrderId) {
-        return this.db.prepare("SELECT * FROM work_orders WHERE workOrderId = ?").get(workOrderId) ?? null;
-      }
-      async updateWorkOrderStatus(workOrderId, status) {
-        await this.writeMutex.runExclusive(() => {
-          this.db.prepare("UPDATE work_orders SET status = ? WHERE workOrderId = ?").run(status, workOrderId);
-        });
-      }
-      async insertReceipt(receipt) {
-        await this.writeMutex.runExclusive(() => {
-          this.db.prepare(`
-        INSERT OR REPLACE INTO receipts
-          (receiptId, workOrderId, status, proofPointers, changedFiles, summary, createdAt)
-        VALUES
-          (@receiptId, @workOrderId, @status, @proofPointers, @changedFiles, @summary, @createdAt)
-      `).run({
-            ...receipt,
-            proofPointers: JSON.stringify(receipt.proofPointers),
-            changedFiles: JSON.stringify(receipt.changedFiles),
-            createdAt: Date.now()
-          });
-        });
-      }
-      /** GC: delete pointers older than cutoffMs and not pinned, return deleted count */
-      async gcScanPointers(keepScanIds) {
-        return await this.writeMutex.runExclusive(() => {
-          const placeholders = keepScanIds.map(() => "?").join(",");
-          const whereClause = keepScanIds.length > 0 ? `WHERE scanId NOT IN (${placeholders})` : "";
-          const result = this.db.prepare(`DELETE FROM pointers ${whereClause}`).run(...keepScanIds);
-          return result.changes;
-        });
-      }
-      listAllScanIds() {
-        const rows = this.db.prepare("SELECT DISTINCT scanId FROM pointers").all();
-        return rows.map((r) => r.scanId);
-      }
-      countPointers() {
-        const row = this.db.prepare("SELECT COUNT(*) as cnt FROM pointers").get();
-        return row.cnt;
-      }
-      close() {
-        this.db.close();
-        instance = null;
-      }
-    };
-  }
-});
-
-// ../../node_modules/uuid/dist/esm-node/rng.js
-import crypto from "crypto";
-function rng() {
-  if (poolPtr > rnds8Pool.length - 16) {
-    crypto.randomFillSync(rnds8Pool);
-    poolPtr = 0;
-  }
-  return rnds8Pool.slice(poolPtr, poolPtr += 16);
-}
-var rnds8Pool, poolPtr;
-var init_rng = __esm({
-  "../../node_modules/uuid/dist/esm-node/rng.js"() {
-    rnds8Pool = new Uint8Array(256);
-    poolPtr = rnds8Pool.length;
-  }
-});
-
-// ../../node_modules/uuid/dist/esm-node/stringify.js
-function unsafeStringify(arr, offset = 0) {
-  return byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]];
-}
-var byteToHex;
-var init_stringify = __esm({
-  "../../node_modules/uuid/dist/esm-node/stringify.js"() {
-    byteToHex = [];
-    for (let i = 0; i < 256; ++i) {
-      byteToHex.push((i + 256).toString(16).slice(1));
-    }
-  }
-});
-
-// ../../node_modules/uuid/dist/esm-node/native.js
-import crypto2 from "crypto";
-var native_default;
-var init_native = __esm({
-  "../../node_modules/uuid/dist/esm-node/native.js"() {
-    native_default = {
-      randomUUID: crypto2.randomUUID
-    };
-  }
-});
-
-// ../../node_modules/uuid/dist/esm-node/v4.js
-function v4(options, buf, offset) {
-  if (native_default.randomUUID && !buf && !options) {
-    return native_default.randomUUID();
-  }
-  options = options || {};
-  const rnds = options.random || (options.rng || rng)();
-  rnds[6] = rnds[6] & 15 | 64;
-  rnds[8] = rnds[8] & 63 | 128;
-  if (buf) {
-    offset = offset || 0;
-    for (let i = 0; i < 16; ++i) {
-      buf[offset + i] = rnds[i];
-    }
-    return buf;
-  }
-  return unsafeStringify(rnds);
-}
-var v4_default;
-var init_v4 = __esm({
-  "../../node_modules/uuid/dist/esm-node/v4.js"() {
-    init_native();
-    init_rng();
-    init_stringify();
-    v4_default = v4;
-  }
-});
-
-// ../../node_modules/uuid/dist/esm-node/index.js
-var init_esm_node = __esm({
-  "../../node_modules/uuid/dist/esm-node/index.js"() {
-    init_v4();
-  }
-});
-
-// dist/export/ExportOrchestrator.js
-var ExportOrchestrator;
-var init_ExportOrchestrator = __esm({
-  "dist/export/ExportOrchestrator.js"() {
-    "use strict";
-    init_dist();
-    init_ArtifactBundleWriter();
-    init_JsonRenderer();
-    init_HtmlRenderer();
-    init_AgentMarkdownRenderer();
-    init_ValidationRenderer();
-    init_RawAnalysisRenderer();
-    init_GraphRenderer();
-    init_BlobStore();
-    init_PointerStore();
-    init_esm_node();
-    ExportOrchestrator = class {
-      projectRoot;
-      constructor(projectRoot) {
-        this.projectRoot = projectRoot;
-      }
-      async writeBundle(dossier, options = {}, store, graph, scanId) {
-        const finalStore = store || await readAnalysis(this.projectRoot);
-        if (!finalStore) {
-          throw new Error("Analysis store not found. Scan the project first.");
-        }
-        for (const p of dossier.pillars) {
-          p.decisions = p.decisions.filter((c) => !(c.severity === 1 && c.category === "Convention"));
-          p.cardCount = p.decisions.length;
-        }
-        const viewModel = this.buildViewModel(dossier, finalStore);
-        const artifacts = [];
-        artifacts.push(...await new JsonRenderer().render(viewModel, finalStore));
-        artifacts.push(...await new ValidationRenderer().render(viewModel, finalStore));
-        artifacts.push(...await new RawAnalysisRenderer().render(viewModel, finalStore));
-        if (graph) {
-          artifacts.push(...await new GraphRenderer(graph).render(viewModel, finalStore));
-        }
-        const gateIndex = buildGateIndex(finalStore);
-        artifacts.push({
-          type: "gate",
-          path: "gate.json",
-          content: JSON.stringify(gateIndex, null, 2)
-        });
-        const formats = ["html", "markdown"];
-        if (options.format && options.format !== "json" && options.format !== "delta") {
-          formats.length = 0;
-          formats.push(options.format);
-        }
-        if (formats.includes("html")) {
-          artifacts.push(...await new HtmlRenderer().render(viewModel, finalStore));
-        }
-        if (formats.includes("markdown")) {
-          artifacts.push(...await new AgentMarkdownRenderer(options.budget).render(viewModel, finalStore));
-        }
-        const writer = new ArtifactBundleWriter(this.projectRoot);
-        await writer.writeBundle(artifacts);
-        const effectiveScanId = scanId ?? `scan_${Date.now()}`;
-        const blobStore = new BlobStore(this.projectRoot);
-        const pointerStore = PointerStore.open(this.projectRoot);
-        const now = Date.now();
-        const manifestEntries = [];
-        for (const artifact of artifacts) {
-          const content = typeof artifact.content === "string" ? Buffer.from(artifact.content, "utf8") : artifact.content;
-          const { contentHash, blobPath } = await blobStore.writeAtomic(content);
-          const pointerId = `ptr_${v4_default().replace(/-/g, "").slice(0, 16)}`;
-          await pointerStore.insertPointer({
-            pointerId,
-            scanId: effectiveScanId,
-            artifactName: artifact.type,
-            contentHash,
-            blobPath,
-            schemaVersion: "1.0.0",
-            createdAt: now,
-            expiresAt: null
-          });
-          const entry = {
-            name: artifact.type,
-            pointer: pointerId,
-            contentHash,
-            sizeBytes: content.length
-          };
-          if (artifact.type === "analysis") {
-            entry.hydrators = ["get_project_summary", "get_start_here"];
-            const analysisIndex = {
-              schemaVersion: "1.0.0",
-              scanId: effectiveScanId,
-              startHere: dossier.map.topGravity.slice(0, 12),
-              topHeat: dossier.map.topHeat.slice(0, 12),
-              pillarSummary: dossier.map.pillars.map((p) => ({
-                name: p.name,
-                fileCount: p.memberFiles?.length ?? 0
-              })),
-              totalFiles: Object.keys(finalStore.files).length,
-              realSourceFiles: Object.values(finalStore.files).filter((f) => f.isRealSource).length
-            };
-            const indexContent = Buffer.from(JSON.stringify(analysisIndex, null, 2), "utf8");
-            const indexWrite = await blobStore.writeAtomic(indexContent);
-            const indexPointerId = `ptr_${v4_default().replace(/-/g, "").slice(0, 16)}`;
-            await pointerStore.insertPointer({
-              pointerId: indexPointerId,
-              scanId: effectiveScanId,
-              artifactName: "analysis.index",
-              contentHash: indexWrite.contentHash,
-              blobPath: indexWrite.blobPath,
-              schemaVersion: "1.0.0",
-              createdAt: now,
-              expiresAt: null
-            });
-            entry.indexes = { startHere: indexPointerId };
-          }
-          manifestEntries.push(entry);
-        }
-        const manifest = {
-          schemaVersion: "2.0.0",
-          scanId: effectiveScanId,
-          generatedAt: new Date(now).toISOString(),
-          projectRoot: this.projectRoot,
-          artifacts: manifestEntries
-        };
-        const manifestContent = Buffer.from(JSON.stringify(manifest, null, 2), "utf8");
-        const manifestWrite = await blobStore.writeAtomic(manifestContent);
-        const manifestPointerId = `ptr_manifest_${effectiveScanId}`;
-        await pointerStore.insertPointer({
-          pointerId: manifestPointerId,
-          scanId: effectiveScanId,
-          artifactName: "artifact_manifest",
-          contentHash: manifestWrite.contentHash,
-          blobPath: manifestWrite.blobPath,
-          schemaVersion: "2.0.0",
-          createdAt: now,
-          expiresAt: null
-        });
-        return { scanId: effectiveScanId, manifestPointer: manifestPointerId };
-      }
-      buildViewModel(dossier, store) {
-        const recommendations = {};
-        for (const file of dossier.map.topGravity) {
-          const persisted = store.files[file];
-          if (persisted) {
-            recommendations[file] = RecommendationEngine.generateRecommendations(persisted);
-          }
-        }
-        for (const file of dossier.map.topHeat) {
-          if (!recommendations[file]) {
-            const persisted = store.files[file];
-            if (persisted) {
-              recommendations[file] = RecommendationEngine.generateRecommendations(persisted);
-            }
-          }
-        }
-        return {
-          ...dossier,
-          recommendations
-        };
-      }
-    };
-  }
-});
-
-// dist/export/Watcher.js
-import chokidar from "chokidar";
-import { createHash as createHash3 } from "crypto";
-import { readFile as readFile7 } from "fs/promises";
-import { join as join13 } from "path";
-async function startWatcher(projectRoot, watchedPaths) {
-  const existing = activeWatchers.get(projectRoot);
-  if (existing) {
-    await existing.close();
-    activeWatchers.delete(projectRoot);
-  }
-  const watcher = chokidar.watch(watchedPaths.length > 0 ? watchedPaths : projectRoot, {
-    ignoreInitial: true,
-    ignored: ["**/node_modules/**", "**/dist/**", "**/build/**", "**/.vibe-splainer/**"],
-    persistent: true
-  });
-  watcher.on("change", async (filepath) => {
-    try {
-      const dossier = await readDossier(projectRoot);
-      if (!dossier)
-        return;
-      const content = await readFile7(filepath, "utf8");
-      const newHash = createHash3("sha256").update(content).digest("hex");
-      let mutated = false;
-      for (const pillar of dossier.pillars) {
-        for (const card of pillar.decisions) {
-          if (!card.primaryFile)
-            continue;
-          const absMatch = filepath === join13(projectRoot, card.primaryFile) || filepath.endsWith("/" + card.primaryFile);
-          if (absMatch && card.lastScannedHash !== newHash) {
-            card.status = "stale";
-            const rel = card.primaryFile;
-            if (!dossier.stalePaths.includes(rel))
-              dossier.stalePaths.push(rel);
-            mutated = true;
-          }
-        }
-      }
-      if (mutated) {
-        const orchestrator = new ExportOrchestrator(projectRoot);
-        await orchestrator.writeBundle(dossier);
-        console.error(`[vibe-splain] File changed: ${filepath}. Dossier artifacts updated.`);
+      if (mutated) {
+        const orchestrator = new ExportOrchestrator(projectRoot);
+        await orchestrator.writeBundle(dossier);
+        console.error(`[vibesplain] File changed: ${filepath}. Dossier artifacts updated.`);
       }
     } catch (err) {
-      console.error("[vibe-splain] Watcher error:", err);
+      console.error("[vibesplain] Watcher error:", err);
     }
   });
   activeWatchers.set(projectRoot, watcher);
-  console.error("[vibe-splain] File watcher started");
+  console.error("[vibesplain] File watcher started");
 }
 var activeWatchers;
 var init_Watcher = __esm({
@@ -4291,29 +3348,28 @@ async function performScan(projectRoot, options = {}) {
   }
   const scanId = `scan_${Date.now()}`;
   const orchestrator = new ExportOrchestrator(projectRoot);
-  const { manifestPointer } = await orchestrator.writeBundle(dossier, {
+  await orchestrator.writeBundle(dossier, {
     format: options.format,
     budget: options.budget ? parseInt(options.budget, 10) : void 0,
     scope: options.scope
-  }, result.store, result.graph, scanId);
-  return { result, dossier, scanId, manifestPointer };
+  }, result.store, result.graph);
+  return { result, dossier, scanId };
 }
 async function handleScanProject(args, options = {}) {
   const projectRoot = args.projectRoot;
   if (!projectRoot)
     throw new Error("projectRoot is required");
-  console.error(`[vibe-splain] Scanning project: ${projectRoot}`);
-  const { result, scanId, manifestPointer } = await performScan(projectRoot, options);
+  console.error(`[vibesplain] Scanning project: ${projectRoot}`);
+  const { result, scanId } = await performScan(projectRoot, options);
   if (options.watch !== false) {
     await startWatcher(projectRoot, result.files.map((f) => f.path));
   }
-  console.error(`[vibe-splain] Scan complete. ${result.totalFilesScanned} files, ${result.realSourceCount} real-source, ${result.wildCandidates.length} wild candidates.`);
-  const validation = result.validation ?? { passed: true, errors: 0, warnings: 0, reportPath: ".vibe-splainer/validation_report.json" };
+  console.error(`[vibesplain] Scan complete. ${result.totalFilesScanned} files, ${result.realSourceCount} real-source, ${result.wildCandidates.length} wild candidates.`);
+  const validation = result.validation ?? { passed: true, errors: 0, warnings: 0, reportPath: ".vibesplain/validation_report.json" };
   return {
     ok: true,
     message: "Scan complete.",
     scanId,
-    manifestPointer,
     validation: result.fullValidationReport || {
       passed: validation.passed,
       errors: validation.errors,
@@ -4321,10 +3377,10 @@ async function handleScanProject(args, options = {}) {
       reportPath: validation.reportPath
     },
     artifacts: {
-      analysis: ".vibe-splainer/analysis.json",
-      dossier: ".vibe-splainer/dossier.json",
-      graph: ".vibe-splainer/graph.json",
-      html: ".vibe-splainer/ui/index.html"
+      analysis: ".vibesplain/analysis.json",
+      dossier: ".vibesplain/dossier.json",
+      graph: ".vibesplain/graph.json",
+      html: ".vibesplain/ui/index.html"
     },
     projectRoot: result.projectRoot,
     totalFilesScanned: result.totalFilesScanned,
@@ -4374,9 +3430,8 @@ import { Command } from "commander";
 // dist/commands/install.js
 import { readFile, writeFile } from "fs/promises";
 import { existsSync } from "fs";
-import { join, dirname } from "path";
+import { join } from "path";
 import { homedir } from "os";
-import { fileURLToPath } from "url";
 function expandPath(p) {
   if (p.startsWith("~")) {
     return join(homedir(), p.slice(1));
@@ -4399,40 +3454,8 @@ var MCP_ENTRY = {
   command: "npx",
   args: ["-y", "vibe-splain", "serve"]
 };
-var HOOK_MATCHER = "Edit|Write|MultiEdit";
-var DEFAULT_HOOK_COMMAND = "npx -y vibe-splain hook pretooluse";
-function addPreToolUseHook(config, hookPath) {
-  if (!config.hooks)
-    config.hooks = {};
-  if (!Array.isArray(config.hooks.PreToolUse))
-    config.hooks.PreToolUse = [];
-  const hookCommand = hookPath ? `node "${hookPath}"` : DEFAULT_HOOK_COMMAND;
-  const already = config.hooks.PreToolUse.some((entry) => Array.isArray(entry?.hooks) && entry.hooks.some((h) => typeof h?.command === "string" && (h.command.includes("vibe-splain hook pretooluse") || h.command.includes("hook.js"))));
-  if (already) {
-    config.hooks.PreToolUse = config.hooks.PreToolUse.map((entry) => {
-      if (Array.isArray(entry?.hooks)) {
-        return {
-          ...entry,
-          hooks: entry.hooks.map((h) => {
-            if (typeof h?.command === "string" && (h.command.includes("vibe-splain hook pretooluse") || h.command.includes("hook.js"))) {
-              return { ...h, command: hookCommand };
-            }
-            return h;
-          })
-        };
-      }
-      return entry;
-    });
-    return config;
-  }
-  config.hooks.PreToolUse.push({
-    matcher: HOOK_MATCHER,
-    hooks: [{ type: "command", command: hookCommand }]
-  });
-  return config;
-}
 async function installCommand() {
-  console.error("\n\u{1F527} vibe-splain Installer\n");
+  console.error("\n\u{1F527} vibesplain Installer\n");
   let patchedCount = 0;
   for (const agent of AGENT_CONFIGS) {
     const resolvedPath = expandPath(agent.path);
@@ -4452,13 +3475,8 @@ async function installCommand() {
       const before = JSON.stringify(config);
       if (!config.mcpServers)
         config.mcpServers = {};
-      if (!config.mcpServers["vibe-splain"])
-        config.mcpServers["vibe-splain"] = MCP_ENTRY;
-      if (agent.name === "Claude Code CLI") {
-        const __dirname3 = dirname(fileURLToPath(import.meta.url));
-        const hookPath = join(__dirname3, "..", "hook.js");
-        addPreToolUseHook(config, hookPath);
-      }
+      if (!config.mcpServers["vibesplain"])
+        config.mcpServers["vibesplain"] = MCP_ENTRY;
       if (JSON.stringify(config) === before) {
         console.error(`    \u2713 Already configured, skipping`);
         patchedCount++;
@@ -4478,7 +3496,7 @@ async function installCommand() {
 `);
     console.error(JSON.stringify({
       mcpServers: {
-        "vibe-splain": MCP_ENTRY
+        "vibesplain": MCP_ENTRY
       }
     }, null, 2));
     process.exit(1);
@@ -4583,7 +3601,7 @@ async function handleSetProjectBrief(args, options = {}) {
 // dist/mcp/tools/get_file_context.js
 init_dist();
 import { readFile as readFile8 } from "fs/promises";
-import { join as join14, relative as relative4, isAbsolute } from "path";
+import { join as join12, relative as relative4, isAbsolute } from "path";
 var getFileContextTool = {
   name: "get_file_context",
   description: "Returns PRE-EXTRACTED evidence for a file so you do not have to read the whole thing and paraphrase its header comment. Returns: gravity/heat scores + signals, importedBy (named fan-in \u2014 use this for blastRadius), hotSpans (the gnarliest function bodies, comment-stripped, each with a reason), smellSpans (located tech debt with \xB13 lines of context), and signature (the exported API surface). Base your evidence on hotSpans/smellSpans \u2014 NEVER on header comments. Pass { full: true } only if you truly need the raw source.",
@@ -4603,7 +3621,7 @@ async function handleGetFileContext(args) {
   const full = args.full === true;
   if (!projectRoot || !filePath)
     throw new Error("projectRoot and filePath are required");
-  const fullPath = isAbsolute(filePath) ? filePath : join14(projectRoot, filePath);
+  const fullPath = isAbsolute(filePath) ? filePath : join12(projectRoot, filePath);
   const relPath = relative4(projectRoot, fullPath);
   const evidence = await getFileAnalysis(fullPath);
   if (!evidence) {
@@ -4636,42 +3654,90 @@ async function handleGetFileContext(args) {
 // dist/mcp/tools/write_decision_card.js
 init_dist();
 init_ExportOrchestrator();
-init_esm_node();
-import { createHash as createHash4 } from "crypto";
-import { readFile as readFile9 } from "fs/promises";
-import { join as join15 } from "path";
-var CATEGORIES = ["Bottleneck", "Hack", "Smart-Move", "Risk", "Convention", "Dead-Weight"];
-function normalizeSnippet(s) {
-  let out = (s ?? "").replace(/\r\n/g, "\n");
-  if (/\\[nt]/.test(out)) {
-    out = out.replace(/\\r\\n/g, "\n").replace(/\\n/g, "\n").replace(/\\t/g, "  ");
+
+// ../../node_modules/uuid/dist/esm-node/rng.js
+import crypto from "crypto";
+var rnds8Pool = new Uint8Array(256);
+var poolPtr = rnds8Pool.length;
+function rng() {
+  if (poolPtr > rnds8Pool.length - 16) {
+    crypto.randomFillSync(rnds8Pool);
+    poolPtr = 0;
   }
-  return out.split("\n").map((l) => l.replace(/\s+$/, "")).join("\n").replace(/^\n+|\n+$/g, "");
+  return rnds8Pool.slice(poolPtr, poolPtr += 16);
 }
-var writeDecisionCardTool = {
-  name: "write_decision_card",
-  description: "Persists ONE Decision Card about ONE file. This is a hostile architecture review, not documentation. The thesis must be a VERDICT, not a description. The pillar MUST be one of the names from get_project_map (free-form is rejected). One card per file (duplicates rejected). Evidence must come from get_file_context hotSpans/smellSpans \u2014 never the header comment, never the whole file.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      projectRoot: { type: "string" },
-      pillar: { type: "string", description: "MUST be one of the pillar names from get_project_map. Free-form values are rejected." },
-      primaryFile: { type: "string", description: "The single file this card is about (relative path). Used to reject duplicate cards." },
-      title: { type: "string" },
-      thesis: { type: "string", description: "ONE sharp sentence. A verdict, not a description. Take a position. Bad: 'This file implements a panel system.' Good: 'A 600-line god-component that owns drag, zoom, persistence AND the host bridge \u2014 the single highest-risk refactor in the app.'" },
-      category: { type: "string", enum: CATEGORIES },
-      severity: { type: "integer", minimum: 1, maximum: 5 },
-      narrative: { type: "string", description: "3-5 sentences. WHY it exists and WHY it's built this way. Do NOT restate the file's header comments." },
-      tradeoff: { type: "string", description: "What was given up, or why the obvious approach was rejected. Null only if genuinely none." },
-      blastRadius: { type: "string", description: "What breaks if this changes. Ground it in the fan-in (importedBy) from get_file_context." },
-      confidence: { type: "string", enum: ["low", "medium", "high"], description: 'Do NOT default to "high". Reserve "high" ONLY for provable execution anti-patterns. Score subjective stylistic choices or abstractions as "low" or "medium".' },
-      evidence: {
-        type: "array",
-        items: {
-          type: "object",
-          properties: {
-            file: { type: "string" },
-            startLine: { type: "number" },
+
+// ../../node_modules/uuid/dist/esm-node/stringify.js
+var byteToHex = [];
+for (let i = 0; i < 256; ++i) {
+  byteToHex.push((i + 256).toString(16).slice(1));
+}
+function unsafeStringify(arr, offset = 0) {
+  return byteToHex[arr[offset + 0]] + byteToHex[arr[offset + 1]] + byteToHex[arr[offset + 2]] + byteToHex[arr[offset + 3]] + "-" + byteToHex[arr[offset + 4]] + byteToHex[arr[offset + 5]] + "-" + byteToHex[arr[offset + 6]] + byteToHex[arr[offset + 7]] + "-" + byteToHex[arr[offset + 8]] + byteToHex[arr[offset + 9]] + "-" + byteToHex[arr[offset + 10]] + byteToHex[arr[offset + 11]] + byteToHex[arr[offset + 12]] + byteToHex[arr[offset + 13]] + byteToHex[arr[offset + 14]] + byteToHex[arr[offset + 15]];
+}
+
+// ../../node_modules/uuid/dist/esm-node/native.js
+import crypto2 from "crypto";
+var native_default = {
+  randomUUID: crypto2.randomUUID
+};
+
+// ../../node_modules/uuid/dist/esm-node/v4.js
+function v4(options, buf, offset) {
+  if (native_default.randomUUID && !buf && !options) {
+    return native_default.randomUUID();
+  }
+  options = options || {};
+  const rnds = options.random || (options.rng || rng)();
+  rnds[6] = rnds[6] & 15 | 64;
+  rnds[8] = rnds[8] & 63 | 128;
+  if (buf) {
+    offset = offset || 0;
+    for (let i = 0; i < 16; ++i) {
+      buf[offset + i] = rnds[i];
+    }
+    return buf;
+  }
+  return unsafeStringify(rnds);
+}
+var v4_default = v4;
+
+// dist/mcp/tools/write_decision_card.js
+import { createHash as createHash3 } from "crypto";
+import { readFile as readFile9 } from "fs/promises";
+import { join as join13 } from "path";
+var CATEGORIES = ["Bottleneck", "Hack", "Smart-Move", "Risk", "Convention", "Dead-Weight"];
+function normalizeSnippet(s) {
+  let out = (s ?? "").replace(/\r\n/g, "\n");
+  if (/\\[nt]/.test(out)) {
+    out = out.replace(/\\r\\n/g, "\n").replace(/\\n/g, "\n").replace(/\\t/g, "  ");
+  }
+  return out.split("\n").map((l) => l.replace(/\s+$/, "")).join("\n").replace(/^\n+|\n+$/g, "");
+}
+var writeDecisionCardTool = {
+  name: "write_decision_card",
+  description: "Persists ONE Decision Card about ONE file. This is a hostile architecture review, not documentation. The thesis must be a VERDICT, not a description. The pillar MUST be one of the names from get_project_map (free-form is rejected). One card per file (duplicates rejected). Evidence must come from get_file_context hotSpans/smellSpans \u2014 never the header comment, never the whole file.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      projectRoot: { type: "string" },
+      pillar: { type: "string", description: "MUST be one of the pillar names from get_project_map. Free-form values are rejected." },
+      primaryFile: { type: "string", description: "The single file this card is about (relative path). Used to reject duplicate cards." },
+      title: { type: "string" },
+      thesis: { type: "string", description: "ONE sharp sentence. A verdict, not a description. Take a position. Bad: 'This file implements a panel system.' Good: 'A 600-line god-component that owns drag, zoom, persistence AND the host bridge \u2014 the single highest-risk refactor in the app.'" },
+      category: { type: "string", enum: CATEGORIES },
+      severity: { type: "integer", minimum: 1, maximum: 5 },
+      narrative: { type: "string", description: "3-5 sentences. WHY it exists and WHY it's built this way. Do NOT restate the file's header comments." },
+      tradeoff: { type: "string", description: "What was given up, or why the obvious approach was rejected. Null only if genuinely none." },
+      blastRadius: { type: "string", description: "What breaks if this changes. Ground it in the fan-in (importedBy) from get_file_context." },
+      confidence: { type: "string", enum: ["low", "medium", "high"], description: 'Do NOT default to "high". Reserve "high" ONLY for provable execution anti-patterns. Score subjective stylistic choices or abstractions as "low" or "medium".' },
+      evidence: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            file: { type: "string" },
+            startLine: { type: "number" },
             endLine: { type: "number" },
             snippet: { type: "string" }
           },
@@ -4736,10 +3802,10 @@ async function handleWriteDecisionCard(args, options = {}) {
   const heat = persisted ? Math.round(persisted.heat) : void 0;
   let primaryContent = "";
   try {
-    primaryContent = await readFile9(join15(projectRoot, primaryFile), "utf8");
+    primaryContent = await readFile9(join13(projectRoot, primaryFile), "utf8");
   } catch {
   }
-  const hash = createHash4("sha256").update(primaryContent).digest("hex");
+  const hash = createHash3("sha256").update(primaryContent).digest("hex");
   const card = {
     id: v4_default(),
     pillar,
@@ -4776,7 +3842,7 @@ async function handleWriteDecisionCard(args, options = {}) {
     budget: options.budget ? parseInt(options.budget, 10) : void 0,
     scope: options.scope
   });
-  console.error(`[vibe-splain] Card written: "${title}" [${category} sev${severity}] in "${pillar}"${isWild ? " (Wild Discovery)" : ""}`);
+  console.error(`[vibesplain] Card written: "${title}" [${category} sev${severity}] in "${pillar}"${isWild ? " (Wild Discovery)" : ""}`);
   const documented = new Set([...dossier.pillars.flatMap((p) => p.decisions), ...dossier.wildDiscoveries].map((c) => c.primaryFile).filter(Boolean));
   const remaining = [.../* @__PURE__ */ new Set([...dossier.map.topGravity, ...dossier.map.topHeat])].filter((f) => !documented.has(f));
   return {
@@ -4971,2377 +4037,111 @@ async function handleMarkStale(args, options = {}) {
   };
 }
 
-// dist/mcp/tools/get_file_skeleton.js
-import { readFile as readFile10 } from "fs/promises";
-import { join as join16 } from "path";
-
-// ../../node_modules/balanced-match/dist/esm/index.js
-var balanced = (a, b, str) => {
-  const ma = a instanceof RegExp ? maybeMatch(a, str) : a;
-  const mb = b instanceof RegExp ? maybeMatch(b, str) : b;
-  const r = ma !== null && mb != null && range(ma, mb, str);
-  return r && {
-    start: r[0],
-    end: r[1],
-    pre: str.slice(0, r[0]),
-    body: str.slice(r[0] + ma.length, r[1]),
-    post: str.slice(r[1] + mb.length)
-  };
-};
-var maybeMatch = (reg, str) => {
-  const m = str.match(reg);
-  return m ? m[0] : null;
+// dist/mcp/server.js
+var ALL_TOOLS = [
+  scanProjectTool,
+  getProjectMapTool,
+  setProjectBriefTool,
+  getFileContextTool,
+  writeDecisionCardTool,
+  getStrategicOverviewTool,
+  inspectPillarTool,
+  getWildDiscoveriesTool,
+  markStaleTool
+];
+var TOOL_HANDLERS = {
+  scan_project: handleScanProject,
+  get_project_map: handleGetProjectMap,
+  set_project_brief: handleSetProjectBrief,
+  get_file_context: handleGetFileContext,
+  write_decision_card: handleWriteDecisionCard,
+  get_strategic_overview: handleGetStrategicOverview,
+  inspect_pillar: handleInspectPillar,
+  get_wild_discoveries: handleGetWildDiscoveries,
+  mark_stale: handleMarkStale
 };
-var range = (a, b, str) => {
-  let begs, beg, left, right = void 0, result;
-  let ai = str.indexOf(a);
-  let bi = str.indexOf(b, ai + 1);
-  let i = ai;
-  if (ai >= 0 && bi > 0) {
-    if (a === b) {
-      return [ai, bi];
-    }
-    begs = [];
-    left = str.length;
-    while (i >= 0 && !result) {
-      if (i === ai) {
-        begs.push(i);
-        ai = str.indexOf(a, i + 1);
-      } else if (begs.length === 1) {
-        const r = begs.pop();
-        if (r !== void 0)
-          result = [r, bi];
-      } else {
-        beg = begs.pop();
-        if (beg !== void 0 && beg < left) {
-          left = beg;
-          right = bi;
-        }
-        bi = str.indexOf(b, i + 1);
+async function startMCPServer(options = {}) {
+  await initParser2();
+  console.error("[vibesplain] Tree-Sitter parser initialized");
+  const server = new Server({ name: "vibesplain", version: "4.0.0" }, { capabilities: { tools: {}, prompts: {} } });
+  server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: [
+      {
+        name: "build_dossier",
+        description: "Build a full architectural dossier using vibesplain (replaces the need to copy-paste the README prompt)"
       }
-      i = ai < bi && ai >= 0 ? ai : bi;
-    }
-    if (begs.length && right !== void 0) {
-      result = [left, right];
+    ]
+  }));
+  server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    if (request.params.name !== "build_dossier") {
+      throw new Error(`Unknown prompt: ${request.params.name}`);
     }
-  }
-  return result;
-};
+    return {
+      description: "Build a full architectural dossier",
+      messages: [
+        {
+          role: "user",
+          content: {
+            type: "text",
+            text: `You are a skeptical staff engineer doing a HOSTILE architecture review of this codebase.
+You are NOT writing documentation. You are finding the load-bearing walls, the landmines,
+and the clever moves, and you are taking positions on them.
 
-// ../../node_modules/brace-expansion/dist/esm/index.js
-var escSlash = "\0SLASH" + Math.random() + "\0";
-var escOpen = "\0OPEN" + Math.random() + "\0";
-var escClose = "\0CLOSE" + Math.random() + "\0";
-var escComma = "\0COMMA" + Math.random() + "\0";
-var escPeriod = "\0PERIOD" + Math.random() + "\0";
-var escSlashPattern = new RegExp(escSlash, "g");
-var escOpenPattern = new RegExp(escOpen, "g");
-var escClosePattern = new RegExp(escClose, "g");
-var escCommaPattern = new RegExp(escComma, "g");
-var escPeriodPattern = new RegExp(escPeriod, "g");
-var slashPattern = /\\\\/g;
-var openPattern = /\\{/g;
-var closePattern = /\\}/g;
-var commaPattern = /\\,/g;
-var periodPattern = /\\\./g;
-var EXPANSION_MAX = 1e5;
-function numeric(str) {
-  return !isNaN(str) ? parseInt(str, 10) : str.charCodeAt(0);
-}
-function escapeBraces(str) {
-  return str.replace(slashPattern, escSlash).replace(openPattern, escOpen).replace(closePattern, escClose).replace(commaPattern, escComma).replace(periodPattern, escPeriod);
-}
-function unescapeBraces(str) {
-  return str.replace(escSlashPattern, "\\").replace(escOpenPattern, "{").replace(escClosePattern, "}").replace(escCommaPattern, ",").replace(escPeriodPattern, ".");
-}
-function parseCommaParts(str) {
-  if (!str) {
-    return [""];
-  }
-  const parts = [];
-  const m = balanced("{", "}", str);
-  if (!m) {
-    return str.split(",");
-  }
-  const { pre, body, post } = m;
-  const p = pre.split(",");
-  p[p.length - 1] += "{" + body + "}";
-  const postParts = parseCommaParts(post);
-  if (post.length) {
-    ;
-    p[p.length - 1] += postParts.shift();
-    p.push.apply(p, postParts);
-  }
-  parts.push.apply(parts, p);
-  return parts;
-}
-function expand(str, options = {}) {
-  if (!str) {
-    return [];
-  }
-  const { max = EXPANSION_MAX } = options;
-  if (str.slice(0, 2) === "{}") {
-    str = "\\{\\}" + str.slice(2);
-  }
-  return expand_(escapeBraces(str), max, true).map(unescapeBraces);
-}
-function embrace(str) {
-  return "{" + str + "}";
-}
-function isPadded(el) {
-  return /^-?0\d/.test(el);
-}
-function lte(i, y) {
-  return i <= y;
-}
-function gte(i, y) {
-  return i >= y;
-}
-function expand_(str, max, isTop) {
-  const expansions = [];
-  const m = balanced("{", "}", str);
-  if (!m)
-    return [str];
-  const pre = m.pre;
-  const post = m.post.length ? expand_(m.post, max, false) : [""];
-  if (/\$$/.test(m.pre)) {
-    for (let k = 0; k < post.length && k < max; k++) {
-      const expansion = pre + "{" + m.body + "}" + post[k];
-      expansions.push(expansion);
-    }
-  } else {
-    const isNumericSequence = /^-?\d+\.\.-?\d+(?:\.\.-?\d+)?$/.test(m.body);
-    const isAlphaSequence = /^[a-zA-Z]\.\.[a-zA-Z](?:\.\.-?\d+)?$/.test(m.body);
-    const isSequence = isNumericSequence || isAlphaSequence;
-    const isOptions = m.body.indexOf(",") >= 0;
-    if (!isSequence && !isOptions) {
-      if (m.post.match(/,(?!,).*\}/)) {
-        str = m.pre + "{" + m.body + escClose + m.post;
-        return expand_(str, max, true);
-      }
-      return [str];
-    }
-    let n;
-    if (isSequence) {
-      n = m.body.split(/\.\./);
-    } else {
-      n = parseCommaParts(m.body);
-      if (n.length === 1 && n[0] !== void 0) {
-        n = expand_(n[0], max, false).map(embrace);
-        if (n.length === 1) {
-          return post.map((p) => m.pre + n[0] + p);
-        }
-      }
-    }
-    let N;
-    if (isSequence && n[0] !== void 0 && n[1] !== void 0) {
-      const x = numeric(n[0]);
-      const y = numeric(n[1]);
-      const width = Math.max(n[0].length, n[1].length);
-      let incr = n.length === 3 && n[2] !== void 0 ? Math.max(Math.abs(numeric(n[2])), 1) : 1;
-      let test = lte;
-      const reverse = y < x;
-      if (reverse) {
-        incr *= -1;
-        test = gte;
-      }
-      const pad = n.some(isPadded);
-      N = [];
-      for (let i = x; test(i, y) && N.length < max; i += incr) {
-        let c;
-        if (isAlphaSequence) {
-          c = String.fromCharCode(i);
-          if (c === "\\") {
-            c = "";
-          }
-        } else {
-          c = String(i);
-          if (pad) {
-            const need = width - c.length;
-            if (need > 0) {
-              const z = new Array(need + 1).join("0");
-              if (i < 0) {
-                c = "-" + z + c.slice(1);
-              } else {
-                c = z + c;
-              }
-            }
-          }
-        }
-        N.push(c);
-      }
-    } else {
-      N = [];
-      for (let j = 0; j < n.length; j++) {
-        N.push.apply(N, expand_(n[j], max, false));
-      }
-    }
-    for (let j = 0; j < N.length; j++) {
-      for (let k = 0; k < post.length && expansions.length < max; k++) {
-        const expansion = pre + N[j] + post[k];
-        if (!isTop || isSequence || expansion) {
-          expansions.push(expansion);
-        }
-      }
-    }
-  }
-  return expansions;
-}
+PROCESS \u2014 follow in order:
+1. Call scan_project, then get_project_map. The map gives you: the detected stack,
+   the FIXED set of pillars (you may not invent others), the Start-Here files (highest
+   gravity = most depended-upon), and Wild-Discovery candidates (highest heat = most smell).
+2. Read the map's stack and entrypoints. Write a 3-5 sentence project brief: what IS this,
+   what's the real stack, and \u2014 critically \u2014 which files are the actual application vs.
+   mockups/generated/vendored noise. Pass it via set_project_brief. Do this BEFORE any card.
+3. Work the Start-Here files first (highest gravity), then the Wild-Discovery files.
+   For each, call get_file_context. It returns hotSpans (the gnarliest functions) and
+   smellSpans (located tech debt) \u2014 base your evidence on THOSE, never on header comments.
+4. Write one decision card per file via write_decision_card.
 
-// ../../node_modules/minimatch/dist/esm/assert-valid-pattern.js
-var MAX_PATTERN_LENGTH = 1024 * 64;
-var assertValidPattern = (pattern) => {
-  if (typeof pattern !== "string") {
-    throw new TypeError("invalid pattern");
-  }
-  if (pattern.length > MAX_PATTERN_LENGTH) {
-    throw new TypeError("pattern is too long");
-  }
-};
+This is an AUTONOMOUS loop. Every tool response includes a \`nextStep\` and often a
+\`remainingFiles\` list \u2014 OBEY them. Do NOT stop, summarize, or ask the user "how would
+you like to proceed" until every Start-Here and Wild-Discovery file has a card. Writing
+the brief is the START of the work, not the end. Keep calling get_file_context +
+write_decision_card until remainingFiles is empty.
 
-// ../../node_modules/minimatch/dist/esm/brace-expressions.js
-var posixClasses = {
-  "[:alnum:]": ["\\p{L}\\p{Nl}\\p{Nd}", true],
-  "[:alpha:]": ["\\p{L}\\p{Nl}", true],
-  "[:ascii:]": ["\\x00-\\x7f", false],
-  "[:blank:]": ["\\p{Zs}\\t", true],
-  "[:cntrl:]": ["\\p{Cc}", true],
-  "[:digit:]": ["\\p{Nd}", true],
-  "[:graph:]": ["\\p{Z}\\p{C}", true, true],
-  "[:lower:]": ["\\p{Ll}", true],
-  "[:print:]": ["\\p{C}", true],
-  "[:punct:]": ["\\p{P}", true],
-  "[:space:]": ["\\p{Z}\\t\\r\\n\\v\\f", true],
-  "[:upper:]": ["\\p{Lu}", true],
-  "[:word:]": ["\\p{L}\\p{Nl}\\p{Nd}\\p{Pc}", true],
-  "[:xdigit:]": ["A-Fa-f0-9", false]
-};
-var braceEscape = (s) => s.replace(/[[\]\\-]/g, "\\$&");
-var regexpEscape = (s) => s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
-var rangesToString = (ranges) => ranges.join("");
-var parseClass = (glob, position) => {
-  const pos = position;
-  if (glob.charAt(pos) !== "[") {
-    throw new Error("not in a brace expression");
-  }
-  const ranges = [];
-  const negs = [];
-  let i = pos + 1;
-  let sawStart = false;
-  let uflag = false;
-  let escaping = false;
-  let negate = false;
-  let endPos = pos;
-  let rangeStart = "";
-  WHILE: while (i < glob.length) {
-    const c = glob.charAt(i);
-    if ((c === "!" || c === "^") && i === pos + 1) {
-      negate = true;
-      i++;
-      continue;
-    }
-    if (c === "]" && sawStart && !escaping) {
-      endPos = i + 1;
-      break;
-    }
-    sawStart = true;
-    if (c === "\\") {
-      if (!escaping) {
-        escaping = true;
-        i++;
-        continue;
-      }
-    }
-    if (c === "[" && !escaping) {
-      for (const [cls, [unip, u, neg]] of Object.entries(posixClasses)) {
-        if (glob.startsWith(cls, i)) {
-          if (rangeStart) {
-            return ["$.", false, glob.length - pos, true];
-          }
-          i += cls.length;
-          if (neg)
-            negs.push(unip);
-          else
-            ranges.push(unip);
-          uflag = uflag || u;
-          continue WHILE;
-        }
-      }
-    }
-    escaping = false;
-    if (rangeStart) {
-      if (c > rangeStart) {
-        ranges.push(braceEscape(rangeStart) + "-" + braceEscape(c));
-      } else if (c === rangeStart) {
-        ranges.push(braceEscape(c));
-      }
-      rangeStart = "";
-      i++;
-      continue;
-    }
-    if (glob.startsWith("-]", i + 1)) {
-      ranges.push(braceEscape(c + "-"));
-      i += 2;
-      continue;
-    }
-    if (glob.startsWith("-", i + 1)) {
-      rangeStart = c;
-      i += 2;
-      continue;
-    }
-    ranges.push(braceEscape(c));
-    i++;
-  }
-  if (endPos < i) {
-    return ["", false, 0, false];
-  }
-  if (!ranges.length && !negs.length) {
-    return ["$.", false, glob.length - pos, true];
-  }
-  if (negs.length === 0 && ranges.length === 1 && /^\\?.$/.test(ranges[0]) && !negate) {
-    const r = ranges[0].length === 2 ? ranges[0].slice(-1) : ranges[0];
-    return [regexpEscape(r), false, endPos - pos, false];
-  }
-  const sranges = "[" + (negate ? "^" : "") + rangesToString(ranges) + "]";
-  const snegs = "[" + (negate ? "" : "^") + rangesToString(negs) + "]";
-  const comb = ranges.length && negs.length ? "(" + sranges + "|" + snegs + ")" : ranges.length ? sranges : snegs;
-  return [comb, uflag, endPos - pos, true];
-};
+RULES FOR EVERY CARD \u2014 non-negotiable:
+- The \`thesis\` is a VERDICT in one sentence. Take a position. If you can't, you don't
+  understand the file yet \u2014 read more.
+- Pick a \`category\`: Bottleneck, Hack, Smart-Move, Risk, Convention, or Dead-Weight.
+- \`blastRadius\` must reference the real fan-in (get_file_context.importedBy).
+- NEVER paraphrase the file's own comments. If the insight is already in a // block,
+  it is not insight \u2014 go deeper into the logic.
+- Evidence = 5-20 lines of the ACTUAL interesting code (hotSpans/smellSpans). Never the
+  whole file, never the doc-header.
+- For every Wild-Discovery candidate, name the specific smell and rate its severity.
 
-// ../../node_modules/minimatch/dist/esm/unescape.js
-var unescape = (s, { windowsPathsNoEscape = false, magicalBraces = true } = {}) => {
-  if (magicalBraces) {
-    return windowsPathsNoEscape ? s.replace(/\[([^/\\])\]/g, "$1") : s.replace(/((?!\\).|^)\[([^/\\])\]/g, "$1$2").replace(/\\([^/])/g, "$1");
-  }
-  return windowsPathsNoEscape ? s.replace(/\[([^/\\{}])\]/g, "$1") : s.replace(/((?!\\).|^)\[([^/\\{}])\]/g, "$1$2").replace(/\\([^/{}])/g, "$1");
-};
+\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+EXAMPLE \u2014 what GOOD vs BAD looks like:
 
-// ../../node_modules/minimatch/dist/esm/ast.js
-var _a;
-var types = /* @__PURE__ */ new Set(["!", "?", "+", "*", "@"]);
-var isExtglobType = (c) => types.has(c);
-var isExtglobAST = (c) => isExtglobType(c.type);
-var adoptionMap = /* @__PURE__ */ new Map([
-  ["!", ["@"]],
-  ["?", ["?", "@"]],
-  ["@", ["@"]],
-  ["*", ["*", "+", "?", "@"]],
-  ["+", ["+", "@"]]
-]);
-var adoptionWithSpaceMap = /* @__PURE__ */ new Map([
-  ["!", ["?"]],
-  ["@", ["?"]],
-  ["+", ["?", "*"]]
-]);
-var adoptionAnyMap = /* @__PURE__ */ new Map([
-  ["!", ["?", "@"]],
-  ["?", ["?", "@"]],
-  ["@", ["?", "@"]],
-  ["*", ["*", "+", "?", "@"]],
-  ["+", ["+", "@", "?", "*"]]
-]);
-var usurpMap = /* @__PURE__ */ new Map([
-  ["!", /* @__PURE__ */ new Map([["!", "@"]])],
-  [
-    "?",
-    /* @__PURE__ */ new Map([
-      ["*", "*"],
-      ["+", "*"]
-    ])
-  ],
-  [
-    "@",
-    /* @__PURE__ */ new Map([
-      ["!", "!"],
-      ["?", "?"],
-      ["@", "@"],
-      ["*", "*"],
-      ["+", "+"]
-    ])
-  ],
-  [
-    "+",
-    /* @__PURE__ */ new Map([
-      ["?", "*"],
-      ["*", "*"]
-    ])
-  ]
-]);
-var startNoTraversal = "(?!(?:^|/)\\.\\.?(?:$|/))";
-var startNoDot = "(?!\\.)";
-var addPatternStart = /* @__PURE__ */ new Set(["[", "."]);
-var justDots = /* @__PURE__ */ new Set(["..", "."]);
-var reSpecials = new Set("().*{}+?[]^$\\!");
-var regExpEscape = (s) => s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
-var qmark = "[^/]";
-var star = qmark + "*?";
-var starNoEmpty = qmark + "+?";
-var ID = 0;
-var AST = class {
-  type;
-  #root;
-  #hasMagic;
-  #uflag = false;
-  #parts = [];
-  #parent;
-  #parentIndex;
-  #negs;
-  #filledNegs = false;
-  #options;
-  #toString;
-  // set to true if it's an extglob with no children
-  // (which really means one child of '')
-  #emptyExt = false;
-  id = ++ID;
-  get depth() {
-    return (this.#parent?.depth ?? -1) + 1;
-  }
-  [/* @__PURE__ */ Symbol.for("nodejs.util.inspect.custom")]() {
-    return {
-      "@@type": "AST",
-      id: this.id,
-      type: this.type,
-      root: this.#root.id,
-      parent: this.#parent?.id,
-      depth: this.depth,
-      partsLength: this.#parts.length,
-      parts: this.#parts
-    };
-  }
-  constructor(type, parent, options = {}) {
-    this.type = type;
-    if (type)
-      this.#hasMagic = true;
-    this.#parent = parent;
-    this.#root = this.#parent ? this.#parent.#root : this;
-    this.#options = this.#root === this ? options : this.#root.#options;
-    this.#negs = this.#root === this ? [] : this.#root.#negs;
-    if (type === "!" && !this.#root.#filledNegs)
-      this.#negs.push(this);
-    this.#parentIndex = this.#parent ? this.#parent.#parts.length : 0;
-  }
-  get hasMagic() {
-    if (this.#hasMagic !== void 0)
-      return this.#hasMagic;
-    for (const p of this.#parts) {
-      if (typeof p === "string")
-        continue;
-      if (p.type || p.hasMagic)
-        return this.#hasMagic = true;
-    }
-    return this.#hasMagic;
-  }
-  // reconstructs the pattern
-  toString() {
-    return this.#toString !== void 0 ? this.#toString : !this.type ? this.#toString = this.#parts.map((p) => String(p)).join("") : this.#toString = this.type + "(" + this.#parts.map((p) => String(p)).join("|") + ")";
-  }
-  #fillNegs() {
-    if (this !== this.#root)
-      throw new Error("should only call on root");
-    if (this.#filledNegs)
-      return this;
-    this.toString();
-    this.#filledNegs = true;
-    let n;
-    while (n = this.#negs.pop()) {
-      if (n.type !== "!")
-        continue;
-      let p = n;
-      let pp = p.#parent;
-      while (pp) {
-        for (let i = p.#parentIndex + 1; !pp.type && i < pp.#parts.length; i++) {
-          for (const part of n.#parts) {
-            if (typeof part === "string") {
-              throw new Error("string part in extglob AST??");
-            }
-            part.copyIn(pp.#parts[i]);
-          }
-        }
-        p = pp;
-        pp = p.#parent;
-      }
-    }
-    return this;
-  }
-  push(...parts) {
-    for (const p of parts) {
-      if (p === "")
-        continue;
-      if (typeof p !== "string" && !(p instanceof _a && p.#parent === this)) {
-        throw new Error("invalid part: " + p);
-      }
-      this.#parts.push(p);
-    }
-  }
-  toJSON() {
-    const ret = this.type === null ? this.#parts.slice().map((p) => typeof p === "string" ? p : p.toJSON()) : [this.type, ...this.#parts.map((p) => p.toJSON())];
-    if (this.isStart() && !this.type)
-      ret.unshift([]);
-    if (this.isEnd() && (this === this.#root || this.#root.#filledNegs && this.#parent?.type === "!")) {
-      ret.push({});
-    }
-    return ret;
-  }
-  isStart() {
-    if (this.#root === this)
-      return true;
-    if (!this.#parent?.isStart())
-      return false;
-    if (this.#parentIndex === 0)
-      return true;
-    const p = this.#parent;
-    for (let i = 0; i < this.#parentIndex; i++) {
-      const pp = p.#parts[i];
-      if (!(pp instanceof _a && pp.type === "!")) {
-        return false;
-      }
-    }
-    return true;
-  }
-  isEnd() {
-    if (this.#root === this)
-      return true;
-    if (this.#parent?.type === "!")
-      return true;
-    if (!this.#parent?.isEnd())
-      return false;
-    if (!this.type)
-      return this.#parent?.isEnd();
-    const pl = this.#parent ? this.#parent.#parts.length : 0;
-    return this.#parentIndex === pl - 1;
-  }
-  copyIn(part) {
-    if (typeof part === "string")
-      this.push(part);
-    else
-      this.push(part.clone(this));
-  }
-  clone(parent) {
-    const c = new _a(this.type, parent);
-    for (const p of this.#parts) {
-      c.copyIn(p);
-    }
-    return c;
-  }
-  static #parseAST(str, ast, pos, opt, extDepth) {
-    const maxDepth = opt.maxExtglobRecursion ?? 2;
-    let escaping = false;
-    let inBrace = false;
-    let braceStart = -1;
-    let braceNeg = false;
-    if (ast.type === null) {
-      let i2 = pos;
-      let acc2 = "";
-      while (i2 < str.length) {
-        const c = str.charAt(i2++);
-        if (escaping || c === "\\") {
-          escaping = !escaping;
-          acc2 += c;
-          continue;
-        }
-        if (inBrace) {
-          if (i2 === braceStart + 1) {
-            if (c === "^" || c === "!") {
-              braceNeg = true;
-            }
-          } else if (c === "]" && !(i2 === braceStart + 2 && braceNeg)) {
-            inBrace = false;
-          }
-          acc2 += c;
-          continue;
-        } else if (c === "[") {
-          inBrace = true;
-          braceStart = i2;
-          braceNeg = false;
-          acc2 += c;
-          continue;
-        }
-        const doRecurse = !opt.noext && isExtglobType(c) && str.charAt(i2) === "(" && extDepth <= maxDepth;
-        if (doRecurse) {
-          ast.push(acc2);
-          acc2 = "";
-          const ext2 = new _a(c, ast);
-          i2 = _a.#parseAST(str, ext2, i2, opt, extDepth + 1);
-          ast.push(ext2);
-          continue;
-        }
-        acc2 += c;
-      }
-      ast.push(acc2);
-      return i2;
-    }
-    let i = pos + 1;
-    let part = new _a(null, ast);
-    const parts = [];
-    let acc = "";
-    while (i < str.length) {
-      const c = str.charAt(i++);
-      if (escaping || c === "\\") {
-        escaping = !escaping;
-        acc += c;
-        continue;
-      }
-      if (inBrace) {
-        if (i === braceStart + 1) {
-          if (c === "^" || c === "!") {
-            braceNeg = true;
-          }
-        } else if (c === "]" && !(i === braceStart + 2 && braceNeg)) {
-          inBrace = false;
-        }
-        acc += c;
-        continue;
-      } else if (c === "[") {
-        inBrace = true;
-        braceStart = i;
-        braceNeg = false;
-        acc += c;
-        continue;
-      }
-      const doRecurse = !opt.noext && isExtglobType(c) && str.charAt(i) === "(" && /* c8 ignore start - the maxDepth is sufficient here */
-      (extDepth <= maxDepth || ast && ast.#canAdoptType(c));
-      if (doRecurse) {
-        const depthAdd = ast && ast.#canAdoptType(c) ? 0 : 1;
-        part.push(acc);
-        acc = "";
-        const ext2 = new _a(c, part);
-        part.push(ext2);
-        i = _a.#parseAST(str, ext2, i, opt, extDepth + depthAdd);
-        continue;
-      }
-      if (c === "|") {
-        part.push(acc);
-        acc = "";
-        parts.push(part);
-        part = new _a(null, ast);
-        continue;
-      }
-      if (c === ")") {
-        if (acc === "" && ast.#parts.length === 0) {
-          ast.#emptyExt = true;
-        }
-        part.push(acc);
-        acc = "";
-        ast.push(...parts, part);
-        return i;
-      }
-      acc += c;
-    }
-    ast.type = null;
-    ast.#hasMagic = void 0;
-    ast.#parts = [str.substring(pos - 1)];
-    return i;
-  }
-  #canAdoptWithSpace(child) {
-    return this.#canAdopt(child, adoptionWithSpaceMap);
-  }
-  #canAdopt(child, map = adoptionMap) {
-    if (!child || typeof child !== "object" || child.type !== null || child.#parts.length !== 1 || this.type === null) {
-      return false;
-    }
-    const gc = child.#parts[0];
-    if (!gc || typeof gc !== "object" || gc.type === null) {
-      return false;
-    }
-    return this.#canAdoptType(gc.type, map);
-  }
-  #canAdoptType(c, map = adoptionAnyMap) {
-    return !!map.get(this.type)?.includes(c);
-  }
-  #adoptWithSpace(child, index) {
-    const gc = child.#parts[0];
-    const blank = new _a(null, gc, this.options);
-    blank.#parts.push("");
-    gc.push(blank);
-    this.#adopt(child, index);
-  }
-  #adopt(child, index) {
-    const gc = child.#parts[0];
-    this.#parts.splice(index, 1, ...gc.#parts);
-    for (const p of gc.#parts) {
-      if (typeof p === "object")
-        p.#parent = this;
-    }
-    this.#toString = void 0;
-  }
-  #canUsurpType(c) {
-    const m = usurpMap.get(this.type);
-    return !!m?.has(c);
-  }
-  #canUsurp(child) {
-    if (!child || typeof child !== "object" || child.type !== null || child.#parts.length !== 1 || this.type === null || this.#parts.length !== 1) {
-      return false;
-    }
-    const gc = child.#parts[0];
-    if (!gc || typeof gc !== "object" || gc.type === null) {
-      return false;
-    }
-    return this.#canUsurpType(gc.type);
-  }
-  #usurp(child) {
-    const m = usurpMap.get(this.type);
-    const gc = child.#parts[0];
-    const nt = m?.get(gc.type);
-    if (!nt)
-      return false;
-    this.#parts = gc.#parts;
-    for (const p of this.#parts) {
-      if (typeof p === "object") {
-        p.#parent = this;
-      }
-    }
-    this.type = nt;
-    this.#toString = void 0;
-    this.#emptyExt = false;
-  }
-  static fromGlob(pattern, options = {}) {
-    const ast = new _a(null, void 0, options);
-    _a.#parseAST(pattern, ast, 0, options, 0);
-    return ast;
-  }
-  // returns the regular expression if there's magic, or the unescaped
-  // string if not.
-  toMMPattern() {
-    if (this !== this.#root)
-      return this.#root.toMMPattern();
-    const glob = this.toString();
-    const [re, body, hasMagic, uflag] = this.toRegExpSource();
-    const anyMagic = hasMagic || this.#hasMagic || this.#options.nocase && !this.#options.nocaseMagicOnly && glob.toUpperCase() !== glob.toLowerCase();
-    if (!anyMagic) {
-      return body;
-    }
-    const flags = (this.#options.nocase ? "i" : "") + (uflag ? "u" : "");
-    return Object.assign(new RegExp(`^${re}$`, flags), {
-      _src: re,
-      _glob: glob
-    });
-  }
-  get options() {
-    return this.#options;
-  }
-  // returns the string match, the regexp source, whether there's magic
-  // in the regexp (so a regular expression is required) and whether or
-  // not the uflag is needed for the regular expression (for posix classes)
-  // TODO: instead of injecting the start/end at this point, just return
-  // the BODY of the regexp, along with the start/end portions suitable
-  // for binding the start/end in either a joined full-path makeRe context
-  // (where we bind to (^|/), or a standalone matchPart context (where
-  // we bind to ^, and not /).  Otherwise slashes get duped!
-  //
-  // In part-matching mode, the start is:
-  // - if not isStart: nothing
-  // - if traversal possible, but not allowed: ^(?!\.\.?$)
-  // - if dots allowed or not possible: ^
-  // - if dots possible and not allowed: ^(?!\.)
-  // end is:
-  // - if not isEnd(): nothing
-  // - else: $
-  //
-  // In full-path matching mode, we put the slash at the START of the
-  // pattern, so start is:
-  // - if first pattern: same as part-matching mode
-  // - if not isStart(): nothing
-  // - if traversal possible, but not allowed: /(?!\.\.?(?:$|/))
-  // - if dots allowed or not possible: /
-  // - if dots possible and not allowed: /(?!\.)
-  // end is:
-  // - if last pattern, same as part-matching mode
-  // - else nothing
-  //
-  // Always put the (?:$|/) on negated tails, though, because that has to be
-  // there to bind the end of the negated pattern portion, and it's easier to
-  // just stick it in now rather than try to inject it later in the middle of
-  // the pattern.
-  //
-  // We can just always return the same end, and leave it up to the caller
-  // to know whether it's going to be used joined or in parts.
-  // And, if the start is adjusted slightly, can do the same there:
-  // - if not isStart: nothing
-  // - if traversal possible, but not allowed: (?:/|^)(?!\.\.?$)
-  // - if dots allowed or not possible: (?:/|^)
-  // - if dots possible and not allowed: (?:/|^)(?!\.)
-  //
-  // But it's better to have a simpler binding without a conditional, for
-  // performance, so probably better to return both start options.
-  //
-  // Then the caller just ignores the end if it's not the first pattern,
-  // and the start always gets applied.
-  //
-  // But that's always going to be $ if it's the ending pattern, or nothing,
-  // so the caller can just attach $ at the end of the pattern when building.
-  //
-  // So the todo is:
-  // - better detect what kind of start is needed
-  // - return both flavors of starting pattern
-  // - attach $ at the end of the pattern when creating the actual RegExp
-  //
-  // Ah, but wait, no, that all only applies to the root when the first pattern
-  // is not an extglob. If the first pattern IS an extglob, then we need all
-  // that dot prevention biz to live in the extglob portions, because eg
-  // +(*|.x*) can match .xy but not .yx.
-  //
-  // So, return the two flavors if it's #root and the first child is not an
-  // AST, otherwise leave it to the child AST to handle it, and there,
-  // use the (?:^|/) style of start binding.
-  //
-  // Even simplified further:
-  // - Since the start for a join is eg /(?!\.) and the start for a part
-  // is ^(?!\.), we can just prepend (?!\.) to the pattern (either root
-  // or start or whatever) and prepend ^ or / at the Regexp construction.
-  toRegExpSource(allowDot) {
-    const dot = allowDot ?? !!this.#options.dot;
-    if (this.#root === this) {
-      this.#flatten();
-      this.#fillNegs();
-    }
-    if (!isExtglobAST(this)) {
-      const noEmpty = this.isStart() && this.isEnd() && !this.#parts.some((s) => typeof s !== "string");
-      const src = this.#parts.map((p) => {
-        const [re, _, hasMagic, uflag] = typeof p === "string" ? _a.#parseGlob(p, this.#hasMagic, noEmpty) : p.toRegExpSource(allowDot);
-        this.#hasMagic = this.#hasMagic || hasMagic;
-        this.#uflag = this.#uflag || uflag;
-        return re;
-      }).join("");
-      let start2 = "";
-      if (this.isStart()) {
-        if (typeof this.#parts[0] === "string") {
-          const dotTravAllowed = this.#parts.length === 1 && justDots.has(this.#parts[0]);
-          if (!dotTravAllowed) {
-            const aps = addPatternStart;
-            const needNoTrav = (
-              // dots are allowed, and the pattern starts with [ or .
-              dot && aps.has(src.charAt(0)) || // the pattern starts with \., and then [ or .
-              src.startsWith("\\.") && aps.has(src.charAt(2)) || // the pattern starts with \.\., and then [ or .
-              src.startsWith("\\.\\.") && aps.has(src.charAt(4))
-            );
-            const needNoDot = !dot && !allowDot && aps.has(src.charAt(0));
-            start2 = needNoTrav ? startNoTraversal : needNoDot ? startNoDot : "";
-          }
-        }
-      }
-      let end = "";
-      if (this.isEnd() && this.#root.#filledNegs && this.#parent?.type === "!") {
-        end = "(?:$|\\/)";
-      }
-      const final2 = start2 + src + end;
-      return [
-        final2,
-        unescape(src),
-        this.#hasMagic = !!this.#hasMagic,
-        this.#uflag
-      ];
-    }
-    const repeated = this.type === "*" || this.type === "+";
-    const start = this.type === "!" ? "(?:(?!(?:" : "(?:";
-    let body = this.#partsToRegExp(dot);
-    if (this.isStart() && this.isEnd() && !body && this.type !== "!") {
-      const s = this.toString();
-      const me = this;
-      me.#parts = [s];
-      me.type = null;
-      me.#hasMagic = void 0;
-      return [s, unescape(this.toString()), false, false];
-    }
-    let bodyDotAllowed = !repeated || allowDot || dot || !startNoDot ? "" : this.#partsToRegExp(true);
-    if (bodyDotAllowed === body) {
-      bodyDotAllowed = "";
-    }
-    if (bodyDotAllowed) {
-      body = `(?:${body})(?:${bodyDotAllowed})*?`;
-    }
-    let final = "";
-    if (this.type === "!" && this.#emptyExt) {
-      final = (this.isStart() && !dot ? startNoDot : "") + starNoEmpty;
-    } else {
-      const close = this.type === "!" ? (
-        // !() must match something,but !(x) can match ''
-        "))" + (this.isStart() && !dot && !allowDot ? startNoDot : "") + star + ")"
-      ) : this.type === "@" ? ")" : this.type === "?" ? ")?" : this.type === "+" && bodyDotAllowed ? ")" : this.type === "*" && bodyDotAllowed ? `)?` : `)${this.type}`;
-      final = start + body + close;
-    }
-    return [
-      final,
-      unescape(body),
-      this.#hasMagic = !!this.#hasMagic,
-      this.#uflag
-    ];
-  }
-  #flatten() {
-    if (!isExtglobAST(this)) {
-      for (const p of this.#parts) {
-        if (typeof p === "object") {
-          p.#flatten();
-        }
-      }
-    } else {
-      let iterations = 0;
-      let done = false;
-      do {
-        done = true;
-        for (let i = 0; i < this.#parts.length; i++) {
-          const c = this.#parts[i];
-          if (typeof c === "object") {
-            c.#flatten();
-            if (this.#canAdopt(c)) {
-              done = false;
-              this.#adopt(c, i);
-            } else if (this.#canAdoptWithSpace(c)) {
-              done = false;
-              this.#adoptWithSpace(c, i);
-            } else if (this.#canUsurp(c)) {
-              done = false;
-              this.#usurp(c);
-            }
-          }
-        }
-      } while (!done && ++iterations < 10);
-    }
-    this.#toString = void 0;
-  }
-  #partsToRegExp(dot) {
-    return this.#parts.map((p) => {
-      if (typeof p === "string") {
-        throw new Error("string type in extglob ast??");
-      }
-      const [re, _, _hasMagic, uflag] = p.toRegExpSource(dot);
-      this.#uflag = this.#uflag || uflag;
-      return re;
-    }).filter((p) => !(this.isStart() && this.isEnd()) || !!p).join("|");
-  }
-  static #parseGlob(glob, hasMagic, noEmpty = false) {
-    let escaping = false;
-    let re = "";
-    let uflag = false;
-    let inStar = false;
-    for (let i = 0; i < glob.length; i++) {
-      const c = glob.charAt(i);
-      if (escaping) {
-        escaping = false;
-        re += (reSpecials.has(c) ? "\\" : "") + c;
-        continue;
-      }
-      if (c === "*") {
-        if (inStar)
-          continue;
-        inStar = true;
-        re += noEmpty && /^[*]+$/.test(glob) ? starNoEmpty : star;
-        hasMagic = true;
-        continue;
-      } else {
-        inStar = false;
-      }
-      if (c === "\\") {
-        if (i === glob.length - 1) {
-          re += "\\\\";
-        } else {
-          escaping = true;
-        }
-        continue;
-      }
-      if (c === "[") {
-        const [src, needUflag, consumed, magic] = parseClass(glob, i);
-        if (consumed) {
-          re += src;
-          uflag = uflag || needUflag;
-          i += consumed - 1;
-          hasMagic = hasMagic || magic;
-          continue;
-        }
-      }
-      if (c === "?") {
-        re += qmark;
-        hasMagic = true;
-        continue;
-      }
-      re += regExpEscape(c);
-    }
-    return [re, unescape(glob), !!hasMagic, uflag];
-  }
-};
-_a = AST;
-
-// ../../node_modules/minimatch/dist/esm/escape.js
-var escape = (s, { windowsPathsNoEscape = false, magicalBraces = false } = {}) => {
-  if (magicalBraces) {
-    return windowsPathsNoEscape ? s.replace(/[?*()[\]{}]/g, "[$&]") : s.replace(/[?*()[\]\\{}]/g, "\\$&");
-  }
-  return windowsPathsNoEscape ? s.replace(/[?*()[\]]/g, "[$&]") : s.replace(/[?*()[\]\\]/g, "\\$&");
-};
-
-// ../../node_modules/minimatch/dist/esm/index.js
-var minimatch = (p, pattern, options = {}) => {
-  assertValidPattern(pattern);
-  if (!options.nocomment && pattern.charAt(0) === "#") {
-    return false;
-  }
-  return new Minimatch(pattern, options).match(p);
-};
-var starDotExtRE = /^\*+([^+@!?*[(]*)$/;
-var starDotExtTest = (ext2) => (f) => !f.startsWith(".") && f.endsWith(ext2);
-var starDotExtTestDot = (ext2) => (f) => f.endsWith(ext2);
-var starDotExtTestNocase = (ext2) => {
-  ext2 = ext2.toLowerCase();
-  return (f) => !f.startsWith(".") && f.toLowerCase().endsWith(ext2);
-};
-var starDotExtTestNocaseDot = (ext2) => {
-  ext2 = ext2.toLowerCase();
-  return (f) => f.toLowerCase().endsWith(ext2);
-};
-var starDotStarRE = /^\*+\.\*+$/;
-var starDotStarTest = (f) => !f.startsWith(".") && f.includes(".");
-var starDotStarTestDot = (f) => f !== "." && f !== ".." && f.includes(".");
-var dotStarRE = /^\.\*+$/;
-var dotStarTest = (f) => f !== "." && f !== ".." && f.startsWith(".");
-var starRE = /^\*+$/;
-var starTest = (f) => f.length !== 0 && !f.startsWith(".");
-var starTestDot = (f) => f.length !== 0 && f !== "." && f !== "..";
-var qmarksRE = /^\?+([^+@!?*[(]*)?$/;
-var qmarksTestNocase = ([$0, ext2 = ""]) => {
-  const noext = qmarksTestNoExt([$0]);
-  if (!ext2)
-    return noext;
-  ext2 = ext2.toLowerCase();
-  return (f) => noext(f) && f.toLowerCase().endsWith(ext2);
-};
-var qmarksTestNocaseDot = ([$0, ext2 = ""]) => {
-  const noext = qmarksTestNoExtDot([$0]);
-  if (!ext2)
-    return noext;
-  ext2 = ext2.toLowerCase();
-  return (f) => noext(f) && f.toLowerCase().endsWith(ext2);
-};
-var qmarksTestDot = ([$0, ext2 = ""]) => {
-  const noext = qmarksTestNoExtDot([$0]);
-  return !ext2 ? noext : (f) => noext(f) && f.endsWith(ext2);
-};
-var qmarksTest = ([$0, ext2 = ""]) => {
-  const noext = qmarksTestNoExt([$0]);
-  return !ext2 ? noext : (f) => noext(f) && f.endsWith(ext2);
-};
-var qmarksTestNoExt = ([$0]) => {
-  const len = $0.length;
-  return (f) => f.length === len && !f.startsWith(".");
-};
-var qmarksTestNoExtDot = ([$0]) => {
-  const len = $0.length;
-  return (f) => f.length === len && f !== "." && f !== "..";
-};
-var defaultPlatform = typeof process === "object" && process ? typeof process.env === "object" && process.env && process.env.__MINIMATCH_TESTING_PLATFORM__ || process.platform : "posix";
-var path = {
-  win32: { sep: "\\" },
-  posix: { sep: "/" }
-};
-var sep4 = defaultPlatform === "win32" ? path.win32.sep : path.posix.sep;
-minimatch.sep = sep4;
-var GLOBSTAR = /* @__PURE__ */ Symbol("globstar **");
-minimatch.GLOBSTAR = GLOBSTAR;
-var qmark2 = "[^/]";
-var star2 = qmark2 + "*?";
-var twoStarDot = "(?:(?!(?:\\/|^)(?:\\.{1,2})($|\\/)).)*?";
-var twoStarNoDot = "(?:(?!(?:\\/|^)\\.).)*?";
-var filter = (pattern, options = {}) => (p) => minimatch(p, pattern, options);
-minimatch.filter = filter;
-var ext = (a, b = {}) => Object.assign({}, a, b);
-var defaults = (def) => {
-  if (!def || typeof def !== "object" || !Object.keys(def).length) {
-    return minimatch;
-  }
-  const orig = minimatch;
-  const m = (p, pattern, options = {}) => orig(p, pattern, ext(def, options));
-  return Object.assign(m, {
-    Minimatch: class Minimatch extends orig.Minimatch {
-      constructor(pattern, options = {}) {
-        super(pattern, ext(def, options));
-      }
-      static defaults(options) {
-        return orig.defaults(ext(def, options)).Minimatch;
-      }
-    },
-    AST: class AST extends orig.AST {
-      /* c8 ignore start */
-      constructor(type, parent, options = {}) {
-        super(type, parent, ext(def, options));
-      }
-      /* c8 ignore stop */
-      static fromGlob(pattern, options = {}) {
-        return orig.AST.fromGlob(pattern, ext(def, options));
-      }
-    },
-    unescape: (s, options = {}) => orig.unescape(s, ext(def, options)),
-    escape: (s, options = {}) => orig.escape(s, ext(def, options)),
-    filter: (pattern, options = {}) => orig.filter(pattern, ext(def, options)),
-    defaults: (options) => orig.defaults(ext(def, options)),
-    makeRe: (pattern, options = {}) => orig.makeRe(pattern, ext(def, options)),
-    braceExpand: (pattern, options = {}) => orig.braceExpand(pattern, ext(def, options)),
-    match: (list, pattern, options = {}) => orig.match(list, pattern, ext(def, options)),
-    sep: orig.sep,
-    GLOBSTAR
-  });
-};
-minimatch.defaults = defaults;
-var braceExpand = (pattern, options = {}) => {
-  assertValidPattern(pattern);
-  if (options.nobrace || !/\{(?:(?!\{).)*\}/.test(pattern)) {
-    return [pattern];
-  }
-  return expand(pattern, { max: options.braceExpandMax });
-};
-minimatch.braceExpand = braceExpand;
-var makeRe = (pattern, options = {}) => new Minimatch(pattern, options).makeRe();
-minimatch.makeRe = makeRe;
-var match = (list, pattern, options = {}) => {
-  const mm = new Minimatch(pattern, options);
-  list = list.filter((f) => mm.match(f));
-  if (mm.options.nonull && !list.length) {
-    list.push(pattern);
-  }
-  return list;
-};
-minimatch.match = match;
-var globMagic = /[?*]|[+@!]\(.*?\)|\[|\]/;
-var regExpEscape2 = (s) => s.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, "\\$&");
-var Minimatch = class {
-  options;
-  set;
-  pattern;
-  windowsPathsNoEscape;
-  nonegate;
-  negate;
-  comment;
-  empty;
-  preserveMultipleSlashes;
-  partial;
-  globSet;
-  globParts;
-  nocase;
-  isWindows;
-  platform;
-  windowsNoMagicRoot;
-  maxGlobstarRecursion;
-  regexp;
-  constructor(pattern, options = {}) {
-    assertValidPattern(pattern);
-    options = options || {};
-    this.options = options;
-    this.maxGlobstarRecursion = options.maxGlobstarRecursion ?? 200;
-    this.pattern = pattern;
-    this.platform = options.platform || defaultPlatform;
-    this.isWindows = this.platform === "win32";
-    const awe = "allowWindowsEscape";
-    this.windowsPathsNoEscape = !!options.windowsPathsNoEscape || options[awe] === false;
-    if (this.windowsPathsNoEscape) {
-      this.pattern = this.pattern.replace(/\\/g, "/");
-    }
-    this.preserveMultipleSlashes = !!options.preserveMultipleSlashes;
-    this.regexp = null;
-    this.negate = false;
-    this.nonegate = !!options.nonegate;
-    this.comment = false;
-    this.empty = false;
-    this.partial = !!options.partial;
-    this.nocase = !!this.options.nocase;
-    this.windowsNoMagicRoot = options.windowsNoMagicRoot !== void 0 ? options.windowsNoMagicRoot : !!(this.isWindows && this.nocase);
-    this.globSet = [];
-    this.globParts = [];
-    this.set = [];
-    this.make();
-  }
-  hasMagic() {
-    if (this.options.magicalBraces && this.set.length > 1) {
-      return true;
-    }
-    for (const pattern of this.set) {
-      for (const part of pattern) {
-        if (typeof part !== "string")
-          return true;
-      }
-    }
-    return false;
-  }
-  debug(..._) {
-  }
-  make() {
-    const pattern = this.pattern;
-    const options = this.options;
-    if (!options.nocomment && pattern.charAt(0) === "#") {
-      this.comment = true;
-      return;
-    }
-    if (!pattern) {
-      this.empty = true;
-      return;
-    }
-    this.parseNegate();
-    this.globSet = [...new Set(this.braceExpand())];
-    if (options.debug) {
-      this.debug = (...args) => console.error(...args);
-    }
-    this.debug(this.pattern, this.globSet);
-    const rawGlobParts = this.globSet.map((s) => this.slashSplit(s));
-    this.globParts = this.preprocess(rawGlobParts);
-    this.debug(this.pattern, this.globParts);
-    let set = this.globParts.map((s, _, __) => {
-      if (this.isWindows && this.windowsNoMagicRoot) {
-        const isUNC = s[0] === "" && s[1] === "" && (s[2] === "?" || !globMagic.test(s[2])) && !globMagic.test(s[3]);
-        const isDrive = /^[a-z]:/i.test(s[0]);
-        if (isUNC) {
-          return [
-            ...s.slice(0, 4),
-            ...s.slice(4).map((ss) => this.parse(ss))
-          ];
-        } else if (isDrive) {
-          return [s[0], ...s.slice(1).map((ss) => this.parse(ss))];
-        }
-      }
-      return s.map((ss) => this.parse(ss));
-    });
-    this.debug(this.pattern, set);
-    this.set = set.filter((s) => s.indexOf(false) === -1);
-    if (this.isWindows) {
-      for (let i = 0; i < this.set.length; i++) {
-        const p = this.set[i];
-        if (p[0] === "" && p[1] === "" && this.globParts[i][2] === "?" && typeof p[3] === "string" && /^[a-z]:$/i.test(p[3])) {
-          p[2] = "?";
-        }
-      }
-    }
-    this.debug(this.pattern, this.set);
-  }
-  // various transforms to equivalent pattern sets that are
-  // faster to process in a filesystem walk.  The goal is to
-  // eliminate what we can, and push all ** patterns as far
-  // to the right as possible, even if it increases the number
-  // of patterns that we have to process.
-  preprocess(globParts) {
-    if (this.options.noglobstar) {
-      for (const partset of globParts) {
-        for (let j = 0; j < partset.length; j++) {
-          if (partset[j] === "**") {
-            partset[j] = "*";
-          }
-        }
-      }
-    }
-    const { optimizationLevel = 1 } = this.options;
-    if (optimizationLevel >= 2) {
-      globParts = this.firstPhasePreProcess(globParts);
-      globParts = this.secondPhasePreProcess(globParts);
-    } else if (optimizationLevel >= 1) {
-      globParts = this.levelOneOptimize(globParts);
-    } else {
-      globParts = this.adjascentGlobstarOptimize(globParts);
-    }
-    return globParts;
-  }
-  // just get rid of adjascent ** portions
-  adjascentGlobstarOptimize(globParts) {
-    return globParts.map((parts) => {
-      let gs = -1;
-      while (-1 !== (gs = parts.indexOf("**", gs + 1))) {
-        let i = gs;
-        while (parts[i + 1] === "**") {
-          i++;
-        }
-        if (i !== gs) {
-          parts.splice(gs, i - gs);
-        }
-      }
-      return parts;
-    });
-  }
-  // get rid of adjascent ** and resolve .. portions
-  levelOneOptimize(globParts) {
-    return globParts.map((parts) => {
-      parts = parts.reduce((set, part) => {
-        const prev = set[set.length - 1];
-        if (part === "**" && prev === "**") {
-          return set;
-        }
-        if (part === "..") {
-          if (prev && prev !== ".." && prev !== "." && prev !== "**") {
-            set.pop();
-            return set;
-          }
-        }
-        set.push(part);
-        return set;
-      }, []);
-      return parts.length === 0 ? [""] : parts;
-    });
-  }
-  levelTwoFileOptimize(parts) {
-    if (!Array.isArray(parts)) {
-      parts = this.slashSplit(parts);
-    }
-    let didSomething = false;
-    do {
-      didSomething = false;
-      if (!this.preserveMultipleSlashes) {
-        for (let i = 1; i < parts.length - 1; i++) {
-          const p = parts[i];
-          if (i === 1 && p === "" && parts[0] === "")
-            continue;
-          if (p === "." || p === "") {
-            didSomething = true;
-            parts.splice(i, 1);
-            i--;
-          }
-        }
-        if (parts[0] === "." && parts.length === 2 && (parts[1] === "." || parts[1] === "")) {
-          didSomething = true;
-          parts.pop();
-        }
-      }
-      let dd = 0;
-      while (-1 !== (dd = parts.indexOf("..", dd + 1))) {
-        const p = parts[dd - 1];
-        if (p && p !== "." && p !== ".." && p !== "**" && !(this.isWindows && /^[a-z]:$/i.test(p))) {
-          didSomething = true;
-          parts.splice(dd - 1, 2);
-          dd -= 2;
-        }
-      }
-    } while (didSomething);
-    return parts.length === 0 ? [""] : parts;
-  }
-  // First phase: single-pattern processing
-  // <pre> is 1 or more portions
-  // <rest> is 1 or more portions
-  // <p> is any portion other than ., .., '', or **
-  // <e> is . or ''
-  //
-  // **/.. is *brutal* for filesystem walking performance, because
-  // it effectively resets the recursive walk each time it occurs,
-  // and ** cannot be reduced out by a .. pattern part like a regexp
-  // or most strings (other than .., ., and '') can be.
-  //
-  // <pre>/**/../<p>/<p>/<rest> -> {<pre>/../<p>/<p>/<rest>,<pre>/**/<p>/<p>/<rest>}
-  // <pre>/<e>/<rest> -> <pre>/<rest>
-  // <pre>/<p>/../<rest> -> <pre>/<rest>
-  // **/**/<rest> -> **/<rest>
-  //
-  // **/*/<rest> -> */**/<rest> <== not valid because ** doesn't follow
-  // this WOULD be allowed if ** did follow symlinks, or * didn't
-  firstPhasePreProcess(globParts) {
-    let didSomething = false;
-    do {
-      didSomething = false;
-      for (let parts of globParts) {
-        let gs = -1;
-        while (-1 !== (gs = parts.indexOf("**", gs + 1))) {
-          let gss = gs;
-          while (parts[gss + 1] === "**") {
-            gss++;
-          }
-          if (gss > gs) {
-            parts.splice(gs + 1, gss - gs);
-          }
-          let next = parts[gs + 1];
-          const p = parts[gs + 2];
-          const p2 = parts[gs + 3];
-          if (next !== "..")
-            continue;
-          if (!p || p === "." || p === ".." || !p2 || p2 === "." || p2 === "..") {
-            continue;
-          }
-          didSomething = true;
-          parts.splice(gs, 1);
-          const other = parts.slice(0);
-          other[gs] = "**";
-          globParts.push(other);
-          gs--;
-        }
-        if (!this.preserveMultipleSlashes) {
-          for (let i = 1; i < parts.length - 1; i++) {
-            const p = parts[i];
-            if (i === 1 && p === "" && parts[0] === "")
-              continue;
-            if (p === "." || p === "") {
-              didSomething = true;
-              parts.splice(i, 1);
-              i--;
-            }
-          }
-          if (parts[0] === "." && parts.length === 2 && (parts[1] === "." || parts[1] === "")) {
-            didSomething = true;
-            parts.pop();
-          }
-        }
-        let dd = 0;
-        while (-1 !== (dd = parts.indexOf("..", dd + 1))) {
-          const p = parts[dd - 1];
-          if (p && p !== "." && p !== ".." && p !== "**") {
-            didSomething = true;
-            const needDot = dd === 1 && parts[dd + 1] === "**";
-            const splin = needDot ? ["."] : [];
-            parts.splice(dd - 1, 2, ...splin);
-            if (parts.length === 0)
-              parts.push("");
-            dd -= 2;
-          }
-        }
-      }
-    } while (didSomething);
-    return globParts;
-  }
-  // second phase: multi-pattern dedupes
-  // {<pre>/*/<rest>,<pre>/<p>/<rest>} -> <pre>/*/<rest>
-  // {<pre>/<rest>,<pre>/<rest>} -> <pre>/<rest>
-  // {<pre>/**/<rest>,<pre>/<rest>} -> <pre>/**/<rest>
-  //
-  // {<pre>/**/<rest>,<pre>/**/<p>/<rest>} -> <pre>/**/<rest>
-  // ^-- not valid because ** doens't follow symlinks
-  secondPhasePreProcess(globParts) {
-    for (let i = 0; i < globParts.length - 1; i++) {
-      for (let j = i + 1; j < globParts.length; j++) {
-        const matched = this.partsMatch(globParts[i], globParts[j], !this.preserveMultipleSlashes);
-        if (matched) {
-          globParts[i] = [];
-          globParts[j] = matched;
-          break;
-        }
-      }
-    }
-    return globParts.filter((gs) => gs.length);
-  }
-  partsMatch(a, b, emptyGSMatch = false) {
-    let ai = 0;
-    let bi = 0;
-    let result = [];
-    let which = "";
-    while (ai < a.length && bi < b.length) {
-      if (a[ai] === b[bi]) {
-        result.push(which === "b" ? b[bi] : a[ai]);
-        ai++;
-        bi++;
-      } else if (emptyGSMatch && a[ai] === "**" && b[bi] === a[ai + 1]) {
-        result.push(a[ai]);
-        ai++;
-      } else if (emptyGSMatch && b[bi] === "**" && a[ai] === b[bi + 1]) {
-        result.push(b[bi]);
-        bi++;
-      } else if (a[ai] === "*" && b[bi] && (this.options.dot || !b[bi].startsWith(".")) && b[bi] !== "**") {
-        if (which === "b")
-          return false;
-        which = "a";
-        result.push(a[ai]);
-        ai++;
-        bi++;
-      } else if (b[bi] === "*" && a[ai] && (this.options.dot || !a[ai].startsWith(".")) && a[ai] !== "**") {
-        if (which === "a")
-          return false;
-        which = "b";
-        result.push(b[bi]);
-        ai++;
-        bi++;
-      } else {
-        return false;
-      }
-    }
-    return a.length === b.length && result;
-  }
-  parseNegate() {
-    if (this.nonegate)
-      return;
-    const pattern = this.pattern;
-    let negate = false;
-    let negateOffset = 0;
-    for (let i = 0; i < pattern.length && pattern.charAt(i) === "!"; i++) {
-      negate = !negate;
-      negateOffset++;
-    }
-    if (negateOffset)
-      this.pattern = pattern.slice(negateOffset);
-    this.negate = negate;
-  }
-  // set partial to true to test if, for example,
-  // "/a/b" matches the start of "/*/b/*/d"
-  // Partial means, if you run out of file before you run
-  // out of pattern, then that's fine, as long as all
-  // the parts match.
-  matchOne(file, pattern, partial = false) {
-    let fileStartIndex = 0;
-    let patternStartIndex = 0;
-    if (this.isWindows) {
-      const fileDrive = typeof file[0] === "string" && /^[a-z]:$/i.test(file[0]);
-      const fileUNC = !fileDrive && file[0] === "" && file[1] === "" && file[2] === "?" && /^[a-z]:$/i.test(file[3]);
-      const patternDrive = typeof pattern[0] === "string" && /^[a-z]:$/i.test(pattern[0]);
-      const patternUNC = !patternDrive && pattern[0] === "" && pattern[1] === "" && pattern[2] === "?" && typeof pattern[3] === "string" && /^[a-z]:$/i.test(pattern[3]);
-      const fdi = fileUNC ? 3 : fileDrive ? 0 : void 0;
-      const pdi = patternUNC ? 3 : patternDrive ? 0 : void 0;
-      if (typeof fdi === "number" && typeof pdi === "number") {
-        const [fd, pd] = [
-          file[fdi],
-          pattern[pdi]
-        ];
-        if (fd.toLowerCase() === pd.toLowerCase()) {
-          pattern[pdi] = fd;
-          patternStartIndex = pdi;
-          fileStartIndex = fdi;
-        }
-      }
-    }
-    const { optimizationLevel = 1 } = this.options;
-    if (optimizationLevel >= 2) {
-      file = this.levelTwoFileOptimize(file);
-    }
-    if (pattern.includes(GLOBSTAR)) {
-      return this.#matchGlobstar(file, pattern, partial, fileStartIndex, patternStartIndex);
-    }
-    return this.#matchOne(file, pattern, partial, fileStartIndex, patternStartIndex);
-  }
-  #matchGlobstar(file, pattern, partial, fileIndex, patternIndex) {
-    const firstgs = pattern.indexOf(GLOBSTAR, patternIndex);
-    const lastgs = pattern.lastIndexOf(GLOBSTAR);
-    const [head, body, tail] = partial ? [
-      pattern.slice(patternIndex, firstgs),
-      pattern.slice(firstgs + 1),
-      []
-    ] : [
-      pattern.slice(patternIndex, firstgs),
-      pattern.slice(firstgs + 1, lastgs),
-      pattern.slice(lastgs + 1)
-    ];
-    if (head.length) {
-      const fileHead = file.slice(fileIndex, fileIndex + head.length);
-      if (!this.#matchOne(fileHead, head, partial, 0, 0)) {
-        return false;
-      }
-      fileIndex += head.length;
-      patternIndex += head.length;
-    }
-    let fileTailMatch = 0;
-    if (tail.length) {
-      if (tail.length + fileIndex > file.length)
-        return false;
-      let tailStart = file.length - tail.length;
-      if (this.#matchOne(file, tail, partial, tailStart, 0)) {
-        fileTailMatch = tail.length;
-      } else {
-        if (file[file.length - 1] !== "" || fileIndex + tail.length === file.length) {
-          return false;
-        }
-        tailStart--;
-        if (!this.#matchOne(file, tail, partial, tailStart, 0)) {
-          return false;
-        }
-        fileTailMatch = tail.length + 1;
-      }
-    }
-    if (!body.length) {
-      let sawSome = !!fileTailMatch;
-      for (let i2 = fileIndex; i2 < file.length - fileTailMatch; i2++) {
-        const f = String(file[i2]);
-        sawSome = true;
-        if (f === "." || f === ".." || !this.options.dot && f.startsWith(".")) {
-          return false;
-        }
-      }
-      return partial || sawSome;
-    }
-    const bodySegments = [[[], 0]];
-    let currentBody = bodySegments[0];
-    let nonGsParts = 0;
-    const nonGsPartsSums = [0];
-    for (const b of body) {
-      if (b === GLOBSTAR) {
-        nonGsPartsSums.push(nonGsParts);
-        currentBody = [[], 0];
-        bodySegments.push(currentBody);
-      } else {
-        currentBody[0].push(b);
-        nonGsParts++;
-      }
-    }
-    let i = bodySegments.length - 1;
-    const fileLength = file.length - fileTailMatch;
-    for (const b of bodySegments) {
-      b[1] = fileLength - (nonGsPartsSums[i--] + b[0].length);
-    }
-    return !!this.#matchGlobStarBodySections(file, bodySegments, fileIndex, 0, partial, 0, !!fileTailMatch);
-  }
-  // return false for "nope, not matching"
-  // return null for "not matching, cannot keep trying"
-  #matchGlobStarBodySections(file, bodySegments, fileIndex, bodyIndex, partial, globStarDepth, sawTail) {
-    const bs = bodySegments[bodyIndex];
-    if (!bs) {
-      for (let i = fileIndex; i < file.length; i++) {
-        sawTail = true;
-        const f = file[i];
-        if (f === "." || f === ".." || !this.options.dot && f.startsWith(".")) {
-          return false;
-        }
-      }
-      return sawTail;
-    }
-    const [body, after] = bs;
-    while (fileIndex <= after) {
-      const m = this.#matchOne(file.slice(0, fileIndex + body.length), body, partial, fileIndex, 0);
-      if (m && globStarDepth < this.maxGlobstarRecursion) {
-        const sub = this.#matchGlobStarBodySections(file, bodySegments, fileIndex + body.length, bodyIndex + 1, partial, globStarDepth + 1, sawTail);
-        if (sub !== false) {
-          return sub;
-        }
-      }
-      const f = file[fileIndex];
-      if (f === "." || f === ".." || !this.options.dot && f.startsWith(".")) {
-        return false;
-      }
-      fileIndex++;
-    }
-    return partial || null;
-  }
-  #matchOne(file, pattern, partial, fileIndex, patternIndex) {
-    let fi;
-    let pi;
-    let pl;
-    let fl;
-    for (fi = fileIndex, pi = patternIndex, fl = file.length, pl = pattern.length; fi < fl && pi < pl; fi++, pi++) {
-      this.debug("matchOne loop");
-      let p = pattern[pi];
-      let f = file[fi];
-      this.debug(pattern, p, f);
-      if (p === false || p === GLOBSTAR) {
-        return false;
-      }
-      let hit;
-      if (typeof p === "string") {
-        hit = f === p;
-        this.debug("string match", p, f, hit);
-      } else {
-        hit = p.test(f);
-        this.debug("pattern match", p, f, hit);
-      }
-      if (!hit)
-        return false;
-    }
-    if (fi === fl && pi === pl) {
-      return true;
-    } else if (fi === fl) {
-      return partial;
-    } else if (pi === pl) {
-      return fi === fl - 1 && file[fi] === "";
-    } else {
-      throw new Error("wtf?");
-    }
-  }
-  braceExpand() {
-    return braceExpand(this.pattern, this.options);
-  }
-  parse(pattern) {
-    assertValidPattern(pattern);
-    const options = this.options;
-    if (pattern === "**")
-      return GLOBSTAR;
-    if (pattern === "")
-      return "";
-    let m;
-    let fastTest = null;
-    if (m = pattern.match(starRE)) {
-      fastTest = options.dot ? starTestDot : starTest;
-    } else if (m = pattern.match(starDotExtRE)) {
-      fastTest = (options.nocase ? options.dot ? starDotExtTestNocaseDot : starDotExtTestNocase : options.dot ? starDotExtTestDot : starDotExtTest)(m[1]);
-    } else if (m = pattern.match(qmarksRE)) {
-      fastTest = (options.nocase ? options.dot ? qmarksTestNocaseDot : qmarksTestNocase : options.dot ? qmarksTestDot : qmarksTest)(m);
-    } else if (m = pattern.match(starDotStarRE)) {
-      fastTest = options.dot ? starDotStarTestDot : starDotStarTest;
-    } else if (m = pattern.match(dotStarRE)) {
-      fastTest = dotStarTest;
-    }
-    const re = AST.fromGlob(pattern, this.options).toMMPattern();
-    if (fastTest && typeof re === "object") {
-      Reflect.defineProperty(re, "test", { value: fastTest });
-    }
-    return re;
-  }
-  makeRe() {
-    if (this.regexp || this.regexp === false)
-      return this.regexp;
-    const set = this.set;
-    if (!set.length) {
-      this.regexp = false;
-      return this.regexp;
-    }
-    const options = this.options;
-    const twoStar = options.noglobstar ? star2 : options.dot ? twoStarDot : twoStarNoDot;
-    const flags = new Set(options.nocase ? ["i"] : []);
-    let re = set.map((pattern) => {
-      const pp = pattern.map((p) => {
-        if (p instanceof RegExp) {
-          for (const f of p.flags.split(""))
-            flags.add(f);
-        }
-        return typeof p === "string" ? regExpEscape2(p) : p === GLOBSTAR ? GLOBSTAR : p._src;
-      });
-      pp.forEach((p, i) => {
-        const next = pp[i + 1];
-        const prev = pp[i - 1];
-        if (p !== GLOBSTAR || prev === GLOBSTAR) {
-          return;
-        }
-        if (prev === void 0) {
-          if (next !== void 0 && next !== GLOBSTAR) {
-            pp[i + 1] = "(?:\\/|" + twoStar + "\\/)?" + next;
-          } else {
-            pp[i] = twoStar;
-          }
-        } else if (next === void 0) {
-          pp[i - 1] = prev + "(?:\\/|\\/" + twoStar + ")?";
-        } else if (next !== GLOBSTAR) {
-          pp[i - 1] = prev + "(?:\\/|\\/" + twoStar + "\\/)" + next;
-          pp[i + 1] = GLOBSTAR;
-        }
-      });
-      const filtered = pp.filter((p) => p !== GLOBSTAR);
-      if (this.partial && filtered.length >= 1) {
-        const prefixes = [];
-        for (let i = 1; i <= filtered.length; i++) {
-          prefixes.push(filtered.slice(0, i).join("/"));
-        }
-        return "(?:" + prefixes.join("|") + ")";
-      }
-      return filtered.join("/");
-    }).join("|");
-    const [open2, close] = set.length > 1 ? ["(?:", ")"] : ["", ""];
-    re = "^" + open2 + re + close + "$";
-    if (this.partial) {
-      re = "^(?:\\/|" + open2 + re.slice(1, -1) + close + ")$";
-    }
-    if (this.negate)
-      re = "^(?!" + re + ").+$";
-    try {
-      this.regexp = new RegExp(re, [...flags].join(""));
-    } catch {
-      this.regexp = false;
-    }
-    return this.regexp;
-  }
-  slashSplit(p) {
-    if (this.preserveMultipleSlashes) {
-      return p.split("/");
-    } else if (this.isWindows && /^\/\/[^/]+/.test(p)) {
-      return ["", ...p.split(/\/+/)];
-    } else {
-      return p.split(/\/+/);
-    }
-  }
-  match(f, partial = this.partial) {
-    this.debug("match", f, this.pattern);
-    if (this.comment) {
-      return false;
-    }
-    if (this.empty) {
-      return f === "";
-    }
-    if (f === "/" && partial) {
-      return true;
-    }
-    const options = this.options;
-    if (this.isWindows) {
-      f = f.split("\\").join("/");
-    }
-    const ff = this.slashSplit(f);
-    this.debug(this.pattern, "split", ff);
-    const set = this.set;
-    this.debug(this.pattern, "set", set);
-    let filename = ff[ff.length - 1];
-    if (!filename) {
-      for (let i = ff.length - 2; !filename && i >= 0; i--) {
-        filename = ff[i];
-      }
-    }
-    for (const pattern of set) {
-      let file = ff;
-      if (options.matchBase && pattern.length === 1) {
-        file = [filename];
-      }
-      const hit = this.matchOne(file, pattern, partial);
-      if (hit) {
-        if (options.flipNegate) {
-          return true;
-        }
-        return !this.negate;
-      }
-    }
-    if (options.flipNegate) {
-      return false;
-    }
-    return this.negate;
-  }
-  static defaults(def) {
-    return minimatch.defaults(def).Minimatch;
-  }
-};
-minimatch.AST = AST;
-minimatch.Minimatch = Minimatch;
-minimatch.escape = escape;
-minimatch.unescape = unescape;
-
-// dist/mcp/SessionScope.js
-var ScopeViolation = class extends Error {
-  path;
-  workOrderId;
-  constructor(path2, workOrderId, reason) {
-    super(`ScopeViolation [${workOrderId}]: ${reason} \u2014 path: ${path2}`);
-    this.path = path2;
-    this.workOrderId = workOrderId;
-    this.name = "ScopeViolation";
-  }
-};
-var activeScope = null;
-var SessionScope = {
-  set(policy) {
-    activeScope = policy;
-  },
-  clear() {
-    activeScope = null;
-  },
-  get() {
-    return activeScope;
-  },
-  /**
-   * Enforce scope for a file path.
-   * Throws ScopeViolation if:
-   *  - a scope is active AND the path is not allowed
-   * If no scope is active, all paths are permitted.
-   */
-  enforce(filePath) {
-    if (!activeScope)
-      return;
-    const { workOrderId, allowedFiles, allowedGlobs, deniedGlobs } = activeScope;
-    const inAllowedFiles = allowedFiles.some((f) => filePath === f || filePath.endsWith("/" + f) || filePath.endsWith(f));
-    const inAllowedGlobs = allowedGlobs.some((g) => minimatch(filePath, g, { matchBase: true }));
-    if (!inAllowedFiles && !inAllowedGlobs) {
-      throw new ScopeViolation(filePath, workOrderId, "path not in allowedFiles or allowedGlobs");
-    }
-    const isDenied = deniedGlobs.some((g) => minimatch(filePath, g, { matchBase: true }));
-    if (isDenied) {
-      throw new ScopeViolation(filePath, workOrderId, "path matches deniedGlobs");
-    }
-  },
-  fromWorkOrderRow(row) {
-    return {
-      workOrderId: row.workOrderId,
-      allowedFiles: JSON.parse(row.allowedFiles),
-      allowedGlobs: JSON.parse(row.allowedGlobs),
-      deniedGlobs: JSON.parse(row.deniedGlobs),
-      requiredProof: JSON.parse(row.requiredProof)
-    };
-  }
-};
-
-// dist/mcp/tools/get_file_skeleton.js
-init_BlobStore();
-init_PointerStore();
-
-// dist/mcp/BudgetGuard.js
-init_BlobStore();
-init_PointerStore();
-init_esm_node();
-var BUDGET_CHARS = 8e3;
-async function applyBudgetGuard(projectRoot, scanId, artifactName, output) {
-  const serialized = JSON.stringify(output, null, 2);
-  if (serialized.length <= BUDGET_CHARS)
-    return output;
-  const blobStore = new BlobStore(projectRoot);
-  const pointerStore = PointerStore.open(projectRoot);
-  const { contentHash, blobPath } = await blobStore.writeAtomic(serialized);
-  const pointerId = `ptr_${v4_default().replace(/-/g, "").slice(0, 16)}`;
-  await pointerStore.insertPointer({
-    pointerId,
-    scanId,
-    artifactName,
-    contentHash,
-    blobPath,
-    schemaVersion: "1.0.0",
-    createdAt: Date.now(),
-    expiresAt: null
-  });
-  const result = {
-    pointerId,
-    contentHash,
-    sizeBytes: serialized.length,
-    summary: `Output exceeded context budget (${serialized.length} chars). Written to artifact blob.`,
-    hydrators: ["get_evidence_slice", "get_start_here", "get_project_summary"]
-  };
-  return result;
-}
-async function hydratePointer(projectRoot, pointerId) {
-  const pointerStore = PointerStore.open(projectRoot);
-  const row = pointerStore.getPointer(pointerId);
-  if (!row) {
-    throw new Error(`ArtifactNotFound: pointer ${pointerId} does not exist`);
-  }
-  if (row.expiresAt !== null && row.expiresAt < Date.now()) {
-    throw new Error(`ArtifactCollectedError: pointer ${pointerId} has expired`);
-  }
-  const SUPPORTED_VERSIONS = ["1.0.0", "2.0.0"];
-  if (!SUPPORTED_VERSIONS.includes(row.schemaVersion)) {
-    throw new Error(`UnsupportedSchema: pointer ${pointerId} has schema version ${row.schemaVersion}`);
-  }
-  const blobStore = new BlobStore(projectRoot);
-  const content = await blobStore.readBlob(row.blobPath);
-  const valid = await blobStore.verifyIntegrity(row.blobPath, row.contentHash);
-  if (!valid) {
-    throw new Error(`IntegrityError: blob for pointer ${pointerId} failed hash verification`);
-  }
-  return { content, row };
-}
-
-// dist/mcp/tools/get_file_skeleton.js
-init_esm_node();
-var getFileSkeletonTool = {
-  name: "get_file_skeleton",
-  description: "Returns a content-addressed skeleton view of a source file (function signatures, class names, exported symbols). Enforces active workOrder scope. Results are content-addressed \u2014 repeated calls on unchanged files return cached pointers.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      projectRoot: { type: "string", description: "Absolute project root" },
-      filePath: { type: "string", description: "Path relative to projectRoot" },
-      scanId: { type: "string", description: "Current scan ID for pointer registration" }
-    },
-    required: ["projectRoot", "filePath", "scanId"]
-  }
-};
-async function handleGetFileSkeleton(args) {
-  const projectRoot = args.projectRoot;
-  const filePath = args.filePath;
-  const scanId = args.scanId;
-  if (!projectRoot || !filePath || !scanId) {
-    throw new Error("projectRoot, filePath, and scanId are required");
-  }
-  try {
-    SessionScope.enforce(filePath);
-  } catch (e) {
-    if (e instanceof ScopeViolation)
-      throw e;
-    throw e;
-  }
-  const absolutePath = filePath.startsWith("/") ? filePath : join16(projectRoot, filePath);
-  let currentHash;
-  try {
-    currentHash = await hashFile(absolutePath);
-  } catch {
-    throw new Error(`FileNotFound: cannot read ${filePath}`);
-  }
-  const parserVersion = "1.0.0";
-  const cacheKey = `skeleton:${currentHash}:${parserVersion}`;
-  const pointerStore = PointerStore.open(projectRoot);
-  const existingPointers = pointerStore.listPointersByScan(scanId);
-  const cached = existingPointers.find((p) => p.artifactName === "file_skeleton" && p.contentHash === cacheKey);
-  if (cached) {
-    return {
-      pointerId: cached.pointerId,
-      contentHash: currentHash,
-      cached: true,
-      filePath
-    };
-  }
-  const source = await readFile10(absolutePath, "utf8");
-  const skeleton = extractSkeleton(source, filePath);
-  const skeletonPayload = {
-    filePath,
-    sourceHash: currentHash,
-    parserVersion,
-    skeleton
-  };
-  const blobStore = new BlobStore(projectRoot);
-  const serialized = JSON.stringify(skeletonPayload, null, 2);
-  const { contentHash: skeletonHash, blobPath } = await blobStore.writeAtomic(serialized);
-  const pointerId = `ptr_skel_${v4_default().replace(/-/g, "").slice(0, 12)}`;
-  await pointerStore.insertPointer({
-    pointerId,
-    scanId,
-    artifactName: "file_skeleton",
-    contentHash: cacheKey,
-    // cache key encodes source hash + parser version
-    blobPath,
-    schemaVersion: "1.0.0",
-    createdAt: Date.now(),
-    expiresAt: null
-  });
-  const result = {
-    filePath,
-    sourceHash: currentHash,
-    pointerId,
-    skeleton
-  };
-  return await applyBudgetGuard(projectRoot, scanId, "file_skeleton", result);
-}
-function extractSkeleton(source, filePath) {
-  const lines = source.split("\n");
-  const skeleton = [];
-  const ext2 = filePath.split(".").pop() ?? "";
-  const isTS = ["ts", "tsx"].includes(ext2);
-  const isJS = ["js", "jsx", "mjs", "cjs"].includes(ext2);
-  if (isTS || isJS) {
-    for (let i = 0; i < lines.length; i++) {
-      const line = lines[i].trim();
-      if (/^(export\s+)?(async\s+)?function\b/.test(line) || /^(export\s+)?(abstract\s+)?class\b/.test(line) || /^(export\s+)?interface\b/.test(line) || /^(export\s+)?type\s+\w+/.test(line) || /^(export\s+)?enum\b/.test(line) || /^(export\s+)?const\s+\w+\s*[:=(]/.test(line) || /^(export\s+)?let\s+\w+\s*[:=(]/.test(line) || /^(export\s+)?(default\s+)/.test(line) || /^\s*(public|private|protected|static|readonly|abstract)\s+/.test(line) || /^import\b/.test(line)) {
-        skeleton.push(`L${i + 1}: ${lines[i]}`);
-      }
-    }
-  } else {
-    return lines.slice(0, 80).map((l, i) => `L${i + 1}: ${l}`);
-  }
-  return skeleton;
-}
-
-// dist/mcp/tools/read_file.js
-import { readFile as readFile11 } from "fs/promises";
-import { join as join17 } from "path";
-init_BlobStore();
-init_BlobStore();
-init_PointerStore();
-init_esm_node();
-var readFileTool = {
-  name: "read_file",
-  description: "Reads a file within the active workOrder scope. Enforces allowedFiles/allowedGlobs/deniedGlobs. Records content hash. Output is budgeted.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      projectRoot: { type: "string", description: "Absolute project root" },
-      filePath: { type: "string", description: "Path relative to projectRoot" },
-      scanId: { type: "string", description: "Current scan ID for pointer registration" },
-      startLine: { type: "number", description: "Optional: 1-based start line to return a slice" },
-      endLine: { type: "number", description: "Optional: 1-based end line (inclusive). Capped at startLine+500." }
-    },
-    required: ["projectRoot", "filePath", "scanId"]
-  }
-};
-async function handleReadFile(args) {
-  const projectRoot = args.projectRoot;
-  const filePath = args.filePath;
-  const scanId = args.scanId;
-  const startLine = args.startLine !== void 0 ? Number(args.startLine) : void 0;
-  const endLine = args.endLine !== void 0 ? Math.min(Number(args.endLine), (startLine ?? 1) + 500) : void 0;
-  if (!projectRoot || !filePath || !scanId) {
-    throw new Error("projectRoot, filePath, and scanId are required");
-  }
-  try {
-    SessionScope.enforce(filePath);
-  } catch (e) {
-    if (e instanceof ScopeViolation)
-      throw e;
-    throw e;
-  }
-  const absolutePath = filePath.startsWith("/") ? filePath : join17(projectRoot, filePath);
-  let content;
-  try {
-    content = await readFile11(absolutePath, "utf8");
-  } catch {
-    throw new Error(`FileNotFound: cannot read ${filePath}`);
-  }
-  const contentHash = await hashFile(absolutePath);
-  let output = content;
-  let sliceInfo;
-  if (startLine !== void 0) {
-    const lines = content.split("\n");
-    const end = endLine ?? lines.length;
-    output = lines.slice(startLine - 1, end).join("\n");
-    sliceInfo = { startLine, endLine: end, totalLines: lines.length };
-  }
-  const blobStore = new BlobStore(projectRoot);
-  const pointerStore = PointerStore.open(projectRoot);
-  const { blobPath } = await blobStore.writeAtomic(content);
-  const pointerId = `ptr_file_${v4_default().replace(/-/g, "").slice(0, 12)}`;
-  await pointerStore.insertPointer({
-    pointerId,
-    scanId,
-    artifactName: "file_read",
-    contentHash,
-    blobPath,
-    schemaVersion: "1.0.0",
-    createdAt: Date.now(),
-    expiresAt: null
-  });
-  const result = {
-    filePath,
-    contentHash,
-    pointerId,
-    content: output
-  };
-  if (sliceInfo)
-    result.slice = sliceInfo;
-  return await applyBudgetGuard(projectRoot, scanId, "file_read", result);
-}
-
-// dist/mcp/tools/hydration/get_start_here.js
-var getStartHereTool = {
-  name: "get_start_here",
-  description: "Hydrates the start-here index for a scan manifest pointer. Returns the top 5 highest-gravity files. Pointer must be valid and unexpired.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      projectRoot: { type: "string", description: "Absolute project root" },
-      manifestPointer: { type: "string", description: "Pointer ID for the scan manifest or analysis.index artifact" },
-      scanId: { type: "string", description: "Current scan ID for budget pointer registration" }
-    },
-    required: ["projectRoot", "manifestPointer", "scanId"]
-  }
-};
-async function handleGetStartHere(args) {
-  const projectRoot = args.projectRoot;
-  const manifestPointer = args.manifestPointer;
-  const scanId = args.scanId;
-  if (!projectRoot || !manifestPointer || !scanId) {
-    throw new Error("projectRoot, manifestPointer, and scanId are required");
-  }
-  const { content, row } = await hydratePointer(projectRoot, manifestPointer);
-  const payload = JSON.parse(content.toString("utf8"));
-  if (row.artifactName === "artifact_manifest") {
-    const manifest = payload;
-    const analysisEntry = manifest.artifacts.find((a) => a.name === "analysis" || a.name === "analysis.index");
-    if (!analysisEntry?.indexes?.startHere) {
-      throw new Error("Manifest has no analysis.index entry \u2014 rescan to regenerate");
-    }
-    const { content: indexContent } = await hydratePointer(projectRoot, analysisEntry.indexes.startHere);
-    const index = JSON.parse(indexContent.toString("utf8"));
-    const result = {
-      startHere: index.startHere.slice(0, 5),
-      schemaVersion: index.schemaVersion,
-      scanId: index.scanId
-    };
-    return await applyBudgetGuard(projectRoot, scanId, "get_start_here_result", result);
-  }
-  if (row.artifactName === "analysis.index") {
-    const result = {
-      startHere: payload.startHere.slice(0, 5),
-      schemaVersion: payload.schemaVersion,
-      scanId: payload.scanId
-    };
-    return await applyBudgetGuard(projectRoot, scanId, "get_start_here_result", result);
-  }
-  throw new Error(`Unsupported artifact type for get_start_here: ${row.artifactName}`);
-}
-
-// dist/mcp/tools/hydration/get_project_summary.js
-var getProjectSummaryTool = {
-  name: "get_project_summary",
-  description: "Returns high-level project metrics from a scan manifest pointer: file counts, pillar summary, stack. Token-safe. Pointer must be valid and unexpired.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      projectRoot: { type: "string", description: "Absolute project root" },
-      manifestPointer: { type: "string", description: "Pointer ID for the scan manifest" },
-      scanId: { type: "string", description: "Current scan ID for budget pointer registration" }
-    },
-    required: ["projectRoot", "manifestPointer", "scanId"]
-  }
-};
-async function handleGetProjectSummary(args) {
-  const projectRoot = args.projectRoot;
-  const manifestPointer = args.manifestPointer;
-  const scanId = args.scanId;
-  if (!projectRoot || !manifestPointer || !scanId) {
-    throw new Error("projectRoot, manifestPointer, and scanId are required");
-  }
-  const { content, row } = await hydratePointer(projectRoot, manifestPointer);
-  const payload = JSON.parse(content.toString("utf8"));
-  if (row.artifactName === "artifact_manifest") {
-    const manifest = payload;
-    const analysisEntry = manifest.artifacts.find((a) => a.name === "analysis" && a.indexes?.startHere);
-    let indexData = {};
-    if (analysisEntry?.indexes?.startHere) {
-      const { content: ic } = await hydratePointer(projectRoot, analysisEntry.indexes.startHere);
-      indexData = JSON.parse(ic.toString("utf8"));
-    }
-    const result = {
-      scanId: manifest.scanId,
-      generatedAt: manifest.generatedAt,
-      artifactCount: manifest.artifacts.length,
-      totalArtifactBytes: manifest.artifacts.reduce((s, a) => s + (a.sizeBytes ?? 0), 0),
-      startHere: indexData.startHere,
-      topHeat: indexData.topHeat,
-      pillarSummary: indexData.pillarSummary,
-      totalFiles: indexData.totalFiles,
-      realSourceFiles: indexData.realSourceFiles
-    };
-    return await applyBudgetGuard(projectRoot, scanId, "get_project_summary_result", result);
-  }
-  if (row.artifactName === "analysis.index") {
-    const result = {
-      scanId: payload.scanId,
-      startHere: payload.startHere,
-      topHeat: payload.topHeat,
-      pillarSummary: payload.pillarSummary,
-      totalFiles: payload.totalFiles,
-      realSourceFiles: payload.realSourceFiles
-    };
-    return await applyBudgetGuard(projectRoot, scanId, "get_project_summary_result", result);
-  }
-  throw new Error(`Unsupported artifact type for get_project_summary: ${row.artifactName}`);
-}
-
-// dist/mcp/tools/hydration/get_evidence_slice.js
-var getEvidenceSliceTool = {
-  name: "get_evidence_slice",
-  description: "Raw fallback: returns a line-range slice from a blob artifact. Pointer must be valid and unexpired. Output is budgeted.",
-  inputSchema: {
-    type: "object",
-    properties: {
-      projectRoot: { type: "string", description: "Absolute project root" },
-      pointerId: { type: "string", description: "Pointer ID for the target artifact" },
-      startLine: { type: "number", description: "Inclusive start line (1-based)" },
-      endLine: { type: "number", description: "Inclusive end line (1-based). Capped at startLine+200." },
-      scanId: { type: "string", description: "Current scan ID for budget pointer registration" }
-    },
-    required: ["projectRoot", "pointerId", "startLine", "endLine", "scanId"]
-  }
-};
-async function handleGetEvidenceSlice(args) {
-  const projectRoot = args.projectRoot;
-  const pointerId = args.pointerId;
-  const startLine = Number(args.startLine);
-  const endLine = Math.min(Number(args.endLine), startLine + 200);
-  const scanId = args.scanId;
-  if (!projectRoot || !pointerId || !scanId) {
-    throw new Error("projectRoot, pointerId, startLine, endLine, and scanId are required");
-  }
-  const { content, row } = await hydratePointer(projectRoot, pointerId);
-  const rawText = content.toString("utf8");
-  const scope = SessionScope.get();
-  if (scope && (row.artifactName === "file_read" || row.artifactName === "file_skeleton")) {
-    try {
-      const parsed = JSON.parse(rawText);
-      if (parsed.filePath) {
-        SessionScope.enforce(parsed.filePath);
-      }
-    } catch (e) {
-      if (e.name === "ScopeViolation")
-        throw e;
-    }
-  }
-  const lines = rawText.split("\n");
-  const sliced = lines.slice(startLine - 1, endLine);
-  const result = {
-    pointerId,
-    artifactName: row.artifactName,
-    startLine,
-    endLine,
-    totalLines: lines.length,
-    slice: sliced
-  };
-  return await applyBudgetGuard(projectRoot, scanId, "evidence_slice", result);
-}
-
-// dist/mcp/server.js
-var ALL_TOOLS = [
-  scanProjectTool,
-  getProjectMapTool,
-  setProjectBriefTool,
-  getFileContextTool,
-  writeDecisionCardTool,
-  getStrategicOverviewTool,
-  inspectPillarTool,
-  getWildDiscoveriesTool,
-  markStaleTool,
-  // Phase 2: Skeletons + Hydration
-  getFileSkeletonTool,
-  readFileTool,
-  getStartHereTool,
-  getProjectSummaryTool,
-  getEvidenceSliceTool
-];
-var TOOL_HANDLERS = {
-  scan_project: handleScanProject,
-  get_project_map: handleGetProjectMap,
-  set_project_brief: handleSetProjectBrief,
-  get_file_context: handleGetFileContext,
-  write_decision_card: handleWriteDecisionCard,
-  get_strategic_overview: handleGetStrategicOverview,
-  inspect_pillar: handleInspectPillar,
-  get_wild_discoveries: handleGetWildDiscoveries,
-  mark_stale: handleMarkStale,
-  // Phase 2
-  get_file_skeleton: handleGetFileSkeleton,
-  read_file: handleReadFile,
-  get_start_here: handleGetStartHere,
-  get_project_summary: handleGetProjectSummary,
-  get_evidence_slice: handleGetEvidenceSlice
-};
-async function startMCPServer(options = {}) {
-  await initParser2();
-  console.error("[vibe-splain] Tree-Sitter parser initialized");
-  const server = new Server({ name: "vibe-splain", version: "3.5.0" }, { capabilities: { tools: {}, prompts: {} } });
-  server.setRequestHandler(ListPromptsRequestSchema, async () => ({
-    prompts: [
-      {
-        name: "build_dossier",
-        description: "Build a full architectural dossier using vibe-splain (replaces the need to copy-paste the README prompt)"
-      }
-    ]
-  }));
-  server.setRequestHandler(GetPromptRequestSchema, async (request) => {
-    if (request.params.name !== "build_dossier") {
-      throw new Error(`Unknown prompt: ${request.params.name}`);
-    }
-    return {
-      description: "Build a full architectural dossier",
-      messages: [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `You are a skeptical staff engineer doing a HOSTILE architecture review of this codebase.
-You are NOT writing documentation. You are finding the load-bearing walls, the landmines,
-and the clever moves, and you are taking positions on them.
-
-PROCESS \u2014 follow in order:
-1. Call scan_project, then get_project_map. The map gives you: the detected stack,
-   the FIXED set of pillars (you may not invent others), the Start-Here files (highest
-   gravity = most depended-upon), and Wild-Discovery candidates (highest heat = most smell).
-2. Read the map's stack and entrypoints. Write a 3-5 sentence project brief: what IS this,
-   what's the real stack, and \u2014 critically \u2014 which files are the actual application vs.
-   mockups/generated/vendored noise. Pass it via set_project_brief. Do this BEFORE any card.
-3. Work the Start-Here files first (highest gravity), then the Wild-Discovery files.
-   For each, call get_file_context. It returns hotSpans (the gnarliest functions) and
-   smellSpans (located tech debt) \u2014 base your evidence on THOSE, never on header comments.
-4. Write one decision card per file via write_decision_card.
-
-This is an AUTONOMOUS loop. Every tool response includes a \`nextStep\` and often a
-\`remainingFiles\` list \u2014 OBEY them. Do NOT stop, summarize, or ask the user "how would
-you like to proceed" until every Start-Here and Wild-Discovery file has a card. Writing
-the brief is the START of the work, not the end. Keep calling get_file_context +
-write_decision_card until remainingFiles is empty.
-
-RULES FOR EVERY CARD \u2014 non-negotiable:
-- The \`thesis\` is a VERDICT in one sentence. Take a position. If you can't, you don't
-  understand the file yet \u2014 read more.
-- Pick a \`category\`: Bottleneck, Hack, Smart-Move, Risk, Convention, or Dead-Weight.
-- \`blastRadius\` must reference the real fan-in (get_file_context.importedBy).
-- NEVER paraphrase the file's own comments. If the insight is already in a // block,
-  it is not insight \u2014 go deeper into the logic.
-- Evidence = 5-20 lines of the ACTUAL interesting code (hotSpans/smellSpans). Never the
-  whole file, never the doc-header.
-- For every Wild-Discovery candidate, name the specific smell and rate its severity.
-
-\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-EXAMPLE \u2014 what GOOD vs BAD looks like:
-
-BAD (rejected \u2014 this is a book report):
-  title: "Panel Component Framework"
-  narrative: "This module establishes the structural framework for the panel-based
-  interface. It defines the generic Panel shell that standardizes look and feel..."
-  \u2192 Restates the header comment. No position. No risk. No tradeoff. Worthless.
-
-GOOD (accepted):
-  title: "Panel shell carries 14 props and 6 tools in one file"
-  thesis: "cipher-panels-a.jsx is a god-file: one 600-line module owns the shared shell
-           AND three unrelated generators, so any panel change risks all of them."
-  category: "Risk"  severity: 4
-  narrative: "Panel was built as a single shell to guarantee visual consistency, but the
-              three generators (Palette/Vibe/Pocket) were folded in beside it instead of
-              split out. The shell threads 14 props through every tool, so the generators
-              are now coupled to the shell's drag/compact state they don't use."
-  tradeoff: "Bought consistency and one import site; paid with a module no one can change
-             safely and props that leak shell concerns into pure generators."
-  blastRadius: "Imported by cipher-shell.jsx (the app root) \u2014 a regression here is a
-                full-app regression."
-  evidence: [ the 14-param Panel signature; the prop-drill into PalettePanel ]
-\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-
-When done, share the exact file:// UI link returned by scan_project. Never invent a URL.`
+BAD (rejected \u2014 this is a book report):
+  title: "Panel Component Framework"
+  narrative: "This module establishes the structural framework for the panel-based
+  interface. It defines the generic Panel shell that standardizes look and feel..."
+  \u2192 Restates the header comment. No position. No risk. No tradeoff. Worthless.
+
+GOOD (accepted):
+  title: "Panel shell carries 14 props and 6 tools in one file"
+  thesis: "cipher-panels-a.jsx is a god-file: one 600-line module owns the shared shell
+           AND three unrelated generators, so any panel change risks all of them."
+  category: "Risk"  severity: 4
+  narrative: "Panel was built as a single shell to guarantee visual consistency, but the
+              three generators (Palette/Vibe/Pocket) were folded in beside it instead of
+              split out. The shell threads 14 props through every tool, so the generators
+              are now coupled to the shell's drag/compact state they don't use."
+  tradeoff: "Bought consistency and one import site; paid with a module no one can change
+             safely and props that leak shell concerns into pure generators."
+  blastRadius: "Imported by cipher-shell.jsx (the app root) \u2014 a regression here is a
+                full-app regression."
+  evidence: [ the 14-param Panel signature; the prop-drill into PalettePanel ]
+\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+
+When done, share the exact file:// UI link returned by scan_project. Never invent a URL.`
           }
         }
       ]
@@ -7366,7 +4166,7 @@ When done, share the exact file:// UI link returned by scan_project. Never inven
       };
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      console.error(`[vibe-splain] Tool ${name} error:`, message);
+      console.error(`[vibesplain] Tool ${name} error:`, message);
       return {
         content: [{ type: "text", text: `Error: ${message}` }],
         isError: true
@@ -7375,162 +4175,18 @@ When done, share the exact file:// UI link returned by scan_project. Never inven
   });
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("[vibe-splain] MCP server running on stdio");
+  console.error("[vibesplain] MCP server running on stdio");
 }
 
 // dist/commands/serve.js
 async function serveCommand(options) {
-  console.error("[vibe-splain] Starting MCP server...");
+  console.error("[vibesplain] Starting MCP server...");
   await startMCPServer(options);
 }
 
-// dist/commands/hook.js
-import { existsSync as existsSync6, writeFileSync, readFileSync as readFileSync2 } from "fs";
-import { dirname as dirname5, join as join18 } from "path";
-import { tmpdir } from "os";
-
-// dist/hook/preToolUse.js
-init_escalation();
-var DEFER = { action: "defer" };
-var EDIT_TOOLS = /* @__PURE__ */ new Set(["Edit", "Write", "MultiEdit"]);
-function decidePreToolUse(input, gateIndex, sessionState) {
-  if (!EDIT_TOOLS.has(input.tool_name ?? ""))
-    return DEFER;
-  if (!gateIndex) {
-    if (sessionState && !sessionState.warningShown) {
-      const warnMsg = "vibe-splain: .vibe-splainer/gate.json is missing. Please run 'vibe-splain scan' to generate the scan architecture and enable tool guarding.";
-      return {
-        action: "emit",
-        output: {
-          hookSpecificOutput: {
-            hookEventName: "PreToolUse",
-            permissionDecision: "allow",
-            additionalContext: warnMsg,
-            systemMessage: warnMsg
-          }
-        }
-      };
-    }
-    return DEFER;
-  }
-  const filePath = input.tool_input?.file_path;
-  if (!filePath)
-    return DEFER;
-  const ctx = buildEscalationContext(filePath, gateIndex);
-  if (!ctx || ctx.blastRadius === "low")
-    return DEFER;
-  const block = formatEscalation(ctx);
-  if (ctx.blastRadius === "high") {
-    return {
-      action: "emit",
-      output: {
-        hookSpecificOutput: {
-          hookEventName: "PreToolUse",
-          permissionDecision: "ask",
-          permissionDecisionReason: block,
-          additionalContext: block
-        }
-      }
-    };
-  }
-  return {
-    action: "emit",
-    output: {
-      hookSpecificOutput: {
-        hookEventName: "PreToolUse",
-        permissionDecision: "allow",
-        additionalContext: block
-      }
-    }
-  };
-}
-function formatEscalation(ctx) {
-  const lines = [];
-  lines.push(`vibe-splain: ${ctx.blastRadius} blast radius \u2014 ${ctx.targetFile} (gravity ${ctx.gravity}).`);
-  if (ctx.dependentCount > 0) {
-    const shown = ctx.dependents.slice(0, 8);
-    const more = ctx.dependentCount - shown.length;
-    lines.push(`${ctx.dependentCount} file(s) depend on it:`);
-    for (const d of shown)
-      lines.push(`  - ${d}`);
-    if (more > 0)
-      lines.push(`  \u2026 (+${more} more)`);
-  }
-  for (const w of ctx.riskWarnings)
-    lines.push(`[${w.level}] ${w.message}`);
-  lines.push(ctx.smallestSafeChange.summary);
-  return lines.join("\n");
-}
-
-// dist/commands/hook.js
-function findProjectRoot(start) {
-  let dir = start || process.cwd();
-  for (let i = 0; i < 64; i++) {
-    if (existsSync6(join18(dir, ".vibe-splainer", "analysis.json")))
-      return dir;
-    const parent = dirname5(dir);
-    if (parent === dir)
-      break;
-    dir = parent;
-  }
-  return null;
-}
-async function runHookCommand(rawStdin) {
-  let input;
-  try {
-    input = JSON.parse(rawStdin);
-  } catch {
-    return { stdout: null };
-  }
-  const root = findProjectRoot(input.cwd);
-  const gatePath = root ? join18(root, ".vibe-splainer", "gate.json") : null;
-  const gateExists = gatePath ? existsSync6(gatePath) : false;
-  let gateIndex = null;
-  if (gateExists) {
-    try {
-      gateIndex = JSON.parse(readFileSync2(gatePath, "utf8"));
-    } catch {
-    }
-  }
-  const sessionId = input.session_id || "default";
-  const warnFile = join18(tmpdir(), `vibe-splain-warn-${sessionId}`);
-  const warningShown = existsSync6(warnFile);
-  const result = decidePreToolUse(input, gateIndex, { warningShown });
-  if (result.action === "defer")
-    return { stdout: null };
-  if (!gateIndex && result.action === "emit") {
-    try {
-      writeFileSync(warnFile, "1");
-    } catch {
-    }
-  }
-  return { stdout: JSON.stringify(result.output) };
-}
-async function hookPreToolUseCommand() {
-  const raw = await readStdin();
-  const { stdout } = await runHookCommand(raw);
-  if (stdout)
-    process.stdout.write(stdout);
-}
-function readStdin() {
-  return new Promise((resolve2) => {
-    let data = "";
-    if (process.stdin.isTTY) {
-      resolve2("");
-      return;
-    }
-    process.stdin.setEncoding("utf8");
-    process.stdin.on("data", (chunk) => {
-      data += chunk;
-    });
-    process.stdin.on("end", () => resolve2(data));
-    process.stdin.on("error", () => resolve2(data));
-  });
-}
-
 // dist/index.js
 var program = new Command();
-program.name("vibe-splain").description("Architectural dossier engine for vibe-coded projects").version("3.5.0");
+program.name("vibesplain").description("Architectural dossier engine for vibe-coded projects").version("4.0.0");
 program.command("scan").description("Scan a project and write dossier artifacts").option("--root <root>", "Project root directory to scan", ".").option("--format <format>", "Export format (html, markdown, etc.)").option("--budget <budget>", "Token budget for markdown").option("--scope <scope>", "Scope for export").action(async (options) => {
   try {
     const rootPath = resolve(options.root);
@@ -7542,8 +4198,6 @@ program.command("scan").description("Scan a project and write dossier artifacts"
     process.exit(1);
   }
 });
-program.command("install").description("Patch coding agent MCP config files to register vibe-splain").action(installCommand);
+program.command("install").description("Patch coding agent MCP config files to register vibesplain").action(installCommand);
 program.command("serve").description("Start the MCP server (called by the coding agent, not by you)").option("--format <format>", "Export format (html, markdown, etc.)").option("--budget <budget>", "Token budget for markdown").option("--scope <scope>", "Scope for export").action((options) => serveCommand(options));
-var hookCmd = program.command("hook").description("Deterministic agent hooks (called by your coding agent, not by you)");
-hookCmd.command("pretooluse").description("PreToolUse gate: escalate edits to high-blast-radius files").action(() => hookPreToolUseCommand());
 program.parse();