@remnic/core 9.3.688 → 9.3.689

package/dist/cli.js

@@ -90,7 +90,7 @@ import {
   runWorkProductStatusCliCommand,
   runWorkProjectCliCommand,
   runWorkTaskCliCommand
-} from "./chunk-CCWHPGT4.js";
+} from "./chunk-RHXFYIHA.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -103,29 +103,29 @@ import "./chunk-OZKVVUJB.js";
 import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
 import "./chunk-2NLLXCJG.js";
-import "./chunk-UP6MOYCB.js";
 import "./chunk-765K3SAT.js";
+import "./chunk-UP6MOYCB.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-HOJZMQ4J.js";
+import "./chunk-D6RIFG4O.js";
 import "./chunk-VX6OBUDW.js";
 import "./chunk-6O6A6YUO.js";
 import "./chunk-LZZNTPLR.js";
+import "./chunk-JCK7V6SN.js";
 import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
-import "./chunk-D6RIFG4O.js";
-import "./chunk-JCK7V6SN.js";
-import "./chunk-GQL52GQ5.js";
 import "./chunk-CKITWVWJ.js";
 import "./chunk-OUELRE5E.js";
+import "./chunk-GQL52GQ5.js";
 import "./chunk-IQ7WCZRW.js";
 import "./chunk-UTYBJR7M.js";
 import "./chunk-3K37VPM3.js";
-import "./chunk-TGQ2NTWH.js";
 import "./chunk-BFVPIKDY.js";
+import "./chunk-TGQ2NTWH.js";
 import "./chunk-3T74IZB3.js";
-import "./chunk-RVYD6LR3.js";
-import "./chunk-2SJCWLQD.js";
+import "./chunk-UHUZXWDX.js";
+import "./chunk-W63OY3J7.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-7XH7VJN4.js";
 import "./chunk-YNDLCWXS.js";
@@ -133,8 +133,8 @@ import "./chunk-AUDJPF4N.js";
 import "./chunk-44442YCH.js";
 import "./chunk-Y4Z4I6WK.js";
 import "./chunk-YBPYIAA5.js";
-import "./chunk-2PRQG7PV.js";
 import "./chunk-WIWPSQYU.js";
+import "./chunk-2PRQG7PV.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-4FE2K57M.js";
@@ -168,7 +168,7 @@ import "./chunk-OO42R444.js";
 import "./chunk-K6MV3TRQ.js";
 import "./chunk-LBJBNWS2.js";
 import "./chunk-OADWQ5CR.js";
-import "./chunk-S2OU5DZY.js";
+import "./chunk-QSQW54U5.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-RKNJBZ55.js";
 import "./chunk-J64TK33U.js";
@@ -177,13 +177,13 @@ import "./chunk-42NQ7AVG.js";
 import "./chunk-TMSXWOBZ.js";
 import "./chunk-7RXCMVFQ.js";
 import "./chunk-7WV3F5DQ.js";
-import "./chunk-473JIN2U.js";
+import "./chunk-UXLZOVCN.js";
 import "./chunk-T4WDJPEZ.js";
 import "./chunk-D24OXEPB.js";
-import "./chunk-KFBOZYME.js";
+import "./chunk-Z2M6YTAJ.js";
 import "./chunk-UDJLF3BO.js";
-import "./chunk-NN7QYW5W.js";
-import "./chunk-FUCUR2OZ.js";
+import "./chunk-OWFY6NGQ.js";
+import "./chunk-XU7363OX.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import "./chunk-ARV3AUOM.js";
@@ -200,21 +200,21 @@ import "./chunk-BMFZLLNI.js";
 import "./chunk-CI7RKSRE.js";
 import "./chunk-6HMYUWXR.js";
 import "./chunk-4N3TFFPH.js";
-import "./chunk-CTOQEZSN.js";
-import "./chunk-2KAYTPPT.js";
+import "./chunk-SAEZIIID.js";
+import "./chunk-JPETDXED.js";
+import "./chunk-5CEJH5ZN.js";
 import "./chunk-WRFKZEO6.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-LQ6JI4VH.js";
 import "./chunk-SANZHXY2.js";
-import "./chunk-EHISUJFN.js";
-import "./chunk-5CEJH5ZN.js";
 import "./chunk-AER6MT24.js";
+import "./chunk-EHISUJFN.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
-import "./chunk-DCWIQFNA.js";
+import "./chunk-T422SYM6.js";
+import "./chunk-SJHM6I4J.js";
 import "./chunk-XBZQRZ6G.js";
 import "./chunk-KCQA46NR.js";
-import "./chunk-SJHM6I4J.js";
 import "./chunk-K43PI6DQ.js";
 import "./chunk-YNQ6DFSV.js";
 import "./chunk-EIR5VLIH.js";

package/dist/conversation-index/backend.js

@@ -1,9 +1,9 @@
 import {
   createConversationIndexBackend
-} from "../chunk-DCWIQFNA.js";
+} from "../chunk-T422SYM6.js";
+import "../chunk-SJHM6I4J.js";
 import "../chunk-XBZQRZ6G.js";
 import "../chunk-KCQA46NR.js";
-import "../chunk-SJHM6I4J.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-NU3CSQ4H.js";
 import "../chunk-PZ5AY32C.js";

package/dist/index.js

@@ -98,7 +98,7 @@ import {
   registerTrainingExportAdapter,
   runBulkImportCliCommand,
   runWearablesCliCommand
-} from "./chunk-CCWHPGT4.js";
+} from "./chunk-RHXFYIHA.js";
 import "./chunk-MC4FJXPA.js";
 import "./chunk-LQHDIS7L.js";
 import "./chunk-7F7Z6MOS.js";
@@ -111,19 +111,18 @@ import "./chunk-OZKVVUJB.js";
 import "./chunk-2DL3OFLD.js";
 import "./chunk-G4IAEX6D.js";
 import "./chunk-2NLLXCJG.js";
-import "./chunk-UP6MOYCB.js";
 import "./chunk-765K3SAT.js";
+import "./chunk-UP6MOYCB.js";
 import "./chunk-EEC4PCG5.js";
 import "./chunk-PYIFUBRK.js";
 import "./chunk-HOJZMQ4J.js";
+import "./chunk-D6RIFG4O.js";
 import "./chunk-VX6OBUDW.js";
 import "./chunk-6O6A6YUO.js";
 import "./chunk-LZZNTPLR.js";
+import "./chunk-JCK7V6SN.js";
 import "./chunk-WMWVO45V.js";
 import "./chunk-KJTKLXTH.js";
-import "./chunk-D6RIFG4O.js";
-import "./chunk-JCK7V6SN.js";
-import "./chunk-GQL52GQ5.js";
 import {
   clearBulkImportSources,
   formatBatchTranscript,
@@ -139,23 +138,24 @@ import {
   parseIsoTimestamp,
   validateImportTurn
 } from "./chunk-OUELRE5E.js";
+import "./chunk-GQL52GQ5.js";
 import "./chunk-IQ7WCZRW.js";
 import "./chunk-UTYBJR7M.js";
 import "./chunk-3K37VPM3.js";
+import {
+  parseXrayBudgetFlag,
+  parseXrayCliOptions
+} from "./chunk-BFVPIKDY.js";
 import {
   clearAuthTokenSecretCache,
   isAgentAccessSecretRef,
   resolveAgentAccessAuthToken
 } from "./chunk-TGQ2NTWH.js";
-import {
-  parseXrayBudgetFlag,
-  parseXrayCliOptions
-} from "./chunk-BFVPIKDY.js";
 import {
   parseStrictCliDate
 } from "./chunk-3T74IZB3.js";
-import "./chunk-RVYD6LR3.js";
-import "./chunk-2SJCWLQD.js";
+import "./chunk-UHUZXWDX.js";
+import "./chunk-W63OY3J7.js";
 import "./chunk-HL4DB7TO.js";
 import "./chunk-7XH7VJN4.js";
 import "./chunk-YNDLCWXS.js";
@@ -196,7 +196,7 @@ import {
   saveTaxonomy,
   validateSlug,
   validateTaxonomy
-} from "./chunk-B43NZNMG.js";
+} from "./chunk-JZBFL7RI.js";
 import {
   WEARABLE_SOURCE_PREFIX,
   buildExtractionTurns,
@@ -227,7 +227,8 @@ import {
 import "./chunk-666A3MOW.js";
 import "./chunk-HHLLAQGZ.js";
 import "./chunk-UWK5OXUJ.js";
-import "./chunk-ZPTISBQU.js";
+import "./chunk-2SNKUSQC.js";
+import "./chunk-KCYE2MZM.js";
 import {
   applyLcmSchema,
   ensureLcmStateDir,
@@ -237,7 +238,6 @@ import "./chunk-7WWURLG6.js";
 import "./chunk-MDJURR27.js";
 import "./chunk-7N4KAIGN.js";
 import "./chunk-TPDBFYEG.js";
-import "./chunk-KCYE2MZM.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-O7GOFAM3.js";
 import "./chunk-STOEE37X.js";
@@ -361,8 +361,8 @@ import {
   buildExtensionsFooterForSummary,
   loadDaySummaryPrompt
 } from "./chunk-EO5QWINU.js";
-import "./chunk-2PRQG7PV.js";
 import "./chunk-WIWPSQYU.js";
+import "./chunk-2PRQG7PV.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-4FE2K57M.js";
@@ -500,7 +500,7 @@ import "./chunk-LBJBNWS2.js";
 import "./chunk-OADWQ5CR.js";
 import {
   EngramAccessHttpServer
-} from "./chunk-S2OU5DZY.js";
+} from "./chunk-QSQW54U5.js";
 import "./chunk-SEDEKFYQ.js";
 import "./chunk-RKNJBZ55.js";
 import "./chunk-J64TK33U.js";
@@ -514,7 +514,7 @@ import {
 } from "./chunk-7WV3F5DQ.js";
 import {
   EngramMcpServer
-} from "./chunk-473JIN2U.js";
+} from "./chunk-UXLZOVCN.js";
 import {
   REMNIC_CHATGPT_MEMORY_INSPECTOR_CANONICAL_TOOL,
   REMNIC_CHATGPT_MEMORY_INSPECTOR_MIME_TYPE,
@@ -530,7 +530,7 @@ import {
   parseOaiMemCitation,
   sanitizeNoteForCitation
 } from "./chunk-D24OXEPB.js";
-import "./chunk-KFBOZYME.js";
+import "./chunk-Z2M6YTAJ.js";
 import {
   formatZodError,
   memoryStoreRequestSchema,
@@ -539,13 +539,13 @@ import {
   suggestionSubmitRequestSchema,
   validateRequest
 } from "./chunk-UDJLF3BO.js";
-import "./chunk-NN7QYW5W.js";
+import "./chunk-OWFY6NGQ.js";
 import {
   EngramAccessInputError,
   EngramAccessService,
   computeProcedureStats,
   formatProcedureStatsText
-} from "./chunk-FUCUR2OZ.js";
+} from "./chunk-XU7363OX.js";
 import "./chunk-GDASG7NC.js";
 import "./chunk-GDB4J2H3.js";
 import {
@@ -592,8 +592,11 @@ import {
 } from "./chunk-CI7RKSRE.js";
 import "./chunk-6HMYUWXR.js";
 import "./chunk-4N3TFFPH.js";
-import "./chunk-CTOQEZSN.js";
-import "./chunk-2KAYTPPT.js";
+import "./chunk-SAEZIIID.js";
+import "./chunk-JPETDXED.js";
+import {
+  LanceDbBackend
+} from "./chunk-5CEJH5ZN.js";
 import {
   MeilisearchBackend
 } from "./chunk-WRFKZEO6.js";
@@ -602,17 +605,14 @@ import {
   OramaBackend
 } from "./chunk-LQ6JI4VH.js";
 import "./chunk-SANZHXY2.js";
-import "./chunk-EHISUJFN.js";
-import {
-  LanceDbBackend
-} from "./chunk-5CEJH5ZN.js";
 import "./chunk-AER6MT24.js";
+import "./chunk-EHISUJFN.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
-import "./chunk-DCWIQFNA.js";
+import "./chunk-T422SYM6.js";
+import "./chunk-SJHM6I4J.js";
 import "./chunk-XBZQRZ6G.js";
 import "./chunk-KCQA46NR.js";
-import "./chunk-SJHM6I4J.js";
 import {
   QmdClient
 } from "./chunk-K43PI6DQ.js";

package/dist/lcm/engine.js

@@ -1,13 +1,13 @@
 import {
   LcmEngine,
   extractLcmConfig
-} from "../chunk-ZPTISBQU.js";
+} from "../chunk-2SNKUSQC.js";
+import "../chunk-KCYE2MZM.js";
 import "../chunk-KYYL4U6X.js";
 import "../chunk-7WWURLG6.js";
 import "../chunk-MDJURR27.js";
 import "../chunk-7N4KAIGN.js";
 import "../chunk-TPDBFYEG.js";
-import "../chunk-KCYE2MZM.js";
 import "../chunk-4RA3C3EV.js";
 import "../chunk-CI7RKSRE.js";
 import "../chunk-6KYMPV2O.js";

package/dist/lcm/index.js

@@ -5,7 +5,10 @@ import {
 import {
   LcmEngine,
   extractLcmConfig
-} from "../chunk-ZPTISBQU.js";
+} from "../chunk-2SNKUSQC.js";
+import {
+  assembleCompressedHistory
+} from "../chunk-KCYE2MZM.js";
 import {
   ensureLcmStateDir,
   openLcmDatabase
@@ -21,9 +24,6 @@ import {
   LcmDag
 } from "../chunk-7N4KAIGN.js";
 import "../chunk-TPDBFYEG.js";
-import {
-  assembleCompressedHistory
-} from "../chunk-KCYE2MZM.js";
 import "../chunk-4RA3C3EV.js";
 import "../chunk-CI7RKSRE.js";
 import "../chunk-6KYMPV2O.js";

package/dist/namespaces/migrate.js

@@ -2,23 +2,23 @@ import {
   listNamespaces,
   runNamespaceMigration,
   verifyNamespaces
-} from "../chunk-2SJCWLQD.js";
+} from "../chunk-W63OY3J7.js";
 import "../chunk-WIHPNY65.js";
-import "../chunk-CTOQEZSN.js";
-import "../chunk-2KAYTPPT.js";
+import "../chunk-SAEZIIID.js";
+import "../chunk-JPETDXED.js";
+import "../chunk-5CEJH5ZN.js";
 import "../chunk-WRFKZEO6.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-LQ6JI4VH.js";
 import "../chunk-SANZHXY2.js";
-import "../chunk-EHISUJFN.js";
-import "../chunk-5CEJH5ZN.js";
 import "../chunk-AER6MT24.js";
+import "../chunk-EHISUJFN.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-ZFXCQPNO.js";
-import "../chunk-DCWIQFNA.js";
+import "../chunk-T422SYM6.js";
+import "../chunk-SJHM6I4J.js";
 import "../chunk-XBZQRZ6G.js";
 import "../chunk-KCQA46NR.js";
-import "../chunk-SJHM6I4J.js";
 import "../chunk-K43PI6DQ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-O75CRYGF.js";

package/dist/namespaces/search.js

@@ -1,21 +1,21 @@
 import {
   NamespaceSearchRouter,
   namespaceCollectionName
-} from "../chunk-CTOQEZSN.js";
-import "../chunk-2KAYTPPT.js";
+} from "../chunk-SAEZIIID.js";
+import "../chunk-JPETDXED.js";
+import "../chunk-5CEJH5ZN.js";
 import "../chunk-WRFKZEO6.js";
 import "../chunk-CYEPCZN5.js";
 import "../chunk-LQ6JI4VH.js";
 import "../chunk-SANZHXY2.js";
-import "../chunk-EHISUJFN.js";
-import "../chunk-5CEJH5ZN.js";
 import "../chunk-AER6MT24.js";
+import "../chunk-EHISUJFN.js";
 import "../chunk-CINZGPSJ.js";
 import "../chunk-ZFXCQPNO.js";
-import "../chunk-DCWIQFNA.js";
+import "../chunk-T422SYM6.js";
+import "../chunk-SJHM6I4J.js";
 import "../chunk-XBZQRZ6G.js";
 import "../chunk-KCQA46NR.js";
-import "../chunk-SJHM6I4J.js";
 import "../chunk-K43PI6DQ.js";
 import "../chunk-YNQ6DFSV.js";
 import "../chunk-O75CRYGF.js";

package/dist/operator-toolkit.js

@@ -11,8 +11,8 @@ import {
   summarizeMemoryWorthLegacyCounters,
   summarizeObservationThroughput,
   summarizeTierDistribution
-} from "./chunk-RVYD6LR3.js";
-import "./chunk-2SJCWLQD.js";
+} from "./chunk-UHUZXWDX.js";
+import "./chunk-W63OY3J7.js";
 import "./chunk-7XH7VJN4.js";
 import "./chunk-YBPYIAA5.js";
 import "./chunk-WIHPNY65.js";
@@ -27,21 +27,21 @@ import "./chunk-Z5LAYHGJ.js";
 import "./chunk-OO42R444.js";
 import "./chunk-K6MV3TRQ.js";
 import "./chunk-4N3TFFPH.js";
-import "./chunk-CTOQEZSN.js";
-import "./chunk-2KAYTPPT.js";
+import "./chunk-SAEZIIID.js";
+import "./chunk-JPETDXED.js";
+import "./chunk-5CEJH5ZN.js";
 import "./chunk-WRFKZEO6.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-LQ6JI4VH.js";
 import "./chunk-SANZHXY2.js";
-import "./chunk-EHISUJFN.js";
-import "./chunk-5CEJH5ZN.js";
 import "./chunk-AER6MT24.js";
+import "./chunk-EHISUJFN.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
-import "./chunk-DCWIQFNA.js";
+import "./chunk-T422SYM6.js";
+import "./chunk-SJHM6I4J.js";
 import "./chunk-XBZQRZ6G.js";
 import "./chunk-KCQA46NR.js";
-import "./chunk-SJHM6I4J.js";
 import "./chunk-K43PI6DQ.js";
 import "./chunk-YNQ6DFSV.js";
 import "./chunk-O75CRYGF.js";

package/dist/orchestrator.js

@@ -28,19 +28,19 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-B43NZNMG.js";
+} from "./chunk-JZBFL7RI.js";
 import "./chunk-AGJH5ISO.js";
 import "./chunk-7HYPN2GC.js";
 import "./chunk-666A3MOW.js";
 import "./chunk-HHLLAQGZ.js";
 import "./chunk-UWK5OXUJ.js";
-import "./chunk-ZPTISBQU.js";
+import "./chunk-2SNKUSQC.js";
+import "./chunk-KCYE2MZM.js";
 import "./chunk-KYYL4U6X.js";
 import "./chunk-7WWURLG6.js";
 import "./chunk-MDJURR27.js";
 import "./chunk-7N4KAIGN.js";
 import "./chunk-TPDBFYEG.js";
-import "./chunk-KCYE2MZM.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-O7GOFAM3.js";
 import "./chunk-STOEE37X.js";
@@ -93,8 +93,8 @@ import "./chunk-6HEM6HTQ.js";
 import "./chunk-ZA2S2VLL.js";
 import "./chunk-B4XVLHJA.js";
 import "./chunk-EO5QWINU.js";
-import "./chunk-2PRQG7PV.js";
 import "./chunk-WIWPSQYU.js";
+import "./chunk-2PRQG7PV.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-4FE2K57M.js";
@@ -149,21 +149,21 @@ import "./chunk-FF4KLI5W.js";
 import "./chunk-LLONI6PY.js";
 import "./chunk-CI7RKSRE.js";
 import "./chunk-6HMYUWXR.js";
-import "./chunk-CTOQEZSN.js";
-import "./chunk-2KAYTPPT.js";
+import "./chunk-SAEZIIID.js";
+import "./chunk-JPETDXED.js";
+import "./chunk-5CEJH5ZN.js";
 import "./chunk-WRFKZEO6.js";
 import "./chunk-CYEPCZN5.js";
 import "./chunk-LQ6JI4VH.js";
 import "./chunk-SANZHXY2.js";
-import "./chunk-EHISUJFN.js";
-import "./chunk-5CEJH5ZN.js";
 import "./chunk-AER6MT24.js";
+import "./chunk-EHISUJFN.js";
 import "./chunk-CINZGPSJ.js";
 import "./chunk-ZFXCQPNO.js";
-import "./chunk-DCWIQFNA.js";
+import "./chunk-T422SYM6.js";
+import "./chunk-SJHM6I4J.js";
 import "./chunk-XBZQRZ6G.js";
 import "./chunk-KCQA46NR.js";
-import "./chunk-SJHM6I4J.js";
 import "./chunk-K43PI6DQ.js";
 import "./chunk-YNQ6DFSV.js";
 import "./chunk-U33LWTQQ.js";

package/dist/recall-pipeline-stages.d.ts

@@ -0,0 +1,167 @@
+import { EvidencePackItem } from './evidence-pack.js';
+
+/**
+ * Issue #1539 PR2 — the staged recall pipeline spine.
+ *
+ * The four recall pipelines (`targeted-fact-recall.ts`, `response-guidance-
+ * recall.ts`, `explicit-cue-recall.ts`, `event-order-recall.ts`) implement
+ * the same stage sequence — intent → candidate collection → dedup → rank →
+ * filter → slice → metadata insertion → token budgeting — with ~70%
+ * near-duplicate code. The most dangerous divergence is the sort
+ * comparator: guidance/targeted-fact sort `turnIndex` DESC (recency) while
+ * event-order sorts `turnIndex` ASC (chronological). The comparators are
+ * byte-identical except for this direction — copy-pasting into a new
+ * chronological pipeline silently inverts the ordering.
+ *
+ * This module centralizes the **dedup + score + threshold-filter + sort**
+ * stages behind one declared config object. Per-tier divergence (threshold
+ * value, sort direction, content transformation) becomes a declared config
+ * field instead of embedded code.
+ *
+ * **PR 2 scope:** extract the module with NO pipeline changes. PRs 3–6
+ * migrate each pipeline to call `unifiedDedupeAndRank` one at a time,
+ * re-running the characterization snapshots
+ * (`tests/recall-pipeline-unified.test.ts`) to verify byte-for-byte parity.
+ *
+ * Future PRs will add the remaining stages from the issue's Solution
+ * (`mergeAcrossLcmKeys`, `insertMetadata`) once the per-tier hooks are
+ * factored out of each pipeline.
+ *
+ * @see https://github.com/joshuaswarren/remnic/issues/1539
+ */
+
+/** A ranked evidence item: an `EvidencePackItem` with a computed `rank`. */
+interface RankedEvidenceItem extends EvidencePackItem {
+    rank: number;
+}
+/**
+ * Sort direction for the turn-index secondary key. This is the divergence
+ * issue #1539 identifies: relevance-ranked pipelines (targeted-fact,
+ * response-guidance) sort `turnIndex` DESC (recency — latest first); the
+ * chronological pipeline (event-order) sorts `turnIndex` ASC (earliest
+ * first). The rank primary key is ALWAYS DESC (higher rank first); only
+ * the `turnIndex` tiebreaker flips direction.
+ */
+type TurnIndexSortDirection = "desc" | "asc";
+/**
+ * Configuration for the unified dedup + score + threshold-filter + sort
+ * pass. Each pipeline declares its divergences as fields here instead of
+ * embedding them in pipeline-specific code.
+ *
+ * The issue's Solution defines the intended full config object
+ * (`RecallPipelineConfig`); this interface is extracted incrementally:
+ *   - PR 2 (this PR): dedup/score/threshold/sort only
+ *   - PRs 3–6: migrate each pipeline to consume the spine
+ *   - future: add `mergeAcrossLcmKeys`, `insertMetadata` once the per-tier
+ *     hooks are factored out of each pipeline
+ */
+interface UnifiedRankConfig<TIntent> {
+    /** The user query — passed to the scorer. */
+    query: string;
+    /**
+     * Per-tier intent classification result (already computed by the caller;
+     * intent classification stays per-tier because it is genuinely
+     * per-tier per issue #1539 Pitfall 1).
+     */
+    intents: TIntent[];
+    /**
+     * Score an item using its ORIGINAL (pre-transform) content. Higher = more
+     * relevant. The return value becomes the item's `rank`. For pipelines
+     * that don't score (explicit-cue), pass a constant scorer — the config
+     * makes the no-scoring policy explicit.
+     */
+    scoreEvidence: (item: EvidencePackItem, query: string, intents: TIntent[]) => number;
+    /**
+     * Optional content transformation applied to each surviving item's
+     * OUTPUT content (NOT to the content the scorer sees). Per-tier
+     * cue-appenders go here:
+     *   - targeted-fact: `appendNormalizedNumericCues`
+     *   - response-guidance: `appendGuidanceCues`
+     *   - event-order: `appendChronologicalCues`
+     *
+     * The dedup key uses the TRANSFORMED content. This is equivalent to
+     * deduping on original content for all existing pipelines because every
+     * transform is a deterministic append (same original → same transformed →
+     * same key; different originals → different transformed → different key).
+     */
+    transformContent?: (content: string, intents: TIntent[]) => string;
+    /**
+     * Whether to deduplicate by normalized (transformed) content in addition to
+     * id. Default `true` — matches targeted-fact, response-guidance, and
+     * explicit-cue, which all collapse later items sharing a normalized content
+     * key. Event-order sets this to `false`: its rank pass
+     * (`rankAndSelectEventOrderItems`) deduplicates by turn id only and keeps
+     * distinct turns even when two turns share the same cue-appended body
+     * (legitimate repeated turns in a chronological transcript). Making this a
+     * declared field prevents PR 6's migration from silently dropping valid
+     * turns (cursor bugbot a4299851).
+     */
+    dedupByContent?: boolean;
+    /**
+     * Items with `rank` below this threshold are dropped. `undefined` = no
+     * filter. Event-order declares `rankThreshold: 6` here instead of
+     * inlining an undocumented `.filter((item) => item.rank >= 6)` (the
+     * "hardcoded rank threshold that exists in no config and no other
+     * pipeline" from issue #1539's audit).
+     */
+    rankThreshold?: number;
+    /**
+     * Sort direction for the `turnIndex` secondary key.
+     *
+     * - `"desc"` (default): relevance-ranked pipelines (targeted-fact,
+     *   response-guidance) sort `turnIndex` DESC. Undefined `turnIndex`
+     *   falls to `-1` (bottom of a DESC list). Tertiary tiebreaker:
+     *   `score DESC`.
+     * - `"asc"`: the chronological pipeline (event-order) sorts `turnIndex`
+     *   ASC. Undefined `turnIndex` falls to `Number.MAX_SAFE_INTEGER`
+     *   (bottom of an ASC list). Tertiary tiebreaker: `content.localeCompare`.
+     *
+     * The rank primary key is ALWAYS DESC regardless of this setting.
+     */
+    turnIndexSortDirection?: TurnIndexSortDirection;
+}
+/**
+ * Deduplicate, score, threshold-filter, and sort evidence items under one
+ * unified policy.
+ *
+ * **Stage order** (matches every existing pipeline's rank/dedupe function):
+ *   1. **dedup** by `id` + normalized content (first-seen wins). The dedup
+ *      key uses transformed content if `transformContent` is declared.
+ *   2. **score** each surviving item on its ORIGINAL content (the transform
+ *      does not influence the score).
+ *   3. **threshold-filter**: drop items with `rank < rankThreshold` (if
+ *      declared).
+ *   4. **sort**: `rank DESC` → `turnIndex` (direction-configurable) →
+ *      tertiary tiebreaker (`score DESC` for relevance pipelines,
+ *      `content.localeCompare` for chronological pipelines).
+ *
+ * This function does NOT slice (`maxResults`), budget, or format — those
+ * stages remain per-tier because they interact with per-tier metadata
+ * insertion. The issue's Solution describes a future `insertMetadata` hook
+ * that will make budget-adjustment uniform; that lands in the per-tier
+ * migration PRs.
+ *
+ * @example
+ * // Relevance-ranked pipeline (targeted-fact shape):
+ * unifiedDedupeAndRank(items, {
+ *   query,
+ *   intents: [],
+ *   scoreEvidence: (item, q) => scoreTargetedFact(item, q),
+ *   transformContent: (content) => appendNormalizedNumericCues(content),
+ *   // turnIndexSortDirection defaults to "desc"
+ * });
+ *
+ * @example
+ * // Chronological pipeline (event-order shape):
+ * unifiedDedupeAndRank(items, {
+ *   query,
+ *   intents: [],
+ *   scoreEvidence: (item, q) => scoreEventOrder(item, q),
+ *   transformContent: (content) => appendChronologicalCues(content, query),
+ *   rankThreshold: 6,           // declared, not inlined
+ *   turnIndexSortDirection: "asc",
+ * });
+ */
+declare function unifiedDedupeAndRank<TIntent>(items: readonly EvidencePackItem[], config: UnifiedRankConfig<TIntent>): RankedEvidenceItem[];
+
+export { type RankedEvidenceItem, type TurnIndexSortDirection, type UnifiedRankConfig, unifiedDedupeAndRank };