@remnic/core 9.69.38 → 9.69.39

package/dist/support-passport/index.js

@@ -4,7 +4,7 @@ import {
   SUPPORT_PASSPORT_MODEL_RESULT_PATH,
   SupportPassportModelBridge,
   parseSupportPassportModelJob
-} from "../chunk-74AHCL56.js";
+} from "../chunk-Q7CLGFA7.js";
 import {
   DEFAULT_SUPPORT_PASSPORT_CONFIG,
   parseSupportPassportConfig
@@ -14,8 +14,8 @@ import {
   buildSupportPassportPublicRequestHandler,
   composeSupportPassportExternalRequestHandlers,
   normalizeSupportPassportNetworkAddress
-} from "../chunk-HVS7TH2Y.js";
-import "../chunk-UQNYPK7G.js";
+} from "../chunk-ZBW7A667.js";
+import "../chunk-D545Z7UH.js";
 import {
   SUPPORT_PASSPORT_DRAFT_MAX_CONTENT_CHARACTERS,
   SUPPORT_PASSPORT_DRAFT_MAX_MEMORIES,
@@ -56,14 +56,14 @@ import {
   notifySupportPassportCommitted,
   resolveSupportPassportModelRoutePlan,
   syncDirectoryForDurability
-} from "../chunk-62QIQEUC.js";
+} from "../chunk-UZEHHXYC.js";
 import "../chunk-W4F3C7N7.js";
 import "../chunk-MPC7TYTZ.js";
 import "../chunk-ZHXSOMYH.js";
+import "../chunk-CC37E3QM.js";
 import "../chunk-2J3V5QEO.js";
 import "../chunk-VQ7B2Q6M.js";
-import "../chunk-CC37E3QM.js";
-import "../chunk-BX4EOMKT.js";
+import "../chunk-3EKVN2OP.js";
 import "../chunk-PJSK6OJM.js";
 import "../chunk-GNVZQ5JN.js";
 import "../chunk-YN2UN7N3.js";
@@ -78,7 +78,7 @@ import "../chunk-H7XKCNR6.js";
 import "../chunk-M6HBPLBA.js";
 import "../chunk-SOBJ6NEY.js";
 import "../chunk-ZEGL7YCC.js";
-import "../chunk-GGAXFTNH.js";
+import "../chunk-O4M4BDIJ.js";
 import "../chunk-CVILPI77.js";
 import "../chunk-6WHJ2EAB.js";
 import "../chunk-AQEJKOKI.js";
@@ -87,7 +87,7 @@ import "../chunk-UD7UNYRD.js";
 import "../chunk-IISBCCWR.js";
 import "../chunk-2YA5N2BY.js";
 import "../chunk-HWLIMQE2.js";
-import "../chunk-6PRY6CLC.js";
+import "../chunk-4RZLTZVM.js";
 import "../chunk-EI6V5UXY.js";
 import "../chunk-CEO4DONG.js";
 import "../chunk-SGUDMW2K.js";
@@ -108,12 +108,12 @@ import "../chunk-SV4Z2S67.js";
 import "../chunk-WTWQA7BB.js";
 import "../chunk-VZIAVM72.js";
 import "../chunk-HRATODNO.js";
-import "../chunk-XGRXQR6T.js";
-import "../chunk-CBFYCDYO.js";
-import "../chunk-VHOSM5G4.js";
+import "../chunk-IL6ODG6M.js";
+import "../chunk-GI4ZBWPQ.js";
+import "../chunk-GG5FHZJJ.js";
 import "../chunk-UFGFMWAD.js";
 import "../chunk-BMWN7B3Y.js";
-import "../chunk-T32B72QX.js";
+import "../chunk-JTQR6L2N.js";
 import "../chunk-5FAGCOZD.js";
 import "../chunk-EUT2WCWS.js";
 import "../chunk-2LSZVONP.js";
@@ -127,24 +127,24 @@ import "../chunk-CSAKJVXW.js";
 import "../chunk-K2XUWZBM.js";
 import "../chunk-OD4FM2U7.js";
 import "../chunk-ZY2MNJR6.js";
-import "../chunk-R4VAUNNC.js";
+import "../chunk-VJIE4D2I.js";
 import "../chunk-3UXOZBHV.js";
 import "../chunk-V6EGNVUT.js";
-import "../chunk-TUKGXQ5T.js";
-import "../chunk-7S53BPTU.js";
-import "../chunk-UHVXE24Y.js";
+import "../chunk-5YCNDC3C.js";
+import "../chunk-CZTPU65V.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-BJEJUOGM.js";
-import "../chunk-OKO57IXB.js";
+import "../chunk-6YAIN5XJ.js";
+import "../chunk-4JVQRFZD.js";
+import "../chunk-TNSCIPBQ.js";
 import "../chunk-YQNNHLCG.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-BD7JTBYP.js";
 import "../chunk-OB3XMWX5.js";
-import "../chunk-CYEPCZN5.js";
-import "../chunk-TNSCIPBQ.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
+import "../chunk-CYEPCZN5.js";
 import "../chunk-TFA6HPOA.js";
 import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";
@@ -189,7 +189,7 @@ import "../chunk-6JMQR72P.js";
 import "../chunk-QLK3SL7Q.js";
 import "../chunk-FEHIOYML.js";
 import "../chunk-P32IDSHD.js";
-import "../chunk-255PC37A.js";
+import "../chunk-YDVAM7S4.js";
 import "../chunk-WNIUPHWV.js";
 import "../chunk-IJ6WHMFB.js";
 import "../chunk-3SG4FGDV.js";

package/dist/transfer/export-okf.js

@@ -4,26 +4,26 @@ import {
   exportOkfBundle,
   firstHeading,
   parseIncludeStatus
-} from "../chunk-TTSJ7WUC.js";
+} from "../chunk-VBSNUH4J.js";
 import {
   OKF_EXPORT_VERSION
 } from "../chunk-UJX4I26O.js";
 import "../chunk-D24OXEPB.js";
 import "../chunk-3UXOZBHV.js";
-import "../chunk-7S53BPTU.js";
-import "../chunk-UHVXE24Y.js";
+import "../chunk-CZTPU65V.js";
 import "../chunk-46WM6JX2.js";
+import "../chunk-UHVXE24Y.js";
 import "../chunk-D5F7TKMH.js";
-import "../chunk-BJEJUOGM.js";
-import "../chunk-OKO57IXB.js";
+import "../chunk-6YAIN5XJ.js";
+import "../chunk-4JVQRFZD.js";
+import "../chunk-TNSCIPBQ.js";
 import "../chunk-YQNNHLCG.js";
 import "../chunk-6KTXE6A3.js";
 import "../chunk-BD7JTBYP.js";
 import "../chunk-OB3XMWX5.js";
-import "../chunk-CYEPCZN5.js";
-import "../chunk-TNSCIPBQ.js";
 import "../chunk-4O6WRBGE.js";
 import "../chunk-GUMZC2BO.js";
+import "../chunk-CYEPCZN5.js";
 import "../chunk-TFA6HPOA.js";
 import "../chunk-F4TWWUMP.js";
 import "../chunk-72A4L5JJ.js";

package/dist/verified-recall.js

@@ -1,22 +1,22 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-ZKZFFWLV.js";
+} from "./chunk-AAZEKXUP.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-7S53BPTU.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-CZTPU65V.js";
 import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-BJEJUOGM.js";
-import "./chunk-OKO57IXB.js";
+import "./chunk-6YAIN5XJ.js";
+import "./chunk-4JVQRFZD.js";
+import "./chunk-TNSCIPBQ.js";
 import "./chunk-YQNNHLCG.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-TNSCIPBQ.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";

package/dist/who-knows-cli.d.ts

@@ -1,4 +1,4 @@
-import { W as WhoKnowsResult } from './access-service-gBcdRUHY.js';
+import { W as WhoKnowsResult } from './access-service-MY4bsr_Q.js';
 import './types-Cyr32ABj.js';
 import './message-parts/index.js';
 import './bounded-jsonl-state.js';
@@ -15,7 +15,7 @@ import './active-context-config.js';
 import './local-llm-config.js';
 import './semantic-merge-config.js';
 import './types-continuity.js';
-import './orchestrator-DocO0_hw.js';
+import './orchestrator-ComHLm49.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';

package/dist/who-knows-cli.js

@@ -4,22 +4,22 @@ import {
   renderWhoKnows,
   renderWhoKnowsJson,
   renderWhoKnowsText
-} from "./chunk-UIOIDW3L.js";
-import "./chunk-BX4EOMKT.js";
-import "./chunk-7S53BPTU.js";
-import "./chunk-UHVXE24Y.js";
+} from "./chunk-XH3HGI2N.js";
+import "./chunk-3EKVN2OP.js";
+import "./chunk-CZTPU65V.js";
 import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-BJEJUOGM.js";
-import "./chunk-OKO57IXB.js";
+import "./chunk-6YAIN5XJ.js";
+import "./chunk-4JVQRFZD.js";
+import "./chunk-TNSCIPBQ.js";
 import "./chunk-YQNNHLCG.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-TNSCIPBQ.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";

package/dist/who-knows.d.ts

@@ -1,6 +1,6 @@
-export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-gBcdRUHY.js';
+export { bA as WHO_KNOWS_AUTHORSHIP_BONUS, bB as WHO_KNOWS_DEFAULT_LIMIT, bC as WHO_KNOWS_MAX_EVIDENCE, bD as WHO_KNOWS_MAX_LIMIT, bE as WHO_KNOWS_MCP_TOOLS, bF as WhoKnowsEntity, bG as WhoKnowsEvidence, bH as WhoKnowsHit, bI as WhoKnowsHttpOutcome, W as WhoKnowsResult, bJ as WhoKnowsStorage, bT as computeWhoKnows, bZ as handleWhoKnowsHttpQuery, c2 as loadWhoKnowsEntities, c9 as tokenizeTopic, ca as validateWhoKnowsInput } from './access-service-MY4bsr_Q.js';
 import './types-Cyr32ABj.js';
-import './orchestrator-DocO0_hw.js';
+import './orchestrator-ComHLm49.js';
 import './recall-state.js';
 import './utils/serialize-mutations.js';
 import './search/port.js';

package/dist/who-knows.js

@@ -9,21 +9,21 @@ import {
   loadWhoKnowsEntities,
   tokenizeTopic,
   validateWhoKnowsInput
-} from "./chunk-BX4EOMKT.js";
-import "./chunk-7S53BPTU.js";
-import "./chunk-UHVXE24Y.js";
+} from "./chunk-3EKVN2OP.js";
+import "./chunk-CZTPU65V.js";
 import "./chunk-46WM6JX2.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-D5F7TKMH.js";
-import "./chunk-BJEJUOGM.js";
-import "./chunk-OKO57IXB.js";
+import "./chunk-6YAIN5XJ.js";
+import "./chunk-4JVQRFZD.js";
+import "./chunk-TNSCIPBQ.js";
 import "./chunk-YQNNHLCG.js";
 import "./chunk-6KTXE6A3.js";
 import "./chunk-BD7JTBYP.js";
 import "./chunk-OB3XMWX5.js";
-import "./chunk-CYEPCZN5.js";
-import "./chunk-TNSCIPBQ.js";
 import "./chunk-4O6WRBGE.js";
 import "./chunk-GUMZC2BO.js";
+import "./chunk-CYEPCZN5.js";
 import "./chunk-TFA6HPOA.js";
 import "./chunk-F4TWWUMP.js";
 import "./chunk-72A4L5JJ.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.69.38",
+  "version": "9.69.39",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3297,7 +3297,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.69.38"
+    "@remnic/coding-graph": "^9.69.39"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/orchestration/recall-internal.ts

@@ -98,7 +98,11 @@ import {
   type RecallInvocationOptions,
 } from "../orchestrator.js";
 import { isGenericRecallExcludedPath } from "./generic-recall-paths.js";
-import { filterRecentScanMemoriesForStateView, indexStateViewAnnotatedResults, resolveRecallStateViewActive } from "../recall-state-view-admission.js";
+import {
+  filterRecentScanMemories,
+  resolveRecallStateViewFlags,
+} from "../recall-state-view-anchors.js";
+import { indexStateViewAnnotatedResults } from "../recall-state-view-admission.js";
 import type { RecallSectionBuckets } from "./recall-section-coordinator.js";
 import {
   reconcileRecallResultPartition,
@@ -242,8 +246,14 @@ export class RecallInternalCoordinator {
         this.deps.effectiveCronRecallInstructionHeavyTokenCap(),
       cronConversationRecallMode: this.deps.config.cronConversationRecallMode,
     });
+    // #1952 state views: config flag OR per-call override, gated on change intent; computed once for all branches.
     const retrievalQuery = queryPolicy.retrievalQuery || prompt;
-    const stateViewActive = resolveRecallStateViewActive(options, this.deps.config, retrievalQuery);
+    const { stateViewActive, stateViewPacketActive } = resolveRecallStateViewFlags(
+      options.stateView,
+      this.deps.config.recallStateViews,
+      retrievalQuery,
+      asOfMs,
+    );
     const retrievalQueryHash = createHash("sha256")
       .update(retrievalQuery)
       .digest("hex");
@@ -3996,17 +4006,19 @@ export class RecallInternalCoordinator {
               recallResultLimit,
               retrievalQuery,
               caps,
+              stateViewPacketActive,
             )
           : null;
       memoryResults = hotQmdPartition
         ? [...hotQmdPartition.appliedResults]
-        : this.deps.diversifyAndLimitRecallResults(
+        : this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
             "memories",
             memoryResults,
             recallResultLimit,
             retrievalQuery,
             caps,
-          );
+            stateViewPacketActive,
+          ).appliedResults;
       // E-Mem-inspired memory reconstruction: fill gaps for referenced entities
       if (resolveRecallEnhancementCapabilities(this.deps.config).memoryReconstruction && memoryResults.length > 0) {
         try {
@@ -4120,27 +4132,8 @@ export class RecallInternalCoordinator {
           },
           [] as QmdSearchResult[],
         );
-        const embeddingPartition =
-          options.xrayCapture === true
-            ? this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
-                "memories",
-                scoped,
-                recallResultLimit,
-                retrievalQuery,
-                caps,
-              )
-            : null;
-        scoped =
-          embeddingPartition?.appliedResults ??
-          this.deps.diversifyAndLimitRecallResults(
-            "memories",
-            scoped,
-            recallResultLimit,
-            retrievalQuery,
-            caps,
-          );
-        // Issue #1577 — apply TrustScore on the embedding-fallback path so the
-        // feature gate is consistent across ALL recall paths (rule 41 parity).
+        // Issue #1577 — trust filter before packet cap (AGENTS.md order).
+        // Feature gate is consistent across ALL recall paths (rule 41 parity).
         {
           // Deadline-bound (issue #1905). This branch has no preloaded
           // frontmatter map (boost ran without one), so pass undefined and let
@@ -4173,6 +4166,27 @@ export class RecallInternalCoordinator {
             success: !trustFellBack,
           });
         }
+        const embeddingPartition =
+          options.xrayCapture === true
+            ? this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
+                "memories",
+                scoped,
+                recallResultLimit,
+                retrievalQuery,
+                caps,
+                stateViewPacketActive,
+              )
+            : null;
+        scoped =
+          embeddingPartition?.appliedResults ??
+          this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
+            "memories",
+            scoped,
+            recallResultLimit,
+            retrievalQuery,
+            caps,
+            stateViewPacketActive,
+          ).appliedResults;
         if (scoped.length > 0) {
           if (shouldPersistGraphSnapshot) {
             graphSnapshotFinalResults = this.deps.buildGraphRecallRankedResults(
@@ -4338,27 +4352,8 @@ export class RecallInternalCoordinator {
           },
           [] as QmdSearchResult[],
         );
-        const embeddingPartition =
-          options.xrayCapture === true
-            ? this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
-                "memories",
-                scoped,
-                recallResultLimit,
-                retrievalQuery,
-                caps,
-              )
-            : null;
-        scoped =
-          embeddingPartition?.appliedResults ??
-          this.deps.diversifyAndLimitRecallResults(
-            "memories",
-            scoped,
-            recallResultLimit,
-            retrievalQuery,
-            caps,
-          );
-        // Issue #1577 — apply TrustScore on the embedding-fallback path so the
-        // feature gate is consistent across ALL recall paths (rule 41 parity).
+        // Issue #1577 — trust filter before packet cap (AGENTS.md order).
+        // Feature gate is consistent across ALL recall paths (rule 41 parity).
         {
           // Deadline-bound (issue #1905); no preloaded map on this branch.
           const trustT0 = Date.now();
@@ -4388,6 +4383,27 @@ export class RecallInternalCoordinator {
             success: !trustFellBack,
           });
         }
+        const embeddingPartition =
+          options.xrayCapture === true
+            ? this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
+                "memories",
+                scoped,
+                recallResultLimit,
+                retrievalQuery,
+                caps,
+                stateViewPacketActive,
+              )
+            : null;
+        scoped =
+          embeddingPartition?.appliedResults ??
+          this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
+            "memories",
+            scoped,
+            recallResultLimit,
+            retrievalQuery,
+            caps,
+            stateViewPacketActive,
+          ).appliedResults;
       if (scoped.length > 0) {
         if (shouldPersistGraphSnapshot) {
           graphSnapshotFinalResults = this.deps.buildGraphRecallRankedResults(
@@ -4427,16 +4443,15 @@ export class RecallInternalCoordinator {
           [] as MemoryFile[],
         );
         if (memories.length > 0) {
-          const activeMemories = filterRecentScanMemoriesForStateView(
-            memories,
-            this.deps.config,
-            {
+          const activeMemories = filterRecentScanMemories(memories, {
+            stateViewActive, asOfMs,
+            namespaceOf: (p) => this.deps.namespaceFromPath(p),
+            isExcluded: (p) => isGenericRecallExcludedPath(p, this.deps.config),
+            supersessionOptions: {
               enabled: lifecycleCaps.temporalSupersession,
               includeInRecall: this.deps.config.temporalSupersessionIncludeInRecall,
             },
-            stateViewActive,
-            asOfMs,
-          );
+          });
           // Convert to QmdSearchResult with recency baseline, then boost so
           // temporal/tag boosts match the QMD path. Cap AFTER boosting, and
           // pass a pre-populated memoryByPath to skip redundant disk reads.
@@ -4541,27 +4556,8 @@ export class RecallInternalCoordinator {
               },
               [] as QmdSearchResult[],
             );
-            const recentPartition =
-              options.xrayCapture === true
-                ? this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
-                    "memories",
-                    recent,
-                    recallResultLimit,
-                    retrievalQuery,
-                    caps,
-                  )
-                : null;
-            recent =
-              recentPartition?.appliedResults ??
-              this.deps.diversifyAndLimitRecallResults(
-                "memories",
-                recent,
-                recallResultLimit,
-                retrievalQuery,
-                caps,
-              );
-            // Issue #1577 — apply TrustScore on the recent-scan path so the
-            // feature gate is consistent across ALL recall paths (rule 41).
+            // Issue #1577 — trust filter before packet cap (AGENTS.md order).
+            // Feature gate is consistent across ALL recall paths (rule 41).
             {
               // Deadline-bound (issue #1905). The recent-scan branch already
               // loaded every candidate's MemoryFile (queryAwareScopedMemories),
@@ -4597,6 +4593,27 @@ export class RecallInternalCoordinator {
                 success: !trustFellBack,
               });
             }
+            const recentPartition =
+              options.xrayCapture === true
+                ? this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
+                    "memories",
+                    recent,
+                    recallResultLimit,
+                    retrievalQuery,
+                    caps,
+                    stateViewPacketActive,
+                  )
+                : null;
+            recent =
+              recentPartition?.appliedResults ??
+              this.deps.recallRerankCoordinator.diversifyRecallResultsWithHeadroom(
+                "memories",
+                recent,
+                recallResultLimit,
+                retrievalQuery,
+                caps,
+                stateViewPacketActive,
+              ).appliedResults;
             if (recent.length > 0) {
               if (shouldPersistGraphSnapshot) {
                 graphSnapshotFinalResults = this.deps.buildGraphRecallRankedResults(

package/src/orchestration/recall-rerank-coordinator.ts

@@ -39,6 +39,7 @@ import type { TrustSignals } from "../trust-score.js";
 import { reorderRecallResultsWithMmr } from "../recall-mmr.js";
 import { applyReasoningTraceBoost } from "../reasoning-trace-recall.js";
 import { memoryMapKey } from "../recall-memory-map.js";
+import { capStateViewPackets, reconcileStateViewPairs } from "../recall-state-view.js";
 
 export interface RecallResultPartition {
   appliedResults: QmdSearchResult[];
@@ -621,12 +622,28 @@ export class RecallRerankCoordinator {
     limit: number,
     retrievalQuery?: string,
     caps: CapabilitySet = resolveCapabilities(this.getConfig()),
+    /**
+     * #2859 — state-view packet semantics. When true, superseded rows are
+     * reconciled against their successors BEFORE MMR (orphan removal can
+     * never underfill), and the cap counts complete evidence packets: a
+     * predecessor admitted alongside its successor consumes ONE slot and
+     * the slice never splits the pair at the boundary. Absent/false keeps
+     * the legacy slice byte-identical.
+     */
+    stateViewActive?: boolean,
   ): RecallResultPartition {
     const safeLimit =
       typeof limit === "number" && Number.isFinite(limit)
         ? Math.max(0, Math.floor(limit))
         : 0;
-    const candidates = Array.isArray(results) ? results : [];
+    // #2859: reconcile pairs before the user cap/MMR so orphan removal
+    // happens pre-truncation, never post-cap.
+    const candidates =
+      stateViewActive === true && Array.isArray(results)
+        ? reconcileStateViewPairs(results)
+        : Array.isArray(results)
+          ? results
+          : [];
     let orderedPool: QmdSearchResult[] | undefined;
     const resolveOrderedPool = (): QmdSearchResult[] => {
       if (orderedPool) return orderedPool;
@@ -640,15 +657,32 @@ export class RecallRerankCoordinator {
       orderedPool = this.applyMmrToQmdResults(sectionId, boosted, caps);
       return orderedPool;
     };
+    let appliedCache: QmdSearchResult[] | undefined;
+    const resolveApplied = (): QmdSearchResult[] => {
+      if (appliedCache) return appliedCache;
+      if (safeLimit === 0 || candidates.length === 0) {
+        appliedCache = [];
+        return appliedCache;
+      }
+      const ordered = resolveOrderedPool();
+      // #2859: the cap counts complete evidence packets, not rows.
+      appliedCache =
+        stateViewActive === true ? capStateViewPackets(ordered, safeLimit) : ordered.slice(0, safeLimit);
+      return appliedCache;
+    };
 
     return {
       get appliedResults(): QmdSearchResult[] {
-        if (safeLimit === 0 || candidates.length === 0) return [];
-        return resolveOrderedPool().slice(0, safeLimit);
+        return resolveApplied().slice();
       },
       get headroomResults(): QmdSearchResult[] {
         if (candidates.length === 0) return [];
-        return resolveOrderedPool().slice(safeLimit);
+        const ordered = resolveOrderedPool();
+        if (stateViewActive === true) {
+          const applied = new Set(resolveApplied());
+          return ordered.filter((row) => !applied.has(row));
+        }
+        return ordered.slice(safeLimit);
       },
     };
   }
@@ -659,6 +693,8 @@ export class RecallRerankCoordinator {
     limit: number,
     retrievalQuery?: string,
     caps: CapabilitySet = resolveCapabilities(this.getConfig()),
+    /** #2859 — see diversifyRecallResultsWithHeadroom. */
+    stateViewActive?: boolean,
   ): QmdSearchResult[] {
     return this.diversifyRecallResultsWithHeadroom(
       sectionId,
@@ -666,6 +702,7 @@ export class RecallRerankCoordinator {
       limit,
       retrievalQuery,
       caps,
+      stateViewActive,
     ).appliedResults;
   }