@fenglimg/fabric-server 2.3.0-rc.2 → 2.3.0-rc.4

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/index.ts
-import { existsSync as existsSync9 } from "fs";
-import { readFile as readFile20 } from "fs/promises";
-import { join as join24, resolve as resolve4 } from "path";
+import { existsSync as existsSync10 } from "fs";
+import { readFile as readFile21 } from "fs/promises";
+import { join as join26, resolve as resolve4 } from "path";
 import { fileURLToPath } from "url";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -820,9 +820,10 @@ function readOrphanDemoteThresholdDays(projectRoot) {
 function readFusion(projectRoot) {
   try {
     const raw = readFabricConfig(projectRoot).fusion;
-    return raw === "rrf" ? "rrf" : "additive";
+    if (raw === "rrf" || raw === "additive") return raw;
+    return "auto";
   } catch {
-    return "additive";
+    return "auto";
   }
 }
 function readConflictLintThreshold(projectRoot) {
@@ -892,7 +893,7 @@ async function awaitFirstReconcileGate(timeoutMs = 5e3) {
 
 // src/services/extract-knowledge.ts
 import { existsSync as existsSync3 } from "fs";
-import { readFile as readFile4 } from "fs/promises";
+import { readFile as readFile5 } from "fs/promises";
 import { join as join7 } from "path";
 import {
   PROPOSED_REASON_DESCRIPTIONS_BY_LOCALE
@@ -900,6 +901,8 @@ import {
 import { hasSecrets, isPersonalScope, redactPii, resolveGlobalLocale } from "@fenglimg/fabric-shared";
 
 // src/services/cross-store-write.ts
+import { createHash as createHash2 } from "crypto";
+import { readFile as readFile3 } from "fs/promises";
 import { join as join5 } from "path";
 import {
   STORE_LAYOUT,
@@ -915,6 +918,7 @@ import {
   PersonalScopeLeakError,
   StoreWriteTargetUnresolvedError
 } from "@fenglimg/fabric-shared/errors";
+import { withFileLock as withFileLock2 } from "@fenglimg/fabric-shared/node/atomic-write";
 function writeTargetUnresolved(scope, layer) {
   const actionHint = layer === "personal" ? "run `fabric install --global` to mint your personal store, then retry" : `mount + bind a shared store, then set an explicit route: \`fabric store switch-write <alias> --scope ${scope}\``;
   return new StoreWriteTargetUnresolvedError(
@@ -977,7 +981,7 @@ function resolveWriteScopeMeta(layer, projectRoot, semanticScope) {
 }
 
 // src/services/cross-store-recall.ts
-import { readFile as readFile3, stat } from "fs/promises";
+import { readFile as readFile4, stat } from "fs/promises";
 import { join as join6 } from "path";
 import {
   buildStoreResolveInput as buildStoreResolveInput2,
@@ -1349,7 +1353,7 @@ async function walkReadSetStoresUncached(snapshot) {
   const entries = await Promise.all(snapshot.refs.map(async (ref) => {
     let source;
     try {
-      source = await readFile3(ref.file, "utf8");
+      source = await readFile4(ref.file, "utf8");
     } catch {
       return null;
     }
@@ -1621,6 +1625,144 @@ function serializeBm25Model(model) {
 function rehydrateBm25Model(serialized) {
   return modelFromStats(serialized);
 }
+var SYNONYM_PAIRS = {
+  // Code / engineering actions
+  refactor: ["restructure", "rewrite", "redesign", "reorganize", "clean", "rework"],
+  optimize: ["improve", "speed-up", "tune", "accelerate", "perf", "performance"],
+  debug: ["fix", "troubleshoot", "diagnose", "investigate", "resolve", "correct"],
+  migrate: ["port", "move", "transfer", "upgrade", "transition", "convert"],
+  "set up": ["init", "initialize", "configure", "bootstrap", "install", "onboard"],
+  implement: ["add", "build", "create", "develop", "write", "introduce", "introduce"],
+  // Architecture / design
+  architecture: ["design", "structure", "layout", "organization", "pattern", "system"],
+  "data model": ["schema", "entity", "type", "structure", "contract", "shape"],
+  // Quality / correctness
+  test: ["verify", "validate", "assert", "check", "spec", "coverage"],
+  lint: ["check", "validate", "audit", "inspect", "analyze"],
+  // Communication / impact
+  documentation: ["docs", "readme", "guide", "spec", "explanation", "reference"],
+  decision: ["adr", "rationale", "why", "motivation", "reason", "trade-off"],
+  // Change management
+  release: ["deploy", "ship", "publish", "cut", "version", "tag"],
+  rollback: ["revert", "undo", "back-out", "backout", "restore"],
+  // Containers / infra
+  container: ["docker", "image", "oci", "cri-o"],
+  deploy: ["release", "rollout", "ship", "publish", "promote"],
+  // Project / process
+  on_boarding: ["getting-started", "quickstart", "newcomer", "new-hire", "first-time"],
+  best_practice: ["convention", "guideline", "standard", "rule", "recommendation"],
+  // Tech stacks
+  api: ["endpoint", "route", "service", "interface", "rpc", "rest"],
+  typescript: ["ts", "types", "type-safe"],
+  react: ["jsx", "tsx", "component", "ui"],
+  node: ["nodejs", "runtime", "backend", "server"],
+  database: ["db", "sql", "nosql", "storage", "persistence"]
+};
+var STEMMING_PATTERNS = [
+  { suffix: "e", alternatives: ["es", "ed", "ing", "ation"] },
+  { suffix: "y", alternatives: ["ies", "ied", "ying"] }
+  // Catch-all for non-verb / already-stemmed query terms: no-op by default.
+];
+var DEFAULT_IDF_WEIGHT = 1;
+var COMMON_TERMS = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "the",
+  "and",
+  "or",
+  "but",
+  "in",
+  "on",
+  "at",
+  "to",
+  "for",
+  "of",
+  "with",
+  "by",
+  "from",
+  "as",
+  "is",
+  "it",
+  "at",
+  "be",
+  "do",
+  "has",
+  "have",
+  "was",
+  "are",
+  "been",
+  "this",
+  "that",
+  "these",
+  "those",
+  "will",
+  "can",
+  "may",
+  "would",
+  "could",
+  "should",
+  "does",
+  "not",
+  "no",
+  "if",
+  "so",
+  "up",
+  "out",
+  "all",
+  "each",
+  "every",
+  "both",
+  "some",
+  "any",
+  "such",
+  "only",
+  "own",
+  "same",
+  "too",
+  "very",
+  "just",
+  "about",
+  "over",
+  "than",
+  "then",
+  "also"
+]);
+function idfWeight(term) {
+  return COMMON_TERMS.has(term) ? 0.3 : DEFAULT_IDF_WEIGHT;
+}
+function expandQueryTerms(text) {
+  const baseTerms = tokenize(text);
+  const weighted = /* @__PURE__ */ new Map();
+  for (const term of baseTerms) {
+    const lower = term.toLowerCase();
+    const aliases = /* @__PURE__ */ new Set();
+    const syns = SYNONYM_PAIRS[lower];
+    if (syns !== void 0) {
+      for (const s of syns) aliases.add(s);
+    }
+    for (const [key, values] of Object.entries(SYNONYM_PAIRS)) {
+      if (values.includes(lower)) {
+        aliases.add(key);
+      }
+    }
+    for (const { suffix, alternatives } of STEMMING_PATTERNS) {
+      if (lower.endsWith(suffix) && lower.length > suffix.length) {
+        const stem = lower.slice(0, -suffix.length);
+        for (const alt of alternatives) {
+          aliases.add(stem + alt);
+        }
+      }
+    }
+    const originalWeight = idfWeight(lower);
+    weighted.set(term, originalWeight);
+    for (const alias of aliases) {
+      if (!weighted.has(alias)) {
+        weighted.set(alias, originalWeight * 0.5);
+      }
+    }
+  }
+  return weighted;
+}
 function buildQueryTerms(text) {
   return tokenize(text);
 }
@@ -2020,7 +2162,7 @@ async function extractKnowledge(projectRoot, input) {
   const writeScopeMeta = resolveWriteScopeMeta(layer, projectRoot, semanticScope);
   await ensureParentDirectory(absolutePath);
   if (existsSync3(absolutePath)) {
-    const existing = await readFile4(absolutePath, "utf8");
+    const existing = await readFile5(absolutePath, "utf8");
     const existingKey = readFrontmatterKey(existing, "x-fabric-idempotency-key");
     if (existingKey === effectiveIdempotencyKey) {
       const fresh2 = renderFreshEntry({
@@ -2153,7 +2295,7 @@ async function resolveDisambiguatedSlugPath(args) {
         idempotencyKey: candidateKey
       };
     }
-    const existing = await readFile4(candidatePath, "utf8");
+    const existing = await readFile5(candidatePath, "utf8");
     const existingKey = readFrontmatterKey(existing, "x-fabric-idempotency-key");
     if (existingKey === candidateKey) {
       return {
@@ -2751,12 +2893,24 @@ var LEDGER_DUAL_WRITE_METRIC_NAMES = {
 };
 
 // src/services/plan-context.ts
-import { mkdir as mkdir4, readFile as readFile5, writeFile as writeFile2 } from "fs/promises";
-import { join as join9 } from "path";
+import { mkdir as mkdir4, readFile as readFile6, writeFile as writeFile2 } from "fs/promises";
+import { join as join10 } from "path";
 
 // src/services/vector-retrieval.ts
+import { mkdirSync } from "fs";
+import { createRequire } from "module";
+import { join as join9 } from "path";
+import { resolveGlobalRoot as resolveGlobalRoot3 } from "@fenglimg/fabric-shared";
 var embedderLoad;
 var OPTIONAL_EMBED_PACKAGE = "fastembed";
+function isEmbedderResolvable() {
+  try {
+    createRequire(import.meta.url).resolve(OPTIONAL_EMBED_PACKAGE);
+    return true;
+  } catch {
+    return false;
+  }
+}
 var embedderModuleLoader = (name) => import(name);
 var MISSING_EMBEDDER_HINT = "[fabric] vector semantic recall is enabled but the optional 'fastembed' package is unavailable \u2014 falling back to text-only ranking. Install it where the server resolves modules (e.g. `npm i -g fastembed`) to enable embeddings, or set embed_enabled:false to silence this.\n";
 var defaultMissingEmbedderHint = () => {
@@ -2771,10 +2925,13 @@ function hintMissingEmbedderOnce() {
   missingEmbedderHinted = true;
   emitMissingEmbedderHint();
 }
+function defaultEmbedCacheDir() {
+  return join9(resolveGlobalRoot3(), "cache", "embed");
+}
 function buildEmbedInitOptions(modelName) {
   return {
     maxLength: 512,
-    cacheDir: process.env.FABRIC_EMBED_CACHE_DIR,
+    cacheDir: process.env.FABRIC_EMBED_CACHE_DIR ?? defaultEmbedCacheDir(),
     ...typeof modelName === "string" && modelName.length > 0 ? { model: modelName } : {}
   };
 }
@@ -2788,7 +2945,9 @@ async function loadEmbedder(modelName) {
           hintMissingEmbedderOnce();
           return null;
         }
-        const model = await mod.FlagEmbedding.init(buildEmbedInitOptions(modelName));
+        const initOpts = buildEmbedInitOptions(modelName);
+        mkdirSync(initOpts.cacheDir, { recursive: true });
+        const model = await mod.FlagEmbedding.init(initOpts);
         return {
           async embed(texts) {
             const out = [];
@@ -3157,11 +3316,11 @@ var bm25BuildCount = 0;
 var BM25_CACHE_DIR = ".fabric/cache/bm25";
 function bm25CachePath(projectRoot, revision) {
   const safe = revision.replace(/[^A-Za-z0-9_-]/g, "_");
-  return join9(projectRoot, BM25_CACHE_DIR, `${safe}.json`);
+  return join10(projectRoot, BM25_CACHE_DIR, `${safe}.json`);
 }
 async function loadBm25ModelFromDisk(projectRoot, revision) {
   try {
-    const raw = await readFile5(bm25CachePath(projectRoot, revision), "utf8");
+    const raw = await readFile6(bm25CachePath(projectRoot, revision), "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.version !== 1) return null;
     return rehydrateBm25Model(parsed);
@@ -3172,7 +3331,7 @@ async function loadBm25ModelFromDisk(projectRoot, revision) {
 async function saveBm25ModelToDisk(projectRoot, revision, model) {
   try {
     const path = bm25CachePath(projectRoot, revision);
-    await mkdir4(join9(projectRoot, BM25_CACHE_DIR), { recursive: true });
+    await mkdir4(join10(projectRoot, BM25_CACHE_DIR), { recursive: true });
     await writeFile2(path, JSON.stringify(serializeBm25Model(model)), "utf8");
   } catch {
   }
@@ -3271,7 +3430,13 @@ async function buildScoringContext(projectRoot, revision, rawItems, opts) {
       scoringContext.vectorWeight = embedConfig.weight;
     }
   }
-  scoringContext.fusion = readFusion(projectRoot);
+  const configuredFusion = readFusion(projectRoot);
+  const vectorActive = scoringContext.vectorScores !== void 0 && scoringContext.vectorScores.size > 0;
+  scoringContext.fusion = configuredFusion === "auto" ? vectorActive ? "rrf" : "additive" : configuredFusion;
+  let queryTermWeights;
+  if (scoringContext.queryTerms.length > 0) {
+    queryTermWeights = expandQueryTerms(opts.queryText);
+  }
   if (scoringContext.fusion === "rrf" && scoringContext.queryTerms.length > 0 && rawItems.length > 0) {
     const rankIds = rawItems.map((item) => item.stable_id).sort((a, b) => compareStableIds(a, b));
     if (scoringContext.bm25 !== void 0) {
@@ -3283,6 +3448,49 @@ async function buildScoringContext(projectRoot, revision, rawItems, opts) {
   }
   return scoringContext;
 }
+var PROXIMITY_WINDOW = 6;
+var PROXIMITY_BOOST_CAP = 0.15;
+function proximityBoost(item, context, contentScore2) {
+  if (contentScore2 <= 0) return 0;
+  const text = context.docTexts?.get(item.stable_id);
+  if (text === void 0 || text.length === 0) return 0;
+  const tokens = text.toLowerCase().split(/[^a-z0-9_$#]+/u).filter(Boolean);
+  const queryTerms = context.queryTerms;
+  if (queryTerms.length < 2) return 0;
+  const positions = /* @__PURE__ */ new Map();
+  for (const qt of queryTerms) {
+    const qtLower = qt.toLowerCase();
+    const pos = [];
+    for (let i = 0; i < tokens.length; i++) {
+      if (tokens[i] === qtLower) {
+        pos.push(i);
+      }
+    }
+    if (pos.length > 0) {
+      positions.set(qtLower, pos);
+    }
+  }
+  if (positions.size < 2) return 0;
+  const termList = [...positions.entries()];
+  let minDist = Infinity;
+  for (let i = 0; i < termList.length; i++) {
+    const [, posI] = termList[i];
+    for (let j = i + 1; j < termList.length; j++) {
+      const [, posJ] = termList[j];
+      for (const pi of posI) {
+        for (const pj of posJ) {
+          const dist = Math.abs(pi - pj);
+          if (dist < minDist) minDist = dist;
+        }
+      }
+    }
+  }
+  if (!Number.isFinite(minDist)) return 0;
+  if (minDist >= PROXIMITY_WINDOW) return 0;
+  const ratio = 1 - minDist / PROXIMITY_WINDOW;
+  const boost = contentScore2 * PROXIMITY_BOOST_CAP * ratio;
+  return boost;
+}
 function sortDescriptionItems(rawItems, scoringContext) {
   if (scoringContext === void 0) {
     return [...rawItems].sort((left, right) => compareStableIds(left.stable_id, right.stable_id)).map((item) => ({ item, score: 0 }));
@@ -3425,7 +3633,8 @@ function structuralScaleFor(context) {
 function scoreDescriptionItem(item, context) {
   const content = contentScore(item, context);
   const structural = salienceScore(item) + recencyBoost(item, context) + localityBoost(item, context);
-  return content + structuralScaleFor(context) * structural;
+  const proximity = proximityBoost(item, context, content);
+  return content + structuralScaleFor(context) * structural + proximity;
 }
 function scoreBreakdownForItem(item, context) {
   const hasQuery = context.queryTerms.length > 0;
@@ -3907,9 +4116,9 @@ import { enforcePayloadLimit as enforcePayloadLimit4 } from "@fenglimg/fabric-sh
 // src/services/review.ts
 import { execFileSync } from "child_process";
 import { existsSync as existsSync5 } from "fs";
-import { readFile as readFile7, readdir as readdir2, stat as stat2, unlink as unlink2 } from "fs/promises";
+import { readFile as readFile8, readdir as readdir2, stat as stat2, unlink as unlink2 } from "fs/promises";
 import { homedir } from "os";
-import { basename, isAbsolute, join as join11, relative, resolve as resolve2, sep as sep2 } from "path";
+import { basename, isAbsolute, join as join12, relative, resolve as resolve2, sep as sep2 } from "path";
 
 // src/services/promotion-gate.ts
 function toLocalId(id) {
@@ -3949,8 +4158,8 @@ import { allocateStoreKnowledgeId, isPersonalScope as isPersonalScope2 } from "@
 
 // src/services/pending-dedupe.ts
 import { existsSync as existsSync4 } from "fs";
-import { readdir, readFile as readFile6, unlink } from "fs/promises";
-import { join as join10 } from "path";
+import { readdir, readFile as readFile7, unlink } from "fs/promises";
+import { join as join11 } from "path";
 var PENDING_TYPES = ["decisions", "pitfalls", "guidelines", "models", "processes"];
 var DISAMBIGUATION_SUFFIX = /^(.+)-([2-9])\.md$/u;
 var SOURCE_SESSIONS_LINE = /^source_sessions:\s*\[(.*)\]\s*$/mu;
@@ -4023,7 +4232,7 @@ async function mergePendingTwins(projectRoot) {
       continue;
     }
     for (const type of PENDING_TYPES) {
-      const dir = join10(pendingBase2, type);
+      const dir = join11(pendingBase2, type);
       if (!existsSync4(dir)) continue;
       let names;
       try {
@@ -4044,10 +4253,10 @@ async function mergePendingTwins(projectRoot) {
         if (groupNames.length < 2) continue;
         const parsed = [];
         for (const name of groupNames) {
-          const abs = join10(dir, name);
+          const abs = join11(dir, name);
           let content;
           try {
-            content = await readFile6(abs, "utf8");
+            content = await readFile7(abs, "utf8");
           } catch {
             continue;
           }
@@ -4227,7 +4436,7 @@ async function listPending(projectRoot, filters) {
   }
   for (const source of sources) {
     for (const type of typesToScan) {
-      const dir = join11(source.root, type);
+      const dir = join12(source.root, type);
       if (!existsSync5(dir)) {
         continue;
       }
@@ -4239,10 +4448,10 @@ async function listPending(projectRoot, filters) {
       }
       for (const name of entries) {
         if (!name.endsWith(".md")) continue;
-        const absolutePath = join11(dir, name);
+        const absolutePath = join12(dir, name);
         let content;
         try {
-          content = await readFile7(absolutePath, "utf8");
+          content = await readFile8(absolutePath, "utf8");
         } catch {
           continue;
         }
@@ -4352,7 +4561,7 @@ async function approveOne(projectRoot, pendingPath) {
   let targetAbs;
   let writtenTarget = false;
   try {
-    const content = await readFile7(sourceAbs, "utf8");
+    const content = await readFile8(sourceAbs, "utf8");
     const fm = parseFrontmatter(content);
     const pluralType = fm.type;
     if (pluralType === void 0 || !PLURAL_TYPES.includes(pluralType)) {
@@ -4366,7 +4575,7 @@ async function approveOne(projectRoot, pendingPath) {
     );
     allocatedId = stableId;
     const newFilename = `${stableId}--${slug}.md`;
-    targetAbs = join11(resolveStoreCanonicalBase(layer, projectRoot), pluralType, newFilename);
+    targetAbs = join12(resolveStoreCanonicalBase(layer, projectRoot), pluralType, newFilename);
     await ensureParentDirectory(targetAbs);
     const rewritten = rewriteFrontmatterMerge(
       rewriteFrontmatterForPromote(content, stableId),
@@ -4424,7 +4633,7 @@ async function rejectAll(projectRoot, pendingPaths, reason) {
     try {
       const sandboxed = resolveSandboxedPath(projectRoot, pendingPath, { allowPersonal: true });
       if (existsSync5(sandboxed.abs)) {
-        const content = await readFile7(sandboxed.abs, "utf8");
+        const content = await readFile8(sandboxed.abs, "utf8");
         const merged = rewriteFrontmatterMerge(content, { status: "rejected" });
         const rejectedAbs = sandboxed.abs.includes(`${sep2}pending${sep2}`) ? sandboxed.abs.replace(`${sep2}pending${sep2}`, `${sep2}rejected${sep2}`) : null;
         if (rejectedAbs !== null) {
@@ -4451,7 +4660,7 @@ async function modifyEntry(projectRoot, pendingPath, changes) {
   if (target === null) {
     throw new Error(`modify target not found: ${pendingPath}`);
   }
-  const content = await readFile7(target.absPath, "utf8");
+  const content = await readFile8(target.absPath, "utf8");
   const fm = parseFrontmatter(content);
   const currentLayer = fm.layer ?? "team";
   if (fm.maturity === "verified" && changes.maturity === "proven" && fm.id !== void 0) {
@@ -4553,7 +4762,7 @@ async function modifyLayerFlip(projectRoot, target, content, fm, changes) {
     pluralType,
     resolveWriteTargetStoreDir(toLayer, projectRoot)
   );
-  const toAbs = join11(
+  const toAbs = join12(
     resolveStoreCanonicalBase(toLayer, projectRoot),
     pluralType,
     `${newStableId}--${slug}.md`
@@ -4653,7 +4862,7 @@ function getSearchDirectoryCache(cacheKey) {
   return created;
 }
 async function listIndexedSearchEntries(source, type) {
-  const dir = join11(source.root, type);
+  const dir = join12(source.root, type);
   let entries;
   try {
     entries = await readdir2(dir);
@@ -4666,7 +4875,7 @@ async function listIndexedSearchEntries(source, type) {
   const indexed = [];
   for (const name of entries) {
     if (!name.endsWith(".md")) continue;
-    const absolutePath = join11(dir, name);
+    const absolutePath = join12(dir, name);
     let fingerprint;
     try {
       const st = await stat2(absolutePath);
@@ -4683,7 +4892,7 @@ async function listIndexedSearchEntries(source, type) {
     }
     let content;
     try {
-      content = await readFile7(absolutePath, "utf8");
+      content = await readFile8(absolutePath, "utf8");
       searchEntryIndexContentReads += 1;
     } catch {
       directoryCache.files.delete(absolutePath);
@@ -4852,7 +5061,7 @@ async function deferAll(projectRoot, pendingPaths, until, reason) {
     try {
       const sandboxed = resolveSandboxedPath(projectRoot, pendingPath, { allowPersonal: true });
       if (existsSync5(sandboxed.abs)) {
-        const content = await readFile7(sandboxed.abs, "utf8");
+        const content = await readFile8(sandboxed.abs, "utf8");
         stableId = parseFrontmatter(content).id;
         const patch = {
           status: "deferred",
@@ -5193,9 +5402,9 @@ function registerPending(server, tracker) {
 }
 
 // src/services/doctor.ts
-import { access as access4, readFile as readFile17, readdir as readdirAsync, stat as statAsync, unlink as unlink4, writeFile as writeFile4 } from "fs/promises";
+import { access as access4, readFile as readFile18, readdir as readdirAsync, stat as statAsync, unlink as unlink4, writeFile as writeFile4 } from "fs/promises";
 import { constants as constants2 } from "fs";
-import { isAbsolute as isAbsolute2, join as join22, posix as posix5, resolve as resolve3 } from "path";
+import { isAbsolute as isAbsolute2, join as join23, posix as posix5, resolve as resolve3 } from "path";
 import {
   createTranslator,
   forensicReportSchema,
@@ -5409,13 +5618,13 @@ function createKnowledgeSummaryOpaqueCheck(t, inspection) {
 }
 
 // src/services/doctor-stable-id-collision.ts
-import { readFile as readFile8 } from "fs/promises";
-import { basename as basename2, join as join12 } from "path";
+import { readFile as readFile9 } from "fs/promises";
+import { basename as basename2, join as join13 } from "path";
 import {
   buildStoreResolveInput as buildStoreResolveInput4,
   createStoreResolver as createStoreResolver4,
   readKnowledgeAcrossStores as readKnowledgeAcrossStores2,
-  resolveGlobalRoot as resolveGlobalRoot3,
+  resolveGlobalRoot as resolveGlobalRoot4,
   storeRelativePathForMount as storeRelativePathForMount3
 } from "@fenglimg/fabric-shared";
 var ID_LINE = /^id:\s*"?([^"\n]+?)"?\s*$/mu;
@@ -5431,13 +5640,13 @@ function resolveIntegrityStores(projectRoot) {
   const personalUuids = new Set(
     input.mountedStores.filter((s) => s.personal).map((s) => s.store_uuid)
   );
-  const globalRoot = resolveGlobalRoot3();
+  const globalRoot = resolveGlobalRoot4();
   const dirs = readSet.stores.map((entry) => {
     const mounted = input.mountedStores.find((s) => s.store_uuid === entry.store_uuid);
     return {
       store_uuid: entry.store_uuid,
       alias: entry.alias,
-      dir: join12(globalRoot, storeRelativePathForMount3(mounted ?? { store_uuid: entry.store_uuid }))
+      dir: join13(globalRoot, storeRelativePathForMount3(mounted ?? { store_uuid: entry.store_uuid }))
     };
   });
   return { dirs, personalUuids };
@@ -5456,7 +5665,7 @@ async function inspectStoreStableIdIntegrity(projectRoot) {
   for (const ref of await readKnowledgeAcrossStores2(resolved.dirs)) {
     let source;
     try {
-      source = await readFile8(ref.file, "utf8");
+      source = await readFile9(ref.file, "utf8");
     } catch {
       continue;
     }
@@ -5541,7 +5750,7 @@ function createLayerMismatchCheck(t, inspection) {
 // src/services/doctor-relevance-paths.ts
 import { execFileSync as execFileSync2 } from "child_process";
 import { existsSync as existsSync6, readdirSync, statSync as statSync3 } from "fs";
-import { join as join13, sep as sep3 } from "path";
+import { join as join14, sep as sep3 } from "path";
 import { minimatch } from "minimatch";
 var MS_PER_DAY = 24 * 60 * 60 * 1e3;
 var RELEVANCE_PATHS_DRIFT_WINDOW_DAYS = 90;
@@ -5584,7 +5793,7 @@ function collectWorkspacePaths(projectRoot) {
       continue;
     }
     for (const entry of entries) {
-      const abs = join13(current, entry.name);
+      const abs = join14(current, entry.name);
       const rel = toPosix(abs.slice(projectRoot.length + 1));
       if (rel.length === 0) continue;
       if (entry.isDirectory()) {
@@ -5777,16 +5986,16 @@ function createNarrowNoPathsCheck(t, inspection) {
 }
 
 // src/services/doctor-broad-index.ts
-import { readFile as readFile9 } from "fs/promises";
-import { join as join14 } from "path";
+import { readFile as readFile10 } from "fs/promises";
+import { join as join15 } from "path";
 var DEFAULT_BROAD_INDEX_BACKSTOP = 50;
 var BROAD_INDEX_BACKSTOP_MIN = 20;
 var BROAD_INDEX_BACKSTOP_MAX = 500;
 var BROAD_INDEX_DRIFT_RATIO = 0.8;
 async function readBroadIndexBackstop(projectRoot) {
-  const configPath = join14(projectRoot, ".fabric", "fabric-config.json");
+  const configPath = join15(projectRoot, ".fabric", "fabric-config.json");
   try {
-    const raw = await readFile9(configPath, "utf8");
+    const raw = await readFile10(configPath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       const v = parsed.broad_index_backstop;
@@ -6103,15 +6312,15 @@ function createBroadReviewRecheckCheck(t, inspection) {
 }
 
 // src/services/doctor-scope-lint.ts
-import { readFile as readFile10 } from "fs/promises";
-import { join as join15 } from "path";
+import { readFile as readFile11 } from "fs/promises";
+import { join as join16 } from "path";
 import {
   buildStoreResolveInput as buildStoreResolveInput5,
   createStoreResolver as createStoreResolver5,
   isPersonalScope as isPersonalScope3,
   readKnowledgeAcrossStores as readKnowledgeAcrossStores3,
   readStoreProjects,
-  resolveGlobalRoot as resolveGlobalRoot4,
+  resolveGlobalRoot as resolveGlobalRoot5,
   scopeRoot as scopeRoot2,
   storeRelativePathForMount as storeRelativePathForMount4
 } from "@fenglimg/fabric-shared";
@@ -6136,10 +6345,10 @@ async function resolveLintStores(projectRoot) {
   const personalUuids = new Set(
     input.mountedStores.filter((s) => s.personal).map((s) => s.store_uuid)
   );
-  const globalRoot = resolveGlobalRoot4();
+  const globalRoot = resolveGlobalRoot5();
   return Promise.all(readSet.stores.map(async (entry) => {
     const mounted = input.mountedStores.find((s) => s.store_uuid === entry.store_uuid);
-    const dir = join15(
+    const dir = join16(
       globalRoot,
       storeRelativePathForMount4(mounted ?? { store_uuid: entry.store_uuid })
     );
@@ -6171,7 +6380,7 @@ async function lintStoreScopes(projectRoot) {
     }
     let source;
     try {
-      source = await readFile10(ref.file, "utf8");
+      source = await readFile11(ref.file, "utf8");
     } catch {
       continue;
     }
@@ -6294,7 +6503,7 @@ function createUnboundProjectCheck(t, violation) {
 
 // src/services/doctor-store-counters.ts
 import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync3 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 import {
   buildStoreResolveInput as buildStoreResolveInput6,
   createStoreResolver as createStoreResolver6,
@@ -6303,7 +6512,7 @@ import {
   parseKnowledgeId as parseKnowledgeId2,
   readStoreCounters,
   reconcileStoreCounters,
-  resolveGlobalRoot as resolveGlobalRoot5,
+  resolveGlobalRoot as resolveGlobalRoot6,
   STORE_KNOWLEDGE_TYPE_DIRS,
   STORE_LAYOUT as STORE_LAYOUT2,
   storeRelativePathForMount as storeRelativePathForMount5
@@ -6317,11 +6526,11 @@ function resolveCounterStores(projectRoot) {
   if (readSet.stores.length === 0) {
     return [];
   }
-  const globalRoot = resolveGlobalRoot5();
+  const globalRoot = resolveGlobalRoot6();
   return readSet.stores.map((entry) => ({
     uuid: entry.store_uuid,
     alias: entry.alias,
-    dir: join16(
+    dir: join17(
       globalRoot,
       storeRelativePathForMount5(
         input.mountedStores.find((s) => s.store_uuid === entry.store_uuid) ?? {
@@ -6349,7 +6558,7 @@ function readEntryId(file) {
 function computeStoreDiskMax(storeDir) {
   const max = defaultAgentsMetaCounters();
   for (const type of STORE_KNOWLEDGE_TYPE_DIRS) {
-    const dir = join16(storeDir, STORE_LAYOUT2.knowledgeDir, type);
+    const dir = join17(storeDir, STORE_LAYOUT2.knowledgeDir, type);
     if (!existsSync7(dir)) {
       continue;
     }
@@ -6363,7 +6572,7 @@ function computeStoreDiskMax(storeDir) {
       if (!name.endsWith(".md")) {
         continue;
       }
-      const parsed = parseKnowledgeId2(readEntryId(join16(dir, name)) ?? "");
+      const parsed = parseKnowledgeId2(readEntryId(join17(dir, name)) ?? "");
       if (parsed === null) {
         continue;
       }
@@ -6446,14 +6655,14 @@ function createStoreCounterCheck(t, drifts) {
 
 // src/services/doctor-store-orphan.ts
 import { readdirSync as readdirSync3 } from "fs";
-import { join as join17 } from "path";
+import { join as join18 } from "path";
 import {
   STORES_ROOT_DIR,
   addMountedStore,
   disambiguateAlias,
   loadGlobalConfig,
   readStoreIdentity,
-  resolveGlobalRoot as resolveGlobalRoot6,
+  resolveGlobalRoot as resolveGlobalRoot7,
   saveGlobalConfig
 } from "@fenglimg/fabric-shared";
 var STORE_BY_ALIAS_DIR = "by-alias";
@@ -6464,21 +6673,21 @@ function listDir(dir) {
     return [];
   }
 }
-function inspectStoreOrphans(globalRoot = resolveGlobalRoot6()) {
+function inspectStoreOrphans(globalRoot = resolveGlobalRoot7()) {
   const config = loadGlobalConfig(globalRoot);
   if (config === null) {
     return [];
   }
   const registered = new Set(config.stores.map((s) => s.store_uuid));
-  const storesRoot = join17(globalRoot, STORES_ROOT_DIR);
+  const storesRoot = join18(globalRoot, STORES_ROOT_DIR);
   const orphans = [];
   for (const group of listDir(storesRoot)) {
     if (group === STORE_BY_ALIAS_DIR) {
       continue;
     }
-    const groupDir = join17(storesRoot, group);
+    const groupDir = join18(storesRoot, group);
     for (const mount of listDir(groupDir)) {
-      const dir = join17(groupDir, mount);
+      const dir = join18(groupDir, mount);
       const identity = readStoreIdentity(dir);
       if (identity === null || registered.has(identity.store_uuid)) {
         continue;
@@ -6488,7 +6697,7 @@ function inspectStoreOrphans(globalRoot = resolveGlobalRoot6()) {
   }
   return orphans;
 }
-function fixStoreOrphans(globalRoot = resolveGlobalRoot6()) {
+function fixStoreOrphans(globalRoot = resolveGlobalRoot7()) {
   let config = loadGlobalConfig(globalRoot);
   if (config === null) {
     return [];
@@ -6615,8 +6824,8 @@ async function inspectEventsJsonlGates(projectRoot, options = {}) {
 }
 
 // src/services/doctor-skill-lints.ts
-import { readdir as readdir3, readFile as readFile11 } from "fs/promises";
-import { join as join18, posix as posix2 } from "path";
+import { readdir as readdir3, readFile as readFile12 } from "fs/promises";
+import { join as join19, posix as posix2 } from "path";
 var FABRIC_SKILL_SLUGS = ["fabric-archive", "fabric-review"];
 var SKILL_MD_FRONTMATTER_ROOTS = [".claude/skills", ".codex/skills"];
 var SKILL_FRONTMATTER_KEY_PATTERN = /^([A-Za-z_][A-Za-z0-9_-]*):[ \t]+(.+?)[ \t]*$/u;
@@ -6646,8 +6855,8 @@ async function listMarkdownFiles(dir) {
 async function inspectSkillRefMirror(projectRoot) {
   const driftedPaths = [];
   for (const slug of FABRIC_SKILL_SLUGS) {
-    const claudeRef = join18(projectRoot, ".claude", "skills", slug, "ref");
-    const codexRef = join18(projectRoot, ".codex", "skills", slug, "ref");
+    const claudeRef = join19(projectRoot, ".claude", "skills", slug, "ref");
+    const codexRef = join19(projectRoot, ".codex", "skills", slug, "ref");
     const [claudeFiles, codexFiles] = await Promise.all([listMarkdownFiles(claudeRef), listMarkdownFiles(codexRef)]);
     if (claudeFiles === null || codexFiles === null) continue;
     const claudeSet = new Set(claudeFiles);
@@ -6664,8 +6873,8 @@ async function inspectSkillRefMirror(projectRoot) {
       let codexBody;
       try {
         [claudeBody, codexBody] = await Promise.all([
-          readFile11(join18(claudeRef, fname), "utf8"),
-          readFile11(join18(codexRef, fname), "utf8")
+          readFile12(join19(claudeRef, fname), "utf8"),
+          readFile12(join19(codexRef, fname), "utf8")
         ]);
       } catch {
         continue;
@@ -6684,10 +6893,10 @@ async function inspectSkillTokenBudget(projectRoot) {
   const overSize = [];
   let highestSeverity = "ok";
   for (const slug of FABRIC_SKILL_SLUGS) {
-    const skillMdPath = join18(projectRoot, ".claude", "skills", slug, "SKILL.md");
+    const skillMdPath = join19(projectRoot, ".claude", "skills", slug, "SKILL.md");
     let body;
     try {
-      body = await readFile11(skillMdPath, "utf8");
+      body = await readFile12(skillMdPath, "utf8");
     } catch {
       continue;
     }
@@ -6708,10 +6917,10 @@ async function inspectSkillDescription(projectRoot) {
   const CJK_PATTERN = /[\u3400-\u4dbf\u4e00-\u9fff]/u;
   const ASCII_PATTERN = /[a-zA-Z]{2,}/u;
   for (const slug of FABRIC_SKILL_SLUGS) {
-    const skillMdPath = join18(projectRoot, ".claude", "skills", slug, "SKILL.md");
+    const skillMdPath = join19(projectRoot, ".claude", "skills", slug, "SKILL.md");
     let body;
     try {
-      body = await readFile11(skillMdPath, "utf8");
+      body = await readFile12(skillMdPath, "utf8");
     } catch {
       continue;
     }
@@ -6742,7 +6951,7 @@ async function inspectSkillDescription(projectRoot) {
 async function inspectSkillMdYamlInvalid(projectRoot) {
   const candidates = [];
   for (const rootRel of SKILL_MD_FRONTMATTER_ROOTS) {
-    const rootAbs = join18(projectRoot, rootRel);
+    const rootAbs = join19(projectRoot, rootRel);
     let dirEntries;
     try {
       dirEntries = await readdir3(rootAbs, { withFileTypes: true });
@@ -6751,10 +6960,10 @@ async function inspectSkillMdYamlInvalid(projectRoot) {
     }
     for (const dirEntry of dirEntries) {
       if (!dirEntry.isDirectory()) continue;
-      const skillFile = join18(rootAbs, dirEntry.name, "SKILL.md");
+      const skillFile = join19(rootAbs, dirEntry.name, "SKILL.md");
       let raw;
       try {
-        raw = await readFile11(skillFile, "utf8");
+        raw = await readFile12(skillFile, "utf8");
       } catch {
         continue;
       }
@@ -6877,8 +7086,8 @@ function createSkillMdYamlInvalidCheck(t, inspection) {
 }
 
 // src/services/doctor-retired-references-lint.ts
-import { readdir as readdir4, readFile as readFile12, stat as stat3 } from "fs/promises";
-import { join as join19, posix as posix3, relative as relative2 } from "path";
+import { readdir as readdir4, readFile as readFile13, stat as stat3 } from "fs/promises";
+import { join as join20, posix as posix3, relative as relative2 } from "path";
 var RETIRED_TOKENS = [
   { token: "fab_plan_context", replacement: "fab_recall", reason: "retrieval collapsed to one lean fab_recall (KT-DEC-0026)" },
   { token: "fab_get_knowledge_sections", replacement: "fab_recall", reason: "two-step fetch retired (KT-DEC-0026)" },
@@ -6901,7 +7110,7 @@ var RETIRED_TOKENS = [
 ];
 var HOOK_DIRS = [".claude/hooks", ".codex/hooks"];
 var SKILL_DIRS = [".claude/skills", ".codex/skills"];
-var BOOTSTRAP_FILES = ["AGENTS.md", "CLAUDE.md", join19(".fabric", "AGENTS.md")];
+var BOOTSTRAP_FILES = ["AGENTS.md", "CLAUDE.md", join20(".fabric", "AGENTS.md")];
 function isCommentLine(line) {
   const t = line.trim();
   return t.startsWith("//") || t.startsWith("*") || t.startsWith("/*");
@@ -6915,7 +7124,7 @@ async function walkFiles(dir, exts) {
   }
   const out = [];
   for (const e of entries) {
-    const full = join19(dir, e.name);
+    const full = join20(dir, e.name);
     if (e.isDirectory()) {
       out.push(...await walkFiles(full, exts));
     } else if (exts.some((ext) => e.name.endsWith(ext))) {
@@ -6941,29 +7150,29 @@ async function inspectRetiredReferences(projectRoot) {
   let scannedFiles = 0;
   const toRel = (p) => posix3.normalize(relative2(projectRoot, p).split("\\").join("/"));
   for (const rel of BOOTSTRAP_FILES) {
-    const abs = join19(projectRoot, rel);
+    const abs = join20(projectRoot, rel);
     try {
       if ((await stat3(abs)).isFile()) {
         scannedFiles += 1;
-        scanText(toRel(abs), await readFile12(abs, "utf8"), false, hits);
+        scanText(toRel(abs), await readFile13(abs, "utf8"), false, hits);
       }
     } catch {
     }
   }
   for (const dir of SKILL_DIRS) {
-    for (const file of await walkFiles(join19(projectRoot, dir), [".md"])) {
+    for (const file of await walkFiles(join20(projectRoot, dir), [".md"])) {
       scannedFiles += 1;
       try {
-        scanText(toRel(file), await readFile12(file, "utf8"), false, hits);
+        scanText(toRel(file), await readFile13(file, "utf8"), false, hits);
       } catch {
       }
     }
   }
   for (const dir of HOOK_DIRS) {
-    for (const file of await walkFiles(join19(projectRoot, dir), [".cjs"])) {
+    for (const file of await walkFiles(join20(projectRoot, dir), [".cjs"])) {
       scannedFiles += 1;
       try {
-        scanText(toRel(file), await readFile12(file, "utf8"), true, hits);
+        scanText(toRel(file), await readFile13(file, "utf8"), true, hits);
       } catch {
       }
     }
@@ -6998,8 +7207,8 @@ function createRetiredReferenceCheck(t, inspection) {
 
 // src/services/doctor-hooks-lints.ts
 import { constants } from "fs";
-import { access, readdir as readdir5, readFile as readFile13, stat as stat4 } from "fs/promises";
-import { join as join20, posix as posix4 } from "path";
+import { access, readdir as readdir5, readFile as readFile14, stat as stat4 } from "fs/promises";
+import { join as join21, posix as posix4 } from "path";
 import { Script } from "vm";
 var HOOKS_RUNTIME_CLIENT_DIRS = [
   { client: "claude", dir: ".claude/hooks" },
@@ -7061,14 +7270,14 @@ async function isFile(absPath) {
   }
 }
 async function inspectHooksWired(projectRoot) {
-  const claudeEntries = await readDirectoryFileNames(join20(projectRoot, ".claude"));
+  const claudeEntries = await readDirectoryFileNames(join21(projectRoot, ".claude"));
   if (claudeEntries === null) {
     return { status: "skipped", missingHooks: [] };
   }
-  const settingsPath = join20(projectRoot, ".claude", "settings.json");
+  const settingsPath = join21(projectRoot, ".claude", "settings.json");
   let parsed;
   try {
-    parsed = JSON.parse(await readFile13(settingsPath, "utf8"));
+    parsed = JSON.parse(await readFile14(settingsPath, "utf8"));
   } catch {
     return { status: "missing-settings", missingHooks: [] };
   }
@@ -7091,8 +7300,8 @@ async function inspectHooksWired(projectRoot) {
 }
 async function inspectHookCacheWritability(projectRoot) {
   const relPath = posix4.join(".fabric", ".cache");
-  const fabricDir = join20(projectRoot, ".fabric");
-  const cacheDir = join20(projectRoot, ".fabric", ".cache");
+  const fabricDir = join21(projectRoot, ".fabric");
+  const cacheDir = join21(projectRoot, ".fabric", ".cache");
   try {
     try {
       const cacheStats = await stat4(cacheDir);
@@ -7141,12 +7350,12 @@ async function inspectHookCacheWritability(projectRoot) {
 async function inspectHooksContentDrift(projectRoot) {
   const hookFilesByBasename = /* @__PURE__ */ new Map();
   for (const { client, dir } of HOOKS_RUNTIME_CLIENT_DIRS) {
-    const absDir = join20(projectRoot, dir);
+    const absDir = join21(projectRoot, dir);
     const entries = await readDirectoryFileNames(absDir);
     if (entries === null) continue;
     for (const name of entries) {
       if (!name.endsWith(".cjs")) continue;
-      const abs = join20(absDir, name);
+      const abs = join21(absDir, name);
       if (!await isFile(abs)) continue;
       const arr = hookFilesByBasename.get(name) ?? [];
       arr.push({ client, abs });
@@ -7161,7 +7370,7 @@ async function inspectHooksContentDrift(projectRoot) {
     const hashes = [];
     for (const { client, abs } of copies) {
       try {
-        const body = await readFile13(abs, "utf8");
+        const body = await readFile14(abs, "utf8");
         hashes.push({ client, sha: sha256(body) });
       } catch {
       }
@@ -7183,18 +7392,18 @@ async function inspectHooksRuntime(projectRoot) {
   const issues = [];
   let scanned = 0;
   for (const { client, dir } of HOOKS_RUNTIME_CLIENT_DIRS) {
-    const absDir = join20(projectRoot, dir);
+    const absDir = join21(projectRoot, dir);
     const entries = await readDirectoryFileNames(absDir);
     if (entries === null) continue;
     for (const name of entries) {
       if (!name.endsWith(".cjs")) continue;
-      const abs = join20(absDir, name);
+      const abs = join21(absDir, name);
       const displayPath = `${dir}/${name}`;
       if (!await isFile(abs)) continue;
       scanned += 1;
       let body;
       try {
-        body = await readFile13(abs, "utf8");
+        body = await readFile14(abs, "utf8");
       } catch (err) {
         issues.push({
           path: displayPath,
@@ -7331,8 +7540,8 @@ function createHookCacheWritabilityCheck(t, inspection) {
 }
 
 // src/services/doctor-bootstrap-lints.ts
-import { access as access2, readFile as readFile14 } from "fs/promises";
-import { join as join21 } from "path";
+import { access as access2, readFile as readFile15 } from "fs/promises";
+import { join as join22 } from "path";
 import {
   BOOTSTRAP_MARKER_BEGIN,
   BOOTSTRAP_MARKER_END,
@@ -7364,17 +7573,17 @@ async function fileExists(path) {
 }
 async function inspectBootstrapAnchor(projectRoot) {
   const [hasAgentsMd, hasClaudeMd] = await Promise.all([
-    fileExists(join21(projectRoot, "AGENTS.md")),
-    fileExists(join21(projectRoot, "CLAUDE.md"))
+    fileExists(join22(projectRoot, "AGENTS.md")),
+    fileExists(join22(projectRoot, "CLAUDE.md"))
   ]);
   return { hasAgentsMd, hasClaudeMd };
 }
 async function inspectL1BootstrapSnapshotDrift(target) {
-  const abs = join21(target, ".fabric", "AGENTS.md");
+  const abs = join22(target, ".fabric", "AGENTS.md");
   const canonical = resolveBootstrapCanonical();
   let onDisk;
   try {
-    onDisk = await readFile14(abs, "utf8");
+    onDisk = await readFile15(abs, "utf8");
   } catch {
     return { status: "missing", canonical, onDisk: null };
   }
@@ -7400,17 +7609,17 @@ function createL1BootstrapSnapshotDriftCheck(t, inspection) {
   );
 }
 async function inspectL2ManagedBlockDrift(target) {
-  const snapshotPath = join21(target, ".fabric", "AGENTS.md");
+  const snapshotPath = join22(target, ".fabric", "AGENTS.md");
   let snapshot;
   try {
-    snapshot = await readFile14(snapshotPath, "utf8");
+    snapshot = await readFile15(snapshotPath, "utf8");
   } catch {
     return { status: "ok", drifted: [] };
   }
-  const projectRulesPath = join21(target, ".fabric", "project-rules.md");
+  const projectRulesPath = join22(target, ".fabric", "project-rules.md");
   let expectedBody = snapshot;
   try {
-    const projectRules = await readFile14(projectRulesPath, "utf8");
+    const projectRules = await readFile15(projectRulesPath, "utf8");
     expectedBody = `${snapshot}
 ---
 ${projectRules}`;
@@ -7419,12 +7628,12 @@ ${projectRules}`;
   const drifted = [];
   let anyManagedBlockFound = false;
   const blockTargets = [
-    join21(target, "AGENTS.md")
+    join22(target, "AGENTS.md")
   ];
   for (const abs of blockTargets) {
     let content;
     try {
-      content = await readFile14(abs, "utf8");
+      content = await readFile15(abs, "utf8");
     } catch {
       continue;
     }
@@ -7447,9 +7656,9 @@ ${projectRules}`;
       drifted.push({ path: abs, expected: expectedBody, actual: body });
     }
   }
-  const claudeMdPath = join21(target, "CLAUDE.md");
+  const claudeMdPath = join22(target, "CLAUDE.md");
   try {
-    const claudeContent = await readFile14(claudeMdPath, "utf8");
+    const claudeContent = await readFile15(claudeMdPath, "utf8");
     anyManagedBlockFound = true;
     const lines = claudeContent.split(/\r?\n/u);
     const hasAtImport = lines.some((line) => line.trim() === "@.fabric/AGENTS.md");
@@ -7517,7 +7726,7 @@ import { appendFile as appendFile3 } from "fs/promises";
 import { minimatch as minimatch2 } from "minimatch";
 
 // src/services/cite-rollup.ts
-import { readFile as readFile15 } from "fs/promises";
+import { readFile as readFile16 } from "fs/promises";
 import { createLedgerWriteQueue as createLedgerWriteQueue3 } from "@fenglimg/fabric-shared/node/atomic-write";
 var citeRollupQueue = createLedgerWriteQueue3();
 async function appendCiteRollupRow(projectRoot, row) {
@@ -7529,7 +7738,7 @@ async function readCiteRollup(projectRoot) {
   const path = getCiteRollupPath(projectRoot);
   let raw;
   try {
-    raw = await readFile15(path, "utf8");
+    raw = await readFile16(path, "utf8");
   } catch (error) {
     if (isNodeError(error) && error.code === "ENOENT") return [];
     throw error;
@@ -8120,6 +8329,18 @@ async function runDoctorCiteCoverage(projectRoot, options) {
       }
     }
   }
+  const editSessionIds = /* @__PURE__ */ new Set();
+  for (const edit of editEvents) {
+    if (typeof edit.session_id === "string" && edit.session_id.length > 0) {
+      editSessionIds.add(edit.session_id);
+    }
+  }
+  let recallsInWindow = 0;
+  for (const list of plannedBySession.values()) recallsInWindow += list.length;
+  let recallSessionsCorrelated = 0;
+  for (const sid of plannedBySession.keys()) {
+    if (editSessionIds.has(sid)) recallSessionsCorrelated += 1;
+  }
   const noneTotal = Object.values(noneHistogram).reduce((a, b) => a + b, 0);
   const compliantCites = qualifyingCites + noneTotal;
   const noncompliantCites = expectedButMissed;
@@ -8187,6 +8408,11 @@ async function runDoctorCiteCoverage(projectRoot, options) {
     uncorrelatable_edits: uncorrelatableEdits,
     recall_backed_edits: recallBackedEdits,
     recall_coverage_rate: recallCoverageRate,
+    recall_diagnostics: {
+      recalls_in_window: recallsInWindow,
+      recall_sessions: plannedBySession.size,
+      recall_sessions_correlated: recallSessionsCorrelated
+    },
     exposed_and_mutated: {
       count: exposedAndMutated.count,
       ...exposedAndMutated.ids.length > 0 ? { ids: exposedAndMutated.ids } : {}
@@ -8659,7 +8885,7 @@ async function runDoctorReport(target) {
   const globalCliVersion = process.env.VITEST === "true" ? { status: "ok", version: "test-skipped" } : inspectGlobalCliVersion();
   const targetFiles = Object.fromEntries(
     await Promise.all(
-      TARGET_FILE_PATHS.map(async (path) => [path, await pathExists(join22(projectRoot, path))])
+      TARGET_FILE_PATHS.map(async (path) => [path, await pathExists(join23(projectRoot, path))])
     )
   );
   const checks = [
@@ -8863,7 +9089,7 @@ async function runDoctorFix(target) {
   const fixed = [];
   const ledgerWarnings = [];
   if (before.fixable_errors.some((issue) => issue.code === "bootstrap_snapshot_drift")) {
-    const snapshotPath = join22(projectRoot, ".fabric", "AGENTS.md");
+    const snapshotPath = join23(projectRoot, ".fabric", "AGENTS.md");
     await ensureParentDirectory(snapshotPath);
     await atomicWriteText4(snapshotPath, resolveBootstrapCanonical2());
     fixed.push(findIssue(before.fixable_errors, "bootstrap_snapshot_drift"));
@@ -8936,7 +9162,7 @@ async function runDoctorFix(target) {
   if (before.infos.some((issue) => issue.code === "stale_serve_lock")) {
     const lockInspection = inspectStaleServeLock(projectRoot, Date.now());
     if (lockInspection.present && !lockInspection.pidAlive) {
-      const lockFilePath = join22(projectRoot, ".fabric", ".serve.lock");
+      const lockFilePath = join23(projectRoot, ".fabric", ".serve.lock");
       try {
         await unlink4(lockFilePath);
       } catch (err) {
@@ -9053,7 +9279,7 @@ function createApplyLintMessage(succeeded, failed, manualErrorCount) {
 }
 async function applySessionHintsStaleCleanup(projectRoot, candidate) {
   const detail = `deleted (${candidate.age_days}d old)`;
-  const absPath = join22(projectRoot, candidate.path);
+  const absPath = join23(projectRoot, candidate.path);
   try {
     const { unlink: unlink5 } = await import("fs/promises");
     await unlink5(absPath);
@@ -9078,9 +9304,9 @@ function truncateErrorMessage(error) {
   return raw.length > 240 ? `${raw.slice(0, 237)}...` : raw;
 }
 async function inspectForensic(projectRoot) {
-  const path = join22(projectRoot, ".fabric", "forensic.json");
+  const path = join23(projectRoot, ".fabric", "forensic.json");
   try {
-    const parsed = forensicReportSchema.parse(JSON.parse(await readFile17(path, "utf8")));
+    const parsed = forensicReportSchema.parse(JSON.parse(await readFile18(path, "utf8")));
     return { present: true, valid: true, report: parsed };
   } catch (error) {
     if (isMissingFileError(error)) {
@@ -9110,7 +9336,7 @@ async function inspectEventLedger(projectRoot) {
   try {
     await access4(path, constants2.W_OK);
     const { warnings } = await readEventLedger(projectRoot);
-    const raw = await readFile17(path, "utf8");
+    const raw = await readFile18(path, "utf8");
     const invalidLine = raw.split(/\r?\n/u).map((line) => line.trim()).filter(Boolean).find((line) => !isValidJsonLine(line));
     const partialWarning = warnings.find((w) => w.kind === "partial_write_at_tail");
     const schemaVersionSamples = [];
@@ -9655,7 +9881,7 @@ async function inspectPreexistingRootFiles(projectRoot) {
   const candidates = ["CLAUDE.md", "AGENTS.md"];
   const detected = [];
   for (const name of candidates) {
-    if (await pathExists(join22(projectRoot, name))) {
+    if (await pathExists(join23(projectRoot, name))) {
       detected.push(name);
     }
   }
@@ -9740,7 +9966,7 @@ async function buildLastActiveIndex(projectRoot) {
   return map;
 }
 async function inspectSessionHintsStale(projectRoot, now) {
-  const cacheDir = join22(projectRoot, ".fabric", ".cache");
+  const cacheDir = join23(projectRoot, ".fabric", ".cache");
   let entries;
   try {
     entries = await readdirAsync(cacheDir, { withFileTypes: true });
@@ -9752,7 +9978,7 @@ async function inspectSessionHintsStale(projectRoot, now) {
     if (!entry.isFile()) continue;
     if (!entry.name.startsWith(SESSION_HINTS_FILE_PREFIX)) continue;
     if (!entry.name.endsWith(SESSION_HINTS_FILE_SUFFIX)) continue;
-    const absPath = join22(cacheDir, entry.name);
+    const absPath = join23(cacheDir, entry.name);
     let mtimeMs = 0;
     try {
       mtimeMs = (await statAsync(absPath)).mtimeMs;
@@ -9784,9 +10010,9 @@ function inspectStaleServeLock(projectRoot, now) {
   };
 }
 async function readUnderseedThresholdFromConfig(projectRoot) {
-  const configPath = join22(projectRoot, ".fabric", "fabric-config.json");
+  const configPath = join23(projectRoot, ".fabric", "fabric-config.json");
   try {
-    const raw = await readFile17(configPath, "utf8");
+    const raw = await readFile18(configPath, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
       const v = parsed.underseed_node_threshold;
@@ -9902,10 +10128,10 @@ async function inspectOnboardCoverage(projectRoot) {
   return { filled, missing, opted_out: optedOut };
 }
 async function readOnboardOptedOut(projectRoot) {
-  const path = join22(projectRoot, ".fabric", "fabric-config.json");
+  const path = join23(projectRoot, ".fabric", "fabric-config.json");
   let raw;
   try {
-    raw = await readFile17(path, "utf8");
+    raw = await readFile18(path, "utf8");
   } catch {
     return [];
   }
@@ -10007,22 +10233,22 @@ async function* iterateCanonicalFilenames(projectRoot) {
   }
 }
 async function rewriteThreeEndManagedBlocks(projectRoot) {
-  const snapshotPath = join22(projectRoot, ".fabric", "AGENTS.md");
+  const snapshotPath = join23(projectRoot, ".fabric", "AGENTS.md");
   if (!await pathExists(snapshotPath)) {
     return;
   }
   let snapshot;
   try {
-    snapshot = await readFile17(snapshotPath, "utf8");
+    snapshot = await readFile18(snapshotPath, "utf8");
   } catch {
     return;
   }
-  const projectRulesPath = join22(projectRoot, ".fabric", "project-rules.md");
+  const projectRulesPath = join23(projectRoot, ".fabric", "project-rules.md");
   const hasProjectRules = await pathExists(projectRulesPath);
   let expectedBody = snapshot;
   if (hasProjectRules) {
     try {
-      const projectRules = await readFile17(projectRulesPath, "utf8");
+      const projectRules = await readFile18(projectRulesPath, "utf8");
       expectedBody = `${snapshot}
 ---
 ${projectRules}`;
@@ -10033,7 +10259,7 @@ ${projectRules}`;
 ${expectedBody}
 ${BOOTSTRAP_MARKER_END2}`;
   const blockTargets = [
-    join22(projectRoot, "AGENTS.md")
+    join23(projectRoot, "AGENTS.md")
   ];
   for (const abs of blockTargets) {
     if (!await pathExists(abs)) {
@@ -10041,7 +10267,7 @@ ${BOOTSTRAP_MARKER_END2}`;
     }
     let existing;
     try {
-      existing = await readFile17(abs, "utf8");
+      existing = await readFile18(abs, "utf8");
     } catch {
       continue;
     }
@@ -10066,11 +10292,11 @@ ${managedBlock}
     }
     await atomicWriteText4(abs, next);
   }
-  const claudeMdPath = join22(projectRoot, "CLAUDE.md");
+  const claudeMdPath = join23(projectRoot, "CLAUDE.md");
   if (await pathExists(claudeMdPath)) {
     let claudeContent;
     try {
-      claudeContent = await readFile17(claudeMdPath, "utf8");
+      claudeContent = await readFile18(claudeMdPath, "utf8");
     } catch {
       return;
     }
@@ -10136,7 +10362,7 @@ async function collectEntryPoints(root) {
       continue;
     }
     for (const entry of await readdirAsync(current, { withFileTypes: true })) {
-      const absolutePath = join22(current, entry.name);
+      const absolutePath = join23(current, entry.name);
       const relativePath = normalizePath2(absolutePath.slice(root.length + 1));
       if (relativePath.length === 0) {
         continue;
@@ -10212,7 +10438,7 @@ async function enrichDescriptions(projectRoot, opts = {}) {
     scanned += 1;
     let source;
     try {
-      source = await readFile17(absPath, "utf8");
+      source = await readFile18(absPath, "utf8");
     } catch {
       continue;
     }
@@ -10350,14 +10576,14 @@ async function runDoctorConflictLint(projectRoot, opts = {}) {
 }
 
 // src/services/why-not-surfaced.ts
-import { readFile as readFile18 } from "fs/promises";
-import { basename as basename3, join as join23 } from "path";
+import { readFile as readFile19 } from "fs/promises";
+import { basename as basename3, join as join24 } from "path";
 import {
   buildStoreResolveInput as buildStoreResolveInput7,
   createStoreResolver as createStoreResolver7,
   loadProjectConfig as loadProjectConfig4,
   readKnowledgeAcrossStores as readKnowledgeAcrossStores4,
-  resolveGlobalRoot as resolveGlobalRoot7,
+  resolveGlobalRoot as resolveGlobalRoot8,
   scopeRoot as scopeRoot3,
   storeRelativePathForMount as storeRelativePathForMount6
 } from "@fenglimg/fabric-shared";
@@ -10387,11 +10613,11 @@ async function explainWhyNotSurfaced(projectRoot, query) {
   if (input === null) {
     return base;
   }
-  const globalRoot = resolveGlobalRoot7();
+  const globalRoot = resolveGlobalRoot8();
   const allStores = input.mountedStores.map((s) => ({
     store_uuid: s.store_uuid,
     alias: s.alias,
-    dir: join23(globalRoot, storeRelativePathForMount6(s))
+    dir: join24(globalRoot, storeRelativePathForMount6(s))
   }));
   const refs = await readKnowledgeAcrossStores4(allStores);
   const candidate = refs.find((ref) => fileMatchesId(ref.file, localId));
@@ -10400,7 +10626,7 @@ async function explainWhyNotSurfaced(projectRoot, query) {
   }
   let source;
   try {
-    source = await readFile18(candidate.file, "utf8");
+    source = await readFile19(candidate.file, "utf8");
   } catch {
     return base;
   }
@@ -10453,6 +10679,191 @@ function buildColdEvalBatch(candidates) {
   return { rubric: COLD_EVAL_RUBRIC, candidates: judgeable };
 }
 
+// src/services/doctor-related-graph.ts
+function buildRelatedGraph(nodes) {
+  const brokenLinks = [];
+  const inDegree = /* @__PURE__ */ new Map();
+  const allIds = /* @__PURE__ */ new Set();
+  const edgeSources = [];
+  for (const node of nodes) {
+    const bareId = extractBareStableId(node.qualifiedId);
+    allIds.add(node.qualifiedId);
+    if (bareId !== null) {
+      allIds.add(bareId);
+    }
+    const related = node.related;
+    if (related !== void 0 && related.length > 0) {
+      edgeSources.push({ source: node.qualifiedId, related });
+      for (const rel of related) {
+        inDegree.set(rel, (inDegree.get(rel) ?? 0) + 1);
+      }
+    }
+  }
+  for (const { source, related } of edgeSources) {
+    for (const rel of related) {
+      if (!allIds.has(rel)) {
+        brokenLinks.push({ source, target: rel });
+      }
+    }
+  }
+  const hubEntries = [...inDegree.entries()].map(([stableId, degree]) => ({ stableId, inDegree: degree })).sort((a, b) => b.inDegree - a.inDegree || a.stableId.localeCompare(b.stableId));
+  return {
+    brokenLinks,
+    hubEntries,
+    totalEntries: nodes.length
+  };
+}
+function extractBareStableId(qualifiedId) {
+  const colonIdx = qualifiedId.indexOf(":");
+  if (colonIdx > 0 && colonIdx < qualifiedId.length - 1) {
+    return qualifiedId.slice(colonIdx + 1);
+  }
+  return null;
+}
+async function inspectRelatedGraph(projectRoot) {
+  const entries = await collectStoreCanonicalEntries(projectRoot);
+  return buildRelatedGraph(
+    entries.map((entry) => ({
+      qualifiedId: entry.qualifiedId,
+      related: entry.description.related
+    }))
+  );
+}
+
+// src/services/store-precheck.ts
+import { existsSync as existsSync9, readFileSync as readFileSync4 } from "fs";
+import { join as join25 } from "path";
+import {
+  buildStoreResolveInput as buildStoreResolveInput8,
+  createStoreResolver as createStoreResolver8,
+  resolveGlobalRoot as resolveGlobalRoot9,
+  storeRelativePathForMount as storeRelativePathForMount7
+} from "@fenglimg/fabric-shared";
+var CACHE_TTL_MS = 6e4;
+var cache = /* @__PURE__ */ new Map();
+function clearPrecheckCache() {
+  cache.clear();
+}
+function evaluateStoreDir(storeDir, identity) {
+  if (!existsSync9(storeDir)) {
+    return {
+      uuid: identity.uuid,
+      alias: identity.alias,
+      reachable: false,
+      reason: `directory not found at ${storeDir}`
+    };
+  }
+  const storeJsonPath = join25(storeDir, "store.json");
+  const gitDirPath = join25(storeDir, ".git");
+  const hasStoreJson = existsSync9(storeJsonPath) && isValidStoreJson(storeJsonPath);
+  const hasGitDir = existsSync9(gitDirPath);
+  if (!hasStoreJson && !hasGitDir) {
+    return {
+      uuid: identity.uuid,
+      alias: identity.alias,
+      reachable: false,
+      reason: `no store.json or .git found in ${storeDir}`
+    };
+  }
+  return { uuid: identity.uuid, alias: identity.alias, reachable: true };
+}
+function isValidStoreJson(path) {
+  try {
+    JSON.parse(readFileSync4(path, "utf8"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function precheckStoreReachability(projectRoot, globalRoot = resolveGlobalRoot9(), now = Date.now()) {
+  const cached = cache.get(projectRoot);
+  if (cached !== void 0 && cached.expiresAt > now) {
+    return cached.result;
+  }
+  const input = buildStoreResolveInput8(projectRoot, globalRoot);
+  if (input === null) {
+    const result2 = { stores: [], allReachable: true };
+    cache.set(projectRoot, { result: result2, expiresAt: now + CACHE_TTL_MS });
+    return result2;
+  }
+  const readSet = createStoreResolver8().resolveReadSet(input);
+  const stores = readSet.stores.map((entry) => {
+    const mounted = input.mountedStores.find((s) => s.store_uuid === entry.store_uuid);
+    const storeDir = join25(
+      globalRoot,
+      storeRelativePathForMount7(mounted ?? { store_uuid: entry.store_uuid })
+    );
+    return evaluateStoreDir(storeDir, { uuid: entry.store_uuid, alias: entry.alias });
+  });
+  const result = {
+    stores,
+    allReachable: stores.every((s) => s.reachable)
+  };
+  cache.set(projectRoot, { result, expiresAt: now + CACHE_TTL_MS });
+  return result;
+}
+
+// src/services/doctor-consumption-lint.ts
+var DEFAULT_WINDOW_DAYS = 30;
+var DEFAULT_TOP_N = 10;
+var DEFAULT_MIN_TOTAL_ENTRIES = 20;
+var DEFAULT_MIN_CONSUMED_WINDOWS = 30;
+var DEFAULT_MIN_CONSUMED_EVENTS = 50;
+var CONSUMED_PREFIX = "knowledge_consumed:";
+var MS_PER_DAY5 = 24 * 60 * 60 * 1e3;
+function resolveConfig(config) {
+  return {
+    windowDays: config?.windowDays ?? DEFAULT_WINDOW_DAYS,
+    topN: config?.topN ?? DEFAULT_TOP_N,
+    minTotalEntries: config?.minTotalEntries ?? DEFAULT_MIN_TOTAL_ENTRIES,
+    minConsumedWindows: config?.minConsumedWindows ?? DEFAULT_MIN_CONSUMED_WINDOWS,
+    minConsumedEvents: config?.minConsumedEvents ?? DEFAULT_MIN_CONSUMED_EVENTS
+  };
+}
+function aggregateConsumption(rows, allQualifiedIds, now, config) {
+  const cfg = resolveConfig(config);
+  const cutoffMs = now - cfg.windowDays * MS_PER_DAY5;
+  const consumed = /* @__PURE__ */ new Map();
+  let consumedWindows = 0;
+  let totalConsumedEvents = 0;
+  for (const row of rows) {
+    const rowTs = Date.parse(row.timestamp);
+    if (!Number.isFinite(rowTs) || rowTs < cutoffMs) continue;
+    if (row.counters === null || typeof row.counters !== "object") continue;
+    let windowHadConsumption = false;
+    for (const [counterName, rawCount] of Object.entries(row.counters)) {
+      if (!counterName.startsWith(CONSUMED_PREFIX)) continue;
+      const count = typeof rawCount === "number" ? rawCount : 0;
+      if (count <= 0) continue;
+      const id = counterName.slice(CONSUMED_PREFIX.length);
+      if (id.length === 0) continue;
+      consumed.set(id, (consumed.get(id) ?? 0) + count);
+      totalConsumedEvents += count;
+      windowHadConsumption = true;
+    }
+    if (windowHadConsumption) consumedWindows += 1;
+  }
+  const topConsumed = [...consumed.entries()].map(([stableId, count]) => ({ stableId, count })).sort((a, b) => b.count - a.count || a.stableId.localeCompare(b.stableId)).slice(0, cfg.topN);
+  const dataMature = consumedWindows >= cfg.minConsumedWindows && totalConsumedEvents >= cfg.minConsumedEvents && allQualifiedIds.length >= cfg.minTotalEntries;
+  const zeroConsumed = dataMature ? allQualifiedIds.filter((id) => !consumed.has(id)).sort((a, b) => a.localeCompare(b)) : [];
+  return {
+    topConsumed,
+    zeroConsumed,
+    totalEntries: allQualifiedIds.length,
+    consumedEntries: consumed.size,
+    consumedWindows,
+    totalConsumedEvents,
+    dataMature,
+    windowDays: cfg.windowDays
+  };
+}
+async function inspectConsumption(projectRoot, config, now = Date.now()) {
+  const rows = await readMetrics(projectRoot);
+  const entries = await collectStoreCanonicalEntries(projectRoot);
+  const allQualifiedIds = entries.map((entry) => entry.qualifiedId);
+  return aggregateConsumption(rows, allQualifiedIds, now, config);
+}
+
 // src/services/rotation-tick.ts
 var DEFAULT_TICK_INTERVAL_MS = 6 * 60 * 60 * 1e3;
 var tickTimers = /* @__PURE__ */ new Map();
@@ -10488,7 +10899,7 @@ import { IOFabricError as IOFabricError2, RuleError } from "@fenglimg/fabric-sha
 
 // src/services/read-ledger.ts
 import { randomUUID as randomUUID7 } from "crypto";
-import { access as access5, copyFile, readFile as readFile19, rm } from "fs/promises";
+import { access as access5, copyFile, readFile as readFile20, rm } from "fs/promises";
 import { ledgerEntrySchema } from "@fenglimg/fabric-shared";
 async function resolveLedgerPaths(projectRoot) {
   const primaryPath = getLedgerPath(projectRoot);
@@ -10516,7 +10927,7 @@ async function readLegacyLedger(projectRoot) {
   const { readPath } = await resolveLedgerPaths(projectRoot);
   let raw;
   try {
-    raw = await readFile19(readPath, "utf8");
+    raw = await readFile20(readPath, "utf8");
   } catch (error) {
     if (isNodeError(error) && error.code === "ENOENT") {
       return [];
@@ -10771,8 +11182,8 @@ function formatError(error) {
 }
 function formatPreexistingRootMessage(projectRoot) {
   const preexisting = [];
-  if (existsSync9(join24(projectRoot, "CLAUDE.md"))) preexisting.push("CLAUDE.md");
-  if (existsSync9(join24(projectRoot, "AGENTS.md"))) preexisting.push("AGENTS.md");
+  if (existsSync10(join26(projectRoot, "CLAUDE.md"))) preexisting.push("CLAUDE.md");
+  if (existsSync10(join26(projectRoot, "AGENTS.md"))) preexisting.push("AGENTS.md");
   if (preexisting.length === 0) return null;
   return `[startup] info: detected ${preexisting.join(", ")} at project root. Note: Fabric serves knowledge from mounted stores via MCP \u2014 root markdown files are not auto-loaded into the AI context.`;
 }
@@ -10799,7 +11210,7 @@ function createFabricServer(tracker) {
   const server = new McpServer(
     {
       name: "fabric-knowledge-server",
-      version: "2.3.0-rc.2"
+      version: "2.3.0-rc.4"
     },
     {
       instructions: FABRIC_SERVER_INSTRUCTIONS
@@ -10819,10 +11230,10 @@ function createFabricServer(tracker) {
     },
     async (_uri) => {
       const projectRoot = process.env.FABRIC_PROJECT_ROOT ?? process.cwd();
-      const path = join24(projectRoot, ".fabric", "bootstrap", "README.md");
+      const path = join26(projectRoot, ".fabric", "bootstrap", "README.md");
       let text = "";
-      if (existsSync9(path)) {
-        text = await readFile20(path, "utf8");
+      if (existsSync10(path)) {
+        text = await readFile21(path, "utf8");
       }
       return {
         contents: [
@@ -10920,19 +11331,26 @@ export {
   LEGACY_LEDGER_PATH,
   METRICS_LEDGER_PATH,
   METRIC_COUNTER_NAMES,
+  OPTIONAL_EMBED_PACKAGE,
   RETIRED_TOKENS,
+  aggregateConsumption,
   appendEventLedgerEvent,
   buildAlwaysActiveBodies,
   buildColdEvalBatch,
   buildKnowledgeCensus,
+  buildRelatedGraph,
   bumpCounter,
+  clearPrecheckCache,
+  collectStoreCanonicalEntries,
   contextCache,
   createFabricServer,
   createInFlightTracker,
   createShutdownHandler,
+  defaultEmbedCacheDir,
   detectUnboundProject,
   drainCounters,
   enrichDescriptions,
+  evaluateStoreDir,
   explainWhyNotSurfaced,
   extractKnowledge,
   findConflictCandidates,
@@ -10943,12 +11361,19 @@ export {
   getLedgerPath,
   getLegacyLedgerPath,
   getMetricsLedgerPath,
+  inspectConsumption,
+  inspectRelatedGraph,
   inspectRetiredReferences,
+  isEmbedderResolvable,
   lintConflicts,
   loadConflictEntries,
+  loadEmbedder,
   pairSimilarity,
   planContext,
+  precheckStoreReachability,
+  readEmbedConfig,
   readEventLedger,
+  readFusion,
   readLedger,
   readMetrics,
   readSelectionToken,