ctxtop 4.1.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 (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,321 @@
1
+ /**
2
+ * @file src/core-isomorphic/coach/resumeToolsetAuditor.mjs
3
+ * Session-resume MCP / tool-set change auditor (`Item 6`).
4
+ *
5
+ * Evidence (`t6_layers.csv` arm `CC-T`):
6
+ * Resuming a warm session with a changed `--mcp-config` / tool definition list invalidated
7
+ * the entire KV prefix (`0` cache read tokens on turn 6).
8
+ *
9
+ * Hook visibility on Claude Code `2.1.325` (`$0` verified):
10
+ * `SessionStart:resume` stdin includes `session_id`, `transcript_path`, `cwd`, `source`,
11
+ * `seconds_since_last_response`, `context_tokens`, `prompt_cache_likely_expired`, and
12
+ * `estimated_cache_write_usd` — it does NOT pass `tools` or `mcp_servers` directly, and
13
+ * `deferred_tools_delta` is appended to `.jsonl` after `SessionStart` during `system/init`.
14
+ * Therefore this auditor hashes MCP & tool configuration from `.mcp.json`, `.claude/settings*.json`,
15
+ * `~/.claude.json`, explicit CLI `--mcp-config`/`--tools` flags if supplied, and optional host
16
+ * `event.tools`/`event.mcp_servers` arrays (using pure runtime I/O adapters per Mod Law 4).
17
+ */
18
+
19
+ import {
20
+ basenamePath,
21
+ fileExists,
22
+ getCwd,
23
+ getHomeDir,
24
+ joinPath,
25
+ readJsonSafe,
26
+ readTextSafe,
27
+ resolvePath,
28
+ sha256Hex
29
+ } from '../utils/runtime.mjs';
30
+ import {
31
+ isKnownCatalogModel,
32
+ normalizeModelId,
33
+ resolveEffectiveRates
34
+ } from '../config/catalogLoader.mjs';
35
+
36
+ function normalizeServerEntry(entry) {
37
+ if (!entry || typeof entry !== 'object') return null;
38
+ const envKeys =
39
+ entry.env && typeof entry.env === 'object' ? Object.keys(entry.env).sort() : [];
40
+ return {
41
+ type: String(entry.type || (entry.url ? 'http' : 'stdio')),
42
+ command: entry.command ? String(entry.command) : null,
43
+ args: Array.isArray(entry.args) ? entry.args.map(String) : [],
44
+ url: entry.url ? String(entry.url) : null,
45
+ envKeys,
46
+ disabled: Boolean(entry.disabled)
47
+ };
48
+ }
49
+
50
+ function mergeMcpServers(target, sourceObj) {
51
+ if (!sourceObj || typeof sourceObj !== 'object' || Array.isArray(sourceObj)) return;
52
+ for (const [name, cfg] of Object.entries(sourceObj)) {
53
+ const cleanName = String(name || '').trim();
54
+ if (!cleanName) continue;
55
+ const normalized = normalizeServerEntry(cfg);
56
+ if (normalized) {
57
+ target[cleanName] = normalized;
58
+ }
59
+ }
60
+ }
61
+
62
+ function parseCliMcpFlags(cliArgs = []) {
63
+ const args = Array.isArray(cliArgs) ? cliArgs.map(String) : [];
64
+ const mcpConfigs = [];
65
+ const toolFlags = [];
66
+ for (let i = 0; i < args.length; i += 1) {
67
+ const tok = args[i];
68
+ if (tok === '--mcp-config' && i + 1 < args.length) {
69
+ mcpConfigs.push(args[i + 1]);
70
+ i += 1;
71
+ } else if (tok.startsWith('--mcp-config=')) {
72
+ mcpConfigs.push(tok.slice('--mcp-config='.length));
73
+ } else if (
74
+ (tok === '--tools' || tok === '--allowedTools' || tok === '--disallowedTools') &&
75
+ i + 1 < args.length
76
+ ) {
77
+ toolFlags.push(`${tok}:${args[i + 1]}`);
78
+ i += 1;
79
+ } else if (
80
+ tok.startsWith('--tools=') ||
81
+ tok.startsWith('--allowedTools=') ||
82
+ tok.startsWith('--disallowedTools=')
83
+ ) {
84
+ toolFlags.push(tok);
85
+ }
86
+ }
87
+ return { mcpConfigs, toolFlags: toolFlags.sort() };
88
+ }
89
+
90
+ function tryReadParentProcCmdline(options = {}) {
91
+ try {
92
+ const proc = globalThis.process;
93
+ if (proc?.platform === 'linux' && proc?.ppid) {
94
+ const cmdlinePath = `/proc/${proc.ppid}/cmdline`;
95
+ if (fileExists(cmdlinePath, options)) {
96
+ const raw = readTextSafe(cmdlinePath, '', options);
97
+ if (typeof raw === 'string' && raw.length > 0) {
98
+ return raw.split('\0').filter(Boolean);
99
+ }
100
+ }
101
+ }
102
+ } catch {
103
+ // Fail-open; zero subprocess spawning in hot hook path
104
+ }
105
+ return null;
106
+ }
107
+
108
+ /**
109
+ * Computes a deterministic SHA-256 hash of observable active MCP server & tool configuration.
110
+ * Strictly read-only, excludes secret env values, and never throws on malformed files.
111
+ *
112
+ * @param {object} [event={}]
113
+ * @param {object} [options={}]
114
+ * @returns {{ hash: string, serverNames: string[], toolCount: number, toolNames: string[], cliFlags: string[], sourcesInspected: string[], recordedAt: string }}
115
+ */
116
+ export function computeActiveToolsetHash(event = {}, options = {}) {
117
+ const cwd = event.cwd || getCwd(options);
118
+ const homeDir = options.homeDir || event.homeDir || getHomeDir(options);
119
+ const ioOpts = { ...options, cwd, homeDir };
120
+ const mcpServers = {};
121
+ const toolSet = new Set();
122
+ const sourcesInspected = [];
123
+
124
+ // 1. Optional host-provided arrays (in case host or future CLI includes them)
125
+ if (Array.isArray(event.tools)) {
126
+ sourcesInspected.push('event.tools');
127
+ for (const t of event.tools) {
128
+ const name = typeof t === 'string' ? t : t?.name || t?.id;
129
+ if (name) toolSet.add(String(name));
130
+ }
131
+ }
132
+ if (event.mcp_servers && typeof event.mcp_servers === 'object') {
133
+ sourcesInspected.push('event.mcp_servers');
134
+ if (Array.isArray(event.mcp_servers)) {
135
+ for (const s of event.mcp_servers) {
136
+ const sName = typeof s === 'string' ? s : s?.name;
137
+ if (sName) {
138
+ mcpServers[String(sName)] = normalizeServerEntry(
139
+ typeof s === 'object' ? s : { type: 'configured' }
140
+ );
141
+ }
142
+ }
143
+ } else {
144
+ mergeMcpServers(mcpServers, event.mcp_servers);
145
+ }
146
+ }
147
+ if (event.mcpServers && typeof event.mcpServers === 'object') {
148
+ sourcesInspected.push('event.mcpServers');
149
+ mergeMcpServers(mcpServers, event.mcpServers);
150
+ }
151
+
152
+ // 2. ~/.claude.json user + workspace project MCP config
153
+ if (options.includeUserClaudeJson !== false && homeDir) {
154
+ const userClaudePath = joinPath(homeDir, '.claude.json');
155
+ const userClaude = readJsonSafe(userClaudePath, null, ioOpts);
156
+ if (userClaude && typeof userClaude === 'object') {
157
+ sourcesInspected.push('home:.claude.json');
158
+ mergeMcpServers(mcpServers, userClaude.mcpServers);
159
+ if (cwd && userClaude.projects && typeof userClaude.projects === 'object') {
160
+ const normCwd = resolvePath(cwd).toLowerCase();
161
+ for (const [projPath, projCfg] of Object.entries(userClaude.projects)) {
162
+ if (
163
+ resolvePath(projPath).toLowerCase() === normCwd &&
164
+ projCfg &&
165
+ typeof projCfg === 'object'
166
+ ) {
167
+ mergeMcpServers(mcpServers, projCfg.mcpServers);
168
+ }
169
+ }
170
+ }
171
+ }
172
+ }
173
+
174
+ // 3. Project .mcp.json and .claude/settings*.json
175
+ const projectFiles = [
176
+ { rel: '.mcp.json', label: 'project:.mcp.json' },
177
+ { rel: '.claude/settings.json', label: 'project:.claude/settings.json' },
178
+ { rel: '.claude/settings.local.json', label: 'project:.claude/settings.local.json' }
179
+ ];
180
+ for (const pf of projectFiles) {
181
+ const fullPath = cwd ? joinPath(cwd, pf.rel) : null;
182
+ const parsed = fullPath ? readJsonSafe(fullPath, null, ioOpts) : null;
183
+ if (parsed && typeof parsed === 'object') {
184
+ sourcesInspected.push(pf.label);
185
+ mergeMcpServers(mcpServers, parsed.mcpServers);
186
+ if (Array.isArray(parsed.tools)) {
187
+ for (const t of parsed.tools) {
188
+ if (typeof t === 'string' && t.trim()) toolSet.add(t.trim());
189
+ }
190
+ }
191
+ if (Array.isArray(parsed.enabledMcpjsonServers)) {
192
+ for (const s of parsed.enabledMcpjsonServers) {
193
+ toolSet.add(`mcp_enabled:${String(s)}`);
194
+ }
195
+ }
196
+ if (Array.isArray(parsed.disabledMcpjsonServers)) {
197
+ for (const s of parsed.disabledMcpjsonServers) {
198
+ toolSet.add(`mcp_disabled:${String(s)}`);
199
+ }
200
+ }
201
+ }
202
+ }
203
+
204
+ // 4. Explicit CLI args or readable parent cmdline (--mcp-config / --tools / --allowedTools)
205
+ const rawCliArgs =
206
+ options.cliArgs ?? event.cliArgs ?? event.cli_args ?? tryReadParentProcCmdline(ioOpts) ?? [];
207
+ const { mcpConfigs, toolFlags } = parseCliMcpFlags(rawCliArgs);
208
+ for (const cfgArg of mcpConfigs) {
209
+ const resolved = cwd ? resolvePath(cwd, cfgArg) : resolvePath(cfgArg);
210
+ const parsedCfg = readJsonSafe(resolved, null, ioOpts);
211
+ if (parsedCfg && typeof parsedCfg === 'object') {
212
+ sourcesInspected.push(`cli:--mcp-config(${basenamePath(resolved)})`);
213
+ mergeMcpServers(mcpServers, parsedCfg.mcpServers || parsedCfg);
214
+ } else {
215
+ toolFlags.push(`mcp-config:${basenamePath(cfgArg)}`);
216
+ }
217
+ }
218
+
219
+ const orderedServers = {};
220
+ for (const name of Object.keys(mcpServers).sort()) {
221
+ orderedServers[name] = mcpServers[name];
222
+ }
223
+ const toolNames = Array.from(toolSet).sort();
224
+ const payload = {
225
+ mcpServers: orderedServers,
226
+ tools: toolNames,
227
+ cliFlags: toolFlags
228
+ };
229
+
230
+ const hash = sha256Hex(JSON.stringify(payload), options);
231
+
232
+ return {
233
+ hash,
234
+ serverNames: Object.keys(orderedServers),
235
+ toolNames,
236
+ toolCount: toolNames.length,
237
+ cliFlags: toolFlags,
238
+ sourcesInspected,
239
+ recordedAt: new Date().toISOString()
240
+ };
241
+ }
242
+
243
+ /**
244
+ * Evaluates whether a changed tool-set / MCP config on `SessionStart:resume` warrants a one-line
245
+ * cache-rewrite advisory (`Item 6`, citing `t6_layers.csv` arm `CC-T`).
246
+ *
247
+ * @param {object} [params={}]
248
+ * @param {object} [options={}]
249
+ * @returns {object}
250
+ */
251
+ export function evaluateResumeToolsetChange(params = {}, options = {}) {
252
+ const prev = params.previousHashRecord || null;
253
+ const curr = params.currentHashRecord || null;
254
+ const contextTokens = Math.max(0, Number(params.contextTokens ?? 0));
255
+ const minTokens = Math.max(0, Number(params.minContextTokens ?? 10_000));
256
+ const cacheExpired = Boolean(params.cacheExpired);
257
+ const ttlTier = params.cacheTtlTier === '1h' ? '1h' : '5m';
258
+ const rawModel = params.modelId || 'claude-sonnet-5-5';
259
+
260
+ if (!prev?.hash || !curr?.hash) {
261
+ return { changed: false, shouldWarn: false, reason: 'no_baseline', advisory: null };
262
+ }
263
+ if (prev.hash === curr.hash) {
264
+ return { changed: false, shouldWarn: false, reason: 'unchanged', advisory: null };
265
+ }
266
+ if (cacheExpired) {
267
+ return { changed: true, shouldWarn: false, reason: 'cache_already_expired', advisory: null };
268
+ }
269
+ if (contextTokens < minTokens) {
270
+ return { changed: true, shouldWarn: false, reason: 'small_or_cold_context', advisory: null };
271
+ }
272
+
273
+ const prevSet = new Set(Array.isArray(prev.serverNames) ? prev.serverNames : []);
274
+ const currSet = new Set(Array.isArray(curr.serverNames) ? curr.serverNames : []);
275
+ const added = [...currSet].filter((s) => !prevSet.has(s));
276
+ const removed = [...prevSet].filter((s) => !currSet.has(s));
277
+ const diffParts = [];
278
+ if (added.length > 0) diffParts.push(`+${added.join(',+')}`);
279
+ if (removed.length > 0) diffParts.push(`-${removed.join(',-')}`);
280
+ const diffSummary = diffParts.length > 0 ? diffParts.join(' ') : 'MCP/tool definitions updated';
281
+
282
+ const knownModel = isKnownCatalogModel(rawModel, options);
283
+ if (!knownModel) {
284
+ const advisory =
285
+ `[Highbeam Resume Toolset Advisory] Active MCP/tool set changed (${diffSummary}); ` +
286
+ `prices are unknown for ${String(rawModel)}, and the first turn will rewrite ~${Math.round(contextTokens).toLocaleString()} cached tokens (t6_layers CC-T).`;
287
+ return {
288
+ changed: true,
289
+ shouldWarn: true,
290
+ unknownModel: true,
291
+ estimatedWriteCostUSD: null,
292
+ diffSummary,
293
+ advisory
294
+ };
295
+ }
296
+
297
+ const modelId = normalizeModelId(rawModel, options);
298
+ const rates = resolveEffectiveRates(modelId, contextTokens, options);
299
+ const writeRate = ttlTier === '1h' ? rates.write1hPer1M : rates.write5mPer1M;
300
+ const estimatedWriteCostUSD = Number(((contextTokens / 1_000_000) * writeRate).toFixed(4));
301
+
302
+ const advisory =
303
+ `[Highbeam Resume Toolset Advisory] Active MCP/tool set changed (${diffSummary}); ` +
304
+ `the first turn will rewrite ~${Math.round(contextTokens).toLocaleString()} cached tokens ` +
305
+ `(~$${estimatedWriteCostUSD.toFixed(4)} at ${modelId} ${ttlTier} write rate, t6_layers CC-T).`;
306
+
307
+ return {
308
+ changed: true,
309
+ shouldWarn: true,
310
+ unknownModel: false,
311
+ modelId,
312
+ estimatedWriteCostUSD,
313
+ diffSummary,
314
+ advisory
315
+ };
316
+ }
317
+
318
+ export default {
319
+ computeActiveToolsetHash,
320
+ evaluateResumeToolsetChange
321
+ };