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,1109 @@
1
+ /**
2
+ * @file src/core/session_auditor.mjs
3
+ * Zero-Write Cross-Platform Historical Session Auditor (`ctxtop audit`).
4
+ *
5
+ * Scans local Antigravity (`transcript_full.jsonl` / `transcript.jsonl`) and Claude Code
6
+ * (`~/.claude/projects/**\/*.jsonl`, deduplicating streaming chunks by `message.id`) transcripts
7
+ * alongside `.agents/telemetry/*.hints.jsonl` and `.claude/cache/horizon_ledger.jsonl`.
8
+ *
9
+ * Guardrails:
10
+ * - Strictly read-only: zero workspace mutations, zero network calls, zero OAuth file reads.
11
+ * - Strictly excludes `packages/airlock/` and sister SKU paths.
12
+ * - Framed strictly around Session ROI & Quota Shield (`Sludge Tax`, `Cold-Cache Spikes`,
13
+ * `Thrash Loops`, `Oversized Reads`, `Top 3 Offending Turns`) — never developer grades.
14
+ */
15
+
16
+ import fs from 'node:fs';
17
+ import path from 'node:path';
18
+ import os from 'node:os';
19
+ import { normalizeModelKey, resolveModelRates, resolveModelCeiling } from './constants.mjs';
20
+ import { isForbiddenSkuPath } from './doc_indexer.mjs';
21
+ import { getSavedQuotaReceiptSummary } from '../core-isomorphic/coach/savedQuotaLedger.mjs';
22
+
23
+ export const COLD_CACHE_IDLE_GAP_MS = 300_000; // 5m TTL
24
+ export const OVERSIZED_READ_CHARS_THRESHOLD = 48_000; // ~1,200 lines / ~12k tokens
25
+ export const OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD = 16_000; // ~4k tokens
26
+
27
+ function resolveHome(options = {}) {
28
+ return (
29
+ options.homeDir ||
30
+ process.env.USERPROFILE ||
31
+ process.env.HOME ||
32
+ os.homedir()
33
+ );
34
+ }
35
+
36
+ function parseIsoOrNumMs(ts) {
37
+ if (typeof ts === 'number' && Number.isFinite(ts)) return ts;
38
+ if (typeof ts === 'string' && ts.trim()) {
39
+ const parsed = Date.parse(ts.trim());
40
+ if (Number.isFinite(parsed)) return parsed;
41
+ }
42
+ return 0;
43
+ }
44
+
45
+ function listClaudeJsonlFiles(claudeRoot, cutoffMs) {
46
+ const results = [];
47
+ if (!claudeRoot || !fs.existsSync(claudeRoot)) return results;
48
+ const walk = (dir, depth = 0) => {
49
+ if (depth > 5) return;
50
+ let entries = [];
51
+ try {
52
+ entries = fs.readdirSync(dir, { withFileTypes: true });
53
+ } catch (err) {
54
+ void err;
55
+ return;
56
+ }
57
+ for (const ent of entries) {
58
+ if (ent.name === 'node_modules' || ent.name === '.git' || ent.name === 'airlock') continue;
59
+ const full = path.join(dir, ent.name);
60
+ if (isForbiddenSkuPath(full)) continue;
61
+ if (ent.isDirectory()) {
62
+ walk(full, depth + 1);
63
+ } else if (ent.isFile() && ent.name.endsWith('.jsonl')) {
64
+ try {
65
+ const st = fs.statSync(full);
66
+ if (st.mtimeMs >= cutoffMs) {
67
+ results.push({ path: full, mtimeMs: st.mtimeMs, sessionId: path.basename(ent.name, '.jsonl') });
68
+ }
69
+ } catch (err) {
70
+ void err;
71
+ }
72
+ }
73
+ }
74
+ };
75
+ walk(claudeRoot, 0);
76
+ return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
77
+ }
78
+
79
+ function listCodexJsonlFiles(codexRoot, cutoffMs) {
80
+ return listClaudeJsonlFiles(codexRoot, cutoffMs);
81
+ }
82
+
83
+ function listCursorTranscriptFiles(cursorRoot, cutoffMs) {
84
+ const results = [];
85
+ if (!cursorRoot || !fs.existsSync(cursorRoot)) return results;
86
+ const walk = (dir, depth = 0) => {
87
+ if (depth > 5) return;
88
+ let entries = [];
89
+ try {
90
+ entries = fs.readdirSync(dir, { withFileTypes: true });
91
+ } catch (err) {
92
+ void err;
93
+ return;
94
+ }
95
+ for (const ent of entries) {
96
+ if (ent.name === 'node_modules' || ent.name === '.git' || ent.name === 'airlock') continue;
97
+ const full = path.join(dir, ent.name);
98
+ if (isForbiddenSkuPath(full)) continue;
99
+ if (ent.isDirectory()) {
100
+ walk(full, depth + 1);
101
+ } else if (ent.isFile() && ent.name.endsWith('.jsonl') && dir.toLowerCase().includes('transcript')) {
102
+ try {
103
+ const st = fs.statSync(full);
104
+ if (st.mtimeMs >= cutoffMs) {
105
+ results.push({ path: full, mtimeMs: st.mtimeMs, sessionId: path.basename(ent.name, '.jsonl') });
106
+ }
107
+ } catch (err) {
108
+ void err;
109
+ }
110
+ }
111
+ }
112
+ };
113
+ walk(cursorRoot, 0);
114
+ return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
115
+ }
116
+
117
+ function listGeminiSessionJsonFiles(geminiTmpRoot, cutoffMs) {
118
+ const results = [];
119
+ if (!geminiTmpRoot || !fs.existsSync(geminiTmpRoot)) return results;
120
+ const walk = (dir, depth = 0) => {
121
+ if (depth > 5) return;
122
+ let entries = [];
123
+ try {
124
+ entries = fs.readdirSync(dir, { withFileTypes: true });
125
+ } catch (err) {
126
+ void err;
127
+ return;
128
+ }
129
+ for (const ent of entries) {
130
+ if (ent.name === 'oauth_creds.json' || ent.name === 'node_modules' || ent.name === '.git' || ent.name === 'airlock') {
131
+ continue;
132
+ }
133
+ const full = path.join(dir, ent.name);
134
+ if (isForbiddenSkuPath(full)) continue;
135
+ if (ent.isDirectory()) {
136
+ walk(full, depth + 1);
137
+ } else if (
138
+ ent.isFile() &&
139
+ /^session-.*\.json$/i.test(ent.name) &&
140
+ path.basename(dir).toLowerCase() === 'chats'
141
+ ) {
142
+ try {
143
+ const st = fs.statSync(full);
144
+ if (st.mtimeMs >= cutoffMs) {
145
+ results.push({ path: full, mtimeMs: st.mtimeMs, sessionId: path.basename(ent.name, '.json') });
146
+ }
147
+ } catch (err) {
148
+ void err;
149
+ }
150
+ }
151
+ }
152
+ };
153
+ walk(geminiTmpRoot, 0);
154
+ return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
155
+ }
156
+
157
+ function listAntigravityTranscriptFiles(brainDirs, cutoffMs) {
158
+ const results = [];
159
+ const seen = new Set();
160
+ for (const brainRoot of brainDirs) {
161
+ if (!brainRoot || !fs.existsSync(brainRoot)) continue;
162
+ let convDirs = [];
163
+ try {
164
+ convDirs = fs.readdirSync(brainRoot, { withFileTypes: true }).filter((d) => d.isDirectory());
165
+ } catch (err) {
166
+ void err;
167
+ continue;
168
+ }
169
+ for (const d of convDirs) {
170
+ const convDir = path.join(brainRoot, d.name);
171
+ if (seen.has(convDir) || isForbiddenSkuPath(convDir)) continue;
172
+ seen.add(convDir);
173
+ const logsDir = path.join(convDir, '.system_generated', 'logs');
174
+ const fullLog = path.join(logsDir, 'transcript_full.jsonl');
175
+ const compactLog = path.join(logsDir, 'transcript.jsonl');
176
+ const chosen = fs.existsSync(fullLog) ? fullLog : fs.existsSync(compactLog) ? compactLog : null;
177
+ if (!chosen) continue;
178
+ try {
179
+ const st = fs.statSync(chosen);
180
+ if (st.mtimeMs >= cutoffMs) {
181
+ results.push({
182
+ path: chosen,
183
+ mtimeMs: st.mtimeMs,
184
+ sessionId: d.name
185
+ });
186
+ }
187
+ } catch (err) {
188
+ void err;
189
+ }
190
+ }
191
+ }
192
+ return results.sort((a, b) => b.mtimeMs - a.mtimeMs);
193
+ }
194
+
195
+ function estimateSludgeCostUSD(modelId, wastedTokens, tsMs, isColdCacheWrite = false) {
196
+ const tok = Math.max(0, Number(wastedTokens) || 0);
197
+ if (tok === 0) return 0;
198
+ const rates = resolveModelRates(modelId || 'claude-sonnet-4-6', tsMs || Date.now(), 'standard', {
199
+ totalPromptTokens: tok
200
+ });
201
+ if (isColdCacheWrite) {
202
+ const writeDiff = Math.max(
203
+ 0.25,
204
+ Number(rates.write5mPer1M || 3.75) - Number(rates.cachedReadPer1M || 0.3)
205
+ );
206
+ return Number(((tok / 1_000_000) * writeDiff).toFixed(4));
207
+ }
208
+ return Number(((tok / 1_000_000) * Number(rates.inputPer1M || 3.0)).toFixed(4));
209
+ }
210
+
211
+ /**
212
+ * Audits a single Claude Code `.jsonl` session transcript, deduplicating streaming
213
+ * assistant chunks by `message.id`.
214
+ *
215
+ * @param {{ path: string, sessionId: string, mtimeMs: number }} item
216
+ */
217
+ export function scoreClaudeTranscriptFile(item) {
218
+ const lines = fs.readFileSync(item.path, 'utf8').split(/\r?\n/).filter(Boolean);
219
+ const assistantByMsgId = new Map();
220
+ const orderedEvents = [];
221
+ let fallbackIdx = 0;
222
+
223
+ for (const line of lines) {
224
+ let row;
225
+ try {
226
+ row = JSON.parse(line);
227
+ } catch (parseErr) {
228
+ void parseErr;
229
+ continue;
230
+ }
231
+ if (!row || typeof row !== 'object') continue;
232
+ const tsMs = parseIsoOrNumMs(row.timestamp || row.created_at || row.createdAt);
233
+
234
+ if (row.type === 'assistant' || row.message?.role === 'assistant') {
235
+ const msg = row.message || row;
236
+ const msgId = String(msg.id || row.uuid || `anon_${++fallbackIdx}`);
237
+ const usage = msg.usage || row.usage || {};
238
+ const outTok = Math.max(0, Number(usage.output_tokens || 0));
239
+ const inTok = Math.max(0, Number(usage.input_tokens || 0));
240
+ const cacheRead = Math.max(0, Number(usage.cache_read_input_tokens || 0));
241
+ const cacheWrite = Math.max(
242
+ 0,
243
+ Number(
244
+ usage.cache_creation_input_tokens ||
245
+ (Number(usage.cache_creation?.ephemeral_5m_input_tokens || 0) +
246
+ Number(usage.cache_creation?.ephemeral_1h_input_tokens || 0)) ||
247
+ 0
248
+ )
249
+ );
250
+ const contentBlocks = Array.isArray(msg.content) ? msg.content : [];
251
+ const prior = assistantByMsgId.get(msgId);
252
+ if (!prior) {
253
+ const entry = {
254
+ kind: 'assistant',
255
+ msgId,
256
+ tsMs,
257
+ modelId: normalizeModelKey(msg.model || row.model || 'claude-sonnet-4-6') || 'claude-sonnet-4-6',
258
+ inputTokens: inTok,
259
+ outputTokens: outTok,
260
+ cacheReadTokens: cacheRead,
261
+ cacheWriteTokens: cacheWrite,
262
+ toolUses: contentBlocks.filter((b) => b && b.type === 'tool_use')
263
+ };
264
+ assistantByMsgId.set(msgId, entry);
265
+ orderedEvents.push(entry);
266
+ } else {
267
+ prior.inputTokens = Math.max(prior.inputTokens, inTok);
268
+ prior.outputTokens = Math.max(prior.outputTokens, outTok);
269
+ prior.cacheReadTokens = Math.max(prior.cacheReadTokens, cacheRead);
270
+ prior.cacheWriteTokens = Math.max(prior.cacheWriteTokens, cacheWrite);
271
+ if (tsMs > prior.tsMs) prior.tsMs = tsMs;
272
+ const moreTools = contentBlocks.filter((b) => b && b.type === 'tool_use');
273
+ if (moreTools.length > prior.toolUses.length) {
274
+ prior.toolUses = moreTools;
275
+ }
276
+ }
277
+ } else if (row.type === 'user' || row.message?.role === 'user') {
278
+ const content = row.message?.content ?? row.content;
279
+ const toolResults = Array.isArray(content)
280
+ ? content.filter((b) => b && b.type === 'tool_result')
281
+ : [];
282
+ orderedEvents.push({
283
+ kind: 'user',
284
+ tsMs,
285
+ toolResults
286
+ });
287
+ }
288
+ }
289
+
290
+ let turnIndex = 0;
291
+ let lastAssistantTsMs = 0;
292
+ let consecutiveToolErrors = 0;
293
+ let thrashLoops = 0;
294
+ let coldCacheSpikes = 0;
295
+ let oversizedReads = 0;
296
+ let oversizedOutputs = 0;
297
+ let sludgeTaxTokens = 0;
298
+ let sludgeTaxUSD = 0;
299
+ let totalPromptTokens = 0;
300
+ let activeModelId = 'claude-sonnet-4-6';
301
+ const toolUseById = new Map();
302
+ const offendingTurns = [];
303
+
304
+ for (const ev of orderedEvents) {
305
+ if (ev.kind === 'assistant') {
306
+ turnIndex += 1;
307
+ activeModelId = ev.modelId || activeModelId;
308
+ totalPromptTokens += ev.inputTokens + ev.cacheReadTokens + ev.cacheWriteTokens;
309
+
310
+ for (const tu of ev.toolUses) {
311
+ if (tu?.id) toolUseById.set(tu.id, { name: tu.name, input: tu.input || {}, turnIndex });
312
+ }
313
+
314
+ // Detect >5m idle Cold-Cache Resume Spike
315
+ if (
316
+ lastAssistantTsMs > 0 &&
317
+ ev.tsMs > 0 &&
318
+ ev.tsMs - lastAssistantTsMs > COLD_CACHE_IDLE_GAP_MS &&
319
+ ev.cacheWriteTokens >= 10_000
320
+ ) {
321
+ coldCacheSpikes += 1;
322
+ const usd = estimateSludgeCostUSD(activeModelId, ev.cacheWriteTokens, ev.tsMs, true);
323
+ sludgeTaxTokens += ev.cacheWriteTokens;
324
+ sludgeTaxUSD += usd;
325
+ offendingTurns.push({
326
+ sessionId: item.sessionId,
327
+ platform: 'claude',
328
+ turnIndex,
329
+ modelId: activeModelId,
330
+ category: 'COLD_CACHE_SPIKE',
331
+ wastedTokens: ev.cacheWriteTokens,
332
+ wastedUSD: usd,
333
+ citation: `${item.sessionId}#T${turnIndex} (${Math.round((ev.tsMs - lastAssistantTsMs) / 60000)}m idle gap rebuilt ${ev.cacheWriteTokens.toLocaleString('en-US')} prefix tok)`,
334
+ fix: 'Finish tool batch before 5m TTL expiry or compact before resuming cold threads.'
335
+ });
336
+ }
337
+ if (ev.tsMs > 0) lastAssistantTsMs = ev.tsMs;
338
+ } else if (ev.kind === 'user') {
339
+ for (const tr of ev.toolResults) {
340
+ const linked = tr.tool_use_id ? toolUseById.get(tr.tool_use_id) : null;
341
+ const toolName = String(linked?.name || tr.tool_name || '');
342
+ const toolInput = linked?.input || {};
343
+ const tIdx = linked?.turnIndex || Math.max(1, turnIndex);
344
+ const text =
345
+ typeof tr.content === 'string'
346
+ ? tr.content
347
+ : Array.isArray(tr.content)
348
+ ? tr.content.map((c) => (typeof c?.text === 'string' ? c.text : '')).join('\n')
349
+ : '';
350
+
351
+ const isError = Boolean(tr.is_error);
352
+ if (isError) {
353
+ consecutiveToolErrors += 1;
354
+ if (consecutiveToolErrors === 3) {
355
+ thrashLoops += 1;
356
+ const thrashTok = 6_000;
357
+ const usd = estimateSludgeCostUSD(activeModelId, thrashTok, ev.tsMs, false);
358
+ sludgeTaxTokens += thrashTok;
359
+ sludgeTaxUSD += usd;
360
+ offendingTurns.push({
361
+ sessionId: item.sessionId,
362
+ platform: 'claude',
363
+ turnIndex: tIdx,
364
+ modelId: activeModelId,
365
+ category: 'THRASH_3X_LOOP',
366
+ wastedTokens: thrashTok,
367
+ wastedUSD: usd,
368
+ citation: `${item.sessionId}#T${tIdx} (3 consecutive failed ${toolName || 'tool'} calls)`,
369
+ fix: 'Enable Active Shield (`ctxtop shield --enable`) to halt 3x failure loops and inspect error lines first.'
370
+ });
371
+ }
372
+ } else {
373
+ consecutiveToolErrors = 0;
374
+ }
375
+
376
+ const isRead = /^Read$/i.test(toolName);
377
+ const hasSlice = toolInput.offset !== undefined || toolInput.limit !== undefined || toolInput.pages !== undefined;
378
+ if (isRead && !hasSlice && text.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
379
+ oversizedReads += 1;
380
+ const estTok = Math.max(0, Math.ceil(text.length / 4) - 600);
381
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, ev.tsMs, false);
382
+ sludgeTaxTokens += estTok;
383
+ sludgeTaxUSD += usd;
384
+ offendingTurns.push({
385
+ sessionId: item.sessionId,
386
+ platform: 'claude',
387
+ turnIndex: tIdx,
388
+ modelId: activeModelId,
389
+ category: 'UNSLICED_LARGE_READ',
390
+ wastedTokens: estTok,
391
+ wastedUSD: usd,
392
+ citation: `${item.sessionId}#T${tIdx} (un-sliced Read of ${path.basename(String(toolInput.file_path || 'file'))}, ~${estTok.toLocaleString('en-US')} excess tok)`,
393
+ fix: 'Run `ctxtop shield --enable` to auto-index files >1,200 lines and enforce offset/limit slices.'
394
+ });
395
+ } else if (!isRead && text.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
396
+ oversizedOutputs += 1;
397
+ const estTok = Math.max(0, Math.ceil(text.length / 4) - 350);
398
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, ev.tsMs, false);
399
+ sludgeTaxTokens += estTok;
400
+ sludgeTaxUSD += usd;
401
+ offendingTurns.push({
402
+ sessionId: item.sessionId,
403
+ platform: 'claude',
404
+ turnIndex: tIdx,
405
+ modelId: activeModelId,
406
+ category: 'OVERSIZED_TOOL_DUMP',
407
+ wastedTokens: estTok,
408
+ wastedUSD: usd,
409
+ citation: `${item.sessionId}#T${tIdx} (${toolName || 'Bash'} dumped ~${Math.ceil(text.length / 4).toLocaleString('en-US')} raw tok)`,
410
+ fix: 'Enable Highbeam PostToolUse sanitizer (`ctxtop shield --enable`) to offload >4k-token logs with 100% error recovery.'
411
+ });
412
+ }
413
+ }
414
+ }
415
+ }
416
+
417
+ return {
418
+ sessionId: item.sessionId,
419
+ platform: 'claude',
420
+ transcriptPath: item.path,
421
+ turns: turnIndex,
422
+ totalPromptTokens,
423
+ sludgeTaxTokens,
424
+ sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
425
+ coldCacheSpikes,
426
+ thrashLoops,
427
+ oversizedReads,
428
+ oversizedOutputs,
429
+ offendingTurns
430
+ };
431
+ }
432
+
433
+ /**
434
+ * Audits a single Antigravity `transcript_full.jsonl` / `transcript.jsonl` session file.
435
+ *
436
+ * @param {{ path: string, sessionId: string, mtimeMs: number }} item
437
+ */
438
+ export function scoreAntigravityTranscriptFile(item) {
439
+ const lines = fs.readFileSync(item.path, 'utf8').split(/\r?\n/).filter(Boolean);
440
+ let turnIndex = 0;
441
+ let lastStepTsMs = 0;
442
+ let consecutiveErrors = 0;
443
+ let thrashLoops = 0;
444
+ let coldCacheSpikes = 0;
445
+ let oversizedReads = 0;
446
+ let oversizedOutputs = 0;
447
+ let sludgeTaxTokens = 0;
448
+ let sludgeTaxUSD = 0;
449
+ let cumulativeContextTokens = 0;
450
+ let activeModelId = 'gemini-4-carbon';
451
+ let lastToolCall = null;
452
+ const offendingTurns = [];
453
+
454
+ for (const line of lines) {
455
+ let step;
456
+ try {
457
+ step = JSON.parse(line);
458
+ } catch (parseErr) {
459
+ void parseErr;
460
+ continue;
461
+ }
462
+ if (!step || typeof step !== 'object') continue;
463
+ const tsMs = parseIsoOrNumMs(step.created_at || step.timestamp);
464
+ if (step.model || step.modelName) {
465
+ activeModelId = normalizeModelKey(step.model || step.modelName) || activeModelId;
466
+ }
467
+
468
+ const stepType = String(step.type || '').toUpperCase();
469
+ const contentStr =
470
+ typeof step.content === 'string'
471
+ ? step.content
472
+ : step.content
473
+ ? JSON.stringify(step.content)
474
+ : '';
475
+ const contentTok = Math.ceil(contentStr.length / 4);
476
+ const modelCeiling = resolveModelCeiling(activeModelId) || 256_000;
477
+
478
+ if (
479
+ stepType.includes('COMPACT') ||
480
+ (stepType === 'USER_INPUT' && /^\s*\/compact\b/i.test(contentStr))
481
+ ) {
482
+ cumulativeContextTokens = Math.min(cumulativeContextTokens, 16_000);
483
+ }
484
+
485
+ if (stepType === 'PLANNER_RESPONSE' || Array.isArray(step.tool_calls)) {
486
+ turnIndex += 1;
487
+ const activeWindowTok = Math.min(cumulativeContextTokens, modelCeiling);
488
+ if (
489
+ lastStepTsMs > 0 &&
490
+ tsMs > 0 &&
491
+ tsMs - lastStepTsMs > COLD_CACHE_IDLE_GAP_MS &&
492
+ activeWindowTok >= 15_000
493
+ ) {
494
+ coldCacheSpikes += 1;
495
+ const usd = estimateSludgeCostUSD(activeModelId, activeWindowTok, tsMs, true);
496
+ sludgeTaxTokens += activeWindowTok;
497
+ sludgeTaxUSD += usd;
498
+ offendingTurns.push({
499
+ sessionId: item.sessionId,
500
+ platform: 'antigravity',
501
+ turnIndex,
502
+ modelId: activeModelId,
503
+ category: 'COLD_CACHE_SPIKE',
504
+ wastedTokens: activeWindowTok,
505
+ wastedUSD: usd,
506
+ citation: `${item.sessionId}#T${turnIndex} (${Math.round((tsMs - lastStepTsMs) / 60000)}m idle gap on ~${activeWindowTok.toLocaleString('en-US')}-tok context)`,
507
+ fix: 'Compact or checkpoint to task.md before >5m idle pauses to avoid cold-prefix rebuild spikes.'
508
+ });
509
+ }
510
+ if (tsMs > 0) lastStepTsMs = tsMs;
511
+ const calls = Array.isArray(step.tool_calls) ? step.tool_calls : [];
512
+ lastToolCall = calls.length > 0 ? calls[0] : null;
513
+ }
514
+
515
+ cumulativeContextTokens = Math.min(modelCeiling, cumulativeContextTokens + contentTok);
516
+
517
+ const statusUpper = String(step.status || '').toUpperCase();
518
+ const failed =
519
+ statusUpper === 'ERROR' ||
520
+ /Command exited with code [1-9]/i.test(contentStr);
521
+ if (failed) {
522
+ consecutiveErrors += 1;
523
+ if (consecutiveErrors === 3) {
524
+ thrashLoops += 1;
525
+ const thrashTok = 6_000;
526
+ const usd = estimateSludgeCostUSD(activeModelId, thrashTok, tsMs, false);
527
+ sludgeTaxTokens += thrashTok;
528
+ sludgeTaxUSD += usd;
529
+ offendingTurns.push({
530
+ sessionId: item.sessionId,
531
+ platform: 'antigravity',
532
+ turnIndex: Math.max(1, turnIndex),
533
+ modelId: activeModelId,
534
+ category: 'THRASH_3X_LOOP',
535
+ wastedTokens: thrashTok,
536
+ wastedUSD: usd,
537
+ citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (3 consecutive tool/command errors)`,
538
+ fix: 'Pause blind retries after 2 failures and inspect the indexed error log.'
539
+ });
540
+ }
541
+ } else if (stepType.includes('TOOL') || contentStr.includes('Command exited with code 0')) {
542
+ consecutiveErrors = 0;
543
+ }
544
+
545
+ const callName = String(lastToolCall?.name || lastToolCall?.tool_name || '');
546
+ const callArgs = lastToolCall?.args || lastToolCall?.parameters || lastToolCall?.arguments || {};
547
+ const isRead = /^(?:default_api:)?(?:read_file|view_file)$/i.test(callName);
548
+ const hasBounds =
549
+ callArgs.StartLine !== undefined ||
550
+ callArgs.EndLine !== undefined ||
551
+ callArgs.offset !== undefined ||
552
+ callArgs.limit !== undefined;
553
+
554
+ if (stepType !== 'PLANNER_RESPONSE' && stepType !== 'USER_INPUT' && contentStr.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
555
+ if (isRead && !hasBounds && contentStr.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
556
+ oversizedReads += 1;
557
+ const estTok = Math.max(0, contentTok - 600);
558
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
559
+ sludgeTaxTokens += estTok;
560
+ sludgeTaxUSD += usd;
561
+ offendingTurns.push({
562
+ sessionId: item.sessionId,
563
+ platform: 'antigravity',
564
+ turnIndex: Math.max(1, turnIndex),
565
+ modelId: activeModelId,
566
+ category: 'UNSLICED_LARGE_READ',
567
+ wastedTokens: estTok,
568
+ wastedUSD: usd,
569
+ citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (un-sliced ${callName || 'read_file'} of ${path.basename(String(callArgs.Path || callArgs.AbsolutePath || 'file'))}, ~${estTok.toLocaleString('en-US')} excess tok)`,
570
+ fix: 'Enable Active Shield (`ctxtop shield --enable`) to index >1,200-line files and enforce StartLine/EndLine.'
571
+ });
572
+ } else if (!isRead) {
573
+ oversizedOutputs += 1;
574
+ const estTok = Math.max(0, contentTok - 350);
575
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
576
+ sludgeTaxTokens += estTok;
577
+ sludgeTaxUSD += usd;
578
+ offendingTurns.push({
579
+ sessionId: item.sessionId,
580
+ platform: 'antigravity',
581
+ turnIndex: Math.max(1, turnIndex),
582
+ modelId: activeModelId,
583
+ category: 'OVERSIZED_TOOL_DUMP',
584
+ wastedTokens: estTok,
585
+ wastedUSD: usd,
586
+ citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (~${contentTok.toLocaleString('en-US')} raw tool output tok)`,
587
+ fix: 'Pipe verbose test/grep commands or enable Highbeam output compaction.'
588
+ });
589
+ }
590
+ lastToolCall = null;
591
+ }
592
+ }
593
+
594
+ return {
595
+ sessionId: item.sessionId,
596
+ platform: 'antigravity',
597
+ transcriptPath: item.path,
598
+ turns: turnIndex,
599
+ totalPromptTokens: cumulativeContextTokens,
600
+ sludgeTaxTokens,
601
+ sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
602
+ coldCacheSpikes,
603
+ thrashLoops,
604
+ oversizedReads,
605
+ oversizedOutputs,
606
+ offendingTurns
607
+ };
608
+ }
609
+
610
+ function scoreGenericJsonlEvents(item, platformName, defaultModelId) {
611
+ const lines = fs.readFileSync(item.path, 'utf8').split(/\r?\n/).filter(Boolean);
612
+ let turnIndex = 0;
613
+ let lastTurnTsMs = 0;
614
+ let consecutiveErrors = 0;
615
+ let thrashLoops = 0;
616
+ let coldCacheSpikes = 0;
617
+ let oversizedReads = 0;
618
+ let oversizedOutputs = 0;
619
+ let sludgeTaxTokens = 0;
620
+ let sludgeTaxUSD = 0;
621
+ let totalPromptTokens = 0;
622
+ let cumulativeContextTokens = 0;
623
+ let activeModelId = defaultModelId;
624
+ const callById = new Map();
625
+ const offendingTurns = [];
626
+
627
+ for (const line of lines) {
628
+ let row;
629
+ try {
630
+ row = JSON.parse(line);
631
+ } catch (parseErr) {
632
+ void parseErr;
633
+ continue;
634
+ }
635
+ if (!row || typeof row !== 'object') continue;
636
+ const tsMs = parseIsoOrNumMs(row.timestamp || row.created_at || row.createdAt);
637
+ const payload = row.payload && typeof row.payload === 'object' ? row.payload : row;
638
+ const rawModel = payload.model || row.model || payload.info?.model;
639
+ if (rawModel) {
640
+ activeModelId = normalizeModelKey(rawModel) || activeModelId;
641
+ }
642
+
643
+ const rowType = String(row.type || payload.type || '').toLowerCase();
644
+ const role = String(payload.role || row.role || '').toLowerCase();
645
+
646
+ if (rowType === 'token_count' && payload.info?.total_token_usage) {
647
+ const u = payload.info.total_token_usage;
648
+ const inTok = Number(u.input_tokens || 0) + Number(u.cached_input_tokens || 0);
649
+ if (inTok > cumulativeContextTokens) {
650
+ cumulativeContextTokens = inTok;
651
+ totalPromptTokens += inTok;
652
+ }
653
+ continue;
654
+ }
655
+
656
+ if (role === 'assistant' || rowType === 'assistant' || rowType === 'agent_message' || rowType === 'turn_started') {
657
+ turnIndex += 1;
658
+ const u = payload.usage || row.usage || {};
659
+ const stepIn = Number(u.input_tokens || 0) + Number(u.cache_read_input_tokens || 0) + Number(u.cache_creation_input_tokens || 0);
660
+ if (stepIn > 0) {
661
+ totalPromptTokens += stepIn;
662
+ cumulativeContextTokens = Math.max(cumulativeContextTokens, stepIn);
663
+ }
664
+ if (lastTurnTsMs > 0 && tsMs > 0 && tsMs - lastTurnTsMs > COLD_CACHE_IDLE_GAP_MS && cumulativeContextTokens >= 15_000) {
665
+ coldCacheSpikes += 1;
666
+ const usd = estimateSludgeCostUSD(activeModelId, cumulativeContextTokens, tsMs, true);
667
+ sludgeTaxTokens += cumulativeContextTokens;
668
+ sludgeTaxUSD += usd;
669
+ offendingTurns.push({
670
+ sessionId: item.sessionId,
671
+ platform: platformName,
672
+ turnIndex,
673
+ modelId: activeModelId,
674
+ category: 'COLD_CACHE_SPIKE',
675
+ wastedTokens: cumulativeContextTokens,
676
+ wastedUSD: usd,
677
+ citation: `${item.sessionId}#T${turnIndex} (${Math.round((tsMs - lastTurnTsMs) / 60000)}m idle gap on ~${cumulativeContextTokens.toLocaleString('en-US')}-tok context)`,
678
+ fix: 'Compact or save a handoff checkpoint before >5m idle pauses to avoid cold-prefix rebuilds.'
679
+ });
680
+ }
681
+ if (tsMs > 0) lastTurnTsMs = tsMs;
682
+ }
683
+
684
+ if (rowType === 'function_call' || rowType === 'tool_use') {
685
+ const cid = payload.call_id || payload.id || '';
686
+ const cname = String(payload.name || payload.tool_name || '');
687
+ let cargs = payload.arguments ?? payload.input ?? {};
688
+ if (typeof cargs === 'string') {
689
+ try {
690
+ cargs = JSON.parse(cargs);
691
+ } catch (argErr) {
692
+ void argErr;
693
+ cargs = {};
694
+ }
695
+ }
696
+ if (cid) callById.set(cid, { name: cname, args: cargs, turnIndex: Math.max(1, turnIndex) });
697
+ continue;
698
+ }
699
+
700
+ if (rowType === 'function_call_output' || rowType === 'tool_result' || role === 'tool') {
701
+ const cid = payload.call_id || payload.tool_use_id || '';
702
+ const linked = cid ? callById.get(cid) : null;
703
+ const toolName = String(linked?.name || payload.name || payload.tool_name || '');
704
+ const toolArgs = linked?.args || {};
705
+ const tIdx = linked?.turnIndex || Math.max(1, turnIndex);
706
+ const outputText = typeof payload.output === 'string'
707
+ ? payload.output
708
+ : typeof payload.content === 'string'
709
+ ? payload.content
710
+ : JSON.stringify(payload.output ?? payload.content ?? '');
711
+ const contentTok = Math.ceil(outputText.length / 4);
712
+ cumulativeContextTokens += contentTok;
713
+ totalPromptTokens += contentTok;
714
+
715
+ const failed = Boolean(payload.is_error || payload.error || /Exit code:\s*[1-9]|Command exited with code [1-9]/i.test(outputText));
716
+ if (failed) {
717
+ consecutiveErrors += 1;
718
+ if (consecutiveErrors === 3) {
719
+ thrashLoops += 1;
720
+ const thrashTok = 6_000;
721
+ const usd = estimateSludgeCostUSD(activeModelId, thrashTok, tsMs, false);
722
+ sludgeTaxTokens += thrashTok;
723
+ sludgeTaxUSD += usd;
724
+ offendingTurns.push({
725
+ sessionId: item.sessionId,
726
+ platform: platformName,
727
+ turnIndex: tIdx,
728
+ modelId: activeModelId,
729
+ category: 'THRASH_3X_LOOP',
730
+ wastedTokens: thrashTok,
731
+ wastedUSD: usd,
732
+ citation: `${item.sessionId}#T${tIdx} (3 consecutive ${toolName || 'tool'} failures)`,
733
+ fix: 'Inspect the failing assertion digest via Highbeam MCP or FTS5 search before retrying.'
734
+ });
735
+ }
736
+ } else {
737
+ consecutiveErrors = 0;
738
+ }
739
+
740
+ const isRead = /^(?:read_file|Read|view_file|cat)$/i.test(toolName);
741
+ const hasBounds = toolArgs.offset !== undefined || toolArgs.limit !== undefined || toolArgs.StartLine !== undefined || toolArgs.EndLine !== undefined;
742
+ if (isRead && !hasBounds && outputText.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
743
+ oversizedReads += 1;
744
+ const estTok = Math.max(0, contentTok - 600);
745
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
746
+ sludgeTaxTokens += estTok;
747
+ sludgeTaxUSD += usd;
748
+ offendingTurns.push({
749
+ sessionId: item.sessionId,
750
+ platform: platformName,
751
+ turnIndex: tIdx,
752
+ modelId: activeModelId,
753
+ category: 'UNSLICED_LARGE_READ',
754
+ wastedTokens: estTok,
755
+ wastedUSD: usd,
756
+ citation: `${item.sessionId}#T${tIdx} (un-sliced read of ${path.basename(String(toolArgs.file_path || toolArgs.path || 'file'))}, ~${estTok.toLocaleString('en-US')} excess tok)`,
757
+ fix: 'Read bounded line ranges (<=150 lines) instead of full large files.'
758
+ });
759
+ } else if (!isRead && outputText.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
760
+ oversizedOutputs += 1;
761
+ const estTok = Math.max(0, contentTok - 350);
762
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
763
+ sludgeTaxTokens += estTok;
764
+ sludgeTaxUSD += usd;
765
+ offendingTurns.push({
766
+ sessionId: item.sessionId,
767
+ platform: platformName,
768
+ turnIndex: tIdx,
769
+ modelId: activeModelId,
770
+ category: 'OVERSIZED_TOOL_DUMP',
771
+ wastedTokens: estTok,
772
+ wastedUSD: usd,
773
+ citation: `${item.sessionId}#T${tIdx} (${toolName || 'CLI'} dumped ~${contentTok.toLocaleString('en-US')} raw tok)`,
774
+ fix: 'Compress noisy CLI dumps via Highbeam FTS5 compressor (`horizon_compress_cli`).'
775
+ });
776
+ }
777
+ }
778
+ }
779
+
780
+ return {
781
+ sessionId: item.sessionId,
782
+ platform: platformName,
783
+ transcriptPath: item.path,
784
+ turns: turnIndex,
785
+ totalPromptTokens,
786
+ sludgeTaxTokens,
787
+ sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
788
+ coldCacheSpikes,
789
+ thrashLoops,
790
+ oversizedReads,
791
+ oversizedOutputs,
792
+ offendingTurns
793
+ };
794
+ }
795
+
796
+ export function scoreCodexTranscriptFile(item) {
797
+ return scoreGenericJsonlEvents(item, 'codex', 'claude-sonnet-4-6');
798
+ }
799
+
800
+ export function scoreCursorTranscriptFile(item) {
801
+ return scoreGenericJsonlEvents(item, 'cursor', 'claude-sonnet-4-6');
802
+ }
803
+
804
+ /**
805
+ * Audits a single Gemini CLI `~/.gemini/tmp/<hash>/chats/session-*.json` transcript read-only.
806
+ */
807
+ export function scoreGeminiSessionFile(item) {
808
+ const raw = JSON.parse(fs.readFileSync(item.path, 'utf8'));
809
+ const messages = Array.isArray(raw?.messages) ? raw.messages : [];
810
+ let turnIndex = 0;
811
+ let lastTsMs = 0;
812
+ let consecutiveErrors = 0;
813
+ let thrashLoops = 0;
814
+ let coldCacheSpikes = 0;
815
+ let oversizedReads = 0;
816
+ let oversizedOutputs = 0;
817
+ let sludgeTaxTokens = 0;
818
+ let sludgeTaxUSD = 0;
819
+ let totalPromptTokens = 0;
820
+ let activeModelId = 'gemini-4-carbon';
821
+ const offendingTurns = [];
822
+
823
+ for (const msg of messages) {
824
+ if (!msg || typeof msg !== 'object') continue;
825
+ const tsMs = parseIsoOrNumMs(msg.timestamp || msg.createdAt);
826
+ if (msg.model) {
827
+ activeModelId = normalizeModelKey(msg.model) || activeModelId;
828
+ }
829
+ const msgType = String(msg.type || '').toLowerCase();
830
+ if (msgType === 'gemini' || msgType === 'model') {
831
+ turnIndex += 1;
832
+ const inTok = Number(msg.tokens?.input || 0);
833
+ totalPromptTokens += inTok;
834
+ if (lastTsMs > 0 && tsMs > 0 && tsMs - lastTsMs > COLD_CACHE_IDLE_GAP_MS && inTok >= 15_000) {
835
+ coldCacheSpikes += 1;
836
+ const usd = estimateSludgeCostUSD(activeModelId, inTok, tsMs, true);
837
+ sludgeTaxTokens += inTok;
838
+ sludgeTaxUSD += usd;
839
+ offendingTurns.push({
840
+ sessionId: item.sessionId,
841
+ platform: 'gemini',
842
+ turnIndex,
843
+ modelId: activeModelId,
844
+ category: 'COLD_CACHE_SPIKE',
845
+ wastedTokens: inTok,
846
+ wastedUSD: usd,
847
+ citation: `${item.sessionId}#T${turnIndex} (${Math.round((tsMs - lastTsMs) / 60000)}m idle gap on ~${inTok.toLocaleString('en-US')}-tok context)`,
848
+ fix: 'Compact or save checkpoint before >5m pauses to preserve warm KV prefix.'
849
+ });
850
+ }
851
+ if (tsMs > 0) lastTsMs = tsMs;
852
+ }
853
+
854
+ const toolCalls = Array.isArray(msg.toolCalls) ? msg.toolCalls : [];
855
+ for (const tc of toolCalls) {
856
+ const toolName = String(tc.name || '');
857
+ const toolArgs = tc.args && typeof tc.args === 'object' ? tc.args : {};
858
+ const outStr = typeof tc.result === 'string'
859
+ ? tc.result
860
+ : Array.isArray(tc.result)
861
+ ? tc.result.map((r) => (typeof r === 'string' ? r : JSON.stringify(r))).join('\n')
862
+ : JSON.stringify(tc.result ?? '');
863
+ const tok = Math.ceil(outStr.length / 4);
864
+ const isErr = String(tc.status || '').toLowerCase() === 'error';
865
+ if (isErr) {
866
+ consecutiveErrors += 1;
867
+ if (consecutiveErrors === 3) {
868
+ thrashLoops += 1;
869
+ const thrashTok = 6_000;
870
+ const usd = estimateSludgeCostUSD(activeModelId, thrashTok, tsMs, false);
871
+ sludgeTaxTokens += thrashTok;
872
+ sludgeTaxUSD += usd;
873
+ offendingTurns.push({
874
+ sessionId: item.sessionId,
875
+ platform: 'gemini',
876
+ turnIndex: Math.max(1, turnIndex),
877
+ modelId: activeModelId,
878
+ category: 'THRASH_3X_LOOP',
879
+ wastedTokens: thrashTok,
880
+ wastedUSD: usd,
881
+ citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (3 consecutive ${toolName || 'tool'} failures)`,
882
+ fix: 'Pause retries and inspect root cause via FTS5 search.'
883
+ });
884
+ }
885
+ } else {
886
+ consecutiveErrors = 0;
887
+ }
888
+
889
+ const isRead = /^(?:read_file|Read|view_file)$/i.test(toolName);
890
+ const hasSlice = toolArgs.offset !== undefined || toolArgs.limit !== undefined || toolArgs.StartLine !== undefined;
891
+ if (isRead && !hasSlice && outStr.length >= OVERSIZED_READ_CHARS_THRESHOLD) {
892
+ oversizedReads += 1;
893
+ const estTok = Math.max(0, tok - 600);
894
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
895
+ sludgeTaxTokens += estTok;
896
+ sludgeTaxUSD += usd;
897
+ offendingTurns.push({
898
+ sessionId: item.sessionId,
899
+ platform: 'gemini',
900
+ turnIndex: Math.max(1, turnIndex),
901
+ modelId: activeModelId,
902
+ category: 'UNSLICED_LARGE_READ',
903
+ wastedTokens: estTok,
904
+ wastedUSD: usd,
905
+ citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (un-sliced read, ~${estTok.toLocaleString('en-US')} excess tok)`,
906
+ fix: 'Use bounded line offsets on large source files.'
907
+ });
908
+ } else if (!isRead && outStr.length >= OVERSIZED_TOOL_OUTPUT_CHARS_THRESHOLD) {
909
+ oversizedOutputs += 1;
910
+ const estTok = Math.max(0, tok - 350);
911
+ const usd = estimateSludgeCostUSD(activeModelId, estTok, tsMs, false);
912
+ sludgeTaxTokens += estTok;
913
+ sludgeTaxUSD += usd;
914
+ offendingTurns.push({
915
+ sessionId: item.sessionId,
916
+ platform: 'gemini',
917
+ turnIndex: Math.max(1, turnIndex),
918
+ modelId: activeModelId,
919
+ category: 'OVERSIZED_TOOL_DUMP',
920
+ wastedTokens: estTok,
921
+ wastedUSD: usd,
922
+ citation: `${item.sessionId}#T${Math.max(1, turnIndex)} (${toolName || 'shell'} dumped ~${tok.toLocaleString('en-US')} raw tok)`,
923
+ fix: 'Enable Highbeam MCP output compression (`horizon_compress_cli`).'
924
+ });
925
+ }
926
+ }
927
+ }
928
+
929
+ return {
930
+ sessionId: item.sessionId,
931
+ platform: 'gemini',
932
+ transcriptPath: item.path,
933
+ turns: turnIndex,
934
+ totalPromptTokens,
935
+ sludgeTaxTokens,
936
+ sludgeTaxUSD: Number(sludgeTaxUSD.toFixed(4)),
937
+ coldCacheSpikes,
938
+ thrashLoops,
939
+ oversizedReads,
940
+ oversizedOutputs,
941
+ offendingTurns
942
+ };
943
+ }
944
+
945
+ /**
946
+ * Runs a zero-write cross-platform audit across historical Antigravity, Claude Code, Codex CLI,
947
+ * Gemini CLI, and Cursor sessions.
948
+ *
949
+ * @param {object} [options={}]
950
+ * @param {'all' | 'antigravity' | 'claude' | 'codex' | 'gemini' | 'cursor'} [options.platform='all']
951
+ */
952
+ export function runSessionAudit(options = {}) {
953
+ const rawPlatform = String(options.platform || 'all').toLowerCase();
954
+ const platform = rawPlatform === 'gemini-cli' ? 'gemini' : rawPlatform;
955
+ const days = Math.max(1, Number(options.days) || 7);
956
+ const limit = Math.max(1, Number(options.limit) || 10);
957
+ const nowMs = Number(options.nowMs) || Date.now();
958
+ const cutoffMs = nowMs - days * 86_400_000;
959
+ const home = resolveHome(options);
960
+ const baseCwd = path.resolve(options.cwd || process.cwd());
961
+
962
+ const includeAg = platform === 'all' || platform === 'antigravity';
963
+ const includeClaude = platform === 'all' || platform === 'claude';
964
+ const includeCodex = platform === 'all' || platform === 'codex';
965
+ const includeGemini = platform === 'all' || platform === 'gemini';
966
+ const includeCursor = platform === 'all' || platform === 'cursor';
967
+
968
+ const agDirs = Array.isArray(options.antigravityDirs)
969
+ ? options.antigravityDirs
970
+ : [
971
+ path.join(home, '.gemini', 'antigravity', 'brain'),
972
+ path.join(home, '.gemini', 'antigravity-cli', 'brain')
973
+ ];
974
+ const claudeDir =
975
+ options.claudeProjectsDir || path.join(home, '.claude', 'projects');
976
+ const codexDir =
977
+ options.codexSessionsDir || path.join(home, '.codex', 'sessions');
978
+ const geminiTmpDir =
979
+ options.geminiTmpDir || path.join(home, '.gemini', 'tmp');
980
+ const cursorDir =
981
+ options.cursorProjectsDir || path.join(home, '.cursor', 'projects');
982
+
983
+ const candidates = [];
984
+ if (includeAg) {
985
+ for (const f of listAntigravityTranscriptFiles(agDirs, cutoffMs)) {
986
+ candidates.push({ ...f, platform: 'antigravity' });
987
+ }
988
+ }
989
+ if (includeClaude) {
990
+ for (const f of listClaudeJsonlFiles(claudeDir, cutoffMs)) {
991
+ candidates.push({ ...f, platform: 'claude' });
992
+ }
993
+ }
994
+ if (includeCodex) {
995
+ for (const f of listCodexJsonlFiles(codexDir, cutoffMs)) {
996
+ candidates.push({ ...f, platform: 'codex' });
997
+ }
998
+ }
999
+ if (includeGemini) {
1000
+ for (const f of listGeminiSessionJsonFiles(geminiTmpDir, cutoffMs)) {
1001
+ candidates.push({ ...f, platform: 'gemini' });
1002
+ }
1003
+ }
1004
+ if (includeCursor) {
1005
+ for (const f of listCursorTranscriptFiles(cursorDir, cutoffMs)) {
1006
+ candidates.push({ ...f, platform: 'cursor' });
1007
+ }
1008
+ }
1009
+
1010
+ candidates.sort((a, b) => b.mtimeMs - a.mtimeMs);
1011
+ const selected = candidates.slice(0, limit);
1012
+
1013
+ const sessions = [];
1014
+ const allOffendingTurns = [];
1015
+ const platformsBreakdown = { antigravity: 0, claude: 0, codex: 0, gemini: 0, cursor: 0 };
1016
+ let totalSludgeTokens = 0;
1017
+ let totalSludgeUSD = 0;
1018
+ let totalColdCacheSpikes = 0;
1019
+ let totalThrashLoops = 0;
1020
+ let totalOversizedReads = 0;
1021
+ let totalOversizedOutputs = 0;
1022
+
1023
+ for (const item of selected) {
1024
+ try {
1025
+ let scored;
1026
+ if (item.platform === 'claude') {
1027
+ scored = scoreClaudeTranscriptFile(item);
1028
+ } else if (item.platform === 'codex') {
1029
+ scored = scoreCodexTranscriptFile(item);
1030
+ } else if (item.platform === 'gemini') {
1031
+ scored = scoreGeminiSessionFile(item);
1032
+ } else if (item.platform === 'cursor') {
1033
+ scored = scoreCursorTranscriptFile(item);
1034
+ } else {
1035
+ scored = scoreAntigravityTranscriptFile(item);
1036
+ }
1037
+ sessions.push(scored);
1038
+ platformsBreakdown[item.platform] = (platformsBreakdown[item.platform] || 0) + 1;
1039
+ totalSludgeTokens += scored.sludgeTaxTokens;
1040
+ totalSludgeUSD += scored.sludgeTaxUSD;
1041
+ totalColdCacheSpikes += scored.coldCacheSpikes;
1042
+ totalThrashLoops += scored.thrashLoops;
1043
+ totalOversizedReads += scored.oversizedReads;
1044
+ totalOversizedOutputs += scored.oversizedOutputs;
1045
+ allOffendingTurns.push(...scored.offendingTurns);
1046
+ } catch (err) {
1047
+ void err;
1048
+ }
1049
+ }
1050
+
1051
+ allOffendingTurns.sort((a, b) => b.wastedUSD - a.wastedUSD || b.wastedTokens - a.wastedTokens);
1052
+ const topOffendingTurns = allOffendingTurns.slice(0, 3);
1053
+
1054
+ const ledger = getSavedQuotaReceiptSummary({
1055
+ cwd: baseCwd,
1056
+ homeDir: home
1057
+ });
1058
+
1059
+ return {
1060
+ ok: true,
1061
+ platform,
1062
+ days,
1063
+ limit,
1064
+ sessionsScanned: sessions.length,
1065
+ platformsBreakdown,
1066
+ sludgeTaxTokens: totalSludgeTokens,
1067
+ sludgeTaxUSD: Number(totalSludgeUSD.toFixed(2)),
1068
+ coldCacheSpikes: totalColdCacheSpikes,
1069
+ thrashLoops: totalThrashLoops,
1070
+ oversizedReads: totalOversizedReads,
1071
+ oversizedOutputs: totalOversizedOutputs,
1072
+ savedTokens30d: Number(ledger.workspace30dSavedTokens || 0),
1073
+ savedUSD30d: Number(Number(ledger.workspace30dSavedUSD || 0).toFixed(2)),
1074
+ topOffendingTurns,
1075
+ sessions
1076
+ };
1077
+ }
1078
+
1079
+ /**
1080
+ * Formats a human-readable Quota Shield & Session ROI console report for `ctxtop audit`.
1081
+ *
1082
+ * @param {ReturnType<typeof runSessionAudit>} res
1083
+ * @returns {string}
1084
+ */
1085
+ export function formatSessionAuditReport(res) {
1086
+ const activePlatforms = Object.entries(res.platformsBreakdown || {})
1087
+ .filter(([, count]) => count > 0)
1088
+ .map(([name, count]) => `${name}=${count}`)
1089
+ .join(', ');
1090
+ const lines = [
1091
+ `[Highbeam Session ROI Audit] Window: ${res.days}d | Platform: ${res.platform} | Sessions: ${res.sessionsScanned}${activePlatforms ? ` (${activePlatforms})` : ''}`,
1092
+ ` Sludge Tax Preventable : ${res.sludgeTaxTokens.toLocaleString('en-US')} tok ($${res.sludgeTaxUSD.toFixed(2)} USD)`,
1093
+ ` Cold-Cache Spikes (>5m): ${res.coldCacheSpikes} | 3x Thrash Loops: ${res.thrashLoops}`,
1094
+ ` Un-Sliced Large Reads : ${res.oversizedReads} | Oversized Tool Dumps: ${res.oversizedOutputs}`,
1095
+ ` Quota Shield Saved (30d): +${res.savedTokens30d.toLocaleString('en-US')} tok ($${res.savedUSD30d.toFixed(2)} USD)`
1096
+ ];
1097
+ if (res.topOffendingTurns.length > 0) {
1098
+ lines.push(' Top Offending Turns:');
1099
+ res.topOffendingTurns.forEach((turn, idx) => {
1100
+ lines.push(
1101
+ ` ${idx + 1}. [${turn.platform}/${turn.category}] ${turn.citation} -> ~$${turn.wastedUSD.toFixed(2)} (${turn.wastedTokens.toLocaleString('en-US')} tok)`
1102
+ );
1103
+ lines.push(` Fix: ${turn.fix}`);
1104
+ });
1105
+ } else {
1106
+ lines.push(' Top Offending Turns: None detected in scanned window.');
1107
+ }
1108
+ return lines.join('\n');
1109
+ }