pi-mega-compact 0.11.4 → 0.11.6

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 (381) hide show
  1. package/dist/extensions/dashboard-server/api-contracts/cache-stripes.js +8 -0
  2. package/dist/extensions/dashboard-server/api-contracts/endpoints.js +32 -0
  3. package/dist/extensions/dashboard-server/api-contracts/memory-map.js +1 -0
  4. package/dist/extensions/dashboard-server/api-contracts/memory.js +8 -0
  5. package/dist/extensions/dashboard-server/api-contracts/provider-cache.js +1 -0
  6. package/dist/extensions/dashboard-server/api-contracts/setup.js +10 -0
  7. package/dist/extensions/dashboard-server/index-reader.js +6 -2
  8. package/dist/extensions/dashboard-server/routes-cache.js +135 -47
  9. package/dist/extensions/dashboard-server/routes-game.js +3 -0
  10. package/dist/extensions/dashboard-server/routes-memory-map.js +50 -0
  11. package/dist/extensions/dashboard-server/routes-memory.js +51 -0
  12. package/dist/extensions/dashboard-server/routes-repo.js +2 -2
  13. package/dist/extensions/dashboard-server/routes-setup.js +267 -0
  14. package/dist/extensions/dashboard-server/routes.js +4 -0
  15. package/dist/extensions/dashboard-server/server.js +13 -1
  16. package/dist/extensions/mega-commands.js +189 -1
  17. package/dist/extensions/mega-compact.js +5 -0
  18. package/dist/extensions/mega-config.js +7 -0
  19. package/dist/extensions/mega-events/agent-handlers.js +19 -4
  20. package/dist/extensions/mega-events/compact-handlers.js +1 -0
  21. package/dist/extensions/mega-events/context-handler.js +45 -92
  22. package/dist/extensions/mega-events/context-hwm.js +51 -0
  23. package/dist/extensions/mega-events/error-classifier.js +16 -5
  24. package/dist/extensions/mega-events/mirror-append.js +107 -0
  25. package/dist/extensions/mega-events/outage-advisor.js +7 -1
  26. package/dist/extensions/mega-events/perf-handler.js +134 -2
  27. package/dist/extensions/mega-events/recall-tail.js +59 -0
  28. package/dist/extensions/mega-events/separated-prompt.js +248 -0
  29. package/dist/extensions/mega-events/session-handlers.js +15 -8
  30. package/dist/extensions/mega-runtime/env-loader.js +56 -0
  31. package/dist/extensions/mega-runtime/reset-runtime.js +6 -0
  32. package/dist/extensions/mega-runtime/runtime-snapshot.js +1 -0
  33. package/dist/extensions/mega-runtime/runtime.js +7 -0
  34. package/dist/extensions/mega-runtime/snapshot.js +1 -0
  35. package/dist/extensions/mega-runtime/widget.js +5 -0
  36. package/dist/src/cache-stripe-impl.js +288 -0
  37. package/dist/src/cache-stripe.js +11 -0
  38. package/dist/src/config/stopwords.js +24 -0
  39. package/dist/src/config.js +17 -0
  40. package/dist/src/embedder.js +41 -2
  41. package/dist/src/memoryGraph.js +299 -0
  42. package/dist/src/memoryStats.js +75 -0
  43. package/dist/src/monitoring.js +13 -0
  44. package/dist/src/prefix-break.js +43 -0
  45. package/dist/src/pricing.js +1 -1
  46. package/dist/src/queryExpansion.js +163 -0
  47. package/dist/src/queryReformulation/cache.js +123 -0
  48. package/dist/src/queryReformulation/rrf.js +29 -0
  49. package/dist/src/queryReformulation/tfidf.js +61 -0
  50. package/dist/src/queryReformulation/vagueness.js +33 -0
  51. package/dist/src/queryReformulation.js +225 -0
  52. package/dist/src/recallMetrics.js +258 -0
  53. package/dist/src/store/sqlite/cache-stripes.js +133 -0
  54. package/dist/src/store/sqlite/fts5-search.js +68 -0
  55. package/dist/src/store/sqlite/perf-samples.js +145 -16
  56. package/dist/src/store/sqlite/schema.js +60 -1
  57. package/dist/src/store/sqlite.js +1 -0
  58. package/dist/src/store/turns/memory-store.js +8 -0
  59. package/dist/src/store/turns/sqlite-store.js +14 -3
  60. package/dist/src/store/turns/types.js +18 -1
  61. package/dist/src/store/vectorIndex.js +55 -10
  62. package/dist/src/tiered-router/types.js +18 -0
  63. package/dist/src/tieredRouter.js +421 -0
  64. package/dist/src/vectorStore.js +8 -6
  65. package/extensions/dashboard-client/dist/assets/{AchievementTiles-vEo2MtE2.js → AchievementTiles-DR9cLGDL.js} +2 -2
  66. package/extensions/dashboard-client/dist/assets/{AchievementTiles-vEo2MtE2.js.map → AchievementTiles-DR9cLGDL.js.map} +1 -1
  67. package/extensions/dashboard-client/dist/assets/AchievementsTab-svNUgJ1e.js +2 -0
  68. package/extensions/dashboard-client/dist/assets/{AchievementsTab-DjxfYrDc.js.map → AchievementsTab-svNUgJ1e.js.map} +1 -1
  69. package/extensions/dashboard-client/dist/assets/CacheTab-ASwhOMjR.js +2 -0
  70. package/extensions/dashboard-client/dist/assets/CacheTab-ASwhOMjR.js.map +1 -0
  71. package/extensions/dashboard-client/dist/assets/{ConfigTab-Cm6ymbmx.js → ConfigTab-CmmWheuW.js} +2 -2
  72. package/extensions/dashboard-client/dist/assets/{ConfigTab-Cm6ymbmx.js.map → ConfigTab-CmmWheuW.js.map} +1 -1
  73. package/extensions/dashboard-client/dist/assets/{EventsTab-DXWl_YzI.js → EventsTab-CFE7jLsa.js} +2 -2
  74. package/extensions/dashboard-client/dist/assets/{EventsTab-DXWl_YzI.js.map → EventsTab-CFE7jLsa.js.map} +1 -1
  75. package/extensions/dashboard-client/dist/assets/GameTab-CJAX_th_.js +2 -0
  76. package/extensions/dashboard-client/dist/assets/{GameTab-BLDudcO5.js.map → GameTab-CJAX_th_.js.map} +1 -1
  77. package/extensions/dashboard-client/dist/assets/{MaintenanceTab-DLkKCztn.js → MaintenanceTab-P4SUsvMf.js} +2 -2
  78. package/extensions/dashboard-client/dist/assets/{MaintenanceTab-DLkKCztn.js.map → MaintenanceTab-P4SUsvMf.js.map} +1 -1
  79. package/extensions/dashboard-client/dist/assets/MemoryMapTab-BBiH76eF.js +2 -0
  80. package/extensions/dashboard-client/dist/assets/MemoryMapTab-BBiH76eF.js.map +1 -0
  81. package/extensions/dashboard-client/dist/assets/{MetricsTab-Cq4u-rZF.js → MetricsTab-CHQscixy.js} +2 -2
  82. package/extensions/dashboard-client/dist/assets/{MetricsTab-Cq4u-rZF.js.map → MetricsTab-CHQscixy.js.map} +1 -1
  83. package/extensions/dashboard-client/dist/assets/OverviewTab-DBs4DJdd.js +2 -0
  84. package/extensions/dashboard-client/dist/assets/{OverviewTab-D4kGvsiQ.js.map → OverviewTab-DBs4DJdd.js.map} +1 -1
  85. package/extensions/dashboard-client/dist/assets/ReposTab-DeFz76L5.js +2 -0
  86. package/extensions/dashboard-client/dist/assets/ReposTab-DeFz76L5.js.map +1 -0
  87. package/extensions/dashboard-client/dist/assets/{SessionsTab-DZC2-GCn.js → SessionsTab-BWNsj1OB.js} +2 -2
  88. package/extensions/dashboard-client/dist/assets/{SessionsTab-DZC2-GCn.js.map → SessionsTab-BWNsj1OB.js.map} +1 -1
  89. package/extensions/dashboard-client/dist/assets/SetupTab-uS6A0xmw.js +2 -0
  90. package/extensions/dashboard-client/dist/assets/SetupTab-uS6A0xmw.js.map +1 -0
  91. package/extensions/dashboard-client/dist/assets/TimeSavedCard-CiqCOQuL.js +2 -0
  92. package/extensions/dashboard-client/dist/assets/TimeSavedCard-CiqCOQuL.js.map +1 -0
  93. package/extensions/dashboard-client/dist/assets/{TopicsTab-01G71hv1.js → TopicsTab-BWWQxltv.js} +2 -2
  94. package/extensions/dashboard-client/dist/assets/{TopicsTab-01G71hv1.js.map → TopicsTab-BWWQxltv.js.map} +1 -1
  95. package/extensions/dashboard-client/dist/assets/{TurnsTab-DLRg0LZT.js → TurnsTab-CVz4f4-o.js} +2 -2
  96. package/extensions/dashboard-client/dist/assets/{TurnsTab-DLRg0LZT.js.map → TurnsTab-CVz4f4-o.js.map} +1 -1
  97. package/extensions/dashboard-client/dist/assets/format-COjDIVGj.js +2 -0
  98. package/extensions/dashboard-client/dist/assets/format-COjDIVGj.js.map +1 -0
  99. package/extensions/dashboard-client/dist/assets/index-CUNn22iV.css +1 -0
  100. package/extensions/dashboard-client/dist/assets/index-DrktNOoT.js +42 -0
  101. package/extensions/dashboard-client/dist/assets/index-DrktNOoT.js.map +1 -0
  102. package/extensions/dashboard-client/dist/assets/pricing-CvE4NllQ.js +2 -0
  103. package/extensions/dashboard-client/dist/assets/pricing-CvE4NllQ.js.map +1 -0
  104. package/extensions/dashboard-client/dist/assets/{useSSE-BBYt5UPB.js → useSSE-Bf5LOLSi.js} +2 -2
  105. package/extensions/dashboard-client/dist/assets/{useSSE-BBYt5UPB.js.map → useSSE-Bf5LOLSi.js.map} +1 -1
  106. package/extensions/dashboard-client/dist/index.html +2 -2
  107. package/extensions/dashboard-client/src/App.tsx +28 -8
  108. package/extensions/dashboard-client/src/api/client.ts +29 -0
  109. package/extensions/dashboard-client/src/components/ActiveReposTable.tsx +21 -12
  110. package/extensions/dashboard-client/src/components/CacheHitRateTrendCard.tsx +100 -0
  111. package/extensions/dashboard-client/src/components/ProviderCacheCard.tsx +56 -0
  112. package/extensions/dashboard-client/src/components/SavingsByModelTable.tsx +38 -57
  113. package/extensions/dashboard-client/src/components/StripeDistributionCard.tsx +110 -0
  114. package/extensions/dashboard-client/src/components/TabBar.tsx +49 -4
  115. package/extensions/dashboard-client/src/main.tsx +1 -0
  116. package/extensions/dashboard-client/src/styles/base.css +30 -0
  117. package/extensions/dashboard-client/src/styles/cache.css +167 -0
  118. package/extensions/dashboard-client/src/tabs/CacheTab.tsx +75 -12
  119. package/extensions/dashboard-client/src/tabs/MemoryMapTab.tsx +440 -0
  120. package/extensions/dashboard-client/src/tabs/SetupTab.tsx +418 -0
  121. package/extensions/dashboard-client/tsconfig.json +3 -2
  122. package/extensions/dashboard-client/vite.config.ts +2 -0
  123. package/extensions/dashboard-server/api-contracts/cache-stripes.ts +49 -0
  124. package/extensions/dashboard-server/api-contracts/endpoints.ts +66 -3
  125. package/extensions/dashboard-server/api-contracts/index.ts +22 -0
  126. package/extensions/dashboard-server/api-contracts/memory-map.ts +50 -0
  127. package/extensions/dashboard-server/api-contracts/memory.ts +27 -0
  128. package/extensions/dashboard-server/api-contracts/multi-repo.ts +231 -231
  129. package/extensions/dashboard-server/api-contracts/provider-cache.ts +37 -0
  130. package/extensions/dashboard-server/api-contracts/setup.ts +80 -0
  131. package/extensions/dashboard-server/index-reader.ts +138 -121
  132. package/extensions/dashboard-server/routes-cache.ts +186 -75
  133. package/extensions/dashboard-server/routes-game.ts +3 -0
  134. package/extensions/dashboard-server/routes-memory-map.ts +105 -0
  135. package/extensions/dashboard-server/routes-memory.ts +63 -0
  136. package/extensions/dashboard-server/routes-repo.ts +36 -36
  137. package/extensions/dashboard-server/routes-setup.ts +293 -0
  138. package/extensions/dashboard-server/routes.ts +4 -0
  139. package/extensions/dashboard-server/server.ts +12 -0
  140. package/extensions/mega-commands.ts +211 -1
  141. package/extensions/mega-compact.ts +5 -0
  142. package/extensions/mega-config.ts +27 -0
  143. package/extensions/mega-events/agent-handlers.ts +20 -4
  144. package/extensions/mega-events/compact-handlers.ts +1 -0
  145. package/extensions/mega-events/context-handler.ts +53 -110
  146. package/extensions/mega-events/context-hwm.ts +85 -0
  147. package/extensions/mega-events/error-classifier.ts +15 -4
  148. package/extensions/mega-events/mirror-append.ts +155 -0
  149. package/extensions/mega-events/outage-advisor.ts +11 -5
  150. package/extensions/mega-events/perf-handler.ts +190 -6
  151. package/extensions/mega-events/recall-tail.ts +88 -0
  152. package/extensions/mega-events/separated-prompt.ts +329 -0
  153. package/extensions/mega-events/session-handlers.ts +14 -7
  154. package/extensions/mega-runtime/env-loader.ts +55 -0
  155. package/extensions/mega-runtime/helpers.ts +14 -0
  156. package/extensions/mega-runtime/reset-runtime.ts +6 -0
  157. package/extensions/mega-runtime/runtime-snapshot.ts +1 -0
  158. package/extensions/mega-runtime/runtime.ts +7 -0
  159. package/extensions/mega-runtime/snapshot.ts +6 -0
  160. package/extensions/mega-runtime/widget-types.ts +3 -0
  161. package/extensions/mega-runtime/widget.ts +5 -0
  162. package/package.json +5 -2
  163. package/src/cache-stripe-impl.ts +385 -0
  164. package/src/cache-stripe.ts +18 -0
  165. package/src/config/stopwords.ts +25 -0
  166. package/src/config.ts +26 -0
  167. package/src/embedder.ts +42 -2
  168. package/src/memoryGraph.ts +438 -0
  169. package/src/memoryStats.ts +107 -0
  170. package/src/monitoring.ts +35 -0
  171. package/src/prefix-break.ts +83 -0
  172. package/src/pricing.ts +2 -2
  173. package/src/queryExpansion.ts +206 -0
  174. package/src/queryReformulation/cache.ts +169 -0
  175. package/src/queryReformulation/rrf.ts +51 -0
  176. package/src/queryReformulation/tfidf.ts +79 -0
  177. package/src/queryReformulation/vagueness.ts +38 -0
  178. package/src/queryReformulation.ts +355 -0
  179. package/src/recallMetrics.ts +388 -0
  180. package/src/store/sqlite/cache-stripes.ts +196 -0
  181. package/src/store/sqlite/fts5-search.ts +90 -0
  182. package/src/store/sqlite/perf-samples.ts +218 -23
  183. package/src/store/sqlite/schema.ts +60 -1
  184. package/src/store/sqlite.ts +1 -0
  185. package/src/store/turns/memory-store.ts +10 -1
  186. package/src/store/turns/sqlite-store.ts +27 -15
  187. package/src/store/turns/types.ts +21 -0
  188. package/src/store/vectorIndex.ts +71 -11
  189. package/src/tiered-router/types.ts +64 -0
  190. package/src/tieredRouter.ts +489 -0
  191. package/src/vectorStore.ts +9 -5
  192. package/dist/extensions/conflict-scan.test.js +0 -115
  193. package/dist/extensions/dashboard-server/api-contracts.test.js +0 -884
  194. package/dist/extensions/dashboard-server/html.test.js +0 -52
  195. package/dist/extensions/dashboard-server/perf-server.test.js +0 -80
  196. package/dist/extensions/dashboard-server/routes-cache.test.js +0 -248
  197. package/dist/extensions/dashboard-server/server.test.js +0 -120
  198. package/dist/extensions/dashboard-server-s32.test.js +0 -181
  199. package/dist/extensions/dashboard-server.test.js +0 -339
  200. package/dist/extensions/mega-cache-replay.test.js +0 -400
  201. package/dist/extensions/mega-compact-s38.test.js +0 -1383
  202. package/dist/extensions/mega-compact.test.js +0 -1112
  203. package/dist/extensions/mega-events.test.js +0 -47
  204. package/dist/extensions/mega-game-cmds.test.js +0 -163
  205. package/dist/extensions/mega-runtime/snapshot.test.js +0 -127
  206. package/dist/extensions/mega-runtime/state.test.js +0 -266
  207. package/dist/extensions/mega-runtime/widget.test.js +0 -343
  208. package/dist/extensions/mega-shutdown-widget.test.js +0 -121
  209. package/dist/extensions/mega-teamrun.test.js +0 -156
  210. package/dist/extensions/mega-trim.test.js +0 -58
  211. package/dist/extensions/mega-turn-store.test.js +0 -68
  212. package/dist/src/boundary.test.js +0 -170
  213. package/dist/src/compact.test.js +0 -78
  214. package/dist/src/config/themes.test.js +0 -94
  215. package/dist/src/dedup/dedup.test.js +0 -41
  216. package/dist/src/dedup/l1.test.js +0 -50
  217. package/dist/src/dedup/raptor/buildHistory.test.js +0 -292
  218. package/dist/src/dedup/raptor/multilevel-serve.test.js +0 -229
  219. package/dist/src/dedup/raptor/multilevel.test.js +0 -238
  220. package/dist/src/dedup/raptor/promote.test.js +0 -69
  221. package/dist/src/dedup/raptor/raptor.test.js +0 -248
  222. package/dist/src/dedup/raptor/retrieval.test.js +0 -95
  223. package/dist/src/dedup/raptor/serve-gate.test.js +0 -298
  224. package/dist/src/dedup/sprint12.test.js +0 -219
  225. package/dist/src/dedup-engine.test.js +0 -472
  226. package/dist/src/driftDetection.test.js +0 -87
  227. package/dist/src/e2e.test.js +0 -698
  228. package/dist/src/engine.test.js +0 -111
  229. package/dist/src/extractive.test.js +0 -147
  230. package/dist/src/fork.test.js +0 -81
  231. package/dist/src/game/scoring.test.js +0 -98
  232. package/dist/src/httpEmbedder.test.js +0 -277
  233. package/dist/src/importance.test.js +0 -372
  234. package/dist/src/intent.test.js +0 -78
  235. package/dist/src/log.test.js +0 -42
  236. package/dist/src/mechanical-fix.test.js +0 -65
  237. package/dist/src/memory.test.js +0 -70
  238. package/dist/src/memoryConsolidate.test.js +0 -38
  239. package/dist/src/memoryOps.test.js +0 -129
  240. package/dist/src/memoryRecall.test.js +0 -171
  241. package/dist/src/memoryRoundtrip.test.js +0 -137
  242. package/dist/src/metrics/turns.test.js +0 -152
  243. package/dist/src/mirror/mirror.test.js +0 -185
  244. package/dist/src/raptor-inject-summaries.test.js +0 -162
  245. package/dist/src/ratio.bench.test.js +0 -897
  246. package/dist/src/recall.integration.test.js +0 -77
  247. package/dist/src/recall.test.js +0 -379
  248. package/dist/src/sprint14.test.js +0 -219
  249. package/dist/src/sprint4x-rag-verification.test.js +0 -93
  250. package/dist/src/store/compression.test.js +0 -139
  251. package/dist/src/store/memoryIndex.test.js +0 -51
  252. package/dist/src/store/migrate.test.js +0 -139
  253. package/dist/src/store/pgOpenGuard.test.js +0 -74
  254. package/dist/src/store/phase01.test.js +0 -81
  255. package/dist/src/store/phase04.test.js +0 -54
  256. package/dist/src/store/sprint10.test.js +0 -186
  257. package/dist/src/store/sqlite/game-achievements.test.js +0 -67
  258. package/dist/src/store/sqlite/game-scores.test.js +0 -106
  259. package/dist/src/store/sqlite/game-state.test.js +0 -76
  260. package/dist/src/store/sqlite/global-index.test.js +0 -136
  261. package/dist/src/store/sqlite/mechanical-fix.test.js +0 -146
  262. package/dist/src/store/sqlite/perf-samples.test.js +0 -146
  263. package/dist/src/store/sqlite/raptor.test.js +0 -106
  264. package/dist/src/store/sqlite/turns.test.js +0 -183
  265. package/dist/src/store/sqlite.cachehit.test.js +0 -55
  266. package/dist/src/store/sqlite.dbmaint.test.js +0 -158
  267. package/dist/src/store/sqlite.dbmirror.test.js +0 -184
  268. package/dist/src/store/turns/contract-compliance.test.js +0 -428
  269. package/dist/src/store/turns/memory-store.test.js +0 -9
  270. package/dist/src/store/turns/migrations.test.js +0 -138
  271. package/dist/src/store/turns/sqlite-store.test.js +0 -144
  272. package/dist/src/store/vectorIndex.test.js +0 -123
  273. package/dist/src/store.test.js +0 -161
  274. package/dist/src/supersede.test.js +0 -36
  275. package/dist/src/topics/cluster.test.js +0 -150
  276. package/dist/src/topics/store.test.js +0 -117
  277. package/dist/src/types.test.js +0 -9
  278. package/dist/src/vector-search-cache.test.js +0 -157
  279. package/dist/src/vectorStore.test.js +0 -479
  280. package/dist/src/wiki.test.js +0 -171
  281. package/extensions/conflict-scan.test.ts +0 -129
  282. package/extensions/dashboard-client/dist/assets/AchievementsTab-DjxfYrDc.js +0 -2
  283. package/extensions/dashboard-client/dist/assets/CacheTab-Dnpv94wq.js +0 -2
  284. package/extensions/dashboard-client/dist/assets/CacheTab-Dnpv94wq.js.map +0 -1
  285. package/extensions/dashboard-client/dist/assets/GameTab-BLDudcO5.js +0 -2
  286. package/extensions/dashboard-client/dist/assets/OverviewTab-D4kGvsiQ.js +0 -2
  287. package/extensions/dashboard-client/dist/assets/ReposTab-C0Wnrf2u.js +0 -2
  288. package/extensions/dashboard-client/dist/assets/ReposTab-C0Wnrf2u.js.map +0 -1
  289. package/extensions/dashboard-client/dist/assets/TimeSavedCard-UqljSyP-.js +0 -2
  290. package/extensions/dashboard-client/dist/assets/TimeSavedCard-UqljSyP-.js.map +0 -1
  291. package/extensions/dashboard-client/dist/assets/index-BEdKlpAB.css +0 -1
  292. package/extensions/dashboard-client/dist/assets/index-BX0bcgLu.js +0 -42
  293. package/extensions/dashboard-client/dist/assets/index-BX0bcgLu.js.map +0 -1
  294. package/extensions/dashboard-server/api-contracts.test.ts +0 -1065
  295. package/extensions/dashboard-server/html.test.ts +0 -62
  296. package/extensions/dashboard-server/perf-server.test.ts +0 -101
  297. package/extensions/dashboard-server/routes-cache.test.ts +0 -302
  298. package/extensions/dashboard-server/server.test.ts +0 -131
  299. package/extensions/dashboard-server-s32.test.ts +0 -195
  300. package/extensions/dashboard-server.test.ts +0 -382
  301. package/extensions/mega-cache-replay.test.ts +0 -526
  302. package/extensions/mega-compact-s38.test.ts +0 -1433
  303. package/extensions/mega-compact.test.ts +0 -1509
  304. package/extensions/mega-events.test.ts +0 -55
  305. package/extensions/mega-game-cmds.test.ts +0 -197
  306. package/extensions/mega-runtime/snapshot.test.ts +0 -139
  307. package/extensions/mega-runtime/state.test.ts +0 -262
  308. package/extensions/mega-runtime/widget.test.ts +0 -468
  309. package/extensions/mega-shutdown-widget.test.ts +0 -141
  310. package/extensions/mega-teamrun.test.ts +0 -176
  311. package/extensions/mega-trim.test.ts +0 -64
  312. package/extensions/mega-turn-store.test.ts +0 -108
  313. package/src/boundary.test.ts +0 -187
  314. package/src/compact.test.ts +0 -99
  315. package/src/config/themes.test.ts +0 -116
  316. package/src/dedup/dedup.test.ts +0 -46
  317. package/src/dedup/l1.test.ts +0 -57
  318. package/src/dedup/raptor/buildHistory.test.ts +0 -353
  319. package/src/dedup/raptor/multilevel-serve.test.ts +0 -273
  320. package/src/dedup/raptor/multilevel.test.ts +0 -325
  321. package/src/dedup/raptor/promote.test.ts +0 -82
  322. package/src/dedup/raptor/raptor.test.ts +0 -297
  323. package/src/dedup/raptor/retrieval.test.ts +0 -118
  324. package/src/dedup/raptor/serve-gate.test.ts +0 -348
  325. package/src/dedup/sprint12.test.ts +0 -242
  326. package/src/dedup-engine.test.ts +0 -670
  327. package/src/driftDetection.test.ts +0 -100
  328. package/src/e2e.test.ts +0 -843
  329. package/src/engine.test.ts +0 -123
  330. package/src/extractive.test.ts +0 -174
  331. package/src/fork.test.ts +0 -94
  332. package/src/game/scoring.test.ts +0 -103
  333. package/src/httpEmbedder.test.ts +0 -286
  334. package/src/importance.test.ts +0 -538
  335. package/src/intent.test.ts +0 -87
  336. package/src/log.test.ts +0 -47
  337. package/src/mechanical-fix.test.ts +0 -70
  338. package/src/memory.test.ts +0 -92
  339. package/src/memoryConsolidate.test.ts +0 -47
  340. package/src/memoryOps.test.ts +0 -148
  341. package/src/memoryRecall.test.ts +0 -194
  342. package/src/memoryRoundtrip.test.ts +0 -155
  343. package/src/metrics/turns.test.ts +0 -165
  344. package/src/mirror/mirror.test.ts +0 -240
  345. package/src/raptor-inject-summaries.test.ts +0 -228
  346. package/src/ratio.bench.test.ts +0 -1316
  347. package/src/recall.integration.test.ts +0 -96
  348. package/src/recall.test.ts +0 -467
  349. package/src/sprint14.test.ts +0 -245
  350. package/src/sprint4x-rag-verification.test.ts +0 -119
  351. package/src/store/compression.test.ts +0 -168
  352. package/src/store/memoryIndex.test.ts +0 -61
  353. package/src/store/migrate.test.ts +0 -158
  354. package/src/store/pgOpenGuard.test.ts +0 -89
  355. package/src/store/phase01.test.ts +0 -88
  356. package/src/store/phase04.test.ts +0 -58
  357. package/src/store/sprint10.test.ts +0 -214
  358. package/src/store/sqlite/game-achievements.test.ts +0 -80
  359. package/src/store/sqlite/game-scores.test.ts +0 -132
  360. package/src/store/sqlite/game-state.test.ts +0 -89
  361. package/src/store/sqlite/global-index.test.ts +0 -222
  362. package/src/store/sqlite/mechanical-fix.test.ts +0 -162
  363. package/src/store/sqlite/perf-samples.test.ts +0 -169
  364. package/src/store/sqlite/raptor.test.ts +0 -139
  365. package/src/store/sqlite/turns.test.ts +0 -218
  366. package/src/store/sqlite.cachehit.test.ts +0 -68
  367. package/src/store/sqlite.dbmaint.test.ts +0 -193
  368. package/src/store/sqlite.dbmirror.test.ts +0 -229
  369. package/src/store/turns/contract-compliance.test.ts +0 -562
  370. package/src/store/turns/memory-store.test.ts +0 -15
  371. package/src/store/turns/migrations.test.ts +0 -161
  372. package/src/store/turns/sqlite-store.test.ts +0 -161
  373. package/src/store/vectorIndex.test.ts +0 -140
  374. package/src/store.test.ts +0 -191
  375. package/src/supersede.test.ts +0 -42
  376. package/src/topics/cluster.test.ts +0 -176
  377. package/src/topics/store.test.ts +0 -132
  378. package/src/types.test.ts +0 -10
  379. package/src/vector-search-cache.test.ts +0 -190
  380. package/src/vectorStore.test.ts +0 -533
  381. package/src/wiki.test.ts +0 -217
@@ -0,0 +1,438 @@
1
+ /**
2
+ * memoryGraph.ts — S46 visual memory map: build a graph of graphs.
3
+ *
4
+ * Nodes = checkpoints (with optional RAPTOR level annotations).
5
+ * Edges = temporal adjacency, semantic similarity (cosine above threshold), and
6
+ * RAPTOR parent–child links.
7
+ *
8
+ * pi-agnostic (no pi runtime types). Zero network calls (PREVENT-PI-004).
9
+ * Synchronous read-only interface — non-fatal on store errors.
10
+ *
11
+ * Re-exports the public types as both MemoryGraph* and shorter aliases
12
+ * (GraphNode, GraphEdge, GraphMetadata) so dashboard api-contracts can import
13
+ * from the canonical source.
14
+ */
15
+ import { getStateDir, normalizeSessionId } from "./store.js";
16
+ import { openStore, decodeEmbedding } from "./store/sqlite/utils.js";
17
+ import { listRaptorNodes } from "./store/sqlite/raptor.js";
18
+ import { Logger } from "./log.js";
19
+ const log = new Logger();
20
+
21
+ // ---------------------------------------------------------------------------
22
+ // Types
23
+ // ---------------------------------------------------------------------------
24
+
25
+ /** A node in the memory graph represents one checkpoint (potentially with
26
+ * RAPTOR level information if it participates in a RAPTOR tree). */
27
+ export interface MemoryGraphNode {
28
+ id: string;
29
+ sessionId: string;
30
+ label: string;
31
+ summaryTruncated: string;
32
+ tokenEstimate: number;
33
+ /** Unix-epoch ms (from checkpoint timestamp or created_at). */
34
+ timestamp: number;
35
+ dedupStatus: string | undefined;
36
+ /** 0 = no RAPTOR parent; 1+ = RAPTOR cluster level. */
37
+ raptorLevel: number;
38
+ topicSummary: string | undefined;
39
+ decisionCount: number;
40
+ /** First ~200 chars of the checkpoint summary/text for inline preview. */
41
+ textSnippet: string;
42
+ }
43
+
44
+ /** Edge types indicate the *reason* two nodes are connected. */
45
+ export type MemoryGraphEdgeType = "temporal" | "semantic" | "raptor_parent";
46
+
47
+ export interface MemoryGraphEdge {
48
+ source: string;
49
+ target: string;
50
+ weight: number;
51
+ type: MemoryGraphEdgeType;
52
+ }
53
+
54
+ export interface MemoryGraphMetadata {
55
+ sessionCount: number;
56
+ totalCheckpoints: number;
57
+ totalEdges: number;
58
+ semanticEdgeCount: number;
59
+ temporalEdgeCount: number;
60
+ raptorEdgeCount: number;
61
+ similarityThresholdUsed: number;
62
+ builtAt: number;
63
+ }
64
+
65
+ /** The complete memory graph returned by buildMemoryGraph. */
66
+ export interface MemoryGraph {
67
+ nodes: MemoryGraphNode[];
68
+ edges: MemoryGraphEdge[];
69
+ metadata: MemoryGraphMetadata;
70
+ }
71
+
72
+ // ---------------------------------------------------------------------------
73
+ // Short aliases for dashboard api-contracts import convenience
74
+ // ---------------------------------------------------------------------------
75
+
76
+ export type GraphNode = MemoryGraphNode;
77
+ export type GraphEdge = MemoryGraphEdge;
78
+ export type GraphMetadata = MemoryGraphMetadata;
79
+
80
+ /** Options to configure graph construction. */
81
+ export interface MemoryGraphOptions {
82
+ /** Similarity threshold for semantic edges (cosine). Default 0.7. */
83
+ similarityThreshold?: number;
84
+ /** Maximum number of semantic edges per node (avoids dense clique). Default 4. */
85
+ maxEdgesPerNode?: number;
86
+ /** Optional session filter — undefined = all sessions. */
87
+ sessionId?: string;
88
+ /** State directory (defaults to getStateDir()). */
89
+ stateDir?: string;
90
+ /** Include RAPTOR parent–child edges when available. Default true. */
91
+ includeRaptorEdges?: boolean;
92
+ /** Include temporal adjacency edges (consecutive checkpoints in same session). Default true. */
93
+ includeTemporalEdges?: boolean;
94
+ }
95
+
96
+ // ---------------------------------------------------------------------------
97
+ // Defaults
98
+ // ---------------------------------------------------------------------------
99
+
100
+ const DEFAULT_SIMILARITY_THRESHOLD = 0.7;
101
+ const DEFAULT_MAX_EDGES_PER_NODE = 4;
102
+
103
+ // ---------------------------------------------------------------------------
104
+ // Public API
105
+ // ---------------------------------------------------------------------------
106
+
107
+ /**
108
+ * Build a memory graph from the store.
109
+ *
110
+ * Opens the SQLite store, reads all (or session-filtered) checkpoints,
111
+ * computes cosine similarity edges, temporal edges, and RAPTOR parent edges.
112
+ * Returns a MemoryGraph or an empty graph on failure (non-fatal).
113
+ */
114
+ export function buildMemoryGraph(opts: MemoryGraphOptions = {}): MemoryGraph {
115
+ const {
116
+ similarityThreshold = DEFAULT_SIMILARITY_THRESHOLD,
117
+ maxEdgesPerNode = DEFAULT_MAX_EDGES_PER_NODE,
118
+ sessionId,
119
+ stateDir = getStateDir(),
120
+ includeRaptorEdges = true,
121
+ includeTemporalEdges = true,
122
+ } = opts;
123
+
124
+ const builtAt = Date.now();
125
+
126
+ try {
127
+ const nodes = loadNodes(sessionId, stateDir);
128
+ const nodeIndex = buildNodeIndex(nodes);
129
+ const edges: MemoryGraphEdge[] = [];
130
+
131
+ // Temporal edges: consecutive checkpoints within the same session
132
+ if (includeTemporalEdges) {
133
+ edges.push(...buildTemporalEdges(nodes));
134
+ }
135
+
136
+ // Semantic edges: cosine similarity above threshold
137
+ edges.push(...buildSemanticEdges(nodes, nodeIndex, similarityThreshold, maxEdgesPerNode));
138
+
139
+ // RAPTOR parent–child edges
140
+ if (includeRaptorEdges) {
141
+ edges.push(...buildRaptorEdges(nodes, sessionId, stateDir, nodeIndex));
142
+ }
143
+
144
+ // Deduplicate edges (keep highest weight for each source-target pair)
145
+ const dedupedEdges = deduplicateEdges(edges);
146
+
147
+ // Count sessions
148
+ const sessionSet = new Set<string>();
149
+ for (const n of nodes) {
150
+ sessionSet.add(n.sessionId);
151
+ }
152
+
153
+ const meta: MemoryGraphMetadata = {
154
+ sessionCount: sessionSet.size,
155
+ totalCheckpoints: nodes.length,
156
+ totalEdges: dedupedEdges.length,
157
+ semanticEdgeCount: dedupedEdges.filter((e) => e.type === "semantic").length,
158
+ temporalEdgeCount: dedupedEdges.filter((e) => e.type === "temporal").length,
159
+ raptorEdgeCount: dedupedEdges.filter((e) => e.type === "raptor_parent").length,
160
+ similarityThresholdUsed: similarityThreshold,
161
+ builtAt,
162
+ };
163
+
164
+ return { nodes, edges: dedupedEdges, metadata: meta };
165
+ } catch (err) {
166
+ log.warn("buildMemoryGraph failed", { error: String(err) });
167
+ return {
168
+ nodes: [],
169
+ edges: [],
170
+ metadata: {
171
+ sessionCount: 0,
172
+ totalCheckpoints: 0,
173
+ totalEdges: 0,
174
+ semanticEdgeCount: 0,
175
+ temporalEdgeCount: 0,
176
+ raptorEdgeCount: 0,
177
+ similarityThresholdUsed: similarityThreshold,
178
+ builtAt,
179
+ },
180
+ };
181
+ }
182
+ }
183
+
184
+ // ---------------------------------------------------------------------------
185
+ // Node loading
186
+ // ---------------------------------------------------------------------------
187
+
188
+ function loadNodes(sessionId: string | undefined, stateDir: string): MemoryGraphNode[] {
189
+ const db = openStore(stateDir);
190
+
191
+ const sql = sessionId
192
+ ? "SELECT * FROM context_chunks WHERE session_id = ? ORDER BY id ASC"
193
+ : "SELECT * FROM context_chunks ORDER BY session_id, id ASC";
194
+
195
+ const rows = sessionId
196
+ ? (db.prepare(sql).all(normalizeSessionId(sessionId)) as any[])
197
+ : (db.prepare(sql).all() as any[]);
198
+
199
+ return rows.map(rowToGraphNode);
200
+ }
201
+
202
+ function rowToGraphNode(row: any): MemoryGraphNode {
203
+ const summary = row.summary ?? "";
204
+ return {
205
+ id: row.id,
206
+ sessionId: row.session_id,
207
+ label: row.id,
208
+ summaryTruncated: summary.length > 200 ? summary.slice(0, 197) + "..." : summary,
209
+ tokenEstimate: row.token_estimate ?? 0,
210
+ timestamp: row.created_at ?? Date.now(),
211
+ dedupStatus: row.dedup_status ?? undefined,
212
+ raptorLevel: 0, // enriched below if RAPTOR data exists
213
+ topicSummary: row.topic_summary ?? undefined,
214
+ decisionCount: row.key_decisions
215
+ ? safeJsonCount(row.key_decisions)
216
+ : 0,
217
+ textSnippet: summary.length > 200 ? summary.slice(0, 197) + "..." : summary,
218
+ };
219
+ }
220
+
221
+ /** Parse a JSON array stored in a text column and return its length. */
222
+ function safeJsonCount(raw: string | null | undefined): number {
223
+ if (!raw) return 0;
224
+ try {
225
+ const arr = JSON.parse(raw);
226
+ return Array.isArray(arr) ? arr.length : 0;
227
+ } catch {
228
+ return 0;
229
+ }
230
+ }
231
+
232
+ // ---------------------------------------------------------------------------
233
+ // Node index building
234
+ // ---------------------------------------------------------------------------
235
+
236
+ function buildNodeIndex(nodes: MemoryGraphNode[]): Map<string, number> {
237
+ const idx = new Map<string, number>();
238
+ nodes.forEach((n, i) => idx.set(n.id, i));
239
+ return idx;
240
+ }
241
+
242
+ // ---------------------------------------------------------------------------
243
+ // Edges: temporal
244
+ // ---------------------------------------------------------------------------
245
+
246
+ function buildTemporalEdges(nodes: MemoryGraphNode[]): MemoryGraphEdge[] {
247
+ const edges: MemoryGraphEdge[] = [];
248
+ if (nodes.length < 2) return edges;
249
+
250
+ let prev = nodes[0];
251
+ for (let i = 1; i < nodes.length; i++) {
252
+ const cur = nodes[i];
253
+ if (cur.sessionId === prev.sessionId) {
254
+ edges.push({
255
+ source: prev.id,
256
+ target: cur.id,
257
+ weight: 1.0,
258
+ type: "temporal",
259
+ });
260
+ }
261
+ prev = cur;
262
+ }
263
+ return edges;
264
+ }
265
+
266
+ // ---------------------------------------------------------------------------
267
+ // Edges: semantic (cosine similarity)
268
+ // ---------------------------------------------------------------------------
269
+
270
+ function buildSemanticEdges(
271
+ nodes: MemoryGraphNode[],
272
+ _nodeIndex: Map<string, number>,
273
+ threshold: number,
274
+ maxPerNode: number,
275
+ ): MemoryGraphEdge[] {
276
+ if (nodes.length < 2) return [];
277
+ const db = openStore();
278
+
279
+ // Retrieve embeddings from DB for each node
280
+ const embeddings = new Map<string, number[]>();
281
+ const placeholders = nodes.map(() => "?").join(",");
282
+ const ids = nodes.map((n) => n.id);
283
+ const rows = db
284
+ .prepare(`SELECT id, embedding_blob FROM context_chunks WHERE id IN (${placeholders})`)
285
+ .all(...ids) as unknown as Array<{ id: string; embedding_blob: Uint8Array | null }>;
286
+
287
+ for (const row of rows) {
288
+ const emb = decodeEmbedding(row.embedding_blob as Uint8Array | null | undefined);
289
+ if (emb.length > 0) {
290
+ embeddings.set(row.id, emb);
291
+ }
292
+ }
293
+
294
+ type EdgeCandidate = { target: string; weight: number };
295
+ const edges: MemoryGraphEdge[] = [];
296
+
297
+ for (const node of nodes) {
298
+ const aId = node.id;
299
+ const aEmb = embeddings.get(aId);
300
+ if (!aEmb) continue;
301
+
302
+ const candidates: EdgeCandidate[] = [];
303
+
304
+ for (const other of nodes) {
305
+ if (other.id === aId) continue;
306
+ // Skip if already connected via temporal or raptor edge
307
+ const bEmb = embeddings.get(other.id);
308
+ if (!bEmb) continue;
309
+
310
+ const sim = cosineSimilarity(aEmb, bEmb);
311
+ if (sim >= threshold) {
312
+ candidates.push({ target: other.id, weight: sim });
313
+ }
314
+ }
315
+
316
+ // Keep top-K highest-weight semantic neighbors
317
+ candidates.sort((a, b) => b.weight - a.weight);
318
+ const top = candidates.slice(0, maxPerNode);
319
+ for (const c of top) {
320
+ edges.push({
321
+ source: aId,
322
+ target: c.target,
323
+ weight: c.weight,
324
+ type: "semantic",
325
+ });
326
+ }
327
+ }
328
+
329
+ return edges;
330
+ }
331
+
332
+ // ---------------------------------------------------------------------------
333
+ // Edges: RAPTOR parent–child
334
+ // ---------------------------------------------------------------------------
335
+
336
+ function buildRaptorEdges(
337
+ nodes: MemoryGraphNode[],
338
+ sessionId: string | undefined,
339
+ stateDir: string,
340
+ nodeIndex: Map<string, number>,
341
+ ): MemoryGraphEdge[] {
342
+ const edges: MemoryGraphEdge[] = [];
343
+
344
+ try {
345
+ if (sessionId) {
346
+ enrichRaptorForSession(sessionId, stateDir, nodeIndex, nodes, edges);
347
+ } else {
348
+ // Load all sessions from DB
349
+ const db = openStore(stateDir);
350
+ const sessionRows = db
351
+ .prepare("SELECT DISTINCT session_id FROM raptor_nodes ORDER BY session_id")
352
+ .all() as any[];
353
+ for (const row of sessionRows) {
354
+ enrichRaptorForSession(row.session_id as string, stateDir, nodeIndex, nodes, edges);
355
+ }
356
+ }
357
+ } catch (err) {
358
+ log.warn("RAPTOR edge build failed (non-fatal)", { error: String(err) });
359
+ }
360
+
361
+ return edges;
362
+ }
363
+
364
+ function enrichRaptorForSession(
365
+ sessId: string,
366
+ stateDir: string,
367
+ nodeIndex: Map<string, number>,
368
+ nodes: MemoryGraphNode[],
369
+ edges: MemoryGraphEdge[],
370
+ ): void {
371
+ const raptorNodes = listRaptorNodes(sessId, stateDir);
372
+
373
+ for (const rn of raptorNodes) {
374
+ const idx = nodeIndex.get(rn.id);
375
+ if (idx !== undefined) {
376
+ // Annotate the graph node with the RAPTOR level
377
+ nodes[idx].raptorLevel = rn.level;
378
+ }
379
+
380
+ if (!rn.parentId) continue;
381
+ // Only create edge if both nodes are in the graph
382
+ if (nodeIndex.has(rn.id) && nodeIndex.has(rn.parentId)) {
383
+ edges.push({
384
+ source: rn.id,
385
+ target: rn.parentId,
386
+ weight: Math.max(0.1, 1.0 - rn.level * 0.1), // higher levels = weaker link
387
+ type: "raptor_parent",
388
+ });
389
+ }
390
+ }
391
+ }
392
+
393
+ // ---------------------------------------------------------------------------
394
+ // Edge deduplication
395
+ // ---------------------------------------------------------------------------
396
+
397
+ function deduplicateEdges(edges: MemoryGraphEdge[]): MemoryGraphEdge[] {
398
+ const seen = new Map<string, MemoryGraphEdge>();
399
+
400
+ for (const e of edges) {
401
+ const keyA = `${e.source}|${e.target}`;
402
+ const keyB = `${e.target}|${e.source}`;
403
+ const existing = seen.get(keyA) ?? seen.get(keyB);
404
+
405
+ if (!existing) {
406
+ seen.set(keyA, e);
407
+ } else if (e.weight > existing.weight) {
408
+ // Replace with higher-weight edge
409
+ seen.delete(keyA);
410
+ seen.delete(keyB);
411
+ seen.set(keyA, e);
412
+ }
413
+ }
414
+
415
+ return Array.from(seen.values());
416
+ }
417
+
418
+ // ---------------------------------------------------------------------------
419
+ // Cosine similarity
420
+ // ---------------------------------------------------------------------------
421
+
422
+ function cosineSimilarity(a: number[], b: number[]): number {
423
+ const len = Math.min(a.length, b.length);
424
+ if (len === 0) return 0;
425
+
426
+ let dot = 0;
427
+ let normA = 0;
428
+ let normB = 0;
429
+
430
+ for (let i = 0; i < len; i++) {
431
+ dot += a[i] * b[i];
432
+ normA += a[i] * a[i];
433
+ normB += b[i] * b[i];
434
+ }
435
+
436
+ const denom = Math.sqrt(normA) * Math.sqrt(normB);
437
+ return denom === 0 ? 0 : dot / denom;
438
+ }
@@ -0,0 +1,107 @@
1
+ /**
2
+ * memoryStats.ts — aggregate memory-store statistics (S53B).
3
+ *
4
+ * Reads from the durable SQLite memories table to produce:
5
+ * - totalMemories: all memories in the store
6
+ * - memoriesInLast30Days: memories created within the last 30 days
7
+ * - topStableMemories: top-N memories by recall count (desc)
8
+ * - avgRecallScore: mean recallCount across all memories
9
+ *
10
+ * recallCount = 1 if last_recalled_at IS NOT NULL, else 0.
11
+ * This is the durable signal from recallMemory() — a memory that was
12
+ * recalled at least once is "stable" (still relevant). The exact recall
13
+ * frequency is tracked via turn_recall rows (source='memory') for
14
+ * cross-session analysis, but the memories table provides a reliable
15
+ * on-store signal that is always present without a schema migration.
16
+ *
17
+ * Real-store only (PREVENT-PI-004). No mocks. No network.
18
+ */
19
+ import { openStore } from "./store/sqlite/utils.js";
20
+
21
+ export interface MemoryStatsResult {
22
+ totalMemories: number;
23
+ memoriesInLast30Days: number;
24
+ topStableMemories: Array<{
25
+ id: number;
26
+ text: string;
27
+ recallCount: number;
28
+ lastRecalledAt: number | null;
29
+ }>;
30
+ avgRecallScore: number;
31
+ }
32
+
33
+ export interface MemoryStatsOptions {
34
+ /** Max memories in topStableMemories (default 5). */
35
+ topN?: number;
36
+ }
37
+
38
+ /**
39
+ * Aggregate memory statistics from the SQLite store.
40
+ * Always returns a valid MemoryStatsResult; never throws.
41
+ */
42
+ export async function memoryStats(
43
+ stateDir: string,
44
+ opts: MemoryStatsOptions = {},
45
+ ): Promise<MemoryStatsResult> {
46
+ const topN = opts.topN ?? 5;
47
+ try {
48
+ const db = openStore(stateDir);
49
+ // ── totalMemories ──────────────────────────────────────────────────────
50
+ const totalRow = db
51
+ .prepare("SELECT COUNT(*) AS n FROM memories")
52
+ .get() as { n: number };
53
+ const totalMemories = totalRow.n;
54
+
55
+ // ── memoriesInLast30Days ───────────────────────────────────────────────
56
+ const thirtyDaysAgo = Math.floor(Date.now() / 1000) - 30 * 86_400;
57
+ const recentRow = db
58
+ .prepare(
59
+ "SELECT COUNT(*) AS n FROM memories WHERE created_at >= ?",
60
+ )
61
+ .get(thirtyDaysAgo) as { n: number };
62
+ const memoriesInLast30Days = recentRow.n;
63
+
64
+ // ── topStableMemories + avgRecallScore ─────────────────────────────────
65
+ // recallCount: 1 if last_recalled_at IS NOT NULL (recalled at least once),
66
+ // 0 otherwise. Stable memories score high.
67
+ const topRows = db
68
+ .prepare(
69
+ `SELECT
70
+ m.id,
71
+ m.content AS text,
72
+ m.last_recalled_at AS lastRecalledAt,
73
+ CASE WHEN m.last_recalled_at IS NOT NULL THEN 1 ELSE 0 END AS recallCount
74
+ FROM memories m
75
+ ORDER BY recallCount DESC, m.id ASC
76
+ LIMIT ?`,
77
+ )
78
+ .all(topN) as Array<Record<string, unknown>>;
79
+
80
+ // avgRecallScore = (count of recalled memories) / totalMemories.
81
+ // This represents the fraction of memories that are "stable" (recalled at least once).
82
+ const recalledRow = db
83
+ .prepare(
84
+ "SELECT COUNT(*) AS n FROM memories WHERE last_recalled_at IS NOT NULL",
85
+ )
86
+ .get() as { n: number };
87
+ const avgRecallScore =
88
+ totalMemories > 0 ? recalledRow.n / totalMemories : 0;
89
+
90
+ const topStableMemories = topRows.map((r) => ({
91
+ id: r.id as number,
92
+ text: (r.text as string) ?? "",
93
+ recallCount: (r.recallCount as number) ?? 0,
94
+ lastRecalledAt: (r.lastRecalledAt as number | null) ?? null,
95
+ }));
96
+
97
+ return { totalMemories, memoriesInLast30Days, topStableMemories, avgRecallScore };
98
+ } catch {
99
+ // Non-fatal: return zeros rather than propagating an error.
100
+ return {
101
+ totalMemories: 0,
102
+ memoriesInLast30Days: 0,
103
+ topStableMemories: [],
104
+ avgRecallScore: 0,
105
+ };
106
+ }
107
+ }
package/src/monitoring.ts CHANGED
@@ -24,6 +24,10 @@ export interface DedupDecisionEvent {
24
24
  latencyMs: number;
25
25
  /** True when this dedup was later found to be a false positive. */
26
26
  falsePositive?: boolean;
27
+ /** Cosine similarity score (L2 semantic tier) or 1 for exact match (L0/L1). */
28
+ similarityScore?: number;
29
+ /** Checkpoint ID of the matched entry. */
30
+ matchedId?: string;
27
31
  }
28
32
 
29
33
  export interface DedupMetrics {
@@ -169,3 +173,34 @@ export function defaultMetricsPath(stateDir: string = STATE_DIR_DEFAULT): string
169
173
  export function defaultEventsPath(stateDir: string = STATE_DIR_DEFAULT): string {
170
174
  return join(stateDir, "events.log");
171
175
  }
176
+
177
+ // ---------------------------------------------------------------------------
178
+ // S45 CRAG quality metrics event
179
+ // ---------------------------------------------------------------------------
180
+
181
+ export interface RecallQualityEvent {
182
+ ts: number;
183
+ sessionId: string;
184
+ tier: "CRAG";
185
+ score: number;
186
+ breakdown: { relevance: number; coverage: number; diversity: number; specificity: number };
187
+ expanded: boolean;
188
+ reRetrieved: boolean;
189
+ uncalibrated: boolean;
190
+ weights: { relevance: number; coverage: number; diversity: number; specificity: number };
191
+ note?: string;
192
+ error?: string;
193
+ }
194
+
195
+ /**
196
+ * Append a RecallQualityEvent to events.log (best-effort, non-fatal).
197
+ * Follows the same append-one-JSON-line pattern as logDecision.
198
+ */
199
+ export function logRecallQuality(path: string, ev: RecallQualityEvent): void {
200
+ try {
201
+ mkdirSync(dirname(path), { recursive: true });
202
+ appendFileSync(path, JSON.stringify(ev) + "\n", "utf-8");
203
+ } catch {
204
+ /* best-effort — never break the extension */
205
+ }
206
+ }
@@ -0,0 +1,83 @@
1
+ /**
2
+ * prefix-break.ts — S53A prefix-break classification.
3
+ *
4
+ * Classifies WHY the provider cache prefix broke on a given turn by comparing
5
+ * the break timestamp against the three candidate event timestamps with a
6
+ * configurable tolerance window.
7
+ *
8
+ * The classification is best-effort (non-fatal): null timestamps are absent,
9
+ * and a break outside all tolerance windows is classified as 'other'.
10
+ *
11
+ * Pi-agnostic: no pi runtime types, no network.
12
+ */
13
+
14
+ export interface PrefixBreakMeta {
15
+ /** Which event caused the break. */
16
+ cause: "recall" | "compaction" | "inject" | "other";
17
+ /** Confidence score 0.0–1.0 based on proximity to the matched event. */
18
+ confidence: number;
19
+ /** Cache hit % immediately before the break. */
20
+ prevHitPct: number;
21
+ /** Cache hit % of the first degraded sample. */
22
+ currHitPct: number;
23
+ /** Wall-clock ms of the break sample. */
24
+ breakAt: number;
25
+ }
26
+
27
+ export interface PrefixBreak {
28
+ id: number;
29
+ ts: number;
30
+ kind: "prefix_break";
31
+ value: number;
32
+ meta: PrefixBreakMeta;
33
+ }
34
+
35
+ /**
36
+ * Timestamps of recent events that can cause a prefix break.
37
+ * All values are wall-clock ms (Date.now()) or null if no event has occurred.
38
+ */
39
+ export interface EventTimestamps {
40
+ lastRecallAt: number | null;
41
+ lastCompactAt: number | null;
42
+ lastInjectAt: number | null;
43
+ }
44
+
45
+ /**
46
+ * Classify why the provider cache prefix broke at `breakTimestamp`.
47
+ *
48
+ * @param breakTimestamp Wall-clock ms of the cache hit % drop sample.
49
+ * @param events Recent event timestamps from the runtime.
50
+ * @param toleranceMs Max ms gap to consider a match (default 2000).
51
+ * @returns Classification result with cause + confidence.
52
+ *
53
+ * Priority: recall > compaction > inject. Confidence = 1 − (gap / (2·tolerance)),
54
+ * capped at [0.5, 1.0]. Returns 'other' when no event is within tolerance.
55
+ */
56
+ export function classifyPrefixBreak(
57
+ breakTimestamp: number,
58
+ events: EventTimestamps,
59
+ toleranceMs = 2000,
60
+ ): { cause: "recall" | "compaction" | "inject" | "other"; confidence: number } {
61
+ // Ordered by priority (recall wins if multiple match).
62
+ const candidates: Array<{
63
+ cause: "recall" | "compaction" | "inject";
64
+ ts: number | null;
65
+ }> = [
66
+ { cause: "recall", ts: events.lastRecallAt },
67
+ { cause: "compaction", ts: events.lastCompactAt },
68
+ { cause: "inject", ts: events.lastInjectAt },
69
+ ];
70
+
71
+ for (const { cause, ts } of candidates) {
72
+ if (ts == null) continue;
73
+ const gap = Math.abs(breakTimestamp - ts);
74
+ if (gap <= toleranceMs) {
75
+ // confidence = 1 − (gap / (2·tolerance)) ∈ [0.5, 1.0]
76
+ // exact match (gap=0) → 1.0; at boundary (gap=tolerance) → 0.5
77
+ const confidence = Math.max(0.5, 1 - gap / (2 * toleranceMs));
78
+ return { cause, confidence };
79
+ }
80
+ }
81
+
82
+ return { cause: "other", confidence: 0 };
83
+ }
package/src/pricing.ts CHANGED
@@ -39,7 +39,7 @@ export const MODEL_INPUT_RATES: Record<string, number> = {
39
39
  "gemini-2.0-flash": 0.1e-6,
40
40
  "deepseek-chat": 0.14e-6,
41
41
  "deepseek-reasoner": 0.55e-6,
42
- "codestral": 0.3e-6,
42
+ codestral: 0.3e-6,
43
43
  "mistral-large": 2e-6,
44
44
  "llama-3.1-405b": 1.33e-6,
45
45
  "llama-3.1-70b": 0.8e-6,
@@ -92,4 +92,4 @@ export function computeCacheSavings(
92
92
  cacheWriteCost,
93
93
  netSaved: cacheReadSaved - cacheWriteCost,
94
94
  };
95
- }
95
+ }