@fenglimg/fabric-server 2.3.0-rc.11 → 2.3.0-rc.12

package/dist/index.d.ts

@@ -995,25 +995,35 @@ type RecallInput = PlanContextInput & {
      * (W1-3 / KT-DEC-0031: surface the related id, do not fetch its body).
      */
     include_related?: boolean;
+    /**
+     * TASK-006 (KT-PIT-0036 observability opt-in): when true, populate
+     * `entry.score_breakdown` with the numbers-only signal decomposition
+     * (bm25/vector/salience/recency/locality/proximity/credibility → final).
+     * Off by default for wire efficiency. Enable when debugging ranking or tuning
+     * scoring weights. The final===score invariant is enforced at the plan-context
+     * service layer (candidate_scores Map) regardless of this flag.
+     */
+    include_score_breakdown?: boolean;
 };
 type FullRuleDescription = PlanContextResult["candidates"][number]["description"];
-type RecallEntryDescription = Pick<FullRuleDescription, "summary" | "must_read_if" | "intent_clues"> & Partial<Pick<FullRuleDescription, "knowledge_type">>;
+type RecallEntryDescription = Pick<FullRuleDescription, "summary"> & Partial<Pick<FullRuleDescription, "must_read_if" | "impact" | "knowledge_type">>;
 type RecallEntry = {
     stable_id: string;
-    rank: number;
     description: RecallEntryDescription;
     read_path?: string;
-    store?: {
-        alias: string;
-    };
+    store_alias?: string;
     body_in_context?: boolean;
-    score?: number;
     score_breakdown?: RecallScoreBreakdown;
 };
-type RecallResult = Omit<PlanContextResult, "selection_token" | "payload_trimmed" | "payload_over_budget" | "entries" | "candidates" | "candidate_scores"> & {
+type RecallResult = Omit<PlanContextResult, "selection_token" | "payload_trimmed" | "payload_over_budget" | "entries" | "candidates" | "candidate_scores" | "stale" | "intent" | "dropped" | "preflight_diagnostics"> & {
     entries: RecallEntry[];
-    directive: string;
     next_steps?: string[];
+    dropped_ids?: string[];
+    dropped_reasons?: {
+        retrieval_budget?: number;
+        payload_budget?: number;
+    };
+    preflight_diagnostics?: PreflightDiagnostic[];
 };
 declare function recall(projectRoot: string, input: RecallInput): Promise<RecallResult>;