ctxtop 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,512 @@
1
+ /**
2
+ * @file src/core-isomorphic/ustf/normalizer.mjs
3
+ * Universal Session Trajectory Format (USTF v1) Dual-Harness Normalizer.
4
+ *
5
+ * Normalizes raw session events, steps, DAGs, and transcripts from Google Antigravity
6
+ * and Claude Code into canonical USTF v1 trajectory objects.
7
+ *
8
+ * Pure JS / ESM with strictly 0 node:* imports adhering to Claude Mod Laws 1–5.
9
+ */
10
+
11
+ import {
12
+ USTF_SCHEMA_VERSION,
13
+ USTF_SCHEMA_URI,
14
+ validateUstfTrajectory
15
+ } from './schema.mjs';
16
+
17
+ /**
18
+ * Creates an empty canonical USTF v1 session object.
19
+ *
20
+ * @param {string} sessionId
21
+ * @param {'antigravity' | 'claude-code' | 'cursor'} [harness='claude-code']
22
+ * @param {object} [options={}]
23
+ * @returns {object}
24
+ */
25
+ export function createEmptyUstfSession(sessionId = 'default-session', harness = 'claude-code', options = {}) {
26
+ const now = options.nowMs || Date.now();
27
+ return {
28
+ $schema: USTF_SCHEMA_URI,
29
+ version: USTF_SCHEMA_VERSION,
30
+ sessionId: String(sessionId),
31
+ harness,
32
+ streamKey: `${sessionId}::${options.agentId || 'main'}`,
33
+ modelId: options.modelId || 'unknown',
34
+ startTimeMs: options.startTimeMs || now,
35
+ endTimeMs: options.endTimeMs || null,
36
+ events: [],
37
+ spans: [],
38
+ usage: {
39
+ uncached: 0,
40
+ cacheWrite5m: 0,
41
+ cacheWrite1h: 0,
42
+ cacheRead: 0,
43
+ output: 0,
44
+ thinking: 0,
45
+ costUSD: 0
46
+ },
47
+ worktree: {
48
+ path: options.worktreePath || '',
49
+ branch: options.branch || '',
50
+ isDetached: Boolean(options.isDetached)
51
+ },
52
+ rewindBranches: [],
53
+ metadata: { ...options.metadata }
54
+ };
55
+ }
56
+
57
+ /**
58
+ * Normalizes a raw usage object from various host shapes into canonical USTF usage.
59
+ *
60
+ * @param {object} [raw={}]
61
+ * @param {object} [rates={}]
62
+ * @returns {object}
63
+ */
64
+ export function normalizeUsage(raw = {}, rates = {}) {
65
+ if (!raw || typeof raw !== 'object') {
66
+ return {
67
+ uncached: 0,
68
+ cacheWrite5m: 0,
69
+ cacheWrite1h: 0,
70
+ cacheRead: 0,
71
+ output: 0,
72
+ thinking: 0,
73
+ costUSD: 0
74
+ };
75
+ }
76
+
77
+ const cacheCreation = raw.cache_creation || raw.cacheCreation || null;
78
+ const cacheWrite5m = Number(
79
+ raw.cacheWrite5m ??
80
+ cacheCreation?.ephemeral_5m_input_tokens ??
81
+ raw.cache_creation_input_tokens ??
82
+ raw.cacheCreationInputTokens ??
83
+ 0
84
+ );
85
+ const cacheWrite1h = Number(
86
+ raw.cacheWrite1h ??
87
+ cacheCreation?.ephemeral_1h_input_tokens ??
88
+ 0
89
+ );
90
+ const cacheRead = Number(
91
+ raw.cacheRead ??
92
+ raw.cache_read_input_tokens ??
93
+ raw.cacheReadInputTokens ??
94
+ raw.cached_tokens ??
95
+ raw.cachedTokens ??
96
+ 0
97
+ );
98
+ const uncached = Number(
99
+ raw.uncached ??
100
+ raw.input_tokens ??
101
+ raw.inputTokens ??
102
+ raw.prompt_tokens ??
103
+ raw.promptTokens ??
104
+ 0
105
+ );
106
+ const output = Number(
107
+ raw.output ??
108
+ raw.output_tokens ??
109
+ raw.outputTokens ??
110
+ 0
111
+ );
112
+ const thinking = Number(
113
+ raw.thinking ??
114
+ raw.thinking_tokens ??
115
+ raw.thinkingTokens ??
116
+ 0
117
+ );
118
+
119
+ let costUSD = Number(raw.costUSD ?? raw.cost_usd ?? raw.costUsd ?? 0);
120
+ if (costUSD === 0 && rates && typeof rates === 'object') {
121
+ const inputRate = Number(rates.inputRate ?? rates.input ?? 3.0) / 1_000_000;
122
+ const cacheWriteRate = Number(rates.cacheWriteRate ?? rates.cacheWrite ?? 3.75) / 1_000_000;
123
+ const cacheReadRate = Number(rates.cacheReadRate ?? rates.cacheRead ?? 0.30) / 1_000_000;
124
+ const outputRate = Number(rates.outputRate ?? rates.output ?? 15.0) / 1_000_000;
125
+ costUSD =
126
+ uncached * inputRate +
127
+ (cacheWrite5m + cacheWrite1h) * cacheWriteRate +
128
+ cacheRead * cacheReadRate +
129
+ output * outputRate;
130
+ }
131
+
132
+ return {
133
+ uncached: Math.max(0, uncached),
134
+ cacheWrite5m: Math.max(0, cacheWrite5m),
135
+ cacheWrite1h: Math.max(0, cacheWrite1h),
136
+ cacheRead: Math.max(0, cacheRead),
137
+ output: Math.max(0, output),
138
+ thinking: Math.max(0, thinking),
139
+ costUSD: Math.max(0, Number(costUSD.toFixed(6)))
140
+ };
141
+ }
142
+
143
+ /**
144
+ * Normalizes Antigravity session steps and transcripts into a USTF v1 trajectory.
145
+ *
146
+ * @param {object} raw - Antigravity session data (steps array, transcript lines, metadata)
147
+ * @param {object} [options={}]
148
+ * @returns {object}
149
+ */
150
+ export function normalizeAntigravitySession(raw = {}, options = {}) {
151
+ const sessionId = raw.sessionId || raw.session_id || options.sessionId || 'antigravity-session';
152
+ const session = createEmptyUstfSession(sessionId, 'antigravity', {
153
+ ...options,
154
+ modelId: raw.modelId || options.modelId || 'gemini-2-5-pro'
155
+ });
156
+
157
+ const rawSteps = Array.isArray(raw.steps)
158
+ ? raw.steps
159
+ : Array.isArray(raw)
160
+ ? raw
161
+ : [];
162
+
163
+ let currentTurnId = null;
164
+ let turnIndex = 0;
165
+ let currentTurnStartMs = session.startTimeMs;
166
+
167
+ for (let i = 0; i < rawSteps.length; i++) {
168
+ const step = rawSteps[i];
169
+ if (!step || typeof step !== 'object') continue;
170
+
171
+ const stepType = String(step.type || step.stepType || step.step_type || 'STEP').toUpperCase();
172
+ const timestampMs = Number(step.createdAt || step.timestampMs || step.timestamp || (session.startTimeMs + i * 1000));
173
+ const content = String(step.content || step.extractedText || '');
174
+
175
+ if (stepType === 'USER_INPUT' || stepType === 'USER') {
176
+ if (currentTurnId) {
177
+ session.events.push({
178
+ eventId: `turn-comp-${turnIndex}`,
179
+ type: 'turn.complete',
180
+ turnId: currentTurnId,
181
+ timestampMs: timestampMs - 1
182
+ });
183
+ }
184
+ turnIndex++;
185
+ currentTurnId = `turn-${turnIndex}`;
186
+ currentTurnStartMs = timestampMs;
187
+
188
+ session.events.push({
189
+ eventId: `turn-start-${turnIndex}`,
190
+ type: 'turn.start',
191
+ turnId: currentTurnId,
192
+ timestampMs,
193
+ payload: { userPrompt: content }
194
+ });
195
+
196
+ session.spans.push({
197
+ spanId: currentTurnId,
198
+ parentSpanId: null,
199
+ kind: 'turn',
200
+ name: `Turn ${turnIndex}`,
201
+ startTimeMs: currentTurnStartMs,
202
+ durationMs: 0,
203
+ status: 'ok',
204
+ attributes: { userPrompt: content }
205
+ });
206
+ } else if (stepType === 'TOOL_CALL' || stepType === 'CALL') {
207
+ const toolName = step.toolName || step.tool_name || 'Tool';
208
+ const toolInput = step.toolInput || step.tool_input || {};
209
+ const spanId = `span-tool-${i}`;
210
+
211
+ session.events.push({
212
+ eventId: `ev-tool-call-${i}`,
213
+ type: 'tool.call',
214
+ turnId: currentTurnId || `turn-${turnIndex}`,
215
+ timestampMs,
216
+ payload: { toolName, toolInput, spanId }
217
+ });
218
+
219
+ session.spans.push({
220
+ spanId,
221
+ parentSpanId: currentTurnId,
222
+ kind: 'tool',
223
+ name: toolName,
224
+ startTimeMs: timestampMs,
225
+ durationMs: Number(step.durationMs || 50),
226
+ status: step.status === 'ERROR' ? 'error' : 'ok',
227
+ attributes: { toolName, input: toolInput }
228
+ });
229
+ } else if (stepType === 'TOOL_RESULT' || stepType === 'RESULT') {
230
+ session.events.push({
231
+ eventId: `ev-tool-result-${i}`,
232
+ type: 'tool.result',
233
+ turnId: currentTurnId || `turn-${turnIndex}`,
234
+ timestampMs,
235
+ payload: {
236
+ toolName: step.toolName || step.tool_name,
237
+ result: content.slice(0, 1000)
238
+ }
239
+ });
240
+ } else {
241
+ session.events.push({
242
+ eventId: `ev-turn-step-${i}`,
243
+ type: 'turn.step',
244
+ turnId: currentTurnId || `turn-${turnIndex}`,
245
+ timestampMs,
246
+ payload: { stepType, content: content.slice(0, 1000) }
247
+ });
248
+ }
249
+
250
+ if (step.usage) {
251
+ const u = normalizeUsage(step.usage);
252
+ session.usage.uncached += u.uncached;
253
+ session.usage.cacheWrite5m += u.cacheWrite5m;
254
+ session.usage.cacheWrite1h += u.cacheWrite1h;
255
+ session.usage.cacheRead += u.cacheRead;
256
+ session.usage.output += u.output;
257
+ session.usage.thinking += u.thinking;
258
+ session.usage.costUSD += u.costUSD;
259
+ }
260
+ }
261
+
262
+ if (currentTurnId) {
263
+ session.events.push({
264
+ eventId: `turn-comp-${turnIndex}`,
265
+ type: 'turn.complete',
266
+ turnId: currentTurnId,
267
+ timestampMs: session.startTimeMs + rawSteps.length * 1000
268
+ });
269
+ }
270
+
271
+ return session;
272
+ }
273
+
274
+ /**
275
+ * Normalizes Claude Code DAG entries / JSONL transcript into a USTF v1 trajectory.
276
+ *
277
+ * @param {string | object[] | object} raw - JSONL content, array of JSONL entries, or session object
278
+ * @param {object} [options={}]
279
+ * @returns {object}
280
+ */
281
+ export function normalizeClaudeCodeSession(raw = {}, options = {}) {
282
+ let entries = [];
283
+ let sessionId = options.sessionId || 'claude-code-session';
284
+
285
+ if (typeof raw === 'string') {
286
+ entries = raw
287
+ .split(/\r?\n/)
288
+ .filter(Boolean)
289
+ .map((line) => {
290
+ try {
291
+ return JSON.parse(line);
292
+ } catch {
293
+ return null;
294
+ }
295
+ })
296
+ .filter(Boolean);
297
+ } else if (Array.isArray(raw)) {
298
+ entries = raw;
299
+ } else if (raw && typeof raw === 'object') {
300
+ sessionId = raw.sessionId || raw.session_id || sessionId;
301
+ if (Array.isArray(raw.entries)) entries = raw.entries;
302
+ else if (Array.isArray(raw.events)) entries = raw.events;
303
+ }
304
+
305
+ const session = createEmptyUstfSession(sessionId, 'claude-code', {
306
+ ...options,
307
+ modelId: options.modelId || 'claude-sonnet-5-5'
308
+ });
309
+
310
+ const nodeMap = new Map();
311
+ const childrenMap = new Map();
312
+ let explicitLeafUuid = null;
313
+ let lastEntryUuid = null;
314
+
315
+ for (let i = 0; i < entries.length; i++) {
316
+ const e = entries[i];
317
+ if (!e || typeof e !== 'object') continue;
318
+
319
+ if (e.leafUuid) explicitLeafUuid = e.leafUuid;
320
+ const uuid = e.uuid || e.id || `node-${i}`;
321
+ const parentUuid = e.parentUuid !== undefined ? e.parentUuid : lastEntryUuid;
322
+ lastEntryUuid = uuid;
323
+
324
+ nodeMap.set(uuid, { ...e, uuid, parentUuid, rawIndex: i });
325
+ const pKey = parentUuid || '__ROOT__';
326
+ if (!childrenMap.has(pKey)) childrenMap.set(pKey, []);
327
+ childrenMap.get(pKey).push(uuid);
328
+ }
329
+
330
+ const activeTipUuid = explicitLeafUuid && nodeMap.has(explicitLeafUuid) ? explicitLeafUuid : lastEntryUuid;
331
+ const activeChain = [];
332
+ const activeUuidSet = new Set();
333
+ let curr = activeTipUuid;
334
+
335
+ while (curr && nodeMap.has(curr) && !activeUuidSet.has(curr)) {
336
+ activeUuidSet.add(curr);
337
+ activeChain.push(nodeMap.get(curr));
338
+ curr = nodeMap.get(curr).parentUuid;
339
+ }
340
+ activeChain.reverse();
341
+
342
+ // Find rewind branches
343
+ for (const node of activeChain) {
344
+ const siblings = childrenMap.get(node.uuid) || [];
345
+ for (const childUuid of siblings) {
346
+ if (!activeUuidSet.has(childUuid)) {
347
+ session.rewindBranches.push({
348
+ forkParentUuid: node.uuid,
349
+ abandonedTipUuid: childUuid
350
+ });
351
+ }
352
+ }
353
+ }
354
+
355
+ let turnIndex = 0;
356
+ let currentTurnId = null;
357
+
358
+ for (let i = 0; i < activeChain.length; i++) {
359
+ const node = activeChain[i];
360
+ const timestampMs = Number(node.timestamp || node.createdAt || (session.startTimeMs + i * 1000));
361
+ const role = node.role || node.type || 'message';
362
+
363
+ if (node.type === 'file-history-snapshot' || node.snapshot) {
364
+ session.events.push({
365
+ eventId: `ev-compact-${i}`,
366
+ type: 'compact.lifecycle',
367
+ timestampMs,
368
+ payload: { snapshotFiles: Object.keys(node.snapshot?.trackedFileBackups || node.files || {}) }
369
+ });
370
+ continue;
371
+ }
372
+
373
+ if (role === 'user' || node.type === 'user_input') {
374
+ if (currentTurnId) {
375
+ session.events.push({
376
+ eventId: `ev-turn-comp-${turnIndex}`,
377
+ type: 'turn.complete',
378
+ turnId: currentTurnId,
379
+ timestampMs: timestampMs - 1
380
+ });
381
+ }
382
+ turnIndex++;
383
+ currentTurnId = `turn-${turnIndex}`;
384
+
385
+ const text = typeof node.content === 'string'
386
+ ? node.content
387
+ : Array.isArray(node.content)
388
+ ? node.content.map((c) => c.text || '').join('')
389
+ : '';
390
+
391
+ session.events.push({
392
+ eventId: `ev-turn-start-${turnIndex}`,
393
+ type: 'turn.start',
394
+ turnId: currentTurnId,
395
+ timestampMs,
396
+ payload: { prompt: text }
397
+ });
398
+
399
+ session.spans.push({
400
+ spanId: currentTurnId,
401
+ parentSpanId: null,
402
+ kind: 'turn',
403
+ name: `Turn ${turnIndex}`,
404
+ startTimeMs: timestampMs,
405
+ durationMs: 0,
406
+ status: 'ok',
407
+ attributes: { prompt: text }
408
+ });
409
+ } else {
410
+ // Assistant / Tool turns
411
+ const contentBlocks = Array.isArray(node.content) ? node.content : [];
412
+ for (const block of contentBlocks) {
413
+ if (block.type === 'tool_use') {
414
+ const spanId = `span-tool-${block.id || i}`;
415
+ session.events.push({
416
+ eventId: `ev-tool-call-${block.id || i}`,
417
+ type: 'tool.call',
418
+ turnId: currentTurnId || `turn-${turnIndex}`,
419
+ timestampMs,
420
+ payload: { toolName: block.name, toolInput: block.input, spanId }
421
+ });
422
+
423
+ session.spans.push({
424
+ spanId,
425
+ parentSpanId: currentTurnId,
426
+ kind: 'tool',
427
+ name: block.name,
428
+ startTimeMs: timestampMs,
429
+ durationMs: 50,
430
+ status: 'ok',
431
+ attributes: { toolName: block.name, input: block.input }
432
+ });
433
+ } else if (block.type === 'tool_result') {
434
+ session.events.push({
435
+ eventId: `ev-tool-result-${block.tool_use_id || i}`,
436
+ type: 'tool.result',
437
+ turnId: currentTurnId || `turn-${turnIndex}`,
438
+ timestampMs,
439
+ payload: { result: String(block.content || '').slice(0, 1000) }
440
+ });
441
+ }
442
+ }
443
+
444
+ session.events.push({
445
+ eventId: `ev-step-${i}`,
446
+ type: 'turn.step',
447
+ turnId: currentTurnId || `turn-${turnIndex}`,
448
+ timestampMs,
449
+ payload: { role: 'assistant', messageId: node.message?.id || node.id }
450
+ });
451
+ }
452
+
453
+ const rawUsage = node.message?.usage || node.usage;
454
+ if (rawUsage) {
455
+ const u = normalizeUsage(rawUsage);
456
+ session.usage.uncached += u.uncached;
457
+ session.usage.cacheWrite5m += u.cacheWrite5m;
458
+ session.usage.cacheWrite1h += u.cacheWrite1h;
459
+ session.usage.cacheRead += u.cacheRead;
460
+ session.usage.output += u.output;
461
+ session.usage.thinking += u.thinking;
462
+ session.usage.costUSD += u.costUSD;
463
+ }
464
+ }
465
+
466
+ if (currentTurnId) {
467
+ session.events.push({
468
+ eventId: `ev-turn-comp-${turnIndex}`,
469
+ type: 'turn.complete',
470
+ turnId: currentTurnId,
471
+ timestampMs: session.startTimeMs + activeChain.length * 1000
472
+ });
473
+ }
474
+
475
+ return session;
476
+ }
477
+
478
+ /**
479
+ * Auto-detects the host format and normalizes into a USTF v1 trajectory.
480
+ *
481
+ * @param {any} rawInput
482
+ * @param {object} [options={}]
483
+ * @returns {object}
484
+ */
485
+ export function normalizeSessionTrajectory(rawInput, options = {}) {
486
+ if (!rawInput) {
487
+ return createEmptyUstfSession('empty-session', 'claude-code', options);
488
+ }
489
+
490
+ if (typeof rawInput === 'string') {
491
+ return normalizeClaudeCodeSession(rawInput, options);
492
+ }
493
+
494
+ if (rawInput.harness === 'antigravity' || Array.isArray(rawInput.steps)) {
495
+ return normalizeAntigravitySession(rawInput, options);
496
+ }
497
+
498
+ if (rawInput.harness === 'claude-code' || rawInput.leafUuid || Array.isArray(rawInput.entries)) {
499
+ return normalizeClaudeCodeSession(rawInput, options);
500
+ }
501
+
502
+ // Heuristic: check first item in array
503
+ if (Array.isArray(rawInput)) {
504
+ const first = rawInput[0];
505
+ if (first && (first.step_type || first.stepType)) {
506
+ return normalizeAntigravitySession(rawInput, options);
507
+ }
508
+ return normalizeClaudeCodeSession(rawInput, options);
509
+ }
510
+
511
+ return createEmptyUstfSession('unknown-session', 'claude-code', options);
512
+ }
@@ -0,0 +1,186 @@
1
+ /**
2
+ * @file src/core-isomorphic/ustf/schema.mjs
3
+ * Universal Session Trajectory Format (USTF v1) Schema & Validators.
4
+ *
5
+ * Cross-platform JSON schema representing agent sessions, turns, tool calls,
6
+ * costs, and execution spans across Google Antigravity and Claude Code.
7
+ *
8
+ * Pure JS / ESM with strictly 0 node:* imports adhering to Claude Mod Laws 1–5.
9
+ */
10
+
11
+ export const USTF_SCHEMA_VERSION = '1.0.0';
12
+ export const USTF_SCHEMA_URI = 'https://ctxtop.dev/schemas/ustf-v1.json';
13
+
14
+ /**
15
+ * 9 Canonical USTF v1 event types.
16
+ */
17
+ export const USTF_EVENT_TYPES = Object.freeze([
18
+ 'turn.start',
19
+ 'turn.step',
20
+ 'turn.complete',
21
+ 'tool.call',
22
+ 'tool.result',
23
+ 'model.switch',
24
+ 'compact.lifecycle',
25
+ 'subagent.lifecycle',
26
+ 'control.action'
27
+ ]);
28
+
29
+ /**
30
+ * Canonical USTF v1 hierarchical call-tree span kinds.
31
+ */
32
+ export const USTF_SPAN_KINDS = Object.freeze([
33
+ 'turn',
34
+ 'agent',
35
+ 'tool',
36
+ 'hook',
37
+ 'llm'
38
+ ]);
39
+
40
+ /**
41
+ * Validates a USTF v1 usage accounting object.
42
+ *
43
+ * @param {object} usage
44
+ * @returns {{ valid: boolean, errors: string[] }}
45
+ */
46
+ export function validateUstfUsage(usage) {
47
+ const errors = [];
48
+ if (!usage || typeof usage !== 'object' || Array.isArray(usage)) {
49
+ return { valid: false, errors: ['usage must be an object'] };
50
+ }
51
+ const numericFields = [
52
+ 'uncached',
53
+ 'cacheWrite5m',
54
+ 'cacheWrite1h',
55
+ 'cacheRead',
56
+ 'output',
57
+ 'thinking',
58
+ 'costUSD'
59
+ ];
60
+ for (const f of numericFields) {
61
+ if (usage[f] !== undefined && typeof usage[f] !== 'number') {
62
+ errors.push(`usage.${f} must be a number`);
63
+ } else if (usage[f] < 0) {
64
+ errors.push(`usage.${f} must be non-negative`);
65
+ }
66
+ }
67
+ return { valid: errors.length === 0, errors };
68
+ }
69
+
70
+ /**
71
+ * Validates a USTF v1 execution span.
72
+ *
73
+ * @param {object} span
74
+ * @returns {{ valid: boolean, errors: string[] }}
75
+ */
76
+ export function validateUstfSpan(span) {
77
+ const errors = [];
78
+ if (!span || typeof span !== 'object' || Array.isArray(span)) {
79
+ return { valid: false, errors: ['span must be an object'] };
80
+ }
81
+ if (!span.spanId || typeof span.spanId !== 'string') {
82
+ errors.push('spanId must be a non-empty string');
83
+ }
84
+ if (span.parentSpanId !== null && span.parentSpanId !== undefined && typeof span.parentSpanId !== 'string') {
85
+ errors.push('parentSpanId must be string or null');
86
+ }
87
+ if (!span.kind || !USTF_SPAN_KINDS.includes(span.kind)) {
88
+ errors.push(`kind must be one of: ${USTF_SPAN_KINDS.join(', ')}`);
89
+ }
90
+ if (!span.name || typeof span.name !== 'string') {
91
+ errors.push('name must be a non-empty string');
92
+ }
93
+ if (typeof span.startTimeMs !== 'number' || span.startTimeMs < 0) {
94
+ errors.push('startTimeMs must be a non-negative number');
95
+ }
96
+ if (span.durationMs !== undefined && span.durationMs !== null) {
97
+ if (typeof span.durationMs !== 'number' || span.durationMs < 0) {
98
+ errors.push('durationMs must be a non-negative number');
99
+ }
100
+ }
101
+ if (span.status && !['ok', 'error', 'aborted'].includes(span.status)) {
102
+ errors.push('status must be one of: ok, error, aborted');
103
+ }
104
+ return { valid: errors.length === 0, errors };
105
+ }
106
+
107
+ /**
108
+ * Validates a USTF v1 event.
109
+ *
110
+ * @param {object} event
111
+ * @returns {{ valid: boolean, errors: string[] }}
112
+ */
113
+ export function validateUstfEvent(event) {
114
+ const errors = [];
115
+ if (!event || typeof event !== 'object' || Array.isArray(event)) {
116
+ return { valid: false, errors: ['event must be an object'] };
117
+ }
118
+ if (!event.eventId || typeof event.eventId !== 'string') {
119
+ errors.push('eventId must be a non-empty string');
120
+ }
121
+ if (!event.type || !USTF_EVENT_TYPES.includes(event.type)) {
122
+ errors.push(`type must be one of: ${USTF_EVENT_TYPES.join(', ')}`);
123
+ }
124
+ if (typeof event.timestampMs !== 'number' || event.timestampMs < 0) {
125
+ errors.push('timestampMs must be a non-negative number');
126
+ }
127
+ return { valid: errors.length === 0, errors };
128
+ }
129
+
130
+ /**
131
+ * Validates a complete USTF v1 session trajectory.
132
+ *
133
+ * @param {object} trajectory
134
+ * @returns {{ valid: boolean, errors: string[] }}
135
+ */
136
+ export function validateUstfTrajectory(trajectory) {
137
+ const errors = [];
138
+ if (!trajectory || typeof trajectory !== 'object' || Array.isArray(trajectory)) {
139
+ return { valid: false, errors: ['trajectory must be an object'] };
140
+ }
141
+
142
+ if (trajectory.$schema && trajectory.$schema !== USTF_SCHEMA_URI) {
143
+ errors.push(`$schema must be "${USTF_SCHEMA_URI}"`);
144
+ }
145
+ if (trajectory.version && trajectory.version !== USTF_SCHEMA_VERSION) {
146
+ errors.push(`version must be "${USTF_SCHEMA_VERSION}"`);
147
+ }
148
+ if (!trajectory.sessionId || typeof trajectory.sessionId !== 'string') {
149
+ errors.push('sessionId must be a non-empty string');
150
+ }
151
+ if (!trajectory.harness || !['antigravity', 'claude-code', 'cursor'].includes(trajectory.harness)) {
152
+ errors.push('harness must be "antigravity", "claude-code", or "cursor"');
153
+ }
154
+ if (!Array.isArray(trajectory.events)) {
155
+ errors.push('events must be an array');
156
+ } else {
157
+ for (let i = 0; i < trajectory.events.length; i++) {
158
+ const evCheck = validateUstfEvent(trajectory.events[i]);
159
+ if (!evCheck.valid) {
160
+ errors.push(`events[${i}]: ${evCheck.errors.join('; ')}`);
161
+ }
162
+ }
163
+ }
164
+
165
+ if (trajectory.spans !== undefined) {
166
+ if (!Array.isArray(trajectory.spans)) {
167
+ errors.push('spans must be an array');
168
+ } else {
169
+ for (let i = 0; i < trajectory.spans.length; i++) {
170
+ const spanCheck = validateUstfSpan(trajectory.spans[i]);
171
+ if (!spanCheck.valid) {
172
+ errors.push(`spans[${i}]: ${spanCheck.errors.join('; ')}`);
173
+ }
174
+ }
175
+ }
176
+ }
177
+
178
+ if (trajectory.usage) {
179
+ const usageCheck = validateUstfUsage(trajectory.usage);
180
+ if (!usageCheck.valid) {
181
+ errors.push(`usage: ${usageCheck.errors.join('; ')}`);
182
+ }
183
+ }
184
+
185
+ return { valid: errors.length === 0, errors };
186
+ }