ctxtop 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,158 @@
1
+ import fs from 'node:fs';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+ import { atomicWriteFileSync } from './atomic_io.mjs';
5
+
6
+ export const MAX_HOOK_DIAGNOSTIC_ENTRIES = 50;
7
+ export const HOOK_DIAGNOSTICS_FILENAME = 'ga_hook_diagnostics.jsonl';
8
+
9
+ const inMemoryDiagnostics = [];
10
+ let ignoredDiagnosticCount = 0;
11
+
12
+ /**
13
+ * Resolves the diagnostics directory outside the workspace root so hook/shim telemetry
14
+ * never pollutes `.agents/cache/` or `stdout`.
15
+ */
16
+ export function getHookDiagnosticsDir(options = {}) {
17
+ if (options.diagnosticsDir && typeof options.diagnosticsDir === 'string') {
18
+ return path.resolve(options.diagnosticsDir);
19
+ }
20
+ const envDir = process.env.HORIZON_DIAGNOSTICS_DIR;
21
+ if (envDir && typeof envDir === 'string' && envDir.trim().length > 0) {
22
+ return path.resolve(envDir.trim());
23
+ }
24
+ const home = options.homeDir || process.env.USERPROFILE || process.env.HOME || os.homedir();
25
+ return path.join(home, '.attention-horizon', 'diagnostics');
26
+ }
27
+
28
+ export function getHookDiagnosticsFilePath(options = {}) {
29
+ return path.join(getHookDiagnosticsDir(options), HOOK_DIAGNOSTICS_FILENAME);
30
+ }
31
+
32
+ function sanitizeDiagnosticMessage(rawMessage = '') {
33
+ return String(rawMessage || 'Unknown error')
34
+ .replace(/\r?\n/g, ' ')
35
+ .replace(/[A-Za-z]:[\\/][^\s"']+/g, '<path>')
36
+ .replace(/\/(?:Users|home)\/[^\s"']+/g, '<path>')
37
+ .slice(0, 240);
38
+ }
39
+
40
+ /**
41
+ * Records a structured diagnostic event into the bounded in-memory ring buffer (<= 50)
42
+ * and persists bounded JSONL (`<= 50` entries) to `~/.attention-horizon/diagnostics/ga_hook_diagnostics.jsonl`.
43
+ * Never writes to `stdout` and never throws.
44
+ */
45
+ export function recordHookDiagnostic(source, operation, err, options = {}) {
46
+ const code = err && typeof err === 'object' && err.code ? String(err.code) : null;
47
+ const ignoreCodes = Array.isArray(options.ignoreCodes) ? options.ignoreCodes : [];
48
+ if (code && ignoreCodes.includes(code)) {
49
+ ignoredDiagnosticCount += 1;
50
+ return { recorded: false, ignored: true, code };
51
+ }
52
+
53
+ const entry = {
54
+ timestamp: new Date().toISOString(),
55
+ pid: process.pid,
56
+ source: String(source || 'unknown').slice(0, 64),
57
+ operation: String(operation || 'unknown').slice(0, 80),
58
+ name: err && typeof err === 'object' && err.name ? String(err.name).slice(0, 48) : 'Error',
59
+ code,
60
+ message: sanitizeDiagnosticMessage(err instanceof Error ? err.message : String(err ?? 'Unknown error'))
61
+ };
62
+
63
+ inMemoryDiagnostics.push(entry);
64
+ while (inMemoryDiagnostics.length > MAX_HOOK_DIAGNOSTIC_ENTRIES) {
65
+ inMemoryDiagnostics.shift();
66
+ }
67
+
68
+ if (options.persist !== false) {
69
+ try {
70
+ const filePath = getHookDiagnosticsFilePath(options);
71
+ let existingLines = [];
72
+ if (fs.existsSync(filePath)) {
73
+ const raw = fs.readFileSync(filePath, 'utf8');
74
+ existingLines = raw
75
+ .split(/\r?\n/)
76
+ .map((l) => l.trim())
77
+ .filter(Boolean);
78
+ }
79
+ existingLines.push(JSON.stringify(entry));
80
+ const bounded = existingLines.slice(-MAX_HOOK_DIAGNOSTIC_ENTRIES);
81
+ atomicWriteFileSync(filePath, `${bounded.join('\n')}\n`, { encoding: 'utf8' });
82
+ } catch (persistErr) {
83
+ // Never throw or write to stdout from diagnostic recorder
84
+ entry.persistFailedCode = persistErr?.code || 'PERSIST_ERR';
85
+ }
86
+ }
87
+
88
+ return { recorded: true, ignored: false, entry };
89
+ }
90
+
91
+ export function getHookDiagnostics() {
92
+ return [...inMemoryDiagnostics];
93
+ }
94
+
95
+ export function getIgnoredHookDiagnosticCount() {
96
+ return ignoredDiagnosticCount;
97
+ }
98
+
99
+ export function clearHookDiagnostics() {
100
+ inMemoryDiagnostics.length = 0;
101
+ ignoredDiagnosticCount = 0;
102
+ }
103
+
104
+ export function readPersistedHookDiagnostics(options = {}) {
105
+ const filePath = getHookDiagnosticsFilePath(options);
106
+ if (!fs.existsSync(filePath)) return [];
107
+ try {
108
+ const raw = fs.readFileSync(filePath, 'utf8');
109
+ const entries = [];
110
+ for (const line of raw.split(/\r?\n/)) {
111
+ const trimmed = line.trim();
112
+ if (!trimmed) continue;
113
+ try {
114
+ const parsed = JSON.parse(trimmed);
115
+ if (parsed && typeof parsed === 'object') entries.push(parsed);
116
+ } catch (parseErr) {
117
+ if (parseErr) {
118
+ // Skip malformed line while preserving valid entries
119
+ }
120
+ }
121
+ }
122
+ return entries.slice(-MAX_HOOK_DIAGNOSTIC_ENTRIES);
123
+ } catch (err) {
124
+ return err ? [] : [];
125
+ }
126
+ }
127
+
128
+ export function getHookDiagnosticSummary(options = {}) {
129
+ const persisted = readPersistedHookDiagnostics(options);
130
+ const bySource = {};
131
+ for (const item of persisted) {
132
+ const key = String(item.source || 'unknown');
133
+ bySource[key] = (bySource[key] || 0) + 1;
134
+ }
135
+ const latest = persisted.length > 0 ? persisted[persisted.length - 1] : null;
136
+ return {
137
+ totalCount: persisted.length,
138
+ inMemoryCount: inMemoryDiagnostics.length,
139
+ bySource,
140
+ latestSource: latest?.source || null,
141
+ latestOperation: latest?.operation || null,
142
+ latestCode: latest?.code || null,
143
+ latestTimestamp: latest?.timestamp || null
144
+ };
145
+ }
146
+
147
+ export default {
148
+ MAX_HOOK_DIAGNOSTIC_ENTRIES,
149
+ HOOK_DIAGNOSTICS_FILENAME,
150
+ getHookDiagnosticsDir,
151
+ getHookDiagnosticsFilePath,
152
+ recordHookDiagnostic,
153
+ getHookDiagnostics,
154
+ getIgnoredHookDiagnosticCount,
155
+ clearHookDiagnostics,
156
+ readPersistedHookDiagnostics,
157
+ getHookDiagnosticSummary
158
+ };
@@ -0,0 +1,311 @@
1
+ import path from 'node:path';
2
+ import fs from 'node:fs';
3
+
4
+ /**
5
+ * Suppresses Node.js `ExperimentalWarning: SQLite is an experimental feature` on CLI and daemon entrypoints.
6
+ */
7
+ export function suppressSqliteExperimentalWarning() {
8
+ if (typeof process === 'undefined' || process.__ctxtopSqliteWarningSuppressed) return;
9
+ process.__ctxtopSqliteWarningSuppressed = true;
10
+ if (typeof process.emitWarning === 'function') {
11
+ const origEmitWarning = process.emitWarning.bind(process);
12
+ process.emitWarning = function (warning, ...args) {
13
+ const msg = typeof warning === 'string' ? warning : (warning && warning.message) || '';
14
+ const type = typeof args[0] === 'string' ? args[0] : (args[0] && args[0].type) || (warning && warning.name) || '';
15
+ if ((type === 'ExperimentalWarning' && /SQLite/i.test(msg)) || /SQLite is an experimental feature/i.test(msg)) {
16
+ return;
17
+ }
18
+ return origEmitWarning(warning, ...args);
19
+ };
20
+ }
21
+ }
22
+
23
+ suppressSqliteExperimentalWarning();
24
+
25
+ export function parseNodeVersion(versionStr = (typeof process !== 'undefined' && process.versions?.node) || '0.0.0') {
26
+ const parts = String(versionStr || '0.0.0').replace(/^v/i, '').split('.').map(n => parseInt(n, 10) || 0);
27
+ return { major: parts[0] || 0, minor: parts[1] || 0, patch: parts[2] || 0 };
28
+ }
29
+
30
+ export function isSupportedNodeVersion(versionStr = (typeof process !== 'undefined' && process.versions?.node) || '0.0.0') {
31
+ const { major } = parseNodeVersion(versionStr);
32
+ return major >= 20;
33
+ }
34
+
35
+ export function hasNativeNodeSqlite(versionStr = (typeof process !== 'undefined' && process.versions?.node) || '0.0.0') {
36
+ if (typeof process !== 'undefined' && process.env?.CTXTOP_FORCE_NO_SQLITE === '1') {
37
+ return false;
38
+ }
39
+ const { major, minor } = parseNodeVersion(versionStr);
40
+ return major > 22 || (major === 22 && minor >= 5);
41
+ }
42
+
43
+ export function formatNodeUpgradeHint(versionStr = (typeof process !== 'undefined' && process.versions?.node) || '0.0.0') {
44
+ const cleanVer = String(versionStr || '0.0.0').replace(/^v/i, '');
45
+ return [
46
+ `\x1b[33m▲ ctxtop requires Node.js >= 20.0.0 LTS (Node.js >= 22.5.0 for built-in zero-dependency SQLite; detected v${cleanVer}).\x1b[0m`,
47
+ ` Upgrade in 10s: \x1b[36mnvm install 22 && nvm use 22\x1b[0m (or download from https://nodejs.org)`
48
+ ].join('\n');
49
+ }
50
+
51
+ export function ensureSupportedNodeVersion({ exitOnUnsupported = true, stream = process.stderr, versionStr = process.versions?.node } = {}) {
52
+ if (isSupportedNodeVersion(versionStr)) return { supported: true, message: '' };
53
+ const message = formatNodeUpgradeHint(versionStr);
54
+ if (stream && typeof stream.write === 'function') {
55
+ stream.write(message + '\n');
56
+ }
57
+ if (exitOnUnsupported && typeof process !== 'undefined' && typeof process.exit === 'function') {
58
+ process.exit(1);
59
+ }
60
+ return { supported: false, message };
61
+ }
62
+
63
+ /**
64
+ * Normalizes Windows & POSIX paths and file:// URIs into a canonical lowercase forward-slash path.
65
+ * Handles file:///c%3A/..., file:///C:/..., C:\..., c:/...
66
+ */
67
+ export function canonicalizePath(input) {
68
+ if (!input || typeof input !== 'string') return '';
69
+ let str = input.trim();
70
+ try {
71
+ str = decodeURIComponent(str);
72
+ } catch {
73
+ // keep as-is if decoding fails
74
+ }
75
+
76
+ // Strip file:// prefix
77
+ str = str.replace(/^file:\/\/\/?/i, '');
78
+
79
+ // Normalize all backslashes to forward slashes
80
+ str = str.replace(/\\+/g, '/');
81
+
82
+ // Strip leading slash before Windows drive letters (e.g. /c:/ -> c:/)
83
+ if (/^\/[a-zA-Z]:/.test(str)) {
84
+ str = str.slice(1);
85
+ }
86
+
87
+ // Remove trailing slashes (except root "c:/" or "/")
88
+ if (str.length > 3 && str.endsWith('/')) {
89
+ str = str.replace(/\/+$/, '');
90
+ }
91
+
92
+ // Lowercase on Windows or Windows drive formats for deterministic case-insensitive matching
93
+ if (process.platform === 'win32' || /^[a-zA-Z]:\//.test(str)) {
94
+ str = str.toLowerCase();
95
+ }
96
+
97
+ return str;
98
+ }
99
+
100
+ /**
101
+ * Returns user home directory across platforms
102
+ */
103
+ export function getHomeDir() {
104
+ return process.env.USERPROFILE || process.env.HOME || path.resolve('/');
105
+ }
106
+
107
+ /**
108
+ * Returns true only for lockfiles, logs, build artifacts, or scratch files.
109
+ * Rule: Active source code files must NEVER be recommended for .antigravityignore.
110
+ */
111
+ export function isIgnorablePath(p) {
112
+ if (!p) return false;
113
+ const raw = String(p).replace(/\\/g, '/');
114
+ const s = raw
115
+ .replace(/^[a-z]:\/users\/[^/]+\/appdata\/local\/temp\/[^/]+\//i, '')
116
+ .replace(/^\/(?:private\/)?var\/folders\/[^/]+\/[^/]+\/[^/]+\/[^/]+\//i, '')
117
+ .replace(/^\/(?:private\/)?tmp\/(?:[^/]+\/)?/i, '');
118
+ if (/(?:^|\/)(?:src|lib|packages|app|bin|test|tests|scripts)\/.*\.(?:[mc]?[jt]sx?|py|rs|go|java|c|cpp|h|hpp|rb|php|swift|kt|vue|svelte|html|css)$/i.test(s)) {
119
+ return false;
120
+ }
121
+ if (/(^|\/)(package-lock\.json|yarn\.lock|pnpm-lock\.yaml|poetry\.lock|Cargo\.lock|Gemfile\.lock|composer\.lock|\.lock)$/i.test(s)) return true;
122
+ if (/\.log$/i.test(s) || /(^|\/)logs?(\/|$)/i.test(s) || /\.jsonl$/i.test(s)) return true;
123
+ if (/(^|\/)(dist|build|out|target|\.next|\.nuxt|coverage|node_modules)(\/|$)/i.test(s)) return true;
124
+ if (/\.(min\.js|min\.css|map|pyc)$/i.test(s)) return true;
125
+ if (/(^|\/)(scratch|\.scratch|tmp|temp)(\/|$)/i.test(s)) return true;
126
+ return false;
127
+ }
128
+
129
+ /**
130
+ * Returns all three local Antigravity surface store descriptors:
131
+ * - Desktop 2.0 / Unified Daemon: ~/.gemini/antigravity ([App])
132
+ * - Standalone IDE Fork: ~/.gemini/antigravity-ide ([IDE])
133
+ * - CLI: ~/.gemini/antigravity-cli ([CLI])
134
+ */
135
+ export function getAntigravitySurfaces(homeDir = getHomeDir(), { includeMissing = false } = {}) {
136
+ const surfaces = [
137
+ {
138
+ name: 'antigravity',
139
+ surfaceTag: '[App]',
140
+ rootDir: path.join(homeDir, '.gemini', 'antigravity'),
141
+ path: path.join(homeDir, '.gemini', 'antigravity', 'brain'),
142
+ brainDir: path.join(homeDir, '.gemini', 'antigravity', 'brain'),
143
+ conversationsDir: path.join(homeDir, '.gemini', 'antigravity', 'conversations'),
144
+ summariesDbPath: path.join(homeDir, '.gemini', 'antigravity', 'conversation_summaries.db')
145
+ },
146
+ {
147
+ name: 'antigravity-ide',
148
+ surfaceTag: '[IDE]',
149
+ rootDir: path.join(homeDir, '.gemini', 'antigravity-ide'),
150
+ path: path.join(homeDir, '.gemini', 'antigravity-ide', 'brain'),
151
+ brainDir: path.join(homeDir, '.gemini', 'antigravity-ide', 'brain'),
152
+ conversationsDir: path.join(homeDir, '.gemini', 'antigravity-ide', 'conversations'),
153
+ summariesDbPath: path.join(homeDir, '.gemini', 'antigravity-ide', 'conversation_summaries.db')
154
+ },
155
+ {
156
+ name: 'antigravity-cli',
157
+ surfaceTag: '[CLI]',
158
+ rootDir: path.join(homeDir, '.gemini', 'antigravity-cli'),
159
+ path: path.join(homeDir, '.gemini', 'antigravity-cli', 'brain'),
160
+ brainDir: path.join(homeDir, '.gemini', 'antigravity-cli', 'brain'),
161
+ conversationsDir: path.join(homeDir, '.gemini', 'antigravity-cli', 'conversations'),
162
+ summariesDbPath: path.join(homeDir, '.gemini', 'antigravity-cli', 'conversation_summaries.db')
163
+ }
164
+ ];
165
+ if (includeMissing) return surfaces;
166
+ return surfaces.filter(s =>
167
+ fs.existsSync(s.brainDir) ||
168
+ fs.existsSync(s.conversationsDir) ||
169
+ fs.existsSync(s.summariesDbPath)
170
+ );
171
+ }
172
+
173
+ /**
174
+ * Discovers potential Antigravity brain directories across all three surfaces
175
+ */
176
+ export function getBrainStores(homeDir = getHomeDir()) {
177
+ return getAntigravitySurfaces(homeDir, { includeMissing: true })
178
+ .filter(s => fs.existsSync(s.path));
179
+ }
180
+
181
+ /**
182
+ * Returns canonical `~/.ctxtop/daemon.port` path used by CLI, healthchecks, and UI.
183
+ */
184
+ export function getDaemonPortFile(homeDir = getHomeDir()) {
185
+ return path.join(homeDir, '.ctxtop', 'daemon.port');
186
+ }
187
+
188
+ /**
189
+ * Reads the active daemon port from `~/.ctxtop/daemon.port` (or `~/.gemini/runtime/horizon-latest.json` fallback).
190
+ */
191
+ export function readDaemonPort(homeDir = getHomeDir(), fallbackPort = 62935) {
192
+ const portFile = getDaemonPortFile(homeDir);
193
+ if (fs.existsSync(portFile)) {
194
+ try {
195
+ const p = parseInt(fs.readFileSync(portFile, 'utf8').trim(), 10);
196
+ if (p > 0 && p <= 65535) return p;
197
+ } catch {}
198
+ }
199
+ const latestJson = path.join(homeDir, '.gemini', 'runtime', 'horizon-latest.json');
200
+ if (fs.existsSync(latestJson)) {
201
+ try {
202
+ const parsed = JSON.parse(fs.readFileSync(latestJson, 'utf8'));
203
+ const p = parseInt(String(parsed?.port || '0'), 10);
204
+ if (p > 0 && p <= 65535) return p;
205
+ } catch {}
206
+ }
207
+ return fallbackPort;
208
+ }
209
+
210
+ /**
211
+ * Parses an explicit `--harness=<name>` or `--harness <name>` CLI flag.
212
+ * Returns normalized harness string ('antigravity' | 'claude' | 'cursor' | 'all') or null when absent.
213
+ */
214
+ export function parseCliHarnessArg(argv = []) {
215
+ if (!Array.isArray(argv)) return null;
216
+ for (let i = 0; i < argv.length; i++) {
217
+ const token = String(argv[i] || '');
218
+ if (token.startsWith('--harness=')) {
219
+ return token.slice('--harness='.length).trim().toLowerCase() || null;
220
+ }
221
+ if (token === '--harness' && i + 1 < argv.length) {
222
+ return String(argv[i + 1] || '').trim().toLowerCase() || null;
223
+ }
224
+ }
225
+ return null;
226
+ }
227
+
228
+ /**
229
+ * Returns true ONLY when cross-host session discovery (`claude` or `cursor`) is explicitly enabled
230
+ * via `{ harness: 'claude' | 'cursor' | 'all' }` or `{ includeCrossHost: true }`.
231
+ */
232
+ export function isCrossHostHarnessEnabled(targetHarness, options = {}) {
233
+ if (!options || typeof options !== 'object') return false;
234
+ if (options.includeCrossHost === true) return true;
235
+ const h = String(options.harness || '').trim().toLowerCase();
236
+ if (!h) return false;
237
+ if (h === 'all' || h === 'cross-host') return true;
238
+ if (targetHarness === 'claude') return h === 'claude' || h === 'claude-code';
239
+ if (targetHarness === 'cursor') return h === 'cursor';
240
+ if (targetHarness === 'codex') return h === 'codex' || h === 'codex-cli';
241
+ if (targetHarness === 'gemini-cli') return h === 'gemini-cli';
242
+ return false;
243
+ }
244
+
245
+ /**
246
+ * Returns OpenAI Codex CLI `~/.codex/sessions` directory ONLY when explicitly gated
247
+ * via `--harness=codex` or `--harness=all`. Strictly scopes to session rollout transcripts.
248
+ */
249
+ export function getCodexSessionsDir(homeDir = getHomeDir(), options = {}) {
250
+ if (!isCrossHostHarnessEnabled('codex', options)) {
251
+ return '';
252
+ }
253
+ return path.join(homeDir, '.codex', 'sessions');
254
+ }
255
+
256
+ /**
257
+ * Returns Google Gemini CLI `~/.gemini/tmp/<hash>/chats` directories ONLY when explicitly gated
258
+ * via `--harness=gemini-cli` or `--harness=all`. Strictly scopes to `chats` subdirectories
259
+ * (never touches root credential files).
260
+ */
261
+ export function getGeminiCliChatsDirs(homeDir = getHomeDir(), options = {}) {
262
+ if (!isCrossHostHarnessEnabled('gemini-cli', options)) {
263
+ return [];
264
+ }
265
+ const tmpRoot = path.join(homeDir, '.gemini', 'tmp');
266
+ if (!fs.existsSync(tmpRoot)) return [];
267
+ const chatDirs = [];
268
+ try {
269
+ for (const entry of fs.readdirSync(tmpRoot, { withFileTypes: true })) {
270
+ if (!entry.isDirectory()) continue;
271
+ const chatsSubdir = path.join(tmpRoot, entry.name, 'chats');
272
+ if (fs.existsSync(chatsSubdir)) {
273
+ chatDirs.push(chatsSubdir);
274
+ }
275
+ }
276
+ } catch {}
277
+ return chatDirs;
278
+ }
279
+
280
+ /**
281
+ * Returns Claude Code `~/.claude/projects` directory when explicitly gated via `--harness=claude`
282
+ * (`options.harness === 'claude'` or `options.includeCrossHost === true`), or empty string by default.
283
+ */
284
+ export function getClaudeCodeProjectsDir(homeDir = getHomeDir(), options = {}) {
285
+ if (!isCrossHostHarnessEnabled('claude', options)) {
286
+ return '';
287
+ }
288
+ return path.join(homeDir, '.claude', 'projects');
289
+ }
290
+
291
+ /**
292
+ * Returns candidate Cursor `workspaceStorage` directories ONLY when explicitly gated via `--harness=cursor`
293
+ * (`options.harness === 'cursor'` or `options.includeCrossHost === true`).
294
+ */
295
+ export function getCursorWorkspaceStorageDirs(homeDir = getHomeDir(), options = {}) {
296
+ if (!isCrossHostHarnessEnabled('cursor', options)) {
297
+ return [];
298
+ }
299
+ const candidates = [
300
+ path.join(homeDir, 'AppData', 'Roaming', 'Cursor', 'User', 'workspaceStorage'),
301
+ path.join(homeDir, 'Library', 'Application Support', 'Cursor', 'User', 'workspaceStorage'),
302
+ path.join(homeDir, '.config', 'Cursor', 'User', 'workspaceStorage'),
303
+ path.join(homeDir, '.cursor', 'workspaceStorage'),
304
+ path.join(homeDir, 'workspaceStorage')
305
+ ];
306
+ if (process.env.APPDATA && canonicalizePath(process.env.APPDATA).startsWith(canonicalizePath(homeDir))) {
307
+ const appDataPath = path.join(process.env.APPDATA, 'Cursor', 'User', 'workspaceStorage');
308
+ if (!candidates.includes(appDataPath)) candidates.unshift(appDataPath);
309
+ }
310
+ return candidates.filter(p => fs.existsSync(p));
311
+ }