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

package/dist/index.d.ts

@@ -530,6 +530,31 @@ declare function runDoctorConflictLint(projectRoot: string, opts?: {
     judge?: ConflictJudge;
 }): Promise<ConflictLintReport>;
 
+declare function readEmbedConfig(projectRoot: string): {
+    enabled: boolean;
+    weight: number;
+    model: string;
+};
+declare function readFusion(projectRoot: string): "additive" | "rrf" | "auto";
+
+interface Embedder {
+    embed(texts: string[]): Promise<number[][]>;
+}
+declare const OPTIONAL_EMBED_PACKAGE = "fastembed";
+declare function defaultEmbedCacheDir(): string;
+/**
+ * Lazy-load the optional fastembed embedder, pinned to CPU + cache-only. Returns
+ * null (cached) when the package is not installed or initialization throws, so
+ * every caller degrades to the text-only path. Never throws.
+ *
+ * v2.1 ③: `modelName` (a fastembed EmbeddingModel enum value) selects the
+ * embedding model — the caller threads `embed_model` config through so the
+ * Chinese-heavy KB no longer embeds against fastembed's English default. The
+ * load is cached per-process; the FIRST model wins (a config change needs a
+ * server restart, already the norm for MCP config changes).
+ */
+declare function loadEmbedder(modelName?: string): Promise<Embedder | null>;
+
 interface RetiredToken {
     /** The exact dead token as it appears in agent-facing text. */
     token: string;
@@ -949,4 +974,4 @@ interface ShutdownHandlerDeps {
  */
 declare function createShutdownHandler(deps: ShutdownHandlerDeps): () => void;
 
-export { AGENTS_MD_RESOURCE_URI, type AlwaysActiveBody, type ArchiveHistoryEntry, type ArchiveHistoryReport, COLD_EVAL_RUBRIC, type CiteCoverageReport, type ColdEvalBatch, type ColdEvalCandidate, type ColdEvalVerdict, type ConflictEntry, type ConflictJudge, type ConflictLintReport, type ConflictPair, type ConflictVerdict, DEFAULT_CONFLICT_SIMILARITY_THRESHOLD, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type EnrichDescriptionsCandidate, type EnrichDescriptionsMode, type EnrichDescriptionsReport, FABRIC_SERVER_INSTRUCTIONS, type HistoryAllReport, type HistoryDayRow, type InFlightTracker, type KnowledgeCensus, LEDGER_PATH, LEGACY_LEDGER_PATH, METRICS_LEDGER_PATH, METRIC_COUNTER_NAMES, type MetricCounterName, type MetricsRow, type PlanContextInput, type PlanContextResult, RETIRED_TOKENS, type RecallInput, type RecallResult, type RequirementProfile, type RetiredReferenceHit, type RetiredReferenceInspection, type RetiredToken, type SelectionTokenState, type ShutdownHandlerDeps, type SurfaceVerdict, type UnboundProjectViolation, type WhyNotSurfacedResult, appendEventLedgerEvent, buildAlwaysActiveBodies, buildColdEvalBatch, buildKnowledgeCensus, bumpCounter, contextCache, createFabricServer, createInFlightTracker, createShutdownHandler, detectUnboundProject, drainCounters, enrichDescriptions, explainWhyNotSurfaced, extractKnowledge, findConflictCandidates, flushAndSyncEventLedger, flushMetrics, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, getMetricsLedgerPath, inspectRetiredReferences, lintConflicts, loadConflictEntries, pairSimilarity, planContext, readEventLedger, readLedger, readMetrics, readSelectionToken, recall, rehydrateAgentsMetaAt, resolveLedgerPaths, reviewKnowledge, reviewPending, runDoctorApplyLint, runDoctorArchiveHistory, runDoctorCiteCoverage, runDoctorConflictLint, runDoctorFix, runDoctorHistoryAll, runDoctorReport, startMetricsFlush, startRotationTick, startStdioServer, stopMetricsFlush, stopRotationTick };
+export { AGENTS_MD_RESOURCE_URI, type AlwaysActiveBody, type ArchiveHistoryEntry, type ArchiveHistoryReport, COLD_EVAL_RUBRIC, type CiteCoverageReport, type ColdEvalBatch, type ColdEvalCandidate, type ColdEvalVerdict, type ConflictEntry, type ConflictJudge, type ConflictLintReport, type ConflictPair, type ConflictVerdict, DEFAULT_CONFLICT_SIMILARITY_THRESHOLD, type DoctorApplyLintMutation, type DoctorApplyLintMutationKind, type DoctorApplyLintReport, type DoctorFixReport, type DoctorIssue, type DoctorReport, EVENT_LEDGER_PATH, type EnrichDescriptionsCandidate, type EnrichDescriptionsMode, type EnrichDescriptionsReport, FABRIC_SERVER_INSTRUCTIONS, type HistoryAllReport, type HistoryDayRow, type InFlightTracker, type KnowledgeCensus, LEDGER_PATH, LEGACY_LEDGER_PATH, METRICS_LEDGER_PATH, METRIC_COUNTER_NAMES, type MetricCounterName, type MetricsRow, OPTIONAL_EMBED_PACKAGE, type PlanContextInput, type PlanContextResult, RETIRED_TOKENS, type RecallInput, type RecallResult, type RequirementProfile, type RetiredReferenceHit, type RetiredReferenceInspection, type RetiredToken, type SelectionTokenState, type ShutdownHandlerDeps, type SurfaceVerdict, type UnboundProjectViolation, type WhyNotSurfacedResult, appendEventLedgerEvent, buildAlwaysActiveBodies, buildColdEvalBatch, buildKnowledgeCensus, bumpCounter, contextCache, createFabricServer, createInFlightTracker, createShutdownHandler, defaultEmbedCacheDir, detectUnboundProject, drainCounters, enrichDescriptions, explainWhyNotSurfaced, extractKnowledge, findConflictCandidates, flushAndSyncEventLedger, flushMetrics, formatPreexistingRootMessage, getEventLedgerPath, getLedgerPath, getLegacyLedgerPath, getMetricsLedgerPath, inspectRetiredReferences, lintConflicts, loadConflictEntries, loadEmbedder, pairSimilarity, planContext, readEmbedConfig, readEventLedger, readFusion, readLedger, readMetrics, readSelectionToken, recall, rehydrateAgentsMetaAt, resolveLedgerPaths, reviewKnowledge, reviewPending, runDoctorApplyLint, runDoctorArchiveHistory, runDoctorCiteCoverage, runDoctorConflictLint, runDoctorFix, runDoctorHistoryAll, runDoctorReport, startMetricsFlush, startRotationTick, startStdioServer, stopMetricsFlush, stopRotationTick };

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 { join as join25, 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) {
@@ -2752,9 +2753,12 @@ 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 { join as join10 } from "path";
 
 // src/services/vector-retrieval.ts
+import { mkdirSync } from "fs";
+import { join as join9 } from "path";
+import { resolveGlobalRoot as resolveGlobalRoot3 } from "@fenglimg/fabric-shared";
 var embedderLoad;
 var OPTIONAL_EMBED_PACKAGE = "fastembed";
 var embedderModuleLoader = (name) => import(name);
@@ -2771,10 +2775,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 +2795,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,7 +3166,7 @@ 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 {
@@ -3172,7 +3181,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 +3280,9 @@ 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;
   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) {
@@ -3909,7 +3920,7 @@ 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 { 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) {
@@ -3950,7 +3961,7 @@ 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 { 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 +4034,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,7 +4055,7 @@ 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");
@@ -4227,7 +4238,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,7 +4250,7 @@ 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");
@@ -4366,7 +4377,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),
@@ -4553,7 +4564,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 +4664,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 +4677,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);
@@ -5195,7 +5206,7 @@ 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 { 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,
@@ -5410,12 +5421,12 @@ 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 { 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 +5442,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 };
@@ -5541,7 +5552,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 +5595,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()) {
@@ -5778,13 +5789,13 @@ function createNarrowNoPathsCheck(t, inspection) {
 
 // src/services/doctor-broad-index.ts
 import { readFile as readFile9 } from "fs/promises";
-import { join as join14 } from "path";
+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 parsed = JSON.parse(raw);
@@ -6104,14 +6115,14 @@ function createBroadReviewRecheckCheck(t, inspection) {
 
 // src/services/doctor-scope-lint.ts
 import { readFile as readFile10 } from "fs/promises";
-import { join as join15 } from "path";
+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 +6147,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 })
     );
@@ -6294,7 +6305,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 +6314,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 +6328,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 +6360,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 +6374,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 +6457,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 +6475,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 +6499,7 @@ function inspectStoreOrphans(globalRoot = resolveGlobalRoot6()) {
   }
   return orphans;
 }
-function fixStoreOrphans(globalRoot = resolveGlobalRoot6()) {
+function fixStoreOrphans(globalRoot = resolveGlobalRoot7()) {
   let config = loadGlobalConfig(globalRoot);
   if (config === null) {
     return [];
@@ -6616,7 +6627,7 @@ 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 { 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 +6657,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 +6675,8 @@ async function inspectSkillRefMirror(projectRoot) {
       let codexBody;
       try {
         [claudeBody, codexBody] = await Promise.all([
-          readFile11(join18(claudeRef, fname), "utf8"),
-          readFile11(join18(codexRef, fname), "utf8")
+          readFile11(join19(claudeRef, fname), "utf8"),
+          readFile11(join19(codexRef, fname), "utf8")
         ]);
       } catch {
         continue;
@@ -6684,7 +6695,7 @@ 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");
@@ -6708,7 +6719,7 @@ 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");
@@ -6742,7 +6753,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,7 +6762,7 @@ 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");
@@ -6878,7 +6889,7 @@ 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 { 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 +6912,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 +6926,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,7 +6952,7 @@ 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;
@@ -6951,7 +6962,7 @@ async function inspectRetiredReferences(projectRoot) {
     }
   }
   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);
@@ -6960,7 +6971,7 @@ async function inspectRetiredReferences(projectRoot) {
     }
   }
   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);
@@ -6999,7 +7010,7 @@ 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 { join as join21, posix as posix4 } from "path";
 import { Script } from "vm";
 var HOOKS_RUNTIME_CLIENT_DIRS = [
   { client: "claude", dir: ".claude/hooks" },
@@ -7061,11 +7072,11 @@ 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"));
@@ -7091,8 +7102,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 +7152,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 });
@@ -7183,12 +7194,12 @@ 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;
@@ -7332,7 +7343,7 @@ 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 { join as join22 } from "path";
 import {
   BOOTSTRAP_MARKER_BEGIN,
   BOOTSTRAP_MARKER_END,
@@ -7364,13 +7375,13 @@ 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 {
@@ -7400,14 +7411,14 @@ 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");
   } 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");
@@ -7419,7 +7430,7 @@ ${projectRules}`;
   const drifted = [];
   let anyManagedBlockFound = false;
   const blockTargets = [
-    join21(target, "AGENTS.md")
+    join22(target, "AGENTS.md")
   ];
   for (const abs of blockTargets) {
     let content;
@@ -7447,7 +7458,7 @@ ${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");
     anyManagedBlockFound = true;
@@ -8659,7 +8670,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 +8874,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 +8947,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 +9064,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,7 +9089,7 @@ 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")));
     return { present: true, valid: true, report: parsed };
@@ -9655,7 +9666,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 +9751,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 +9763,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,7 +9795,7 @@ 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 parsed = JSON.parse(raw);
@@ -9902,7 +9913,7 @@ 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");
@@ -10007,7 +10018,7 @@ 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;
   }
@@ -10017,7 +10028,7 @@ async function rewriteThreeEndManagedBlocks(projectRoot) {
   } 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) {
@@ -10033,7 +10044,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)) {
@@ -10066,7 +10077,7 @@ ${managedBlock}
     }
     await atomicWriteText4(abs, next);
   }
-  const claudeMdPath = join22(projectRoot, "CLAUDE.md");
+  const claudeMdPath = join23(projectRoot, "CLAUDE.md");
   if (await pathExists(claudeMdPath)) {
     let claudeContent;
     try {
@@ -10136,7 +10147,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;
@@ -10351,13 +10362,13 @@ 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 { 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 +10398,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));
@@ -10771,8 +10782,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 (existsSync9(join25(projectRoot, "CLAUDE.md"))) preexisting.push("CLAUDE.md");
+  if (existsSync9(join25(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 +10810,7 @@ function createFabricServer(tracker) {
   const server = new McpServer(
     {
       name: "fabric-knowledge-server",
-      version: "2.3.0-rc.2"
+      version: "2.3.0-rc.3"
     },
     {
       instructions: FABRIC_SERVER_INSTRUCTIONS
@@ -10819,7 +10830,7 @@ function createFabricServer(tracker) {
     },
     async (_uri) => {
       const projectRoot = process.env.FABRIC_PROJECT_ROOT ?? process.cwd();
-      const path = join24(projectRoot, ".fabric", "bootstrap", "README.md");
+      const path = join25(projectRoot, ".fabric", "bootstrap", "README.md");
       let text = "";
       if (existsSync9(path)) {
         text = await readFile20(path, "utf8");
@@ -10920,6 +10931,7 @@ export {
   LEGACY_LEDGER_PATH,
   METRICS_LEDGER_PATH,
   METRIC_COUNTER_NAMES,
+  OPTIONAL_EMBED_PACKAGE,
   RETIRED_TOKENS,
   appendEventLedgerEvent,
   buildAlwaysActiveBodies,
@@ -10930,6 +10942,7 @@ export {
   createFabricServer,
   createInFlightTracker,
   createShutdownHandler,
+  defaultEmbedCacheDir,
   detectUnboundProject,
   drainCounters,
   enrichDescriptions,
@@ -10946,9 +10959,12 @@ export {
   inspectRetiredReferences,
   lintConflicts,
   loadConflictEntries,
+  loadEmbedder,
   pairSimilarity,
   planContext,
+  readEmbedConfig,
   readEventLedger,
+  readFusion,
   readLedger,
   readMetrics,
   readSelectionToken,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-server",
-  "version": "2.3.0-rc.2",
+  "version": "2.3.0-rc.3",
   "description": "Fabric MCP knowledge server — stdio transport for Claude Code / Codex CLI, manages .fabric/ knowledge base + agents.meta.json + event ledger.",
   "license": "MIT",
   "author": "wangzhichao <fenglimg90@gmail.com>",
@@ -37,7 +37,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "minimatch": "^10.0.1",
     "zod": "^3.25.0",
-    "@fenglimg/fabric-shared": "2.3.0-rc.2"
+    "@fenglimg/fabric-shared": "2.3.0-rc.3"
   },
   "optionalDependencies": {
     "fastembed": "^2.0.0"