ctxtop 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,1029 @@
1
+ /**
2
+ * @file src/core/rsl_ledger.mjs
3
+ * Stage 3 Dual-Platform ExpeL Importance Ledger & Simultaneous Carrier Compiler.
4
+ *
5
+ * Compiles validated heuristics simultaneously into:
6
+ * - Carrier A: `.agents/rules/rsl-<slug>.md` AND `.claude/rules/rsl-<slug>.md`
7
+ * - Carrier B: `.agents/skills/rsl-<slug>/SKILL.md` AND `.claude/skills/rsl-<slug>/SKILL.md`
8
+ * - Carrier C: `.agents/hooks.json` (`PreToolUse`) AND `.claude/settings.json` (`PreToolUse`)
9
+ *
10
+ * Governs lifecycle weights (`importance: 2` init, `+1` clean reuse, `-1` repeat violation,
11
+ * `<= 0` dual-platform deletion, `>= 5` or `>= 2` repeat violations -> deterministic hook promotion).
12
+ */
13
+
14
+ import fs from 'node:fs';
15
+ import path from 'node:path';
16
+ import os from 'node:os';
17
+ import { fileURLToPath } from 'node:url';
18
+ import { atomicWriteFileSync } from './atomic_io.mjs';
19
+ import { RSL_CONSTANTS } from './constants.mjs';
20
+ import { auditClaudeAutoMemory } from './shield_manager.mjs';
21
+ import { toKebabSlug } from './rsl_distiller.mjs';
22
+ import { humanizeLearnedRule } from '../core-isomorphic/catalog/safeguardGuide.mjs';
23
+ import {
24
+ extractRuleDirectives,
25
+ doRuleScopesOverlap,
26
+ detectRuleClashes,
27
+ auditWorkspaceRuleClashes,
28
+ buildConsolidatedSpecMarkdown
29
+ } from './rsl_clash_auditor.mjs';
30
+
31
+ export {
32
+ extractRuleDirectives,
33
+ doRuleScopesOverlap,
34
+ detectRuleClashes,
35
+ auditWorkspaceRuleClashes,
36
+ buildConsolidatedSpecMarkdown
37
+ };
38
+
39
+ const __dirname = path.dirname(fileURLToPath(import.meta.url));
40
+ export const RSL_PKG_ROOT = path.resolve(__dirname, '..', '..').replace(/\\/g, '/');
41
+
42
+ const ANTIGRAVITY_RSL_HOOK_RE = /src[\\/]hooks[\\/]antigravity_rsl_hook\.mjs/i;
43
+ const CLAUDE_RSL_HOOK_RE = /src[\\/]hooks[\\/]claude_rsl_hook\.mjs/i;
44
+
45
+ /**
46
+ * Resolves `<workspaceRoot>/.agents/telemetry/rsl_ledger.json`.
47
+ * @param {string} workspaceRoot
48
+ * @returns {string}
49
+ */
50
+ export function getRslLedgerPath(workspaceRoot = process.cwd()) {
51
+ return path.join(path.resolve(workspaceRoot), '.agents', 'telemetry', 'rsl_ledger.json');
52
+ }
53
+
54
+ function createEmptyLedger() {
55
+ return {
56
+ schemaVersion: '2026.11.1',
57
+ updatedAt: new Date().toISOString(),
58
+ stats: {
59
+ taintedSessions: 0,
60
+ prunedCount: 0,
61
+ lastSessionId: null,
62
+ lastPlatform: null
63
+ },
64
+ items: {}
65
+ };
66
+ }
67
+
68
+ /**
69
+ * Reads `.agents/telemetry/rsl_ledger.json` safely.
70
+ * @param {string} [workspaceRoot=process.cwd()]
71
+ * @returns {object}
72
+ */
73
+ export function readRslLedger(workspaceRoot = process.cwd()) {
74
+ const ledgerPath = getRslLedgerPath(workspaceRoot);
75
+ if (!fs.existsSync(ledgerPath)) {
76
+ return createEmptyLedger();
77
+ }
78
+ try {
79
+ const parsed = JSON.parse(fs.readFileSync(ledgerPath, 'utf8'));
80
+ if (!parsed || typeof parsed !== 'object') return createEmptyLedger();
81
+ return {
82
+ schemaVersion: parsed.schemaVersion || '2026.11.1',
83
+ updatedAt: parsed.updatedAt || new Date().toISOString(),
84
+ stats: {
85
+ taintedSessions: Number(parsed.stats?.taintedSessions || 0),
86
+ prunedCount: Number(parsed.stats?.prunedCount || 0),
87
+ lastSessionId: parsed.stats?.lastSessionId || null,
88
+ lastPlatform: parsed.stats?.lastPlatform || null
89
+ },
90
+ items: parsed.items && typeof parsed.items === 'object' ? parsed.items : {}
91
+ };
92
+ } catch {
93
+ return createEmptyLedger();
94
+ }
95
+ }
96
+
97
+ /**
98
+ * Atomically persists `.agents/telemetry/rsl_ledger.json`.
99
+ * @param {string} workspaceRoot
100
+ * @param {object} ledger
101
+ */
102
+ export function writeRslLedger(workspaceRoot, ledger) {
103
+ const ledgerPath = getRslLedgerPath(workspaceRoot);
104
+ fs.mkdirSync(path.dirname(ledgerPath), { recursive: true });
105
+ const payload = {
106
+ ...ledger,
107
+ updatedAt: new Date().toISOString()
108
+ };
109
+ atomicWriteFileSync(ledgerPath, `${JSON.stringify(payload, null, 2)}\n`);
110
+ return ledgerPath;
111
+ }
112
+
113
+ /**
114
+ * Rewrites Antigravity `@[label](path)` inline includes into canonical `@path` pointers
115
+ * so target files are not expanded prior to the 24,000-byte truncation check.
116
+ * Also strips Claude-only `$ARGUMENTS` syntax.
117
+ *
118
+ * @param {string} text
119
+ * @returns {string}
120
+ */
121
+ export function rewriteAntigravityReferences(text = '') {
122
+ return String(text || '')
123
+ .replace(/@\[[^\]]*\]\(([^)\s]+)\)/g, (_, target) => `@${target.replace(/\\/g, '/')}`)
124
+ .replace(/\$ARGUMENTS\b/gi, '')
125
+ .trim();
126
+ }
127
+
128
+ /**
129
+ * Rewrites Antigravity `@[label](path)` and bare `@path/file` tokens into backtick-wrapped paths
130
+ * for Claude Code `.claude/rules/` (preventing eager `@path` file imports).
131
+ *
132
+ * @param {string} text
133
+ * @returns {string}
134
+ */
135
+ export function rewriteClaudeReferences(text = '') {
136
+ return String(text || '')
137
+ .replace(/@\[[^\]]*\]\(([^)\s]+)\)/g, (_, target) => `\`${target.replace(/\\/g, '/')}\``)
138
+ .replace(/(^|[^a-zA-Z0-9_`])@([a-zA-Z0-9_.-]+(?:\/[a-zA-Z0-9_.-]+)+|\.[a-zA-Z0-9_.-]+|[a-zA-Z0-9_.-]+\.[a-z]{1,6})/g, '$1`$2`')
139
+ .trim();
140
+ }
141
+
142
+ /**
143
+ * Enforces strict Agent Skills third-person description hygiene without `"You are"`,
144
+ * `"PROACTIVELY"`, or `$ARGUMENTS`.
145
+ *
146
+ * @param {string} desc
147
+ * @param {string} slug
148
+ * @returns {string}
149
+ */
150
+ export function sanitizeSkillDescription(desc = '', slug = 'workflow') {
151
+ let clean = String(desc || '')
152
+ .replace(/\bYou are\b[^.]*\.?/gi, '')
153
+ .replace(/\bPROACTIVELY\b/gi, '')
154
+ .replace(/\$ARGUMENTS\b/gi, '')
155
+ .replace(/\s+/g, ' ')
156
+ .trim();
157
+ if (!/\bUse when\b/i.test(clean)) {
158
+ clean = `Use when executing the ${slug} workflow${clean ? `: ${clean}` : ''}.`;
159
+ }
160
+ if (!/\bDo not use\b/i.test(clean)) {
161
+ clean = `${clean.replace(/\.+$/, '')}. Do not use for unrelated tasks.`;
162
+ }
163
+ return clean;
164
+ }
165
+
166
+ function truncateToUtf8ByteCap(text, maxBytes = RSL_CONSTANTS.MAX_RULE_FILE_BYTES) {
167
+ if (Buffer.byteLength(text, 'utf8') <= maxBytes) return text;
168
+ const lines = text.split('\n');
169
+ const out = [];
170
+ let currentBytes = 0;
171
+ const suffix = '\n<!-- truncated by Highbeam RSL 24KB budget -->\n';
172
+ const limit = maxBytes - Buffer.byteLength(suffix, 'utf8');
173
+ for (const line of lines) {
174
+ const lineBytes = Buffer.byteLength(`${line}\n`, 'utf8');
175
+ if (currentBytes + lineBytes > limit) break;
176
+ out.push(line);
177
+ currentBytes += lineBytes;
178
+ }
179
+ return `${out.join('\n')}${suffix}`;
180
+ }
181
+
182
+ /**
183
+ * Estimates aggregate rule tokens across `AGENTS.md`, `GEMINI.md`, and `.agents/rules/*.md`.
184
+ * @param {string} workspaceRoot
185
+ * @returns {{ totalBytes: number, totalTokens: number, budgetTokens: number, pct: number, files: Array<object> }}
186
+ */
187
+ export function measureWorkspaceRuleBudget(workspaceRoot = process.cwd()) {
188
+ const baseRoot = path.resolve(workspaceRoot);
189
+ const files = [];
190
+ let totalBytes = 0;
191
+
192
+ for (const topFile of ['AGENTS.md', 'GEMINI.md']) {
193
+ const abs = path.join(baseRoot, topFile);
194
+ if (fs.existsSync(abs)) {
195
+ try {
196
+ const bytes = fs.statSync(abs).size;
197
+ totalBytes += bytes;
198
+ files.push({ path: topFile, bytes, tokens: Math.ceil(bytes / 4) });
199
+ } catch {
200
+ // Ignore
201
+ }
202
+ }
203
+ }
204
+
205
+ const agRulesDir = path.join(baseRoot, '.agents', 'rules');
206
+ if (fs.existsSync(agRulesDir)) {
207
+ try {
208
+ for (const ent of fs.readdirSync(agRulesDir, { withFileTypes: true })) {
209
+ if (!ent.isFile() || !ent.name.endsWith('.md')) continue;
210
+ const abs = path.join(agRulesDir, ent.name);
211
+ const bytes = fs.statSync(abs).size;
212
+ totalBytes += bytes;
213
+ files.push({
214
+ path: `.agents/rules/${ent.name}`,
215
+ bytes,
216
+ tokens: Math.ceil(bytes / 4)
217
+ });
218
+ }
219
+ } catch {
220
+ // Ignore
221
+ }
222
+ }
223
+
224
+ const totalTokens = Math.ceil(totalBytes / 4);
225
+ const budgetTokens = RSL_CONSTANTS.AGGREGATE_RULE_TOKEN_BUDGET;
226
+ return {
227
+ totalBytes,
228
+ totalTokens,
229
+ budgetTokens,
230
+ pct: Math.min(100, Math.round((totalTokens / budgetTokens) * 100)),
231
+ files
232
+ };
233
+ }
234
+
235
+ function buildAntigravityRuleMarkdown(item) {
236
+ const globs = String(item.globs || '').trim();
237
+ const trigger = globs ? 'glob' : 'model_decision';
238
+ const desc = rewriteAntigravityReferences(item.description || item.when_condition || item.slug).replace(/"/g, '\\"');
239
+ const whenTxt = rewriteAntigravityReferences(item.when_condition || '');
240
+ const guideTxt = rewriteAntigravityReferences(item.then_guidance || '');
241
+
242
+ const fmLines = [
243
+ '---',
244
+ `trigger: ${trigger}`
245
+ ];
246
+ if (trigger === 'glob') {
247
+ fmLines.push(`globs: "${globs.replace(/"/g, '')}"`);
248
+ }
249
+ fmLines.push(`description: "${desc}"`);
250
+ fmLines.push('---');
251
+
252
+ const body = [
253
+ ...fmLines,
254
+ '',
255
+ `# RSL Learned Heuristic: ${item.slug}`,
256
+ '',
257
+ `- **Condition**: ${whenTxt}`,
258
+ `- **Guidance**: ${guideTxt}`,
259
+ `- **Importance**: ${item.importance} (${item.sourcePlatform || 'dual'} origin)`,
260
+ ''
261
+ ].join('\n');
262
+
263
+ return truncateToUtf8ByteCap(body, RSL_CONSTANTS.MAX_RULE_FILE_BYTES - 128);
264
+ }
265
+
266
+ function buildClaudeRuleMarkdown(item) {
267
+ const paths = Array.isArray(item.paths) && item.paths.length > 0
268
+ ? item.paths
269
+ : String(item.globs || '')
270
+ .split(',')
271
+ .map((p) => p.trim())
272
+ .filter(Boolean);
273
+
274
+ const whenTxt = rewriteClaudeReferences(item.when_condition || '');
275
+ const guideTxt = rewriteClaudeReferences(item.then_guidance || '');
276
+
277
+ const fmLines = ['---'];
278
+ if (paths.length > 0) {
279
+ fmLines.push('paths:');
280
+ for (const p of paths) {
281
+ fmLines.push(` - "${p.replace(/"/g, '')}"`);
282
+ }
283
+ } else {
284
+ fmLines.push(`description: "${rewriteClaudeReferences(item.description || item.slug).replace(/"/g, '\\"')}"`);
285
+ }
286
+ fmLines.push('---');
287
+
288
+ return [
289
+ ...fmLines,
290
+ '',
291
+ `# RSL Learned Heuristic: ${item.slug}`,
292
+ '',
293
+ `- **Condition**: ${whenTxt}`,
294
+ `- **Guidance**: ${guideTxt}`,
295
+ `- **Importance**: ${item.importance} (${item.sourcePlatform || 'dual'} origin)`,
296
+ ''
297
+ ].join('\n');
298
+ }
299
+
300
+ function buildAntigravitySkillMarkdown(item) {
301
+ const slug = toKebabSlug(item.slug);
302
+ const desc = sanitizeSkillDescription(
303
+ rewriteAntigravityReferences(item.description || item.when_condition),
304
+ slug
305
+ );
306
+ const steps = Array.isArray(item.steps) && item.steps.length > 0
307
+ ? item.steps.map((s, idx) => `${idx + 1}. ${rewriteAntigravityReferences(s.replace(/^\d+\.\s*/, ''))}`)
308
+ : [`1. ${rewriteAntigravityReferences(item.then_guidance)}`];
309
+
310
+ return [
311
+ '---',
312
+ `name: rsl-${slug}`,
313
+ `description: "${desc.replace(/"/g, '\\"')}"`,
314
+ '---',
315
+ '',
316
+ `# RSL Workflow: ${slug}`,
317
+ '',
318
+ '## When to Apply',
319
+ rewriteAntigravityReferences(item.when_condition || desc),
320
+ '',
321
+ '## Verified Steps',
322
+ ...steps,
323
+ '',
324
+ '## Validation',
325
+ 'Verify the targeted command or test suite passes with zero skipped assertions.',
326
+ ''
327
+ ].join('\n');
328
+ }
329
+
330
+ function buildClaudeSkillMarkdown(item) {
331
+ const slug = toKebabSlug(item.slug);
332
+ const desc = sanitizeSkillDescription(
333
+ rewriteClaudeReferences(item.description || item.when_condition),
334
+ slug
335
+ );
336
+ const steps = Array.isArray(item.steps) && item.steps.length > 0
337
+ ? item.steps.map((s, idx) => `${idx + 1}. ${rewriteClaudeReferences(s.replace(/^\d+\.\s*/, ''))}`)
338
+ : [`1. ${rewriteClaudeReferences(item.then_guidance)}`];
339
+
340
+ return [
341
+ '---',
342
+ `name: rsl-${slug}`,
343
+ `description: "${desc.replace(/"/g, '\\"')}"`,
344
+ 'argument-hint: "[target]"',
345
+ 'allowed-tools: Read Bash',
346
+ '---',
347
+ '',
348
+ `# RSL Workflow: ${slug}`,
349
+ '',
350
+ '## When to Apply',
351
+ rewriteClaudeReferences(item.when_condition || desc),
352
+ '',
353
+ '## Verified Steps',
354
+ ...steps,
355
+ '',
356
+ '## Validation',
357
+ 'Verify the targeted command or test suite passes cleanly.',
358
+ ''
359
+ ].join('\n');
360
+ }
361
+
362
+ function removeDualCarrierFiles(workspaceRoot, slug) {
363
+ const safeSlug = toKebabSlug(slug);
364
+ const targets = [
365
+ path.join(workspaceRoot, '.agents', 'rules', `rsl-${safeSlug}.md`),
366
+ path.join(workspaceRoot, '.claude', 'rules', `rsl-${safeSlug}.md`)
367
+ ];
368
+ for (const file of targets) {
369
+ try {
370
+ if (fs.existsSync(file)) fs.rmSync(file, { force: true });
371
+ } catch {
372
+ // Non-fatal
373
+ }
374
+ }
375
+ const skillDirs = [
376
+ path.join(workspaceRoot, '.agents', 'skills', `rsl-${safeSlug}`),
377
+ path.join(workspaceRoot, '.claude', 'skills', `rsl-${safeSlug}`)
378
+ ];
379
+ for (const dir of skillDirs) {
380
+ try {
381
+ if (fs.existsSync(dir)) fs.rmSync(dir, { recursive: true, force: true });
382
+ } catch {
383
+ // Non-fatal
384
+ }
385
+ }
386
+ }
387
+
388
+ /**
389
+ * Synchronizes promoted Carrier C (`PreToolUse`) deterministic deny guards into
390
+ * both `<workspaceRoot>/.agents/hooks.json` and `<workspaceRoot>/.claude/settings.json`
391
+ * (never setting `disableAllHooks: true`).
392
+ *
393
+ * @param {string} workspaceRoot
394
+ * @param {object} ledger
395
+ * @param {object} [options={}]
396
+ */
397
+ export function syncPromotedDualHooks(workspaceRoot, ledger, options = {}) {
398
+ const baseRoot = path.resolve(workspaceRoot);
399
+ const pkgRoot = String(options.pkgRoot || RSL_PKG_ROOT).replace(/\\/g, '/').replace(/\/+$/, '');
400
+ const promoted = Object.values(ledger?.items || {}).filter(
401
+ (it) =>
402
+ it &&
403
+ it.status === 'active' &&
404
+ (it.promotedHook === true ||
405
+ it.carrier === 'pre_tool_hook' ||
406
+ Number(it.importance || 0) >= RSL_CONSTANTS.PROMOTE_HOOK_IMPORTANCE ||
407
+ Number(it.violationCount || 0) >= RSL_CONSTANTS.REPEAT_VIOLATION_THRESHOLD)
408
+ );
409
+
410
+ // 1. Antigravity `.agents/hooks.json`
411
+ const agHooksPath = path.join(baseRoot, '.agents', 'hooks.json');
412
+ let agDoc = {};
413
+ if (fs.existsSync(agHooksPath)) {
414
+ try {
415
+ const parsed = JSON.parse(fs.readFileSync(agHooksPath, 'utf8'));
416
+ if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
417
+ agDoc = { ...parsed };
418
+ }
419
+ } catch {
420
+ agDoc = {};
421
+ }
422
+ }
423
+
424
+ if (promoted.length > 0) {
425
+ const agMatchers = Array.from(
426
+ new Set(
427
+ promoted
428
+ .flatMap((it) => String(it.toolMatcher || 'run_command|edit_file|write_file').split('|'))
429
+ .map((s) => s.trim())
430
+ .filter(Boolean)
431
+ )
432
+ );
433
+ const agDir = path.dirname(agHooksPath);
434
+ const agHookAbs = `${pkgRoot}/src/hooks/antigravity_rsl_hook.mjs`;
435
+ const relAg = path.relative(agDir, agHookAbs).replace(/\\/g, '/');
436
+ const agScriptPath =
437
+ relAg && !relAg.startsWith('..') && !path.isAbsolute(relAg) ? relAg : agHookAbs;
438
+ const safeAgScript = /\s/.test(agScriptPath) ? `"${agScriptPath}"` : agScriptPath;
439
+ agDoc['ctxtop-rsl-guards'] = {
440
+ enabled: true,
441
+ PreToolUse: [
442
+ {
443
+ matcher: agMatchers.join('|') || '*',
444
+ hooks: [
445
+ {
446
+ type: 'command',
447
+ command: `node ${safeAgScript} --event=PreToolUse`,
448
+ timeout: 5
449
+ }
450
+ ]
451
+ }
452
+ ]
453
+ };
454
+ fs.mkdirSync(path.dirname(agHooksPath), { recursive: true });
455
+ atomicWriteFileSync(agHooksPath, `${JSON.stringify(agDoc, null, 2)}\n`);
456
+ } else if ('ctxtop-rsl-guards' in agDoc) {
457
+ delete agDoc['ctxtop-rsl-guards'];
458
+ if (fs.existsSync(agHooksPath)) {
459
+ atomicWriteFileSync(agHooksPath, `${JSON.stringify(agDoc, null, 2)}\n`);
460
+ }
461
+ }
462
+
463
+ // 2. Claude Code `.claude/settings.json` (never sets disableAllHooks: true)
464
+ const ccSettingsPath = path.join(baseRoot, '.claude', 'settings.json');
465
+ let ccDoc = {};
466
+ if (fs.existsSync(ccSettingsPath)) {
467
+ try {
468
+ const parsed = JSON.parse(fs.readFileSync(ccSettingsPath, 'utf8'));
469
+ if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
470
+ ccDoc = { ...parsed };
471
+ }
472
+ } catch {
473
+ ccDoc = {};
474
+ }
475
+ }
476
+
477
+ if (promoted.length > 0) {
478
+ const ccMatchers = Array.from(
479
+ new Set(
480
+ promoted
481
+ .flatMap((it) => String(it.claudeToolMatcher || 'Bash|PowerShell|Edit|MultiEdit|Write').split('|'))
482
+ .map((s) => s.trim())
483
+ .filter(Boolean)
484
+ )
485
+ );
486
+ const prevHooks = ccDoc.hooks && typeof ccDoc.hooks === 'object' && !Array.isArray(ccDoc.hooks)
487
+ ? { ...ccDoc.hooks }
488
+ : {};
489
+ const existingPre = Array.isArray(prevHooks.PreToolUse) ? prevHooks.PreToolUse : [];
490
+ const filteredPre = existingPre.filter((entry) => {
491
+ const cmds = [
492
+ entry?.command,
493
+ ...(Array.isArray(entry?.hooks) ? entry.hooks.map((h) => h?.command) : [])
494
+ ].map((c) => String(c || ''));
495
+ return !cmds.some((c) => CLAUDE_RSL_HOOK_RE.test(c) && c.includes('--event=PreToolUse'));
496
+ });
497
+
498
+ const ccHookAbs = `${pkgRoot}/src/hooks/claude_rsl_hook.mjs`;
499
+ const safeCcScript = /\s/.test(ccHookAbs) ? `"${ccHookAbs}"` : ccHookAbs;
500
+ filteredPre.push({
501
+ matcher: ccMatchers.join('|') || 'Bash|PowerShell|Edit|MultiEdit|Write',
502
+ hooks: [
503
+ {
504
+ type: 'command',
505
+ command: `node ${safeCcScript} --event=PreToolUse`
506
+ }
507
+ ]
508
+ });
509
+
510
+ ccDoc.hooks = {
511
+ ...prevHooks,
512
+ PreToolUse: filteredPre
513
+ };
514
+ if (ccDoc.disableAllHooks === true) {
515
+ delete ccDoc.disableAllHooks;
516
+ }
517
+ fs.mkdirSync(path.dirname(ccSettingsPath), { recursive: true });
518
+ atomicWriteFileSync(ccSettingsPath, `${JSON.stringify(ccDoc, null, 2)}\n`);
519
+ } else if (ccDoc.hooks && Array.isArray(ccDoc.hooks.PreToolUse)) {
520
+ const filteredPre = ccDoc.hooks.PreToolUse.filter((entry) => {
521
+ const cmds = [
522
+ entry?.command,
523
+ ...(Array.isArray(entry?.hooks) ? entry.hooks.map((h) => h?.command) : [])
524
+ ].map((c) => String(c || ''));
525
+ return !cmds.some((c) => CLAUDE_RSL_HOOK_RE.test(c) && c.includes('--event=PreToolUse'));
526
+ });
527
+ if (filteredPre.length !== ccDoc.hooks.PreToolUse.length) {
528
+ if (filteredPre.length > 0) ccDoc.hooks.PreToolUse = filteredPre;
529
+ else delete ccDoc.hooks.PreToolUse;
530
+ atomicWriteFileSync(ccSettingsPath, `${JSON.stringify(ccDoc, null, 2)}\n`);
531
+ }
532
+ }
533
+
534
+ return {
535
+ promotedCount: promoted.length,
536
+ agHooksPath,
537
+ ccSettingsPath
538
+ };
539
+ }
540
+
541
+ /**
542
+ * Compiles a single active heuristic simultaneously into `.agents/` and `.claude/`.
543
+ *
544
+ * @param {string} workspaceRoot
545
+ * @param {object} item
546
+ * @param {object} [options={}]
547
+ */
548
+ export function compileHeuristicDualTargets(workspaceRoot, item, options = {}) {
549
+ const baseRoot = path.resolve(workspaceRoot);
550
+ const slug = toKebabSlug(item.slug);
551
+ const written = [];
552
+
553
+ if (item.carrier === 'skill_workflow') {
554
+ const agSkillPath = path.join(baseRoot, '.agents', 'skills', `rsl-${slug}`, 'SKILL.md');
555
+ const ccSkillPath = path.join(baseRoot, '.claude', 'skills', `rsl-${slug}`, 'SKILL.md');
556
+ fs.mkdirSync(path.dirname(agSkillPath), { recursive: true });
557
+ fs.mkdirSync(path.dirname(ccSkillPath), { recursive: true });
558
+ atomicWriteFileSync(agSkillPath, buildAntigravitySkillMarkdown(item));
559
+ atomicWriteFileSync(ccSkillPath, buildClaudeSkillMarkdown(item));
560
+ written.push(agSkillPath, ccSkillPath);
561
+ } else {
562
+ const agRuleContent = buildAntigravityRuleMarkdown(item);
563
+ const ccRuleContent = buildClaudeRuleMarkdown(item);
564
+ const agRulePath = path.join(baseRoot, '.agents', 'rules', `rsl-${slug}.md`);
565
+ const ccRulePath = path.join(baseRoot, '.claude', 'rules', `rsl-${slug}.md`);
566
+
567
+ const budget = measureWorkspaceRuleBudget(baseRoot);
568
+ const existingBytes = fs.existsSync(agRulePath) ? fs.statSync(agRulePath).size : 0;
569
+ const projectedTokens = budget.totalTokens - Math.ceil(existingBytes / 4) + Math.ceil(Buffer.byteLength(agRuleContent, 'utf8') / 4);
570
+
571
+ if (projectedTokens <= RSL_CONSTANTS.AGGREGATE_RULE_TOKEN_BUDGET || options.force === true) {
572
+ fs.mkdirSync(path.dirname(agRulePath), { recursive: true });
573
+ fs.mkdirSync(path.dirname(ccRulePath), { recursive: true });
574
+ atomicWriteFileSync(agRulePath, agRuleContent);
575
+ atomicWriteFileSync(ccRulePath, ccRuleContent);
576
+ written.push(agRulePath, ccRulePath);
577
+ }
578
+ }
579
+
580
+ return { slug, written };
581
+ }
582
+
583
+ function globMatchesFile(globPattern = '', filePath = '') {
584
+ const posixFile = String(filePath || '').replace(/\\/g, '/').toLowerCase();
585
+ if (!posixFile) return false;
586
+ const parts = String(globPattern || '')
587
+ .split(',')
588
+ .map((p) => p.trim().toLowerCase())
589
+ .filter(Boolean);
590
+ for (const pat of parts) {
591
+ if (pat.startsWith('*.') && posixFile.endsWith(pat.slice(1))) return true;
592
+ if (pat.endsWith('/**') && posixFile.startsWith(pat.slice(0, -3))) return true;
593
+ if (posixFile === pat || posixFile.endsWith(`/${pat}`)) return true;
594
+ }
595
+ return false;
596
+ }
597
+
598
+ /**
599
+ * Applies ExpeL `+1` clean reuse / `-1` repeat error feedback to existing active heuristics,
600
+ * ingests newly distilled heuristics at `importance: 2`, prunes `<= 0` items from both
601
+ * `.agents/` and `.claude/`, and promotes `>= 5` (or `>= 2` repeat violations) to hooks.
602
+ *
603
+ * @param {string} workspaceRoot
604
+ * @param {object} distilledReport
605
+ * @param {object} [sessionContext={}]
606
+ * @param {object} [options={}]
607
+ */
608
+ export function ingestDistilledHeuristics(workspaceRoot, distilledReport = {}, sessionContext = {}, options = {}) {
609
+ const baseRoot = path.resolve(workspaceRoot || process.cwd());
610
+ const ledger = readRslLedger(baseRoot);
611
+ ledger.stats.lastSessionId = sessionContext.sessionId || ledger.stats.lastSessionId;
612
+ ledger.stats.lastPlatform = sessionContext.platform || ledger.stats.lastPlatform;
613
+
614
+ if (sessionContext.tainted || sessionContext.status === 'TAINTED_REWARD_HACK') {
615
+ ledger.stats.taintedSessions += 1;
616
+ writeRslLedger(baseRoot, ledger);
617
+ return {
618
+ ok: false,
619
+ tainted: true,
620
+ upvoted: [],
621
+ downvoted: [],
622
+ pruned: [],
623
+ promoted: [],
624
+ added: [],
625
+ quarantined: []
626
+ };
627
+ }
628
+
629
+ const upvoted = [];
630
+ const downvoted = [];
631
+ const pruned = [];
632
+ const promoted = [];
633
+ const added = [];
634
+ const quarantined = [];
635
+
636
+ const touchedFiles = Array.isArray(sessionContext.touchedFiles) ? sessionContext.touchedFiles : [];
637
+ const unresolvedErrors = Array.isArray(sessionContext.unresolvedErrors) ? sessionContext.unresolvedErrors : [];
638
+ const pairs = Array.isArray(sessionContext.contrastivePairs) ? sessionContext.contrastivePairs : [];
639
+ const sessionErrorsText = [
640
+ ...unresolvedErrors.map((e) => `${e.toolName || ''}:${e.errorText || ''}`),
641
+ ...pairs.map((p) => `${p.toolName || ''}:${p.errorText || ''}`)
642
+ ]
643
+ .join('\n')
644
+ .toLowerCase();
645
+
646
+ // 1. ExpeL feedback on existing active heuristics
647
+ for (const item of Object.values(ledger.items)) {
648
+ if (!item || item.status !== 'active') continue;
649
+ const sig = String(item.errorSignature || '').toLowerCase();
650
+ const sigErrPart = sig.includes(':') ? sig.split(':').slice(1).join(':').trim() : sig;
651
+ const matchedError = Boolean(sigErrPart && sigErrPart.length >= 6 && sessionErrorsText.includes(sigErrPart.slice(0, 32)));
652
+
653
+ if (matchedError) {
654
+ item.importance = Math.max(0, Number(item.importance || 0) - 1);
655
+ item.violationCount = Number(item.violationCount || 0) + 1;
656
+ item.updatedAt = new Date().toISOString();
657
+ downvoted.push(item.slug);
658
+ if (item.importance <= 0) {
659
+ item.status = 'pruned';
660
+ item.promotedHook = false;
661
+ ledger.stats.prunedCount += 1;
662
+ removeDualCarrierFiles(baseRoot, item.slug);
663
+ pruned.push(item.slug);
664
+ } else {
665
+ if (item.violationCount >= RSL_CONSTANTS.REPEAT_VIOLATION_THRESHOLD) {
666
+ item.promotedHook = true;
667
+ promoted.push(item.slug);
668
+ }
669
+ compileHeuristicDualTargets(baseRoot, item, options);
670
+ }
671
+ continue;
672
+ }
673
+
674
+ const touchedMatchingFile = touchedFiles.some((f) => globMatchesFile(item.globs, f));
675
+ if (touchedMatchingFile && sessionContext.terminationReason !== 'ERROR') {
676
+ item.importance = Number(item.importance || RSL_CONSTANTS.INITIAL_IMPORTANCE) + 1;
677
+ item.cleanUses = Number(item.cleanUses || 0) + 1;
678
+ item.updatedAt = new Date().toISOString();
679
+ upvoted.push(item.slug);
680
+ if (item.importance >= RSL_CONSTANTS.PROMOTE_HOOK_IMPORTANCE && !item.promotedHook) {
681
+ item.promotedHook = true;
682
+ promoted.push(item.slug);
683
+ }
684
+ compileHeuristicDualTargets(baseRoot, item, options);
685
+ }
686
+ }
687
+
688
+ // 2. Ingest newly distilled heuristics (initialized at importance: 2, or staged as candidate for 1-turn user corrections)
689
+ const incoming = Array.isArray(distilledReport?.heuristics) ? distilledReport.heuristics : [];
690
+ const stagedCandidates = [];
691
+ for (const h of incoming) {
692
+ const slug = toKebabSlug(h.slug);
693
+ if (!slug) continue;
694
+ const existing = ledger.items[slug];
695
+ if (existing && existing.status === 'active') {
696
+ // Do not duplicate; reinforce if same pattern surfaced again cleanly or already handled above
697
+ continue;
698
+ }
699
+
700
+ if (existing && existing.status === 'candidate') {
701
+ const sameSession = Boolean(
702
+ existing.lastSessionId &&
703
+ sessionContext.sessionId &&
704
+ existing.lastSessionId === sessionContext.sessionId
705
+ );
706
+ if (!sameSession) {
707
+ existing.confirmations = Number(existing.confirmations || 1) + 1;
708
+ existing.lastSessionId = sessionContext.sessionId || existing.lastSessionId || null;
709
+ existing.updatedAt = new Date().toISOString();
710
+ }
711
+ if (existing.confirmations >= 2 || options.promoteCandidatesImmediately === true) {
712
+ const clashReport = existing.carrier !== 'skill_workflow'
713
+ ? auditWorkspaceRuleClashes(baseRoot, existing)
714
+ : { candidateClashes: [] };
715
+ if (clashReport.candidateClashes.length > 0 && options.allowClashingRules !== true) {
716
+ existing.status = 'quarantined_conflict';
717
+ existing.promotedHook = false;
718
+ existing.quarantinedConflict = clashReport.candidateClashes[0];
719
+ quarantined.push(slug);
720
+ continue;
721
+ }
722
+ existing.status = 'active';
723
+ existing.importance = Math.max(RSL_CONSTANTS.INITIAL_IMPORTANCE, Number(existing.importance || 0));
724
+ compileHeuristicDualTargets(baseRoot, existing, options);
725
+ added.push(slug);
726
+ } else {
727
+ stagedCandidates.push(slug);
728
+ }
729
+ continue;
730
+ }
731
+
732
+ const stageOnly = h.initialStatus === 'candidate' && options.promoteCandidatesImmediately !== true;
733
+ const item = {
734
+ slug,
735
+ carrier: h.carrier || 'rule_model_decision',
736
+ importance: RSL_CONSTANTS.INITIAL_IMPORTANCE,
737
+ status: stageOnly ? 'candidate' : 'active',
738
+ confirmations: 1,
739
+ lastSessionId: sessionContext.sessionId || null,
740
+ promotedHook: stageOnly ? false : h.carrier === 'pre_tool_hook',
741
+ violationCount: stageOnly ? 0 : (h.carrier === 'pre_tool_hook' ? RSL_CONSTANTS.REPEAT_VIOLATION_THRESHOLD : 0),
742
+ cleanUses: 0,
743
+ sourcePlatform: sessionContext.platform || 'antigravity',
744
+ description: h.description || '',
745
+ globs: h.globs || '',
746
+ paths: Array.isArray(h.paths) ? h.paths : [],
747
+ when_condition: h.when_condition || '',
748
+ then_guidance: h.then_guidance || '',
749
+ steps: Array.isArray(h.steps) ? h.steps : [],
750
+ errorSignature: h.errorSignature || '',
751
+ toolMatcher: h.toolMatcher || 'run_command|edit_file|write_file',
752
+ claudeToolMatcher: h.claudeToolMatcher || 'Bash|PowerShell|Edit|MultiEdit|Write',
753
+ denyPattern: h.denyPattern || '',
754
+ evidence_step_ids: Array.isArray(h.evidence_step_ids) ? h.evidence_step_ids : [],
755
+ createdAt: new Date().toISOString(),
756
+ updatedAt: new Date().toISOString()
757
+ };
758
+
759
+ if (stageOnly) {
760
+ ledger.items[slug] = item;
761
+ stagedCandidates.push(slug);
762
+ continue;
763
+ }
764
+
765
+ const isRuleCandidate = item.carrier !== 'skill_workflow';
766
+ const clashReport = isRuleCandidate
767
+ ? auditWorkspaceRuleClashes(baseRoot, item)
768
+ : { candidateClashes: [] };
769
+ if (clashReport.candidateClashes.length > 0 && options.allowClashingRules !== true) {
770
+ item.status = 'quarantined_conflict';
771
+ item.promotedHook = false;
772
+ item.quarantinedConflict = clashReport.candidateClashes[0];
773
+ ledger.items[slug] = item;
774
+ quarantined.push(slug);
775
+ continue;
776
+ }
777
+
778
+ ledger.items[slug] = item;
779
+ compileHeuristicDualTargets(baseRoot, item, options);
780
+ added.push(slug);
781
+ if (item.promotedHook) promoted.push(slug);
782
+ }
783
+
784
+ syncPromotedDualHooks(baseRoot, ledger, options);
785
+ writeRslLedger(baseRoot, ledger);
786
+
787
+ return {
788
+ ok: true,
789
+ tainted: false,
790
+ upvoted,
791
+ downvoted,
792
+ pruned,
793
+ promoted: Array.from(new Set(promoted)),
794
+ added,
795
+ candidates: stagedCandidates,
796
+ quarantined
797
+ };
798
+ }
799
+
800
+ /**
801
+ * Promotes a heuristic slug to `importance >= 5` and compiles dual-platform `PreToolUse` hooks.
802
+ * @param {string} workspaceRoot
803
+ * @param {string} slug
804
+ * @param {object} [options={}]
805
+ */
806
+ export function promoteHeuristic(workspaceRoot, slug, options = {}) {
807
+ const baseRoot = path.resolve(workspaceRoot || process.cwd());
808
+ const safeSlug = toKebabSlug(slug);
809
+ const ledger = readRslLedger(baseRoot);
810
+ const item = ledger.items[safeSlug];
811
+ if (!item) {
812
+ return { ok: false, error: `Heuristic "${safeSlug}" not found in RSL ledger` };
813
+ }
814
+ item.status = 'active';
815
+ item.importance = Math.max(RSL_CONSTANTS.PROMOTE_HOOK_IMPORTANCE, Number(item.importance || 0));
816
+ item.promotedHook = true;
817
+ item.updatedAt = new Date().toISOString();
818
+ compileHeuristicDualTargets(baseRoot, item, options);
819
+ const hooks = syncPromotedDualHooks(baseRoot, ledger, options);
820
+ writeRslLedger(baseRoot, ledger);
821
+ return { ok: true, slug: safeSlug, item, hooks };
822
+ }
823
+
824
+ /**
825
+ * Prunes a heuristic slug (`importance = 0`, deletes files from both `.agents/` and `.claude/`).
826
+ * @param {string} workspaceRoot
827
+ * @param {string} slug
828
+ * @param {object} [options={}]
829
+ */
830
+ export function pruneHeuristic(workspaceRoot, slug, options = {}) {
831
+ const baseRoot = path.resolve(workspaceRoot || process.cwd());
832
+ const safeSlug = toKebabSlug(slug);
833
+ const ledger = readRslLedger(baseRoot);
834
+ const item = ledger.items[safeSlug];
835
+ if (!item) {
836
+ removeDualCarrierFiles(baseRoot, safeSlug);
837
+ return { ok: false, error: `Heuristic "${safeSlug}" not found in RSL ledger` };
838
+ }
839
+ if (item.status !== 'pruned') {
840
+ ledger.stats.prunedCount += 1;
841
+ }
842
+ item.status = 'pruned';
843
+ item.importance = 0;
844
+ item.promotedHook = false;
845
+ item.updatedAt = new Date().toISOString();
846
+ removeDualCarrierFiles(baseRoot, safeSlug);
847
+ const hooks = syncPromotedDualHooks(baseRoot, ledger, options);
848
+ writeRslLedger(baseRoot, ledger);
849
+ return { ok: true, slug: safeSlug, item, hooks };
850
+ }
851
+
852
+ /**
853
+ * Directly adjusts heuristic importance (`+delta` or `-delta`), triggering automatic pruning at `<= 0`
854
+ * or hook promotion at `>= 5` across both Antigravity and Claude Code.
855
+ */
856
+ export function adjustHeuristicImportance(workspaceRoot, slug, delta = 1, options = {}) {
857
+ const baseRoot = path.resolve(workspaceRoot || process.cwd());
858
+ const safeSlug = toKebabSlug(slug);
859
+ const ledger = readRslLedger(baseRoot);
860
+ const item = ledger.items[safeSlug];
861
+ if (!item) return { ok: false, error: `Heuristic "${safeSlug}" not found` };
862
+
863
+ const next = Number(item.importance || 0) + Number(delta || 0);
864
+ if (next <= 0) {
865
+ return pruneHeuristic(baseRoot, safeSlug, options);
866
+ }
867
+ item.status = 'active';
868
+ item.importance = next;
869
+ if (delta < 0) item.violationCount = Number(item.violationCount || 0) + 1;
870
+ else if (delta > 0) item.cleanUses = Number(item.cleanUses || 0) + 1;
871
+ item.updatedAt = new Date().toISOString();
872
+
873
+ if (next >= RSL_CONSTANTS.PROMOTE_HOOK_IMPORTANCE || item.violationCount >= RSL_CONSTANTS.REPEAT_VIOLATION_THRESHOLD) {
874
+ item.promotedHook = true;
875
+ }
876
+ compileHeuristicDualTargets(baseRoot, item, options);
877
+ const hooks = syncPromotedDualHooks(baseRoot, ledger, options);
878
+ writeRslLedger(baseRoot, ledger);
879
+ return { ok: true, slug: safeSlug, item, hooks };
880
+ }
881
+
882
+ /**
883
+ * Fast (<5ms) runtime evaluation of promoted Carrier C `PreToolUse` guards.
884
+ *
885
+ * @param {string} workspaceRoot
886
+ * @param {'antigravity' | 'claude'} platform
887
+ * @param {object} [payload={}]
888
+ */
889
+ export function evaluatePromotedPreToolGuards(workspaceRoot, platform = 'antigravity', payload = {}) {
890
+ const baseRoot = path.resolve(workspaceRoot || process.cwd());
891
+ const ledgerPath = getRslLedgerPath(baseRoot);
892
+ if (!fs.existsSync(ledgerPath)) {
893
+ return { decision: 'allow', matchedSlug: null, reason: null };
894
+ }
895
+
896
+ const ledger = readRslLedger(baseRoot);
897
+ const promoted = Object.values(ledger.items || {}).filter(
898
+ (it) =>
899
+ it &&
900
+ it.status === 'active' &&
901
+ Boolean(it.denyPattern) &&
902
+ (it.promotedHook === true ||
903
+ it.carrier === 'pre_tool_hook' ||
904
+ Number(it.importance || 0) >= RSL_CONSTANTS.PROMOTE_HOOK_IMPORTANCE)
905
+ );
906
+ if (promoted.length === 0) {
907
+ return { decision: 'allow', matchedSlug: null, reason: null };
908
+ }
909
+
910
+ const toolName = String(payload.toolCall?.name || payload.tool_name || payload.toolName || '');
911
+ const args = payload.toolCall?.args || payload.tool_input || payload.toolInput || {};
912
+ const haystack = [
913
+ args.CommandLine,
914
+ args.command,
915
+ args.cmd,
916
+ args.script,
917
+ args.file_path,
918
+ args.TargetFile,
919
+ args.Path,
920
+ args.path,
921
+ args.content,
922
+ args.Replacement
923
+ ]
924
+ .filter((v) => typeof v === 'string' && v.length > 0)
925
+ .join('\n')
926
+ .toLowerCase();
927
+
928
+ if (!haystack) {
929
+ return { decision: 'allow', matchedSlug: null, reason: null };
930
+ }
931
+
932
+ for (const item of promoted) {
933
+ const matcherStr = platform === 'claude' ? item.claudeToolMatcher : item.toolMatcher;
934
+ if (matcherStr && toolName) {
935
+ try {
936
+ const re = new RegExp(`^(?:${matcherStr})$`, 'i');
937
+ if (!re.test(toolName)) continue;
938
+ } catch {
939
+ // Ignore malformed matcher
940
+ }
941
+ }
942
+ const needle = String(item.denyPattern || '').trim().toLowerCase();
943
+ if (needle && haystack.includes(needle)) {
944
+ return {
945
+ decision: 'deny',
946
+ matchedSlug: item.slug,
947
+ reason: `[Highbeam RSL Guard: rsl-${item.slug}] Blocked repeated pattern "${item.denyPattern}". ${item.then_guidance || ''}`.trim()
948
+ };
949
+ }
950
+ }
951
+
952
+ return { decision: 'allow', matchedSlug: null, reason: null };
953
+ }
954
+
955
+ /**
956
+ * Returns consolidated dual-platform RSL summary for CLI, Daemon, WebView, and StatusLine.
957
+ *
958
+ * @param {string} [workspaceRoot=process.cwd()]
959
+ * @param {object} [options={}]
960
+ */
961
+ export function getRslSummary(workspaceRoot = process.cwd(), options = {}) {
962
+ const baseRoot = path.resolve(workspaceRoot || process.cwd());
963
+ const ledger = readRslLedger(baseRoot);
964
+ const allItems = Object.values(ledger.items || {});
965
+ const activeItems = allItems.filter((it) => it && it.status === 'active');
966
+ const candidateItems = allItems.filter((it) => it && it.status === 'candidate');
967
+ const activeRules = activeItems.filter((it) => it.carrier !== 'skill_workflow').length;
968
+ const candidateRules = candidateItems.filter((it) => it.carrier !== 'skill_workflow').length;
969
+ const activeSkills = activeItems.filter((it) => it.carrier === 'skill_workflow').length;
970
+ const promotedHooks = activeItems.filter(
971
+ (it) =>
972
+ it.promotedHook === true ||
973
+ it.carrier === 'pre_tool_hook' ||
974
+ Number(it.importance || 0) >= RSL_CONSTANTS.PROMOTE_HOOK_IMPORTANCE
975
+ ).length;
976
+
977
+ const budget = measureWorkspaceRuleBudget(baseRoot);
978
+ const clashAudit = auditWorkspaceRuleClashes(baseRoot);
979
+ const quarantinedItems = allItems.filter((it) => it && it.status === 'quarantined_conflict');
980
+ const activeClashes = clashAudit.clashes.slice(0, 5);
981
+ const claudeMemoryAudit = auditClaudeAutoMemory({
982
+ cwd: baseRoot,
983
+ homeDir: options.homeDir || os.homedir(),
984
+ memoryDir: options.memoryDir,
985
+ memoryFilePath: options.memoryFilePath
986
+ });
987
+
988
+ const topHeuristics = activeItems
989
+ .slice()
990
+ .sort((a, b) => Number(b.importance || 0) - Number(a.importance || 0))
991
+ .slice(0, 10)
992
+ .map((it) => ({
993
+ slug: it.slug,
994
+ carrier: it.carrier,
995
+ importance: Number(it.importance || 0),
996
+ promotedHook: Boolean(it.promotedHook),
997
+ sourcePlatform: it.sourcePlatform || 'dual',
998
+ globs: it.globs || '',
999
+ description: it.description || ''
1000
+ }));
1001
+
1002
+ return {
1003
+ workspaceRoot: baseRoot,
1004
+ ledgerPath: getRslLedgerPath(baseRoot),
1005
+ activeRules,
1006
+ candidateRules,
1007
+ activeSkills,
1008
+ promotedHooks,
1009
+ totalActive: activeItems.length,
1010
+ clashCount: clashAudit.clashCount + quarantinedItems.length,
1011
+ quarantinedCount: quarantinedItems.length,
1012
+ activeClashes,
1013
+ prunedCount: Number(ledger.stats?.prunedCount || 0),
1014
+ taintedSessions: Number(ledger.stats?.taintedSessions || 0),
1015
+ lastSessionId: ledger.stats?.lastSessionId || null,
1016
+ lastPlatform: ledger.stats?.lastPlatform || null,
1017
+ ruleBudgetTokens: budget.totalTokens,
1018
+ ruleBudgetMaxTokens: budget.budgetTokens,
1019
+ ruleBudgetPct: budget.pct,
1020
+ claudeMemoryAudit,
1021
+ topHeuristics,
1022
+ uiRules: activeItems
1023
+ .slice()
1024
+ .sort((a, b) => Number(b.importance || 0) - Number(a.importance || 0))
1025
+ .slice(0, 12)
1026
+ .map((it) => humanizeLearnedRule(it)),
1027
+ items: options.includeAll ? allItems : activeItems
1028
+ };
1029
+ }