@remnic/core 9.3.701 → 9.3.703

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (302) hide show
  1. package/dist/access-boundary.d.ts +7 -7
  2. package/dist/access-boundary.js +15 -12
  3. package/dist/access-cli.js +36 -33
  4. package/dist/access-cli.js.map +1 -1
  5. package/dist/access-http.d.ts +7 -7
  6. package/dist/access-http.js +18 -15
  7. package/dist/access-mcp.d.ts +7 -7
  8. package/dist/access-mcp.js +17 -14
  9. package/dist/access-operations.d.ts +7 -7
  10. package/dist/access-operations.js +16 -13
  11. package/dist/{access-service-CGVWK6lZ.d.ts → access-service-COCzhgEL.d.ts} +397 -19
  12. package/dist/access-service.d.ts +6 -6
  13. package/dist/access-service.js +14 -11
  14. package/dist/access-surface-catalog.d.ts +7 -7
  15. package/dist/action-confidence.d.ts +1 -1
  16. package/dist/active-memory-bridge.d.ts +1 -1
  17. package/dist/active-memory-bridge.js +2 -2
  18. package/dist/active-recall.d.ts +1 -1
  19. package/dist/active-recall.js +7 -6
  20. package/dist/active-recall.js.map +1 -1
  21. package/dist/behavior-learner.d.ts +1 -1
  22. package/dist/behavior-signals.d.ts +1 -1
  23. package/dist/bootstrap.d.ts +5 -5
  24. package/dist/briefing.d.ts +1 -1
  25. package/dist/briefing.js +6 -5
  26. package/dist/buffer-surprise-report.d.ts +1 -1
  27. package/dist/buffer.d.ts +1 -1
  28. package/dist/calibration.d.ts +1 -1
  29. package/dist/capabilities.d.ts +1 -1
  30. package/dist/{catalog-DBIghceA.d.ts → catalog-DxCzhjE6.d.ts} +2 -2
  31. package/dist/causal-behavior.d.ts +1 -1
  32. package/dist/causal-consolidation.d.ts +1 -1
  33. package/dist/causal-consolidation.js +7 -6
  34. package/dist/causal-consolidation.js.map +1 -1
  35. package/dist/{chunk-YXLT4EMM.js → chunk-4463LUIE.js} +12 -2
  36. package/dist/chunk-4463LUIE.js.map +1 -0
  37. package/dist/{chunk-R5DB26G6.js → chunk-4SBW47WK.js} +9 -23
  38. package/dist/chunk-4SBW47WK.js.map +1 -0
  39. package/dist/{chunk-KF4TXW7Z.js → chunk-5VXVXJH6.js} +149 -6
  40. package/dist/{chunk-KF4TXW7Z.js.map → chunk-5VXVXJH6.js.map} +1 -1
  41. package/dist/{chunk-ODTWHSY2.js → chunk-64XXOQRW.js} +2 -2
  42. package/dist/{chunk-ZT7B64BE.js → chunk-6TAETM63.js} +2 -2
  43. package/dist/{chunk-HF4N43Q7.js → chunk-6VVP6NK7.js} +2 -2
  44. package/dist/{chunk-FN2SM5SN.js → chunk-ABCGDW3A.js} +75 -12
  45. package/dist/chunk-ABCGDW3A.js.map +1 -0
  46. package/dist/{chunk-7TAQEPLE.js → chunk-AMNLZ6SF.js} +2 -2
  47. package/dist/{chunk-KS7WQ4BZ.js → chunk-CZJ6QSKG.js} +3 -3
  48. package/dist/{chunk-27LQPUMZ.js → chunk-EOOVJK2U.js} +3 -3
  49. package/dist/{chunk-QP37KL5H.js → chunk-EYJD6KIO.js} +2 -2
  50. package/dist/{chunk-WFEZUGU5.js → chunk-EZR35XHX.js} +2 -2
  51. package/dist/{chunk-UU6MVCJ6.js → chunk-FIOYURII.js} +32 -25
  52. package/dist/chunk-FIOYURII.js.map +1 -0
  53. package/dist/{chunk-JO3E5VGS.js → chunk-FVI5B7DE.js} +2 -2
  54. package/dist/{chunk-SFMRLXIV.js → chunk-GFIARMA7.js} +15 -7
  55. package/dist/chunk-GFIARMA7.js.map +1 -0
  56. package/dist/{chunk-PONNZ54D.js → chunk-GY3SKOS4.js} +4 -4
  57. package/dist/{chunk-U33LWTQQ.js → chunk-HV57RHMD.js} +4 -4
  58. package/dist/{chunk-IKNQAGBV.js → chunk-IX3UQT4H.js} +1 -1
  59. package/dist/{chunk-IKNQAGBV.js.map → chunk-IX3UQT4H.js.map} +1 -1
  60. package/dist/{chunk-IYOPIG3E.js → chunk-IX72AAMZ.js} +2 -2
  61. package/dist/{chunk-JKOKX3PS.js → chunk-JMA4RYRN.js} +2 -2
  62. package/dist/{chunk-DEDQXIDL.js → chunk-JTKFZMZ7.js} +2 -2
  63. package/dist/{chunk-OLOYQZFB.js → chunk-KC6TCAWV.js} +5 -5
  64. package/dist/{chunk-ROZJACKP.js → chunk-KKK7YTYN.js} +4 -1
  65. package/dist/chunk-KKK7YTYN.js.map +1 -0
  66. package/dist/{chunk-EC2AYKRX.js → chunk-L6W77GWW.js} +10 -24
  67. package/dist/chunk-L6W77GWW.js.map +1 -0
  68. package/dist/{chunk-ED35D32I.js → chunk-LQ4J7ELC.js} +2 -2
  69. package/dist/chunk-LUPVCGYK.js +63 -0
  70. package/dist/chunk-LUPVCGYK.js.map +1 -0
  71. package/dist/{chunk-TFVVONWD.js → chunk-MBUM2Y3L.js} +2 -2
  72. package/dist/{chunk-T5QAZIBO.js → chunk-MOXFPLD6.js} +3 -3
  73. package/dist/{chunk-XTIRCSIH.js → chunk-MXEWQKM7.js} +2 -2
  74. package/dist/{chunk-ZYNMX6IU.js → chunk-NUIJEGVD.js} +6 -6
  75. package/dist/{chunk-FUCJAZ25.js → chunk-OXEAMU42.js} +529 -9
  76. package/dist/chunk-OXEAMU42.js.map +1 -0
  77. package/dist/{chunk-YO4MBK3I.js → chunk-QGJAGC2J.js} +2 -2
  78. package/dist/{chunk-ISLJ5WIM.js → chunk-QIMFOCSH.js} +2 -2
  79. package/dist/{chunk-IJEZMWKA.js → chunk-SFOAQQDJ.js} +3 -3
  80. package/dist/{chunk-HRUULBBV.js → chunk-SHRRWOVY.js} +81 -4
  81. package/dist/chunk-SHRRWOVY.js.map +1 -0
  82. package/dist/{chunk-NINRTFSV.js → chunk-SINGJCUR.js} +5 -5
  83. package/dist/{chunk-ZPQVJEVQ.js → chunk-SK2CR6MW.js} +146 -2
  84. package/dist/chunk-SK2CR6MW.js.map +1 -0
  85. package/dist/{chunk-6W2D6FGG.js → chunk-TGAHHCB6.js} +2 -2
  86. package/dist/{chunk-D75JXBV4.js → chunk-WN4GHSDH.js} +2 -2
  87. package/dist/{chunk-K4DWSPMW.js → chunk-WRGPE6AW.js} +2 -2
  88. package/dist/{chunk-4HIAWLA2.js → chunk-XGMCUY5P.js} +60 -114
  89. package/dist/chunk-XGMCUY5P.js.map +1 -0
  90. package/dist/{chunk-SDPDU2PM.js → chunk-YTMDF6S7.js} +2 -2
  91. package/dist/{chunk-MNU5G4TK.js → chunk-Z7XEIAV4.js} +2 -2
  92. package/dist/{chunk-HXHKLVAS.js → chunk-ZCEI242W.js} +23 -23
  93. package/dist/{cli-D3XeenwN.d.ts → cli-BM4xQPp4.d.ts} +3 -3
  94. package/dist/cli.d.ts +7 -7
  95. package/dist/cli.js +33 -32
  96. package/dist/compounding/engine.d.ts +1 -1
  97. package/dist/compounding/engine.js +6 -5
  98. package/dist/compounding/preference-consolidator.d.ts +1 -1
  99. package/dist/compression-optimizer.d.ts +1 -1
  100. package/dist/config.d.ts +1 -1
  101. package/dist/config.js +4 -2
  102. package/dist/connectors/codex-materialize-runner.d.ts +1 -1
  103. package/dist/connectors/codex-materialize-runner.js +6 -5
  104. package/dist/connectors/codex-materialize.d.ts +1 -1
  105. package/dist/connectors/index.d.ts +1 -1
  106. package/dist/connectors/index.js +7 -6
  107. package/dist/consolidation-provenance-check.d.ts +1 -1
  108. package/dist/consolidation-undo.d.ts +1 -1
  109. package/dist/contradiction/index.d.ts +2 -2
  110. package/dist/conversation-index/backend.d.ts +1 -1
  111. package/dist/conversation-index/chunker.d.ts +1 -1
  112. package/dist/conversation-index/faiss-adapter.d.ts +1 -1
  113. package/dist/conversation-index/indexer.d.ts +1 -1
  114. package/dist/conversation-index/search.d.ts +1 -1
  115. package/dist/day-summary.d.ts +1 -1
  116. package/dist/delinearize.d.ts +1 -1
  117. package/dist/direct-answer-wiring.d.ts +1 -1
  118. package/dist/direct-answer.d.ts +1 -1
  119. package/dist/embedding-fallback.d.ts +1 -1
  120. package/dist/enrichment/index.d.ts +1 -1
  121. package/dist/entity-retrieval.d.ts +1 -1
  122. package/dist/entity-retrieval.js +6 -5
  123. package/dist/entity-schema.d.ts +1 -1
  124. package/dist/event-order-recall.js +2 -1
  125. package/dist/explicit-capture.d.ts +5 -5
  126. package/dist/explicit-capture.js +2 -2
  127. package/dist/explicit-cue-recall.js +2 -1
  128. package/dist/extraction-faithfulness.d.ts +1 -1
  129. package/dist/extraction-judge-telemetry.d.ts +1 -1
  130. package/dist/extraction-judge-training.d.ts +1 -1
  131. package/dist/extraction-judge.d.ts +1 -1
  132. package/dist/extraction.d.ts +14 -1
  133. package/dist/extraction.js +5 -3
  134. package/dist/fallback-llm.d.ts +1 -1
  135. package/dist/identity-continuity.d.ts +1 -1
  136. package/dist/importance.d.ts +1 -1
  137. package/dist/index.d.ts +123 -123
  138. package/dist/index.js +53 -52
  139. package/dist/index.js.map +1 -1
  140. package/dist/intent.d.ts +1 -1
  141. package/dist/lcm/engine.d.ts +1 -1
  142. package/dist/lcm/index.d.ts +1 -1
  143. package/dist/lcm/tools.d.ts +1 -1
  144. package/dist/lifecycle.d.ts +1 -1
  145. package/dist/live-connectors-runner.d.ts +1 -1
  146. package/dist/local-llm.d.ts +1 -1
  147. package/dist/maintenance/memory-governance.d.ts +1 -1
  148. package/dist/maintenance/memory-governance.js +6 -5
  149. package/dist/maintenance/rebuild-memory-lifecycle-ledger.js +6 -5
  150. package/dist/maintenance/rebuild-memory-projection.js +7 -6
  151. package/dist/mcp-memory-inspector-app.d.ts +7 -7
  152. package/dist/memory-action-policy.d.ts +1 -1
  153. package/dist/memory-cache.d.ts +1 -1
  154. package/dist/memory-lifecycle-ledger-utils.d.ts +1 -1
  155. package/dist/memory-projection-store.d.ts +1 -1
  156. package/dist/memory-provenance.d.ts +1 -1
  157. package/dist/memory-worth-outcomes.d.ts +1 -1
  158. package/dist/models-json.d.ts +1 -1
  159. package/dist/namespaces/migrate.d.ts +2 -2
  160. package/dist/namespaces/migrate.js +7 -6
  161. package/dist/namespaces/principal.d.ts +1 -1
  162. package/dist/namespaces/search.d.ts +1 -1
  163. package/dist/namespaces/storage.d.ts +2 -2
  164. package/dist/namespaces/storage.js +6 -5
  165. package/dist/native-knowledge.d.ts +1 -1
  166. package/dist/operator-toolkit.d.ts +1 -1
  167. package/dist/operator-toolkit.js +12 -11
  168. package/dist/orchestration/maintenance.d.ts +2 -2
  169. package/dist/orchestration/maintenance.js +8 -7
  170. package/dist/{orchestrator-BzMCZlKn.d.ts → orchestrator-C9CDWAm6.d.ts} +4 -4
  171. package/dist/orchestrator.d.ts +5 -5
  172. package/dist/orchestrator.js +29 -27
  173. package/dist/patterns-cli.d.ts +1 -1
  174. package/dist/policy-runtime.d.ts +1 -1
  175. package/dist/provenance.d.ts +36 -2
  176. package/dist/provenance.js +5 -1
  177. package/dist/qmd-recall-cache.d.ts +1 -1
  178. package/dist/qmd.d.ts +1 -1
  179. package/dist/recall-disclosure-escalation.d.ts +1 -1
  180. package/dist/recall-explain-renderer.d.ts +1 -1
  181. package/dist/recall-explain-renderer.js +3 -3
  182. package/dist/recall-pipeline-stages.d.ts +15 -0
  183. package/dist/recall-pipeline-stages.js +3 -56
  184. package/dist/recall-pipeline-stages.js.map +1 -1
  185. package/dist/recall-planner-llm.d.ts +1 -1
  186. package/dist/recall-state.d.ts +1 -1
  187. package/dist/recall-tag-filter.d.ts +1 -1
  188. package/dist/recall-xray-cli.d.ts +1 -1
  189. package/dist/recall-xray-cli.js +4 -4
  190. package/dist/recall-xray-renderer.d.ts +1 -1
  191. package/dist/recall-xray-renderer.js +3 -3
  192. package/dist/recall-xray.d.ts +1 -1
  193. package/dist/recall-xray.js +2 -2
  194. package/dist/resolve-auth-token.d.ts +1 -1
  195. package/dist/response-guidance-recall.js +2 -1
  196. package/dist/resume-bundles.js +7 -5
  197. package/dist/retrieval-agents.d.ts +1 -1
  198. package/dist/retrieval-tiers.d.ts +1 -1
  199. package/dist/routing/engine.d.ts +1 -1
  200. package/dist/routing/store.d.ts +1 -1
  201. package/dist/schemas.d.ts +41 -22
  202. package/dist/schemas.js +1 -1
  203. package/dist/search/embed-helper.d.ts +1 -1
  204. package/dist/search/factory.d.ts +1 -1
  205. package/dist/search/index.d.ts +1 -1
  206. package/dist/search/lancedb-backend.d.ts +1 -1
  207. package/dist/search/meilisearch-backend.d.ts +1 -1
  208. package/dist/search/noop-backend.d.ts +1 -1
  209. package/dist/search/orama-backend.d.ts +1 -1
  210. package/dist/search/port.d.ts +1 -1
  211. package/dist/search/remote-backend.d.ts +1 -1
  212. package/dist/{semantic-DJR8_DMQ.d.ts → semantic-SLAa_prH.d.ts} +1 -1
  213. package/dist/{semantic-consolidation-BtUfv-AL.d.ts → semantic-consolidation-DgFXyALl.d.ts} +1 -1
  214. package/dist/semantic-consolidation.d.ts +2 -2
  215. package/dist/semantic-consolidation.js +7 -6
  216. package/dist/semantic-rule-promotion.js +6 -5
  217. package/dist/semantic-rule-verifier.d.ts +1 -1
  218. package/dist/semantic-rule-verifier.js +6 -5
  219. package/dist/session-observer-bands.d.ts +1 -1
  220. package/dist/session-observer-state.d.ts +1 -1
  221. package/dist/shared-context/manager.d.ts +1 -1
  222. package/dist/signal.d.ts +1 -1
  223. package/dist/storage.d.ts +13 -1
  224. package/dist/storage.js +5 -4
  225. package/dist/summarizer.d.ts +1 -1
  226. package/dist/summary-snapshot.d.ts +1 -1
  227. package/dist/targeted-fact-recall.js +2 -1
  228. package/dist/temporal-supersession.d.ts +1 -1
  229. package/dist/temporal-validity.d.ts +1 -1
  230. package/dist/threading.d.ts +1 -1
  231. package/dist/tier-migration.d.ts +1 -1
  232. package/dist/tier-routing.d.ts +1 -1
  233. package/dist/topics.d.ts +1 -1
  234. package/dist/transcript.d.ts +1 -1
  235. package/dist/transcript.js +2 -2
  236. package/dist/transfer/types.d.ts +12 -12
  237. package/dist/{types-PuiPZ9iE.d.ts → types-MWKPZnM0.d.ts} +25 -1
  238. package/dist/types.d.ts +1 -1
  239. package/dist/types.js +1 -1
  240. package/dist/utility-runtime.d.ts +1 -1
  241. package/dist/verified-recall.js +6 -5
  242. package/package.json +2 -2
  243. package/src/access-http.ts +162 -0
  244. package/src/access-service.ts +215 -0
  245. package/src/admin/admin-surfaces.test.ts +458 -0
  246. package/src/admin/admin-surfaces.ts +819 -0
  247. package/src/event-order-recall.test.ts +53 -0
  248. package/src/event-order-recall.ts +61 -37
  249. package/src/explicit-cue-recall.ts +21 -1
  250. package/src/extraction.ts +91 -6
  251. package/src/orchestrator.ts +46 -5
  252. package/src/provenance-extraction.test.ts +838 -0
  253. package/src/provenance.ts +413 -0
  254. package/src/recall-pipeline-parity.test.ts +288 -0
  255. package/src/recall-pipeline-stages.test.ts +43 -0
  256. package/src/recall-pipeline-stages.ts +22 -0
  257. package/src/response-guidance-recall.ts +32 -36
  258. package/src/schemas.ts +7 -0
  259. package/src/storage.ts +23 -0
  260. package/src/targeted-fact-recall.ts +25 -32
  261. package/src/types.ts +24 -0
  262. package/dist/chunk-4HIAWLA2.js.map +0 -1
  263. package/dist/chunk-EC2AYKRX.js.map +0 -1
  264. package/dist/chunk-FN2SM5SN.js.map +0 -1
  265. package/dist/chunk-FUCJAZ25.js.map +0 -1
  266. package/dist/chunk-HRUULBBV.js.map +0 -1
  267. package/dist/chunk-R5DB26G6.js.map +0 -1
  268. package/dist/chunk-ROZJACKP.js.map +0 -1
  269. package/dist/chunk-SFMRLXIV.js.map +0 -1
  270. package/dist/chunk-UU6MVCJ6.js.map +0 -1
  271. package/dist/chunk-YXLT4EMM.js.map +0 -1
  272. package/dist/chunk-ZPQVJEVQ.js.map +0 -1
  273. /package/dist/{chunk-ODTWHSY2.js.map → chunk-64XXOQRW.js.map} +0 -0
  274. /package/dist/{chunk-ZT7B64BE.js.map → chunk-6TAETM63.js.map} +0 -0
  275. /package/dist/{chunk-HF4N43Q7.js.map → chunk-6VVP6NK7.js.map} +0 -0
  276. /package/dist/{chunk-7TAQEPLE.js.map → chunk-AMNLZ6SF.js.map} +0 -0
  277. /package/dist/{chunk-KS7WQ4BZ.js.map → chunk-CZJ6QSKG.js.map} +0 -0
  278. /package/dist/{chunk-27LQPUMZ.js.map → chunk-EOOVJK2U.js.map} +0 -0
  279. /package/dist/{chunk-QP37KL5H.js.map → chunk-EYJD6KIO.js.map} +0 -0
  280. /package/dist/{chunk-WFEZUGU5.js.map → chunk-EZR35XHX.js.map} +0 -0
  281. /package/dist/{chunk-JO3E5VGS.js.map → chunk-FVI5B7DE.js.map} +0 -0
  282. /package/dist/{chunk-PONNZ54D.js.map → chunk-GY3SKOS4.js.map} +0 -0
  283. /package/dist/{chunk-U33LWTQQ.js.map → chunk-HV57RHMD.js.map} +0 -0
  284. /package/dist/{chunk-IYOPIG3E.js.map → chunk-IX72AAMZ.js.map} +0 -0
  285. /package/dist/{chunk-JKOKX3PS.js.map → chunk-JMA4RYRN.js.map} +0 -0
  286. /package/dist/{chunk-DEDQXIDL.js.map → chunk-JTKFZMZ7.js.map} +0 -0
  287. /package/dist/{chunk-OLOYQZFB.js.map → chunk-KC6TCAWV.js.map} +0 -0
  288. /package/dist/{chunk-ED35D32I.js.map → chunk-LQ4J7ELC.js.map} +0 -0
  289. /package/dist/{chunk-TFVVONWD.js.map → chunk-MBUM2Y3L.js.map} +0 -0
  290. /package/dist/{chunk-T5QAZIBO.js.map → chunk-MOXFPLD6.js.map} +0 -0
  291. /package/dist/{chunk-XTIRCSIH.js.map → chunk-MXEWQKM7.js.map} +0 -0
  292. /package/dist/{chunk-ZYNMX6IU.js.map → chunk-NUIJEGVD.js.map} +0 -0
  293. /package/dist/{chunk-YO4MBK3I.js.map → chunk-QGJAGC2J.js.map} +0 -0
  294. /package/dist/{chunk-ISLJ5WIM.js.map → chunk-QIMFOCSH.js.map} +0 -0
  295. /package/dist/{chunk-IJEZMWKA.js.map → chunk-SFOAQQDJ.js.map} +0 -0
  296. /package/dist/{chunk-NINRTFSV.js.map → chunk-SINGJCUR.js.map} +0 -0
  297. /package/dist/{chunk-6W2D6FGG.js.map → chunk-TGAHHCB6.js.map} +0 -0
  298. /package/dist/{chunk-D75JXBV4.js.map → chunk-WN4GHSDH.js.map} +0 -0
  299. /package/dist/{chunk-K4DWSPMW.js.map → chunk-WRGPE6AW.js.map} +0 -0
  300. /package/dist/{chunk-SDPDU2PM.js.map → chunk-YTMDF6S7.js.map} +0 -0
  301. /package/dist/{chunk-MNU5G4TK.js.map → chunk-Z7XEIAV4.js.map} +0 -0
  302. /package/dist/{chunk-HXHKLVAS.js.map → chunk-ZCEI242W.js.map} +0 -0
@@ -15,7 +15,7 @@ import {
15
15
  } from "./chunk-O75CRYGF.js";
16
16
  import {
17
17
  coerceInstallExtension
18
- } from "./chunk-ZPQVJEVQ.js";
18
+ } from "./chunk-SK2CR6MW.js";
19
19
  import {
20
20
  expandTildePath
21
21
  } from "./chunk-EYIEWJNI.js";
@@ -2254,4 +2254,4 @@ export {
2254
2254
  resolveWeCloneProxyConfigPath,
2255
2255
  buildWeCloneProxyConfig
2256
2256
  };
2257
- //# sourceMappingURL=chunk-ED35D32I.js.map
2257
+ //# sourceMappingURL=chunk-LQ4J7ELC.js.map
@@ -0,0 +1,63 @@
1
+ // src/recall-pipeline-stages.ts
2
+ var UNDEFINED_TURN_INDEX_DESC_SENTINEL = -1;
3
+ var UNDEFINED_TURN_INDEX_ASC_SENTINEL = Number.MAX_SAFE_INTEGER;
4
+ function unifiedDedupeAndRank(items, config) {
5
+ const transformContent = config.transformContent ?? ((content) => content);
6
+ const direction = config.turnIndexSortDirection ?? "desc";
7
+ const dedupByContent = config.dedupByContent !== false;
8
+ const seenIds = /* @__PURE__ */ new Set();
9
+ const seenContent = /* @__PURE__ */ new Set();
10
+ const survivors = [];
11
+ for (const item of items) {
12
+ const id = resolveItemId(item);
13
+ if (id && seenIds.has(id)) continue;
14
+ const transformedContent = transformContent(item.content, config.intents);
15
+ if (dedupByContent) {
16
+ const contentKey = transformedContent.toLowerCase().replace(/\s+/g, " ").trim();
17
+ if (seenContent.has(contentKey)) continue;
18
+ seenContent.add(contentKey);
19
+ }
20
+ if (id) seenIds.add(id);
21
+ survivors.push({ original: item, transformedContent });
22
+ }
23
+ const scored = survivors.map(({ original, transformedContent }) => ({
24
+ ...original,
25
+ content: transformedContent,
26
+ rank: config.scoreEvidence(original, config.query, config.intents)
27
+ }));
28
+ const filtered = typeof config.rankThreshold === "number" ? scored.filter((item) => item.rank >= config.rankThreshold) : scored;
29
+ if (config.preserveInsertionOrder) {
30
+ return filtered;
31
+ }
32
+ return filtered.sort(makeComparator(direction));
33
+ }
34
+ function makeComparator(direction) {
35
+ if (direction === "asc") {
36
+ return (left, right) => {
37
+ if (right.rank !== left.rank) return right.rank - left.rank;
38
+ const leftTurn = typeof left.turnIndex === "number" ? left.turnIndex : UNDEFINED_TURN_INDEX_ASC_SENTINEL;
39
+ const rightTurn = typeof right.turnIndex === "number" ? right.turnIndex : UNDEFINED_TURN_INDEX_ASC_SENTINEL;
40
+ if (leftTurn !== rightTurn) return leftTurn - rightTurn;
41
+ return left.content.localeCompare(right.content);
42
+ };
43
+ }
44
+ return (left, right) => {
45
+ if (right.rank !== left.rank) return right.rank - left.rank;
46
+ const leftTurn = typeof left.turnIndex === "number" ? left.turnIndex : UNDEFINED_TURN_INDEX_DESC_SENTINEL;
47
+ const rightTurn = typeof right.turnIndex === "number" ? right.turnIndex : UNDEFINED_TURN_INDEX_DESC_SENTINEL;
48
+ if (rightTurn !== leftTurn) return rightTurn - leftTurn;
49
+ return (right.score ?? 0) - (left.score ?? 0);
50
+ };
51
+ }
52
+ function resolveItemId(item) {
53
+ if (item.id) return item.id;
54
+ if (item.sessionId && typeof item.turnIndex === "number") {
55
+ return `${item.sessionId}:${item.turnIndex}`;
56
+ }
57
+ return void 0;
58
+ }
59
+
60
+ export {
61
+ unifiedDedupeAndRank
62
+ };
63
+ //# sourceMappingURL=chunk-LUPVCGYK.js.map
@@ -0,0 +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 * When `true`, skip the sort stage entirely and return items in their\n * post-dedup insertion order (first-seen first). Used by explicit-cue,\n * whose deliberate value ordering — turn references → content cues →\n * lexical cues, gathered by evidence TYPE then read-key priority — is the\n * pipeline's highest-value design choice. A rank-based sort would invert\n * it (turn references are deliberately UNSCORED while lexical hits carry\n * numeric scores; sorting by score would demote turn references below\n * weak lexical hits — cursor[bot] / codex P2 on #1505).\n *\n * Score and threshold-filter still apply when declared; only the sort is\n * skipped. The constant scorer (`scoreEvidence: () => 0`) makes the\n * no-scoring policy explicit alongside this flag.\n */\n preserveInsertionOrder?: boolean;\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 //\n // explicit-cue opts out of sorting entirely (preserveInsertionOrder) — its\n // deliberate value ordering is the collection order (turn references →\n // content cues → lexical cues), and a rank-based sort would invert it.\n if (config.preserveInsertionOrder) {\n return filtered;\n }\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":";AAsJA,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;AAWN,MAAI,OAAO,wBAAwB;AACjC,WAAO;AAAA,EACT;AACA,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":[]}
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  StorageManager
3
- } from "./chunk-SFMRLXIV.js";
3
+ } from "./chunk-GFIARMA7.js";
4
4
  import {
5
5
  assertPathInsideRoot
6
6
  } from "./chunk-5GPPACXK.js";
@@ -751,4 +751,4 @@ export {
751
751
  listMemoryGovernanceRuns,
752
752
  readMemoryGovernanceRunArtifact
753
753
  };
754
- //# sourceMappingURL=chunk-TFVVONWD.js.map
754
+ //# sourceMappingURL=chunk-MBUM2Y3L.js.map
@@ -4,14 +4,14 @@ import {
4
4
  } from "./chunk-ZRWB5D4H.js";
5
5
  import {
6
6
  TranscriptManager
7
- } from "./chunk-PONNZ54D.js";
7
+ } from "./chunk-GY3SKOS4.js";
8
8
  import {
9
9
  resolveCommitmentLedgerDir,
10
10
  validateCommitmentLedgerEntry
11
11
  } from "./chunk-LMDRGRJ2.js";
12
12
  import {
13
13
  parseConfig
14
- } from "./chunk-K4DWSPMW.js";
14
+ } from "./chunk-WRGPE6AW.js";
15
15
  import {
16
16
  resolveObjectiveStateStoreDir,
17
17
  validateObjectiveStateSnapshot
@@ -268,4 +268,4 @@ export {
268
268
  recordResumeBundle,
269
269
  getResumeBundleStatus
270
270
  };
271
- //# sourceMappingURL=chunk-T5QAZIBO.js.map
271
+ //# sourceMappingURL=chunk-MOXFPLD6.js.map
@@ -3,7 +3,7 @@ import {
3
3
  } from "./chunk-7FL4CNPV.js";
4
4
  import {
5
5
  StorageManager
6
- } from "./chunk-SFMRLXIV.js";
6
+ } from "./chunk-GFIARMA7.js";
7
7
  import {
8
8
  getCachedEpisodeMap,
9
9
  setCachedEpisodeMap
@@ -107,4 +107,4 @@ export {
107
107
  compareVerifiedEpisodeResults,
108
108
  searchVerifiedEpisodes
109
109
  };
110
- //# sourceMappingURL=chunk-XTIRCSIH.js.map
110
+ //# sourceMappingURL=chunk-MXEWQKM7.js.map
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  listNamespaces
3
- } from "./chunk-DEDQXIDL.js";
3
+ } from "./chunk-JTKFZMZ7.js";
4
4
  import {
5
5
  runConsolidationProvenanceCheck
6
6
  } from "./chunk-7XH7VJN4.js";
@@ -9,7 +9,7 @@ import {
9
9
  } from "./chunk-YBPYIAA5.js";
10
10
  import {
11
11
  summarizeNamespaceMaintenanceHealth
12
- } from "./chunk-WFEZUGU5.js";
12
+ } from "./chunk-EZR35XHX.js";
13
13
  import {
14
14
  analyzeSessionIntegrity,
15
15
  applySessionRepair,
@@ -35,17 +35,17 @@ import {
35
35
  } from "./chunk-3PY7VHV7.js";
36
36
  import {
37
37
  parseConfig
38
- } from "./chunk-K4DWSPMW.js";
38
+ } from "./chunk-WRGPE6AW.js";
39
39
  import {
40
40
  listMemoryGovernanceRuns,
41
41
  readMemoryGovernanceRunArtifact
42
- } from "./chunk-TFVVONWD.js";
42
+ } from "./chunk-MBUM2Y3L.js";
43
43
  import {
44
44
  analyzeGraphHealth
45
45
  } from "./chunk-KF74X62T.js";
46
46
  import {
47
47
  StorageManager
48
- } from "./chunk-SFMRLXIV.js";
48
+ } from "./chunk-GFIARMA7.js";
49
49
  import {
50
50
  lintWorkspaceFiles
51
51
  } from "./chunk-DM2T26WE.js";
@@ -1395,4 +1395,4 @@ export {
1395
1395
  runBenchmarkRecall,
1396
1396
  runOperatorRepair
1397
1397
  };
1398
- //# sourceMappingURL=chunk-ZYNMX6IU.js.map
1398
+ //# sourceMappingURL=chunk-NUIJEGVD.js.map