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
@@ -15,8 +15,19 @@ import {
15
15
  getDiagnosticsFilePath,
16
16
  readRuntimeDiagnostics
17
17
  } from '../utils/nodeIo.mjs';
18
- import { loadModelCatalog } from '../core-isomorphic/config/catalogLoader.mjs';
18
+ import {
19
+ isKnownCatalogModel,
20
+ loadModelCatalog
21
+ } from '../core-isomorphic/config/catalogLoader.mjs';
19
22
  import { loadHorizonConfig } from '../core-isomorphic/config/horizonConfig.mjs';
23
+ import { inspectClaudeBinaryCapabilities } from './claudeHookCapabilities.mjs';
24
+ import { readModelSwitchTelemetry } from '../utils/modelSwitchTelemetry.mjs';
25
+ import { auditAntigravityRulesIntegrity } from '../core/layer5_hygiene.mjs';
26
+ import { auditClaudeAutoMemory } from '../core/shield_manager.mjs';
27
+ import { auditProseRuleHookCandidates } from '../core/bucket_b_runtime.mjs';
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';
20
31
 
21
32
  /**
22
33
  * Redacts the user's OS home directory from any diagnostic string.
@@ -86,7 +97,7 @@ export function inspectHookDiagnostics(options = {}) {
86
97
  }
87
98
 
88
99
  /**
89
- * Runs host contract & runtime diagnostic checks (`npx ah-claude doctor`).
100
+ * Runs host contract & runtime diagnostic checks (`npx ctxtop doctor`).
90
101
  *
91
102
  * @param {object} [options={}]
92
103
  * @returns {{
@@ -185,14 +196,121 @@ export function runDoctorDiagnostics(options = {}) {
185
196
  detail: `20 detectors configured (FlightMode=${config.flightMode}, overrides=${customDetectors})`
186
197
  });
187
198
 
199
+ const agRulesAudit = auditAntigravityRulesIntegrity({ workspacePath: cwd });
200
+ const claudeMemAudit = auditClaudeAutoMemory({
201
+ cwd,
202
+ homeDir: options.homeDir,
203
+ memoryDir: options.memoryDir,
204
+ memoryFilePath: options.memoryFilePath
205
+ });
206
+ const memoryRuleIntegrity = {
207
+ ok: !options.strictRulesCheck || !(agRulesAudit.triggered || claudeMemAudit.triggered),
208
+ warning: Boolean(agRulesAudit.triggered || claudeMemAudit.triggered),
209
+ issues: [...(agRulesAudit.issues || []), ...(claudeMemAudit.issues || [])],
210
+ antigravityRules: agRulesAudit,
211
+ claudeAutoMemory: claudeMemAudit
212
+ };
213
+
214
+ const proseHookCandidates = auditProseRuleHookCandidates(cwd);
215
+ const rslClashAudit = auditWorkspaceRuleClashes(cwd);
188
216
  const hookDiagnostics = inspectHookDiagnostics({ ...options, cwd });
189
- const ok = checks.every((c) => c.ok);
217
+
218
+ // Item 1.2: Warn cleanly when the configured or active session model has no price catalog entry
219
+ const candidateModelSources = [
220
+ options.model,
221
+ options.activeModel,
222
+ config?.model,
223
+ readJsonSafe(path.join(cwd, '.claude', 'settings.local.json'), null, options)?.model,
224
+ readJsonSafe(path.join(cwd, '.claude', 'settings.json'), null, options)?.model,
225
+ readJsonSafe(
226
+ path.join(options.homeDir || os.homedir() || '', '.claude', 'settings.json'),
227
+ null,
228
+ options
229
+ )?.model,
230
+ options.env?.ANTHROPIC_MODEL,
231
+ options.env?.CLAUDE_MODEL,
232
+ globalThis.process?.env?.ANTHROPIC_MODEL,
233
+ globalThis.process?.env?.CLAUDE_MODEL
234
+ ].filter((m) => typeof m === 'string' && m.trim().length > 0);
235
+ const unknownConfiguredModels = Array.from(
236
+ new Set(
237
+ candidateModelSources
238
+ .map((m) => m.trim())
239
+ .filter((m) => !isKnownCatalogModel(m, { ...options, cwd }))
240
+ )
241
+ );
242
+ const warnings = [];
243
+ if (unknownConfiguredModels.length > 0) {
244
+ const warnDetail = `Configured model(s) [${unknownConfiguredModels.join(', ')}] not in price catalog; dollar figures and price-based holds are disabled (unknown model state).`;
245
+ warnings.push(warnDetail);
246
+ checks.push({
247
+ id: 'model_catalog_coverage',
248
+ status: 'WARN',
249
+ ok: true,
250
+ detail: warnDetail
251
+ });
252
+ }
253
+
254
+ const modelSwitchTelemetry = readModelSwitchTelemetry({
255
+ homeDir: options.homeDir,
256
+ telemetryPath: options.telemetryPath
257
+ });
258
+ const claudeCapabilities = inspectClaudeBinaryCapabilities({
259
+ ...options,
260
+ cwd,
261
+ recordDiagnostic: false
262
+ });
263
+ if (rslClashAudit.clashCount > 0) {
264
+ const clashMsg = `${rslClashAudit.clashCount} RSL rule conflict(s) detected: ${rslClashAudit.clashes.slice(0, 2).map((c) => c.reason).join('; ')}`;
265
+ warnings.push(clashMsg);
266
+ checks.push({
267
+ id: 'rsl_rule_clashes',
268
+ status: 'WARN',
269
+ ok: true,
270
+ detail: clashMsg
271
+ });
272
+ }
273
+ const ok =
274
+ checks.every((c) => c.ok) &&
275
+ memoryRuleIntegrity.ok &&
276
+ (!options.strictClaudeCheck || Boolean(claudeCapabilities.found && claudeCapabilities.contractValid));
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
+ }
190
299
 
191
300
  return {
192
301
  ok,
193
302
  nodeVersion,
194
303
  checks,
195
- hookDiagnostics
304
+ warnings,
305
+ claudeCapabilities,
306
+ hookDiagnostics,
307
+ modelSwitchTelemetry,
308
+ memoryRuleIntegrity,
309
+ proseHookCandidates,
310
+ rslRuleClashes: rslClashAudit.clashCount,
311
+ rslClashes: rslClashAudit.clashes.slice(0, 5),
312
+ offloadIndex,
313
+ ipcFastPath
196
314
  };
197
315
  }
198
316
 
@@ -30,6 +30,237 @@ export function suppressSqliteWarning({ force = false } = {}) {
30
30
 
31
31
  let probedModule = undefined;
32
32
 
33
+ function extractFtsTokens(rawQuery = '') {
34
+ const cleaned = String(rawQuery || '')
35
+ .replace(/\bNEAR\s*\([^)]*\)/gi, ' ')
36
+ .replace(/[A-Za-z0-9_]+\s*:/g, ' ')
37
+ .replace(/['"*()]/g, ' ')
38
+ .trim();
39
+ if (!cleaned) return { mode: 'EMPTY', include: [], exclude: [] };
40
+
41
+ if (/\s+NOT\s+/i.test(cleaned)) {
42
+ const [incPart, ...excParts] = cleaned.split(/\s+NOT\s+/i);
43
+ const include = incPart.split(/\s+(?:AND\s+|OR\s+)?/i).map(t => t.trim().toLowerCase()).filter(Boolean);
44
+ const exclude = excParts.join(' ').split(/\s+/).map(t => t.trim().toLowerCase()).filter(Boolean);
45
+ return { mode: 'AND', include, exclude };
46
+ }
47
+ if (/\s+OR\s+/i.test(cleaned)) {
48
+ const include = cleaned.split(/\s+OR\s+|\s+/i).map(t => t.trim().toLowerCase()).filter(t => t && t !== 'or' && t !== 'and');
49
+ return { mode: 'OR', include, exclude: [] };
50
+ }
51
+ const include = cleaned.split(/\s+AND\s+|\s+/i).map(t => t.trim().toLowerCase()).filter(t => t && t !== 'and');
52
+ return { mode: 'AND', include, exclude: [] };
53
+ }
54
+
55
+ function evaluateFtsMatch(haystack = '', rawQuery = '') {
56
+ const text = String(haystack || '').toLowerCase();
57
+ const { mode, include, exclude } = extractFtsTokens(rawQuery);
58
+ if (mode === 'EMPTY' || include.length === 0) return 0;
59
+ for (const ex of exclude) {
60
+ if (text.includes(ex)) return 0;
61
+ }
62
+ if (mode === 'OR') {
63
+ return include.some(tok => text.includes(tok)) ? 1 : 0;
64
+ }
65
+ return include.every(tok => text.includes(tok)) ? 1 : 0;
66
+ }
67
+
68
+ function evaluateFtsBm25(haystack = '', rawQuery = '') {
69
+ const text = String(haystack || '').toLowerCase();
70
+ const { include } = extractFtsTokens(rawQuery);
71
+ if (include.length === 0) return 0.0;
72
+ let score = 0;
73
+ for (const tok of include) {
74
+ let idx = 0;
75
+ while ((idx = text.indexOf(tok, idx)) !== -1) {
76
+ score += 1;
77
+ idx += tok.length;
78
+ }
79
+ }
80
+ return score > 0 ? -score : 0.0;
81
+ }
82
+
83
+ function evaluateFtsSnippet(haystack = '', rawQuery = '', openTag = '[', closeTag = ']', ellipsis = '...', maxTokens = 16) {
84
+ const rawStr = String(haystack || '');
85
+ const { include } = extractFtsTokens(rawQuery);
86
+ const segments = rawStr.includes('\x1f') ? rawStr.split('\x1f') : [rawStr];
87
+ let chosenSegment = segments[segments.length - 1] || '';
88
+ if (include.length > 0) {
89
+ for (const seg of segments) {
90
+ const lowerSeg = seg.toLowerCase();
91
+ if (include.some(tok => lowerSeg.includes(tok))) {
92
+ chosenSegment = seg;
93
+ break;
94
+ }
95
+ }
96
+ }
97
+ if (!chosenSegment || include.length === 0) return chosenSegment.slice(0, 120);
98
+ let out = chosenSegment;
99
+ for (const tok of include) {
100
+ const escaped = tok.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
101
+ const re = new RegExp(`(${escaped})`, 'gi');
102
+ if (re.test(out)) {
103
+ out = out.replace(re, `${openTag}$1${closeTag}`);
104
+ }
105
+ }
106
+ const words = out.split(/\s+/);
107
+ const limit = Math.max(4, Number(maxTokens) || 16);
108
+ if (words.length > limit) {
109
+ let matchWordIdx = 0;
110
+ const lowerInclude = include.map(t => t.toLowerCase());
111
+ for (let i = 0; i < words.length; i++) {
112
+ const wLower = words[i].toLowerCase();
113
+ if (lowerInclude.some(tok => wLower.includes(tok))) {
114
+ matchWordIdx = i;
115
+ break;
116
+ }
117
+ }
118
+ const startIdx = Math.max(0, Math.min(words.length - limit, matchWordIdx - Math.floor(limit / 3)));
119
+ const endIdx = startIdx + limit;
120
+ const prefix = startIdx > 0 ? ellipsis : '';
121
+ const suffix = endIdx < words.length ? ellipsis : '';
122
+ return `${prefix}${words.slice(startIdx, endIdx).join(' ')}${suffix}`;
123
+ }
124
+ return out;
125
+ }
126
+
127
+ function createFts5PolyfillClass(RawDatabaseSync) {
128
+ const Fts5PolyfillDatabaseSync = class DatabaseSync extends RawDatabaseSync {
129
+ constructor(...args) {
130
+ super(...args);
131
+ this._activeFtsQuery = '';
132
+ this._ftsColsCache = new Map();
133
+ try {
134
+ if (typeof this.function === 'function') {
135
+ this.function('__hz_fts_match', (haystack, q) => {
136
+ this._activeFtsQuery = String(q ?? '');
137
+ return evaluateFtsMatch(haystack, q);
138
+ });
139
+ this.function('__hz_fts_bm25', (haystack) => {
140
+ return evaluateFtsBm25(haystack, this._activeFtsQuery);
141
+ });
142
+ this.function('__hz_fts_snippet', (haystack, openTag, closeTag, ellipsis, maxTok) => {
143
+ return evaluateFtsSnippet(haystack, this._activeFtsQuery, openTag, closeTag, ellipsis, maxTok);
144
+ });
145
+ }
146
+ } catch {
147
+ // Ignore if custom functions cannot be registered
148
+ }
149
+ }
150
+
151
+ _getTableColumns(tableName) {
152
+ if (this._ftsColsCache.has(tableName)) return this._ftsColsCache.get(tableName);
153
+ try {
154
+ const rows = super.prepare(`PRAGMA table_info(${tableName})`).all();
155
+ const cols = rows.map(r => r.name).filter(Boolean);
156
+ if (cols.length > 0) {
157
+ this._ftsColsCache.set(tableName, cols);
158
+ return cols;
159
+ }
160
+ } catch {}
161
+ return [];
162
+ }
163
+
164
+ _buildConcatExpr(tableName) {
165
+ const cols = this._getTableColumns(tableName);
166
+ if (cols.length === 0) return `''`;
167
+ return `(${cols.map(c => `COALESCE(CAST(${tableName}.${c} AS TEXT), '')`).join(" || char(31) || ")})`;
168
+ }
169
+
170
+ exec(sql) {
171
+ let rewritten = String(sql || '');
172
+ // Strip FTS5 optimize command on polyfilled tables
173
+ rewritten = rewritten.replace(
174
+ /INSERT\s+INTO\s+([A-Za-z0-9_]+)\s*\(\s*\1\s*\)\s*VALUES\s*\(\s*'optimize'\s*\)\s*;?/gi,
175
+ ''
176
+ );
177
+ // Rewrite CREATE VIRTUAL TABLE ... USING fts5(...) into standard SQLite table preserving /* fts5 */ marker
178
+ rewritten = rewritten.replace(
179
+ /CREATE\s+VIRTUAL\s+TABLE\s+(IF\s+NOT\s+EXISTS\s+)?([A-Za-z0-9_]+)\s+USING\s+fts5\s*\(([\s\S]*?)\)/gi,
180
+ (_, ifNotExists = '', tableName, rawCols) => {
181
+ const cols = rawCols
182
+ .split(',')
183
+ .map(part => part.trim())
184
+ .filter(part => part && !part.includes('='))
185
+ .map(part => part.replace(/\bUNINDEXED\b/gi, '').trim().split(/\s+/)[0])
186
+ .filter(Boolean);
187
+ this._ftsColsCache.set(tableName, cols);
188
+ const colDefs = cols.map(c => `${c} TEXT`).join(', ');
189
+ return `CREATE TABLE ${ifNotExists}${tableName} (/* fts5 */ ${colDefs})`;
190
+ }
191
+ );
192
+ if (!rewritten.trim()) return;
193
+ return super.exec(rewritten);
194
+ }
195
+
196
+ prepare(sql) {
197
+ let rewritten = String(sql || '');
198
+ const hasFtsSyntax = /\bMATCH\s+\?|\bbm25\s*\(|\bsnippet\s*\(/i.test(rewritten);
199
+ if (hasFtsSyntax) {
200
+ rewritten = rewritten.replace(
201
+ /snippet\s*\(\s*([A-Za-z0-9_]+)\s*,\s*(-?\d+)\s*,\s*('[^']*')\s*,\s*('[^']*')\s*,\s*('[^']*')\s*,\s*(\d+)\s*\)/gi,
202
+ (_, tbl, colIdxStr, openTag, closeTag, ellipsis, maxTok) => {
203
+ const colIdx = Number(colIdxStr);
204
+ const cols = this._getTableColumns(tbl);
205
+ const targetExpr = (colIdx >= 0 && cols[colIdx])
206
+ ? `COALESCE(CAST(${tbl}.${cols[colIdx]} AS TEXT), '')`
207
+ : this._buildConcatExpr(tbl);
208
+ return `__hz_fts_snippet(${targetExpr}, ${openTag}, ${closeTag}, ${ellipsis}, ${maxTok})`;
209
+ }
210
+ );
211
+ rewritten = rewritten.replace(
212
+ /bm25\s*\(\s*([A-Za-z0-9_]+)\s*\)/gi,
213
+ (_, tbl) => `__hz_fts_bm25(${this._buildConcatExpr(tbl)})`
214
+ );
215
+ rewritten = rewritten.replace(
216
+ /([A-Za-z0-9_]+)\s+MATCH\s+\?/gi,
217
+ (_, tbl) => `__hz_fts_match(${this._buildConcatExpr(tbl)}, ?)`
218
+ );
219
+ }
220
+
221
+ const stmt = super.prepare(rewritten);
222
+ if (!hasFtsSyntax) return stmt;
223
+
224
+ const self = this;
225
+ const origAll = stmt.all.bind(stmt);
226
+ const origGet = stmt.get.bind(stmt);
227
+ stmt.all = (...args) => {
228
+ if (args.length > 0) self._activeFtsQuery = String(args[0] ?? '');
229
+ return origAll(...args);
230
+ };
231
+ stmt.get = (...args) => {
232
+ if (args.length > 0) self._activeFtsQuery = String(args[0] ?? '');
233
+ return origGet(...args);
234
+ };
235
+ return stmt;
236
+ }
237
+ };
238
+ Object.defineProperty(Fts5PolyfillDatabaseSync, 'name', { value: 'DatabaseSync' });
239
+ return Fts5PolyfillDatabaseSync;
240
+ }
241
+
242
+ function ensureFts5CapableModule(mod) {
243
+ if (!mod || typeof mod.DatabaseSync !== 'function') return mod;
244
+ const RawDb = mod.DatabaseSync;
245
+ let hasNativeFts5 = false;
246
+ if (typeof process === 'undefined' || process.env?.CTXTOP_FORCE_FTS5_POLYFILL !== '1') {
247
+ try {
248
+ const mem = new RawDb(':memory:');
249
+ mem.exec('CREATE VIRTUAL TABLE __fts5_probe USING fts5(c);');
250
+ mem.close();
251
+ hasNativeFts5 = true;
252
+ } catch {
253
+ hasNativeFts5 = false;
254
+ }
255
+ }
256
+ if (hasNativeFts5) return mod;
257
+ const PolyfilledDb = createFts5PolyfillClass(RawDb);
258
+ return {
259
+ ...mod,
260
+ DatabaseSync: PolyfilledDb
261
+ };
262
+ }
263
+
33
264
  /**
34
265
  * Probes for built-in node:sqlite module via process.getBuiltinModule.
35
266
  *
@@ -60,8 +291,9 @@ export function probeSqliteBuiltin({ forceFallback = false, getBuiltinModuleOver
60
291
  }
61
292
 
62
293
  try {
63
- const mod = getBuiltin('node:sqlite');
64
- if (mod && typeof mod.DatabaseSync === 'function') {
294
+ const rawMod = getBuiltin('node:sqlite');
295
+ if (rawMod && typeof rawMod.DatabaseSync === 'function') {
296
+ const mod = getBuiltinModuleOverride ? rawMod : ensureFts5CapableModule(rawMod);
65
297
  if (!getBuiltinModuleOverride) probedModule = mod;
66
298
  return mod;
67
299
  }
@@ -7,3 +7,6 @@ export * from './db/index.mjs';
7
7
  export * from './sensors/index.mjs';
8
8
  export * from './offloader/index.mjs';
9
9
  export * from './ipc/index.mjs';
10
+ export * from '../core/rsl_triage.mjs';
11
+ export * from '../core/rsl_distiller.mjs';
12
+ export * from '../core/rsl_ledger.mjs';
@@ -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';