ctxtop 4.1.0 → 4.1.1

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