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
@@ -0,0 +1,446 @@
1
+ /**
2
+ * @file src/guards/docIndexCore.mjs
3
+ * Pure JavaScript zero-token structural document & log indexer (`< 20ms`, 0 LLM tokens).
4
+ *
5
+ * Architectural Invariants:
6
+ * - ZERO `node:*` imports, ZERO `require()`, ZERO dynamic ESM imports (Mod Law 4 compliant).
7
+ * - Strictly excludes `ctxvault` SKU paths (`packages/airlock/`, `airlock-schema-canary.yml`,
8
+ * `docs/HIGHBEAM_AIRLOCK_*.md`).
9
+ * - Scans outside fenced code blocks for Markdown headings (`#`..`####`), code definitions
10
+ * (`export`, `function`, `class`, `interface`, `type`, `def`, `async def`, `func`, `struct`),
11
+ * or top-level JSON/YAML keys, with a contiguous 150-line unstructured fallback when `< 3`
12
+ * structural boundaries exist in files `> 400` lines.
13
+ */
14
+
15
+ import { normalizeSlashes, sha256Hex } from '../utils/runtime.mjs';
16
+
17
+ export const UNSTRUCTURED_FALLBACK_LINE_THRESHOLD = 400;
18
+ export const UNSTRUCTURED_SPAN_SIZE = 150;
19
+ export const MIN_STRUCTURAL_BOUNDARIES = 3;
20
+ export const MAX_IDENTIFIERS_PER_SPAN = 8;
21
+
22
+ const STOPWORDS = new Set([
23
+ 'const', 'let', 'var', 'function', 'async', 'await', 'return', 'export', 'import', 'from',
24
+ 'default', 'class', 'interface', 'type', 'extends', 'implements', 'public', 'private',
25
+ 'protected', 'static', 'true', 'false', 'null', 'undefined', 'this', 'super', 'new',
26
+ 'throw', 'catch', 'try', 'finally', 'else', 'switch', 'case', 'break', 'continue',
27
+ 'while', 'for', 'typeof', 'instanceof', 'void', 'delete', 'with', 'yield', 'def',
28
+ 'self', 'none', 'pass', 'elif', 'lambda', 'func', 'struct', 'impl', 'pub', 'mut',
29
+ 'string', 'number', 'boolean', 'object', 'array', 'promise', 'record', 'the', 'and',
30
+ 'with', 'that', 'this', 'from', 'into', 'when', 'where', 'then', 'only', 'also',
31
+ 'must', 'should', 'never', 'always', 'line', 'lines', 'file', 'files', 'test', 'data'
32
+ ]);
33
+
34
+ /**
35
+ * Checks whether a path belongs to the isolated sister security SKU and must never be indexed or read.
36
+ *
37
+ * @param {string} [filePath='']
38
+ * @returns {boolean}
39
+ */
40
+ export function isForbiddenSkuPath(filePath = '') {
41
+ const norm = normalizeSlashes(String(filePath || '')).trim();
42
+ if (!norm) return false;
43
+ const lower = norm.toLowerCase();
44
+ if (
45
+ /(?:^|\/)packages\/airlock(?:\/|$)/i.test(lower) ||
46
+ lower.endsWith('.github/workflows/airlock-schema-canary.yml') ||
47
+ /(?:^|\/)\.github\/workflows\/airlock-schema-canary\.yml$/i.test(lower) ||
48
+ /(?:^|\/)docs\/highbeam_airlock_[^/]*\.md$/i.test(lower)
49
+ ) {
50
+ return true;
51
+ }
52
+ return false;
53
+ }
54
+
55
+ /**
56
+ * Splits text into lines across CRLF and LF line endings.
57
+ *
58
+ * @param {string} [rawText='']
59
+ * @returns {string[]}
60
+ */
61
+ export function splitLinesNormalized(rawText = '') {
62
+ const str = String(rawText ?? '');
63
+ if (str.length === 0) return [];
64
+ return str.replace(/\r\n/g, '\n').replace(/\r/g, '\n').split('\n');
65
+ }
66
+
67
+ /**
68
+ * Parses YAML frontmatter from a `.index.md` document.
69
+ *
70
+ * @param {string} [markdownText='']
71
+ * @returns {{ indexed_file: string, sha256: string, total_lines: number, generated_by: string } | null}
72
+ */
73
+ export function parseIndexFrontmatter(markdownText = '') {
74
+ const lines = splitLinesNormalized(markdownText);
75
+ if (lines.length < 3 || lines[0].trim() !== '---') return null;
76
+ const meta = {
77
+ indexed_file: '',
78
+ sha256: '',
79
+ total_lines: 0,
80
+ generated_by: ''
81
+ };
82
+ let closed = false;
83
+ for (let i = 1; i < Math.min(lines.length, 25); i++) {
84
+ const trimmed = lines[i].trim();
85
+ if (trimmed === '---') {
86
+ closed = true;
87
+ break;
88
+ }
89
+ const sepIdx = trimmed.indexOf(':');
90
+ if (sepIdx === -1) continue;
91
+ const key = trimmed.slice(0, sepIdx).trim();
92
+ const val = trimmed.slice(sepIdx + 1).trim().replace(/^["']|["']$/g, '');
93
+ if (key === 'indexed_file') meta.indexed_file = val;
94
+ else if (key === 'sha256') meta.sha256 = val;
95
+ else if (key === 'total_lines') meta.total_lines = Number(val) || 0;
96
+ else if (key === 'generated_by') meta.generated_by = val;
97
+ }
98
+ return closed && meta.sha256 ? meta : null;
99
+ }
100
+
101
+ /**
102
+ * Compares live SHA-256 of a file against `.index.md` YAML frontmatter.
103
+ * Returns `0` (`FRESH`), `1` (`STALE`), or `2` (`MISSING`).
104
+ *
105
+ * @param {string} liveSha256
106
+ * @param {string | null | undefined} indexMarkdownText
107
+ * @returns {{ code: 0 | 1 | 2, status: 'FRESH' | 'STALE' | 'MISSING', recordedSha256: string | null }}
108
+ */
109
+ export function compareIndexFreshness(liveSha256, indexMarkdownText) {
110
+ if (!indexMarkdownText || typeof indexMarkdownText !== 'string') {
111
+ return { code: 2, status: 'MISSING', recordedSha256: null };
112
+ }
113
+ const fm = parseIndexFrontmatter(indexMarkdownText);
114
+ if (!fm || !fm.sha256) {
115
+ return { code: 2, status: 'MISSING', recordedSha256: null };
116
+ }
117
+ if (String(fm.sha256).toLowerCase() === String(liveSha256 || '').toLowerCase()) {
118
+ return { code: 0, status: 'FRESH', recordedSha256: fm.sha256 };
119
+ }
120
+ return { code: 1, status: 'STALE', recordedSha256: fm.sha256 };
121
+ }
122
+
123
+ function sanitizeTableCell(text = '') {
124
+ return String(text || '')
125
+ .replace(/\|/g, '\\|')
126
+ .replace(/\s+/g, ' ')
127
+ .trim()
128
+ .slice(0, 96);
129
+ }
130
+
131
+ /**
132
+ * Extracts up to `maxCount` backticked terms or high-signal identifiers from a slice of lines.
133
+ *
134
+ * @param {string[]} lines
135
+ * @param {number} startIdx - 0-based inclusive
136
+ * @param {number} endIdx - 0-based inclusive
137
+ * @param {number} [maxCount=MAX_IDENTIFIERS_PER_SPAN]
138
+ * @returns {string[]}
139
+ */
140
+ export function extractSpanIdentifiers(lines, startIdx, endIdx, maxCount = MAX_IDENTIFIERS_PER_SPAN) {
141
+ const counts = new Map();
142
+ const backtickTerms = [];
143
+ const backtickSeen = new Set();
144
+
145
+ const upper = Math.min(lines.length - 1, endIdx);
146
+ for (let i = Math.max(0, startIdx); i <= upper; i++) {
147
+ const line = lines[i] || '';
148
+ if (line.length > 500) continue;
149
+
150
+ // 1. Backticked terms first (high signal in Markdown/JSDoc/logs)
151
+ const btRegex = /`([A-Za-z0-9_./:-]{3,48})`/g;
152
+ let btMatch;
153
+ while ((btMatch = btRegex.exec(line)) !== null) {
154
+ const term = btMatch[1];
155
+ if (!backtickSeen.has(term) && !STOPWORDS.has(term.toLowerCase())) {
156
+ backtickSeen.add(term);
157
+ backtickTerms.push(term);
158
+ if (backtickTerms.length >= maxCount) break;
159
+ }
160
+ }
161
+
162
+ // 2. Identifiers (camelCase, PascalCase, snake_case, SCREAMING_SNAKE, error codes)
163
+ const idRegex = /\b([A-Za-z_][A-Za-z0-9_]{3,44})\b/g;
164
+ let idMatch;
165
+ while ((idMatch = idRegex.exec(line)) !== null) {
166
+ const ident = idMatch[1];
167
+ const lower = ident.toLowerCase();
168
+ if (STOPWORDS.has(lower)) continue;
169
+ const isStructuredIdent =
170
+ /[A-Z]/.test(ident) || ident.includes('_') || ident.length >= 6;
171
+ if (!isStructuredIdent) continue;
172
+ counts.set(ident, (counts.get(ident) || 0) + 1);
173
+ }
174
+ }
175
+
176
+ const out = [...backtickTerms.slice(0, maxCount)];
177
+ if (out.length < maxCount) {
178
+ const ranked = Array.from(counts.entries())
179
+ .filter(([ident]) => !backtickSeen.has(ident))
180
+ .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
181
+ for (const [ident] of ranked) {
182
+ out.push(ident);
183
+ if (out.length >= maxCount) break;
184
+ }
185
+ }
186
+ return out;
187
+ }
188
+
189
+ /**
190
+ * Detects structural boundary label on a single line (outside Markdown code fences).
191
+ *
192
+ * @param {string} line
193
+ * @param {boolean} isMarkdownLike
194
+ * @returns {string | null}
195
+ */
196
+ function matchStructuralBoundary(line, isMarkdownLike) {
197
+ const trimmed = line.trim();
198
+ if (!trimmed || trimmed.length > 240) return null;
199
+
200
+ // Markdown headings (# .. ####)
201
+ const mdMatch = /^(#{1,4})\s+(.+)$/.exec(line);
202
+ if (mdMatch) {
203
+ return `${mdMatch[1]} ${mdMatch[2].trim().slice(0, 72)}`;
204
+ }
205
+ if (isMarkdownLike) return null;
206
+
207
+ // JS/TS exports, functions, classes, interfaces, types
208
+ const jsMatch =
209
+ /^(?:export\s+(?:default\s+)?)?(?:async\s+)?(?:function\*?\s+([A-Za-z_$][A-Za-z0-9_$]*)|class\s+([A-Za-z_$][A-Za-z0-9_$]*)|interface\s+([A-Za-z_$][A-Za-z0-9_$]*)|type\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=|const\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=\s*(?:async\s*)?(?:\([^\x29]*\)|[A-Za-z_$][A-Za-z0-9_$]*)\s*=>|(?:export\s+const\s+([A-Za-z_$][A-Za-z0-9_$]*)\s*=))/.exec(
210
+ line
211
+ );
212
+ if (jsMatch) {
213
+ const sym = jsMatch[1] || jsMatch[2] || jsMatch[3] || jsMatch[4] || jsMatch[5] || jsMatch[6];
214
+ if (sym) return sym;
215
+ }
216
+
217
+ // Python / Go / Rust definitions
218
+ const pyGoRustMatch =
219
+ /^(?:async\s+def|def|class|func(?:\s*\([^\x29]+\))?|pub\s+(?:async\s+)?fn|fn|pub\s+struct|struct|impl)\s+([A-Za-z_][A-Za-z0-9_]*)/.exec(
220
+ line
221
+ );
222
+ if (pyGoRustMatch) {
223
+ return pyGoRustMatch[1];
224
+ }
225
+
226
+ // Top-level JSON or YAML keys (0-2 leading spaces)
227
+ const jsonKeyMatch = /^ {0,2}"([A-Za-z0-9_.-]{2,48})"\s*:\s*[\x7b\x5b]/.exec(line);
228
+ if (jsonKeyMatch) {
229
+ return `"${jsonKeyMatch[1]}"`;
230
+ }
231
+ const yamlKeyMatch = /^([A-Za-z][A-Za-z0-9_.-]{1,48}):\s*(?:#.*)?$/.exec(line);
232
+ if (yamlKeyMatch && !/^(?:https?|file|mailto)$/i.test(yamlKeyMatch[1])) {
233
+ return `${yamlKeyMatch[1]}:`;
234
+ }
235
+
236
+ return null;
237
+ }
238
+
239
+ /**
240
+ * Builds deterministic zero-token `.index.md` content for any text/code/log file.
241
+ *
242
+ * @param {object} params
243
+ * @param {string} params.filePath
244
+ * @param {string} [params.displayPath]
245
+ * @param {string} params.rawText
246
+ * @param {string} [params.sha256]
247
+ * @returns {{
248
+ * markdown: string,
249
+ * sha256: string,
250
+ * totalLines: number,
251
+ * spanCount: number,
252
+ * usedFallback: boolean,
253
+ * indexTokens: number
254
+ * }}
255
+ */
256
+ export function buildStructuralIndexMarkdown({
257
+ filePath = '',
258
+ displayPath = '',
259
+ rawText = '',
260
+ sha256 = ''
261
+ } = {}) {
262
+ const normalizedRaw = String(rawText ?? '').replace(/\r\n/g, '\n');
263
+ const computedSha = sha256 || sha256Hex(normalizedRaw);
264
+ const lines = splitLinesNormalized(rawText);
265
+ const totalLines = lines.length;
266
+ const labelPath = normalizeSlashes(displayPath || filePath || 'unknown');
267
+ const isMarkdownLike = /\.(?:md|mdx|markdown)$/i.test(labelPath);
268
+
269
+ const boundaries = [];
270
+ let inFence = false;
271
+ let fenceMarker = '';
272
+
273
+ for (let i = 0; i < totalLines; i++) {
274
+ const line = lines[i];
275
+ const fenceMatch = /^\s*(`{3,}|~{3,})/.exec(line);
276
+ if (fenceMatch) {
277
+ const marker = fenceMatch[1][0];
278
+ if (!inFence) {
279
+ inFence = true;
280
+ fenceMarker = marker;
281
+ } else if (marker === fenceMarker) {
282
+ inFence = false;
283
+ fenceMarker = '';
284
+ }
285
+ continue;
286
+ }
287
+ if (inFence) continue;
288
+
289
+ const label = matchStructuralBoundary(line, isMarkdownLike);
290
+ if (label) {
291
+ boundaries.push({ lineNum: i + 1, label });
292
+ }
293
+ }
294
+
295
+ let spans = [];
296
+ let usedFallback = false;
297
+
298
+ if (boundaries.length < MIN_STRUCTURAL_BOUNDARIES && totalLines > UNSTRUCTURED_FALLBACK_LINE_THRESHOLD) {
299
+ usedFallback = true;
300
+ for (let start = 1; start <= totalLines; start += UNSTRUCTURED_SPAN_SIZE) {
301
+ const end = Math.min(totalLines, start + UNSTRUCTURED_SPAN_SIZE - 1);
302
+ const idents = extractSpanIdentifiers(lines, start - 1, end - 1);
303
+ spans.push({
304
+ startLine: start,
305
+ endLine: end,
306
+ label: `Unstructured Span L${start}-L${end}`,
307
+ identifiers: idents
308
+ });
309
+ }
310
+ } else if (boundaries.length > 0) {
311
+ // Include leading preamble if boundary 0 starts after line 1
312
+ if (boundaries[0].lineNum > 1) {
313
+ const preEnd = boundaries[0].lineNum - 1;
314
+ spans.push({
315
+ startLine: 1,
316
+ endLine: preEnd,
317
+ label: 'Preamble / Imports',
318
+ identifiers: extractSpanIdentifiers(lines, 0, preEnd - 1)
319
+ });
320
+ }
321
+ for (let idx = 0; idx < boundaries.length; idx++) {
322
+ const curr = boundaries[idx];
323
+ const next = boundaries[idx + 1];
324
+ const endLine = next ? Math.max(curr.lineNum, next.lineNum - 1) : totalLines;
325
+ spans.push({
326
+ startLine: curr.lineNum,
327
+ endLine,
328
+ label: curr.label,
329
+ identifiers: extractSpanIdentifiers(lines, curr.lineNum - 1, endLine - 1)
330
+ });
331
+ }
332
+ } else {
333
+ const end = Math.max(1, totalLines);
334
+ spans.push({
335
+ startLine: 1,
336
+ endLine: end,
337
+ label: totalLines === 0 ? 'Empty File' : `Full Span L1-L${end}`,
338
+ identifiers: totalLines === 0 ? [] : extractSpanIdentifiers(lines, 0, end - 1)
339
+ });
340
+ }
341
+
342
+ // Cap extreme table rows at 120 spans by coalescing adjacent micro-spans if needed
343
+ if (spans.length > 120) {
344
+ const bucketSize = Math.ceil(spans.length / 80);
345
+ const merged = [];
346
+ for (let i = 0; i < spans.length; i += bucketSize) {
347
+ const group = spans.slice(i, i + bucketSize);
348
+ const combinedIdents = [];
349
+ const seen = new Set();
350
+ for (const g of group) {
351
+ for (const id of g.identifiers) {
352
+ if (!seen.has(id)) {
353
+ seen.add(id);
354
+ combinedIdents.push(id);
355
+ }
356
+ if (combinedIdents.length >= MAX_IDENTIFIERS_PER_SPAN) break;
357
+ }
358
+ }
359
+ merged.push({
360
+ startLine: group[0].startLine,
361
+ endLine: group[group.length - 1].endLine,
362
+ label: group.length > 1 ? `${group[0].label} (+${group.length - 1} more)` : group[0].label,
363
+ identifiers: combinedIdents
364
+ });
365
+ }
366
+ spans = merged;
367
+ }
368
+
369
+ const rows = spans.map((sp) => {
370
+ const rangeStr = `L${sp.startLine}-L${sp.endLine}`;
371
+ const sectionStr = sanitizeTableCell(sp.label);
372
+ const identStr =
373
+ sp.identifiers.length > 0
374
+ ? sp.identifiers.map((id) => `\`${sanitizeTableCell(id)}\``).join(', ')
375
+ : '—';
376
+ return `| ${rangeStr} | ${sectionStr} | ${identStr} |`;
377
+ });
378
+
379
+ const markdown = [
380
+ '---',
381
+ `indexed_file: "${labelPath}"`,
382
+ `sha256: "${computedSha}"`,
383
+ `total_lines: ${totalLines}`,
384
+ 'generated_by: "ctxtop-doc-indexer"',
385
+ '---',
386
+ '',
387
+ `# Structural Index: \`${labelPath}\` (${totalLines} lines)`,
388
+ '',
389
+ '| Lines | Section / Symbol | High-Signal Identifiers |',
390
+ '| :--- | :--- | :--- |',
391
+ ...rows,
392
+ ''
393
+ ].join('\n');
394
+
395
+ return {
396
+ markdown,
397
+ sha256: computedSha,
398
+ totalLines,
399
+ spanCount: spans.length,
400
+ usedFallback,
401
+ indexTokens: Math.max(1, Math.ceil(markdown.length / 4))
402
+ };
403
+ }
404
+
405
+ /**
406
+ * Formats 1-indexed line-numbered slice output (` 142 | ...`) across CRLF and LF inputs.
407
+ *
408
+ * @param {string} [rawText='']
409
+ * @param {number} [startLine=1]
410
+ * @param {number} [endLine=1]
411
+ * @returns {{ text: string, startLine: number, endLine: number, totalLines: number }}
412
+ */
413
+ export function formatSlicedLines(rawText = '', startLine = 1, endLine = 1) {
414
+ const lines = splitLinesNormalized(rawText);
415
+ const totalLines = lines.length;
416
+ if (totalLines === 0) {
417
+ return { text: '', startLine: 0, endLine: 0, totalLines: 0 };
418
+ }
419
+ const s = Math.max(1, Math.min(totalLines, Math.floor(Number(startLine) || 1)));
420
+ const e = Math.max(s, Math.min(totalLines, Math.floor(Number(endLine) || s)));
421
+ const width = Math.max(6, String(e).length);
422
+ const out = [];
423
+ for (let lineNum = s; lineNum <= e; lineNum++) {
424
+ out.push(`${String(lineNum).padStart(width, ' ')} | ${lines[lineNum - 1]}`);
425
+ }
426
+ return {
427
+ text: out.join('\n'),
428
+ startLine: s,
429
+ endLine: e,
430
+ totalLines
431
+ };
432
+ }
433
+
434
+ export default {
435
+ UNSTRUCTURED_FALLBACK_LINE_THRESHOLD,
436
+ UNSTRUCTURED_SPAN_SIZE,
437
+ MIN_STRUCTURAL_BOUNDARIES,
438
+ MAX_IDENTIFIERS_PER_SPAN,
439
+ isForbiddenSkuPath,
440
+ splitLinesNormalized,
441
+ parseIndexFrontmatter,
442
+ compareIndexFreshness,
443
+ extractSpanIdentifiers,
444
+ buildStructuralIndexMarkdown,
445
+ formatSlicedLines
446
+ };