ctxtop 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. package/src/webview/simple_view.html +1 -1
@@ -1,12 +1,16 @@
1
1
  {
2
2
  "name": "@ctxtop/engine-node",
3
- "version": "4.1.0",
3
+ "version": "4.1.1",
4
4
  "description": "Highbeam Node.js >=20 runtime engine (SQLite + JSONL fallback, Micro-IPC, lossless offloader, git sensors)",
5
5
  "type": "module",
6
6
  "main": "./src/index.mjs",
7
7
  "exports": {
8
- ".": "./src/index.mjs"
8
+ ".": "./src/index.mjs",
9
+ "./*": "./src/*"
9
10
  },
11
+ "files": [
12
+ "src/"
13
+ ],
10
14
  "engines": {
11
15
  "node": ">=20.0.0"
12
16
  },
@@ -0,0 +1,58 @@
1
+ /**
2
+ * @file src/engine-node/db/index.mjs
3
+ * Unified database client factory for Highbeam storage engines.
4
+ *
5
+ * Dynamically resolves to native read-only node:sqlite on Node >= 22.5,
6
+ * or pure-JS JsonlDatabaseFallbackWrapper on Node 20 LTS without warnings.
7
+ */
8
+
9
+ import { isNodeSqliteAvailable, getDatabaseSyncClass, suppressSqliteWarning } from './probe.mjs';
10
+ import { SqliteDatabaseSyncWrapper } from './sqlite_wrapper.mjs';
11
+ import { JsonlDatabaseFallbackWrapper } from './jsonl_fallback.mjs';
12
+
13
+ /**
14
+ * Returns a unified read-only database client.
15
+ *
16
+ * @param {object} options
17
+ * @param {string} options.dbPath - Path to database or session transcript
18
+ * @param {boolean} options.readOnly - Must strictly be true
19
+ * @param {boolean} [options.forceFallback=false] - Force JSONL fallback wrapper
20
+ * @returns {SqliteDatabaseSyncWrapper | JsonlDatabaseFallbackWrapper}
21
+ */
22
+ export function getDatabaseClient(options = {}) {
23
+ if (!options || typeof options !== 'object') {
24
+ throw new TypeError('getDatabaseClient requires an options object');
25
+ }
26
+ if (options.readOnly !== true) {
27
+ throw new Error('[Zero-Trust SQLite Guard] getDatabaseClient strictly requires { readOnly: true }');
28
+ }
29
+ if (!options.dbPath || typeof options.dbPath !== 'string') {
30
+ throw new TypeError('getDatabaseClient requires a non-empty dbPath string');
31
+ }
32
+
33
+ const { dbPath, forceFallback = false } = options;
34
+
35
+ if (!forceFallback && isNodeSqliteAvailable()) {
36
+ const DatabaseSync = getDatabaseSyncClass();
37
+ return new SqliteDatabaseSyncWrapper(dbPath, { ...options, DatabaseSync });
38
+ }
39
+
40
+ return new JsonlDatabaseFallbackWrapper(dbPath, options);
41
+ }
42
+
43
+ export {
44
+ isNodeSqliteAvailable,
45
+ getDatabaseSyncClass,
46
+ suppressSqliteWarning,
47
+ SqliteDatabaseSyncWrapper,
48
+ JsonlDatabaseFallbackWrapper
49
+ };
50
+
51
+ export default {
52
+ getDatabaseClient,
53
+ isNodeSqliteAvailable,
54
+ getDatabaseSyncClass,
55
+ suppressSqliteWarning,
56
+ SqliteDatabaseSyncWrapper,
57
+ JsonlDatabaseFallbackWrapper
58
+ };
@@ -0,0 +1,184 @@
1
+ /**
2
+ * @file src/engine-node/db/jsonl_fallback.mjs
3
+ * Pure-JS JSONL transcript reader and query emulator for Node 20 LTS environments.
4
+ *
5
+ * Provides equivalent get(), all(), and searchFts() interface for session transcripts,
6
+ * strictly enforcing the { readOnly: true } invariant and rejecting mutation queries.
7
+ */
8
+
9
+ import fs from 'node:fs';
10
+ import path from 'node:path';
11
+
12
+ const MUTATION_SQL_RE = /^\s*(INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|REPLACE|ATTACH|DETACH|VACUUM|REINDEX)\b/i;
13
+
14
+ export class JsonlDatabaseFallbackWrapper {
15
+ /**
16
+ * @param {string} dbPath
17
+ * @param {object} options
18
+ * @param {boolean} options.readOnly - Must strictly be true
19
+ * @param {Array<object>} [options.records] - Direct pre-loaded records
20
+ */
21
+ constructor(dbPath, options = {}) {
22
+ if (!options || options.readOnly !== true) {
23
+ throw new Error('[Zero-Trust SQLite Guard] JsonlDatabaseFallbackWrapper strictly requires { readOnly: true }');
24
+ }
25
+ this.dbPath = dbPath;
26
+ this.readOnly = true;
27
+ this.isOpen = true;
28
+ this.records = [];
29
+ this._loadRecords(options);
30
+ }
31
+
32
+ _loadRecords(options = {}) {
33
+ if (options.records && Array.isArray(options.records)) {
34
+ this.records = [...options.records];
35
+ return;
36
+ }
37
+ if (!this.dbPath || typeof this.dbPath !== 'string') return;
38
+
39
+ try {
40
+ const targetPath = path.resolve(this.dbPath);
41
+ if (fs.existsSync(targetPath)) {
42
+ const stat = fs.statSync(targetPath);
43
+ if (stat.isFile() && targetPath.endsWith('.jsonl')) {
44
+ this._parseJsonlFile(targetPath);
45
+ return;
46
+ }
47
+
48
+ const sessionDir = stat.isDirectory() ? targetPath : path.dirname(targetPath);
49
+ const cand1 = path.join(sessionDir, '.system_generated', 'logs', 'transcript_full.jsonl');
50
+ if (fs.existsSync(cand1)) {
51
+ this._parseJsonlFile(cand1);
52
+ return;
53
+ }
54
+ const cand2 = path.join(sessionDir, '.system_generated', 'logs', 'transcript.jsonl');
55
+ if (fs.existsSync(cand2)) {
56
+ this._parseJsonlFile(cand2);
57
+ return;
58
+ }
59
+ const cand3 = path.join(sessionDir, 'transcript.jsonl');
60
+ if (fs.existsSync(cand3)) {
61
+ this._parseJsonlFile(cand3);
62
+ return;
63
+ }
64
+ }
65
+ } catch {
66
+ // Graceful fail-open on path lookup
67
+ }
68
+ }
69
+
70
+ _parseJsonlFile(filePath) {
71
+ try {
72
+ const content = fs.readFileSync(filePath, 'utf8');
73
+ const lines = content.split(/\r?\n/);
74
+ for (const line of lines) {
75
+ const trimmed = line.trim();
76
+ if (!trimmed) continue;
77
+ try {
78
+ const parsed = JSON.parse(trimmed);
79
+ if (parsed !== null && parsed !== undefined) this.records.push(parsed);
80
+ } catch {
81
+ // Ignore malformed individual JSONL line
82
+ }
83
+ }
84
+ } catch {
85
+ // File read error caught gracefully
86
+ }
87
+ }
88
+
89
+ _assertNotMutating(sql) {
90
+ if (MUTATION_SQL_RE.test(sql)) {
91
+ throw new Error(`[Zero-Trust SQLite Guard] Mutation query not permitted on read-only database: ${sql}`);
92
+ }
93
+ }
94
+
95
+ get(sql, params = []) {
96
+ const rows = this.all(sql, params);
97
+ return rows.length > 0 ? rows[0] : null;
98
+ }
99
+
100
+ all(sql, params = []) {
101
+ if (!this.isOpen) throw new Error('Database handle is closed');
102
+ this._assertNotMutating(sql);
103
+
104
+ // Handle SELECT COUNT(*)
105
+ if (/SELECT\s+COUNT\(\*\)\s+(?:AS\s+(\w+))?/i.test(sql)) {
106
+ const match = sql.match(/SELECT\s+COUNT\(\*\)\s+(?:AS\s+(\w+))?/i);
107
+ const alias = match ? match[1] || 'cnt' : 'cnt';
108
+ return [{ [alias]: this.records.length }];
109
+ }
110
+
111
+ let filtered = this.records;
112
+
113
+ // Handle WHERE column = ? or literal
114
+ const whereMatch = sql.match(/WHERE\s+([a-zA-Z0-9_]+)\s*=\s*(?:\?|'([^']*)'|(\d+))/i);
115
+ if (whereMatch) {
116
+ const col = whereMatch[1];
117
+ const expectedVal = whereMatch[2] !== undefined
118
+ ? whereMatch[2]
119
+ : whereMatch[3] !== undefined
120
+ ? Number(whereMatch[3])
121
+ : (Array.isArray(params) ? params[0] : params);
122
+
123
+ filtered = filtered.filter(r => r && (r[col] === expectedVal || String(r[col]) === String(expectedVal)));
124
+ }
125
+
126
+ // Handle LIMIT N
127
+ const limitMatch = sql.match(/LIMIT\s+(\d+)/i);
128
+ if (limitMatch) {
129
+ const lim = parseInt(limitMatch[1], 10);
130
+ filtered = filtered.slice(0, lim);
131
+ }
132
+
133
+ return filtered;
134
+ }
135
+
136
+ searchFts(query, limit = 10) {
137
+ if (!this.isOpen) throw new Error('Database handle is closed');
138
+ if (!query || typeof query !== 'string') return [];
139
+
140
+ const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
141
+ if (terms.length === 0) return [];
142
+
143
+ const results = [];
144
+ for (const r of this.records) {
145
+ if (!r) continue;
146
+ const text = typeof r === 'string'
147
+ ? r
148
+ : Object.values(r).map(v => (typeof v === 'object' && v !== null ? JSON.stringify(v) : String(v ?? ''))).join(' ');
149
+ const lower = text.toLowerCase();
150
+ let score = 0;
151
+ let firstIdx = -1;
152
+
153
+ for (const term of terms) {
154
+ let idx = 0;
155
+ let count = 0;
156
+ while ((idx = lower.indexOf(term, idx)) !== -1) {
157
+ count++;
158
+ if (firstIdx === -1 || idx < firstIdx) firstIdx = idx;
159
+ idx += term.length;
160
+ }
161
+ if (count > 0) {
162
+ score += count * (term.length / Math.max(1, lower.length) + 1);
163
+ }
164
+ }
165
+
166
+ if (score > 0) {
167
+ const start = Math.max(0, firstIdx - 20);
168
+ const end = Math.min(text.length, firstIdx + 60);
169
+ const snippet = (start > 0 ? '...' : '') + text.slice(start, end) + (end < text.length ? '...' : '');
170
+ results.push({ ...r, snippet, score });
171
+ }
172
+ }
173
+
174
+ results.sort((a, b) => b.score - a.score);
175
+ return results.slice(0, limit);
176
+ }
177
+
178
+ close() {
179
+ this.isOpen = false;
180
+ this.records = [];
181
+ }
182
+ }
183
+
184
+ export default JsonlDatabaseFallbackWrapper;
@@ -0,0 +1,342 @@
1
+ /**
2
+ * @file src/engine-node/db/probe.mjs
3
+ * Dynamic runtime probe for node:sqlite builtin module.
4
+ *
5
+ * Enables full read-only SQLite & FTS5 on Node >= 22.5, with automatic fallback
6
+ * to JSONL parsing on Node 20 LTS with zero --no-warnings flags.
7
+ */
8
+
9
+ let warningSuppressed = false;
10
+
11
+ /**
12
+ * Suppresses experimental SQLite warning from process.emitWarning.
13
+ * Allows Node >= 22.5 to load node:sqlite with 0 stderr noise and zero --no-warnings CLI flags.
14
+ */
15
+ export function suppressSqliteWarning({ force = false } = {}) {
16
+ if ((warningSuppressed && !force) || typeof process === 'undefined') return;
17
+ warningSuppressed = true;
18
+ if (typeof process.emitWarning === 'function') {
19
+ const orig = process.emitWarning.bind(process);
20
+ process.emitWarning = function (warning, ...args) {
21
+ const msg = typeof warning === 'string' ? warning : (warning && warning.message) || '';
22
+ const type = typeof args[0] === 'string' ? args[0] : (args[0] && args[0].type) || (warning && warning.name) || '';
23
+ if ((type === 'ExperimentalWarning' && /SQLite/i.test(msg)) || /SQLite is an experimental feature/i.test(msg)) {
24
+ return;
25
+ }
26
+ return orig(warning, ...args);
27
+ };
28
+ }
29
+ }
30
+
31
+ let probedModule = undefined;
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
+
264
+ /**
265
+ * Probes for built-in node:sqlite module via process.getBuiltinModule.
266
+ *
267
+ * @param {object} [options={}]
268
+ * @param {boolean} [options.forceFallback=false]
269
+ * @param {Function|null} [options.getBuiltinModuleOverride=null]
270
+ * @returns {object|null}
271
+ */
272
+ export function probeSqliteBuiltin({ forceFallback = false, getBuiltinModuleOverride = null } = {}) {
273
+ if (
274
+ forceFallback ||
275
+ (typeof process !== 'undefined' && process.env?.CTXTOP_FORCE_NO_SQLITE === '1')
276
+ ) {
277
+ return null;
278
+ }
279
+ if (probedModule !== undefined && !getBuiltinModuleOverride) return probedModule;
280
+
281
+ suppressSqliteWarning();
282
+
283
+ const getBuiltin = getBuiltinModuleOverride ||
284
+ (typeof process !== 'undefined' && typeof process.getBuiltinModule === 'function'
285
+ ? process.getBuiltinModule.bind(process)
286
+ : null);
287
+
288
+ if (!getBuiltin) {
289
+ if (!getBuiltinModuleOverride) probedModule = null;
290
+ return null;
291
+ }
292
+
293
+ try {
294
+ const rawMod = getBuiltin('node:sqlite');
295
+ if (rawMod && typeof rawMod.DatabaseSync === 'function') {
296
+ const mod = getBuiltinModuleOverride ? rawMod : ensureFts5CapableModule(rawMod);
297
+ if (!getBuiltinModuleOverride) probedModule = mod;
298
+ return mod;
299
+ }
300
+ } catch {
301
+ // Fail-open: probe never throws
302
+ }
303
+
304
+ if (!getBuiltinModuleOverride) probedModule = null;
305
+ return null;
306
+ }
307
+
308
+ /**
309
+ * Returns true if built-in node:sqlite with DatabaseSync is available in this runtime.
310
+ *
311
+ * @param {object} [options={}]
312
+ * @returns {boolean}
313
+ */
314
+ export function isNodeSqliteAvailable(options = {}) {
315
+ return Boolean(probeSqliteBuiltin(options));
316
+ }
317
+
318
+ /**
319
+ * Returns the DatabaseSync constructor if available, or null.
320
+ *
321
+ * @param {object} [options={}]
322
+ * @returns {Function|null}
323
+ */
324
+ export function getDatabaseSyncClass(options = {}) {
325
+ const mod = probeSqliteBuiltin(options);
326
+ return mod?.DatabaseSync || null;
327
+ }
328
+
329
+ /**
330
+ * Resets probe cache for testing environments.
331
+ */
332
+ export function resetProbeCacheForTesting() {
333
+ probedModule = undefined;
334
+ }
335
+
336
+ export default {
337
+ suppressSqliteWarning,
338
+ probeSqliteBuiltin,
339
+ isNodeSqliteAvailable,
340
+ getDatabaseSyncClass,
341
+ resetProbeCacheForTesting
342
+ };