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
@@ -1,428 +0,0 @@
1
- /**
2
- * contract-compliance.test.ts — Shared compliance suite for TurnStore.
3
- *
4
- * Parameterized: takes a factory function and runs every contract assertion
5
- * against the produced store. Imported by backend-specific test files to prove
6
- * both SqliteTurnStore and InMemoryTurnStore satisfy the same contract.
7
- *
8
- * Contract guarantees tested:
9
- * 1. appendTurn returns a TurnId; getTurn round-trips
10
- * 2. appendRecall + listRecall round-trips
11
- * 3. query filters compose (AND)
12
- * 4. conversationStats aggregates correctly
13
- * 5. forkConversation creates fork lineage
14
- * 6. asReader cannot append (type-level — verified by compilation)
15
- * 7. asWriter cannot prune (type-level — verified by compilation)
16
- * 8. asAdmin can prune + checkpoint + restore
17
- * 9. checkpoint/restore round-trip is lossless
18
- * 10. close() is idempotent
19
- * 11. clear() wipes all data
20
- */
21
- import { describe, it, beforeEach, afterEach } from "node:test";
22
- import assert from "node:assert/strict";
23
- /** Helper: create a valid TurnEntry. */
24
- function makeTurn(overrides = {}) {
25
- return {
26
- conversationId: "conv_test1234",
27
- sessionId: "sess_abc",
28
- turnIndex: 0,
29
- role: "assistant",
30
- endedAt: Date.now(),
31
- ...overrides,
32
- };
33
- }
34
- /** Helper: create a valid TurnRecallEntry. */
35
- function makeRecall(turnId, overrides = {}) {
36
- return {
37
- turnId,
38
- checkpointId: "ckpt_001",
39
- score: 0.85,
40
- source: "checkpoint",
41
- ...overrides,
42
- };
43
- }
44
- /**
45
- * Run the full compliance suite against a TurnStore factory.
46
- * Backend test files call this with their constructor.
47
- */
48
- export function runComplianceSuite(name, factory, options) {
49
- describe(`${name} — TurnStore compliance`, () => {
50
- let store;
51
- beforeEach(() => {
52
- store = factory(options);
53
- });
54
- afterEach(() => {
55
- try {
56
- store.asAdmin().clear();
57
- }
58
- catch {
59
- // best-effort
60
- }
61
- try {
62
- store.close();
63
- }
64
- catch {
65
- // best-effort
66
- }
67
- });
68
- // ── 1. appendTurn + getTurn round-trip ──────────────────
69
- it("appendTurn returns a TurnId; getTurn retrieves the entry", () => {
70
- const entry = makeTurn({ turnIndex: 0 });
71
- const id = store.asWriter().appendTurn(entry);
72
- assert.ok(typeof id === "string" && id.length > 0, "TurnId is a non-empty string");
73
- const retrieved = store.asReader().getTurn(id);
74
- assert.ok(retrieved, "getTurn should return the entry");
75
- assert.equal(retrieved.conversationId, entry.conversationId);
76
- assert.equal(retrieved.turnIndex, entry.turnIndex);
77
- assert.equal(retrieved.role, entry.role);
78
- });
79
- it("appendTurn preserves optional fields", () => {
80
- const entry = makeTurn({
81
- turnIndex: 1,
82
- ctxTokens: 5000,
83
- ctxPercent: 0.65,
84
- pressureBand: "yellow",
85
- model: "claude-sonnet-4",
86
- });
87
- const id = store.asWriter().appendTurn(entry);
88
- const retrieved = store.asReader().getTurn(id);
89
- assert.ok(retrieved);
90
- assert.equal(retrieved.ctxTokens, 5000);
91
- assert.equal(retrieved.ctxPercent, 0.65);
92
- assert.equal(retrieved.pressureBand, "yellow");
93
- assert.equal(retrieved.model, "claude-sonnet-4");
94
- });
95
- // ── 2. appendRecall + listRecall round-trip ──────────────
96
- it("appendRecall + listRecall round-trips", () => {
97
- const tid = store.asWriter().appendTurn(makeTurn({ turnIndex: 0 }));
98
- const recall = makeRecall(tid, {
99
- checkpointId: "ckpt_r1",
100
- score: 0.9,
101
- source: "cluster_summary",
102
- });
103
- store.asWriter().appendRecall(recall);
104
- const results = store.asReader().listRecall(tid);
105
- assert.equal(results.length, 1);
106
- assert.equal(results[0].checkpointId, "ckpt_r1");
107
- assert.equal(results[0].score, 0.9);
108
- assert.equal(results[0].source, "cluster_summary");
109
- });
110
- it("appendRecall deduplicates on (turnId, checkpointId)", () => {
111
- const tid = store.asWriter().appendTurn(makeTurn({ turnIndex: 0 }));
112
- const r1 = makeRecall(tid, { checkpointId: "ckpt_dedup", score: 0.7 });
113
- const r2 = makeRecall(tid, { checkpointId: "ckpt_dedup", score: 0.8 });
114
- store.asWriter().appendRecall(r1);
115
- store.asWriter().appendRecall(r2);
116
- const results = store.asReader().listRecall(tid);
117
- // Either 1 (deduped) or 2 (last-write-wins) — both valid contract behaviors
118
- assert.ok(results.length >= 1 && results.length <= 2);
119
- });
120
- // ── 3. query filters compose (AND) ──────────────────────
121
- it("query with no filter returns all turns", () => {
122
- store.asWriter().appendTurn(makeTurn({ turnIndex: 0 }));
123
- store.asWriter().appendTurn(makeTurn({ turnIndex: 1 }));
124
- const results = store.asReader().query({});
125
- assert.ok(results.length >= 2);
126
- });
127
- it("query filters by conversationId", () => {
128
- store
129
- .asWriter()
130
- .appendTurn(makeTurn({ conversationId: "conv_a", turnIndex: 0 }));
131
- store
132
- .asWriter()
133
- .appendTurn(makeTurn({ conversationId: "conv_b", turnIndex: 0 }));
134
- const results = store.asReader().query({ conversationId: "conv_a" });
135
- assert.equal(results.length, 1);
136
- assert.equal(results[0].conversationId, "conv_a");
137
- });
138
- it("query filters by time range (sinceMs + untilMs)", () => {
139
- const now = Date.now();
140
- store
141
- .asWriter()
142
- .appendTurn(makeTurn({ turnIndex: 0, endedAt: now - 2000 }));
143
- store
144
- .asWriter()
145
- .appendTurn(makeTurn({ turnIndex: 1, endedAt: now - 1000 }));
146
- store.asWriter().appendTurn(makeTurn({ turnIndex: 2, endedAt: now }));
147
- const results = store.asReader().query({
148
- sinceMs: now - 1500,
149
- untilMs: now - 500,
150
- });
151
- assert.equal(results.length, 1);
152
- assert.equal(results[0].turnIndex, 1);
153
- });
154
- it("query filters by pressureBand", () => {
155
- store
156
- .asWriter()
157
- .appendTurn(makeTurn({ turnIndex: 0, pressureBand: "red" }));
158
- store
159
- .asWriter()
160
- .appendTurn(makeTurn({ turnIndex: 1, pressureBand: "green" }));
161
- const results = store.asReader().query({ pressureBand: "red" });
162
- assert.equal(results.length, 1);
163
- assert.equal(results[0].pressureBand, "red");
164
- });
165
- it("query respects limit and offset", () => {
166
- for (let i = 0; i < 5; i++) {
167
- store.asWriter().appendTurn(makeTurn({ turnIndex: i }));
168
- }
169
- const page1 = store.asReader().query({ limit: 2, offset: 0 });
170
- const page2 = store.asReader().query({ limit: 2, offset: 2 });
171
- assert.equal(page1.length, 2);
172
- assert.equal(page2.length, 2);
173
- assert.notEqual(page1[0].turnIndex, page2[0].turnIndex);
174
- });
175
- // ── 4. conversationStats ────────────────────────────────
176
- it("conversationStats aggregates correctly", () => {
177
- const now = Date.now();
178
- const convId = "conv_stats";
179
- store.asWriter().appendTurn(makeTurn({
180
- conversationId: convId,
181
- turnIndex: 0,
182
- endedAt: now - 2000,
183
- ctxPercent: 0.3,
184
- pressureBand: "green",
185
- }));
186
- store.asWriter().appendTurn(makeTurn({
187
- conversationId: convId,
188
- turnIndex: 1,
189
- endedAt: now - 1000,
190
- ctxPercent: 0.7,
191
- pressureBand: "yellow",
192
- }));
193
- store.asWriter().appendTurn(makeTurn({
194
- conversationId: convId,
195
- turnIndex: 2,
196
- endedAt: now,
197
- pressureBand: "green",
198
- }));
199
- const stats = store.asReader().conversationStats(convId);
200
- assert.equal(stats.turnCount, 3);
201
- assert.equal(stats.firstTurnAt, now - 2000);
202
- assert.equal(stats.lastTurnAt, now);
203
- assert.ok(Math.abs(stats.avgCtxPercent - 0.5) < 0.01);
204
- assert.equal(stats.pressureBands.green, 2);
205
- assert.equal(stats.pressureBands.yellow, 1);
206
- });
207
- it("conversationStats returns zeros for empty conversation", () => {
208
- const stats = store.asReader().conversationStats("conv_nonexistent");
209
- assert.equal(stats.turnCount, 0);
210
- assert.equal(stats.avgCtxPercent, 0);
211
- });
212
- // ── 5. forkConversation ─────────────────────────────────
213
- it("forkConversation creates a child conversation with fork lineage", () => {
214
- const parentId = "conv_parent";
215
- store
216
- .asWriter()
217
- .appendTurn(makeTurn({ conversationId: parentId, turnIndex: 0 }));
218
- const tid = store
219
- .asWriter()
220
- .appendTurn(makeTurn({ conversationId: parentId, turnIndex: 1 }));
221
- store
222
- .asWriter()
223
- .appendRecall(makeRecall(tid, { checkpointId: "ckpt_fork" }));
224
- const childId = store.asWriter().forkConversation(parentId, 1);
225
- assert.ok(childId.startsWith("conv_"), "child is a conversation id");
226
- assert.notEqual(childId, parentId, "child is a different conversation");
227
- const forks = store.asReader().listForks(parentId);
228
- assert.equal(forks.length, 1);
229
- assert.equal(forks[0].childConversationId, childId);
230
- assert.equal(forks[0].forkTurnIndex, 1);
231
- });
232
- it("forkConversation seeds child with parent recall", () => {
233
- const parentId = "conv_seed_parent";
234
- store.asWriter().appendTurn(makeTurn({ conversationId: parentId, turnIndex: 0 }));
235
- const tid1 = store.asWriter().appendTurn(makeTurn({ conversationId: parentId, turnIndex: 1 }));
236
- // Attach recall to the parent's turn at index 1
237
- store.asWriter().appendRecall(makeRecall(tid1, { checkpointId: "ckpt_seed1", score: 0.9, source: "checkpoint" }));
238
- store.asWriter().appendRecall(makeRecall(tid1, { checkpointId: "ckpt_seed2", score: 0.7, source: "memory" }));
239
- const childId = store.asWriter().forkConversation(parentId, 1);
240
- // The child should have a seed turn (turnIndex 0, role system)
241
- const childTurns = store.asReader().query({ conversationId: childId });
242
- assert.ok(childTurns.length >= 1, "child has at least one turn");
243
- const seedTurn = childTurns.find((t) => t.turnIndex === 0 && t.role === "system");
244
- assert.ok(seedTurn, "child has a seed turn");
245
- // The seed turn should have the parent's recall entries.
246
- // Use snapshot-based verification (position-stable IDs).
247
- const snapshot = store.asAdmin().checkpoint();
248
- const childRecallInSnapshot = snapshot.recall.filter((r) => {
249
- // The recall's turnId should point to a turn in the child conversation
250
- const turnIdx = Number(r.turnId) - 1;
251
- const turn = snapshot.turns[turnIdx];
252
- return turn && turn.conversationId === childId;
253
- });
254
- assert.equal(childRecallInSnapshot.length, 2, "child seed turn inherits both recall entries from parent");
255
- assert.ok(childRecallInSnapshot.some((r) => r.checkpointId === "ckpt_seed1"), "child has ckpt_seed1");
256
- assert.ok(childRecallInSnapshot.some((r) => r.checkpointId === "ckpt_seed2"), "child has ckpt_seed2");
257
- });
258
- // ── 6. countTurns ──────────────────────────────────────
259
- it("countTurns returns the number of turns in a conversation", () => {
260
- const convId = "conv_count";
261
- store
262
- .asWriter()
263
- .appendTurn(makeTurn({ conversationId: convId, turnIndex: 0 }));
264
- store
265
- .asWriter()
266
- .appendTurn(makeTurn({ conversationId: convId, turnIndex: 1 }));
267
- assert.equal(store.asReader().countTurns(convId), 2);
268
- assert.equal(store.asReader().countTurns("conv_nonexistent"), 0);
269
- });
270
- // ── 7. ensureConversationId ─────────────────────────────
271
- it("ensureConversationId returns same id for same session", () => {
272
- const id1 = store.asWriter().ensureConversationId("sess_test1");
273
- const id2 = store.asWriter().ensureConversationId("sess_test1");
274
- assert.equal(id1, id2, "same session should always get the same conversationId");
275
- assert.ok(id1.startsWith("conv_"), "conversationId has conv_ prefix");
276
- // After writing a turn with this session, ensureConversationId
277
- // should still return the same conversationId
278
- store.asWriter().appendTurn(makeTurn({ conversationId: id1, sessionId: "sess_test1", turnIndex: 0 }));
279
- const id3 = store.asWriter().ensureConversationId("sess_test1");
280
- assert.equal(id3, id1, "conversationId stable after turn is written");
281
- });
282
- // ── 8. prune ────────────────────────────────────────────
283
- it("prune removes old turns, respects keepMinPerConversation", () => {
284
- const convId = "conv_prune";
285
- const now = Date.now();
286
- // 5 turns, 3 are old
287
- for (let i = 0; i < 5; i++) {
288
- store.asWriter().appendTurn(makeTurn({
289
- conversationId: convId,
290
- turnIndex: i,
291
- endedAt: now - (5 - i) * 1000,
292
- }));
293
- }
294
- const report = store.asAdmin().prune({
295
- maxTurnAgeMs: 3500, // turns older than 3.5s
296
- keepMinPerConversation: 3, // keep at least 3
297
- vacuumAfterPrune: false,
298
- });
299
- // Should delete 2 (5 total - 3 minimum = 2 eligible, but only those older than cutoff)
300
- assert.ok(report.turnsRemoved >= 0, "prune report has turnsRemoved");
301
- assert.equal(store.asReader().countTurns(convId), 5 - report.turnsRemoved);
302
- });
303
- it("prune cascades recall for deleted turns", () => {
304
- const convId = "conv_prune_recall";
305
- const now = Date.now();
306
- const tid0 = store.asWriter().appendTurn(makeTurn({
307
- conversationId: convId,
308
- turnIndex: 0,
309
- endedAt: now - 10000,
310
- }));
311
- store.asWriter().appendRecall(makeRecall(tid0));
312
- store.asWriter().appendTurn(makeTurn({
313
- conversationId: convId,
314
- turnIndex: 1,
315
- endedAt: now,
316
- }));
317
- const report = store.asAdmin().prune({
318
- maxTurnAgeMs: 5000,
319
- keepMinPerConversation: 1,
320
- vacuumAfterPrune: false,
321
- });
322
- if (report.turnsRemoved > 0) {
323
- assert.ok(report.recallRemoved >= 0, "recall cascaded");
324
- }
325
- });
326
- // ── 9. checkpoint / restore round-trip ──────────────────
327
- it("checkpoint + restore is lossless", () => {
328
- const convId = "conv_snapshot";
329
- store
330
- .asWriter()
331
- .appendTurn(makeTurn({ conversationId: convId, turnIndex: 0 }));
332
- const tid = store.asWriter().appendTurn(makeTurn({
333
- conversationId: convId,
334
- turnIndex: 1,
335
- ctxTokens: 8000,
336
- ctxPercent: 0.8,
337
- pressureBand: "red",
338
- model: "test-model",
339
- }));
340
- store.asWriter().appendRecall(makeRecall(tid, {
341
- checkpointId: "ckpt_snap",
342
- score: 0.95,
343
- source: "memory",
344
- }));
345
- store.asWriter().forkConversation(convId, 1);
346
- const snapshot = store.asAdmin().checkpoint();
347
- assert.equal(snapshot.version, 1);
348
- // Fork creates a seed turn in the child, so total turns = 3
349
- assert.equal(snapshot.turns.length, 3, "2 parent + 1 child seed turn");
350
- assert.equal(snapshot.recall.length, 2, "1 parent recall + 1 child seed recall (copied from parent)");
351
- assert.equal(snapshot.forks.length, 1);
352
- // Clear and restore
353
- store.asAdmin().clear();
354
- assert.equal(store.asReader().countTurns(convId), 0);
355
- store.asAdmin().restore(snapshot);
356
- // Verify turns restored
357
- assert.equal(store.asReader().countTurns(convId), 2);
358
- // Verify turn content
359
- const turns = store.asReader().query({ conversationId: convId });
360
- assert.equal(turns.length, 2);
361
- assert.equal(turns[1].ctxTokens, 8000);
362
- assert.equal(turns[1].pressureBand, "red");
363
- assert.equal(turns[1].model, "test-model");
364
- // Verify recall restored: find the restored turn at turnIndex 1
365
- // and check its recall entries
366
- const turn1 = turns.find((t) => t.turnIndex === 1);
367
- assert.ok(turn1, "turn at index 1 should exist after restore");
368
- // We need the TurnId to query listRecall. Since restore may
369
- // remap IDs, we query by (conversationId, turnIndex) to find
370
- // the new TurnId via getTurn.
371
- //
372
- // Strategy: snapshot recall uses position-based IDs.
373
- // After restore, the turn at position 2 (index 1) should have
374
- // its recall. We can verify by taking a second checkpoint
375
- // and checking it matches the first.
376
- const snapshot2 = store.asAdmin().checkpoint();
377
- assert.equal(snapshot2.turns.length, 3, "second checkpoint has 3 turns (2 parent + 1 child seed)");
378
- assert.equal(snapshot2.recall.length, 2, "second checkpoint has 2 recall (1 parent + 1 child seed)");
379
- assert.equal(snapshot2.recall[0].checkpointId, "ckpt_snap", "recall checkpointId preserved");
380
- assert.equal(snapshot2.recall[0].score, 0.95, "recall score preserved");
381
- assert.equal(snapshot2.recall[0].source, "memory", "recall source preserved");
382
- // Verify forks restored
383
- const forks = store.asReader().listForks(convId);
384
- assert.equal(forks.length, 1);
385
- });
386
- // ── 10. close is idempotent ──────────────────────────────
387
- it("close is idempotent", () => {
388
- // Should not throw
389
- store.close();
390
- // Second close should also not throw
391
- // (create a new store for this since the old one is closed)
392
- const store2 = factory(options);
393
- store2.close();
394
- store2.close();
395
- });
396
- // ── 11. clear wipes all data ─────────────────────────────
397
- it("clear wipes all data", () => {
398
- store.asWriter().appendTurn(makeTurn({ turnIndex: 0 }));
399
- store.asAdmin().clear();
400
- assert.equal(store.asReader().query({}).length, 0, "no turns after clear");
401
- });
402
- // ── 12. Capability gating ────────────────────────────────
403
- it("asReader returns a TurnReader (type check)", () => {
404
- const reader = store.asReader();
405
- assert.equal(typeof reader.query, "function");
406
- assert.equal(typeof reader.getTurn, "function");
407
- assert.equal(typeof reader.listRecall, "function");
408
- assert.equal(typeof reader.listForks, "function");
409
- assert.equal(typeof reader.countTurns, "function");
410
- assert.equal(typeof reader.conversationStats, "function");
411
- });
412
- it("asWriter returns a TurnWriter (type check)", () => {
413
- const writer = store.asWriter();
414
- assert.equal(typeof writer.appendTurn, "function");
415
- assert.equal(typeof writer.appendRecall, "function");
416
- assert.equal(typeof writer.ensureConversationId, "function");
417
- assert.equal(typeof writer.forkConversation, "function");
418
- });
419
- it("asAdmin returns a TurnAdmin (type check)", () => {
420
- const admin = store.asAdmin();
421
- assert.equal(typeof admin.prune, "function");
422
- assert.equal(typeof admin.vacuum, "function");
423
- assert.equal(typeof admin.checkpoint, "function");
424
- assert.equal(typeof admin.restore, "function");
425
- assert.equal(typeof admin.clear, "function");
426
- });
427
- });
428
- }
@@ -1,9 +0,0 @@
1
- /**
2
- * memory-store.test.ts — InMemoryTurnStore compliance.
3
- */
4
- import { InMemoryTurnStore } from "./memory-store.js";
5
- import { runComplianceSuite } from "./contract-compliance.test.js";
6
- // Run the shared compliance suite against the in-memory backend
7
- runComplianceSuite("InMemoryTurnStore", (options) => {
8
- return new InMemoryTurnStore(options);
9
- }, { stateDir: "/tmp/turns-compliance-memory", inMemory: true });
@@ -1,138 +0,0 @@
1
- /**
2
- * migrations.test.ts — S49B main-db → turns.db migration tests.
3
- *
4
- * Seeds a legacy main sqlite.db (with S48-era turn tables + session_state
5
- * conversation pointers), then opens the turns store and asserts rows moved,
6
- * legacy dropped, and the move is idempotent + flag-gated. No network.
7
- */
8
- import { test, beforeEach, afterEach } from "node:test";
9
- import assert from "node:assert/strict";
10
- import { mkdtempSync, rmSync, mkdirSync } from "node:fs";
11
- import { tmpdir } from "node:os";
12
- import { join } from "node:path";
13
- import { DatabaseSync } from "node:sqlite";
14
- import { openTurnStore, closeTurnStore } from "./connection.js";
15
- import { TurnsConfig } from "../../config/turns.js";
16
- let tmpDir;
17
- let counter = 0;
18
- beforeEach(() => {
19
- tmpDir = mkdtempSync(join(tmpdir(), "mc-migrate-"));
20
- });
21
- afterEach(() => {
22
- rmSync(tmpDir, { recursive: true, force: true });
23
- });
24
- function stateDir() {
25
- return join(tmpDir, `run-${counter++}`);
26
- }
27
- /** Seed a legacy main db with S48-era turn tables + a conversation pointer. */
28
- function seedLegacyMainDb(dir) {
29
- mkdirSync(dir, { recursive: true });
30
- const db = new DatabaseSync(join(dir, "sqlite.db"));
31
- db.exec(`
32
- CREATE TABLE turns (
33
- id INTEGER PRIMARY KEY AUTOINCREMENT, conversation_id TEXT NOT NULL,
34
- session_id TEXT NOT NULL, turn_index INTEGER NOT NULL, role TEXT,
35
- started_at INTEGER NOT NULL, ended_at INTEGER, ctx_tokens INTEGER,
36
- ctx_percent REAL, pressure_band TEXT, model_id TEXT, epoch_id TEXT,
37
- UNIQUE(session_id, turn_index)
38
- );
39
- CREATE TABLE turn_recall (
40
- id INTEGER PRIMARY KEY AUTOINCREMENT, turn_id INTEGER NOT NULL,
41
- checkpoint_id TEXT NOT NULL, score REAL NOT NULL, source TEXT NOT NULL,
42
- raptor_level INTEGER, UNIQUE(turn_id, checkpoint_id)
43
- );
44
- CREATE TABLE conversation_branches (
45
- conversation_id TEXT PRIMARY KEY, parent_conversation_id TEXT NOT NULL,
46
- fork_turn_id INTEGER NOT NULL, created_at INTEGER NOT NULL
47
- );
48
- CREATE TABLE session_state (
49
- session_id TEXT PRIMARY KEY, injected_checkpoint_ids TEXT,
50
- stored_region_hashes TEXT, conversation_id TEXT, last_turn_id INTEGER
51
- );
52
- INSERT INTO turns (conversation_id, session_id, turn_index, started_at, ended_at, ctx_tokens)
53
- VALUES ('conv_leg', 'sess_leg', 0, 100, 200, 500);
54
- INSERT INTO turn_recall (turn_id, checkpoint_id, score, source)
55
- VALUES (1, 'cp_leg', 0.6, 'flat');
56
- INSERT INTO conversation_branches (conversation_id, parent_conversation_id, fork_turn_id, created_at)
57
- VALUES ('conv_child', 'conv_leg', 1, 300);
58
- INSERT INTO session_state (session_id, conversation_id) VALUES ('sess_leg', 'conv_leg');
59
- `);
60
- db.close();
61
- }
62
- function tableExists(db, name) {
63
- return (db
64
- .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name=?")
65
- .get(name) !== undefined);
66
- }
67
- test("fresh dir (no main db) → no-op, marks migrated", () => {
68
- const dir = stateDir();
69
- const db = openTurnStore(dir);
70
- // openTurnStore ran the migration hook; with no sqlite.db it should just mark.
71
- const row = db
72
- .prepare("SELECT value FROM turns_meta WHERE key='migrated_from_main'")
73
- .get();
74
- assert.equal(row?.value, "1");
75
- closeTurnStore(dir);
76
- });
77
- test("legacy rows moved, legacy tables dropped, conversation pointer migrated", () => {
78
- const dir = stateDir();
79
- seedLegacyMainDb(dir);
80
- const db = openTurnStore(dir); // triggers migration
81
- // Rows present in turns.db.
82
- const turns = db.prepare("SELECT * FROM turns").all();
83
- assert.equal(turns.length, 1);
84
- assert.equal(turns[0].conversation_id, "conv_leg");
85
- const recall = db.prepare("SELECT * FROM turn_recall").all();
86
- assert.equal(recall.length, 1);
87
- assert.equal(recall[0].checkpoint_id, "cp_leg");
88
- const branches = db
89
- .prepare("SELECT * FROM conversation_forks")
90
- .all();
91
- assert.equal(branches.length, 1);
92
- assert.equal(branches[0].parent_conversation_id, "conv_leg");
93
- assert.equal(branches[0].child_conversation_id, "conv_child");
94
- assert.equal(branches[0].fork_turn_index, 1);
95
- // Conversation pointer migrated to session_conversations (session_id → conversation_id).
96
- const ptr = db
97
- .prepare("SELECT conversation_id FROM session_conversations WHERE session_id='sess_leg'")
98
- .get();
99
- assert.equal(ptr?.conversation_id, "conv_leg");
100
- closeTurnStore(dir);
101
- // Legacy tables dropped from the main db.
102
- const main = new DatabaseSync(join(dir, "sqlite.db"));
103
- assert.ok(!tableExists(main, "turns"));
104
- assert.ok(!tableExists(main, "turn_recall"));
105
- assert.ok(!tableExists(main, "conversation_branches"));
106
- assert.ok(tableExists(main, "session_state")); // left intact
107
- main.close();
108
- });
109
- test("idempotent: re-open does not re-copy or re-drop", () => {
110
- const dir = stateDir();
111
- seedLegacyMainDb(dir);
112
- openTurnStore(dir);
113
- closeTurnStore(dir);
114
- // Second open — marker set, should be a no-op even though main db now lacks turn tables.
115
- const db = openTurnStore(dir);
116
- const turns = db.prepare("SELECT * FROM turns").all();
117
- assert.equal(turns.length, 1); // still exactly the migrated row, not duplicated
118
- closeTurnStore(dir);
119
- });
120
- test("flag OFF → legacy tables untouched, no marker write from hook", () => {
121
- const dir = stateDir();
122
- seedLegacyMainDb(dir);
123
- const original = TurnsConfig.TURNS_DB_ENABLED;
124
- TurnsConfig.TURNS_DB_ENABLED = false;
125
- try {
126
- const db = openTurnStore(dir);
127
- closeTurnStore(dir);
128
- void db;
129
- }
130
- finally {
131
- TurnsConfig.TURNS_DB_ENABLED = original;
132
- }
133
- // Main db turn tables must be intact (migration hook was gated off).
134
- const main = new DatabaseSync(join(dir, "sqlite.db"));
135
- assert.ok(tableExists(main, "turns"));
136
- assert.ok(tableExists(main, "conversation_branches"));
137
- main.close();
138
- });