ctxtop 4.0.0 → 4.1.1

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 (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,527 @@
1
+ /**
2
+ * @file src/coach/savedQuotaLedger.mjs
3
+ * Append-only `.jsonl` Saved-Quota Receipt Ledger (`horizon_ledger.jsonl`).
4
+ *
5
+ * Strict Invariant:
6
+ * - Initialized strictly at `0` tokens and `$0.00` USD (never uses the legacy `142,400` fallback bug).
7
+ * - Zero `node:sqlite` dependency; works across all Node >= 20 environments.
8
+ */
9
+
10
+ import {
11
+ path,
12
+ getCwd,
13
+ getHomeDir,
14
+ readTextSafe,
15
+ appendJsonlSafe,
16
+ recordRuntimeDiagnostic
17
+ } from '../utils/runtime.mjs';
18
+ import { calculateTurnCostUSD } from '../config/catalogLoader.mjs';
19
+
20
+ /**
21
+ * Resolves the ledger file path (`options.ledgerPath`, or `.claude/cache/horizon_ledger.jsonl`
22
+ * when `options.cwd` is provided, or `~/.claude/plugins/store/horizon_ledger.jsonl`).
23
+ *
24
+ * @param {object} [options={}]
25
+ * @returns {string}
26
+ */
27
+ export function getLedgerFilePath(options = {}) {
28
+ if (typeof options.ledgerPath === 'string' && options.ledgerPath.trim()) {
29
+ return options.ledgerPath.trim();
30
+ }
31
+ if (options.cwd) {
32
+ return path.join(options.cwd, '.claude', 'cache', 'horizon_ledger.jsonl');
33
+ }
34
+ const home = getHomeDir(options);
35
+ if (home) {
36
+ return path.join(home, '.claude', 'plugins', 'store', 'horizon_ledger.jsonl');
37
+ }
38
+ const fallbackCwd = getCwd(options);
39
+ return path.join(fallbackCwd, '.claude', 'cache', 'horizon_ledger.jsonl');
40
+ }
41
+
42
+ /**
43
+ * Reads all valid JSONL entries from the ledger file.
44
+ * Returns an empty array if the file does not exist (strictly 0 fallback).
45
+ *
46
+ * @param {object} [options={}]
47
+ * @returns {Array<object>}
48
+ */
49
+ export function readLedgerEntries(options = {}) {
50
+ const filePath = getLedgerFilePath(options);
51
+ const raw = readTextSafe(filePath, null, options);
52
+ if (!raw) {
53
+ return [];
54
+ }
55
+ try {
56
+ const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
57
+ const entries = [];
58
+ for (const line of lines) {
59
+ try {
60
+ const parsed = JSON.parse(line);
61
+ if (parsed && typeof parsed === 'object') {
62
+ entries.push(parsed);
63
+ }
64
+ } catch (err) {
65
+ recordRuntimeDiagnostic('savedQuotaLedger', 'readLedgerEntries.parseLine', err, options);
66
+ }
67
+ }
68
+ return entries;
69
+ } catch (err) {
70
+ recordRuntimeDiagnostic('savedQuotaLedger', 'readLedgerEntries', err, options);
71
+ return [];
72
+ }
73
+ }
74
+
75
+ /**
76
+ * Appends a verified savings receipt entry to `horizon_ledger.jsonl`.
77
+ *
78
+ * @param {object} receipt
79
+ * @param {string} [receipt.sessionId='default']
80
+ * @param {string} [receipt.category='CACHE_READ_DISCOUNT']
81
+ * @param {number} [receipt.savedTokens=0]
82
+ * @param {number} [receipt.savedUSD=0]
83
+ * @param {string} [receipt.modelId='claude-sonnet-5-5']
84
+ * @param {string} [receipt.detail='']
85
+ * @param {object} [options={}]
86
+ * @returns {{ ok: boolean, entry: object, filePath: string }}
87
+ */
88
+ const recordedTurnSavingsKeys = new Set();
89
+ const recordedInterventionKeys = new Set();
90
+
91
+ export const THIRTY_DAYS_MS = 30 * 24 * 60 * 60 * 1000;
92
+
93
+ /**
94
+ * Canonical 5-category Claude Code savings taxonomy for Simple View (Rank 4) and Advanced View (Section 1).
95
+ */
96
+ export const SAVINGS_BUCKETS = Object.freeze({
97
+ cacheReadDiscount: Object.freeze({
98
+ id: 'cacheReadDiscount',
99
+ label: 'Prompt Cache Read Discounts (0.10x)',
100
+ shortLabel: 'Cache Read Discounts',
101
+ rawCategories: Object.freeze(['CACHE_READ_DISCOUNT', 'CACHE_HIT_PRESERVED'])
102
+ }),
103
+ prefixBustAvoided: Object.freeze({
104
+ id: 'prefixBustAvoided',
105
+ label: 'Warm-Prefix & Cross-Model Busts Avoided (C*)',
106
+ shortLabel: 'Prefix Busts Avoided',
107
+ rawCategories: Object.freeze([
108
+ 'COLD_PREFILL_AVOIDED',
109
+ 'MODEL_SWITCH_DEFERRED',
110
+ 'PREFIX_MUTATION_DEFERRED',
111
+ 'POST_COMPACT_MUTATION_RELEASE',
112
+ 'COMPACT_STATE_BATON',
113
+ 'DET_08_MODEL_SWITCH_HOLD',
114
+ 'DET_09_PREFIX_FENCE'
115
+ ])
116
+ }),
117
+ toolOutputCompressed: Object.freeze({
118
+ id: 'toolOutputCompressed',
119
+ label: 'Lossless PostToolUse Sanitizer & >4k Offloads',
120
+ shortLabel: 'Tool Output Sanitized',
121
+ rawCategories: Object.freeze([
122
+ 'LOSSLESS_POST_SANITIZER',
123
+ 'ARTIFACT_OFFLOAD_4K',
124
+ 'TOOL_OUTPUT_COMPRESSED'
125
+ ])
126
+ }),
127
+ loopAndReadGuarded: Object.freeze({
128
+ id: 'loopAndReadGuarded',
129
+ label: 'Loop, Bounded-Read & Quota Interventions',
130
+ shortLabel: 'Loop & Read Guards',
131
+ rawCategories: Object.freeze([
132
+ 'LOOP_TURN_PREVENTED',
133
+ 'BOUNDED_READ_ENFORCED',
134
+ 'TTL_EXPIRY_HOLD',
135
+ 'SCOPE_QUOTA_BRAKE',
136
+ 'DET_06_LOOP_BREAKER',
137
+ 'DET_10_TTL_HOLD',
138
+ 'DET_11_BOUNDED_READ',
139
+ 'DET_20_SCOPE_BRAKE',
140
+ 'PROMPT_HYGIENE_STEERED',
141
+ 'PROMPT_HYGIENE_BLOCKED',
142
+ 'SIGHTSEEING_TOOL_PREVENTED'
143
+ ])
144
+ }),
145
+ subagentIsolated: Object.freeze({
146
+ id: 'subagentIsolated',
147
+ label: 'Task / Agent Subagent Context Isolation',
148
+ shortLabel: 'Subagent Isolation',
149
+ rawCategories: Object.freeze(['SUBAGENT_ISOLATED', 'TASK_SUBAGENT_ISOLATED'])
150
+ })
151
+ });
152
+
153
+ /**
154
+ * Maps a raw ledger category string into one of the 5 canonical Claude Code savings buckets.
155
+ *
156
+ * @param {string} [rawCategory='']
157
+ * @returns {'cacheReadDiscount'|'prefixBustAvoided'|'toolOutputCompressed'|'loopAndReadGuarded'|'subagentIsolated'}
158
+ */
159
+ export function normalizeSavingsBucketId(rawCategory = '') {
160
+ const upper = String(rawCategory || '').trim().toUpperCase();
161
+ for (const [bucketId, spec] of Object.entries(SAVINGS_BUCKETS)) {
162
+ if (spec.rawCategories.includes(upper) || bucketId.toUpperCase() === upper) {
163
+ return bucketId;
164
+ }
165
+ }
166
+ if (upper.includes('CACHE')) return 'cacheReadDiscount';
167
+ if (upper.includes('PREFIX') || upper.includes('MODEL') || upper.includes('DET_08') || upper.includes('DET_09')) {
168
+ return 'prefixBustAvoided';
169
+ }
170
+ if (upper.includes('SANITIZ') || upper.includes('OFFLOAD') || upper.includes('COMPRESS')) {
171
+ return 'toolOutputCompressed';
172
+ }
173
+ if (upper.includes('SUBAGENT') || upper.includes('TASK')) {
174
+ return 'subagentIsolated';
175
+ }
176
+ return 'loopAndReadGuarded';
177
+ }
178
+
179
+ export function recordSavingsReceipt(receipt = {}, options = {}) {
180
+ const filePath = getLedgerFilePath(options);
181
+ const entry = {
182
+ timestamp: receipt.timestamp || options.nowMs || Date.now(),
183
+ sessionId: String(receipt.sessionId || 'default'),
184
+ category: String(receipt.category || 'CACHE_READ_DISCOUNT'),
185
+ modelId: String(receipt.modelId || 'claude-sonnet-5-5'),
186
+ savedTokens: Math.max(0, Math.round(Number(receipt.savedTokens || 0))),
187
+ savedUSD: Math.max(0, Number(Number(receipt.savedUSD || 0).toFixed(6))),
188
+ detail: String(receipt.detail || ''),
189
+ ...(receipt.turnId ? { turnId: String(receipt.turnId) } : {})
190
+ };
191
+
192
+ const ok = appendJsonlSafe(filePath, entry, options);
193
+ return { ok, entry, filePath };
194
+ }
195
+
196
+ /**
197
+ * Records a deduplicated intervention savings receipt (e.g. `DET-08` model switch hold,
198
+ * `DET-09` warm-prefix file mutation fence, `DET-06`/`10`/`11`/`20` guard, or `SUBAGENT_ISOLATED`).
199
+ *
200
+ * @param {object} [params={}]
201
+ * @param {string} [params.sessionId='default']
202
+ * @param {string} [params.category='COLD_PREFILL_AVOIDED']
203
+ * @param {string} [params.modelId='claude-sonnet-5-5']
204
+ * @param {number} [params.savedTokens=0]
205
+ * @param {number} [params.savedUSD=0]
206
+ * @param {string} [params.detail='']
207
+ * @param {string} [params.dedupeId]
208
+ * @param {object} [options={}]
209
+ */
210
+ export function recordInterventionSavings(params = {}, options = {}) {
211
+ const sessionId = String(params.sessionId || options.sessionId || 'default');
212
+ const category = String(params.category || 'COLD_PREFILL_AVOIDED');
213
+ const modelId = String(params.modelId || 'claude-sonnet-5-5');
214
+ const savedTokens = Math.max(0, Math.round(Number(params.savedTokens || 0)));
215
+ let savedUSD = Math.max(0, Number(params.savedUSD || 0));
216
+
217
+ if (savedTokens <= 0 && savedUSD <= 0) {
218
+ return { recorded: false, deduplicated: false, receipt: null };
219
+ }
220
+
221
+ if (savedUSD <= 0 && savedTokens > 0) {
222
+ const turnCost = calculateTurnCostUSD(
223
+ {
224
+ model: modelId,
225
+ inputTokens: savedTokens
226
+ },
227
+ options
228
+ );
229
+ savedUSD = Math.max(0, Number(turnCost.costsUSD.totalActualSpendUSD || 0));
230
+ }
231
+
232
+ const dedupeToken = params.dedupeId || params.turnId || '';
233
+ const dedupeKey = dedupeToken
234
+ ? `${getLedgerFilePath(options)}::${sessionId}::${category}::${dedupeToken}`
235
+ : null;
236
+ if (dedupeKey) {
237
+ if (recordedInterventionKeys.has(dedupeKey)) {
238
+ return { recorded: false, deduplicated: true, receipt: null };
239
+ }
240
+ recordedInterventionKeys.add(dedupeKey);
241
+ }
242
+
243
+ const res = recordSavingsReceipt(
244
+ {
245
+ sessionId,
246
+ turnId: dedupeToken || undefined,
247
+ category,
248
+ modelId,
249
+ savedTokens,
250
+ savedUSD,
251
+ detail: String(params.detail || '')
252
+ },
253
+ options
254
+ );
255
+
256
+ return {
257
+ recorded: res.ok,
258
+ deduplicated: false,
259
+ receipt: res.entry
260
+ };
261
+ }
262
+
263
+ /**
264
+ * Computes exact cache read USD & token savings for a turn via `calculateTurnCostUSD`
265
+ * (honoring the Haiku 5.5 `$0.10/$0.50` base and `100,000` total-prompt `5x` cliff)
266
+ * and records a verified receipt if `netCacheSavingsUSD > 0`.
267
+ * Deduplicates by `turnId` per session when provided (`ISS-027`).
268
+ *
269
+ * @param {object} [usage={}]
270
+ * @param {object} [options={}]
271
+ */
272
+ export function recordTurnCacheSavings(usage = {}, options = {}) {
273
+ const sessionId = String(usage.sessionId || options.sessionId || 'default');
274
+ const turnId =
275
+ usage.turnId ||
276
+ usage.turn_id ||
277
+ usage.messageId ||
278
+ usage.message_id ||
279
+ usage.message?.id ||
280
+ options.turnId ||
281
+ null;
282
+
283
+ const dedupeKey = turnId ? `${getLedgerFilePath(options)}::${sessionId}::${turnId}` : null;
284
+ if (dedupeKey) {
285
+ if (recordedTurnSavingsKeys.has(dedupeKey)) {
286
+ const turnCost = calculateTurnCostUSD(usage, options);
287
+ return {
288
+ recorded: false,
289
+ deduplicated: true,
290
+ turnCost,
291
+ receipt: null
292
+ };
293
+ }
294
+ const existing = readLedgerEntries(options);
295
+ if (existing.some((e) => e.sessionId === sessionId && e.turnId === String(turnId))) {
296
+ recordedTurnSavingsKeys.add(dedupeKey);
297
+ const turnCost = calculateTurnCostUSD(usage, options);
298
+ return {
299
+ recorded: false,
300
+ deduplicated: true,
301
+ turnCost,
302
+ receipt: null
303
+ };
304
+ }
305
+ }
306
+
307
+ const turnCost = calculateTurnCostUSD(usage, options);
308
+ const savedUSD = Math.max(0, Number(turnCost.costsUSD.netCacheSavingsUSD || 0));
309
+ const savedTokens = Math.max(0, Number(turnCost.tokens.cacheRead || 0));
310
+
311
+ if (savedUSD <= 0 && savedTokens <= 0) {
312
+ return {
313
+ recorded: false,
314
+ turnCost,
315
+ receipt: null
316
+ };
317
+ }
318
+
319
+ const receipt = recordSavingsReceipt(
320
+ {
321
+ sessionId,
322
+ turnId,
323
+ category: 'CACHE_READ_DISCOUNT',
324
+ modelId: turnCost.modelId,
325
+ savedTokens,
326
+ savedUSD,
327
+ detail: `Warm cache read (${savedTokens.toLocaleString()} tok, total prompt ${turnCost.tokens.totalPrompt.toLocaleString()} tok)`
328
+ },
329
+ options
330
+ );
331
+
332
+ if (dedupeKey) {
333
+ recordedTurnSavingsKeys.add(dedupeKey);
334
+ }
335
+
336
+ return {
337
+ recorded: receipt.ok,
338
+ turnCost,
339
+ receipt: receipt.entry
340
+ };
341
+ }
342
+
343
+ /**
344
+ * Computes the deterministic Saved-Quota Receipt summary across all recorded entries
345
+ * (or filtered by `options.sessionId`). Always starts strictly at `0`.
346
+ *
347
+ * @param {object} [options={}]
348
+ * @returns {{
349
+ * totalSavedTokens: number,
350
+ * totalSavedUSD: number,
351
+ * entryCount: number,
352
+ * byCategory: Record<string, { savedTokens: number, savedUSD: number, count: number }>,
353
+ * entries: Array<object>
354
+ * }}
355
+ */
356
+ export function getSavedQuotaReceiptSummary(options = {}) {
357
+ const nowMs = Number(options.nowMs || Date.now());
358
+ const cutoff30d = nowMs - THIRTY_DAYS_MS;
359
+ const allEntries = readLedgerEntries(options);
360
+ const filtered = options.sessionId
361
+ ? allEntries.filter((e) => e.sessionId === options.sessionId)
362
+ : allEntries;
363
+
364
+ const targetSessionId =
365
+ options.sessionId ||
366
+ options.activeSessionId ||
367
+ (allEntries.length > 0 ? allEntries[allEntries.length - 1].sessionId : 'default');
368
+
369
+ let totalSavedTokens = 0;
370
+ let totalSavedUSD = 0;
371
+ const byCategory = {};
372
+
373
+ const categories = {};
374
+ for (const [bucketId, spec] of Object.entries(SAVINGS_BUCKETS)) {
375
+ categories[bucketId] = {
376
+ id: bucketId,
377
+ label: spec.label,
378
+ shortLabel: spec.shortLabel,
379
+ savedTokens: 0,
380
+ savedUSD: 0,
381
+ sessionSavedTokens: 0,
382
+ sessionSavedUSD: 0,
383
+ count: 0
384
+ };
385
+ }
386
+
387
+ for (const entry of filtered) {
388
+ const tokens = Math.max(0, Number(entry.savedTokens || 0));
389
+ const usd = Math.max(0, Number(entry.savedUSD || 0));
390
+ totalSavedTokens += tokens;
391
+ totalSavedUSD += usd;
392
+
393
+ const cat = entry.category || 'OTHER';
394
+ if (!byCategory[cat]) {
395
+ byCategory[cat] = { savedTokens: 0, savedUSD: 0, count: 0 };
396
+ }
397
+ byCategory[cat].savedTokens += tokens;
398
+ byCategory[cat].savedUSD = Number((byCategory[cat].savedUSD + usd).toFixed(6));
399
+ byCategory[cat].count += 1;
400
+
401
+ const bucketId = normalizeSavingsBucketId(cat);
402
+ const bucket = categories[bucketId];
403
+ if (bucket) {
404
+ bucket.savedTokens += tokens;
405
+ bucket.savedUSD = Number((bucket.savedUSD + usd).toFixed(6));
406
+ bucket.count += 1;
407
+ }
408
+ }
409
+
410
+ let sessionSavedTokens = 0;
411
+ let sessionSavedUSD = 0;
412
+ let sessionEntryCount = 0;
413
+ let workspace30dSavedTokens = 0;
414
+ let workspace30dSavedUSD = 0;
415
+ let workspace30dEntryCount = 0;
416
+
417
+ for (const entry of allEntries) {
418
+ const tokens = Math.max(0, Number(entry.savedTokens || 0));
419
+ const usd = Math.max(0, Number(entry.savedUSD || 0));
420
+ const ts = Number(entry.timestamp || nowMs);
421
+ const bucketId = normalizeSavingsBucketId(entry.category || 'OTHER');
422
+
423
+ if (!options.sessionId || entry.sessionId === targetSessionId) {
424
+ if (entry.sessionId === targetSessionId || !options.activeSessionId) {
425
+ sessionSavedTokens += tokens;
426
+ sessionSavedUSD += usd;
427
+ sessionEntryCount += 1;
428
+ if (categories[bucketId]) {
429
+ categories[bucketId].sessionSavedTokens += tokens;
430
+ categories[bucketId].sessionSavedUSD = Number(
431
+ (categories[bucketId].sessionSavedUSD + usd).toFixed(6)
432
+ );
433
+ }
434
+ }
435
+ }
436
+
437
+ if (ts >= cutoff30d) {
438
+ workspace30dSavedTokens += tokens;
439
+ workspace30dSavedUSD += usd;
440
+ workspace30dEntryCount += 1;
441
+ }
442
+ }
443
+
444
+ workspace30dSavedTokens = Math.max(workspace30dSavedTokens, sessionSavedTokens, totalSavedTokens);
445
+ workspace30dSavedUSD = Math.max(workspace30dSavedUSD, sessionSavedUSD, totalSavedUSD);
446
+
447
+ const categoryList = Object.values(categories);
448
+ let topDriver = {
449
+ id: 'cacheReadDiscount',
450
+ label: SAVINGS_BUCKETS.cacheReadDiscount.label,
451
+ shortLabel: SAVINGS_BUCKETS.cacheReadDiscount.shortLabel,
452
+ savedTokens: 0,
453
+ savedUSD: 0
454
+ };
455
+ for (const bucket of categoryList) {
456
+ if (
457
+ bucket.savedTokens > topDriver.savedTokens ||
458
+ (bucket.savedTokens === topDriver.savedTokens && bucket.savedUSD > topDriver.savedUSD)
459
+ ) {
460
+ topDriver = {
461
+ id: bucket.id,
462
+ label: bucket.label,
463
+ shortLabel: bucket.shortLabel,
464
+ savedTokens: bucket.savedTokens,
465
+ savedUSD: bucket.savedUSD
466
+ };
467
+ }
468
+ }
469
+
470
+ const measuredPromptHygiene = {
471
+ steeredPrompts: Number(byCategory.PROMPT_HYGIENE_STEERED?.count || 0),
472
+ blockedPrompts: Number(byCategory.PROMPT_HYGIENE_BLOCKED?.count || 0),
473
+ sightseeingToolsPrevented: Number(byCategory.SIGHTSEEING_TOOL_PREVENTED?.count || 0),
474
+ modeledEstimateTokensSaved:
475
+ Number(byCategory.PROMPT_HYGIENE_STEERED?.savedTokens || 0) +
476
+ Number(byCategory.PROMPT_HYGIENE_BLOCKED?.savedTokens || 0) +
477
+ Number(byCategory.SIGHTSEEING_TOOL_PREVENTED?.savedTokens || 0),
478
+ provenanceTag: '[modeled-estimate]'
479
+ };
480
+
481
+ return {
482
+ totalSavedTokens: Math.round(totalSavedTokens),
483
+ totalSavedUSD: Number(totalSavedUSD.toFixed(6)),
484
+ entryCount: filtered.length,
485
+ sessionSavedTokens: Math.round(sessionSavedTokens),
486
+ sessionSavedUSD: Number(sessionSavedUSD.toFixed(6)),
487
+ sessionEntryCount,
488
+ workspace30dSavedTokens: Math.round(workspace30dSavedTokens),
489
+ workspace30dSavedUSD: Number(workspace30dSavedUSD.toFixed(6)),
490
+ workspace30dEntryCount,
491
+ measuredPromptHygiene,
492
+ byCategory,
493
+ categories,
494
+ categoryList,
495
+ topDriver,
496
+ entries: filtered
497
+ };
498
+ }
499
+
500
+ /**
501
+ * Stateful SavedQuotaReceiptLedger class wrapper.
502
+ */
503
+ export class SavedQuotaReceiptLedger {
504
+ constructor(options = {}) {
505
+ this.options = options;
506
+ }
507
+
508
+ record(receipt = {}) {
509
+ return recordSavingsReceipt(receipt, this.options);
510
+ }
511
+
512
+ getSummary(filterOptions = {}) {
513
+ return getSavedQuotaReceiptSummary({ ...this.options, ...filterOptions });
514
+ }
515
+ }
516
+
517
+ export default {
518
+ SAVINGS_BUCKETS,
519
+ normalizeSavingsBucketId,
520
+ getLedgerFilePath,
521
+ readLedgerEntries,
522
+ recordSavingsReceipt,
523
+ recordTurnCacheSavings,
524
+ recordInterventionSavings,
525
+ getSavedQuotaReceiptSummary,
526
+ SavedQuotaReceiptLedger
527
+ };