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,142 @@
1
+ /**
2
+ * @file src/core-isomorphic/ui/brailleSparkline.mjs
3
+ * Feature 23: ANSI Braille & Block Sparklines for Highbeam Terminal HUDs.
4
+ *
5
+ * Implements:
6
+ * - 2x-Resolution Unicode Braille Sparklines (`U+2800..U+28FF`)
7
+ * (2 columns per character x 4 vertical dot levels)
8
+ * - 8-Level Unicode Block Sparklines (`\u2581..\u2588`)
9
+ * - Responsive terminal width capping (40, 80, 110, 144 columns)
10
+ *
11
+ * Adheres strictly to Claude Mod Laws 1–5: pure ESM, zero `node:*` imports, zero Node globals.
12
+ */
13
+
14
+ export const BLOCK_SPARK_GLYPHS = Object.freeze([
15
+ '\u2581', '\u2582', '\u2583', '\u2584', '\u2585', '\u2586', '\u2587', '\u2588'
16
+ ]);
17
+
18
+ // Dot bit patterns for Braille characters (0x2800 offset)
19
+ // Left column (Dots 1, 2, 3, 7) levels 0..4
20
+ const BRAILLE_LEFT_BITS = [
21
+ 0, // Level 0: no dots
22
+ 0x40, // Level 1: Dot 7
23
+ 0x44, // Level 2: Dots 3, 7
24
+ 0x46, // Level 3: Dots 2, 3, 7
25
+ 0x47 // Level 4: Dots 1, 2, 3, 7
26
+ ];
27
+
28
+ // Right column (Dots 4, 5, 6, 8) levels 0..4
29
+ const BRAILLE_RIGHT_BITS = [
30
+ 0, // Level 0: no dots
31
+ 0x80, // Level 1: Dot 8
32
+ 0xA0, // Level 2: Dots 6, 8
33
+ 0xB0, // Level 3: Dots 5, 6, 8
34
+ 0xB8 // Level 4: Dots 4, 5, 6, 8
35
+ ];
36
+
37
+ /**
38
+ * Renders an inline Unicode block sparkline from per-turn values.
39
+ *
40
+ * @param {Array<number>} turnDeltas
41
+ * @param {number} [maxTurns=16]
42
+ * @returns {string}
43
+ */
44
+ export function buildTurnVelocitySparkline(turnDeltas = [], maxTurns = 16) {
45
+ const arr = Array.isArray(turnDeltas)
46
+ ? turnDeltas.map(n => Math.max(0, Number(n) || 0)).slice(-maxTurns)
47
+ : [];
48
+ if (arr.length === 0) return '';
49
+ const peak = Math.max(...arr, 1);
50
+ return arr.map(val => {
51
+ if (val <= 0) return BLOCK_SPARK_GLYPHS[0];
52
+ const idx = Math.min(
53
+ BLOCK_SPARK_GLYPHS.length - 1,
54
+ Math.max(0, Math.floor((val / peak) * (BLOCK_SPARK_GLYPHS.length - 1)))
55
+ );
56
+ return BLOCK_SPARK_GLYPHS[idx];
57
+ }).join('');
58
+ }
59
+
60
+ /**
61
+ * Alias for buildTurnVelocitySparkline conforming to renderer signature.
62
+ *
63
+ * @param {Array<number>} values
64
+ * @param {object} [options={}]
65
+ * @returns {string}
66
+ */
67
+ export function renderBlockSparkline(values = [], options = {}) {
68
+ const maxTurns = options.maxTurns || options.width || 16;
69
+ return buildTurnVelocitySparkline(values, maxTurns);
70
+ }
71
+
72
+ /**
73
+ * Builds a high-resolution Unicode Braille sparkline from an array of numbers.
74
+ * Encodes 2 consecutive data points into each Braille glyph.
75
+ *
76
+ * @param {Array<number>} values Array of numerical data points
77
+ * @param {object} [options={}]
78
+ * @param {number} [options.maxChars] Maximum number of characters to emit
79
+ * @param {number} [options.columns] Target terminal column width (40, 80, 110, 144)
80
+ * @param {number} [options.min] Optional explicit minimum baseline
81
+ * @param {number} [options.max] Optional explicit maximum peak
82
+ * @returns {string}
83
+ */
84
+ export function buildBrailleSparkline(values = [], options = {}) {
85
+ if (!Array.isArray(values) || values.length === 0) {
86
+ return '';
87
+ }
88
+
89
+ const raw = values.map(v => (Number.isFinite(Number(v)) ? Number(v) : 0));
90
+ const maxChars = options.maxChars || (options.columns ? Math.floor(options.columns / 4) : 16);
91
+ const maxPoints = maxChars * 2;
92
+ const sliced = raw.slice(-maxPoints);
93
+
94
+ const min = options.min !== undefined ? Number(options.min) : Math.min(...sliced);
95
+ const max = options.max !== undefined ? Number(options.max) : Math.max(...sliced);
96
+ const range = Math.max(1e-6, max - min);
97
+
98
+ // Map each value to a level 0..4
99
+ const levels = sliced.map(v => {
100
+ const norm = Math.max(0, Math.min(1, (v - min) / range));
101
+ return Math.min(4, Math.max(0, Math.round(norm * 4)));
102
+ });
103
+
104
+ // If odd length, pad with initial baseline
105
+ if (levels.length % 2 !== 0) {
106
+ levels.unshift(0);
107
+ }
108
+
109
+ let result = '';
110
+ for (let i = 0; i < levels.length; i += 2) {
111
+ const leftLevel = levels[i];
112
+ const rightLevel = levels[i + 1];
113
+ const code = 0x2800 + ((BRAILLE_LEFT_BITS[leftLevel] || 0) | (BRAILLE_RIGHT_BITS[rightLevel] || 0));
114
+ result += String.fromCharCode(code);
115
+ }
116
+
117
+ return result;
118
+ }
119
+
120
+ /**
121
+ * Alias for buildBrailleSparkline.
122
+ */
123
+ export function renderBrailleSparkline(values = [], options = {}) {
124
+ return buildBrailleSparkline(values, options);
125
+ }
126
+
127
+ /**
128
+ * Formats a sparkline summary line with min/max bounds.
129
+ *
130
+ * @param {Array<number>} values
131
+ * @param {object} [options={}]
132
+ * @returns {string}
133
+ */
134
+ export function formatSparklineSummary(values = [], options = {}) {
135
+ if (!Array.isArray(values) || values.length === 0) {
136
+ return '—';
137
+ }
138
+ const sparkline = buildBrailleSparkline(values, options);
139
+ const min = Math.min(...values);
140
+ const max = Math.max(...values);
141
+ return `${min} ${sparkline} ${max}`;
142
+ }
@@ -0,0 +1,276 @@
1
+ /**
2
+ * @file src/core-isomorphic/ui/costRadarSvg.mjs
3
+ * Feature 23: Retention Step-Chart SVG & HTML Visualizer for Highbeam v4.0.
4
+ *
5
+ * Pure, zero-dependency renderer (no `node:*` imports) complying with Mod Laws 1–5.
6
+ *
7
+ * Panels (dark, Tufte-style high data-ink, tabular figures):
8
+ * 1. Prefix-Cache Retention step chart per turn, 95% retention guideline, bust markers + savings callout.
9
+ * 2. Thinking vs. Generation drift sparkline + TTFT strip, DET-30 (DET-21) loop turns highlighted.
10
+ * 3. Swarm / worktree topology graph (coordinator -> workers, worktrees, DET-20 overlaps).
11
+ *
12
+ * Security & Accessibility:
13
+ * - Zero executable `<script>` tags across all string and numeric fields
14
+ * - Strict numeric coercion preventing attribute or tag breakout
15
+ * - Valid XML SVG with viewBox, role="img", and aria-label
16
+ * - Strict XML entity escaping via `escapeXml()` with control-character stripping
17
+ */
18
+
19
+ export const COST_RADAR_DIMENSIONS = Object.freeze({
20
+ WIDTH: 640,
21
+ CHART_HEIGHT: 120,
22
+ PAD_LEFT: 36,
23
+ PAD_RIGHT: 12,
24
+ PAD_TOP: 14,
25
+ PAD_BOTTOM: 18
26
+ });
27
+
28
+ const COLORS = Object.freeze({
29
+ bg: '#0b1020',
30
+ fg: '#cbd5e1',
31
+ muted: '#64748b',
32
+ grid: '#1e293b',
33
+ good: '#34d399',
34
+ warn: '#fbbf24',
35
+ bad: '#f87171',
36
+ accent: '#60a5fa',
37
+ think: '#a78bfa'
38
+ });
39
+
40
+ export function escapeXml(value) {
41
+ return String(value ?? '')
42
+ .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F]/g, '')
43
+ .replace(/&/g, '&amp;')
44
+ .replace(/</g, '&lt;')
45
+ .replace(/>/g, '&gt;')
46
+ .replace(/"/g, '&quot;')
47
+ .replace(/'/g, '&#39;');
48
+ }
49
+
50
+ function fmtUsd(n) {
51
+ const v = Number(n) || 0;
52
+ return v >= 1 ? `$${v.toFixed(2)}` : `$${v.toFixed(3)}`;
53
+ }
54
+
55
+ function fmtTokens(n) {
56
+ const v = Number(n) || 0;
57
+ if (v >= 1_000_000) return `${(v / 1_000_000).toFixed(1)}M`;
58
+ if (v >= 1000) return `${(v / 1000).toFixed(1)}k`;
59
+ return String(Math.round(v));
60
+ }
61
+
62
+ function emptyPanel(message, height = 40) {
63
+ const { WIDTH } = COST_RADAR_DIMENSIONS;
64
+ const safeHeight = Math.max(20, Number(height) || 40);
65
+ return `<svg class="cr-svg" viewBox="0 0 ${WIDTH} ${safeHeight}" width="100%" role="img" aria-label="${escapeXml(message)}">` +
66
+ `<text x="${WIDTH / 2}" y="${safeHeight / 2 + 4}" text-anchor="middle" fill="${COLORS.muted}" font-size="11">${escapeXml(message)}</text></svg>`;
67
+ }
68
+
69
+ /**
70
+ * Panel 1: retention step chart. `retention.series` = [{ pct, bust, cause, ttlExpired, savedUSD }].
71
+ * Includes 95% cache discount threshold guideline.
72
+ */
73
+ export function renderRetentionStepChart(retention) {
74
+ const series = Array.isArray(retention?.series) ? retention.series : [];
75
+ if (!retention?.measured || series.length === 0) {
76
+ return emptyPanel('Prefix retention: no multi-turn cache usage measured yet');
77
+ }
78
+ const { WIDTH, CHART_HEIGHT: H, PAD_LEFT: L, PAD_RIGHT: R, PAD_TOP: T, PAD_BOTTOM: B } = COST_RADAR_DIMENSIONS;
79
+ const innerW = WIDTH - L - R;
80
+ const innerH = H - T - B;
81
+ const n = series.length;
82
+ const step = innerW / Math.max(1, n);
83
+ const y = (pct) => T + innerH - (Math.max(0, Math.min(100, pct)) / 100) * innerH;
84
+
85
+ let d = '';
86
+ let lastY = y(0);
87
+ const marks = [];
88
+ series.forEach((pt, i) => {
89
+ const x0 = L + i * step;
90
+ const x1 = x0 + step;
91
+ const rawPct = Number(pt?.pct);
92
+ if (pt?.ttlExpired || pt?.pct === null || pt?.pct === undefined || !Number.isFinite(rawPct)) {
93
+ marks.push(`<rect x="${x0.toFixed(1)}" y="${T}" width="${step.toFixed(1)}" height="${innerH}" fill="${COLORS.grid}" opacity="0.6"><title>Turn ${i + 1}: TTL expired while idle (excluded)</title></rect>`);
94
+ return;
95
+ }
96
+ const safePct = Math.max(0, Math.min(100, rawPct));
97
+ const yy = y(safePct);
98
+ d += d ? ` L${x0.toFixed(1)},${lastY.toFixed(1)} L${x0.toFixed(1)},${yy.toFixed(1)}` : `M${x0.toFixed(1)},${yy.toFixed(1)}`;
99
+ d += ` L${x1.toFixed(1)},${yy.toFixed(1)}`;
100
+ lastY = yy;
101
+ if (pt?.bust) {
102
+ const cx = x0 + step / 2;
103
+ marks.push(`<path d="M${cx.toFixed(1)},${(yy - 7).toFixed(1)} l4,7 l-8,0 z" fill="${COLORS.bad}"><title>Turn ${i + 1}: prefix bust (${escapeXml(String(pt.cause || 'unknown').replace(/_/g, ' '))}) — ${(Math.max(0, Math.min(100, Number(pt.pct) || 0))).toFixed(1)}% retained</title></path>`);
104
+ }
105
+ });
106
+
107
+ const gridLevels = [0, 50, 90, 95, 100];
108
+ const grid = gridLevels.map((p) => {
109
+ const yy = y(p).toFixed(1);
110
+ const is95 = p === 95;
111
+ const is90 = p === 90;
112
+ const strokeColor = is95 ? COLORS.good : COLORS.grid;
113
+ const strokeWidth = is95 ? '0.8' : is90 ? '1' : '0.5';
114
+ const dash = is95 ? ' stroke-dasharray="2,2"' : is90 ? ' stroke-dasharray="3,3"' : '';
115
+ const labelColor = is95 ? COLORS.good : COLORS.muted;
116
+ return `<line x1="${L}" x2="${WIDTH - R}" y1="${yy}" y2="${yy}" stroke="${strokeColor}" stroke-width="${strokeWidth}"${dash}/>` +
117
+ `<text x="${L - 4}" y="${(Number(yy) + 3).toFixed(1)}" text-anchor="end" fill="${labelColor}" font-size="9">${p}%</text>`;
118
+ }).join('');
119
+
120
+ const pct = Number.isFinite(Number(retention.retentionIndexPct)) ? Number(retention.retentionIndexPct).toFixed(1) : '0.0';
121
+ const color = retention.grade === 'A' ? COLORS.good : retention.grade === 'B' ? COLORS.warn : COLORS.bad;
122
+ const callout = `<text x="${WIDTH - R}" y="${T - 3}" text-anchor="end" fill="${color}" font-size="10">` +
123
+ `${escapeXml(`${pct}% retained · saved ${fmtUsd(retention.retainedDiscountSavingsUSD)} · leaked ${fmtUsd(retention.leakedColdPrefillUSD)}`)}</text>`;
124
+
125
+ const measuredTurns = Math.max(0, Math.floor(Number(retention.measuredTurns) || 0));
126
+ const bustCount = Math.max(0, Math.floor(Number(retention.bustCount) || 0));
127
+ const ttlExpiredTurns = Math.max(0, Math.floor(Number(retention.ttlExpiredTurns) || 0));
128
+
129
+ return `<svg class="cr-svg" viewBox="0 0 ${WIDTH} ${H}" width="100%" role="img" aria-label="Prefix-cache retention per turn">` +
130
+ grid + marks.join('') +
131
+ (d ? `<path d="${d}" fill="none" stroke="${color}" stroke-width="1.5"/>` : '') +
132
+ callout +
133
+ `<text x="${L}" y="${H - 4}" fill="${COLORS.muted}" font-size="9">turns 2+ (${measuredTurns} measured, ${bustCount} bust${bustCount === 1 ? '' : 's'}, ${ttlExpiredTurns} TTL-expired)</text>` +
134
+ `</svg>`;
135
+ }
136
+
137
+ /**
138
+ * Panel 2: drift sparkline (thinking:output ratio per turn) + TTFT strip.
139
+ * Emphasizes canonical DET-30 (with DET-21 alias).
140
+ */
141
+ export function renderDriftSparkline(drift) {
142
+ const turns = Array.isArray(drift?.turns) ? drift.turns : [];
143
+ if (!drift?.measured || turns.length === 0) {
144
+ return emptyPanel('Thinking drift: no reported reasoning tokens yet');
145
+ }
146
+ const { WIDTH, PAD_LEFT: L, PAD_RIGHT: R } = COST_RADAR_DIMENSIONS;
147
+ const H = 96;
148
+ const sparkTop = 14;
149
+ const sparkH = 44;
150
+ const stripTop = sparkTop + sparkH + 12;
151
+ const stripH = 12;
152
+ const innerW = WIDTH - L - R;
153
+ const n = turns.length;
154
+ const step = innerW / Math.max(1, n);
155
+ const maxRatio = Math.max(12, ...turns.map((t) => Number(t?.driftRatio) || 0));
156
+ const y = (r) => sparkTop + sparkH - (Math.min(maxRatio, Math.max(0, r)) / maxRatio) * sparkH;
157
+ const maxTtft = Math.max(1, ...turns.map((t) => Number(t?.ttftMs) || 0));
158
+
159
+ const pts = turns.map((t, i) => `${(L + i * step + step / 2).toFixed(1)},${y(Number(t?.driftRatio) || 0).toFixed(1)}`);
160
+ const loopBands = turns.map((t, i) => {
161
+ if (t?.driftState !== 'loop_suspect') return '';
162
+ const mutatingCalls = Math.max(0, Math.floor(Number(t?.mutatingCalls) || 0));
163
+ return `<rect x="${(L + i * step).toFixed(1)}" y="${sparkTop}" width="${step.toFixed(1)}" height="${sparkH}" fill="${COLORS.bad}" opacity="0.18"><title>Turn ${i + 1}: DET-30 loop suspect — ${fmtTokens(t?.thinkingTokens)} thinking, ${mutatingCalls} edits</title></rect>`;
164
+ }).join('');
165
+ const thresholdY = y(12).toFixed(1);
166
+ const ttftStrip = turns.map((t, i) => {
167
+ const rawTtft = Number(t?.ttftMs);
168
+ if (!Number.isFinite(rawTtft) || rawTtft < 0) return '';
169
+ const intensity = Math.max(0.15, Math.min(1, rawTtft / maxTtft));
170
+ return `<rect x="${(L + i * step + 0.5).toFixed(1)}" y="${stripTop}" width="${Math.max(1, step - 1).toFixed(1)}" height="${stripH}" fill="${COLORS.accent}" opacity="${intensity.toFixed(2)}"><title>Turn ${i + 1}: TTFT ${(rawTtft / 1000).toFixed(1)}s</title></rect>`;
171
+ }).join('');
172
+ const last = turns[turns.length - 1];
173
+ const dot = `<circle cx="${(L + (n - 1) * step + step / 2).toFixed(1)}" cy="${y(Number(last?.driftRatio) || 0).toFixed(1)}" r="2.5" fill="${drift.loop?.triggered ? COLORS.bad : COLORS.think}"/>`;
174
+
175
+ const consecutiveTurns = Math.max(0, Math.floor(Number(drift.loop?.consecutiveLoopTurns) || 0));
176
+ const lastRatioStr = Number.isFinite(Number(drift.lastDriftRatio)) ? `${Number(drift.lastDriftRatio).toFixed(1)}x` : (drift.lastDriftRatio != null ? `${drift.lastDriftRatio}x` : '—');
177
+ const rollingRatioStr = Number.isFinite(Number(drift.rollingDriftRatio)) ? `${Number(drift.rollingDriftRatio).toFixed(1)}x` : (drift.rollingDriftRatio != null ? `${drift.rollingDriftRatio}x` : '—');
178
+ const avgTtftStr = Number.isFinite(Number(drift.avgTtftMs)) ? `${(Number(drift.avgTtftMs) / 1000).toFixed(1)}s` : '—';
179
+
180
+ const headline = drift.loop?.triggered
181
+ ? `DET-30 ${String(drift.loop.severity || 'warn').toUpperCase()}: ${consecutiveTurns} consecutive loop turn(s)`
182
+ : `last ${lastRatioStr} · rolling ${rollingRatioStr} · avg TTFT ${avgTtftStr}`;
183
+
184
+ return `<svg class="cr-svg" viewBox="0 0 ${WIDTH} ${H}" width="100%" role="img" aria-label="Thinking vs generation drift and TTFT">` +
185
+ loopBands +
186
+ `<line x1="${L}" x2="${WIDTH - R}" y1="${thresholdY}" y2="${thresholdY}" stroke="${COLORS.bad}" stroke-width="0.6" stroke-dasharray="3,3"/>` +
187
+ `<text x="${L - 4}" y="${(Number(thresholdY) + 3).toFixed(1)}" text-anchor="end" fill="${COLORS.muted}" font-size="9">12x</text>` +
188
+ `<polyline points="${pts.join(' ')}" fill="none" stroke="${COLORS.think}" stroke-width="1.3"/>` + dot +
189
+ `<text x="${WIDTH - R}" y="10" text-anchor="end" fill="${drift.loop?.triggered ? COLORS.bad : COLORS.fg}" font-size="10">${escapeXml(headline)}</text>` +
190
+ `<text x="${L - 4}" y="${stripTop + 9}" text-anchor="end" fill="${COLORS.muted}" font-size="9">TTFT</text>` +
191
+ ttftStrip +
192
+ `<text x="${L}" y="${H - 4}" fill="${COLORS.muted}" font-size="9">thinking ÷ visible output per user turn (estimates excluded)</text>` +
193
+ `</svg>`;
194
+ }
195
+
196
+ /**
197
+ * Panel 3: swarm / worktree topology graph.
198
+ */
199
+ export function renderTopologyGraph(topology) {
200
+ const workers = Array.isArray(topology?.workers) ? topology.workers : [];
201
+ const worktrees = Array.isArray(topology?.worktrees) ? topology.worktrees : [];
202
+ const collisions = Array.isArray(topology?.scopeLocks?.collisions) ? topology.scopeLocks.collisions : [];
203
+ if (workers.length === 0 && worktrees.length <= 1 && collisions.length === 0) {
204
+ return emptyPanel('Topology: solo agent · single worktree');
205
+ }
206
+ const { WIDTH } = COST_RADAR_DIMENSIONS;
207
+ const rowH = 18;
208
+ const rows = Math.max(workers.length, worktrees.length, 1);
209
+ const H = 30 + rows * rowH + (collisions.length > 0 ? 18 : 0);
210
+ const rootX = 60;
211
+ const rootY = 22 + (rows * rowH) / 2;
212
+ const workerX = 220;
213
+ const wtX = 440;
214
+ const stateColor = { working: COLORS.good, waiting: COLORS.accent, stopped: COLORS.warn, killed: COLORS.muted };
215
+
216
+ let out = `<circle cx="${rootX}" cy="${rootY.toFixed(1)}" r="6" fill="${COLORS.fg}"/>` +
217
+ `<text x="${rootX}" y="${(rootY + 18).toFixed(1)}" text-anchor="middle" fill="${COLORS.fg}" font-size="10">coordinator</text>`;
218
+ workers.forEach((w, i) => {
219
+ const wy = 22 + i * rowH + rowH / 2;
220
+ const color = (w && w.state && Object.prototype.hasOwnProperty.call(stateColor, w.state))
221
+ ? stateColor[w.state]
222
+ : COLORS.muted;
223
+ out += `<path d="M${rootX + 6},${rootY.toFixed(1)} C${rootX + 70},${rootY.toFixed(1)} ${workerX - 70},${wy.toFixed(1)} ${workerX - 5},${wy.toFixed(1)}" fill="none" stroke="${color}" stroke-width="1" opacity="${w?.state === 'killed' ? 0.35 : 0.8}"${w?.state === 'waiting' ? ' stroke-dasharray="3,3"' : ''}/>` +
224
+ `<circle cx="${workerX}" cy="${wy.toFixed(1)}" r="4" fill="${color}"/>` +
225
+ `<text x="${workerX + 9}" y="${(wy + 3).toFixed(1)}" fill="${COLORS.fg}" font-size="10">${escapeXml(`${w?.name ?? 'worker'} · ${w?.state ?? 'unknown'}${w?.parked ? ' ($0)' : ''} · ${w?.model || 'inherit'} · ${w?.workspace || 'inherit'}`)}</text>`;
226
+ });
227
+ worktrees.forEach((t, i) => {
228
+ const ty = 22 + i * rowH + rowH / 2;
229
+ const branchLabel = t?.branch || (t?.detached ? `detached@${t?.head || ''}` : t?.name) || 'worktree';
230
+ const label = `${t?.isMain ? '★ ' : ''}${branchLabel}${t?.locked ? ' [locked]' : ''}${t?.prunable ? ' [prunable]' : ''}`;
231
+ out += `<rect x="${wtX}" y="${(ty - 6).toFixed(1)}" width="10" height="10" fill="none" stroke="${COLORS.accent}"/>` +
232
+ `<text x="${wtX + 16}" y="${(ty + 3).toFixed(1)}" fill="${COLORS.fg}" font-size="10">${escapeXml(label)}<title>${escapeXml(t?.path || '')}</title></text>`;
233
+ });
234
+ if (collisions.length > 0) {
235
+ const cy = H - 8;
236
+ const formattedCollisions = collisions.map((c) => {
237
+ const trajs = Array.isArray(c?.trajectories) ? c.trajectories.join(' ↔ ') : String(c?.trajectories || '');
238
+ const paths = Array.isArray(c?.overlappingPaths) ? c.overlappingPaths.join(', ') : String(c?.overlappingPaths || '');
239
+ return `${trajs} [${paths}]`;
240
+ }).join('; ');
241
+ out += `<text x="12" y="${cy}" fill="${COLORS.bad}" font-size="10">${escapeXml(`DET-20 overlap: ${formattedCollisions}`)}</text>`;
242
+ }
243
+ out += `<text x="${workerX}" y="12" fill="${COLORS.muted}" font-size="9">workers</text>` +
244
+ `<text x="${wtX}" y="12" fill="${COLORS.muted}" font-size="9">git worktrees</text>`;
245
+ return `<svg class="cr-svg" viewBox="0 0 ${WIDTH} ${H}" width="100%" role="img" aria-label="Swarm and worktree topology">${out}</svg>`;
246
+ }
247
+
248
+ /**
249
+ * Builds the full self-contained HTML artifact.
250
+ */
251
+ export function renderCostRadarHtml({ retention = null, drift = null, topology = null, meta = {} } = {}) {
252
+ const safeMeta = (meta && typeof meta === 'object') ? meta : {};
253
+ const title = safeMeta.sessionTitle ? `Cost Radar — ${safeMeta.sessionTitle}` : 'Cost Radar';
254
+ const generated = safeMeta.generatedAt || new Date().toISOString();
255
+ const subtitleParts = [safeMeta.model ? `model ${safeMeta.model}` : null, safeMeta.edition || null, `generated ${generated}`].filter(Boolean);
256
+ return `<!doctype html>
257
+ <html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
258
+ <title>${escapeXml(title)}</title>
259
+ <style>
260
+ :root { color-scheme: dark; }
261
+ body { margin: 0; padding: 16px 20px; background: ${COLORS.bg}; color: ${COLORS.fg}; font: 12px/1.45 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; font-variant-numeric: tabular-nums; }
262
+ h1 { font-size: 14px; font-weight: 600; margin: 0 0 2px; }
263
+ .sub { color: ${COLORS.muted}; font-size: 11px; margin-bottom: 12px; }
264
+ section { margin: 0 0 14px; max-width: 680px; }
265
+ h2 { font-size: 11px; font-weight: 500; color: ${COLORS.muted}; text-transform: uppercase; letter-spacing: 0.06em; margin: 0 0 4px; border-bottom: 1px solid ${COLORS.grid}; padding-bottom: 2px; }
266
+ .cr-svg { display: block; font-family: inherit; }
267
+ </style></head>
268
+ <body>
269
+ <h1>${escapeXml(title)}</h1>
270
+ <div class="sub">${escapeXml(subtitleParts.join(' · '))}</div>
271
+ <section id="cr-retention"><h2>Prefix-Cache Retention</h2>${renderRetentionStepChart(retention)}</section>
272
+ <section id="cr-drift"><h2>Thinking vs. Generation Drift · TTFT</h2>${renderDriftSparkline(drift)}</section>
273
+ <section id="cr-topology"><h2>Swarm &amp; Worktree Topology</h2>${renderTopologyGraph(topology)}</section>
274
+ </body></html>
275
+ `;
276
+ }