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
@@ -5,13 +5,20 @@
5
5
  */
6
6
 
7
7
  import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
8
+ import { resolveEffectiveAutoFlightMode } from '../../src/core/pro_license.mjs';
8
9
  import { isSilentOrOffMode } from '../../src/core-isomorphic/coach/cacheGravityRouter.mjs';
10
+ import { evaluateSmartCompactSuggestion } from '../../src/core-isomorphic/coach/smartCompactAdvisor.mjs';
11
+ import { computeActiveToolsetHash } from '../../src/core-isomorphic/coach/resumeToolsetAuditor.mjs';
12
+ import { readLiveStateSnapshot } from '../../src/core-isomorphic/telemetry/telemetryBridge.mjs';
13
+ import { updateSessionCalibrationOnStop } from '../../src/utils/sessionCalibration.mjs';
9
14
  import {
10
15
  evaluateDet14PrematureStopGate,
11
16
  evaluateDet15BatchedStopFormatter,
12
17
  readBreakerStateSnapshot,
13
18
  writeBreakerStateSnapshot
14
19
  } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
20
+ import { runBucketBStopPass } from '../../src/core/bucket_b_runtime.mjs';
21
+ import { handleClaudeRslHook } from '../../src/hooks/claude_rsl_hook.mjs';
15
22
  import {
16
23
  isCliEntrypoint,
17
24
  readStdinJsonAsync,
@@ -34,8 +41,18 @@ export function runStopGateHook(event = {}, options = {}) {
34
41
  const sessionId = event.session_id || event.sessionId || 'default';
35
42
  const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
36
43
  const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
37
- const effectiveMode = options.mode || event.mode || horizonConfig?.flightMode || 'COACH';
44
+ const rawEffectiveMode = options.mode || event.mode || horizonConfig?.flightMode || 'COACH';
45
+ const modeGate = resolveEffectiveAutoFlightMode(rawEffectiveMode, {
46
+ licensePath: options.licensePath || event.licensePath,
47
+ homeDir: options.homeDir || event.homeDir,
48
+ nowMs: options.nowMs,
49
+ strict: Boolean(options.strict ?? event.strict)
50
+ });
51
+ const effectiveMode = modeGate.effectiveFlightMode;
38
52
  const stopHookActive = Boolean(event.stop_hook_active ?? event.stopHookActive);
53
+ const isSessionEnd =
54
+ String(options.phase || event.phase || '').toLowerCase() === 'end' ||
55
+ event.hook_event_name === 'SessionEnd';
39
56
 
40
57
  const shouldPersistState =
41
58
  options.persistState !== false &&
@@ -45,6 +62,97 @@ export function runStopGateHook(event = {}, options = {}) {
45
62
  ? readBreakerStateSnapshot(sessionId, cwdOptions)
46
63
  : null;
47
64
 
65
+ const rawBgTasks =
66
+ event.active_background_tasks ??
67
+ event.activeBackgroundTasks ??
68
+ event.backgroundTasks ??
69
+ breakerSnap?.activeBackgroundTasks ??
70
+ [];
71
+ const activeBackgroundTasks = Array.isArray(rawBgTasks)
72
+ ? rawBgTasks
73
+ .filter(Boolean)
74
+ .map((t) => (typeof t === 'string' ? t : String(t?.id || t?.command || 'bg_task')))
75
+ : [];
76
+ const bgDrainWarning =
77
+ activeBackgroundTasks.length > 0 && !isSilentOrOffMode(effectiveMode)
78
+ ? `[Highbeam Quota Shield — Orphan Background Drain (#10)] ${activeBackgroundTasks.length} active background task(s) still running (${activeBackgroundTasks.slice(0, 3).join(', ')}). Terminate orphan daemons/watchers to prevent idle token & CPU drain.`
79
+ : null;
80
+
81
+ if (isSessionEnd) {
82
+ if (shouldPersistState) {
83
+ const liveEnd = options.telemetryState || readLiveStateSnapshot(sessionId, cwdOptions);
84
+ const endContextTokens = Number(
85
+ event.context_tokens ??
86
+ event.contextTokens ??
87
+ event.cached_tokens ??
88
+ event.cachedTokens ??
89
+ liveEnd?.contextWindow?.cachedTokens ??
90
+ breakerSnap?.lastContextTokens ??
91
+ 0
92
+ );
93
+ const endModelId = String(
94
+ event.model || event.modelId || liveEnd?.modelId || breakerSnap?.lastModelId || 'claude-sonnet-5-5'
95
+ );
96
+ const toolsetHash = computeActiveToolsetHash(event, cwdOptions);
97
+ writeBreakerStateSnapshot(
98
+ sessionId,
99
+ {
100
+ ...(breakerSnap || {}),
101
+ updatedAt: Date.now(),
102
+ ...(activeBackgroundTasks.length === 0 ? { activeBackgroundTasks: [] } : {}),
103
+ pending_downshift: null,
104
+ pendingDownshiftModel: null,
105
+ justCompacted: false,
106
+ lastToolsetHash: toolsetHash,
107
+ lastContextTokens: endContextTokens,
108
+ lastModelId: endModelId
109
+ },
110
+ cwdOptions
111
+ );
112
+ if (!stopHookActive && Boolean(event.cwd || options.cwd) && options.enableRsl !== false) {
113
+ try {
114
+ handleClaudeRslHook(event, { ...cwdOptions, event: 'SessionEnd' });
115
+ } catch {
116
+ // Fail open for RSL post-mortem
117
+ }
118
+ }
119
+ }
120
+ if (bgDrainWarning) {
121
+ const stdoutJson = { systemMessage: bgDrainWarning };
122
+ return {
123
+ exitCode: 0,
124
+ stdout: JSON.stringify(stdoutJson),
125
+ stdoutJson,
126
+ stderr: '',
127
+ activeBackgroundTasks,
128
+ bgDrainWarning
129
+ };
130
+ }
131
+ return {
132
+ exitCode: 0,
133
+ stdout: '',
134
+ stderr: '',
135
+ activeBackgroundTasks,
136
+ bgDrainWarning: null
137
+ };
138
+ }
139
+
140
+ const hasDirectOutput =
141
+ event.output_tokens !== undefined ||
142
+ event.outputTokens !== undefined ||
143
+ event.usage?.output_tokens !== undefined;
144
+ const shouldPersistCalibration =
145
+ options.persistCalibration !== false &&
146
+ Boolean(
147
+ event.transcript_path ||
148
+ event.transcriptPath ||
149
+ options.calibrationPath ||
150
+ (hasDirectOutput && (options.homeDir || event.cwd || options.cwd))
151
+ );
152
+ const sessionCalibration = shouldPersistCalibration
153
+ ? updateSessionCalibrationOnStop(event, cwdOptions)
154
+ : null;
155
+
48
156
  if (stopHookActive) {
49
157
  if (shouldPersistState && breakerSnap) {
50
158
  writeBreakerStateSnapshot(
@@ -55,6 +163,7 @@ export function runStopGateHook(event = {}, options = {}) {
55
163
  modifiedFilesInTurn: [],
56
164
  editedFiles: [],
57
165
  pendingFormatFiles: [],
166
+ turnFileDiffs: [],
58
167
  codeEditedSinceLastTest: false
59
168
  },
60
169
  cwdOptions
@@ -64,6 +173,7 @@ export function runStopGateHook(event = {}, options = {}) {
64
173
  exitCode: 0,
65
174
  stdout: '',
66
175
  stderr: '',
176
+ sessionCalibration,
67
177
  det14: {
68
178
  detectorId: 'DET-14',
69
179
  triggered: false,
@@ -154,38 +264,211 @@ export function runStopGateHook(event = {}, options = {}) {
154
264
  modifiedFiles: modifiedFilesForFormat
155
265
  });
156
266
 
157
- if (shouldPersistState && breakerSnap && det14.decision !== 'block') {
267
+ let stopPass = null;
268
+ if (
269
+ !isSessionEnd &&
270
+ !stopHookActive &&
271
+ det14.decision !== 'block' &&
272
+ String(effectiveMode).toUpperCase() !== 'OFF' &&
273
+ options.bucketBShadow !== false &&
274
+ event.bucketBShadow !== false
275
+ ) {
276
+ const turnFileDiffs = Array.isArray(event.fileDiffs)
277
+ ? event.fileDiffs
278
+ : Array.isArray(breakerSnap?.turnFileDiffs)
279
+ ? breakerSnap.turnFileDiffs
280
+ : [];
281
+ const lastUserPrompt = String(
282
+ event.lastUserPrompt ?? event.prompt ?? breakerSnap?.lastUserPrompt ?? ''
283
+ );
284
+ if (turnFileDiffs.length > 0) {
285
+ try {
286
+ stopPass = runBucketBStopPass({
287
+ platform: 'claude',
288
+ sessionId,
289
+ cwd: event.cwd || options.cwd || '',
290
+ hasExplicitCwd: Boolean(event.cwd || options.cwd),
291
+ fileDiffs: turnFileDiffs,
292
+ lastUserPrompt,
293
+ options: { ...options, mode: effectiveMode, horizonConfig }
294
+ });
295
+ } catch (_stopPassErr) {
296
+ stopPass = null;
297
+ }
298
+ }
299
+ }
300
+
301
+ const liveForStop =
302
+ shouldPersistState ||
303
+ event.smartCompactBoundarySuggest !== undefined ||
304
+ options.smartCompactBoundarySuggest !== undefined ||
305
+ horizonConfig?.thresholds?.smartCompactBoundarySuggest
306
+ ? (options.telemetryState || readLiveStateSnapshot(sessionId, cwdOptions))
307
+ : null;
308
+ const currentContextTokens = Number(
309
+ event.context_tokens ??
310
+ event.contextTokens ??
311
+ event.cached_tokens ??
312
+ event.cachedTokens ??
313
+ liveForStop?.contextWindow?.cachedTokens ??
314
+ breakerSnap?.lastContextTokens ??
315
+ 0
316
+ );
317
+ const currentModelId = String(
318
+ event.model ||
319
+ event.modelId ||
320
+ liveForStop?.modelId ||
321
+ breakerSnap?.lastModelId ||
322
+ 'claude-sonnet-5-5'
323
+ );
324
+ const effectiveTurnsSinceLastCompact =
325
+ event.turns_since_last_compact ??
326
+ event.turnsSinceLastCompact ??
327
+ breakerSnap?.turnsSinceLastCompact ??
328
+ null;
329
+ const boundaryReached = Boolean(
330
+ event.boundary_detected ?? event.boundaryDetected ?? breakerSnap?.turnBoundaryReached
331
+ );
332
+ const midDebugActive = Boolean(
333
+ event.mid_debug ??
334
+ event.midDebug ??
335
+ breakerSnap?.turnMidDebug ??
336
+ breakerSnap?.taskBoundaryState?.openFailure
337
+ );
338
+ const smartCompactSuggestion =
339
+ det14.decision === 'block' ||
340
+ stopPass?.decision === 'block' ||
341
+ isSilentOrOffMode(effectiveMode) ||
342
+ stopHookActive
343
+ ? { shouldSuggest: false, suppressedReason: 'blocked_or_silent', detectorStatus: 'verified', message: null }
344
+ : evaluateSmartCompactSuggestion(
345
+ {
346
+ enabled:
347
+ event.smartCompactBoundarySuggest ??
348
+ options.smartCompactBoundarySuggest ??
349
+ horizonConfig?.thresholds?.smartCompactBoundarySuggest ??
350
+ true,
351
+ detectorState: midDebugActive
352
+ ? 'mid_debug'
353
+ : boundaryReached
354
+ ? 'task_boundary'
355
+ : (event.detectorState || 'other'),
356
+ boundaryDetected: boundaryReached,
357
+ openFailure: Boolean(breakerSnap?.taskBoundaryState?.openFailure),
358
+ ...(event.boundary_detected === undefined && event.boundaryDetected === undefined
359
+ ? { editsSinceBoundary: Number(breakerSnap?.taskBoundaryState?.editsSinceBoundary || 0) }
360
+ : {}),
361
+ consecutiveFailures: Number(breakerSnap?.consecutiveFailures || 0),
362
+ turnsSinceLastCompact: effectiveTurnsSinceLastCompact,
363
+ modelId: currentModelId,
364
+ preCompactTokens: currentContextTokens,
365
+ cacheTtlTier: liveForStop?.promptCache?.ttlTier === '1h' ? '1h' : '5m',
366
+ expectedRemainingRequests:
367
+ event.expected_remaining_requests ?? event.expectedRemainingRequests,
368
+ expectedRemainingTurns:
369
+ event.expected_remaining_turns ??
370
+ event.expectedRemainingTurns ??
371
+ horizonConfig?.expectedRemainingTurns,
372
+ turnsCompleted: sessionCalibration?.turnsCompleted ?? liveForStop?.turnsCompleted ?? 0,
373
+ apiCallsCompleted: sessionCalibration?.apiCallsCompleted,
374
+ requestsPerTurn:
375
+ event.requests_per_turn ??
376
+ event.requestsPerTurn ??
377
+ sessionCalibration?.requestsPerTurn,
378
+ contextGrowthPerTurn: sessionCalibration?.rollingMedianPromptGrowthTokens,
379
+ contextCeiling: liveForStop?.contextWindow?.contextCeiling
380
+ },
381
+ { ...cwdOptions, horizonConfig }
382
+ );
383
+
384
+ if (shouldPersistState && det14.decision !== 'block') {
385
+ const nextTurnsSinceCompact = smartCompactSuggestion.shouldSuggest
386
+ ? 1
387
+ : (typeof breakerSnap?.turnsSinceLastCompact === 'number' &&
388
+ Number.isFinite(breakerSnap.turnsSinceLastCompact)
389
+ ? breakerSnap.turnsSinceLastCompact + 1
390
+ : null);
391
+ const toolsetHash =
392
+ event.cwd || cwdOptions.cwd || event.tools || event.mcp_servers || options.cliArgs || event.cliArgs
393
+ ? computeActiveToolsetHash(event, cwdOptions)
394
+ : (breakerSnap?.lastToolsetHash || null);
158
395
  writeBreakerStateSnapshot(
159
396
  sessionId,
160
397
  {
161
- ...breakerSnap,
398
+ ...(breakerSnap || {}),
162
399
  updatedAt: Date.now(),
163
400
  modifiedFilesInTurn: [],
164
401
  editedFiles: [],
165
402
  pendingFormatFiles: [],
166
- codeEditedSinceLastTest: false
403
+ turnFileDiffs: [],
404
+ codeEditedSinceLastTest: false,
405
+ justCompacted: false,
406
+ turnBoundaryReached: false,
407
+ turnMidDebug: false,
408
+ ...(nextTurnsSinceCompact !== null ? { turnsSinceLastCompact: nextTurnsSinceCompact } : {}),
409
+ ...(toolsetHash ? { lastToolsetHash: toolsetHash } : {}),
410
+ lastContextTokens: currentContextTokens,
411
+ lastModelId: currentModelId
167
412
  },
168
413
  cwdOptions
169
414
  );
415
+ if (!stopHookActive && Boolean(event.cwd || options.cwd) && options.enableRsl !== false) {
416
+ try {
417
+ handleClaudeRslHook(event, { ...cwdOptions, event: 'Stop' });
418
+ } catch {
419
+ // Fail open for RSL post-mortem
420
+ }
421
+ }
170
422
  }
171
423
 
172
424
  if (det14.decision === 'block') {
425
+ const locSuffix = breakerSnap?.lastFailingLocation
426
+ ? ` (last failing location: ${breakerSnap.lastFailingLocation})`
427
+ : '';
428
+ const stdoutJson = {
429
+ decision: 'block',
430
+ reason: `${det14.reason}${locSuffix}`
431
+ };
432
+ return {
433
+ exitCode: 0,
434
+ stdout: JSON.stringify(stdoutJson),
435
+ stdoutJson,
436
+ stderr: '',
437
+ sessionCalibration,
438
+ det14,
439
+ det15,
440
+ smartCompactSuggestion,
441
+ activeBackgroundTasks
442
+ };
443
+ }
444
+
445
+ if (stopPass?.triggered && stopPass.decision === 'block') {
173
446
  const stdoutJson = {
174
447
  decision: 'block',
175
- reason: det14.reason
448
+ reason: stopPass.reason
176
449
  };
177
450
  return {
178
451
  exitCode: 0,
179
452
  stdout: JSON.stringify(stdoutJson),
180
453
  stdoutJson,
181
454
  stderr: '',
455
+ sessionCalibration,
182
456
  det14,
183
- det15
457
+ det15,
458
+ smartCompactSuggestion,
459
+ overengineeringGate: stopPass,
460
+ activeBackgroundTasks
184
461
  };
185
462
  }
186
463
 
187
- if (det14.advisory || det15.triggered) {
188
- const reasons = [det14.reason, det15.batchCommand ? `Batch format: ${det15.batchCommand}` : null]
464
+ if (det14.advisory || det15.triggered || bgDrainWarning || stopPass?.triggered || smartCompactSuggestion.shouldSuggest) {
465
+ const reasons = [
466
+ det14.advisory ? det14.reason : null,
467
+ det15.batchCommand ? `Batch format: ${det15.batchCommand}` : null,
468
+ bgDrainWarning,
469
+ stopPass?.triggered ? stopPass.reason : null,
470
+ smartCompactSuggestion.shouldSuggest ? smartCompactSuggestion.message : null
471
+ ]
189
472
  .filter(Boolean)
190
473
  .join(' | ');
191
474
  const stdoutJson = {
@@ -196,8 +479,12 @@ export function runStopGateHook(event = {}, options = {}) {
196
479
  stdout: JSON.stringify(stdoutJson),
197
480
  stdoutJson,
198
481
  stderr: '',
482
+ sessionCalibration,
199
483
  det14,
200
- det15
484
+ det15,
485
+ smartCompactSuggestion,
486
+ ...(stopPass ? { overengineeringGate: stopPass } : {}),
487
+ activeBackgroundTasks
201
488
  };
202
489
  }
203
490
 
@@ -205,13 +492,17 @@ export function runStopGateHook(event = {}, options = {}) {
205
492
  exitCode: 0,
206
493
  stdout: '',
207
494
  stderr: '',
495
+ sessionCalibration,
208
496
  det14,
209
- det15
497
+ det15,
498
+ smartCompactSuggestion,
499
+ ...(stopPass ? { overengineeringGate: stopPass } : {}),
500
+ activeBackgroundTasks
210
501
  };
211
502
  }
212
503
 
213
504
  /**
214
- * CLI runner for `Stop` (`ISS-035`).
505
+ * CLI runner for `Stop` and `SessionEnd` (`--phase=end`) (`ISS-035`).
215
506
  * Non-blocking lifecycle hook on uncaught internal error: logs diagnostic to stderr and exits `0`.
216
507
  *
217
508
  * @param {object} [cliOptions={}]
@@ -221,8 +512,15 @@ export async function executeStopGateCli(cliOptions = {}) {
221
512
  const runHook = cliOptions.runHook || runStopGateHook;
222
513
  const ioOverride = cliOptions.ioOverride || {};
223
514
  try {
515
+ const argv = cliOptions.argv || globalThis.process?.argv || [];
516
+ const phaseArg = argv.find((a) => String(a).startsWith('--phase='));
517
+ const explicitPhase = phaseArg ? String(phaseArg).split('=')[1] : undefined;
224
518
  const payload = await readPayload(cliOptions.timeoutMs);
225
- const res = runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
519
+ const res = runHook(payload, {
520
+ persistState: true,
521
+ ...(cliOptions.hookOptions || {}),
522
+ ...(explicitPhase ? { phase: explicitPhase } : {})
523
+ });
226
524
  if (res.stdout) {
227
525
  exitWithStdoutJson(res.stdout, ioOverride);
228
526
  } else {