@remnic/core 9.3.701 → 9.3.702

package/dist/orchestrator.d.ts

@@ -9,7 +9,7 @@ import './local-llm.js';
 import './fallback-llm.js';
 import './orchestration/maintenance.js';
 import './live-connectors-runner.js';
-export { L as BulkImportBatchIngestResult, M as BulkImportBatchPartialFailureError, N as GraphRecallRankedResult, Q as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, T as QmdRecallSnapshot, U as RecallInvocationOptions, V as RecallModeDecision, X as appendMemoryToGraphContext, Y as blendGraphExpandedRecallScore, Z as buildCompressionGuidelinesMarkdown, _ as buildMemoryPathById, $ as computeArtifactCandidateFetchLimit, a0 as computeArtifactRecallLimit, a1 as computeQmdHybridFetchLimit, a2 as dedupeEntitySynthesisEvidenceEntries, q as defaultWorkspaceDir, a3 as deriveTopicsFromExtraction, a4 as filterRecallCandidates, a5 as formatCompressionGuidelinesForRecall, a6 as graphPathRelativeToStorage, a7 as hasIdentityRecoveryIntent, a8 as isArtifactMemoryPath, a9 as lifecycleRecallScoreAdjustment, aa as mergeArtifactRecallCandidates, ab as mergeGraphExpandedResults, ac as resolveEffectiveIdentityInjectionMode, ad as resolveEffectiveRecallMode, ae as resolvePersistedMemoryRelativePath, af as resolveRecallModeDecision, ag as resolveRecallModeDecisionAsync, ah as resolveRecentThreadMemoryPaths, A as sanitizeSessionKeyForFilename, ai as shouldFilterLifecycleRecallCandidate, aj as summarizeGraphShadowComparison } from './orchestrator-BzMCZlKn.js';
+export { L as BulkImportBatchIngestResult, M as BulkImportBatchPartialFailureError, N as GraphRecallRankedResult, Q as GraphRecallShadowComparison, G as GraphRecallSnapshot, I as IntentDebugSnapshot, O as Orchestrator, T as QmdRecallSnapshot, U as RecallInvocationOptions, V as RecallModeDecision, X as appendMemoryToGraphContext, Y as blendGraphExpandedRecallScore, Z as buildCompressionGuidelinesMarkdown, _ as buildMemoryPathById, $ as computeArtifactCandidateFetchLimit, a0 as computeArtifactRecallLimit, a1 as computeQmdHybridFetchLimit, a2 as dedupeEntitySynthesisEvidenceEntries, q as defaultWorkspaceDir, a3 as deriveTopicsFromExtraction, a4 as filterRecallCandidates, a5 as formatCompressionGuidelinesForRecall, a6 as graphPathRelativeToStorage, a7 as hasIdentityRecoveryIntent, a8 as isArtifactMemoryPath, a9 as lifecycleRecallScoreAdjustment, aa as mergeArtifactRecallCandidates, ab as mergeGraphExpandedResults, ac as resolveEffectiveIdentityInjectionMode, ad as resolveEffectiveRecallMode, ae as resolvePersistedMemoryRelativePath, af as resolveRecallModeDecision, ag as resolveRecallModeDecisionAsync, ah as resolveRecentThreadMemoryPaths, A as sanitizeSessionKeyForFilename, ai as shouldFilterLifecycleRecallCandidate, aj as summarizeGraphShadowComparison } from './orchestrator-C9CDWAm6.js';
 import './model-registry.js';
 import './relevance.js';
 import './negative.js';
@@ -17,15 +17,15 @@ import './recall-state.js';
 import './recall-xray.js';
 import './session-observer-state.js';
 import './embedding-fallback.js';
-import './semantic-DJR8_DMQ.js';
+import './semantic-SLAa_prH.js';
 import './capabilities.js';
 import './replay/types.js';
 import './types-ByK7T3L6.js';
-import './types-PuiPZ9iE.js';
+import './types-MWKPZnM0.js';
 import './lcm/engine.js';
-import './semantic-consolidation-BtUfv-AL.js';
+import './semantic-consolidation-DgFXyALl.js';
 import './conversation-index/backend.js';
-import './catalog-DBIghceA.js';
+import './catalog-DxCzhjE6.js';
 import './namespaces/search.js';
 import './shared-context/manager.js';
 import './compounding/engine.js';

package/dist/orchestrator.js

@@ -28,10 +28,10 @@ import {
   sanitizeSessionKeyForFilename,
   shouldFilterLifecycleRecallCandidate,
   summarizeGraphShadowComparison
-} from "./chunk-4HIAWLA2.js";
+} from "./chunk-XGMCUY5P.js";
 import "./chunk-VKJHM6PL.js";
 import "./chunk-7HYPN2GC.js";
-import "./chunk-ZT7B64BE.js";
+import "./chunk-6TAETM63.js";
 import "./chunk-666A3MOW.js";
 import "./chunk-HHLLAQGZ.js";
 import "./chunk-X5J3JZR3.js";
@@ -43,7 +43,7 @@ import "./chunk-UWK5OXUJ.js";
 import "./chunk-O7GOFAM3.js";
 import "./chunk-MDJURR27.js";
 import "./chunk-7N4KAIGN.js";
-import "./chunk-MNU5G4TK.js";
+import "./chunk-Z7XEIAV4.js";
 import "./chunk-UFS7OXGL.js";
 import "./chunk-TECVW3JP.js";
 import "./chunk-UHGBNIOS.js";
@@ -54,9 +54,9 @@ import "./chunk-S75M5ZRK.js";
 import "./chunk-ECZU5BJH.js";
 import "./chunk-IO5NQEGZ.js";
 import "./chunk-3FAMU5TX.js";
-import "./chunk-R5DB26G6.js";
+import "./chunk-4SBW47WK.js";
 import "./chunk-DKTSR7EK.js";
-import "./chunk-EC2AYKRX.js";
+import "./chunk-L6W77GWW.js";
 import "./chunk-L24JROPR.js";
 import "./chunk-MGN7VHWQ.js";
 import "./chunk-5IZL4DCV.js";
@@ -74,40 +74,40 @@ import "./chunk-VU3SVYMA.js";
 import "./chunk-H63EDPFJ.js";
 import "./chunk-PD6O7AXF.js";
 import "./chunk-YAZNBMNF.js";
-import "./chunk-FN2SM5SN.js";
+import "./chunk-ABCGDW3A.js";
 import "./chunk-4RA3C3EV.js";
-import "./chunk-ROZJACKP.js";
+import "./chunk-KKK7YTYN.js";
 import "./chunk-54V4BZWP.js";
 import "./chunk-PWFWCGOO.js";
 import "./chunk-24D66MMN.js";
 import "./chunk-LZTFCAKE.js";
-import "./chunk-YXLT4EMM.js";
+import "./chunk-4463LUIE.js";
 import "./chunk-YVVQUAOO.js";
 import "./chunk-XHYGJVXL.js";
 import "./chunk-TH7WMHVK.js";
 import "./chunk-OQH5XUH3.js";
 import "./chunk-6HEM6HTQ.js";
 import "./chunk-ZA2S2VLL.js";
-import "./chunk-7TAQEPLE.js";
-import "./chunk-UU6MVCJ6.js";
+import "./chunk-AMNLZ6SF.js";
+import "./chunk-FIOYURII.js";
+import "./chunk-LUPVCGYK.js";
 import "./chunk-PYPOFEMK.js";
 import "./chunk-EO5QWINU.js";
 import "./chunk-VEWZZM3H.js";
 import "./chunk-2PRQG7PV.js";
 import "./chunk-WIWPSQYU.js";
-import "./chunk-XTIRCSIH.js";
+import "./chunk-MXEWQKM7.js";
 import "./chunk-2F6NP3NT.js";
 import "./chunk-TERNBNJB.js";
 import "./chunk-QRDOSYOR.js";
-import "./chunk-QP37KL5H.js";
+import "./chunk-EYJD6KIO.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-PONNZ54D.js";
-import "./chunk-S4DDLTPX.js";
+import "./chunk-GY3SKOS4.js";
 import "./chunk-SFQ6QNL7.js";
 import "./chunk-33JBK2XP.js";
-import "./chunk-WFEZUGU5.js";
-import "./chunk-JKOKX3PS.js";
-import "./chunk-ODTWHSY2.js";
+import "./chunk-EZR35XHX.js";
+import "./chunk-JMA4RYRN.js";
+import "./chunk-64XXOQRW.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-TQNRI55H.js";
 import "./chunk-6GUG4YNM.js";
@@ -121,8 +121,8 @@ import "./chunk-LMDRGRJ2.js";
 import "./chunk-OD4FM2U7.js";
 import "./chunk-OKTXM5H4.js";
 import "./chunk-PBH4JUAB.js";
-import "./chunk-JO3E5VGS.js";
-import "./chunk-ISLJ5WIM.js";
+import "./chunk-FVI5B7DE.js";
+import "./chunk-QIMFOCSH.js";
 import "./chunk-UUH4YQOF.js";
 import "./chunk-JLNBQWZ2.js";
 import "./chunk-3UXOZBHV.js";
@@ -138,11 +138,12 @@ import "./chunk-Z5LAYHGJ.js";
 import "./chunk-LBJBNWS2.js";
 import "./chunk-OADWQ5CR.js";
 import "./chunk-7WV3F5DQ.js";
-import "./chunk-HRUULBBV.js";
+import "./chunk-SHRRWOVY.js";
 import "./chunk-RS25QOKZ.js";
 import "./chunk-JGSKJHF7.js";
+import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-SDPDU2PM.js";
+import "./chunk-YTMDF6S7.js";
 import "./chunk-CI7RKSRE.js";
 import "./chunk-6HMYUWXR.js";
 import "./chunk-VPAFWWCL.js";
@@ -165,15 +166,15 @@ import "./chunk-YNQ6DFSV.js";
 import "./chunk-EI6V5UXY.js";
 import "./chunk-PNLCEFE4.js";
 import "./chunk-O75CRYGF.js";
-import "./chunk-U33LWTQQ.js";
+import "./chunk-HV57RHMD.js";
 import "./chunk-QDW3E4RD.js";
 import "./chunk-3ONXXHQO.js";
 import "./chunk-KF74X62T.js";
 import "./chunk-2LSZVONP.js";
 import "./chunk-DEUNUKTD.js";
 import "./chunk-YN4ZT4CW.js";
-import "./chunk-HF4N43Q7.js";
-import "./chunk-SFMRLXIV.js";
+import "./chunk-6VVP6NK7.js";
+import "./chunk-GFIARMA7.js";
 import "./chunk-3JJWNZTT.js";
 import "./chunk-M7XQSUBB.js";
 import "./chunk-5UZXUTVO.js";
@@ -183,7 +184,7 @@ import "./chunk-IREVVFTM.js";
 import "./chunk-SVOZFLIQ.js";
 import "./chunk-LTJAMRGI.js";
 import "./chunk-J6A3CX5N.js";
-import "./chunk-IKNQAGBV.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-MB5RSUW6.js";
 import "./chunk-6KYMPV2O.js";
@@ -192,7 +193,6 @@ import "./chunk-42JKGUFJ.js";
 import "./chunk-RULE4VG5.js";
 import "./chunk-LDXUBPMO.js";
 import "./chunk-DM2T26WE.js";
-import "./chunk-FVQJYWH7.js";
 import "./chunk-FEB7W5JG.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-VF4XKTX3.js";
@@ -213,11 +213,13 @@ import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-UZYLX7M6.js";
 import "./chunk-U3PN77QT.js";
-import "./chunk-ZPQVJEVQ.js";
+import "./chunk-SK2CR6MW.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";
+import "./chunk-6MKAMLQL.js";
 import "./chunk-TBBDFYXW.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-PVGDJXVK.js";

package/dist/patterns-cli.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory, g as MemoryFile } from './types-PuiPZ9iE.js';
+import { M as MemoryCategory, g as MemoryFile } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/policy-runtime.d.ts

@@ -1,4 +1,4 @@
-import { P as PluginConfig, e as BehaviorLoopPolicyState } from './types-PuiPZ9iE.js';
+import { P as PluginConfig, e as BehaviorLoopPolicyState } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/provenance.d.ts

@@ -1,4 +1,4 @@
-import { ai as ProvenanceConfig, aj as ProvenanceSource, k as MemoryFrontmatter } from './types-PuiPZ9iE.js';
+import { ai as ProvenanceSource, aj as ProvenanceConfig, k as MemoryFrontmatter } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 
@@ -90,5 +90,39 @@ declare function parseProvenanceSources(raw: string | undefined): ProvenanceSour
  * boolean, so this field uses the simpler omit-the-default approach.
  */
 declare function parseProvenanceConfig(raw: unknown): ProvenanceConfig;
+/**
+ * A turn in the buffered conversation, reduced to the fields the provenance
+ * validator needs. `ExtractionEngine.extract` maps its `BufferTurn[]` to this
+ * shape so the validator is pure and testable without the full BufferTurn type.
+ */
+interface ProvenanceTurnInput {
+    content: string;
+    sessionKey?: string;
+    logicalSessionKey?: string;
+    timestamp: string;
+    turnId?: string;
+}
+/**
+ * Result of building provenance for a single extracted fact.
+ */
+interface ProvenanceBuildResult {
+    /** Verified sources (one per matching turn). Absent when no quote survives. */
+    sources?: ProvenanceSource[];
+    /** Coarse strength tag persisted to frontmatter. */
+    provenance: "verified" | "unverified" | "none";
+    /**
+     * Transient signal (never persisted): `true` when `config.requireSpans`
+     * is enabled and the LLM-provided quote could not be located in ANY source
+     * turn (the strict case `ProvenanceConfig.requireSpans` documents: "facts
+     * whose quote cannot be located are routed to `pending_review`"). The
+     * extraction consumer carries this onto the in-memory `ExtractedFact` so
+     * the persist path can route the fact to the review queue. A quote that
+     * WAS located but whose source was dropped (e.g. un-coercible timestamp)
+     * does NOT set this flag — the span was found, so requireSpans is
+     * satisfied (chatgpt-codex-connector thread 4xB).
+     */
+    requireSpansPending?: boolean;
+}
+declare function buildFactProvenance(factQuote: string | null | undefined, turns: ReadonlyArray<ProvenanceTurnInput>, config: ProvenanceConfig): ProvenanceBuildResult;
 
-export { parseProvenanceConfig, parseProvenanceSources, parseProvenanceTag, reconcileProvenanceRead, serializeProvenanceFields };
+export { type ProvenanceBuildResult, type ProvenanceTurnInput, buildFactProvenance, parseProvenanceConfig, parseProvenanceSources, parseProvenanceTag, reconcileProvenanceRead, serializeProvenanceFields };

package/dist/provenance.js

@@ -1,13 +1,17 @@
 import {
+  buildFactProvenance,
   parseProvenanceConfig,
   parseProvenanceSources,
   parseProvenanceTag,
   reconcileProvenanceRead,
   serializeProvenanceFields
-} from "./chunk-ZPQVJEVQ.js";
+} from "./chunk-SK2CR6MW.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-JUC24CTX.js";
+import "./chunk-6MKAMLQL.js";
 import "./chunk-PZ5AY32C.js";
 export {
+  buildFactProvenance,
   parseProvenanceConfig,
   parseProvenanceSources,
   parseProvenanceTag,

package/dist/qmd-recall-cache.d.ts

@@ -1,4 +1,4 @@
-import { i as RecallPlanMode } from './types-PuiPZ9iE.js';
+import { i as RecallPlanMode } from './types-MWKPZnM0.js';
 import { SearchQueryOptions } from './search/port.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/qmd.d.ts

@@ -1,4 +1,4 @@
-import { Q as QmdSearchResult, ab as QmdSearchExplain } from './types-PuiPZ9iE.js';
+import { Q as QmdSearchResult, ab as QmdSearchExplain } from './types-MWKPZnM0.js';
 import { SearchBackend, SearchExecutionOptions, SearchQueryOptions } from './search/port.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/recall-disclosure-escalation.d.ts

@@ -1,4 +1,4 @@
-import { j as RecallDisclosure } from './types-PuiPZ9iE.js';
+import { j as RecallDisclosure } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/recall-explain-renderer.d.ts

@@ -1,5 +1,5 @@
 import { LastRecallSnapshot } from './recall-state.js';
-import { R as RecallTierExplain } from './types-PuiPZ9iE.js';
+import { R as RecallTierExplain } from './types-MWKPZnM0.js';
 import { RecallXraySnapshot } from './recall-xray.js';
 import './search/port.js';
 import './types-ByK7T3L6.js';

package/dist/recall-explain-renderer.js

@@ -5,10 +5,10 @@ import {
   toRecallExplainJson,
   toRecallExplainText,
   toRecallXraySnapshotFromLegacy
-} from "./chunk-D75JXBV4.js";
+} from "./chunk-WN4GHSDH.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-SDPDU2PM.js";
-import "./chunk-IKNQAGBV.js";
+import "./chunk-YTMDF6S7.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

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

@@ -119,6 +119,21 @@ interface UnifiedRankConfig<TIntent> {
      * The rank primary key is ALWAYS DESC regardless of this setting.
      */
     turnIndexSortDirection?: TurnIndexSortDirection;
+    /**
+     * When `true`, skip the sort stage entirely and return items in their
+     * post-dedup insertion order (first-seen first). Used by explicit-cue,
+     * whose deliberate value ordering — turn references → content cues →
+     * lexical cues, gathered by evidence TYPE then read-key priority — is the
+     * pipeline's highest-value design choice. A rank-based sort would invert
+     * it (turn references are deliberately UNSCORED while lexical hits carry
+     * numeric scores; sorting by score would demote turn references below
+     * weak lexical hits — cursor[bot] / codex P2 on #1505).
+     *
+     * Score and threshold-filter still apply when declared; only the sort is
+     * skipped. The constant scorer (`scoreEvidence: () => 0`) makes the
+     * no-scoring policy explicit alongside this flag.
+     */
+    preserveInsertionOrder?: boolean;
 }
 /**
  * Deduplicate, score, threshold-filter, and sort evidence items under one

package/dist/recall-pipeline-stages.js

@@ -1,60 +1,7 @@
+import {
+  unifiedDedupeAndRank
+} from "./chunk-LUPVCGYK.js";
 import "./chunk-PZ5AY32C.js";
-
-// src/recall-pipeline-stages.ts
-var UNDEFINED_TURN_INDEX_DESC_SENTINEL = -1;
-var UNDEFINED_TURN_INDEX_ASC_SENTINEL = Number.MAX_SAFE_INTEGER;
-function unifiedDedupeAndRank(items, config) {
-  const transformContent = config.transformContent ?? ((content) => content);
-  const direction = config.turnIndexSortDirection ?? "desc";
-  const dedupByContent = config.dedupByContent !== false;
-  const seenIds = /* @__PURE__ */ new Set();
-  const seenContent = /* @__PURE__ */ new Set();
-  const survivors = [];
-  for (const item of items) {
-    const id = resolveItemId(item);
-    if (id && seenIds.has(id)) continue;
-    const transformedContent = transformContent(item.content, config.intents);
-    if (dedupByContent) {
-      const contentKey = transformedContent.toLowerCase().replace(/\s+/g, " ").trim();
-      if (seenContent.has(contentKey)) continue;
-      seenContent.add(contentKey);
-    }
-    if (id) seenIds.add(id);
-    survivors.push({ original: item, transformedContent });
-  }
-  const scored = survivors.map(({ original, transformedContent }) => ({
-    ...original,
-    content: transformedContent,
-    rank: config.scoreEvidence(original, config.query, config.intents)
-  }));
-  const filtered = typeof config.rankThreshold === "number" ? scored.filter((item) => item.rank >= config.rankThreshold) : scored;
-  return filtered.sort(makeComparator(direction));
-}
-function makeComparator(direction) {
-  if (direction === "asc") {
-    return (left, right) => {
-      if (right.rank !== left.rank) return right.rank - left.rank;
-      const leftTurn = typeof left.turnIndex === "number" ? left.turnIndex : UNDEFINED_TURN_INDEX_ASC_SENTINEL;
-      const rightTurn = typeof right.turnIndex === "number" ? right.turnIndex : UNDEFINED_TURN_INDEX_ASC_SENTINEL;
-      if (leftTurn !== rightTurn) return leftTurn - rightTurn;
-      return left.content.localeCompare(right.content);
-    };
-  }
-  return (left, right) => {
-    if (right.rank !== left.rank) return right.rank - left.rank;
-    const leftTurn = typeof left.turnIndex === "number" ? left.turnIndex : UNDEFINED_TURN_INDEX_DESC_SENTINEL;
-    const rightTurn = typeof right.turnIndex === "number" ? right.turnIndex : UNDEFINED_TURN_INDEX_DESC_SENTINEL;
-    if (rightTurn !== leftTurn) return rightTurn - leftTurn;
-    return (right.score ?? 0) - (left.score ?? 0);
-  };
-}
-function resolveItemId(item) {
-  if (item.id) return item.id;
-  if (item.sessionId && typeof item.turnIndex === "number") {
-    return `${item.sessionId}:${item.turnIndex}`;
-  }
-  return void 0;
-}
 export {
   unifiedDedupeAndRank
 };

package/dist/recall-pipeline-stages.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/recall-pipeline-stages.ts"],"sourcesContent":["/**\n * Issue #1539 PR2 — the staged recall pipeline spine.\n *\n * The four recall pipelines (`targeted-fact-recall.ts`, `response-guidance-\n * recall.ts`, `explicit-cue-recall.ts`, `event-order-recall.ts`) implement\n * the same stage sequence — intent → candidate collection → dedup → rank →\n * filter → slice → metadata insertion → token budgeting — with ~70%\n * near-duplicate code. The most dangerous divergence is the sort\n * comparator: guidance/targeted-fact sort `turnIndex` DESC (recency) while\n * event-order sorts `turnIndex` ASC (chronological). The comparators are\n * byte-identical except for this direction — copy-pasting into a new\n * chronological pipeline silently inverts the ordering.\n *\n * This module centralizes the **dedup + score + threshold-filter + sort**\n * stages behind one declared config object. Per-tier divergence (threshold\n * value, sort direction, content transformation) becomes a declared config\n * field instead of embedded code.\n *\n * **PR 2 scope:** extract the module with NO pipeline changes. PRs 3–6\n * migrate each pipeline to call `unifiedDedupeAndRank` one at a time,\n * re-running the characterization snapshots\n * (`tests/recall-pipeline-unified.test.ts`) to verify byte-for-byte parity.\n *\n * Future PRs will add the remaining stages from the issue's Solution\n * (`mergeAcrossLcmKeys`, `insertMetadata`) once the per-tier hooks are\n * factored out of each pipeline.\n *\n * @see https://github.com/joshuaswarren/remnic/issues/1539\n */\n\nimport type { EvidencePackItem } from \"./evidence-pack.js\";\n\n/** A ranked evidence item: an `EvidencePackItem` with a computed `rank`. */\nexport interface RankedEvidenceItem extends EvidencePackItem {\n  rank: number;\n}\n\n/**\n * Sort direction for the turn-index secondary key. This is the divergence\n * issue #1539 identifies: relevance-ranked pipelines (targeted-fact,\n * response-guidance) sort `turnIndex` DESC (recency — latest first); the\n * chronological pipeline (event-order) sorts `turnIndex` ASC (earliest\n * first). The rank primary key is ALWAYS DESC (higher rank first); only\n * the `turnIndex` tiebreaker flips direction.\n */\nexport type TurnIndexSortDirection = \"desc\" | \"asc\";\n\n/**\n * Configuration for the unified dedup + score + threshold-filter + sort\n * pass. Each pipeline declares its divergences as fields here instead of\n * embedding them in pipeline-specific code.\n *\n * The issue's Solution defines the intended full config object\n * (`RecallPipelineConfig`); this interface is extracted incrementally:\n *   - PR 2 (this PR): dedup/score/threshold/sort only\n *   - PRs 3–6: migrate each pipeline to consume the spine\n *   - future: add `mergeAcrossLcmKeys`, `insertMetadata` once the per-tier\n *     hooks are factored out of each pipeline\n */\nexport interface UnifiedRankConfig<TIntent> {\n  /** The user query — passed to the scorer. */\n  query: string;\n  /**\n   * Per-tier intent classification result (already computed by the caller;\n   * intent classification stays per-tier because it is genuinely\n   * per-tier per issue #1539 Pitfall 1).\n   */\n  intents: TIntent[];\n  /**\n   * Score an item using its ORIGINAL (pre-transform) content. Higher = more\n   * relevant. The return value becomes the item's `rank`. For pipelines\n   * that don't score (explicit-cue), pass a constant scorer — the config\n   * makes the no-scoring policy explicit.\n   */\n  scoreEvidence: (\n    item: EvidencePackItem,\n    query: string,\n    intents: TIntent[],\n  ) => number;\n  /**\n   * Optional content transformation applied to each surviving item's\n   * OUTPUT content (NOT to the content the scorer sees). Per-tier\n   * cue-appenders go here:\n   *   - targeted-fact: `appendNormalizedNumericCues`\n   *   - response-guidance: `appendGuidanceCues`\n   *   - event-order: `appendChronologicalCues`\n   *\n   * The dedup key uses the TRANSFORMED content. This is equivalent to\n   * deduping on original content for all existing pipelines because every\n   * transform is a deterministic append (same original → same transformed →\n   * same key; different originals → different transformed → different key).\n   */\n  transformContent?: (content: string, intents: TIntent[]) => string;\n  /**\n   * Whether to deduplicate by normalized (transformed) content in addition to\n   * id. Default `true` — matches targeted-fact, response-guidance, and\n   * explicit-cue, which all collapse later items sharing a normalized content\n   * key. Event-order sets this to `false`: its rank pass\n   * (`rankAndSelectEventOrderItems`) deduplicates by turn id only and keeps\n   * distinct turns even when two turns share the same cue-appended body\n   * (legitimate repeated turns in a chronological transcript). Making this a\n   * declared field prevents PR 6's migration from silently dropping valid\n   * turns (cursor bugbot a4299851).\n   */\n  dedupByContent?: boolean;\n  /**\n   * Items with `rank` below this threshold are dropped. `undefined` = no\n   * filter. Event-order declares `rankThreshold: 6` here instead of\n   * inlining an undocumented `.filter((item) => item.rank >= 6)` (the\n   * \"hardcoded rank threshold that exists in no config and no other\n   * pipeline\" from issue #1539's audit).\n   */\n  rankThreshold?: number;\n  /**\n   * Sort direction for the `turnIndex` secondary key.\n   *\n   * - `\"desc\"` (default): relevance-ranked pipelines (targeted-fact,\n   *   response-guidance) sort `turnIndex` DESC. Undefined `turnIndex`\n   *   falls to `-1` (bottom of a DESC list). Tertiary tiebreaker:\n   *   `score DESC`.\n   * - `\"asc\"`: the chronological pipeline (event-order) sorts `turnIndex`\n   *   ASC. Undefined `turnIndex` falls to `Number.MAX_SAFE_INTEGER`\n   *   (bottom of an ASC list). Tertiary tiebreaker: `content.localeCompare`.\n   *\n   * The rank primary key is ALWAYS DESC regardless of this setting.\n   */\n  turnIndexSortDirection?: TurnIndexSortDirection;\n}\n\n/**\n * Sentinel for undefined `turnIndex` when sorting DESC. `-1` sorts below\n * every real turn index (which are `>= 0`), so missing `turn_index` always\n * lands at the bottom of a DESC-ordered list — never wins ordering over a\n * real turn.\n */\nconst UNDEFINED_TURN_INDEX_DESC_SENTINEL = -1;\n\n/**\n * Sentinel for undefined `turnIndex` when sorting ASC.\n * `Number.MAX_SAFE_INTEGER` sorts above every real turn index, so missing\n * `turn_index` always lands at the bottom of an ASC-ordered list.\n */\nconst UNDEFINED_TURN_INDEX_ASC_SENTINEL = Number.MAX_SAFE_INTEGER;\n\n/**\n * Deduplicate, score, threshold-filter, and sort evidence items under one\n * unified policy.\n *\n * **Stage order** (matches every existing pipeline's rank/dedupe function):\n *   1. **dedup** by `id` + normalized content (first-seen wins). The dedup\n *      key uses transformed content if `transformContent` is declared.\n *   2. **score** each surviving item on its ORIGINAL content (the transform\n *      does not influence the score).\n *   3. **threshold-filter**: drop items with `rank < rankThreshold` (if\n *      declared).\n *   4. **sort**: `rank DESC` → `turnIndex` (direction-configurable) →\n *      tertiary tiebreaker (`score DESC` for relevance pipelines,\n *      `content.localeCompare` for chronological pipelines).\n *\n * This function does NOT slice (`maxResults`), budget, or format — those\n * stages remain per-tier because they interact with per-tier metadata\n * insertion. The issue's Solution describes a future `insertMetadata` hook\n * that will make budget-adjustment uniform; that lands in the per-tier\n * migration PRs.\n *\n * @example\n * // Relevance-ranked pipeline (targeted-fact shape):\n * unifiedDedupeAndRank(items, {\n *   query,\n *   intents: [],\n *   scoreEvidence: (item, q) => scoreTargetedFact(item, q),\n *   transformContent: (content) => appendNormalizedNumericCues(content),\n *   // turnIndexSortDirection defaults to \"desc\"\n * });\n *\n * @example\n * // Chronological pipeline (event-order shape):\n * unifiedDedupeAndRank(items, {\n *   query,\n *   intents: [],\n *   scoreEvidence: (item, q) => scoreEventOrder(item, q),\n *   transformContent: (content) => appendChronologicalCues(content, query),\n *   rankThreshold: 6,           // declared, not inlined\n *   turnIndexSortDirection: \"asc\",\n * });\n */\nexport function unifiedDedupeAndRank<TIntent>(\n  items: readonly EvidencePackItem[],\n  config: UnifiedRankConfig<TIntent>,\n): RankedEvidenceItem[] {\n  const transformContent = config.transformContent ?? ((content: string) => content);\n  const direction: TurnIndexSortDirection = config.turnIndexSortDirection ?? \"desc\";\n  const dedupByContent = config.dedupByContent !== false;\n\n  // Stage 1: dedup by id (+ normalized transformed content when enabled).\n  // First-seen wins, matching every existing pipeline. Event-order opts out\n  // of content dedup (dedupByContent: false) because it keeps distinct turns\n  // even when two turns share the same cue-appended body.\n  const seenIds = new Set<string>();\n  const seenContent = new Set<string>();\n  const survivors: Array<{ original: EvidencePackItem; transformedContent: string }> = [];\n\n  for (const item of items) {\n    const id = resolveItemId(item);\n    if (id && seenIds.has(id)) continue;\n\n    const transformedContent = transformContent(item.content, config.intents);\n    if (dedupByContent) {\n      const contentKey = transformedContent.toLowerCase().replace(/\\s+/g, \" \").trim();\n      if (seenContent.has(contentKey)) continue;\n      seenContent.add(contentKey);\n    }\n    if (id) seenIds.add(id);\n    survivors.push({ original: item, transformedContent });\n  }\n\n  // Stage 2: score on ORIGINAL content (transforms don't influence the score).\n  const scored: RankedEvidenceItem[] = survivors.map(({ original, transformedContent }) => ({\n    ...original,\n    content: transformedContent,\n    rank: config.scoreEvidence(original, config.query, config.intents),\n  }));\n\n  // Stage 3: threshold-filter (declared, not inlined).\n  const filtered =\n    typeof config.rankThreshold === \"number\"\n      ? scored.filter((item) => item.rank >= (config.rankThreshold as number))\n      : scored;\n\n  // Stage 4: sort.\n  // rank is ALWAYS DESC (higher rank first).\n  // turnIndex direction is configurable: DESC (relevance) or ASC (chronology).\n  // The tertiary tiebreaker follows the direction:\n  //   DESC → score DESC; ASC → content.localeCompare.\n  return filtered.sort(makeComparator(direction));\n}\n\n/**\n * Build the sort comparator for the configured direction. Extracted so the\n * comparator's two shapes (DESC / ASC) can be tested independently and so\n * the direction divergence is visible in ONE place.\n */\nfunction makeComparator(\n  direction: TurnIndexSortDirection,\n): (left: RankedEvidenceItem, right: RankedEvidenceItem) => number {\n  if (direction === \"asc\") {\n    // Chronological (event-order): rank DESC → turnIndex ASC → content localeCompare.\n    // Matches event-order-recall.ts:159-164 (rankedByScore sort) byte-for-byte.\n    return (left, right) => {\n      if (right.rank !== left.rank) return right.rank - left.rank;\n      const leftTurn =\n        typeof left.turnIndex === \"number\"\n          ? left.turnIndex\n          : UNDEFINED_TURN_INDEX_ASC_SENTINEL;\n      const rightTurn =\n        typeof right.turnIndex === \"number\"\n          ? right.turnIndex\n          : UNDEFINED_TURN_INDEX_ASC_SENTINEL;\n      if (leftTurn !== rightTurn) return leftTurn - rightTurn;\n      return left.content.localeCompare(right.content);\n    };\n  }\n  // Relevance-ranked (targeted-fact, response-guidance):\n  // rank DESC → turnIndex DESC → score DESC.\n  // Matches targeted-fact-recall.ts:239-245 and response-guidance-recall.ts:374-380\n  // byte-for-byte.\n  return (left, right) => {\n    if (right.rank !== left.rank) return right.rank - left.rank;\n    const leftTurn =\n      typeof left.turnIndex === \"number\"\n        ? left.turnIndex\n        : UNDEFINED_TURN_INDEX_DESC_SENTINEL;\n    const rightTurn =\n      typeof right.turnIndex === \"number\"\n        ? right.turnIndex\n        : UNDEFINED_TURN_INDEX_DESC_SENTINEL;\n    if (rightTurn !== leftTurn) return rightTurn - leftTurn;\n    return (right.score ?? 0) - (left.score ?? 0);\n  };\n}\n\n\n/**\n * Resolve an evidence item's id. Falls back to `sessionId:turnIndex` when\n * `id` is absent — mirrors every existing pipeline's fallback and\n * `evidence-pack.ts`'s `evidenceItemFallbackId`.\n */\nfunction resolveItemId(item: EvidencePackItem): string | undefined {\n  if (item.id) return item.id;\n  if (item.sessionId && typeof item.turnIndex === \"number\") {\n    return `${item.sessionId}:${item.turnIndex}`;\n  }\n  return undefined;\n}\n"],"mappings":";;;AAuIA,IAAM,qCAAqC;AAO3C,IAAM,oCAAoC,OAAO;AA4C1C,SAAS,qBACd,OACA,QACsB;AACtB,QAAM,mBAAmB,OAAO,qBAAqB,CAAC,YAAoB;AAC1E,QAAM,YAAoC,OAAO,0BAA0B;AAC3E,QAAM,iBAAiB,OAAO,mBAAmB;AAMjD,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,cAAc,oBAAI,IAAY;AACpC,QAAM,YAA+E,CAAC;AAEtF,aAAW,QAAQ,OAAO;AACxB,UAAM,KAAK,cAAc,IAAI;AAC7B,QAAI,MAAM,QAAQ,IAAI,EAAE,EAAG;AAE3B,UAAM,qBAAqB,iBAAiB,KAAK,SAAS,OAAO,OAAO;AACxE,QAAI,gBAAgB;AAClB,YAAM,aAAa,mBAAmB,YAAY,EAAE,QAAQ,QAAQ,GAAG,EAAE,KAAK;AAC9E,UAAI,YAAY,IAAI,UAAU,EAAG;AACjC,kBAAY,IAAI,UAAU;AAAA,IAC5B;AACA,QAAI,GAAI,SAAQ,IAAI,EAAE;AACtB,cAAU,KAAK,EAAE,UAAU,MAAM,mBAAmB,CAAC;AAAA,EACvD;AAGA,QAAM,SAA+B,UAAU,IAAI,CAAC,EAAE,UAAU,mBAAmB,OAAO;AAAA,IACxF,GAAG;AAAA,IACH,SAAS;AAAA,IACT,MAAM,OAAO,cAAc,UAAU,OAAO,OAAO,OAAO,OAAO;AAAA,EACnE,EAAE;AAGF,QAAM,WACJ,OAAO,OAAO,kBAAkB,WAC5B,OAAO,OAAO,CAAC,SAAS,KAAK,QAAS,OAAO,aAAwB,IACrE;AAON,SAAO,SAAS,KAAK,eAAe,SAAS,CAAC;AAChD;AAOA,SAAS,eACP,WACiE;AACjE,MAAI,cAAc,OAAO;AAGvB,WAAO,CAAC,MAAM,UAAU;AACtB,UAAI,MAAM,SAAS,KAAK,KAAM,QAAO,MAAM,OAAO,KAAK;AACvD,YAAM,WACJ,OAAO,KAAK,cAAc,WACtB,KAAK,YACL;AACN,YAAM,YACJ,OAAO,MAAM,cAAc,WACvB,MAAM,YACN;AACN,UAAI,aAAa,UAAW,QAAO,WAAW;AAC9C,aAAO,KAAK,QAAQ,cAAc,MAAM,OAAO;AAAA,IACjD;AAAA,EACF;AAKA,SAAO,CAAC,MAAM,UAAU;AACtB,QAAI,MAAM,SAAS,KAAK,KAAM,QAAO,MAAM,OAAO,KAAK;AACvD,UAAM,WACJ,OAAO,KAAK,cAAc,WACtB,KAAK,YACL;AACN,UAAM,YACJ,OAAO,MAAM,cAAc,WACvB,MAAM,YACN;AACN,QAAI,cAAc,SAAU,QAAO,YAAY;AAC/C,YAAQ,MAAM,SAAS,MAAM,KAAK,SAAS;AAAA,EAC7C;AACF;AAQA,SAAS,cAAc,MAA4C;AACjE,MAAI,KAAK,GAAI,QAAO,KAAK;AACzB,MAAI,KAAK,aAAa,OAAO,KAAK,cAAc,UAAU;AACxD,WAAO,GAAG,KAAK,SAAS,IAAI,KAAK,SAAS;AAAA,EAC5C;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recall-planner-llm.d.ts

@@ -1,4 +1,4 @@
-import { i as RecallPlanMode, P as PluginConfig } from './types-PuiPZ9iE.js';
+import { i as RecallPlanMode, P as PluginConfig } from './types-MWKPZnM0.js';
 import { CapabilitySet } from './capabilities.js';
 import { FallbackLlmClient, FallbackLlmOptions } from './fallback-llm.js';
 import './types-ByK7T3L6.js';

package/dist/recall-state.d.ts

@@ -1,5 +1,5 @@
 import { SearchDegradation } from './search/port.js';
-import { i as RecallPlanMode, I as IdentityInjectionMode, R as RecallTierExplain } from './types-PuiPZ9iE.js';
+import { i as RecallPlanMode, I as IdentityInjectionMode, R as RecallTierExplain } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/recall-tag-filter.d.ts

@@ -1,6 +1,6 @@
 import { RecallFilterTrace } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-PuiPZ9iE.js';
+import './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './user-model.js';

package/dist/recall-xray-cli.d.ts

@@ -1,5 +1,5 @@
 import { RecallXrayFormat } from './recall-xray-renderer.js';
-import { j as RecallDisclosure } from './types-PuiPZ9iE.js';
+import { j as RecallDisclosure } from './types-MWKPZnM0.js';
 import './recall-xray.js';
 import './memory-provenance.js';
 import './user-model.js';

package/dist/recall-xray-cli.js

@@ -2,11 +2,11 @@ import {
   parseXrayBudgetFlag,
   parseXrayCliOptions,
   parseXrayDisclosureFlag
-} from "./chunk-IJEZMWKA.js";
-import "./chunk-D75JXBV4.js";
+} from "./chunk-SFOAQQDJ.js";
+import "./chunk-WN4GHSDH.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-SDPDU2PM.js";
-import "./chunk-IKNQAGBV.js";
+import "./chunk-YTMDF6S7.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/recall-xray-renderer.d.ts

@@ -1,6 +1,6 @@
 import { RecallXraySnapshot } from './recall-xray.js';
 import './memory-provenance.js';
-import './types-PuiPZ9iE.js';
+import './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 import './user-model.js';

package/dist/recall-xray-renderer.js

@@ -5,10 +5,10 @@ import {
   renderXrayJson,
   renderXrayMarkdown,
   renderXrayText
-} from "./chunk-D75JXBV4.js";
+} from "./chunk-WN4GHSDH.js";
 import "./chunk-SOBJ6NEY.js";
-import "./chunk-SDPDU2PM.js";
-import "./chunk-IKNQAGBV.js";
+import "./chunk-YTMDF6S7.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/recall-xray.d.ts

@@ -1,5 +1,5 @@
 import { RetrievedMemoryProvenance } from './memory-provenance.js';
-import { R as RecallTierExplain, j as RecallDisclosure } from './types-PuiPZ9iE.js';
+import { R as RecallTierExplain, j as RecallDisclosure } from './types-MWKPZnM0.js';
 import './user-model.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/recall-xray.js

@@ -5,8 +5,8 @@ import {
   estimateRecallTokens,
   isRecallXrayServedBy,
   summarizeDisclosureTokens
-} from "./chunk-SDPDU2PM.js";
-import "./chunk-IKNQAGBV.js";
+} from "./chunk-YTMDF6S7.js";
+import "./chunk-IX3UQT4H.js";
 import "./chunk-I4WBNM3M.js";
 import "./chunk-SOAU2OE2.js";
 import "./chunk-PZ5AY32C.js";

package/dist/resolve-auth-token.d.ts

@@ -1,4 +1,4 @@
-import { D as SecretRef, J as AgentAccessAuthToken } from './types-PuiPZ9iE.js';
+import { D as SecretRef, J as AgentAccessAuthToken } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/response-guidance-recall.js

@@ -1,8 +1,9 @@
 import {
   buildResponseGuidanceRecallSection,
   shouldRecallResponseGuidance
-} from "./chunk-EC2AYKRX.js";
+} from "./chunk-L6W77GWW.js";
 import "./chunk-YVVQUAOO.js";
+import "./chunk-LUPVCGYK.js";
 import "./chunk-PYPOFEMK.js";
 import "./chunk-PZ5AY32C.js";
 export {

package/dist/resume-bundles.js

@@ -4,24 +4,26 @@ import {
   recordResumeBundle,
   resolveResumeBundleDir,
   validateResumeBundle
-} from "./chunk-T5QAZIBO.js";
+} from "./chunk-MOXFPLD6.js";
 import "./chunk-ZRWB5D4H.js";
-import "./chunk-PONNZ54D.js";
-import "./chunk-S4DDLTPX.js";
+import "./chunk-GY3SKOS4.js";
 import "./chunk-KFY3SGN7.js";
 import "./chunk-LMDRGRJ2.js";
-import "./chunk-K4DWSPMW.js";
+import "./chunk-WRGPE6AW.js";
 import "./chunk-NDAH7BJ5.js";
 import "./chunk-Z5LAYHGJ.js";
 import "./chunk-OO42R444.js";
 import "./chunk-K6MV3TRQ.js";
+import "./chunk-S4DDLTPX.js";
 import "./chunk-FF4KLI5W.js";
 import "./chunk-6HMYUWXR.js";
-import "./chunk-ZPQVJEVQ.js";
+import "./chunk-SK2CR6MW.js";
+import "./chunk-FVQJYWH7.js";
 import "./chunk-4DJQYKMN.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-NU3CSQ4H.js";
+import "./chunk-6MKAMLQL.js";
 import "./chunk-ZBJMUXZH.js";
 import "./chunk-A2IYSXDQ.js";
 import "./chunk-LPSF4OQH.js";

package/dist/retrieval-agents.d.ts

@@ -1,4 +1,4 @@
-import { Q as QmdSearchResult } from './types-PuiPZ9iE.js';
+import { Q as QmdSearchResult } from './types-MWKPZnM0.js';
 import { QmdClient } from './qmd.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';

package/dist/retrieval-tiers.d.ts

@@ -1,4 +1,4 @@
-import { ak as RetrievalTier } from './types-PuiPZ9iE.js';
+import { ak as RetrievalTier } from './types-MWKPZnM0.js';
 import './types-ByK7T3L6.js';
 import './index-DJ9QWMw-.js';
 

package/dist/routing/engine.d.ts

@@ -1,4 +1,4 @@
-import { M as MemoryCategory } from '../types-PuiPZ9iE.js';
+import { M as MemoryCategory } from '../types-MWKPZnM0.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';
 

package/dist/routing/store.d.ts

@@ -1,5 +1,5 @@
 import { RoutingEngineOptions, RouteRule } from './engine.js';
-import '../types-PuiPZ9iE.js';
+import '../types-MWKPZnM0.js';
 import '../types-ByK7T3L6.js';
 import '../index-DJ9QWMw-.js';