@fenglimg/fabric-server 2.3.0-rc.6 → 2.3.0-rc.8

package/dist/index.d.ts

@@ -988,10 +988,12 @@ type RecallInput = PlanContextInput & {
      */
     include_related?: boolean;
 };
+type FullRuleDescription = PlanContextResult["candidates"][number]["description"];
+type RecallEntryDescription = Pick<FullRuleDescription, "summary" | "must_read_if" | "intent_clues"> & Partial<Pick<FullRuleDescription, "knowledge_type">>;
 type RecallEntry = {
     stable_id: string;
     rank: number;
-    description: PlanContextResult["candidates"][number]["description"];
+    description: RecallEntryDescription;
     read_path?: string;
     store?: {
         alias: string;

package/dist/index.js

@@ -817,6 +817,64 @@ function readOrphanDemoteThresholdDays(projectRoot) {
     return {};
   }
 }
+function readCredibilityHalfLives(projectRoot) {
+  const defaults = {
+    decisions: 180,
+    guidelines: 150,
+    models: 150,
+    pitfalls: 120,
+    processes: 120
+  };
+  try {
+    const cfg = readFabricConfig(projectRoot);
+    const validate = (v) => {
+      if (typeof v !== "number" || !Number.isFinite(v) || v < 1 || v > 3650 || !Number.isInteger(v)) {
+        return void 0;
+      }
+      return v;
+    };
+    const out = { ...defaults };
+    const dec = validate(cfg.credibility_half_life_decisions_days);
+    if (dec !== void 0) out.decisions = dec;
+    const gui = validate(cfg.credibility_half_life_guidelines_days);
+    if (gui !== void 0) out.guidelines = gui;
+    const mod = validate(cfg.credibility_half_life_models_days);
+    if (mod !== void 0) out.models = mod;
+    const pit = validate(cfg.credibility_half_life_pitfalls_days);
+    if (pit !== void 0) out.pitfalls = pit;
+    const pro = validate(cfg.credibility_half_life_processes_days);
+    if (pro !== void 0) out.processes = pro;
+    return out;
+  } catch {
+    return { ...defaults };
+  }
+}
+function readCredibilityFloors(projectRoot) {
+  const defaults = {
+    draft: 0.4,
+    verified: 0.55,
+    proven: 0.7
+  };
+  try {
+    const cfg = readFabricConfig(projectRoot);
+    const validate = (v) => {
+      if (typeof v !== "number" || !Number.isFinite(v) || v < 0 || v > 1) {
+        return void 0;
+      }
+      return v;
+    };
+    const out = { ...defaults };
+    const draft = validate(cfg.credibility_floor_draft);
+    if (draft !== void 0) out.draft = draft;
+    const verified = validate(cfg.credibility_floor_verified);
+    if (verified !== void 0) out.verified = verified;
+    const proven = validate(cfg.credibility_floor_proven);
+    if (proven !== void 0) out.proven = proven;
+    return out;
+  } catch {
+    return { ...defaults };
+  }
+}
 function readFusion(projectRoot) {
   try {
     const raw = readFabricConfig(projectRoot).fusion;
@@ -1109,7 +1167,9 @@ function extractRuleDescription(source) {
     relevance_scope: knowledge?.relevance_scope ?? "broad",
     relevance_paths: knowledge?.relevance_paths ?? [],
     // v2.2 H2-related (W1-T7): graph edges, undefined when absent.
-    related: knowledge?.related
+    related: knowledge?.related,
+    // v2.2 glossary aliases FIELD (C-002): synonym terms, undefined when absent.
+    aliases: knowledge?.aliases
   };
 }
 function extractDescriptionFromFrontmatter(frontmatter) {
@@ -1133,7 +1193,9 @@ function extractDescriptionFromFrontmatter(frontmatter) {
     relevance_scope: knowledge.relevance_scope,
     relevance_paths: knowledge.relevance_paths,
     // v2.2 H2-related (W1-T7): graph edges parsed from frontmatter.
-    related: knowledge.related
+    related: knowledge.related,
+    // v2.2 glossary aliases FIELD (C-002): synonym terms for the BM25 body.
+    aliases: knowledge.aliases
   };
 }
 function isForbiddenCrossLayerEdge(sourceLayer, targetId) {
@@ -1222,6 +1284,7 @@ function extractKnowledgeFieldsFromFrontmatter(frontmatter) {
     }
     return true;
   });
+  const aliases = extractInlineArray(frontmatter, "aliases");
   return {
     id,
     knowledge_type,
@@ -1230,7 +1293,8 @@ function extractKnowledgeFieldsFromFrontmatter(frontmatter) {
     tags: tags.length > 0 ? tags : void 0,
     relevance_scope,
     relevance_paths,
-    related: related.length > 0 ? related : void 0
+    related: related.length > 0 ? related : void 0,
+    aliases: aliases.length > 0 ? aliases : void 0
   };
 }
 function extractScalar(frontmatter, key) {
@@ -3491,7 +3555,11 @@ async function buildScoringContext(projectRoot, revision, rawItems, opts) {
   const scoringContext = {
     nowMs: Date.now(),
     targetPaths: opts.targetPaths,
-    queryTerms: buildQueryTerms(opts.queryText)
+    queryTerms: buildQueryTerms(opts.queryText),
+    // PLN-004 F1: resolve the credibility half-lives + floors ONCE here (never per
+    // candidate) so credibilityFactor is a pure lookup on the ranking hot path.
+    credibilityHalfLives: readCredibilityHalfLives(projectRoot),
+    credibilityFloors: readCredibilityFloors(projectRoot)
   };
   const docTexts = /* @__PURE__ */ new Map();
   for (const item of rawItems) {
@@ -3620,14 +3688,21 @@ function documentTextForItem(description) {
     ...description.intent_clues,
     ...description.tech_stack,
     ...description.impact,
-    ...description.tags ?? []
+    ...description.tags ?? [],
+    // v2.2 glossary aliases (C-002): long-tail synonym terms feed the flat
+    // vector-embedding document verbatim, same as the BM25F summary slot below.
+    ...description.aliases ?? []
   ].join(" ");
 }
 function documentFieldsForItem(description) {
   return {
     title: tokenize2(description.summary),
     tags: tokenize2([...description.tags ?? [], ...description.tech_stack].join(" ")),
-    summary: tokenize2([description.must_read_if, ...description.intent_clues].join(" ")),
+    summary: tokenize2(
+      [description.must_read_if, ...description.intent_clues, ...description.aliases ?? []].join(
+        " "
+      )
+    ),
     body: tokenize2(description.impact.join(" "))
   };
 }
@@ -3716,11 +3791,28 @@ function localityBoost(item, context) {
 function structuralScaleFor(context) {
   return context.fusion === "rrf" && context.queryTerms.length > 0 ? RRF_STRUCTURAL_SCALE : 1;
 }
+function credibilityFactor(item, context) {
+  const halfLives = context.credibilityHalfLives;
+  const floors = context.credibilityFloors;
+  if (halfLives === void 0 || floors === void 0) return 1;
+  const createdAtRaw = item.description?.created_at;
+  if (typeof createdAtRaw !== "string" || createdAtRaw.length === 0) return 1;
+  const createdMs = Date.parse(createdAtRaw);
+  if (!Number.isFinite(createdMs)) return 1;
+  const ageDays = (context.nowMs - createdMs) / (24 * 60 * 60 * 1e3);
+  if (ageDays <= 0) return 1;
+  const type = item.description?.knowledge_type;
+  const halfLife = type !== void 0 ? halfLives[type] : halfLives.decisions;
+  const factor = Math.pow(2, -ageDays / halfLife);
+  const maturity = item.description?.maturity;
+  const floor = maturity !== void 0 ? floors[maturity] : floors.draft;
+  return Math.max(floor, Math.min(1, factor));
+}
 function scoreDescriptionItem(item, context) {
   const content = contentScore(item, context);
   const structural = salienceScore(item) + recencyBoost(item, context) + localityBoost(item, context);
   const proximity = proximityBoost(item, context, content);
-  return content + structuralScaleFor(context) * structural + proximity;
+  return (content + structuralScaleFor(context) * structural + proximity) * credibilityFactor(item, context);
 }
 function scoreBreakdownForItem(item, context) {
   const hasQuery = context.queryTerms.length > 0;
@@ -3742,7 +3834,9 @@ function scoreBreakdownForItem(item, context) {
   const salience = salienceScore(item) * scale;
   const recency = recencyBoost(item, context) * scale;
   const locality = localityBoost(item, context) * scale;
-  const final = bm25 + vector + salience + recency + locality;
+  const proximity = proximityBoost(item, context, bm25 + vector);
+  const credibility = credibilityFactor(item, context);
+  const final = (bm25 + vector + salience + recency + locality + proximity) * credibility;
   return {
     final,
     ...bm25 !== 0 ? { bm25 } : {},
@@ -3751,7 +3845,9 @@ function scoreBreakdownForItem(item, context) {
     ...vectorRank !== void 0 ? { vector_rank: vectorRank } : {},
     salience,
     recency,
-    locality
+    locality,
+    proximity,
+    credibility
   };
 }
 function localityTier(relevancePath, targetPath) {
@@ -3848,7 +3944,7 @@ async function recall(projectRoot, input) {
     return {
       stable_id: c.stable_id,
       rank: index + 1,
-      description: c.description,
+      description: slimDescription(c.description),
       ...readPath ? { read_path: readPath.path } : {},
       ...readPath?.store ? { store: readPath.store } : {},
       ...isAlwaysActive(c) ? { body_in_context: true } : {},
@@ -3868,6 +3964,14 @@ function isAlwaysActive(candidate) {
   const { relevance_scope, knowledge_type } = candidate.description;
   return (relevance_scope ?? "broad") !== "narrow" && ALWAYS_ACTIVE_TYPES2.has(knowledge_type ?? "");
 }
+function slimDescription(d) {
+  return {
+    summary: d.summary,
+    must_read_if: d.must_read_if,
+    intent_clues: d.intent_clues,
+    ...d.knowledge_type !== void 0 ? { knowledge_type: d.knowledge_type } : {}
+  };
+}
 function buildNextSteps(planResult, paths, candidateById, candidateLookup) {
   const nextSteps = [];
   const omitted = (planResult.dropped ?? []).filter((d) => d.reason === "retrieval_budget").length;
@@ -11513,7 +11617,7 @@ function createFabricServer(tracker) {
   const server = new McpServer(
     {
       name: "fabric-knowledge-server",
-      version: "2.3.0-rc.6"
+      version: "2.3.0-rc.8"
     },
     {
       instructions: FABRIC_SERVER_INSTRUCTIONS

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-server",
-  "version": "2.3.0-rc.6",
+  "version": "2.3.0-rc.8",
   "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.6"
+    "@fenglimg/fabric-shared": "2.3.0-rc.8"
   },
   "optionalDependencies": {
     "fastembed": "^2.0.0"