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
@@ -40,3 +40,11 @@ When writing or updating `task.md`, apply the **KEEP / DROP** filter:
40
40
  ```
41
41
  3. When the audit reports `CLEAN ✅` and the KV cache window is ready, advise the user with the parameterized compaction prompt:
42
42
  > Type `/compact` in the chat box and press Enter (preserving active exported symbols, `task.md` checklist state, and explicit in-chat constraints).
43
+
44
+ ## Consolidating Sharded Specifications (`[CTX_HINT: SHARDED_SPEC]`)
45
+
46
+ When multi-turn requirement sharding triggers (`4+` incremental constraint turns across `>=25k` tokens), merge scattered Turn-1 goals, recorded shards, and uncommitted paths into a clean restart contract before clearing:
47
+
48
+ ```bash
49
+ npx ctxtop handoff --consolidate --write
50
+ ```
@@ -47,8 +47,28 @@ import {
47
47
  writeSidecarAtomicSync,
48
48
  updateSwarmAgentStateAtomicSync
49
49
  } from '../../core/sidecar_store.mjs';
50
+ import { checkIndex, buildIndex, sliceFile } from '../../core/doc_indexer.mjs';
51
+ import {
52
+ evaluateShieldReadGuard,
53
+ configureShield,
54
+ getShieldStatus
55
+ } from '../../core/shield_manager.mjs';
56
+ import { runSessionAudit, formatSessionAuditReport } from '../../core/session_auditor.mjs';
57
+ import {
58
+ resolveModelCliffSpec,
59
+ evaluateParameterizedCliffBreaker
60
+ } from '../../core-isomorphic/economics/cliffBreaker.mjs';
61
+ import {
62
+ handleAntigravityRslHook,
63
+ syncAntigravityWorkspaceRslHooks
64
+ } from '../../hooks/antigravity_rsl_hook.mjs';
65
+ export * from '../../core/rsl_triage.mjs';
66
+ export * from '../../core/rsl_distiller.mjs';
67
+ export * from '../../core/rsl_ledger.mjs';
50
68
 
51
69
  export {
70
+ handleAntigravityRslHook,
71
+ syncAntigravityWorkspaceRslHooks,
52
72
  handlePreInvocation,
53
73
  handlePreToolUse,
54
74
  handlePostInvocation,
@@ -75,5 +95,15 @@ export {
75
95
  evaluateCarbonVerbosityGuardrail,
76
96
  readSidecarSync,
77
97
  writeSidecarAtomicSync,
78
- updateSwarmAgentStateAtomicSync
98
+ updateSwarmAgentStateAtomicSync,
99
+ checkIndex,
100
+ buildIndex,
101
+ sliceFile,
102
+ evaluateShieldReadGuard,
103
+ configureShield,
104
+ getShieldStatus,
105
+ resolveModelCliffSpec,
106
+ evaluateParameterizedCliffBreaker,
107
+ runSessionAudit,
108
+ formatSessionAuditReport
79
109
  };
@@ -141,7 +141,32 @@ export function trackClaudeCodeSessionCache(events = [], options = {}) {
141
141
  };
142
142
  }
143
143
 
144
+ import { checkIndex, buildIndex, sliceFile } from '../../core/doc_indexer.mjs';
145
+ import {
146
+ evaluateShieldReadGuard,
147
+ configureShield,
148
+ getShieldStatus,
149
+ syncClaudeIdleDrainSettings,
150
+ auditClaudeIdleDrainSettings,
151
+ auditClaudeAgentAutoCompactWindows
152
+ } from '../../core/shield_manager.mjs';
153
+ import { runSessionAudit, formatSessionAuditReport } from '../../core/session_auditor.mjs';
154
+ import {
155
+ resolveModelCliffSpec,
156
+ evaluateParameterizedCliffBreaker
157
+ } from '../../core-isomorphic/economics/cliffBreaker.mjs';
158
+ import { runConfigChangeHook } from '../../../hooks/handlers/config-change.mjs';
159
+ import {
160
+ handleClaudeRslHook,
161
+ syncClaudeWorkspaceRslHooks
162
+ } from '../../hooks/claude_rsl_hook.mjs';
163
+ export * from '../../core/rsl_triage.mjs';
164
+ export * from '../../core/rsl_distiller.mjs';
165
+ export * from '../../core/rsl_ledger.mjs';
166
+
144
167
  export {
168
+ handleClaudeRslHook,
169
+ syncClaudeWorkspaceRslHooks,
145
170
  formatAgentCacheKey,
146
171
  formatAgentStreamKey,
147
172
  parseAgentCacheKey,
@@ -151,5 +176,19 @@ export {
151
176
  computeQuotaAndCacheTelemetry,
152
177
  resolveModelDescriptor,
153
178
  resolveModelRates,
154
- calculateModelCost
179
+ calculateModelCost,
180
+ checkIndex,
181
+ buildIndex,
182
+ sliceFile,
183
+ evaluateShieldReadGuard,
184
+ configureShield,
185
+ getShieldStatus,
186
+ syncClaudeIdleDrainSettings,
187
+ auditClaudeIdleDrainSettings,
188
+ auditClaudeAgentAutoCompactWindows,
189
+ resolveModelCliffSpec,
190
+ evaluateParameterizedCliffBreaker,
191
+ runConfigChangeHook,
192
+ runSessionAudit,
193
+ formatSessionAuditReport
155
194
  };
@@ -6,7 +6,15 @@ import { loadFlightcheckConfig, getUserConfigPath } from '../core/config.mjs';
6
6
  import { getDaemonPortFile, readDaemonPort, ensureSupportedNodeVersion, isSupportedNodeVersion } from '../core/paths.mjs';
7
7
  import { resolveModelCeilingDetailed, resolvePricePerM } from '../core/constants.mjs';
8
8
  import { getFlightcheckDir, SIDECAR_VERSION } from '../core/sidecar_store.mjs';
9
- import { syncAndVerifyMirrors } from '../../scripts/sync_mirrors.mjs';
9
+
10
+ async function getSyncAndVerifyMirrors() {
11
+ try {
12
+ const mod = await import('../../scripts/sync_mirrors.mjs');
13
+ return mod.syncAndVerifyMirrors;
14
+ } catch {
15
+ return () => ({ parityOk: true, targets: 0, sha256: '' });
16
+ }
17
+ }
10
18
  import { findSessionDirectory, parseTranscriptIncremental, parseRawJsonl } from '../core/parser.mjs';
11
19
  import { executeToolOutputSurgery } from '../core/tool_surgeon.mjs';
12
20
  import { compactCursorVscdbStreaming, recoverAntigravityBrainMigration } from '../core/storage_doctor.mjs';
@@ -168,6 +176,7 @@ export async function runDoctor({ workspacePath = process.cwd(), pruneTools = fa
168
176
  // 1b. Plugin Mirror & Canonical Integrity Check
169
177
  const agyHorizonDir = path.join(home, '.gemini', 'config', 'plugins', 'agy-horizon');
170
178
  const flightcheckDir = path.join(home, '.gemini', 'config', 'plugins', 'agy-horizon-flightcheck');
179
+ const syncAndVerifyMirrors = await getSyncAndVerifyMirrors();
171
180
  if (fs.existsSync(agyHorizonDir) && fs.existsSync(flightcheckDir)) {
172
181
  let mirrorsInSync = false;
173
182
  try {
@@ -202,7 +211,7 @@ export async function runDoctor({ workspacePath = process.cwd(), pruneTools = fa
202
211
  }
203
212
 
204
213
  // 3. Model Ceiling & Pricing Resolution
205
- const testModels = ['gemini-3.8-flash', 'gemini-4-argon', 'gemini-4-carbon', 'claude-opus-5.5', 'custom-enterprise-model'];
214
+ const testModels = ['gemini-3.8-flash', 'gemini-4-argon', 'gemini-4-hydrogen', 'gemini-4-carbon', 'claude-opus-5.5', 'claude-fable-5-2', 'custom-enterprise-model'];
206
215
  let fallbackSeen = false;
207
216
  for (const m of testModels) {
208
217
  const details = resolveModelCeilingDetailed(m, null, { config });
@@ -384,7 +384,7 @@ export function formatDemoScenarioAnsi(scenarioId = 5, options = {}) {
384
384
  const aqAnsi = formatActionQueueAnsi(state);
385
385
  const aqLines = aqAnsi ? aqAnsi.split('\n').filter(Boolean) : [];
386
386
  const boxWidth = Math.max(40, Math.min(78, maxCols));
387
- const headerLabel = `╭── Flight Check v3.3 (${meta.routerState}) `;
387
+ const headerLabel = `╭── Flight Check v4.1 (${meta.routerState}) `;
388
388
  const headerDashCount = Math.max(1, boxWidth - visibleWidth(headerLabel) - 1);
389
389
  const footerLine = `╰${'─'.repeat(Math.max(1, boxWidth - 2))}╯`;
390
390
 
@@ -407,7 +407,7 @@ export function formatDemoScenarioAnsi(scenarioId = 5, options = {}) {
407
407
 
408
408
  export async function runDemoShowcase({ scenarioId = null, animate = false, columns = process.stdout.columns || 80 } = {}) {
409
409
  const maxCols = columns <= 80 ? Math.min(columns, 80) : 80;
410
- console.log('\n' + clampAnsiLine('\x1b[1m\x1b[38;5;51m⚡ HIGHBEAM (ctxtop v3.4.0) — 40-Cell Context Telemetry & Flight Check\x1b[0m', maxCols));
410
+ console.log('\n' + clampAnsiLine('\x1b[1m\x1b[38;5;51m⚡ HIGHBEAM (ctxtop v4.1.1) — 40-Cell Context Telemetry & Flight Check\x1b[0m', maxCols));
411
411
  console.log(clampAnsiLine('\x1b[38;5;244mLegend: \x1b[38;5;51m█ Anchor\x1b[0m \x1b[38;5;141m▓ Memory\x1b[0m \x1b[38;5;205m▓ Bleed\x1b[0m \x1b[38;5;214m▒ Stale\x1b[0m \x1b[38;5;196m▓ Error\x1b[0m \x1b[38;5;82m█ Active\x1b[0m \x1b[38;5;196m![..]! (>140k)\x1b[0m', maxCols) + '\n');
412
412
 
413
413
  const ids = scenarioId ? [Number(scenarioId)] : (animate ? [2, 4, 5, 6, 7] : [5]);
@@ -419,7 +419,7 @@ export async function runDemoShowcase({ scenarioId = null, animate = false, colu
419
419
  if (animate) await new Promise(r => setTimeout(r, 450));
420
420
  }
421
421
  }
422
- console.log('\n' + clampAnsiLine('\x1b[38;5;245mTry: npx attention-horizon-antigravity --demo-animate | Web UI: npx attention-horizon-antigravity ui\x1b[0m', maxCols) + '\n');
422
+ console.log('\n' + clampAnsiLine('\x1b[38;5;245mTry: npx ctxtop --demo-animate | Web UI: npx ctxtop ui\x1b[0m', maxCols) + '\n');
423
423
  }
424
424
 
425
425
  export function isHudMain(argv1 = process.argv[1], metaUrl = import.meta.url) {
@@ -472,6 +472,256 @@ if (isMain) {
472
472
  }
473
473
  }
474
474
 
475
+ /**
476
+ * Adapts an Antigravity `classifyHorizon` state object into the Claude Code
477
+ * static HUD contract consumed by `renderHorizonPanelHtml`. Passes native
478
+ * Claude Code states through unchanged.
479
+ */
480
+ export function adaptClassifierStateForStaticHud(state = {}, options = {}) {
481
+ const isAntigravityState = Boolean(
482
+ state &&
483
+ typeof state === 'object' &&
484
+ state.window &&
485
+ typeof state.window.totalActiveTokens === 'number' &&
486
+ !state.contextWindow &&
487
+ typeof state.totalInputTokens !== 'number'
488
+ );
489
+ if (!isAntigravityState) {
490
+ return { state, options };
491
+ }
492
+
493
+ const totalInputTokens = Math.max(0, Number(state.window.totalActiveTokens || 0));
494
+ const contextCeiling = Math.max(0, Number(state.window.maxTokens || 0));
495
+ const breakdown = state.breakdown || {};
496
+ const systemTokens = Math.max(0, Number(breakdown.ANCHOR ?? state.baseline?.totalEst ?? 0));
497
+ const dupTok = Math.max(0, Number(breakdown.STALE_DUPLICATE ?? breakdown.DUPLICATE_READ ?? 0));
498
+ const oldHistTok = Math.max(0, Number(breakdown.STALE_TURN ?? 0));
499
+ const deadErrTok = Math.max(0, Number(breakdown.DEAD_ERROR ?? 0));
500
+ const bleedTok = Math.max(0, Number(breakdown.FOREIGN_BLEED ?? 0));
501
+ const distractorTokens = dupTok + oldHistTok + deadErrTok + bleedTok;
502
+
503
+ const cacheObj = state.quota?.cache || {};
504
+ const ttlSec = Math.max(0, Math.round(Number(cacheObj.ttlRemainingSec || 0) || 0));
505
+ const hitPct = Math.max(0, Math.min(100, Math.round(Number(cacheObj.hitRatePct || 0) || 0)));
506
+ const cacheReadTokens = Math.max(0, Number(cacheObj.cacheReadTokens || 0));
507
+ const isWarm = Boolean(
508
+ !cacheObj.isCacheCold &&
509
+ !cacheObj.prefixBustDetected &&
510
+ ttlSec > 0 &&
511
+ (cacheReadTokens > 0 || hitPct > 0)
512
+ );
513
+ const nonAnchorOrDistractor = Math.max(0, totalInputTokens - systemTokens - distractorTokens);
514
+
515
+ const adaptedState = {
516
+ sessionId: state.sessionId || 'horizon-hud',
517
+ model: state.model?.id || 'claude-sonnet-5-5',
518
+ modelLabel: state.model?.displayName || state.model?.rawLabel || state.model?.id || 'claude-sonnet-5-5',
519
+ totalInputTokens,
520
+ contextCeiling: contextCeiling > 0 ? contextCeiling : undefined,
521
+ systemTokens,
522
+ distractorTokens,
523
+ cachedTokens: isWarm ? nonAnchorOrDistractor : 0,
524
+ cacheReadTokens,
525
+ uncachedInputTokens: isWarm ? 0 : nonAnchorOrDistractor,
526
+ promptCache: {
527
+ warm: isWarm,
528
+ ttlRemainingSec: isWarm ? ttlSec : 0,
529
+ ttlTier: '5m'
530
+ },
531
+ cacheRoi: {
532
+ cacheHitRatio: hitPct / 100
533
+ },
534
+ amnesiaRisk: Boolean(
535
+ state.amputation?.amputationCrisis ||
536
+ state.amputation?.inAmputationZone ||
537
+ state.telemetry?.amputationRisk
538
+ ),
539
+ sessionTimeline: state.sessionTimeline || null,
540
+ autoFixLog: state.autoFixLog || null,
541
+ compactCommand: typeof state.compaction?.parameterizedCommand === 'string' &&
542
+ state.compaction.parameterizedCommand.startsWith('/compact ')
543
+ ? state.compaction.parameterizedCommand
544
+ : '/compact'
545
+ };
546
+
547
+ const mergedOptions = { ...options };
548
+ if (!Array.isArray(mergedOptions.offenders)) {
549
+ const derivedOffenders = [];
550
+ const seen = new Set();
551
+ const bs = state.brainSignals || {};
552
+ const topFiles = Array.isArray(bs.duplicateReads?.topFiles) ? bs.duplicateReads.topFiles : [];
553
+ for (const f of topFiles) {
554
+ const target = f?.path || f?.file;
555
+ const wastedTokens = Number(f?.wastedTokens ?? f?.tokens ?? 0);
556
+ if (!target || wastedTokens <= 0) continue;
557
+ seen.add(String(target).toLowerCase());
558
+ derivedOffenders.push({
559
+ target,
560
+ occurrences: Number(f.occurrences || f.reads || 1),
561
+ wastedTokens,
562
+ category: '[D]'
563
+ });
564
+ }
565
+ for (const o of (Array.isArray(state.offenders) ? state.offenders : [])) {
566
+ const rawTarget = String(o?.target || '');
567
+ const wastedTokens = Number(o?.wastedTokens || 0);
568
+ if (!rawTarget || wastedTokens <= 0) continue;
569
+ if (rawTarget === 'Foreign Bleed Knowledge') continue;
570
+ const key = rawTarget.toLowerCase();
571
+ if (seen.has(key)) continue;
572
+ seen.add(key);
573
+ derivedOffenders.push({
574
+ target: rawTarget,
575
+ occurrences: Number(o.occurrences || 1),
576
+ wastedTokens,
577
+ category: '[D]'
578
+ });
579
+ }
580
+ if (bleedTok > 0) {
581
+ derivedOffenders.push({
582
+ target: 'Cross-project memory bleed (foreign KIs)',
583
+ occurrences: 1,
584
+ wastedTokens: bleedTok,
585
+ category: '[D]'
586
+ });
587
+ }
588
+ for (const b of (Array.isArray(bs.blowupSteps) ? bs.blowupSteps : [])) {
589
+ const wastedTokens = Number(b?.tokens || 0);
590
+ if (wastedTokens <= 0) continue;
591
+ const isFile = b.payload?.kind === 'file' && Boolean(b.payload?.path);
592
+ const target = isFile ? b.payload.path : (b.payload?.detail || b.target || 'Output spike');
593
+ const key = String(target).toLowerCase();
594
+ if (seen.has(key)) continue;
595
+ seen.add(key);
596
+ derivedOffenders.push({
597
+ target,
598
+ occurrences: 1,
599
+ wastedTokens,
600
+ category: isFile ? '[D]' : '[W]'
601
+ });
602
+ }
603
+ for (const srv of (Array.isArray(bs.mcpAudit?.unusedEagerServers) ? bs.mcpAudit.unusedEagerServers : [])) {
604
+ const schemaTokens = Number(srv?.schemaTokens || 0);
605
+ if (!srv?.name || schemaTokens <= 0) continue;
606
+ derivedOffenders.push({
607
+ target: srv.name,
608
+ occurrences: 1,
609
+ wastedTokens: schemaTokens,
610
+ category: '[S]'
611
+ });
612
+ }
613
+ derivedOffenders.sort((a, b) => (b.wastedTokens || 0) - (a.wastedTokens || 0));
614
+ mergedOptions.offenders = derivedOffenders;
615
+ }
616
+
617
+ if (!mergedOptions.breakerVerdict) {
618
+ const tripped = state.coachState?.detectors?.tripped;
619
+ const isErrLoop = Boolean(state.brainSignals?.deadErrors?.isErrorLoop);
620
+ const errCount = Number(state.brainSignals?.deadErrors?.errorCount || 0);
621
+ if (state.amputation?.amputationCrisis) {
622
+ mergedOptions.breakerVerdict = {
623
+ triggered: true,
624
+ detectorId: tripped?.detectorId || 'CRISIS',
625
+ reason: tripped?.reason || `Context truncation crisis (${Math.round(totalInputTokens / 1000)}k used — oldest rules at risk).`
626
+ };
627
+ } else if (tripped && tripped.detectorId) {
628
+ mergedOptions.breakerVerdict = {
629
+ triggered: true,
630
+ detectorId: tripped.detectorId,
631
+ reason: tripped.reason || `${tripped.detectorId} guard triggered.`
632
+ };
633
+ } else if (isErrLoop) {
634
+ mergedOptions.breakerVerdict = {
635
+ triggered: true,
636
+ detectorId: 'ERR-LOOP',
637
+ reason: `Stuck error loop (${errCount}x failing attempts). Pause retries and isolate a minimal repro.`
638
+ };
639
+ }
640
+ }
641
+
642
+ if (state.savings && mergedOptions.sessionSavedTokens === undefined) {
643
+ const sessTok = Math.max(0, Number(state.savings?.session?.totalPhysicalTokens ?? state.savings?.session?.totalTokens ?? 0));
644
+ const sessUsd = Math.max(0, Number(state.savings?.session?.estimatedInputValueUsd ?? state.savings?.session?.estimatedUsd ?? Number(((sessTok / 1_000_000) * 2).toFixed(2))));
645
+ const wsTok = Math.max(sessTok, Number(state.savings?.workspace30d?.totalPhysicalTokens ?? state.savings?.workspace30d?.totalTokens ?? 0));
646
+ const wsUsd = Math.max(sessUsd, Number(state.savings?.workspace30d?.estimatedInputValueUsd ?? state.savings?.workspace30d?.estimatedUsd ?? Number(((wsTok / 1_000_000) * 2).toFixed(2))));
647
+ mergedOptions.sessionSavedTokens = sessTok;
648
+ mergedOptions.sessionSavedUSD = sessUsd;
649
+ mergedOptions.workspace30dSavedTokens = wsTok;
650
+ mergedOptions.workspace30dSavedUSD = wsUsd;
651
+ if (mergedOptions.includeDiskLedger === undefined) {
652
+ mergedOptions.includeDiskLedger = false;
653
+ }
654
+ }
655
+
656
+ return { state: adaptedState, options: mergedOptions };
657
+ }
658
+
659
+ /**
660
+ * Renders the static HTML HUD from either an Antigravity `classifyHorizon`
661
+ * state or a native Claude Code state.
662
+ */
663
+ export function renderClassifierHudHtml(state = {}, options = {}) {
664
+ const { state: adaptedState, options: mergedOptions } = adaptClassifierStateForStaticHud(state, options);
665
+ return renderHorizonPanelHtml(adaptedState, mergedOptions);
666
+ }
667
+
668
+ /**
669
+ * Formats the single-line ANSI CLI status bar for a `classifyHorizon` state
670
+ * clamped cleanly to `columns` when <= 80.
671
+ */
672
+ export function formatCliStatusLine(state = {}, { columns = 120 } = {}) {
673
+ let cellCount = 40;
674
+ if (columns < 80) cellCount = 10;
675
+ else if (columns < 120) cellCount = 20;
676
+
677
+ const downsampleRatio = 40 / cellCount;
678
+ const isAmputation = Boolean(state.amputation?.inAmputationZone);
679
+ const isCrisis = Boolean(state.amputation?.amputationCrisis);
680
+
681
+ let bar = isCrisis ? '\x1b[48;5;196m\x1b[38;5;255m![ 🚨 \x1b[0m ' : (isAmputation ? '\x1b[38;5;196m![\x1b[0m' : '[');
682
+ for (let i = 0; i < cellCount; i++) {
683
+ const origStart = Math.floor(i * downsampleRatio);
684
+ const origEnd = Math.floor((i + 1) * downsampleRatio);
685
+ const slice = (state.cells || []).slice(origStart, origEnd);
686
+ const dominant = slice[0]?.dominantCategory || H_CATEGORIES.FREE_HEADROOM;
687
+ const meta = CATEGORY_METADATA[dominant] || CATEGORY_METADATA.FREE_HEADROOM;
688
+ if (slice.some(c => c.isCrisisCell)) {
689
+ bar += `\x1b[48;5;196m\x1b[38;5;255m${meta.symbol}\x1b[0m`;
690
+ } else {
691
+ bar += `${meta.ansiCode}${meta.symbol}\x1b[0m`;
692
+ }
693
+ }
694
+ bar += isCrisis ? ' \x1b[48;5;196m\x1b[38;5;255m]!\x1b[0m' : (isAmputation ? '\x1b[38;5;196m]!\x1b[0m' : ']');
695
+
696
+ const activeK = Math.round((state.window?.totalActiveTokens || 0) / 1000);
697
+ const maxK = Math.round((state.window?.maxTokens || 0) / 1000);
698
+ const usedPct = maxK > 0 ? Math.round((activeK / maxK) * 100) : 0;
699
+ const purity = state.metrics?.signalPurityPct ?? 100;
700
+ const noiseK = Math.round((state.metrics?.sludgeTokens || 0) / 1000);
701
+ const rawRecCmd = state.diagnostics?.recommendedCommand || 'Ready';
702
+ const recCmd = rawRecCmd === '/fast' ? 'Ready' : rawRecCmd;
703
+ const isCacheCold = state.quota?.cache ? Boolean(state.quota.cache.isCacheCold) : false;
704
+ const ttlSec = Math.max(0, Math.round(Number(state.quota?.cache?.ttlRemainingSec || 0) || 0));
705
+ const cacheHitPct = Math.max(0, Number(state.quota?.cache?.hitRatePct || 0) || 0);
706
+ const cacheLabel = (!isCacheCold && ttlSec > 0 && cacheHitPct > 0) ? `Warm(${ttlSec}s)` : 'Cold';
707
+ const modeTag = state.workloadMode?.tag || '[Mode: Read-Heavy Audit]';
708
+ const strandedCnt = Number(state.attentionHeatmap?.strandedSignalCount || 0);
709
+ const strandedSuffix = strandedCnt > 0 ? ` | \u26A0 ${strandedCnt}/40 mid-window blocks` : '';
710
+
711
+ let line1 = '';
712
+ if (cellCount === 40) {
713
+ line1 = `${bar} [ ${activeK}k / ${maxK}k · ${usedPct}% ] \x1b[1mPurity:\x1b[0m ${purity}% | \x1b[1mCache Hit:\x1b[0m ${cacheHitPct}% | \x1b[1mWaste:\x1b[0m ${noiseK}k tok | \x1b[1mCache:\x1b[0m ${cacheLabel} | ${modeTag}${strandedSuffix} \x1b[38;5;51m-> ${recCmd}\x1b[0m`;
714
+ } else if (cellCount === 20) {
715
+ line1 = `${bar} [${activeK}k/${maxK}k·${usedPct}%] P:${purity}% Waste:${noiseK}k -> ${recCmd}`;
716
+ } else {
717
+ line1 = `${bar} ${activeK}k P:${purity}% ${recCmd}`;
718
+ }
719
+ if (columns <= 80) {
720
+ line1 = clampAnsiText(line1, Math.min(columns, 80));
721
+ }
722
+ return line1;
723
+ }
724
+
475
725
  /**
476
726
  * Renders the ANSI statusLine bar and full 256K-aware HorizonStatePayload for Antigravity CLI / Sidecar Daemon
477
727
  */
@@ -492,7 +742,7 @@ export async function runCLI(options = {}) {
492
742
  );
493
743
  if (options.emitWidget || (Array.isArray(process.argv) && process.argv.includes('--emit-widget'))) {
494
744
  const target = path.resolve(options.out || 'horizon_widget.html');
495
- const { html } = renderHorizonPanelHtml(state, { viewMode: 'simple' });
745
+ const { html } = renderClassifierHudHtml(state, { viewMode: 'simple' });
496
746
  fs.mkdirSync(path.dirname(target), { recursive: true });
497
747
  fs.writeFileSync(target, html, 'utf8');
498
748
  const fileUri = `file:///${target.replace(/\\/g, '/').replace(/^\/+/, '')}`;
@@ -504,6 +754,7 @@ export async function runCLI(options = {}) {
504
754
  return { output: text, state };
505
755
  }
506
756
 
757
+ const passedSessionId = stdinData?.session_id || stdinData?.conversation_id || null;
507
758
  let sessionInfo = null;
508
759
  if (sessionDirOverride) {
509
760
  const lowerOverride = String(sessionDirOverride).toLowerCase();
@@ -516,18 +767,28 @@ export async function runCLI(options = {}) {
516
767
  sessionId: path.basename(sessionDirOverride).replace(/\.(jsonl|vscdb)$/i, '')
517
768
  };
518
769
  } else {
519
- const passedSessionId = stdinData?.session_id || stdinData?.conversation_id;
520
770
  sessionInfo = findSessionDirectory(passedSessionId);
771
+ if (!sessionInfo && passedSessionId) {
772
+ sessionInfo = {
773
+ storeName: 'antigravity',
774
+ sessionDir: '',
775
+ sessionId: String(passedSessionId)
776
+ };
777
+ }
521
778
  }
522
779
 
523
- if (!sessionInfo || !fs.existsSync(sessionInfo.sessionDir)) {
780
+ if (!sessionInfo || (!passedSessionId && !sessionInfo.dbPath && !fs.existsSync(sessionInfo.sessionDir))) {
524
781
  const fallbackText = '\x1b[38;5;244m[ - ] No Antigravity session active\x1b[0m';
525
782
  if (!options.silent) console.log(fallbackText);
526
783
  return { output: fallbackText, state: null };
527
784
  }
528
785
 
529
- const parsed = parseTranscriptIncremental(sessionInfo.sessionDir, cacheDirOverride);
530
- if (!parsed.steps || parsed.steps.length === 0) {
786
+ const hasReadableLogDir = Boolean(sessionInfo.sessionDir && fs.existsSync(sessionInfo.sessionDir));
787
+ const parsed = hasReadableLogDir
788
+ ? parseTranscriptIncremental(sessionInfo.sessionDir, cacheDirOverride)
789
+ : { steps: [], tier: 0, filePath: '', activeEffortProfile: null, effortTransitions: [], rewindDetected: false, genMetadata: null, sessionTitle: '' };
790
+ const parsedSteps = Array.isArray(parsed?.steps) ? parsed.steps : [];
791
+ if (parsedSteps.length === 0 && !passedSessionId && !sessionInfo.dbPath && !hasReadableLogDir) {
531
792
  const initText = '\x1b[38;5;244m[ ... ] Initialize session to build attention horizon\x1b[0m';
532
793
  if (!options.silent) console.log(initText);
533
794
  return { output: initText, state: null };
@@ -541,7 +802,7 @@ export async function runCLI(options = {}) {
541
802
  const resolvedModel = resolveSessionModel({
542
803
  stdinData,
543
804
  genMetadata: activeGenMetadata,
544
- steps: parsed.steps
805
+ steps: parsedSteps
545
806
  });
546
807
  const modelId = resolvedModel.id;
547
808
  const loadedSettings = loadSettings(cacheDir);
@@ -556,7 +817,7 @@ export async function runCLI(options = {}) {
556
817
  ? win.safeLimit
557
818
  : (scaledEffort?.safeLimit || win.safeLimit);
558
819
 
559
- const state = classifyHorizon(parsed.steps, {
820
+ const state = classifyHorizon(parsedSteps, {
560
821
  sessionId: sessionInfo.sessionId,
561
822
  storeSource: sessionInfo.storeName,
562
823
  logTierUsed: parsed.tier,
@@ -576,7 +837,8 @@ export async function runCLI(options = {}) {
576
837
  activeEffortProfile: scaledEffort,
577
838
  effortTransitions: parsed.effortTransitions
578
839
  });
579
- state.sessionTitle = reconciliation.sessionTitle || parsed.sessionTitle || '';
840
+ state.sessionTitle = reconciliation.sessionTitle || parsed.sessionTitle || (parsedSteps.length === 0 ? 'New Conversation' : '');
841
+ state.isEmptySession = parsedSteps.length === 0;
580
842
  if (state.model && typeof state.model === 'object') {
581
843
  state.model.source = resolvedModel.source;
582
844
  state.model.rawLabel = resolvedModel.raw;
@@ -592,69 +854,25 @@ export async function runCLI(options = {}) {
592
854
  reconciliation.primaryWorkspace || state.workspace?.canonicalPath || ''
593
855
  );
594
856
 
595
- state.delta = recordAndDelta(cacheDir, sessionInfo.sessionId, state, parsed.steps).delta;
857
+ state.delta = recordAndDelta(cacheDir, sessionInfo.sessionId, state, parsedSteps).delta;
596
858
  try {
597
859
  state.hostHealth = await inspectHostProcesses({ force: false });
598
860
  } catch {
599
861
  state.hostHealth = { rssGb: 0, languageServerCount: 0, orphanCount: 0, orphans: [], status: 'HEALTHY', alertBanner: null, checkedAt: new Date().toISOString() };
600
862
  }
601
- try {
602
- writeJsonAtomicSync(path.join(cacheDir, 'latest.state.json'), state);
603
- } catch {}
604
-
605
- let cellCount = 40;
606
- if (columns < 80) cellCount = 10;
607
- else if (columns < 120) cellCount = 20;
608
-
609
- const downsampleRatio = 40 / cellCount;
610
- const isAmputation = state.amputation.inAmputationZone;
611
- const isCrisis = state.amputation.amputationCrisis;
612
-
613
- let bar = isCrisis ? '\x1b[48;5;196m\x1b[38;5;255m![ 🚨 \x1b[0m ' : (isAmputation ? '\x1b[38;5;196m![\x1b[0m' : '[');
614
- for (let i = 0; i < cellCount; i++) {
615
- const origStart = Math.floor(i * downsampleRatio);
616
- const origEnd = Math.floor((i + 1) * downsampleRatio);
617
- const slice = state.cells.slice(origStart, origEnd);
618
- const dominant = slice[0]?.dominantCategory || H_CATEGORIES.FREE_HEADROOM;
619
- const meta = CATEGORY_METADATA[dominant] || CATEGORY_METADATA.FREE_HEADROOM;
620
- if (slice.some(c => c.isCrisisCell)) {
621
- bar += `\x1b[48;5;196m\x1b[38;5;255m${meta.symbol}\x1b[0m`;
622
- } else {
623
- bar += `${meta.ansiCode}${meta.symbol}\x1b[0m`;
624
- }
863
+ if (parsedSteps.length > 0) {
864
+ try {
865
+ writeJsonAtomicSync(path.join(cacheDir, 'latest.state.json'), state);
866
+ } catch {}
625
867
  }
626
- bar += isCrisis ? ' \x1b[48;5;196m\x1b[38;5;255m]!\x1b[0m' : (isAmputation ? '\x1b[38;5;196m]!\x1b[0m' : ']');
627
868
 
628
- const activeK = Math.round(state.window.totalActiveTokens / 1000);
629
- const maxK = Math.round(state.window.maxTokens / 1000);
630
- const usedPct = maxK > 0 ? Math.round((activeK / maxK) * 100) : 0;
631
- const purity = state.metrics.signalPurityPct;
632
- const noiseK = Math.round((state.metrics.sludgeTokens || 0) / 1000);
633
- const rawRecCmd = state.diagnostics.recommendedCommand || 'Ready';
634
- const recCmd = rawRecCmd === '/fast' ? 'Ready' : rawRecCmd;
635
- const isCacheCold = state.quota?.cache ? Boolean(state.quota.cache.isCacheCold) : false;
636
- const ttlSec = Math.max(0, Math.round(Number(state.quota?.cache?.ttlRemainingSec || 0) || 0));
637
- const cacheHitPct = Math.max(0, Number(state.quota?.cache?.hitRatePct || 0) || 0);
638
- const cacheLabel = (!isCacheCold && ttlSec > 0 && cacheHitPct > 0) ? `Warm(${ttlSec}s)` : 'Cold';
639
- const modeTag = state.workloadMode?.tag || '[Mode: Read-Heavy Audit]';
640
- const strandedCnt = Number(state.attentionHeatmap?.strandedSignalCount || 0);
641
- const strandedSuffix = strandedCnt > 0 ? ` | \u26A0 ${strandedCnt}/40 mid-window blocks` : '';
642
-
643
- let line1 = '';
644
- if (cellCount === 40) {
645
- line1 = `${bar} [ ${activeK}k / ${maxK}k · ${usedPct}% ] \x1b[1mPurity:\x1b[0m ${purity}% | \x1b[1mCache Hit:\x1b[0m ${cacheHitPct}% | \x1b[1mWaste:\x1b[0m ${noiseK}k tok | \x1b[1mCache:\x1b[0m ${cacheLabel} | ${modeTag}${strandedSuffix} \x1b[38;5;51m-> ${recCmd}\x1b[0m`;
646
- } else if (cellCount === 20) {
647
- line1 = `${bar} [${activeK}k/${maxK}k·${usedPct}%] P:${purity}% Waste:${noiseK}k -> ${recCmd}`;
648
- } else {
649
- line1 = `${bar} ${activeK}k P:${purity}% ${recCmd}`;
650
- }
651
- if (columns <= 80) {
652
- line1 = clampAnsiText(line1, Math.min(columns, 80));
653
- }
869
+ const line1 = parsedSteps.length === 0
870
+ ? '\x1b[38;5;244m[ ... ] Initialize session to build attention horizon\x1b[0m'
871
+ : formatCliStatusLine(state, { columns });
654
872
 
655
873
  if (options.emitWidget || (Array.isArray(process.argv) && process.argv.includes('--emit-widget'))) {
656
874
  const target = path.resolve(options.out || 'horizon_widget.html');
657
- const { html } = renderHorizonPanelHtml(state, { viewMode: 'simple' });
875
+ const { html } = renderClassifierHudHtml(state, { viewMode: 'simple' });
658
876
  fs.mkdirSync(path.dirname(target), { recursive: true });
659
877
  fs.writeFileSync(target, html, 'utf8');
660
878
  const fileUri = `file:///${target.replace(/\\/g, '/').replace(/^\/+/, '')}`;
@@ -674,7 +892,7 @@ export async function emitHorizonWidget(options = {}) {
674
892
  const targetPath = path.resolve(options.out || 'horizon_widget.html');
675
893
  const cliRes = await runCLI({ ...options, silent: true, useNativeCeiling: true });
676
894
  const state = cliRes?.state || {};
677
- const { html } = renderHorizonPanelHtml(state, { viewMode: 'simple' });
895
+ const { html } = renderClassifierHudHtml(state, { viewMode: 'simple' });
678
896
  fs.mkdirSync(path.dirname(targetPath), { recursive: true });
679
897
  fs.writeFileSync(targetPath, html, 'utf8');
680
898
  const fileUri = `file:///${targetPath.replace(/\\/g, '/').replace(/^\/+/, '')}`;