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,1830 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { createRequire } from 'node:module';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { readSidecarSync, writeSidecarAtomicSync, getSidecarPath } from '../core/sidecar_store.mjs';
6
+ import { canonicalizePath } from '../core/path_canonicalizer.mjs';
7
+ import { scorePromptSufficiency, toWorkspaceRelativePath } from '../core/prompt_rubric.mjs';
8
+ import { loadFlightcheckConfig } from '../core/config.mjs';
9
+ import {
10
+ resolveModelCeiling,
11
+ resolveModelRates,
12
+ normalizeModelKey,
13
+ isModelDeprecated,
14
+ getDeprecatedModelMigrationNotice,
15
+ evaluateCarbonVerbosityGuardrail
16
+ } from '../core/constants.mjs';
17
+ import {
18
+ SwarmIdleTtlTracker,
19
+ evaluateSwarmColdCacheWakeup,
20
+ computeSwarmRosterTtlBadges
21
+ } from '../core/subagents.mjs';
22
+ import {
23
+ classifyTaskComplexity,
24
+ CacheGravityScorer,
25
+ TaskMdDirectiveWatcher,
26
+ ModelSelectorActuator,
27
+ evaluateTaskAndQuotaRoute
28
+ } from '../core/task_quota_router.mjs';
29
+ import { loadHorizonConfig, resolveDetectorOverride } from '../core/horizon_config.mjs';
30
+ import { loadRegistry } from '../core/telemetry/scope_lock_registry.mjs';
31
+ import { recordHookDiagnostic } from '../core/hook_diagnostics.mjs';
32
+ import {
33
+ evaluateScopeBrake,
34
+ evaluateRelayBreaker,
35
+ evaluateTwoStageSightseeingIntercept,
36
+ evaluateShardedSpecDrift,
37
+ evaluateTurn1ContractGate
38
+ } from '../core/shared/prompt_hygiene_governor.mjs';
39
+ import {
40
+ runBucketBPreToolShadowPass,
41
+ runBucketBPromptPass
42
+ } from '../core/bucket_b_runtime.mjs';
43
+ import { evaluateParameterizedCliffBreaker } from '../core-isomorphic/economics/cliffBreaker.mjs';
44
+ import { evaluateActiveDet30StepDown } from '../core-isomorphic/economics/driftLatency.mjs';
45
+ import { evaluateDet05DiffThrashing } from '../core-isomorphic/guards/det04_12_thrash_rot.mjs';
46
+ import { hasExplicitTestModifyIntent } from '../core-isomorphic/guards/det01_03_shell_secret.mjs';
47
+ import { evaluateDet04ConsecutiveFailureBreaker } from '../core/shared/detectors.mjs';
48
+
49
+ const requireFromHere = createRequire(import.meta.url);
50
+ const AUTO_MODE_ALIAS_RE = /^(?:AUTO_PILOT|AUTOPILOT|AUTO|AUTO-PILOT)$/i;
51
+
52
+ let _proMod = null;
53
+ function getProMod() {
54
+ if (!_proMod) _proMod = requireFromHere('../core/pro_license.mjs');
55
+ return _proMod;
56
+ }
57
+
58
+ let _shadowAutoMod = null;
59
+ function getShadowAutoMod() {
60
+ if (!_shadowAutoMod) _shadowAutoMod = requireFromHere('../core/shadow_auto_ledger.mjs');
61
+ return _shadowAutoMod;
62
+ }
63
+
64
+ let _detectorsMod = null;
65
+ function getDetectorsMod() {
66
+ if (!_detectorsMod) _detectorsMod = requireFromHere('../core/detectors_det01_to_16.mjs');
67
+ return _detectorsMod;
68
+ }
69
+
70
+ let _codeFoldMod = null;
71
+ function getCodeFoldMod() {
72
+ if (!_codeFoldMod) _codeFoldMod = requireFromHere('../core/code_fold_lite.mjs');
73
+ return _codeFoldMod;
74
+ }
75
+
76
+ let _shieldMod = null;
77
+ function getShieldMod() {
78
+ if (!_shieldMod) _shieldMod = requireFromHere('../core/shield_manager.mjs');
79
+ return _shieldMod;
80
+ }
81
+
82
+ function resolveSimpleAgMode(rawMode = 'COACH') {
83
+ const upper = String(rawMode || 'COACH').trim().toUpperCase();
84
+ if (upper === 'OFF' || upper === 'DISABLED') return 'OFF';
85
+ if (upper === 'SILENT') return 'SILENT';
86
+ return 'COACH';
87
+ }
88
+
89
+ const KNOWN_ANTIGRAVITY_TOOL_NAMES = new Set([
90
+ 'read_file',
91
+ 'view_file',
92
+ 'view_file_outline',
93
+ 'view_code_item',
94
+ 'write_file',
95
+ 'write_to_file',
96
+ 'edit_file',
97
+ 'replace_file_content',
98
+ 'multi_replace_file_content',
99
+ 'run_command',
100
+ 'grep_search',
101
+ 'find_by_name',
102
+ 'list_dir',
103
+ 'search_web',
104
+ 'invoke_subagent',
105
+ 'define_subagent',
106
+ 'send_message',
107
+ 'manage_subagents',
108
+ 'manage_task',
109
+ 'schedule',
110
+ 'ask_question',
111
+ 'call_mcp_tool',
112
+ 'list_resources',
113
+ 'read_resource',
114
+ 'swarm',
115
+ 'run_workflow',
116
+ 'search_marketplace',
117
+ 'list_plugin_accounts'
118
+ ]);
119
+
120
+ export {
121
+ classifyTaskComplexity,
122
+ CacheGravityScorer,
123
+ TaskMdDirectiveWatcher,
124
+ ModelSelectorActuator,
125
+ evaluateTaskAndQuotaRoute
126
+ };
127
+
128
+ async function readStdinSafe({ maxTimeoutMs = 1000, settleMs = 50 } = {}) {
129
+ if (process.stdin.isTTY || process.stdin.readableEnded) return {};
130
+ return new Promise((resolve) => {
131
+ let raw = '';
132
+ let settled = false;
133
+ let settleTimer = null;
134
+
135
+ const finish = (val) => {
136
+ if (settled) return;
137
+ settled = true;
138
+ clearTimeout(maxTimer);
139
+ if (settleTimer) clearTimeout(settleTimer);
140
+ try {
141
+ process.stdin.pause();
142
+ } catch (err) {
143
+ recordHookDiagnostic('pre_invocation', 'stdin.pause', err, { persist: false });
144
+ }
145
+ resolve(val);
146
+ };
147
+
148
+ const tryParse = () => {
149
+ try {
150
+ return raw ? JSON.parse(raw) : {};
151
+ } catch (err) {
152
+ recordHookDiagnostic('pre_invocation', 'stdin.parse', err);
153
+ return {};
154
+ }
155
+ };
156
+
157
+ const maxTimer = setTimeout(() => finish(tryParse()), maxTimeoutMs);
158
+
159
+ process.stdin.setEncoding('utf8');
160
+ process.stdin.on('data', chunk => {
161
+ raw += chunk;
162
+ if (settleTimer) clearTimeout(settleTimer);
163
+ if (raw.trim().endsWith('}')) {
164
+ settleTimer = setTimeout(() => {
165
+ try {
166
+ finish(JSON.parse(raw));
167
+ } catch (err) {
168
+ recordHookDiagnostic('pre_invocation', 'stdin.settleParse', err, { persist: false });
169
+ }
170
+ }, settleMs);
171
+ }
172
+ });
173
+ process.stdin.on('end', () => finish(tryParse()));
174
+ process.stdin.on('error', (err) => {
175
+ recordHookDiagnostic('pre_invocation', 'stdin.error', err);
176
+ finish({});
177
+ });
178
+ });
179
+ }
180
+
181
+ function formatScorecard(p1, p2, p3, p4) {
182
+ const pad = (s, len = 74) => s.length >= len ? s.slice(0, len) : s + ' '.repeat(len - s.length);
183
+ return [
184
+ '╭─ Flight Check v3.1 ──────────────────────────────────────────────────────────╮',
185
+ `│ 1. PROMPT : ${pad(p1, 62)} │`,
186
+ `│ 2. HORIZON: ${pad(p2, 62)} │`,
187
+ `│ 3. ACTION : ${pad(p3, 62)} │`,
188
+ `│ 4. REWRITE: ${pad(p4, 62)} │`,
189
+ '╰──────────────────────────────────────────────────────────────────────────────╯',
190
+ 'Bypass once: prefix with `!` • Lock model/effort: include `!lock`'
191
+ ].join('\n');
192
+ }
193
+
194
+ function recordAntigravitySidecarSavings(sidecar, { category = 'BOUNDED_READ_ENFORCED', savedTokens = 0, detail = '', nowMs = Date.now() } = {}) {
195
+ const tokens = Math.max(0, Number(savedTokens || 0));
196
+ if (!sidecar || typeof sidecar !== 'object' || tokens <= 0) return;
197
+ sidecar.telemetry = sidecar.telemetry && typeof sidecar.telemetry === 'object' ? sidecar.telemetry : {};
198
+ sidecar.telemetry.savedTokens = Number(sidecar.telemetry.savedTokens || 0) + tokens;
199
+ sidecar.telemetry.boundedReadInterventions = Number(sidecar.telemetry.boundedReadInterventions || 0) + 1;
200
+ sidecar.telemetry.savedTokensByCategory =
201
+ sidecar.telemetry.savedTokensByCategory && typeof sidecar.telemetry.savedTokensByCategory === 'object'
202
+ ? sidecar.telemetry.savedTokensByCategory
203
+ : {};
204
+ sidecar.telemetry.savedTokensByCategory[category] =
205
+ Number(sidecar.telemetry.savedTokensByCategory[category] || 0) + tokens;
206
+ const recent = Array.isArray(sidecar.telemetry.recentInterventions)
207
+ ? sidecar.telemetry.recentInterventions
208
+ : [];
209
+ recent.push({
210
+ ts: new Date(nowMs).toISOString(),
211
+ category,
212
+ savedTokens: tokens,
213
+ detail
214
+ });
215
+ sidecar.telemetry.recentInterventions = recent.slice(-25);
216
+ }
217
+
218
+ export async function handlePreToolUse(inputData = {}) {
219
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
220
+ const sidecar = readSidecarSync(conversationId);
221
+ sidecar.sessionMeta = sidecar.sessionMeta || {};
222
+ sidecar.swarmRoster = sidecar.swarmRoster || {};
223
+
224
+ // Phase 3.2: Buffer mid-turn model switches without mutating active_model_id
225
+ const requestedMidTurnModel = inputData.requestedModel || inputData.newModel || inputData.pending_model_id || null;
226
+ if (requestedMidTurnModel) {
227
+ const normalizedNext = normalizeModelKey(requestedMidTurnModel);
228
+ if (!sidecar.sessionMeta.active_model_id) {
229
+ sidecar.sessionMeta.active_model_id = normalizeModelKey(
230
+ inputData.active_model_id || inputData.modelName || sidecar.sessionMeta.activeModel || 'gemini-3.8-flash'
231
+ );
232
+ }
233
+ if (normalizedNext !== sidecar.sessionMeta.active_model_id) {
234
+ sidecar.sessionMeta.pending_model_id = normalizedNext;
235
+ }
236
+ }
237
+
238
+ const toolName = String(inputData.tool_name || inputData.tool || inputData.toolName || '').trim();
239
+ const toolInput = inputData.tool_input || inputData.toolInput || inputData.args || inputData.parameters || inputData.Arguments || inputData;
240
+ const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
241
+ const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
242
+ cwd: workspacePath,
243
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
244
+ });
245
+ const rawFlightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
246
+ const resolvedModeInfo = AUTO_MODE_ALIAS_RE.test(rawFlightMode)
247
+ ? getProMod().resolveEffectiveAutoFlightMode(rawFlightMode, {
248
+ licensePath: inputData.licensePath,
249
+ homeDir: inputData.homeDir,
250
+ strict: Boolean(inputData.strictProGate)
251
+ })
252
+ : { effectiveFlightMode: resolveSimpleAgMode(rawFlightMode) };
253
+ const flightMode = resolvedModeInfo.effectiveFlightMode;
254
+ const isSilentMode = flightMode === 'SILENT';
255
+ const isOffMode = flightMode === 'OFF';
256
+ const isAutoPilotMode = flightMode === 'AUTO_PILOT';
257
+ const shadowMissOpts = {
258
+ cwd: workspacePath,
259
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {}),
260
+ ...(inputData.shadowLedgerPath ? { shadowLedgerPath: inputData.shadowLedgerPath } : {})
261
+ };
262
+ const logAgToolShadowMiss = (detectorId, category, missedUsd, wastedTokens, detail) => {
263
+ if (isAutoPilotMode) return;
264
+ getShadowAutoMod().recordShadowAutoMiss(
265
+ {
266
+ sessionId: conversationId,
267
+ workspacePath,
268
+ harness: 'antigravity',
269
+ effectiveMode: flightMode,
270
+ category,
271
+ detectorId,
272
+ turnKey: inputData.turnKey || inputData.turn || `${detectorId}:${toolName}`,
273
+ wastedTokens,
274
+ missedUsd,
275
+ avoidedPrompts: 1,
276
+ autoSelected: rawFlightMode === 'AUTO_PILOT' || rawFlightMode === 'AUTOPILOT',
277
+ detail
278
+ },
279
+ shadowMissOpts
280
+ );
281
+ };
282
+
283
+ const syntheticStep = [{
284
+ toolCalls: [{
285
+ name: toolName,
286
+ args: toolInput && typeof toolInput === 'object' ? toolInput : {}
287
+ }]
288
+ }];
289
+
290
+ const makeBlockPayload = (detResult) => ({
291
+ decision: 'block',
292
+ permissionDecision: 'deny',
293
+ terminationBehavior: 'terminate',
294
+ blocked: true,
295
+ flightMode,
296
+ detectorId: detResult.id,
297
+ reason: detResult.message,
298
+ userMessage: detResult.message,
299
+ systemMessage: detResult.message
300
+ });
301
+
302
+ // Ring-0 Security Gates (active even in SILENT / OFF unless explicitly disabled in Antigravity namespace)
303
+ const effectivePromptText = String(
304
+ inputData.lastUserInput ??
305
+ inputData.prompt ??
306
+ inputData.user_input ??
307
+ sidecar.sessionMeta?.lastUserPrompt ??
308
+ ''
309
+ );
310
+ const userExplicitTestIntent =
311
+ Boolean(inputData.userExplicitTestIntent || inputData.userAuthorizedTestDeletion) ||
312
+ hasExplicitTestModifyIntent(effectivePromptText);
313
+ if (/^(run_command|execute_bash|bash|powershell|exec)$/i.test(toolName)) {
314
+ if (resolveDetectorOverride(horizonConfig, 'DET-19') !== 'off') {
315
+ const det19 = getDetectorsMod().evaluateDet19GitHookBypass(syntheticStep);
316
+ if (det19) return makeBlockPayload(det19);
317
+ }
318
+ if (resolveDetectorOverride(horizonConfig, 'DET-08') !== 'off') {
319
+ const det08 = getDetectorsMod().evaluateDet08DestructiveShell(syntheticStep, { userExplicitTestIntent });
320
+ if (det08) return makeBlockPayload(det08);
321
+ }
322
+ }
323
+ if (/^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content|run_command|execute_bash|bash|powershell)$/i.test(toolName)) {
324
+ if (resolveDetectorOverride(horizonConfig, 'DET-18') !== 'off') {
325
+ const det18 = getDetectorsMod().evaluateDet18UntrustedWorkspaceSettings(syntheticStep, {
326
+ workspacePath,
327
+ scanWorkspace: false
328
+ });
329
+ if (det18) return makeBlockPayload(det18);
330
+ }
331
+ }
332
+
333
+ // Non-Ring-0 Guardrails (DET-09 warm-cache rule fence, DET-20 concurrent scope lock collision, Two-Stage Prompt Hygiene)
334
+ let gateSystemMessage = null;
335
+ if (!isOffMode) {
336
+ const scopeOverride = resolveDetectorOverride(horizonConfig, 'vague-prompt-rubric');
337
+ const relayOverride = resolveDetectorOverride(horizonConfig, 'relay-breaker');
338
+ const twoStage = evaluateTwoStageSightseeingIntercept({
339
+ toolName,
340
+ toolArgs: toolInput && typeof toolInput === 'object' ? toolInput : {},
341
+ unanchoredTurnFlag: Boolean(inputData.unanchoredTurnFlag ?? sidecar.sessionMeta?.unanchoredTurnFlag),
342
+ candidateFiles: Array.isArray(inputData.candidateFiles)
343
+ ? inputData.candidateFiles
344
+ : (sidecar.fileState?.modifiedFiles || sidecar.fileState?.activeSetPaths || []),
345
+ relayState: inputData.relayState ?? sidecar.sessionMeta?.relayState,
346
+ overrideMode: scopeOverride !== 'default' ? scopeOverride : relayOverride,
347
+ flightMode,
348
+ detectorId: 'DET-26'
349
+ });
350
+ if (twoStage.intercepted) {
351
+ if (twoStage.consumeFlag && sidecar.sessionMeta) {
352
+ sidecar.sessionMeta.unanchoredTurnFlag = false;
353
+ sidecar.sessionMeta.sightseeingToolsPrevented = Number(sidecar.sessionMeta.sightseeingToolsPrevented || 0) + 1;
354
+ try {
355
+ writeSidecarAtomicSync(conversationId, sidecar);
356
+ } catch (err) {
357
+ recordHookDiagnostic('pre_invocation', 'twoStage.writeSidecar', err);
358
+ }
359
+ }
360
+ if (twoStage.decision === 'deny') {
361
+ return makeBlockPayload({ id: twoStage.detectorId, message: twoStage.reason });
362
+ }
363
+ if (!isSilentMode) gateSystemMessage = twoStage.reason;
364
+ }
365
+
366
+ // Item A0: Unify shared DET-04 3-Strike Consecutive Tool Failure Breaker in handlePreToolUse
367
+ if (resolveDetectorOverride(horizonConfig, 'DET-04') !== 'off' && sidecar.portfolio?.failureStreaks) {
368
+ const currentTurnNum = Math.max(1, Number(inputData.turn ?? sidecar.sessionMeta?.turnCount ?? 1));
369
+ const det04 = evaluateDet04ConsecutiveFailureBreaker({
370
+ toolName,
371
+ toolArgs: toolInput && typeof toolInput === 'object' ? toolInput : {},
372
+ failureStreaks: sidecar.portfolio.failureStreaks,
373
+ currentTurn: currentTurnNum,
374
+ lastAlertTurnByKey: sidecar.portfolio.lastAlertTurnByKey || {},
375
+ cooldownTurns: 3,
376
+ flightMode
377
+ });
378
+ if (det04.triggered) {
379
+ if (det04.decision === 'deny') {
380
+ return makeBlockPayload({ id: 'DET-04', message: det04.reason });
381
+ }
382
+ logAgToolShadowMiss(
383
+ 'DET-04',
384
+ 'RUNAWAY_LOOP_TURN',
385
+ 0.35,
386
+ Number(sidecar.telemetry?.totalInputTokens || 30000),
387
+ det04.reason
388
+ );
389
+ if (!isSilentMode && !gateSystemMessage && det04.reason) gateSystemMessage = det04.reason;
390
+ }
391
+ }
392
+
393
+ // Item A0: Validate define_subagent tools: array against known Antigravity tool names
394
+ if (toolName === 'define_subagent') {
395
+ const rawTools = toolInput?.tools ?? toolInput?.Tools;
396
+ if (Array.isArray(rawTools) && rawTools.length > 0) {
397
+ const invalidTools = rawTools
398
+ .map((t) => String(t || '').trim().replace(/^default_api:/, ''))
399
+ .filter((t) => t && !KNOWN_ANTIGRAVITY_TOOL_NAMES.has(t) && !t.startsWith('mcp_'));
400
+ if (invalidTools.length > 0) {
401
+ const invalidMsg = `[DET-16 Subagent Tool Validation] Unknown tool name(s) in define_subagent (${invalidTools.join(', ')}). Invalid names are silently stripped by the host; use canonical Antigravity tool names or EnableWriteTools/EnableMCPTools.`;
402
+ if (isAutoPilotMode) return makeBlockPayload({ id: 'DET-16', message: invalidMsg });
403
+ if (!isSilentMode && !gateSystemMessage) gateSystemMessage = invalidMsg;
404
+ }
405
+ }
406
+ }
407
+
408
+ // Item A0 + #10: Guard Monitor / IsDaemon shell commands lacking bounds & track active background tasks
409
+ if (toolName === 'Monitor') {
410
+ const hasTimeout = Number.isFinite(Number(toolInput?.timeout_ms ?? toolInput?.timeoutMs));
411
+ const hasFilter = Boolean(toolInput?.filter || toolInput?.pattern || toolInput?.regex);
412
+ if (!hasTimeout || !hasFilter) {
413
+ const monMsg = '[Highbeam Quota Shield — Unbounded Monitor (#10)] Monitor called without explicit timeout_ms and filter; stream bursts can flood main-thread context.';
414
+ if (isAutoPilotMode) return makeBlockPayload({ id: 'DET-07', message: monMsg });
415
+ if (!isSilentMode && !gateSystemMessage) gateSystemMessage = monMsg;
416
+ }
417
+ } else if (/^(run_command|execute_bash)$/i.test(toolName) && Boolean(toolInput?.IsDaemon)) {
418
+ sidecar.sessionMeta = sidecar.sessionMeta || {};
419
+ const bgList = Array.isArray(sidecar.sessionMeta.activeBackgroundTasks)
420
+ ? sidecar.sessionMeta.activeBackgroundTasks
421
+ : [];
422
+ const label = String(toolInput?.toolSummary || toolInput?.CommandLine || 'daemon_task').slice(0, 60);
423
+ if (!bgList.includes(label)) bgList.push(label);
424
+ sidecar.sessionMeta.activeBackgroundTasks = bgList.slice(-16);
425
+ } else if (toolName === 'manage_task' && String(toolInput?.Action || '').toLowerCase() === 'kill') {
426
+ if (Array.isArray(sidecar.sessionMeta?.activeBackgroundTasks)) {
427
+ const killedId = String(toolInput?.TaskId || '').trim();
428
+ sidecar.sessionMeta.activeBackgroundTasks = killedId
429
+ ? sidecar.sessionMeta.activeBackgroundTasks.filter((t) => t !== killedId)
430
+ : [];
431
+ }
432
+ }
433
+
434
+ // Item A3 (#7): Parameterized Pricing Cliff Breaker (Haiku 100K 5x + Gemini 3.1/2.5 Pro 200K 2x/1.5x)
435
+ const det12Mode = resolveDetectorOverride(horizonConfig, 'DET-12');
436
+ if (det12Mode !== 'off') {
437
+ const cliffEval = evaluateParameterizedCliffBreaker({
438
+ modelId:
439
+ inputData.modelName ||
440
+ sidecar.sessionMeta?.active_model_id ||
441
+ sidecar.sessionMeta?.activeModel ||
442
+ '',
443
+ totalInputTokens: Number(
444
+ inputData.totalPromptTokens ??
445
+ inputData.totalInputTokens ??
446
+ sidecar.telemetry?.totalInputTokens ??
447
+ 0
448
+ )
449
+ });
450
+ if (cliffEval.triggered) {
451
+ if (cliffEval.decision === 'deny' && (isAutoPilotMode || det12Mode === 'block')) {
452
+ return makeBlockPayload({ id: 'DET-12', message: cliffEval.reason });
453
+ }
454
+ if (!isSilentMode && !gateSystemMessage) {
455
+ gateSystemMessage = cliffEval.reason;
456
+ }
457
+ }
458
+ }
459
+ }
460
+ if (!isOffMode && /^(?:default_api:)?(?:read_file|view_file)$/i.test(toolName)) {
461
+ const hasBounds =
462
+ toolInput?.StartLine !== undefined ||
463
+ toolInput?.EndLine !== undefined ||
464
+ toolInput?.offset !== undefined ||
465
+ toolInput?.limit !== undefined;
466
+ const rawReadTarget = String(
467
+ toolInput?.Path || toolInput?.AbsolutePath || toolInput?.file_path || toolInput?.path || ''
468
+ ).trim();
469
+
470
+ // Item A8 (#14): Multimodal .ipynb Base64 Stripper & Unbounded >10-page .pdf Read Blocker
471
+ if (rawReadTarget && /\.(?:ipynb|pdf)$/i.test(rawReadTarget)) {
472
+ const mmRes = getShieldMod().inspectAndSanitizeMultimodalRead({
473
+ platform: 'antigravity',
474
+ cwd: workspacePath,
475
+ filePath: rawReadTarget,
476
+ pages: toolInput?.pages,
477
+ hasPageBounds: hasBounds || toolInput?.pages !== undefined
478
+ });
479
+ if (mmRes.action === 'deny') {
480
+ return {
481
+ decision: 'deny',
482
+ permissionDecision: 'deny',
483
+ terminationBehavior: 'terminate',
484
+ blocked: true,
485
+ flightMode,
486
+ detectorId: mmRes.detectorId,
487
+ subType: mmRes.subType,
488
+ reason: mmRes.reason,
489
+ userMessage: mmRes.reason,
490
+ systemMessage: mmRes.reason,
491
+ sanitizedPath: mmRes.sanitizedPath || null,
492
+ pageCount: mmRes.pageCount || null,
493
+ savedTokens: mmRes.savedTokens || 0
494
+ };
495
+ }
496
+ }
497
+
498
+ if (!hasBounds && rawReadTarget) {
499
+ const shieldRes = getShieldMod().evaluateShieldReadGuard({
500
+ platform: 'antigravity',
501
+ sessionId: conversationId,
502
+ cwd: workspacePath,
503
+ filePath: rawReadTarget,
504
+ hasSliceBounds: false,
505
+ currentPromptTokens: Number(
506
+ inputData.totalPromptTokens ?? sidecar.telemetry?.totalInputTokens ?? 0
507
+ ),
508
+ modelId:
509
+ inputData.modelName ||
510
+ sidecar.sessionMeta?.active_model_id ||
511
+ sidecar.sessionMeta?.activeModel ||
512
+ 'gemini-4-carbon',
513
+ shieldConfig: inputData.shieldConfig,
514
+ forceActive: Boolean(inputData.shieldForceActive),
515
+ recordLedger: inputData.recordLedger !== false
516
+ });
517
+ if (shieldRes.action === 'deny') {
518
+ return {
519
+ decision: 'deny',
520
+ permissionDecision: 'deny',
521
+ terminationBehavior: 'terminate',
522
+ blocked: true,
523
+ flightMode,
524
+ detectorId: shieldRes.detectorId,
525
+ reason: shieldRes.reason,
526
+ userMessage: shieldRes.reason,
527
+ systemMessage: shieldRes.reason,
528
+ indexPath: shieldRes.indexPath,
529
+ savedTokens: shieldRes.savedTokens,
530
+ savedUSD: shieldRes.savedUSD
531
+ };
532
+ }
533
+ }
534
+ }
535
+ if (!isOffMode && /^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content)$/i.test(toolName)) {
536
+ // Item A2 (#3) & Item A7 (#12): Test Integrity Lock + Standalone Silent Error-Masking Linter
537
+ const det03Mode = resolveDetectorOverride(horizonConfig, 'DET-03');
538
+ if (det03Mode !== 'off') {
539
+ const editTarget = String(
540
+ toolInput?.Path || toolInput?.path || toolInput?.TargetFile || toolInput?.AbsolutePath || ''
541
+ ).trim();
542
+ const chunks = Array.isArray(toolInput?.ReplacementChunks) ? toolInput.ReplacementChunks : null;
543
+ let oldTxt = String(
544
+ toolInput?.Target ??
545
+ toolInput?.TargetContent ??
546
+ toolInput?.old_string ??
547
+ (chunks ? chunks.map((c) => c?.TargetContent ?? c?.Target ?? '').join('\n') : '') ??
548
+ ''
549
+ );
550
+ if (!oldTxt && /^(write_file|write_to_file)$/i.test(toolName) && editTarget) {
551
+ try {
552
+ const absEdit = path.isAbsolute(editTarget)
553
+ ? editTarget
554
+ : path.resolve(workspacePath, editTarget);
555
+ if (fs.existsSync(absEdit) && fs.statSync(absEdit).isFile()) {
556
+ oldTxt = fs.readFileSync(absEdit, 'utf8');
557
+ }
558
+ } catch {
559
+ oldTxt = '';
560
+ }
561
+ }
562
+ const newTxt = String(
563
+ toolInput?.Replacement ??
564
+ toolInput?.ReplacementContent ??
565
+ toolInput?.Content ??
566
+ toolInput?.CodeContent ??
567
+ toolInput?.new_string ??
568
+ (chunks ? chunks.map((c) => c?.ReplacementContent ?? c?.Replacement ?? '').join('\n') : '') ??
569
+ ''
570
+ );
571
+ if (oldTxt || newTxt) {
572
+ const diffRes = evaluateDet05DiffThrashing({
573
+ filePath: editTarget,
574
+ oldText: oldTxt,
575
+ newText: newTxt,
576
+ toolName,
577
+ flightMode,
578
+ lastUserInput: effectivePromptText,
579
+ userExplicitTestIntent
580
+ });
581
+ if (diffRes.triggered && diffRes.decision === 'deny' && diffRes.subType !== 'SUDDEN_FILE_SHRINKAGE') {
582
+ if (det03Mode !== 'warn') {
583
+ return makeBlockPayload({ id: 'DET-03', message: diffRes.reason });
584
+ }
585
+ if (!isSilentMode && !gateSystemMessage) gateSystemMessage = diffRes.reason;
586
+ } else if (
587
+ diffRes.triggered &&
588
+ diffRes.subType === 'SUDDEN_FILE_SHRINKAGE' &&
589
+ /\.(?:test|spec)\.[a-z0-9]+$/i.test(editTarget) &&
590
+ !userExplicitTestIntent
591
+ ) {
592
+ if (det03Mode !== 'warn') {
593
+ return makeBlockPayload({ id: 'DET-03', message: diffRes.reason });
594
+ }
595
+ if (!isSilentMode && !gateSystemMessage) gateSystemMessage = diffRes.reason;
596
+ }
597
+ }
598
+ }
599
+
600
+ const det09Mode = resolveDetectorOverride(horizonConfig, 'DET-09');
601
+ if (det09Mode !== 'off') {
602
+ const det09 = getDetectorsMod().evaluateDet09MidSessionRuleMutate(syntheticStep, {
603
+ cachedTokens: inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? sidecar.telemetry?.totalInputTokens ?? 0,
604
+ cacheTtlSeconds: inputData.cacheTtlSeconds ?? sidecar.telemetry?.cacheTtlSeconds ?? 300,
605
+ cacheState: inputData.cacheState
606
+ });
607
+ if (det09) {
608
+ if (isAutoPilotMode || det09Mode === 'block') return makeBlockPayload(det09);
609
+ logAgToolShadowMiss(
610
+ 'DET-09',
611
+ 'PREFIX_MUTATION_BUST',
612
+ 0.25,
613
+ Number(inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? sidecar.telemetry?.totalInputTokens ?? 30000),
614
+ det09.message
615
+ );
616
+ if (!isSilentMode) gateSystemMessage = det09.message;
617
+ }
618
+ }
619
+
620
+ const det20Mode = resolveDetectorOverride(horizonConfig, 'DET-20');
621
+ if (det20Mode !== 'off') {
622
+ const rawTarget = String(
623
+ toolInput?.Path || toolInput?.path || toolInput?.TargetFile || toolInput?.AbsolutePath || ''
624
+ ).trim();
625
+ if (rawTarget) {
626
+ const relTarget = path.isAbsolute(rawTarget)
627
+ ? path.relative(workspacePath, rawTarget).replace(/\\/g, '/')
628
+ : rawTarget.replace(/\\/g, '/');
629
+ const activeLeases = Array.isArray(inputData.activeLeases)
630
+ ? inputData.activeLeases
631
+ : loadRegistry(workspacePath).leases;
632
+ const det20 = getDetectorsMod().evaluateDet20ScopeCollision([], {
633
+ currentTrajectoryId: conversationId,
634
+ claimedPaths: [relTarget],
635
+ activeLeases,
636
+ workspaceDir: workspacePath
637
+ });
638
+ if (det20) {
639
+ if (isAutoPilotMode || det20Mode === 'block') return makeBlockPayload(det20);
640
+ if (!isSilentMode && !gateSystemMessage) gateSystemMessage = det20.message;
641
+ }
642
+ }
643
+ }
644
+ }
645
+
646
+ if (!isOffMode && inputData.bucketBShadow !== false) {
647
+ try {
648
+ const hasExplicitCwd = Boolean(inputData.cwd || inputData.workspacePath);
649
+ const priorUnverifiedEdits = Array.isArray(inputData.editsSinceVerify)
650
+ ? inputData.editsSinceVerify
651
+ : Array.isArray(sidecar.fileState?.unverifiedEdits)
652
+ ? sidecar.fileState.unverifiedEdits
653
+ : [];
654
+ const shadowRes = runBucketBPreToolShadowPass({
655
+ platform: 'antigravity',
656
+ sessionId: conversationId,
657
+ cwd: workspacePath,
658
+ hasExplicitCwd,
659
+ toolName,
660
+ toolInput: toolInput && typeof toolInput === 'object' ? toolInput : {},
661
+ lastUserPrompt: effectivePromptText,
662
+ editsSinceVerify: priorUnverifiedEdits,
663
+ options: {
664
+ bucketBStage: inputData.bucketBStage,
665
+ bucketBAlphaStage: inputData.bucketBAlphaStage,
666
+ bucketBBetaStage: inputData.bucketBBetaStage,
667
+ bucketBGammaStage: inputData.bucketBGammaStage,
668
+ bucketBLspStage: inputData.bucketBLspStage,
669
+ persistState: inputData.persistState,
670
+ mode: flightMode,
671
+ registryMetadata: inputData.registryMetadata,
672
+ cliCapabilities: inputData.cliCapabilities,
673
+ lspCapabilities: inputData.lspCapabilities,
674
+ horizonConfig
675
+ }
676
+ });
677
+ if (shadowRes.triggered && shadowRes.activeRecords.length > 0) {
678
+ const blockingEntry = shadowRes.activeRecords.find(
679
+ (r) => r.stage === 'ENFORCE' || (isAutoPilotMode && r.verdict.decision === 'ask')
680
+ );
681
+ if (blockingEntry) {
682
+ return makeBlockPayload({
683
+ id: blockingEntry.verdict.code || 'BUCKET_B_GUARD',
684
+ message: blockingEntry.verdict.reason
685
+ });
686
+ }
687
+ if (!isSilentMode && !gateSystemMessage) {
688
+ gateSystemMessage = shadowRes.activeRecords
689
+ .map((r) => r.verdict.reason)
690
+ .filter(Boolean)
691
+ .join('\n');
692
+ }
693
+ }
694
+ } catch (err) {
695
+ recordHookDiagnostic('pre_invocation', 'handlePreToolUse.bucketBShadow', err, { persist: false });
696
+ }
697
+ }
698
+
699
+ if (
700
+ !isOffMode &&
701
+ /^(edit_file|write_file|write_to_file|replace_file_content|multi_replace_file_content)$/i.test(
702
+ toolName
703
+ )
704
+ ) {
705
+ const editTarget = String(
706
+ toolInput?.Path || toolInput?.path || toolInput?.TargetFile || toolInput?.AbsolutePath || ''
707
+ ).trim();
708
+ if (editTarget) {
709
+ const chunks = Array.isArray(toolInput?.ReplacementChunks) ? toolInput.ReplacementChunks : null;
710
+ const newTxt = String(
711
+ toolInput?.Replacement ??
712
+ toolInput?.ReplacementContent ??
713
+ toolInput?.Content ??
714
+ toolInput?.CodeContent ??
715
+ toolInput?.new_string ??
716
+ (chunks ? chunks.map((c) => c?.ReplacementContent ?? c?.Replacement ?? '').join('\n') : '') ??
717
+ ''
718
+ );
719
+ const oldTxt = String(
720
+ toolInput?.Target ??
721
+ toolInput?.TargetContent ??
722
+ toolInput?.old_string ??
723
+ (chunks ? chunks.map((c) => c?.TargetContent ?? c?.Target ?? '').join('\n') : '') ??
724
+ ''
725
+ );
726
+ const changedLines = newTxt.split(/\r?\n/);
727
+ const netLines = changedLines.filter((l) => l.trim().length > 0).length;
728
+ const deletedLineCount = oldTxt ? oldTxt.split(/\r?\n/).length : 0;
729
+ if (!sidecar.fileState || typeof sidecar.fileState !== 'object') sidecar.fileState = {};
730
+ if (!Array.isArray(sidecar.fileState.unverifiedEdits)) sidecar.fileState.unverifiedEdits = [];
731
+ sidecar.fileState.unverifiedEdits.push({
732
+ filePath: editTarget,
733
+ netLines,
734
+ changedLines: changedLines.slice(0, 64)
735
+ });
736
+ if (sidecar.fileState.unverifiedEdits.length > 32) {
737
+ sidecar.fileState.unverifiedEdits = sidecar.fileState.unverifiedEdits.slice(-32);
738
+ }
739
+ if (!Array.isArray(sidecar.fileState.turnFileDiffs)) sidecar.fileState.turnFileDiffs = [];
740
+ sidecar.fileState.turnFileDiffs.push({
741
+ filePath: editTarget,
742
+ addedLines: newTxt ? changedLines.slice(0, 400) : [],
743
+ deletedLineCount
744
+ });
745
+ if (sidecar.fileState.turnFileDiffs.length > 32) {
746
+ sidecar.fileState.turnFileDiffs = sidecar.fileState.turnFileDiffs.slice(-32);
747
+ }
748
+ if (effectivePromptText) {
749
+ sidecar.sessionMeta.lastUserPrompt = effectivePromptText;
750
+ }
751
+ }
752
+ }
753
+
754
+ const nowMs = inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now();
755
+ const eventTimestampUtc = inputData.eventTimestampUtc ?? nowMs;
756
+ const serviceTier = inputData.serviceTier || 'standard';
757
+ const tracker = new SwarmIdleTtlTracker({
758
+ initialRoster: inputData.swarmRoster || sidecar.swarmRoster,
759
+ cacheTtlMs: inputData.cacheTtlMs ?? 300000,
760
+ coldWakeThresholdTokens: inputData.coldWakeThresholdTokens ?? 100000
761
+ });
762
+
763
+ let coldCacheWakeup = null;
764
+ let systemMessage = gateSystemMessage;
765
+ let astSignatureStub = null;
766
+ let deltaDiffStub = null;
767
+ let astStubSavedTokens = 0;
768
+
769
+ if (!isOffMode && (toolName === 'read_file' || toolName === 'Read' || toolName === 'view_file')) {
770
+ const rawTarget = String(
771
+ toolInput?.Path || toolInput?.path || toolInput?.file_path || toolInput?.TargetFile || toolInput?.AbsolutePath || ''
772
+ ).trim();
773
+ const hasLineBounds = Number.isFinite(Number(toolInput?.StartLine ?? toolInput?.start_line ?? toolInput?.offset)) ||
774
+ Number.isFinite(Number(toolInput?.EndLine ?? toolInput?.end_line ?? toolInput?.limit));
775
+ if (rawTarget && !hasLineBounds) {
776
+ const resolvedPath = path.isAbsolute(rawTarget) ? rawTarget : path.resolve(workspacePath, rawTarget);
777
+ const normKey = resolvedPath.replace(/\\/g, '/').toLowerCase();
778
+ if (!sidecar.fileState || typeof sidecar.fileState !== 'object') sidecar.fileState = {};
779
+ if (!sidecar.fileState.unclippedReadCounts || typeof sidecar.fileState.unclippedReadCounts !== 'object') {
780
+ sidecar.fileState.unclippedReadCounts = {};
781
+ }
782
+ if (!sidecar.fileState.readSnapshots || typeof sidecar.fileState.readSnapshots !== 'object') {
783
+ sidecar.fileState.readSnapshots = {};
784
+ }
785
+ const priorReads = Number(inputData.priorUnclippedReads ?? sidecar.fileState.unclippedReadCounts[normKey] ?? 0);
786
+ const nextReads = priorReads + 1;
787
+ sidecar.fileState.unclippedReadCounts[normKey] = nextReads;
788
+
789
+ if (fs.existsSync(resolvedPath)) {
790
+ try {
791
+ const stat = fs.statSync(resolvedPath);
792
+ if (stat.isFile() && stat.size > 256 && stat.size <= 512 * 1024) {
793
+ const rawContent = fs.readFileSync(resolvedPath, 'utf8');
794
+ const prevSnap = typeof inputData.priorContentSnapshot === 'string'
795
+ ? inputData.priorContentSnapshot
796
+ : (typeof sidecar.fileState.readSnapshots[normKey] === 'string' ? sidecar.fileState.readSnapshots[normKey] : null);
797
+
798
+ if (prevSnap !== null && prevSnap !== rawContent) {
799
+ const delta = getCodeFoldMod().computeCompactLineDiff(prevSnap, rawContent, path.basename(resolvedPath));
800
+ if (delta.wasDiffed) {
801
+ deltaDiffStub = delta.diffText;
802
+ astStubSavedTokens = delta.savedTokens;
803
+ const deltaNotice = `[Highbeam Post-Edit Delta Read — ${path.basename(resolvedPath)} (+${delta.savedTokens} tokens saved)]\n${delta.diffText}`;
804
+ if (!isSilentMode && !systemMessage) {
805
+ systemMessage = deltaNotice;
806
+ }
807
+ try {
808
+ recordAntigravitySidecarSavings(sidecar, {
809
+ category: 'BOUNDED_READ_ENFORCED',
810
+ savedTokens: delta.savedTokens,
811
+ detail: `Post-edit delta read for ${path.basename(resolvedPath)}`,
812
+ nowMs: inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now()
813
+ });
814
+ } catch (err) {
815
+ recordHookDiagnostic('pre_invocation', 'handlePreToolUse.recordDeltaSavings', err);
816
+ }
817
+ }
818
+ } else if (nextReads >= 3 && stat.size > 512) {
819
+ const fullTokens = Math.max(1, Math.ceil(rawContent.length / 4));
820
+ const folded = getCodeFoldMod().foldCodeToSignatureStub(rawContent, resolvedPath);
821
+ const stubText = typeof folded?.condensed === 'string' && folded.condensed.length > 0
822
+ ? folded.condensed
823
+ : rawContent.slice(0, 1200);
824
+ const stubTokens = Math.max(1, Math.ceil(stubText.length / 4));
825
+ astStubSavedTokens = Math.max(0, fullTokens - stubTokens);
826
+ astSignatureStub = stubText;
827
+ const stubNotice = `[Highbeam AST Signature Stub — Read #${nextReads} of ${path.basename(resolvedPath)} (${astStubSavedTokens} tokens saved; pass StartLine/EndLine for full bodies)]\n${stubText}`;
828
+ if (!isSilentMode && !systemMessage) {
829
+ systemMessage = stubNotice;
830
+ }
831
+ if (astStubSavedTokens > 0) {
832
+ try {
833
+ recordAntigravitySidecarSavings(sidecar, {
834
+ category: 'BOUNDED_READ_ENFORCED',
835
+ savedTokens: astStubSavedTokens,
836
+ detail: `AST signature stub read #${nextReads} for ${path.basename(resolvedPath)}`,
837
+ nowMs: inputData.nowMs ?? inputData.eventTimestampUtc ?? Date.now()
838
+ });
839
+ } catch (err) {
840
+ recordHookDiagnostic('pre_invocation', 'handlePreToolUse.recordAstStubSavings', err);
841
+ }
842
+ }
843
+ }
844
+
845
+ if (rawContent.length <= 128 * 1024) {
846
+ const snapKeys = Object.keys(sidecar.fileState.readSnapshots);
847
+ if (!sidecar.fileState.readSnapshots[normKey] && snapKeys.length >= 12) {
848
+ delete sidecar.fileState.readSnapshots[snapKeys[0]];
849
+ }
850
+ sidecar.fileState.readSnapshots[normKey] = rawContent;
851
+ }
852
+ }
853
+ } catch (err) {
854
+ recordHookDiagnostic('pre_invocation', 'handlePreToolUse.astSignatureStub', err);
855
+ }
856
+ }
857
+ }
858
+ }
859
+
860
+ if (toolName === 'send_message' || toolInput?.Recipient || toolInput?.recipient || /@[a-z0-9_-]+/i.test(String(toolInput?.Message || toolInput?.message || toolInput?.brief || ''))) {
861
+ coldCacheWakeup = tracker.handlePreToolSendMessage(toolInput, {
862
+ nowMs,
863
+ eventTimestampUtc,
864
+ serviceTier
865
+ });
866
+ if (coldCacheWakeup.coldWakeDetected) {
867
+ if (isAutoPilotMode && !inputData.allowColdWake && Number(coldCacheWakeup.incrementalColdPenaltyUsd || 0) >= 0.5) {
868
+ return {
869
+ decision: 'block',
870
+ permissionDecision: 'deny',
871
+ terminationBehavior: 'terminate',
872
+ blocked: true,
873
+ flightMode,
874
+ autoPilotGate: 'COLD_CACHE_CLIFF_HOLD',
875
+ coldCacheWakeup,
876
+ reason: coldCacheWakeup.message,
877
+ userMessage: coldCacheWakeup.message,
878
+ systemMessage: coldCacheWakeup.message
879
+ };
880
+ }
881
+ if (!isAutoPilotMode && Number(coldCacheWakeup.incrementalColdPenaltyUsd || 0) >= 0.5) {
882
+ logAgToolShadowMiss(
883
+ 'DET-16',
884
+ 'COLD_SWARM_WAKEUP',
885
+ Number(coldCacheWakeup.incrementalColdPenaltyUsd || 0.55),
886
+ Number(inputData.cachedTokens ?? sidecar.telemetry?.cachedTokens ?? 120000),
887
+ coldCacheWakeup.message
888
+ );
889
+ }
890
+ if (!isSilentMode && !isOffMode) {
891
+ systemMessage = coldCacheWakeup.message;
892
+ }
893
+ }
894
+ } else if (toolName === 'invoke_subagent' || toolName === 'define_subagent' || toolName === 'swarm') {
895
+ // Item A9 (#18): Concurrent Multi-Agent Worktree Isolation Guard (`Workspace: "branch" | "share"`)
896
+ if (
897
+ !isOffMode &&
898
+ (toolName === 'invoke_subagent' ||
899
+ (toolName === 'swarm' && String(toolInput?.action || '').toLowerCase() === 'add'))
900
+ ) {
901
+ const subType = String(toolInput?.TypeName || toolInput?.name || '').trim().toLowerCase();
902
+ const isReadOnlySub =
903
+ subType === 'research' || subType === 'ah-flash-scout' || subType === 'browser';
904
+ const wsMode = String(toolInput?.Workspace || toolInput?.workspace || 'inherit')
905
+ .trim()
906
+ .toLowerCase();
907
+ if (!isReadOnlySub && wsMode !== 'branch' && wsMode !== 'share') {
908
+ const activeLeasesCount = Array.isArray(inputData.activeLeases)
909
+ ? inputData.activeLeases.length
910
+ : loadRegistry(workspacePath).leases.length;
911
+ const activeRosterCount = Object.values(tracker.getRosterSnapshot() || {}).filter(
912
+ (a) => a && a.status !== 'terminated' && !/^(research|ah-flash-scout|browser)$/i.test(String(a.id || ''))
913
+ ).length;
914
+ const concurrentWriters = Math.max(
915
+ activeLeasesCount,
916
+ activeRosterCount,
917
+ Number(inputData.activeWriteWorkers ?? 0)
918
+ );
919
+ if (concurrentWriters >= 1 && resolveDetectorOverride(horizonConfig, 'DET-20') !== 'off') {
920
+ const wtMsg =
921
+ `[DET-20 Worktree Isolation Guard (#18)] Spawning write-capable ${toolName} with Workspace: "${wsMode}" while ${concurrentWriters} write worker(s)/lease(s) are already active risks shared-tree clobbering. Set Workspace: "branch" or "share".`;
922
+ if (isAutoPilotMode || resolveDetectorOverride(horizonConfig, 'DET-20') === 'block') {
923
+ return makeBlockPayload({ id: 'DET-20', message: wtMsg });
924
+ }
925
+ if (!isSilentMode && !systemMessage) systemMessage = wtMsg;
926
+ }
927
+ }
928
+ }
929
+ if (toolName === 'invoke_subagent' || toolName === 'define_subagent') {
930
+ const subagentId = toolInput?.ConversationId || toolInput?.conversationId || toolInput?.Name || toolInput?.TypeName || toolInput?.Role || 'subagent';
931
+ const subagentModel = toolInput?.Model && toolInput.Model !== 'inherit'
932
+ ? toolInput.Model
933
+ : (sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || 'gemini-4-carbon');
934
+ tracker.touchAgentActive(subagentId, {
935
+ modelId: subagentModel,
936
+ warmPrefixTokens: Number(toolInput?.warm_prefix_tokens ?? 0),
937
+ timestampMs: nowMs
938
+ });
939
+ }
940
+ } else if (toolName === 'manage_subagents') {
941
+ const action = String(toolInput?.Action || toolInput?.action || '').toLowerCase();
942
+ if (action === 'kill' && Array.isArray(toolInput?.ConversationIds)) {
943
+ for (const id of toolInput.ConversationIds) {
944
+ tracker.terminateAgent(id, { timestampMs: nowMs });
945
+ }
946
+ } else if (action === 'kill_all') {
947
+ for (const id of Object.keys(tracker.getRosterSnapshot())) {
948
+ tracker.terminateAgent(id, { timestampMs: nowMs });
949
+ }
950
+ }
951
+ }
952
+
953
+ sidecar.swarmRoster = tracker.getRosterSnapshot();
954
+ sidecar.swarmTtlBadges = computeSwarmRosterTtlBadges(sidecar.swarmRoster, {
955
+ nowMs,
956
+ cacheTtlMs: inputData.cacheTtlMs ?? 300000
957
+ });
958
+
959
+ try {
960
+ writeSidecarAtomicSync(conversationId, sidecar);
961
+ } catch (err) {
962
+ recordHookDiagnostic('pre_invocation', 'handlePreToolUse.writeSidecar', err);
963
+ }
964
+
965
+ const response = {
966
+ decision: 'allow',
967
+ flightMode,
968
+ active_model_id: sidecar.sessionMeta.active_model_id || sidecar.sessionMeta.activeModel || null,
969
+ pending_model_id: sidecar.sessionMeta.pending_model_id || null,
970
+ swarmTtlBadges: sidecar.swarmTtlBadges
971
+ };
972
+ if (coldCacheWakeup) response.coldCacheWakeup = coldCacheWakeup;
973
+ if (astSignatureStub) {
974
+ response.astSignatureStub = astSignatureStub;
975
+ response.savedTokens = astStubSavedTokens;
976
+ }
977
+ if (deltaDiffStub) {
978
+ response.deltaDiffStub = deltaDiffStub;
979
+ response.savedTokens = astStubSavedTokens;
980
+ }
981
+ if (systemMessage && !isSilentMode && !isOffMode) response.systemMessage = systemMessage;
982
+ return response;
983
+ }
984
+
985
+ export async function handlePreInvocation(inputData = {}) {
986
+ if (
987
+ inputData.hook_event_name === 'PreToolUse' ||
988
+ inputData.event === 'PreToolUse' ||
989
+ inputData.tool_name ||
990
+ inputData.toolName ||
991
+ inputData.tool_input ||
992
+ inputData.args ||
993
+ inputData.parameters ||
994
+ inputData.Arguments ||
995
+ (typeof inputData.tool === 'string' && inputData.tool.length > 0) ||
996
+ (typeof inputData.name === 'string' && !inputData.prompt && !inputData.user_input)
997
+ ) {
998
+ return handlePreToolUse(inputData);
999
+ }
1000
+
1001
+ const config = inputData.configOverride || loadFlightcheckConfig();
1002
+ const rawPrompt = String(inputData.prompt || inputData.user_input || inputData.message || '').trim();
1003
+ const conversationId = inputData.conversationId || inputData.session_id || inputData.conversation_id || 'default_session';
1004
+ const sidecar = readSidecarSync(conversationId);
1005
+ const workspacePath = inputData.cwd || inputData.workspacePath || sidecar.workspacePath || process.cwd();
1006
+ const horizonConfig = inputData.horizonConfig || loadHorizonConfig({
1007
+ cwd: workspacePath,
1008
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {})
1009
+ });
1010
+ const rawFlightMode = String(inputData.flightMode || horizonConfig.flightMode || 'COACH').toUpperCase();
1011
+ const resolvedModeInfo = AUTO_MODE_ALIAS_RE.test(rawFlightMode)
1012
+ ? getProMod().resolveEffectiveAutoFlightMode(rawFlightMode, {
1013
+ licensePath: inputData.licensePath,
1014
+ homeDir: inputData.homeDir,
1015
+ strict: Boolean(inputData.strictProGate)
1016
+ })
1017
+ : { effectiveFlightMode: resolveSimpleAgMode(rawFlightMode) };
1018
+ const flightMode = resolvedModeInfo.effectiveFlightMode;
1019
+ const agPromptShadowOpts = {
1020
+ cwd: workspacePath,
1021
+ ...(inputData.homeDir ? { homeDir: inputData.homeDir } : {}),
1022
+ ...(inputData.shadowLedgerPath ? { shadowLedgerPath: inputData.shadowLedgerPath } : {})
1023
+ };
1024
+ const logAgPromptShadowMiss = (detectorId, category, missedUsd, wastedTokens, detail) => {
1025
+ if (flightMode === 'AUTO_PILOT') return;
1026
+ getShadowAutoMod().recordShadowAutoMiss(
1027
+ {
1028
+ sessionId: conversationId,
1029
+ workspacePath,
1030
+ harness: 'antigravity',
1031
+ effectiveMode: flightMode,
1032
+ category,
1033
+ detectorId,
1034
+ turnKey: inputData.turnKey || inputData.turn || `${detectorId}:prompt`,
1035
+ wastedTokens,
1036
+ missedUsd,
1037
+ avoidedPrompts: 1,
1038
+ autoSelected: rawFlightMode === 'AUTO_PILOT' || rawFlightMode === 'AUTOPILOT',
1039
+ detail
1040
+ },
1041
+ agPromptShadowOpts
1042
+ );
1043
+ };
1044
+
1045
+ // 1. Control Flags & flightMode Handling (ISS-039)
1046
+ if (config.hook_level === 'off' || flightMode === 'OFF') {
1047
+ return {};
1048
+ }
1049
+ if (flightMode === 'SILENT') {
1050
+ // SILENT suppresses all non-Ring-0 advisory context/stderr chatter on PreInvocation
1051
+ // (Ring-0 security blocks remain active in PreToolUse and workspace settings checks).
1052
+ if (resolveDetectorOverride(horizonConfig, 'DET-18') !== 'off' && inputData.scanWorkspaceSettings === true) {
1053
+ const det18 = getDetectorsMod().evaluateDet18UntrustedWorkspaceSettings([], { workspacePath, scanWorkspace: true });
1054
+ if (det18) {
1055
+ return { terminationBehavior: 'terminate', decision: 'block', detectorId: 'DET-18', userMessage: det18.message };
1056
+ }
1057
+ }
1058
+ if (rawPrompt && (inputData.cwd || inputData.workspacePath) && inputData.bucketBShadow !== false) {
1059
+ try {
1060
+ const silentFileState = sidecar.fileState || {};
1061
+ const silentSessionMeta = sidecar.sessionMeta || {};
1062
+ const isAutonomousOrSubagent = Boolean(
1063
+ inputData.isAutonomousTurn ||
1064
+ inputData.autonomous ||
1065
+ inputData.isSubagent ||
1066
+ silentSessionMeta.isSubagent ||
1067
+ inputData.isScheduledTask ||
1068
+ inputData.isLoopIteration ||
1069
+ /^(?:scheduled|cron|loop|subagent|agent_callback|callback|auto|autonomous|background|system|hook|task_notification|wake)$/i.test(
1070
+ String(inputData.provenance || inputData.source || '')
1071
+ )
1072
+ );
1073
+ const cachedDirtyFiles = Array.isArray(inputData.cachedDirtyFiles)
1074
+ ? inputData.cachedDirtyFiles
1075
+ : [
1076
+ ...(silentFileState.modifiedFiles || []),
1077
+ ...(Array.isArray(silentFileState.unverifiedEdits)
1078
+ ? silentFileState.unverifiedEdits.map((e) => e?.filePath)
1079
+ : [])
1080
+ ];
1081
+ runBucketBPromptPass({
1082
+ platform: 'antigravity',
1083
+ sessionId: conversationId,
1084
+ cwd: workspacePath,
1085
+ hasExplicitCwd: true,
1086
+ prompt: rawPrompt,
1087
+ isAutonomousOrSubagent,
1088
+ cachedDirtyFiles,
1089
+ lastFailingLocation:
1090
+ inputData.lastFailingLocation ?? silentSessionMeta.lastFailingLocation ?? '',
1091
+ options: {
1092
+ bucketBStage: inputData.bucketBStage,
1093
+ bucketBGammaStage: inputData.bucketBGammaStage,
1094
+ mode: 'SILENT',
1095
+ horizonConfig
1096
+ }
1097
+ });
1098
+ } catch (err) {
1099
+ recordHookDiagnostic('pre_invocation', 'handlePreInvocation.silentPromptPass', err, { persist: false });
1100
+ }
1101
+ }
1102
+ return {};
1103
+ }
1104
+
1105
+ const sessionMeta = sidecar.sessionMeta || {};
1106
+ const telemetry = sidecar.telemetry || {};
1107
+ const sensors = sidecar.sensors || {};
1108
+ const fileState = sidecar.fileState || {};
1109
+
1110
+ if (rawPrompt.includes('!lock')) {
1111
+ sessionMeta.effortLocked = true;
1112
+ sidecar.sessionMeta = sessionMeta;
1113
+ try {
1114
+ writeSidecarAtomicSync(conversationId, sidecar);
1115
+ } catch (err) {
1116
+ recordHookDiagnostic('pre_invocation', 'effortLock.writeSidecar', err);
1117
+ }
1118
+ return {};
1119
+ }
1120
+
1121
+ if (rawPrompt.startsWith('! ') || rawPrompt === '!' || rawPrompt.startsWith('!force')) {
1122
+ return {};
1123
+ }
1124
+
1125
+ const hasCheckTag = /#check\b/i.test(rawPrompt);
1126
+ const turnCount = sessionMeta.turnCount || 0;
1127
+ const purity = telemetry.signalPurityPct ?? 100.0;
1128
+ const tokens = telemetry.totalInputTokens || 0;
1129
+ const activeEffort = inputData.effort || sessionMeta.activeEffort || 'high';
1130
+ const activeModel = inputData.modelName || sessionMeta.activeModel || (config.recommended_models?.fast || 'gemini-3.8-flash');
1131
+ const quotaFrac = telemetry.quota?.remaining_fraction ?? 1.0;
1132
+ const ceiling = resolveModelCeiling(activeModel, null, { config }) || 256000;
1133
+ const ceilingK = Math.round(ceiling / 1000);
1134
+
1135
+ // In AUTO_PILOT mode, enforce active guard halts even if legacy hook_level was 'advisory'
1136
+ const hookLevel = flightMode === 'AUTO_PILOT' ? 'guard' : (config.hook_level || 'guard');
1137
+ const cooldownTurns = config.halt_cooldown_turns ?? 3;
1138
+ const lastHalts = { ...(sessionMeta.lastHalts || {}) };
1139
+ const isTelemetryReliable = telemetry.confidence !== 'LOW';
1140
+
1141
+ function haltOrAdvise(stateKey, card, { exemptFromCooldown = false } = {}) {
1142
+ const lastFiredTurn = lastHalts[stateKey];
1143
+ const isWithinCooldown = typeof lastFiredTurn === 'number' && ((turnCount - lastFiredTurn) <= cooldownTurns);
1144
+
1145
+ if (hookLevel === 'advisory' || (isWithinCooldown && !exemptFromCooldown)) {
1146
+ return { systemMessage: card };
1147
+ }
1148
+
1149
+ lastHalts[stateKey] = turnCount;
1150
+ sessionMeta.lastHalts = lastHalts;
1151
+ sidecar.sessionMeta = sessionMeta;
1152
+ try {
1153
+ writeSidecarAtomicSync(conversationId, sidecar);
1154
+ } catch (err) {
1155
+ recordHookDiagnostic('pre_invocation', 'haltOrAdvise.writeSidecar', err);
1156
+ }
1157
+ return { terminationBehavior: 'terminate', userMessage: card };
1158
+ }
1159
+
1160
+ function applyHabitOverride(slug, stateKey, card, { detectorId = null, defaultMode = 'haltOrAdvise', extraWarn = {}, extraBlock = {} } = {}) {
1161
+ const override = resolveDetectorOverride(horizonConfig, slug);
1162
+ if (override === 'off') return null;
1163
+ if (override === 'warn') {
1164
+ return { systemMessage: card, ...(detectorId ? { detectorId } : {}), ...extraWarn };
1165
+ }
1166
+ if (override === 'block') {
1167
+ lastHalts[stateKey] = turnCount;
1168
+ sessionMeta.lastHalts = lastHalts;
1169
+ sidecar.sessionMeta = sessionMeta;
1170
+ try {
1171
+ writeSidecarAtomicSync(conversationId, sidecar);
1172
+ } catch (err) {
1173
+ recordHookDiagnostic('pre_invocation', 'applyHabitOverride.writeSidecar', err);
1174
+ }
1175
+ return {
1176
+ terminationBehavior: 'terminate',
1177
+ decision: 'block',
1178
+ ...(detectorId ? { detectorId } : {}),
1179
+ userMessage: card,
1180
+ ...extraBlock
1181
+ };
1182
+ }
1183
+ if (defaultMode === 'flightMode') {
1184
+ if (flightMode === 'AUTO_PILOT') {
1185
+ return {
1186
+ terminationBehavior: 'terminate',
1187
+ decision: 'block',
1188
+ ...(detectorId ? { detectorId } : {}),
1189
+ userMessage: card,
1190
+ ...extraBlock
1191
+ };
1192
+ }
1193
+ return { systemMessage: card, ...(detectorId ? { detectorId } : {}), ...extraWarn };
1194
+ }
1195
+ return haltOrAdvise(stateKey, card);
1196
+ }
1197
+
1198
+ // 2. ALLOW_PLAN_OR_SUBAGENT
1199
+ if (!hasCheckTag && (sessionMeta.inPlanMode || sessionMeta.lastTurnUsedSubagent)) {
1200
+ if (!telemetry.amputationRisk && !sensors.threeStrikeLoop) {
1201
+ return {};
1202
+ }
1203
+ }
1204
+
1205
+ // 3. HALT_HYGIENE_OR_SAFETY
1206
+ sessionMeta.lastUserPrompt = rawPrompt;
1207
+ const isHighOrMaxEffort = activeEffort === 'high' || activeEffort === 'max';
1208
+
1209
+ // 3a.0 Item A6 (#11): Active DET-30 Thinking Runaway Step-Down Gate (>4,000 thinking tokens & >12x ratio across >=2 turns)
1210
+ if (resolveDetectorOverride(horizonConfig, 'DET-30') !== 'off') {
1211
+ const det30Check = evaluateActiveDet30StepDown({
1212
+ recentTurns: inputData.recentTurns || telemetry.recentTurns,
1213
+ thinkingDrift: inputData.thinkingDrift || telemetry.thinkingDrift || sensors.thinkingDrift,
1214
+ mode: flightMode
1215
+ });
1216
+ if (det30Check.triggered) {
1217
+ const det30Card = formatScorecard(
1218
+ det30Check.reason,
1219
+ `[Thinking Streak: ${det30Check.consecutiveTurns} turns | Ratio: ${det30Check.latestRatio}x]`,
1220
+ `Step down effort to medium or cap MAX_THINKING_TOKENS=16000`,
1221
+ `"Switch to medium effort before sending next prompt"`
1222
+ );
1223
+ const det30Res = applyHabitOverride('thinking-runaway', 'DET30_THINKING_STEPDOWN', det30Card, {
1224
+ detectorId: 'DET-30',
1225
+ defaultMode: 'flightMode'
1226
+ });
1227
+ if (det30Res) {
1228
+ if (det30Res.decision !== 'block' && det30Res.terminationBehavior !== 'terminate') {
1229
+ logAgPromptShadowMiss('DET-30', 'RUNAWAY_LOOP_TURN', 0.35, Number(tokens || 40000), det30Check.reason);
1230
+ }
1231
+ return det30Res;
1232
+ }
1233
+ }
1234
+ }
1235
+
1236
+ // 3a. Item A3 (#7): Parameterized Pricing Cliff Breaker (Haiku 100K 5x + Gemini 3.1/2.5 Pro 200K 2x/1.5x)
1237
+ if (resolveDetectorOverride(horizonConfig, 'DET-12') !== 'off') {
1238
+ const cliffCheck = evaluateParameterizedCliffBreaker({
1239
+ modelId: activeModel,
1240
+ totalInputTokens: Number(inputData.totalInputTokens ?? inputData.totalPromptTokens ?? tokens)
1241
+ });
1242
+ if (cliffCheck.triggered) {
1243
+ if (cliffCheck.decision === 'deny') {
1244
+ const cliffCard = formatScorecard(
1245
+ cliffCheck.reason,
1246
+ `[Useful Context: ${purity}% | Cliff Threshold: ${Math.round(cliffCheck.cliffThresholdTokens / 1000)}k]`,
1247
+ `/compact or /clear`,
1248
+ `"Compact context before crossing the ${Math.round(cliffCheck.cliffThresholdTokens / 1000)}k stepped pricing cliff"`
1249
+ );
1250
+ return haltOrAdvise('PRICING_CLIFF_BREAKER', cliffCard, { exemptFromCooldown: true });
1251
+ }
1252
+ const advRes = applyHabitOverride('pricing-cliff', 'PRICING_CLIFF_ADVISORY', cliffCheck.reason, {
1253
+ detectorId: 'DET-12',
1254
+ defaultMode: 'warn'
1255
+ });
1256
+ if (advRes) return advRes;
1257
+ }
1258
+ }
1259
+
1260
+ // 3b. Item A1 (#1): Warm-Cache Mid-Session Model Switch Guard (Antigravity PreInvocation)
1261
+ const priorActiveModel = sessionMeta.active_model_id || sessionMeta.activeModel || null;
1262
+ if (
1263
+ inputData.modelName &&
1264
+ priorActiveModel &&
1265
+ turnCount >= 1 &&
1266
+ normalizeModelKey(inputData.modelName) !== normalizeModelKey(priorActiveModel)
1267
+ ) {
1268
+ const cachedTok = Number(
1269
+ inputData.cachedTokens ?? telemetry.cachedTokens ?? telemetry.cacheReadTokens ?? tokens ?? 0
1270
+ );
1271
+ const cacheTtlSec = Number(inputData.cacheTtlSeconds ?? telemetry.cacheTtlSeconds ?? 300);
1272
+ if (cachedTok >= 25000 && cacheTtlSec > 0) {
1273
+ const prevRates = resolveModelRates(priorActiveModel, inputData.eventTimestampUtc, 'standard', {
1274
+ totalPromptTokens: cachedTok
1275
+ });
1276
+ const nextRates = resolveModelRates(inputData.modelName, inputData.eventTimestampUtc, 'standard', {
1277
+ totalPromptTokens: cachedTok
1278
+ });
1279
+ const coldPenaltyUsd =
1280
+ (cachedTok / 1_000_000) * Math.max(0, nextRates.write5m - prevRates.cachedRead);
1281
+ const outputDeltaSavingUsd =
1282
+ (1500 / 1_000_000) * Math.max(0, prevRates.output - nextRates.output);
1283
+ if (coldPenaltyUsd > outputDeltaSavingUsd && coldPenaltyUsd >= 0.03) {
1284
+ const bustCard = formatScorecard(
1285
+ `[DET-08 Warm-Cache Model Switch] ${normalizeModelKey(priorActiveModel)} -> ${normalizeModelKey(inputData.modelName)} on ${Math.round(cachedTok / 1000)}k warm prefix`,
1286
+ `[Cold Cache Penalty: +$${coldPenaltyUsd.toFixed(3)} vs $${outputDeltaSavingUsd.toFixed(3)} output saving]`,
1287
+ `Stay on ${normalizeModelKey(priorActiveModel)} or delegate via invoke_subagent`,
1288
+ `"Keep main thread on ${normalizeModelKey(priorActiveModel)} until /compact, or use invoke_subagent"`
1289
+ );
1290
+ const bustRes = applyHabitOverride('mid-session-model-switch', 'MID_SESSION_CACHE_BUST', bustCard, {
1291
+ detectorId: 'DET-08',
1292
+ defaultMode: 'flightMode'
1293
+ });
1294
+ if (bustRes) {
1295
+ if (bustRes.decision !== 'block' && bustRes.terminationBehavior !== 'terminate') {
1296
+ logAgPromptShadowMiss(
1297
+ 'DET-08',
1298
+ 'WARM_SWITCH_BUST',
1299
+ Number(Math.max(0.03, coldPenaltyUsd - outputDeltaSavingUsd).toFixed(4)),
1300
+ cachedTok,
1301
+ `Warm model switch ${normalizeModelKey(priorActiveModel)} -> ${normalizeModelKey(inputData.modelName)}`
1302
+ );
1303
+ }
1304
+ return bustRes;
1305
+ }
1306
+ }
1307
+ }
1308
+ }
1309
+ if (telemetry.amputationRisk && isTelemetryReliable) {
1310
+ const handoff = sidecar.handoff || {};
1311
+ const handoffAction = handoff.result === 'NEEDS_FIXES'
1312
+ ? `Handoff NEEDS FIXES: ${(handoff.failingChecks || []).slice(0, 2).join('; ') || 'update task.md'}`
1313
+ : `/clear or /compact`;
1314
+ const rewriteCmd = handoff.result === 'NEEDS_FIXES'
1315
+ ? `"Update task.md checkpoint (/handoff), then type /compact or /clear"`
1316
+ : `"Save progress to task.md and start a clean session with /clear (or /compact)"`;
1317
+
1318
+ const card = formatScorecard(
1319
+ `[Amputation Crisis] Tokens: ${Math.round(tokens / 1000)}k/${ceilingK}k (Context Truncation Risk)`,
1320
+ `[Useful Context: ${purity}% | Oldest Rules at Risk]`,
1321
+ handoffAction,
1322
+ rewriteCmd
1323
+ );
1324
+ return haltOrAdvise('AMPUTATION_CRISIS', card, { exemptFromCooldown: true });
1325
+ }
1326
+
1327
+ if (sensors.threeStrikeLoop) {
1328
+ const loopInfo = sensors.loopFingerprint
1329
+ ? `Loop: ${sensors.loopFingerprint.slice(0, 48)}`
1330
+ : 'Consecutive command failures detected';
1331
+ const card = formatScorecard(
1332
+ `[3-Strike Error Loop] ${loopInfo}`,
1333
+ `[Useful Context: ${purity}% | Errors: 3 strikes]`,
1334
+ `Break loop: isolate with subagent or compact`,
1335
+ `"Diagnose previous errors using invoke_subagent or run /compact"`
1336
+ );
1337
+ return haltOrAdvise('THREE_STRIKE_LOOP', card);
1338
+ }
1339
+
1340
+ if (fileState.foreignBleedKiIds && fileState.foreignBleedKiIds.length > 0 && sessionMeta.inPlanMode) {
1341
+ const card = formatScorecard(
1342
+ `[Foreign KI Bleed] Injected memory from other workspace`,
1343
+ `[Bleed IDs: ${fileState.foreignBleedKiIds.join(', ')}]`,
1344
+ `/context`,
1345
+ `"Eject foreign knowledge items in /context before planning"`
1346
+ );
1347
+ return haltOrAdvise('FOREIGN_BLEED', card);
1348
+ }
1349
+
1350
+ if (isTelemetryReliable && purity < (config.compact_halt_purity_pct || 45.0) && isHighOrMaxEffort) {
1351
+ const card = formatScorecard(
1352
+ `[Low Useful Context] ${purity}% useful context on ${activeEffort} effort`,
1353
+ `[Wasted Context: +$${(telemetry.sludgeTaxUsdPerTurn || 0).toFixed(2)}/turn]`,
1354
+ `/compact`,
1355
+ `"Run /compact to compress stale reads before high-effort execution"`
1356
+ );
1357
+ return haltOrAdvise('LOW_PURITY', card);
1358
+ }
1359
+
1360
+ if (sensors.uncheckpointedGitDrift) {
1361
+ const card = formatScorecard(
1362
+ `[Uncheckpointed Drift] ${sensors.dirtyGitFileCount || 4}+ dirty files untested`,
1363
+ `[Git Drift: >=3 turns without passing test]`,
1364
+ `git commit or run test`,
1365
+ `"Run unit tests and commit working changes before editing further"`
1366
+ );
1367
+ return haltOrAdvise('GIT_DRIFT', card);
1368
+ }
1369
+
1370
+ // 4. HALT_EFFORT_OR_QUOTA
1371
+ const fastModel = config.recommended_models?.fast || 'gemini-3.8-flash';
1372
+ const deepModel = config.recommended_models?.deep || 'gemini-3.1-pro';
1373
+
1374
+ if (isTelemetryReliable && sensors.quotaFloorBreached && (activeModel.includes('pro') || activeModel.includes('argon') || activeModel.includes('carbon') || activeEffort === 'max')) {
1375
+ const card = formatScorecard(
1376
+ `[Quota Floor Breached] 5h Quota: ${Math.round(quotaFrac * 100)}% (<10%)`,
1377
+ `[Tokens: ${Math.round(tokens / 1000)}k | Risk: 0% lockout]`,
1378
+ `/model ${fastModel} • /effort low`,
1379
+ `"Switch to ${fastModel} on low effort to preserve remaining quota"`
1380
+ );
1381
+ return haltOrAdvise('QUOTA_FLOOR', card);
1382
+ }
1383
+
1384
+ const promptTokenEst = Math.max(1, Math.ceil(rawPrompt.length / 4));
1385
+ const isColdCache = tokens < 10000;
1386
+ const isTrivial = promptTokenEst < 15;
1387
+ if (isTelemetryReliable && !sessionMeta.effortLocked && isTrivial && (sessionMeta.consecutiveTrivialOnMax >= 2 || (isColdCache && (activeModel.includes('pro') || activeModel.includes('argon') || activeModel.includes('carbon')) && activeEffort === 'max'))) {
1388
+ const card = formatScorecard(
1389
+ `[Effort Overkill] Trivial edit (${promptTokenEst} tokens) on max effort`,
1390
+ `[Cold cache / trivial turn]`,
1391
+ `/model ${fastModel} • /effort low`,
1392
+ `"Run trivial single-file edit on ${fastModel} / low effort"`
1393
+ );
1394
+ const effortRes = applyHabitOverride('effort-overkill', 'EFFORT_OVERKILL', card);
1395
+ if (effortRes) return effortRes;
1396
+ }
1397
+
1398
+ // 4b. Local Formatter / Import Sorter Bypass (DET-15 / 'formatter-bypass')
1399
+ 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);
1400
+ const pastedLineCount = (rawPrompt.match(/\r?\n/g) || []).length;
1401
+ if (isFormattingIntent && pastedLineCount >= 40 && !/\b(add|implement|refactor|create|fix\s+bug|logic|test|calculate)\b/i.test(rawPrompt)) {
1402
+ 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).';
1403
+ const fmtRes = applyHabitOverride('formatter-bypass', 'LOCAL_FORMATTER_BYPASS', bypassNotice, {
1404
+ detectorId: 'DET-15',
1405
+ defaultMode: 'flightMode'
1406
+ });
1407
+ if (fmtRes) return fmtRes;
1408
+ }
1409
+
1410
+ // 5. INJECT_CONTEXT_GUARD
1411
+ const guards = [];
1412
+ const eventTimestampUtc = inputData.eventTimestampUtc ?? null;
1413
+ if (isModelDeprecated(activeModel, eventTimestampUtc)) {
1414
+ const notice = getDeprecatedModelMigrationNotice(activeModel, eventTimestampUtc);
1415
+ if (notice) guards.push(notice);
1416
+ }
1417
+ const recentTurns = inputData.recentTurns || sidecar.recentTurns || [];
1418
+ if (Array.isArray(recentTurns) && recentTurns.length >= 2) {
1419
+ const verbosityGuard = evaluateCarbonVerbosityGuardrail(recentTurns, {
1420
+ modelId: activeModel,
1421
+ activeEffort,
1422
+ eventTimestampUtc
1423
+ });
1424
+ if (verbosityGuard.triggered && verbosityGuard.prescription) {
1425
+ guards.push(verbosityGuard.prescription);
1426
+ }
1427
+ }
1428
+ if (!isTelemetryReliable) {
1429
+ guards.push('Telemetry confidence DEGRADED (parser schema drift detected) — running fail-open');
1430
+ }
1431
+ if (fileState.dirtySnapshotPaths && fileState.dirtySnapshotPaths.length > 0) {
1432
+ guards.push(`Dirty Snapshots modified externally: ${fileState.dirtySnapshotPaths.slice(0, 2).join(', ')} — re-read with view_file before editing`);
1433
+ }
1434
+ if (fileState.unseenCallers && fileState.unseenCallers.length > 0) {
1435
+ guards.push(`Unseen Callers importing target: ${fileState.unseenCallers.slice(0, 2).join(', ')} — verify signature compatibility`);
1436
+ }
1437
+ if (fileState.legacyPoisonPaths && fileState.legacyPoisonPaths.length > 0) {
1438
+ guards.push(`Legacy Poison paths in context: ${fileState.legacyPoisonPaths.slice(0, 2).join(', ')} — avoid copying deprecated patterns`);
1439
+ }
1440
+ if (fileState.streamCutoffRiskFiles && fileState.streamCutoffRiskFiles.length > 0) {
1441
+ guards.push(`Stream Cutoff Risk (>600 lines): ${fileState.streamCutoffRiskFiles.slice(0, 2).join(', ')} — use surgical edit chunks under 300 lines`);
1442
+ }
1443
+
1444
+ if (guards.length > 0) {
1445
+ return {
1446
+ systemMessage: `[Flight Check Context Guard] Active hazards: ${guards.join('; ')}`
1447
+ };
1448
+ }
1449
+
1450
+ // 6. STEER_SUBAGENT
1451
+ const isComplexTopic = /(concurrency|deadlock|race condition|architecture refactor|multi-module)/i.test(rawPrompt);
1452
+ if (tokens >= (config.subagent_min_cache_tokens || 25000) &&
1453
+ purity >= (config.subagent_min_purity_pct || 70.0) &&
1454
+ (activeEffort === 'low' || activeEffort === 'medium') &&
1455
+ isComplexTopic) {
1456
+ return {
1457
+ 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.`
1458
+ };
1459
+ }
1460
+
1461
+ // 7. ALLOW_ACTIVE_SET & Trust Decay
1462
+ const matchedScope = (fileState.activeSetPaths || fileState.modifiedFiles || []).find(p => {
1463
+ const base = path.basename(p);
1464
+ return rawPrompt.includes(base) || rawPrompt.includes(p);
1465
+ }) || '';
1466
+ const hasActiveSetMatch = Boolean(matchedScope);
1467
+
1468
+ // Conversational Drip-Feeding check (DET-02B) & Cross-Turn Sharded Spec Detector:
1469
+ // Even if prompt mentions activeSetPaths, 4+ rapid micro-prompts (<= 18 words) targeting the same file within 90s trigger DET-02B,
1470
+ // while 4+ requirement-mutating shards across >=25k tokens trigger SHARDED_SPEC_DRIFT.
1471
+ const timestampMs = Number(inputData.timestampMs ?? inputData.nowMs ?? inputData.timestamp ?? Date.now());
1472
+ const wordCount = rawPrompt.split(/\s+/).filter(Boolean).length;
1473
+ const effectiveTurnNumber = Number(
1474
+ inputData.turnNumber ?? Math.max(turnCount + 1, Number(sessionMeta.promptTurnSeq || 0) + 1)
1475
+ );
1476
+ sessionMeta.promptTurnSeq = effectiveTurnNumber;
1477
+ sessionMeta.recentPrompts = Array.isArray(sessionMeta.recentPrompts) ? sessionMeta.recentPrompts : [];
1478
+ sessionMeta.recentPrompts = sessionMeta.recentPrompts.filter(e => (timestampMs - e.ts) <= 90000);
1479
+ sessionMeta.recentPrompts.push({ ts: timestampMs, wordCount, targetScope: matchedScope });
1480
+
1481
+ const shardedOverride = resolveDetectorOverride(horizonConfig, 'sharded-spec-drift');
1482
+ const shardedEval = rawPrompt
1483
+ ? evaluateShardedSpecDrift({
1484
+ prompt: rawPrompt,
1485
+ provenance: inputData.provenance || inputData.source || 'user',
1486
+ isAutonomousTurn: Boolean(inputData.isAutonomousTurn || inputData.autonomous),
1487
+ isSubagent: Boolean(inputData.isSubagent || sessionMeta.isSubagent),
1488
+ isScheduledTask: Boolean(inputData.isScheduledTask),
1489
+ isLoopIteration: Boolean(inputData.isLoopIteration),
1490
+ priorShards: Array.isArray(inputData.specShards) ? inputData.specShards : (sessionMeta.specShards || []),
1491
+ initialGoal: inputData.initialGoal ?? sessionMeta.initialGoal ?? '',
1492
+ totalTokens: Number(inputData.totalInputTokens ?? inputData.totalPromptTokens ?? tokens),
1493
+ turnNumber: effectiveTurnNumber,
1494
+ lastAlertTurn: Number(sessionMeta.lastShardedSpecAlertTurn || 0),
1495
+ overrideMode: shardedOverride,
1496
+ flightMode,
1497
+ detectorId: 'DET-26'
1498
+ })
1499
+ : { triggered: false, specShards: sessionMeta.specShards || [], initialGoal: sessionMeta.initialGoal || '', lastAlertTurn: Number(sessionMeta.lastShardedSpecAlertTurn || 0) };
1500
+
1501
+ sessionMeta.specShards = shardedEval.specShards;
1502
+ if (shardedEval.initialGoal) sessionMeta.initialGoal = shardedEval.initialGoal;
1503
+ sessionMeta.lastShardedSpecAlertTurn = shardedEval.lastAlertTurn;
1504
+
1505
+ sidecar.sessionMeta = sessionMeta;
1506
+ const flushSidecarOnce = () => {
1507
+ try {
1508
+ writeSidecarAtomicSync(conversationId, sidecar);
1509
+ } catch (err) {
1510
+ recordHookDiagnostic('pre_invocation', 'recentPrompts.writeSidecar', err);
1511
+ }
1512
+ };
1513
+
1514
+ const rapidSameScopeCount = sessionMeta.recentPrompts.filter(
1515
+ e => e.targetScope && e.targetScope === matchedScope && e.wordCount <= 18
1516
+ ).length;
1517
+
1518
+ if (rapidSameScopeCount >= 4) {
1519
+ 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.`;
1520
+ const dripRes = applyHabitOverride('drip-feed', 'CONVERSATIONAL_DRIP_FEED', dripCard, {
1521
+ detectorId: 'DET-02B',
1522
+ defaultMode: 'flightMode',
1523
+ extraWarn: { continue: true },
1524
+ extraBlock: { continue: false }
1525
+ });
1526
+ if (dripRes) {
1527
+ if (!dripRes.terminationBehavior && dripRes.decision !== 'block') flushSidecarOnce();
1528
+ return dripRes;
1529
+ }
1530
+ }
1531
+
1532
+ if (shardedEval.triggered) {
1533
+ flushSidecarOnce();
1534
+ return {
1535
+ ephemeralMessage: shardedEval.steerContext,
1536
+ systemMessage: shardedEval.steerContext,
1537
+ detectorId: 'DET-26',
1538
+ subType: shardedEval.subType,
1539
+ shardCount: shardedEval.shardCount
1540
+ };
1541
+ }
1542
+
1543
+ if (!hasCheckTag) {
1544
+ if (hasActiveSetMatch) {
1545
+ flushSidecarOnce();
1546
+ return {};
1547
+ }
1548
+ if (config.hook_level === 'guard' && turnCount > (config.trust_decay_turn_threshold || 10)) {
1549
+ flushSidecarOnce();
1550
+ return {};
1551
+ }
1552
+ }
1553
+
1554
+ // 8a. Prompt Hygiene Governor (v4.1 Phase 1): Relay Breaker ('relay-breaker') & Scope Brake ('vague-prompt-rubric')
1555
+ const relayOverride = resolveDetectorOverride(horizonConfig, 'relay-breaker');
1556
+ const relayEval = evaluateRelayBreaker({
1557
+ prompt: rawPrompt,
1558
+ relayState: inputData.relayState ?? sessionMeta.relayState,
1559
+ sourceCodeEditsInSession: Number(inputData.sourceCodeEditsInSession ?? (fileState.modifiedFiles || []).filter(p => !/\.md$/i.test(String(p || ''))).length),
1560
+ sourceCodeEditedSinceLastRelay: Boolean(inputData.sourceCodeEditedSinceLastRelay),
1561
+ priorTurnWebSearches: Number(inputData.priorTurnWebSearches ?? sessionMeta.priorTurnWebSearches ?? 0),
1562
+ zeroEditSessionTokens: Number(inputData.zeroEditSessionTokens ?? (((fileState.modifiedFiles || []).length === 0) ? tokens : 0)),
1563
+ boundSpecPath: inputData.boundSpecPath ?? sessionMeta.relayState?.boundSpecPath ?? null,
1564
+ overrideMode: relayOverride,
1565
+ flightMode,
1566
+ detectorId: 'DET-26'
1567
+ });
1568
+ sessionMeta.relayState = relayEval.relayStateSnapshot;
1569
+ if (relayEval.triggered) {
1570
+ sidecar.sessionMeta = sessionMeta;
1571
+ try {
1572
+ writeSidecarAtomicSync(conversationId, sidecar);
1573
+ } catch (err) {
1574
+ recordHookDiagnostic('pre_invocation', 'relayBreaker.writeSidecar', err);
1575
+ }
1576
+ if (relayEval.decision === 'block') {
1577
+ sessionMeta.blockedPrompts = Number(sessionMeta.blockedPrompts || 0) + 1;
1578
+ return {
1579
+ terminationBehavior: 'terminate',
1580
+ decision: 'block',
1581
+ detectorId: 'DET-26',
1582
+ subType: relayEval.subType,
1583
+ relayState: relayEval.nextState,
1584
+ userMessage: relayEval.tailInjection
1585
+ };
1586
+ }
1587
+ sessionMeta.steeredPrompts = Number(sessionMeta.steeredPrompts || 0) + 1;
1588
+ return {
1589
+ ephemeralMessage: relayEval.tailInjection,
1590
+ systemMessage: relayEval.tailInjection,
1591
+ detectorId: 'DET-26',
1592
+ subType: relayEval.subType,
1593
+ relayState: relayEval.nextState
1594
+ };
1595
+ }
1596
+
1597
+ const scopeOverride = resolveDetectorOverride(horizonConfig, 'vague-prompt-rubric');
1598
+ const scopeEval = evaluateScopeBrake({
1599
+ prompt: rawPrompt,
1600
+ provenance: inputData.provenance || inputData.source || 'user',
1601
+ isAutonomousTurn: Boolean(inputData.isAutonomousTurn || inputData.autonomous),
1602
+ isSubagent: Boolean(inputData.isSubagent || sessionMeta.isSubagent),
1603
+ isScheduledTask: Boolean(inputData.isScheduledTask),
1604
+ isLoopIteration: Boolean(inputData.isLoopIteration),
1605
+ priorTurnEditedFilesCount: Number(
1606
+ inputData.priorTurnEditedFilesCount ??
1607
+ (Array.isArray(sessionMeta.lastTurnEditedFiles) ? sessionMeta.lastTurnEditedFiles.length : 0)
1608
+ ),
1609
+ priorTurnSingleFileTarget: inputData.priorTurnSingleFileTarget ?? sessionMeta.priorTurnSingleFileTarget ?? null,
1610
+ priorTurnHadToolOrTestFailure: Boolean(
1611
+ inputData.priorTurnHadToolOrTestFailure ??
1612
+ sensors.lastTurnToolFailed ??
1613
+ sensors.threeStrikeLoop
1614
+ ),
1615
+ priorTurnAssistantAskedQuestion: Boolean(
1616
+ inputData.priorTurnAssistantAskedQuestion ?? sessionMeta.lastTurnAskedQuestion
1617
+ ),
1618
+ activeSetPaths: fileState.activeSetPaths || [],
1619
+ modifiedFiles: fileState.modifiedFiles || [],
1620
+ recentlyViewedFiles: fileState.recentlyViewedFiles || [],
1621
+ overrideMode: scopeOverride,
1622
+ flightMode,
1623
+ detectorId: 'DET-26'
1624
+ });
1625
+ if (scopeEval.triggered) {
1626
+ sessionMeta.unanchoredTurnFlag = true;
1627
+ sidecar.sessionMeta = sessionMeta;
1628
+ try {
1629
+ writeSidecarAtomicSync(conversationId, sidecar);
1630
+ } catch (err) {
1631
+ recordHookDiagnostic('pre_invocation', 'scopeBrake.writeSidecar', err);
1632
+ }
1633
+ if (scopeEval.decision === 'block') {
1634
+ sessionMeta.blockedPrompts = Number(sessionMeta.blockedPrompts || 0) + 1;
1635
+ return {
1636
+ terminationBehavior: 'terminate',
1637
+ decision: 'block',
1638
+ detectorId: 'DET-26',
1639
+ subType: scopeEval.subType,
1640
+ userMessage: scopeEval.blockReason
1641
+ };
1642
+ }
1643
+ sessionMeta.steeredPrompts = Number(sessionMeta.steeredPrompts || 0) + 1;
1644
+ return {
1645
+ ephemeralMessage: scopeEval.steerContext,
1646
+ systemMessage: scopeEval.steerContext,
1647
+ detectorId: 'DET-26',
1648
+ subType: scopeEval.subType,
1649
+ candidateFiles: scopeEval.candidateFiles
1650
+ };
1651
+ }
1652
+ sessionMeta.unanchoredTurnFlag = false;
1653
+
1654
+ // 8b. HALT_REWRITE_SCORECARD (Explicit #check or Cold Session Vague Multi-File Prompt)
1655
+ const isColdSession = turnCount <= (config.cold_session_max_turns || 3);
1656
+ const promptSufficiency = scorePromptSufficiency(rawPrompt, { activeSetPaths: fileState.activeSetPaths });
1657
+ const isArchitecturalVague = promptSufficiency.score <= 4 &&
1658
+ /\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);
1659
+ const isVagueMultiFile = (/(refactor everything|fix all|update the whole project|caching)/i.test(rawPrompt) || isArchitecturalVague) && !rawPrompt.includes('@');
1660
+
1661
+ // Ground rule: "Short prompts are not bad by default" - concise scoped instructions shouldn't trigger vague halt
1662
+ if (hasCheckTag || (isColdSession && isVagueMultiFile && (!promptSufficiency.shortPrompt || isArchitecturalVague))) {
1663
+ const cleanedPrompt = rawPrompt.replace(/#check\b/gi, '').trim();
1664
+ const recommendedModel = tokens > 50000 ? deepModel : fastModel;
1665
+ const recommendedEffort = isComplexTopic ? 'high' : 'medium';
1666
+ const rawTargetHint = (fileState.activeSetPaths && fileState.activeSetPaths[0]) || '';
1667
+ const targetHint = (rawTargetHint ? toWorkspaceRelativePath(rawTargetHint, sidecar.workspacePath || process.cwd()) : '') || '<target-file>';
1668
+ const missingSnippet = promptSufficiency.missing.length > 0 ? ` | Missing: ${promptSufficiency.missing[0]}` : '';
1669
+
1670
+ const rewriteSuggestion = promptSufficiency.missing.includes('testability & expected outcome')
1671
+ ? `"In @${targetHint}, ${cleanedPrompt || 'implement updates'} and run automated tests to verify"`
1672
+ : `"In @${targetHint}, ${cleanedPrompt || 'implement surgical updates with unit test'}"`;
1673
+
1674
+ const card = formatScorecard(
1675
+ `[Sufficiency ${promptSufficiency.score}/12 ${promptSufficiency.band}]${missingSnippet}`,
1676
+ `[Purity: ${purity}% | Sludge: +$${(telemetry.sludgeTaxUsdPerTurn || 0).toFixed(2)}/t | Tokens: ${Math.round(tokens / 1000)}k]`,
1677
+ `/model ${recommendedModel} • /effort ${recommendedEffort}`,
1678
+ rewriteSuggestion
1679
+ );
1680
+ const vagueRes = applyHabitOverride('vague-prompt-rubric', 'REWRITE_SCORECARD', card);
1681
+ if (vagueRes) {
1682
+ if (!vagueRes.terminationBehavior && vagueRes.decision !== 'block') flushSidecarOnce();
1683
+ return vagueRes;
1684
+ }
1685
+ }
1686
+
1687
+ const hasTurn1Workspace = Boolean(
1688
+ inputData.cwd ||
1689
+ inputData.workspacePath ||
1690
+ (Array.isArray(inputData.workspacePaths) && inputData.workspacePaths.length > 0) ||
1691
+ inputData.enableTurn1Contract
1692
+ );
1693
+ if (hasTurn1Workspace && resolveDetectorOverride(horizonConfig, 'turn1-contract-gate') !== 'off') {
1694
+ const contractEval = evaluateTurn1ContractGate({
1695
+ prompt: rawPrompt,
1696
+ provenance: inputData.provenance || inputData.source || 'user',
1697
+ isAutonomousTurn: Boolean(inputData.isAutonomousTurn || inputData.autonomous),
1698
+ isSubagent: Boolean(inputData.isSubagent || sessionMeta.isSubagent),
1699
+ isScheduledTask: Boolean(inputData.isScheduledTask),
1700
+ isLoopIteration: Boolean(inputData.isLoopIteration),
1701
+ inPlanMode: Boolean(sessionMeta.inPlanMode || inputData.inPlanMode),
1702
+ turnNumber: effectiveTurnNumber,
1703
+ invocationNum: Number(inputData.invocationNum ?? 1),
1704
+ alreadyInjected: Boolean(sessionMeta.turn1ContractInjected),
1705
+ hasActiveSetMatch,
1706
+ sufficiency: promptSufficiency,
1707
+ overrideMode: resolveDetectorOverride(horizonConfig, 'turn1-contract-gate'),
1708
+ flightMode,
1709
+ detectorId: 'DET-26'
1710
+ });
1711
+ if (contractEval.triggered) {
1712
+ sessionMeta.turn1ContractInjected = true;
1713
+ sessionMeta.lastUserPrompt = rawPrompt;
1714
+ sidecar.sessionMeta = sessionMeta;
1715
+ try {
1716
+ writeSidecarAtomicSync(conversationId, sidecar);
1717
+ } catch (err) {
1718
+ recordHookDiagnostic('pre_invocation', 'turn1Contract.writeSidecar', err);
1719
+ }
1720
+ return {
1721
+ ephemeralMessage: contractEval.contractDirective,
1722
+ systemMessage: contractEval.contractDirective,
1723
+ detectorId: 'DET-26',
1724
+ subType: contractEval.subType
1725
+ };
1726
+ }
1727
+ }
1728
+
1729
+ if (rawPrompt && (inputData.cwd || inputData.workspacePath)) {
1730
+ sessionMeta.lastUserPrompt = rawPrompt;
1731
+ sidecar.sessionMeta = sessionMeta;
1732
+ }
1733
+
1734
+ if (rawPrompt && inputData.bucketBShadow !== false) {
1735
+ try {
1736
+ const isAutonomousOrSubagent = Boolean(
1737
+ inputData.isAutonomousTurn ||
1738
+ inputData.autonomous ||
1739
+ inputData.isSubagent ||
1740
+ sessionMeta.isSubagent ||
1741
+ inputData.isScheduledTask ||
1742
+ inputData.isLoopIteration ||
1743
+ /^(?:scheduled|cron|loop|subagent|agent_callback|callback|auto|autonomous|background|system|hook|task_notification|wake)$/i.test(
1744
+ String(inputData.provenance || inputData.source || '')
1745
+ )
1746
+ );
1747
+ const cachedDirtyFiles = Array.isArray(inputData.cachedDirtyFiles)
1748
+ ? inputData.cachedDirtyFiles
1749
+ : [
1750
+ ...(fileState.modifiedFiles || []),
1751
+ ...(Array.isArray(fileState.unverifiedEdits)
1752
+ ? fileState.unverifiedEdits.map((e) => e?.filePath)
1753
+ : [])
1754
+ ];
1755
+ const promptAnchor = runBucketBPromptPass({
1756
+ platform: 'antigravity',
1757
+ sessionId: conversationId,
1758
+ cwd: workspacePath,
1759
+ hasExplicitCwd: Boolean(inputData.cwd || inputData.workspacePath),
1760
+ prompt: rawPrompt,
1761
+ isAutonomousOrSubagent,
1762
+ cachedDirtyFiles,
1763
+ lastFailingLocation:
1764
+ inputData.lastFailingLocation ?? sessionMeta.lastFailingLocation ?? '',
1765
+ options: {
1766
+ bucketBStage: inputData.bucketBStage,
1767
+ bucketBGammaStage: inputData.bucketBGammaStage,
1768
+ mode: flightMode,
1769
+ horizonConfig
1770
+ }
1771
+ });
1772
+ if (promptAnchor.triggered) {
1773
+ flushSidecarOnce();
1774
+ return {
1775
+ ephemeralMessage: promptAnchor.reason,
1776
+ systemMessage: promptAnchor.reason,
1777
+ anchorContext: promptAnchor.anchorContext,
1778
+ detectorId: 'VAGUE_PROMPT_ANCHOR'
1779
+ };
1780
+ }
1781
+ } catch (err) {
1782
+ recordHookDiagnostic('pre_invocation', 'handlePreInvocation.bucketBPromptPass', err, { persist: false });
1783
+ }
1784
+ }
1785
+
1786
+ flushSidecarOnce();
1787
+ return {};
1788
+ }
1789
+
1790
+ /**
1791
+ * Sanitizes internal hook return payloads into strict Antigravity protojson-compatible
1792
+ * CLI stdout objects (no unknown fields like flightMode, active_model_id, swarmTtlBadges).
1793
+ */
1794
+ export function toProtoSafePreHookOutput(output, { isPreToolUse = false } = {}) {
1795
+ const out = output && typeof output === 'object' ? output : {};
1796
+ if (isPreToolUse) {
1797
+ const rawDecision = String(out.decision || '').toLowerCase();
1798
+ let decision = 'allow';
1799
+ if (rawDecision === 'deny' || rawDecision === 'block' || out.blocked === true || out.terminationBehavior === 'terminate') {
1800
+ decision = 'deny';
1801
+ } else if (rawDecision === 'ask') {
1802
+ decision = 'ask';
1803
+ }
1804
+ const reasonText = out.reason || out.errorMessage?.userMessage || out.userMessage || out.systemMessage || out.ephemeralMessage;
1805
+ if (decision !== 'allow' && reasonText) {
1806
+ return { decision, reason: String(reasonText) };
1807
+ }
1808
+ return { decision };
1809
+ }
1810
+
1811
+ if (out.terminationBehavior === 'terminate') {
1812
+ const userMessage = String(
1813
+ out.errorMessage?.userMessage ||
1814
+ out.userMessage ||
1815
+ out.reason ||
1816
+ out.systemMessage ||
1817
+ 'Halted by Highbeam Flightcheck'
1818
+ );
1819
+ return {
1820
+ terminationBehavior: 'terminate',
1821
+ errorMessage: { userMessage }
1822
+ };
1823
+ }
1824
+ const advisory = out.ephemeralMessage || out.systemMessage;
1825
+ if (typeof advisory === 'string' && advisory.trim().length > 0) {
1826
+ return { ephemeralMessage: advisory };
1827
+ }
1828
+ return {};
1829
+ }
1830
+