@vibgrate/cli 2026.727.1 → 2026.727.2

package/dist/{chunk-S6CYDZEW.js → chunk-KNELIQJO.js}

@@ -1,17 +1,17 @@
-import { loadConfig, computeUpgradeImpact, getChangelogSignals, gitHistoryAvailable, buildVersionTimelines, findPackageTimeline, severityRank, projectTypeToVulnEcosystem, VERSION } from './chunk-WLETRGAC.js';
-import { resolveVersion, resolveLib, loadCatalog, driftFor, localPackageDocs, readDoc, inventory, localApiSurface, edgeId, buildModuleResolver, resolve, applyStaticTestLinkage, nodeId } from './chunk-C4CKTAZP.js';
+import { loadConfig, computeUpgradeImpact, getChangelogSignals, gitHistoryAvailable, buildVersionTimelines, findPackageTimeline, severityRank, projectTypeToVulnEcosystem, VERSION } from './chunk-WGUL45AV.js';
+import { resolveVersion, resolveLib, loadCatalog, driftFor, localPackageDocs, readDoc, inventory, localApiSurface, edgeId, buildModuleResolver, resolve, applyStaticTestLinkage, nodeId } from './chunk-LKVMI67M.js';
 import { resolveOne, findNodes } from './chunk-J7LKEB2R.js';
 import { discoverModels } from './chunk-OOIG3RUM.js';
-import { impactOf, indexFor, withTimeout, getNodeEmbeddings, queryGraphSemantic, queryGraph, loadEmbedder, isModelReady, cacheDir, loadCache, acquireLock, releaseLock } from './chunk-6IOQJGFT.js';
+import { impactOf, indexFor, withTimeout, getNodeEmbeddings, queryGraphSemantic, queryGraph, loadEmbedder, isModelReady, acquireLock, releaseLock } from './chunk-6ABXHZRN.js';
 import { langById, grammarSetVersion, langForExtension, setGrammarsOverride, parseSource } from './chunk-3Q7QBWFW.js';
 import { redactSecrets } from './chunk-RXP66R2E.js';
-import { loadGraph, ensureVibgrateGitignore, vibgrateDir, writeArtifacts } from './chunk-HABUT7HW.js';
-import { serializeGraph, stableStringify } from './chunk-5Q54GEHM.js';
+import { writeGraphIndex, SCHEMA_VERSION, loadGraph, ensureVibgrateGitignore, vibgrateDir, writeArtifacts } from './chunk-2XQDMLKB.js';
+import { cacheDir, loadCache, serializeGraph, stableStringify } from './chunk-K3MZIVZW.js';
 import { shortId, canonicalize, hashString, hashBytes } from './chunk-JFGYT6BI.js';
 import { writeTextFile, pathExists, readJsonFile } from './chunk-CRAMOEBE.js';
-import * as fs15 from 'fs';
+import * as fs16 from 'fs';
 import { spawnSync, execFileSync } from 'child_process';
-import * as path17 from 'path';
+import * as path18 from 'path';
 import ignore from 'ignore';
 import * as v8 from 'v8';
 import Graph from 'graphology';
@@ -46,9 +46,9 @@ function whichOnPath(cmd) {
 }
 function isOwnBinary(binPath) {
   try {
-    const real = fs15.realpathSync(binPath);
+    const real = fs16.realpathSync(binPath);
     if (/[\\/]@vibgrate[\\/]cli[\\/]/.test(real)) return true;
-    const head = fs15.readFileSync(real, { encoding: "utf8" }).slice(0, 2048);
+    const head = fs16.readFileSync(real, { encoding: "utf8" }).slice(0, 2048);
     return head.includes("@vibgrate/cli") || head.includes("vibgrate");
   } catch {
     return false;
@@ -58,7 +58,7 @@ function isEphemeralNpxBinary(binPath) {
   const NPX_SEGMENT = /[\\/]_npx[\\/]/;
   if (NPX_SEGMENT.test(binPath)) return true;
   try {
-    return NPX_SEGMENT.test(fs15.realpathSync(binPath));
+    return NPX_SEGMENT.test(fs16.realpathSync(binPath));
   } catch {
     return false;
   }
@@ -235,19 +235,19 @@ var SKIP_FILES = /* @__PURE__ */ new Set([
   "flake.lock"
 ]);
 function toPosix(p) {
-  return p.split(path17.sep).join("/");
+  return p.split(path18.sep).join("/");
 }
 function buildRootIgnore(root, exclude) {
   const ig = ignore();
-  const gitignorePath = path17.join(root, ".gitignore");
-  if (fs15.existsSync(gitignorePath)) {
-    ig.add(fs15.readFileSync(gitignorePath, "utf8"));
+  const gitignorePath = path18.join(root, ".gitignore");
+  if (fs16.existsSync(gitignorePath)) {
+    ig.add(fs16.readFileSync(gitignorePath, "utf8"));
   }
   if (exclude.length) ig.add(exclude);
   return ig;
 }
 function discover(options) {
-  const root = path17.resolve(options.root);
+  const root = path18.resolve(options.root);
   const onlyLangs = (options.only ?? []).filter(Boolean);
   const allowLang = (lang) => onlyLangs.length === 0 || onlyLangs.includes(lang.id);
   for (const id of onlyLangs) {
@@ -256,27 +256,27 @@ function discover(options) {
     }
   }
   const rootIg = buildRootIgnore(root, options.exclude ?? []);
-  const scopeAbs = (options.paths && options.paths.length ? options.paths.map((p) => path17.resolve(root, p)) : [root]).filter((p) => fs15.existsSync(p));
+  const scopeAbs = (options.paths && options.paths.length ? options.paths.map((p) => path18.resolve(root, p)) : [root]).filter((p) => fs16.existsSync(p));
   const found = /* @__PURE__ */ new Map();
   const considerFile = (abs) => {
-    const rel2 = toPosix(path17.relative(root, abs));
+    const rel2 = toPosix(path18.relative(root, abs));
     if (rel2.startsWith("..")) return;
     if (rel2 === "" || rootIg.ignores(rel2)) return;
-    if (SKIP_FILES.has(path17.basename(abs).toLowerCase())) return;
-    const lang = langForExtension(path17.extname(abs));
+    if (SKIP_FILES.has(path18.basename(abs).toLowerCase())) return;
+    const lang = langForExtension(path18.extname(abs));
     if (!lang || !allowLang(lang)) return;
     found.set(rel2, { rel: rel2, abs, lang });
   };
   const walk = (dir) => {
     let entries;
     try {
-      entries = fs15.readdirSync(dir, { withFileTypes: true });
+      entries = fs16.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const entry of entries) {
-      const abs = path17.join(dir, entry.name);
-      const rel2 = toPosix(path17.relative(root, abs));
+      const abs = path18.join(dir, entry.name);
+      const rel2 = toPosix(path18.relative(root, abs));
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (rel2 && rootIg.ignores(`${rel2}/`)) continue;
@@ -287,7 +287,7 @@ function discover(options) {
     }
   };
   for (const scope of scopeAbs) {
-    const stat = fs15.statSync(scope);
+    const stat = fs16.statSync(scope);
     if (stat.isDirectory()) walk(scope);
     else if (stat.isFile()) considerFile(scope);
   }
@@ -540,25 +540,36 @@ function mulberry32(seed) {
 var CLUSTER_SEED = 42;
 
 // src/engine/analyze.ts
+var TIER_LARGE_NODES = 5e3;
+var TIER_XL_NODES = 5e4;
+function pickAnalysisTier(nodeCount, forced) {
+  if (forced) return forced;
+  if (nodeCount > TIER_XL_NODES) return "xl";
+  if (nodeCount > TIER_LARGE_NODES) return "large";
+  return "full";
+}
 var DEP_EDGES = /* @__PURE__ */ new Set(["call", "import", "extends", "implements", "references"]);
 var CLUSTER_EDGE_KINDS = /* @__PURE__ */ new Set([...DEP_EDGES, "contains"]);
 var IMPORTANCE_WEIGHTS = { pagerank: 0.4, betweenness: 0.25, eigenvector: 0.2, degree: 0.15 };
 var DEFAULT_BETWEENNESS_LIMIT = 5e3;
 function analyze(nodes, edges, options = {}) {
-  const mode = options.cluster ?? "louvain";
+  const tier = pickAnalysisTier(nodes.length, options.tier);
+  const mode = options.cluster ?? (tier === "xl" ? "louvain" : "louvain");
   const ids = [...nodes.map((n) => n.id)].sort((a, b) => a.localeCompare(b));
   const dg = simpleGraph(ids, edges, DEP_EDGES, "directed");
   const pr = safeMetric(() => pagerank(dg), ids);
-  const bw = dg.order <= (options.betweennessLimit ?? DEFAULT_BETWEENNESS_LIMIT) ? safeMetric(() => betweenness(dg), ids) : zeros(ids);
-  const ev = safeMetric(() => eigenvector(dg), ids);
+  const bwLimit = options.betweennessLimit ?? DEFAULT_BETWEENNESS_LIMIT;
+  const bw = tier === "full" && dg.order <= bwLimit ? safeMetric(() => betweenness(dg), ids) : zeros(ids);
+  const ev = tier === "full" || tier === "large" ? safeMetric(() => eigenvector(dg), ids) : zeros(ids);
   const deg = degreeMap(dg, ids);
   const prN = normalize(pr);
   const bwN = normalize(bw);
   const evN = normalize(ev);
   const degN = normalize(deg);
+  const weights = tier === "xl" ? { pagerank: 0.7, betweenness: 0, eigenvector: 0, degree: 0.3 } : tier === "large" ? { pagerank: 0.5, betweenness: 0, eigenvector: 0.25, degree: 0.25 } : IMPORTANCE_WEIGHTS;
   const importance = /* @__PURE__ */ new Map();
   for (const id of ids) {
-    const score = IMPORTANCE_WEIGHTS.pagerank * (prN.get(id) ?? 0) + IMPORTANCE_WEIGHTS.betweenness * (bwN.get(id) ?? 0) + IMPORTANCE_WEIGHTS.eigenvector * (evN.get(id) ?? 0) + IMPORTANCE_WEIGHTS.degree * (degN.get(id) ?? 0);
+    const score = weights.pagerank * (prN.get(id) ?? 0) + weights.betweenness * (bwN.get(id) ?? 0) + weights.eigenvector * (evN.get(id) ?? 0) + weights.degree * (degN.get(id) ?? 0);
     importance.set(id, score);
   }
   const importanceN = normalize(importance);
@@ -567,7 +578,7 @@ function analyze(nodes, edges, options = {}) {
   const variance = vals.reduce((a, b) => a + (b - mean) ** 2, 0) / (vals.length || 1);
   const std = Math.sqrt(variance);
   const hubThreshold = mean + 2 * std;
-  const { areaByNode, mode: actualMode } = cluster(ids, edges, mode);
+  const { areaByNode, mode: actualMode } = tier === "xl" ? clusterFileLevel(nodes, edges, mode) : cluster(ids, edges, mode);
   const outNodes = nodes.map((n) => ({
     ...n,
     centrality: {
@@ -582,7 +593,42 @@ function analyze(nodes, edges, options = {}) {
   })).sort((a, b) => a.id.localeCompare(b.id));
   const areas = buildAreas(outNodes, edges, areaByNode);
   const outEdges = scoreSurprise(edges, areaByNode);
-  return { nodes: outNodes, edges: outEdges, areas, cluster: actualMode };
+  return { nodes: outNodes, edges: outEdges, areas, cluster: actualMode, tier };
+}
+function clusterFileLevel(nodes, edges, mode) {
+  const fileNodes = nodes.filter((n) => n.kind === "file");
+  const fileIds = fileNodes.map((n) => n.id).sort((a, b) => a.localeCompare(b));
+  if (fileIds.length === 0) {
+    return { areaByNode: new Map(nodes.map((n) => [n.id, -1])), mode: "none" };
+  }
+  const fileIdByPath = new Map(fileNodes.map((n) => [n.file, n.id]));
+  const fileOf = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    if (n.kind === "file") fileOf.set(n.id, n.id);
+    else if (n.file) {
+      const fid = fileIdByPath.get(n.file);
+      if (fid) fileOf.set(n.id, fid);
+    }
+  }
+  const fileEdges = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const e of edges) {
+    if (!DEP_EDGES.has(e.kind)) continue;
+    const sf = fileOf.get(e.src);
+    const df = fileOf.get(e.dst);
+    if (!sf || !df || sf === df) continue;
+    const key = `${e.kind}|${sf}|${df}`;
+    if (seen.has(key)) continue;
+    seen.add(key);
+    fileEdges.push({ ...e, src: sf, dst: df, id: key });
+  }
+  const { areaByNode: fileAreas, mode: used } = cluster(fileIds, fileEdges, mode);
+  const areaByNode = /* @__PURE__ */ new Map();
+  for (const n of nodes) {
+    const fid = fileOf.get(n.id);
+    areaByNode.set(n.id, fid ? fileAreas.get(fid) ?? -1 : -1);
+  }
+  return { areaByNode, mode: used };
 }
 function simpleGraph(ids, edges, kinds, type) {
   const g = new Graph({ type, multi: false, allowSelfLoops: false });
@@ -723,14 +769,14 @@ var DEFAULT_PATHS = [
 ];
 function loadCoverage(root, explicit) {
   const candidates = (explicit && explicit.length ? explicit : DEFAULT_PATHS).map(
-    (p) => path17.resolve(root, p)
+    (p) => path18.resolve(root, p)
   );
-  const found = candidates.filter((p) => fs15.existsSync(p));
+  const found = candidates.filter((p) => fs16.existsSync(p));
   if (found.length === 0) return null;
   const map = /* @__PURE__ */ new Map();
   for (const file of found) {
     try {
-      const text = fs15.readFileSync(file, "utf8");
+      const text = fs16.readFileSync(file, "utf8");
       if (file.endsWith(".json")) mergeIstanbul(map, text, root);
       else mergeLcov(map, text, root);
     } catch {
@@ -739,8 +785,8 @@ function loadCoverage(root, explicit) {
   return map.size ? map : null;
 }
 function rel(root, p) {
-  const abs = path17.isAbsolute(p) ? p : path17.resolve(root, p);
-  return path17.relative(root, abs).split(path17.sep).join("/");
+  const abs = path18.isAbsolute(p) ? p : path18.resolve(root, p);
+  return path18.relative(root, abs).split(path18.sep).join("/");
 }
 function bump(map, file, line, hits) {
   let lh = map.get(file);
@@ -1027,9 +1073,6 @@ function matchConfidence(entry, nameParts, imports, callees) {
   }
   return conf;
 }
-
-// src/schema.ts
-var SCHEMA_VERSION = "vg-graph/1.0";
 var DEFAULT_INLINE_THRESHOLD = 24;
 async function parseFiles(files, options = {}) {
   const threshold = options.inlineThreshold ?? DEFAULT_INLINE_THRESHOLD;
@@ -1050,7 +1093,7 @@ async function parseInline(files, options) {
   onProgress?.(0, files.length);
   for (const file of files) {
     try {
-      const source = fs15.readFileSync(file.abs, "utf8");
+      const source = fs16.readFileSync(file.abs, "utf8");
       out.push(await parseSource(file.rel, file.lang.id, source));
     } catch (err) {
       out.push(emptyParse(file, `parse failed: ${err.message}`));
@@ -1105,9 +1148,9 @@ function isWorkerOom(err) {
   return e?.code === "ERR_WORKER_OUT_OF_MEMORY" || /out of memory/i.test(e?.message ?? "");
 }
 function resolveWorkerFile() {
-  const here = path17.dirname(fileURLToPath(import.meta.url));
-  const candidate = path17.join(here, "parse-worker.js");
-  return fs15.existsSync(candidate) ? candidate : null;
+  const here = path18.dirname(fileURLToPath(import.meta.url));
+  const candidate = path18.join(here, "parse-worker.js");
+  return fs16.existsSync(candidate) ? candidate : null;
 }
 function chunk(items, buckets) {
   const out = Array.from({ length: Math.min(buckets, items.length || 1) }, () => []);
@@ -1356,7 +1399,7 @@ function enclosing3(nodes, line) {
   return best;
 }
 function normalize2(p) {
-  return path17.resolve(p).split(path17.sep).join("/");
+  return path18.resolve(p).split(path18.sep).join("/");
 }
 
 // src/engine/epistemic.ts
@@ -1599,14 +1642,14 @@ var IMPORTANCE = {
   "other-config": 0.08
 };
 function toPosix2(p) {
-  return p.split(path17.sep).join("/");
+  return p.split(path18.sep).join("/");
 }
 function buildRootIgnore2(root, exclude) {
   const ig = ignore();
-  const gitignorePath = path17.join(root, ".gitignore");
-  if (fs15.existsSync(gitignorePath)) {
+  const gitignorePath = path18.join(root, ".gitignore");
+  if (fs16.existsSync(gitignorePath)) {
     try {
-      ig.add(fs15.readFileSync(gitignorePath, "utf8"));
+      ig.add(fs16.readFileSync(gitignorePath, "utf8"));
     } catch {
     }
   }
@@ -1615,7 +1658,7 @@ function buildRootIgnore2(root, exclude) {
 }
 function classifyProjectContext(relOrName) {
   const rel2 = relOrName.replace(/\\/g, "/");
-  const base = path17.basename(rel2);
+  const base = path18.basename(rel2);
   const baseLower = base.toLowerCase();
   if (/^\.env($|\.)/i.test(base) && !isEnvExampleName(baseLower)) return null;
   if (SKIP_FILES.has(baseLower)) return null;
@@ -1628,7 +1671,7 @@ function classifyProjectContext(relOrName) {
   for (const { re, category } of PATH_PATTERNS) {
     if (re.test(rel2)) return category;
   }
-  const ext = path17.extname(baseLower);
+  const ext = path18.extname(baseLower);
   if (DOC_EXTENSIONS.has(ext)) return ext === ".txt" ? "text" : "markdown";
   if (API_EXTENSIONS.has(ext)) return "api-contract";
   if ((ext === ".yaml" || ext === ".yml" || ext === ".json") && /openapi|swagger|asyncapi/i.test(base)) {
@@ -1646,24 +1689,24 @@ function isEnvExampleName(baseLower) {
   return false;
 }
 function discoverDocs(options) {
-  const root = path17.resolve(options.root);
+  const root = path18.resolve(options.root);
   const maxFiles = options.maxFiles ?? DOC_MAX_FILES;
   const rootIg = buildRootIgnore2(root, options.exclude ?? []);
-  const scopeAbs = (options.paths?.length ? options.paths.map((p) => path17.resolve(root, p)) : [root]).filter(
-    (p) => fs15.existsSync(p)
+  const scopeAbs = (options.paths?.length ? options.paths.map((p) => path18.resolve(root, p)) : [root]).filter(
+    (p) => fs16.existsSync(p)
   );
   const found = /* @__PURE__ */ new Map();
   const consider = (abs) => {
     if (found.size >= maxFiles) return;
-    const rel2 = toPosix2(path17.relative(root, abs));
+    const rel2 = toPosix2(path18.relative(root, abs));
     if (!rel2 || rel2.startsWith("..")) return;
     if (rootIg.ignores(rel2)) return;
-    const base = path17.basename(abs);
+    const base = path18.basename(abs);
     if (SKIP_FILES.has(base.toLowerCase())) return;
     const category = classifyProjectContext(rel2);
     if (!category) return;
     try {
-      const st = fs15.statSync(abs);
+      const st = fs16.statSync(abs);
       if (!st.isFile() || st.size > DOC_FILE_MAX_BYTES) return;
       if (st.size === 0) return;
     } catch {
@@ -1675,14 +1718,14 @@ function discoverDocs(options) {
     if (found.size >= maxFiles || depth > 12) return;
     let entries;
     try {
-      entries = fs15.readdirSync(dir, { withFileTypes: true });
+      entries = fs16.readdirSync(dir, { withFileTypes: true });
     } catch {
       return;
     }
     for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
       if (found.size >= maxFiles) return;
-      const abs = path17.join(dir, entry.name);
-      const rel2 = toPosix2(path17.relative(root, abs));
+      const abs = path18.join(dir, entry.name);
+      const rel2 = toPosix2(path18.relative(root, abs));
       if (entry.isDirectory()) {
         if (SKIP_DIRS.has(entry.name)) continue;
         if (rel2 && rootIg.ignores(`${rel2}/`) && !rel2.startsWith(".github")) continue;
@@ -1694,7 +1737,7 @@ function discoverDocs(options) {
   };
   for (const scope of scopeAbs) {
     try {
-      const st = fs15.statSync(scope);
+      const st = fs16.statSync(scope);
       if (st.isDirectory()) walk(scope, 0);
       else if (st.isFile()) consider(scope);
     } catch {
@@ -1705,7 +1748,7 @@ function discoverDocs(options) {
 function prepareDocBody(rel2, raw, category) {
   const scrubbed = redactSecrets(raw);
   if (scrubbed.length <= DOC_BODY_MAX_CHARS) return scrubbed;
-  if (category === "manifest" && path17.basename(rel2).toLowerCase() === "package.json") {
+  if (category === "manifest" && path18.basename(rel2).toLowerCase() === "package.json") {
     return summarizePackageJson(scrubbed);
   }
   if (category === "api-contract" && /\.(ya?ml|json)$/i.test(rel2)) {
@@ -1751,14 +1794,14 @@ function documentNodesFromDocs(docs) {
   for (const d of docs) {
     let raw = "";
     try {
-      raw = fs15.readFileSync(d.abs, "utf8");
+      raw = fs16.readFileSync(d.abs, "utf8");
     } catch {
       continue;
     }
     const category = d.category ?? d.kind;
     const scrubbed = prepareDocBody(d.rel, raw, category);
     if (!scrubbed.trim()) continue;
-    const name = path17.basename(d.rel);
+    const name = path18.basename(d.rel);
     const qualifiedName = d.rel.replace(/\\/g, "/");
     const id = nodeId({
       kind: "document",
@@ -1787,17 +1830,89 @@ function documentNodesFromDocs(docs) {
   }
   return nodes.sort((a, b) => a.file.localeCompare(b.file) || a.id.localeCompare(b.id));
 }
+function shardTsProjects(root, files) {
+  if (files.length === 0) return [];
+  const cache = /* @__PURE__ */ new Map();
+  const byKey = /* @__PURE__ */ new Map();
+  for (const f of files) {
+    const dir = path18.dirname(f.abs);
+    const key = nearestProjectKey(root, dir, cache);
+    const list = byKey.get(key);
+    if (list) list.push(f);
+    else byKey.set(key, [f]);
+  }
+  return [...byKey.entries()].sort((a, b) => a[0].localeCompare(b[0])).map(([key, shardFiles]) => ({
+    key,
+    files: [...shardFiles].sort((a, b) => a.rel.localeCompare(b.rel))
+  }));
+}
+function nearestProjectKey(root, startDir, cache) {
+  const hit = cache.get(startDir);
+  if (hit !== void 0) return hit;
+  let dir = startDir;
+  const rootAbs = path18.resolve(root);
+  while (true) {
+    if (fs16.existsSync(path18.join(dir, "tsconfig.json")) || fs16.existsSync(path18.join(dir, "tsconfig.base.json")) || fs16.existsSync(path18.join(dir, "package.json"))) {
+      const key = toPosix3(path18.relative(rootAbs, dir)) || ".";
+      cache.set(startDir, key);
+      return key;
+    }
+    if (dir === rootAbs || path18.dirname(dir) === dir) {
+      cache.set(startDir, ".");
+      return ".";
+    }
+    dir = path18.dirname(dir);
+  }
+}
+function toPosix3(p) {
+  return p.split(path18.sep).join("/");
+}
+
+// src/engine/timing.ts
+var StageTimer = class {
+  marks = /* @__PURE__ */ new Map();
+  durations = {};
+  start(name) {
+    this.marks.set(name, nowMs());
+  }
+  end(name) {
+    const t0 = this.marks.get(name);
+    if (t0 === void 0) return 0;
+    const ms = Math.round((nowMs() - t0) * 1e3) / 1e3;
+    this.durations[name] = ms;
+    this.marks.delete(name);
+    return ms;
+  }
+  /** Run `fn` under a named stage. */
+  async measure(name, fn) {
+    this.start(name);
+    try {
+      return await fn();
+    } finally {
+      this.end(name);
+    }
+  }
+  snapshot() {
+    return { ...this.durations };
+  }
+};
+function nowMs() {
+  return Number(process.hrtime.bigint() / 1000n) / 1e3;
+}
 
 // src/engine/build.ts
 async function buildGraph(options) {
-  const start = nowMs();
-  const root = path17.resolve(options.root);
+  const timer = new StageTimer();
+  timer.start("total");
+  const root = path18.resolve(options.root);
+  timer.start("discover");
   const files = discover({
     root,
     only: options.only,
     exclude: options.exclude,
     paths: options.paths
   });
+  timer.end("discover");
   const limits = resolveLimits(options.limits);
   if (limits.maxFiles > 0 && files.length > limits.maxFiles) {
     throw new ResourceLimitError(
@@ -1811,15 +1926,17 @@ async function buildGraph(options) {
     grammars,
     disabled: options.noCache
   });
+  timer.start("hash");
   const hashes = /* @__PURE__ */ new Map();
   const fileStats = [];
   const toParse = [];
   const reused = [];
   const buildWarnings = [];
+  let statHits = 0;
   for (const file of files) {
     let stat;
     try {
-      stat = fs15.statSync(file.abs);
+      stat = fs16.statSync(file.abs);
     } catch {
       continue;
     }
@@ -1835,18 +1952,38 @@ async function buildGraph(options) {
       );
       continue;
     }
+    const byStat = options.noCache ? void 0 : cache.getByStat(file.rel, stat.mtimeMs, stat.size);
+    if (byStat) {
+      hashes.set(file.rel, byStat.hash);
+      if (byStat.parse.hash !== byStat.hash) byStat.parse.hash = byStat.hash;
+      fileStats.push({
+        rel: file.rel,
+        size: stat.size,
+        mtimeMs: stat.mtimeMs,
+        hash: byStat.hash
+      });
+      reused.push(byStat.parse);
+      statHits++;
+      continue;
+    }
     let hash = "";
     try {
-      hash = hashBytes(fs15.readFileSync(file.abs));
+      hash = hashBytes(fs16.readFileSync(file.abs));
     } catch {
       continue;
     }
     hashes.set(file.rel, hash);
     fileStats.push({ rel: file.rel, size: stat.size, mtimeMs: stat.mtimeMs, hash });
     const cached2 = cache.get(file.rel, hash);
-    if (cached2) reused.push(cached2);
-    else toParse.push(file);
+    if (cached2) {
+      reused.push(cached2);
+      cache.set(file.rel, cached2, { mtimeMs: stat.mtimeMs, size: stat.size });
+    } else {
+      toParse.push(file);
+    }
   }
+  timer.end("hash");
+  timer.start("parse");
   const parsedNew = await parseFiles(toParse, {
     jobs: options.jobs,
     inline: options.inline,
@@ -1854,8 +1991,12 @@ async function buildGraph(options) {
     grammarsDir: options.grammarsDir,
     memoryBudgetMb: limits.memoryBudgetMb
   });
+  timer.end("parse");
   checkMemoryBudget("parse", limits.memoryBudgetMb);
-  for (const p of parsedNew) cache.set(p.rel, p);
+  for (const p of parsedNew) {
+    const st = fileStats.find((f) => f.rel === p.rel);
+    cache.set(p.rel, p, st ? { mtimeMs: st.mtimeMs, size: st.size } : void 0);
+  }
   const currentRels = new Set(files.map((f) => f.rel));
   cache.prune(currentRels);
   cache.save();
@@ -1863,31 +2004,61 @@ async function buildGraph(options) {
     (a, b) => a.rel < b.rel ? -1 : a.rel > b.rel ? 1 : 0
   );
   const warnings = [...buildWarnings, ...parses.flatMap((p) => p.warnings ?? [])];
+  timer.start("resolve");
   const moduleResolver = buildModuleResolver(root, new Set(parses.map((p) => p.rel)));
   const resolved = resolve(parses, moduleResolver);
+  timer.end("resolve");
   checkMemoryBudget("resolve", limits.memoryBudgetMb);
   const nodeFileById = new Map(resolved.nodes.map((n) => [n.id, n.file]));
   let edges = resolved.edges;
   const resolvers = [...resolved.stats.resolvers];
   const preciseCoveredFiles = /* @__PURE__ */ new Set();
   let tscStats;
-  let tsFiles = options.noTsc ? [] : files.filter((f) => (f.lang.id === "ts" || f.lang.id === "tsx" || f.lang.id === "js") && hashes.has(f.rel)).map((f) => ({ rel: f.rel, abs: f.abs }));
+  const skipTsc = options.noTsc || options.fast;
+  let tsFiles = skipTsc ? [] : files.filter((f) => (f.lang.id === "ts" || f.lang.id === "tsx" || f.lang.id === "js") && hashes.has(f.rel)).map((f) => ({ rel: f.rel, abs: f.abs }));
   if (limits.tscMaxFiles > 0 && tsFiles.length > limits.tscMaxFiles) {
     warnings.push(
       `typescript resolver skipped \u2014 ${tsFiles.length.toLocaleString()} TS/JS files exceed the ${limits.tscMaxFiles.toLocaleString()}-file limit; calls use the heuristic resolver (set VG_TSC_MAX_FILES to raise it, 0 to disable)`
     );
     tsFiles = [];
   }
+  timer.start("tsc");
   if (tsFiles.length) {
-    const res = tsResolveEdges(root, tsFiles, resolved.nodes);
-    if (res.stats.files > 0) {
-      edges = mergePreciseEdges(edges, res.edges, res.coveredFiles, nodeFileById);
-      for (const f of res.coveredFiles) preciseCoveredFiles.add(f);
+    const shards = shardTsProjects(root, tsFiles);
+    let filesCovered = 0;
+    let calls = 0;
+    let jsx = 0;
+    let heritage = 0;
+    let resolvedCount = 0;
+    const coveredAll = /* @__PURE__ */ new Set();
+    const preciseAll = [];
+    for (const shard of shards) {
+      const res = tsResolveEdges(root, shard.files, resolved.nodes);
+      if (res.stats.files === 0) continue;
+      filesCovered += res.stats.files;
+      calls += res.stats.calls;
+      jsx += res.stats.jsx;
+      heritage += res.stats.heritage;
+      resolvedCount += res.stats.resolved;
+      for (const f of res.coveredFiles) coveredAll.add(f);
+      preciseAll.push(...res.edges);
+    }
+    if (filesCovered > 0) {
+      edges = mergePreciseEdges(edges, preciseAll, coveredAll, nodeFileById);
+      for (const f of coveredAll) preciseCoveredFiles.add(f);
       if (!resolvers.includes("tsc")) resolvers.unshift("tsc");
-      tscStats = res.stats;
+      tscStats = {
+        files: filesCovered,
+        calls,
+        jsx,
+        heritage,
+        resolved: resolvedCount,
+        shards: shards.length
+      };
     }
     checkMemoryBudget("typescript resolution", limits.memoryBudgetMb);
   }
+  timer.end("tsc");
   const scip = options.noScip ? null : loadScipIndex(root, options.scip);
   let scipStats;
   if (scip) {
@@ -1908,8 +2079,8 @@ async function buildGraph(options) {
   });
   for (const d of docs) {
     try {
-      const st = fs15.statSync(d.abs);
-      const hash = hashBytes(fs15.readFileSync(d.abs));
+      const st = fs16.statSync(d.abs);
+      const hash = hashBytes(fs16.readFileSync(d.abs));
       hashes.set(d.rel, hash);
       fileStats.push({ rel: d.rel, size: st.size, mtimeMs: st.mtimeMs, hash });
     } catch {
@@ -1917,7 +2088,12 @@ async function buildGraph(options) {
   }
   const docNodes = documentNodesFromDocs(docs);
   if (docNodes.length) nodes = [...nodes, ...docNodes];
-  const analysis = analyze(nodes, linked.edges, { cluster: options.cluster });
+  timer.start("analyze");
+  const analysis = analyze(nodes, linked.edges, {
+    cluster: options.cluster,
+    tier: options.analysisTier
+  });
+  timer.end("analyze");
   checkMemoryBudget("analysis", limits.memoryBudgetMb);
   const languages = [.../* @__PURE__ */ new Set([...parses.map((p) => p.lang), ...docNodes.map((n) => n.lang)])].sort();
   const edgeKinds = [...new Set(analysis.edges.map((e) => e.kind))].sort();
@@ -1945,8 +2121,9 @@ async function buildGraph(options) {
       toolchain
     },
     meta: {
-      root: path17.basename(root) === "" ? "." : ".",
+      root: path18.basename(root) === "" ? "." : ".",
       languages,
+      analysisTier: analysis.tier,
       counts: {
         nodes: analysis.nodes.length,
         edges: analysis.edges.length,
@@ -1972,16 +2149,27 @@ async function buildGraph(options) {
     const grounding = groundGraph(analysis.nodes, analysis.edges, parses);
     if (grounding.length) graph.grounding = grounding;
   }
+  let indexResult;
+  if (!options.noIndex) {
+    timer.start("index");
+    const wr = writeGraphIndex(root, graph);
+    indexResult = { ok: wr.ok, path: wr.ok ? wr.path : void 0, reason: wr.reason };
+    timer.end("index");
+  }
+  timer.end("total");
+  const stages = timer.snapshot();
   return {
     graph,
-    timing: { totalMs: Math.round((nowMs() - start) * 1e3) / 1e3 },
+    timing: { totalMs: stages.total ?? 0, stages },
     reparsed: parsedNew.length,
     reused: reused.length,
+    statHits,
     totalFiles: files.length,
     fileStats,
     resolveStats: resolved.stats,
     tsc: tscStats,
     scip: scipStats,
+    index: indexResult,
     warnings
   };
 }
@@ -1991,14 +2179,14 @@ function toRepoRel(p) {
 function loadScipIndex(root, explicit) {
   const candidates = [
     explicit,
-    path17.join(root, "index.scip"),
-    path17.join(root, ".vibgrate", "index.scip")
+    path18.join(root, "index.scip"),
+    path18.join(root, ".vibgrate", "index.scip")
   ].filter((p) => Boolean(p));
   for (const file of candidates) {
-    const abs = path17.isAbsolute(file) ? file : path17.resolve(root, file);
-    if (!fs15.existsSync(abs)) continue;
+    const abs = path18.isAbsolute(file) ? file : path18.resolve(root, file);
+    if (!fs16.existsSync(abs)) continue;
     try {
-      const index = decodeScipIndex(new Uint8Array(fs15.readFileSync(abs)));
+      const index = decodeScipIndex(new Uint8Array(fs16.readFileSync(abs)));
       if (index.documents.length) {
         return { index, tool: index.toolVersion ? `${index.toolName} ${index.toolVersion}` : index.toolName };
       }
@@ -2047,9 +2235,6 @@ function computeCorpusHash(parses, hashes) {
   const list = [...byRel.entries()].sort((a, b) => a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0);
   return hashString(canonicalize(list));
 }
-function nowMs() {
-  return Number(process.hrtime.bigint() / 1000n) / 1e3;
-}
 
 // src/engine/verify.ts
 var PINNED = "1970-01-01T00:00:00.000Z";
@@ -2116,21 +2301,21 @@ function usageError(message) {
 }
 var SNAPSHOT_VERSION = "vg-freshness/1";
 function snapshotPath(root) {
-  return path17.join(cacheDir(root), "freshness.json");
+  return path18.join(cacheDir(root), "freshness.json");
 }
 function writeSnapshot(root, corpusHash, fileStats, scope = {}) {
   const files = {};
   for (const f of fileStats) files[f.rel] = { size: f.size, mtimeMs: f.mtimeMs, hash: f.hash };
   const snapshot = { version: SNAPSHOT_VERSION, corpusHash, scope: pruneScope(scope), files };
   try {
-    fs15.mkdirSync(cacheDir(root), { recursive: true });
-    fs15.writeFileSync(snapshotPath(root), stableStringify(snapshot, 0));
+    fs16.mkdirSync(cacheDir(root), { recursive: true });
+    fs16.writeFileSync(snapshotPath(root), stableStringify(snapshot, 0));
   } catch {
   }
 }
 function loadSnapshot(root) {
   try {
-    const loaded = JSON.parse(fs15.readFileSync(snapshotPath(root), "utf8"));
+    const loaded = JSON.parse(fs16.readFileSync(snapshotPath(root), "utf8"));
     if (loaded.version === SNAPSHOT_VERSION && loaded.files && typeof loaded.corpusHash === "string") {
       return { ...loaded, scope: loaded.scope ?? {} };
     }
@@ -2166,7 +2351,7 @@ function probeFreshness(root) {
     }
     let stat;
     try {
-      stat = fs15.statSync(file.abs);
+      stat = fs16.statSync(file.abs);
     } catch {
       drift.removed.push(file.rel);
       continue;
@@ -2174,7 +2359,7 @@ function probeFreshness(root) {
     if (stat.size === entry.size && stat.mtimeMs === entry.mtimeMs) continue;
     let hash = "";
     try {
-      hash = hashBytes(fs15.readFileSync(file.abs));
+      hash = hashBytes(fs16.readFileSync(file.abs));
     } catch {
       drift.removed.push(file.rel);
       continue;
@@ -2191,7 +2376,7 @@ function probeFreshness(root) {
   }
   if (absorbed && !hasDrift(drift)) {
     try {
-      fs15.writeFileSync(snapshotPath(root), stableStringify(snapshot, 0));
+      fs16.writeFileSync(snapshotPath(root), stableStringify(snapshot, 0));
     } catch {
     }
   }
@@ -2272,10 +2457,10 @@ function testsToRun(graph, rootId, depth = 4) {
   };
 }
 function detectRunner(root, lang) {
-  const pkgPath = path17.join(root, "package.json");
-  if (fs15.existsSync(pkgPath)) {
+  const pkgPath = path18.join(root, "package.json");
+  if (fs16.existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(fs15.readFileSync(pkgPath, "utf8"));
+      const pkg = JSON.parse(fs16.readFileSync(pkgPath, "utf8"));
       const deps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (deps.vitest) return { name: "vitest", command: (f) => `npx vitest run ${f.join(" ")}`.trim() };
       if (deps.jest) return { name: "jest", command: (f) => `npx jest ${f.join(" ")}`.trim() };
@@ -2283,10 +2468,10 @@ function detectRunner(root, lang) {
     } catch {
     }
   }
-  if (lang === "py" || fs15.existsSync(path17.join(root, "pyproject.toml")) || fs15.existsSync(path17.join(root, "pytest.ini"))) {
+  if (lang === "py" || fs16.existsSync(path18.join(root, "pyproject.toml")) || fs16.existsSync(path18.join(root, "pytest.ini"))) {
     return { name: "pytest", command: (f) => `pytest ${f.join(" ")}`.trim() };
   }
-  if (lang === "go" || fs15.existsSync(path17.join(root, "go.mod"))) {
+  if (lang === "go" || fs16.existsSync(path18.join(root, "go.mod"))) {
     return { name: "go test", command: () => "go test ./..." };
   }
   if (lang === "cs" || hasFile(root, /\.csproj$/) || hasFile(root, /\.sln$/)) {
@@ -2297,16 +2482,16 @@ function detectRunner(root, lang) {
 }
 function hasFile(root, re) {
   try {
-    return fs15.readdirSync(root).some((f) => re.test(f));
+    return fs16.readdirSync(root).some((f) => re.test(f));
   } catch {
     return false;
   }
 }
 function findGitRoot(startDir = process.cwd()) {
-  let dir = path17.resolve(startDir);
+  let dir = path18.resolve(startDir);
   for (; ; ) {
-    if (fs15.existsSync(path17.join(dir, ".git"))) return dir;
-    const parent = path17.dirname(dir);
+    if (fs16.existsSync(path18.join(dir, ".git"))) return dir;
+    const parent = path18.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -2317,19 +2502,19 @@ function normalizeEntry(line) {
 function ensureGitignored(entry, startDir = process.cwd()) {
   const root = findGitRoot(startDir);
   if (!root) return { status: "not-a-repo", entry };
-  const gitignorePath = path17.join(root, ".gitignore");
+  const gitignorePath = path18.join(root, ".gitignore");
   const target = normalizeEntry(entry);
   let existing = "";
   let fileExisted = true;
   try {
-    existing = fs15.readFileSync(gitignorePath, "utf8");
+    existing = fs16.readFileSync(gitignorePath, "utf8");
   } catch {
     fileExisted = false;
   }
   const alreadyPresent = existing.split(/\r?\n/).some((line) => normalizeEntry(line) === target);
   if (alreadyPresent) return { status: "present", entry, gitignorePath };
   const needsLeadingNewline = existing.length > 0 && !existing.endsWith("\n");
-  fs15.appendFileSync(gitignorePath, `${needsLeadingNewline ? "\n" : ""}${entry}
+  fs16.appendFileSync(gitignorePath, `${needsLeadingNewline ? "\n" : ""}${entry}
 `, "utf8");
   return { status: fileExisted ? "added" : "created", entry, gitignorePath };
 }
@@ -2483,14 +2668,14 @@ dsnCommand.command("create").description("Create a new DSN token").option("--ing
     console.log(chalk.dim("The secret must be registered on your Vibgrate ingest API."));
   }
   if (opts.write) {
-    const writePath = path17.resolve(opts.write);
+    const writePath = path18.resolve(opts.write);
     await writeTextFile(writePath, dsn + "\n");
     console.log("");
     console.log(chalk.green("\u2714") + ` DSN written to ${opts.write}`);
-    const root = findGitRoot(path17.dirname(writePath));
-    const rel2 = root ? path17.relative(root, writePath).split(path17.sep).join("/") : "";
+    const root = findGitRoot(path18.dirname(writePath));
+    const rel2 = root ? path18.relative(root, writePath).split(path18.sep).join("/") : "";
     if (root && rel2 && !rel2.startsWith("..")) {
-      const res = ensureGitignored(rel2, path17.dirname(writePath));
+      const res = ensureGitignored(rel2, path18.dirname(writePath));
       if (res.status === "created") {
         console.log(chalk.green("\u2714") + ` Created .gitignore and ignored ${rel2}`);
       } else if (res.status === "added") {
@@ -2508,30 +2693,30 @@ dsnCommand.command("create").description("Create a new DSN token").option("--ing
 var STORE_DIRNAME = ".vibgrate";
 var STORE_FILENAME = "credentials.json";
 function homeCredentialsPath() {
-  return path17.join(os.homedir(), STORE_DIRNAME, STORE_FILENAME);
+  return path18.join(os.homedir(), STORE_DIRNAME, STORE_FILENAME);
 }
 function projectCredentialsPath(cwd = process.cwd()) {
   const root = findGitRoot(cwd) ?? cwd;
-  return path17.join(root, STORE_DIRNAME, STORE_FILENAME);
+  return path18.join(root, STORE_DIRNAME, STORE_FILENAME);
 }
 function credentialsPath(opts = {}) {
   const override = process.env.VIBGRATE_CREDENTIALS?.trim();
-  if (override) return path17.resolve(override);
+  if (override) return path18.resolve(override);
   const local = projectCredentialsPath(opts.cwd);
   if (opts.local) return local;
-  if (fs15.existsSync(local)) return local;
+  if (fs16.existsSync(local)) return local;
   return homeCredentialsPath();
 }
 function gitignoreEntryForCredentials(repoRoot, credsFile = credentialsPath()) {
-  const rel2 = path17.relative(repoRoot, credsFile);
-  if (rel2 && !rel2.startsWith("..") && !path17.isAbsolute(rel2)) {
-    return rel2.split(path17.sep).join("/");
+  const rel2 = path18.relative(repoRoot, credsFile);
+  if (rel2 && !rel2.startsWith("..") && !path18.isAbsolute(rel2)) {
+    return rel2.split(path18.sep).join("/");
   }
   return `${STORE_DIRNAME}/${STORE_FILENAME}`;
 }
 function readStoredCredentials(opts = {}) {
   try {
-    const raw = fs15.readFileSync(credentialsPath(opts), "utf8");
+    const raw = fs16.readFileSync(credentialsPath(opts), "utf8");
     const parsed = JSON.parse(raw);
     return parsed && typeof parsed.dsn === "string" && parsed.dsn ? parsed : null;
   } catch {
@@ -2540,16 +2725,16 @@ function readStoredCredentials(opts = {}) {
 }
 function writeStoredCredentials(creds, opts = {}) {
   const file = credentialsPath(opts);
-  fs15.mkdirSync(path17.dirname(file), { recursive: true });
-  fs15.writeFileSync(file, JSON.stringify(creds, null, 2) + "\n", { encoding: "utf8", mode: 384 });
+  fs16.mkdirSync(path18.dirname(file), { recursive: true });
+  fs16.writeFileSync(file, JSON.stringify(creds, null, 2) + "\n", { encoding: "utf8", mode: 384 });
   try {
-    fs15.chmodSync(file, 384);
+    fs16.chmodSync(file, 384);
   } catch {
   }
 }
 function clearStoredCredentials(opts = {}) {
   try {
-    fs15.rmSync(credentialsPath(opts));
+    fs16.rmSync(credentialsPath(opts));
     return true;
   } catch {
     return false;
@@ -2920,7 +3105,7 @@ var pushCommand = new Command("push").description("Push scan results to Vibgrate
     if (opts.strict) process.exit(1);
     return;
   }
-  const filePath = path17.resolve(opts.file);
+  const filePath = path18.resolve(opts.file);
   if (!await pathExists(filePath)) {
     console.error(chalk.red(`Scan artifact not found: ${filePath}`));
     console.error(chalk.dim('Run "vibgrate scan" first.'));
@@ -3015,7 +3200,7 @@ function measure(root, files) {
   for (const rel2 of files) {
     let size;
     try {
-      size = fs15.statSync(path17.join(root, rel2)).size;
+      size = fs16.statSync(path18.join(root, rel2)).size;
     } catch {
       continue;
     }
@@ -3038,9 +3223,9 @@ function matchLines(text, needleLower) {
 }
 function readCandidate(abs, knownSize) {
   try {
-    const size = knownSize ?? fs15.statSync(abs).size;
+    const size = knownSize ?? fs16.statSync(abs).size;
     if (size > MAX_FILE_BYTES) return null;
-    const text = fs15.readFileSync(abs, "utf8");
+    const text = fs16.readFileSync(abs, "utf8");
     return text.includes(NUL) ? null : text;
   } catch {
     return null;
@@ -3051,7 +3236,7 @@ function scanInline(root, files, needleLower, cap, stopAtCap, sizes) {
   let total = 0;
   let truncated = false;
   for (const rel2 of files) {
-    const text = readCandidate(path17.join(root, rel2), sizes?.get(rel2));
+    const text = readCandidate(path18.join(root, rel2), sizes?.get(rel2));
     if (text === null) continue;
     for (const h of matchLines(text, needleLower)) {
       total++;
@@ -3118,12 +3303,12 @@ var WORKER_SOURCE = [
   "parentPort.postMessage({ hits, total, truncated });"
 ].join("\n");
 function runWorker(root, files, needleLower) {
-  return new Promise((resolve11, reject) => {
+  return new Promise((resolve12, reject) => {
     const w = new Worker(WORKER_SOURCE, { eval: true, workerData: { root, files, needleLower } });
     let settled = false;
     w.once("message", (m) => {
       settled = true;
-      resolve11(m);
+      resolve12(m);
     });
     w.once("error", reject);
     w.once("exit", (code) => {
@@ -3192,10 +3377,10 @@ var BINARY_EXTS = /* @__PURE__ */ new Set([
   ".pdf"
 ]);
 function hasBinaryExt(rel2) {
-  return BINARY_EXTS.has(path17.extname(rel2).toLowerCase());
+  return BINARY_EXTS.has(path18.extname(rel2).toLowerCase());
 }
-function toPosix3(rel2) {
-  return path17.sep === "\\" ? rel2.replaceAll("\\", "/") : rel2;
+function toPosix4(rel2) {
+  return path18.sep === "\\" ? rel2.replaceAll("\\", "/") : rel2;
 }
 async function searchSymbols(graph, root, query, limit) {
   let q = query.trim();
@@ -3334,13 +3519,13 @@ function walkCandidates(root) {
     const dir = stack.pop();
     let entries;
     try {
-      entries = fs15.readdirSync(dir, { withFileTypes: true });
+      entries = fs16.readdirSync(dir, { withFileTypes: true });
     } catch {
       continue;
     }
     for (const e of entries) {
       if (e.name.startsWith(".") || IGNORE_DIRS.has(e.name)) continue;
-      const abs = path17.join(dir, e.name);
+      const abs = path18.join(dir, e.name);
       if (e.isDirectory()) {
         stack.push(abs);
         continue;
@@ -3350,7 +3535,7 @@ function walkCandidates(root) {
         truncated = true;
         continue;
       }
-      files.push(toPosix3(path17.relative(root, abs)));
+      files.push(toPosix4(path18.relative(root, abs)));
     }
   }
   files.sort();
@@ -3381,11 +3566,11 @@ function ripgrepCandidates(root, needle) {
   if (files.length > MAX_FILES_SCANNED) return { files: files.slice(0, MAX_FILES_SCANNED), truncated: true };
   return { files, truncated: false };
 }
-function parseRgFileList(stdout, sep8 = path17.sep) {
+function parseRgFileList(stdout, sep9 = path18.sep) {
   const seen = /* @__PURE__ */ new Set();
   for (const raw of stdout.split("\n")) {
     if (!raw) continue;
-    const posix = sep8 === "\\" ? raw.replaceAll("\\", "/") : raw;
+    const posix = sep9 === "\\" ? raw.replaceAll("\\", "/") : raw;
     const rel2 = posix.startsWith("./") ? posix.slice(2) : posix;
     if (!rel2) continue;
     const segs = rel2.split("/");
@@ -3397,8 +3582,8 @@ function parseRgFileList(stdout, sep8 = path17.sep) {
 }
 function readScanArtifact(root) {
   try {
-    const file = path17.join(root, ".vibgrate", "scan_result.json");
-    return JSON.parse(fs15.readFileSync(file, "utf8"));
+    const file = path18.join(root, ".vibgrate", "scan_result.json");
+    return JSON.parse(fs16.readFileSync(file, "utf8"));
   } catch {
     return null;
   }
@@ -3788,7 +3973,7 @@ var CACHE_VERSION = "vg-hosted-docs/1";
 var HOSTED_DOCS_TTL_MS = 24 * 60 * 60 * 1e3;
 var MAX_ENTRIES = 64;
 function cachePath(root) {
-  return path17.join(cacheDir(root), "hosted-docs.json");
+  return path18.join(cacheDir(root), "hosted-docs.json");
 }
 function hostedDocsCacheKey(req, opts = {}) {
   const material = JSON.stringify([
@@ -3804,7 +3989,7 @@ function hostedDocsCacheKey(req, opts = {}) {
 }
 function loadFile(root) {
   try {
-    const parsed = JSON.parse(fs15.readFileSync(cachePath(root), "utf8"));
+    const parsed = JSON.parse(fs16.readFileSync(cachePath(root), "utf8"));
     if (parsed && parsed.version === CACHE_VERSION && parsed.entries && typeof parsed.entries === "object") return parsed;
   } catch {
   }
@@ -3818,8 +4003,8 @@ function saveFile(root, file) {
         delete file.entries[k];
       }
     }
-    fs15.mkdirSync(cacheDir(root), { recursive: true });
-    fs15.writeFileSync(cachePath(root), JSON.stringify(file));
+    fs16.mkdirSync(cacheDir(root), { recursive: true });
+    fs16.writeFileSync(cachePath(root), JSON.stringify(file));
   } catch {
   }
 }
@@ -4794,12 +4979,12 @@ function detectAssistants(root, opts = {}) {
   const which = opts.which ?? whichOnPath;
   const found = [];
   for (const assistant of ASSISTANTS) {
-    const repoHit = (assistant.markers ?? []).find((m) => fs15.existsSync(path17.join(root, m)));
+    const repoHit = (assistant.markers ?? []).find((m) => fs16.existsSync(path18.join(root, m)));
     if (repoHit) {
       found.push({ assistant, via: "repo", marker: repoHit });
       continue;
     }
-    const homeHit = (assistant.homeMarkers ?? []).find((m) => fs15.existsSync(path17.join(home, m)));
+    const homeHit = (assistant.homeMarkers ?? []).find((m) => fs16.existsSync(path18.join(home, m)));
     if (homeHit) {
       found.push({ assistant, via: "home", marker: homeHit });
       continue;
@@ -4831,19 +5016,19 @@ function installAssistant(a, opts) {
   const skipped = [];
   let note;
   if (a.skill) {
-    writeFileEnsured(path17.join(opts.root, a.skill), skillMarkdown(a.id));
+    writeFileEnsured(path18.join(opts.root, a.skill), skillMarkdown(a.id));
     wrote.push(a.skill);
   }
   if (a.mcp) {
     const launch = opts.launch ?? detectServeLaunch();
-    upsertMcp(path17.join(opts.root, a.mcp.file), a.mcp, launch);
+    upsertMcp(path18.join(opts.root, a.mcp.file), a.mcp, launch);
     wrote.push(a.mcp.file);
     note = launch.note;
   } else {
     skipped.push("mcp (host-specific setup)");
   }
   if (a.nudge && opts.hook !== false) {
-    writeNudge(path17.join(opts.root, a.nudge.file), a.nudge, opts.smallRepo, a.id);
+    writeNudge(path18.join(opts.root, a.nudge.file), a.nudge, opts.smallRepo, a.id);
     wrote.push(a.nudge.file);
   } else if (a.nudge) {
     skipped.push("nudge (--no-hook)");
@@ -4853,41 +5038,41 @@ function installAssistant(a, opts) {
 function uninstallAssistant(a, root, purge) {
   const removed = [];
   if (a.mcp) {
-    const file = path17.join(root, a.mcp.file);
+    const file = path18.join(root, a.mcp.file);
     if (removeMcp(file, a.mcp)) removed.push(a.mcp.file);
   }
   if (a.nudge) {
-    const file = path17.join(root, a.nudge.file);
+    const file = path18.join(root, a.nudge.file);
     if (a.nudge.kind === "block") {
       if (removeBlock(file)) removed.push(a.nudge.file);
-    } else if (fs15.existsSync(file)) {
-      fs15.rmSync(file);
+    } else if (fs16.existsSync(file)) {
+      fs16.rmSync(file);
       removed.push(a.nudge.file);
     }
   }
   if (purge && a.skill) {
-    const file = path17.join(root, a.skill);
-    if (fs15.existsSync(file)) {
-      fs15.rmSync(file);
+    const file = path18.join(root, a.skill);
+    if (fs16.existsSync(file)) {
+      fs16.rmSync(file);
       removed.push(a.skill);
     }
   }
   return removed;
 }
 function writeFileEnsured(file, content) {
-  fs15.mkdirSync(path17.dirname(file), { recursive: true });
-  fs15.writeFileSync(file, content);
+  fs16.mkdirSync(path18.dirname(file), { recursive: true });
+  fs16.writeFileSync(file, content);
 }
 function writeNavigationConfig(root) {
   ensureVibgrateGitignore(root);
-  const rel2 = path17.join(".vibgrate", "mcp-navigation.json");
+  const rel2 = path18.join(".vibgrate", "mcp-navigation.json");
   const doc = {
     _readme: "Deferred-loading config for agents embedding `vg serve` via the Claude API (defer_loading + tool-search). The hot navigation core stays in context; the rest load on demand \u2014 ~350-450 schema tokens/step vs ~1,881 for the full set. Hosts without defer_loading ignore this and serve the whole (already optimized) tool set. See docs/graph/VG-NAVIGATION-PROFILE.md.",
     hot_core: [...HOT_TOOLS],
     deferred: deferredToolNames(),
     toolset: navigationToolsetConfig()
   };
-  writeFileEnsured(path17.join(root, rel2), `${JSON.stringify(doc, null, 2)}
+  writeFileEnsured(path18.join(root, rel2), `${JSON.stringify(doc, null, 2)}
 `);
   return rel2;
 }
@@ -4902,7 +5087,7 @@ function upsertMcp(file, target, launch) {
 `);
 }
 function removeMcp(file, target) {
-  if (!fs15.existsSync(file)) return false;
+  if (!fs16.existsSync(file)) return false;
   const config = readJson(file);
   const bag = config[target.key];
   if (!bag || !(bag.vg !== void 0)) return false;
@@ -4921,8 +5106,8 @@ function refreshInstalledInstructions(root, smallRepo) {
   };
   for (const a of ASSISTANTS) {
     if (a.skill) {
-      const file = path17.join(root, a.skill);
-      if (fs15.existsSync(file)) {
+      const file = path18.join(root, a.skill);
+      if (fs16.existsSync(file)) {
         const text = readTextSafe(file);
         const from = text === null ? null : staleVersion(text, "# vg \u2014 the code map");
         if (from !== null) {
@@ -4932,8 +5117,8 @@ function refreshInstalledInstructions(root, smallRepo) {
       }
     }
     if (a.nudge) {
-      const file = path17.join(root, a.nudge.file);
-      if (!fs15.existsSync(file)) continue;
+      const file = path18.join(root, a.nudge.file);
+      if (!fs16.existsSync(file)) continue;
       const text = readTextSafe(file);
       if (text === null) continue;
       if (a.nudge.kind === "block") {
@@ -4957,7 +5142,7 @@ function refreshInstalledInstructions(root, smallRepo) {
 }
 function readTextSafe(file) {
   try {
-    return fs15.readFileSync(file, "utf8");
+    return fs16.readFileSync(file, "utf8");
   } catch {
     return null;
   }
@@ -4976,8 +5161,8 @@ ${stripMarkers(nudgeMarkdown(smallRepo, client))}` : stripMarkers(nudgeMarkdown(
   upsertBlock(file, nudgeMarkdown(smallRepo, client));
 }
 function upsertBlock(file, block) {
-  fs15.mkdirSync(path17.dirname(file), { recursive: true });
-  let existing = fs15.existsSync(file) ? fs15.readFileSync(file, "utf8") : "";
+  fs16.mkdirSync(path18.dirname(file), { recursive: true });
+  let existing = fs16.existsSync(file) ? fs16.readFileSync(file, "utf8") : "";
   const re = new RegExp(`${escapeRe(NUDGE_BEGIN)}[\\s\\S]*?${escapeRe(NUDGE_END)}`);
   if (re.test(existing)) existing = existing.replace(re, block);
   else existing = existing.length ? `${existing.replace(/\s*$/, "")}
@@ -4985,20 +5170,20 @@ function upsertBlock(file, block) {
 ${block}
 ` : `${block}
 `;
-  fs15.writeFileSync(file, existing);
+  fs16.writeFileSync(file, existing);
 }
 function removeBlock(file) {
-  if (!fs15.existsSync(file)) return false;
-  const existing = fs15.readFileSync(file, "utf8");
+  if (!fs16.existsSync(file)) return false;
+  const existing = fs16.readFileSync(file, "utf8");
   const re = new RegExp(`\\n*${escapeRe(NUDGE_BEGIN)}[\\s\\S]*?${escapeRe(NUDGE_END)}\\n*`);
   if (!re.test(existing)) return false;
-  fs15.writeFileSync(file, existing.replace(re, "\n"));
+  fs16.writeFileSync(file, existing.replace(re, "\n"));
   return true;
 }
 function readJson(file) {
-  if (!fs15.existsSync(file)) return {};
+  if (!fs16.existsSync(file)) return {};
   try {
-    const parsed = JSON.parse(fs15.readFileSync(file, "utf8"));
+    const parsed = JSON.parse(fs16.readFileSync(file, "utf8"));
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       return parsed;
     }
@@ -5018,7 +5203,7 @@ function escapeRe(s) {
 }
 var REFRESH_LOCK_STALE_MS = 10 * 60 * 1e3;
 function refreshLockPath(root) {
-  return path17.join(cacheDir(root), "refresh.lock");
+  return path18.join(cacheDir(root), "refresh.lock");
 }
 async function refreshIfStale(root, opts = {}) {
   const probe = probeFreshness(root);
@@ -5050,8 +5235,8 @@ async function refreshIfStale(root, opts = {}) {
       writeArtifacts(result.graph, {
         root,
         graphPath: opts.graphPath,
-        report: fs15.existsSync(path17.join(dir, "GRAPH_REPORT.md")),
-        html: fs15.existsSync(path17.join(dir, "graph.html"))
+        report: fs16.existsSync(path18.join(dir, "GRAPH_REPORT.md")),
+        html: fs16.existsSync(path18.join(dir, "graph.html"))
       });
     }
     writeSnapshot(root, result.graph.provenance.corpusHash, result.fileStats, scope);
@@ -5071,6 +5256,6 @@ async function refreshIfStale(root, opts = {}) {
   }
 }
 
-export { ASSISTANTS, CliError, ExitCode, FREE_PACK, NPX_INVOCATION, ResourceLimitError, SCHEMA_VERSION, SKIP_DIRS, SKIP_FILES, SMALL_REPO_FILES, TOOLS, UsageError, analyze, applyCoverage, assessDocQuality, assistantById, availableRegionIds, buildFacts, buildGraph, clearStoredCredentials, countTokens, coveringTests, createWorkspaceDsn, credentialsPath, dashHostForIngestHost, decodeScipIndex, detectAssistants, detectRunner, detectServeLaunch, discover, driftCount, dsnCommand, ensureGitignored, epistemicBreakdown, fetchHostedDocsCached, findGitRoot, gitignoreEntryForCredentials, groundGraph, hasDrift, homeCredentialsPath, hostedBase, ingestHostForRegionId, installAssistant, loadCoverage, loadSnapshot, parseDsn, probeFreshness, projectCredentialsPath, publishPrivateLibrary, pushCommand, readScanArtifact, readStoredCredentials, refreshIfStale, refreshInstalledInstructions, renderToolResult, resolveCliInvocation, resolveDsn, resolveIngestHost, resolveLimits, scipEdges, searchSymbols, selectForBudget, shortestPath, symbolsFromApi, testsToRun, uninstallAssistant, uploadScanArtifact, usageError, verifyDeterminism, warmEmbedderInBackground, writeNavigationConfig, writeSnapshot, writeStoredCredentials };
-//# sourceMappingURL=chunk-S6CYDZEW.js.map
-//# sourceMappingURL=chunk-S6CYDZEW.js.map
+export { ASSISTANTS, CliError, ExitCode, FREE_PACK, NPX_INVOCATION, ResourceLimitError, SKIP_DIRS, SKIP_FILES, SMALL_REPO_FILES, TOOLS, UsageError, analyze, applyCoverage, assessDocQuality, assistantById, availableRegionIds, buildFacts, buildGraph, clearStoredCredentials, countTokens, coveringTests, createWorkspaceDsn, credentialsPath, dashHostForIngestHost, decodeScipIndex, detectAssistants, detectRunner, detectServeLaunch, discover, driftCount, dsnCommand, ensureGitignored, epistemicBreakdown, fetchHostedDocsCached, findGitRoot, gitignoreEntryForCredentials, groundGraph, hasDrift, homeCredentialsPath, hostedBase, ingestHostForRegionId, installAssistant, loadCoverage, loadSnapshot, parseDsn, probeFreshness, projectCredentialsPath, publishPrivateLibrary, pushCommand, readScanArtifact, readStoredCredentials, refreshIfStale, refreshInstalledInstructions, renderToolResult, resolveCliInvocation, resolveDsn, resolveIngestHost, resolveLimits, scipEdges, searchSymbols, selectForBudget, shortestPath, symbolsFromApi, testsToRun, uninstallAssistant, uploadScanArtifact, usageError, verifyDeterminism, warmEmbedderInBackground, writeNavigationConfig, writeSnapshot, writeStoredCredentials };
+//# sourceMappingURL=chunk-KNELIQJO.js.map
+//# sourceMappingURL=chunk-KNELIQJO.js.map