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,327 @@
1
+ /**
2
+ * @file src/telemetry/sprintMetrics.mjs
3
+ * Sprint 1 "Metrics Wedge" for Claude Code (parity with Antigravity `src/core/sprint_metrics.mjs`):
4
+ *
5
+ * 1. Prefix-Cache Retention Index (0–100%) — incremental, per distinct API request.
6
+ * 2. Thinking vs. Generation Drift + DET-21 Scratchpad Loop Detector
7
+ * (Claude Code DET-21 ⇄ Antigravity DET-30 `thinking-drift-loop`).
8
+ *
9
+ * Pure ESM, zero `node:*` imports (Mod-safe). Only measured usage is scored: an
10
+ * unmeasured session reports `retentionIndexPct: null` (rendered "—"), never a fabricated 100%.
11
+ */
12
+
13
+ export const RETENTION_CONSTANTS = Object.freeze({
14
+ DEFAULT_TTL_SECONDS: 300,
15
+ BUST_RETAINED_RATIO: 0.5,
16
+ GRADE_A_PCT: 90,
17
+ GRADE_B_PCT: 70,
18
+ SERIES_MAX: 40
19
+ });
20
+
21
+ export const DRIFT_THRESHOLDS = Object.freeze({
22
+ MIN_THINKING_TOKENS: 4000,
23
+ LOOP_RATIO: 12,
24
+ ELEVATED_RATIO: 4,
25
+ CUMULATIVE_THINKING_TOKENS: 10000,
26
+ CONSECUTIVE_TURNS_CRITICAL: 2,
27
+ ROLLING_WINDOW: 3,
28
+ HISTORY: 10
29
+ });
30
+
31
+ export const THINKING_DRIFT_DETECTOR_ID = 'DET-30';
32
+ export const THINKING_DRIFT_DEPRECATED_ALIAS = 'DET-21';
33
+ export const THINKING_DRIFT_GA_DETECTOR_ID = 'DET-30';
34
+ export const THINKING_DRIFT_SLUG = 'thinking-drift-loop';
35
+
36
+ function num(v) {
37
+ const n = Number(v);
38
+ return Number.isFinite(n) && n > 0 ? n : 0;
39
+ }
40
+
41
+ function round2(v) {
42
+ return Number((Number(v) || 0).toFixed(2));
43
+ }
44
+
45
+ function round6(v) {
46
+ return Number((Number(v) || 0).toFixed(6));
47
+ }
48
+
49
+ export function createInitialPrefixRetention() {
50
+ return {
51
+ measured: false,
52
+ retentionIndexPct: null,
53
+ grade: 'n/a',
54
+ eligiblePrefixTokens: 0,
55
+ retainedPrefixTokens: 0,
56
+ leakedPrefixTokens: 0,
57
+ measuredTurns: 0,
58
+ bustCount: 0,
59
+ ttlExpiredTurns: 0,
60
+ bustCauses: {},
61
+ lastBust: null,
62
+ retainedDiscountSavingsUSD: 0,
63
+ leakedColdPrefillUSD: 0,
64
+ hasCacheTelemetry: false,
65
+ unmeasuredReason: 'insufficient_turns',
66
+ series: [],
67
+ streams: {}
68
+ };
69
+ }
70
+
71
+ export function createInitialThinkingDrift() {
72
+ return {
73
+ measured: false,
74
+ turns: [],
75
+ current: null,
76
+ lastTtftMs: null,
77
+ avgTtftMs: null,
78
+ lastDriftRatio: null,
79
+ rollingDriftRatio: null,
80
+ driftState: 'n/a',
81
+ loop: { detectorId: THINKING_DRIFT_DETECTOR_ID, triggered: false, severity: 'none', consecutiveLoopTurns: 0, message: '' }
82
+ };
83
+ }
84
+
85
+ /**
86
+ * Applies one distinct API request's prompt-side usage to the retention ledger.
87
+ *
88
+ * @param {object} retention - prior ledger (mutated copy returned)
89
+ * @param {object} req
90
+ * @param {string} req.streamKey - 'main' or subagent id
91
+ * @param {string} req.modelId
92
+ * @param {number} req.uncachedInputTokens
93
+ * @param {number} req.cacheReadTokens
94
+ * @param {number} req.cacheWriteTokens
95
+ * @param {number} req.nowMs
96
+ * @param {number} [req.ttlSeconds=300]
97
+ * @param {number} req.inputPer1M
98
+ * @param {number} req.readPer1M
99
+ */
100
+ export function applyPrefixRetentionRequest(retention, req = {}) {
101
+ const r = retention && typeof retention === 'object' ? retention : createInitialPrefixRetention();
102
+ if (!r.streams || typeof r.streams !== 'object') r.streams = {};
103
+ if (!r.bustCauses || typeof r.bustCauses !== 'object') r.bustCauses = {};
104
+
105
+ const total = num(req.uncachedInputTokens) + num(req.cacheReadTokens) + num(req.cacheWriteTokens);
106
+ if (total <= 0) return r;
107
+ if (num(req.cacheReadTokens) > 0 || num(req.cacheWriteTokens) > 0) r.hasCacheTelemetry = true;
108
+ if (!Array.isArray(r.series)) r.series = [];
109
+ const pushSeries = (pt) => {
110
+ r.series.push(pt);
111
+ if (r.series.length > RETENTION_CONSTANTS.SERIES_MAX) r.series = r.series.slice(-RETENTION_CONSTANTS.SERIES_MAX);
112
+ };
113
+
114
+ const key = String(req.streamKey || 'main');
115
+ const prev = r.streams[key] || null;
116
+ r.streams[key] = { promptTotal: total, atMs: num(req.nowMs), modelId: req.modelId || null };
117
+ if (!prev) return r;
118
+
119
+ const ttlSec = num(req.ttlSeconds) || RETENTION_CONSTANTS.DEFAULT_TTL_SECONDS;
120
+ const gapSec = prev.atMs > 0 && num(req.nowMs) >= prev.atMs ? (num(req.nowMs) - prev.atMs) / 1000 : null;
121
+ if (gapSec !== null && gapSec > ttlSec) {
122
+ r.ttlExpiredTurns += 1;
123
+ pushSeries({ eligible: 0, retained: 0, pct: null, bust: false, cause: null, ttlExpired: true, atMs: num(req.nowMs) });
124
+ return r;
125
+ }
126
+
127
+ const eligible = Math.min(prev.promptTotal, total);
128
+ if (eligible <= 0) return r;
129
+ const retained = Math.min(num(req.cacheReadTokens), eligible);
130
+ const leaked = eligible - retained;
131
+ const discountPerToken = Math.max(0, num(req.inputPer1M) - num(req.readPer1M)) / 1_000_000;
132
+
133
+ r.measuredTurns += 1;
134
+ r.eligiblePrefixTokens += eligible;
135
+ r.retainedPrefixTokens += retained;
136
+ r.leakedPrefixTokens = r.eligiblePrefixTokens - r.retainedPrefixTokens;
137
+ r.retainedDiscountSavingsUSD = round6(num(r.retainedDiscountSavingsUSD) + retained * discountPerToken);
138
+ r.leakedColdPrefillUSD = round6(num(r.leakedColdPrefillUSD) + leaked * discountPerToken);
139
+
140
+ const isBust = retained / eligible < RETENTION_CONSTANTS.BUST_RETAINED_RATIO;
141
+ pushSeries({
142
+ eligible,
143
+ retained,
144
+ pct: Math.round((100 * retained) / eligible),
145
+ bust: isBust,
146
+ cause: isBust ? (prev.modelId && req.modelId && prev.modelId !== req.modelId ? 'model_switch' : 'prefix_drift') : null,
147
+ ttlExpired: false,
148
+ savedUSD: round6(retained * discountPerToken),
149
+ atMs: num(req.nowMs)
150
+ });
151
+ if (isBust) {
152
+ const cause = prev.modelId && req.modelId && prev.modelId !== req.modelId ? 'model_switch' : 'prefix_drift';
153
+ r.bustCount += 1;
154
+ r.bustCauses[cause] = (r.bustCauses[cause] || 0) + 1;
155
+ r.lastBust = { cause, leakedTokens: leaked, leakedUSD: round6(leaked * discountPerToken), atMs: num(req.nowMs) };
156
+ }
157
+
158
+ // Honesty gate: zero cache reads/writes across every request => harness exposes no cache
159
+ // telemetry; report "unmeasured", never "0% retained / N busts".
160
+ r.measured = r.measuredTurns > 0 && r.hasCacheTelemetry === true;
161
+ r.unmeasuredReason = r.measured ? null : (r.measuredTurns > 0 ? 'no_cache_telemetry' : 'insufficient_turns');
162
+ r.retentionIndexPct = r.measured
163
+ ? Math.max(0, Math.min(100, Math.round((100 * r.retainedPrefixTokens) / r.eligiblePrefixTokens)))
164
+ : null;
165
+ r.grade = !r.measured
166
+ ? 'n/a'
167
+ : r.retentionIndexPct >= RETENTION_CONSTANTS.GRADE_A_PCT
168
+ ? 'A'
169
+ : r.retentionIndexPct >= RETENTION_CONSTANTS.GRADE_B_PCT ? 'B' : 'C';
170
+ return r;
171
+ }
172
+
173
+ export function formatRetentionCompact(r = {}) {
174
+ if (!r || !r.measured || r.retentionIndexPct === null || r.retentionIndexPct === undefined) return 'Ret —';
175
+ return `Ret ${r.retentionIndexPct}%`;
176
+ }
177
+
178
+ export function formatRetentionLabel(r = {}) {
179
+ if (r && r.unmeasuredReason === 'no_cache_telemetry') return 'Retention — (no cache telemetry reported)';
180
+ if (!r || !r.measured || r.retentionIndexPct === null || r.retentionIndexPct === undefined) {
181
+ return 'Retain — (no multi-turn usage yet)';
182
+ }
183
+ const parts = [`Retain ${r.retentionIndexPct}%`, `Saved $${round2(r.retainedDiscountSavingsUSD).toFixed(2)}`];
184
+ if (num(r.leakedColdPrefillUSD) > 0.005) parts.push(`Leaked $${round2(r.leakedColdPrefillUSD).toFixed(2)}`);
185
+ if (num(r.bustCount) > 0) parts.push(`${r.bustCount} bust${r.bustCount === 1 ? '' : 's'}`);
186
+ return parts.join(' · ');
187
+ }
188
+
189
+ export function classifyTurnDrift(t = {}) {
190
+ const thinking = num(t.thinkingTokens);
191
+ const ratio = thinking / Math.max(1, num(t.visibleOutputTokens));
192
+ if (thinking >= DRIFT_THRESHOLDS.MIN_THINKING_TOKENS && ratio >= DRIFT_THRESHOLDS.LOOP_RATIO && num(t.mutatingCalls) === 0) {
193
+ return 'loop_suspect';
194
+ }
195
+ if (thinking > 0 && ratio >= DRIFT_THRESHOLDS.ELEVATED_RATIO) return 'elevated';
196
+ return 'nominal';
197
+ }
198
+
199
+ export function evaluateThinkingDriftLoop(turnRecords = []) {
200
+ const records = Array.isArray(turnRecords) ? turnRecords : [];
201
+ let consecutive = 0;
202
+ let runThinking = 0;
203
+ for (let i = records.length - 1; i >= 0; i--) {
204
+ const rec = records[i];
205
+ if (num(rec.mutatingCalls) > 0) break;
206
+ runThinking += num(rec.thinkingTokens);
207
+ if (classifyTurnDrift(rec) === 'loop_suspect') consecutive += 1;
208
+ else break;
209
+ }
210
+ const last = records[records.length - 1] || null;
211
+ let severity = 'none';
212
+ if (consecutive >= DRIFT_THRESHOLDS.CONSECUTIVE_TURNS_CRITICAL ||
213
+ (consecutive >= 1 && runThinking >= DRIFT_THRESHOLDS.CUMULATIVE_THINKING_TOKENS)) {
214
+ severity = 'critical';
215
+ } else if (consecutive === 1) {
216
+ severity = 'warn';
217
+ }
218
+ const triggered = severity !== 'none';
219
+ const ratio = last ? round2(num(last.thinkingTokens) / Math.max(1, num(last.visibleOutputTokens))) : 0;
220
+ return {
221
+ detectorId: THINKING_DRIFT_DETECTOR_ID,
222
+ deprecatedAlias: THINKING_DRIFT_DEPRECATED_ALIAS,
223
+ gaDetectorId: THINKING_DRIFT_GA_DETECTOR_ID,
224
+ slug: THINKING_DRIFT_SLUG,
225
+ triggered,
226
+ severity,
227
+ consecutiveLoopTurns: consecutive,
228
+ trailingThinkingTokens: runThinking,
229
+ message: triggered
230
+ ? `${THINKING_DRIFT_DETECTOR_ID} Scratchpad Loop: ${ratio}x reasoning-to-output over ${consecutive} turn(s) with 0 edits. Give a concrete target file + acceptance test, or lower /effort.`
231
+ : ''
232
+ };
233
+ }
234
+
235
+ /**
236
+ * Applies one main-agent usage delta to the drift tracker.
237
+ *
238
+ * @param {object} drift
239
+ * @param {object} ev
240
+ * @param {'turn.step'|'turn.complete'} ev.eventType
241
+ * @param {number} ev.thinkingTokens - delta thinking tokens (reported, never estimated)
242
+ * @param {number} ev.outputTokens - delta visible output tokens
243
+ * @param {number} ev.nowMs
244
+ * @param {number|null} [ev.turnStartedAtMs]
245
+ * @param {number|null} [ev.ttftMs] - explicit TTFT from the host, if provided
246
+ * @param {number} [ev.turnMutations] - workspace edits observed in this turn so far
247
+ */
248
+ export function applyThinkingDriftEvent(drift, ev = {}) {
249
+ const d = drift && typeof drift === 'object' ? drift : createInitialThinkingDrift();
250
+ if (!Array.isArray(d.turns)) d.turns = [];
251
+
252
+ if (!d.current) {
253
+ d.current = {
254
+ startTs: num(ev.turnStartedAtMs) || null,
255
+ ttftMs: null,
256
+ thinkingTokens: 0,
257
+ visibleOutputTokens: 0,
258
+ mutatingCalls: 0
259
+ };
260
+ }
261
+ const cur = d.current;
262
+ if (!cur.startTs && num(ev.turnStartedAtMs)) cur.startTs = num(ev.turnStartedAtMs);
263
+ if (cur.ttftMs === null) {
264
+ if (num(ev.ttftMs) > 0) cur.ttftMs = num(ev.ttftMs);
265
+ else if (cur.startTs && num(ev.nowMs) >= cur.startTs && (num(ev.outputTokens) > 0 || num(ev.thinkingTokens) > 0)) {
266
+ cur.ttftMs = num(ev.nowMs) - cur.startTs;
267
+ }
268
+ }
269
+ cur.thinkingTokens += num(ev.thinkingTokens);
270
+ cur.visibleOutputTokens += num(ev.outputTokens);
271
+ cur.mutatingCalls = Math.max(cur.mutatingCalls, num(ev.turnMutations));
272
+
273
+ const snapshot = (t) => ({
274
+ ttftMs: t.ttftMs,
275
+ thinkingTokens: t.thinkingTokens,
276
+ visibleOutputTokens: t.visibleOutputTokens,
277
+ mutatingCalls: t.mutatingCalls,
278
+ driftRatio: round2(t.thinkingTokens / Math.max(1, t.visibleOutputTokens)),
279
+ driftState: classifyTurnDrift(t)
280
+ });
281
+
282
+ const live = snapshot(cur);
283
+ if (ev.eventType === 'turn.complete') {
284
+ if (live.thinkingTokens > 0 || live.visibleOutputTokens > 0 || live.ttftMs !== null) {
285
+ d.turns.push(live);
286
+ d.turns = d.turns.slice(-DRIFT_THRESHOLDS.HISTORY);
287
+ }
288
+ d.current = null;
289
+ }
290
+
291
+ // Evaluate over completed turns plus the in-flight turn (catches loops mid-turn).
292
+ const series = ev.eventType === 'turn.complete' ? d.turns : [...d.turns, live];
293
+ const scored = series.filter((t) => t.thinkingTokens > 0 || t.visibleOutputTokens > 0);
294
+ const last = scored[scored.length - 1] || null;
295
+ const rolling = scored.slice(-DRIFT_THRESHOLDS.ROLLING_WINDOW);
296
+ const ttfts = series.map((t) => t.ttftMs).filter((v) => typeof v === 'number');
297
+
298
+ d.measured = scored.some((t) => t.thinkingTokens > 0);
299
+ d.loop = evaluateThinkingDriftLoop(scored);
300
+ d.lastTtftMs = ttfts.length ? ttfts[ttfts.length - 1] : null;
301
+ d.avgTtftMs = ttfts.length ? Math.round(ttfts.reduce((a, b) => a + b, 0) / ttfts.length) : null;
302
+ d.lastDriftRatio = d.measured && last ? last.driftRatio : null;
303
+ d.rollingDriftRatio = d.measured
304
+ ? round2(rolling.reduce((a, t) => a + t.thinkingTokens, 0) / Math.max(1, rolling.reduce((a, t) => a + t.visibleOutputTokens, 0)))
305
+ : null;
306
+ d.driftState = !d.measured
307
+ ? 'n/a'
308
+ : d.loop.triggered ? 'loop_detected' : (last && last.driftState === 'elevated' ? 'elevated' : 'nominal');
309
+ return d;
310
+ }
311
+
312
+ export function formatTtft(ms) {
313
+ if (typeof ms !== 'number' || !Number.isFinite(ms)) return '—';
314
+ if (ms < 1000) return `${Math.round(ms)}ms`;
315
+ if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
316
+ return `${Math.floor(ms / 60000)}m${Math.round((ms % 60000) / 1000)}s`;
317
+ }
318
+
319
+ export function formatDriftCompact(d = {}) {
320
+ if (!d || !d.measured || d.lastDriftRatio === null || d.lastDriftRatio === undefined) return 'Think —';
321
+ if (d.driftState === 'loop_detected') return `!LOOP ${d.lastDriftRatio}x`;
322
+ return `Think ${d.lastDriftRatio}x`;
323
+ }
324
+
325
+ export function formatDriftLabel(d = {}) {
326
+ return `${formatDriftCompact(d)} · TTFT ${formatTtft(d?.lastTtftMs)}`;
327
+ }
@@ -0,0 +1,152 @@
1
+ /**
2
+ * Sprint 2.1 (Claude Code) — Subagent lifecycle & worktree topology.
3
+ *
4
+ * Pure ESM, zero `node:*` imports (Mod-safe). Derives per-`agentId` lifecycle from the
5
+ * telemetry bridge's `state.subagents` / `state.subagentInFlightTurns` maps:
6
+ * - `working` : in-flight turn, or activity within the idle window (default 30s)
7
+ * - `waiting` : idle longer than the window with no completion seen (parked, $0)
8
+ * - `completed` : the subagent's final `turn.complete` was observed and nothing since
9
+ * Worktree / branch metadata is only reported when the host event supplied it.
10
+ */
11
+
12
+ export const SWARM_LIFECYCLE_CONSTANTS = Object.freeze({
13
+ IDLE_WINDOW_MS: 30000,
14
+ MAX_WORKERS: 24
15
+ });
16
+
17
+ function str(v) {
18
+ return typeof v === 'string' && v.trim() ? v.trim() : null;
19
+ }
20
+
21
+ /**
22
+ * Extracts optional worktree / branch / model metadata from a mod turn event.
23
+ */
24
+ export function extractAgentLocation(event = {}) {
25
+ const ev = event && typeof event === 'object' ? event : {};
26
+ return {
27
+ model: str(ev.model) || str(ev.result?.model),
28
+ worktree: str(ev.worktree) || str(ev.worktreePath) || str(ev.worktree_path) || str(ev.cwd) || null,
29
+ branch: str(ev.gitBranch) || str(ev.git_branch) || str(ev.branch) || null
30
+ };
31
+ }
32
+
33
+ /**
34
+ * Mutates a `state.subagents[agentKey]` record with lifecycle + location fields.
35
+ */
36
+ export function applySubagentLifecycle(sub, event = {}, { nowMs = 0, eventType = 'turn.step' } = {}) {
37
+ if (!sub || typeof sub !== 'object') return sub;
38
+ const loc = extractAgentLocation(event);
39
+ if (loc.model) sub.model = loc.model;
40
+ if (loc.worktree) sub.worktree = loc.worktree;
41
+ if (loc.branch) sub.branch = loc.branch;
42
+ if (!sub.firstSeenAt) sub.firstSeenAt = nowMs || sub.lastActiveAt || 0;
43
+ if (eventType === 'turn.complete') {
44
+ sub.completedAt = nowMs || sub.lastActiveAt || 0;
45
+ } else {
46
+ sub.completedAt = null;
47
+ }
48
+ return sub;
49
+ }
50
+
51
+ /**
52
+ * Builds the swarm summary rendered by the Pane and statusLine.
53
+ */
54
+ export function computeSwarmSummary(state = {}, {
55
+ nowMs = Date.now(),
56
+ idleWindowMs = SWARM_LIFECYCLE_CONSTANTS.IDLE_WINDOW_MS
57
+ } = {}) {
58
+ const subs = state && typeof state.subagents === 'object' && state.subagents ? state.subagents : {};
59
+ const inFlight = state && typeof state.subagentInFlightTurns === 'object' && state.subagentInFlightTurns
60
+ ? state.subagentInFlightTurns
61
+ : {};
62
+
63
+ const workers = Object.values(subs)
64
+ .filter((s) => s && typeof s === 'object' && s.agentId)
65
+ .map((s) => {
66
+ const lastActive = Number(s.lastActiveAt) || 0;
67
+ const idleMs = lastActive > 0 ? Math.max(0, nowMs - lastActive) : null;
68
+ let lifecycle;
69
+ if (inFlight[s.agentId]) lifecycle = 'working';
70
+ else if (s.completedAt && Number(s.completedAt) >= lastActive) lifecycle = 'completed';
71
+ else if (idleMs !== null && idleMs <= idleWindowMs) lifecycle = 'working';
72
+ else lifecycle = 'waiting';
73
+ return {
74
+ agentId: String(s.agentId),
75
+ state: lifecycle,
76
+ idleSec: idleMs === null ? null : Math.round(idleMs / 1000),
77
+ turns: Number(s.turns) || 0,
78
+ totalTokens: Number(s.totalTokens) || 0,
79
+ model: s.model || null,
80
+ worktree: s.worktree || null,
81
+ branch: s.branch || null
82
+ };
83
+ })
84
+ .sort((a, b) => (a.state === b.state ? b.totalTokens - a.totalTokens : (a.state === 'working' ? -1 : b.state === 'working' ? 1 : 0)))
85
+ .slice(0, SWARM_LIFECYCLE_CONSTANTS.MAX_WORKERS);
86
+
87
+ const counts = { working: 0, waiting: 0, completed: 0 };
88
+ for (const w of workers) counts[w.state] = (counts[w.state] || 0) + 1;
89
+ const live = counts.working + counts.waiting;
90
+
91
+ const wtMap = new Map();
92
+ const mainLoc = { worktree: str(state?.cwd) || str(state?.workspace) || null, branch: str(state?.gitBranch) || null };
93
+ if (mainLoc.worktree || mainLoc.branch) wtMap.set(`${mainLoc.worktree || ''}|${mainLoc.branch || ''}`, { ...mainLoc, agents: ['main'] });
94
+ for (const w of workers) {
95
+ if (!w.worktree && !w.branch) continue;
96
+ const key = `${w.worktree || ''}|${w.branch || ''}`;
97
+ const entry = wtMap.get(key) || { worktree: w.worktree, branch: w.branch, agents: [] };
98
+ entry.agents.push(w.agentId);
99
+ wtMap.set(key, entry);
100
+ }
101
+ const worktrees = Array.from(wtMap.values());
102
+
103
+ const parts = [];
104
+ if (live > 0) parts.push(`${live} live (${counts.working} working · ${counts.waiting} parked)`);
105
+ if (counts.completed > 0) parts.push(`${counts.completed} done`);
106
+ if (worktrees.length > 1) parts.push(`${worktrees.length} worktrees`);
107
+
108
+ return {
109
+ active: workers.length > 0,
110
+ live,
111
+ counts: { ...counts, total: workers.length },
112
+ workers,
113
+ worktrees,
114
+ worktreeCount: worktrees.length,
115
+ label: parts.length > 0 ? parts.join(' · ') : 'Solo'
116
+ };
117
+ }
118
+
119
+ /**
120
+ * Compact statusLine token: `Swarm 3W` (live workers) / '' when solo.
121
+ */
122
+ export function formatSwarmCompact(summary) {
123
+ if (!summary || !summary.live) return '';
124
+ return `Swarm ${summary.live}W`;
125
+ }
126
+
127
+ /**
128
+ * Converts the CC summary into the shared `/cost-radar` topology shape.
129
+ */
130
+ export function toCostRadarTopology(summary) {
131
+ if (!summary || !summary.active) return null;
132
+ const stateMap = { working: 'working', waiting: 'waiting', completed: 'killed' };
133
+ return {
134
+ workers: summary.workers.map((w) => ({
135
+ name: w.agentId,
136
+ state: stateMap[w.state] || 'waiting',
137
+ parked: w.state === 'waiting',
138
+ model: w.model || 'inherit',
139
+ workspace: w.branch || (w.worktree ? 'worktree' : 'inherit')
140
+ })),
141
+ worktrees: summary.worktrees.map((t, idx) => ({
142
+ path: t.worktree || '',
143
+ branch: t.branch || null,
144
+ name: t.worktree || t.branch || `wt-${idx}`,
145
+ isMain: idx === 0,
146
+ detached: false,
147
+ locked: false,
148
+ prunable: false
149
+ })),
150
+ scopeLocks: { leaseCount: 0, collisions: [] }
151
+ };
152
+ }