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

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { FabExtractKnowledgeInput, FabExtractKnowledgeOutput, FabReviewInput, FabReviewOutput, FabPendingInput, FabPendingOutput } from '@fenglimg/fabric-shared/schemas/api-contracts';
-import { EventLedgerEventInput, EventLedgerEvent, RuleDescriptionIndexItem, LedgerEntry, AgentsMeta } from '@fenglimg/fabric-shared';
+import { EventLedgerEventInput, EventLedgerEvent, RuleDescriptionIndexItem, RecallScore, RecallScoreBreakdown, LedgerEntry, AgentsMeta } from '@fenglimg/fabric-shared';
 import { PayloadGuardOptions } from '@fenglimg/fabric-shared/node/mcp-payload-guard';
 
 interface InFlightTracker {
@@ -394,6 +394,29 @@ interface Bm25Model {
      * query property).
      */
     scoreDoc(id: string, queryTerms: string[]): number;
+    /**
+     * P1 recall-engine-refactor (TASK-002): the plain JSON-safe snapshot of the
+     * corpus statistics this model scores against, attached so the model can be
+     * serialized to disk (`serializeBm25Model`) and a cold hook can `rehydrate`
+     * an identical scorer without re-tokenizing the corpus.
+     */
+    readonly __serialized: SerializedBm25Model;
+}
+interface SerializedBm25Model {
+    /** Schema/format version — bump on any layout change so a stale on-disk cache
+     *  (different shape) is detected and discarded rather than mis-rehydrated. */
+    version: 1;
+    totalDocs: number;
+    /** term → document frequency (union-of-fields df), as [term, count] pairs. */
+    documentFrequency: [string, number][];
+    /** Per-field corpus average length. */
+    avgFieldLength: Record<Bm25Field, number>;
+    /** Per-doc stats: id → { per-field [term,freq] pairs, per-field length }. */
+    perDoc: {
+        id: string;
+        fieldTermFreq: Record<Bm25Field, [string, number][]>;
+        fieldLength: Record<Bm25Field, number>;
+    }[];
 }
 /**
  * Build a BM25F model over `docs`. Corpus statistics (per-field document
@@ -594,8 +617,10 @@ declare function reviewKnowledge(projectRoot: string, input: FabReviewInput): Pr
  * from `reviewKnowledge`. list browses the store-backed pending backlog;
  * search ranges over BOTH pending and canonical knowledge. Neither mutates
  * state — the fab_pending tool is registered readOnlyHint:true / idempotentHint:true.
- * The underlying listPending / searchEntries helpers are unchanged (verbatim
- * relocation), so behavior is identical to the prior fab_review list/search.
+ * P1 recall-engine-refactor (TASK-005): search now routes through `triageSearch`,
+ * which gates on the substring query then RANKS the matches via the shared
+ * rankDescriptionItems('triage') — NO top_k, NO floor, so pending review never
+ * silently drops a match. The old substring-only search machine is gone.
  */
 declare function reviewPending(projectRoot: string, input: FabPendingInput): Promise<FabPendingOutput>;
 
@@ -729,6 +754,7 @@ type PlanContextResult = {
     previous_revision_hash?: string;
     redirects?: Record<string, string>;
     related_appended?: Record<string, string>;
+    candidate_scores?: Map<string, RecallScore>;
     /** Internal service→tool signal; stripped before MCP output. */
     payload_trimmed?: boolean;
     /** Internal service→tool signal; stripped before MCP output. */
@@ -773,8 +799,10 @@ type RecallEntry = {
         alias: string;
     };
     body_in_context?: boolean;
+    score?: number;
+    score_breakdown?: RecallScoreBreakdown;
 };
-type RecallResult = Omit<PlanContextResult, "selection_token" | "payload_trimmed" | "payload_over_budget" | "entries" | "candidates"> & {
+type RecallResult = Omit<PlanContextResult, "selection_token" | "payload_trimmed" | "payload_over_budget" | "entries" | "candidates" | "candidate_scores"> & {
     entries: RecallEntry[];
     directive: string;
     next_steps?: string[];