ctxtop 4.1.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 (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. 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,11 @@ import {
94
95
  inspectHookDiagnostics,
95
96
  runDoctorDiagnostics
96
97
  } from '../src/diagnostics/doctorEngine.mjs';
97
- import { inspectClaudeBinaryCapabilities } from '../src/diagnostics/claudeHookCapabilities.mjs';
98
- 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';
99
103
  import { executeStatusLineBridge, runStatusLineCli } from './ah-statusline.mjs';
100
104
  import { runSessionAudit, formatSessionAuditReport } from '../src/core/session_auditor.mjs';
101
105
  import { configureShield, getShieldStatus } from '../src/core/shield_manager.mjs';
@@ -110,6 +114,15 @@ import {
110
114
  auditWorkspaceRuleClashes,
111
115
  buildConsolidatedSpecMarkdown
112
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';
113
126
 
114
127
  export { inspectHookDiagnostics, runDoctorDiagnostics };
115
128
 
@@ -595,11 +608,11 @@ export function generateRoastCard(options = {}) {
595
608
  `│ Verified Savings : +${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)} USD saved in 30d) │`,
596
609
  '│ Top Remediation : Fence mid-session CLAUDE.md/AGENTS.md edits (DET-09) │',
597
610
  '╰────────────────────────────────────────────────────────────────────────────╯',
598
- `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`
599
612
  ].join('\n');
600
613
 
601
614
  const markdown = [
602
- '### 🔥 Highbeam Context Roast (`npx ah-claude --roast`)',
615
+ '### 🔥 Highbeam Context Roast (`npx ctxtop --roast`)',
603
616
  `- **KV-Cache Retention**: Grade **${retentionGrade}** (${retentionPct}% warmth retained)`,
604
617
  `- **Cold Prefill Leak**: **$${leakedUsd.toFixed(2)}** burned on avoidable cold switches`,
605
618
  `- **30-Day Verified Savings**: **+${savedTok.toLocaleString('en-US')} tokens ($${savedUsd.toFixed(2)} USD)**`,
@@ -730,15 +743,28 @@ export function installMcpConfig(options = {}) {
730
743
  }
731
744
 
732
745
  export function executeInitSubcommand(args = [], options = {}) {
733
- const isAntigravity = args.includes('--antigravity') || args.includes('-a');
734
- const isClaude = args.includes('--claude') || args.includes('-c');
735
- const isMcp =
736
- args.includes('--mcp') ||
737
- args.includes('--cursor') ||
738
- args.includes('--windsurf') ||
739
- Boolean(options.mcp) ||
740
- Boolean(options.cursor);
741
- 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);
742
768
  const isDryRun = args.includes('--dry-run') || Boolean(options.dryRun);
743
769
  const isWorkspace = args.includes('--workspace') || args.includes('--project') || Boolean(options.workspace);
744
770
  const isGlobal = args.includes('--global') || Boolean(options.global);
@@ -749,12 +775,13 @@ export function executeInitSubcommand(args = [], options = {}) {
749
775
  const targetParts = [];
750
776
  if (isAll || isAntigravity) targetParts.push('Google Antigravity');
751
777
  if (isAll || isClaude) targetParts.push('Claude Code');
752
- 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(', ')})`);
753
780
  const targetLabel =
754
- targetParts.length === 2 && !isMcp ? targetParts.join(' & ') : targetParts.join(', ');
781
+ targetParts.length === 2 && !hasMcpTarget ? targetParts.join(' & ') : targetParts.join(', ');
755
782
 
756
783
  const lines = [
757
- `\x1b[1m\x1b[38;5;51m⚡ Highbeam (ctxtop v4.1.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`,
758
785
  ` • Target Harnesses : ${targetLabel}`,
759
786
  ` • Installation Scope: ${isWorkspace ? 'Workspace' : 'Global'}${isDryRun ? ' [DRY RUN]' : ''}`
760
787
  ];
@@ -762,6 +789,7 @@ export function executeInitSubcommand(args = [], options = {}) {
762
789
  let claudeResult = null;
763
790
  let antigravityResult = null;
764
791
  let mcpResult = null;
792
+ let hostMcpResult = null;
765
793
 
766
794
  if (isClaude || isAll) {
767
795
  const scope = isGlobal ? 'global' : 'project';
@@ -803,7 +831,7 @@ export function executeInitSubcommand(args = [], options = {}) {
803
831
  }
804
832
  }
805
833
 
806
- if (isMcp) {
834
+ if (isLegacyMcp) {
807
835
  mcpResult = installMcpConfig({
808
836
  ...options,
809
837
  global: isGlobal,
@@ -815,28 +843,112 @@ export function executeInitSubcommand(args = [], options = {}) {
815
843
  );
816
844
  }
817
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
+
818
864
  const ok =
819
865
  (claudeResult ? claudeResult.ok : true) &&
820
866
  (antigravityResult ? antigravityResult.ok : true) &&
821
- (mcpResult ? mcpResult.ok : true);
867
+ (mcpResult ? mcpResult.ok : true) &&
868
+ (hostMcpResult ? hostMcpResult.ok : true);
822
869
  return {
823
870
  ok,
824
871
  exitCode: ok ? 0 : 1,
825
872
  output: lines.join('\n'),
826
- 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
+ }
827
880
  };
828
881
  }
829
882
 
830
883
  export function runCli(args = [], options = {}) {
831
- const subcommand = String(args[0] || 'doctor').toLowerCase();
832
- const isGlobal = args.includes('--global') || args.includes('-g');
833
- const isJson = args.includes('--json') || Boolean(options.json);
834
- const isMarkdown = args.includes('--markdown') || args.includes('--md') || args.includes('--git');
835
- 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');
836
894
  const scope = isGlobal ? 'global' : 'project';
837
895
 
838
- if (args.includes('--version') || args.includes('-v') || subcommand === 'version') {
839
- return { exitCode: 0, output: '4.1.0', data: { version: '4.1.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
+ });
840
952
  }
841
953
 
842
954
  if (subcommand === 'inspect') {
@@ -1073,7 +1185,15 @@ export function runCli(args = [], options = {}) {
1073
1185
  }
1074
1186
 
1075
1187
  if (subcommand === 'init') {
1076
- 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;
1077
1197
  }
1078
1198
 
1079
1199
  if (subcommand === 'install') {
@@ -1213,6 +1333,19 @@ export function runCli(args = [], options = {}) {
1213
1333
  }
1214
1334
  if (action === 'trial') {
1215
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
+ }
1216
1349
  return {
1217
1350
  exitCode: 0,
1218
1351
  output: `[Highbeam Pro] Activated 14-day local trial (expires ${trRes.expiresAt}) -> ${trRes.licensePath}`,
@@ -1228,13 +1361,25 @@ export function runCli(args = [], options = {}) {
1228
1361
  };
1229
1362
  }
1230
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 };
1231
1370
  if (isJson) {
1232
- 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}`);
1233
1378
  }
1234
1379
  return {
1235
1380
  exitCode: 0,
1236
- output: `[Highbeam Pro] Tier=${status.tier} | Entitled=${status.entitled} | Source=${status.source}`,
1237
- data: status
1381
+ output: statusLines.join('\n'),
1382
+ data: outData
1238
1383
  };
1239
1384
  }
1240
1385
 
@@ -1306,7 +1451,7 @@ export function runCli(args = [], options = {}) {
1306
1451
  const res = generateCostRadar({ ...options, demo: isDemo });
1307
1452
  fs.mkdirSync(path.dirname(target), { recursive: true });
1308
1453
  const ok = writeTextAtomic(target, res.html) !== false;
1309
- 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)`;
1310
1455
  const data = { ok, path: target, ...res.summary, shareSnippet };
1311
1456
  if (isJson) {
1312
1457
  return { exitCode: ok ? 0 : 1, output: JSON.stringify(data, null, 2), data };
@@ -1462,7 +1607,7 @@ export function runCli(args = [], options = {}) {
1462
1607
  }),
1463
1608
  ...(ccCap?.found
1464
1609
  ? [
1465
- ` [${ccCap.contractValid ? 'PASS' : 'WARN'}] claude_pre_model_switch: Claude Code ${ccCap.claudeVersion || 'unknown'} | PreModelSwitch=${ccCap.preModelSwitchSupported} | ask=${ccCap.supportsAskDecision} | PreEffortChange=${ccCap.preEffortChangeSupported}`
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)}`
1466
1611
  ]
1467
1612
  : []),
1468
1613
  ` [${hookDiag.recentErrorCount > 0 ? 'WARN' : 'PASS'}] hook_diagnostics: ${hookDiag.recentErrorCount} recent non-fatal error(s)`
@@ -1655,7 +1800,7 @@ export function runCli(args = [], options = {}) {
1655
1800
  else action = 'status';
1656
1801
  }
1657
1802
 
1658
- const res =
1803
+ const baseRes =
1659
1804
  subcommand === 'status'
1660
1805
  ? { ok: true, action: 'status', platform, ...getShieldStatus({ ...options }) }
1661
1806
  : configureShield({
@@ -1665,6 +1810,29 @@ export function runCli(args = [], options = {}) {
1665
1810
  ...(maxUnslicedLines ? { maxUnslicedLines } : {})
1666
1811
  });
1667
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
+
1668
1836
  if (isJson) {
1669
1837
  return { exitCode: res.ok === false ? 1 : 0, output: JSON.stringify(res, null, 2), data: res };
1670
1838
  }
@@ -1673,6 +1841,11 @@ export function runCli(args = [], options = {}) {
1673
1841
  ` Targets : Antigravity=${res.platforms.antigravity ? 'ON' : 'OFF'} (hooks=${res.hooksConfigured.antigravity}) | Claude=${res.platforms.claude ? 'ON' : 'OFF'} (hooks=${res.hooksConfigured.claude})`,
1674
1842
  ` Read Threshold: >${res.maxUnslicedLines} lines default | >${res.cliffMaxUnslicedLines} lines near pricing cliff`,
1675
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
+ : []),
1676
1849
  ...(res.selfTest ? [` Self-Test : ${res.selfTest.detail}`] : [])
1677
1850
  ];
1678
1851
  return { exitCode: res.ok === false ? 1 : 0, output: lines.join('\n'), data: res };
@@ -1699,41 +1872,81 @@ export function runCli(args = [], options = {}) {
1699
1872
  };
1700
1873
  }
1701
1874
 
1702
- if (args.includes('--demo') || args.includes('--demo-animate') || args.includes('--roast') || args.includes('--serve')) {
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')) {
1703
1906
  return runLiveOrDemoCli(options);
1704
1907
  }
1705
1908
 
1706
1909
  const knownSubcommands = new Set([
1707
1910
  'init', 'install', 'uninstall', 'config', 'cost-radar', 'radar', 'panel',
1708
1911
  'receipt', 'doctor', 'statusline', 'inspect', 'control', 'postmortem',
1709
- 'audit', 'shield', 'status', 'rsl', 'handoff',
1710
- 'license', 'pro', 'roast',
1711
- '--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'
1712
1915
  ]);
1713
1916
  const hasHelp = args.length === 0 || args.includes('--help') || args.includes('-h') || subcommand === 'help';
1714
1917
  const isUnknown = !hasHelp && args.length > 0 && !knownSubcommands.has(subcommand);
1715
1918
 
1716
1919
  const helpText = [
1717
1920
  'Usage: ctxtop <command> [options]',
1718
- 'Commands:',
1719
- ' init [--antigravity | --claude | --all | --workspace | --dry-run] Zero-config dual-host installer',
1720
- ' audit [--platform all|antigravity|claude] [--days 7] [--json] Zero-write historical Sludge Tax & ROI audit',
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',
1932
+ ' statusline [--demo] [--columns N] Responsive single-line statusline bridge',
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',
1936
+ ' inspect [<session-id> | --last] [--out <file.json>] Inspect session trajectory',
1937
+ '',
1938
+ 'Compression, Search & Multi-Host MCP:',
1721
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:',
1722
1944
  ' rsl <status|list|run|promote|prune> [--platform ...] [--json] Dual-platform RSL post-mortem & rule ledger',
1723
1945
  ' handoff [--consolidate] [--session <id>] [--write] [--json] Consolidate sharded spec constraints & diff',
1724
- ' status [--platform all|antigravity|claude] [--json] Show Shield & Session ROI status',
1725
- ' install [--global | --project] Merge Claude Code hooks & statusLine',
1726
- ' uninstall [--global | --project] Remove Highbeam hooks',
1727
- ' doctor [--diagnostic | --json] Verify contracts or emit zero-PII report',
1728
- ' postmortem [--last N] [--json] [--demo] Analyze transcript forensics & rot',
1729
- ' receipt [--advanced | --markdown | --json] Print Simple View or Git-Commit Receipt',
1730
- ' panel [--advanced] [--out <file.html>] Write zero-socket Claude Code HTML HUD',
1731
- ' radar [--out <file.html>] [--json] [--demo] Write SVG KV-cache retention radar timeline',
1732
- ' cost-radar [--out <file.html>] [--json] (Alias for radar)',
1733
- ' statusline [--demo] [--columns N] Responsive single-line statusline bridge',
1734
- ' config [list | set <DET-ID> <mode> | reset] Configure per-detector overrides',
1735
- ' inspect [<session-id> | --last] [--out <file.json>] Inspect session trajectory',
1736
- ' control <pause|resume|step|abort|rewind|status> Execution control plane command'
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'
1737
1950
  ].join('\n');
1738
1951
  return { exitCode: isUnknown ? 1 : 0, output: helpText, data: { help: true, isUnknown } };
1739
1952
  }