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