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,316 @@
1
+ /**
2
+ * @file src/core-isomorphic/coach/effortShiftDetector.mjs
3
+ * Passive Turn-Boundary Effort-Shift Detector (`PostEffortChange` equivalent).
4
+ *
5
+ * Pure zero-I/O module (safe for in-process Claude Code Mod runtime in `hooks/register.js`):
6
+ * - Tracks mid-session `/effort` shifts when Claude Code lacks `PreEffortChange`.
7
+ * - Attributes prefix rewrite penalties (`DET-09`) on cache-invalidating `4.6` models
8
+ * (both explicit effort changes and inferred whole-prefix rewrites).
9
+ * - Preserves zero-noise silence on cache-safe `5.5+` models for single high-effort turns,
10
+ * while flagging consecutive routine-turn thinking spikes (`DET-21`) with a 3-turn cooldown.
11
+ */
12
+
13
+ import {
14
+ isKnownCatalogModel,
15
+ normalizeModelId,
16
+ resolveEffectiveRates
17
+ } from '../config/catalogLoader.mjs';
18
+ import { getEffortMutationCacheCapability } from './cacheGravityRouter.mjs';
19
+
20
+ export const WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS = 50000;
21
+ export const ROUTINE_THINKING_SPIKE_MIN_TOKENS = 4000;
22
+ export const ROUTINE_THINKING_TO_OUTPUT_RATIO = 4;
23
+ export const EFFORT_ADVISORY_COOLDOWN_TURNS = 3;
24
+
25
+ const EFFORT_ALIASES = Object.freeze({
26
+ low: 'low',
27
+ medium: 'medium',
28
+ med: 'medium',
29
+ normal: 'medium',
30
+ high: 'high',
31
+ max: 'max',
32
+ xhigh: 'max'
33
+ });
34
+
35
+ /**
36
+ * Normalizes a raw effort string (`low | med | medium | normal | high | max | xhigh`)
37
+ * to canonical values (`low | medium | high | max`), or `null` if absent/unrecognized.
38
+ *
39
+ * @param {unknown} raw
40
+ * @returns {'low'|'medium'|'high'|'max'|null}
41
+ */
42
+ export function normalizeEffortLevel(raw) {
43
+ if (typeof raw !== 'string') return null;
44
+ const cleaned = raw.trim().toLowerCase();
45
+ return EFFORT_ALIASES[cleaned] || null;
46
+ }
47
+
48
+ /**
49
+ * Extracts normalized `{ effortLevel, thinkingBudget }` from Mod, `statusLine`,
50
+ * or `UserPromptSubmit` event payloads.
51
+ *
52
+ * @param {object} [payload={}]
53
+ * @returns {{ effortLevel: 'low'|'medium'|'high'|'max'|null, thinkingBudget: number|null }}
54
+ */
55
+ export function extractEventEffortObservation(payload = {}) {
56
+ if (!payload || typeof payload !== 'object') {
57
+ return { effortLevel: null, thinkingBudget: null };
58
+ }
59
+
60
+ const rawEffortCandidates = [
61
+ payload.effort,
62
+ payload.effortLevel,
63
+ payload.effort_level,
64
+ payload.reasoningEffort,
65
+ payload.reasoning_effort,
66
+ payload.model?.effort,
67
+ payload.config?.effortLevel,
68
+ payload.settings?.effortLevel,
69
+ payload.result?.effort
70
+ ];
71
+
72
+ let effortLevel = null;
73
+ for (const candidate of rawEffortCandidates) {
74
+ const normalized = normalizeEffortLevel(candidate);
75
+ if (normalized) {
76
+ effortLevel = normalized;
77
+ break;
78
+ }
79
+ }
80
+
81
+ const rawBudget =
82
+ payload.thinkingBudget ??
83
+ payload.thinking_budget ??
84
+ payload.thinking?.budget_tokens ??
85
+ null;
86
+ let thinkingBudget = null;
87
+ if (rawBudget !== null && rawBudget !== undefined && rawBudget !== '') {
88
+ const parsedBudget = Number(rawBudget);
89
+ if (Number.isFinite(parsedBudget) && parsedBudget >= 0) {
90
+ thinkingBudget = parsedBudget;
91
+ }
92
+ }
93
+
94
+ return { effortLevel, thinkingBudget };
95
+ }
96
+
97
+ /**
98
+ * Creates a clean initial effort-tracking state object for session telemetry.
99
+ *
100
+ * @returns {{
101
+ * currentEffort: string|null,
102
+ * previousEffort: string|null,
103
+ * currentThinkingBudget: number|null,
104
+ * shiftCount: number,
105
+ * highEffortRoutineStreak: number,
106
+ * lastShiftTurn: number|null,
107
+ * lastAdvisoryTurn: number|null,
108
+ * pendingAdvisory: object|null
109
+ * }}
110
+ */
111
+ export function createInitialEffortTrackingState() {
112
+ return {
113
+ currentEffort: null,
114
+ previousEffort: null,
115
+ currentThinkingBudget: null,
116
+ shiftCount: 0,
117
+ highEffortRoutineStreak: 0,
118
+ lastShiftTurn: null,
119
+ lastAdvisoryTurn: null,
120
+ pendingAdvisory: null
121
+ };
122
+ }
123
+
124
+ /**
125
+ * Updates turn-boundary effort tracking and evaluates `DET-09` rewrite attribution
126
+ * or `DET-21` routine-turn high-effort thinking spike advisories.
127
+ *
128
+ * @param {object|null|undefined} prevTracking
129
+ * @param {object} [observation={}]
130
+ * @param {object} [options={}]
131
+ * @returns {object} Updated effort tracking snapshot
132
+ */
133
+ export function applyTurnEffortObservation(prevTracking, observation = {}, options = {}) {
134
+ const tracking = {
135
+ ...createInitialEffortTrackingState(),
136
+ ...(prevTracking && typeof prevTracking === 'object' ? prevTracking : {})
137
+ };
138
+
139
+ const modelId = observation.modelId || observation.rawModelId || 'claude-sonnet-5-5';
140
+ const rawModelId = observation.rawModelId || modelId;
141
+ const normObserved = normalizeEffortLevel(observation.observedEffort);
142
+ const observedThinkingBudget =
143
+ observation.observedThinkingBudget !== undefined && observation.observedThinkingBudget !== null
144
+ ? Number(observation.observedThinkingBudget)
145
+ : null;
146
+ if (Number.isFinite(observedThinkingBudget) && observedThinkingBudget >= 0) {
147
+ tracking.currentThinkingBudget = observedThinkingBudget;
148
+ }
149
+
150
+ const turnIndex = Math.max(1, Number(observation.turnIndex ?? 1) || 1);
151
+ const priorTurnsCompleted = Math.max(0, Number(observation.priorTurnsCompleted ?? 0) || 0);
152
+ const priorModelId = observation.priorModelId || null;
153
+ const priorWarmPrefixTokens = Math.max(0, Number(observation.priorWarmPrefixTokens || 0));
154
+ const priorCacheWarm = Boolean(observation.priorCacheWarm);
155
+ const cacheReadTokens = Math.max(0, Number(observation.cacheReadTokens || 0));
156
+ const cacheWriteTokens = Math.max(0, Number(observation.cacheWriteTokens || 0));
157
+ const outputTokens = Math.max(0, Number(observation.outputTokens || 0));
158
+ const thinkingTokens = Math.max(0, Number(observation.thinkingTokens || 0));
159
+ const turnMutations = Number(observation.turnMutations ?? 0) || 0;
160
+ const ttlTier = observation.ttlTier === '1h' ? '1h' : '5m';
161
+
162
+ let explicitShift = false;
163
+ if (normObserved) {
164
+ if (tracking.currentEffort === null) {
165
+ if (priorTurnsCompleted >= 1 && options.treatFirstObservationAfterStartAsShift === true) {
166
+ explicitShift = true;
167
+ } else {
168
+ tracking.currentEffort = normObserved;
169
+ }
170
+ } else if (normObserved !== tracking.currentEffort) {
171
+ explicitShift = true;
172
+ }
173
+ }
174
+
175
+ const knownModel = isKnownCatalogModel(rawModelId, options);
176
+ const normalizedModel = knownModel
177
+ ? normalizeModelId(rawModelId, options)
178
+ : String(rawModelId || 'unknown');
179
+ const effortCap = getEffortMutationCacheCapability(rawModelId, options);
180
+
181
+ const normalizedPriorModel =
182
+ priorModelId && isKnownCatalogModel(priorModelId, options)
183
+ ? normalizeModelId(priorModelId, options)
184
+ : priorModelId
185
+ ? String(priorModelId)
186
+ : null;
187
+
188
+ const inferredLegacy46Rewrite = Boolean(
189
+ !explicitShift &&
190
+ effortCap.invalidatesCache === 'yes' &&
191
+ priorCacheWarm === true &&
192
+ priorWarmPrefixTokens >= WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS &&
193
+ normalizedPriorModel &&
194
+ normalizedPriorModel === normalizedModel &&
195
+ cacheReadTokens === 0 &&
196
+ cacheWriteTokens >= WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS * 0.8
197
+ );
198
+
199
+ if (explicitShift || inferredLegacy46Rewrite) {
200
+ const fromEffort = tracking.currentEffort;
201
+ const toEffort = normObserved || tracking.currentEffort;
202
+ tracking.shiftCount += 1;
203
+ tracking.previousEffort = fromEffort;
204
+ tracking.currentEffort = toEffort;
205
+ tracking.lastShiftTurn = turnIndex;
206
+
207
+ if (!knownModel || effortCap.invalidatesCache === 'unknown') {
208
+ if (priorWarmPrefixTokens >= WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS) {
209
+ tracking.pendingAdvisory = {
210
+ advisoryId: `eff-${turnIndex}-${tracking.shiftCount}`,
211
+ detectorId: 'DET-09',
212
+ subType: 'POST_EFFORT_UNVERIFIED',
213
+ modelId: String(rawModelId),
214
+ fromEffort,
215
+ toEffort,
216
+ cachePreserved: null,
217
+ rewritePenaltyUSD: null,
218
+ message: `[Highbeam DET-09] Interactive /effort shift (${fromEffort || 'prior'} -> ${toEffort || 'new'}) detected over ${(priorWarmPrefixTokens / 1000).toFixed(1)}k warm tokens on ${rawModelId} (effort cache behavior unverified; prices/impact unverified).`
219
+ };
220
+ }
221
+ } else if (effortCap.invalidatesCache === 'yes') {
222
+ if (priorWarmPrefixTokens >= WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS) {
223
+ const warmTokens = Math.max(priorWarmPrefixTokens, inferredLegacy46Rewrite ? cacheWriteTokens : 0);
224
+ const rates = resolveEffectiveRates(
225
+ rawModelId,
226
+ Math.max(priorWarmPrefixTokens, cacheWriteTokens),
227
+ options
228
+ );
229
+ const writeRate = ttlTier === '1h' ? rates.write1hPer1M : rates.write5mPer1M;
230
+ const rewritePenaltyUSD = Number(
231
+ Math.max(0, (warmTokens / 1_000_000) * (writeRate - rates.readPer1M)).toFixed(6)
232
+ );
233
+ tracking.pendingAdvisory = {
234
+ advisoryId: `eff-${turnIndex}-${tracking.shiftCount}`,
235
+ detectorId: 'DET-09',
236
+ subType: 'POST_EFFORT_CACHE_REWRITE',
237
+ modelId: normalizedModel,
238
+ fromEffort,
239
+ toEffort,
240
+ cachePreserved: false,
241
+ inferredFromRewrite: Boolean(inferredLegacy46Rewrite && !explicitShift),
242
+ rewritePenaltyUSD,
243
+ message: `[Highbeam DET-09] Mid-session /effort shift${explicitShift ? ` (${fromEffort} -> ${toEffort})` : ''} rewrote ${(warmTokens / 1000).toFixed(1)}k warm prefix tokens (+$${rewritePenaltyUSD.toFixed(2)} USD) on ${rates.label}. Batch /effort changes with /compact or upgrade to 5.5+ (99.3% cache-safe).`
244
+ };
245
+ }
246
+ } else if (
247
+ (toEffort === 'high' || toEffort === 'max') &&
248
+ priorWarmPrefixTokens >= WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS
249
+ ) {
250
+ tracking.lastCacheSafeShift = {
251
+ turnIndex,
252
+ fromEffort,
253
+ toEffort,
254
+ preservedTokens: priorWarmPrefixTokens
255
+ };
256
+ }
257
+ }
258
+
259
+ const hasUsageObservation =
260
+ observation.evaluateThinkingSpike !== false &&
261
+ (thinkingTokens > 0 || outputTokens > 0 || observation.hasTurnUsage === true);
262
+
263
+ const highEffortOrThinkingSpike =
264
+ tracking.currentEffort === 'high' ||
265
+ tracking.currentEffort === 'max' ||
266
+ thinkingTokens >= ROUTINE_THINKING_SPIKE_MIN_TOKENS * 1.5;
267
+
268
+ if (hasUsageObservation) {
269
+ if (highEffortOrThinkingSpike) {
270
+ const isRoutineSpike =
271
+ turnMutations <= 1 &&
272
+ thinkingTokens >= ROUTINE_THINKING_SPIKE_MIN_TOKENS &&
273
+ thinkingTokens >= ROUTINE_THINKING_TO_OUTPUT_RATIO * Math.max(1, outputTokens);
274
+
275
+ if (isRoutineSpike) {
276
+ tracking.highEffortRoutineStreak += 1;
277
+ } else {
278
+ tracking.highEffortRoutineStreak = 0;
279
+ }
280
+
281
+ if (
282
+ tracking.highEffortRoutineStreak >= 2 &&
283
+ (tracking.lastAdvisoryTurn === null ||
284
+ turnIndex - tracking.lastAdvisoryTurn >= EFFORT_ADVISORY_COOLDOWN_TURNS)
285
+ ) {
286
+ tracking.lastAdvisoryTurn = turnIndex;
287
+ tracking.pendingAdvisory = {
288
+ advisoryId: `spk-${turnIndex}-${tracking.highEffortRoutineStreak}`,
289
+ detectorId: 'DET-21',
290
+ subType: 'HIGH_EFFORT_ROUTINE_SPIKE',
291
+ modelId: normalizedModel,
292
+ fromEffort: tracking.previousEffort,
293
+ toEffort: tracking.currentEffort || 'high',
294
+ cachePreserved: effortCap.invalidatesCache === 'no',
295
+ rewritePenaltyUSD: 0,
296
+ message: `[Highbeam DET-21] ${tracking.highEffortRoutineStreak} consecutive routine turns burned ${(thinkingTokens / 1000).toFixed(1)}k thinking tokens vs ${outputTokens} output tokens at /effort ${tracking.currentEffort || 'high'}. Consider '/effort medium' for routine reads/edits (KV cache remains preserved on 5.5+).`
297
+ };
298
+ }
299
+ } else {
300
+ tracking.highEffortRoutineStreak = 0;
301
+ }
302
+ }
303
+
304
+ return tracking;
305
+ }
306
+
307
+ export default {
308
+ WARM_EFFORT_ATTRIBUTION_FLOOR_TOKENS,
309
+ ROUTINE_THINKING_SPIKE_MIN_TOKENS,
310
+ ROUTINE_THINKING_TO_OUTPUT_RATIO,
311
+ EFFORT_ADVISORY_COOLDOWN_TURNS,
312
+ normalizeEffortLevel,
313
+ extractEventEffortObservation,
314
+ createInitialEffortTrackingState,
315
+ applyTurnEffortObservation
316
+ };
@@ -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
+ };