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
@@ -729,6 +729,50 @@ export function deriveClaudeCodeVerdictAndActions(state = {}, grid, metrics, opt
729
729
  });
730
730
  }
731
731
 
732
+ const rslData = options.rsl || state.rsl || null;
733
+ if (rslData && Number(rslData.clashCount || 0) > 0) {
734
+ if (verdict.severity === 'healthy') {
735
+ verdict = {
736
+ severity: 'warn',
737
+ badge: 'RULE CLASH',
738
+ headline: `${rslData.clashCount} Conflicting Learned Rule${rslData.clashCount === 1 ? '' : 's'}`,
739
+ detail: 'Quarantined RSL heuristic conflict needs review before applying automatically'
740
+ };
741
+ }
742
+ actions.push({
743
+ id: 'rsl-clash',
744
+ severity: 'warn',
745
+ title: `Resolve ${rslData.clashCount} RSL rule clash${rslData.clashCount === 1 ? '' : 'es'}`,
746
+ instruction: 'Run `npx ah rsl status` to inspect and resolve conflicting workspace heuristics.',
747
+ commandHint: 'npx ah rsl status',
748
+ reclaimTokens: 0
749
+ });
750
+ }
751
+
752
+ const shardedSpec = options.shardedSpec || state.shardedSpec || null;
753
+ if (shardedSpec && shardedSpec.sharded) {
754
+ actions.push({
755
+ id: 'sharded-spec',
756
+ severity: 'warn',
757
+ title: `Consolidate ${Number(shardedSpec.count || 2)} sharded specification files`,
758
+ instruction: 'Run `npx ah handoff --consolidate` so split constraints stay anchored in Turn 0.',
759
+ commandHint: 'npx ah handoff --consolidate',
760
+ reclaimTokens: 0
761
+ });
762
+ }
763
+
764
+ const shieldData = options.shield || state.shield || null;
765
+ if (shieldData && (shieldData.quarantined || shieldData.alert)) {
766
+ actions.push({
767
+ id: 'shield-firewall',
768
+ severity: 'warn',
769
+ title: 'Prefix-cache Shield held a mutation',
770
+ instruction: 'Inspect queued prefix updates with `npx ah doctor` before modifying rules mid-chat.',
771
+ commandHint: 'npx ah doctor',
772
+ reclaimTokens: 0
773
+ });
774
+ }
775
+
732
776
  if (actions.length === 0) {
733
777
  actions.push({
734
778
  id: 'keep-coding',
@@ -1259,10 +1303,19 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1259
1303
 
1260
1304
  // Section 3: Circuit Breakers (DET-01..32), Thinking Drift & Prefix Retention
1261
1305
  const activeBreakerId =
1262
- options.breakerVerdict?.detectorId || options.breakerVerdict?.ruleId || null;
1306
+ options.breakerVerdict?.detectorId ||
1307
+ options.breakerVerdict?.ruleId ||
1308
+ state.coachState?.detectors?.tripped?.detectorId ||
1309
+ state.circuitBreakerTripped?.detectorId ||
1310
+ null;
1311
+ const activeBreakerReason =
1312
+ options.breakerVerdict?.reason ||
1313
+ state.coachState?.detectors?.tripped?.reason ||
1314
+ state.circuitBreakerTripped?.reason ||
1315
+ 'active';
1263
1316
  const sec3Lines = [
1264
1317
  `[Section 3] Circuit Breakers (DET-01..32), Thinking Drift & Retention`,
1265
- `Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${options.breakerVerdict?.reason || 'active'})` : 'None (32 guards nominal)'}`,
1318
+ `Flight Mode: ${metrics.flightMode} | Active Trigger: ${activeBreakerId ? `${activeBreakerId} (${activeBreakerReason})` : 'None (32 guards nominal)'}`,
1266
1319
  `Prefix Retention: ${formatRetentionLabel(state.prefixRetention)}`,
1267
1320
  `Thinking Drift (DET-30): ${formatDriftLabel(state.thinkingDrift)}`,
1268
1321
  `Haiku 100k 5x Cliff (DET-12): ${state.cliffTriggered ? 'EXCEEDED (5x step-up)' : state.preCliffWarningTriggered ? 'PRE-CLIFF WARNING (>= 90k)' : 'Nominal'}`
@@ -1285,7 +1338,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1285
1338
  // Section 5: PreCompact State Baton & Session Forensics
1286
1339
  const sec5Lines = [
1287
1340
  `[Section 5] PreCompact State Baton & Claude Code Forensics`,
1288
- `Session ID: ${state.sessionId || 'default'} | Completed Turns: ${Number(state.turnsCompleted || 0)}`,
1341
+ `Session ID: ${state.sessionId || 'default'} | Completed Turns: ${Number(state.turnsCompleted ?? state.window?.turnCount ?? state.sessionTimeline?.totalTurns ?? 0)}`,
1289
1342
  `Zoom Tier : ${grid.zoomTier.label} (${grid.zoomTier.tokensPerCell.toLocaleString('en-US')} tok/cell)`,
1290
1343
  `State Baton: Auto-flushed on PreCompact to .claude/cache/HANDOFF_LATEST.md`,
1291
1344
  `CLI Tools : npx ctxtop statusline | npx ctxtop radar | npx ctxtop inspect | npx ctxtop doctor`
@@ -1307,7 +1360,7 @@ export function renderAdvancedViewPane(state = {}, options = {}) {
1307
1360
  {
1308
1361
  sectionNumber: 3,
1309
1362
  id: 'circuit-breakers-drift',
1310
- title: 'Circuit Breakers (DET-01..21), Thinking Drift & Retention',
1363
+ title: 'Circuit Breakers (DET-01..32), Thinking Drift & Retention',
1311
1364
  lines: sec3Lines
1312
1365
  },
1313
1366
  {
@@ -1441,15 +1494,16 @@ export function renderStatusLine(state = {}, options = {}) {
1441
1494
  const rslTok = layoutTier !== 'compact-80' && rslData ? formatRslStatusSegment(rslData) : '';
1442
1495
  const rslStr = rslTok ? ` · ${rslTok}` : '';
1443
1496
 
1497
+ const prefix = options.legacyPrefix ? 'AH' : 'HB';
1444
1498
  let p = '';
1445
1499
  let a = '';
1446
1500
  if (layoutTier === 'compact-80') {
1447
- p = `AH ${g.bracketedBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1448
- a = `AH ${g.ansiCodeBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1501
+ p = `${prefix} ${g.bracketedBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1502
+ a = `${prefix} ${g.ansiCodeBar} ${tokStr} C:${metrics.cacheHitPct}% ${ttlStr} ${pill}${loopStr} ${savedStr}`;
1449
1503
  } else {
1450
1504
  const shortModel = g.modelId.replace(/^claude-/, '');
1451
- p = `AH ${g.bracketedBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
1452
- a = `AH ${g.ansiCodeBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
1505
+ p = `${prefix} ${g.bracketedBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
1506
+ a = `${prefix} ${g.ansiCodeBar} ${shortModel} ${tokStr} (${g.utilizationPct}%) · Cache ${metrics.cacheHitPct}% (${ttlStr})${retStr} · ${pill}${loopStr} · Saved ${savedStr}${swarmStr}${rslStr}`;
1453
1507
  }
1454
1508
 
1455
1509
  chosenGrid = g;
@@ -199,6 +199,23 @@ function scanBinaryMarkersChunked(binPath) {
199
199
  return foundFlags;
200
200
  }
201
201
 
202
+ /**
203
+ * Formats `PreEffortChange` capability into a clear human-readable doctor status string
204
+ * without altering the boolean `preEffortChangeSupported` API contract.
205
+ *
206
+ * @param {{ preEffortChangeSupported?: boolean | null }} [cap={}]
207
+ * @returns {string}
208
+ */
209
+ export function formatPreEffortChangeCapability(cap = {}) {
210
+ if (cap?.preEffortChangeSupported === true) {
211
+ return 'true';
212
+ }
213
+ if (cap?.preEffortChangeSupported === false) {
214
+ return 'n/a (ConfigChange + turn-boundary active; 5.5+ cache-safe)';
215
+ }
216
+ return 'unknown';
217
+ }
218
+
202
219
  /**
203
220
  * Inspects the installed Claude Code CLI/bundle for `PreModelSwitch` support and contract parity.
204
221
  *
@@ -210,6 +227,7 @@ function scanBinaryMarkersChunked(binPath) {
210
227
  * preModelSwitchSupported: boolean | null,
211
228
  * postModelSwitchSupported: boolean | null,
212
229
  * preEffortChangeSupported: boolean | null,
230
+ * preEffortChangeSummary: string | null,
213
231
  * supportsAskDecision: boolean | null,
214
232
  * sdkSetModelHooked: boolean | null,
215
233
  * payloadKeys: { from_model: boolean, to_model: boolean, prompt_cache_warm: boolean, context_tokens: boolean } | null,
@@ -229,6 +247,7 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
229
247
  preModelSwitchSupported: null,
230
248
  postModelSwitchSupported: null,
231
249
  preEffortChangeSupported: null,
250
+ preEffortChangeSummary: null,
232
251
  supportsAskDecision: null,
233
252
  sdkSetModelHooked: null,
234
253
  payloadKeys: null,
@@ -241,7 +260,8 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
241
260
  let stat;
242
261
  try {
243
262
  stat = fs.statSync(binPath);
244
- } catch {
263
+ } catch (err) {
264
+ void err;
245
265
  return {
246
266
  found: false,
247
267
  binaryPath: null,
@@ -249,6 +269,7 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
249
269
  preModelSwitchSupported: null,
250
270
  postModelSwitchSupported: null,
251
271
  preEffortChangeSupported: null,
272
+ preEffortChangeSummary: null,
252
273
  supportsAskDecision: null,
253
274
  sdkSetModelHooked: null,
254
275
  payloadKeys: null,
@@ -272,7 +293,12 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
272
293
  cached.result &&
273
294
  typeof cached.result.contractValid === 'boolean'
274
295
  ) {
275
- return { ...cached.result, cached: true };
296
+ return {
297
+ ...cached.result,
298
+ preEffortChangeSummary:
299
+ cached.result.preEffortChangeSummary || formatPreEffortChangeCapability(cached.result),
300
+ cached: true
301
+ };
276
302
  }
277
303
  }
278
304
 
@@ -313,6 +339,9 @@ export function inspectClaudeBinaryCapabilities(options = {}) {
313
339
  preModelSwitchSupported: markers.preModelSwitchSupported,
314
340
  postModelSwitchSupported: markers.postModelSwitchSupported,
315
341
  preEffortChangeSupported: markers.preEffortChangeSupported,
342
+ preEffortChangeSummary: formatPreEffortChangeCapability({
343
+ preEffortChangeSupported: markers.preEffortChangeSupported
344
+ }),
316
345
  supportsAskDecision,
317
346
  sdkSetModelHooked: markers.sdkSetModelHooked,
318
347
  payloadKeys,
@@ -391,6 +420,7 @@ export function extractClaudeSelectableModelsFromBinary(binPath) {
391
420
 
392
421
  export default {
393
422
  resolveClaudeBinaryPath,
423
+ formatPreEffortChangeCapability,
394
424
  inspectClaudeBinaryCapabilities,
395
425
  extractClaudeSelectableModelsFromBinary
396
426
  };
@@ -26,6 +26,8 @@ import { auditAntigravityRulesIntegrity } from '../core/layer5_hygiene.mjs';
26
26
  import { auditClaudeAutoMemory } from '../core/shield_manager.mjs';
27
27
  import { auditProseRuleHookCandidates } from '../core/bucket_b_runtime.mjs';
28
28
  import { auditWorkspaceRuleClashes } from '../core/rsl_clash_auditor.mjs';
29
+ import { getOffloadIndexStats } from '../core/fts5_output_compressor.mjs';
30
+ import { resolveFastIpcPipePath } from '../engine-node/ipc/fast_client.mjs';
29
31
 
30
32
  /**
31
33
  * Redacts the user's OS home directory from any diagnostic string.
@@ -95,7 +97,7 @@ export function inspectHookDiagnostics(options = {}) {
95
97
  }
96
98
 
97
99
  /**
98
- * Runs host contract & runtime diagnostic checks (`npx ah-claude doctor`).
100
+ * Runs host contract & runtime diagnostic checks (`npx ctxtop doctor`).
99
101
  *
100
102
  * @param {object} [options={}]
101
103
  * @returns {{
@@ -273,6 +275,28 @@ export function runDoctorDiagnostics(options = {}) {
273
275
  memoryRuleIntegrity.ok &&
274
276
  (!options.strictClaudeCheck || Boolean(claudeCapabilities.found && claudeCapabilities.contractValid));
275
277
 
278
+ let offloadIndex = { indexedToolLogs: 0, indexedArtifacts: 0, dbExists: false };
279
+ try {
280
+ offloadIndex = getOffloadIndexStats({
281
+ cwd,
282
+ homeDir: options.homeDir,
283
+ dbPath: options.toolLogsDbPath || null
284
+ });
285
+ } catch (offloadErr) {
286
+ void offloadErr;
287
+ }
288
+
289
+ let ipcFastPath = { pipePath: '', socketPresent: null };
290
+ try {
291
+ const pipePath = resolveFastIpcPipePath({ homeDir: options.homeDir });
292
+ ipcFastPath = {
293
+ pipePath: redactDoctorPaths(pipePath, options.homeDir),
294
+ socketPresent: pipePath.startsWith('\\\\.\\pipe\\') ? null : fs.existsSync(pipePath)
295
+ };
296
+ } catch (ipcErr) {
297
+ void ipcErr;
298
+ }
299
+
276
300
  return {
277
301
  ok,
278
302
  nodeVersion,
@@ -284,7 +308,9 @@ export function runDoctorDiagnostics(options = {}) {
284
308
  memoryRuleIntegrity,
285
309
  proseHookCandidates,
286
310
  rslRuleClashes: rslClashAudit.clashCount,
287
- rslClashes: rslClashAudit.clashes.slice(0, 5)
311
+ rslClashes: rslClashAudit.clashes.slice(0, 5),
312
+ offloadIndex,
313
+ ipcFastPath
288
314
  };
289
315
  }
290
316
 
@@ -0,0 +1,191 @@
1
+ /**
2
+ * @file src/engine-node/ipc/fast_client.mjs
3
+ * Minimal zero-heavy-dependency JSON-RPC client for warm Horizon Daemon IPC checks.
4
+ *
5
+ * Imports strictly Node built-ins (`node:fs`, `node:path`, `node:os`, `node:net`) so
6
+ * thin Tier-2 CLI hook shells avoid loading heavyweight ESM trees when probing or
7
+ * dispatching directly over the warm daemon socket/pipe.
8
+ */
9
+
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+ import os from 'node:os';
13
+ import net from 'node:net';
14
+
15
+ function normalizeHomePath(raw = '') {
16
+ return String(raw || '')
17
+ .trim()
18
+ .replace(/\\/g, '/')
19
+ .replace(/\/+$/, '');
20
+ }
21
+
22
+ /**
23
+ * Ensures tests that isolate `HOME`/`USERPROFILE` to temporary sandboxes never
24
+ * auto-connect to a developer's live host daemon pipe unless `CTXTOP_IPC_PATH`
25
+ * is explicitly specified.
26
+ *
27
+ * @param {object} [env=process.env]
28
+ * @returns {boolean}
29
+ */
30
+ export function isRealHostHomeEnv(env = process.env) {
31
+ if (env && typeof env.CTXTOP_IPC_PATH === 'string' && env.CTXTOP_IPC_PATH.trim()) {
32
+ return true;
33
+ }
34
+ const envHome = normalizeHomePath(env?.USERPROFILE || env?.HOME || '');
35
+ if (!envHome) return true;
36
+ let realHome = '';
37
+ try {
38
+ realHome = normalizeHomePath(os.userInfo()?.homedir || '');
39
+ } catch (err) {
40
+ void err;
41
+ return true;
42
+ }
43
+ if (!realHome) return true;
44
+ if (process.platform === 'win32') {
45
+ return envHome.toLowerCase() === realHome.toLowerCase();
46
+ }
47
+ return envHome === realHome;
48
+ }
49
+
50
+ /**
51
+ * Mirrors `resolveIpcPath` from `src/engine-node/ipc/protocol.mjs` without loading it.
52
+ *
53
+ * @param {object} [options={}]
54
+ * @returns {string | null}
55
+ */
56
+ export function resolveFastIpcPipePath(options = {}) {
57
+ if (options.ipcPath || process.env.CTXTOP_IPC_PATH) {
58
+ return options.ipcPath || process.env.CTXTOP_IPC_PATH;
59
+ }
60
+
61
+ if (process.platform === 'win32') {
62
+ let rawUser = process.env.USERNAME || process.env.USER;
63
+ if (!rawUser) {
64
+ try {
65
+ rawUser = typeof os.userInfo === 'function' ? os.userInfo()?.username : null;
66
+ } catch (err) {
67
+ void err;
68
+ rawUser = null;
69
+ }
70
+ }
71
+ const cleanUser = String(rawUser || 'default').replace(/[^a-zA-Z0-9_-]/g, '_');
72
+ return `\\\\.\\pipe\\ctxtop-${cleanUser}`;
73
+ }
74
+
75
+ const homeDir = options.homeDir || process.env.HOME || os.homedir() || '/tmp';
76
+ return path.join(homeDir, '.ctxtop', 'daemon.sock');
77
+ }
78
+
79
+ /**
80
+ * Attempts a single fast JSON-RPC call to the warm Horizon Daemon pipe.
81
+ * Returns `parsed.result` strictly when `result?.fullVerdict === true`, otherwise `null`.
82
+ * Never writes to stderr and never throws.
83
+ *
84
+ * @param {string} method
85
+ * @param {object} [params={}]
86
+ * @param {object} [options={}]
87
+ * @returns {Promise<object | null>}
88
+ */
89
+ export function tryFastDaemonRpc(method, params = {}, options = {}) {
90
+ if (!options.ipcPath && !process.env.CTXTOP_IPC_PATH && !isRealHostHomeEnv()) {
91
+ return Promise.resolve(null);
92
+ }
93
+ const pipePath = resolveFastIpcPipePath(options);
94
+ if (!pipePath || (process.platform !== 'win32' && !fs.existsSync(pipePath))) {
95
+ return Promise.resolve(null);
96
+ }
97
+
98
+ const connectTimeoutMs = Math.max(1, Number(options.connectTimeoutMs ?? 12));
99
+ const requestTimeoutMs = Math.max(20, Number(options.requestTimeoutMs ?? 5000));
100
+
101
+ return new Promise((resolve) => {
102
+ let settled = false;
103
+ let connected = false;
104
+ let socket = null;
105
+ let connectTimer = null;
106
+ let requestTimer = null;
107
+ let buffer = '';
108
+
109
+ const settle = (val) => {
110
+ if (settled) return;
111
+ settled = true;
112
+ if (connectTimer) {
113
+ clearTimeout(connectTimer);
114
+ connectTimer = null;
115
+ }
116
+ if (requestTimer) {
117
+ clearTimeout(requestTimer);
118
+ requestTimer = null;
119
+ }
120
+ if (socket) {
121
+ try {
122
+ socket.removeAllListeners();
123
+ socket.destroy();
124
+ } catch (cleanupErr) {
125
+ void cleanupErr;
126
+ }
127
+ }
128
+ resolve(val);
129
+ };
130
+
131
+ try {
132
+ socket = net.connect(pipePath);
133
+ } catch (connErr) {
134
+ void connErr;
135
+ settle(null);
136
+ return;
137
+ }
138
+
139
+ connectTimer = setTimeout(() => {
140
+ if (!connected) settle(null);
141
+ }, connectTimeoutMs);
142
+
143
+ requestTimer = setTimeout(() => {
144
+ settle(null);
145
+ }, requestTimeoutMs);
146
+
147
+ socket.once('connect', () => {
148
+ connected = true;
149
+ if (connectTimer) {
150
+ clearTimeout(connectTimer);
151
+ connectTimer = null;
152
+ }
153
+ try {
154
+ const frame = JSON.stringify({ jsonrpc: '2.0', id: 1, method: String(method), params }) + '\n';
155
+ socket.write(frame);
156
+ } catch (writeErr) {
157
+ void writeErr;
158
+ settle(null);
159
+ }
160
+ });
161
+
162
+ socket.on('data', (chunk) => {
163
+ buffer += chunk.toString('utf8');
164
+ if (buffer.length > 2 * 1024 * 1024) {
165
+ settle(null);
166
+ return;
167
+ }
168
+ const nlIdx = buffer.indexOf('\n');
169
+ if (nlIdx === -1) return;
170
+ const line = buffer.slice(0, nlIdx).trim();
171
+ if (!line) {
172
+ buffer = buffer.slice(nlIdx + 1);
173
+ return;
174
+ }
175
+ try {
176
+ const parsed = JSON.parse(line);
177
+ if (parsed && !parsed.error && parsed.result && parsed.result.fullVerdict === true) {
178
+ settle(parsed.result);
179
+ } else {
180
+ settle(null);
181
+ }
182
+ } catch (parseErr) {
183
+ void parseErr;
184
+ settle(null);
185
+ }
186
+ });
187
+
188
+ socket.once('error', () => settle(null));
189
+ socket.once('close', () => settle(null));
190
+ });
191
+ }
@@ -17,6 +17,8 @@ export {
17
17
  MicroIpcClient
18
18
  } from './client.mjs';
19
19
 
20
+ export * from './fast_client.mjs';
21
+
20
22
  export {
21
23
  MicroIpcServer
22
24
  } from './server.mjs';
@@ -0,0 +1,168 @@
1
+ /**
2
+ * @file src/core/shared/multi_host_mcp.mjs
3
+ * Zero-network idempotent MCP client configuration installer for multi-host parity
4
+ * across Cursor, Windsurf, OpenAI Codex CLI, Gemini CLI, and generic `.mcp.json` hosts.
5
+ */
6
+
7
+ import fs from 'node:fs';
8
+ import path from 'node:path';
9
+ import os from 'node:os';
10
+
11
+ export const SUPPORTED_MCP_HOSTS = Object.freeze([
12
+ 'cursor',
13
+ 'windsurf',
14
+ 'codex',
15
+ 'gemini-cli',
16
+ 'generic'
17
+ ]);
18
+
19
+ const CODEX_TOML_SNIPPET = [
20
+ '[mcp_servers.highbeam]',
21
+ 'command = "npx"',
22
+ 'args = ["-y", "ctxtop", "mcp"]'
23
+ ].join('\n');
24
+
25
+ function resolveHome(options = {}) {
26
+ return (
27
+ options.homeDir ||
28
+ options.home ||
29
+ process.env.USERPROFILE ||
30
+ process.env.HOME ||
31
+ os.homedir()
32
+ );
33
+ }
34
+
35
+ function readJsonObjectSafe(filePath) {
36
+ if (!fs.existsSync(filePath)) return {};
37
+ try {
38
+ const raw = fs.readFileSync(filePath, 'utf8').trim();
39
+ if (!raw) return {};
40
+ const parsed = JSON.parse(raw);
41
+ if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
42
+ return parsed;
43
+ }
44
+ } catch (err) {
45
+ void err;
46
+ }
47
+ return {};
48
+ }
49
+
50
+ function writeJsonAtomicSafe(filePath, obj) {
51
+ const dir = path.dirname(filePath);
52
+ fs.mkdirSync(dir, { recursive: true });
53
+ const tmpPath = path.join(dir, `.${path.basename(filePath)}.tmp.${process.pid}`);
54
+ fs.writeFileSync(tmpPath, JSON.stringify(obj, null, 2) + '\n', 'utf8');
55
+ fs.renameSync(tmpPath, filePath);
56
+ }
57
+
58
+ export function normalizeMcpHostName(rawHost = '') {
59
+ const cleaned = String(rawHost || '').trim().toLowerCase();
60
+ if (cleaned === 'gemini' || cleaned === 'gemini-cli') return 'gemini-cli';
61
+ if (cleaned === 'mcp' || cleaned === 'generic') return 'generic';
62
+ if (SUPPORTED_MCP_HOSTS.includes(cleaned)) return cleaned;
63
+ return null;
64
+ }
65
+
66
+ /**
67
+ * Resolves the MCP config path for a supported AI host.
68
+ * Strictly avoids auth credential files such as `oauth_creds.json`.
69
+ */
70
+ export function resolveHostMcpConfigPath(host, { cwd = process.cwd(), homeDir, global = false } = {}) {
71
+ const normalized = normalizeMcpHostName(host) || 'generic';
72
+ const home = resolveHome({ homeDir });
73
+ const workspaceRoot = path.resolve(cwd);
74
+
75
+ if (normalized === 'cursor') {
76
+ return global
77
+ ? path.join(home, '.cursor', 'mcp.json')
78
+ : path.join(workspaceRoot, '.cursor', 'mcp.json');
79
+ }
80
+ if (normalized === 'windsurf') {
81
+ return global
82
+ ? path.join(home, '.codeium', 'windsurf', 'mcp_config.json')
83
+ : path.join(workspaceRoot, '.windsurf', 'mcp.json');
84
+ }
85
+ if (normalized === 'gemini-cli') {
86
+ return global
87
+ ? path.join(home, '.gemini', 'settings.json')
88
+ : path.join(workspaceRoot, '.gemini', 'settings.json');
89
+ }
90
+ if (normalized === 'codex') {
91
+ return global
92
+ ? path.join(home, '.codex', 'mcp.json')
93
+ : path.join(workspaceRoot, '.codex', 'mcp.json');
94
+ }
95
+ return path.join(workspaceRoot, '.mcp.json');
96
+ }
97
+
98
+ /**
99
+ * Idempotently installs `{ command: 'npx', args: ['-y', 'ctxtop', 'mcp'] }` under `mcpServers.highbeam`
100
+ * while preserving all existing host settings and third-party MCP servers.
101
+ */
102
+ export function installHostMcpConfig({
103
+ hosts = ['generic'],
104
+ cwd = process.cwd(),
105
+ homeDir,
106
+ global = false,
107
+ dryRun = false,
108
+ useLocalServer = false,
109
+ serverScriptPath = ''
110
+ } = {}) {
111
+ const resolvedHome = resolveHome({ homeDir });
112
+ const uniqueHosts = Array.from(
113
+ new Set(
114
+ (Array.isArray(hosts) ? hosts : [hosts])
115
+ .map((h) => normalizeMcpHostName(h))
116
+ .filter(Boolean)
117
+ )
118
+ );
119
+ if (uniqueHosts.length === 0) uniqueHosts.push('generic');
120
+
121
+ const serverEntry =
122
+ useLocalServer && serverScriptPath
123
+ ? { command: 'node', args: [serverScriptPath] }
124
+ : { command: 'npx', args: ['-y', 'ctxtop', 'mcp'] };
125
+
126
+ const results = [];
127
+ for (const host of uniqueHosts) {
128
+ const configPath = resolveHostMcpConfigPath(host, {
129
+ cwd,
130
+ homeDir: resolvedHome,
131
+ global
132
+ });
133
+ const existing = readJsonObjectSafe(configPath);
134
+ const prevServers =
135
+ existing.mcpServers && typeof existing.mcpServers === 'object' && !Array.isArray(existing.mcpServers)
136
+ ? { ...existing.mcpServers }
137
+ : {};
138
+ prevServers.highbeam = { ...serverEntry };
139
+
140
+ const updated = {
141
+ ...existing,
142
+ mcpServers: prevServers
143
+ };
144
+
145
+ if (!dryRun) {
146
+ writeJsonAtomicSafe(configPath, updated);
147
+ }
148
+
149
+ const codexTomlExists =
150
+ host === 'codex' && fs.existsSync(path.join(resolvedHome, '.codex', 'config.toml'));
151
+ results.push({
152
+ ok: true,
153
+ host,
154
+ serverKey: 'highbeam',
155
+ configPath,
156
+ dryRun: Boolean(dryRun),
157
+ entry: serverEntry,
158
+ ...(codexTomlExists ? { tomlSnippet: CODEX_TOML_SNIPPET } : {})
159
+ });
160
+ }
161
+
162
+ return {
163
+ ok: results.every((r) => r.ok),
164
+ dryRun: Boolean(dryRun),
165
+ hosts: uniqueHosts,
166
+ results
167
+ };
168
+ }
@@ -14,7 +14,10 @@ import {
14
14
  sanitizeRslSessionId,
15
15
  snapshotTestSuiteBaseline,
16
16
  recordStepOutcome,
17
- buildContrastiveDigest
17
+ buildContrastiveDigest,
18
+ RSL_ANTIGRAVITY_POST_TOOL_MATCHER,
19
+ isMutatingOrExecRslTool,
20
+ isDuplicateRslStepEvent
18
21
  } from '../core/rsl_triage.mjs';
19
22
  import { distillContrastiveDigest } from '../core/rsl_distiller.mjs';
20
23
  import {
@@ -135,6 +138,25 @@ export function handleAntigravityRslHook(payload = {}, options = {}) {
135
138
  }
136
139
 
137
140
  if (event === 'PostToolUse') {
141
+ const toolName = String(
142
+ payload?.toolCall?.name || payload?.tool_name || payload?.toolName || ''
143
+ ).trim();
144
+ if (toolName && !isMutatingOrExecRslTool(toolName)) {
145
+ return {
146
+ exitCode: 0,
147
+ stdoutJson: {},
148
+ event,
149
+ skippedReason: 'read_only_tool'
150
+ };
151
+ }
152
+ if (isDuplicateRslStepEvent(payload, { ...options, platform: 'antigravity' })) {
153
+ return {
154
+ exitCode: 0,
155
+ stdoutJson: {},
156
+ event,
157
+ deduplicated: true
158
+ };
159
+ }
138
160
  const recorded = recordStepOutcome(payload, { ...options, platform: 'antigravity' });
139
161
  return {
140
162
  exitCode: 0,
@@ -217,7 +239,7 @@ export function syncAntigravityWorkspaceRslHooks(workspaceRoot, options = {}) {
217
239
  ],
218
240
  PostToolUse: [
219
241
  {
220
- matcher: '*',
242
+ matcher: RSL_ANTIGRAVITY_POST_TOOL_MATCHER,
221
243
  hooks: [
222
244
  { type: 'command', command: `node "${hookScript}" --event=PostToolUse`, timeout: 5 }
223
245
  ]