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,105 @@
1
+ /**
2
+ * routes-memory-map.ts — GET /api/memory-map route handler (S46).
3
+ *
4
+ * Builds a memory graph from the local SQLite store and returns it as JSON.
5
+ * Uses an inline require to the pi-agnostic src/memoryGraph.ts builder.
6
+ */
7
+ import { createRequire } from "node:module";
8
+ import type { ServerResponse, IncomingMessage } from "node:http";
9
+ import { parse as parseUrl } from "node:url";
10
+ import type { RouteContext } from "./routes-core.js";
11
+ import type { MemoryMapResponse, MemoryMapNode, MemoryMapEdgeEntry } from "./api-contracts/memory-map.js";
12
+
13
+ const _req = createRequire(import.meta.url);
14
+
15
+ // guardrails-allow PREVENT-PI-004: localhost-only dashboard API endpoint that reads from the local SQLite store — zero remote network calls.
16
+
17
+ export function handleMemoryMap(
18
+ req: IncomingMessage,
19
+ res: ServerResponse,
20
+ ctx: RouteContext,
21
+ ): boolean {
22
+ if (req.method !== "GET") return false;
23
+ const parsed = parseUrl(req.url ?? "", true);
24
+ if (parsed.pathname !== "/api/memory-map") return false;
25
+
26
+ // guardrails-allow PREVENT-PI-004: local loopback-only dashboard server — reads the local SQLite store for graph data.
27
+ const { buildMemoryGraph } = _req("../../src/memoryGraph.js") as {
28
+ buildMemoryGraph: (opts?: {
29
+ sessionId?: string;
30
+ similarityThreshold?: number;
31
+ maxEdgesPerNode?: number;
32
+ stateDir?: string;
33
+ includeRaptorEdges?: boolean;
34
+ includeTemporalEdges?: boolean;
35
+ }) => MemoryGraphReturn;
36
+ };
37
+
38
+ type MemoryGraphReturn = {
39
+ nodes: Array<{
40
+ id: string;
41
+ sessionId: string;
42
+ label: string;
43
+ summaryTruncated: string;
44
+ tokenEstimate: number;
45
+ timestamp: number;
46
+ dedupStatus: string | undefined;
47
+ raptorLevel: number;
48
+ topicSummary: string | undefined;
49
+ decisionCount: number;
50
+ textSnippet: string;
51
+ }>;
52
+ edges: Array<{
53
+ source: string;
54
+ target: string;
55
+ weight: number;
56
+ type: "temporal" | "semantic" | "raptor_parent";
57
+ }>;
58
+ metadata: {
59
+ sessionCount: number;
60
+ totalCheckpoints: number;
61
+ totalEdges: number;
62
+ semanticEdgeCount: number;
63
+ temporalEdgeCount: number;
64
+ raptorEdgeCount: number;
65
+ similarityThresholdUsed: number;
66
+ builtAt: number;
67
+ };
68
+ };
69
+
70
+ const sessionId = typeof parsed.query.sessionId === "string" ? parsed.query.sessionId : undefined;
71
+ const threshold = typeof parsed.query.threshold === "string" ? Number.parseFloat(parsed.query.threshold) : undefined;
72
+ const maxEdges = typeof parsed.query.maxEdgesPerNode === "string" ? Number.parseInt(parsed.query.maxEdgesPerNode, 10) : undefined;
73
+ const raptorEdges = parsed.query.includeRaptorEdges === "false" ? false : true;
74
+ const temporalEdges = parsed.query.includeTemporalEdges === "false" ? false : true;
75
+
76
+ const graph = buildMemoryGraph({
77
+ sessionId,
78
+ similarityThreshold: threshold,
79
+ maxEdgesPerNode: maxEdges,
80
+ stateDir: ctx.stateDir,
81
+ includeRaptorEdges: raptorEdges,
82
+ includeTemporalEdges: temporalEdges,
83
+ });
84
+
85
+ const nodes: MemoryMapNode[] = graph.nodes.map((n) => ({
86
+ id: n.id,
87
+ sessionId: n.sessionId,
88
+ label: n.label,
89
+ summaryTruncated: n.summaryTruncated,
90
+ tokenEstimate: n.tokenEstimate,
91
+ timestamp: n.timestamp,
92
+ dedupStatus: n.dedupStatus,
93
+ raptorLevel: n.raptorLevel,
94
+ topicSummary: n.topicSummary,
95
+ decisionCount: n.decisionCount,
96
+ textSnippet: n.textSnippet,
97
+ }));
98
+
99
+ const edges: MemoryMapEdgeEntry[] = graph.edges as MemoryMapEdgeEntry[];
100
+ const response: MemoryMapResponse = { nodes, edges, metadata: graph.metadata };
101
+
102
+ res.writeHead(200, { "Content-Type": "application/json" });
103
+ res.end(JSON.stringify(response));
104
+ return true;
105
+ }
@@ -0,0 +1,63 @@
1
+ /**
2
+ * dashboard-server/routes-memory.ts — Memory effectiveness stats route handler (S53B).
3
+ *
4
+ * GET /api/memory-status — Returns memoryStats() aggregated data:
5
+ * totalMemories, memoriesInLast30Days, topStableMemories, avgRecallScore.
6
+ *
7
+ * Guardrails: PREVENT-PI-004 (loopback-only), PREVENT-001 (null-safe JSON),
8
+ * PREVENT-002 (parameterized SQL — memoryStats uses openStore internally).
9
+ * Loopback-only localhost dashboard endpoint.
10
+ */
11
+
12
+ import { createRequire } from "node:module";
13
+ import type { IncomingMessage, ServerResponse } from "node:http";
14
+ import type { RouteContext } from "./routes-core.js";
15
+ import type { MemoryStatusResponse } from "./api-contracts/memory.js";
16
+
17
+ // PREVENT-PI-004: memoryStats is a pure local module (no network, no side-effects at import time).
18
+ // guardrails-allow PREVENT-PI-004: local TypeScript module import (loopback-only).
19
+ const { memoryStats } = createRequire(import.meta.url)(
20
+ "../../src/memoryStats.js",
21
+ ) as typeof import("../../src/memoryStats.js");
22
+
23
+ // ---------------------------------------------------------------------------
24
+ // handleMemoryStatus — "/api/memory-status"
25
+ // ---------------------------------------------------------------------------
26
+
27
+ export function handleMemoryStatus(
28
+ req: IncomingMessage,
29
+ res: ServerResponse,
30
+ ctx: RouteContext,
31
+ ): boolean {
32
+ if (!req.url?.startsWith("/api/memory-status")) return false;
33
+ if (req.method !== "GET") {
34
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
35
+ res.writeHead(405, { "Content-Type": "application/json" });
36
+ res.end(JSON.stringify({ error: "method_not_allowed" }));
37
+ return true;
38
+ }
39
+ // PREVENT-PI-004: loopback-only — memoryStats reads from local SQLite store.
40
+ memoryStats(ctx.stateDir)
41
+ .then((stats) => {
42
+ const body: MemoryStatusResponse = {
43
+ totalMemories: stats.totalMemories,
44
+ memoriesInLast30Days: stats.memoriesInLast30Days,
45
+ topStableMemories: stats.topStableMemories.map((m) => ({
46
+ id: m.id,
47
+ text: m.text,
48
+ recallCount: m.recallCount,
49
+ lastRecalledAt: m.lastRecalledAt,
50
+ })),
51
+ avgRecallScore: stats.avgRecallScore,
52
+ };
53
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
54
+ res.writeHead(200, { "Content-Type": "application/json" });
55
+ res.end(JSON.stringify(body));
56
+ })
57
+ .catch(() => {
58
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
59
+ res.writeHead(500, { "Content-Type": "application/json" });
60
+ res.end(JSON.stringify({ error: "memory_stats_unavailable" }));
61
+ });
62
+ return true;
63
+ }
@@ -13,7 +13,10 @@ import { ACTIVE_WINDOW_SEC } from "./types.js";
13
13
  import type { RouteContext } from "./routes-core.js";
14
14
  import type { LiveSnapshot } from "./types.js";
15
15
  import { readProviderCacheForRepo } from "../../src/store/sqlite/perf-samples.js";
16
- import { computeCacheSavings, lookupModelInputRate } from "../../src/pricing.js";
16
+ import {
17
+ computeCacheSavings,
18
+ lookupModelInputRate,
19
+ } from "../../src/pricing.js";
17
20
  import { latestModelSnapshot } from "../../src/store/sqlite/model-snapshots.js";
18
21
 
19
22
  // ---------------------------------------------------------------------------
@@ -154,43 +157,42 @@ export function handleRepoIndex(
154
157
  try {
155
158
  const p = join(r.stateDir, "dashboard.json");
156
159
  if (existsSync(p)) {
157
- const snap = JSON.parse(
158
- readFileSync(p, "utf-8"),
159
- ) as LiveSnapshot;
160
+ const snap = JSON.parse(readFileSync(p, "utf-8")) as LiveSnapshot;
160
161
  out.tier = snap.tier ?? null;
161
162
  out.contextPct =
162
163
  snap.context && snap.context.percent != null
163
164
  ? snap.context.percent
164
165
  : null;
165
166
  out.state = (snap.session && snap.session.state) || null;
166
- out.cacheHits = snap.cacheHits ?? null;
167
- out.compacts = snap.compacts ?? null;
168
- out.timeSaved = snap.timeSaved ?? null;
169
- out.updatedAt = snap.updatedAt ?? null;
170
- // Provider cache per-repo lifetime (E.2)
171
- try {
172
- const pc = readProviderCacheForRepo(r.stateDir);
173
- // Price from model snapshot if available
174
- const modelSnap = latestModelSnapshot(r.stateDir);
175
- const inputRate = modelSnap
176
- ? modelSnap.inputRate
177
- : lookupModelInputRate(r.modelName ?? "") ?? 0;
178
- const savings = computeCacheSavings(
179
- pc.totalCacheRead,
180
- pc.totalCacheWrite,
181
- inputRate,
182
- );
183
- out.providerCache = {
184
- avgHitPct: pc.avgHitPct,
185
- cacheRead: pc.totalCacheRead,
186
- cacheWrite: pc.totalCacheWrite,
187
- totalInput: pc.totalInput,
188
- sampleCount: pc.sampleCount,
189
- estimatedSaved: savings.netSaved > 0 ? savings.netSaved : null,
190
- };
191
- } catch {
192
- /* best-effort — repo may not have perf_samples */
193
- }
167
+ out.cacheHits = snap.cacheHits ?? null;
168
+ out.compacts = snap.compacts ?? null;
169
+ out.timeSaved = snap.timeSaved ?? null;
170
+ out.updatedAt = snap.updatedAt ?? null;
171
+ // Provider cache per-repo lifetime (E.2)
172
+ try {
173
+ const pc = readProviderCacheForRepo(r.stateDir);
174
+ // Price from model snapshot if available
175
+ const modelSnap = latestModelSnapshot(r.stateDir);
176
+ const inputRate = modelSnap
177
+ ? modelSnap.inputRate
178
+ : (lookupModelInputRate(r.modelName ?? "") ?? 0);
179
+ const savings = computeCacheSavings(
180
+ pc.totalCacheRead,
181
+ pc.totalCacheWrite,
182
+ inputRate,
183
+ );
184
+ out.providerCache = {
185
+ avgHitPct: pc.avgHitPct,
186
+ cacheRead: pc.totalCacheRead,
187
+ cacheWrite: pc.totalCacheWrite,
188
+ totalInput: pc.totalInput,
189
+ sampleCount: pc.sampleCount,
190
+ estimatedSaved:
191
+ savings.netSaved > 0 ? savings.netSaved : null,
192
+ };
193
+ } catch {
194
+ /* best-effort — repo may not have perf_samples */
195
+ }
194
196
  }
195
197
  } catch {
196
198
  /* best-effort */
@@ -199,9 +201,7 @@ export function handleRepoIndex(
199
201
  })
200
202
  .sort((a, b) => (b.lastSeen as number) - (a.lastSeen as number));
201
203
  res.writeHead(200, { "Content-Type": "application/json" });
202
- res.end(
203
- JSON.stringify({ updatedAt: new Date().toISOString(), servers }),
204
- );
204
+ res.end(JSON.stringify({ updatedAt: new Date().toISOString(), servers }));
205
205
  } catch {
206
206
  res.writeHead(500, { "Content-Type": "application/json" });
207
207
  res.end(JSON.stringify({ error: "servers_unavailable" }));
@@ -236,4 +236,4 @@ export function handleStatic(
236
236
  res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
237
237
  res.end(dashboardHtml(tier));
238
238
  return true;
239
- }
239
+ }
@@ -0,0 +1,293 @@
1
+ /**
2
+ * dashboard-server/routes-setup.ts — Setup wizard route handlers.
3
+ *
4
+ * GET /api/setup-status — Returns current embedder configuration from env.
5
+ * GET /api/setup-detect — Runs best-effort detection of local embedder backends.
6
+ *
7
+ * Guardrails: PREVENT-PI-004 (loopback-only), PREVENT-001 (null-safe JSON).
8
+ * The detection commands run local subprocesses via spawnSync, NOT network calls.
9
+ * Each decoration line carries a guardrails-allow annotation.
10
+ */
11
+
12
+ import { spawnSync } from "node:child_process"; // guardrails-allow PREVENT-PI-004: local subprocess detection only
13
+ import { createRequire } from "node:module";
14
+ import { writeFileSync, mkdirSync } from "node:fs";
15
+ import { join } from "node:path";
16
+ import type { IncomingMessage, ServerResponse } from "node:http";
17
+ import type { RouteContext } from "./routes-core.js";
18
+ import type {
19
+ SetupStatusResponse,
20
+ SetupDetectResponse,
21
+ SetupConfigureRequest,
22
+ SetupConfigureResponse,
23
+ DetectResult,
24
+ OllamaDetectResult,
25
+ } from "./api-contracts/setup.js";
26
+
27
+ // ---------------------------------------------------------------------------
28
+ // handleSetupStatus — "/api/setup-status"
29
+ // ---------------------------------------------------------------------------
30
+
31
+ function detectCurrentEmbedder(): SetupStatusResponse["currentEmbedder"] {
32
+ const url = process.env["MEGACOMPACT_EMBEDDING_URL"];
33
+ const minilm = process.env["MEGACOMPACT_MINILM"];
34
+ if (url && url.trim().length > 0) return "http";
35
+ if (minilm && ["1", "true", "yes"].includes(minilm.trim().toLowerCase()))
36
+ return "minilm";
37
+ return "trigram";
38
+ }
39
+
40
+ export function handleSetupStatus(
41
+ req: IncomingMessage,
42
+ res: ServerResponse,
43
+ _ctx: RouteContext,
44
+ ): boolean {
45
+ if (req.url !== "/api/setup-status") return false;
46
+ if (req.method !== "GET") {
47
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
48
+ res.writeHead(405, { "Content-Type": "application/json" });
49
+ res.end(JSON.stringify({ error: "method_not_allowed" }));
50
+ return true;
51
+ }
52
+ const body: SetupStatusResponse = {
53
+ currentEmbedder: detectCurrentEmbedder(),
54
+ embeddingUrl: process.env["MEGACOMPACT_EMBEDDING_URL"] ?? null,
55
+ embedCache: process.env["MEGACOMPACT_EMBED_CACHE"] ?? null,
56
+ minilm: ["1", "true", "yes"].includes(
57
+ (process.env["MEGACOMPACT_MINILM"] ?? "").trim().toLowerCase(),
58
+ ),
59
+ };
60
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
61
+ res.writeHead(200, { "Content-Type": "application/json" });
62
+ res.end(JSON.stringify(body));
63
+ return true;
64
+ }
65
+
66
+ // ---------------------------------------------------------------------------
67
+ // handleSetupDetect — "/api/setup-detect"
68
+ // ---------------------------------------------------------------------------
69
+
70
+ function detectOllama(): OllamaDetectResult | null {
71
+ try {
72
+ const version = spawnSync("ollama", ["--version"], {
73
+ timeout: 5000,
74
+ encoding: "utf-8",
75
+ stdio: ["ignore", "pipe", "pipe"],
76
+ });
77
+ if (version.status !== 0) {
78
+ return { installed: false, models: [], running: false, detail: version.stderr?.trim() || "not found" };
79
+ }
80
+ // Check for running server
81
+ let running = false;
82
+ let models: string[] = [];
83
+ try {
84
+ const listResult = spawnSync("ollama", ["list"], {
85
+ timeout: 5000,
86
+ encoding: "utf-8",
87
+ stdio: ["ignore", "pipe", "pipe"],
88
+ });
89
+ if (listResult.status === 0) {
90
+ running = true;
91
+ // Parse lines: NAME ID SIZE MODIFIED
92
+ const lines = listResult.stdout?.split("\n") ?? [];
93
+ for (const line of lines) {
94
+ const name = line.split(/\s+/)[0];
95
+ if (name && name !== "NAME") models.push(name);
96
+ }
97
+ }
98
+ } catch {
99
+ // ollama list failed — server may not be running
100
+ running = false;
101
+ }
102
+ return {
103
+ installed: true,
104
+ models,
105
+ running,
106
+ detail: version.stdout?.trim() || null,
107
+ };
108
+ } catch {
109
+ return { installed: false, models: [], running: false, detail: "detection error" };
110
+ }
111
+ }
112
+
113
+ function detectLlamaCpp(): DetectResult | null {
114
+ try {
115
+ const which = spawnSync("which", ["llama-server", "llama.cpp"], {
116
+ timeout: 3000,
117
+ encoding: "utf-8",
118
+ stdio: ["ignore", "pipe", "pipe"],
119
+ });
120
+ const installed = which.status === 0 && which.stdout.trim().length > 0;
121
+ return {
122
+ installed,
123
+ detail: installed ? which.stdout.trim() : null,
124
+ };
125
+ } catch {
126
+ return { installed: false, detail: "detection error" };
127
+ }
128
+ }
129
+
130
+ function detectOnnx(): DetectResult | null {
131
+ try {
132
+ // Check for onnxruntime-node in a parent node_modules
133
+ const req = createRequire(import.meta.url);
134
+ try {
135
+ req.resolve("onnxruntime-node");
136
+ return { installed: true, detail: "onnxruntime-node found in node_modules" };
137
+ } catch {
138
+ return { installed: false, detail: "onnxruntime-node not found in node_modules" };
139
+ }
140
+ } catch {
141
+ return { installed: false, detail: "detection error" };
142
+ }
143
+ }
144
+
145
+ export function handleSetupDetect(
146
+ req: IncomingMessage,
147
+ res: ServerResponse,
148
+ _ctx: RouteContext,
149
+ ): boolean {
150
+ if (req.url !== "/api/setup-detect") return false;
151
+ if (req.method !== "GET") {
152
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
153
+ res.writeHead(405, { "Content-Type": "application/json" });
154
+ res.end(JSON.stringify({ error: "method_not_allowed" }));
155
+ return true;
156
+ }
157
+ let error: string | null = null;
158
+ let ollama: OllamaDetectResult | null = null;
159
+ let llamaCpp: DetectResult | null = null;
160
+ let onnx: DetectResult | null = null;
161
+
162
+ try {
163
+ ollama = detectOllama();
164
+ } catch (e) {
165
+ error = `ollama detection failed: ${e instanceof Error ? e.message : String(e)}`;
166
+ }
167
+
168
+ try {
169
+ llamaCpp = detectLlamaCpp();
170
+ } catch (e) {
171
+ error = error ?? `llama.cpp detection failed: ${e instanceof Error ? e.message : String(e)}`;
172
+ }
173
+
174
+ try {
175
+ onnx = detectOnnx();
176
+ } catch (e) {
177
+ error = error ?? `onnx detection failed: ${e instanceof Error ? e.message : String(e)}`;
178
+ }
179
+
180
+ const body: SetupDetectResponse = { ollama, llamaCpp, onnx, error };
181
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
182
+ res.writeHead(200, { "Content-Type": "application/json" });
183
+ res.end(JSON.stringify(body));
184
+ return true;
185
+ }
186
+
187
+ // ---------------------------------------------------------------------------
188
+ // handleSetupConfigure — POST "/api/setup-configure"
189
+ // ---------------------------------------------------------------------------
190
+
191
+ const OLLAMA_DEFAULT_URL = "http://localhost:11434/api/embeddings"; // guardrails-allow PREVENT-PI-004: localhost-only config string, not a runtime fetch
192
+ const LLAMA_DEFAULT_URL = "http://localhost:8080/v1/embeddings"; // guardrails-allow PREVENT-PI-004: localhost-only config string, not a runtime fetch
193
+
194
+ function readJsonBody(
195
+ req: IncomingMessage,
196
+ cb: (
197
+ result:
198
+ | { ok: true; value: Record<string, unknown> }
199
+ | { ok: false; error: string },
200
+ ) => void,
201
+ ): void {
202
+ let body = "";
203
+ let tooBig = false;
204
+ req.on("data", (chunk: Buffer) => {
205
+ if (body.length > 65536) { tooBig = true; return; }
206
+ body += chunk.toString();
207
+ });
208
+ req.on("end", () => {
209
+ if (tooBig) return cb({ ok: false, error: "body_too_large" });
210
+ try {
211
+ const v = body ? JSON.parse(body) : {}; // PREVENT-001: parsed value type-checked below
212
+ if (typeof v !== "object" || v === null || Array.isArray(v)) {
213
+ return cb({ ok: false, error: "invalid_object" });
214
+ }
215
+ cb({ ok: true, value: v as Record<string, unknown> });
216
+ } catch {
217
+ cb({ ok: false, error: "invalid_json" });
218
+ }
219
+ });
220
+ req.on("error", () => cb({ ok: false, error: "read_error" }));
221
+ }
222
+
223
+ export function handleSetupConfigure(
224
+ req: IncomingMessage,
225
+ res: ServerResponse,
226
+ ctx: RouteContext,
227
+ ): boolean {
228
+ if (req.url !== "/api/setup-configure") return false;
229
+ if (req.method !== "POST") {
230
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
231
+ res.writeHead(405, { "Content-Type": "application/json" });
232
+ res.end(JSON.stringify({ error: "method_not_allowed" }));
233
+ return true;
234
+ }
235
+ readJsonBody(req, (parsed) => {
236
+ if (!parsed.ok) {
237
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
238
+ res.writeHead(400, { "Content-Type": "application/json" });
239
+ res.end(JSON.stringify({ error: parsed.error }));
240
+ return;
241
+ }
242
+ const body = parsed.value as unknown as SetupConfigureRequest;
243
+ const embedder = body.embedder;
244
+ if (embedder !== "ollama" && embedder !== "llama" && embedder !== "trigram") {
245
+ res.writeHead(400, { "Content-Type": "application/json" });
246
+ res.end(JSON.stringify({ error: "invalid_embedder" }));
247
+ return;
248
+ }
249
+ const url = body.url;
250
+ let resolvedUrl: string | null;
251
+ if (embedder === "ollama") resolvedUrl = typeof url === "string" && url ? url : OLLAMA_DEFAULT_URL;
252
+ else if (embedder === "llama") resolvedUrl = typeof url === "string" && url ? url : LLAMA_DEFAULT_URL;
253
+ else resolvedUrl = null;
254
+
255
+ // Write .mega-compact.env to the state dir (loaded by env-loader at next startup).
256
+ const stateDir = ctx.stateDir;
257
+ const envPath = join(stateDir, ".mega-compact.env");
258
+ const lines: string[] = [
259
+ "# Mega-Compact Embedder Configuration",
260
+ `# Configured via dashboard Setup tab at ${new Date().toISOString()}`,
261
+ ];
262
+ if (resolvedUrl) {
263
+ lines.push(`export MEGACOMPACT_EMBEDDING_URL="${resolvedUrl}"`);
264
+ } else {
265
+ lines.push("# trigram: built-in embedder, no URL needed");
266
+ lines.push("# unset MEGACOMPACT_EMBEDDING_URL (commented to override any shell-set value)");
267
+ lines.push("# export MEGACOMPACT_EMBEDDING_URL=");
268
+ }
269
+ lines.push("");
270
+ try {
271
+ mkdirSync(stateDir, { recursive: true });
272
+ writeFileSync(envPath, lines.join("\n"), "utf-8");
273
+ } catch (e) {
274
+ res.writeHead(500, { "Content-Type": "application/json" });
275
+ res.end(JSON.stringify({ error: `write_failed: ${e instanceof Error ? e.message : String(e)}` }));
276
+ return;
277
+ }
278
+ // Detect if the new config matches what's already active (no restart needed).
279
+ const currentUrl = process.env["MEGACOMPACT_EMBEDDING_URL"];
280
+ const alreadyActive = (resolvedUrl === null && !currentUrl) || (resolvedUrl !== null && currentUrl === resolvedUrl);
281
+ const resp: SetupConfigureResponse = {
282
+ embedder,
283
+ url: resolvedUrl,
284
+ envPath,
285
+ restartRequired: !alreadyActive,
286
+ alreadyActive,
287
+ };
288
+ // guardrails-allow PREVENT-PI-004: loopback dashboard response (local)
289
+ res.writeHead(200, { "Content-Type": "application/json" });
290
+ res.end(JSON.stringify(resp));
291
+ });
292
+ return true;
293
+ }
@@ -20,3 +20,7 @@ export { handleTopics } from "./routes-topics.js";
20
20
  export { handleTurns } from "./routes-turns.js";
21
21
  export { handleMaintenance } from "./routes-maintenance.js";
22
22
  export { handleProviderCache } from "./routes-cache.js";
23
+ export { handleMemoryStatus } from "./routes-memory.js";
24
+ export { handleSetupStatus, handleSetupDetect, handleSetupConfigure } from "./routes-setup.js";
25
+ export { handleMemoryMap } from "./routes-memory-map.js";
26
+ export { handleCacheStripes } from "./routes-cache.js";
@@ -38,6 +38,12 @@ import {
38
38
  handleTurns,
39
39
  handleMaintenance,
40
40
  handleProviderCache,
41
+ handleCacheStripes,
42
+ handleMemoryStatus,
43
+ handleSetupStatus,
44
+ handleSetupDetect,
45
+ handleSetupConfigure,
46
+ handleMemoryMap,
41
47
  handleStatic,
42
48
  } from "./routes.js";
43
49
 
@@ -227,6 +233,12 @@ export async function launchDashboardServer(
227
233
  if (handleTurns(req, res, ctx)) return;
228
234
  if (handleMaintenance(req, res, ctx)) return;
229
235
  if (handleProviderCache(req, res, ctx)) return;
236
+ if (handleMemoryStatus(req, res, ctx)) return;
237
+ if (handleCacheStripes(req, res, ctx)) return;
238
+ if (handleSetupStatus(req, res, ctx)) return;
239
+ if (handleSetupDetect(req, res, ctx)) return;
240
+ if (handleSetupConfigure(req, res, ctx)) return;
241
+ if (handleMemoryMap(req, res, ctx)) return;
230
242
  handleStatic(req, res, ctx);
231
243
  });
232
244