@remnic/core 9.54.3 → 9.54.5

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 (526) hide show
  1. package/dist/access-admin-ops-surface.d.ts +12 -11
  2. package/dist/access-admin-ops-surface.js +46 -44
  3. package/dist/access-authorization-probe.d.ts +12 -11
  4. package/dist/access-authorization-probe.js +47 -45
  5. package/dist/access-boundary.d.ts +12 -11
  6. package/dist/access-boundary.js +46 -44
  7. package/dist/access-cli.js +92 -90
  8. package/dist/access-cli.js.map +1 -1
  9. package/dist/access-coding-context-resolution.d.ts +1 -1
  10. package/dist/access-extraction-force-flush.d.ts +12 -11
  11. package/dist/access-extraction-force-flush.js +46 -44
  12. package/dist/access-health-types.d.ts +1 -1
  13. package/dist/access-http-lcm-compaction.d.ts +12 -11
  14. package/dist/access-http-lifecycle-flush.d.ts +12 -11
  15. package/dist/access-http-offline-stream.d.ts +12 -11
  16. package/dist/access-http-query.js +46 -44
  17. package/dist/access-http.d.ts +12 -11
  18. package/dist/access-http.js +56 -54
  19. package/dist/access-identity-continuity-surface.d.ts +9 -9
  20. package/dist/access-identity-continuity-surface.js +46 -44
  21. package/dist/access-lcm-surface.d.ts +12 -11
  22. package/dist/access-lcm-surface.js +46 -44
  23. package/dist/access-mcp.d.ts +12 -11
  24. package/dist/access-mcp.js +52 -50
  25. package/dist/access-memory-search-fanout.d.ts +22 -2
  26. package/dist/access-memory-search-fanout.js +1 -1
  27. package/dist/{access-namespace-preflight-C7n4tgWC.d.ts → access-namespace-preflight-BdHlGd_T.d.ts} +1 -1
  28. package/dist/access-namespace-preflight.d.ts +3 -3
  29. package/dist/access-namespace-preflight.js +46 -44
  30. package/dist/access-observe-write-surface.d.ts +12 -11
  31. package/dist/access-observe-write-surface.js +46 -44
  32. package/dist/access-offline-manifest.d.ts +10 -9
  33. package/dist/access-offline-manifest.js +12 -10
  34. package/dist/access-operations-batch.js +48 -46
  35. package/dist/access-operations.d.ts +15 -14
  36. package/dist/access-operations.js +51 -49
  37. package/dist/access-recall-concurrency.d.ts +12 -11
  38. package/dist/access-recall-concurrency.js +46 -44
  39. package/dist/access-recall-response.d.ts +12 -11
  40. package/dist/access-recall-response.js +46 -44
  41. package/dist/access-recall-surface.d.ts +12 -11
  42. package/dist/access-recall-surface.js +46 -44
  43. package/dist/access-schema.d.ts +90 -90
  44. package/dist/access-schema.js +3 -2
  45. package/dist/{access-service-CXvbxLK-.d.ts → access-service-DL7X9hrg.d.ts} +7 -7
  46. package/dist/access-service-helpers.d.ts +12 -11
  47. package/dist/access-service.d.ts +12 -11
  48. package/dist/access-service.js +46 -44
  49. package/dist/access-surface-catalog.d.ts +12 -11
  50. package/dist/access-wearables-meetings-surface.d.ts +3 -3
  51. package/dist/action-confidence.d.ts +1 -1
  52. package/dist/active-memory-bridge.d.ts +13 -1
  53. package/dist/active-memory-bridge.js +6 -1
  54. package/dist/active-recall.d.ts +1 -1
  55. package/dist/active-recall.js +3 -2
  56. package/dist/active-recall.js.map +1 -1
  57. package/dist/adapters/index.js +4 -4
  58. package/dist/adapters/registry.js +2 -2
  59. package/dist/ambient-provenance.d.ts +1 -1
  60. package/dist/artifact-search.d.ts +1 -1
  61. package/dist/behavior-learner.d.ts +1 -1
  62. package/dist/behavior-signals.d.ts +1 -1
  63. package/dist/bootstrap.d.ts +9 -9
  64. package/dist/briefing.d.ts +2 -2
  65. package/dist/briefing.js +30 -9
  66. package/dist/buffer-surprise-report.d.ts +1 -1
  67. package/dist/buffer-turn-helpers.d.ts +1 -1
  68. package/dist/buffer.d.ts +2 -2
  69. package/dist/buffer.js +3 -3
  70. package/dist/bulk-import/index.d.ts +3 -3
  71. package/dist/calibration.d.ts +1 -1
  72. package/dist/capabilities.d.ts +1 -1
  73. package/dist/{catalog-BOOxl-I2.d.ts → catalog-B90is4d8.d.ts} +1 -1
  74. package/dist/causal-behavior.d.ts +1 -1
  75. package/dist/causal-consolidation.d.ts +1 -1
  76. package/dist/causal-consolidation.js +31 -10
  77. package/dist/causal-consolidation.js.map +1 -1
  78. package/dist/causal-trajectory-graph.d.ts +1 -1
  79. package/dist/{chunk-6LAPLZOS.js → chunk-2DD6ZHOM.js} +8 -3
  80. package/dist/chunk-2DD6ZHOM.js.map +1 -0
  81. package/dist/{chunk-47P3RYZP.js → chunk-2INWPC6E.js} +2 -2
  82. package/dist/{chunk-3CSX3ETE.js → chunk-2LWQSV6A.js} +23 -11
  83. package/dist/chunk-2LWQSV6A.js.map +1 -0
  84. package/dist/{chunk-7BZOBA5J.js → chunk-2PNXOQ4P.js} +69 -11
  85. package/dist/chunk-2PNXOQ4P.js.map +1 -0
  86. package/dist/{chunk-WOPA3SGI.js → chunk-3OTSVCPK.js} +8 -8
  87. package/dist/{chunk-PX2LSHYM.js → chunk-3SXLD5T3.js} +3 -3
  88. package/dist/{chunk-T2JHZWH6.js → chunk-3WGI7F4V.js} +237 -93
  89. package/dist/chunk-3WGI7F4V.js.map +1 -0
  90. package/dist/{chunk-C4ZNGVK3.js → chunk-5JKUSBMX.js} +2 -2
  91. package/dist/{chunk-S75M5ZRK.js → chunk-6LEIWWAF.js} +16 -1
  92. package/dist/chunk-6LEIWWAF.js.map +1 -0
  93. package/dist/{chunk-MAXVH44E.js → chunk-6NNNURLK.js} +4 -4
  94. package/dist/{chunk-LJS7KUPV.js → chunk-6PZGKGAO.js} +2 -2
  95. package/dist/{chunk-YN6ASZUG.js → chunk-6QPI2ITJ.js} +5 -5
  96. package/dist/{chunk-CYF6WVE7.js → chunk-7HG7MGAP.js} +2688 -496
  97. package/dist/chunk-7HG7MGAP.js.map +1 -0
  98. package/dist/{chunk-CGVHPCP2.js → chunk-7Q7JWLQ4.js} +2 -2
  99. package/dist/{chunk-227UFSEQ.js → chunk-7RZJWZ46.js} +5 -5
  100. package/dist/{chunk-JBPKEARU.js → chunk-AU7Q3LSC.js} +4 -4
  101. package/dist/{chunk-PDDTI7IC.js → chunk-B4T3FQMT.js} +1 -1
  102. package/dist/{chunk-UU3G6GUP.js → chunk-BIF4SHMD.js} +1 -1
  103. package/dist/{chunk-UU3G6GUP.js.map → chunk-BIF4SHMD.js.map} +1 -1
  104. package/dist/{chunk-APPFNGX6.js → chunk-BSXGTDVJ.js} +2 -2
  105. package/dist/{chunk-4IIFL7GC.js → chunk-CLKBV3Z3.js} +10 -10
  106. package/dist/{chunk-ZYLC7NFO.js → chunk-CSY44OKU.js} +4 -4
  107. package/dist/{chunk-HLYR2TQL.js → chunk-CUTFSLSD.js} +2 -2
  108. package/dist/{chunk-RDJRFDJY.js → chunk-DBY26JJJ.js} +2 -2
  109. package/dist/{chunk-QWGE2PUH.js → chunk-DDA55IVB.js} +10 -10
  110. package/dist/{chunk-VMMQDEN5.js → chunk-DN2IDKI5.js} +2 -2
  111. package/dist/{chunk-2GFK22OZ.js → chunk-DOOWFDWN.js} +2 -2
  112. package/dist/{chunk-7FGL6CGA.js → chunk-DVYRD4HY.js} +2 -2
  113. package/dist/{chunk-YGLY6QFV.js → chunk-F2Y6I74C.js} +2 -2
  114. package/dist/{chunk-UU7TRFNE.js → chunk-FFEBSFVT.js} +2 -2
  115. package/dist/chunk-HNDIND7P.js +331 -0
  116. package/dist/chunk-HNDIND7P.js.map +1 -0
  117. package/dist/{chunk-NIS256NW.js → chunk-JKW663ZN.js} +2 -2
  118. package/dist/{chunk-G7A5HLUS.js → chunk-KJH6W2I7.js} +2 -2
  119. package/dist/{chunk-IXEBUYO4.js → chunk-KM55SMLG.js} +11 -2
  120. package/dist/{chunk-IXEBUYO4.js.map → chunk-KM55SMLG.js.map} +1 -1
  121. package/dist/{chunk-G2LUMAUF.js → chunk-L7RTUEDG.js} +12 -5
  122. package/dist/chunk-L7RTUEDG.js.map +1 -0
  123. package/dist/chunk-LC2BDILZ.js +57 -0
  124. package/dist/chunk-LC2BDILZ.js.map +1 -0
  125. package/dist/{chunk-JV5YUBIZ.js → chunk-LC3FD4BV.js} +52 -46
  126. package/dist/chunk-LC3FD4BV.js.map +1 -0
  127. package/dist/{chunk-HWRD23DW.js → chunk-LVKYLMSM.js} +3 -3
  128. package/dist/{chunk-RUMNY5DT.js → chunk-MRGJZ75M.js} +6 -2
  129. package/dist/chunk-MRGJZ75M.js.map +1 -0
  130. package/dist/{chunk-ZMYDYNI4.js → chunk-N7CXQ5TA.js} +4 -4
  131. package/dist/{chunk-3JLPGJ43.js → chunk-NGT35IGQ.js} +5 -5
  132. package/dist/{chunk-GUKBW4HL.js → chunk-NQMSEB5D.js} +6 -6
  133. package/dist/{chunk-WRJVB3C2.js → chunk-PO7NXBG2.js} +2 -2
  134. package/dist/{chunk-WM65LU67.js → chunk-QOQQMVR2.js} +2 -2
  135. package/dist/{chunk-QHFV6VNU.js → chunk-QPAQSG3F.js} +2 -2
  136. package/dist/{chunk-UTRO5UJU.js → chunk-QPW3PAIH.js} +5 -1
  137. package/dist/chunk-QPW3PAIH.js.map +1 -0
  138. package/dist/{chunk-6R4G7N4S.js → chunk-QQXWFDRD.js} +128 -74
  139. package/dist/chunk-QQXWFDRD.js.map +1 -0
  140. package/dist/{chunk-UES4BHA2.js → chunk-QTO6BMQZ.js} +2 -2
  141. package/dist/{chunk-THPPCISA.js → chunk-RBII7637.js} +5 -5
  142. package/dist/{chunk-QT2FRYI4.js → chunk-RG426DJO.js} +2 -2
  143. package/dist/{chunk-XUAMCLY4.js → chunk-TKFGFDPJ.js} +17 -13
  144. package/dist/chunk-TKFGFDPJ.js.map +1 -0
  145. package/dist/{chunk-VKXWK44Q.js → chunk-TY6MKIWP.js} +3 -3
  146. package/dist/{chunk-AZM4CCAC.js → chunk-UWJNKGBA.js} +5 -5
  147. package/dist/{chunk-JDZPNCMA.js → chunk-UYOXFFEY.js} +6 -3
  148. package/dist/chunk-UYOXFFEY.js.map +1 -0
  149. package/dist/{chunk-ZPJ4QSGP.js → chunk-VTU5IEKY.js} +2 -2
  150. package/dist/{chunk-RZ4XGKOJ.js → chunk-VYQ4URQB.js} +8 -8
  151. package/dist/{chunk-WDBX6VER.js → chunk-VZRFGJCH.js} +5 -5
  152. package/dist/{chunk-IBKR2TFR.js → chunk-WM5LD6AT.js} +2 -2
  153. package/dist/{chunk-K4QS7LXU.js → chunk-WZWZRZ2V.js} +2 -2
  154. package/dist/{chunk-G4T7L557.js → chunk-XKAR4RF6.js} +2 -2
  155. package/dist/{chunk-DZD576ZU.js → chunk-XSV2YDCJ.js} +2 -2
  156. package/dist/{chunk-G7Z6EENO.js → chunk-YDWPYDML.js} +4 -4
  157. package/dist/{chunk-6HPHEFXT.js → chunk-YKZLOPTC.js} +2 -2
  158. package/dist/{chunk-NH5IR2WM.js → chunk-YR65W7BV.js} +6 -2
  159. package/dist/chunk-YR65W7BV.js.map +1 -0
  160. package/dist/{chunk-GYPQL6XN.js → chunk-Z4N7SVVF.js} +35 -47
  161. package/dist/chunk-Z4N7SVVF.js.map +1 -0
  162. package/dist/{cli-DVUFIa5E.d.ts → cli-jfuZXixq.d.ts} +5 -5
  163. package/dist/cli.d.ts +14 -13
  164. package/dist/cli.js +74 -72
  165. package/dist/coding/pre-action-gate.d.ts +1 -1
  166. package/dist/compounding/engine.d.ts +2 -2
  167. package/dist/compounding/engine.js +30 -9
  168. package/dist/compounding/preference-consolidator.d.ts +1 -1
  169. package/dist/compression-optimizer.d.ts +1 -1
  170. package/dist/config.d.ts +1 -1
  171. package/dist/config.js +3 -2
  172. package/dist/connectors/codex-materialize-runner.d.ts +1 -1
  173. package/dist/connectors/codex-materialize-runner.js +30 -9
  174. package/dist/connectors/codex-materialize.d.ts +1 -1
  175. package/dist/connectors/index.d.ts +1 -1
  176. package/dist/connectors/index.js +29 -9
  177. package/dist/consolidation-provenance-check.d.ts +2 -2
  178. package/dist/consolidation-undo.d.ts +2 -2
  179. package/dist/contradiction/index.d.ts +2 -2
  180. package/dist/contradiction/index.js +3 -1
  181. package/dist/contradiction-scan-KCADHXPE.js +20 -0
  182. package/dist/converge-config.d.ts +1 -1
  183. package/dist/convergence-refresh.d.ts +2 -2
  184. package/dist/convergence-refresh.js +32 -11
  185. package/dist/conversation-index/backend.d.ts +1 -1
  186. package/dist/conversation-index/backend.js +2 -2
  187. package/dist/conversation-index/chunker.d.ts +1 -1
  188. package/dist/conversation-index/faiss-adapter.d.ts +1 -1
  189. package/dist/conversation-index/indexer.d.ts +1 -1
  190. package/dist/conversation-index/search.d.ts +1 -1
  191. package/dist/corpus-watermark.d.ts +1 -1
  192. package/dist/corpus-watermark.js +21 -20
  193. package/dist/day-summary.d.ts +1 -1
  194. package/dist/delinearize.d.ts +1 -1
  195. package/dist/dependency-propagation-config.d.ts +1 -1
  196. package/dist/{dependency-propagation-delivery-XzF76C9n.d.ts → dependency-propagation-delivery-CTDuAVJc.d.ts} +1 -1
  197. package/dist/direct-answer-wiring.d.ts +1 -1
  198. package/dist/direct-answer.d.ts +1 -1
  199. package/dist/embedding-fallback.d.ts +1 -1
  200. package/dist/enrichment/index.d.ts +1 -1
  201. package/dist/entity-retrieval.d.ts +2 -2
  202. package/dist/entity-retrieval.js +30 -9
  203. package/dist/entity-schema.d.ts +1 -1
  204. package/dist/explicit-capture.d.ts +9 -9
  205. package/dist/explicit-capture.js +6 -4
  206. package/dist/external-wiki-access.d.ts +12 -11
  207. package/dist/external-wiki-access.js +47 -45
  208. package/dist/external-wiki-collection-registration.d.ts +1 -1
  209. package/dist/external-wiki-collection.d.ts +1 -1
  210. package/dist/external-wiki-mcp-tools.d.ts +12 -11
  211. package/dist/extraction-error-classification.d.ts +1 -1
  212. package/dist/extraction-faithfulness.d.ts +1 -1
  213. package/dist/extraction-judge-telemetry.d.ts +1 -1
  214. package/dist/extraction-judge-training.d.ts +1 -1
  215. package/dist/extraction-judge.d.ts +1 -1
  216. package/dist/extraction-liveness.d.ts +1 -1
  217. package/dist/extraction-normalization.d.ts +1 -1
  218. package/dist/extraction-prompt.d.ts +1 -1
  219. package/dist/extraction-source-grounding-rules.d.ts +1 -1
  220. package/dist/extraction-source-grounding.d.ts +1 -1
  221. package/dist/extraction.d.ts +1 -1
  222. package/dist/extraction.js +29 -13
  223. package/dist/fallback-llm.d.ts +1 -1
  224. package/dist/{first-start-migration-626C5554.js → first-start-migration-LMMZFLKK.js} +13 -5
  225. package/dist/first-start-migration-LMMZFLKK.js.map +1 -0
  226. package/dist/graph-dashboard-diff.d.ts +1 -1
  227. package/dist/graph-dashboard-key.d.ts +1 -1
  228. package/dist/graph-dashboard-parser.d.ts +1 -1
  229. package/dist/graph-edge-reinforcement.d.ts +1 -1
  230. package/dist/graph-path-reconstruction.d.ts +1 -1
  231. package/dist/graph-path-scoring.d.ts +1 -1
  232. package/dist/graph-snapshot.d.ts +1 -1
  233. package/dist/graph.d.ts +1 -1
  234. package/dist/harmonic-retrieval.js +1 -1
  235. package/dist/importance.d.ts +1 -1
  236. package/dist/importers/index.d.ts +1 -1
  237. package/dist/in-flight-reads.d.ts +1 -1
  238. package/dist/index.d.ts +1439 -716
  239. package/dist/index.js +207 -121
  240. package/dist/intent.d.ts +1 -1
  241. package/dist/lcm/engine.d.ts +1 -1
  242. package/dist/lcm/engine.js +2 -2
  243. package/dist/lcm/index.d.ts +1 -1
  244. package/dist/lcm/index.js +5 -5
  245. package/dist/lcm/tools.d.ts +1 -1
  246. package/dist/lifecycle.d.ts +1 -1
  247. package/dist/live-connectors-runner.d.ts +1 -1
  248. package/dist/local-llm.d.ts +1 -1
  249. package/dist/local-model-endpoint.d.ts +1 -1
  250. package/dist/maintenance/memory-governance.d.ts +1 -1
  251. package/dist/maintenance/memory-governance.js +30 -9
  252. package/dist/maintenance/rebuild-memory-lifecycle-ledger.d.ts +2 -2
  253. package/dist/maintenance/rebuild-memory-lifecycle-ledger.js +30 -9
  254. package/dist/maintenance/rebuild-memory-projection.d.ts +2 -2
  255. package/dist/maintenance/rebuild-memory-projection.js +31 -10
  256. package/dist/{maintenance-BJzNIKBE.d.ts → maintenance-heMZSq7G.d.ts} +3 -3
  257. package/dist/mcp-memory-inspector-app.d.ts +12 -11
  258. package/dist/memory-action-policy.d.ts +1 -1
  259. package/dist/memory-cache.d.ts +1 -1
  260. package/dist/memory-lifecycle-ledger-utils.d.ts +1 -1
  261. package/dist/memory-projection-mutations.js +2 -2
  262. package/dist/memory-projection-store.d.ts +6 -2
  263. package/dist/memory-projection-store.js +1 -1
  264. package/dist/memory-provenance.d.ts +1 -1
  265. package/dist/memory-snapshot.d.ts +1 -1
  266. package/dist/memory-worth-outcomes.d.ts +2 -2
  267. package/dist/models-json.d.ts +1 -1
  268. package/dist/namespaces/migrate.d.ts +3 -3
  269. package/dist/namespaces/migrate.js +20 -19
  270. package/dist/namespaces/principal.d.ts +1 -1
  271. package/dist/namespaces/search.d.ts +1 -1
  272. package/dist/namespaces/search.js +6 -6
  273. package/dist/namespaces/storage.d.ts +3 -3
  274. package/dist/namespaces/storage.js +30 -9
  275. package/dist/native-knowledge.d.ts +1 -1
  276. package/dist/offline-sync-file-io.d.ts +20 -0
  277. package/dist/offline-sync-file-io.js +18 -0
  278. package/dist/offline-sync-file-io.js.map +1 -0
  279. package/dist/offline-sync-impression-drain.d.ts +1 -1
  280. package/dist/offline-sync-impression-drain.js +5 -5
  281. package/dist/offline-sync.d.ts +8 -6
  282. package/dist/offline-sync.js +2 -1
  283. package/dist/operator-doctor-corpus.d.ts +1 -1
  284. package/dist/operator-doctor-corpus.js +22 -21
  285. package/dist/operator-doctor-replica.d.ts +1 -1
  286. package/dist/operator-toolkit.d.ts +3 -3
  287. package/dist/operator-toolkit.js +34 -32
  288. package/dist/orchestration/compression-guideline-coordinator.d.ts +2 -2
  289. package/dist/orchestration/maintenance.d.ts +4 -4
  290. package/dist/orchestration/maintenance.js +35 -15
  291. package/dist/{orchestrator-BiXgBJBQ.d.ts → orchestrator-BQQPsSjs.d.ts} +11 -8
  292. package/dist/orchestrator.d.ts +9 -9
  293. package/dist/orchestrator.js +93 -91
  294. package/dist/patterns-cli.d.ts +1 -1
  295. package/dist/{pipeline-sz_dcuLg.d.ts → pipeline-DFfmsnGk.d.ts} +1 -1
  296. package/dist/policy-runtime.d.ts +1 -1
  297. package/dist/proactive-contention.d.ts +1 -1
  298. package/dist/provenance.d.ts +1 -1
  299. package/dist/{purge-533FZLS4.js → purge-GB7PZHT2.js} +2 -2
  300. package/dist/{qmd-eAWObK4M.d.ts → qmd-BF5bcVRs.d.ts} +1 -1
  301. package/dist/qmd-preflight.d.ts +2 -2
  302. package/dist/qmd-recall-cache.d.ts +1 -1
  303. package/dist/qmd.d.ts +2 -2
  304. package/dist/recall-concurrency-config.d.ts +1 -1
  305. package/dist/recall-disclosure-escalation.d.ts +1 -1
  306. package/dist/recall-explain-renderer.d.ts +1 -1
  307. package/dist/recall-explain-renderer.js +3 -3
  308. package/dist/recall-memory-map.d.ts +1 -1
  309. package/dist/recall-planner-llm.d.ts +1 -1
  310. package/dist/recall-state.d.ts +1 -1
  311. package/dist/recall-tag-filter.d.ts +1 -1
  312. package/dist/recall-timings.d.ts +1 -1
  313. package/dist/recall-xray-cli.d.ts +1 -1
  314. package/dist/recall-xray-cli.js +4 -4
  315. package/dist/recall-xray-renderer.d.ts +1 -1
  316. package/dist/recall-xray-renderer.js +3 -3
  317. package/dist/recall-xray.d.ts +1 -1
  318. package/dist/recall-xray.js +2 -2
  319. package/dist/reconcile/cursor.d.ts +2 -1
  320. package/dist/reconcile/manifest.d.ts +2 -1
  321. package/dist/reconcile/manifest.js +6 -5
  322. package/dist/reconcile/plan.d.ts +2 -1
  323. package/dist/reconcile/plan.js +3 -2
  324. package/dist/replay/normalizers/chatgpt.d.ts +1 -1
  325. package/dist/replay/normalizers/claude.d.ts +1 -1
  326. package/dist/replay/normalizers/openclaw.d.ts +1 -1
  327. package/dist/replay/normalizers/shared.d.ts +1 -1
  328. package/dist/replay/runner.d.ts +1 -1
  329. package/dist/replay/types.d.ts +1 -1
  330. package/dist/replica-divergence.d.ts +1 -1
  331. package/dist/replica-peers-config.d.ts +1 -1
  332. package/dist/resolve-auth-token.d.ts +1 -1
  333. package/dist/resume-bundles.js +4 -3
  334. package/dist/retrieval-agents.d.ts +2 -2
  335. package/dist/retrieval-tiers.d.ts +1 -1
  336. package/dist/routing/engine.d.ts +1 -1
  337. package/dist/routing/store.d.ts +1 -1
  338. package/dist/salvage-envelope.d.ts +1 -1
  339. package/dist/schemas.d.ts +138 -138
  340. package/dist/{scope-profiles-BBQsXuyj.d.ts → scope-profiles-CbUOsE_E.d.ts} +1 -1
  341. package/dist/search/embed-helper.d.ts +1 -1
  342. package/dist/search/factory.d.ts +1 -1
  343. package/dist/search/factory.js +4 -4
  344. package/dist/search/index.d.ts +1 -1
  345. package/dist/search/index.js +6 -6
  346. package/dist/search/lancedb-backend.d.ts +1 -1
  347. package/dist/search/meilisearch-backend.d.ts +1 -1
  348. package/dist/search/noop-backend.d.ts +1 -1
  349. package/dist/search/orama-backend.d.ts +1 -1
  350. package/dist/search/port.d.ts +1 -1
  351. package/dist/search/remote-backend.d.ts +1 -1
  352. package/dist/{semantic-consolidation-HD8RkzVA.d.ts → semantic-consolidation-DAB3xdKM.d.ts} +1 -1
  353. package/dist/semantic-consolidation.d.ts +2 -2
  354. package/dist/semantic-consolidation.js +31 -10
  355. package/dist/semantic-rule-promotion.js +30 -9
  356. package/dist/semantic-rule-verifier.d.ts +1 -1
  357. package/dist/semantic-rule-verifier.js +30 -9
  358. package/dist/{service-DIrtHHEg.d.ts → service-DGKg2O6r.d.ts} +2 -2
  359. package/dist/session-observer-bands.d.ts +1 -1
  360. package/dist/session-observer-state.d.ts +1 -1
  361. package/dist/shared-context/manager.d.ts +9 -9
  362. package/dist/signal.d.ts +1 -1
  363. package/dist/source-agent-qualifier.d.ts +1 -1
  364. package/dist/source-agent-qualifier.js +28 -12
  365. package/dist/{storage-DqCzXi56.d.ts → storage-CC1jKcWg.d.ts} +46 -13
  366. package/dist/storage.d.ts +2 -2
  367. package/dist/storage.js +30 -9
  368. package/dist/summarizer.d.ts +1 -1
  369. package/dist/summary-snapshot.d.ts +1 -1
  370. package/dist/temporal-supersession.d.ts +2 -2
  371. package/dist/temporal-timeline-recall.d.ts +1 -1
  372. package/dist/temporal-validity.d.ts +1 -1
  373. package/dist/threading.d.ts +1 -1
  374. package/dist/tier-migration.d.ts +2 -2
  375. package/dist/tier-routing.d.ts +2 -2
  376. package/dist/tier-routing.js +7 -1
  377. package/dist/{tier-stats-2JCZYEF7.js → tier-stats-JDN6HRNT.js} +8 -2
  378. package/dist/{tier-stats-2JCZYEF7.js.map → tier-stats-JDN6HRNT.js.map} +1 -1
  379. package/dist/topics.d.ts +1 -1
  380. package/dist/transcript.d.ts +1 -1
  381. package/dist/transfer/types.d.ts +66 -66
  382. package/dist/trust-score-stage.d.ts +1 -1
  383. package/dist/trust-score.d.ts +1 -1
  384. package/dist/{types-d_j4vC6N.d.ts → types-BnQza1y8.d.ts} +2 -1
  385. package/dist/types.d.ts +1 -1
  386. package/dist/types.js +1 -1
  387. package/dist/utility-runtime.d.ts +2 -2
  388. package/dist/verified-recall.js +30 -9
  389. package/dist/write-envelope.d.ts +1 -1
  390. package/package.json +2 -2
  391. package/src/access-http.test.ts +31 -0
  392. package/src/access-memory-search-fanout.ts +24 -1
  393. package/src/access-offline-manifest.ts +5 -0
  394. package/src/access-service-namespace.test.ts +14 -0
  395. package/src/access-service-observe-scope.test.ts +2 -0
  396. package/src/access-service-offline-file-content.test.ts +211 -0
  397. package/src/access-service.ts +20 -43
  398. package/src/active-memory-bridge.test.ts +151 -0
  399. package/src/active-memory-bridge.ts +87 -11
  400. package/src/briefing.test.ts +38 -0
  401. package/src/briefing.ts +3 -3
  402. package/src/cli.ts +6 -1
  403. package/src/connectors/codex-materialize-runner.ts +2 -0
  404. package/src/contradiction/contradiction-scan.ts +2 -0
  405. package/src/contradiction/contradiction.test.ts +42 -0
  406. package/src/correction/correction-access-wiring.ts +8 -2
  407. package/src/correction/correction-storage-integration.test.ts +7 -0
  408. package/src/explicit-capture.test.ts +24 -0
  409. package/src/explicit-capture.ts +2 -0
  410. package/src/index.ts +3 -0
  411. package/src/maintenance/first-start-migration.ts +2 -1
  412. package/src/maintenance/memory-governance.test.ts +25 -0
  413. package/src/maintenance/memory-governance.ts +4 -1
  414. package/src/maintenance/pattern-reinforcement.test.ts +20 -0
  415. package/src/maintenance/pattern-reinforcement.ts +2 -1
  416. package/src/maintenance/rebuild-memory-projection.ts +8 -8
  417. package/src/memory-projection-store.ts +25 -27
  418. package/src/offline-sync-file-io.ts +68 -0
  419. package/src/offline-sync.ts +43 -57
  420. package/src/orchestration/consolidation-run.ts +5 -4
  421. package/src/orchestration/contradiction-linking-coordinator.ts +7 -0
  422. package/src/orchestration/contradiction-localization.integration.test.ts +115 -0
  423. package/src/orchestration/lifecycle-policy-coordinator.ts +2 -1
  424. package/src/orchestration/qmd-result-resolver.test.ts +215 -14
  425. package/src/orchestration/qmd-result-resolver.ts +142 -82
  426. package/src/orchestration/recall-search-pipeline.test.ts +41 -0
  427. package/src/orchestration/recall-search-pipeline.ts +12 -0
  428. package/src/orchestration/semantic-consolidation-coordinator.ts +2 -1
  429. package/src/orchestration/tier-migration-coordinator.ts +23 -56
  430. package/src/orchestration/workspace-ops.test.ts +37 -0
  431. package/src/orchestration/workspace-ops.ts +5 -29
  432. package/src/orchestrator.ts +7 -8
  433. package/src/storage/supersession-audit.ts +7 -1
  434. package/src/storage/supersession-side-effects.ts +17 -5
  435. package/src/storage.ts +18 -19
  436. package/src/support-passport/card-projection.test.ts +129 -0
  437. package/src/support-passport/card-projection.ts +287 -0
  438. package/src/support-passport/card-service.test.ts +2462 -0
  439. package/src/support-passport/card-service.ts +1042 -0
  440. package/src/support-passport/contracts.test.ts +143 -0
  441. package/src/support-passport/contracts.ts +136 -0
  442. package/src/support-passport/errors.ts +24 -0
  443. package/src/support-passport/grant-contracts.ts +139 -0
  444. package/src/support-passport/grant-service-cache.test.ts +148 -0
  445. package/src/support-passport/grant-service-cancellation.test.ts +81 -0
  446. package/src/support-passport/grant-service.test.ts +2882 -0
  447. package/src/support-passport/grant-service.ts +364 -0
  448. package/src/support-passport/grant-store-commit-hook.test.ts +123 -0
  449. package/src/support-passport/grant-store-order.test.ts +60 -0
  450. package/src/support-passport/grant-store-path-safety.test.ts +30 -0
  451. package/src/support-passport/grant-store-recovery.test.ts +448 -0
  452. package/src/support-passport/grant-store.ts +902 -0
  453. package/src/support-passport/index.ts +7 -0
  454. package/src/support-passport/offline-sync-guard.ts +230 -0
  455. package/src/support-passport/owner-lock.ts +53 -0
  456. package/src/support-passport/private-file.ts +371 -0
  457. package/src/tier-routing.ts +28 -17
  458. package/src/training-export/converter.test.ts +24 -0
  459. package/src/training-export/converter.ts +2 -0
  460. package/src/types.ts +1 -1
  461. package/src/wearables/service.test.ts +13 -0
  462. package/src/wearables/service.ts +2 -0
  463. package/dist/chunk-3CSX3ETE.js.map +0 -1
  464. package/dist/chunk-6LAPLZOS.js.map +0 -1
  465. package/dist/chunk-6R4G7N4S.js.map +0 -1
  466. package/dist/chunk-7BZOBA5J.js.map +0 -1
  467. package/dist/chunk-CYF6WVE7.js.map +0 -1
  468. package/dist/chunk-G2LUMAUF.js.map +0 -1
  469. package/dist/chunk-GYPQL6XN.js.map +0 -1
  470. package/dist/chunk-JDZPNCMA.js.map +0 -1
  471. package/dist/chunk-JV5YUBIZ.js.map +0 -1
  472. package/dist/chunk-NH5IR2WM.js.map +0 -1
  473. package/dist/chunk-RUMNY5DT.js.map +0 -1
  474. package/dist/chunk-S75M5ZRK.js.map +0 -1
  475. package/dist/chunk-T2JHZWH6.js.map +0 -1
  476. package/dist/chunk-UTRO5UJU.js.map +0 -1
  477. package/dist/chunk-XUAMCLY4.js.map +0 -1
  478. package/dist/contradiction-scan-HYLIRMJ2.js +0 -14
  479. package/dist/first-start-migration-626C5554.js.map +0 -1
  480. /package/dist/{chunk-47P3RYZP.js.map → chunk-2INWPC6E.js.map} +0 -0
  481. /package/dist/{chunk-WOPA3SGI.js.map → chunk-3OTSVCPK.js.map} +0 -0
  482. /package/dist/{chunk-PX2LSHYM.js.map → chunk-3SXLD5T3.js.map} +0 -0
  483. /package/dist/{chunk-C4ZNGVK3.js.map → chunk-5JKUSBMX.js.map} +0 -0
  484. /package/dist/{chunk-MAXVH44E.js.map → chunk-6NNNURLK.js.map} +0 -0
  485. /package/dist/{chunk-LJS7KUPV.js.map → chunk-6PZGKGAO.js.map} +0 -0
  486. /package/dist/{chunk-YN6ASZUG.js.map → chunk-6QPI2ITJ.js.map} +0 -0
  487. /package/dist/{chunk-CGVHPCP2.js.map → chunk-7Q7JWLQ4.js.map} +0 -0
  488. /package/dist/{chunk-227UFSEQ.js.map → chunk-7RZJWZ46.js.map} +0 -0
  489. /package/dist/{chunk-JBPKEARU.js.map → chunk-AU7Q3LSC.js.map} +0 -0
  490. /package/dist/{chunk-PDDTI7IC.js.map → chunk-B4T3FQMT.js.map} +0 -0
  491. /package/dist/{chunk-APPFNGX6.js.map → chunk-BSXGTDVJ.js.map} +0 -0
  492. /package/dist/{chunk-4IIFL7GC.js.map → chunk-CLKBV3Z3.js.map} +0 -0
  493. /package/dist/{chunk-ZYLC7NFO.js.map → chunk-CSY44OKU.js.map} +0 -0
  494. /package/dist/{chunk-HLYR2TQL.js.map → chunk-CUTFSLSD.js.map} +0 -0
  495. /package/dist/{chunk-RDJRFDJY.js.map → chunk-DBY26JJJ.js.map} +0 -0
  496. /package/dist/{chunk-QWGE2PUH.js.map → chunk-DDA55IVB.js.map} +0 -0
  497. /package/dist/{chunk-VMMQDEN5.js.map → chunk-DN2IDKI5.js.map} +0 -0
  498. /package/dist/{chunk-2GFK22OZ.js.map → chunk-DOOWFDWN.js.map} +0 -0
  499. /package/dist/{chunk-7FGL6CGA.js.map → chunk-DVYRD4HY.js.map} +0 -0
  500. /package/dist/{chunk-YGLY6QFV.js.map → chunk-F2Y6I74C.js.map} +0 -0
  501. /package/dist/{chunk-UU7TRFNE.js.map → chunk-FFEBSFVT.js.map} +0 -0
  502. /package/dist/{chunk-NIS256NW.js.map → chunk-JKW663ZN.js.map} +0 -0
  503. /package/dist/{chunk-G7A5HLUS.js.map → chunk-KJH6W2I7.js.map} +0 -0
  504. /package/dist/{chunk-HWRD23DW.js.map → chunk-LVKYLMSM.js.map} +0 -0
  505. /package/dist/{chunk-ZMYDYNI4.js.map → chunk-N7CXQ5TA.js.map} +0 -0
  506. /package/dist/{chunk-3JLPGJ43.js.map → chunk-NGT35IGQ.js.map} +0 -0
  507. /package/dist/{chunk-GUKBW4HL.js.map → chunk-NQMSEB5D.js.map} +0 -0
  508. /package/dist/{chunk-WRJVB3C2.js.map → chunk-PO7NXBG2.js.map} +0 -0
  509. /package/dist/{chunk-WM65LU67.js.map → chunk-QOQQMVR2.js.map} +0 -0
  510. /package/dist/{chunk-QHFV6VNU.js.map → chunk-QPAQSG3F.js.map} +0 -0
  511. /package/dist/{chunk-UES4BHA2.js.map → chunk-QTO6BMQZ.js.map} +0 -0
  512. /package/dist/{chunk-THPPCISA.js.map → chunk-RBII7637.js.map} +0 -0
  513. /package/dist/{chunk-QT2FRYI4.js.map → chunk-RG426DJO.js.map} +0 -0
  514. /package/dist/{chunk-VKXWK44Q.js.map → chunk-TY6MKIWP.js.map} +0 -0
  515. /package/dist/{chunk-AZM4CCAC.js.map → chunk-UWJNKGBA.js.map} +0 -0
  516. /package/dist/{chunk-ZPJ4QSGP.js.map → chunk-VTU5IEKY.js.map} +0 -0
  517. /package/dist/{chunk-RZ4XGKOJ.js.map → chunk-VYQ4URQB.js.map} +0 -0
  518. /package/dist/{chunk-WDBX6VER.js.map → chunk-VZRFGJCH.js.map} +0 -0
  519. /package/dist/{chunk-IBKR2TFR.js.map → chunk-WM5LD6AT.js.map} +0 -0
  520. /package/dist/{chunk-K4QS7LXU.js.map → chunk-WZWZRZ2V.js.map} +0 -0
  521. /package/dist/{chunk-G4T7L557.js.map → chunk-XKAR4RF6.js.map} +0 -0
  522. /package/dist/{chunk-DZD576ZU.js.map → chunk-XSV2YDCJ.js.map} +0 -0
  523. /package/dist/{chunk-G7Z6EENO.js.map → chunk-YDWPYDML.js.map} +0 -0
  524. /package/dist/{chunk-6HPHEFXT.js.map → chunk-YKZLOPTC.js.map} +0 -0
  525. /package/dist/{contradiction-scan-HYLIRMJ2.js.map → contradiction-scan-KCADHXPE.js.map} +0 -0
  526. /package/dist/{purge-533FZLS4.js.map → purge-GB7PZHT2.js.map} +0 -0
@@ -1,4 +1,4 @@
1
- import { aL as FusedWearableConversation, aM as FusedDayMeta, aN as FusedDayFile, aO as MeetingRecord, aP as MeetingDetectionSource, aQ as FusedMeeting, M as MemoryFile, l as MemoryFrontmatter, aR as EntityTimelineEntry, an as EntityStructuredSection, E as EntityFile, P as PluginConfig, y as MemoryStatus, w as MemoryCategory, aq as ImportanceScore, aS as MemoryLink, F as FaithfulnessFrontmatter, K as ProvenanceSource, aT as BufferState, az as MetaState, ag as MemoryActionEvent, J as MemoryLifecycleEvent, a7 as BufferSurpriseEvent, a6 as BehaviorSignalEvent, ah as CompressionGuidelineOptimizerState, aU as FileHygieneConfig, aV as EntityRelationship, aW as EntityActivityEntry, aX as AccessTrackingEntry, z as MemoryProjectionCurrentState, aY as MemorySummary, aD as TopicScore } from './types-d_j4vC6N.js';
1
+ import { aU as FusedWearableConversation, b2 as FusedDayMeta, b3 as FusedDayFile, aZ as MeetingRecord, b4 as MeetingDetectionSource, aY as FusedMeeting, M as MemoryFile, l as MemoryFrontmatter, b5 as EntityTimelineEntry, an as EntityStructuredSection, E as EntityFile, P as PluginConfig, y as MemoryStatus, w as MemoryCategory, aq as ImportanceScore, b6 as MemoryLink, F as FaithfulnessFrontmatter, K as ProvenanceSource, b7 as BufferState, az as MetaState, ag as MemoryActionEvent, J as MemoryLifecycleEvent, a7 as BufferSurpriseEvent, a6 as BehaviorSignalEvent, ah as CompressionGuidelineOptimizerState, b8 as FileHygieneConfig, b9 as EntityRelationship, ba as EntityActivityEntry, bb as AccessTrackingEntry, z as MemoryProjectionCurrentState, bc as MemorySummary, aD as TopicScore } from './types-BnQza1y8.js';
2
2
  import { CorpusReadOptions } from './corpus-read-cancellation.js';
3
3
  import { ArtifactSearchOptions } from './artifact-search.js';
4
4
  import './entity-id-normalization.js';
@@ -570,6 +570,13 @@ interface RetiredMemoryRecord {
570
570
  contentHash?: string;
571
571
  }
572
572
 
573
+ interface SupersessionAuditOptions {
574
+ content: string;
575
+ tags?: string[];
576
+ structuredAttributes?: Record<string, string>;
577
+ source?: string;
578
+ }
579
+
573
580
  /**
574
581
  * Tuning for {@link ContentHashIndex} cross-process lock waits and the
575
582
  * deferred reconcile-save durable retry (issue #1909 / PR #2016). All optional;
@@ -1762,7 +1769,23 @@ declare class StorageManager extends TombstoneBlockedCaptureIndexHost {
1762
1769
  */
1763
1770
  private resolveCategoryWritePath;
1764
1771
  private findExistingTombstoneBlockedMemory;
1765
- writeMemory(category: MemoryCategory, content: string, options?: WriteMemoryOptions): Promise<MemoryWriteResult>;
1772
+ writeMemory(category: MemoryCategory, content: string, options?: WriteMemoryOptions): Promise<{
1773
+ id: string;
1774
+ tombstoneBlocked: boolean;
1775
+ blockedBy: string | undefined;
1776
+ duplicateOf: string;
1777
+ memory: MemoryFile;
1778
+ } | {
1779
+ memory: {
1780
+ path: string;
1781
+ frontmatter: MemoryFrontmatter;
1782
+ content: string;
1783
+ };
1784
+ blockedBy?: string | undefined;
1785
+ id: string;
1786
+ tombstoneBlocked: boolean;
1787
+ duplicateOf?: undefined;
1788
+ }>;
1766
1789
  /**
1767
1790
  * Sealed-envelope write entry point (issue #1989 PR2).
1768
1791
  *
@@ -1782,7 +1805,23 @@ declare class StorageManager extends TombstoneBlockedCaptureIndexHost {
1782
1805
  * `envelope.sourceReason` is access-layer metadata with no frontmatter
1783
1806
  * field and is deliberately not persisted here.
1784
1807
  */
1785
- writeSealedMemory(envelope: SealedMemoryEnvelope, extras?: SealedWriteExtras): Promise<MemoryWriteResult>;
1808
+ writeSealedMemory(envelope: SealedMemoryEnvelope, extras?: SealedWriteExtras): Promise<{
1809
+ id: string;
1810
+ tombstoneBlocked: boolean;
1811
+ blockedBy: string | undefined;
1812
+ duplicateOf: string;
1813
+ memory: MemoryFile;
1814
+ } | {
1815
+ memory: {
1816
+ path: string;
1817
+ frontmatter: MemoryFrontmatter;
1818
+ content: string;
1819
+ };
1820
+ blockedBy?: string | undefined;
1821
+ id: string;
1822
+ tombstoneBlocked: boolean;
1823
+ duplicateOf?: undefined;
1824
+ }>;
1786
1825
  hasFactContentHash(content: string): Promise<boolean>;
1787
1826
  private factContentHashPresentInCorpus;
1788
1827
  private factContentHashesForRemoval;
@@ -2168,17 +2207,9 @@ declare class StorageManager extends TombstoneBlockedCaptureIndexHost {
2168
2207
  * Called during consolidation or when buffer exceeds max size.
2169
2208
  */
2170
2209
  flushAccessTracking(entries: AccessTrackingEntry[]): Promise<number>;
2171
- /**
2172
- * Get a memory by its ID.
2173
- */
2174
2210
  getMemoryById(id: string): Promise<MemoryFile | null>;
2175
- /**
2176
- * Resolve existing active memory IDs to their on-disk paths.
2177
- *
2178
- * Uses a lightweight directory scan (collectActiveMemoryPaths) that reads
2179
- * file names without parsing frontmatter — much cheaper than readAllMemories()
2180
- * for citation usage tracking and other existence checks.
2181
- */
2211
+ getMemoryByIdIncludingArchived(id: string): Promise<MemoryFile | null>;
2212
+ /** Resolve existing active memory IDs through a lightweight directory scan. */
2182
2213
  findExistingMemoryPaths(ids: string[], preferredPaths?: Map<string, string[]>): Promise<Map<string, string[]>>;
2183
2214
  /**
2184
2215
  * Check which of the given memory IDs actually exist on disk.
@@ -2231,9 +2262,11 @@ declare class StorageManager extends TombstoneBlockedCaptureIndexHost {
2231
2262
  */
2232
2263
  getChunksForParent(parentId: string): Promise<MemoryFile[]>;
2233
2264
  supersedeMemory(oldMemoryId: string, newMemoryId: string, reason: string, supersessionMetadata?: Pick<MemoryFrontmatter, "supersessionCause" | "invalidatedBy">, options?: {
2265
+ actor?: string;
2234
2266
  requireActive?: boolean;
2235
2267
  acceptExactReplay?: boolean;
2236
2268
  expectedSnapshot?: Pick<MemoryFile, "content" | "frontmatter"> & Partial<Pick<MemoryFile, "path">>;
2269
+ audit?: SupersessionAuditOptions;
2237
2270
  }): Promise<boolean>;
2238
2271
  private get summariesDir();
2239
2272
  writeSummary(summary: MemorySummary): Promise<void>;
package/dist/storage.d.ts CHANGED
@@ -1,7 +1,7 @@
1
- import './types-d_j4vC6N.js';
1
+ import './types-BnQza1y8.js';
2
2
  import './corpus-read-cancellation.js';
3
3
  import './artifact-search.js';
4
- export { C as ContentHashIndex, t as ContentHashIndexLockOptions, u as FactHashIndexNotAuthoritativeError, v as MemoryLifecycleEventWriteOptions, M as MemoryWriteResult, R as ReextractJobRequest, w as SealedWriteExtras, S as StorageManager, W as WriteMemoryOptions, x as buildEntitySchemaCacheKey, y as compareEntityTimestamps, z as compileEntityFacts, A as countEntityStructuredFacts, B as fingerprintEntityStructuredFacts, D as isEntitySynthesisStale, E as isValidBufferSurpriseEvent, G as normalizeFrontmatterForPath, H as normalizeStructuredSectionFacts, p as parseEntityFile, I as parseFrontmatter, J as parseFrontmatterStringValue, s as serializeEntityFile } from './storage-DqCzXi56.js';
4
+ export { C as ContentHashIndex, t as ContentHashIndexLockOptions, u as FactHashIndexNotAuthoritativeError, v as MemoryLifecycleEventWriteOptions, M as MemoryWriteResult, R as ReextractJobRequest, w as SealedWriteExtras, S as StorageManager, W as WriteMemoryOptions, x as buildEntitySchemaCacheKey, y as compareEntityTimestamps, z as compileEntityFacts, A as countEntityStructuredFacts, B as fingerprintEntityStructuredFacts, D as isEntitySynthesisStale, E as isValidBufferSurpriseEvent, G as normalizeFrontmatterForPath, H as normalizeStructuredSectionFacts, p as parseEntityFile, I as parseFrontmatter, J as parseFrontmatterStringValue, s as serializeEntityFile } from './storage-CC1jKcWg.js';
5
5
  export { normalizeEntityName } from './entity-id-normalization.js';
6
6
  import './page-versioning.js';
7
7
  import './consolidation-operator.js';
package/dist/storage.js CHANGED
@@ -13,22 +13,37 @@ import {
13
13
  parseFrontmatter,
14
14
  parseFrontmatterStringValue,
15
15
  serializeEntityFile
16
- } from "./chunk-6R4G7N4S.js";
16
+ } from "./chunk-QQXWFDRD.js";
17
17
  import "./chunk-UHVXE24Y.js";
18
18
  import "./chunk-MLPTFODV.js";
19
19
  import "./chunk-SXIMQLGV.js";
20
+ import "./chunk-DN2IDKI5.js";
21
+ import "./chunk-UWJNKGBA.js";
22
+ import "./chunk-VANZKHTN.js";
23
+ import "./chunk-CYEPCZN5.js";
24
+ import "./chunk-YLHM5BQQ.js";
25
+ import "./chunk-VYISFWVX.js";
26
+ import "./chunk-GWFSVJ4P.js";
27
+ import "./chunk-XL3TATMJ.js";
28
+ import "./chunk-W7IGLX4G.js";
29
+ import "./chunk-GUMZC2BO.js";
30
+ import "./chunk-7RZJWZ46.js";
31
+ import "./chunk-A7Q43EUZ.js";
32
+ import "./chunk-ET356KSB.js";
33
+ import "./chunk-72A4L5JJ.js";
20
34
  import "./chunk-S2V7RUCL.js";
21
- import "./chunk-UU3G6GUP.js";
35
+ import "./chunk-BIF4SHMD.js";
22
36
  import "./chunk-SCU65EZI.js";
23
- import "./chunk-WRJVB3C2.js";
37
+ import "./chunk-PO7NXBG2.js";
24
38
  import "./chunk-S2HLHAZ4.js";
25
39
  import "./chunk-DM2T26WE.js";
26
40
  import "./chunk-LDXUBPMO.js";
27
41
  import "./chunk-JYIJNNN3.js";
28
42
  import "./chunk-AAD2ZS6P.js";
29
- import "./chunk-K4QS7LXU.js";
43
+ import "./chunk-WZWZRZ2V.js";
30
44
  import "./chunk-NSVDUN76.js";
31
45
  import "./chunk-BT7NVCML.js";
46
+ import "./chunk-3ONXXHQO.js";
32
47
  import {
33
48
  normalizeEntityName
34
49
  } from "./chunk-YXZG5TVN.js";
@@ -46,6 +61,10 @@ import "./chunk-L2EXJQJP.js";
46
61
  import "./chunk-45GF7Y3V.js";
47
62
  import "./chunk-RGMVMVMF.js";
48
63
  import "./chunk-N7RWREIQ.js";
64
+ import "./chunk-QCECHYZL.js";
65
+ import "./chunk-URS5GSM7.js";
66
+ import "./chunk-ZLQ37WJX.js";
67
+ import "./chunk-IUM3VSHI.js";
49
68
  import "./chunk-XMMESCPD.js";
50
69
  import "./chunk-42JKGUFJ.js";
51
70
  import "./chunk-VOELBUS4.js";
@@ -59,8 +78,7 @@ import "./chunk-BJMBJZ2Y.js";
59
78
  import "./chunk-UKJAGEXH.js";
60
79
  import "./chunk-FP2373TW.js";
61
80
  import "./chunk-J6A3CX5N.js";
62
- import "./chunk-7FGL6CGA.js";
63
- import "./chunk-EGGE52UU.js";
81
+ import "./chunk-DVYRD4HY.js";
64
82
  import "./chunk-ZA53AZND.js";
65
83
  import "./chunk-GCASGYIO.js";
66
84
  import "./chunk-7RJUVTVF.js";
@@ -68,18 +86,21 @@ import {
68
86
  ContentHashIndex,
69
87
  FactHashIndexNotAuthoritativeError
70
88
  } from "./chunk-CX5SW2EW.js";
71
- import "./chunk-3CSX3ETE.js";
89
+ import "./chunk-2LWQSV6A.js";
72
90
  import "./chunk-RL6NEVXT.js";
91
+ import "./chunk-FFAZ2XFU.js";
92
+ import "./chunk-5FVVY2EB.js";
93
+ import "./chunk-HNDIND7P.js";
94
+ import "./chunk-EGGE52UU.js";
73
95
  import {
74
96
  normalizeAttributePairs,
75
97
  stripAttributesSuffix
76
98
  } from "./chunk-JDSVLVCG.js";
77
- import "./chunk-FFAZ2XFU.js";
78
- import "./chunk-5FVVY2EB.js";
79
99
  import "./chunk-5GKPFL3S.js";
80
100
  import "./chunk-JAKIDQB2.js";
81
101
  import "./chunk-P7FMDTKL.js";
82
102
  import "./chunk-2XRE6FLM.js";
103
+ import "./chunk-O75CRYGF.js";
83
104
  import "./chunk-EYIEWJNI.js";
84
105
  import "./chunk-JUC24CTX.js";
85
106
  import "./chunk-BTTPKDIL.js";
@@ -1,5 +1,5 @@
1
1
  import { ModelRegistry } from './model-registry.js';
2
- import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-d_j4vC6N.js';
2
+ import { P as PluginConfig, G as GatewayConfig, T as TranscriptEntry, H as HourlySummary } from './types-BnQza1y8.js';
3
3
  import { TranscriptManager } from './transcript.js';
4
4
  import './message-parts/index.js';
5
5
  import './bounded-jsonl-state.js';
@@ -1,4 +1,4 @@
1
- import { H as HourlySummary } from './types-d_j4vC6N.js';
1
+ import { H as HourlySummary } from './types-BnQza1y8.js';
2
2
  import './message-parts/index.js';
3
3
  import './bounded-jsonl-state.js';
4
4
  import './operator-doctor-types.js';
@@ -1,5 +1,5 @@
1
- import { M as MemoryFile, l as MemoryFrontmatter, J as MemoryLifecycleEvent } from './types-d_j4vC6N.js';
2
- import { D as DependencyPropagationDeliveryPort } from './dependency-propagation-delivery-XzF76C9n.js';
1
+ import { M as MemoryFile, l as MemoryFrontmatter, J as MemoryLifecycleEvent } from './types-BnQza1y8.js';
2
+ import { D as DependencyPropagationDeliveryPort } from './dependency-propagation-delivery-CTDuAVJc.js';
3
3
  import './message-parts/index.js';
4
4
  import './bounded-jsonl-state.js';
5
5
  import './operator-doctor-types.js';
@@ -1,4 +1,4 @@
1
- import { M as MemoryFile } from './types-d_j4vC6N.js';
1
+ import { M as MemoryFile } from './types-BnQza1y8.js';
2
2
  import './message-parts/index.js';
3
3
  import './bounded-jsonl-state.js';
4
4
  import './operator-doctor-types.js';
@@ -1,4 +1,4 @@
1
- import { l as MemoryFrontmatter } from './types-d_j4vC6N.js';
1
+ import { l as MemoryFrontmatter } from './types-BnQza1y8.js';
2
2
  import './message-parts/index.js';
3
3
  import './bounded-jsonl-state.js';
4
4
  import './operator-doctor-types.js';
@@ -1,4 +1,4 @@
1
- import { j as BufferTurn, O as ConversationThread } from './types-d_j4vC6N.js';
1
+ import { j as BufferTurn, O as ConversationThread } from './types-BnQza1y8.js';
2
2
  import './message-parts/index.js';
3
3
  import './bounded-jsonl-state.js';
4
4
  import './operator-doctor-types.js';
@@ -1,5 +1,5 @@
1
- import { M as MemoryFile } from './types-d_j4vC6N.js';
2
- import { S as StorageManager } from './storage-DqCzXi56.js';
1
+ import { M as MemoryFile } from './types-BnQza1y8.js';
2
+ import { S as StorageManager } from './storage-CC1jKcWg.js';
3
3
  import { MemoryTier } from './tier-routing.js';
4
4
  import { SearchBackend } from './search/port.js';
5
5
  import './message-parts/index.js';
@@ -1,5 +1,5 @@
1
- import { M as MemoryFile } from './types-d_j4vC6N.js';
2
1
  import { LifecycleSignals } from './lifecycle.js';
2
+ import { M as MemoryFile } from './types-BnQza1y8.js';
3
3
  import './message-parts/index.js';
4
4
  import './bounded-jsonl-state.js';
5
5
  import './operator-doctor-types.js';
@@ -23,6 +23,6 @@ interface TierTransitionDecision {
23
23
  reason: string;
24
24
  }
25
25
  declare function computeTierValueScore(memory: Pick<MemoryFile, "frontmatter">, now: Date, signals?: LifecycleSignals): number;
26
- declare function decideTierTransition(memory: Pick<MemoryFile, "frontmatter">, currentTier: MemoryTier, policy: TierRoutingPolicy, now: Date, signals?: LifecycleSignals): TierTransitionDecision;
26
+ declare function decideTierTransition(memory: Pick<MemoryFile, "frontmatter" | "content">, currentTier: MemoryTier, policy: TierRoutingPolicy, now: Date, signals?: LifecycleSignals): TierTransitionDecision;
27
27
 
28
28
  export { type MemoryTier, type TierRoutingPolicy, type TierTransitionDecision, computeTierValueScore, decideTierTransition };
@@ -1,8 +1,14 @@
1
1
  import {
2
2
  computeTierValueScore,
3
3
  decideTierTransition
4
- } from "./chunk-S75M5ZRK.js";
4
+ } from "./chunk-6LEIWWAF.js";
5
5
  import "./chunk-TBBDFYXW.js";
6
+ import "./chunk-HNDIND7P.js";
7
+ import "./chunk-EGGE52UU.js";
8
+ import "./chunk-JDSVLVCG.js";
9
+ import "./chunk-5GKPFL3S.js";
10
+ import "./chunk-JAKIDQB2.js";
11
+ import "./chunk-P7FMDTKL.js";
6
12
  import "./chunk-PZ5AY32C.js";
7
13
  export {
8
14
  computeTierValueScore,
@@ -5,12 +5,18 @@ import {
5
5
  import {
6
6
  computeTierValueScore,
7
7
  decideTierTransition
8
- } from "./chunk-S75M5ZRK.js";
8
+ } from "./chunk-6LEIWWAF.js";
9
9
  import "./chunk-HDQUQBPW.js";
10
10
  import "./chunk-6FC3IZ26.js";
11
11
  import {
12
12
  computeLifecycleValueInputs
13
13
  } from "./chunk-TBBDFYXW.js";
14
+ import "./chunk-HNDIND7P.js";
15
+ import "./chunk-EGGE52UU.js";
16
+ import "./chunk-JDSVLVCG.js";
17
+ import "./chunk-5GKPFL3S.js";
18
+ import "./chunk-JAKIDQB2.js";
19
+ import "./chunk-P7FMDTKL.js";
14
20
  import {
15
21
  resolveQmdCapabilities,
16
22
  resolveUtilityLearningCapabilities
@@ -153,4 +159,4 @@ export {
153
159
  formatTierSummaryText,
154
160
  summarizeTiers
155
161
  };
156
- //# sourceMappingURL=tier-stats-2JCZYEF7.js.map
162
+ //# sourceMappingURL=tier-stats-JDN6HRNT.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/maintenance/tier-stats.ts"],"sourcesContent":["/**\n * Operator-facing tier visibility (issue #686 PR 5/6).\n *\n * Two read-only surfaces:\n *\n * - `summarizeTiers(storage)` — count memories by tier (hot vs cold)\n * plus per-status breakdown so operators can see at a glance\n * whether the lifecycle policy has actually demoted anything.\n * - `explainTierForMemory(storage, id)` — show the value-score\n * components and tier-transition decision for a single memory\n * so an operator can reason about why a memory ended up where\n * it did.\n *\n * Pure inspection — neither surface mutates anything. The CLI wires\n * them as `remnic tier list` and `remnic tier explain <id>`.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile, PluginConfig } from \"../types.js\";\nimport { computeLifecycleValueInputs } from \"../lifecycle.js\";\nimport {\n computeTierValueScore,\n decideTierTransition,\n type MemoryTier,\n type TierRoutingPolicy,\n type TierTransitionDecision,\n} from \"../tier-routing.js\";\nimport { resolveQmdCapabilities, resolveUtilityLearningCapabilities} from \"../capabilities.js\";\nimport {\n applyUtilityPromotionRuntimePolicy,\n loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\n\nexport interface TierSummary {\n /** Total memories scanned (all tiers, all statuses). */\n total: number;\n byTier: Record<MemoryTier, number>;\n byStatus: Record<string, number>;\n /** Memories with `status === \"forgotten\"` (issue #686 PR 4/6). */\n forgottenCount: number;\n /** Top contributors to the forgotten / archived buckets, by category. */\n byCategory: Record<string, number>;\n}\n\nexport interface TierExplainResult {\n id: string;\n path: string;\n currentTier: MemoryTier;\n status: string;\n category: string;\n valueScore: number;\n decision: TierTransitionDecision;\n signals: {\n confidence: number;\n accessCount: number;\n lastAccessed: string | null;\n created: string;\n updated: string;\n importance: number;\n feedback: number;\n };\n}\n\ninterface TierVisibleMemory {\n memory: MemoryFile;\n tier: MemoryTier;\n}\n\nasync function readTierVisibleMemories(\n storage: StorageManager,\n): Promise<TierVisibleMemory[]> {\n const [hotMemories, coldMemories] = await Promise.all([\n storage.readAllMemories(),\n storage.readAllColdMemories(),\n ]);\n return [\n ...hotMemories.map((memory) => ({ memory, tier: \"hot\" as const })),\n ...coldMemories.map((memory) => ({ memory, tier: \"cold\" as const })),\n ];\n}\n\nasync function tierRoutingPolicyFromConfig(\n config: PluginConfig,\n): Promise<TierRoutingPolicy> {\n const basePolicy: TierRoutingPolicy = {\n enabled: resolveQmdCapabilities(config).qmdTierMigration,\n demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n };\n const runtime = await loadUtilityRuntimeValues({\n memoryDir: config.memoryDir,\n memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\n });\n return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nexport async function summarizeTiers(\n storage: StorageManager,\n): Promise<TierSummary> {\n const all = await readTierVisibleMemories(storage);\n const summary: TierSummary = {\n total: all.length,\n byTier: { hot: 0, cold: 0 },\n byStatus: {},\n forgottenCount: 0,\n byCategory: {},\n };\n for (const { memory: m, tier } of all) {\n summary.byTier[tier] += 1;\n const status: string = m.frontmatter.status ?? \"active\";\n summary.byStatus[status] = (summary.byStatus[status] ?? 0) + 1;\n // Compare via the widened `string` type so this module compiles\n // both before and after PR 4/6 lands `\"forgotten\"` in MemoryStatus.\n if (status === \"forgotten\") summary.forgottenCount += 1;\n const cat = m.frontmatter.category ?? \"(uncategorized)\";\n summary.byCategory[cat] = (summary.byCategory[cat] ?? 0) + 1;\n }\n return summary;\n}\n\nexport async function explainTierForMemory(\n storage: StorageManager,\n id: string,\n config: PluginConfig,\n): Promise<TierExplainResult> {\n const trimmed = typeof id === \"string\" ? id.trim() : \"\";\n if (trimmed.length === 0) {\n throw new Error(\"tier explain: memory id is required and must be non-empty\");\n }\n const all = await readTierVisibleMemories(storage);\n const entry = all.find(({ memory: m }) => m.frontmatter.id === trimmed);\n if (!entry) {\n throw new Error(`tier explain: memory not found: ${trimmed}`);\n }\n const { memory, tier: currentTier } = entry;\n const now = new Date();\n const valueInputs = computeLifecycleValueInputs(memory, now);\n const valueScore = computeTierValueScore(memory, now);\n const policy = await tierRoutingPolicyFromConfig(config);\n const decision = decideTierTransition(memory, currentTier, policy, now);\n const fm = memory.frontmatter as unknown as Record<string, unknown>;\n return {\n id: trimmed,\n path: memory.path,\n currentTier,\n status: typeof fm.status === \"string\" ? (fm.status as string) : \"active\",\n category: typeof fm.category === \"string\" ? (fm.category as string) : \"\",\n valueScore,\n decision,\n signals: {\n confidence: valueInputs.confidence,\n accessCount:\n typeof fm.accessCount === \"number\" ? (fm.accessCount as number) : 0,\n lastAccessed:\n typeof fm.lastAccessed === \"string\" ? (fm.lastAccessed as string) : null,\n created: typeof fm.created === \"string\" ? (fm.created as string) : \"\",\n updated: typeof fm.updated === \"string\" ? (fm.updated as string) : \"\",\n importance: valueInputs.importance,\n feedback: valueInputs.feedback,\n },\n };\n}\n\n/**\n * Render a TierSummary as plain text for `remnic tier list` text mode.\n * Pure formatter — exposed so future surfaces (HTTP, MCP) can reuse.\n */\nexport function formatTierSummaryText(summary: TierSummary): string {\n const lines: string[] = [];\n lines.push(\"=== Memory Tier Distribution ===\");\n lines.push(`Total memories: ${summary.total}`);\n lines.push(\"\");\n lines.push(\"Tier:\");\n lines.push(` hot: ${summary.byTier.hot}`);\n lines.push(` cold: ${summary.byTier.cold}`);\n lines.push(\"\");\n lines.push(\"Status:\");\n const statusEntries = Object.entries(summary.byStatus).sort(\n (a, b) => b[1] - a[1] || a[0].localeCompare(b[0]),\n );\n for (const [status, count] of statusEntries) {\n lines.push(` ${status}: ${count}`);\n }\n lines.push(\"\");\n lines.push(\"Top categories:\");\n const categoryEntries = Object.entries(summary.byCategory)\n .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n .slice(0, 8);\n for (const [cat, count] of categoryEntries) {\n lines.push(` ${cat}: ${count}`);\n }\n return lines.join(\"\\n\");\n}\n\n/**\n * Render a TierExplainResult as plain text for `remnic tier explain`.\n */\nexport function formatTierExplainText(explain: TierExplainResult): string {\n const lines: string[] = [];\n lines.push(`=== Tier Explain: ${explain.id} ===`);\n lines.push(`path: ${explain.path}`);\n lines.push(`current tier: ${explain.currentTier}`);\n lines.push(`status: ${explain.status}`);\n lines.push(`category: ${explain.category}`);\n lines.push(`value score: ${explain.valueScore.toFixed(3)}`);\n lines.push(\"\");\n lines.push(\"Tier-transition decision:\");\n lines.push(` next tier: ${explain.decision.nextTier}`);\n lines.push(` changed: ${explain.decision.changed}`);\n lines.push(` reason: ${explain.decision.reason}`);\n lines.push(\"\");\n lines.push(\"Signals:\");\n lines.push(` confidence: ${explain.signals.confidence}`);\n lines.push(` accessCount: ${explain.signals.accessCount}`);\n lines.push(` lastAccessed: ${explain.signals.lastAccessed ?? \"(never)\"}`);\n lines.push(` created: ${explain.signals.created}`);\n lines.push(` updated: ${explain.signals.updated}`);\n lines.push(` importance: ${explain.signals.importance}`);\n lines.push(` feedback: ${explain.signals.feedback}`);\n return lines.join(\"\\n\");\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/maintenance/tier-stats.ts"],"sourcesContent":["/**\n * Operator-facing tier visibility (issue #686 PR 5/6).\n *\n * Two read-only surfaces:\n *\n * - `summarizeTiers(storage)` — count memories by tier (hot vs cold)\n * plus per-status breakdown so operators can see at a glance\n * whether the lifecycle policy has actually demoted anything.\n * - `explainTierForMemory(storage, id)` — show the value-score\n * components and tier-transition decision for a single memory\n * so an operator can reason about why a memory ended up where\n * it did.\n *\n * Pure inspection — neither surface mutates anything. The CLI wires\n * them as `remnic tier list` and `remnic tier explain <id>`.\n */\n\nimport type { StorageManager } from \"../storage.js\";\nimport type { MemoryFile, PluginConfig } from \"../types.js\";\nimport { computeLifecycleValueInputs } from \"../lifecycle.js\";\nimport {\n computeTierValueScore,\n decideTierTransition,\n type MemoryTier,\n type TierRoutingPolicy,\n type TierTransitionDecision,\n} from \"../tier-routing.js\";\nimport { resolveQmdCapabilities, resolveUtilityLearningCapabilities} from \"../capabilities.js\";\nimport {\n applyUtilityPromotionRuntimePolicy,\n loadUtilityRuntimeValues,\n} from \"../utility-runtime.js\";\n\nexport interface TierSummary {\n /** Total memories scanned (all tiers, all statuses). */\n total: number;\n byTier: Record<MemoryTier, number>;\n byStatus: Record<string, number>;\n /** Memories with `status === \"forgotten\"` (issue #686 PR 4/6). */\n forgottenCount: number;\n /** Top contributors to the forgotten / archived buckets, by category. */\n byCategory: Record<string, number>;\n}\n\nexport interface TierExplainResult {\n id: string;\n path: string;\n currentTier: MemoryTier;\n status: string;\n category: string;\n valueScore: number;\n decision: TierTransitionDecision;\n signals: {\n confidence: number;\n accessCount: number;\n lastAccessed: string | null;\n created: string;\n updated: string;\n importance: number;\n feedback: number;\n };\n}\n\ninterface TierVisibleMemory {\n memory: MemoryFile;\n tier: MemoryTier;\n}\n\nasync function readTierVisibleMemories(\n storage: StorageManager,\n): Promise<TierVisibleMemory[]> {\n const [hotMemories, coldMemories] = await Promise.all([\n storage.readAllMemories(),\n storage.readAllColdMemories(),\n ]);\n return [\n ...hotMemories.map((memory) => ({ memory, tier: \"hot\" as const })),\n ...coldMemories.map((memory) => ({ memory, tier: \"cold\" as const })),\n ];\n}\n\nasync function tierRoutingPolicyFromConfig(\n config: PluginConfig,\n): Promise<TierRoutingPolicy> {\n const basePolicy: TierRoutingPolicy = {\n enabled: resolveQmdCapabilities(config).qmdTierMigration,\n demotionMinAgeDays: config.qmdTierDemotionMinAgeDays,\n demotionValueThreshold: config.qmdTierDemotionValueThreshold,\n promotionValueThreshold: config.qmdTierPromotionValueThreshold,\n };\n const runtime = await loadUtilityRuntimeValues({\n memoryDir: config.memoryDir,\n memoryUtilityLearningEnabled: resolveUtilityLearningCapabilities(config).memoryUtilityLearning,\n promotionByOutcomeEnabled: resolveUtilityLearningCapabilities(config).promotionByOutcome,\n });\n return applyUtilityPromotionRuntimePolicy(basePolicy, runtime);\n}\n\nexport async function summarizeTiers(\n storage: StorageManager,\n): Promise<TierSummary> {\n const all = await readTierVisibleMemories(storage);\n const summary: TierSummary = {\n total: all.length,\n byTier: { hot: 0, cold: 0 },\n byStatus: {},\n forgottenCount: 0,\n byCategory: {},\n };\n for (const { memory: m, tier } of all) {\n summary.byTier[tier] += 1;\n const status: string = m.frontmatter.status ?? \"active\";\n summary.byStatus[status] = (summary.byStatus[status] ?? 0) + 1;\n // Compare via the widened `string` type so this module compiles\n // both before and after PR 4/6 lands `\"forgotten\"` in MemoryStatus.\n if (status === \"forgotten\") summary.forgottenCount += 1;\n const cat = m.frontmatter.category ?? \"(uncategorized)\";\n summary.byCategory[cat] = (summary.byCategory[cat] ?? 0) + 1;\n }\n return summary;\n}\n\nexport async function explainTierForMemory(\n storage: StorageManager,\n id: string,\n config: PluginConfig,\n): Promise<TierExplainResult> {\n const trimmed = typeof id === \"string\" ? id.trim() : \"\";\n if (trimmed.length === 0) {\n throw new Error(\"tier explain: memory id is required and must be non-empty\");\n }\n const all = await readTierVisibleMemories(storage);\n const entry = all.find(({ memory: m }) => m.frontmatter.id === trimmed);\n if (!entry) {\n throw new Error(`tier explain: memory not found: ${trimmed}`);\n }\n const { memory, tier: currentTier } = entry;\n const now = new Date();\n const valueInputs = computeLifecycleValueInputs(memory, now);\n const valueScore = computeTierValueScore(memory, now);\n const policy = await tierRoutingPolicyFromConfig(config);\n const decision = decideTierTransition(memory, currentTier, policy, now);\n const fm = memory.frontmatter as unknown as Record<string, unknown>;\n return {\n id: trimmed,\n path: memory.path,\n currentTier,\n status: typeof fm.status === \"string\" ? (fm.status as string) : \"active\",\n category: typeof fm.category === \"string\" ? (fm.category as string) : \"\",\n valueScore,\n decision,\n signals: {\n confidence: valueInputs.confidence,\n accessCount:\n typeof fm.accessCount === \"number\" ? (fm.accessCount as number) : 0,\n lastAccessed:\n typeof fm.lastAccessed === \"string\" ? (fm.lastAccessed as string) : null,\n created: typeof fm.created === \"string\" ? (fm.created as string) : \"\",\n updated: typeof fm.updated === \"string\" ? (fm.updated as string) : \"\",\n importance: valueInputs.importance,\n feedback: valueInputs.feedback,\n },\n };\n}\n\n/**\n * Render a TierSummary as plain text for `remnic tier list` text mode.\n * Pure formatter — exposed so future surfaces (HTTP, MCP) can reuse.\n */\nexport function formatTierSummaryText(summary: TierSummary): string {\n const lines: string[] = [];\n lines.push(\"=== Memory Tier Distribution ===\");\n lines.push(`Total memories: ${summary.total}`);\n lines.push(\"\");\n lines.push(\"Tier:\");\n lines.push(` hot: ${summary.byTier.hot}`);\n lines.push(` cold: ${summary.byTier.cold}`);\n lines.push(\"\");\n lines.push(\"Status:\");\n const statusEntries = Object.entries(summary.byStatus).sort(\n (a, b) => b[1] - a[1] || a[0].localeCompare(b[0]),\n );\n for (const [status, count] of statusEntries) {\n lines.push(` ${status}: ${count}`);\n }\n lines.push(\"\");\n lines.push(\"Top categories:\");\n const categoryEntries = Object.entries(summary.byCategory)\n .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))\n .slice(0, 8);\n for (const [cat, count] of categoryEntries) {\n lines.push(` ${cat}: ${count}`);\n }\n return lines.join(\"\\n\");\n}\n\n/**\n * Render a TierExplainResult as plain text for `remnic tier explain`.\n */\nexport function formatTierExplainText(explain: TierExplainResult): string {\n const lines: string[] = [];\n lines.push(`=== Tier Explain: ${explain.id} ===`);\n lines.push(`path: ${explain.path}`);\n lines.push(`current tier: ${explain.currentTier}`);\n lines.push(`status: ${explain.status}`);\n lines.push(`category: ${explain.category}`);\n lines.push(`value score: ${explain.valueScore.toFixed(3)}`);\n lines.push(\"\");\n lines.push(\"Tier-transition decision:\");\n lines.push(` next tier: ${explain.decision.nextTier}`);\n lines.push(` changed: ${explain.decision.changed}`);\n lines.push(` reason: ${explain.decision.reason}`);\n lines.push(\"\");\n lines.push(\"Signals:\");\n lines.push(` confidence: ${explain.signals.confidence}`);\n lines.push(` accessCount: ${explain.signals.accessCount}`);\n lines.push(` lastAccessed: ${explain.signals.lastAccessed ?? \"(never)\"}`);\n lines.push(` created: ${explain.signals.created}`);\n lines.push(` updated: ${explain.signals.updated}`);\n lines.push(` importance: ${explain.signals.importance}`);\n lines.push(` feedback: ${explain.signals.feedback}`);\n return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,eAAe,wBACb,SAC8B;AAC9B,QAAM,CAAC,aAAa,YAAY,IAAI,MAAM,QAAQ,IAAI;AAAA,IACpD,QAAQ,gBAAgB;AAAA,IACxB,QAAQ,oBAAoB;AAAA,EAC9B,CAAC;AACD,SAAO;AAAA,IACL,GAAG,YAAY,IAAI,CAAC,YAAY,EAAE,QAAQ,MAAM,MAAe,EAAE;AAAA,IACjE,GAAG,aAAa,IAAI,CAAC,YAAY,EAAE,QAAQ,MAAM,OAAgB,EAAE;AAAA,EACrE;AACF;AAEA,eAAe,4BACb,QAC4B;AAC5B,QAAM,aAAgC;AAAA,IACpC,SAAS,uBAAuB,MAAM,EAAE;AAAA,IACxC,oBAAoB,OAAO;AAAA,IAC3B,wBAAwB,OAAO;AAAA,IAC/B,yBAAyB,OAAO;AAAA,EAClC;AACA,QAAM,UAAU,MAAM,yBAAyB;AAAA,IAC7C,WAAW,OAAO;AAAA,IAClB,8BAA8B,mCAAmC,MAAM,EAAE;AAAA,IACzE,2BAA2B,mCAAmC,MAAM,EAAE;AAAA,EACxE,CAAC;AACD,SAAO,mCAAmC,YAAY,OAAO;AAC/D;AAEA,eAAsB,eACpB,SACsB;AACtB,QAAM,MAAM,MAAM,wBAAwB,OAAO;AACjD,QAAM,UAAuB;AAAA,IAC3B,OAAO,IAAI;AAAA,IACX,QAAQ,EAAE,KAAK,GAAG,MAAM,EAAE;AAAA,IAC1B,UAAU,CAAC;AAAA,IACX,gBAAgB;AAAA,IAChB,YAAY,CAAC;AAAA,EACf;AACA,aAAW,EAAE,QAAQ,GAAG,KAAK,KAAK,KAAK;AACrC,YAAQ,OAAO,IAAI,KAAK;AACxB,UAAM,SAAiB,EAAE,YAAY,UAAU;AAC/C,YAAQ,SAAS,MAAM,KAAK,QAAQ,SAAS,MAAM,KAAK,KAAK;AAG7D,QAAI,WAAW,YAAa,SAAQ,kBAAkB;AACtD,UAAM,MAAM,EAAE,YAAY,YAAY;AACtC,YAAQ,WAAW,GAAG,KAAK,QAAQ,WAAW,GAAG,KAAK,KAAK;AAAA,EAC7D;AACA,SAAO;AACT;AAEA,eAAsB,qBACpB,SACA,IACA,QAC4B;AAC5B,QAAM,UAAU,OAAO,OAAO,WAAW,GAAG,KAAK,IAAI;AACrD,MAAI,QAAQ,WAAW,GAAG;AACxB,UAAM,IAAI,MAAM,2DAA2D;AAAA,EAC7E;AACA,QAAM,MAAM,MAAM,wBAAwB,OAAO;AACjD,QAAM,QAAQ,IAAI,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,OAAO,OAAO;AACtE,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,mCAAmC,OAAO,EAAE;AAAA,EAC9D;AACA,QAAM,EAAE,QAAQ,MAAM,YAAY,IAAI;AACtC,QAAM,MAAM,oBAAI,KAAK;AACrB,QAAM,cAAc,4BAA4B,QAAQ,GAAG;AAC3D,QAAM,aAAa,sBAAsB,QAAQ,GAAG;AACpD,QAAM,SAAS,MAAM,4BAA4B,MAAM;AACvD,QAAM,WAAW,qBAAqB,QAAQ,aAAa,QAAQ,GAAG;AACtE,QAAM,KAAK,OAAO;AAClB,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM,OAAO;AAAA,IACb;AAAA,IACA,QAAQ,OAAO,GAAG,WAAW,WAAY,GAAG,SAAoB;AAAA,IAChE,UAAU,OAAO,GAAG,aAAa,WAAY,GAAG,WAAsB;AAAA,IACtE;AAAA,IACA;AAAA,IACA,SAAS;AAAA,MACP,YAAY,YAAY;AAAA,MACxB,aACE,OAAO,GAAG,gBAAgB,WAAY,GAAG,cAAyB;AAAA,MACpE,cACE,OAAO,GAAG,iBAAiB,WAAY,GAAG,eAA0B;AAAA,MACtE,SAAS,OAAO,GAAG,YAAY,WAAY,GAAG,UAAqB;AAAA,MACnE,SAAS,OAAO,GAAG,YAAY,WAAY,GAAG,UAAqB;AAAA,MACnE,YAAY,YAAY;AAAA,MACxB,UAAU,YAAY;AAAA,IACxB;AAAA,EACF;AACF;AAMO,SAAS,sBAAsB,SAA8B;AAClE,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,kCAAkC;AAC7C,QAAM,KAAK,mBAAmB,QAAQ,KAAK,EAAE;AAC7C,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,OAAO;AAClB,QAAM,KAAK,WAAW,QAAQ,OAAO,GAAG,EAAE;AAC1C,QAAM,KAAK,WAAW,QAAQ,OAAO,IAAI,EAAE;AAC3C,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,SAAS;AACpB,QAAM,gBAAgB,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AAAA,IACrD,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC;AAAA,EAClD;AACA,aAAW,CAAC,QAAQ,KAAK,KAAK,eAAe;AAC3C,UAAM,KAAK,KAAK,MAAM,KAAK,KAAK,EAAE;AAAA,EACpC;AACA,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,iBAAiB;AAC5B,QAAM,kBAAkB,OAAO,QAAQ,QAAQ,UAAU,EACtD,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EACtD,MAAM,GAAG,CAAC;AACb,aAAW,CAAC,KAAK,KAAK,KAAK,iBAAiB;AAC1C,UAAM,KAAK,KAAK,GAAG,KAAK,KAAK,EAAE;AAAA,EACjC;AACA,SAAO,MAAM,KAAK,IAAI;AACxB;AAKO,SAAS,sBAAsB,SAAoC;AACxE,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,qBAAqB,QAAQ,EAAE,MAAM;AAChD,QAAM,KAAK,kBAAkB,QAAQ,IAAI,EAAE;AAC3C,QAAM,KAAK,kBAAkB,QAAQ,WAAW,EAAE;AAClD,QAAM,KAAK,kBAAkB,QAAQ,MAAM,EAAE;AAC7C,QAAM,KAAK,kBAAkB,QAAQ,QAAQ,EAAE;AAC/C,QAAM,KAAK,kBAAkB,QAAQ,WAAW,QAAQ,CAAC,CAAC,EAAE;AAC5D,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,2BAA2B;AACtC,QAAM,KAAK,gBAAgB,QAAQ,SAAS,QAAQ,EAAE;AACtD,QAAM,KAAK,gBAAgB,QAAQ,SAAS,OAAO,EAAE;AACrD,QAAM,KAAK,gBAAgB,QAAQ,SAAS,MAAM,EAAE;AACpD,QAAM,KAAK,EAAE;AACb,QAAM,KAAK,UAAU;AACrB,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,UAAU,EAAE;AAC1D,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,WAAW,EAAE;AAC3D,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,gBAAgB,SAAS,EAAE;AACzE,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,OAAO,EAAE;AACvD,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,OAAO,EAAE;AACvD,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,UAAU,EAAE;AAC1D,QAAM,KAAK,mBAAmB,QAAQ,QAAQ,QAAQ,EAAE;AACxD,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}
package/dist/topics.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- import { M as MemoryFile, aD as TopicScore } from './types-d_j4vC6N.js';
1
+ import { M as MemoryFile, aD as TopicScore } from './types-BnQza1y8.js';
2
2
  import './message-parts/index.js';
3
3
  import './bounded-jsonl-state.js';
4
4
  import './operator-doctor-types.js';
@@ -1,4 +1,4 @@
1
- import { P as PluginConfig, T as TranscriptEntry, m as Checkpoint } from './types-d_j4vC6N.js';
1
+ import { P as PluginConfig, T as TranscriptEntry, m as Checkpoint } from './types-BnQza1y8.js';
2
2
  import { SessionIntegrityReport } from './session-integrity.js';
3
3
  import './message-parts/index.js';
4
4
  import './bounded-jsonl-state.js';