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
@@ -1,946 +1,64 @@
1
- import fs from 'node:fs';
2
- import path from 'node:path';
3
- import { fileURLToPath } from 'node:url';
4
- import { readSidecarSync, writeSidecarAtomicSync, getSidecarPath } from '../core/sidecar_store.mjs';
5
- import { canonicalizePath } from '../core/path_canonicalizer.mjs';
6
- import { scorePromptSufficiency, toWorkspaceRelativePath } from '../core/prompt_rubric.mjs';
7
- import { loadFlightcheckConfig } from '../core/config.mjs';
8
- import {
9
- resolveModelCeiling,
10
- normalizeModelKey,
11
- isModelDeprecated,
12
- getDeprecatedModelMigrationNotice,
13
- evaluateCarbonVerbosityGuardrail
14
- } from '../core/constants.mjs';
15
- import {
16
- SwarmIdleTtlTracker,
17
- evaluateSwarmColdCacheWakeup,
18
- computeSwarmRosterTtlBadges
19
- } from '../core/subagents.mjs';
20
- import {
21
- classifyTaskComplexity,
22
- CacheGravityScorer,
23
- TaskMdDirectiveWatcher,
24
- ModelSelectorActuator,
25
- evaluateTaskAndQuotaRoute
26
- } from '../core/task_quota_router.mjs';
27
- import { loadHorizonConfig, resolveDetectorOverride } from '../core/horizon_config.mjs';
28
- import {
29
- evaluateDet08DestructiveShell,
30
- evaluateDet09MidSessionRuleMutate,
31
- evaluateDet18UntrustedWorkspaceSettings,
32
- evaluateDet19GitHookBypass,
33
- evaluateDet20ScopeCollision
34
- } from '../core/detectors_det01_to_16.mjs';
35
- import { loadRegistry } from '../core/telemetry/scope_lock_registry.mjs';
36
- import { recordHookDiagnostic } from '../core/hook_diagnostics.mjs';
37
- import {
38
- evaluateScopeBrake,
39
- evaluateRelayBreaker,
40
- evaluateTwoStageSightseeingIntercept
41
- } from '../core/shared/prompt_hygiene_governor.mjs';
42
- import { foldCodeToSignatureStub, computeCompactLineDiff } from '../core/pruner.mjs';
43
-
44
- export {
45
- classifyTaskComplexity,
46
- CacheGravityScorer,
47
- TaskMdDirectiveWatcher,
48
- ModelSelectorActuator,
49
- evaluateTaskAndQuotaRoute
50
- };
51
-
52
- async function readStdinSafe({ maxTimeoutMs = 1000, settleMs = 50 } = {}) {
53
- if (process.stdin.isTTY || process.stdin.readableEnded) return {};
54
- return new Promise((resolve) => {
55
- let raw = '';
56
- let settled = false;
57
- let settleTimer = null;
58
-
59
- const finish = (val) => {
60
- if (settled) return;
61
- settled = true;
62
- clearTimeout(maxTimer);
63
- if (settleTimer) clearTimeout(settleTimer);
64
- try {
65
- process.stdin.pause();
66
- } catch (err) {
67
- recordHookDiagnostic('pre_invocation', 'stdin.pause', err, { persist: false });
68
- }
69
- resolve(val);
70
- };
71
-
72
- const tryParse = () => {
73
- try {
74
- return raw ? JSON.parse(raw) : {};
75
- } catch (err) {
76
- recordHookDiagnostic('pre_invocation', 'stdin.parse', err);
77
- return {};
78
- }
79
- };
80
-
81
- const maxTimer = setTimeout(() => finish(tryParse()), maxTimeoutMs);
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @file src/hooks/pre_invocation.mjs
4
+ * Thin Fast-Shell Entrypoint for Google Antigravity `PreInvocation` and `PreToolUse` hooks.
5
+ *
6
+ * Imports only `node:module` and `./fast_hook_ipc.mjs` on startup so warm daemon IPC
7
+ * and bounded workspace reads execute in ~55-58ms on Windows before lazily loading
8
+ * `pre_invocation_core.mjs`.
9
+ */
82
10
 
83
- process.stdin.setEncoding('utf8');
84
- process.stdin.on('data', chunk => {
85
- raw += chunk;
86
- if (settleTimer) clearTimeout(settleTimer);
87
- if (raw.trim().endsWith('}')) {
88
- settleTimer = setTimeout(() => {
89
- try {
90
- finish(JSON.parse(raw));
91
- } catch (err) {
92
- recordHookDiagnostic('pre_invocation', 'stdin.settleParse', err, { persist: false });
93
- }
94
- }, settleMs);
95
- }
96
- });
97
- process.stdin.on('end', () => finish(tryParse()));
98
- process.stdin.on('error', (err) => {
99
- recordHookDiagnostic('pre_invocation', 'stdin.error', err);
100
- finish({});
101
- });
102
- });
11
+ import { createRequire } from 'node:module';
12
+ import {
13
+ tryFastDaemonRpc,
14
+ canFastAllowBoundedRead,
15
+ readStdinFast
16
+ } from './fast_hook_ipc.mjs';
17
+
18
+ const requireFromHere = createRequire(import.meta.url);
19
+ let _routerMod = null;
20
+ function getRouterModSync() {
21
+ if (!_routerMod) _routerMod = requireFromHere('../core/task_quota_router.mjs');
22
+ return _routerMod;
103
23
  }
104
24
 
105
- function formatScorecard(p1, p2, p3, p4) {
106
- const pad = (s, len = 74) => s.length >= len ? s.slice(0, len) : s + ' '.repeat(len - s.length);
107
- return [
108
- '╭─ Flight Check v3.1 ──────────────────────────────────────────────────────────╮',
109
- `│ 1. PROMPT : ${pad(p1, 62)} │`,
110
- `│ 2. HORIZON: ${pad(p2, 62)} │`,
111
- `│ 3. ACTION : ${pad(p3, 62)} │`,
112
- `│ 4. REWRITE: ${pad(p4, 62)} │`,
113
- '╰──────────────────────────────────────────────────────────────────────────────╯',
114
- 'Bypass once: prefix with `!` • Lock model/effort: include `!lock`'
115
- ].join('\n');
25
+ export function classifyTaskComplexity(...args) {
26
+ return getRouterModSync().classifyTaskComplexity(...args);
116
27
  }
117
28
 
118
- function recordAntigravitySidecarSavings(sidecar, { category = 'BOUNDED_READ_ENFORCED', savedTokens = 0, detail = '', nowMs = Date.now() } = {}) {
119
- const tokens = Math.max(0, Number(savedTokens || 0));
120
- if (!sidecar || typeof sidecar !== 'object' || tokens <= 0) return;
121
- sidecar.telemetry = sidecar.telemetry && typeof sidecar.telemetry === 'object' ? sidecar.telemetry : {};
122
- sidecar.telemetry.savedTokens = Number(sidecar.telemetry.savedTokens || 0) + tokens;
123
- sidecar.telemetry.boundedReadInterventions = Number(sidecar.telemetry.boundedReadInterventions || 0) + 1;
124
- sidecar.telemetry.savedTokensByCategory =
125
- sidecar.telemetry.savedTokensByCategory && typeof sidecar.telemetry.savedTokensByCategory === 'object'
126
- ? sidecar.telemetry.savedTokensByCategory
127
- : {};
128
- sidecar.telemetry.savedTokensByCategory[category] =
129
- Number(sidecar.telemetry.savedTokensByCategory[category] || 0) + tokens;
130
- const recent = Array.isArray(sidecar.telemetry.recentInterventions)
131
- ? sidecar.telemetry.recentInterventions
132
- : [];
133
- recent.push({
134
- ts: new Date(nowMs).toISOString(),
135
- category,
136
- savedTokens: tokens,
137
- detail
138
- });
139
- sidecar.telemetry.recentInterventions = recent.slice(-25);
29
+ export function evaluateTaskAndQuotaRoute(...args) {
30
+ return getRouterModSync().evaluateTaskAndQuotaRoute(...args);
140
31
  }
141
32
 
142
- export async function handlePreToolUse(inputData = {}) {
143
- const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
144
- const sidecar = readSidecarSync(conversationId);
145
- sidecar.sessionMeta = sidecar.sessionMeta || {};
146
- sidecar.swarmRoster = sidecar.swarmRoster || {};
147
-
148
- // Phase 3.2: Buffer mid-turn model switches without mutating active_model_id
149
- const requestedMidTurnModel = inputData.requestedModel || inputData.newModel || inputData.pending_model_id || null;
150
- if (requestedMidTurnModel) {
151
- const normalizedNext = normalizeModelKey(requestedMidTurnModel);
152
- if (!sidecar.sessionMeta.active_model_id) {
153
- sidecar.sessionMeta.active_model_id = normalizeModelKey(
154
- inputData.active_model_id || inputData.modelName || sidecar.sessionMeta.activeModel || 'gemini-3.8-flash'
155
- );
156
- }
157
- if (normalizedNext !== sidecar.sessionMeta.active_model_id) {
158
- sidecar.sessionMeta.pending_model_id = normalizedNext;
159
- }
160
- }
161
-
162
- const toolName = String(inputData.tool_name || inputData.tool || inputData.toolName || '').trim();
163
- const toolInput = inputData.tool_input || inputData.toolInput || inputData.args || inputData.parameters || inputData.Arguments || inputData;
164
- const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
165
- const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
166
- cwd: workspacePath,
167
- ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
168
- });
169
- const flightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
170
- const isSilentMode = flightMode === 'SILENT';
171
- const isOffMode = flightMode === 'OFF';
172
- const isAutoPilotMode = flightMode === 'AUTO_PILOT';
173
-
174
- const syntheticStep = [{
175
- toolCalls: [{
176
- name: toolName,
177
- args: toolInput && typeof toolInput === 'object' ? toolInput : {}
178
- }]
179
- }];
180
-
181
- const makeBlockPayload = (detResult) => ({
182
- decision: 'block',
183
- permissionDecision: 'deny',
184
- terminationBehavior: 'terminate',
185
- blocked: true,
186
- flightMode,
187
- detectorId: detResult.id,
188
- reason: detResult.message,
189
- userMessage: detResult.message,
190
- systemMessage: detResult.message
191
- });
192
-
193
- // Ring-0 Security Gates (active even in SILENT / OFF unless explicitly disabled in Antigravity namespace)
194
- if (/^(run_command|execute_bash|bash|powershell|exec)$/i.test(toolName)) {
195
- if (resolveDetectorOverride(horizonConfig, 'DET-19') !== 'off') {
196
- const det19 = evaluateDet19GitHookBypass(syntheticStep);
197
- if (det19) return makeBlockPayload(det19);
198
- }
199
- if (resolveDetectorOverride(horizonConfig, 'DET-08') !== 'off') {
200
- const det08 = evaluateDet08DestructiveShell(syntheticStep);
201
- if (det08) return makeBlockPayload(det08);
202
- }
203
- }
204
- if (/^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content|run_command|execute_bash|bash|powershell)$/i.test(toolName)) {
205
- if (resolveDetectorOverride(horizonConfig, 'DET-18') !== 'off') {
206
- const det18 = evaluateDet18UntrustedWorkspaceSettings(syntheticStep, {
207
- workspacePath,
208
- scanWorkspace: false
209
- });
210
- if (det18) return makeBlockPayload(det18);
211
- }
212
- }
213
-
214
- // Non-Ring-0 Guardrails (DET-09 warm-cache rule fence, DET-20 concurrent scope lock collision, Two-Stage Prompt Hygiene)
215
- let gateSystemMessage = null;
216
- if (!isOffMode) {
217
- const scopeOverride = resolveDetectorOverride(horizonConfig, 'vague-prompt-rubric');
218
- const relayOverride = resolveDetectorOverride(horizonConfig, 'relay-breaker');
219
- const twoStage = evaluateTwoStageSightseeingIntercept({
220
- toolName,
221
- toolArgs: toolInput && typeof toolInput === 'object' ? toolInput : {},
222
- unanchoredTurnFlag: Boolean(inputData.unanchoredTurnFlag ?? sidecar.sessionMeta?.unanchoredTurnFlag),
223
- candidateFiles: Array.isArray(inputData.candidateFiles)
224
- ? inputData.candidateFiles
225
- : (sidecar.fileState?.modifiedFiles || sidecar.fileState?.activeSetPaths || []),
226
- relayState: inputData.relayState ?? sidecar.sessionMeta?.relayState,
227
- overrideMode: scopeOverride !== 'default' ? scopeOverride : relayOverride,
228
- flightMode,
229
- detectorId: 'DET-26'
230
- });
231
- if (twoStage.intercepted) {
232
- if (twoStage.consumeFlag && sidecar.sessionMeta) {
233
- sidecar.sessionMeta.unanchoredTurnFlag = false;
234
- sidecar.sessionMeta.sightseeingToolsPrevented = Number(sidecar.sessionMeta.sightseeingToolsPrevented || 0) + 1;
235
- try {
236
- writeSidecarAtomicSync(conversationId, sidecar);
237
- } catch (err) {
238
- recordHookDiagnostic('pre_invocation', 'twoStage.writeSidecar', err);
239
- }
240
- }
241
- if (twoStage.decision === 'deny') {
242
- return makeBlockPayload({ id: twoStage.detectorId, message: twoStage.reason });
243
- }
244
- if (!isSilentMode) gateSystemMessage = twoStage.reason;
245
- }
246
- }
247
- if (!isOffMode && /^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content)$/i.test(toolName)) {
248
- const det09Mode = resolveDetectorOverride(horizonConfig, 'DET-09');
249
- if (det09Mode !== 'off') {
250
- const det09 = evaluateDet09MidSessionRuleMutate(syntheticStep, {
251
- cachedTokens: inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? sidecar.telemetry?.totalInputTokens ?? 0,
252
- cacheTtlSeconds: inputData.cacheTtlSeconds ?? sidecar.telemetry?.cacheTtlSeconds ?? 300,
253
- cacheState: inputData.cacheState
254
- });
255
- if (det09) {
256
- if (isAutoPilotMode || det09Mode === 'block') return makeBlockPayload(det09);
257
- if (!isSilentMode) gateSystemMessage = det09.message;
258
- }
259
- }
260
-
261
- const det20Mode = resolveDetectorOverride(horizonConfig, 'DET-20');
262
- if (det20Mode !== 'off') {
263
- const rawTarget = String(
264
- toolInput?.Path || toolInput?.path || toolInput?.TargetFile || toolInput?.AbsolutePath || ''
265
- ).trim();
266
- if (rawTarget) {
267
- const relTarget = path.isAbsolute(rawTarget)
268
- ? path.relative(workspacePath, rawTarget).replace(/\\/g, '/')
269
- : rawTarget.replace(/\\/g, '/');
270
- const activeLeases = Array.isArray(inputData.activeLeases)
271
- ? inputData.activeLeases
272
- : loadRegistry(workspacePath).leases;
273
- const det20 = evaluateDet20ScopeCollision([], {
274
- currentTrajectoryId: conversationId,
275
- claimedPaths: [relTarget],
276
- activeLeases,
277
- workspaceDir: workspacePath
278
- });
279
- if (det20) {
280
- if (isAutoPilotMode || det20Mode === 'block') return makeBlockPayload(det20);
281
- if (!isSilentMode && !gateSystemMessage) gateSystemMessage = det20.message;
282
- }
283
- }
284
- }
285
- }
286
-
287
- const nowMs = inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now();
288
- const eventTimestampUtc = inputData.eventTimestampUtc ?? nowMs;
289
- const serviceTier = inputData.serviceTier || 'standard';
290
- const tracker = new SwarmIdleTtlTracker({
291
- initialRoster: inputData.swarmRoster || sidecar.swarmRoster,
292
- cacheTtlMs: inputData.cacheTtlMs ?? 300000,
293
- coldWakeThresholdTokens: inputData.coldWakeThresholdTokens ?? 100000
294
- });
295
-
296
- let coldCacheWakeup = null;
297
- let systemMessage = gateSystemMessage;
298
- let astSignatureStub = null;
299
- let deltaDiffStub = null;
300
- let astStubSavedTokens = 0;
301
-
302
- if (!isOffMode && (toolName === 'read_file' || toolName === 'Read' || toolName === 'view_file')) {
303
- const rawTarget = String(
304
- toolInput?.Path || toolInput?.path || toolInput?.file_path || toolInput?.TargetFile || toolInput?.AbsolutePath || ''
305
- ).trim();
306
- const hasLineBounds = Number.isFinite(Number(toolInput?.StartLine ?? toolInput?.start_line ?? toolInput?.offset)) ||
307
- Number.isFinite(Number(toolInput?.EndLine ?? toolInput?.end_line ?? toolInput?.limit));
308
- if (rawTarget && !hasLineBounds) {
309
- const resolvedPath = path.isAbsolute(rawTarget) ? rawTarget : path.resolve(workspacePath, rawTarget);
310
- const normKey = resolvedPath.replace(/\\/g, '/').toLowerCase();
311
- if (!sidecar.fileState || typeof sidecar.fileState !== 'object') sidecar.fileState = {};
312
- if (!sidecar.fileState.unclippedReadCounts || typeof sidecar.fileState.unclippedReadCounts !== 'object') {
313
- sidecar.fileState.unclippedReadCounts = {};
314
- }
315
- if (!sidecar.fileState.readSnapshots || typeof sidecar.fileState.readSnapshots !== 'object') {
316
- sidecar.fileState.readSnapshots = {};
317
- }
318
- const priorReads = Number(inputData.priorUnclippedReads ?? sidecar.fileState.unclippedReadCounts[normKey] ?? 0);
319
- const nextReads = priorReads + 1;
320
- sidecar.fileState.unclippedReadCounts[normKey] = nextReads;
321
-
322
- if (fs.existsSync(resolvedPath)) {
323
- try {
324
- const stat = fs.statSync(resolvedPath);
325
- if (stat.isFile() && stat.size > 256 && stat.size <= 512 * 1024) {
326
- const rawContent = fs.readFileSync(resolvedPath, 'utf8');
327
- const prevSnap = typeof inputData.priorContentSnapshot === 'string'
328
- ? inputData.priorContentSnapshot
329
- : (typeof sidecar.fileState.readSnapshots[normKey] === 'string' ? sidecar.fileState.readSnapshots[normKey] : null);
330
-
331
- if (prevSnap !== null && prevSnap !== rawContent) {
332
- const delta = computeCompactLineDiff(prevSnap, rawContent, path.basename(resolvedPath));
333
- if (delta.wasDiffed) {
334
- deltaDiffStub = delta.diffText;
335
- astStubSavedTokens = delta.savedTokens;
336
- const deltaNotice = `[Highbeam Post-Edit Delta Read — ${path.basename(resolvedPath)} (+${delta.savedTokens} tokens saved)]\n${delta.diffText}`;
337
- if (!isSilentMode && !systemMessage) {
338
- systemMessage = deltaNotice;
339
- }
340
- try {
341
- recordAntigravitySidecarSavings(sidecar, {
342
- category: 'BOUNDED_READ_ENFORCED',
343
- savedTokens: delta.savedTokens,
344
- detail: `Post-edit delta read for ${path.basename(resolvedPath)}`,
345
- nowMs: inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now()
346
- });
347
- } catch (err) {
348
- recordHookDiagnostic('pre_invocation', 'handlePreToolUse.recordDeltaSavings', err);
349
- }
350
- }
351
- } else if (nextReads >= 3 && stat.size > 512) {
352
- const fullTokens = Math.max(1, Math.ceil(rawContent.length / 4));
353
- const folded = foldCodeToSignatureStub(rawContent, resolvedPath);
354
- const stubText = typeof folded?.condensed === 'string' && folded.condensed.length > 0
355
- ? folded.condensed
356
- : rawContent.slice(0, 1200);
357
- const stubTokens = Math.max(1, Math.ceil(stubText.length / 4));
358
- astStubSavedTokens = Math.max(0, fullTokens - stubTokens);
359
- astSignatureStub = stubText;
360
- const stubNotice = `[Highbeam AST Signature Stub — Read #${nextReads} of ${path.basename(resolvedPath)} (${astStubSavedTokens} tokens saved; pass StartLine/EndLine for full bodies)]\n${stubText}`;
361
- if (!isSilentMode && !systemMessage) {
362
- systemMessage = stubNotice;
363
- }
364
- if (astStubSavedTokens > 0) {
365
- try {
366
- recordAntigravitySidecarSavings(sidecar, {
367
- category: 'BOUNDED_READ_ENFORCED',
368
- savedTokens: astStubSavedTokens,
369
- detail: `AST signature stub read #${nextReads} for ${path.basename(resolvedPath)}`,
370
- nowMs: inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now()
371
- });
372
- } catch (err) {
373
- recordHookDiagnostic('pre_invocation', 'handlePreToolUse.recordAstStubSavings', err);
374
- }
375
- }
376
- }
377
-
378
- if (rawContent.length <= 128 * 1024) {
379
- const snapKeys = Object.keys(sidecar.fileState.readSnapshots);
380
- if (!sidecar.fileState.readSnapshots[normKey] && snapKeys.length >= 12) {
381
- delete sidecar.fileState.readSnapshots[snapKeys[0]];
382
- }
383
- sidecar.fileState.readSnapshots[normKey] = rawContent;
384
- }
385
- }
386
- } catch (err) {
387
- recordHookDiagnostic('pre_invocation', 'handlePreToolUse.astSignatureStub', err);
388
- }
389
- }
390
- }
33
+ export class CacheGravityScorer {
34
+ constructor(...args) {
35
+ const { CacheGravityScorer: Impl } = getRouterModSync();
36
+ return new Impl(...args);
391
37
  }
38
+ }
392
39
 
393
- if (toolName === 'send_message' || toolInput?.Recipient || toolInput?.recipient || /@[a-z0-9_-]+/i.test(String(toolInput?.Message || toolInput?.message || toolInput?.brief || ''))) {
394
- coldCacheWakeup = tracker.handlePreToolSendMessage(toolInput, {
395
- nowMs,
396
- eventTimestampUtc,
397
- serviceTier
398
- });
399
- if (coldCacheWakeup.coldWakeDetected) {
400
- if (isAutoPilotMode && !inputData.allowColdWake && Number(coldCacheWakeup.incrementalColdPenaltyUsd || 0) >= 0.5) {
401
- return {
402
- decision: 'block',
403
- permissionDecision: 'deny',
404
- terminationBehavior: 'terminate',
405
- blocked: true,
406
- flightMode,
407
- autoPilotGate: 'COLD_CACHE_CLIFF_HOLD',
408
- coldCacheWakeup,
409
- reason: coldCacheWakeup.message,
410
- userMessage: coldCacheWakeup.message,
411
- systemMessage: coldCacheWakeup.message
412
- };
413
- }
414
- if (!isSilentMode && !isOffMode) {
415
- systemMessage = coldCacheWakeup.message;
416
- }
417
- }
418
- } else if (toolName === 'invoke_subagent' || toolName === 'define_subagent') {
419
- const subagentId = toolInput?.ConversationId || toolInput?.conversationId || toolInput?.Name || toolInput?.TypeName || toolInput?.Role || 'subagent';
420
- const subagentModel = toolInput?.Model && toolInput.Model !== 'inherit'
421
- ? toolInput.Model
422
- : (sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || 'gemini-4-carbon');
423
- tracker.touchAgentActive(subagentId, {
424
- modelId: subagentModel,
425
- warmPrefixTokens: Number(toolInput?.warm_prefix_tokens ?? 0),
426
- timestampMs: nowMs
427
- });
428
- } else if (toolName === 'manage_subagents') {
429
- const action = String(toolInput?.Action || toolInput?.action || '').toLowerCase();
430
- if (action === 'kill' && Array.isArray(toolInput?.ConversationIds)) {
431
- for (const id of toolInput.ConversationIds) {
432
- tracker.terminateAgent(id, { timestampMs: nowMs });
433
- }
434
- } else if (action === 'kill_all') {
435
- for (const id of Object.keys(tracker.getRosterSnapshot())) {
436
- tracker.terminateAgent(id, { timestampMs: nowMs });
437
- }
438
- }
40
+ export class TaskMdDirectiveWatcher {
41
+ constructor(...args) {
42
+ const { TaskMdDirectiveWatcher: Impl } = getRouterModSync();
43
+ return new Impl(...args);
439
44
  }
45
+ }
440
46
 
441
- sidecar.swarmRoster = tracker.getRosterSnapshot();
442
- sidecar.swarmTtlBadges = computeSwarmRosterTtlBadges(sidecar.swarmRoster, {
443
- nowMs,
444
- cacheTtlMs: inputData.cacheTtlMs ?? 300000
445
- });
446
-
447
- try {
448
- writeSidecarAtomicSync(conversationId, sidecar);
449
- } catch (err) {
450
- recordHookDiagnostic('pre_invocation', 'handlePreToolUse.writeSidecar', err);
47
+ export class ModelSelectorActuator {
48
+ constructor(...args) {
49
+ const { ModelSelectorActuator: Impl } = getRouterModSync();
50
+ return new Impl(...args);
451
51
  }
52
+ }
452
53
 
453
- const response = {
454
- decision: 'allow',
455
- flightMode,
456
- active_model_id: sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || null,
457
- pending_model_id: sidecar.sessionMeta.pending_model_id || null,
458
- swarmTtlBadges: sidecar.swarmTtlBadges
459
- };
460
- if (coldCacheWakeup) response.coldCacheWakeup = coldCacheWakeup;
461
- if (astSignatureStub) {
462
- response.astSignatureStub = astSignatureStub;
463
- response.savedTokens = astStubSavedTokens;
464
- }
465
- if (deltaDiffStub) {
466
- response.deltaDiffStub = deltaDiffStub;
467
- response.savedTokens = astStubSavedTokens;
468
- }
469
- if (systemMessage && !isSilentMode && !isOffMode) response.systemMessage = systemMessage;
470
- return response;
54
+ export async function handlePreToolUse(inputData = {}) {
55
+ const { handlePreToolUse: impl } = await import('./pre_invocation_core.mjs');
56
+ return impl(inputData);
471
57
  }
472
58
 
473
59
  export async function handlePreInvocation(inputData = {}) {
474
- if (
475
- inputData.hook_event_name === 'PreToolUse' ||
476
- inputData.event === 'PreToolUse' ||
477
- inputData.tool_name ||
478
- inputData.toolName ||
479
- inputData.tool_input ||
480
- inputData.args ||
481
- inputData.parameters ||
482
- inputData.Arguments ||
483
- (typeof inputData.tool === 'string' && inputData.tool.length > 0) ||
484
- (typeof inputData.name === 'string' && !inputData.prompt && !inputData.user_input)
485
- ) {
486
- return handlePreToolUse(inputData);
487
- }
488
-
489
- const config = inputData.configOverride || loadFlightcheckConfig();
490
- const rawPrompt = String(inputData.prompt || inputData.user_input || inputData.message || '').trim();
491
- const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
492
- const sidecar = readSidecarSync(conversationId);
493
- const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
494
- const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
495
- cwd: workspacePath,
496
- ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
497
- });
498
- const flightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
499
-
500
- // 1. Control Flags & flightMode Handling (ISS-039)
501
- if (config.hook_level === 'off' || flightMode === 'OFF') {
502
- return {};
503
- }
504
- if (flightMode === 'SILENT') {
505
- // SILENT suppresses all non-Ring-0 advisory context/stderr chatter on PreInvocation
506
- // (Ring-0 security blocks remain active in PreToolUse and workspace settings checks).
507
- if (resolveDetectorOverride(horizonConfig, 'DET-18') !== 'off' && inputData.scanWorkspaceSettings === true) {
508
- const det18 = evaluateDet18UntrustedWorkspaceSettings([], { workspacePath, scanWorkspace: true });
509
- if (det18) {
510
- return { terminationBehavior: 'terminate', decision: 'block', detectorId: 'DET-18', userMessage: det18.message };
511
- }
512
- }
513
- return {};
514
- }
515
-
516
- const sessionMeta = sidecar.sessionMeta || {};
517
- const telemetry = sidecar.telemetry || {};
518
- const sensors = sidecar.sensors || {};
519
- const fileState = sidecar.fileState || {};
520
-
521
- if (rawPrompt.includes('!lock')) {
522
- sessionMeta.effortLocked = true;
523
- sidecar.sessionMeta = sessionMeta;
524
- try {
525
- writeSidecarAtomicSync(conversationId, sidecar);
526
- } catch (err) {
527
- recordHookDiagnostic('pre_invocation', 'effortLock.writeSidecar', err);
528
- }
529
- return {};
530
- }
531
-
532
- if (rawPrompt.startsWith('! ') || rawPrompt === '!' || rawPrompt.startsWith('!force')) {
533
- return {};
534
- }
535
-
536
- const hasCheckTag = /#check\b/i.test(rawPrompt);
537
- const turnCount = sessionMeta.turnCount || 0;
538
- const purity = telemetry.signalPurityPct ?? 100.0;
539
- const tokens = telemetry.totalInputTokens || 0;
540
- const activeEffort = inputData.effort || sessionMeta.activeEffort || 'high';
541
- const activeModel = inputData.modelName || sessionMeta.activeModel || (config.recommended_models?.fast || 'gemini-3.8-flash');
542
- const quotaFrac = telemetry.quota?.remaining_fraction ?? 1.0;
543
- const ceiling = resolveModelCeiling(activeModel, null, { config }) || 256000;
544
- const ceilingK = Math.round(ceiling / 1000);
545
-
546
- // In AUTO_PILOT mode, enforce active guard halts even if legacy hook_level was 'advisory'
547
- const hookLevel = flightMode === 'AUTO_PILOT' ? 'guard' : (config.hook_level || 'guard');
548
- const cooldownTurns = config.halt_cooldown_turns ?? 3;
549
- const lastHalts = { ...(sessionMeta.lastHalts || {}) };
550
- const isTelemetryReliable = telemetry.confidence !== 'LOW';
551
-
552
- function haltOrAdvise(stateKey, card, { exemptFromCooldown = false } = {}) {
553
- const lastFiredTurn = lastHalts[stateKey];
554
- const isWithinCooldown = typeof lastFiredTurn === 'number' && ((turnCount - lastFiredTurn) <= cooldownTurns);
555
-
556
- if (hookLevel === 'advisory' || (isWithinCooldown && !exemptFromCooldown)) {
557
- return { systemMessage: card };
558
- }
559
-
560
- lastHalts[stateKey] = turnCount;
561
- sessionMeta.lastHalts = lastHalts;
562
- sidecar.sessionMeta = sessionMeta;
563
- try {
564
- writeSidecarAtomicSync(conversationId, sidecar);
565
- } catch (err) {
566
- recordHookDiagnostic('pre_invocation', 'haltOrAdvise.writeSidecar', err);
567
- }
568
- return { terminationBehavior: 'terminate', userMessage: card };
569
- }
570
-
571
- function applyHabitOverride(slug, stateKey, card, { detectorId = null, defaultMode = 'haltOrAdvise', extraWarn = {}, extraBlock = {} } = {}) {
572
- const override = resolveDetectorOverride(horizonConfig, slug);
573
- if (override === 'off') return null;
574
- if (override === 'warn') {
575
- return { systemMessage: card, ...(detectorId ? { detectorId } : {}), ...extraWarn };
576
- }
577
- if (override === 'block') {
578
- lastHalts[stateKey] = turnCount;
579
- sessionMeta.lastHalts = lastHalts;
580
- sidecar.sessionMeta = sessionMeta;
581
- try {
582
- writeSidecarAtomicSync(conversationId, sidecar);
583
- } catch (err) {
584
- recordHookDiagnostic('pre_invocation', 'applyHabitOverride.writeSidecar', err);
585
- }
586
- return {
587
- terminationBehavior: 'terminate',
588
- decision: 'block',
589
- ...(detectorId ? { detectorId } : {}),
590
- userMessage: card,
591
- ...extraBlock
592
- };
593
- }
594
- if (defaultMode === 'flightMode') {
595
- if (flightMode === 'AUTO_PILOT') {
596
- return {
597
- terminationBehavior: 'terminate',
598
- decision: 'block',
599
- ...(detectorId ? { detectorId } : {}),
600
- userMessage: card,
601
- ...extraBlock
602
- };
603
- }
604
- return { systemMessage: card, ...(detectorId ? { detectorId } : {}), ...extraWarn };
605
- }
606
- return haltOrAdvise(stateKey, card);
607
- }
608
-
609
- // 2. ALLOW_PLAN_OR_SUBAGENT
610
- if (!hasCheckTag && (sessionMeta.inPlanMode || sessionMeta.lastTurnUsedSubagent)) {
611
- if (!telemetry.amputationRisk && !sensors.threeStrikeLoop) {
612
- return {};
613
- }
614
- }
615
-
616
- // 3. HALT_HYGIENE_OR_SAFETY
617
- const isHighOrMaxEffort = activeEffort === 'high' || activeEffort === 'max';
618
- if (telemetry.amputationRisk && isTelemetryReliable) {
619
- const handoff = sidecar.handoff || {};
620
- const handoffAction = handoff.result === 'NEEDS_FIXES'
621
- ? `Handoff NEEDS FIXES: ${(handoff.failingChecks || []).slice(0, 2).join('; ') || 'update task.md'}`
622
- : `/clear or /compact`;
623
- const rewriteCmd = handoff.result === 'NEEDS_FIXES'
624
- ? `"Update task.md checkpoint (/handoff), then type /compact or /clear"`
625
- : `"Save progress to task.md and start a clean session with /clear (or /compact)"`;
626
-
627
- const card = formatScorecard(
628
- `[Amputation Crisis] Tokens: ${Math.round(tokens / 1000)}k/${ceilingK}k (Context Truncation Risk)`,
629
- `[Useful Context: ${purity}% | Oldest Rules at Risk]`,
630
- handoffAction,
631
- rewriteCmd
632
- );
633
- return haltOrAdvise('AMPUTATION_CRISIS', card, { exemptFromCooldown: true });
634
- }
635
-
636
- if (sensors.threeStrikeLoop) {
637
- const loopInfo = sensors.loopFingerprint
638
- ? `Loop: ${sensors.loopFingerprint.slice(0, 48)}`
639
- : 'Consecutive command failures detected';
640
- const card = formatScorecard(
641
- `[3-Strike Error Loop] ${loopInfo}`,
642
- `[Useful Context: ${purity}% | Errors: 3 strikes]`,
643
- `Break loop: isolate with subagent or compact`,
644
- `"Diagnose previous errors using invoke_subagent or run /compact"`
645
- );
646
- return haltOrAdvise('THREE_STRIKE_LOOP', card);
647
- }
648
-
649
- if (fileState.foreignBleedKiIds && fileState.foreignBleedKiIds.length > 0 && sessionMeta.inPlanMode) {
650
- const card = formatScorecard(
651
- `[Foreign KI Bleed] Injected memory from other workspace`,
652
- `[Bleed IDs: ${fileState.foreignBleedKiIds.join(', ')}]`,
653
- `/context`,
654
- `"Eject foreign knowledge items in /context before planning"`
655
- );
656
- return haltOrAdvise('FOREIGN_BLEED', card);
657
- }
658
-
659
- if (isTelemetryReliable && purity < (config.compact_halt_purity_pct || 45.0) && isHighOrMaxEffort) {
660
- const card = formatScorecard(
661
- `[Low Useful Context] ${purity}% useful context on ${activeEffort} effort`,
662
- `[Wasted Context: +$${(telemetry.sludgeTaxUsdPerTurn || 0).toFixed(2)}/turn]`,
663
- `/compact`,
664
- `"Run /compact to compress stale reads before high-effort execution"`
665
- );
666
- return haltOrAdvise('LOW_PURITY', card);
667
- }
668
-
669
- if (sensors.uncheckpointedGitDrift) {
670
- const card = formatScorecard(
671
- `[Uncheckpointed Drift] ${sensors.dirtyGitFileCount || 4}+ dirty files untested`,
672
- `[Git Drift: >=3 turns without passing test]`,
673
- `git commit or run test`,
674
- `"Run unit tests and commit working changes before editing further"`
675
- );
676
- return haltOrAdvise('GIT_DRIFT', card);
677
- }
678
-
679
- // 4. HALT_EFFORT_OR_QUOTA
680
- const fastModel = config.recommended_models?.fast || 'gemini-3.8-flash';
681
- const deepModel = config.recommended_models?.deep || 'gemini-3.1-pro';
682
-
683
- if (isTelemetryReliable && sensors.quotaFloorBreached && (activeModel.includes('pro') || activeModel.includes('argon') || activeModel.includes('carbon') || activeEffort === 'max')) {
684
- const card = formatScorecard(
685
- `[Quota Floor Breached] 5h Quota: ${Math.round(quotaFrac * 100)}% (<10%)`,
686
- `[Tokens: ${Math.round(tokens / 1000)}k | Risk: 0% lockout]`,
687
- `/model ${fastModel} • /effort low`,
688
- `"Switch to ${fastModel} on low effort to preserve remaining quota"`
689
- );
690
- return haltOrAdvise('QUOTA_FLOOR', card);
691
- }
692
-
693
- const promptTokenEst = Math.max(1, Math.ceil(rawPrompt.length / 4));
694
- const isColdCache = tokens < 10000;
695
- const isTrivial = promptTokenEst < 15;
696
- if (isTelemetryReliable && !sessionMeta.effortLocked && isTrivial && (sessionMeta.consecutiveTrivialOnMax >= 2 || (isColdCache && (activeModel.includes('pro') || activeModel.includes('argon') || activeModel.includes('carbon')) && activeEffort === 'max'))) {
697
- const card = formatScorecard(
698
- `[Effort Overkill] Trivial edit (${promptTokenEst} tokens) on max effort`,
699
- `[Cold cache / trivial turn]`,
700
- `/model ${fastModel} • /effort low`,
701
- `"Run trivial single-file edit on ${fastModel} / low effort"`
702
- );
703
- const effortRes = applyHabitOverride('effort-overkill', 'EFFORT_OVERKILL', card);
704
- if (effortRes) return effortRes;
705
- }
706
-
707
- // 4b. Local Formatter / Import Sorter Bypass (DET-15 / 'formatter-bypass')
708
- const isFormattingIntent = /\b(fix\s+(?:the\s+)?indentation|sort\s+(?:the\s+)?imports|format\s+this\s+(?:code|file|block)|convert\s+tabs\s+to\s+spaces|run\s+prettier)\b/i.test(rawPrompt);
709
- const pastedLineCount = (rawPrompt.match(/\r?\n/g) || []).length;
710
- if (isFormattingIntent && pastedLineCount >= 40 && !/\b(add|implement|refactor|create|fix\s+bug|logic|test|calculate)\b/i.test(rawPrompt)) {
711
- const bypassNotice = '[DET-15 Local Formatter Bypass] Prompt requests code formatting / import sorting on a pasted code block. Run `npx prettier --write <file>` or `npx eslint --fix <file>` directly (0 LLM tokens).';
712
- const fmtRes = applyHabitOverride('formatter-bypass', 'LOCAL_FORMATTER_BYPASS', bypassNotice, {
713
- detectorId: 'DET-15',
714
- defaultMode: 'flightMode'
715
- });
716
- if (fmtRes) return fmtRes;
717
- }
718
-
719
- // 5. INJECT_CONTEXT_GUARD
720
- const guards = [];
721
- const eventTimestampUtc = inputData.eventTimestampUtc ?? null;
722
- if (isModelDeprecated(activeModel, eventTimestampUtc)) {
723
- const notice = getDeprecatedModelMigrationNotice(activeModel, eventTimestampUtc);
724
- if (notice) guards.push(notice);
725
- }
726
- const recentTurns = inputData.recentTurns || sidecar.recentTurns || [];
727
- if (Array.isArray(recentTurns) && recentTurns.length >= 2) {
728
- const verbosityGuard = evaluateCarbonVerbosityGuardrail(recentTurns, {
729
- modelId: activeModel,
730
- activeEffort,
731
- eventTimestampUtc
732
- });
733
- if (verbosityGuard.triggered && verbosityGuard.prescription) {
734
- guards.push(verbosityGuard.prescription);
735
- }
736
- }
737
- if (!isTelemetryReliable) {
738
- guards.push('Telemetry confidence DEGRADED (parser schema drift detected) — running fail-open');
739
- }
740
- if (fileState.dirtySnapshotPaths && fileState.dirtySnapshotPaths.length > 0) {
741
- guards.push(`Dirty Snapshots modified externally: ${fileState.dirtySnapshotPaths.slice(0, 2).join(', ')} — re-read with view_file before editing`);
742
- }
743
- if (fileState.unseenCallers && fileState.unseenCallers.length > 0) {
744
- guards.push(`Unseen Callers importing target: ${fileState.unseenCallers.slice(0, 2).join(', ')} — verify signature compatibility`);
745
- }
746
- if (fileState.legacyPoisonPaths && fileState.legacyPoisonPaths.length > 0) {
747
- guards.push(`Legacy Poison paths in context: ${fileState.legacyPoisonPaths.slice(0, 2).join(', ')} — avoid copying deprecated patterns`);
748
- }
749
- if (fileState.streamCutoffRiskFiles && fileState.streamCutoffRiskFiles.length > 0) {
750
- guards.push(`Stream Cutoff Risk (>600 lines): ${fileState.streamCutoffRiskFiles.slice(0, 2).join(', ')} — use surgical edit chunks under 300 lines`);
751
- }
752
-
753
- if (guards.length > 0) {
754
- return {
755
- systemMessage: `[Flight Check Context Guard] Active hazards: ${guards.join('; ')}`
756
- };
757
- }
758
-
759
- // 6. STEER_SUBAGENT
760
- const isComplexTopic = /(concurrency|deadlock|race condition|architecture refactor|multi-module)/i.test(rawPrompt);
761
- if (tokens >= (config.subagent_min_cache_tokens || 25000) &&
762
- purity >= (config.subagent_min_purity_pct || 70.0) &&
763
- (activeEffort === 'low' || activeEffort === 'medium') &&
764
- isComplexTopic) {
765
- return {
766
- systemMessage: `[Flight Check KV-Cache Guard] Warm context detected (${Math.round(tokens / 1000)}k tokens, ${purity}% Purity). Do not switch session model (preserves warm KV cache). Delegate this analysis via invoke_subagent with pro/max depth.`
767
- };
768
- }
769
-
770
- // 7. ALLOW_ACTIVE_SET & Trust Decay
771
- const matchedScope = (fileState.activeSetPaths || fileState.modifiedFiles || []).find(p => {
772
- const base = path.basename(p);
773
- return rawPrompt.includes(base) || rawPrompt.includes(p);
774
- }) || '';
775
- const hasActiveSetMatch = Boolean(matchedScope);
776
-
777
- // Conversational Drip-Feeding check (DET-02B):
778
- // Even if prompt mentions activeSetPaths, 4+ rapid micro-prompts (<= 18 words) targeting the same file within 90s trigger advisory
779
- const timestampMs = Number(inputData.timestampMs ?? inputData.nowMs ?? inputData.timestamp ?? Date.now());
780
- const wordCount = rawPrompt.split(/\s+/).filter(Boolean).length;
781
- sessionMeta.recentPrompts = Array.isArray(sessionMeta.recentPrompts) ? sessionMeta.recentPrompts : [];
782
- sessionMeta.recentPrompts = sessionMeta.recentPrompts.filter(e => (timestampMs - e.ts) <= 90000);
783
- sessionMeta.recentPrompts.push({ ts: timestampMs, wordCount, targetScope: matchedScope });
784
- sidecar.sessionMeta = sessionMeta;
785
- try {
786
- writeSidecarAtomicSync(conversationId, sidecar);
787
- } catch (err) {
788
- recordHookDiagnostic('pre_invocation', 'recentPrompts.writeSidecar', err);
789
- }
790
-
791
- const rapidSameScopeCount = sessionMeta.recentPrompts.filter(
792
- e => e.targetScope && e.targetScope === matchedScope && e.wordCount <= 18
793
- ).length;
794
-
795
- if (rapidSameScopeCount >= 4) {
796
- const dripCard = `[DET-02B Conversational Drip-Feed Advisory] Detected ${rapidSameScopeCount} rapid single-sentence prompts on ${matchedScope || 'target file'} in <90s. Batch requirements into a single checklist turn to save prefix cache and 4x turn overhead.`;
797
- const dripRes = applyHabitOverride('drip-feed', 'CONVERSATIONAL_DRIP_FEED', dripCard, {
798
- detectorId: 'DET-02B',
799
- defaultMode: 'flightMode',
800
- extraWarn: { continue: true },
801
- extraBlock: { continue: false }
802
- });
803
- if (dripRes) return dripRes;
804
- }
805
-
806
- if (!hasCheckTag) {
807
- if (hasActiveSetMatch) return {};
808
- if (config.hook_level === 'guard' && turnCount > (config.trust_decay_turn_threshold || 10)) {
809
- return {};
810
- }
811
- }
812
-
813
- // 8a. Prompt Hygiene Governor (v4.1 Phase 1): Relay Breaker ('relay-breaker') & Scope Brake ('vague-prompt-rubric')
814
- const relayOverride = resolveDetectorOverride(horizonConfig, 'relay-breaker');
815
- const relayEval = evaluateRelayBreaker({
816
- prompt: rawPrompt,
817
- relayState: inputData.relayState ?? sessionMeta.relayState,
818
- sourceCodeEditsInSession: Number(inputData.sourceCodeEditsInSession ?? (fileState.modifiedFiles || []).filter(p => !/\.md$/i.test(String(p || ''))).length),
819
- sourceCodeEditedSinceLastRelay: Boolean(inputData.sourceCodeEditedSinceLastRelay),
820
- priorTurnWebSearches: Number(inputData.priorTurnWebSearches ?? sessionMeta.priorTurnWebSearches ?? 0),
821
- zeroEditSessionTokens: Number(inputData.zeroEditSessionTokens ?? (((fileState.modifiedFiles || []).length === 0) ? tokens : 0)),
822
- boundSpecPath: inputData.boundSpecPath ?? sessionMeta.relayState?.boundSpecPath ?? null,
823
- overrideMode: relayOverride,
824
- flightMode,
825
- detectorId: 'DET-26'
826
- });
827
- sessionMeta.relayState = relayEval.relayStateSnapshot;
828
- if (relayEval.triggered) {
829
- sidecar.sessionMeta = sessionMeta;
830
- try {
831
- writeSidecarAtomicSync(conversationId, sidecar);
832
- } catch (err) {
833
- recordHookDiagnostic('pre_invocation', 'relayBreaker.writeSidecar', err);
834
- }
835
- if (relayEval.decision === 'block') {
836
- sessionMeta.blockedPrompts = Number(sessionMeta.blockedPrompts || 0) + 1;
837
- return {
838
- terminationBehavior: 'terminate',
839
- decision: 'block',
840
- detectorId: 'DET-26',
841
- subType: relayEval.subType,
842
- relayState: relayEval.nextState,
843
- userMessage: relayEval.tailInjection
844
- };
845
- }
846
- sessionMeta.steeredPrompts = Number(sessionMeta.steeredPrompts || 0) + 1;
847
- return {
848
- ephemeralMessage: relayEval.tailInjection,
849
- systemMessage: relayEval.tailInjection,
850
- detectorId: 'DET-26',
851
- subType: relayEval.subType,
852
- relayState: relayEval.nextState
853
- };
854
- }
855
-
856
- const scopeOverride = resolveDetectorOverride(horizonConfig, 'vague-prompt-rubric');
857
- const scopeEval = evaluateScopeBrake({
858
- prompt: rawPrompt,
859
- provenance: inputData.provenance || inputData.source || 'user',
860
- isAutonomousTurn: Boolean(inputData.isAutonomousTurn || inputData.autonomous),
861
- isSubagent: Boolean(inputData.isSubagent || sessionMeta.isSubagent),
862
- isScheduledTask: Boolean(inputData.isScheduledTask),
863
- isLoopIteration: Boolean(inputData.isLoopIteration),
864
- priorTurnEditedFilesCount: Number(
865
- inputData.priorTurnEditedFilesCount ??
866
- (Array.isArray(sessionMeta.lastTurnEditedFiles) ? sessionMeta.lastTurnEditedFiles.length : 0)
867
- ),
868
- priorTurnSingleFileTarget: inputData.priorTurnSingleFileTarget ?? sessionMeta.priorTurnSingleFileTarget ?? null,
869
- priorTurnHadToolOrTestFailure: Boolean(
870
- inputData.priorTurnHadToolOrTestFailure ??
871
- sensors.lastTurnToolFailed ??
872
- sensors.threeStrikeLoop
873
- ),
874
- priorTurnAssistantAskedQuestion: Boolean(
875
- inputData.priorTurnAssistantAskedQuestion ?? sessionMeta.lastTurnAskedQuestion
876
- ),
877
- activeSetPaths: fileState.activeSetPaths || [],
878
- modifiedFiles: fileState.modifiedFiles || [],
879
- recentlyViewedFiles: fileState.recentlyViewedFiles || [],
880
- overrideMode: scopeOverride,
881
- flightMode,
882
- detectorId: 'DET-26'
883
- });
884
- if (scopeEval.triggered) {
885
- sessionMeta.unanchoredTurnFlag = true;
886
- sidecar.sessionMeta = sessionMeta;
887
- try {
888
- writeSidecarAtomicSync(conversationId, sidecar);
889
- } catch (err) {
890
- recordHookDiagnostic('pre_invocation', 'scopeBrake.writeSidecar', err);
891
- }
892
- if (scopeEval.decision === 'block') {
893
- sessionMeta.blockedPrompts = Number(sessionMeta.blockedPrompts || 0) + 1;
894
- return {
895
- terminationBehavior: 'terminate',
896
- decision: 'block',
897
- detectorId: 'DET-26',
898
- subType: scopeEval.subType,
899
- userMessage: scopeEval.blockReason
900
- };
901
- }
902
- sessionMeta.steeredPrompts = Number(sessionMeta.steeredPrompts || 0) + 1;
903
- return {
904
- ephemeralMessage: scopeEval.steerContext,
905
- systemMessage: scopeEval.steerContext,
906
- detectorId: 'DET-26',
907
- subType: scopeEval.subType,
908
- candidateFiles: scopeEval.candidateFiles
909
- };
910
- }
911
- sessionMeta.unanchoredTurnFlag = false;
912
-
913
- // 8b. HALT_REWRITE_SCORECARD (Explicit #check or Cold Session Vague Multi-File Prompt)
914
- const isColdSession = turnCount <= (config.cold_session_max_turns || 3);
915
- const promptSufficiency = scorePromptSufficiency(rawPrompt, { activeSetPaths: fileState.activeSetPaths });
916
- const isArchitecturalVague = promptSufficiency.score <= 4 &&
917
- /\b(refactor|rewrite|rearchitect|migrate|overhaul|redesign)\s+(?:the\s+)?[a-z0-9_-]+\s+(?:pipeline|system|architecture|service|subsystem|layer|workflow|engine)\b/i.test(rawPrompt);
918
- const isVagueMultiFile = (/(refactor everything|fix all|update the whole project|caching)/i.test(rawPrompt) || isArchitecturalVague) && !rawPrompt.includes('@');
919
-
920
- // Ground rule: "Short prompts are not bad by default" - concise scoped instructions shouldn't trigger vague halt
921
- if (hasCheckTag || (isColdSession && isVagueMultiFile && (!promptSufficiency.shortPrompt || isArchitecturalVague))) {
922
- const cleanedPrompt = rawPrompt.replace(/#check\b/gi, '').trim();
923
- const recommendedModel = tokens > 50000 ? deepModel : fastModel;
924
- const recommendedEffort = isComplexTopic ? 'high' : 'medium';
925
- const rawTargetHint = (fileState.activeSetPaths && fileState.activeSetPaths[0]) || '';
926
- const targetHint = (rawTargetHint ? toWorkspaceRelativePath(rawTargetHint, sidecar.workspacePath || process.cwd()) : '') || '<target-file>';
927
- const missingSnippet = promptSufficiency.missing.length > 0 ? ` | Missing: ${promptSufficiency.missing[0]}` : '';
928
-
929
- const rewriteSuggestion = promptSufficiency.missing.includes('testability & expected outcome')
930
- ? `"In @${targetHint}, ${cleanedPrompt || 'implement updates'} and run automated tests to verify"`
931
- : `"In @${targetHint}, ${cleanedPrompt || 'implement surgical updates with unit test'}"`;
932
-
933
- const card = formatScorecard(
934
- `[Sufficiency ${promptSufficiency.score}/12 ${promptSufficiency.band}]${missingSnippet}`,
935
- `[Purity: ${purity}% | Sludge: +$${(telemetry.sludgeTaxUsdPerTurn || 0).toFixed(2)}/t | Tokens: ${Math.round(tokens / 1000)}k]`,
936
- `/model ${recommendedModel} • /effort ${recommendedEffort}`,
937
- rewriteSuggestion
938
- );
939
- const vagueRes = applyHabitOverride('vague-prompt-rubric', 'REWRITE_SCORECARD', card);
940
- if (vagueRes) return vagueRes;
941
- }
942
-
943
- return {};
60
+ const { handlePreInvocation: impl } = await import('./pre_invocation_core.mjs');
61
+ return impl(inputData);
944
62
  }
945
63
 
946
64
  /**
@@ -952,12 +70,18 @@ export function toProtoSafePreHookOutput(output, { isPreToolUse = false } = {})
952
70
  if (isPreToolUse) {
953
71
  const rawDecision = String(out.decision || '').toLowerCase();
954
72
  let decision = 'allow';
955
- if (rawDecision === 'deny' || rawDecision === 'block' || out.blocked === true || out.terminationBehavior === 'terminate') {
73
+ if (
74
+ rawDecision === 'deny' ||
75
+ rawDecision === 'block' ||
76
+ out.blocked === true ||
77
+ out.terminationBehavior === 'terminate'
78
+ ) {
956
79
  decision = 'deny';
957
80
  } else if (rawDecision === 'ask') {
958
81
  decision = 'ask';
959
82
  }
960
- const reasonText = out.reason || out.errorMessage?.userMessage || out.userMessage || out.systemMessage || out.ephemeralMessage;
83
+ const reasonText =
84
+ out.reason || out.errorMessage?.userMessage || out.userMessage || out.systemMessage || out.ephemeralMessage;
961
85
  if (decision !== 'allow' && reasonText) {
962
86
  return { decision, reason: String(reasonText) };
963
87
  }
@@ -967,10 +91,10 @@ export function toProtoSafePreHookOutput(output, { isPreToolUse = false } = {})
967
91
  if (out.terminationBehavior === 'terminate') {
968
92
  const userMessage = String(
969
93
  out.errorMessage?.userMessage ||
970
- out.userMessage ||
971
- out.reason ||
972
- out.systemMessage ||
973
- 'Halted by Highbeam Flightcheck'
94
+ out.userMessage ||
95
+ out.reason ||
96
+ out.systemMessage ||
97
+ 'Halted by Highbeam Flightcheck'
974
98
  );
975
99
  return {
976
100
  terminationBehavior: 'terminate',
@@ -984,32 +108,53 @@ export function toProtoSafePreHookOutput(output, { isPreToolUse = false } = {})
984
108
  return {};
985
109
  }
986
110
 
987
- // Auto-run when executed directly by Antigravity Hook Harness
988
- const isMain = process.argv[1] && (process.argv[1].endsWith('pre_invocation.mjs') || process.argv[1].endsWith('pre_invocation.js'));
111
+ const isMain =
112
+ process.argv[1] &&
113
+ (process.argv[1].endsWith('pre_invocation.mjs') || process.argv[1].endsWith('pre_invocation.js'));
989
114
  const isPreToolUseCli = process.argv.includes('--event=PreToolUse');
115
+
990
116
  if (isMain) {
991
117
  let detectedPreToolUse = isPreToolUseCli;
992
- readStdinSafe().then(input => {
993
- const safeInput = input && typeof input === 'object' ? input : {};
994
- if (isPreToolUseCli && !safeInput.hook_event_name) {
995
- safeInput.hook_event_name = 'PreToolUse';
996
- }
997
- if (
998
- safeInput.hook_event_name === 'PreToolUse' ||
999
- safeInput.event === 'PreToolUse' ||
1000
- safeInput.tool_name ||
1001
- safeInput.toolName
1002
- ) {
1003
- detectedPreToolUse = true;
1004
- }
1005
- return handlePreInvocation(safeInput);
1006
- }).then(output => {
1007
- const safeOut = toProtoSafePreHookOutput(output, { isPreToolUse: detectedPreToolUse });
1008
- console.log(JSON.stringify(safeOut));
1009
- process.exit(0);
1010
- }).catch((err) => {
1011
- recordHookDiagnostic('pre_invocation', 'main', err);
1012
- console.log(JSON.stringify(detectedPreToolUse ? { decision: 'allow' } : {}));
1013
- process.exit(0);
1014
- });
118
+ readStdinFast({ maxTimeoutMs: 250, settleMs: 2 })
119
+ .then(async (input) => {
120
+ const safeInput = input && typeof input === 'object' ? input : {};
121
+ if (isPreToolUseCli && !safeInput.hook_event_name) {
122
+ safeInput.hook_event_name = 'PreToolUse';
123
+ }
124
+ if (
125
+ safeInput.hook_event_name === 'PreToolUse' ||
126
+ safeInput.event === 'PreToolUse' ||
127
+ safeInput.tool_name ||
128
+ safeInput.toolName
129
+ ) {
130
+ detectedPreToolUse = true;
131
+ }
132
+
133
+ const ipcRes = await tryFastDaemonRpc('hook.antigravity.preInvocation', {
134
+ input: safeInput,
135
+ isPreToolUse: detectedPreToolUse
136
+ });
137
+ if (ipcRes && ipcRes.fullVerdict === true && ipcRes.safeOut) {
138
+ return { _fastSafeOut: ipcRes.safeOut };
139
+ }
140
+
141
+ if (detectedPreToolUse && canFastAllowBoundedRead(safeInput, { platform: 'antigravity' })) {
142
+ return { _fastSafeOut: { decision: 'allow' } };
143
+ }
144
+
145
+ const { handlePreInvocation: runCore } = await import('./pre_invocation_core.mjs');
146
+ return runCore(safeInput);
147
+ })
148
+ .then((output) => {
149
+ const safeOut =
150
+ output && output._fastSafeOut
151
+ ? output._fastSafeOut
152
+ : toProtoSafePreHookOutput(output, { isPreToolUse: detectedPreToolUse });
153
+ console.log(JSON.stringify(safeOut));
154
+ process.exit(0);
155
+ })
156
+ .catch(() => {
157
+ console.log(JSON.stringify(detectedPreToolUse ? { decision: 'allow' } : {}));
158
+ process.exit(0);
159
+ });
1015
160
  }