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,726 @@
1
+ /**
2
+ * @file hooks/register.js
3
+ * In-process Mod entrypoint for Highbeam (attention-horizon-claude).
4
+ * Compliant with Claude Code Mod static analyzer rules:
5
+ * - Direct literal on('...') calls
6
+ * - No destructuring or variable assignment of $ or $.namespace
7
+ * - Never pass $ or $.* to any function (imported or module-local)
8
+ * - Pure ES modules, strictly relative imports, zero node:* or process.getBuiltinModule
9
+ * - Explicit .catch(...) fail-closed handlers resolving { decision: 'deny' } on tool.call guards
10
+ */
11
+
12
+ import {
13
+ createInitialTelemetryState,
14
+ ingestModTurnEvent,
15
+ writeLiveStateSnapshot
16
+ } from '@ctxtop/core/telemetry/telemetryBridge.mjs';
17
+ import { loadHorizonConfig } from '@ctxtop/core/config/horizonConfig.mjs';
18
+ import { normalizeFlightMode } from '@ctxtop/core/coach/cacheGravityRouter.mjs';
19
+ import { TtlWatchdog } from '@ctxtop/core/coach/ttlWatchdog.mjs';
20
+ import { CircuitBreakerEngine } from '@ctxtop/core/guards/circuitBreakers.mjs';
21
+ import {
22
+ handlePreCompactBatonFlush,
23
+ handleSessionStartHydration,
24
+ handlePostCompactFlush
25
+ } from '@ctxtop/core/coach/stateBatonHydrator.mjs';
26
+ import {
27
+ renderAbovePromptBand,
28
+ renderSimpleViewPane,
29
+ renderAdvancedViewPane,
30
+ renderSpinnerSuffix
31
+ } from '@ctxtop/core/ui/modViews.mjs';
32
+ import { recordRuntimeDiagnostic } from '@ctxtop/core/utils/runtime.mjs';
33
+ import { evaluateToolBoundaryLatch, CONTROL_STATES } from '@ctxtop/core/control/index.mjs';
34
+
35
+ const bootHorizonConfig = loadHorizonConfig();
36
+ const ttlWatchdog = new TtlWatchdog({ mode: bootHorizonConfig.flightMode || 'COACH' });
37
+ const breakerEngine = new CircuitBreakerEngine({
38
+ mode: bootHorizonConfig.flightMode || 'COACH',
39
+ horizonConfig: bootHorizonConfig
40
+ });
41
+
42
+ let stopWatchdogClock = null;
43
+ let modUnclippedReadCounts = Object.create(null);
44
+
45
+ /**
46
+ * Disposes any active `$.clock.every(1000)` interval handle so headless / completed
47
+ * sessions exit cleanly without dangling timers (`ISS-036`).
48
+ */
49
+ function clearWatchdogClock() {
50
+ const handle = stopWatchdogClock;
51
+ stopWatchdogClock = null;
52
+ if (!handle) return;
53
+ try {
54
+ if (typeof handle === 'function') {
55
+ handle();
56
+ } else if (typeof handle.cancel === 'function') {
57
+ handle.cancel();
58
+ } else if (typeof handle.dispose === 'function') {
59
+ handle.dispose();
60
+ } else if (typeof handle.stop === 'function') {
61
+ handle.stop();
62
+ }
63
+ } catch (err) {
64
+ recordRuntimeDiagnostic('hooks/register.js', 'clearWatchdogClock', err);
65
+ }
66
+ }
67
+
68
+ /**
69
+ * Detects non-interactive / headless print mode (`claude -p`) from a plain event payload.
70
+ * @param {object} event
71
+ * @returns {boolean}
72
+ */
73
+ function isHeadlessEvent(event) {
74
+ return Boolean(
75
+ event?.headless ||
76
+ event?.printMode ||
77
+ event?.nonInteractive ||
78
+ event?.isHeadless ||
79
+ globalThis.process?.env?.CLAUDE_HEADLESS === '1'
80
+ );
81
+ }
82
+
83
+ /**
84
+ * Resolves the active flight mode from event overrides, `.attention-horizon.json` (when `cwd`
85
+ * is present), or persisted store state, synchronizing `breakerEngine` and `ttlWatchdog` (`ISS-038`).
86
+ *
87
+ * @param {object} event
88
+ * @param {string | undefined | null} storedMode
89
+ * @returns {string}
90
+ */
91
+ function resolveActiveModFlightMode(event, storedMode) {
92
+ if (event?.mode) {
93
+ const explicitMode = normalizeFlightMode(event.mode);
94
+ breakerEngine.setMode(explicitMode);
95
+ ttlWatchdog.setMode(explicitMode);
96
+ return explicitMode;
97
+ }
98
+ if (typeof event?.cwd === 'string' && event.cwd.trim()) {
99
+ const cfg = breakerEngine.refreshConfig({ cwd: event.cwd });
100
+ const cfgMode = normalizeFlightMode(cfg?.flightMode || 'COACH');
101
+ ttlWatchdog.setMode(cfgMode);
102
+ return cfgMode;
103
+ }
104
+ if (storedMode) {
105
+ const normStored = normalizeFlightMode(storedMode);
106
+ breakerEngine.setMode(normStored);
107
+ ttlWatchdog.setMode(normStored);
108
+ return normStored;
109
+ }
110
+ return breakerEngine.mode || 'COACH';
111
+ }
112
+
113
+ /**
114
+ * Extracts a target workspace file path from a tool or file-change event.
115
+ * @param {object} event
116
+ * @returns {string}
117
+ */
118
+ function extractModEventFilePath(event) {
119
+ const input = event?.tool_input || event?.toolInput || {};
120
+ return String(
121
+ input.file_path ||
122
+ input.notebook_path ||
123
+ input.filePath ||
124
+ input.path ||
125
+ event?.filePath ||
126
+ event?.file_path ||
127
+ event?.path ||
128
+ ''
129
+ );
130
+ }
131
+
132
+ /**
133
+ * Checks whether a `tool.call` event mutates a workspace file (`Edit|MultiEdit|Write|NotebookEdit`).
134
+ * @param {object} event
135
+ * @returns {boolean}
136
+ */
137
+ function isWorkspaceEditToolEvent(event) {
138
+ const name = String(event?.tool_name || event?.toolName || '').toLowerCase();
139
+ return (
140
+ name === 'edit' ||
141
+ name === 'multiedit' ||
142
+ name === 'write' ||
143
+ name === 'notebookedit'
144
+ );
145
+ }
146
+
147
+ /**
148
+ * Checks whether a `tool.call` event commits or verifies workspace changes (`git commit` or test runner),
149
+ * clearing the pending-edits flag.
150
+ * @param {object} event
151
+ * @returns {boolean}
152
+ */
153
+ function shouldClearRecentEditsOnToolEvent(event) {
154
+ const name = String(event?.tool_name || event?.toolName || '').toLowerCase();
155
+ if (
156
+ name !== 'bash' &&
157
+ name !== 'powershell' &&
158
+ name !== 'pwsh' &&
159
+ name !== 'cmd' &&
160
+ name !== 'sh'
161
+ ) {
162
+ return false;
163
+ }
164
+ const input = event?.tool_input || event?.toolInput || {};
165
+ const cmd = String(input.command || input.cmd || event?.command || '');
166
+ return (
167
+ /\bgit\s+commit\b/i.test(cmd) ||
168
+ /\b(?:npm\s+test|npm\s+run\s+test|pnpm\s+(?:run\s+)?test|yarn\s+test|bun\s+test|vitest|jest|pytest|cargo\s+test|go\s+test|node\s+--test|tsc(?:\s|$)|npx\s+tsc)\b/i.test(
169
+ cmd
170
+ )
171
+ );
172
+ }
173
+
174
+ function didDownstreamToolResultFail(result) {
175
+ if (!result || typeof result !== 'object') return false;
176
+ if (
177
+ result.is_error === true ||
178
+ result.isError === true ||
179
+ result.succeeded === false ||
180
+ result.status === 'error' ||
181
+ result.status === 'failed' ||
182
+ Boolean(result.error)
183
+ ) {
184
+ return true;
185
+ }
186
+ if (typeof result.exit_code === 'number' && result.exit_code !== 0) return true;
187
+ if (typeof result.exitCode === 'number' && result.exitCode !== 0) return true;
188
+ return false;
189
+ }
190
+
191
+ /**
192
+ * Main Mod registration function.
193
+ * @param {Function} on - Claude Code event registration callback
194
+ */
195
+ export default function register(on) {
196
+ clearWatchdogClock();
197
+ ttlWatchdog.clearRecentEdits();
198
+ modUnclippedReadCounts = Object.create(null);
199
+ breakerEngine.hydrateStateSnapshot({
200
+ consecutiveFailures: 0,
201
+ lastFailedToolKey: '',
202
+ sequentialSearchCount: 0,
203
+ fileHashHistory: {},
204
+ modifiedFilesInTurn: [],
205
+ pendingFormatFiles: [],
206
+ codeEditedSinceLastTest: false,
207
+ subagentTurns: {},
208
+ subagentTokens: {},
209
+ pendingBatchEdits: 0
210
+ });
211
+
212
+ on('file.changed', async (event, $) => {
213
+ try {
214
+ const changedPath = extractModEventFilePath(event);
215
+ ttlWatchdog.recordFileChanged(changedPath, Date.now());
216
+ $.store.set('ah_recent_file_changed', true);
217
+ } catch (err) {
218
+ recordRuntimeDiagnostic(
219
+ 'hooks/register.js',
220
+ 'file.changed',
221
+ err,
222
+ event?.cwd ? { cwd: event.cwd } : {}
223
+ );
224
+ }
225
+ });
226
+
227
+ on('tool.call', (event, $, next) => {
228
+ return Promise.resolve()
229
+ .then(async () => {
230
+ const storedControl = $.store.get('ah_control_state');
231
+ if (storedControl) {
232
+ const latch = evaluateToolBoundaryLatch(storedControl);
233
+ if (latch.decision === 'deny') {
234
+ $.store.set('ah_last_breaker_verdict', { triggered: true, detectorId: 'CONTROL_ABORT', reason: latch.reason });
235
+ $.ui.invalidate('ui.render');
236
+ return {
237
+ decision: 'deny',
238
+ reason: latch.reason || 'Session aborted by user'
239
+ };
240
+ }
241
+ if (latch.decision === 'allow' && latch.consumeStep) {
242
+ $.store.set('ah_control_state', { ...storedControl, state: CONTROL_STATES.PAUSED, stepRemaining: 0, updatedAt: Date.now() });
243
+ }
244
+ }
245
+
246
+ const storedMode = $.store.get('ah_flight_mode');
247
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
248
+ $.store.set('ah_flight_mode', activeMode);
249
+
250
+ const telemetry =
251
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
252
+ const verdict = breakerEngine.evaluatePreToolUse(
253
+ { ...event, mode: event?.mode || activeMode },
254
+ telemetry
255
+ );
256
+
257
+ if (verdict.triggered && verdict.decision === 'deny') {
258
+ $.store.set('ah_last_breaker_verdict', verdict);
259
+ $.ui.invalidate('ui.render');
260
+ return {
261
+ decision: 'deny',
262
+ reason: verdict.reason || 'Blocked by Highbeam circuit breaker'
263
+ };
264
+ }
265
+
266
+ if (verdict.triggered && (verdict.decision === 'ask' || verdict.decision === 'defer')) {
267
+ $.store.set('ah_last_breaker_verdict', verdict);
268
+ $.ui.invalidate('ui.render');
269
+ return {
270
+ decision: verdict.decision === 'defer' ? 'defer' : 'ask',
271
+ reason: verdict.reason || 'Confirmation required by Highbeam'
272
+ };
273
+ }
274
+
275
+ const isEditEvent = isWorkspaceEditToolEvent(event);
276
+ const isClearCandidate = !isEditEvent && shouldClearRecentEditsOnToolEvent(event);
277
+ if (isEditEvent) {
278
+ ttlWatchdog.recordFileChanged(extractModEventFilePath(event), Date.now());
279
+ $.store.set('ah_recent_file_changed', true);
280
+ $.store.set('ah_turn_mutations', (Number($.store.get('ah_turn_mutations')) || 0) + 1);
281
+ }
282
+
283
+ let repeatReadAdvisory = '';
284
+ const tName = String(event?.tool_name || event?.toolName || '');
285
+ const tArgs = event?.tool_input || event?.toolInput || {};
286
+ const cmdStr = String(tArgs.command || tArgs.cmd || event?.command || '');
287
+ if (
288
+ activeMode !== 'OFF' &&
289
+ /^(Read|read_file)$/i.test(tName) &&
290
+ tArgs.offset === undefined &&
291
+ tArgs.limit === undefined &&
292
+ tArgs.StartLine === undefined &&
293
+ tArgs.EndLine === undefined
294
+ ) {
295
+ const readTarget = extractModEventFilePath(event);
296
+ if (readTarget) {
297
+ const normReadKey = readTarget.replace(/\\/g, '/').toLowerCase();
298
+ const nextReadCount = (modUnclippedReadCounts[normReadKey] || 0) + 1;
299
+ modUnclippedReadCounts[normReadKey] = nextReadCount;
300
+ if (nextReadCount >= 3) {
301
+ repeatReadAdvisory = `[GUARD-4 Repeat-Read Surgeon] Unclipped Read #${nextReadCount} of ${readTarget} — pass offset/limit (or StartLine/EndLine) to prevent duplicate context bloat.`;
302
+ }
303
+ }
304
+ }
305
+
306
+ const finalizeDownstream = async () => {
307
+ const downstream = typeof next === 'function' ? await next(event) : undefined;
308
+ const failed = didDownstreamToolResultFail(downstream);
309
+ if (isClearCandidate && !failed) {
310
+ ttlWatchdog.clearRecentEdits();
311
+ $.store.set('ah_recent_file_changed', false);
312
+ $.store.set('ah_turn_mutations', (Number($.store.get('ah_turn_mutations')) || 0) + 1);
313
+ }
314
+ if (/^(bash|powershell|pwsh|cmd|sh)$/i.test(tName)) {
315
+ const outText =
316
+ typeof downstream === 'string'
317
+ ? downstream
318
+ : String(downstream?.stderr || downstream?.stdout || downstream?.output || '');
319
+ breakerEngine.recordVerificationOutcome({
320
+ succeeded: !failed,
321
+ command: cmdStr,
322
+ outputText: outText
323
+ });
324
+ }
325
+ return downstream;
326
+ };
327
+
328
+ if (verdict.triggered) {
329
+ $.store.set('ah_last_breaker_verdict', verdict);
330
+ $.ui.invalidate('ui.render');
331
+ const downstream = await finalizeDownstream();
332
+ return downstream ?? { additionalContext: verdict.reason };
333
+ }
334
+
335
+ if (repeatReadAdvisory) {
336
+ const downstream = await finalizeDownstream();
337
+ if (downstream && typeof downstream === 'object') {
338
+ return {
339
+ ...downstream,
340
+ additionalContext: downstream.additionalContext
341
+ ? `${downstream.additionalContext}\n${repeatReadAdvisory}`
342
+ : repeatReadAdvisory
343
+ };
344
+ }
345
+ return downstream ?? { additionalContext: repeatReadAdvisory };
346
+ }
347
+
348
+ if (typeof next === 'function') {
349
+ return await finalizeDownstream();
350
+ }
351
+ await finalizeDownstream();
352
+ return undefined;
353
+ })
354
+ .catch((err) => {
355
+ // ISS-031: Fail CLOSED on any uncaught or timed-out guard error (never re-throw!)
356
+ recordRuntimeDiagnostic(
357
+ 'hooks/register.js',
358
+ 'tool.call',
359
+ err,
360
+ event?.cwd ? { cwd: event.cwd } : {}
361
+ );
362
+ return {
363
+ decision: 'deny',
364
+ reason: `[Highbeam Fail-Closed] ${err?.message || String(err)}`
365
+ };
366
+ });
367
+ });
368
+
369
+ on('turn.step', async (event, $) => {
370
+ try {
371
+ const storedMode = $.store.get('ah_flight_mode');
372
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
373
+ $.store.set('ah_flight_mode', activeMode);
374
+
375
+ if (event?.fileChanged || event?.hasRecentWorkspaceEdits || isWorkspaceEditToolEvent(event)) {
376
+ ttlWatchdog.recordFileChanged(extractModEventFilePath(event), Date.now());
377
+ $.store.set('ah_recent_file_changed', true);
378
+ }
379
+
380
+ const current =
381
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
382
+ const updated = ingestModTurnEvent(current, {
383
+ ...event,
384
+ flightMode: event?.flightMode || event?.mode || activeMode,
385
+ turnMutations: Number($.store.get('ah_turn_mutations')) || 0,
386
+ type: 'turn.step'
387
+ });
388
+ $.store.set('ah_session_telemetry', updated);
389
+ writeLiveStateSnapshot(
390
+ updated.sessionId || 'default',
391
+ updated,
392
+ event?.cwd ? { cwd: event.cwd } : {}
393
+ );
394
+
395
+ if (
396
+ !isHeadlessEvent(event) &&
397
+ updated.promptCache?.warm &&
398
+ !$.store.get('ah_watchdog_clock_started')
399
+ ) {
400
+ $.store.set('ah_watchdog_clock_started', true);
401
+ stopWatchdogClock = $.clock.every(1000, () => {
402
+ try {
403
+ const state = $.store.get('ah_session_telemetry');
404
+ if (!state || !state.promptCache?.warm) {
405
+ clearWatchdogClock();
406
+ $.store.set('ah_watchdog_clock_started', false);
407
+ return;
408
+ }
409
+ const tick = ttlWatchdog.evaluateTick({
410
+ sessionId: state.sessionId,
411
+ modelId: state.modelId,
412
+ cacheWarm: state.promptCache.warm,
413
+ ttlTier: state.promptCache.ttlTier,
414
+ cachedTokens: state.contextWindow?.cachedTokens || 0,
415
+ totalPromptTokens: state.contextWindow?.totalInputTokens || 0,
416
+ expiresAt: state.promptCache.expiresAt,
417
+ hasRecentWorkspaceEdits: Boolean($.store.get('ah_recent_file_changed')),
418
+ mode: $.store.get('ah_flight_mode') || 'COACH'
419
+ });
420
+ $.store.set('ah_ttl_tick', tick);
421
+ if (tick.preSnapshotTriggered && tick.stateBatonSnapshot) {
422
+ $.store.set('ah_state_baton', tick.stateBatonSnapshot);
423
+ }
424
+ if (tick.amberAlertActive) {
425
+ $.ui.invalidate('ui.render');
426
+ }
427
+ if (tick.remainingSeconds <= 0) {
428
+ clearWatchdogClock();
429
+ $.store.set('ah_watchdog_clock_started', false);
430
+ }
431
+ } catch (err) {
432
+ recordRuntimeDiagnostic(
433
+ 'hooks/register.js',
434
+ 'turn.step.watchdogTick',
435
+ err,
436
+ event?.cwd ? { cwd: event.cwd } : {}
437
+ );
438
+ }
439
+ });
440
+ }
441
+ } catch (err) {
442
+ recordRuntimeDiagnostic(
443
+ 'hooks/register.js',
444
+ 'turn.step',
445
+ err,
446
+ event?.cwd ? { cwd: event.cwd } : {}
447
+ );
448
+ }
449
+ });
450
+
451
+ on('turn.complete', async (event, $) => {
452
+ try {
453
+ const turnId =
454
+ event?.turnId ||
455
+ event?.turn_id ||
456
+ event?.result?.turn_id ||
457
+ event?.result?.id ||
458
+ event?.message?.id ||
459
+ null;
460
+ if (turnId && $.store.get('ah_last_completed_turn_id') === turnId) {
461
+ return;
462
+ }
463
+ if (turnId) {
464
+ $.store.set('ah_last_completed_turn_id', turnId);
465
+ }
466
+
467
+ const storedMode = $.store.get('ah_flight_mode');
468
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
469
+ $.store.set('ah_flight_mode', activeMode);
470
+
471
+ ttlWatchdog.recordTurnTimestamp(Date.now());
472
+ const current =
473
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
474
+ const updated = ingestModTurnEvent(current, {
475
+ ...event,
476
+ flightMode: event?.flightMode || event?.mode || activeMode,
477
+ turnMutations: Number($.store.get('ah_turn_mutations')) || 0,
478
+ type: 'turn.complete'
479
+ });
480
+ $.store.set('ah_turn_mutations', 0);
481
+ $.store.set('ah_session_telemetry', updated);
482
+ writeLiveStateSnapshot(
483
+ updated.sessionId || 'default',
484
+ updated,
485
+ event?.cwd ? { cwd: event.cwd } : {}
486
+ );
487
+
488
+ if (isHeadlessEvent(event)) {
489
+ clearWatchdogClock();
490
+ $.store.set('ah_watchdog_clock_started', false);
491
+ } else if (updated.promptCache?.warm && !$.store.get('ah_watchdog_clock_started')) {
492
+ $.store.set('ah_watchdog_clock_started', true);
493
+ stopWatchdogClock = $.clock.every(1000, () => {
494
+ try {
495
+ const state = $.store.get('ah_session_telemetry');
496
+ if (!state || !state.promptCache?.warm) {
497
+ clearWatchdogClock();
498
+ $.store.set('ah_watchdog_clock_started', false);
499
+ return;
500
+ }
501
+ const tick = ttlWatchdog.evaluateTick({
502
+ sessionId: state.sessionId,
503
+ modelId: state.modelId,
504
+ cacheWarm: state.promptCache.warm,
505
+ ttlTier: state.promptCache.ttlTier,
506
+ cachedTokens: state.contextWindow?.cachedTokens || 0,
507
+ totalPromptTokens: state.contextWindow?.totalInputTokens || 0,
508
+ expiresAt: state.promptCache.expiresAt,
509
+ hasRecentWorkspaceEdits: Boolean($.store.get('ah_recent_file_changed')),
510
+ mode: $.store.get('ah_flight_mode') || 'COACH'
511
+ });
512
+ $.store.set('ah_ttl_tick', tick);
513
+ if (tick.preSnapshotTriggered && tick.stateBatonSnapshot) {
514
+ $.store.set('ah_state_baton', tick.stateBatonSnapshot);
515
+ }
516
+ if (tick.amberAlertActive) {
517
+ $.ui.invalidate('ui.render');
518
+ }
519
+ if (tick.remainingSeconds <= 0) {
520
+ clearWatchdogClock();
521
+ $.store.set('ah_watchdog_clock_started', false);
522
+ }
523
+ } catch (err) {
524
+ recordRuntimeDiagnostic(
525
+ 'hooks/register.js',
526
+ 'turn.complete.watchdogTick',
527
+ err,
528
+ event?.cwd ? { cwd: event.cwd } : {}
529
+ );
530
+ }
531
+ });
532
+ }
533
+
534
+ $.ui.invalidate('ui.render');
535
+ } catch (err) {
536
+ recordRuntimeDiagnostic(
537
+ 'hooks/register.js',
538
+ 'turn.complete',
539
+ err,
540
+ event?.cwd ? { cwd: event.cwd } : {}
541
+ );
542
+ }
543
+ });
544
+
545
+ on('classic.PreCompact', async (event, $) => {
546
+ try {
547
+ const flushRes = handlePreCompactBatonFlush(
548
+ event,
549
+ event?.cwd ? { cwd: event.cwd } : {}
550
+ );
551
+ $.store.set('ah_state_baton', flushRes.baton);
552
+ } catch (err) {
553
+ recordRuntimeDiagnostic(
554
+ 'hooks/register.js',
555
+ 'classic.PreCompact',
556
+ err,
557
+ event?.cwd ? { cwd: event.cwd } : {}
558
+ );
559
+ }
560
+ });
561
+
562
+ on('classic.SessionStart', async (event, $) => {
563
+ try {
564
+ const storedMode = $.store.get('ah_flight_mode');
565
+ const activeMode = resolveActiveModFlightMode(event, storedMode);
566
+ $.store.set('ah_flight_mode', activeMode);
567
+
568
+ const hydrated = handleSessionStartHydration(
569
+ event,
570
+ event?.cwd ? { cwd: event.cwd } : {}
571
+ );
572
+ if (hydrated.hydrated && hydrated.baton) {
573
+ $.store.set('ah_state_baton', hydrated.baton);
574
+ }
575
+ } catch (err) {
576
+ recordRuntimeDiagnostic(
577
+ 'hooks/register.js',
578
+ 'classic.SessionStart',
579
+ err,
580
+ event?.cwd ? { cwd: event.cwd } : {}
581
+ );
582
+ }
583
+ });
584
+
585
+ on('classic.PostCompact', async (event, $) => {
586
+ try {
587
+ const postRes = handlePostCompactFlush(event, {
588
+ ...(event?.cwd ? { cwd: event.cwd } : {}),
589
+ mutationQueue: breakerEngine.router.mutationQueue
590
+ });
591
+ ttlWatchdog.clearRecentEdits();
592
+ $.store.set('ah_recent_file_changed', false);
593
+ $.store.set('ah_last_post_compact', postRes);
594
+ $.ui.invalidate('ui.render');
595
+ } catch (err) {
596
+ recordRuntimeDiagnostic(
597
+ 'hooks/register.js',
598
+ 'classic.PostCompact',
599
+ err,
600
+ event?.cwd ? { cwd: event.cwd } : {}
601
+ );
602
+ }
603
+ });
604
+
605
+ on('classic.Stop', async (event, $) => {
606
+ try {
607
+ clearWatchdogClock();
608
+ $.store.set('ah_watchdog_clock_started', false);
609
+ } catch (err) {
610
+ recordRuntimeDiagnostic(
611
+ 'hooks/register.js',
612
+ 'classic.Stop',
613
+ err,
614
+ event?.cwd ? { cwd: event.cwd } : {}
615
+ );
616
+ }
617
+ });
618
+
619
+ on('command.horizon', async (event, $) => {
620
+ try {
621
+ const rawArgs = String(event?.args || event?.subcommand || event?.viewMode || '').toLowerCase();
622
+ if (rawArgs.includes('advanced')) {
623
+ $.store.set('ah_pane_view_mode', 'advanced');
624
+ } else if (rawArgs.includes('simple')) {
625
+ $.store.set('ah_pane_view_mode', 'simple');
626
+ }
627
+ $.ui.open({
628
+ id: 'attention-horizon',
629
+ title: 'Highbeam',
630
+ closeOnEscape: true
631
+ });
632
+ } catch (err) {
633
+ recordRuntimeDiagnostic(
634
+ 'hooks/register.js',
635
+ 'command.horizon',
636
+ err,
637
+ event?.cwd ? { cwd: event.cwd } : {}
638
+ );
639
+ }
640
+ });
641
+
642
+ on('ui.render', async (event, $, next) => {
643
+ try {
644
+ const component = event?.component || event?.surface || 'AbovePrompt';
645
+
646
+ if (component === 'Pane' && event?.id !== 'attention-horizon') {
647
+ return typeof next === 'function' ? await next(event) : undefined;
648
+ }
649
+
650
+ const telemetry =
651
+ $.store.get('ah_session_telemetry') || createInitialTelemetryState('default');
652
+ const renderOptions = {
653
+ nowMs: event?.nowMs,
654
+ maxCols: event?.maxCols || event?.columns,
655
+ noColor: event?.noColor,
656
+ forceColor: event?.forceColor,
657
+ ansi: event?.ansi,
658
+ flightMode: $.store.get('ah_flight_mode') || 'COACH',
659
+ ttlTick: $.store.get('ah_ttl_tick') || null,
660
+ breakerVerdict: $.store.get('ah_last_breaker_verdict') || null
661
+ };
662
+
663
+ if (component === 'Pane' && event?.id === 'attention-horizon') {
664
+ const requestedMode = String(
665
+ event?.viewMode || $.store.get('ah_pane_view_mode') || 'simple'
666
+ ).toLowerCase();
667
+ const pane =
668
+ requestedMode === 'advanced'
669
+ ? renderAdvancedViewPane(telemetry, renderOptions)
670
+ : requestedMode === '4-rank' || requestedMode === 'ranks'
671
+ ? renderSimpleViewPane(telemetry, { ...renderOptions, viewMode: 'SIMPLE_4_RANK' })
672
+ : renderSimpleViewPane(telemetry, renderOptions);
673
+ return {
674
+ ...pane,
675
+ content: pane.text
676
+ };
677
+ }
678
+
679
+ if (component === 'Spinner') {
680
+ const downstream = typeof next === 'function' ? await next(event) : '';
681
+ const spinner = renderSpinnerSuffix(telemetry, renderOptions);
682
+ const baseText =
683
+ typeof downstream === 'string'
684
+ ? downstream
685
+ : typeof downstream?.text === 'string'
686
+ ? downstream.text
687
+ : '';
688
+ return {
689
+ ...(typeof downstream === 'object' && downstream ? downstream : {}),
690
+ text: baseText ? `${baseText} ${spinner.suffix}` : spinner.suffix,
691
+ suffix: spinner.suffix
692
+ };
693
+ }
694
+
695
+ // Default surface: AbovePrompt 1-line band while chaining await next(event)
696
+ const downstream = typeof next === 'function' ? await next(event) : null;
697
+ const band = renderAbovePromptBand(telemetry, renderOptions);
698
+ if (typeof downstream === 'string' && downstream.length > 0) {
699
+ return `${band.line}\n${downstream}`;
700
+ }
701
+ const downstreamLine =
702
+ typeof downstream === 'object' &&
703
+ downstream &&
704
+ typeof downstream.line === 'string' &&
705
+ downstream.line.length > 0
706
+ ? downstream.line
707
+ : '';
708
+ return {
709
+ ...(typeof downstream === 'object' && downstream ? downstream : {}),
710
+ line: downstreamLine ? `${band.line}\n${downstreamLine}` : band.line,
711
+ band
712
+ };
713
+ } catch (err) {
714
+ recordRuntimeDiagnostic(
715
+ 'hooks/register.js',
716
+ 'ui.render',
717
+ err,
718
+ event?.cwd ? { cwd: event.cwd } : {}
719
+ );
720
+ if (typeof next === 'function') {
721
+ return await next(event);
722
+ }
723
+ return undefined;
724
+ }
725
+ });
726
+ }