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

package/dist/{chunk-PPV5IQGX.js → chunk-CVNJCAC7.js}

@@ -50,8 +50,14 @@ var _maturityEnum = z3.enum(["draft", "verified", "proven"]);
 var _ruleDescriptionSchema = z3.object({
   summary: z3.string(),
   intent_clues: z3.array(z3.string()),
-  tech_stack: z3.array(z3.string()),
-  impact: z3.array(z3.string()),
+  // wire-slim (payload): fab_recall projects a LEAN description (summary +
+  // must_read_if + intent_clues + knowledge_type — the selection signal), leaving
+  // tech_stack/impact to be Read on demand via read_path (KT-DEC-0026 lean
+  // contract at the field level). So they are optional on the wire. plan-context
+  // still returns them in full — zod keeps optional-present values, only ABSENT is
+  // now allowed, so no plan-context consumer regresses.
+  tech_stack: z3.array(z3.string()).optional(),
+  impact: z3.array(z3.string()).optional(),
   must_read_if: z3.string(),
   // v2.0: optional knowledge-entry fields. Absent for v1.x rules; present for
   // entries that declare frontmatter `id/type/maturity`. W4/Track1: the redundant
@@ -73,7 +79,12 @@ var _ruleDescriptionSchema = z3.object({
   // schema must also carry `related`, else zod strips the graph edges on output
   // validation and they never reach the client (MC1 include_related / fabric-
   // connect would see nothing). Mirrors the agents-meta ruleDescriptionSchema.
-  related: z3.array(z3.string()).optional()
+  related: z3.array(z3.string()).optional(),
+  // v2.2 glossary aliases FIELD (C-001): mirrors agents.ts RuleDescription.
+  // MUST be declared here or zod .strip() drops aliases on output validation
+  // before plan-context feeds them into the BM25 body — long-tail alias terms
+  // would never reach the lexical/vector index (KT-PIT-0018 zod-strip lesson).
+  aliases: z3.array(z3.string()).optional()
 });
 var _descriptionIndexItemSchema = z3.object({
   stable_id: z3.string(),
@@ -333,7 +344,14 @@ var _recallEntrySchema = z3.object({
     vector_rank: z3.number().optional(),
     salience: z3.number(),
     recency: z3.number(),
-    locality: z3.number()
+    locality: z3.number(),
+    // BORROW-008 proximity boost — MUST be declared or zod .strip() drops it at
+    // the MCP boundary (KT-PIT-0005), desyncing wire `final` from its components.
+    proximity: z3.number(),
+    // PLN-004 F1 credibility content-age decay MULTIPLIER factor — optional
+    // (only present once the multiplier is wired). MUST be declared or zod
+    // .strip() drops it at the MCP boundary (KT-PIT-0005).
+    credibility: z3.number().optional()
   }).optional()
 });
 var recallOutputSchema = z3.object({

package/dist/{index-Ba3sXdL4.d.ts → index-B2e0wKJi.d.ts}

@@ -17,6 +17,7 @@ interface RuleDescription {
     relevance_scope?: "narrow" | "broad";
     relevance_paths?: string[];
     related?: string[];
+    aliases?: string[];
 }
 interface RuleDescriptionIndexItem {
     stable_id: string;
@@ -36,6 +37,8 @@ interface RecallScoreBreakdown {
     salience: number;
     recency: number;
     locality: number;
+    proximity: number;
+    credibility?: number;
 }
 interface AgentsMetaNode {
     file: string;
@@ -484,6 +487,14 @@ declare const fabricConfigSchema: z.ZodObject<{
     orphan_demote_proven_days: z.ZodOptional<z.ZodNumber>;
     orphan_demote_verified_days: z.ZodOptional<z.ZodNumber>;
     orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_decisions_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_guidelines_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_models_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_pitfalls_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_processes_days: z.ZodOptional<z.ZodNumber>;
+    credibility_floor_draft: z.ZodOptional<z.ZodNumber>;
+    credibility_floor_verified: z.ZodOptional<z.ZodNumber>;
+    credibility_floor_proven: z.ZodOptional<z.ZodNumber>;
     broad_review_recheck_days: z.ZodOptional<z.ZodNumber>;
     hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -558,6 +569,14 @@ declare const fabricConfigSchema: z.ZodObject<{
     orphan_demote_proven_days?: number | undefined;
     orphan_demote_verified_days?: number | undefined;
     orphan_demote_draft_days?: number | undefined;
+    credibility_half_life_decisions_days?: number | undefined;
+    credibility_half_life_guidelines_days?: number | undefined;
+    credibility_half_life_models_days?: number | undefined;
+    credibility_half_life_pitfalls_days?: number | undefined;
+    credibility_half_life_processes_days?: number | undefined;
+    credibility_floor_draft?: number | undefined;
+    credibility_floor_verified?: number | undefined;
+    credibility_floor_proven?: number | undefined;
     broad_review_recheck_days?: number | undefined;
     selection_token_ttl_ms?: number | undefined;
     plan_context_top_k?: number | undefined;
@@ -620,6 +639,14 @@ declare const fabricConfigSchema: z.ZodObject<{
     orphan_demote_proven_days?: number | undefined;
     orphan_demote_verified_days?: number | undefined;
     orphan_demote_draft_days?: number | undefined;
+    credibility_half_life_decisions_days?: number | undefined;
+    credibility_half_life_guidelines_days?: number | undefined;
+    credibility_half_life_models_days?: number | undefined;
+    credibility_half_life_pitfalls_days?: number | undefined;
+    credibility_half_life_processes_days?: number | undefined;
+    credibility_floor_draft?: number | undefined;
+    credibility_floor_verified?: number | undefined;
+    credibility_floor_proven?: number | undefined;
     broad_review_recheck_days?: number | undefined;
     hint_summary_max_len?: number | undefined;
     hint_reminder_to_context?: boolean | undefined;
@@ -713,6 +740,14 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     orphan_demote_proven_days: z.ZodOptional<z.ZodNumber>;
     orphan_demote_verified_days: z.ZodOptional<z.ZodNumber>;
     orphan_demote_draft_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_decisions_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_guidelines_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_models_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_pitfalls_days: z.ZodOptional<z.ZodNumber>;
+    credibility_half_life_processes_days: z.ZodOptional<z.ZodNumber>;
+    credibility_floor_draft: z.ZodOptional<z.ZodNumber>;
+    credibility_floor_verified: z.ZodOptional<z.ZodNumber>;
+    credibility_floor_proven: z.ZodOptional<z.ZodNumber>;
     broad_review_recheck_days: z.ZodOptional<z.ZodNumber>;
     hint_summary_max_len: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     hint_reminder_to_context: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -798,6 +833,14 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     orphan_demote_proven_days?: number | undefined;
     orphan_demote_verified_days?: number | undefined;
     orphan_demote_draft_days?: number | undefined;
+    credibility_half_life_decisions_days?: number | undefined;
+    credibility_half_life_guidelines_days?: number | undefined;
+    credibility_half_life_models_days?: number | undefined;
+    credibility_half_life_pitfalls_days?: number | undefined;
+    credibility_half_life_processes_days?: number | undefined;
+    credibility_floor_draft?: number | undefined;
+    credibility_floor_verified?: number | undefined;
+    credibility_floor_proven?: number | undefined;
     broad_review_recheck_days?: number | undefined;
     selection_token_ttl_ms?: number | undefined;
     plan_context_top_k?: number | undefined;
@@ -860,6 +903,14 @@ declare const fabricConfigLoadSchema: z.ZodObject<{
     orphan_demote_proven_days?: number | undefined;
     orphan_demote_verified_days?: number | undefined;
     orphan_demote_draft_days?: number | undefined;
+    credibility_half_life_decisions_days?: number | undefined;
+    credibility_half_life_guidelines_days?: number | undefined;
+    credibility_half_life_models_days?: number | undefined;
+    credibility_half_life_pitfalls_days?: number | undefined;
+    credibility_half_life_processes_days?: number | undefined;
+    credibility_floor_draft?: number | undefined;
+    credibility_floor_verified?: number | undefined;
+    credibility_floor_proven?: number | undefined;
     broad_review_recheck_days?: number | undefined;
     hint_summary_max_len?: number | undefined;
     hint_reminder_to_context?: boolean | undefined;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, S as StoreIdentity, c as StoreProject, G as GlobalConfig, F as FabricConfig, M as MountedStore, R as RequiredStoreEntry, d as AgentsMeta, L as LedgerEntry } from './index-Ba3sXdL4.js';
-export { e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, j as FabricLanguage, k as GLOBAL_BINDINGS_DIR, l as GLOBAL_STATE_DIR, m as HumanLedgerEntry, n as McpPayloadLimits, P as PERSONAL_STORE_SENTINEL, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem, s as STORES_ROOT_DIR, t as STORE_ALIAS_PATTERN, u as STORE_KNOWLEDGE_TYPE_DIRS, v as STORE_LAYOUT, w as STORE_MOUNT_GROUPS, x as STORE_MOUNT_NAME_PATTERN, y as STORE_PROJECT_ID_PATTERN, z as STORE_UUID_PATTERN, B as StoreLayout, E as StoreMountGroup, I as StoreProjectsFile, J as auditModeSchema, K as clientPathsSchema, N as defaultLayerFilterSchema, O as deriveMountLabel, Q as fabricConfigLoadSchema, T as fabricLanguageSchema, U as globalConfigSchema, V as isNonPersonalRequiredStore, W as mcpPayloadLimitsSchema, X as migrateRequiredStores, Y as mountedStoreSchema, Z as nudgeModeSchema, _ as observeConfigSchema, $ as planContextTopKSchema, a0 as requiredStoreEntrySchema, a1 as selectionTokenTtlMsSchema, a2 as storeAliasSchema, a3 as storeIdentitySchema, a4 as storeKnowledgeTypeDir, a5 as storeMountGroup, a6 as storeMountNameSchema, a7 as storeMountSubPath, a8 as storeProjectSchema, a9 as storeProjectsFileSchema, aa as storeRelativePath, ab as storeRelativePathForMount, ac as storeUuidSchema, ad as writeRouteSchema } from './index-Ba3sXdL4.js';
+import { A as AgentsMetaNode, a as AgentsIdentitySource, b as AgentsTopologyType, H as HumanLockEntry, f as fabricConfigSchema, S as StoreIdentity, c as StoreProject, G as GlobalConfig, F as FabricConfig, M as MountedStore, R as RequiredStoreEntry, d as AgentsMeta, L as LedgerEntry } from './index-B2e0wKJi.js';
+export { e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, j as FabricLanguage, k as GLOBAL_BINDINGS_DIR, l as GLOBAL_STATE_DIR, m as HumanLedgerEntry, n as McpPayloadLimits, P as PERSONAL_STORE_SENTINEL, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem, s as STORES_ROOT_DIR, t as STORE_ALIAS_PATTERN, u as STORE_KNOWLEDGE_TYPE_DIRS, v as STORE_LAYOUT, w as STORE_MOUNT_GROUPS, x as STORE_MOUNT_NAME_PATTERN, y as STORE_PROJECT_ID_PATTERN, z as STORE_UUID_PATTERN, B as StoreLayout, E as StoreMountGroup, I as StoreProjectsFile, J as auditModeSchema, K as clientPathsSchema, N as defaultLayerFilterSchema, O as deriveMountLabel, Q as fabricConfigLoadSchema, T as fabricLanguageSchema, U as globalConfigSchema, V as isNonPersonalRequiredStore, W as mcpPayloadLimitsSchema, X as migrateRequiredStores, Y as mountedStoreSchema, Z as nudgeModeSchema, _ as observeConfigSchema, $ as planContextTopKSchema, a0 as requiredStoreEntrySchema, a1 as selectionTokenTtlMsSchema, a2 as storeAliasSchema, a3 as storeIdentitySchema, a4 as storeKnowledgeTypeDir, a5 as storeMountGroup, a6 as storeMountNameSchema, a7 as storeMountSubPath, a8 as storeProjectSchema, a9 as storeProjectsFileSchema, aa as storeRelativePath, ab as storeRelativePathForMount, ac as storeUuidSchema, ad as writeRouteSchema } from './index-B2e0wKJi.js';
 import { T as Translator } from './types-qg4xXVuT.js';
 export { L as Locale, M as Messages, a as TranslationKey } from './types-qg4xXVuT.js';
 export { PROTECTED_TOKENS, ProtectedToken, createTranslator, defaultMessages, detectNodeLocale, enMessages, normalizeLocale, resolveFabricLocale, resolveGlobalLocale, zhCNMessages } from './i18n/index.js';

package/dist/index.js

@@ -116,7 +116,7 @@ import {
   scopeCoordinateSchema,
   scopeRoot,
   structuredWarningSchema
-} from "./chunk-PPV5IQGX.js";
+} from "./chunk-CVNJCAC7.js";
 
 // src/schemas/agents-meta.ts
 import { z } from "zod";
@@ -701,6 +701,27 @@ var fabricConfigSchema = z5.object({
   orphan_demote_proven_days: z5.number().int().min(1).max(3650).optional(),
   orphan_demote_verified_days: z5.number().int().min(1).max(3650).optional(),
   orphan_demote_draft_days: z5.number().int().min(1).max(3650).optional(),
+  // PLN-004 F1 (credibility content-age decay): per-knowledge-type half-lives
+  // (days) for the recall-scoring credibility MULTIPLIER. Orthogonal to the
+  // orphan_demote usage-inactivity ladder above (that is last-activity age; this
+  // is content age off created_at) and to recencyBoost (a 7-day additive
+  // freshness bump). Team-curated knowledge decays slower than transient work, so
+  // defaults run longer than upstream: decisions 180 / guidelines 150 / models
+  // 150 / pitfalls 120 / processes 120 (applied in config-loader). Each optional;
+  // absent → the loader default. Range 1..3650 mirrors orphan_demote.
+  credibility_half_life_decisions_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_guidelines_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_models_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_pitfalls_days: z5.number().int().min(1).max(3650).optional(),
+  credibility_half_life_processes_days: z5.number().int().min(1).max(3650).optional(),
+  // PLN-004 F1: per-maturity floor the credibility multiplier never decays below
+  // (a stale-but-endorsed entry keeps a minimum weight). Higher maturity → higher
+  // floor: draft 0.4 / verified 0.55 / proven 0.7 (config-loader defaults). Range
+  // [0,1]. This is the softened form of the "content leads structural" invariant —
+  // credibility may sink a stale match but never zero it.
+  credibility_floor_draft: z5.number().min(0).max(1).optional(),
+  credibility_floor_verified: z5.number().min(0).max(1).optional(),
+  credibility_floor_proven: z5.number().min(0).max(1).optional(),
   // v2.2 C1 (processes/maturity-promotion-rubric-v1): days a `broad` entry may
   // go without a fab-review re-confirmation before doctor surfaces a RECHECK
   // nudge. `broad` is EXEMPT from usage-age decay (it is SessionStart-pushed,

package/dist/schemas/api-contracts.d.ts

@@ -91,8 +91,8 @@ declare const planContextOutputSchema: z.ZodObject<{
         description: z.ZodObject<{
             summary: z.ZodString;
             intent_clues: z.ZodArray<z.ZodString, "many">;
-            tech_stack: z.ZodArray<z.ZodString, "many">;
-            impact: z.ZodArray<z.ZodString, "many">;
+            tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             must_read_if: z.ZodString;
             id: z.ZodOptional<z.ZodString>;
             knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
@@ -102,51 +102,55 @@ declare const planContextOutputSchema: z.ZodObject<{
             relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
             relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         }, {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         }>;
         always_active: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         always_active?: boolean | undefined;
@@ -154,17 +158,18 @@ declare const planContextOutputSchema: z.ZodObject<{
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         always_active?: boolean | undefined;
@@ -237,17 +242,18 @@ declare const planContextOutputSchema: z.ZodObject<{
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         always_active?: boolean | undefined;
@@ -291,17 +297,18 @@ declare const planContextOutputSchema: z.ZodObject<{
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         always_active?: boolean | undefined;
@@ -595,8 +602,8 @@ declare const recallOutputSchema: z.ZodObject<{
         description: z.ZodObject<{
             summary: z.ZodString;
             intent_clues: z.ZodArray<z.ZodString, "many">;
-            tech_stack: z.ZodArray<z.ZodString, "many">;
-            impact: z.ZodArray<z.ZodString, "many">;
+            tech_stack: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            impact: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             must_read_if: z.ZodString;
             id: z.ZodOptional<z.ZodString>;
             knowledge_type: z.ZodOptional<z.ZodEnum<["models", "decisions", "guidelines", "pitfalls", "processes"]>>;
@@ -606,34 +613,37 @@ declare const recallOutputSchema: z.ZodObject<{
             relevance_scope: z.ZodOptional<z.ZodEnum<["narrow", "broad"]>>;
             relevance_paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             related: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            aliases: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         }, {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         }>;
         read_path: z.ZodOptional<z.ZodString>;
         store: z.ZodOptional<z.ZodObject<{
@@ -654,40 +664,47 @@ declare const recallOutputSchema: z.ZodObject<{
             salience: z.ZodNumber;
             recency: z.ZodNumber;
             locality: z.ZodNumber;
+            proximity: z.ZodNumber;
+            credibility: z.ZodOptional<z.ZodNumber>;
         }, "strip", z.ZodTypeAny, {
             final: number;
             salience: number;
             recency: number;
             locality: number;
+            proximity: number;
             bm25?: number | undefined;
             bm25_rank?: number | undefined;
             vector?: number | undefined;
             vector_rank?: number | undefined;
+            credibility?: number | undefined;
         }, {
             final: number;
             salience: number;
             recency: number;
             locality: number;
+            proximity: number;
             bm25?: number | undefined;
             bm25_rank?: number | undefined;
             vector?: number | undefined;
             vector_rank?: number | undefined;
+            credibility?: number | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         rank: number;
@@ -702,26 +719,29 @@ declare const recallOutputSchema: z.ZodObject<{
             salience: number;
             recency: number;
             locality: number;
+            proximity: number;
             bm25?: number | undefined;
             bm25_rank?: number | undefined;
             vector?: number | undefined;
             vector_rank?: number | undefined;
+            credibility?: number | undefined;
         } | undefined;
     }, {
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         rank: number;
@@ -736,10 +756,12 @@ declare const recallOutputSchema: z.ZodObject<{
             salience: number;
             recency: number;
             locality: number;
+            proximity: number;
             bm25?: number | undefined;
             bm25_rank?: number | undefined;
             vector?: number | undefined;
             vector_rank?: number | undefined;
+            credibility?: number | undefined;
         } | undefined;
     }>, "many">;
     intent: z.ZodOptional<z.ZodString>;
@@ -802,17 +824,18 @@ declare const recallOutputSchema: z.ZodObject<{
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         rank: number;
@@ -827,10 +850,12 @@ declare const recallOutputSchema: z.ZodObject<{
             salience: number;
             recency: number;
             locality: number;
+            proximity: number;
             bm25?: number | undefined;
             bm25_rank?: number | undefined;
             vector?: number | undefined;
             vector_rank?: number | undefined;
+            credibility?: number | undefined;
         } | undefined;
     }[];
     stale: boolean;
@@ -865,17 +890,18 @@ declare const recallOutputSchema: z.ZodObject<{
         description: {
             summary: string;
             intent_clues: string[];
-            tech_stack: string[];
-            impact: string[];
             must_read_if: string;
             created_at?: string | undefined;
             id?: string | undefined;
             relevance_scope?: "narrow" | "broad" | undefined;
             relevance_paths?: string[] | undefined;
+            tech_stack?: string[] | undefined;
+            impact?: string[] | undefined;
             knowledge_type?: "models" | "decisions" | "guidelines" | "pitfalls" | "processes" | undefined;
             maturity?: "draft" | "verified" | "proven" | undefined;
             tags?: string[] | undefined;
             related?: string[] | undefined;
+            aliases?: string[] | undefined;
         };
         stable_id: string;
         rank: number;
@@ -890,10 +916,12 @@ declare const recallOutputSchema: z.ZodObject<{
             salience: number;
             recency: number;
             locality: number;
+            proximity: number;
             bm25?: number | undefined;
             bm25_rank?: number | undefined;
             vector?: number | undefined;
             vector_rank?: number | undefined;
+            credibility?: number | undefined;
         } | undefined;
     }[];
     stale: boolean;

package/dist/schemas/api-contracts.js

@@ -47,7 +47,7 @@ import {
   recallInputSchema,
   recallOutputSchema,
   structuredWarningSchema
-} from "../chunk-PPV5IQGX.js";
+} from "../chunk-CVNJCAC7.js";
 export {
   FabExtractKnowledgeInputSchema,
   FabExtractKnowledgeInputShape,

package/dist/types/index.d.ts

@@ -1,2 +1,2 @@
-export { a as AgentsIdentitySource, d as AgentsMeta, e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, b as AgentsTopologyType, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, j as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, n as McpPayloadLimits, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem } from '../index-Ba3sXdL4.js';
+export { a as AgentsIdentitySource, d as AgentsMeta, e as AgentsMetaCountersEnvelope, g as AgentsMetaKnowledgeTypeCounters, A as AgentsMetaNode, b as AgentsTopologyType, h as AiLedgerEntry, i as AuditMode, C as ClientPaths, D as DefaultLayerFilter, F as FabricConfig, j as FabricLanguage, m as HumanLedgerEntry, H as HumanLockEntry, L as LedgerEntry, n as McpPayloadLimits, o as RecallScore, p as RecallScoreBreakdown, q as RuleDescription, r as RuleDescriptionIndexItem } from '../index-B2e0wKJi.js';
 import 'zod';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-shared",
-  "version": "2.3.0-rc.6",
+  "version": "2.3.0-rc.8",
   "description": "Fabric shared types — Zod schemas, i18n, atomic-write helpers, MCP payload guard, error classes. Consumed by @fenglimg/fabric-server + @fenglimg/fabric-cli.",
   "license": "MIT",
   "author": "wangzhichao <fenglimg90@gmail.com>",