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,547 @@
1
+ /**
2
+ * @file src/core/pro_license.mjs
3
+ * Highbeam Pro (`@ctxtop/pro`) — Zero-Network Offline Ed25519 License Verifier & Cross-Harness Entitlement Store.
4
+ *
5
+ * Uses Node.js built-in `node:crypto` Ed25519 signature verification (`CTXP1.<payloadB64Url>.<sigB64Url>`).
6
+ * Stores verified license state at `~/.ctxtop/license.json` shared across Google Antigravity and Claude Code.
7
+ */
8
+
9
+ import crypto from 'node:crypto';
10
+ import fs from 'node:fs';
11
+ import path from 'node:path';
12
+ import os from 'node:os';
13
+
14
+ /**
15
+ * Default embedded Ed25519 public key (SPKI PEM) for Polar.sh / `@ctxtop/pro` offline license verification.
16
+ * Can be overridden in tests or enterprise deployments via `options.publicKeyPem` or `CTXTOP_ED25519_PUBLIC_KEY_PEM`.
17
+ */
18
+ export const DEFAULT_PRO_PUBLIC_KEY_PEM = [
19
+ '-----BEGIN PUBLIC KEY-----',
20
+ 'MCowBQYDK2VwAyEAsKBx+VAPklTmfQPootRr8wzq4ZEDhEu9ImAI7Q4GMDM=',
21
+ '-----END PUBLIC KEY-----'
22
+ ].join('\n');
23
+
24
+ export const PRO_PRICING_TIERS = Object.freeze({
25
+ free: { id: 'free', label: 'Free Core (MIT)', priceUSD: 0, billing: 'forever' },
26
+ pro_monthly: { id: 'pro', label: 'Highbeam Pro (Monthly)', priceUSD: 15, priceRangeUSD: [12, 19], billing: 'month' },
27
+ pro_annual: { id: 'pro', label: 'Highbeam Pro (Annual)', priceUSD: 149, effectiveMonthlyUSD: 12.42, billing: 'year' },
28
+ pro_ltd: { id: 'ltd', label: 'Highbeam Pro (Founder Lifetime)', priceUSD: 199, billing: 'lifetime' },
29
+ team: { id: 'team', label: 'Highbeam Team (Annual 5-Seat Starter + OTel)', priceUSD: 299, seatMonthlyUSD: 39, billing: 'year' }
30
+ });
31
+
32
+ /**
33
+ * Three-Tier "Self-Expensing" PLG Funnel Matrix (VC Playbook Step 5).
34
+ */
35
+ export const PLG_TIER_MATRIX = Object.freeze({
36
+ free: Object.freeze({
37
+ id: 'free',
38
+ name: 'Free Tier (MIT Core + COACH Mode)',
39
+ priceMonthlyUSD: 0,
40
+ installCommand: 'npx ctxtop init',
41
+ features: Object.freeze([
42
+ 'Simple View HUD & 4-Rank Tufte Verdict Bar',
43
+ '40-Cell Parabolic U-Curve Context Map',
44
+ '5m/1h Live Prompt Cache TTL Countdown',
45
+ 'SQLite FTS5 CLI & Test Output Compression (PostToolUse)',
46
+ 'Automated PreToolUse Delta-Read & AST Signature Stub Interception (GUARD-4)',
47
+ 'HOLD_COMPACT Warm Cache Warning & 32 Auditable Guards (COACH Default)'
48
+ ])
49
+ }),
50
+ pro: Object.freeze({
51
+ id: 'pro',
52
+ name: 'Pro Tier (Self-Expensing Solo Developer)',
53
+ priceMonthlyUSD: 15,
54
+ priceRangeMonthlyUSD: Object.freeze([12, 19]),
55
+ features: Object.freeze([
56
+ 'AUTO_PILOT Hands-Free Enforcement & Horizon-Calibrated C_max Model Switch Hold',
57
+ 'Signed Corporate PDF 1.4 FinOps + GreenOps Expense Receipt (ctxtop receipt --pdf)',
58
+ 'Cross-Session Chronic Offender Memory & 30-Day Workspace Savings Ledger (#tufteBaselineStrip)',
59
+ '14-Day Zero-Network Local Trial'
60
+ ])
61
+ }),
62
+ team: Object.freeze({
63
+ id: 'team',
64
+ name: 'Team / Enterprise Tier (Zero-Cloud FinOps)',
65
+ pricePerSeatMonthlyUSD: 39,
66
+ features: Object.freeze([
67
+ 'Shared .agents/rules/ Primacy-Band Governance',
68
+ 'Sanitized Cross-Developer Bloat Analytics (/api/export/sanitized)',
69
+ 'Repo-Wide MCP Lazy-Loading Enforcement',
70
+ 'BYO-Grafana OpenTelemetry & Prometheus Alerting Pack (ctxtop team-pack)'
71
+ ])
72
+ })
73
+ });
74
+
75
+ export function resolveLicenseFilePath(options = {}) {
76
+ if (typeof options.licensePath === 'string' && options.licensePath.trim()) {
77
+ return path.resolve(options.licensePath.trim());
78
+ }
79
+ const homeDir = options.homeDir || process.env.USERPROFILE || process.env.HOME || os.homedir();
80
+ return path.join(homeDir, '.ctxtop', 'license.json');
81
+ }
82
+
83
+ /**
84
+ * Generates an Ed25519 keypair (PEM) for signing offline `CTXP1` Pro license keys.
85
+ */
86
+ export function generateProKeyPair() {
87
+ const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519', {
88
+ publicKeyEncoding: { type: 'spki', format: 'pem' },
89
+ privateKeyEncoding: { type: 'pkcs8', format: 'pem' }
90
+ });
91
+ return { publicKeyPem: publicKey, privateKeyPem: privateKey };
92
+ }
93
+
94
+ /**
95
+ * Signs a Pro license payload using an Ed25519 private key PEM and returns a `CTXP1.<payload>.<sig>` string.
96
+ *
97
+ * @param {object} payload
98
+ * @param {string} privateKeyPem
99
+ * @returns {string}
100
+ */
101
+ export function signProLicensePayload(payload = {}, privateKeyPem = '') {
102
+ if (!privateKeyPem) {
103
+ throw new Error('signProLicensePayload requires an Ed25519 privateKeyPem');
104
+ }
105
+ const nowIso = new Date().toISOString();
106
+ const normalizedPayload = {
107
+ v: 1,
108
+ tier: payload.tier || 'pro',
109
+ email: payload.email || 'developer@local',
110
+ seats: Number(payload.seats || 1),
111
+ issuedAt: payload.issuedAt || nowIso,
112
+ expiresAt: payload.expiresAt || null,
113
+ source: payload.source || 'polar.sh',
114
+ features: Array.isArray(payload.features)
115
+ ? payload.features
116
+ : ['auto_pilot_locks', 'cross_harness_scope_locks', 'corporate_expense_receipts', 'otel_team_bundle']
117
+ };
118
+ const payloadB64 = Buffer.from(JSON.stringify(normalizedPayload), 'utf8').toString('base64url');
119
+ const sigBuf = crypto.sign(null, Buffer.from(payloadB64, 'utf8'), privateKeyPem);
120
+ const sigB64 = sigBuf.toString('base64url');
121
+ return `CTXP1.${payloadB64}.${sigB64}`;
122
+ }
123
+
124
+ /**
125
+ * Strictly verifies a `CTXP1.<payloadB64Url>.<sigB64Url>` license key offline via `node:crypto` Ed25519.
126
+ *
127
+ * @param {string} licenseKey
128
+ * @param {object} [options={}]
129
+ * @returns {{ valid: boolean, reason: string | null, payload: object | null }}
130
+ */
131
+ export function verifyProLicenseKey(licenseKey = '', options = {}) {
132
+ const raw = String(licenseKey || '').trim();
133
+ if (!raw) {
134
+ return { valid: false, reason: 'EMPTY_KEY', payload: null };
135
+ }
136
+ const parts = raw.split('.');
137
+ if (parts.length !== 3 || parts[0] !== 'CTXP1') {
138
+ return { valid: false, reason: 'INVALID_FORMAT', payload: null };
139
+ }
140
+ const [, payloadB64, sigB64] = parts;
141
+ if (!payloadB64 || !sigB64) {
142
+ return { valid: false, reason: 'MALFORMED_SEGMENTS', payload: null };
143
+ }
144
+
145
+ const publicKeyPem =
146
+ options.publicKeyPem ||
147
+ process.env.CTXTOP_ED25519_PUBLIC_KEY_PEM ||
148
+ DEFAULT_PRO_PUBLIC_KEY_PEM;
149
+
150
+ try {
151
+ const isVerified = crypto.verify(
152
+ null,
153
+ Buffer.from(payloadB64, 'utf8'),
154
+ publicKeyPem,
155
+ Buffer.from(sigB64, 'base64url')
156
+ );
157
+ if (!isVerified) {
158
+ return { valid: false, reason: 'INVALID_SIGNATURE', payload: null };
159
+ }
160
+ } catch (err) {
161
+ return { valid: false, reason: `CRYPTO_VERIFY_ERROR: ${err.message}`, payload: null };
162
+ }
163
+
164
+ let payload = null;
165
+ try {
166
+ payload = JSON.parse(Buffer.from(payloadB64, 'base64url').toString('utf8'));
167
+ } catch {
168
+ return { valid: false, reason: 'INVALID_PAYLOAD_JSON', payload: null };
169
+ }
170
+
171
+ const nowMs = Number(options.nowMs || Date.now());
172
+ if (payload.expiresAt) {
173
+ const expMs = Date.parse(payload.expiresAt);
174
+ if (Number.isFinite(expMs) && nowMs > expMs) {
175
+ return { valid: false, reason: 'LICENSE_EXPIRED', payload };
176
+ }
177
+ }
178
+
179
+ return { valid: true, reason: null, payload };
180
+ }
181
+
182
+ /**
183
+ * Activates and persists a verified `CTXP1` license key into `~/.ctxtop/license.json`.
184
+ */
185
+ export function activateProLicense(licenseKey = '', options = {}) {
186
+ const check = verifyProLicenseKey(licenseKey, options);
187
+ if (!check.valid) {
188
+ return { ok: false, ...check, licensePath: resolveLicenseFilePath(options) };
189
+ }
190
+ const licensePath = resolveLicenseFilePath(options);
191
+ fs.mkdirSync(path.dirname(licensePath), { recursive: true });
192
+ const record = {
193
+ version: 1,
194
+ licenseKey: String(licenseKey).trim(),
195
+ activatedAt: new Date(options.nowMs || Date.now()).toISOString(),
196
+ payload: check.payload
197
+ };
198
+ fs.writeFileSync(licensePath, JSON.stringify(record, null, 2) + '\n', 'utf8');
199
+ return {
200
+ ok: true,
201
+ valid: true,
202
+ tier: check.payload.tier || 'pro',
203
+ payload: check.payload,
204
+ licensePath
205
+ };
206
+ }
207
+
208
+ /**
209
+ * Starts a 14-day zero-network local trial stored in `~/.ctxtop/license.json`.
210
+ */
211
+ export function activateLocalTrial(options = {}) {
212
+ const licensePath = resolveLicenseFilePath(options);
213
+ const nowMs = Number(options.nowMs || Date.now());
214
+
215
+ if (fs.existsSync(licensePath)) {
216
+ try {
217
+ const stored = JSON.parse(fs.readFileSync(licensePath, 'utf8'));
218
+ if (stored?.licenseKey) {
219
+ const verified = verifyProLicenseKey(stored.licenseKey, options);
220
+ if (verified.valid) {
221
+ return {
222
+ ok: true,
223
+ tier: verified.payload.tier || 'pro',
224
+ alreadyLicensed: true,
225
+ expiresAt: verified.payload.expiresAt || null,
226
+ licensePath
227
+ };
228
+ }
229
+ }
230
+ if (stored?.trial && stored?.expiresAt && !options.forceResetTrial) {
231
+ const prevExpMs = Date.parse(stored.expiresAt);
232
+ if (Number.isFinite(prevExpMs) && nowMs > prevExpMs) {
233
+ return {
234
+ ok: false,
235
+ alreadyUsed: true,
236
+ trialExpired: true,
237
+ reason: 'TRIAL_ALREADY_EXPIRED',
238
+ expiresAt: stored.expiresAt,
239
+ licensePath
240
+ };
241
+ }
242
+ if (Number.isFinite(prevExpMs) && nowMs <= prevExpMs) {
243
+ return {
244
+ ok: true,
245
+ tier: 'trial',
246
+ alreadyActive: true,
247
+ expiresAt: stored.expiresAt,
248
+ licensePath
249
+ };
250
+ }
251
+ }
252
+ } catch (_err) {
253
+ void _err;
254
+ }
255
+ }
256
+
257
+ const expiresAt = new Date(nowMs + 14 * 86400 * 1000).toISOString();
258
+ fs.mkdirSync(path.dirname(licensePath), { recursive: true });
259
+ const record = {
260
+ version: 1,
261
+ trial: true,
262
+ activatedAt: new Date(nowMs).toISOString(),
263
+ expiresAt,
264
+ payload: {
265
+ v: 1,
266
+ tier: 'trial',
267
+ email: 'trial@local',
268
+ seats: 1,
269
+ issuedAt: new Date(nowMs).toISOString(),
270
+ expiresAt,
271
+ source: 'local_trial'
272
+ }
273
+ };
274
+ fs.writeFileSync(licensePath, JSON.stringify(record, null, 2) + '\n', 'utf8');
275
+ return {
276
+ ok: true,
277
+ tier: 'trial',
278
+ expiresAt,
279
+ licensePath
280
+ };
281
+ }
282
+
283
+ export function deactivateProLicense(options = {}) {
284
+ const licensePath = resolveLicenseFilePath(options);
285
+ const existed = fs.existsSync(licensePath);
286
+ if (existed) {
287
+ try {
288
+ fs.unlinkSync(licensePath);
289
+ } catch (_err) {
290
+ void _err;
291
+ }
292
+ }
293
+ return { ok: true, removed: existed, licensePath };
294
+ }
295
+
296
+ /**
297
+ * Evaluates current Pro entitlement across both Antigravity and Claude Code.
298
+ * Supports automatic dev/test bypass unless `options.strict === true`.
299
+ */
300
+ export function getProEntitlementStatus(options = {}) {
301
+ const licensePath = resolveLicenseFilePath(options);
302
+ const nowMs = Number(options.nowMs || Date.now());
303
+ const isDevOrTest =
304
+ !options.strict &&
305
+ Boolean(
306
+ process.env.CTXTOP_PRO_DEV === '1' ||
307
+ process.env.NODE_ENV === 'test' ||
308
+ process.env.NODE_TEST_CONTEXT ||
309
+ process.execArgv?.includes('--test')
310
+ );
311
+
312
+ if (isDevOrTest && !options.licensePath) {
313
+ return {
314
+ entitled: true,
315
+ tier: 'pro_dev_bypass',
316
+ source: 'dev_or_test_bypass',
317
+ isDevOrTestBypass: true,
318
+ licensePath,
319
+ pricing: PRO_PRICING_TIERS
320
+ };
321
+ }
322
+
323
+ if (fs.existsSync(licensePath)) {
324
+ try {
325
+ const stored = JSON.parse(fs.readFileSync(licensePath, 'utf8'));
326
+ if (stored.licenseKey) {
327
+ const verified = verifyProLicenseKey(stored.licenseKey, options);
328
+ if (verified.valid) {
329
+ return {
330
+ entitled: true,
331
+ tier: verified.payload.tier || 'pro',
332
+ source: 'ed25519_license',
333
+ email: verified.payload.email || null,
334
+ expiresAt: verified.payload.expiresAt || null,
335
+ licensePath,
336
+ pricing: PRO_PRICING_TIERS
337
+ };
338
+ }
339
+ return {
340
+ entitled: false,
341
+ tier: 'free',
342
+ source: 'invalid_or_expired_license',
343
+ reason: verified.reason,
344
+ licensePath,
345
+ pricing: PRO_PRICING_TIERS
346
+ };
347
+ }
348
+ if (stored.trial && stored.expiresAt) {
349
+ const expMs = Date.parse(stored.expiresAt);
350
+ if (Number.isFinite(expMs) && nowMs <= expMs) {
351
+ return {
352
+ entitled: true,
353
+ tier: 'trial',
354
+ source: 'local_trial',
355
+ expiresAt: stored.expiresAt,
356
+ daysRemaining: Math.max(1, Math.ceil((expMs - nowMs) / 86400000)),
357
+ licensePath,
358
+ pricing: PRO_PRICING_TIERS
359
+ };
360
+ }
361
+ if (Number.isFinite(expMs) && nowMs > expMs && !isDevOrTest) {
362
+ return {
363
+ entitled: false,
364
+ tier: 'free',
365
+ source: 'expired_trial',
366
+ trialExpired: true,
367
+ trialActivatedAt: stored.activatedAt || null,
368
+ expiresAt: stored.expiresAt,
369
+ licensePath,
370
+ pricing: PRO_PRICING_TIERS
371
+ };
372
+ }
373
+ }
374
+ } catch (_err) {
375
+ void _err;
376
+ }
377
+ }
378
+
379
+ if (isDevOrTest) {
380
+ return {
381
+ entitled: true,
382
+ tier: 'pro_dev_bypass',
383
+ source: 'dev_or_test_bypass',
384
+ isDevOrTestBypass: true,
385
+ licensePath,
386
+ pricing: PRO_PRICING_TIERS
387
+ };
388
+ }
389
+
390
+ return {
391
+ entitled: false,
392
+ tier: 'free',
393
+ source: 'free_core',
394
+ licensePath,
395
+ pricing: PRO_PRICING_TIERS
396
+ };
397
+ }
398
+
399
+ /**
400
+ * Evaluates whether a specific commercial Pro or Team feature is permitted.
401
+ * Preserves automatic dev/test bypass unless `options.strict === true`.
402
+ *
403
+ * @param {string} [featureId='pro_feature']
404
+ * @param {object} [options={}]
405
+ */
406
+ export function requireProFeature(featureId = 'pro_feature', options = {}) {
407
+ const status = getProEntitlementStatus(options);
408
+ const needsTeamTier = featureId === 'team_finops_pack';
409
+ const isDevOrTest =
410
+ !options.strict &&
411
+ Boolean(
412
+ process.env.CTXTOP_PRO_DEV === '1' ||
413
+ process.env.NODE_ENV === 'test' ||
414
+ process.env.NODE_TEST_CONTEXT ||
415
+ process.execArgv?.includes('--test')
416
+ );
417
+
418
+ const allowed = needsTeamTier
419
+ ? Boolean(
420
+ isDevOrTest ||
421
+ (status.entitled &&
422
+ (status.tier === 'team' ||
423
+ status.tier === 'trial' ||
424
+ status.tier === 'pro_dev_bypass' ||
425
+ status.tier === 'ltd'))
426
+ )
427
+ : Boolean(status.entitled);
428
+
429
+ return {
430
+ allowed,
431
+ featureId,
432
+ entitled: status.entitled,
433
+ tier: status.tier,
434
+ source: status.source,
435
+ status,
436
+ upgradeHint: needsTeamTier
437
+ ? 'Requires Highbeam Team ($299/yr for 5 seats — Commercial License: packages/pro/LICENSE-COMMERCIAL.md) or an active 14-day trial (`npx ctxtop license trial`).'
438
+ : 'Requires Highbeam Pro ($15/mo · $149/yr · $199 LTD — Commercial License: packages/pro/LICENSE-COMMERCIAL.md) or an active 14-day trial (`npx ctxtop license trial`).'
439
+ };
440
+ }
441
+
442
+ /**
443
+ * Provisions a one-time 14-day Reverse Trial for brand-new Free users without
444
+ * overwriting paid licenses or reviving expired trials.
445
+ *
446
+ * @param {object} [options={}]
447
+ */
448
+ export function ensureReverseTrialProvisioned(options = {}) {
449
+ const isTestEnv = Boolean(
450
+ process.env.NODE_ENV === 'test' ||
451
+ process.env.NODE_TEST_CONTEXT ||
452
+ process.execArgv?.includes('--test')
453
+ );
454
+ if (
455
+ isTestEnv &&
456
+ !options.licensePath &&
457
+ !options.homeDir &&
458
+ !options.allowTestHomeWrite
459
+ ) {
460
+ return {
461
+ ok: true,
462
+ provisioned: false,
463
+ steppedDownToCoach: false,
464
+ skippedTestEnv: true,
465
+ status: getProEntitlementStatus(options)
466
+ };
467
+ }
468
+
469
+ const strictOpts = { ...options, strict: true };
470
+ const current = getProEntitlementStatus(strictOpts);
471
+ if (current.entitled) {
472
+ return {
473
+ ok: true,
474
+ provisioned: false,
475
+ steppedDownToCoach: false,
476
+ status: current
477
+ };
478
+ }
479
+ if (current.trialExpired || current.source === 'invalid_or_expired_license') {
480
+ return {
481
+ ok: false,
482
+ provisioned: false,
483
+ steppedDownToCoach: true,
484
+ reason: current.trialExpired ? 'TRIAL_EXPIRED' : (current.reason || 'PRO_REQUIRED'),
485
+ status: current
486
+ };
487
+ }
488
+
489
+ const trialRes = activateLocalTrial(strictOpts);
490
+ if (!trialRes.ok) {
491
+ return {
492
+ ok: false,
493
+ provisioned: false,
494
+ steppedDownToCoach: true,
495
+ reason: trialRes.reason || 'PRO_REQUIRED',
496
+ status: getProEntitlementStatus(strictOpts)
497
+ };
498
+ }
499
+
500
+ return {
501
+ ok: true,
502
+ provisioned: true,
503
+ steppedDownToCoach: false,
504
+ status: getProEntitlementStatus(strictOpts)
505
+ };
506
+ }
507
+
508
+ /**
509
+ * Resolves effective flightMode across Antigravity and Claude Code, stepping
510
+ * `AUTO_PILOT` down to `COACH` when Pro / Reverse Trial entitlement is absent.
511
+ *
512
+ * @param {string} [rawFlightMode='COACH']
513
+ * @param {object} [options={}]
514
+ */
515
+ export function resolveEffectiveAutoFlightMode(rawFlightMode = 'COACH', options = {}) {
516
+ const upper = String(rawFlightMode || 'COACH').trim().toUpperCase();
517
+ let normalized = 'COACH';
518
+ if (upper === 'AUTO_PILOT' || upper === 'AUTOPILOT' || upper === 'AUTO' || upper === 'AUTO-PILOT') {
519
+ normalized = 'AUTO_PILOT';
520
+ } else if (upper === 'OFF' || upper === 'DISABLED') {
521
+ normalized = 'OFF';
522
+ } else if (upper === 'SILENT') {
523
+ normalized = 'SILENT';
524
+ }
525
+
526
+ if (normalized === 'AUTO_PILOT') {
527
+ const check = requireProFeature('auto_pilot_locks', options);
528
+ if (!check.allowed) {
529
+ return {
530
+ effectiveFlightMode: 'COACH',
531
+ steppedDown: true,
532
+ proStatus: check.status
533
+ };
534
+ }
535
+ return {
536
+ effectiveFlightMode: 'AUTO_PILOT',
537
+ steppedDown: false,
538
+ proStatus: check.status
539
+ };
540
+ }
541
+
542
+ return {
543
+ effectiveFlightMode: normalized,
544
+ steppedDown: false,
545
+ proStatus: null
546
+ };
547
+ }