@remnic/core 9.69.88 → 9.69.90

package/dist/who-knows-cli.js

@@ -4,26 +4,26 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-PEBHPCX2.js";
-import "./chunk-6UQFJULG.js";
-import "./chunk-STEOT4DI.js";
+} from "./chunk-KTG23JDX.js";
+import "./chunk-VBNA2JEN.js";
+import "./chunk-SCPHU3RW.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-LV5H6FTN.js";
-import "./chunk-4OQET73E.js";
-import "./chunk-T2YX56QI.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-T3FMRLWQ.js";
+import "./chunk-SFSD5Q6O.js";
+import "./chunk-O57FCN42.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-Z4TXB4K7.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-4O6WRBGE.js";
+import "./chunk-5BUCKFRE.js";
+import "./chunk-DPG5HQLE.js";
+import "./chunk-XWSUK5GL.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-D5HQ3VEX.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-TFA6HPOA.js";
-import "./chunk-F4TWWUMP.js";
+import "./chunk-4O6WRBGE.js";
+import "./chunk-WQUGCOKF.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
+import "./chunk-F4TWWUMP.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
@@ -34,10 +34,10 @@ import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-6O2VUWV6.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
 import "./chunk-345MEMRU.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-3ONXXHQO.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-G7D6GZ5J.js";
@@ -47,10 +47,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-B3OFQP5Y.js";
+import "./chunk-IY47KPML.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
 import "./chunk-ZLQ37WJX.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -83,7 +83,7 @@ import "./chunk-N4PYB235.js";
 import "./chunk-AW4QUFQF.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-PWF4JXKD.js";
+import "./chunk-RKDSELA3.js";
 import "./chunk-YBA52OKG.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
@@ -91,7 +91,7 @@ import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-BMXEBWBT.js";
+import "./chunk-2EMROIXS.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/dist/who-knows.js

@@ -9,25 +9,25 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-6UQFJULG.js";
-import "./chunk-STEOT4DI.js";
+} from "./chunk-VBNA2JEN.js";
+import "./chunk-SCPHU3RW.js";
 import "./chunk-UHVXE24Y.js";
 import "./chunk-46WM6JX2.js";
 import "./chunk-V4JZCTMK.js";
-import "./chunk-LV5H6FTN.js";
-import "./chunk-4OQET73E.js";
-import "./chunk-T2YX56QI.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-T3FMRLWQ.js";
+import "./chunk-SFSD5Q6O.js";
+import "./chunk-O57FCN42.js";
 import "./chunk-7VO6E5UD.js";
-import "./chunk-Z4TXB4K7.js";
-import "./chunk-S7LWX2PQ.js";
-import "./chunk-4O6WRBGE.js";
+import "./chunk-5BUCKFRE.js";
+import "./chunk-DPG5HQLE.js";
+import "./chunk-XWSUK5GL.js";
+import "./chunk-CYEPCZN5.js";
+import "./chunk-D5HQ3VEX.js";
 import "./chunk-GUMZC2BO.js";
-import "./chunk-TFA6HPOA.js";
-import "./chunk-F4TWWUMP.js";
+import "./chunk-4O6WRBGE.js";
+import "./chunk-WQUGCOKF.js";
 import "./chunk-72A4L5JJ.js";
 import "./chunk-A7Q43EUZ.js";
+import "./chunk-F4TWWUMP.js";
 import "./chunk-S2V7RUCL.js";
 import "./chunk-MRPOZBJC.js";
 import "./chunk-S2HLHAZ4.js";
@@ -38,10 +38,10 @@ import "./chunk-2DT7PIDZ.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-6O2VUWV6.js";
 import "./chunk-ZIKENA2C.js";
-import "./chunk-3ONXXHQO.js";
-import "./chunk-YXZG5TVN.js";
 import "./chunk-345MEMRU.js";
 import "./chunk-SCU65EZI.js";
+import "./chunk-3ONXXHQO.js";
+import "./chunk-YXZG5TVN.js";
 import "./chunk-5GINB5LC.js";
 import "./chunk-3WU7XOFN.js";
 import "./chunk-G7D6GZ5J.js";
@@ -51,10 +51,10 @@ import "./chunk-RBOJCG4T.js";
 import "./chunk-R7QY5ZVB.js";
 import "./chunk-5WITETWU.js";
 import "./chunk-6CIAGZ6X.js";
-import "./chunk-B3OFQP5Y.js";
+import "./chunk-IY47KPML.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-G26YNEOC.js";
 import "./chunk-ZLQ37WJX.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-23G5P7TA.js";
 import "./chunk-C64XATK7.js";
 import "./chunk-42JKGUFJ.js";
@@ -87,7 +87,7 @@ import "./chunk-N4PYB235.js";
 import "./chunk-AW4QUFQF.js";
 import "./chunk-5FVVY2EB.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-PWF4JXKD.js";
+import "./chunk-RKDSELA3.js";
 import "./chunk-YBA52OKG.js";
 import "./chunk-PWPIERBM.js";
 import "./chunk-JDSVLVCG.js";
@@ -95,7 +95,7 @@ import "./chunk-5GKPFL3S.js";
 import "./chunk-JAKIDQB2.js";
 import "./chunk-P7FMDTKL.js";
 import "./chunk-VUFL7X3H.js";
-import "./chunk-BMXEBWBT.js";
+import "./chunk-2EMROIXS.js";
 import "./chunk-ZEFVK7XC.js";
 import "./chunk-6KH5NLQS.js";
 import "./chunk-P2QRMMVQ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.69.88",
+  "version": "9.69.90",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -36,6 +36,16 @@
       "remnic-source": "./src/abort-error.ts",
       "import": "./dist/abort-error.js"
     },
+    "./rerank-outcome": {
+      "types": "./dist/rerank-outcome.d.ts",
+      "remnic-source": "./src/rerank-outcome.ts",
+      "import": "./dist/rerank-outcome.js"
+    },
+    "./rerank-outcome.js": {
+      "types": "./dist/rerank-outcome.d.ts",
+      "remnic-source": "./src/rerank-outcome.ts",
+      "import": "./dist/rerank-outcome.js"
+    },
     "./salvage-envelope": {
       "types": "./dist/salvage-envelope.d.ts",
       "remnic-source": "./src/salvage-envelope.ts",
@@ -3287,7 +3297,7 @@
     "meilisearch": "^0.46.0",
     "node-gyp": "^12.3.0",
     "openai": "^6.0.0",
-    "undici": "^6.28.0",
+    "undici": "^6.28.1",
     "zod": "^3.25.28",
     "zod-to-json-schema": "^3.25.2"
   },
@@ -3317,7 +3327,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.69.88"
+    "@remnic/coding-graph": "^9.69.90"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-mcp-output-schemas.ts

@@ -14,6 +14,7 @@ const T_ARRAY = { type: "array" } as const;
 const T_OBJECT = { type: "object" } as const;
 const T_NULLABLE_OBJECT = { type: ["object", "null"] } as const;
 const T_NULLABLE_STRING = { type: ["string", "null"] } as const;
+const T_NULLABLE_NUMBER = { type: ["number", "null"] } as const;
 
 /** Build a JSON Schema object type with the given properties. */
 function objectSchema(
@@ -106,6 +107,7 @@ const TOOL_OUTPUT_SCHEMAS: Readonly<Record<string, Record<string, unknown>>> = {
       reason: T_STRING,
       detail: T_STRING,
     }),
+    storageCorpusVersionsAtRecallStart: { type: "array", items: objectSchema({ namespace: T_STRING, version: T_NULLABLE_NUMBER }) },
   }),
   recall_explain: objectSchema({
     found: T_BOOLEAN,

package/src/access-recall-corpus-versions.ts

@@ -0,0 +1,59 @@
+import type { RecallInvocationOptions } from "./orchestration/orchestrator-helpers.js";
+
+export type RecallCorpusVersion = { namespace: string; version: number | null };
+
+const DEFAULT_CAPTURE_TIMEOUT_MS = 250;
+
+export function mergeRecallCorpusVersions(
+  current: RecallCorpusVersion[],
+  captured: RecallCorpusVersion[],
+): RecallCorpusVersion[] {
+  const versions = new Map(current.map((entry) => [entry.namespace, entry]));
+  for (const entry of captured) {
+    if (!versions.has(entry.namespace)) versions.set(entry.namespace, entry);
+  }
+  return [...versions.values()];
+}
+
+export function createRecallCorpusVersionCapture(
+  orchestrator: { getStorage(namespace: string): Promise<{ getMemoryCorpusVersion(): number }> },
+  signal: AbortSignal | undefined,
+  setVersions: (versions: RecallCorpusVersion[]) => void,
+  includeNoRecall = false,
+  timeoutMs = DEFAULT_CAPTURE_TIMEOUT_MS,
+): NonNullable<RecallInvocationOptions["onRecallPlanResolved"]> {
+  return async (mode, namespaces) => {
+    if ((mode === "no_recall" && !includeNoRecall) || signal?.aborted) return;
+    const captured = await Promise.all(namespaces.map(async (namespace) => {
+      let timer: ReturnType<typeof setTimeout> | undefined;
+      let abortCapture: (() => void) | undefined;
+      try {
+        const timeout = new Promise<null>((resolve) => {
+          timer = setTimeout(() => resolve(null), timeoutMs);
+        });
+        const aborted = signal
+          ? new Promise<null>((resolve) => {
+              if (signal.aborted) {
+                resolve(null);
+              } else {
+                abortCapture = () => resolve(null);
+                signal.addEventListener("abort", abortCapture, { once: true });
+              }
+            })
+          : undefined;
+        const version = await Promise.race([
+          orchestrator.getStorage(namespace).then((storage) => storage.getMemoryCorpusVersion()),
+          timeout,
+          ...(aborted ? [aborted] : []),
+        ]);
+        return { namespace, version };
+      } catch {
+        return { namespace, version: null };
+      } finally {
+        if (timer !== undefined) clearTimeout(timer);
+        if (abortCapture) signal?.removeEventListener("abort", abortCapture);
+      }
+    }));
+    if (!signal?.aborted) setVersions(captured);
+  };
+}

package/src/access-recall-response.ts

@@ -36,6 +36,7 @@ export async function assembleRecallResponse(
   request: EngramAccessRecallRequest;
   context: string;
   contextComposition?: RecallContextComposition;
+  storageCorpusVersionsAtRecallStart: Array<{ namespace: string; version: number | null }>;
   query: string;
   mode: RecallPlanMode | undefined;
   namespace: string;
@@ -55,6 +56,7 @@ export async function assembleRecallResponse(
     request,
     context,
     contextComposition,
+    storageCorpusVersionsAtRecallStart,
     query,
     mode,
     namespace,
@@ -321,6 +323,7 @@ export async function assembleRecallResponse(
       namespace: effectiveNamespace,
       context: effectiveContext,
       contextComposition: effectiveComposition,
+      storageCorpusVersionsAtRecallStart,
       ...(retrievalFailure ? { retrievalFailure } : {}),
       count: filterTags && filterTags.length > 0
         ? results.length

package/src/access-recall-surface.ts

@@ -21,9 +21,11 @@ import { type BudgetDecision, type BudgetReservation, CrossNamespaceBudget, toBu
 import { lcmEvidenceIdentity } from "./lcm/evidence-identity.js";
 import { normalizeProjectionTags } from "./memory-projection-format.js";
 import { namespaceIdentityFromToken } from "./namespaces/identity.js";
-import { canReadNamespace, defaultNamespaceForPrincipal, recallNamespacesForPrincipal, resolvePrincipal } from "./namespaces/principal.js";
-import { expandScopeProfileReadNamespaces, resolveScopeProfilePlan } from "./namespaces/scope-profiles.js";
+import { canReadNamespace, defaultNamespaceForPrincipal, resolvePrincipal } from "./namespaces/principal.js";
+import { resolveScopeProfilePlan } from "./namespaces/scope-profiles.js";
+import { resolveScopePlan } from "./scopes/scope-plan.js";
 import type { Orchestrator, RecallInvocationOptions } from "./orchestrator.js";
+import { createRecallCorpusVersionCapture, mergeRecallCorpusVersions } from "./access-recall-corpus-versions.js";
 import { decideDisclosureEscalation } from "./recall-disclosure-escalation.js";
 import { assembleRecallResponse } from "./access-recall-response.js";
 import { coerceIncludedMemories, type LastRecallSnapshot } from "./recall-state.js";
@@ -57,6 +59,7 @@ export interface AccessRecallSurfaceDeps {
     query: string;
     sessionKey?: string;
     snapshot: RecallXraySnapshot;
+    storageCorpusVersionsAtRecallStart: Array<{ namespace: string; version: number | null }>;
     disclosure: RecallDisclosure;
     startedAt: number;
     requestedMode?: RecallPlanMode | "auto";
@@ -187,6 +190,7 @@ export class AccessRecallSurface {
     query: string;
     sessionKey?: string;
     snapshot: RecallXraySnapshot;
+    storageCorpusVersionsAtRecallStart: Array<{ namespace: string; version: number | null }>;
     disclosure: RecallDisclosure;
     startedAt: number;
     requestedMode?: RecallPlanMode | "auto";
@@ -290,6 +294,7 @@ export class AccessRecallSurface {
       sourcesUsed,
       disclosure: options.disclosure,
       budgetsApplied: snapshotForSerialization.budgetsApplied,
+      storageCorpusVersionsAtRecallStart: options.storageCorpusVersionsAtRecallStart,
       latencyMs: snapshotForSerialization.latencyMs,
     };
   }
@@ -732,29 +737,17 @@ export class AccessRecallSurface {
           codingContext: profileCodingContext,
           codingOverlay: profileCodingOverlay,
         });
+    const recallScopePlan = resolveScopePlan({
+      config: this.deps.orchestrator.config,
+      sessionKey: request.sessionKey,
+      namespace: namespaceOverride,
+      principalOverride: authenticatedPrincipal,
+      codingContext: profileCodingContext,
+      namespacesEnabled: resolveNamespaceCapabilities(this.deps.orchestrator.config).namespaces,
+    });
     // Skip budget checks for modes that never perform a cross-namespace read.
     const modeSkipsBudget = mode === "no_recall";
-    // Derive the full set of namespaces the orchestrator will actually search.
-    // When no explicit override is provided, `recallNamespacesForPrincipal()` may
-    // expand to shared / policy-default namespaces.  Budget must be checked
-    // against every cross-namespace entry in the effective set so that omitting
-    // `namespace` cannot bypass the limiter (Cursor/Codex review feedback).
-    //
-    const legacyRecallNamespaces = Array.isArray(this.deps.orchestrator.config.defaultRecallNamespaces)
-      ? recallNamespacesForPrincipal(principal, this.deps.orchestrator.config)
-      : [];
-    const effectiveNamespaces = namespaceOverride
-      ? [namespaceOverride]
-      : profilePlan
-        ? expandScopeProfileReadNamespaces({
-            profilePlan,
-            principalSelfNamespace: profilePlan.baseNamespace,
-            config: this.deps.orchestrator.config,
-            principal,
-            codingOverlay: profileCodingOverlay,
-            legacyRecallNamespaces,
-          })
-        : legacyRecallNamespaces;
+    const effectiveNamespaces = recallScopePlan.readNamespaces;
     const budgetPrincipalNamespace = profilePlan?.baseNamespace ?? principalNamespace;
     let budgetDecision: BudgetDecision;
     let willReserveBudget = false;
@@ -860,6 +853,7 @@ export class AccessRecallSurface {
       onContextComposition: (composition) => {
         contextComposition = composition;
       },
+      onRecallPlanResolved: createRecallCorpusVersionCapture(this.deps.orchestrator, request.abortSignal, (versions) => { storageCorpusVersionsAtRecallStart = mergeRecallCorpusVersions(storageCorpusVersionsAtRecallStart, versions); }, true),
       ...(authenticatedPrincipal ? { principalOverride: authenticatedPrincipal } : {}),
       ...(request.sourceConnector ? { sourceConnector: request.sourceConnector } : {}),
       ...(request.stateView !== undefined ? { stateView: request.stateView } : {}),
@@ -897,6 +891,7 @@ export class AccessRecallSurface {
     // operation — orchestrator.recall AND serialization / debug / response
     // construction — so ANY failure after the reserve releases the exact
     // budget entry (by token, review #4) instead of leaking it.
+    let storageCorpusVersionsAtRecallStart: Array<{ namespace: string; version: number | null }> = [];
     try {
       const context = await this.deps.orchestrator.recall(
         query,
@@ -907,6 +902,7 @@ export class AccessRecallSurface {
         request,
         context,
         contextComposition,
+        storageCorpusVersionsAtRecallStart,
         query,
         mode,
         namespace,
@@ -1063,6 +1059,7 @@ export class AccessRecallSurface {
     let recallStartedAt = Date.now();
 
     const recallSessionKey = request.sessionKey?.trim() || undefined;
+    let storageCorpusVersionsAtRecallStart: Array<{ namespace: string; version: number | null }> = [];
     let xrayResponse: {
       snapshotFound: boolean;
       snapshot?: RecallXraySnapshot;
@@ -1084,6 +1081,7 @@ export class AccessRecallSurface {
             ? { budgetCharsOverride: budgetOverride }
             : {}),
           ...(mode !== undefined ? { mode } : {}),
+          onRecallPlanResolved: createRecallCorpusVersionCapture(this.deps.orchestrator, request.abortSignal, (versions) => { storageCorpusVersionsAtRecallStart = mergeRecallCorpusVersions(storageCorpusVersionsAtRecallStart, versions); }, true),
           // When the caller supplies an authenticated principal, forward
           // it via the dedicated override channel so orchestrator-side
           // ACL decisions use the SAME principal the access-surface
@@ -1395,6 +1393,7 @@ export class AccessRecallSurface {
           startedAt: recallStartedAt,
           requestedMode: request.mode,
           normalizedMode: mode,
+          storageCorpusVersionsAtRecallStart,
           ...(xrayRawExcerptNamespace
             ? { rawExcerptNamespace: xrayRawExcerptNamespace }
             : {}),

package/src/access-service-raw-excerpt-read-gate.test.ts

@@ -124,7 +124,7 @@ function makeRawExcerptProbe(options: {
     resolveSelfNamespace: (sk?: string) =>
       Orchestrator.prototype.resolveSelfNamespace.call(orch, sk),
     async getStorage() {
-      return storage;
+      return { ...storage, getMemoryCorpusVersion: () => 0 };
     },
     lastRecall: new Map<string, LastRecallSnapshot>([
       [options.sessionKey, snapshot],

package/src/access-service.ts

@@ -446,6 +446,8 @@ export interface EngramAccessRecallResponse {
   /** Request-local split used by adapters that must re-render a tighter prompt budget. */
   contextComposition?: RecallContextComposition;
   retrievalFailure?: { reason: "backend_unavailable"; detail: string };
+  /** Storage corpus sentinel values read immediately before retrieval; they do not attest to QMD index application. */
+  storageCorpusVersionsAtRecallStart?: Array<{ namespace: string; version: number | null }>;
   count: number;
   memoryIds: string[];
   results: EngramAccessMemorySummary[];
@@ -2034,6 +2036,7 @@ export class EngramAccessService extends SupportPassportAccessServiceBase {
   private async buildRecallResponseFromXraySnapshot(options: {
     query: string;
     sessionKey?: string;
+    storageCorpusVersionsAtRecallStart: Array<{ namespace: string; version: number | null }>;
     snapshot: RecallXraySnapshot;
     disclosure: RecallDisclosure;
     startedAt: number;

package/src/capabilities.test.ts

@@ -1184,6 +1184,7 @@ const RECALL_ENH_FIELD_TO_FLAG: Record<keyof RecallEnhancementCapabilitySet, str
   responseGuidanceRecall: "responseGuidanceRecallEnabled",
   eventOrderRecall: "eventOrderRecallEnabled",
   reinforcementRecallBoost: "reinforcementRecallBoostEnabled",
+  outcomeBoost: "outcomeBoostEnabled",
   recallPlannerTelemetry: "recallPlannerTelemetryEnabled",
   peerProfileRecall: "peerProfileRecallEnabled",
   graphAssistShadowEval: "graphAssistShadowEvalEnabled",

package/src/capabilities.ts

@@ -1031,14 +1031,9 @@ export function resolveRecallAuxiliaryCapabilities(config: RecallAuxiliaryConfig
 }
 
 // ---------------------------------------------------------------------------
-// RecallEnhancement capability set (issue #1523 batch 9).
-//
-// These 24 flags gate recall enrichment, memory reconstruction, entity
-// relationships, causal trajectory recall, CMC retrieval, and related
-// enhancement paths. Read sites span orchestrator, access-service, graph-recall,
-// and CLI research-status commands. All flags are non-optional booleans on
-// PluginConfig (defaults resolved at the parse boundary), so the projection
-// is a pure pass-through.
+// RecallEnhancement capability set (issue #1523 batch 9, outcome prior #1958).
+// Gates recall enrichment and related paths. Flags are booleans on PluginConfig
+// (defaults resolved at parse), so the projection is a pure pass-through.
 // ---------------------------------------------------------------------------
 
 /**
@@ -1051,6 +1046,7 @@ export interface RecallEnhancementCapabilitySet {
   readonly responseGuidanceRecall: boolean;
   readonly eventOrderRecall: boolean;
   readonly reinforcementRecallBoost: boolean;
+  readonly outcomeBoost: boolean;
   readonly recallPlannerTelemetry: boolean;
   readonly peerProfileRecall: boolean;
   readonly graphAssistShadowEval: boolean;
@@ -1081,6 +1077,7 @@ export type RecallEnhancementConfigProjection = Pick<
   | "responseGuidanceRecallEnabled"
   | "eventOrderRecallEnabled"
   | "reinforcementRecallBoostEnabled"
+  | "outcomeBoostEnabled"
   | "recallPlannerTelemetryEnabled"
   | "peerProfileRecallEnabled"
   | "graphAssistShadowEvalEnabled"
@@ -1111,6 +1108,7 @@ export function resolveRecallEnhancementCapabilities(config: RecallEnhancementCo
     responseGuidanceRecall: config.responseGuidanceRecallEnabled,
     eventOrderRecall: config.eventOrderRecallEnabled,
     reinforcementRecallBoost: config.reinforcementRecallBoostEnabled,
+    outcomeBoost: config.outcomeBoostEnabled,
     recallPlannerTelemetry: config.recallPlannerTelemetryEnabled,
     peerProfileRecall: config.peerProfileRecallEnabled,
     graphAssistShadowEval: config.graphAssistShadowEvalEnabled === true,

package/src/config.ts

@@ -44,6 +44,7 @@ import {
   parseStandingBlockMaxChars,
 } from "./standing-memory-block.js";
 import { parseDirectorySidecarsEnabled } from "./directory-sidecars.js";
+import { parseOutcomeBoostWeight } from "./rerank-outcome.js";
 import { parseRecognitionIndexMaxEntries, parseRecallRecognitionTier } from "./recall-recognition-tier.js";
 import { parseRecallConcurrencyConfig } from "./recall-concurrency-config.js";
 import { parseExtractionFields } from "./extraction-span-config.js";
@@ -2622,6 +2623,8 @@ export function parseConfig(
       }
       return n;
     })(),
+    outcomeBoostEnabled: coerceBool(cfg.outcomeBoostEnabled) ?? false,
+    outcomeBoostWeight: parseOutcomeBoostWeight(cfg.outcomeBoostWeight),
     // Async peer profile reasoner (issue #679 PR 2/5). Defaults to
     // `false` (opt-in) per Gotchas #30/#48 — least-privileged default.
     // `coerceBool` handles "true"/"1"/"yes"/"on" CLI strings (Gotcha

package/src/index.ts

@@ -393,7 +393,7 @@ export { auditMemoryStore, auditScreenProfile, formatAuditMemoryReport, type Aud
 // Access layer (HTTP + MCP + schema validation)
 // ---------------------------------------------------------------------------
 
-export { EngramAccessService, EngramAccessInputError } from "./access-service.js";
+export { EngramAccessService, EngramAccessInputError, type EngramAccessRecallResponse } from "./access-service.js";
 export {
   EngramAccessHttpServer,
   type RemnicAdminConfigPatch,