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
@@ -345,9 +345,10 @@ export function deriveSurfaceMetrics(state = {}, options = {}) {
345
345
  totalInputTokens,
346
346
  options
347
347
  );
348
- const liveSubagentIsolatedUSD = Number(
349
- ((liveSubagentIsolatedTokens / 1_000_000) * Number(activeRatesForSub.inputPer1M || 3)).toFixed(6)
350
- );
348
+ const liveSubagentIsolatedUSD =
349
+ activeRatesForSub && !activeRatesForSub.unknownModel && Number.isFinite(activeRatesForSub.inputPer1M)
350
+ ? Number(((liveSubagentIsolatedTokens / 1_000_000) * activeRatesForSub.inputPer1M).toFixed(6))
351
+ : 0;
351
352
 
352
353
  // Use explicit options.savedUSD / options.savedTokens if passed, else max of ledger + session
353
354
  const savedUSD =
@@ -478,10 +479,14 @@ export function deriveSurfaceMetrics(state = {}, options = {}) {
478
479
  totalInputTokens,
479
480
  options
480
481
  );
481
- const mWrite =
482
- ttlTier === '1h' ? activeRates.multipliers.write1h : activeRates.multipliers.write5m;
483
- const mRead = activeRates.multipliers.read;
484
- breakEvenReadsPerWrite = Number(((mWrite - 1) / (1 - mRead)).toFixed(3));
482
+ if (activeRates && !activeRates.unknownModel && activeRates.multipliers) {
483
+ const mWrite =
484
+ ttlTier === '1h' ? activeRates.multipliers.write1h : activeRates.multipliers.write5m;
485
+ const mRead = activeRates.multipliers.read;
486
+ breakEvenReadsPerWrite = Number(((mWrite - 1) / (1 - mRead)).toFixed(3));
487
+ } else {
488
+ breakEvenReadsPerWrite = null;
489
+ }
485
490
  }
486
491
  const sessionFiveMinRoiTarget = Number(roi.sessionFiveMinRoiTarget || 1.39);
487
492
 
@@ -724,6 +729,50 @@ export function deriveClaudeCodeVerdictAndActions(state = {}, grid, metrics, opt
724
729
  });
725
730
  }
726
731
 
732
+ const rslData = options.rsl || state.rsl || null;
733
+ if (rslData && Number(rslData.clashCount || 0) > 0) {
734
+ if (verdict.severity === 'healthy') {
735
+ verdict = {
736
+ severity: 'warn',
737
+ badge: 'RULE CLASH',
738
+ headline: `${rslData.clashCount} Conflicting Learned Rule${rslData.clashCount === 1 ? '' : 's'}`,
739
+ detail: 'Quarantined RSL heuristic conflict needs review before applying automatically'
740
+ };
741
+ }
742
+ actions.push({
743
+ id: 'rsl-clash',
744
+ severity: 'warn',
745
+ title: `Resolve ${rslData.clashCount} RSL rule clash${rslData.clashCount === 1 ? '' : 'es'}`,
746
+ instruction: 'Run `npx ah rsl status` to inspect and resolve conflicting workspace heuristics.',
747
+ commandHint: 'npx ah rsl status',
748
+ reclaimTokens: 0
749
+ });
750
+ }
751
+
752
+ const shardedSpec = options.shardedSpec || state.shardedSpec || null;
753
+ if (shardedSpec && shardedSpec.sharded) {
754
+ actions.push({
755
+ id: 'sharded-spec',
756
+ severity: 'warn',
757
+ title: `Consolidate ${Number(shardedSpec.count || 2)} sharded specification files`,
758
+ instruction: 'Run `npx ah handoff --consolidate` so split constraints stay anchored in Turn 0.',
759
+ commandHint: 'npx ah handoff --consolidate',
760
+ reclaimTokens: 0
761
+ });
762
+ }
763
+
764
+ const shieldData = options.shield || state.shield || null;
765
+ if (shieldData && (shieldData.quarantined || shieldData.alert)) {
766
+ actions.push({
767
+ id: 'shield-firewall',
768
+ severity: 'warn',
769
+ title: 'Prefix-cache Shield held a mutation',
770
+ instruction: 'Inspect queued prefix updates with `npx ah doctor` before modifying rules mid-chat.',
771
+ commandHint: 'npx ah doctor',
772
+ reclaimTokens: 0
773
+ });
774
+ }
775
+
727
776
  if (actions.length === 0) {
728
777
  actions.push({
729
778
  id: 'keep-coding',
@@ -1254,10 +1303,19 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1254
1303
 
1255
1304
  // Section 3: Circuit Breakers (DET-01..32), Thinking Drift & Prefix Retention
1256
1305
  const activeBreakerId =
1257
- options.breakerVerdict?.detectorId || options.breakerVerdict?.ruleId || null;
1306
+ options.breakerVerdict?.detectorId ||
1307
+ options.breakerVerdict?.ruleId ||
1308
+ state.coachState?.detectors?.tripped?.detectorId ||
1309
+ state.circuitBreakerTripped?.detectorId ||
1310
+ null;
1311
+ const activeBreakerReason =
1312
+ options.breakerVerdict?.reason ||
1313
+ state.coachState?.detectors?.tripped?.reason ||
1314
+ state.circuitBreakerTripped?.reason ||
1315
+ 'active';
1258
1316
  const sec3Lines = [
1259
1317
  `[Section 3] Circuit Breakers (DET-01..32), Thinking Drift & Retention`,
1260
- `Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${options.breakerVerdict?.reason || 'active'})` : 'None (32 guards nominal)'}`,
1318
+ `Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${activeBreakerReason})` : 'None (32 guards nominal)'}`,
1261
1319
  `Prefix Retention: ${formatRetentionLabel(state.prefixRetention)}`,
1262
1320
  `Thinking Drift (DET-30): ${formatDriftLabel(state.thinkingDrift)}`,
1263
1321
  `Haiku 100k 5x Cliff (DET-12): ${state.cliffTriggered ? 'EXCEEDED (5x step-up)' : state.preCliffWarningTriggered ? 'PRE-CLIFF WARNING (>= 90k)' : 'Nominal'}`
@@ -1280,7 +1338,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1280
1338
  // Section 5: PreCompact State Baton & Session Forensics
1281
1339
  const sec5Lines = [
1282
1340
  `[Section 5] PreCompact State Baton & Claude Code Forensics`,
1283
- `Session ID: ${state.sessionId || 'default'} | Completed Turns: ${Number(state.turnsCompleted || 0)}`,
1341
+ `Session ID: ${state.sessionId || 'default'} | Completed Turns: ${Number(state.turnsCompleted ?? state.window?.turnCount ?? state.sessionTimeline?.totalTurns ?? 0)}`,
1284
1342
  `Zoom Tier : ${grid.zoomTier.label} (${grid.zoomTier.tokensPerCell.toLocaleString('en-US')} tok/cell)`,
1285
1343
  `State Baton: Auto-flushed on PreCompact to .claude/cache/HANDOFF_LATEST.md`,
1286
1344
  `CLI Tools : npx ctxtop statusline | npx ctxtop radar | npx ctxtop inspect | npx ctxtop doctor`
@@ -1302,7 +1360,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1302
1360
  {
1303
1361
  sectionNumber: 3,
1304
1362
  id: 'circuit-breakers-drift',
1305
- title: 'Circuit Breakers (DET-01..21), Thinking Drift & Retention',
1363
+ title: 'Circuit Breakers (DET-01..32), Thinking Drift & Retention',
1306
1364
  lines: sec3Lines
1307
1365
  },
1308
1366
  {
@@ -1346,6 +1404,23 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1346
1404
  };
1347
1405
  }
1348
1406
 
1407
+ /**
1408
+ * Pure zero-Node formatter for the Claude Code `statusLine` RSL budget segment.
1409
+ *
1410
+ * @param {object} rsl
1411
+ * @returns {string}
1412
+ */
1413
+ export function formatRslStatusSegment(rsl) {
1414
+ if (!rsl || typeof rsl !== 'object') return '';
1415
+ const rules = Math.max(0, Number(rsl.activeRules ?? 0));
1416
+ const tokens = Math.max(0, Number(rsl.ruleBudgetTokens ?? 0));
1417
+ const clashes = Math.max(0, Number(rsl.clashCount ?? 0));
1418
+ const budgetStr =
1419
+ tokens >= 1000 ? `${(tokens / 1000).toFixed(1).replace(/\.0$/, '')}k` : String(tokens);
1420
+ const base = `RSL: ${rules} rules | Budget: ${budgetStr}/20k`;
1421
+ return clashes > 0 ? `${base} | ${clashes} clash!` : base;
1422
+ }
1423
+
1349
1424
  /**
1350
1425
  * 4. Renders a single-line terminal `statusLine` adapting cleanly to terminal column width
1351
1426
  * (`80`, `110`, `144`, or arbitrary column count).
@@ -1415,16 +1490,20 @@ export function renderStatusLine(state = {}, options = {}) {
1415
1490
  const retStr = state.prefixRetention?.measured ? ` · ${formatRetentionCompact(state.prefixRetention)}` : '';
1416
1491
  const swarmTok = layoutTier === 'wide-144' ? formatSwarmCompact(computeSwarmSummary(state, { nowMs: options.nowMs || Date.now() })) : '';
1417
1492
  const swarmStr = swarmTok ? ` · ${swarmTok}` : '';
1493
+ const rslData = options.rsl || state.rsl || null;
1494
+ const rslTok = layoutTier !== 'compact-80' && rslData ? formatRslStatusSegment(rslData) : '';
1495
+ const rslStr = rslTok ? ` · ${rslTok}` : '';
1418
1496
 
1497
+ const prefix = options.legacyPrefix ? 'AH' : 'HB';
1419
1498
  let p = '';
1420
1499
  let a = '';
1421
1500
  if (layoutTier === 'compact-80') {
1422
- p = `AH ${g.bracketedBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1423
- a = `AH ${g.ansiCodeBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1501
+ p = `${prefix} ${g.bracketedBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1502
+ a = `${prefix} ${g.ansiCodeBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1424
1503
  } else {
1425
1504
  const shortModel = g.modelId.replace(/^claude-/, '');
1426
- p = `AH ${g.bracketedBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}`;
1427
- a = `AH ${g.ansiCodeBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}`;
1505
+ p = `${prefix} ${g.bracketedBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
1506
+ a = `${prefix} ${g.ansiCodeBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
1428
1507
  }
1429
1508
 
1430
1509
  chosenGrid = g;
@@ -1474,5 +1553,6 @@ export default {
1474
1553
  renderSimpleViewPane,
1475
1554
  renderSimpleHudPane,
1476
1555
  renderAdvancedViewPane,
1556
+ formatRslStatusSegment,
1477
1557
  renderStatusLine
1478
1558
  };
@@ -0,0 +1,426 @@
1
+ /**
2
+ * @file src/diagnostics/claudeHookCapabilities.mjs
3
+ * Startup feature-check for undocumented Claude Code hook contracts (`PreModelSwitch`,
4
+ * `permissionBehavior === "ask"`, payload keys `from_model`/`to_model`/`prompt_cache_warm`,
5
+ * and absence of `PreEffortChange`).
6
+ *
7
+ * Scans the installed Claude Code binary/bundle in bounded 4 MB chunks with 256-byte overlap,
8
+ * caches results by `(binaryPath, size, mtimeMs)` under `.attention-horizon/cache/ah_claude_capabilities.json`,
9
+ * and logs a non-fatal runtime diagnostic if the installed binary drops the hook contract.
10
+ */
11
+
12
+ import { execFileSync } from 'node:child_process';
13
+ import {
14
+ fs,
15
+ path,
16
+ os,
17
+ readJsonSafe,
18
+ writeJsonAtomic
19
+ } from '../utils/nodeIo.mjs';
20
+ import { recordRuntimeDiagnostic } from '../core-isomorphic/utils/runtime.mjs';
21
+
22
+ const CHUNK_BYTES = 4 * 1024 * 1024;
23
+ const OVERLAP_BYTES = 256;
24
+
25
+ const CAPABILITY_MARKERS = Object.freeze({
26
+ preModelSwitchSupported: 'PreModelSwitch',
27
+ postModelSwitchSupported: 'PostModelSwitch',
28
+ preEffortChangeSupported: 'PreEffortChange',
29
+ hasFromModelKey: 'from_model',
30
+ hasToModelKey: 'to_model',
31
+ hasPromptCacheWarmKey: 'prompt_cache_warm',
32
+ hasContextTokensKey: 'context_tokens',
33
+ hasAskBehavior: 'permissionBehavior==="ask"',
34
+ hasAskDialog: 'A PreModelSwitch hook asked',
35
+ sdkSetModelHooked: 'blocked_by_hook'
36
+ });
37
+
38
+ /**
39
+ * Resolves the underlying JS bundle or native binary when given a Windows `.cmd` / POSIX wrapper.
40
+ * @param {string} candidatePath
41
+ * @returns {string}
42
+ */
43
+ function unwrapClaudeShim(candidatePath) {
44
+ if (!candidatePath || !fs.existsSync(candidatePath)) return candidatePath;
45
+ const ext = path.extname(candidatePath).toLowerCase();
46
+ const dir = path.dirname(candidatePath);
47
+
48
+ if (ext === '.cmd' || ext === '.bat') {
49
+ const pkgBase = path.join(dir, 'node_modules', '@anthropic-ai', 'claude-code');
50
+ const exeInPkg = path.join(pkgBase, 'bin', 'claude.exe');
51
+ const jsInPkg = path.join(pkgBase, 'cli.js');
52
+ if (fs.existsSync(exeInPkg)) return exeInPkg;
53
+ if (fs.existsSync(jsInPkg)) return jsInPkg;
54
+ }
55
+
56
+ return candidatePath;
57
+ }
58
+
59
+ /**
60
+ * Resolves the active `claude` binary/bundle path from options, `CLAUDE_BIN`, or `PATH`.
61
+ * @param {object} [options={}]
62
+ * @returns {string | null}
63
+ */
64
+ export function resolveClaudeBinaryPath(options = {}) {
65
+ const candidates = [];
66
+ if (typeof options.claudeBinPath === 'string' && options.claudeBinPath.trim()) {
67
+ candidates.push(options.claudeBinPath.trim());
68
+ }
69
+ const envBin = globalThis.process?.env?.CLAUDE_BIN;
70
+ if (typeof envBin === 'string' && envBin.trim()) {
71
+ candidates.push(envBin.trim());
72
+ }
73
+
74
+ if (candidates.length === 0) {
75
+ const pathEnv = String(globalThis.process?.env?.PATH || '');
76
+ const sep = globalThis.process?.platform === 'win32' ? ';' : ':';
77
+ const names =
78
+ globalThis.process?.platform === 'win32'
79
+ ? ['claude.exe', 'claude.cmd', 'claude']
80
+ : ['claude'];
81
+ for (const dir of pathEnv.split(sep).filter(Boolean)) {
82
+ for (const name of names) {
83
+ candidates.push(path.join(dir, name));
84
+ }
85
+ }
86
+
87
+ // Standard local CLI & benchmark runtime locations (no hardcoded usernames)
88
+ const homeDir = options.homeDir || os.homedir();
89
+ const tmpDir = os.tmpdir();
90
+ if (homeDir) {
91
+ for (const name of names) {
92
+ candidates.push(path.join(homeDir, '.local', 'bin', name));
93
+ candidates.push(path.join(homeDir, '.claude', 'local', name));
94
+ candidates.push(
95
+ path.join(homeDir, '.claude', 'local', 'node_modules', '@anthropic-ai', 'claude-code', 'bin', name)
96
+ );
97
+ }
98
+ }
99
+ try {
100
+ if (tmpDir && fs.existsSync(tmpDir)) {
101
+ for (const ent of fs.readdirSync(tmpDir)) {
102
+ if (ent.includes('model-switch-runtime')) {
103
+ for (const name of names) {
104
+ candidates.push(
105
+ path.join(tmpDir, ent, 'cli', 'node_modules', '@anthropic-ai', 'claude-code', 'bin', name)
106
+ );
107
+ }
108
+ }
109
+ }
110
+ }
111
+ } catch {
112
+ // Ignore temp directory scan errors
113
+ }
114
+ }
115
+
116
+ for (const raw of candidates) {
117
+ try {
118
+ const unwrapped = unwrapClaudeShim(raw);
119
+ if (unwrapped && fs.existsSync(unwrapped)) {
120
+ const st = fs.statSync(unwrapped);
121
+ if (st.isFile()) return unwrapped;
122
+ }
123
+ } catch {
124
+ // Skip inaccessible candidate
125
+ }
126
+ }
127
+ return null;
128
+ }
129
+
130
+ /**
131
+ * Reads sibling `@anthropic-ai/claude-code/package.json` (fast, zero subprocess) or optionally
132
+ * queries `claude --version` when `options.probeVersion === true`.
133
+ *
134
+ * @param {string} binPath
135
+ * @param {object} [options={}]
136
+ * @returns {string | null}
137
+ */
138
+ function detectClaudeVersion(binPath, options = {}) {
139
+ const pkgCandidates = [
140
+ path.join(path.dirname(binPath), 'package.json'),
141
+ path.join(path.dirname(binPath), '..', 'package.json')
142
+ ];
143
+ for (const pkgPath of pkgCandidates) {
144
+ const parsed = readJsonSafe(pkgPath, null, options);
145
+ if (parsed && parsed.name === '@anthropic-ai/claude-code' && typeof parsed.version === 'string') {
146
+ return parsed.version;
147
+ }
148
+ }
149
+
150
+ if (options.probeVersion === true) {
151
+ try {
152
+ const out = execFileSync(binPath, ['--version'], {
153
+ encoding: 'utf8',
154
+ timeout: 3000,
155
+ stdio: ['ignore', 'pipe', 'ignore']
156
+ }).trim();
157
+ const match = out.match(/(\d+\.\d+\.\d+(?:[-+][^\s]+)?)/);
158
+ if (match) return match[1];
159
+ } catch {
160
+ // Ignore version subprocess failure
161
+ }
162
+ }
163
+ return null;
164
+ }
165
+
166
+ /**
167
+ * Streams a file in bounded 4 MB overlapping chunks to test exact ASCII substring markers
168
+ * without loading large standalone binaries wholly into V8 heap memory.
169
+ *
170
+ * @param {string} binPath
171
+ * @returns {Record<string, boolean>}
172
+ */
173
+ function scanBinaryMarkersChunked(binPath) {
174
+ const foundFlags = Object.fromEntries(Object.keys(CAPABILITY_MARKERS).map((k) => [k, false]));
175
+ const markerEntries = Object.entries(CAPABILITY_MARKERS);
176
+ const buf = Buffer.allocUnsafe(CHUNK_BYTES);
177
+ const fd = fs.openSync(binPath, 'r');
178
+ try {
179
+ let tail = '';
180
+ let bytesRead;
181
+ while ((bytesRead = fs.readSync(fd, buf, 0, CHUNK_BYTES, null)) > 0) {
182
+ const chunkStr = tail + buf.subarray(0, bytesRead).toString('latin1');
183
+ let allFound = true;
184
+ for (const [key, marker] of markerEntries) {
185
+ if (!foundFlags[key]) {
186
+ if (chunkStr.includes(marker)) {
187
+ foundFlags[key] = true;
188
+ } else {
189
+ allFound = false;
190
+ }
191
+ }
192
+ }
193
+ if (allFound) break;
194
+ tail = chunkStr.slice(Math.max(0, chunkStr.length - OVERLAP_BYTES));
195
+ }
196
+ } finally {
197
+ fs.closeSync(fd);
198
+ }
199
+ return foundFlags;
200
+ }
201
+
202
+ /**
203
+ * Formats `PreEffortChange` capability into a clear human-readable doctor status string
204
+ * without altering the boolean `preEffortChangeSupported` API contract.
205
+ *
206
+ * @param {{ preEffortChangeSupported?: boolean | null }} [cap={}]
207
+ * @returns {string}
208
+ */
209
+ export function formatPreEffortChangeCapability(cap = {}) {
210
+ if (cap?.preEffortChangeSupported === true) {
211
+ return 'true';
212
+ }
213
+ if (cap?.preEffortChangeSupported === false) {
214
+ return 'n/a (ConfigChange + turn-boundary active; 5.5+ cache-safe)';
215
+ }
216
+ return 'unknown';
217
+ }
218
+
219
+ /**
220
+ * Inspects the installed Claude Code CLI/bundle for `PreModelSwitch` support and contract parity.
221
+ *
222
+ * @param {object} [options={}]
223
+ * @returns {{
224
+ * found: boolean,
225
+ * binaryPath: string | null,
226
+ * claudeVersion: string | null,
227
+ * preModelSwitchSupported: boolean | null,
228
+ * postModelSwitchSupported: boolean | null,
229
+ * preEffortChangeSupported: boolean | null,
230
+ * preEffortChangeSummary: string | null,
231
+ * supportsAskDecision: boolean | null,
232
+ * sdkSetModelHooked: boolean | null,
233
+ * payloadKeys: { from_model: boolean, to_model: boolean, prompt_cache_warm: boolean, context_tokens: boolean } | null,
234
+ * contractValid: boolean | null,
235
+ * cached: boolean,
236
+ * warning: string | null
237
+ * }}
238
+ */
239
+ export function inspectClaudeBinaryCapabilities(options = {}) {
240
+ const cwd = options.cwd || globalThis.process?.cwd?.() || '.';
241
+ const binPath = resolveClaudeBinaryPath(options);
242
+ if (!binPath) {
243
+ return {
244
+ found: false,
245
+ binaryPath: null,
246
+ claudeVersion: null,
247
+ preModelSwitchSupported: null,
248
+ postModelSwitchSupported: null,
249
+ preEffortChangeSupported: null,
250
+ preEffortChangeSummary: null,
251
+ supportsAskDecision: null,
252
+ sdkSetModelHooked: null,
253
+ payloadKeys: null,
254
+ contractValid: null,
255
+ cached: false,
256
+ warning: null
257
+ };
258
+ }
259
+
260
+ let stat;
261
+ try {
262
+ stat = fs.statSync(binPath);
263
+ } catch (err) {
264
+ void err;
265
+ return {
266
+ found: false,
267
+ binaryPath: null,
268
+ claudeVersion: null,
269
+ preModelSwitchSupported: null,
270
+ postModelSwitchSupported: null,
271
+ preEffortChangeSupported: null,
272
+ preEffortChangeSummary: null,
273
+ supportsAskDecision: null,
274
+ sdkSetModelHooked: null,
275
+ payloadKeys: null,
276
+ contractValid: null,
277
+ cached: false,
278
+ warning: null
279
+ };
280
+ }
281
+
282
+ const cacheBaseDir = options.homeDir || cwd;
283
+ const cachePath =
284
+ options.cachePath ||
285
+ path.join(cacheBaseDir, '.attention-horizon', 'cache', 'ah_claude_capabilities.json');
286
+ if (!options.bypassCache) {
287
+ const cached = readJsonSafe(cachePath, null, options);
288
+ if (
289
+ cached &&
290
+ cached.binaryPath === binPath &&
291
+ cached.size === stat.size &&
292
+ cached.mtimeMs === stat.mtimeMs &&
293
+ cached.result &&
294
+ typeof cached.result.contractValid === 'boolean'
295
+ ) {
296
+ return {
297
+ ...cached.result,
298
+ preEffortChangeSummary:
299
+ cached.result.preEffortChangeSummary || formatPreEffortChangeCapability(cached.result),
300
+ cached: true
301
+ };
302
+ }
303
+ }
304
+
305
+ const markers = scanBinaryMarkersChunked(binPath);
306
+ const claudeVersion = options.claudeVersion || detectClaudeVersion(binPath, options);
307
+ const payloadKeys = {
308
+ from_model: markers.hasFromModelKey,
309
+ to_model: markers.hasToModelKey,
310
+ prompt_cache_warm: markers.hasPromptCacheWarmKey,
311
+ context_tokens: markers.hasContextTokensKey
312
+ };
313
+ const supportsAskDecision = Boolean(markers.hasAskBehavior || markers.hasAskDialog);
314
+ const contractValid = Boolean(
315
+ markers.preModelSwitchSupported &&
316
+ payloadKeys.from_model &&
317
+ payloadKeys.to_model &&
318
+ payloadKeys.prompt_cache_warm &&
319
+ supportsAskDecision
320
+ );
321
+
322
+ const warning = contractValid
323
+ ? null
324
+ : `[Highbeam Startup Check] Claude Code (${claudeVersion || 'unknown'}) does not expose the expected undocumented PreModelSwitch hook contract; DET-08 native /model interception is unavailable.`;
325
+
326
+ if (warning && options.recordDiagnostic !== false) {
327
+ recordRuntimeDiagnostic(
328
+ 'claudeHookCapabilities',
329
+ 'inspectClaudeBinaryCapabilities',
330
+ new Error(warning),
331
+ { ...options, cwd }
332
+ );
333
+ }
334
+
335
+ const result = {
336
+ found: true,
337
+ binaryPath: binPath,
338
+ claudeVersion,
339
+ preModelSwitchSupported: markers.preModelSwitchSupported,
340
+ postModelSwitchSupported: markers.postModelSwitchSupported,
341
+ preEffortChangeSupported: markers.preEffortChangeSupported,
342
+ preEffortChangeSummary: formatPreEffortChangeCapability({
343
+ preEffortChangeSupported: markers.preEffortChangeSupported
344
+ }),
345
+ supportsAskDecision,
346
+ sdkSetModelHooked: markers.sdkSetModelHooked,
347
+ payloadKeys,
348
+ contractValid,
349
+ cached: false,
350
+ warning
351
+ };
352
+
353
+ if (options.writeCache !== false && (options.cwd || options.cachePath)) {
354
+ writeJsonAtomic(
355
+ cachePath,
356
+ {
357
+ binaryPath: binPath,
358
+ size: stat.size,
359
+ mtimeMs: stat.mtimeMs,
360
+ result
361
+ },
362
+ options
363
+ );
364
+ }
365
+
366
+ return result;
367
+ }
368
+
369
+ /**
370
+ * Extracts all selectable model IDs and official aliases from an installed Claude Code binary
371
+ * in bounded 4 MB chunks (Item 1.3).
372
+ *
373
+ * @param {string} binPath
374
+ * @returns {{
375
+ * found: boolean,
376
+ * modelIds: string[],
377
+ * aliases: string[],
378
+ * allSelectable: string[]
379
+ * }}
380
+ */
381
+ export function extractClaudeSelectableModelsFromBinary(binPath) {
382
+ if (!binPath || !fs.existsSync(binPath)) {
383
+ return { found: false, modelIds: [], aliases: [], allSelectable: [] };
384
+ }
385
+ const modelIds = new Set();
386
+ const aliases = new Set();
387
+ const buf = Buffer.allocUnsafe(CHUNK_BYTES);
388
+ const overlap = 8192;
389
+ const fd = fs.openSync(binPath, 'r');
390
+ try {
391
+ let tail = '';
392
+ let bytesRead;
393
+ while ((bytesRead = fs.readSync(fd, buf, 0, CHUNK_BYTES, null)) > 0) {
394
+ const chunkStr = tail + buf.subarray(0, bytesRead).toString('latin1');
395
+ if (chunkStr.includes('family:') && chunkStr.includes('display_name:')) {
396
+ for (const m of chunkStr.matchAll(/\{id:"(claude-[a-z0-9-]+)",family:"(?:haiku|sonnet|opus|fable|mythos)"/g)) {
397
+ modelIds.add(m[1]);
398
+ }
399
+ }
400
+ const aliasArrMatch = chunkStr.match(/\[("sonnet","opus"[^\]]{0,240})\]/);
401
+ if (aliasArrMatch) {
402
+ for (const m of aliasArrMatch[1].matchAll(/"([a-z0-9[\]-]+)"/g)) {
403
+ aliases.add(m[1]);
404
+ }
405
+ }
406
+ tail = chunkStr.slice(Math.max(0, chunkStr.length - overlap));
407
+ }
408
+ } finally {
409
+ fs.closeSync(fd);
410
+ }
411
+ const sortedIds = Array.from(modelIds).sort();
412
+ const sortedAliases = Array.from(aliases).sort();
413
+ return {
414
+ found: true,
415
+ modelIds: sortedIds,
416
+ aliases: sortedAliases,
417
+ allSelectable: Array.from(new Set([...sortedIds, ...sortedAliases]))
418
+ };
419
+ }
420
+
421
+ export default {
422
+ resolveClaudeBinaryPath,
423
+ formatPreEffortChangeCapability,
424
+ inspectClaudeBinaryCapabilities,
425
+ extractClaudeSelectableModelsFromBinary
426
+ };