ctxtop 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. package/src/webview/simple_view.html +1 -1
@@ -1,27 +1,13 @@
1
1
  /**
2
2
  * @file hooks/handlers/pre-tool-use.mjs
3
- * Tier 2 Command Hook handler for `PreToolUse`
3
+ * Thin Tier-2 Command Hook Fast-Shell for `PreToolUse`
4
4
  * (`Bash|PowerShell|Edit|MultiEdit|Write|NotebookEdit|Read|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
5
+ *
6
+ * Imports only `node:module`, `./hookIo.mjs`, and `../../src/hooks/fast_hook_ipc.mjs` so
7
+ * warm daemon IPC and safe bounded-read spawns avoid loading the full ESM engine graph on Windows.
5
8
  */
6
9
 
7
- import fs from 'node:fs';
8
- import path from 'node:path';
9
- import { readLiveStateSnapshot } from '../../src/core-isomorphic/telemetry/telemetryBridge.mjs';
10
- import { computeTotalPromptTokens } from '../../src/core-isomorphic/config/catalogLoader.mjs';
11
- import { loadHorizonConfig } from '../../src/core-isomorphic/config/horizonConfig.mjs';
12
- import { recordInterventionSavings } from '../../src/core-isomorphic/coach/savedQuotaLedger.mjs';
13
- import { requireProFeature } from '../../src/core/pro_license.mjs';
14
- import { foldCodeToSignatureStub, computeCompactLineDiff } from '../../src/core/pruner.mjs';
15
- import {
16
- evaluateShieldReadGuard,
17
- inspectAndSanitizeMultimodalRead
18
- } from '../../src/core/shield_manager.mjs';
19
- import { runBucketBPreToolShadowPass } from '../../src/core/bucket_b_runtime.mjs';
20
- import {
21
- CircuitBreakerEngine,
22
- readBreakerStateSnapshot,
23
- writeBreakerStateSnapshot
24
- } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
10
+ import { createRequire } from 'node:module';
25
11
  import {
26
12
  isCliEntrypoint,
27
13
  readStdinJsonAsync,
@@ -29,544 +15,29 @@ import {
29
15
  exitHardBlockStderr,
30
16
  exitWithStdoutJson
31
17
  } from './hookIo.mjs';
32
- import { dispatchPreToolUseWithFallback } from './hookIpcClient.mjs';
18
+ import {
19
+ tryFastDaemonRpc,
20
+ canFastAllowBoundedRead,
21
+ tryTier1PreToolFastPath
22
+ } from '../../src/hooks/fast_hook_ipc.mjs';
23
+
24
+ const requireFromHere = createRequire(import.meta.url);
25
+ let _coreMod = null;
26
+ function getCoreSync() {
27
+ if (!_coreMod) _coreMod = requireFromHere('./pre-tool-use-core.mjs');
28
+ return _coreMod;
29
+ }
33
30
 
34
31
  /**
35
- * Evaluates a `PreToolUse` hook payload and returns the contract response.
36
- * Persists stateful breaker counters atomically across separate CLI hook spawns (`ISS-038`).
32
+ * Synchronous programmatic wrapper delegating to `pre-tool-use-core.mjs`.
37
33
  *
38
- * @param {object} event
34
+ * @param {object} [event={}]
39
35
  * @param {object} [options={}]
40
36
  */
41
37
  export function runPreToolUseHook(event = {}, options = {}) {
42
- const toolName = String(event.tool_name || event.toolName || '');
43
- const tier1Active = Boolean(
44
- options.tier1ModActive ||
45
- event.tier1ModActive ||
46
- globalThis.process?.env?.AH_TIER1_MOD_ACTIVE === '1'
47
- );
48
- if (tier1Active && /^(Grep|Glob)$/i.test(toolName)) {
49
- return {
50
- exitCode: 0,
51
- stdout: '',
52
- stderr: '',
53
- fastPath: 'tier1_mod_active',
54
- verdict: { triggered: false, decision: 'allow', reason: 'Handled in-process by Tier 1 Mod' }
55
- };
56
- }
57
- const sessionId = event.session_id || event.sessionId || 'default';
58
- const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
59
- const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
60
- const liveState = options.telemetryState || readLiveStateSnapshot(sessionId, cwdOptions);
61
- const configHasDiskSource = Boolean(
62
- horizonConfig?.sources?.projectLoaded || horizonConfig?.sources?.globalLoaded
63
- );
64
- const rawEffectiveMode =
65
- event.mode ||
66
- options.mode ||
67
- options.telemetryState?.flightMode ||
68
- (configHasDiskSource
69
- ? horizonConfig.flightMode
70
- : liveState?.flightMode || horizonConfig?.flightMode || 'COACH');
71
- const proAutoPilot =
72
- rawEffectiveMode === 'AUTO_PILOT' ? requireProFeature('auto_pilot_locks', options) : { allowed: true };
73
- const effectiveMode =
74
- rawEffectiveMode === 'AUTO_PILOT' && !proAutoPilot.allowed ? 'COACH' : rawEffectiveMode;
75
-
76
- const shouldPersistState =
77
- !options.engine &&
78
- options.persistState !== false &&
79
- Boolean(event.cwd || options.cwd || options.breakerStatePath || options.persistState);
80
-
81
- const priorSnapshot = shouldPersistState
82
- ? readBreakerStateSnapshot(sessionId, cwdOptions)
83
- : null;
84
-
85
- const engine =
86
- options.engine ||
87
- new CircuitBreakerEngine({
88
- ...cwdOptions,
89
- horizonConfig,
90
- mode: effectiveMode,
91
- initialState: priorSnapshot
92
- });
93
-
94
- const eventUsage = event.usage || event.context_window?.current_usage || null;
95
- const computedEventPromptTokens = Math.max(
96
- computeTotalPromptTokens(event),
97
- eventUsage ? computeTotalPromptTokens(eventUsage) : 0
98
- );
99
- const enrichedEvent = {
100
- ...event,
101
- ...(computedEventPromptTokens > 0 && event.totalPromptTokens === undefined
102
- ? { totalPromptTokens: computedEventPromptTokens }
103
- : {}),
104
- mode: event.mode || effectiveMode
105
- };
106
-
107
- const verdict = engine.evaluatePreToolUse(enrichedEvent, {
108
- ...liveState,
109
- flightMode: effectiveMode
110
- });
111
-
112
- // Playbook Step 4 & VC Gap 4: Post-Edit Unified Delta Diff + 3rd-Read AST Signature Stub Interception
113
- const isReadTool = /^(Read|read_file|view_file)$/i.test(toolName);
114
- const tIn = event.tool_input || event.toolInput || event.args || {};
115
- const hasLineBounds =
116
- tIn.StartLine !== undefined ||
117
- tIn.EndLine !== undefined ||
118
- tIn.offset !== undefined ||
119
- tIn.limit !== undefined ||
120
- tIn.pages !== undefined;
121
- const rawReadPath = String(tIn.file_path || tIn.Path || tIn.AbsolutePath || tIn.path || '').trim();
122
-
123
- // Item A8 (#14): Multimodal .ipynb Base64 Stripper (`updatedInput`) & Unbounded >10-page .pdf Blocker
124
- if (
125
- isReadTool &&
126
- rawReadPath &&
127
- verdict.decision !== 'deny' &&
128
- verdict.decision !== 'ask' &&
129
- verdict.decision !== 'defer' &&
130
- /\.(?:ipynb|pdf)$/i.test(rawReadPath)
131
- ) {
132
- const baseCwdForMm = event.cwd || options.cwd || process.cwd();
133
- const mmVerdict = inspectAndSanitizeMultimodalRead({
134
- platform: 'claude',
135
- cwd: baseCwdForMm,
136
- filePath: rawReadPath,
137
- pages: tIn.pages,
138
- hasPageBounds: tIn.pages !== undefined
139
- });
140
- if (mmVerdict.action === 'deny') {
141
- if (shouldPersistState) {
142
- writeBreakerStateSnapshot(sessionId, engine.exportStateSnapshot(), cwdOptions);
143
- }
144
- const denyOut = {
145
- hookSpecificOutput: {
146
- hookEventName: 'PreToolUse',
147
- permissionDecision: 'deny',
148
- permissionDecisionReason: mmVerdict.reason
149
- }
150
- };
151
- return {
152
- exitCode: 0,
153
- stdout: JSON.stringify(denyOut),
154
- stderr: '',
155
- verdict: {
156
- triggered: true,
157
- detectorId: mmVerdict.detectorId,
158
- subType: mmVerdict.subType,
159
- decision: 'deny',
160
- pageCount: mmVerdict.pageCount,
161
- savedTokens: mmVerdict.savedTokens,
162
- reason: mmVerdict.reason
163
- }
164
- };
165
- }
166
- if (mmVerdict.action === 'rewrite' && mmVerdict.sanitizedPath) {
167
- if (shouldPersistState) {
168
- writeBreakerStateSnapshot(sessionId, engine.exportStateSnapshot(), cwdOptions);
169
- }
170
- if (
171
- mmVerdict.savedTokens > 0 &&
172
- options.recordLedger !== false &&
173
- Boolean(event.cwd || options.cwd || options.ledgerPath || options.recordLedger)
174
- ) {
175
- recordInterventionSavings(
176
- {
177
- sessionId,
178
- category: 'BOUNDED_READ_ENFORCED',
179
- modelId: event.model || event.modelId || liveState?.modelId || 'claude-sonnet-4-6',
180
- savedTokens: mmVerdict.savedTokens,
181
- detail: `Sanitized .ipynb base64 blobs in ${path.basename(rawReadPath)}`
182
- },
183
- cwdOptions
184
- );
185
- }
186
- const updatedInput = {
187
- ...tIn,
188
- file_path: mmVerdict.sanitizedPath
189
- };
190
- const rewriteOut = {
191
- hookSpecificOutput: {
192
- hookEventName: 'PreToolUse',
193
- permissionDecision: 'allow',
194
- updatedInput,
195
- additionalContext: mmVerdict.reason
196
- }
197
- };
198
- return {
199
- exitCode: 0,
200
- stdout: JSON.stringify(rewriteOut),
201
- stderr: '',
202
- verdict: {
203
- triggered: true,
204
- detectorId: mmVerdict.detectorId,
205
- subType: mmVerdict.subType,
206
- decision: 'allow',
207
- sanitizedPath: mmVerdict.sanitizedPath,
208
- savedTokens: mmVerdict.savedTokens,
209
- updatedInput,
210
- reason: mmVerdict.reason
211
- }
212
- };
213
- }
214
- }
215
-
216
- if (
217
- isReadTool &&
218
- !hasLineBounds &&
219
- rawReadPath &&
220
- verdict.decision !== 'deny' &&
221
- verdict.decision !== 'ask' &&
222
- verdict.decision !== 'defer'
223
- ) {
224
- const baseCwdForShield = event.cwd || options.cwd || process.cwd();
225
- const shieldVerdict = evaluateShieldReadGuard({
226
- platform: 'claude',
227
- sessionId,
228
- cwd: baseCwdForShield,
229
- filePath: rawReadPath,
230
- hasSliceBounds: false,
231
- currentPromptTokens:
232
- computedEventPromptTokens || Number(liveState?.contextWindow?.totalInputTokens || 0),
233
- modelId: event.model || event.modelId || liveState?.modelId || 'claude-sonnet-4-6',
234
- shieldConfig: options.shieldConfig,
235
- forceActive: Boolean(options.shieldForceActive),
236
- recordLedger:
237
- options.recordLedger !== false &&
238
- Boolean(event.cwd || options.cwd || options.ledgerPath || options.recordLedger),
239
- ledgerPath: options.ledgerPath
240
- });
241
- if (shieldVerdict.action === 'deny') {
242
- if (shouldPersistState) {
243
- writeBreakerStateSnapshot(sessionId, engine.exportStateSnapshot(), cwdOptions);
244
- }
245
- const denyOut = {
246
- permissionDecision: 'deny',
247
- reason: shieldVerdict.reason,
248
- hookSpecificOutput: {
249
- hookEventName: 'PreToolUse',
250
- permissionDecision: 'deny',
251
- permissionDecisionReason: shieldVerdict.reason
252
- }
253
- };
254
- return {
255
- exitCode: 0,
256
- stdout: JSON.stringify(denyOut),
257
- stderr: '',
258
- verdict: {
259
- triggered: true,
260
- detectorId: shieldVerdict.detectorId,
261
- decision: 'deny',
262
- reason: shieldVerdict.reason,
263
- indexPath: shieldVerdict.indexPath,
264
- savedTokens: shieldVerdict.savedTokens,
265
- savedUSD: shieldVerdict.savedUSD
266
- }
267
- };
268
- }
269
- }
270
-
271
- if (isReadTool && !hasLineBounds && rawReadPath) {
272
- try {
273
- const baseCwd = event.cwd || options.cwd || '';
274
- const absReadPath = path.isAbsolute(rawReadPath)
275
- ? rawReadPath
276
- : path.resolve(baseCwd || process.cwd(), rawReadPath);
277
- if (fs.existsSync(absReadPath) && fs.statSync(absReadPath).isFile()) {
278
- const st = fs.statSync(absReadPath);
279
- if (st.size > 256 && st.size <= 256 * 1024) {
280
- const rawSrc = fs.readFileSync(absReadPath, 'utf8');
281
- const normKey = absReadPath.replace(/\\/g, '/').toLowerCase();
282
- let prevSrc = typeof event.priorContentSnapshot === 'string' ? event.priorContentSnapshot : null;
283
- let snapFilePath = '';
284
- let snapMap = {};
285
-
286
- if (baseCwd && shouldPersistState) {
287
- const safeSid = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_').slice(0, 64);
288
- const cacheDir = path.join(baseCwd, '.claude', 'cache');
289
- snapFilePath = path.join(cacheDir, `read_snapshots_${safeSid}.json`);
290
- if (fs.existsSync(snapFilePath)) {
291
- try {
292
- snapMap = JSON.parse(fs.readFileSync(snapFilePath, 'utf8')) || {};
293
- if (prevSrc === null && typeof snapMap[normKey] === 'string') {
294
- prevSrc = snapMap[normKey];
295
- }
296
- } catch (_e) {
297
- snapMap = {};
298
- }
299
- }
300
- }
301
-
302
- if (prevSrc !== null && prevSrc !== rawSrc) {
303
- const delta = computeCompactLineDiff(prevSrc, rawSrc, path.basename(absReadPath));
304
- if (delta.wasDiffed) {
305
- verdict.triggered = true;
306
- verdict.detectorId = verdict.detectorId || 'DET-06';
307
- verdict.decision = verdict.decision || 'allow';
308
- verdict.deltaDiffStub = delta.diffText;
309
- verdict.savedTokens = Math.max(Number(verdict.savedTokens || 0), delta.savedTokens);
310
- verdict.reason = `[GUARD-4 Post-Edit Delta Read] File modified since last read; returning unified delta diff (+${delta.savedTokens} tokens saved):\n${delta.diffText}`;
311
- }
312
- } else if (verdict.detectorId === 'DET-06' || Number(event.priorUnclippedReads || 0) >= 2) {
313
- const folded = foldCodeToSignatureStub(rawSrc, rawReadPath);
314
- if (folded.wasFolded) {
315
- const stubSavedTok = Math.max(250, Math.round(folded.savedChars / 4));
316
- verdict.triggered = true;
317
- verdict.detectorId = verdict.detectorId || 'DET-06';
318
- verdict.decision = verdict.decision || 'allow';
319
- verdict.astSignatureStub = folded.condensed;
320
- verdict.savedTokens = Math.max(Number(verdict.savedTokens || 0), stubSavedTok);
321
- verdict.reason = `${verdict.reason ? verdict.reason + '\n\n' : '[GUARD-4 Repeat-Read Surgeon] Full-file re-read intercepted; returning AST signature stub (+' + stubSavedTok + ' tokens saved):\n'}${folded.condensed}`;
322
- }
323
- }
324
-
325
- if (snapFilePath && rawSrc.length <= 128 * 1024) {
326
- try {
327
- fs.mkdirSync(path.dirname(snapFilePath), { recursive: true });
328
- const keys = Object.keys(snapMap);
329
- if (!snapMap[normKey] && keys.length >= 12) {
330
- delete snapMap[keys[0]];
331
- }
332
- snapMap[normKey] = rawSrc;
333
- fs.writeFileSync(snapFilePath, JSON.stringify(snapMap), 'utf8');
334
- } catch (_writeErr) {
335
- void _writeErr;
336
- }
337
- }
338
- }
339
- }
340
- } catch (_stubErr) {
341
- void _stubErr;
342
- }
343
- }
344
-
345
- const hasExplicitCwd = Boolean(event.cwd || options.cwd);
346
-
347
- // Bucket B Coach/Shadow Pass (B-Alpha defaults to COACH; B-Beta & B-Gamma default to SHADOW)
348
- if (!verdict.triggered && options.bucketBShadow !== false) {
349
- try {
350
- const priorUnverifiedEdits = Array.isArray(event.editsSinceVerify)
351
- ? event.editsSinceVerify
352
- : engine.codeEditedSinceLastTest
353
- ? engine.unverifiedEdits
354
- : [];
355
- const shadowRes = runBucketBPreToolShadowPass({
356
- platform: 'claude',
357
- sessionId,
358
- cwd: event.cwd || options.cwd || '',
359
- hasExplicitCwd,
360
- toolName,
361
- toolInput: tIn,
362
- lastUserPrompt: event.prompt || engine.lastUserPrompt || '',
363
- editsSinceVerify: priorUnverifiedEdits,
364
- options: {
365
- ...options,
366
- cliCapabilities: event.cliCapabilities || options.cliCapabilities,
367
- lspCapabilities: event.lspCapabilities || options.lspCapabilities,
368
- bucketBStage: event.bucketBStage ?? options.bucketBStage,
369
- bucketBGammaStage: event.bucketBGammaStage ?? options.bucketBGammaStage,
370
- bucketBLspStage: event.bucketBLspStage ?? options.bucketBLspStage,
371
- persistState: shouldPersistState,
372
- mode: effectiveMode,
373
- horizonConfig
374
- }
375
- });
376
- if (shadowRes.triggered && shadowRes.activeRecords.length > 0) {
377
- const primaryEntry =
378
- shadowRes.activeRecords.find((r) => r.verdict.decision === 'ask') ||
379
- shadowRes.activeRecords[0];
380
- const topRec = primaryEntry.verdict;
381
- verdict.triggered = true;
382
- verdict.decision = topRec.decision === 'ask' ? 'ask' : 'allow';
383
- verdict.detectorId = topRec.code || 'BUCKET_B_GUARD';
384
- verdict.reason = shadowRes.activeRecords
385
- .map((r) => r.verdict.reason)
386
- .filter(Boolean)
387
- .join('\n');
388
- const maxSavedTokens = Math.max(
389
- 0,
390
- ...shadowRes.activeRecords.map((r) => Number(r.verdict.tokensSavedEst || 0))
391
- );
392
- if (maxSavedTokens > 0) {
393
- verdict.savedTokens = Math.max(
394
- Number(verdict.savedTokens || 0),
395
- maxSavedTokens
396
- );
397
- }
398
- }
399
- } catch (_shadowErr) {
400
- // Non-fatal Bucket B shadow/coach pass
401
- }
402
- }
403
-
404
- if (
405
- shouldPersistState &&
406
- /^(?:Edit|MultiEdit|Write)$/i.test(toolName) &&
407
- verdict.decision !== 'deny' &&
408
- verdict.decision !== 'ask'
409
- ) {
410
- const rawEditPath = String(
411
- tIn.file_path || tIn.Path || tIn.path || tIn.filePath || ''
412
- ).trim();
413
- if (rawEditPath) {
414
- const addedTxt = String(
415
- tIn.new_string ??
416
- tIn.content ??
417
- tIn.newText ??
418
- (Array.isArray(tIn.edits) ? tIn.edits.map((e) => e?.new_string ?? '').join('\n') : '') ??
419
- ''
420
- );
421
- const oldTxt = String(
422
- tIn.old_string ??
423
- tIn.oldText ??
424
- (Array.isArray(tIn.edits) ? tIn.edits.map((e) => e?.old_string ?? '').join('\n') : '') ??
425
- ''
426
- );
427
- const changedLines = addedTxt.split(/\r?\n/);
428
- const netLines = changedLines.filter((l) => l.trim().length > 0).length;
429
- const deletedLineCount = oldTxt ? oldTxt.split(/\r?\n/).length : 0;
430
- if (!Array.isArray(engine.unverifiedEdits)) engine.unverifiedEdits = [];
431
- engine.unverifiedEdits.push({
432
- filePath: rawEditPath,
433
- netLines,
434
- changedLines: changedLines.slice(0, 64)
435
- });
436
- if (engine.unverifiedEdits.length > 32) {
437
- engine.unverifiedEdits = engine.unverifiedEdits.slice(-32);
438
- }
439
- if (!Array.isArray(engine.turnFileDiffs)) engine.turnFileDiffs = [];
440
- engine.turnFileDiffs.push({
441
- filePath: rawEditPath,
442
- addedLines: addedTxt ? changedLines.slice(0, 400) : [],
443
- deletedLineCount
444
- });
445
- if (engine.turnFileDiffs.length > 32) {
446
- engine.turnFileDiffs = engine.turnFileDiffs.slice(-32);
447
- }
448
- if (event.prompt) {
449
- engine.lastUserPrompt = String(event.prompt);
450
- }
451
- engine.codeEditedSinceLastTest = true;
452
- }
453
- }
454
-
455
- if (shouldPersistState) {
456
- writeBreakerStateSnapshot(sessionId, engine.exportStateSnapshot(), cwdOptions);
457
- }
458
-
459
- if (!verdict.triggered) {
460
- return {
461
- exitCode: 0,
462
- stdout: '',
463
- stderr: '',
464
- verdict
465
- };
466
- }
467
-
468
- const detId = String(verdict.detectorId || '');
469
- const isQuotaSavingGuard =
470
- /^(DET-04|DET-06|DET-09|DET-10|DET-11|DET-12|DET-13|DET-14|DET-20|SLOPSQUAT_DEP_GATE|BLAST_RADIUS_BREAKER|DUPLICATE_CLONE_DETECTOR|EVILGENIE_HARDCODED_ORACLE|SUBAGENT_TEAM_GOVERNOR|MCP_CLI_ROUTER)$/.test(
471
- detId
472
- );
473
- if (
474
- isQuotaSavingGuard &&
475
- (verdict.decision === 'deny' || verdict.decision === 'ask' || verdict.decision === 'defer' || Boolean(verdict.astSignatureStub) || Boolean(verdict.deltaDiffStub)) &&
476
- options.recordLedger !== false &&
477
- Boolean(event.cwd || options.cwd || options.ledgerPath || options.recordLedger)
478
- ) {
479
- const isPrefixFence = detId === 'DET-09';
480
- const isBoundedRead = detId === 'DET-11' || Boolean(verdict.astSignatureStub) || Boolean(verdict.deltaDiffStub);
481
- const estimatedSavedTokens = Math.max(
482
- 0,
483
- Number(
484
- verdict.savedTokens ||
485
- verdict.estimatedTokensSaved ||
486
- (isPrefixFence ? liveState?.contextWindow?.cachedTokens || 25000 : 4000)
487
- )
488
- );
489
- recordInterventionSavings(
490
- {
491
- sessionId,
492
- category: isPrefixFence
493
- ? 'DET_09_PREFIX_FENCE'
494
- : isBoundedRead
495
- ? 'BOUNDED_READ_ENFORCED'
496
- : 'LOOP_TURN_PREVENTED',
497
- modelId: liveState?.modelId || 'claude-sonnet-5-5',
498
- savedTokens: estimatedSavedTokens,
499
- savedUSD: Math.max(0, Number(verdict.avoidedPenaltyUSD || 0)),
500
- dedupeId:
501
- event.tool_use_id ||
502
- event.toolUseId ||
503
- event.turn_id ||
504
- event.turnId ||
505
- `${detId}:${event.tool_name || event.toolName || 'tool'}`,
506
- detail: `${detId} intervention (${verdict.decision}): ${String(verdict.reason || '').slice(0, 120)}`
507
- },
508
- cwdOptions
509
- );
510
- }
511
-
512
- if (verdict.decision === 'ask' || verdict.decision === 'defer') {
513
- const out = {
514
- hookSpecificOutput: {
515
- hookEventName: 'PreToolUse',
516
- permissionDecision: verdict.decision === 'defer' ? 'defer' : 'ask',
517
- permissionDecisionReason: verdict.reason
518
- }
519
- };
520
- return {
521
- exitCode: 0,
522
- stdout: JSON.stringify(out),
523
- stderr: '',
524
- verdict
525
- };
526
- }
527
-
528
- if (verdict.decision === 'deny') {
529
- if (options.useJsonDecision) {
530
- const out = {
531
- hookSpecificOutput: {
532
- hookEventName: 'PreToolUse',
533
- permissionDecision: 'deny',
534
- permissionDecisionReason: verdict.reason
535
- }
536
- };
537
- return {
538
- exitCode: 0,
539
- stdout: JSON.stringify(out),
540
- stderr: '',
541
- verdict
542
- };
543
- }
544
- return {
545
- exitCode: 2,
546
- stdout: '',
547
- stderr: verdict.reason,
548
- verdict
549
- };
550
- }
551
-
552
- // ISS-034: Coach advisory on 'allow' uses additionalContext so Claude sees the message!
553
- const out = {
554
- hookSpecificOutput: {
555
- hookEventName: 'PreToolUse',
556
- permissionDecision: 'allow',
557
- additionalContext: verdict.reason,
558
- ...(verdict.astSignatureStub ? { astSignatureStub: verdict.astSignatureStub, savedTokens: verdict.savedTokens } : {}),
559
- ...(verdict.deltaDiffStub ? { deltaDiffStub: verdict.deltaDiffStub, savedTokens: verdict.savedTokens } : {})
560
- }
561
- };
562
- return {
563
- exitCode: 0,
564
- stdout: JSON.stringify(out),
565
- stderr: '',
566
- verdict,
567
- ...(verdict.astSignatureStub ? { decision: 'allow', astSignatureStub: verdict.astSignatureStub, savedTokens: verdict.savedTokens } : {}),
568
- ...(verdict.deltaDiffStub ? { decision: 'allow', deltaDiffStub: verdict.deltaDiffStub, savedTokens: verdict.savedTokens } : {})
569
- };
38
+ const fast = tryTier1PreToolFastPath(event, options);
39
+ if (fast) return fast;
40
+ return getCoreSync().runPreToolUseHook(event, options);
570
41
  }
571
42
 
572
43
  /**
@@ -580,32 +51,51 @@ export async function executePreToolUseCli(cliOptions = {}) {
580
51
  const ioOverride = cliOptions.ioOverride || {};
581
52
  try {
582
53
  const payload = await readPayload(cliOptions.timeoutMs);
583
- let res;
54
+ const hasCustomOptions = Boolean(cliOptions.runHook || cliOptions.hookOptions);
55
+
584
56
  if (cliOptions.runHook) {
585
- res = cliOptions.runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
586
- } else {
587
- const dispatch = await dispatchPreToolUseWithFallback(payload, {
588
- persistState: true,
589
- ...(cliOptions.hookOptions || {})
590
- });
591
- if (dispatch.source === 'ipc') {
592
- const ipcRes = dispatch.result;
593
- if (ipcRes?.decision === 'deny' || ipcRes?.decision === 'block') {
594
- res = {
595
- exitCode: 2,
596
- stderr: ipcRes.reason || ipcRes.hookSpecificOutput?.permissionDecisionReason || '[Highbeam] Tool execution denied'
597
- };
57
+ const res = cliOptions.runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
58
+ if (res.exitCode === 2) {
59
+ exitHardBlockStderr(res.stderr, 'PreToolUse', ioOverride);
60
+ } else if (res.stdout) {
61
+ exitWithStdoutJson(res.stdout, ioOverride);
62
+ } else {
63
+ exitPassThrough(ioOverride.exitFn);
64
+ }
65
+ return;
66
+ }
67
+
68
+ if (!hasCustomOptions) {
69
+ if (tryTier1PreToolFastPath(payload)) {
70
+ exitPassThrough(ioOverride.exitFn);
71
+ return;
72
+ }
73
+
74
+ const ipcRes = await tryFastDaemonRpc(
75
+ 'hook.claude.preToolUse',
76
+ { event: payload },
77
+ { ipcPath: cliOptions.ipcPath }
78
+ );
79
+ if (ipcRes && ipcRes.fullVerdict === true) {
80
+ if (ipcRes.exitCode === 2) {
81
+ exitHardBlockStderr(ipcRes.stderr, 'PreToolUse', ioOverride);
82
+ } else if (ipcRes.stdout) {
83
+ exitWithStdoutJson(ipcRes.stdout, ioOverride);
598
84
  } else {
599
- res = runPreToolUseHook(payload, {
600
- persistState: true,
601
- ...(cliOptions.hookOptions || {})
602
- });
85
+ exitPassThrough(ioOverride.exitFn);
603
86
  }
604
- } else {
605
- res = dispatch.result;
87
+ return;
88
+ }
89
+
90
+ if (canFastAllowBoundedRead(payload, { platform: 'claude', cwd: payload?.cwd })) {
91
+ exitPassThrough(ioOverride.exitFn);
92
+ return;
606
93
  }
607
94
  }
608
95
 
96
+ const { runPreToolUseHook: runCore } = await import('./pre-tool-use-core.mjs');
97
+ const res = runCore(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
98
+
609
99
  if (res.exitCode === 2) {
610
100
  exitHardBlockStderr(res.stderr, 'PreToolUse', ioOverride);
611
101
  } else if (res.stdout) {