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
package/bin/ctxtop.mjs CHANGED
@@ -1,7 +1,7 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
3
  * @file bin/ctxtop.mjs
4
- * Highbeam v4.0 Unified Cross-Platform CLI (`ctxtop`).
4
+ * Highbeam v4.1.1 Unified Cross-Platform CLI (`ctxtop`).
5
5
  *
6
6
  * Commands:
7
7
  * - `ctxtop init [--antigravity | --claude | --all | --workspace | --project | --dry-run | --dedupe]`
@@ -70,6 +70,7 @@ import {
70
70
  verifyProLicenseKey,
71
71
  PLG_TIER_MATRIX
72
72
  } from '../src/core/pro_license.mjs';
73
+ import { getShadowAutoSummary } from '../src/core/shadow_auto_ledger.mjs';
73
74
  import { generateTeamFinopsPack } from '../packages/pro/src/team_finops_pack.mjs';
74
75
  import {
75
76
  computeSwarmSummary,
@@ -94,8 +95,34 @@ import {
94
95
  inspectHookDiagnostics,
95
96
  runDoctorDiagnostics
96
97
  } from '../src/diagnostics/doctorEngine.mjs';
97
- import { installPlugin, runLiveOrDemoCli } from '../src/cli/init.mjs';
98
+ import {
99
+ formatPreEffortChangeCapability,
100
+ inspectClaudeBinaryCapabilities
101
+ } from '../src/diagnostics/claudeHookCapabilities.mjs';
102
+ import { installPlugin, runLiveOrDemoCli, openBrowserUrl } from '../src/cli/init.mjs';
98
103
  import { executeStatusLineBridge, runStatusLineCli } from './ah-statusline.mjs';
104
+ import { runSessionAudit, formatSessionAuditReport } from '../src/core/session_auditor.mjs';
105
+ import { configureShield, getShieldStatus } from '../src/core/shield_manager.mjs';
106
+ import { buildContrastiveDigest, sanitizeRslSessionId } from '../src/core/rsl_triage.mjs';
107
+ import { distillContrastiveDigest } from '../src/core/rsl_distiller.mjs';
108
+ import {
109
+ getRslLedgerPath,
110
+ getRslSummary,
111
+ ingestDistilledHeuristics,
112
+ promoteHeuristic,
113
+ pruneHeuristic,
114
+ auditWorkspaceRuleClashes,
115
+ buildConsolidatedSpecMarkdown
116
+ } from '../src/core/rsl_ledger.mjs';
117
+ import {
118
+ searchOffloadedContextFts5,
119
+ getOffloadIndexStats
120
+ } from '../src/core/fts5_output_compressor.mjs';
121
+ import {
122
+ SUPPORTED_MCP_HOSTS,
123
+ installHostMcpConfig
124
+ } from '../src/engine-node/multi_host_mcp.mjs';
125
+ import { resolveFastIpcPipePath } from '../src/engine-node/ipc/fast_client.mjs';
99
126
 
100
127
  export { inspectHookDiagnostics, runDoctorDiagnostics };
101
128
 
@@ -113,7 +140,7 @@ export const LEAN_POST_TOOL_USE_MATCHER =
113
140
  'Bash|PowerShell|Task|Agent|WebFetch|mcp__.*';
114
141
 
115
142
  const AH_HANDLER_REGEX =
116
- /hooks[\\/]handlers[\\/](pre-tool-use|post-tool-use|pre-model-switch|compact-lifecycle|stop-gate)\.mjs/i;
143
+ /hooks[\\/]handlers[\\/](pre-tool-use|post-tool-use|pre-model-switch|post-model-switch|compact-lifecycle|stop-gate|user-prompt-submit|config-change)\.mjs/i;
117
144
  const AH_STATUSLINE_REGEX = /ah-statusline\.mjs/i;
118
145
  const AH_MOD_REGISTER_REGEX = /(?:^|[\\/])hooks[\\/]register\.js$|^\.\/register\.js$/i;
119
146
 
@@ -155,6 +182,7 @@ export function buildCanonicalAhHooks(options = {}) {
155
182
  const handlerPrefix = `${rootPrefix}/hooks/handlers`;
156
183
  const preMatcher = options.leanHooks ? LEAN_PRE_TOOL_USE_MATCHER : PRE_TOOL_USE_MATCHER;
157
184
  const postMatcher = options.leanHooks ? LEAN_POST_TOOL_USE_MATCHER : POST_TOOL_USE_MATCHER;
185
+ const includePostModelSwitch = options.includePostModelSwitch !== false;
158
186
 
159
187
  return {
160
188
  PreToolUse: [
@@ -189,6 +217,20 @@ export function buildCanonicalAhHooks(options = {}) {
189
217
  ]
190
218
  }
191
219
  ],
220
+ ...(includePostModelSwitch
221
+ ? {
222
+ PostModelSwitch: [
223
+ {
224
+ hooks: [
225
+ {
226
+ type: 'command',
227
+ command: `node "${handlerPrefix}/post-model-switch.mjs"`
228
+ }
229
+ ]
230
+ }
231
+ ]
232
+ }
233
+ : {}),
192
234
  PreCompact: [
193
235
  {
194
236
  hooks: [
@@ -229,6 +271,46 @@ export function buildCanonicalAhHooks(options = {}) {
229
271
  }
230
272
  ]
231
273
  }
274
+ ],
275
+ UserPromptSubmit: [
276
+ {
277
+ hooks: [
278
+ {
279
+ type: 'command',
280
+ command: `node "${handlerPrefix}/user-prompt-submit.mjs"`
281
+ }
282
+ ]
283
+ }
284
+ ],
285
+ ConfigChange: [
286
+ {
287
+ hooks: [
288
+ {
289
+ type: 'command',
290
+ command: `node "${handlerPrefix}/config-change.mjs"`
291
+ }
292
+ ]
293
+ }
294
+ ],
295
+ InstructionsLoaded: [
296
+ {
297
+ hooks: [
298
+ {
299
+ type: 'command',
300
+ command: `node "${handlerPrefix}/compact-lifecycle.mjs" --phase=instructions`
301
+ }
302
+ ]
303
+ }
304
+ ],
305
+ SessionEnd: [
306
+ {
307
+ hooks: [
308
+ {
309
+ type: 'command',
310
+ command: `node "${handlerPrefix}/stop-gate.mjs" --phase=end`
311
+ }
312
+ ]
313
+ }
232
314
  ]
233
315
  };
234
316
  }
@@ -330,10 +412,30 @@ export function installAttentionHorizon(options = {}) {
330
412
 
331
413
  const useLeanHooks =
332
414
  options.leanHooks !== undefined ? Boolean(options.leanHooks) : !Boolean(options.fullHooks);
415
+ let includePostModelSwitch =
416
+ options.includePostModelSwitch !== undefined ? Boolean(options.includePostModelSwitch) : true;
417
+ const omittedUnsupportedHooks = [];
418
+ if (
419
+ options.includePostModelSwitch === undefined &&
420
+ options.checkBinaryCapabilities !== false
421
+ ) {
422
+ const caps = inspectClaudeBinaryCapabilities({
423
+ ...options,
424
+ cwd,
425
+ probeVersion: false,
426
+ recordDiagnostic: false,
427
+ writeCache: false
428
+ });
429
+ if (caps.found === true && caps.postModelSwitchSupported === false) {
430
+ includePostModelSwitch = false;
431
+ omittedUnsupportedHooks.push('PostModelSwitch');
432
+ }
433
+ }
333
434
  const canonicalHooks = buildCanonicalAhHooks({
334
435
  usePluginRootVar: false,
335
436
  pkgRoot,
336
- leanHooks: useLeanHooks
437
+ leanHooks: useLeanHooks,
438
+ includePostModelSwitch
337
439
  });
338
440
  for (const [eventName, ahEntries] of Object.entries(canonicalHooks)) {
339
441
  const existingList = Array.isArray(currentSettings.hooks[eventName])
@@ -395,6 +497,7 @@ export function installAttentionHorizon(options = {}) {
395
497
  settingsPath,
396
498
  backupPath,
397
499
  gitExcludeUpdated: gitExclude.updated,
500
+ omittedUnsupportedHooks,
398
501
  settings: currentSettings
399
502
  };
400
503
  }
@@ -505,11 +608,11 @@ export function generateRoastCard(options = {}) {
505
608
  `│ Verified Savings : +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)} USD saved in 30d) │`,
506
609
  '│ Top Remediation : Fence mid-session CLAUDE.md/AGENTS.md edits (DET-09) │',
507
610
  '╰────────────────────────────────────────────────────────────────────────────╯',
508
- `Share: Shielded +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)}) with npx ah-claude --roast #ClaudeCode #Antigravity`
611
+ `Share: Shielded +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)}) with npx ctxtop --roast #ClaudeCode #Antigravity`
509
612
  ].join('\n');
510
613
 
511
614
  const markdown = [
512
- '### 🔥 Highbeam Context Roast (`npx ah-claude --roast`)',
615
+ '### 🔥 Highbeam Context Roast (`npx ctxtop --roast`)',
513
616
  `- **KV-Cache Retention**: Grade **${retentionGrade}** (${retentionPct}% warmth retained)`,
514
617
  `- **Cold Prefill Leak**: **$${leakedUsd.toFixed(2)}** burned on avoidable cold switches`,
515
618
  `- **30-Day Verified Savings**: **+${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)} USD)**`,
@@ -640,15 +743,28 @@ export function installMcpConfig(options = {}) {
640
743
  }
641
744
 
642
745
  export function executeInitSubcommand(args = [], options = {}) {
643
- const isAntigravity = args.includes('--antigravity') || args.includes('-a');
644
- const isClaude = args.includes('--claude') || args.includes('-c');
645
- const isMcp =
646
- args.includes('--mcp') ||
647
- args.includes('--cursor') ||
648
- args.includes('--windsurf') ||
649
- Boolean(options.mcp) ||
650
- Boolean(options.cursor);
651
- const isAll = args.includes('--all') || (!isAntigravity && !isClaude && !isMcp);
746
+ const isAllHosts = args.includes('--all-hosts') || Boolean(options.allHosts);
747
+ const isAntigravity = args.includes('--antigravity') || args.includes('-a') || isAllHosts;
748
+ const isClaude = args.includes('--claude') || args.includes('-c') || isAllHosts;
749
+ const isLegacyMcp = args.includes('--mcp') || Boolean(options.mcp);
750
+
751
+ const selectedMcpHosts = [];
752
+ if (args.includes('--cursor') || Boolean(options.cursor)) selectedMcpHosts.push('cursor');
753
+ if (args.includes('--windsurf') || Boolean(options.windsurf)) selectedMcpHosts.push('windsurf');
754
+ if (args.includes('--codex') || Boolean(options.codex)) selectedMcpHosts.push('codex');
755
+ if (args.includes('--gemini-cli') || args.includes('--gemini') || Boolean(options.geminiCli)) {
756
+ selectedMcpHosts.push('gemini-cli');
757
+ }
758
+ if (isAllHosts) {
759
+ for (const h of SUPPORTED_MCP_HOSTS) {
760
+ if (!selectedMcpHosts.includes(h)) selectedMcpHosts.push(h);
761
+ }
762
+ } else if (isLegacyMcp && selectedMcpHosts.length === 0) {
763
+ // Also ensure --mcp works cleanly alongside legacy .cursor/mcp.json contract
764
+ }
765
+
766
+ const hasMcpTarget = isLegacyMcp || selectedMcpHosts.length > 0;
767
+ const isAll = args.includes('--all') || (!isAntigravity && !isClaude && !hasMcpTarget);
652
768
  const isDryRun = args.includes('--dry-run') || Boolean(options.dryRun);
653
769
  const isWorkspace = args.includes('--workspace') || args.includes('--project') || Boolean(options.workspace);
654
770
  const isGlobal = args.includes('--global') || Boolean(options.global);
@@ -659,12 +775,13 @@ export function executeInitSubcommand(args = [], options = {}) {
659
775
  const targetParts = [];
660
776
  if (isAll || isAntigravity) targetParts.push('Google Antigravity');
661
777
  if (isAll || isClaude) targetParts.push('Claude Code');
662
- if (isMcp) targetParts.push('MCP (.cursor/mcp.json)');
778
+ if (isLegacyMcp) targetParts.push('MCP (.cursor/mcp.json)');
779
+ if (selectedMcpHosts.length > 0) targetParts.push(`MCP (${selectedMcpHosts.join(', ')})`);
663
780
  const targetLabel =
664
- targetParts.length === 2 && !isMcp ? targetParts.join(' & ') : targetParts.join(', ');
781
+ targetParts.length === 2 && !hasMcpTarget ? targetParts.join(' & ') : targetParts.join(', ');
665
782
 
666
783
  const lines = [
667
- `\x1b[1m\x1b[38;5;51m⚡ Highbeam (ctxtop v4.0.0) — Zero-Config Unified Installer\x1b[0m`,
784
+ `\x1b[1m\x1b[38;5;51m⚡ Highbeam (ctxtop v4.1.1) — Zero-Config Unified Installer\x1b[0m`,
668
785
  ` • Target Harnesses : ${targetLabel}`,
669
786
  ` • Installation Scope: ${isWorkspace ? 'Workspace' : 'Global'}${isDryRun ? ' [DRY RUN]' : ''}`
670
787
  ];
@@ -672,6 +789,7 @@ export function executeInitSubcommand(args = [], options = {}) {
672
789
  let claudeResult = null;
673
790
  let antigravityResult = null;
674
791
  let mcpResult = null;
792
+ let hostMcpResult = null;
675
793
 
676
794
  if (isClaude || isAll) {
677
795
  const scope = isGlobal ? 'global' : 'project';
@@ -713,7 +831,7 @@ export function executeInitSubcommand(args = [], options = {}) {
713
831
  }
714
832
  }
715
833
 
716
- if (isMcp) {
834
+ if (isLegacyMcp) {
717
835
  mcpResult = installMcpConfig({
718
836
  ...options,
719
837
  global: isGlobal,
@@ -725,28 +843,112 @@ export function executeInitSubcommand(args = [], options = {}) {
725
843
  );
726
844
  }
727
845
 
846
+ if (selectedMcpHosts.length > 0) {
847
+ hostMcpResult = installHostMcpConfig({
848
+ hosts: selectedMcpHosts,
849
+ cwd: options.cwd || process.cwd(),
850
+ homeDir: options.homeDir || options.home,
851
+ global: isGlobal,
852
+ dryRun: isDryRun
853
+ });
854
+ for (const r of hostMcpResult.results) {
855
+ lines.push(
856
+ ` \x1b[38;5;82m✓\x1b[0m MCP [${r.host.padEnd(10)}]: ${isDryRun ? '[DRY RUN] Would configure' : 'Configured'} ${r.configPath} (${r.serverKey})`
857
+ );
858
+ if (r.tomlSnippet) {
859
+ lines.push(` Tip: Append to ~/.codex/config.toml:\n${r.tomlSnippet}`);
860
+ }
861
+ }
862
+ }
863
+
728
864
  const ok =
729
865
  (claudeResult ? claudeResult.ok : true) &&
730
866
  (antigravityResult ? antigravityResult.ok : true) &&
731
- (mcpResult ? mcpResult.ok : true);
867
+ (mcpResult ? mcpResult.ok : true) &&
868
+ (hostMcpResult ? hostMcpResult.ok : true);
732
869
  return {
733
870
  ok,
734
871
  exitCode: ok ? 0 : 1,
735
872
  output: lines.join('\n'),
736
- data: { claude: claudeResult, antigravity: antigravityResult, mcp: mcpResult, dryRun: isDryRun }
873
+ data: {
874
+ claude: claudeResult,
875
+ antigravity: antigravityResult,
876
+ mcp: mcpResult,
877
+ hostMcp: hostMcpResult,
878
+ dryRun: isDryRun
879
+ }
737
880
  };
738
881
  }
739
882
 
740
883
  export function runCli(args = [], options = {}) {
741
- const subcommand = String(args[0] || 'doctor').toLowerCase();
742
- const isGlobal = args.includes('--global') || args.includes('-g');
743
- const isJson = args.includes('--json') || Boolean(options.json);
744
- const isMarkdown = args.includes('--markdown') || args.includes('--md') || args.includes('--git');
745
- const isDiagnostic = args.includes('--diagnostic') || args.includes('--bug-report');
884
+ const invokedBin = path.basename(String(globalThis.process?.argv?.[1] || '')).toLowerCase();
885
+ const isLogSearchBin = invokedBin.includes('agy-log-search');
886
+ const effectiveArgs = isLogSearchBin && !['search', 'log-search'].includes(String(args[0] || '').toLowerCase())
887
+ ? ['search', ...args]
888
+ : args;
889
+ const subcommand = String(effectiveArgs[0] || 'doctor').toLowerCase();
890
+ const isGlobal = effectiveArgs.includes('--global') || effectiveArgs.includes('-g');
891
+ const isJson = effectiveArgs.includes('--json') || Boolean(options.json);
892
+ const isMarkdown = effectiveArgs.includes('--markdown') || effectiveArgs.includes('--md') || effectiveArgs.includes('--git');
893
+ const isDiagnostic = effectiveArgs.includes('--diagnostic') || effectiveArgs.includes('--bug-report');
746
894
  const scope = isGlobal ? 'global' : 'project';
747
895
 
748
- if (args.includes('--version') || args.includes('-v') || subcommand === 'version') {
749
- return { exitCode: 0, output: '4.0.0', data: { version: '4.0.0' } };
896
+ if (effectiveArgs.includes('--version') || effectiveArgs.includes('-v') || subcommand === 'version') {
897
+ return { exitCode: 0, output: '4.1.1', data: { version: '4.1.1' } };
898
+ }
899
+
900
+ if (subcommand === 'search' || subcommand === 'log-search') {
901
+ const positional = [];
902
+ let turnId = options.turnId || '';
903
+ let cwd = options.cwd || process.cwd();
904
+ let limit = Number(options.limit || 10);
905
+ for (let i = 1; i < effectiveArgs.length; i++) {
906
+ const a = String(effectiveArgs[i] || '');
907
+ if (a === '--turn' && effectiveArgs[i + 1]) {
908
+ turnId = String(effectiveArgs[++i]);
909
+ } else if (a === '--cwd' && effectiveArgs[i + 1]) {
910
+ cwd = String(effectiveArgs[++i]);
911
+ } else if (a === '--limit' && effectiveArgs[i + 1]) {
912
+ limit = Math.max(1, Number(effectiveArgs[++i]) || 10);
913
+ } else if (a === '--json') {
914
+ // handled via isJson
915
+ } else if (!a.startsWith('-')) {
916
+ positional.push(a);
917
+ }
918
+ }
919
+ let keyword = '';
920
+ if (!turnId && positional.length >= 2 && /^(turn-|art_)/i.test(positional[0])) {
921
+ turnId = positional[0];
922
+ keyword = positional.slice(1).join(' ');
923
+ } else if (!turnId && positional.length === 1 && /^(turn-|art_)/i.test(positional[0])) {
924
+ turnId = positional[0];
925
+ } else {
926
+ keyword = positional.join(' ');
927
+ }
928
+ return searchOffloadedContextFts5({
929
+ turnId,
930
+ keyword,
931
+ cwd,
932
+ homeDir: options.homeDir || getHomeDir(),
933
+ dbPath: options.dbPath || null,
934
+ limit
935
+ }).then((searchRes) => {
936
+ if (isJson) {
937
+ return { exitCode: 0, output: JSON.stringify(searchRes, null, 2), data: searchRes };
938
+ }
939
+ if (searchRes.matchedLines.length === 0) {
940
+ return {
941
+ exitCode: 0,
942
+ output: `[Highbeam FTS5 Search] No indexed matches for "${keyword || turnId || '*'}" (hits=${searchRes.totalHits}).`,
943
+ data: searchRes
944
+ };
945
+ }
946
+ const lines = [
947
+ `[Highbeam FTS5 Search] Matched ${searchRes.matchedLines.length} line(s) across ${searchRes.toolLogHits} tool log(s) + ${searchRes.artifactHits} artifact(s):`,
948
+ ...searchRes.matchedLines.map((m) => ` [${m.turnId}:${m.lineNumber}] (${m.source}) ${m.text}`)
949
+ ];
950
+ return { exitCode: 0, output: lines.join('\n'), data: searchRes };
951
+ });
750
952
  }
751
953
 
752
954
  if (subcommand === 'inspect') {
@@ -983,7 +1185,15 @@ export function runCli(args = [], options = {}) {
983
1185
  }
984
1186
 
985
1187
  if (subcommand === 'init') {
986
- return executeInitSubcommand(args.slice(1), options);
1188
+ const initRes = executeInitSubcommand(effectiveArgs.slice(1), options);
1189
+ if (isJson) {
1190
+ return {
1191
+ exitCode: initRes.exitCode,
1192
+ output: JSON.stringify(initRes.data, null, 2),
1193
+ data: initRes.data
1194
+ };
1195
+ }
1196
+ return initRes;
987
1197
  }
988
1198
 
989
1199
  if (subcommand === 'install') {
@@ -1123,6 +1333,19 @@ export function runCli(args = [], options = {}) {
1123
1333
  }
1124
1334
  if (action === 'trial') {
1125
1335
  const trRes = activateLocalTrial(options);
1336
+ if (!trRes.ok) {
1337
+ if (isJson) {
1338
+ return { exitCode: 1, output: JSON.stringify(trRes, null, 2), data: trRes };
1339
+ }
1340
+ return {
1341
+ exitCode: 1,
1342
+ output: `[Highbeam Pro] 14-day trial already expired (${trRes.expiresAt || ''}). Unlock Pro with: npx ctxtop license activate <CTXP1-KEY>`,
1343
+ data: trRes
1344
+ };
1345
+ }
1346
+ if (isJson) {
1347
+ return { exitCode: 0, output: JSON.stringify(trRes, null, 2), data: trRes };
1348
+ }
1126
1349
  return {
1127
1350
  exitCode: 0,
1128
1351
  output: `[Highbeam Pro] Activated 14-day local trial (expires ${trRes.expiresAt}) -> ${trRes.licensePath}`,
@@ -1138,13 +1361,25 @@ export function runCli(args = [], options = {}) {
1138
1361
  };
1139
1362
  }
1140
1363
  const status = getProEntitlementStatus(options);
1364
+ const shadowAuto = getShadowAutoSummary({
1365
+ workspacePath: options.cwd || process.cwd(),
1366
+ proEntitlement: status,
1367
+ ...options
1368
+ });
1369
+ const outData = { ...status, shadowAuto };
1141
1370
  if (isJson) {
1142
- return { exitCode: 0, output: JSON.stringify(status, null, 2), data: status };
1371
+ return { exitCode: 0, output: JSON.stringify(outData, null, 2), data: outData };
1372
+ }
1373
+ const statusLines = [
1374
+ `[Highbeam Pro] Tier=${status.tier} | Entitled=${status.entitled} | Source=${status.source}`
1375
+ ];
1376
+ if (!status.entitled && shadowAuto.incidentCount30d > 0) {
1377
+ statusLines.push(` Auto preview (30d): ${shadowAuto.headlineText} — ${shadowAuto.sublineText}`);
1143
1378
  }
1144
1379
  return {
1145
1380
  exitCode: 0,
1146
- output: `[Highbeam Pro] Tier=${status.tier} | Entitled=${status.entitled} | Source=${status.source}`,
1147
- data: status
1381
+ output: statusLines.join('\n'),
1382
+ data: outData
1148
1383
  };
1149
1384
  }
1150
1385
 
@@ -1216,7 +1451,7 @@ export function runCli(args = [], options = {}) {
1216
1451
  const res = generateCostRadar({ ...options, demo: isDemo });
1217
1452
  fs.mkdirSync(path.dirname(target), { recursive: true });
1218
1453
  const ok = writeTextAtomic(target, res.html) !== false;
1219
- const shareSnippet = `⚡ Cost Radar: ${res.summary.retention} · ${res.summary.drift} · ${res.summary.swarm} (via npx ah-claude cost-radar)`;
1454
+ const shareSnippet = `⚡ Cost Radar: ${res.summary.retention} · ${res.summary.drift} · ${res.summary.swarm} (via npx ctxtop cost-radar)`;
1220
1455
  const data = { ok, path: target, ...res.summary, shareSnippet };
1221
1456
  if (isJson) {
1222
1457
  return { exitCode: ok ? 0 : 1, output: JSON.stringify(data, null, 2), data };
@@ -1363,9 +1598,18 @@ export function runCli(args = [], options = {}) {
1363
1598
  return { exitCode: res.ok ? 0 : 1, output: JSON.stringify(res, null, 2), data: res };
1364
1599
  }
1365
1600
  const hookDiag = res.hookDiagnostics || { recentErrorCount: 0, recentErrors: [] };
1601
+ const ccCap = res.claudeCapabilities;
1366
1602
  const lines = [
1367
1603
  `[Highbeam Doctor] Status: ${res.ok ? 'HEALTHY' : 'ISSUES DETECTED'}`,
1368
- ...res.checks.map((c) => ` [${c.ok ? 'PASS' : 'FAIL'}] ${c.id}: ${c.detail}`),
1604
+ ...res.checks.map((c) => {
1605
+ const badge = c.status || (c.ok ? 'PASS' : 'FAIL');
1606
+ return ` [${badge}] ${c.id}: ${c.detail}`;
1607
+ }),
1608
+ ...(ccCap?.found
1609
+ ? [
1610
+ ` [${ccCap.contractValid ? 'PASS' : 'WARN'}] claude_pre_model_switch: Claude Code ${ccCap.claudeVersion || 'unknown'} | PreModelSwitch=${ccCap.preModelSwitchSupported} | ask=${ccCap.supportsAskDecision} | PreEffortChange=${ccCap.preEffortChangeSummary || formatPreEffortChangeCapability(ccCap)}`
1611
+ ]
1612
+ : []),
1369
1613
  ` [${hookDiag.recentErrorCount > 0 ? 'WARN' : 'PASS'}] hook_diagnostics: ${hookDiag.recentErrorCount} recent non-fatal error(s)`
1370
1614
  ];
1371
1615
  for (const errEntry of hookDiag.recentErrors) {
@@ -1380,35 +1624,329 @@ export function runCli(args = [], options = {}) {
1380
1624
  return runStatusLineCli(args.slice(1));
1381
1625
  }
1382
1626
 
1383
- if (args.includes('--demo') || args.includes('--demo-animate') || args.includes('--roast') || args.includes('--serve')) {
1627
+ if (subcommand === 'audit') {
1628
+ const platIdx = args.indexOf('--platform');
1629
+ const platform =
1630
+ platIdx !== -1 && args[platIdx + 1]
1631
+ ? String(args[platIdx + 1]).toLowerCase()
1632
+ : (options.platform || 'all');
1633
+ const daysIdx = args.indexOf('--days');
1634
+ const days =
1635
+ daysIdx !== -1 && args[daysIdx + 1]
1636
+ ? Number(args[daysIdx + 1])
1637
+ : (options.days || 7);
1638
+ const limitIdx = args.indexOf('--limit');
1639
+ const limit =
1640
+ limitIdx !== -1 && args[limitIdx + 1]
1641
+ ? Number(args[limitIdx + 1])
1642
+ : (options.limit || 10);
1643
+
1644
+ const auditRes = runSessionAudit({
1645
+ ...options,
1646
+ platform,
1647
+ days,
1648
+ limit
1649
+ });
1650
+ if (isJson) {
1651
+ return { exitCode: 0, output: JSON.stringify(auditRes, null, 2), data: auditRes };
1652
+ }
1653
+ return { exitCode: 0, output: formatSessionAuditReport(auditRes), data: auditRes };
1654
+ }
1655
+
1656
+ if (subcommand === 'rsl') {
1657
+ const action = String(args[1] || 'status').toLowerCase();
1658
+ const readFlag = (flag, fallback) => {
1659
+ const idx = args.indexOf(flag);
1660
+ return idx !== -1 && args[idx + 1] ? String(args[idx + 1]) : fallback;
1661
+ };
1662
+ const wsRoot = path.resolve(readFlag('--cwd', options.cwd || process.cwd()));
1663
+ const platform = readFlag('--platform', options.platform || 'all').toLowerCase();
1664
+
1665
+ if (action === 'status') {
1666
+ const summary = { ok: true, platform, ...getRslSummary(wsRoot, options) };
1667
+ if (isJson) {
1668
+ return { exitCode: 0, output: JSON.stringify(summary, null, 2), data: summary };
1669
+ }
1670
+ const memNote = summary.claudeMemoryAudit?.triggered
1671
+ ? `WARN (${summary.claudeMemoryAudit.maxLines}L / ${Math.round(summary.claudeMemoryAudit.maxBytes / 1024)}KB)`
1672
+ : 'OK';
1673
+ const lines = [
1674
+ `[Highbeam RSL] Dual-Platform Self-Learning Status (platform=${platform})`,
1675
+ ` Active Carriers : ${summary.activeRules} rules · ${summary.activeSkills} skills · ${summary.promotedHooks} promoted hooks`,
1676
+ ` Rule Budget : ${summary.ruleBudgetTokens}/${summary.ruleBudgetMaxTokens} tokens (${summary.ruleBudgetPct}%)`,
1677
+ ` Rule Clashes : ${summary.clashCount || 0} conflict(s)${summary.quarantinedCount ? ` (${summary.quarantinedCount} quarantined)` : ''}`,
1678
+ ` Lifecycle Stats : ${summary.prunedCount} pruned · ${summary.taintedSessions} tainted sessions`,
1679
+ ` Claude Memory : ${memNote}`,
1680
+ ...((summary.activeClashes || []).map((c) => ` [RULE_CONFLICT] ${c.reason}`))
1681
+ ];
1682
+ return { exitCode: 0, output: lines.join('\n'), data: summary };
1683
+ }
1684
+
1685
+ if (action === 'list') {
1686
+ const includeAll = args.includes('--all') || Boolean(options.all);
1687
+ const summary = getRslSummary(wsRoot, { ...options, includeAll });
1688
+ const payload = { ok: true, includeAll, count: summary.items.length, items: summary.items };
1689
+ if (isJson) {
1690
+ return { exitCode: 0, output: JSON.stringify(payload, null, 2), data: payload };
1691
+ }
1692
+ const lines = [`[Highbeam RSL] Heuristics (${payload.count} item(s), all=${includeAll}):`];
1693
+ for (const it of summary.items) {
1694
+ lines.push(` - ${it.slug} [${it.carrier}] importance=${it.importance} status=${it.status} hook=${Boolean(it.promotedHook)}`);
1695
+ }
1696
+ return { exitCode: 0, output: lines.join('\n'), data: payload };
1697
+ }
1698
+
1699
+ if (action === 'run') {
1700
+ const mode = readFlag('--mode', options.mode || 'local').toLowerCase();
1701
+ let sessionId = readFlag('--session', options.sessionId || '');
1702
+ if (!sessionId) {
1703
+ const telemetryDir = path.join(wsRoot, '.agents', 'telemetry');
1704
+ if (fs.existsSync(telemetryDir)) {
1705
+ const candidates = fs.readdirSync(telemetryDir)
1706
+ .filter((f) => f.endsWith('.rsl_steps.jsonl'))
1707
+ .map((f) => ({ name: f.replace(/\.rsl_steps\.jsonl$/, ''), mtime: fs.statSync(path.join(telemetryDir, f)).mtimeMs }))
1708
+ .sort((a, b) => b.mtime - a.mtime);
1709
+ if (candidates[0]) sessionId = candidates[0].name;
1710
+ }
1711
+ }
1712
+ sessionId = sanitizeRslSessionId(sessionId || 'default');
1713
+ const resolvedPlatform = platform === 'auto' || platform === 'all'
1714
+ ? (options.transcriptPath && String(options.transcriptPath).includes('.claude') ? 'claude' : 'antigravity')
1715
+ : platform;
1716
+ const digest = buildContrastiveDigest(
1717
+ {
1718
+ conversationId: sessionId,
1719
+ session_id: sessionId,
1720
+ cwd: wsRoot,
1721
+ workspacePaths: [wsRoot],
1722
+ transcriptPath: readFlag('--transcript', options.transcriptPath || ''),
1723
+ artifactDirectoryPath: readFlag('--artifacts', options.artifactDirectoryPath || '')
1724
+ },
1725
+ { ...options, cwd: wsRoot, platform: resolvedPlatform }
1726
+ );
1727
+ const distillation = digest.triggered
1728
+ ? distillContrastiveDigest(digest, { mode, sdkRunner: options.sdkRunner })
1729
+ : { is_valid_learning: false, mode, heuristics: [] };
1730
+ const ledgerResult = (digest.tainted || digest.triggered || fs.existsSync(getRslLedgerPath(wsRoot)))
1731
+ ? ingestDistilledHeuristics(wsRoot, distillation, digest, options)
1732
+ : null;
1733
+ const summary = getRslSummary(wsRoot, options);
1734
+ const res = {
1735
+ ok: !digest.tainted,
1736
+ sessionId,
1737
+ platform: resolvedPlatform,
1738
+ mode: distillation.mode || mode,
1739
+ digest,
1740
+ distillation,
1741
+ ledgerResult,
1742
+ summary
1743
+ };
1744
+ if (isJson) {
1745
+ return { exitCode: res.ok ? 0 : 1, output: JSON.stringify(res, null, 2), data: res };
1746
+ }
1747
+ const msg = digest.tainted
1748
+ ? `[Highbeam RSL] Session ${sessionId} flagged ${digest.status} (${digest.taintDetails.join('; ')}) — extraction aborted.`
1749
+ : `[Highbeam RSL] Session ${sessionId} distilled (${res.mode}): +${ledgerResult?.added?.length || 0} added, ${ledgerResult?.upvoted?.length || 0} upvoted, ${ledgerResult?.pruned?.length || 0} pruned.`;
1750
+ return { exitCode: res.ok ? 0 : 1, output: msg, data: res };
1751
+ }
1752
+
1753
+ if (action === 'promote' || action === 'prune') {
1754
+ const slug = args[2] && !args[2].startsWith('-') ? args[2] : (options.slug || '');
1755
+ if (!slug) {
1756
+ const errRes = { ok: false, error: `Missing <slug> for rsl ${action}` };
1757
+ return {
1758
+ exitCode: 1,
1759
+ output: isJson ? JSON.stringify(errRes, null, 2) : `[Highbeam RSL] ERROR: ${errRes.error}`,
1760
+ data: errRes
1761
+ };
1762
+ }
1763
+ const res = action === 'promote'
1764
+ ? promoteHeuristic(wsRoot, slug, options)
1765
+ : pruneHeuristic(wsRoot, slug, options);
1766
+ if (isJson) {
1767
+ return { exitCode: res.ok ? 0 : 1, output: JSON.stringify(res, null, 2), data: res };
1768
+ }
1769
+ return {
1770
+ exitCode: res.ok ? 0 : 1,
1771
+ output: res.ok
1772
+ ? `[Highbeam RSL] ${action === 'promote' ? 'Promoted' : 'Pruned'} heuristic "${res.slug}" across .agents/ and .claude/`
1773
+ : `[Highbeam RSL] ERROR: ${res.error}`,
1774
+ data: res
1775
+ };
1776
+ }
1777
+
1778
+ const helpRsl = 'Usage: ctxtop rsl <status|list|run|promote <slug>|prune <slug>> [--platform all|antigravity|claude] [--mode local|sdk] [--json]';
1779
+ return {
1780
+ exitCode: 1,
1781
+ output: isJson ? JSON.stringify({ ok: false, error: `Unknown rsl action: ${action}` }, null, 2) : helpRsl,
1782
+ data: { ok: false }
1783
+ };
1784
+ }
1785
+
1786
+ if (subcommand === 'shield' || subcommand === 'status') {
1787
+ const platIdx = args.indexOf('--platform');
1788
+ const platform =
1789
+ platIdx !== -1 && args[platIdx + 1]
1790
+ ? String(args[platIdx + 1]).toLowerCase()
1791
+ : (options.platform || 'all');
1792
+ const linesIdx = args.indexOf('--max-lines');
1793
+ const maxUnslicedLines =
1794
+ linesIdx !== -1 && args[linesIdx + 1] ? Number(args[linesIdx + 1]) : options.maxUnslicedLines;
1795
+
1796
+ let action = 'status';
1797
+ if (subcommand === 'shield') {
1798
+ if (args.includes('--enable') || args[1] === 'enable') action = 'enable';
1799
+ else if (args.includes('--disable') || args[1] === 'disable') action = 'disable';
1800
+ else action = 'status';
1801
+ }
1802
+
1803
+ const baseRes =
1804
+ subcommand === 'status'
1805
+ ? { ok: true, action: 'status', platform, ...getShieldStatus({ ...options }) }
1806
+ : configureShield({
1807
+ ...options,
1808
+ action,
1809
+ platform,
1810
+ ...(maxUnslicedLines ? { maxUnslicedLines } : {})
1811
+ });
1812
+
1813
+ const offloadIndex =
1814
+ subcommand === 'status'
1815
+ ? getOffloadIndexStats({
1816
+ cwd: options.cwd || process.cwd(),
1817
+ homeDir: options.homeDir || getHomeDir(),
1818
+ dbPath: options.dbPath || null
1819
+ })
1820
+ : null;
1821
+ const ipcFastPath =
1822
+ subcommand === 'status'
1823
+ ? {
1824
+ pipePath: resolveFastIpcPipePath({ homeDir: options.homeDir || getHomeDir() }),
1825
+ socketPresent: (() => {
1826
+ const p = resolveFastIpcPipePath({ homeDir: options.homeDir || getHomeDir() });
1827
+ return (p && p.startsWith('\\\\.\\pipe\\')) ? null : (p ? fs.existsSync(p) : false);
1828
+ })()
1829
+ }
1830
+ : null;
1831
+ const res =
1832
+ subcommand === 'status'
1833
+ ? { ...baseRes, offloadIndex, ipcFastPath }
1834
+ : baseRes;
1835
+
1836
+ if (isJson) {
1837
+ return { exitCode: res.ok === false ? 1 : 0, output: JSON.stringify(res, null, 2), data: res };
1838
+ }
1839
+ const lines = [
1840
+ `[Highbeam Shield] Status: ${res.enabled ? 'ACTIVE' : 'PASSIVE'} (action=${res.action}, platform=${platform})`,
1841
+ ` Targets : Antigravity=${res.platforms.antigravity ? 'ON' : 'OFF'} (hooks=${res.hooksConfigured.antigravity}) | Claude=${res.platforms.claude ? 'ON' : 'OFF'} (hooks=${res.hooksConfigured.claude})`,
1842
+ ` Read Threshold: >${res.maxUnslicedLines} lines default | >${res.cliffMaxUnslicedLines} lines near pricing cliff`,
1843
+ ` Session ROI : +${res.roi.tokensSaved.toLocaleString('en-US')} tok saved ($${res.roi.dollarsSaved.toFixed(2)} USD) | ${res.roi.readsBlocked} oversized reads indexed`,
1844
+ ...(offloadIndex
1845
+ ? [
1846
+ ` Offload Index : ${offloadIndex.indexedToolLogs} FTS5 CLI logs · ${offloadIndex.indexedArtifacts} artifact(s) (query: npx ctxtop search "<keyword>")`
1847
+ ]
1848
+ : []),
1849
+ ...(res.selfTest ? [` Self-Test : ${res.selfTest.detail}`] : [])
1850
+ ];
1851
+ return { exitCode: res.ok === false ? 1 : 0, output: lines.join('\n'), data: res };
1852
+ }
1853
+
1854
+ if (subcommand === 'handoff') {
1855
+ const readFlag = (flag, fallback) => {
1856
+ const idx = args.indexOf(flag);
1857
+ return idx !== -1 && args[idx + 1] ? String(args[idx + 1]) : fallback;
1858
+ };
1859
+ const wsRoot = path.resolve(readFlag('--cwd', options.cwd || process.cwd()));
1860
+ const sessionId = readFlag('--session', options.sessionId || '');
1861
+ const result = buildConsolidatedSpecMarkdown(wsRoot, { sessionId });
1862
+ let outputPath = null;
1863
+ if (args.includes('--write') || Boolean(options.write)) {
1864
+ outputPath = path.join(wsRoot, '.agents', 'telemetry', 'CONSOLIDATED_SPEC.md');
1865
+ writeTextAtomic(outputPath, `${result.consolidatedMarkdown}\n`);
1866
+ }
1867
+ const payload = { ...result, ...(outputPath ? { outputPath } : {}) };
1868
+ return {
1869
+ exitCode: 0,
1870
+ output: isJson ? JSON.stringify(payload, null, 2) : payload.consolidatedMarkdown,
1871
+ data: payload
1872
+ };
1873
+ }
1874
+
1875
+ if (subcommand === 'mcp') {
1876
+ return import('../packages/mcp/src/server.mjs').then(({ startMcpStdioServer }) => {
1877
+ startMcpStdioServer(options);
1878
+ if (isCliMain()) {
1879
+ globalThis.process?.stdin?.resume?.();
1880
+ }
1881
+ return { exitCode: 0, output: '', data: { ok: true, mode: 'mcp' } };
1882
+ });
1883
+ }
1884
+
1885
+ if (subcommand === 'ui' || subcommand === 'serve' || args.includes('--serve')) {
1886
+ if (args.includes('--demo')) {
1887
+ process.env.HORIZON_DEMO = '1';
1888
+ }
1889
+ const shouldOpenBrowser = (subcommand === 'ui' || args.includes('--open')) && !args.includes('--no-open');
1890
+ return import('../sidecars/horizon-daemon/server.mjs').then(({ startServer }) =>
1891
+ startServer().then(({ port }) => {
1892
+ const targetUrl = `http://127.0.0.1:${port}`;
1893
+ if (shouldOpenBrowser) {
1894
+ openBrowserUrl(targetUrl);
1895
+ }
1896
+ return {
1897
+ exitCode: 0,
1898
+ output: `✓ Highbeam Web UI Live at: ${targetUrl} (Press Ctrl+C to stop)`,
1899
+ data: { ok: true, port, url: targetUrl }
1900
+ };
1901
+ })
1902
+ );
1903
+ }
1904
+
1905
+ if (args.includes('--demo') || args.includes('--demo-animate') || args.includes('--roast')) {
1384
1906
  return runLiveOrDemoCli(options);
1385
1907
  }
1386
1908
 
1387
1909
  const knownSubcommands = new Set([
1388
1910
  'init', 'install', 'uninstall', 'config', 'cost-radar', 'radar', 'panel',
1389
1911
  'receipt', 'doctor', 'statusline', 'inspect', 'control', 'postmortem',
1390
- 'license', 'pro', 'roast',
1391
- '--help', '-h', 'help', '--version', '-v', 'version'
1912
+ 'audit', 'shield', 'status', 'rsl', 'handoff', 'search', 'log-search',
1913
+ 'mcp', 'ui', 'serve', 'license', 'pro', 'roast', 'tiers', 'team-pack',
1914
+ 'verify', 'verify-checksums', '--help', '-h', 'help', '--version', '-v', 'version'
1392
1915
  ]);
1393
1916
  const hasHelp = args.length === 0 || args.includes('--help') || args.includes('-h') || subcommand === 'help';
1394
1917
  const isUnknown = !hasHelp && args.length > 0 && !knownSubcommands.has(subcommand);
1395
1918
 
1396
1919
  const helpText = [
1397
1920
  'Usage: ctxtop <command> [options]',
1398
- 'Commands:',
1399
- ' init [--antigravity | --claude | --all | --workspace | --dry-run] Zero-config dual-host installer',
1400
- ' install [--global | --project] Merge Claude Code hooks & statusLine',
1401
- ' uninstall [--global | --project] Remove Highbeam hooks',
1402
- ' doctor [--diagnostic | --json] Verify contracts or emit zero-PII report',
1403
- ' postmortem [--last N] [--json] [--demo] Analyze transcript forensics & rot',
1404
- ' receipt [--advanced | --markdown | --json] Print Simple View or Git-Commit Receipt',
1405
- ' panel [--advanced] [--out <file.html>] Write zero-socket Claude Code HTML HUD',
1406
- ' radar [--out <file.html>] [--json] [--demo] Write SVG KV-cache retention radar timeline',
1407
- ' cost-radar [--out <file.html>] [--json] (Alias for radar)',
1921
+ '',
1922
+ 'Quick Start (Zero-Write & Setup):',
1923
+ ' audit [--platform all|antigravity|claude|codex|gemini|cursor] [--days 7] [--json]',
1924
+ ' Zero-write 5-host Sludge Tax & ROI scan',
1925
+ ' init [--antigravity|--claude|--cursor|--windsurf|--codex|--gemini-cli|--mcp|--all-hosts]',
1926
+ ' Zero-config multi-host installer',
1927
+ ' ui [--open] [--demo] Launch local Simple/Advanced Web UI (127.0.0.1)',
1928
+ ' doctor [--diagnostic | --json] Verify contracts, FTS5 index & IPC readiness',
1929
+ '',
1930
+ 'Daily Cockpit & Live UX:',
1931
+ ' status [--platform all|antigravity|claude] [--json] Show Shield, FTS5 offload & Session ROI status',
1408
1932
  ' statusline [--demo] [--columns N] Responsive single-line statusline bridge',
1409
- ' config [list | set <DET-ID> <mode> | reset] Configure per-detector overrides',
1933
+ ' panel [--advanced] [--out <file.html>] Write zero-socket HTML HUD',
1934
+ ' radar [--out <file.html>] [--json] [--demo] Write SVG KV-cache retention radar timeline',
1935
+ ' postmortem [--last N] [--json] [--demo] Analyze transcript forensics & rot',
1410
1936
  ' inspect [<session-id> | --last] [--out <file.json>] Inspect session trajectory',
1411
- ' control <pause|resume|step|abort|rewind|status> Execution control plane command'
1937
+ '',
1938
+ 'Compression, Search & Multi-Host MCP:',
1939
+ ' shield <--enable | --disable | --status> [--platform all|...] Toggle Active Context Shield & read-index guard',
1940
+ ' search [<turn-id>] "<keyword>" [--limit 10] [--json] Search FTS5 offloaded CLI logs & artifacts',
1941
+ ' mcp Start zero-network 7-tool stdio MCP (@ctxtop/mcp)',
1942
+ '',
1943
+ 'Governance, RSL & FinOps:',
1944
+ ' rsl <status|list|run|promote|prune> [--platform ...] [--json] Dual-platform RSL post-mortem & rule ledger',
1945
+ ' handoff [--consolidate] [--session <id>] [--write] [--json] Consolidate sharded spec constraints & diff',
1946
+ ' receipt [--advanced | --markdown | --pdf | --json] Print Simple View, Git Receipt, or FinOps PDF',
1947
+ ' config [list | set <DET-ID> <mode> | reset] Configure per-detector overrides',
1948
+ ' control <pause|resume|step|abort|rewind|status> Execution control plane command',
1949
+ ' verify [--json] | uninstall [--global | --project] Verify checksums or remove Highbeam hooks'
1412
1950
  ].join('\n');
1413
1951
  return { exitCode: isUnknown ? 1 : 0, output: helpText, data: { help: true, isUnknown } };
1414
1952
  }