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,198 @@
1
+ /**
2
+ * @file src/core-isomorphic/economics/dualTtl.mjs
3
+ * Feature 21: 1s Live Dual-TTL Countdown & Pause Distribution Analyzer.
4
+ *
5
+ * Implements:
6
+ * - 5-Minute (300s) Ephemeral Prompt Cache TTL Countdown
7
+ * - 1-Hour (3,600s) Rolling Billing Block TTL Countdown
8
+ * - Sub-second accuracy clamped cleanly at "00:00" without negative rollover
9
+ * - Inter-turn pause distribution analyzer (recommends 1h tier upgrade when >= 3.1% pauses are 5m-60m)
10
+ * - Amber warning at <= 45s, Keep-alive at <= 15s, T-10s StateBaton pre-snapshot
11
+ *
12
+ * Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
13
+ */
14
+
15
+ export const DUAL_TTL_CONSTANTS = Object.freeze({
16
+ CACHE_TTL_MS: 300000, // 5 minutes
17
+ BILLING_TTL_MS: 3600000, // 1 hour
18
+ CACHE_TTL_SEC: 300,
19
+ BILLING_TTL_SEC: 3600,
20
+ AMBER_ALERT_SEC: 45,
21
+ KEEP_ALIVE_SEC: 15,
22
+ SNAPSHOT_SEC: 10,
23
+ ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD: 0.031 // 3.1%
24
+ });
25
+
26
+ /**
27
+ * Formats seconds into digital countdown clock notation "MM:SS".
28
+ * Clamps negative or non-finite values to "00:00".
29
+ *
30
+ * @param {number} sec
31
+ * @returns {string}
32
+ */
33
+ export function formatMmSs(sec) {
34
+ const s = Math.max(0, Math.floor(Number(sec || 0)));
35
+ const m = Math.floor(s / 60);
36
+ const remS = s % 60;
37
+ return `${String(m).padStart(2, '0')}:${String(remS).padStart(2, '0')}`;
38
+ }
39
+
40
+ /**
41
+ * Formats remaining seconds into compact human-readable display e.g. "4m12s" or "42s".
42
+ * @param {number} remainingSeconds
43
+ * @returns {string}
44
+ */
45
+ export function formatRemainingTtl(remainingSeconds = 0) {
46
+ const sec = Math.max(0, Math.floor(Number(remainingSeconds || 0)));
47
+ if (sec <= 0) return '0s';
48
+ const mins = Math.floor(sec / 60);
49
+ const remSec = sec % 60;
50
+ if (mins === 0) return `${remSec}s`;
51
+ return `${mins}m${String(remSec).padStart(2, '0')}s`;
52
+ }
53
+
54
+ /**
55
+ * Calculates live Dual-TTL countdown for 5-minute cache TTL and 1-hour billing TTL.
56
+ *
57
+ * @param {number} lastTurnTimestamp Epoch ms when last turn/cache event finished
58
+ * @param {number} [now=Date.now()] Current epoch ms
59
+ * @param {number} [cacheTtlMs=300000] Ephemeral cache window (default 300,000ms = 5m)
60
+ * @param {number} [billingTtlMs=3600000] Billing block TTL (default 3,600,000ms = 1h)
61
+ * @param {object} [options={}] Optional configuration (e.g. { rolling: boolean })
62
+ * @returns {{
63
+ * cacheTtlSec: number,
64
+ * billingTtlSec: number,
65
+ * formattedCacheTtl: string,
66
+ * formattedBillingTtl: string,
67
+ * isCacheExpired: boolean,
68
+ * isBillingExpired: boolean
69
+ * }}
70
+ */
71
+ export function calculateDualTtlCountdown(
72
+ lastTurnTimestamp,
73
+ now = Date.now(),
74
+ cacheTtlMs = DUAL_TTL_CONSTANTS.CACHE_TTL_MS,
75
+ billingTtlMs = DUAL_TTL_CONSTANTS.BILLING_TTL_MS,
76
+ options = {}
77
+ ) {
78
+ const elapsedMs = Math.max(0, now - lastTurnTimestamp);
79
+ const cacheRemainingMs = Math.max(0, cacheTtlMs - elapsedMs);
80
+
81
+ const isRolling = Boolean(options.rolling);
82
+ const billingRemainingMs = isRolling
83
+ ? (elapsedMs >= billingTtlMs && elapsedMs % billingTtlMs === 0
84
+ ? 0
85
+ : Math.max(0, billingTtlMs - (elapsedMs % billingTtlMs)))
86
+ : Math.max(0, billingTtlMs - elapsedMs);
87
+
88
+ const cacheTtlSec = Math.floor(cacheRemainingMs / 1000);
89
+ const billingTtlSec = Math.floor(billingRemainingMs / 1000);
90
+
91
+ return {
92
+ cacheTtlSec,
93
+ billingTtlSec,
94
+ formattedCacheTtl: formatMmSs(cacheTtlSec),
95
+ formattedBillingTtl: formatMmSs(billingTtlSec),
96
+ isCacheExpired: cacheRemainingMs === 0,
97
+ isBillingExpired: elapsedMs >= billingTtlMs
98
+ };
99
+ }
100
+
101
+ /**
102
+ * Evaluates inter-turn pause durations (in seconds) and advises upgrading the session
103
+ * prompt cache tier to 1h when >= 3.1% of pauses fall between 5m and 60m.
104
+ *
105
+ * @param {Array<number>} pauseDurationsSeconds
106
+ * @param {number} [thresholdRatio=0.031]
107
+ * @returns {{
108
+ * totalIntervals: number,
109
+ * fiveToSixtyMinCount: number,
110
+ * fiveToSixtyMinRatio: number,
111
+ * fiveToSixtyMinPct: number,
112
+ * thresholdRatio: number,
113
+ * recommend1hTierUpgrade: boolean,
114
+ * advisoryMessage: string | null
115
+ * }}
116
+ */
117
+ export function evaluatePauseDistribution(
118
+ pauseDurationsSeconds = [],
119
+ thresholdRatio = DUAL_TTL_CONSTANTS.ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD
120
+ ) {
121
+ const validPauses = Array.isArray(pauseDurationsSeconds)
122
+ ? pauseDurationsSeconds.map(v => Number(v)).filter(v => Number.isFinite(v) && v >= 0)
123
+ : [];
124
+
125
+ const totalIntervals = validPauses.length;
126
+ if (totalIntervals === 0) {
127
+ return {
128
+ totalIntervals: 0,
129
+ fiveToSixtyMinCount: 0,
130
+ fiveToSixtyMinRatio: 0,
131
+ fiveToSixtyMinPct: 0,
132
+ thresholdRatio,
133
+ recommend1hTierUpgrade: false,
134
+ advisoryMessage: null
135
+ };
136
+ }
137
+
138
+ const fiveToSixtyMinCount = validPauses.filter(
139
+ sec => sec > DUAL_TTL_CONSTANTS.CACHE_TTL_SEC && sec <= DUAL_TTL_CONSTANTS.BILLING_TTL_SEC
140
+ ).length;
141
+
142
+ const fiveToSixtyMinRatio = Number((fiveToSixtyMinCount / totalIntervals).toFixed(4));
143
+ const fiveToSixtyMinPct = Number((fiveToSixtyMinRatio * 100).toFixed(2));
144
+ const recommend1hTierUpgrade = fiveToSixtyMinRatio >= thresholdRatio;
145
+
146
+ const advisoryMessage = recommend1hTierUpgrade
147
+ ? `Inter-turn pause telemetry: ${fiveToSixtyMinPct}% of turns (${fiveToSixtyMinCount}/${totalIntervals}) ` +
148
+ `followed a 5-to-60 minute pause (>= ${(thresholdRatio * 100).toFixed(1)}% break-even threshold). ` +
149
+ `Upgrade session prompt cache tier from 5m (1.25x) to 1h (2.0x) to prevent recurring cold prefix rewrites.`
150
+ : null;
151
+
152
+ return {
153
+ totalIntervals,
154
+ fiveToSixtyMinCount,
155
+ fiveToSixtyMinRatio,
156
+ fiveToSixtyMinPct,
157
+ thresholdRatio,
158
+ recommend1hTierUpgrade,
159
+ advisoryMessage
160
+ };
161
+ }
162
+
163
+ /**
164
+ * Stateful Dual-TTL countdown tracker.
165
+ */
166
+ export class DualTtlTracker {
167
+ constructor(options = {}) {
168
+ this.cacheTtlMs = options.cacheTtlMs || DUAL_TTL_CONSTANTS.CACHE_TTL_MS;
169
+ this.billingTtlMs = options.billingTtlMs || DUAL_TTL_CONSTANTS.BILLING_TTL_MS;
170
+ this.rolling = Boolean(options.rolling);
171
+ this.lastTurnTimestamp = Date.now();
172
+ this.pauseDurationsSeconds = [];
173
+ }
174
+
175
+ recordTurn(now = Date.now()) {
176
+ if (this.lastTurnTimestamp > 0) {
177
+ const pauseSec = Math.max(0, Math.floor((now - this.lastTurnTimestamp) / 1000));
178
+ this.pauseDurationsSeconds.push(pauseSec);
179
+ }
180
+ this.lastTurnTimestamp = now;
181
+ }
182
+
183
+ getCountdown(now = Date.now()) {
184
+ return calculateDualTtlCountdown(
185
+ this.lastTurnTimestamp,
186
+ now,
187
+ this.cacheTtlMs,
188
+ this.billingTtlMs,
189
+ { rolling: this.rolling }
190
+ );
191
+ }
192
+
193
+ getPauseAnalysis() {
194
+ return evaluatePauseDistribution(this.pauseDurationsSeconds);
195
+ }
196
+ }
197
+
198
+ export { TtlWatchdog } from '../coach/ttlWatchdog.mjs';
@@ -0,0 +1,47 @@
1
+ /**
2
+ * @file src/core-isomorphic/economics/index.mjs
3
+ * Unified Token Economics, Latency Telemetry, and Cache Retention Radar Module.
4
+ *
5
+ * Consolidates:
6
+ * - Feature 17: TTFT & Thinking Drift Detection (`driftLatency.mjs`)
7
+ * - Feature 18: 95% Prefix-Cache Retention Radar (`retentionRadar.mjs`)
8
+ * - Feature 19: Algebraic C* Break-Even Router (`cacheGravity.mjs`)
9
+ * - Feature 20: Haiku 100k 5x Cliff Breaker (`cliffBreaker.mjs`)
10
+ * - Feature 21: 1s Live Dual-TTL Countdown (`dualTtl.mjs`)
11
+ * - Feature 22: 5-Hour Rolling Billing Blocks (`billingBlocks.mjs`)
12
+ *
13
+ * Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
14
+ */
15
+
16
+ export * from './driftLatency.mjs';
17
+ export * from './retentionRadar.mjs';
18
+ export * from './cacheGravity.mjs';
19
+ export * from './cliffBreaker.mjs';
20
+ export * from './dualTtl.mjs';
21
+ export * from './billingBlocks.mjs';
22
+
23
+ // Coach & Ledger backward-compatible exports (without duplicate export conflicts)
24
+ export {
25
+ PostCompactMutationQueue,
26
+ HysteresisLock,
27
+ CacheGravityRouter,
28
+ isPrefixInstructionFile,
29
+ normalizeFlightMode,
30
+ isSilentOrOffMode,
31
+ DEFAULT_ADVISORY_COOLDOWN_TURNS,
32
+ evaluatePreModelSwitch,
33
+ evaluateDet09PrefixMutationFence
34
+ } from '../coach/cacheGravityRouter.mjs';
35
+
36
+ export {
37
+ buildPreExpiryStateBaton,
38
+ DEFAULT_MIN_CACHED_TOKENS_FOR_WATCHDOG,
39
+ DEFAULT_AMBER_THRESHOLD_SECONDS,
40
+ DEFAULT_KEEP_ALIVE_THRESHOLD_SECONDS,
41
+ DEFAULT_SNAPSHOT_THRESHOLD_SECONDS,
42
+ ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD,
43
+ FIVE_MINUTES_SECONDS,
44
+ SIXTY_MINUTES_SECONDS
45
+ } from '../coach/ttlWatchdog.mjs';
46
+
47
+ export * from '../coach/savedQuotaLedger.mjs';
@@ -0,0 +1,348 @@
1
+ /**
2
+ * @file src/core-isomorphic/economics/retentionRadar.mjs
3
+ * Feature 18: 95% Prefix-Cache Retention Radar with Byte-Offset Diffing.
4
+ *
5
+ * Implements:
6
+ * - Isomorphic byte-offset mutation diffing via standard `new TextEncoder().encode()` (Uint8Array)
7
+ * - Prefix retention percentage calculation
8
+ * - 95% discount threshold alert & letter grading (Grade A >= 95%, Grade B 80-95%, Grade C < 80%)
9
+ * - Cache bust cause classification (role_prefix_mutation, rule_mutation, etc.)
10
+ * - Financial accounting: retained discount savings vs leaked cold prefill costs
11
+ *
12
+ * Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
13
+ */
14
+
15
+ export const PREFIX_RETENTION_THRESHOLDS = Object.freeze({
16
+ DISCOUNT_THRESHOLD_PCT: 95.0,
17
+ DIFF_GRADE_A_PCT: 95.0,
18
+ DIFF_GRADE_B_PCT: 80.0,
19
+ INDEX_GRADE_A_PCT: 90.0,
20
+ INDEX_GRADE_B_PCT: 70.0,
21
+ GRADE_A_PCT: 95.0,
22
+ GRADE_B_PCT: 80.0,
23
+ BUST_RATIO: 0.50
24
+ });
25
+
26
+ const DEFAULT_INPUT_PRICE_PER_1M = 3.00;
27
+ const DEFAULT_READ_PRICE_PER_1M = 0.30;
28
+
29
+ /**
30
+ * Compares two prompt strings byte-by-byte using standard isomorphic TextEncoder.
31
+ * Pinpoints the exact first byte offset where the prompts diverge.
32
+ *
33
+ * @param {string} [originalText='']
34
+ * @param {string} [mutatedText='']
35
+ * @returns {{
36
+ * firstDiffOffset: number,
37
+ * prefixMatchBytes: number,
38
+ * retentionPct: number,
39
+ * is95PctRetained: boolean,
40
+ * grade: 'A' | 'B' | 'C'
41
+ * }}
42
+ */
43
+ export function verifyRetentionRadarDiff(originalText = '', mutatedText = '') {
44
+ const encoder = new TextEncoder();
45
+ const bufOrig = encoder.encode(String(originalText ?? ''));
46
+ const bufMut = encoder.encode(String(mutatedText ?? ''));
47
+
48
+ let firstDiffOffset = -1;
49
+ const minLen = Math.min(bufOrig.length, bufMut.length);
50
+
51
+ // Fast 32-bit chunking comparison
52
+ const u32Len = Math.floor(minLen / 4);
53
+ const u1 = new Uint32Array(bufOrig.buffer, bufOrig.byteOffset, Math.floor(bufOrig.byteLength / 4));
54
+ const u2 = new Uint32Array(bufMut.buffer, bufMut.byteOffset, Math.floor(bufMut.byteLength / 4));
55
+
56
+ let chunkIdx = 0;
57
+ while (chunkIdx < u32Len && u1[chunkIdx] === u2[chunkIdx]) {
58
+ chunkIdx++;
59
+ }
60
+
61
+ for (let i = chunkIdx * 4; i < minLen; i++) {
62
+ if (bufOrig[i] !== bufMut[i]) {
63
+ firstDiffOffset = i;
64
+ break;
65
+ }
66
+ }
67
+
68
+ if (firstDiffOffset === -1 && bufOrig.length !== bufMut.length) {
69
+ firstDiffOffset = minLen;
70
+ }
71
+
72
+ const prefixMatchBytes = firstDiffOffset === -1 ? bufOrig.length : firstDiffOffset;
73
+ const retentionPct = bufOrig.length === 0
74
+ ? 100
75
+ : parseFloat(((prefixMatchBytes / bufOrig.length) * 100).toFixed(2));
76
+
77
+ let grade = 'C';
78
+ if (retentionPct >= PREFIX_RETENTION_THRESHOLDS.GRADE_A_PCT) {
79
+ grade = 'A';
80
+ } else if (retentionPct >= PREFIX_RETENTION_THRESHOLDS.GRADE_B_PCT) {
81
+ grade = 'B';
82
+ }
83
+
84
+ return {
85
+ firstDiffOffset,
86
+ prefixMatchBytes,
87
+ retentionPct,
88
+ is95PctRetained: retentionPct >= PREFIX_RETENTION_THRESHOLDS.DISCOUNT_THRESHOLD_PCT,
89
+ grade
90
+ };
91
+ }
92
+
93
+ /**
94
+ * Finds the first mutation offset between two texts, including line and column numbers
95
+ * and a 40-character contextual snippet.
96
+ *
97
+ * @param {string} prevText
98
+ * @param {string} currText
99
+ * @returns {{
100
+ * firstDiffOffset: number,
101
+ * line: number,
102
+ * column: number,
103
+ * snippet: string,
104
+ * retentionPct: number,
105
+ * is95PctRetained: boolean,
106
+ * grade: 'A' | 'B' | 'C'
107
+ * }}
108
+ */
109
+ export function findPrefixMutationOffset(prevText = '', currText = '') {
110
+ const diff = verifyRetentionRadarDiff(prevText, currText);
111
+ const offset = diff.firstDiffOffset;
112
+
113
+ if (offset === -1) {
114
+ return {
115
+ ...diff,
116
+ line: 1,
117
+ column: 1,
118
+ snippet: ''
119
+ };
120
+ }
121
+
122
+ const text = String(currText ?? '');
123
+ const bufCurr = new TextEncoder().encode(text);
124
+
125
+ // Safely convert UTF-8 byte offset to UTF-16 code unit index.
126
+ // Clamp safeOffset within bounds and step backward past any UTF-8 continuation bytes (0x80..0xBF)
127
+ // so TextDecoder never decodes a truncated multibyte sequence or emits \uFFFD.
128
+ let safeOffset = Math.max(0, Math.min(offset, bufCurr.length));
129
+ while (safeOffset > 0 && (bufCurr[safeOffset] & 0xC0) === 0x80) {
130
+ safeOffset--;
131
+ }
132
+
133
+ const charOffset = new TextDecoder().decode(bufCurr.subarray(0, safeOffset)).length;
134
+ const textBefore = text.slice(0, charOffset);
135
+ const lines = textBefore.split('\n');
136
+ const line = lines.length;
137
+ const column = lines[lines.length - 1].length + 1;
138
+
139
+ const start = Math.max(0, charOffset - 15);
140
+ const end = Math.min(text.length, charOffset + 25);
141
+ const snippet = text.slice(start, end);
142
+
143
+ return {
144
+ ...diff,
145
+ line,
146
+ column,
147
+ snippet
148
+ };
149
+ }
150
+
151
+ /**
152
+ * Classifies the likely cause of a prefix cache bust based on diff offset and text contents.
153
+ *
154
+ * @param {number} firstDiffOffset
155
+ * @param {string} [mutatedText='']
156
+ * @returns {string}
157
+ */
158
+ export function classifyBustCause(firstDiffOffset, mutatedText = '') {
159
+ if (firstDiffOffset < 0) return 'none';
160
+ if (firstDiffOffset < 60) return 'role_prefix_mutation';
161
+ const prefix = String(mutatedText).slice(0, firstDiffOffset + 100);
162
+ if (/rule|instruction|guideline|invariant/i.test(prefix)) {
163
+ return 'rule_mutation';
164
+ }
165
+ if (/tool|function|schema|mcp/i.test(prefix)) {
166
+ return 'tools_changed';
167
+ }
168
+ if (/system\s+prompt/i.test(prefix)) {
169
+ return 'system_prompt_mutation';
170
+ }
171
+ return 'prefix_drift';
172
+ }
173
+
174
+ /**
175
+ * Creates an empty initial prefix retention accumulator.
176
+ * @returns {object}
177
+ */
178
+ export function createInitialPrefixRetention() {
179
+ return {
180
+ measured: false,
181
+ measuredTurns: 0,
182
+ bustCount: 0,
183
+ ttlExpiredTurns: 0,
184
+ retentionIndexPct: 100,
185
+ grade: 'A',
186
+ series: [],
187
+ retainedDiscountSavingsUSD: 0,
188
+ leakedColdPrefillUSD: 0,
189
+ lastDiff: null
190
+ };
191
+ }
192
+
193
+ /**
194
+ * Computes multi-turn prefix retention metrics and dollar savings across turns.
195
+ *
196
+ * @param {Array<object>} turns
197
+ * @param {object} [options={}]
198
+ * @param {number} [options.inputPricePer1M]
199
+ * @param {number} [options.readPricePer1M]
200
+ * @returns {object}
201
+ */
202
+ export function computePrefixRetention(turns = [], options = {}) {
203
+ const rawInputPrice = Number(options.inputPricePer1M ?? DEFAULT_INPUT_PRICE_PER_1M);
204
+ const rawReadPrice = Number(options.readPricePer1M ?? DEFAULT_READ_PRICE_PER_1M);
205
+ const inputPrice = Number.isFinite(rawInputPrice) ? rawInputPrice : DEFAULT_INPUT_PRICE_PER_1M;
206
+ const readPrice = Number.isFinite(rawReadPrice) ? rawReadPrice : DEFAULT_READ_PRICE_PER_1M;
207
+ const savingsPer1M = Math.max(0, inputPrice - readPrice);
208
+
209
+ if (!Array.isArray(turns) || turns.length === 0) {
210
+ return createInitialPrefixRetention();
211
+ }
212
+
213
+ let totalRetainedTokens = 0;
214
+ let totalEligibleTokens = 0;
215
+ let totalLeakedTokens = 0;
216
+ let bustCount = 0;
217
+ let ttlExpiredTurns = 0;
218
+ const series = [];
219
+
220
+ for (let i = 0; i < turns.length; i++) {
221
+ const t = turns[i];
222
+ if (t.ttlExpired) {
223
+ ttlExpiredTurns += 1;
224
+ series.push({ pct: null, bust: false, cause: 'ttl_expired', ttlExpired: true });
225
+ continue;
226
+ }
227
+
228
+ const rawEligible = Number(t.eligibleTokens ?? t.previousPrefixTokens ?? 0);
229
+ const rawRetained = Number(t.retainedTokens ?? t.cacheReadTokens ?? 0);
230
+ const eligible = Number.isFinite(rawEligible) ? Math.max(0, rawEligible) : 0;
231
+ const retained = Number.isFinite(rawRetained) ? Math.max(0, rawRetained) : 0;
232
+ const leaked = Math.max(0, eligible - retained);
233
+
234
+ totalEligibleTokens += eligible;
235
+ totalRetainedTokens += retained;
236
+ totalLeakedTokens += leaked;
237
+
238
+ const pct = eligible === 0 ? 100 : parseFloat(((retained / eligible) * 100).toFixed(1));
239
+ const isBust = eligible > 0 && (retained / eligible) < PREFIX_RETENTION_THRESHOLDS.BUST_RATIO;
240
+ if (isBust) bustCount += 1;
241
+
242
+ series.push({
243
+ turnIndex: i + 1,
244
+ pct,
245
+ bust: isBust,
246
+ cause: t.bustCause || (isBust ? 'prefix_drift' : 'none'),
247
+ ttlExpired: false,
248
+ savedUSD: parseFloat(((retained * savingsPer1M) / 1_000_000).toFixed(4)),
249
+ leakedUSD: parseFloat(((leaked * savingsPer1M) / 1_000_000).toFixed(4))
250
+ });
251
+ }
252
+
253
+ const retentionIndexPct = totalEligibleTokens === 0
254
+ ? 100
255
+ : parseFloat(((totalRetainedTokens / totalEligibleTokens) * 100).toFixed(1));
256
+
257
+ let grade = 'C';
258
+ if (retentionIndexPct >= PREFIX_RETENTION_THRESHOLDS.INDEX_GRADE_A_PCT) {
259
+ grade = 'A';
260
+ } else if (retentionIndexPct >= PREFIX_RETENTION_THRESHOLDS.INDEX_GRADE_B_PCT) {
261
+ grade = 'B';
262
+ }
263
+
264
+ const retainedDiscountSavingsUSD = parseFloat(((totalRetainedTokens * savingsPer1M) / 1_000_000).toFixed(4));
265
+ const leakedColdPrefillUSD = parseFloat(((totalLeakedTokens * savingsPer1M) / 1_000_000).toFixed(4));
266
+
267
+ return {
268
+ measured: series.length > 0,
269
+ measuredTurns: series.length,
270
+ bustCount,
271
+ ttlExpiredTurns,
272
+ retentionIndexPct,
273
+ grade,
274
+ series,
275
+ retainedDiscountSavingsUSD,
276
+ leakedColdPrefillUSD,
277
+ lastDiff: null
278
+ };
279
+ }
280
+
281
+ /**
282
+ * Stateful RetentionRadar tracker for rolling turns.
283
+ */
284
+ export class RetentionRadar {
285
+ constructor(options = {}) {
286
+ this.options = options;
287
+ this.state = createInitialPrefixRetention();
288
+ this.lastPrompt = '';
289
+ }
290
+
291
+ /**
292
+ * Records a turn's prompt and updates the radar state.
293
+ * @param {string} promptText
294
+ * @param {object} [metadata={}]
295
+ * @returns {object} Diff result
296
+ */
297
+ recordTurn(promptText = '', metadata = {}) {
298
+ const isFirstTurn = this.lastPrompt === '';
299
+ const diff = verifyRetentionRadarDiff(this.lastPrompt, promptText);
300
+ this.state.lastDiff = diff;
301
+ this.state.measured = true;
302
+ this.state.measuredTurns += 1;
303
+
304
+ const isBust = diff.retentionPct < 50;
305
+ if (isBust) this.state.bustCount += 1;
306
+
307
+ const cause = isFirstTurn || diff.retentionPct >= PREFIX_RETENTION_THRESHOLDS.DISCOUNT_THRESHOLD_PCT
308
+ ? 'none'
309
+ : classifyBustCause(diff.firstDiffOffset, promptText);
310
+
311
+ this.state.series.push({
312
+ turnIndex: this.state.measuredTurns,
313
+ pct: diff.retentionPct,
314
+ bust: isBust,
315
+ cause,
316
+ ttlExpired: Boolean(metadata.ttlExpired)
317
+ });
318
+
319
+ this.lastPrompt = promptText;
320
+ return diff;
321
+ }
322
+
323
+ getState() {
324
+ return this.state;
325
+ }
326
+ }
327
+
328
+ /**
329
+ * Returns a compact 1-line retention summary for statuslines.
330
+ * @param {object} retention
331
+ * @returns {string}
332
+ */
333
+ export function formatRetentionCompact(retention) {
334
+ if (!retention?.measured) return 'Cache: —';
335
+ const pct = retention.retentionIndexPct ?? 100;
336
+ const grade = retention.grade ?? 'A';
337
+ return `Cache: ${pct}% [${grade}]`;
338
+ }
339
+
340
+ /**
341
+ * Formats a detailed retention label for reports.
342
+ * @param {object} retention
343
+ * @returns {string}
344
+ */
345
+ export function formatRetentionLabel(retention) {
346
+ if (!retention?.measured) return 'Prefix retention unmeasured';
347
+ return `${retention.retentionIndexPct}% retained (${retention.grade}) · ${retention.bustCount} busts`;
348
+ }