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,412 @@
1
+ /**
2
+ * @file src/core-isomorphic/catalog/safeguardGuide.mjs
3
+ * Plain-English (grade 10-11) guidance for every Highbeam safeguard and learned rule.
4
+ *
5
+ * Every safeguard is either:
6
+ * - "action" -> something the developer should look at or do (what happened + what to do + what to avoid)
7
+ * - "info" -> handled automatically; no action needed
8
+ *
9
+ * Pure JS / ESM with strictly 0 node:* imports (isomorphic: daemon, CLI, and webview-safe).
10
+ */
11
+
12
+ /** Returns the last path segment of a Windows or POSIX path (never truncates mid-word). */
13
+ export function safeBaseName(p) {
14
+ const s = String(p || '').trim();
15
+ if (!s) return '';
16
+ const parts = s.split(/[\\/]+/).filter(Boolean);
17
+ return parts.length ? parts[parts.length - 1] : s;
18
+ }
19
+
20
+ /** Strips emoji / pictographs and collapses whitespace so mono-tag rows stay clean. */
21
+ export function stripEmoji(text) {
22
+ return String(text || '')
23
+ .replace(/[\u{1F000}-\u{1FAFF}\u{2600}-\u{27BF}\u{FE0F}\u{200D}]/gu, '')
24
+ .replace(/\s+/g, ' ')
25
+ .trim();
26
+ }
27
+
28
+ const g = (title, kind, issue, doText, avoidText) =>
29
+ Object.freeze({ title, kind, issue, doText, avoidText });
30
+
31
+ /**
32
+ * Guide for the canonical DET-01..DET-32 catalog (what the guard watches).
33
+ * `{file}` is replaced with a clean file name when one is known.
34
+ */
35
+ export const SAFEGUARD_GUIDE = Object.freeze({
36
+ 'DET-01': g(
37
+ 'Unsafe Git or shell command blocked', 'action',
38
+ 'The AI tried to run a command that can destroy work, such as git reset --hard, push --force, --no-verify, or rm -rf.',
39
+ 'Read the command in chat. Run it yourself only if you really want to overwrite work.',
40
+ 'Avoid letting the AI force-push or bypass Git hooks without checking first.'
41
+ ),
42
+ 'DET-02': g(
43
+ 'Secret or .env file protected', 'action',
44
+ 'Highbeam stopped a read or paste of credentials (.env files, SSH keys, API tokens) so secrets stay out of the chat.',
45
+ 'Use a placeholder or .env.example instead. If a real key was pasted into chat, replace that key.',
46
+ 'Avoid pasting real keys or tokens into the chat.'
47
+ ),
48
+ 'DET-03': g(
49
+ 'Lockfile or migration changed', 'action',
50
+ '{file} is a package lockfile or database migration, and it changed.',
51
+ 'Check that you meant to update dependencies or the database. If not, undo it with git checkout -- "{file}".',
52
+ 'Avoid committing lockfile or migration changes you did not ask for.'
53
+ ),
54
+ 'DET-04': g(
55
+ 'Same command failed 3 times', 'action',
56
+ 'The AI ran the same failing command three times in a row without changing its approach.',
57
+ 'Read the first error message and point the AI at the real cause, or switch to a stronger model.',
58
+ 'Avoid letting the AI keep retrying the same command.'
59
+ ),
60
+ 'DET-05': g(
61
+ 'Big deletion, weaker tests, or edit loop', 'action',
62
+ 'The AI deleted a large part of {file}, removed test checks, or kept flipping between two versions.',
63
+ 'Run git diff -- "{file}" and make sure no real code or test checks were removed just to make tests pass.',
64
+ 'Avoid accepting more edits until you know what was removed.'
65
+ ),
66
+ 'DET-06': g(
67
+ 'File read again or edited before reading', 'action',
68
+ 'The AI re-read {file} when nothing changed, or edited a file it had not read first.',
69
+ 'Ask the AI to read the file in small line ranges (StartLine and EndLine) before it edits.',
70
+ 'Avoid letting the AI edit files it has not read.'
71
+ ),
72
+ 'DET-07': g(
73
+ 'Long command output trimmed', 'info',
74
+ 'A very long terminal log was shortened to its errors and summary. The full log is saved on disk.',
75
+ 'No action needed.',
76
+ 'Nothing to avoid.'
77
+ ),
78
+ 'DET-08': g(
79
+ 'Model switch held while cache is warm', 'info',
80
+ 'Switching models now would cost more because your prompt cache is still discounted. Highbeam waits for the cache to cool.',
81
+ 'No action needed.',
82
+ 'Nothing to avoid.'
83
+ ),
84
+ 'DET-09': g(
85
+ 'Rule file change queued', 'info',
86
+ 'A non-urgent edit to AGENTS.md, CLAUDE.md, or .mcp.json is waiting so it does not erase your cache discount.',
87
+ 'No action needed. It will be applied after the cache timer ends or after /compact.',
88
+ 'Nothing to avoid.'
89
+ ),
90
+ 'DET-10': g(
91
+ 'Idle cache timer check', 'info',
92
+ 'Highbeam saves a short progress summary before your 5-minute prompt cache runs out while you are idle.',
93
+ 'No action needed.',
94
+ 'Nothing to avoid.'
95
+ ),
96
+ 'DET-11': g(
97
+ 'Old file copies or a missing file path', 'action',
98
+ 'Old copies of edited files are filling memory, or the AI mentioned a file that does not exist.',
99
+ 'Check that the file path is real, or run /compact to clear old copies.',
100
+ 'Avoid trusting file names the AI mentions without checking them.'
101
+ ),
102
+ 'DET-12': g(
103
+ 'Near a pricing jump or stuck background process', 'action',
104
+ 'Context is close to 98,000 tokens, where pricing jumps on this model, or a background process is still running.',
105
+ 'Run /compact before your next message, and stop any background process you do not need.',
106
+ 'Avoid sending large new files into chat right now.'
107
+ ),
108
+ 'DET-13': g(
109
+ 'Unused tools load at the start of every chat', 'action',
110
+ 'Connected MCP servers add large tool lists to every turn, even when you do not use them.',
111
+ 'Set unused MCP servers to load only when needed, or turn them off for this project.',
112
+ 'Avoid keeping MCP servers on that you do not use.'
113
+ ),
114
+ 'DET-14': g(
115
+ 'Code changed without running tests', 'action',
116
+ 'Source files were edited, but the tests have not been run to check the change.',
117
+ 'Ask the AI to run your test command before it finishes or you commit.',
118
+ 'Avoid committing changes that have not been tested.'
119
+ ),
120
+ 'DET-15': g(
121
+ 'Unfinished TODO left in code', 'action',
122
+ 'The AI left TODO notes or placeholder code in {file}.',
123
+ 'Open {file} and ask the AI to finish any unfinished parts.',
124
+ 'Avoid committing placeholder code.'
125
+ ),
126
+ 'DET-16': g(
127
+ 'Helper agents limited to save quota', 'info',
128
+ 'Highbeam limited how many helper agents run at once because your quota use passed 80%.',
129
+ 'No action needed.',
130
+ 'Nothing to avoid.'
131
+ ),
132
+ 'DET-17': g(
133
+ 'Waiting for edits to finish before suggesting /compact', 'info',
134
+ 'Highbeam is holding back compact suggestions until your current multi-file edit is done.',
135
+ 'No action needed.',
136
+ 'Nothing to avoid.'
137
+ ),
138
+ 'DET-18': g(
139
+ 'Unsafe editor or hook setting blocked', 'action',
140
+ 'An edit to {file} tried to turn on auto-approval or run remote shell commands.',
141
+ 'Open {file} and reject any change you did not ask for.',
142
+ 'Avoid approving changes to settings or hook files you have not read.'
143
+ ),
144
+ 'DET-19': g(
145
+ 'Hidden characters removed from helper text', 'info',
146
+ 'Invisible control characters were removed from outside text before they could steer the AI.',
147
+ 'No action needed.',
148
+ 'Nothing to avoid.'
149
+ ),
150
+ 'DET-20': g(
151
+ 'Two agents editing the same file, or quota full', 'action',
152
+ 'More than one AI agent tried to edit {file} at the same time, or your 5-hour quota is used up.',
153
+ 'Let one agent finish before the next one edits {file}, or give each agent its own files.',
154
+ 'Avoid running parallel agents on the same file.'
155
+ ),
156
+ 'DET-21': Object.freeze({
157
+ title: 'Deprecated alias of the thinking-loop guard', kind: 'info', hidden: true,
158
+ issue: 'Old name for the thinking-loop guard.', doText: 'No action needed.', avoidText: 'Nothing to avoid.'
159
+ }),
160
+ 'DET-22': g(
161
+ 'Repeated back-and-forth edits', 'action',
162
+ 'The AI undid and redid changes in {file} over the last few turns.',
163
+ 'Run git diff -- "{file}" to see what changed, then give the AI one clear goal.',
164
+ 'Avoid giving the AI conflicting instructions for the same file.'
165
+ ),
166
+ 'DET-23': g(
167
+ 'Errors may be hidden in {file}', 'action',
168
+ 'The last edit to {file} added an empty catch block or a linter-ignore comment, or removed error handling. That can hide crashes.',
169
+ 'Run git diff -- "{file}" and check that errors are still logged or handled. If the AI only moved error handling into a helper, you can keep going.',
170
+ 'Avoid approving more changes until you know no error handling was lost.'
171
+ ),
172
+ 'DET-24': g(
173
+ 'Long chat may be less accurate', 'action',
174
+ 'Chats over 30 turns collect old instructions that can make the AI less accurate.',
175
+ 'Save your progress to task.md, then run /compact at your next stopping point.',
176
+ 'Avoid starting a new, unrelated task in this same long chat.'
177
+ ),
178
+ 'DET-25': g(
179
+ 'Progress snapshot saved', 'info',
180
+ 'Your context passed 70,000 tokens, so Highbeam saved a recovery snapshot in the background.',
181
+ 'No action needed.',
182
+ 'Nothing to avoid.'
183
+ ),
184
+ 'DET-26': g(
185
+ 'Prompt asks for many things at once', 'action',
186
+ 'Asking for four or more separate goals in one message raises the chance the AI misses one.',
187
+ 'Split the work into steps, or use /plan so each part is checked off in order.',
188
+ 'Avoid bundling unrelated changes into one prompt.'
189
+ ),
190
+ 'DET-27': g(
191
+ 'Startup rule file is large', 'action',
192
+ 'Your AGENTS.md or CLAUDE.md is over 8,000 tokens, which uses up memory on every turn.',
193
+ 'Move topic-specific rules into on-demand skills (try /evolve) so only core rules load every time.',
194
+ 'Avoid adding long, rarely used rules to the startup file.'
195
+ ),
196
+ 'DET-28': g(
197
+ 'Background agent running a long time', 'action',
198
+ 'A helper agent or tool server has been running unattended for over 5 minutes.',
199
+ 'Check whether it is stuck, and stop it if you no longer need it.',
200
+ 'Avoid leaving unused background processes running.'
201
+ ),
202
+ 'DET-29': g(
203
+ 'Saved learnings applied between turns', 'info',
204
+ 'Highbeam applied pending warnings and learned rules between turns.',
205
+ 'No action needed.',
206
+ 'Nothing to avoid.'
207
+ ),
208
+ 'DET-30': g(
209
+ 'AI is thinking without making progress', 'action',
210
+ 'For two or more turns the AI used thousands of thinking tokens without changing any code.',
211
+ 'Stop and narrow the request. Name the exact file and function to change.',
212
+ 'Avoid sending vague follow-ups like "keep going".'
213
+ ),
214
+ 'DET-31': g(
215
+ 'Merge conflict between parallel branches', 'action',
216
+ 'Parallel agent branches changed overlapping lines, so they will conflict when merged.',
217
+ 'Merge or rebase one branch first, then let the other agent continue.',
218
+ 'Avoid letting two branches edit the same lines.'
219
+ ),
220
+ 'DET-32': g(
221
+ 'AI drifted from your task.md rules', 'action',
222
+ 'Recent edits go against a rule in task.md, or repeat an idea that already failed.',
223
+ 'Compare the AI\'s last step with task.md and remind it of the rule it missed.',
224
+ 'Avoid approving steps that break your written rules.'
225
+ )
226
+ });
227
+
228
+ /**
229
+ * Guide for live CircuitBreakers alerts. Their IDs use the live numbering
230
+ * (e.g. DET-03 here means "test checks removed"), so they are keyed separately.
231
+ */
232
+ export const CIRCUIT_ALERT_GUIDE = Object.freeze({
233
+ 'DET-01': g(
234
+ 'Same command keeps failing', 'action',
235
+ 'The AI ran a failing command several times in a row.',
236
+ 'Read the first error message and point the AI at the real cause, or switch to a stronger model.',
237
+ 'Avoid letting the AI retry the exact same command.'
238
+ ),
239
+ 'DET-02': g(
240
+ 'Edits are going back and forth in {file}', 'action',
241
+ '{file} returned to a version it had a few turns ago.',
242
+ 'Run git diff -- "{file}" and give the AI one clear goal for this file.',
243
+ 'Avoid giving the AI conflicting instructions for the same file.'
244
+ ),
245
+ 'DET-03': g(
246
+ 'Test checks were removed from {file}', 'action',
247
+ 'Some assert or expect lines were deleted from {file}. Tests may pass only because the checks are gone.',
248
+ 'Run git diff -- "{file}" and restore any test checks that were removed.',
249
+ 'Avoid accepting passing tests until you know the checks are still there.'
250
+ ),
251
+ 'DET-18': SAFEGUARD_GUIDE['DET-18'],
252
+ 'DET-20': SAFEGUARD_GUIDE['DET-20'],
253
+ 'DET-21': g(
254
+ 'File edited before it was read', 'action',
255
+ 'The AI changed or created {file} without reading or searching the project first.',
256
+ 'Ask the AI to read {file} (or search the project) before it makes more edits.',
257
+ 'Avoid letting the AI edit files it has not read.'
258
+ ),
259
+ 'DET-22': g(
260
+ 'Large part of {file} was deleted', 'action',
261
+ 'More than half of {file} was removed in one edit, and you did not ask for that.',
262
+ 'Run git diff -- "{file}" to see what was removed, and restore anything needed.',
263
+ 'Avoid approving more edits until you know what was lost.'
264
+ ),
265
+ 'DET-23': SAFEGUARD_GUIDE['DET-23'],
266
+ 'DET-30': SAFEGUARD_GUIDE['DET-30']
267
+ });
268
+
269
+ const fillFile = (text, file) => String(text || '').replace(/\{file\}/g, file || 'this file');
270
+
271
+ /**
272
+ * Builds display-ready guidance for a safeguard.
273
+ * @param {string} id Detector id (e.g. 'DET-23').
274
+ * @param {object} [ctx]
275
+ * @param {string} [ctx.file] Full or partial file path; only the file name is shown.
276
+ * @param {boolean} [ctx.live] true = use live-alert guide (CircuitBreakers numbering).
277
+ */
278
+ export function formatSafeguardGuidance(id, ctx = {}) {
279
+ const key = String(id || '').trim().toUpperCase();
280
+ const guide = (ctx.live ? CIRCUIT_ALERT_GUIDE[key] : null) || SAFEGUARD_GUIDE[key] || null;
281
+ const file = safeBaseName(ctx.file);
282
+ if (!guide) {
283
+ return {
284
+ id: key || 'DET',
285
+ title: 'Highbeam safeguard triggered',
286
+ kind: 'action',
287
+ issue: 'A safeguard flagged the most recent step.',
288
+ doText: 'Review the AI\'s last step before approving more work.',
289
+ avoidText: 'Avoid approving follow-up changes until you have checked it.',
290
+ file
291
+ };
292
+ }
293
+ return {
294
+ id: key,
295
+ title: fillFile(guide.title, file),
296
+ kind: guide.kind,
297
+ issue: fillFile(guide.issue, file),
298
+ doText: fillFile(guide.doText, file),
299
+ avoidText: fillFile(guide.avoidText, file),
300
+ file
301
+ };
302
+ }
303
+
304
+ /** Guidance for a live CircuitBreakers (or daemon) alert object. */
305
+ export function getAlertGuidance(alert = {}) {
306
+ return formatSafeguardGuidance(alert.detectorId || alert.id, { live: true, file: alert.filePath || alert.file });
307
+ }
308
+
309
+ /** Short plain-English summary of every canonical guard (for roster tooltips). */
310
+ export function getGuardSummary(id) {
311
+ const guide = SAFEGUARD_GUIDE[String(id || '').toUpperCase()];
312
+ if (!guide) return null;
313
+ return { title: guide.title.replace(/\{file\}/g, 'a file'), kind: guide.kind, summary: guide.issue.replace(/\{file\}/g, 'a file') };
314
+ }
315
+
316
+ /**
317
+ * Maps live CircuitBreakers alert ids onto canonical catalog ids so the roster marks the right guard as tripped.
318
+ */
319
+ export function canonicalGuardIdForAlert(alert = {}) {
320
+ const id = String(alert.detectorId || alert.id || '').toUpperCase();
321
+ if (id === 'DET-01') return 'DET-04';
322
+ if (id === 'DET-02' || id === 'DET-03') return 'DET-05';
323
+ if (id === 'DET-21') return 'DET-06';
324
+ return id;
325
+ }
326
+
327
+ /**
328
+ * Keeps only breaker alerts that are still fresh: raised after the last /compact (or checkpoint)
329
+ * and no more than `maxUserTurns` user messages ago. Alerts without a turnIndex are kept.
330
+ * When no steps are available, every alert is kept.
331
+ */
332
+ export function filterFreshAlerts(alerts = [], steps = [], { maxUserTurns = 1 } = {}) {
333
+ const list = Array.isArray(alerts) ? alerts : [];
334
+ const stepsArr = Array.isArray(steps) ? steps : [];
335
+ if (stepsArr.length === 0) return [...list];
336
+ let lastCompactIdx = -1;
337
+ const userIdxs = [];
338
+ stepsArr.forEach((st, i) => {
339
+ const idx = Number.isFinite(st?.stepIndex) ? st.stepIndex : i;
340
+ if (st?.type === 'USER_INPUT' || st?.source === 'USER_EXPLICIT') {
341
+ userIdxs.push(idx);
342
+ if (/^\/compact\b/i.test(String(st.content || '').trim())) lastCompactIdx = Math.max(lastCompactIdx, idx);
343
+ }
344
+ if (st?.type === 'CHECKPOINT') lastCompactIdx = Math.max(lastCompactIdx, idx);
345
+ });
346
+ return list.filter((a) => {
347
+ const t = Number(a?.turnIndex);
348
+ if (!Number.isFinite(t)) return true;
349
+ if (t <= lastCompactIdx) return false;
350
+ return userIdxs.filter((u) => u > t).length <= maxUserTurns;
351
+ });
352
+ }
353
+
354
+ // ---------------------------------------------------------------------------
355
+ // Learned rules (RSL) — plain-English summaries
356
+ // ---------------------------------------------------------------------------
357
+
358
+ const clip = (text, max) => {
359
+ const s = String(text || '').replace(/\s+/g, ' ').trim();
360
+ if (s.length <= max) return s;
361
+ const cut = s.slice(0, max);
362
+ const lastSpace = cut.lastIndexOf(' ');
363
+ return `${(lastSpace > max * 0.6 ? cut.slice(0, lastSpace) : cut).replace(/[\s,;:.-]+$/, '')}…`;
364
+ };
365
+
366
+ /**
367
+ * Turns a raw learned-rule ledger item into a short, readable row.
368
+ * @returns {{kind:'hook'|'skill'|'rule', title:string, detail:string, status:string}}
369
+ */
370
+ export function humanizeLearnedRule(item = {}) {
371
+ const carrier = String(item.carrier || '');
372
+ const isHook = item.promotedHook === true || carrier === 'pre_tool_hook';
373
+ const isSkill = carrier === 'skill_workflow';
374
+ const kind = isHook ? 'hook' : (isSkill ? 'skill' : 'rule');
375
+ const desc = String(item.description || '');
376
+ const when = String(item.when_condition || '');
377
+ const then = String(item.then_guidance || '');
378
+ const slug = String(item.slug || '').replace(/-[0-9a-f]{6}$/i, '').replace(/[-_]+/g, ' ').trim();
379
+
380
+ let title = '';
381
+ let detail = '';
382
+
383
+ if (isSkill) {
384
+ const steps = Array.isArray(item.steps) ? item.steps.length : 0;
385
+ const target = (desc.match(/recovery workflow for (.+?)\.\s*Do not/i) || [])[1] || '';
386
+ const tool = (when.match(/after `([^`]+)` fails/i) || [])[1] || '';
387
+ const msg = (when.match(/fails with "([^"]*)"/i) || [])[1] || '';
388
+ const stepWord = steps > 0 ? `${steps}-step recovery` : 'Recovery';
389
+ title = `${stepWord} for ${safeBaseName(target) || 'a repeated failure'}`;
390
+ detail = tool
391
+ ? `Used when ${tool} fails${msg ? ` ("${clip(msg, 60)}")` : ''}.`
392
+ : clip(when || then, 110);
393
+ } else {
394
+ const target = (desc.match(/editing (.+?) affected by/i) || [])[1] || '';
395
+ const isReview = /artifact review feedback/i.test(desc) || /^Enforce user artifact guidance/i.test(then);
396
+ const thenClean = clip(
397
+ then.replace(/^Enforce user artifact guidance:\s*/i, '').replace(/[|`*_]+/g, ' ').replace(/^[-\s]+/, ''),
398
+ 110
399
+ );
400
+ title = isReview
401
+ ? `Review feedback rule for ${safeBaseName(target) || 'this project'}`
402
+ : (clip(desc.replace(/^Use when\s+/i, '').replace(/\.\s*Do not.*$/i, ''), 70) || slug || 'Workspace rule');
403
+ detail = thenClean || clip(when, 110);
404
+ }
405
+
406
+ return {
407
+ kind,
408
+ title: stripEmoji(title) || slug || 'Learned rule',
409
+ detail: stripEmoji(detail),
410
+ status: 'active'
411
+ };
412
+ }