ctxtop 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,394 @@
1
+ /**
2
+ * @file hooks/handlers/post-tool-use-core.mjs
3
+ * Full evaluation engine for `PostToolUse` (`Bash|PowerShell|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
4
+ * Runs lossless output sanitization, 100% critical error-line recovery,
5
+ * >4,000 token programmatic artifact offloading (excluding workspace `Read`),
6
+ * and `DET-19` subagent IPI boundary & Unicode tag stripping (`ISS-034`, `ISS-053`).
7
+ */
8
+
9
+ import { createRequire } from 'node:module';
10
+ import { sanitizePostToolOutput } from '../../src/core-isomorphic/guards/losslessPostSanitizer.mjs';
11
+ import {
12
+ CircuitBreakerEngine,
13
+ evaluateDet19SubagentIpiSanitizer,
14
+ readBreakerStateSnapshot,
15
+ writeBreakerStateSnapshot
16
+ } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
17
+ import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
18
+ import { evaluateTaskBoundaryTurn } from '../../src/core-isomorphic/coach/smartCompactAdvisor.mjs';
19
+ import { runBucketBPostToolPass } from '../../src/core/bucket_b_runtime.mjs';
20
+
21
+ const requireFromHere = createRequire(import.meta.url);
22
+ const AUTO_MODE_ALIAS_RE = /^(?:AUTO_PILOT|AUTOPILOT|AUTO|AUTO-PILOT)$/i;
23
+ const RSL_MUTATING_OR_EXEC_TOOL_RE =
24
+ /^(?:Bash|PowerShell|Edit|MultiEdit|Write|NotebookEdit|run_command|execute_bash|bash|powershell|edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content|edit|multiedit|multi_edit|write|notebookedit)$/i;
25
+
26
+ let _proLicenseMod = null;
27
+ function getProLicenseMod() {
28
+ if (!_proLicenseMod) _proLicenseMod = requireFromHere('../../src/core/pro_license.mjs');
29
+ return _proLicenseMod;
30
+ }
31
+
32
+ let _microSkillsMod = null;
33
+ function getMicroSkillsMod() {
34
+ if (!_microSkillsMod) _microSkillsMod = requireFromHere('../../src/core-isomorphic/coach/microSkills.mjs');
35
+ return _microSkillsMod;
36
+ }
37
+
38
+ let _savedQuotaMod = null;
39
+ function getSavedQuotaMod() {
40
+ if (!_savedQuotaMod) _savedQuotaMod = requireFromHere('../../src/core-isomorphic/coach/savedQuotaLedger.mjs');
41
+ return _savedQuotaMod;
42
+ }
43
+
44
+ let _telemetryMod = null;
45
+ function getTelemetryMod() {
46
+ if (!_telemetryMod) _telemetryMod = requireFromHere('../../src/core-isomorphic/telemetry/telemetryBridge.mjs');
47
+ return _telemetryMod;
48
+ }
49
+
50
+ let _catalogMod = null;
51
+ function getCatalogMod() {
52
+ if (!_catalogMod) _catalogMod = requireFromHere('../../src/core-isomorphic/config/catalogLoader.mjs');
53
+ return _catalogMod;
54
+ }
55
+
56
+ let _claudeRslMod = null;
57
+ function getClaudeRslMod() {
58
+ if (!_claudeRslMod) _claudeRslMod = requireFromHere('../../src/hooks/claude_rsl_hook.mjs');
59
+ return _claudeRslMod;
60
+ }
61
+
62
+ function resolveSimpleFlightMode(rawMode = 'COACH') {
63
+ const upper = String(rawMode || 'COACH').trim().toUpperCase();
64
+ if (upper === 'OFF' || upper === 'DISABLED') return 'OFF';
65
+ if (upper === 'SILENT') return 'SILENT';
66
+ return 'COACH';
67
+ }
68
+
69
+ /**
70
+ * Extracts text from a string or structured `tool_response` object.
71
+ * @param {object} event
72
+ * @returns {string}
73
+ */
74
+ function extractPostToolText(event = {}) {
75
+ const resp = event.tool_response ?? event.tool_output ?? event.toolOutput ?? event.output;
76
+ if (typeof resp === 'string') return resp;
77
+ if (resp && typeof resp === 'object') {
78
+ const parts = [resp.stdout, resp.stderr, resp.output, resp.content, resp.error]
79
+ .filter((x) => typeof x === 'string' && x.length > 0);
80
+ if (parts.length > 0) return parts.join('\n');
81
+ return '';
82
+ }
83
+ return resp !== undefined && resp !== null ? String(resp) : '';
84
+ }
85
+
86
+ /**
87
+ * Determines whether a completed tool call failed (`is_error`, non-zero `exit_code`, etc.).
88
+ * @param {object} event
89
+ * @returns {boolean}
90
+ */
91
+ function didToolExecutionFail(event = {}) {
92
+ if (
93
+ event.is_error === true ||
94
+ event.isError === true ||
95
+ event.succeeded === false ||
96
+ Boolean(event.tool_error || event.error) ||
97
+ (typeof event.exit_code === 'number' && event.exit_code !== 0) ||
98
+ (typeof event.exitCode === 'number' && event.exitCode !== 0)
99
+ ) {
100
+ return true;
101
+ }
102
+ const resp = event.tool_response;
103
+ if (resp && typeof resp === 'object') {
104
+ if (
105
+ resp.is_error === true ||
106
+ resp.isError === true ||
107
+ resp.succeeded === false ||
108
+ resp.status === 'error' ||
109
+ resp.status === 'failed' ||
110
+ Boolean(resp.error) ||
111
+ (typeof resp.exit_code === 'number' && resp.exit_code !== 0) ||
112
+ (typeof resp.exitCode === 'number' && resp.exitCode !== 0) ||
113
+ (typeof resp.returncode === 'number' && resp.returncode !== 0)
114
+ ) {
115
+ return true;
116
+ }
117
+ }
118
+ return false;
119
+ }
120
+
121
+ /**
122
+ * Evaluates a `PostToolUse` hook payload and returns the contract response.
123
+ * @param {object} event
124
+ * @param {object} [options={}]
125
+ */
126
+ export function runPostToolUseHook(event = {}, options = {}) {
127
+ const toolName = String(event.tool_name || event.toolName || 'Bash');
128
+ const rawOutput = extractPostToolText(event);
129
+ const tier1Active = Boolean(
130
+ options.tier1ModActive ||
131
+ event.tier1ModActive ||
132
+ globalThis.process?.env?.AH_TIER1_MOD_ACTIVE === '1'
133
+ );
134
+ if (tier1Active && /^(Grep|Glob)$/i.test(toolName) && rawOutput.length < 16000 && !didToolExecutionFail(event)) {
135
+ return {
136
+ exitCode: 0,
137
+ stdout: '',
138
+ stderr: '',
139
+ fastPath: 'tier1_mod_active',
140
+ sanitized: { modified: false, offloaded: false }
141
+ };
142
+ }
143
+ const sessionId = event.session_id || event.sessionId || 'default';
144
+ const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
145
+ const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
146
+ const rawMode = event.mode || options.mode || horizonConfig.flightMode || 'COACH';
147
+ const effectiveMode = AUTO_MODE_ALIAS_RE.test(String(rawMode || '').trim())
148
+ ? getProLicenseMod().resolveEffectiveAutoFlightMode(rawMode, {
149
+ licensePath: options.licensePath || event.licensePath,
150
+ homeDir: options.homeDir || event.homeDir,
151
+ nowMs: options.nowMs,
152
+ strict: Boolean(options.strict ?? event.strict)
153
+ }).effectiveFlightMode
154
+ : resolveSimpleFlightMode(rawMode);
155
+
156
+ const hasExplicitCwd = Boolean(event.cwd || options.cwd);
157
+ let loadedPriorSnap = null;
158
+ const shouldPersistState =
159
+ options.persistState !== false &&
160
+ Boolean(event.cwd || options.cwd || options.breakerStatePath || options.persistState);
161
+
162
+ if (shouldPersistState) {
163
+ if (hasExplicitCwd && options.enableRsl !== false && RSL_MUTATING_OR_EXEC_TOOL_RE.test(toolName)) {
164
+ try {
165
+ getClaudeRslMod().handleClaudeRslHook(event, { ...cwdOptions, event: 'PostToolUse' });
166
+ } catch {
167
+ // Fail open for RSL step telemetry
168
+ }
169
+ }
170
+ const failed = didToolExecutionFail(event);
171
+ const priorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
172
+ loadedPriorSnap = priorSnap;
173
+ const engine = new CircuitBreakerEngine({
174
+ ...cwdOptions,
175
+ horizonConfig,
176
+ mode: effectiveMode,
177
+ initialState: priorSnap
178
+ });
179
+ const toolInput = event.tool_input || event.toolInput || {};
180
+ const cmdStr = String(toolInput.command || toolInput.cmd || event.command || '');
181
+ const rawExit =
182
+ event.exit_code ??
183
+ event.exitCode ??
184
+ event.tool_response?.exit_code ??
185
+ event.tool_response?.exitCode;
186
+ engine.recordToolOutcome(!failed, toolName);
187
+ if (/^(Bash|PowerShell|pwsh|cmd|sh|run_command|execute_bash)$/i.test(toolName)) {
188
+ engine.recordVerificationOutcome({
189
+ succeeded: !failed,
190
+ command: cmdStr,
191
+ outputText: rawOutput
192
+ });
193
+ }
194
+ if (failed && engine.modifiedFilesInTurn.size > 0) {
195
+ // If a test command failed, code edits remain unverified
196
+ engine.codeEditedSinceLastTest = true;
197
+ }
198
+ const editedPath = String(
199
+ event.tool_input?.file_path ||
200
+ event.tool_input?.Path ||
201
+ event.tool_input?.path ||
202
+ event.tool_input?.TargetFile ||
203
+ ''
204
+ );
205
+ const boundaryEval = evaluateTaskBoundaryTurn(
206
+ {
207
+ toolName,
208
+ command: cmdStr,
209
+ filePath: editedPath,
210
+ failed,
211
+ exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0)
212
+ },
213
+ engine.taskBoundaryState
214
+ );
215
+ engine.taskBoundaryState = {
216
+ openFailure: boundaryEval.openFailure,
217
+ editsSinceBoundary: boundaryEval.editsSinceBoundary,
218
+ lastBoundarySuggestedTurn: engine.taskBoundaryState?.lastBoundarySuggestedTurn ?? null
219
+ };
220
+ const nextTurnBoundaryReached =
221
+ boundaryEval.detectorState === 'mid_debug'
222
+ ? false
223
+ : boundaryEval.boundaryDetected
224
+ ? true
225
+ : boundaryEval.editsSinceBoundary > 0 && priorSnap?.turnBoundaryReached
226
+ ? false
227
+ : Boolean(priorSnap?.turnBoundaryReached);
228
+ const nextTurnMidDebug =
229
+ boundaryEval.detectorState === 'mid_debug'
230
+ ? true
231
+ : boundaryEval.boundaryDetected
232
+ ? false
233
+ : Boolean(priorSnap?.turnMidDebug);
234
+ if (Array.isArray(event.active_background_tasks || event.activeBackgroundTasks)) {
235
+ engine.activeBackgroundTasks = (event.active_background_tasks || event.activeBackgroundTasks)
236
+ .filter(Boolean)
237
+ .map((t) => (typeof t === 'string' ? t : String(t?.id || t?.command || 'bg_task')));
238
+ }
239
+ writeBreakerStateSnapshot(
240
+ sessionId,
241
+ {
242
+ ...engine.exportStateSnapshot(),
243
+ turnBoundaryReached: nextTurnBoundaryReached,
244
+ turnMidDebug: nextTurnMidDebug
245
+ },
246
+ cwdOptions
247
+ );
248
+
249
+ // RSI-04 ('micro-skills'): Capture shell failure -> recovery pairs within <= 3 turns
250
+ if (/^(Bash|PowerShell|pwsh|cmd|sh)$/i.test(toolName) && resolveDetectorOverride('micro-skills', horizonConfig) !== 'off') {
251
+ if (cmdStr) {
252
+ getMicroSkillsMod().recordWorkspaceShellOutcome(
253
+ {
254
+ command: cmdStr,
255
+ exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0),
256
+ turn: Number(event.turnId ?? event.turn_id ?? event.turn ?? 1),
257
+ sessionId: String(sessionId),
258
+ confirmSessions: Number(horizonConfig.thresholds?.microSkillConfirmSessions ?? 2)
259
+ },
260
+ cwdOptions
261
+ );
262
+ }
263
+ }
264
+ }
265
+
266
+ if (!loadedPriorSnap && options.bucketBShadow !== false && hasExplicitCwd && /^(?:Grep|Glob)$/i.test(toolName)) {
267
+ loadedPriorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
268
+ }
269
+ const bAlphaPost =
270
+ options.bucketBShadow === false
271
+ ? { triggered: false, updatedOutput: rawOutput, savedTokens: 0 }
272
+ : runBucketBPostToolPass({
273
+ platform: 'claude',
274
+ sessionId,
275
+ cwd: event.cwd || options.cwd || '',
276
+ hasExplicitCwd,
277
+ toolName,
278
+ toolInput: event.tool_input || event.toolInput || {},
279
+ rawOutput,
280
+ lastUserPrompt: event.prompt || loadedPriorSnap?.lastUserPrompt || '',
281
+ activeFiles: event.activeFiles || loadedPriorSnap?.modifiedFilesInTurn || [],
282
+ dirtyFiles: event.dirtyFiles || [],
283
+ lastEditedFile:
284
+ event.lastEditedFile || (loadedPriorSnap?.modifiedFilesInTurn || []).slice(-1)[0] || '',
285
+ webFetchesInTurn: Number(event.webFetchesInTurn || 1),
286
+ options: {
287
+ ...options,
288
+ mode: effectiveMode,
289
+ horizonConfig
290
+ }
291
+ });
292
+
293
+ const effectiveRawOutput = bAlphaPost.triggered ? bAlphaPost.updatedOutput : rawOutput;
294
+
295
+ const sanitized = sanitizePostToolOutput(
296
+ {
297
+ toolName,
298
+ toolOutput: effectiveRawOutput
299
+ },
300
+ cwdOptions
301
+ );
302
+
303
+ let finalOutput = sanitized.updatedToolOutput;
304
+ let wasModified = sanitized.sanitized || Boolean(bAlphaPost.triggered);
305
+
306
+ // Apply DET-19 IPI sanitizer if output comes from a subagent (Task/Agent/agentId) or external WebFetch/MCP tool
307
+ const isSubagentSource =
308
+ Boolean(event.agentId || event.subagentId) || /^(Task|Agent)$/i.test(toolName);
309
+ const isUntrustedSource =
310
+ isSubagentSource || /^(WebFetch|mcp__.+)$/i.test(toolName);
311
+
312
+ if (
313
+ isUntrustedSource &&
314
+ finalOutput &&
315
+ resolveDetectorOverride('DET-19', horizonConfig) !== 'off'
316
+ ) {
317
+ const ipi = evaluateDet19SubagentIpiSanitizer({
318
+ text: finalOutput,
319
+ wrapUntrusted: isSubagentSource
320
+ });
321
+ if (ipi.triggered || isSubagentSource) {
322
+ finalOutput = ipi.sanitizedText;
323
+ wasModified = true;
324
+ }
325
+ }
326
+
327
+ const totalSavedTokens = sanitized.savedTokens + Number(bAlphaPost.savedTokens || 0);
328
+ if (
329
+ totalSavedTokens > 0 &&
330
+ options.recordLedger !== false &&
331
+ (sanitized.savedTokens > 0 || hasExplicitCwd || options.ledgerPath || options.recordLedger === true)
332
+ ) {
333
+ const liveState = options.telemetryState || getTelemetryMod().readLiveStateSnapshot(sessionId, cwdOptions);
334
+ const rawEventModel =
335
+ typeof event.model === 'string'
336
+ ? event.model
337
+ : event.model?.id || event.model?.model_id || event.modelId || event.model_id;
338
+ const modelId = rawEventModel || liveState?.modelId || 'claude-sonnet-5-5';
339
+ const usageSource =
340
+ event.usage || event.context_window?.current_usage || liveState?.contextWindow || {};
341
+ const { computeTotalPromptTokens, resolveEffectiveRates } = getCatalogMod();
342
+ const totalPromptTokens = computeTotalPromptTokens(usageSource);
343
+ const rates = resolveEffectiveRates(modelId, totalPromptTokens, cwdOptions);
344
+ const computedSavedUSD =
345
+ rates && !rates.unknownModel && Number.isFinite(rates.inputPer1M)
346
+ ? Number(((totalSavedTokens / 1_000_000) * rates.inputPer1M).toFixed(6))
347
+ : 0;
348
+
349
+ getSavedQuotaMod().recordSavingsReceipt(
350
+ {
351
+ sessionId,
352
+ modelId: rates.unknownModel ? (rates.rawModelId || modelId) : rates.modelId,
353
+ category: sanitized.offloaded
354
+ ? 'ARTIFACT_OFFLOAD_4K'
355
+ : sanitized.savedTokens > 0
356
+ ? 'LOSSLESS_POST_SANITIZER'
357
+ : bAlphaPost.code || 'BUCKET_B_POST_SHIELD',
358
+ savedTokens: totalSavedTokens,
359
+ savedUSD: computedSavedUSD,
360
+ detail: `${toolName} output compressed (+${totalSavedTokens} tokens saved)`
361
+ },
362
+ cwdOptions
363
+ );
364
+ }
365
+
366
+ if (!wasModified) {
367
+ return {
368
+ exitCode: 0,
369
+ stdout: '',
370
+ stderr: '',
371
+ sanitized
372
+ };
373
+ }
374
+
375
+ // ISS-034: updatedMCPToolOutput applies strictly to MCP tools; built-in tools use additionalContext!
376
+ const isMcpTool = /^mcp__/i.test(toolName);
377
+ const hookSpecificOutput = isMcpTool
378
+ ? {
379
+ hookEventName: 'PostToolUse',
380
+ updatedMCPToolOutput: finalOutput
381
+ }
382
+ : {
383
+ hookEventName: 'PostToolUse',
384
+ additionalContext: finalOutput
385
+ };
386
+
387
+ return {
388
+ exitCode: 0,
389
+ stdout: JSON.stringify({ hookSpecificOutput }),
390
+ stderr: '',
391
+ sanitized,
392
+ hookSpecificOutput
393
+ };
394
+ }
@@ -1,23 +1,10 @@
1
1
  /**
2
2
  * @file hooks/handlers/post-tool-use.mjs
3
- * Tier 2 Command Hook handler for `PostToolUse` (`Bash|PowerShell|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
4
- * Runs lossless output sanitization, 100% critical error-line recovery,
5
- * >4,000 token programmatic artifact offloading (excluding workspace `Read`),
6
- * and `DET-19` subagent IPI boundary & Unicode tag stripping (`ISS-034`, `ISS-053`).
3
+ * Thin Tier-2 Command Hook Fast-Shell for `PostToolUse`
4
+ * (`Bash|PowerShell|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
7
5
  */
8
6
 
9
- import { sanitizePostToolOutput } from '../../src/core-isomorphic/guards/losslessPostSanitizer.mjs';
10
- import {
11
- CircuitBreakerEngine,
12
- evaluateDet19SubagentIpiSanitizer,
13
- readBreakerStateSnapshot,
14
- writeBreakerStateSnapshot
15
- } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
16
- import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
17
- import { recordWorkspaceShellOutcome } from '../../src/core-isomorphic/coach/microSkills.mjs';
18
- import { recordSavingsReceipt } from '../../src/core-isomorphic/coach/savedQuotaLedger.mjs';
19
- import { readLiveStateSnapshot } from '../../src/core-isomorphic/telemetry/telemetryBridge.mjs';
20
- import { resolveEffectiveRates, computeTotalPromptTokens } from '../../src/core-isomorphic/config/catalogLoader.mjs';
7
+ import { createRequire } from 'node:module';
21
8
  import {
22
9
  isCliEntrypoint,
23
10
  readStdinJsonAsync,
@@ -25,214 +12,28 @@ import {
25
12
  exitDiagnosticZero,
26
13
  exitWithStdoutJson
27
14
  } from './hookIo.mjs';
28
-
29
- /**
30
- * Extracts text from a string or structured `tool_response` object.
31
- * @param {object} event
32
- * @returns {string}
33
- */
34
- function extractPostToolText(event = {}) {
35
- const resp = event.tool_response ?? event.tool_output ?? event.toolOutput ?? event.output;
36
- if (typeof resp === 'string') return resp;
37
- if (resp && typeof resp === 'object') {
38
- const parts = [resp.stdout, resp.stderr, resp.output, resp.content, resp.error]
39
- .filter((x) => typeof x === 'string' && x.length > 0);
40
- if (parts.length > 0) return parts.join('\n');
41
- return '';
42
- }
43
- return resp !== undefined && resp !== null ? String(resp) : '';
44
- }
45
-
46
- /**
47
- * Determines whether a completed tool call failed (`is_error`, non-zero `exit_code`, etc.).
48
- * @param {object} event
49
- * @returns {boolean}
50
- */
51
- function didToolExecutionFail(event = {}) {
52
- if (
53
- event.is_error === true ||
54
- event.isError === true ||
55
- event.succeeded === false ||
56
- Boolean(event.tool_error || event.error) ||
57
- (typeof event.exit_code === 'number' && event.exit_code !== 0) ||
58
- (typeof event.exitCode === 'number' && event.exitCode !== 0)
59
- ) {
60
- return true;
61
- }
62
- const resp = event.tool_response;
63
- if (resp && typeof resp === 'object') {
64
- if (
65
- resp.is_error === true ||
66
- resp.isError === true ||
67
- resp.succeeded === false ||
68
- resp.status === 'error' ||
69
- resp.status === 'failed' ||
70
- Boolean(resp.error) ||
71
- (typeof resp.exit_code === 'number' && resp.exit_code !== 0) ||
72
- (typeof resp.exitCode === 'number' && resp.exitCode !== 0) ||
73
- (typeof resp.returncode === 'number' && resp.returncode !== 0)
74
- ) {
75
- return true;
76
- }
77
- }
78
- return false;
15
+ import {
16
+ tryFastDaemonRpc,
17
+ tryTier1PostToolFastPath
18
+ } from '../../src/hooks/fast_hook_ipc.mjs';
19
+
20
+ const requireFromHere = createRequire(import.meta.url);
21
+ let _coreMod = null;
22
+ function getCoreSync() {
23
+ if (!_coreMod) _coreMod = requireFromHere('./post-tool-use-core.mjs');
24
+ return _coreMod;
79
25
  }
80
26
 
81
27
  /**
82
- * Evaluates a `PostToolUse` hook payload and returns the contract response.
83
- * @param {object} event
28
+ * Synchronous programmatic wrapper delegating to `post-tool-use-core.mjs`.
29
+ *
30
+ * @param {object} [event={}]
84
31
  * @param {object} [options={}]
85
32
  */
86
33
  export function runPostToolUseHook(event = {}, options = {}) {
87
- const toolName = String(event.tool_name || event.toolName || 'Bash');
88
- const rawOutput = extractPostToolText(event);
89
- const tier1Active = Boolean(
90
- options.tier1ModActive ||
91
- event.tier1ModActive ||
92
- globalThis.process?.env?.AH_TIER1_MOD_ACTIVE === '1'
93
- );
94
- if (tier1Active && /^(Grep|Glob)$/i.test(toolName) && rawOutput.length < 16000 && !didToolExecutionFail(event)) {
95
- return {
96
- exitCode: 0,
97
- stdout: '',
98
- stderr: '',
99
- fastPath: 'tier1_mod_active',
100
- sanitized: { modified: false, offloaded: false }
101
- };
102
- }
103
- const sessionId = event.session_id || event.sessionId || 'default';
104
- const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
105
- const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
106
-
107
- const shouldPersistState =
108
- options.persistState !== false &&
109
- Boolean(event.cwd || options.cwd || options.breakerStatePath || options.persistState);
110
-
111
- if (shouldPersistState) {
112
- const failed = didToolExecutionFail(event);
113
- const priorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
114
- const engine = new CircuitBreakerEngine({
115
- ...cwdOptions,
116
- horizonConfig,
117
- mode: event.mode || options.mode || horizonConfig.flightMode || 'COACH',
118
- initialState: priorSnap
119
- });
120
- engine.recordToolOutcome(!failed, toolName);
121
- if (failed && engine.modifiedFilesInTurn.size > 0) {
122
- // If a test command failed, code edits remain unverified
123
- engine.codeEditedSinceLastTest = true;
124
- }
125
- writeBreakerStateSnapshot(sessionId, engine.exportStateSnapshot(), cwdOptions);
126
-
127
- // RSI-04 ('micro-skills'): Capture shell failure -> recovery pairs within <= 3 turns
128
- if (/^(Bash|PowerShell|pwsh|cmd|sh)$/i.test(toolName) && resolveDetectorOverride('micro-skills', horizonConfig) !== 'off') {
129
- const toolInput = event.tool_input || event.toolInput || {};
130
- const cmdStr = String(toolInput.command || toolInput.cmd || event.command || '');
131
- if (cmdStr) {
132
- const rawExit =
133
- event.exit_code ??
134
- event.exitCode ??
135
- event.tool_response?.exit_code ??
136
- event.tool_response?.exitCode;
137
- recordWorkspaceShellOutcome(
138
- {
139
- command: cmdStr,
140
- exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0),
141
- turn: Number(event.turnId ?? event.turn_id ?? event.turn ?? 1),
142
- sessionId: String(sessionId),
143
- confirmSessions: Number(horizonConfig.thresholds?.microSkillConfirmSessions ?? 2)
144
- },
145
- cwdOptions
146
- );
147
- }
148
- }
149
- }
150
-
151
- const sanitized = sanitizePostToolOutput(
152
- {
153
- toolName,
154
- toolOutput: rawOutput
155
- },
156
- cwdOptions
157
- );
158
-
159
- let finalOutput = sanitized.updatedToolOutput;
160
- let wasModified = sanitized.sanitized;
161
-
162
- // Apply DET-19 IPI sanitizer if output comes from a subagent (Task/Agent/agentId) or external WebFetch/MCP tool
163
- const isSubagentSource =
164
- Boolean(event.agentId || event.subagentId) || /^(Task|Agent)$/i.test(toolName);
165
- const isUntrustedSource =
166
- isSubagentSource || /^(WebFetch|mcp__.+)$/i.test(toolName);
167
-
168
- if (
169
- isUntrustedSource &&
170
- finalOutput &&
171
- resolveDetectorOverride('DET-19', horizonConfig) !== 'off'
172
- ) {
173
- const ipi = evaluateDet19SubagentIpiSanitizer({
174
- text: finalOutput,
175
- wrapUntrusted: isSubagentSource
176
- });
177
- if (ipi.triggered || isSubagentSource) {
178
- finalOutput = ipi.sanitizedText;
179
- wasModified = true;
180
- }
181
- }
182
-
183
- if (sanitized.savedTokens > 0 && options.recordLedger !== false) {
184
- const liveState = options.telemetryState || readLiveStateSnapshot(sessionId, cwdOptions);
185
- const rawEventModel =
186
- typeof event.model === 'string'
187
- ? event.model
188
- : event.model?.id || event.model?.model_id || event.modelId || event.model_id;
189
- const modelId = rawEventModel || liveState?.modelId || 'claude-sonnet-5-5';
190
- const usageSource =
191
- event.usage || event.context_window?.current_usage || liveState?.contextWindow || {};
192
- const totalPromptTokens = computeTotalPromptTokens(usageSource);
193
- const rates = resolveEffectiveRates(modelId, totalPromptTokens, cwdOptions);
194
-
195
- recordSavingsReceipt(
196
- {
197
- sessionId,
198
- modelId: rates.modelId,
199
- category: sanitized.offloaded ? 'ARTIFACT_OFFLOAD_4K' : 'LOSSLESS_POST_SANITIZER',
200
- savedTokens: sanitized.savedTokens,
201
- savedUSD: Number(((sanitized.savedTokens / 1_000_000) * rates.inputPer1M).toFixed(6)),
202
- detail: `${toolName} output compressed (${sanitized.originalTokens} -> ${sanitized.finalTokens} tokens)`
203
- },
204
- cwdOptions
205
- );
206
- }
207
-
208
- if (!wasModified) {
209
- return {
210
- exitCode: 0,
211
- stdout: '',
212
- stderr: '',
213
- sanitized
214
- };
215
- }
216
-
217
- // ISS-034: updatedMCPToolOutput applies strictly to MCP tools; built-in tools use additionalContext!
218
- const isMcpTool = /^mcp__/i.test(toolName);
219
- const hookSpecificOutput = isMcpTool
220
- ? {
221
- hookEventName: 'PostToolUse',
222
- updatedMCPToolOutput: finalOutput
223
- }
224
- : {
225
- hookEventName: 'PostToolUse',
226
- additionalContext: finalOutput
227
- };
228
-
229
- return {
230
- exitCode: 0,
231
- stdout: JSON.stringify({ hookSpecificOutput }),
232
- stderr: '',
233
- sanitized,
234
- hookSpecificOutput
235
- };
34
+ const fast = tryTier1PostToolFastPath(event, options);
35
+ if (fast) return fast;
36
+ return getCoreSync().runPostToolUseHook(event, options);
236
37
  }
237
38
 
238
39
  /**
@@ -243,11 +44,44 @@ export function runPostToolUseHook(event = {}, options = {}) {
243
44
  */
244
45
  export async function executePostToolUseCli(cliOptions = {}) {
245
46
  const readPayload = cliOptions.readPayload || readStdinJsonAsync;
246
- const runHook = cliOptions.runHook || runPostToolUseHook;
247
47
  const ioOverride = cliOptions.ioOverride || {};
248
48
  try {
249
49
  const payload = await readPayload(cliOptions.timeoutMs);
250
- const res = runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
50
+ const hasCustomOptions = Boolean(cliOptions.runHook || cliOptions.hookOptions);
51
+
52
+ if (cliOptions.runHook) {
53
+ const res = cliOptions.runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
54
+ if (res.stdout) {
55
+ exitWithStdoutJson(res.stdout, ioOverride);
56
+ } else {
57
+ exitPassThrough(ioOverride.exitFn);
58
+ }
59
+ return;
60
+ }
61
+
62
+ if (!hasCustomOptions) {
63
+ if (tryTier1PostToolFastPath(payload)) {
64
+ exitPassThrough(ioOverride.exitFn);
65
+ return;
66
+ }
67
+
68
+ const ipcRes = await tryFastDaemonRpc(
69
+ 'hook.claude.postToolUse',
70
+ { event: payload },
71
+ { ipcPath: cliOptions.ipcPath }
72
+ );
73
+ if (ipcRes && ipcRes.fullVerdict === true) {
74
+ if (ipcRes.stdout) {
75
+ exitWithStdoutJson(ipcRes.stdout, ioOverride);
76
+ } else {
77
+ exitPassThrough(ioOverride.exitFn);
78
+ }
79
+ return;
80
+ }
81
+ }
82
+
83
+ const { runPostToolUseHook: runCore } = await import('./post-tool-use-core.mjs');
84
+ const res = runCore(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
251
85
  if (res.stdout) {
252
86
  exitWithStdoutJson(res.stdout, ioOverride);
253
87
  } else {