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,704 @@
1
+ /**
2
+ * @file src/utils/sessionCalibration.mjs
3
+ * Read-only Stop-hook session transcript calibrator for Claude Code (`DET-08`).
4
+ *
5
+ * Counts completed interactive turns (`turnsCompleted`), unique API calls (`apiCallsCompleted`),
6
+ * initial session prefix tokens, and the rolling median output tokens across the most recent
7
+ * turns, persisting compact numeric state outside `<cwd>` under
8
+ * `~/.attention-horizon/cache/sessions/cal_<sessionId>.json`.
9
+ */
10
+
11
+ import { fs, path, os, readJsonSafe, writeJsonAtomic } from './nodeIo.mjs';
12
+
13
+ export const ROLLING_OUTPUT_WINDOW = 10;
14
+ export const MIN_TRUSTED_OUTPUT_TURNS = 5;
15
+ export const DEFAULT_OUTPUT_SHRINKAGE_PRIOR_TOKENS = 500;
16
+ export const MIN_TRUSTED_RPT_TURNS = 5;
17
+ export const DEFAULT_RPT_SHRINKAGE_PRIOR = 2.0;
18
+ export const RPT_AGREEMENT_MAX_RELATIVE_SPREAD = 0.25;
19
+ export const OUTPUT_SHRINKAGE_PRIOR_METADATA = Object.freeze({
20
+ priorTokens: DEFAULT_OUTPUT_SHRINKAGE_PRIOR_TOKENS,
21
+ minTrustedTurns: MIN_TRUSTED_OUTPUT_TURNS,
22
+ effectivePseudoCountExampleAtN2: MIN_TRUSTED_OUTPUT_TURNS - 2,
23
+ isPlaceholderPrior: true,
24
+ provenance: 'placeholder_engineering_heuristic_midpoint_not_claude_code_telemetry',
25
+ description:
26
+ 'Heuristic 500-token output midpoint over a 5-turn ramp (effective k = minTrustedTurns - n, e.g. k = 3 at n = 2); not derived from Claude Code telemetry.'
27
+ });
28
+ export const RPT_SHRINKAGE_PRIOR_METADATA = Object.freeze({
29
+ priorRequestsPerTurn: DEFAULT_RPT_SHRINKAGE_PRIOR,
30
+ minTrustedTurns: MIN_TRUSTED_RPT_TURNS,
31
+ agreementReducedMinTurns: Number((MIN_TRUSTED_RPT_TURNS / 2).toFixed(2)),
32
+ agreementMaxRelativeSpread: RPT_AGREEMENT_MAX_RELATIVE_SPREAD,
33
+ localTranscriptOverrideMinSessions: 3,
34
+ effectivePseudoCountExampleAtN2: MIN_TRUSTED_RPT_TURNS - 2,
35
+ isPlaceholderPrior: true,
36
+ provenance: 'placeholder_single_tool_round_rpt_prior_2.0_not_empirical_evidence',
37
+ description:
38
+ 'Placeholder rationale of 2.0 requests/turn (1 tool round + 1 reply, not empirical evidence) over a 5-turn ramp (halved to 2.5 when >= 2 observed turns agree within 25% spread, w = 0.8 at n = 2), overridden once >= 3 non-current, non-benchmark local Claude Code transcripts exist; replaces earlier 1.0 (0 tool calls) placeholder.'
39
+ });
40
+
41
+ /**
42
+ * Linearly shrink an early rolling output median toward a conservative placeholder prior
43
+ * until `minTrustedTurns` turns of output have been observed.
44
+ */
45
+ export function shrinkRollingOutputEstimate(rollingMedian, sampleSize, options = {}) {
46
+ const minTurnsRaw = Number(options.minTrustedTurns);
47
+ const minTrustedTurns =
48
+ Number.isFinite(minTurnsRaw) && minTurnsRaw > 0
49
+ ? Math.round(minTurnsRaw)
50
+ : MIN_TRUSTED_OUTPUT_TURNS;
51
+ const priorRaw = Number(options.priorTokens);
52
+ const priorTokens =
53
+ Number.isFinite(priorRaw) && priorRaw > 0
54
+ ? Math.round(priorRaw)
55
+ : DEFAULT_OUTPUT_SHRINKAGE_PRIOR_TOKENS;
56
+ const count = Math.max(0, Math.round(Number(sampleSize) || 0));
57
+ const rawMedian = Number(rollingMedian);
58
+ if (!Number.isFinite(rawMedian) || rawMedian <= 0 || count === 0) {
59
+ return {
60
+ expectedOutputTokens: priorTokens,
61
+ rawRollingMedianOutputTokens: null,
62
+ sampleSize: 0,
63
+ shrinkageWeight: 0,
64
+ minTrustedTurns,
65
+ priorTokens,
66
+ effectiveSmoothingK: minTrustedTurns,
67
+ isPlaceholderShrinkagePrior: true,
68
+ shrinkagePriorProvenance: OUTPUT_SHRINKAGE_PRIOR_METADATA.provenance,
69
+ source: 'shrinkage_prior_default'
70
+ };
71
+ }
72
+ const weight = Math.min(1, count / minTrustedTurns);
73
+ const blended = Math.round(weight * rawMedian + (1 - weight) * priorTokens);
74
+ return {
75
+ expectedOutputTokens: Math.max(1, blended),
76
+ rawRollingMedianOutputTokens: Math.round(rawMedian),
77
+ sampleSize: count,
78
+ shrinkageWeight: Number(weight.toFixed(4)),
79
+ minTrustedTurns,
80
+ priorTokens,
81
+ effectiveSmoothingK: Math.max(0, minTrustedTurns - Math.min(minTrustedTurns, count)),
82
+ isPlaceholderShrinkagePrior: true,
83
+ shrinkagePriorProvenance: OUTPUT_SHRINKAGE_PRIOR_METADATA.provenance,
84
+ source: weight < 1 ? 'stop_hook_shrunk_median' : 'stop_hook_rolling_median'
85
+ };
86
+ }
87
+
88
+ /**
89
+ * Sanitizes a session ID for safe cache filenames.
90
+ * @param {string} [sessionId='default']
91
+ * @returns {string}
92
+ */
93
+ function sanitizeSessionId(sessionId = 'default') {
94
+ const cleaned = String(sessionId || 'default')
95
+ .trim()
96
+ .replace(/[^a-zA-Z0-9_-]/g, '_');
97
+ return cleaned || 'default';
98
+ }
99
+
100
+ /**
101
+ * Resolves the user home directory across options, `HOME`, `USERPROFILE`, and `os.homedir()`.
102
+ * @param {object} [options={}]
103
+ * @returns {string}
104
+ */
105
+ export function resolveCalibrationHomeDir(options = {}) {
106
+ return (
107
+ options.homeDir ||
108
+ globalThis.process?.env?.HOME ||
109
+ globalThis.process?.env?.USERPROFILE ||
110
+ os.homedir()
111
+ );
112
+ }
113
+
114
+ /**
115
+ * Computes the rounded integer median of positive finite numbers over the trailing window.
116
+ * @param {number[]} [values=[]]
117
+ * @param {number} [windowSize=ROLLING_OUTPUT_WINDOW]
118
+ * @returns {number | null}
119
+ */
120
+ export function computeRollingMedian(values = [], windowSize = ROLLING_OUTPUT_WINDOW) {
121
+ const nums = (Array.isArray(values) ? values : [])
122
+ .map((v) => Number(v))
123
+ .filter((v) => Number.isFinite(v) && v > 0);
124
+ if (nums.length === 0) return null;
125
+ const recent = nums.slice(-Math.max(1, Number(windowSize) || ROLLING_OUTPUT_WINDOW));
126
+ recent.sort((a, b) => a - b);
127
+ const mid = Math.floor(recent.length / 2);
128
+ return recent.length % 2 === 1
129
+ ? Math.round(recent[mid])
130
+ : Math.round((recent[mid - 1] + recent[mid]) / 2);
131
+ }
132
+
133
+ /**
134
+ * Computes the floating-point median of positive finite numbers over the trailing window (4 decimals).
135
+ * @param {number[]} [values=[]]
136
+ * @param {number} [windowSize=ROLLING_OUTPUT_WINDOW]
137
+ * @returns {number | null}
138
+ */
139
+ export function computeRollingMedianFloat(values = [], windowSize = ROLLING_OUTPUT_WINDOW) {
140
+ const nums = (Array.isArray(values) ? values : [])
141
+ .map((v) => Number(v))
142
+ .filter((v) => Number.isFinite(v) && v > 0);
143
+ if (nums.length === 0) return null;
144
+ const recent = nums.slice(-Math.max(1, Number(windowSize) || ROLLING_OUTPUT_WINDOW));
145
+ recent.sort((a, b) => a - b);
146
+ const mid = Math.floor(recent.length / 2);
147
+ const med = recent.length % 2 === 1 ? recent[mid] : (recent[mid - 1] + recent[mid]) / 2;
148
+ return Number(med.toFixed(4));
149
+ }
150
+
151
+ /**
152
+ * Computes the rounded integer median of non-negative finite numbers over the trailing window.
153
+ * @param {number[]} [values=[]]
154
+ * @param {number} [windowSize=ROLLING_OUTPUT_WINDOW]
155
+ * @returns {number | null}
156
+ */
157
+ export function computeRollingMedianNonNegative(values = [], windowSize = ROLLING_OUTPUT_WINDOW) {
158
+ const nums = (Array.isArray(values) ? values : [])
159
+ .map((v) => Number(v))
160
+ .filter((v) => Number.isFinite(v) && v >= 0);
161
+ if (nums.length === 0) return null;
162
+ const recent = nums.slice(-Math.max(1, Number(windowSize) || ROLLING_OUTPUT_WINDOW));
163
+ recent.sort((a, b) => a - b);
164
+ const mid = Math.floor(recent.length / 2);
165
+ return recent.length % 2 === 1
166
+ ? Math.round(recent[mid])
167
+ : Math.round((recent[mid - 1] + recent[mid]) / 2);
168
+ }
169
+
170
+ /**
171
+ * Linearly shrinks an early rolling requests/turn median toward a prior (`2.0` structural tool-round
172
+ * placeholder, or median `requests/turn` over >= 1 local deduplicated Claude Code transcript).
173
+ * When `>= 2` observed turns agree closely (relative spread `(max - min) / med <= maxSpread`),
174
+ * halves the effective shrinkage horizon (`Math.max(2, minTrustedTurns / 2)`, i.e. `2.5` at default `5`,
175
+ * giving `w = 0.8` at `n = 2`).
176
+ *
177
+ * @param {number | null} rollingMedianRpt
178
+ * @param {number} sampleSize
179
+ * @param {object} [options={}]
180
+ */
181
+ export function shrinkRollingRequestsPerTurn(rollingMedianRpt, sampleSize, options = {}) {
182
+ const minTurnsRaw = Number(options.minTrustedTurns);
183
+ const minTrustedTurns =
184
+ Number.isFinite(minTurnsRaw) && minTurnsRaw > 0
185
+ ? Math.round(minTurnsRaw)
186
+ : MIN_TRUSTED_RPT_TURNS;
187
+ const maxSpreadRaw = Number(options.agreementMaxRelativeSpread);
188
+ const maxSpread =
189
+ Number.isFinite(maxSpreadRaw) && maxSpreadRaw >= 0
190
+ ? maxSpreadRaw
191
+ : RPT_AGREEMENT_MAX_RELATIVE_SPREAD;
192
+ const hasLocalPrior =
193
+ options.priorSource === 'local_transcripts' &&
194
+ Number.isFinite(Number(options.priorRequestsPerTurn)) &&
195
+ Number(options.priorRequestsPerTurn) >= 1;
196
+ const priorRaw = Number(options.priorRequestsPerTurn);
197
+ const priorRequestsPerTurn =
198
+ Number.isFinite(priorRaw) && priorRaw > 0
199
+ ? Number(priorRaw.toFixed(4))
200
+ : DEFAULT_RPT_SHRINKAGE_PRIOR;
201
+ const isPlaceholderShrinkagePrior = !hasLocalPrior;
202
+ const shrinkagePriorProvenance = hasLocalPrior
203
+ ? 'local_claude_code_transcripts_median_rpt'
204
+ : RPT_SHRINKAGE_PRIOR_METADATA.provenance;
205
+
206
+ const recentCounts = Array.isArray(options.recentTurnRequestCounts)
207
+ ? options.recentTurnRequestCounts
208
+ .map((v) => Number(v))
209
+ .filter((v) => Number.isFinite(v) && v > 0)
210
+ .slice(-ROLLING_OUTPUT_WINDOW)
211
+ : [];
212
+ const computeAgreeingStats = (slice) => {
213
+ if (!Array.isArray(slice) || slice.length < 2) return null;
214
+ const sortedCounts = [...slice].sort((a, b) => a - b);
215
+ const mid = Math.floor(sortedCounts.length / 2);
216
+ const medR =
217
+ sortedCounts.length % 2 === 1
218
+ ? sortedCounts[mid]
219
+ : (sortedCounts[mid - 1] + sortedCounts[mid]) / 2;
220
+ const minR = sortedCounts[0];
221
+ const maxR = sortedCounts[sortedCounts.length - 1];
222
+ const relativeSpread = medR > 0 ? (maxR - minR) / medR : Infinity;
223
+ return { agreed: relativeSpread <= maxSpread, median: medR, length: slice.length };
224
+ };
225
+
226
+ const fullStats = computeAgreeingStats(recentCounts);
227
+ const turnsAgree = Boolean(fullStats?.agreed);
228
+
229
+ const effectiveMinTrustedTurns = turnsAgree
230
+ ? Math.max(2, Number((minTrustedTurns / 2).toFixed(4)))
231
+ : minTrustedTurns;
232
+
233
+ const count = Math.max(0, Math.round(Number(sampleSize) || 0));
234
+ const rawMedian = Number(rollingMedianRpt);
235
+ if (!Number.isFinite(rawMedian) || rawMedian <= 0 || count === 0) {
236
+ return {
237
+ expectedRequestsPerTurn: priorRequestsPerTurn,
238
+ rawRollingMedianRequestsPerTurn: null,
239
+ sampleSize: 0,
240
+ shrinkageWeight: 0,
241
+ minTrustedTurns,
242
+ effectiveMinTrustedTurns,
243
+ turnsAgree: false,
244
+ trailingRegimeDetected: false,
245
+ priorRequestsPerTurn,
246
+ effectiveSmoothingK: effectiveMinTrustedTurns,
247
+ isPlaceholderShrinkagePrior,
248
+ shrinkagePriorProvenance,
249
+ source: hasLocalPrior ? 'local_transcript_rpt_prior' : 'placeholder_rpt_prior_2.0'
250
+ };
251
+ }
252
+
253
+ // Detect a stabilized trailing regime shift (e.g. [2,2,2,1,1] setup -> Q&A) without unlocking early growth extrapolation
254
+ let trailingStats = null;
255
+ if (!turnsAgree && recentCounts.length >= 4) {
256
+ for (let k = recentCounts.length - 1; k >= 2; k--) {
257
+ const candidate = computeAgreeingStats(recentCounts.slice(-k));
258
+ if (candidate?.agreed) {
259
+ trailingStats = candidate;
260
+ break;
261
+ }
262
+ }
263
+ }
264
+ if (trailingStats && Math.abs(trailingStats.median - rawMedian) > 1e-6) {
265
+ const trailingMed = Number(trailingStats.median.toFixed(4));
266
+ const isStepDown = trailingMed < rawMedian;
267
+ const agreedHorizon = Math.max(2, Number((minTrustedTurns / 2).toFixed(4)));
268
+ const wTrail = isStepDown ? 1 : Math.min(1, trailingStats.length / agreedHorizon);
269
+ const expectedTrail = isStepDown
270
+ ? Math.max(1, trailingMed)
271
+ : Math.max(1, Number((wTrail * trailingMed + (1 - wTrail) * priorRequestsPerTurn).toFixed(4)));
272
+ const effectiveSmoothTrail = isStepDown
273
+ ? Math.max(0, effectiveMinTrustedTurns - Math.min(effectiveMinTrustedTurns, count))
274
+ : Math.max(0, agreedHorizon - Math.min(agreedHorizon, trailingStats.length));
275
+ return {
276
+ expectedRequestsPerTurn: expectedTrail,
277
+ rawRollingMedianRequestsPerTurn: Number(rawMedian.toFixed(4)),
278
+ sampleSize: count,
279
+ shrinkageWeight: Number(wTrail.toFixed(4)),
280
+ minTrustedTurns,
281
+ effectiveMinTrustedTurns,
282
+ turnsAgree: false,
283
+ trailingRegimeDetected: true,
284
+ trailingRegimeLength: trailingStats.length,
285
+ trailingRegimeMedian: trailingMed,
286
+ priorRequestsPerTurn,
287
+ effectiveSmoothingK: Number(effectiveSmoothTrail.toFixed(4)),
288
+ isPlaceholderShrinkagePrior,
289
+ shrinkagePriorProvenance,
290
+ source: isStepDown ? 'stop_hook_trailing_regime_rpt' : 'stop_hook_trailing_regime_shrunk_rpt'
291
+ };
292
+ }
293
+
294
+ const weight = Math.min(1, count / effectiveMinTrustedTurns);
295
+ const blended = Math.max(
296
+ 1,
297
+ Number((weight * rawMedian + (1 - weight) * priorRequestsPerTurn).toFixed(4))
298
+ );
299
+ return {
300
+ expectedRequestsPerTurn: blended,
301
+ rawRollingMedianRequestsPerTurn: Number(rawMedian.toFixed(4)),
302
+ sampleSize: count,
303
+ shrinkageWeight: Number(weight.toFixed(4)),
304
+ minTrustedTurns,
305
+ effectiveMinTrustedTurns,
306
+ turnsAgree,
307
+ trailingRegimeDetected: false,
308
+ priorRequestsPerTurn,
309
+ effectiveSmoothingK: Number(
310
+ Math.max(0, effectiveMinTrustedTurns - Math.min(effectiveMinTrustedTurns, count)).toFixed(4)
311
+ ),
312
+ isPlaceholderShrinkagePrior,
313
+ shrinkagePriorProvenance,
314
+ source:
315
+ weight >= 1
316
+ ? 'stop_hook_rolling_rpt_median'
317
+ : turnsAgree
318
+ ? 'stop_hook_agreed_shrunk_rpt_median'
319
+ : 'stop_hook_shrunk_rpt_median'
320
+ };
321
+ }
322
+
323
+ /**
324
+ * Resolves `~/.attention-horizon/cache/sessions/cal_<safeId>.json` (or explicit `options.calibrationPath`).
325
+ * @param {string} [sessionId='default']
326
+ * @param {object} [options={}]
327
+ * @returns {string}
328
+ */
329
+ export function getSessionCalibrationPath(sessionId = 'default', options = {}) {
330
+ if (typeof options.calibrationPath === 'string' && options.calibrationPath.trim()) {
331
+ return options.calibrationPath.trim();
332
+ }
333
+ const home = resolveCalibrationHomeDir(options);
334
+ const safeId = sanitizeSessionId(sessionId);
335
+ return path.join(home, '.attention-horizon', 'cache', 'sessions', `cal_${safeId}.json`);
336
+ }
337
+
338
+ /**
339
+ * Parses a Claude Code JSONL transcript read-only (`'r'`), deduplicating streaming assistant
340
+ * rows by `message.id` and extracting completed turn counts, rolling median output tokens,
341
+ * and initial prefix size without retaining any prompt or response prose.
342
+ *
343
+ * @param {string} transcriptPath
344
+ * @returns {{
345
+ * turnsCompleted: number,
346
+ * apiCallsCompleted: number,
347
+ * rollingMedianOutputTokens: number | null,
348
+ * rollingMedianOutputTokensPerCall: number | null,
349
+ * recentTurnOutputs: number[],
350
+ * initialPrefixTokens: number | null,
351
+ * latestContextTokens: number | null
352
+ * } | null}
353
+ */
354
+ /**
355
+ * Checks whether a Claude Code transcript `user` record represents a real human prompt
356
+ * (excluding tool results and synthetic `/model` or local-command UI rows).
357
+ * @param {object} obj
358
+ * @returns {boolean}
359
+ */
360
+ export function isRealHumanUserTranscriptEntry(obj) {
361
+ if (obj?.type !== 'user' || (obj?.message?.role !== 'user' && obj?.message)) {
362
+ return false;
363
+ }
364
+ if (obj?.isMeta === true || obj?.isCompactSummary === true) {
365
+ return false;
366
+ }
367
+ const content = obj?.message?.content;
368
+ if (typeof content === 'string') {
369
+ const trimmed = content.trim();
370
+ return (
371
+ trimmed.length > 0 &&
372
+ !/^<(?:local-command-|command-name>)/.test(trimmed) &&
373
+ !trimmed.startsWith('This session is being continued from a previous conversation')
374
+ );
375
+ }
376
+ return Array.isArray(content) && content.some((b) => b && b.type !== 'tool_result');
377
+ }
378
+
379
+ export function parseSessionTranscriptCalibration(transcriptPath) {
380
+ if (!transcriptPath || typeof transcriptPath !== 'string' || !fs.existsSync(transcriptPath)) {
381
+ return null;
382
+ }
383
+ let fd = null;
384
+ let raw = '';
385
+ try {
386
+ fd = fs.openSync(transcriptPath, 'r');
387
+ raw = fs.readFileSync(fd, 'utf8');
388
+ } catch {
389
+ return null;
390
+ } finally {
391
+ if (fd !== null) {
392
+ try {
393
+ fs.closeSync(fd);
394
+ } catch {
395
+ // Ignore close errors on read-only transcript fd
396
+ }
397
+ }
398
+ }
399
+
400
+ let currentTurnBucket = 0;
401
+ const byMsgId = new Map();
402
+ let lineIdx = 0;
403
+
404
+ for (const line of raw.split(/\r?\n/)) {
405
+ lineIdx += 1;
406
+ if (!line || !line.trim()) continue;
407
+ let obj;
408
+ try {
409
+ obj = JSON.parse(line);
410
+ } catch {
411
+ continue;
412
+ }
413
+
414
+ if (isRealHumanUserTranscriptEntry(obj)) {
415
+ currentTurnBucket += 1;
416
+ continue;
417
+ }
418
+
419
+ if (obj?.type === 'assistant' && obj?.message?.usage) {
420
+ const msg = obj.message;
421
+ const u = msg.usage;
422
+ const msgId = msg.id ? String(msg.id) : `anon_line_${lineIdx}`;
423
+ const prev = byMsgId.get(msgId);
424
+ const outTok = Number(u.output_tokens || 0);
425
+ const inTok = Number(u.input_tokens || 0);
426
+ const cwTok = Number(u.cache_creation_input_tokens || 0);
427
+ const crTok = Number(u.cache_read_input_tokens || 0);
428
+ const turnBucket = prev ? prev.turnBucket : currentTurnBucket > 0 ? currentTurnBucket : byMsgId.size + 1;
429
+
430
+ if (!prev) {
431
+ byMsgId.set(msgId, {
432
+ turnBucket,
433
+ outputTokens: outTok,
434
+ inputTokens: inTok,
435
+ cacheCreationTokens: cwTok,
436
+ cacheReadTokens: crTok
437
+ });
438
+ } else {
439
+ byMsgId.set(msgId, {
440
+ turnBucket: prev.turnBucket,
441
+ outputTokens: Math.max(prev.outputTokens, outTok),
442
+ inputTokens: outTok >= prev.outputTokens ? inTok : prev.inputTokens,
443
+ cacheCreationTokens: outTok >= prev.outputTokens ? cwTok : prev.cacheCreationTokens,
444
+ cacheReadTokens: outTok >= prev.outputTokens ? crTok : prev.cacheReadTokens
445
+ });
446
+ }
447
+ }
448
+ }
449
+
450
+ const orderedMsgs = Array.from(byMsgId.values());
451
+ const perCallOutputs = orderedMsgs.map((m) => m.outputTokens);
452
+ const turnSums = new Map();
453
+ const turnCallCounts = new Map();
454
+ const turnMsgGroups = new Map();
455
+ for (const m of orderedMsgs) {
456
+ turnSums.set(m.turnBucket, (turnSums.get(m.turnBucket) || 0) + m.outputTokens);
457
+ turnCallCounts.set(m.turnBucket, (turnCallCounts.get(m.turnBucket) || 0) + 1);
458
+ if (!turnMsgGroups.has(m.turnBucket)) turnMsgGroups.set(m.turnBucket, []);
459
+ turnMsgGroups.get(m.turnBucket).push(m);
460
+ }
461
+ const sortedTurnGroups = Array.from(turnMsgGroups.entries()).sort((a, b) => a[0] - b[0]);
462
+ const turnPromptGrowths = [];
463
+ let prevEndContext = null;
464
+ for (const [, msgs] of sortedTurnGroups) {
465
+ const firstMsgInTurn = msgs[0];
466
+ const lastMsgInTurn = msgs[msgs.length - 1];
467
+ const firstPrompt =
468
+ firstMsgInTurn.inputTokens +
469
+ firstMsgInTurn.cacheCreationTokens +
470
+ firstMsgInTurn.cacheReadTokens;
471
+ const endContext =
472
+ lastMsgInTurn.inputTokens +
473
+ lastMsgInTurn.cacheCreationTokens +
474
+ lastMsgInTurn.cacheReadTokens +
475
+ lastMsgInTurn.outputTokens;
476
+ const prevBoundary = prevEndContext === null ? firstPrompt : prevEndContext;
477
+ const growth = endContext - prevBoundary;
478
+ if (Number.isFinite(growth) && growth >= 0) {
479
+ turnPromptGrowths.push(Math.round(growth));
480
+ }
481
+ prevEndContext = endContext;
482
+ }
483
+ const turnOutputs = Array.from(turnSums.values());
484
+ const turnRequestCounts = Array.from(turnCallCounts.values());
485
+ const recentTurnOutputs = turnOutputs.slice(-ROLLING_OUTPUT_WINDOW);
486
+ const recentTurnRequestCounts = turnRequestCounts.slice(-ROLLING_OUTPUT_WINDOW);
487
+ const recentTurnPromptGrowths = turnPromptGrowths.slice(-ROLLING_OUTPUT_WINDOW);
488
+
489
+ const firstMsg = orderedMsgs[0] || null;
490
+ const lastMsg = orderedMsgs[orderedMsgs.length - 1] || null;
491
+ const initialPrefixTokens = firstMsg
492
+ ? firstMsg.inputTokens + firstMsg.cacheCreationTokens + firstMsg.cacheReadTokens
493
+ : null;
494
+ const latestContextTokens = lastMsg
495
+ ? lastMsg.inputTokens +
496
+ lastMsg.cacheCreationTokens +
497
+ lastMsg.cacheReadTokens +
498
+ lastMsg.outputTokens
499
+ : null;
500
+
501
+ const turnsCompleted = turnOutputs.length;
502
+ const apiCallsCompleted = byMsgId.size;
503
+ return {
504
+ turnsCompleted,
505
+ apiCallsCompleted,
506
+ outputSampleSize: recentTurnOutputs.length,
507
+ rptSampleSize: recentTurnRequestCounts.length,
508
+ promptGrowthSampleSize: recentTurnPromptGrowths.length,
509
+ requestsPerTurn:
510
+ turnsCompleted > 0 && apiCallsCompleted > 0
511
+ ? Number((apiCallsCompleted / turnsCompleted).toFixed(4))
512
+ : null,
513
+ rollingMedianRequestsPerTurn: computeRollingMedianFloat(
514
+ recentTurnRequestCounts,
515
+ ROLLING_OUTPUT_WINDOW
516
+ ),
517
+ recentTurnRequestCounts,
518
+ rollingMedianOutputTokens: computeRollingMedian(recentTurnOutputs, ROLLING_OUTPUT_WINDOW),
519
+ rollingMedianOutputTokensPerCall: computeRollingMedian(perCallOutputs, ROLLING_OUTPUT_WINDOW),
520
+ recentTurnOutputs,
521
+ rollingMedianPromptGrowthTokens: computeRollingMedianNonNegative(
522
+ recentTurnPromptGrowths,
523
+ ROLLING_OUTPUT_WINDOW
524
+ ),
525
+ recentTurnPromptGrowths,
526
+ initialPrefixTokens:
527
+ Number.isFinite(initialPrefixTokens) && initialPrefixTokens > 0 ? initialPrefixTokens : null,
528
+ latestContextTokens:
529
+ Number.isFinite(latestContextTokens) && latestContextTokens > 0 ? latestContextTokens : null
530
+ };
531
+ }
532
+
533
+ /**
534
+ * Updates persisted Stop-hook calibration metrics from `event.transcript_path` or direct `output_tokens`.
535
+ *
536
+ * @param {object} [event={}]
537
+ * @param {object} [options={}]
538
+ * @returns {object | null}
539
+ */
540
+ export function updateSessionCalibrationOnStop(event = {}, options = {}) {
541
+ const sessionId = event.session_id || event.sessionId || 'default';
542
+ const calPath = getSessionCalibrationPath(sessionId, options);
543
+ const nowMs = Number.isFinite(Number(options.nowMs)) ? Number(options.nowMs) : Date.now();
544
+ const txPath = event.transcript_path || event.transcriptPath;
545
+
546
+ if (typeof txPath === 'string' && txPath.trim() && fs.existsSync(txPath)) {
547
+ const parsed = parseSessionTranscriptCalibration(txPath);
548
+ if (parsed) {
549
+ const record = {
550
+ sessionId,
551
+ updatedAtMs: nowMs,
552
+ source: 'stop_transcript',
553
+ ...parsed
554
+ };
555
+ writeJsonAtomic(calPath, record, options);
556
+ return record;
557
+ }
558
+ }
559
+
560
+ const stopHookActive = Boolean(event.stop_hook_active ?? event.stopHookActive);
561
+ const directOut = Number(
562
+ event.output_tokens ?? event.outputTokens ?? event.usage?.output_tokens ?? 0
563
+ );
564
+ if (!stopHookActive && Number.isFinite(directOut) && directOut > 0) {
565
+ const prev = readJsonSafe(calPath, null, options);
566
+ const prevOutputs = Array.isArray(prev?.recentTurnOutputs) ? prev.recentTurnOutputs : [];
567
+ const recentTurnOutputs = [...prevOutputs, Math.round(directOut)].slice(-ROLLING_OUTPUT_WINDOW);
568
+ const prevRpts = Array.isArray(prev?.recentTurnRequestCounts) ? prev.recentTurnRequestCounts : [];
569
+ const directRptRaw = Number(event.requests_in_turn ?? event.requestsInTurn ?? 1);
570
+ const directRpt = Number.isFinite(directRptRaw) && directRptRaw >= 1 ? Math.round(directRptRaw) : 1;
571
+ const recentTurnRequestCounts = [...prevRpts, directRpt].slice(-ROLLING_OUTPUT_WINDOW);
572
+ const directContextRaw = Number(event.context_tokens ?? event.contextTokens ?? 0);
573
+ const prevGrowths = Array.isArray(prev?.recentTurnPromptGrowths) ? prev.recentTurnPromptGrowths : [];
574
+ let recentTurnPromptGrowths = prevGrowths;
575
+ let latestContextTokens = prev?.latestContextTokens ?? null;
576
+ if (Number.isFinite(directContextRaw) && directContextRaw > 0) {
577
+ const roundedCtx = Math.round(directContextRaw);
578
+ if (Number.isFinite(Number(prev?.latestContextTokens)) && Number(prev.latestContextTokens) > 0) {
579
+ const delta = roundedCtx - Number(prev.latestContextTokens);
580
+ if (delta >= 0) {
581
+ recentTurnPromptGrowths = [...prevGrowths, delta].slice(-ROLLING_OUTPUT_WINDOW);
582
+ }
583
+ }
584
+ latestContextTokens = roundedCtx;
585
+ }
586
+ const turnsCompleted = Number(prev?.turnsCompleted || 0) + 1;
587
+ const apiCallsCompleted = Number(prev?.apiCallsCompleted || 0) + directRpt;
588
+ const record = {
589
+ sessionId,
590
+ updatedAtMs: nowMs,
591
+ source: 'stop_direct_usage',
592
+ turnsCompleted,
593
+ apiCallsCompleted,
594
+ outputSampleSize: recentTurnOutputs.length,
595
+ rptSampleSize: recentTurnRequestCounts.length,
596
+ promptGrowthSampleSize: recentTurnPromptGrowths.length,
597
+ requestsPerTurn:
598
+ turnsCompleted > 0 && apiCallsCompleted > 0
599
+ ? Number((apiCallsCompleted / turnsCompleted).toFixed(4))
600
+ : null,
601
+ rollingMedianRequestsPerTurn: computeRollingMedianFloat(
602
+ recentTurnRequestCounts,
603
+ ROLLING_OUTPUT_WINDOW
604
+ ),
605
+ recentTurnRequestCounts,
606
+ rollingMedianOutputTokens: computeRollingMedian(recentTurnOutputs, ROLLING_OUTPUT_WINDOW),
607
+ rollingMedianOutputTokensPerCall: computeRollingMedian(recentTurnOutputs, ROLLING_OUTPUT_WINDOW),
608
+ recentTurnOutputs,
609
+ rollingMedianPromptGrowthTokens: computeRollingMedianNonNegative(
610
+ recentTurnPromptGrowths,
611
+ ROLLING_OUTPUT_WINDOW
612
+ ),
613
+ recentTurnPromptGrowths,
614
+ initialPrefixTokens: prev?.initialPrefixTokens ?? null,
615
+ latestContextTokens
616
+ };
617
+ writeJsonAtomic(calPath, record, options);
618
+ return record;
619
+ }
620
+
621
+ return null;
622
+ }
623
+
624
+ /**
625
+ * Reads persisted Stop-hook calibration snapshot or falls back read-only to `event.transcript_path`.
626
+ *
627
+ * @param {string} [sessionId='default']
628
+ * @param {object} [event={}]
629
+ * @param {object} [options={}]
630
+ * @returns {object | null}
631
+ */
632
+ export function readSessionCalibration(sessionId = 'default', event = {}, options = {}) {
633
+ const canCheckCache = Boolean(
634
+ options.homeDir ||
635
+ options.calibrationPath ||
636
+ event.cwd ||
637
+ options.cwd ||
638
+ event.transcript_path ||
639
+ event.transcriptPath ||
640
+ event.session_id ||
641
+ event.sessionId
642
+ );
643
+
644
+ if (canCheckCache) {
645
+ const calPath = getSessionCalibrationPath(sessionId, options);
646
+ const cached = readJsonSafe(calPath, null, options);
647
+ if (cached && typeof cached === 'object') {
648
+ const sampleSize =
649
+ cached.outputSampleSize ??
650
+ (Array.isArray(cached.recentTurnOutputs)
651
+ ? cached.recentTurnOutputs.length
652
+ : Number(cached.turnsCompleted || 0));
653
+ const turns = Number(cached.turnsCompleted || 0);
654
+ const calls = Number(cached.apiCallsCompleted || 0);
655
+ const rpt =
656
+ cached.requestsPerTurn ??
657
+ (turns > 0 && calls > 0 ? Number((calls / turns).toFixed(4)) : null);
658
+ const rptSampleSize =
659
+ cached.rptSampleSize ??
660
+ (Array.isArray(cached.recentTurnRequestCounts)
661
+ ? cached.recentTurnRequestCounts.length
662
+ : turns);
663
+ const rollingMedianRequestsPerTurn =
664
+ cached.rollingMedianRequestsPerTurn ??
665
+ (Array.isArray(cached.recentTurnRequestCounts)
666
+ ? computeRollingMedianFloat(cached.recentTurnRequestCounts, ROLLING_OUTPUT_WINDOW)
667
+ : rpt);
668
+ const promptGrowthSampleSize =
669
+ cached.promptGrowthSampleSize ??
670
+ (Array.isArray(cached.recentTurnPromptGrowths) ? cached.recentTurnPromptGrowths.length : 0);
671
+ const rollingMedianPromptGrowthTokens =
672
+ cached.rollingMedianPromptGrowthTokens !== undefined
673
+ ? cached.rollingMedianPromptGrowthTokens
674
+ : Array.isArray(cached.recentTurnPromptGrowths)
675
+ ? computeRollingMedianNonNegative(cached.recentTurnPromptGrowths, ROLLING_OUTPUT_WINDOW)
676
+ : null;
677
+ return {
678
+ ...cached,
679
+ outputSampleSize: Number.isFinite(Number(sampleSize)) ? Number(sampleSize) : 0,
680
+ rptSampleSize: Number.isFinite(Number(rptSampleSize)) ? Number(rptSampleSize) : 0,
681
+ promptGrowthSampleSize: Number.isFinite(Number(promptGrowthSampleSize))
682
+ ? Number(promptGrowthSampleSize)
683
+ : 0,
684
+ requestsPerTurn: rpt,
685
+ rollingMedianRequestsPerTurn,
686
+ rollingMedianPromptGrowthTokens
687
+ };
688
+ }
689
+ }
690
+
691
+ const txPath = event.transcript_path || event.transcriptPath;
692
+ if (typeof txPath === 'string' && txPath.trim() && fs.existsSync(txPath)) {
693
+ const parsed = parseSessionTranscriptCalibration(txPath);
694
+ if (parsed) {
695
+ return {
696
+ sessionId,
697
+ source: 'transcript_fallback',
698
+ ...parsed
699
+ };
700
+ }
701
+ }
702
+
703
+ return null;
704
+ }