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
@@ -3,12 +3,31 @@
3
3
  * Tier 2 Command Hook handler for `PreModelSwitch` (`DET-08` Warm KV-Cache Cross-Model Switch Guard).
4
4
  */
5
5
 
6
+ import { fs, path, os, readJsonSafe, writeJsonAtomic } from '../../src/utils/nodeIo.mjs';
7
+ import {
8
+ DEFAULT_RPT_SHRINKAGE_PRIOR,
9
+ isRealHumanUserTranscriptEntry,
10
+ readSessionCalibration,
11
+ shrinkRollingOutputEstimate,
12
+ shrinkRollingRequestsPerTurn,
13
+ computeRollingMedianFloat
14
+ } from '../../src/utils/sessionCalibration.mjs';
6
15
  import { readLiveStateSnapshot } from '../../src/core-isomorphic/telemetry/telemetryBridge.mjs';
7
- import { computeTotalPromptTokens } from '../../src/core-isomorphic/config/catalogLoader.mjs';
16
+ import {
17
+ computeTotalPromptTokens,
18
+ isKnownCatalogModel,
19
+ normalizeModelId
20
+ } from '../../src/core-isomorphic/config/catalogLoader.mjs';
21
+ import {
22
+ readBreakerStateSnapshot,
23
+ writeBreakerStateSnapshot
24
+ } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
8
25
  import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
9
26
  import { CacheGravityRouter } from '../../src/core-isomorphic/coach/cacheGravityRouter.mjs';
10
27
  import { recordInterventionSavings } from '../../src/core-isomorphic/coach/savedQuotaLedger.mjs';
11
28
  import { requireProFeature } from '../../src/core/pro_license.mjs';
29
+ import { recordShadowAutoMiss } from '../../src/core/shadow_auto_ledger.mjs';
30
+ import { recordPreModelSwitchEvent } from '../../src/utils/modelSwitchTelemetry.mjs';
12
31
  import {
13
32
  isCliEntrypoint,
14
33
  readStdinJsonAsync,
@@ -17,6 +36,213 @@ import {
17
36
  exitWithStdoutJson
18
37
  } from './hookIo.mjs';
19
38
 
39
+ const PRIOR_CACHE_TTL_MS = 3_600_000;
40
+
41
+ export const MIN_LOCAL_RPT_PRIOR_SESSIONS = 3;
42
+
43
+ function isExcludedBenchmarkTranscript(filePath = '', content = '') {
44
+ const normPath = String(filePath || '').replace(/\\/g, '/').toLowerCase();
45
+ if (
46
+ normPath.includes('model-switch-benchmark') ||
47
+ normPath.includes('smart-compact') ||
48
+ normPath.includes('e2e_harness') ||
49
+ normPath.includes('ctxtop-model-switch')
50
+ ) {
51
+ return true;
52
+ }
53
+ if (typeof content === 'string' && content.includes('Benchmark-Run-Salt:')) {
54
+ return true;
55
+ }
56
+ return false;
57
+ }
58
+
59
+ /**
60
+ * Samples recent local Claude Code session assistant-turn counts and requests/turn (read-only,
61
+ * bounded to 50 files, deduplicated by `message.id`, 1h disk cache under
62
+ * `~/.attention-horizon/cache/ah_session_prior.json`).
63
+ * Excludes the current session (`excludeSessionId` / `excludeTranscriptPath`) and benchmark/harness
64
+ * transcripts (`excludeBenchmarkSessions !== false`), requiring `>= 3` qualifying sessions for
65
+ * `medianRequestsPerTurn`.
66
+ *
67
+ * @param {object} [options={}]
68
+ * @returns {{ apiCounts: number[], medianRequestsPerTurn: number | null, sessionCount: number } | null}
69
+ */
70
+ export function loadLocalClaudeSessionPriors(options = {}) {
71
+ if (Array.isArray(options.historicalSessionApiCalls)) {
72
+ return {
73
+ apiCounts: options.historicalSessionApiCalls,
74
+ medianRequestsPerTurn:
75
+ Number.isFinite(Number(options.historicalSessionRequestsPerTurn))
76
+ ? Number(options.historicalSessionRequestsPerTurn)
77
+ : null,
78
+ sessionCount: options.historicalSessionApiCalls.length
79
+ };
80
+ }
81
+ const home =
82
+ options.homeDir ||
83
+ globalThis.process?.env?.HOME ||
84
+ globalThis.process?.env?.USERPROFILE ||
85
+ os.homedir();
86
+ const cachePath = path.join(home, '.attention-horizon', 'cache', 'ah_session_prior.json');
87
+ const nowMs = Number.isFinite(Number(options.nowMs)) ? Number(options.nowMs) : Date.now();
88
+ const excludeSessionId =
89
+ options.excludeSessionId && options.excludeSessionId !== 'default'
90
+ ? String(options.excludeSessionId).trim()
91
+ : null;
92
+ const excludeTranscriptPathNorm = options.excludeTranscriptPath
93
+ ? path.resolve(String(options.excludeTranscriptPath)).replace(/\\/g, '/').toLowerCase()
94
+ : null;
95
+ const excludeBenchmarks = options.excludeBenchmarkSessions !== false;
96
+
97
+ const cached = readJsonSafe(cachePath, null, options);
98
+ if (
99
+ cached &&
100
+ Array.isArray(cached.sessions) &&
101
+ Number.isFinite(cached.sampledAtMs) &&
102
+ nowMs - cached.sampledAtMs < PRIOR_CACHE_TTL_MS
103
+ ) {
104
+ const filtered = cached.sessions.filter((s) => {
105
+ if (excludeSessionId && s.sessionId === excludeSessionId) return false;
106
+ if (excludeTranscriptPathNorm && s.normPath === excludeTranscriptPathNorm) return false;
107
+ if (excludeBenchmarks && s.isBenchmark) return false;
108
+ return true;
109
+ });
110
+ if (filtered.length >= 1) {
111
+ const apiCounts = filtered.map((s) => s.assistantTurns);
112
+ const rpts = filtered.map((s) => s.rpt).filter((r) => Number.isFinite(r) && r >= 1);
113
+ return {
114
+ apiCounts,
115
+ medianRequestsPerTurn:
116
+ rpts.length >= MIN_LOCAL_RPT_PRIOR_SESSIONS
117
+ ? computeRollingMedianFloat(rpts, rpts.length)
118
+ : null,
119
+ sessionCount: apiCounts.length
120
+ };
121
+ }
122
+ return null;
123
+ }
124
+
125
+ try {
126
+ const ccProjects = path.join(home, '.claude', 'projects');
127
+ if (!fs.existsSync(ccProjects)) return null;
128
+
129
+ const jsonlFiles = [];
130
+ const queue = [ccProjects];
131
+ while (queue.length > 0 && jsonlFiles.length < 150) {
132
+ const dir = queue.shift();
133
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
134
+ const full = path.join(dir, entry.name);
135
+ if (entry.isDirectory()) {
136
+ if (entry.name !== 'subagents') queue.push(full);
137
+ } else if (entry.name.endsWith('.jsonl')) {
138
+ const st = fs.statSync(full);
139
+ if (st.size >= 512 && st.size <= 5_000_000) {
140
+ jsonlFiles.push({ path: full, mtimeMs: st.mtimeMs });
141
+ }
142
+ }
143
+ }
144
+ }
145
+ jsonlFiles.sort((a, b) => b.mtimeMs - a.mtimeMs);
146
+ const allSessions = [];
147
+ for (const item of jsonlFiles.slice(0, 50)) {
148
+ let fd = null;
149
+ try {
150
+ const normPath = path.resolve(item.path).replace(/\\/g, '/').toLowerCase();
151
+ const fileSessionId = path.basename(item.path, '.jsonl');
152
+ fd = fs.openSync(item.path, 'r');
153
+ const txt = fs.readFileSync(fd, 'utf8');
154
+ const isBenchmark = isExcludedBenchmarkTranscript(item.path, txt);
155
+ const assistantMsgIds = new Set();
156
+ let humanTurnCount = 0;
157
+ let idx = 0;
158
+ for (const line of txt.split(/\r?\n/)) {
159
+ idx += 1;
160
+ if (!line.includes('"assistant"') && !line.includes('"user"')) continue;
161
+ try {
162
+ const obj = JSON.parse(line);
163
+ if (isRealHumanUserTranscriptEntry(obj)) {
164
+ humanTurnCount += 1;
165
+ } else if (obj?.type === 'assistant') {
166
+ assistantMsgIds.add(obj?.message?.id || `line_${idx}`);
167
+ }
168
+ } catch {
169
+ if (line.includes('"type":"assistant"')) assistantMsgIds.add(`raw_${idx}`);
170
+ }
171
+ }
172
+ const assistantTurns = assistantMsgIds.size;
173
+ if (assistantTurns >= 2) {
174
+ const rpt =
175
+ humanTurnCount >= 1
176
+ ? Math.max(1, Number((assistantTurns / humanTurnCount).toFixed(4)))
177
+ : null;
178
+ allSessions.push({
179
+ sessionId: fileSessionId,
180
+ normPath,
181
+ isBenchmark,
182
+ assistantTurns,
183
+ rpt
184
+ });
185
+ }
186
+ } catch {
187
+ // Ignore unreadable session file
188
+ } finally {
189
+ if (fd !== null) {
190
+ try {
191
+ fs.closeSync(fd);
192
+ } catch {
193
+ // Ignore close failure
194
+ }
195
+ }
196
+ }
197
+ }
198
+ const filtered = allSessions.filter((s) => {
199
+ if (excludeSessionId && s.sessionId === excludeSessionId) return false;
200
+ if (excludeTranscriptPathNorm && s.normPath === excludeTranscriptPathNorm) return false;
201
+ if (excludeBenchmarks && s.isBenchmark) return false;
202
+ return true;
203
+ });
204
+ const apiCounts = filtered.map((s) => s.assistantTurns);
205
+ const sessionRpts = filtered.map((s) => s.rpt).filter((r) => Number.isFinite(r) && r >= 1);
206
+ const medianRequestsPerTurn =
207
+ sessionRpts.length >= MIN_LOCAL_RPT_PRIOR_SESSIONS
208
+ ? computeRollingMedianFloat(sessionRpts, sessionRpts.length)
209
+ : null;
210
+ if (allSessions.length >= 1) {
211
+ writeJsonAtomic(
212
+ cachePath,
213
+ {
214
+ sampledAtMs: nowMs,
215
+ sessions: allSessions,
216
+ apiCounts,
217
+ medianRequestsPerTurn,
218
+ sessionCount: apiCounts.length
219
+ },
220
+ options
221
+ );
222
+ }
223
+ if (apiCounts.length >= 1) {
224
+ return { apiCounts, medianRequestsPerTurn, sessionCount: apiCounts.length };
225
+ }
226
+ } catch {
227
+ // Fallback to built-in 496-session prior
228
+ }
229
+ return null;
230
+ }
231
+
232
+ /**
233
+ * Backward-compatible accessor returning `apiCounts` once >= 5 local sessions exist
234
+ * (or any explicit `options.historicalSessionApiCalls` override).
235
+ * @param {object} [options={}]
236
+ * @returns {number[] | null}
237
+ */
238
+ export function loadLocalClaudeSessionApiCalls(options = {}) {
239
+ if (Array.isArray(options.historicalSessionApiCalls)) {
240
+ return options.historicalSessionApiCalls;
241
+ }
242
+ const priors = loadLocalClaudeSessionPriors(options);
243
+ return Array.isArray(priors?.apiCounts) && priors.apiCounts.length >= 5 ? priors.apiCounts : null;
244
+ }
245
+
20
246
  /**
21
247
  * Evaluates a `PreModelSwitch` event against `CacheGravityRouter` break-even threshold `C*`.
22
248
  * @param {object} event
@@ -61,31 +287,135 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
61
287
  const effectiveMode =
62
288
  rawEffectiveMode === 'AUTO_PILOT' && !proAutoPilot.allowed ? 'COACH' : rawEffectiveMode;
63
289
 
290
+ const rawRemainingTurns =
291
+ event.expected_remaining_turns ??
292
+ event.expectedRemainingTurns ??
293
+ options.expectedRemainingTurns ??
294
+ horizonConfig?.expectedRemainingTurns;
295
+ const useEmpiricalHorizonPrior = Boolean(
296
+ event.use_empirical_horizon_prior ??
297
+ event.useEmpiricalHorizonPrior ??
298
+ options.useEmpiricalHorizonPrior ??
299
+ horizonConfig?.useEmpiricalHorizonPrior
300
+ );
301
+ const sessionCal =
302
+ options.useSessionCalibration === false
303
+ ? null
304
+ : readSessionCalibration(sessionId, event, cwdOptions);
305
+ const turnsCompleted = Number(
306
+ event.current_turn ??
307
+ event.currentTurn ??
308
+ (sessionCal?.turnsCompleted > 0 ? sessionCal.turnsCompleted : undefined) ??
309
+ liveState?.turnsCompleted ??
310
+ 0
311
+ );
312
+ const localPriorsOptions = {
313
+ ...cwdOptions,
314
+ excludeSessionId: sessionId,
315
+ excludeTranscriptPath:
316
+ event.transcript_path || event.transcriptPath || sessionCal?.transcriptPath || null
317
+ };
318
+ const localPriors =
319
+ options.useLocalRptPrior !== false &&
320
+ (options.homeDir ||
321
+ options.cliInvocation ||
322
+ options.useLocalRptPrior === true ||
323
+ useEmpiricalHorizonPrior ||
324
+ Boolean(sessionCal))
325
+ ? loadLocalClaudeSessionPriors(localPriorsOptions)
326
+ : null;
327
+ const localSurvivalApiCalls =
328
+ localPriors && Array.isArray(localPriors.apiCounts) && localPriors.apiCounts.length >= 5
329
+ ? localPriors.apiCounts
330
+ : null;
331
+ const historicalSessionApiCalls =
332
+ useEmpiricalHorizonPrior && (rawRemainingTurns === undefined || rawRemainingTurns === null)
333
+ ? (localSurvivalApiCalls ?? loadLocalClaudeSessionApiCalls(localPriorsOptions))
334
+ : options.historicalSessionApiCalls;
335
+
64
336
  const router =
65
337
  options.router ||
66
338
  new CacheGravityRouter({
67
339
  ...cwdOptions,
340
+ ...(historicalSessionApiCalls ? { historicalSessionApiCalls } : {}),
68
341
  mode: effectiveMode,
69
342
  strictBlock:
70
343
  det08Override === 'block' ? true : (event.strictBlock ?? options.strictBlock)
71
344
  });
72
345
 
346
+ const shouldPersistBreaker =
347
+ options.persistState !== false &&
348
+ Boolean(
349
+ options.persistState === true ||
350
+ options.cliInvocation ||
351
+ options.breakerStatePath ||
352
+ event.persistState ||
353
+ event.cwd
354
+ );
355
+ const breakerSnap = shouldPersistBreaker
356
+ ? readBreakerStateSnapshot(sessionId, cwdOptions)
357
+ : null;
358
+ const justCompacted = Boolean(
359
+ event.just_compacted ?? event.justCompacted ?? breakerSnap?.justCompacted
360
+ );
361
+
73
362
  const currentModel =
74
- event.current_model || event.currentModel || liveState.modelId || 'claude-opus-5-5';
363
+ event.current_model ||
364
+ event.currentModel ||
365
+ event.from_model ||
366
+ event.fromModel ||
367
+ liveState.modelId ||
368
+ 'claude-opus-5-5';
75
369
  const targetModel =
76
- event.target_model || event.targetModel || event.model || 'claude-sonnet-5-5';
77
- const cachedTokens = Number(
370
+ event.target_model ||
371
+ event.targetModel ||
372
+ event.to_model ||
373
+ event.toModel ||
374
+ event.requested_model ||
375
+ event.requestedModel ||
376
+ event.model ||
377
+ 'claude-sonnet-5-5';
378
+ const explicitCachedTokens =
78
379
  event.cached_tokens ??
79
- event.cachedTokens ??
80
- liveState.contextWindow?.cachedTokens ??
81
- 0
380
+ event.cachedTokens ??
381
+ event.context_tokens ??
382
+ event.contextTokens;
383
+ const cachedTokens = Number(
384
+ explicitCachedTokens ??
385
+ (justCompacted
386
+ ? (liveState.contextWindow?.cacheReadTokens ?? liveState.contextWindow?.cachedTokens ?? 0)
387
+ : (liveState.contextWindow?.cachedTokens ?? 0))
388
+ );
389
+ const explicitUncachedWrite =
390
+ event.uncached_write_tokens ?? event.uncachedWriteTokens;
391
+ const uncachedWriteTokens = Math.max(
392
+ 0,
393
+ Number(
394
+ explicitUncachedWrite ??
395
+ (justCompacted ? (liveState.contextWindow?.cacheCreationTokens ?? 0) : 0)
396
+ )
82
397
  );
398
+ const nowMs = Number.isFinite(Number(options.nowMs)) ? Number(options.nowMs) : Date.now();
399
+ const rawExpiresAt = liveState?.promptCache?.expiresAt;
400
+ const liveCacheExpired =
401
+ rawExpiresAt !== null &&
402
+ rawExpiresAt !== undefined &&
403
+ Number.isFinite(Number(rawExpiresAt)) &&
404
+ Number(rawExpiresAt) > 0 &&
405
+ nowMs >= Number(rawExpiresAt);
406
+ const explicitCacheWarm =
407
+ event.cache_warm ??
408
+ event.cacheWarm ??
409
+ event.prompt_cache_warm ??
410
+ event.promptCacheWarm;
83
411
  const cacheWarm =
84
- event.cache_warm !== undefined
85
- ? Boolean(event.cache_warm)
86
- : event.cacheWarm !== undefined
87
- ? Boolean(event.cacheWarm)
88
- : Boolean(liveState.promptCache?.warm);
412
+ explicitCacheWarm !== undefined
413
+ ? Boolean(explicitCacheWarm)
414
+ : liveCacheExpired
415
+ ? false
416
+ : justCompacted && cachedTokens === 0
417
+ ? false
418
+ : Boolean(liveState.promptCache?.warm);
89
419
 
90
420
  const uncachedDeltaTokens = Number(
91
421
  event.uncached_delta_tokens ?? event.uncachedDeltaTokens ?? 0
@@ -93,6 +423,8 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
93
423
  const rawTier =
94
424
  event.cache_ttl_tier ??
95
425
  event.cacheTtlTier ??
426
+ event.cache_ttl ??
427
+ event.cacheTtl ??
96
428
  event.prompt_cache?.ttl ??
97
429
  liveState.promptCache?.ttlTier ??
98
430
  '5m';
@@ -101,23 +433,304 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
101
433
  const usageSource =
102
434
  event.usage || event.context_window?.current_usage || liveState.contextWindow || {};
103
435
  const totalPromptTokens = Math.max(
104
- cachedTokens + uncachedDeltaTokens,
436
+ cachedTokens + uncachedDeltaTokens + uncachedWriteTokens,
105
437
  computeTotalPromptTokens(event),
106
438
  computeTotalPromptTokens(usageSource)
107
439
  );
108
440
 
441
+ const isNativePreModelSwitch = Boolean(
442
+ event.hook_event_name === 'PreModelSwitch' ||
443
+ event.from_model !== undefined ||
444
+ event.to_model !== undefined ||
445
+ event.fromModel !== undefined ||
446
+ event.toModel !== undefined ||
447
+ options.nativeHook === true
448
+ );
449
+ const resolvedAutoPilotDecision =
450
+ det08Override === 'block'
451
+ ? 'deny'
452
+ : (event.autoPilotDecision ??
453
+ options.autoPilotDecision ??
454
+ horizonConfig?.autoPilotDecision ??
455
+ (isNativePreModelSwitch ? 'ask' : 'deny'));
456
+
457
+ const apiCallsCompletedRaw =
458
+ event.api_calls_completed ??
459
+ event.apiCallsCompleted ??
460
+ sessionCal?.apiCallsCompleted;
461
+ const apiCallsCompleted =
462
+ apiCallsCompletedRaw !== undefined &&
463
+ apiCallsCompletedRaw !== null &&
464
+ Number.isFinite(Number(apiCallsCompletedRaw))
465
+ ? Math.max(0, Number(apiCallsCompletedRaw))
466
+ : undefined;
467
+ const explicitRptRaw =
468
+ event.requests_per_turn ?? event.requestsPerTurn ?? options.requestsPerTurn;
469
+ const rptShrinkageMinTurns = Number(
470
+ options.rptShrinkageMinTurns ?? horizonConfig?.thresholds?.rptShrinkageMinTurns ?? 5
471
+ );
472
+ const rptShrinkagePriorDefault = Number(
473
+ options.rptShrinkagePrior ??
474
+ horizonConfig?.thresholds?.rptShrinkagePrior ??
475
+ DEFAULT_RPT_SHRINKAGE_PRIOR
476
+ );
477
+ let requestsPerTurn;
478
+ let rptEstimateSource = `placeholder_rpt_prior_${rptShrinkagePriorDefault}`;
479
+ let rptSampleSize = 0;
480
+ let rawRollingMedianRequestsPerTurn = sessionCal?.rollingMedianRequestsPerTurn ?? null;
481
+ let rawCumulativeRequestsPerTurn = sessionCal?.requestsPerTurn ?? null;
482
+ let rptShrinkageWeight = 0;
483
+ let rptPriorUsed = rptShrinkagePriorDefault;
484
+ let isPlaceholderRptPrior = true;
485
+ let rptTurnsAgree = false;
486
+ let rptEffectiveMinTrustedTurns = rptShrinkageMinTurns;
487
+
488
+ if (
489
+ explicitRptRaw !== undefined &&
490
+ explicitRptRaw !== null &&
491
+ Number.isFinite(Number(explicitRptRaw)) &&
492
+ Number(explicitRptRaw) > 0
493
+ ) {
494
+ requestsPerTurn = Number(explicitRptRaw);
495
+ rptEstimateSource = 'explicit';
496
+ rptSampleSize = Number(sessionCal?.rptSampleSize ?? sessionCal?.turnsCompleted ?? 0);
497
+ rptShrinkageWeight = 1;
498
+ rptPriorUsed = null;
499
+ isPlaceholderRptPrior = false;
500
+ rptTurnsAgree = false;
501
+ rptEffectiveMinTrustedTurns = rptShrinkageMinTurns;
502
+ } else if (sessionCal) {
503
+ const localMedianRpt =
504
+ options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn ?? null;
505
+ const hasLocalRptPrior =
506
+ options.useLocalRptPrior !== false &&
507
+ Number.isFinite(Number(localMedianRpt)) &&
508
+ Number(localMedianRpt) >= 1;
509
+ const rawRollingRpt =
510
+ sessionCal.rollingMedianRequestsPerTurn ?? sessionCal.requestsPerTurn ?? null;
511
+ const sampleTurns = Number(
512
+ sessionCal.rptSampleSize ??
513
+ (Array.isArray(sessionCal.recentTurnRequestCounts)
514
+ ? sessionCal.recentTurnRequestCounts.length
515
+ : sessionCal.turnsCompleted || 0)
516
+ );
517
+ const shrunkRpt = shrinkRollingRequestsPerTurn(rawRollingRpt, sampleTurns, {
518
+ minTrustedTurns: rptShrinkageMinTurns,
519
+ priorRequestsPerTurn: hasLocalRptPrior ? localMedianRpt : rptShrinkagePriorDefault,
520
+ priorSource: hasLocalRptPrior ? 'local_transcripts' : 'placeholder',
521
+ recentTurnRequestCounts: sessionCal.recentTurnRequestCounts
522
+ });
523
+ requestsPerTurn = shrunkRpt.expectedRequestsPerTurn;
524
+ rptEstimateSource = shrunkRpt.source;
525
+ rptSampleSize = shrunkRpt.sampleSize;
526
+ rawRollingMedianRequestsPerTurn = shrunkRpt.rawRollingMedianRequestsPerTurn;
527
+ rptShrinkageWeight = shrunkRpt.shrinkageWeight;
528
+ rptPriorUsed = shrunkRpt.priorRequestsPerTurn;
529
+ isPlaceholderRptPrior = shrunkRpt.isPlaceholderShrinkagePrior;
530
+ rptTurnsAgree = shrunkRpt.turnsAgree;
531
+ rptEffectiveMinTrustedTurns = shrunkRpt.effectiveMinTrustedTurns;
532
+ } else if (
533
+ options.useLocalRptPrior !== false &&
534
+ Number.isFinite(Number(options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn)) &&
535
+ Number(options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn) >= 1
536
+ ) {
537
+ requestsPerTurn = Number(
538
+ Number(options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn).toFixed(4)
539
+ );
540
+ rptEstimateSource = 'local_transcript_rpt_prior';
541
+ rptPriorUsed = requestsPerTurn;
542
+ isPlaceholderRptPrior = false;
543
+ }
544
+
545
+ const explicitGrowthRaw =
546
+ event.context_growth_per_turn ?? event.contextGrowthPerTurn ?? options.contextGrowthPerTurn;
547
+ const allowObservedGrowth =
548
+ (event.useObservedPromptGrowth ?? options.useObservedPromptGrowth) !== false;
549
+ let contextGrowthPerTurn = 0;
550
+ let promptGrowthEstimateSource = 'default_0';
551
+ let promptGrowthSampleSize = Number(sessionCal?.promptGrowthSampleSize ?? 0);
552
+ const hasRecentRptHistory =
553
+ Array.isArray(sessionCal?.recentTurnRequestCounts) &&
554
+ sessionCal.recentTurnRequestCounts.length >= 2;
555
+ const growthRegimeTrusted =
556
+ turnsCompleted >= 5 &&
557
+ promptGrowthSampleSize >= 4 &&
558
+ (!hasRecentRptHistory || Boolean(rptTurnsAgree));
559
+ if (
560
+ explicitGrowthRaw !== undefined &&
561
+ explicitGrowthRaw !== null &&
562
+ Number.isFinite(Number(explicitGrowthRaw)) &&
563
+ Number(explicitGrowthRaw) >= 0
564
+ ) {
565
+ contextGrowthPerTurn = Math.max(0, Math.round(Number(explicitGrowthRaw)));
566
+ promptGrowthEstimateSource = 'explicit';
567
+ } else if (
568
+ allowObservedGrowth &&
569
+ sessionCal?.rollingMedianPromptGrowthTokens !== null &&
570
+ sessionCal?.rollingMedianPromptGrowthTokens !== undefined &&
571
+ Number.isFinite(Number(sessionCal.rollingMedianPromptGrowthTokens)) &&
572
+ Number(sessionCal.rollingMedianPromptGrowthTokens) >= 0
573
+ ) {
574
+ if (growthRegimeTrusted) {
575
+ contextGrowthPerTurn = Math.max(
576
+ 0,
577
+ Math.round(Number(sessionCal.rollingMedianPromptGrowthTokens))
578
+ );
579
+ promptGrowthEstimateSource = 'stop_hook_rolling_growth_median';
580
+ } else {
581
+ contextGrowthPerTurn = 0;
582
+ promptGrowthEstimateSource =
583
+ turnsCompleted < 5
584
+ ? 'capped_early_session_no_extrapolation'
585
+ : 'capped_unstable_regime_no_extrapolation';
586
+ }
587
+ }
588
+ const contextCeilingRaw =
589
+ event.context_ceiling ??
590
+ event.contextCeiling ??
591
+ event.context_window_size ??
592
+ event.contextWindowSize ??
593
+ event.context_window?.context_window_size ??
594
+ options.contextCeiling ??
595
+ liveState?.contextWindow?.contextCeiling;
596
+ const contextCeiling =
597
+ contextCeilingRaw !== undefined &&
598
+ contextCeilingRaw !== null &&
599
+ Number.isFinite(Number(contextCeilingRaw)) &&
600
+ Number(contextCeilingRaw) >= 10_000
601
+ ? Math.round(Number(contextCeilingRaw))
602
+ : undefined;
603
+
604
+ const shrinkageMinTurns = Number(
605
+ options.outputShrinkageMinTurns ?? horizonConfig?.thresholds?.outputShrinkageMinTurns ?? 5
606
+ );
607
+ const shrinkagePriorTokens = Number(
608
+ options.outputShrinkagePriorTokens ?? horizonConfig?.thresholds?.outputShrinkagePriorTokens ?? 500
609
+ );
610
+
611
+ let resolvedExpectedOutputTokens =
612
+ event.expectedOutputTokens ?? event.expected_output_tokens ?? options.expectedOutputTokens;
613
+ let outputEstimateSource =
614
+ resolvedExpectedOutputTokens !== undefined ? 'explicit' : 'default_1500';
615
+ let outputSampleSize = 0;
616
+ let rawRollingMedianOutputTokens = null;
617
+ let shrinkageWeight = resolvedExpectedOutputTokens !== undefined ? 1 : 0;
618
+ const allowObservedOutput =
619
+ (event.useObservedOutputTokens ?? options.useObservedOutputTokens) !== false;
620
+ if (resolvedExpectedOutputTokens === undefined && allowObservedOutput) {
621
+ const turnsDone = Number(liveState?.turnsCompleted || 0);
622
+ const cumOut =
623
+ Number(liveState?.cumulative?.outputTokens || 0) +
624
+ Number(liveState?.cumulative?.thinkingTokens || 0);
625
+ const lastOut =
626
+ Number(liveState?.contextWindow?.lastOutputTokens || 0) +
627
+ Number(liveState?.contextWindow?.lastThinkingTokens || 0);
628
+ if (Number(sessionCal?.rollingMedianOutputTokens) > 0) {
629
+ const calSampleSize = Math.max(
630
+ 1,
631
+ Number(
632
+ sessionCal.outputSampleSize ??
633
+ (Array.isArray(sessionCal.recentTurnOutputs)
634
+ ? sessionCal.recentTurnOutputs.length
635
+ : sessionCal.turnsCompleted || 0)
636
+ )
637
+ );
638
+ const shrunk = shrinkRollingOutputEstimate(
639
+ sessionCal.rollingMedianOutputTokens,
640
+ calSampleSize,
641
+ { minTrustedTurns: shrinkageMinTurns, priorTokens: shrinkagePriorTokens }
642
+ );
643
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
644
+ outputEstimateSource = shrunk.source;
645
+ outputSampleSize = shrunk.sampleSize;
646
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
647
+ shrinkageWeight = shrunk.shrinkageWeight;
648
+ } else if (Number(liveState?.rollingMedianOutputTokens) > 0) {
649
+ const liveSampleSize = Math.max(1, turnsDone);
650
+ const shrunk = shrinkRollingOutputEstimate(
651
+ liveState.rollingMedianOutputTokens,
652
+ liveSampleSize,
653
+ { minTrustedTurns: shrinkageMinTurns, priorTokens: shrinkagePriorTokens }
654
+ );
655
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
656
+ outputEstimateSource =
657
+ shrunk.shrinkageWeight < 1 ? 'live_state_shrunk_median' : 'live_state_rolling_median';
658
+ outputSampleSize = shrunk.sampleSize;
659
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
660
+ shrinkageWeight = shrunk.shrinkageWeight;
661
+ } else if (turnsDone > 0 && cumOut > 0) {
662
+ const shrunk = shrinkRollingOutputEstimate(Math.round(cumOut / turnsDone), turnsDone, {
663
+ minTrustedTurns: shrinkageMinTurns,
664
+ priorTokens: shrinkagePriorTokens
665
+ });
666
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
667
+ outputEstimateSource =
668
+ shrunk.shrinkageWeight < 1 ? 'live_state_shrunk_mean' : 'live_state_mean';
669
+ outputSampleSize = shrunk.sampleSize;
670
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
671
+ shrinkageWeight = shrunk.shrinkageWeight;
672
+ } else if (lastOut > 0) {
673
+ const shrunk = shrinkRollingOutputEstimate(lastOut, 1, {
674
+ minTrustedTurns: shrinkageMinTurns,
675
+ priorTokens: shrinkagePriorTokens
676
+ });
677
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
678
+ outputEstimateSource = 'live_state_shrunk_last';
679
+ outputSampleSize = 1;
680
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
681
+ shrinkageWeight = shrunk.shrinkageWeight;
682
+ }
683
+ }
684
+
109
685
  let verdict = router.evaluateModelSwitch({
110
686
  currentModel,
111
687
  targetModel,
112
688
  cachedTokens,
113
689
  uncachedDeltaTokens,
690
+ uncachedWriteTokens,
691
+ justCompacted,
114
692
  totalPromptTokens,
115
693
  cacheWarm,
116
694
  cacheTtlTier,
117
- expectedOutputTokens: event.expectedOutputTokens ?? 1500,
695
+ turnsCompleted,
696
+ ...(apiCallsCompleted !== undefined ? { apiCallsCompleted } : {}),
697
+ ...(requestsPerTurn !== undefined ? { requestsPerTurn } : {}),
698
+ ...(contextGrowthPerTurn > 0 ? { contextGrowthPerTurn } : {}),
699
+ ...(contextCeiling !== undefined ? { contextCeiling } : {}),
700
+ initialPrefixTokens: sessionCal?.initialPrefixTokens,
701
+ expectedOutputTokens: resolvedExpectedOutputTokens ?? 1500,
702
+ ...(event.minSwitchPenaltyUSD !== undefined ||
703
+ event.min_switch_penalty_usd !== undefined ||
704
+ options.minSwitchPenaltyUSD !== undefined ||
705
+ horizonConfig?.thresholds?.minSwitchPenaltyUSD !== undefined
706
+ ? {
707
+ minSwitchPenaltyUSD:
708
+ event.minSwitchPenaltyUSD ??
709
+ event.min_switch_penalty_usd ??
710
+ options.minSwitchPenaltyUSD ??
711
+ horizonConfig?.thresholds?.minSwitchPenaltyUSD
712
+ }
713
+ : {}),
714
+ ...(event.notableAllowPenaltyUSD !== undefined ||
715
+ event.notable_allow_penalty_usd !== undefined ||
716
+ options.notableAllowPenaltyUSD !== undefined ||
717
+ horizonConfig?.thresholds?.notableAllowPenaltyUSD !== undefined
718
+ ? {
719
+ notableAllowPenaltyUSD:
720
+ event.notableAllowPenaltyUSD ??
721
+ event.notable_allow_penalty_usd ??
722
+ options.notableAllowPenaltyUSD ??
723
+ horizonConfig?.thresholds?.notableAllowPenaltyUSD
724
+ }
725
+ : {}),
726
+ ...(rawRemainingTurns !== undefined && rawRemainingTurns !== null
727
+ ? { expectedRemainingTurns: Number(rawRemainingTurns) }
728
+ : useEmpiricalHorizonPrior
729
+ ? { useEmpiricalHorizonPrior: true }
730
+ : {}),
118
731
  strictBlock:
119
732
  det08Override === 'block' ? true : (event.strictBlock ?? options.strictBlock),
120
- autoPilotDecision: event.autoPilotDecision ?? options.autoPilotDecision
733
+ autoPilotDecision: resolvedAutoPilotDecision
121
734
  });
122
735
 
123
736
  if (det08Override === 'warn' && verdict.blocked) {
@@ -138,20 +751,295 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
138
751
  };
139
752
  }
140
753
 
754
+ const isHeldDownshift = Boolean(
755
+ (verdict.blocked || verdict.advisory) &&
756
+ verdict.breakEven?.shouldHoldModel &&
757
+ !verdict.belowMinSwitchPenaltyUSD &&
758
+ !verdict.breakEven?.isCapabilityUpshift &&
759
+ !verdict.breakEven?.unknownModel &&
760
+ verdict.breakEven?.currentModel &&
761
+ verdict.breakEven?.targetModel &&
762
+ verdict.breakEven.currentModel !== verdict.breakEven.targetModel
763
+ );
764
+ const recordedPendingDownshift = isHeldDownshift
765
+ ? {
766
+ fromModel: verdict.breakEven.currentModel,
767
+ toModel: verdict.breakEven.targetModel,
768
+ recordedAt: new Date(nowMs).toISOString()
769
+ }
770
+ : null;
771
+
772
+ const shadowAutoEval =
773
+ effectiveMode !== 'AUTO_PILOT' &&
774
+ det08Override !== 'off' &&
775
+ cacheWarm &&
776
+ cachedTokens > 0 &&
777
+ effectiveMode === 'OFF'
778
+ ? new CacheGravityRouter({
779
+ ...cwdOptions,
780
+ ...(historicalSessionApiCalls ? { historicalSessionApiCalls } : {}),
781
+ mode: 'AUTO_PILOT'
782
+ }).evaluateModelSwitch({
783
+ currentModel,
784
+ targetModel,
785
+ cachedTokens,
786
+ uncachedDeltaTokens,
787
+ uncachedWriteTokens,
788
+ justCompacted,
789
+ totalPromptTokens,
790
+ cacheWarm,
791
+ cacheTtlTier,
792
+ turnsCompleted,
793
+ ...(apiCallsCompleted !== undefined ? { apiCallsCompleted } : {}),
794
+ ...(requestsPerTurn !== undefined ? { requestsPerTurn } : {}),
795
+ ...(contextGrowthPerTurn > 0 ? { contextGrowthPerTurn } : {}),
796
+ ...(contextCeiling !== undefined ? { contextCeiling } : {}),
797
+ initialPrefixTokens: sessionCal?.initialPrefixTokens,
798
+ expectedOutputTokens: resolvedExpectedOutputTokens ?? 1500,
799
+ ...(rawRemainingTurns !== undefined && rawRemainingTurns !== null
800
+ ? { expectedRemainingTurns: Number(rawRemainingTurns) }
801
+ : useEmpiricalHorizonPrior
802
+ ? { useEmpiricalHorizonPrior: true }
803
+ : {}),
804
+ autoPilotDecision: resolvedAutoPilotDecision
805
+ })
806
+ : null;
807
+
808
+ const effectiveShadowVerdict = shadowAutoEval || verdict;
809
+ const shadowAutoWouldHold = Boolean(
810
+ effectiveMode !== 'AUTO_PILOT' &&
811
+ (effectiveShadowVerdict.advisory ||
812
+ effectiveShadowVerdict.blocked ||
813
+ effectiveShadowVerdict.decision === 'ask') &&
814
+ effectiveShadowVerdict.breakEven?.shouldHoldModel &&
815
+ !effectiveShadowVerdict.belowMinSwitchPenaltyUSD &&
816
+ !effectiveShadowVerdict.breakEven?.isCapabilityUpshift &&
817
+ !effectiveShadowVerdict.breakEven?.unknownModel
818
+ );
819
+ const rawShadowNetUsd = Number(
820
+ effectiveShadowVerdict.netExpectedSavingsUSD ??
821
+ effectiveShadowVerdict.breakEven?.horizonNetSavingsUSD ??
822
+ NaN
823
+ );
824
+ const shadowPenaltyUsd = Number(
825
+ effectiveShadowVerdict.switchPenaltyUSD ??
826
+ effectiveShadowVerdict.breakEven?.coldWritePenaltyUSD ??
827
+ 0
828
+ );
829
+ const shadowMissedUsd = Number(
830
+ Math.max(
831
+ 0,
832
+ Number.isFinite(rawShadowNetUsd) && rawShadowNetUsd < 0 ? -rawShadowNetUsd : shadowPenaltyUsd
833
+ ).toFixed(4)
834
+ );
835
+ const pendingShadowSwitchMiss = shadowAutoWouldHold
836
+ ? {
837
+ ts: nowMs,
838
+ currentModel,
839
+ targetModel,
840
+ wastedTokens: cachedTokens,
841
+ missedUsd: shadowMissedUsd,
842
+ effectiveMode,
843
+ turnKey: String(
844
+ event.turn_id || event.turnId || `${currentModel}->${targetModel}:${cachedTokens}`
845
+ ),
846
+ detectorId: 'DET-08'
847
+ }
848
+ : null;
849
+
850
+ if (shadowAutoWouldHold && options.recordShadowImmediate === true) {
851
+ recordShadowAutoMiss(
852
+ {
853
+ sessionId,
854
+ workspacePath: event.cwd || options.cwd || '',
855
+ harness: 'claude-code',
856
+ effectiveMode,
857
+ category: 'WARM_SWITCH_BUST',
858
+ detectorId: 'DET-08',
859
+ turnKey: pendingShadowSwitchMiss.turnKey,
860
+ wastedTokens: cachedTokens,
861
+ missedUsd: shadowMissedUsd,
862
+ avoidedPrompts: 1,
863
+ detail: `Model switch ${currentModel} -> ${targetModel} on warm cache`
864
+ },
865
+ {
866
+ ...cwdOptions,
867
+ ...(event.shadowLedgerPath ? { shadowLedgerPath: event.shadowLedgerPath } : {})
868
+ }
869
+ );
870
+ }
871
+
872
+ if (shouldPersistBreaker) {
873
+ if (recordedPendingDownshift || pendingShadowSwitchMiss) {
874
+ writeBreakerStateSnapshot(
875
+ sessionId,
876
+ {
877
+ ...(breakerSnap || {}),
878
+ updatedAt: nowMs,
879
+ ...(recordedPendingDownshift
880
+ ? {
881
+ pending_downshift: recordedPendingDownshift,
882
+ pendingDownshiftModel: recordedPendingDownshift.toModel
883
+ }
884
+ : {}),
885
+ ...(pendingShadowSwitchMiss ? { pendingShadowSwitchMiss } : {}),
886
+ lastModelId: verdict.breakEven?.currentModel || currentModel,
887
+ lastContextTokens: cachedTokens
888
+ },
889
+ cwdOptions
890
+ );
891
+ } else if (
892
+ !verdict.blocked &&
893
+ !verdict.advisory &&
894
+ breakerSnap &&
895
+ (breakerSnap.pending_downshift ||
896
+ breakerSnap.pendingDownshiftModel ||
897
+ breakerSnap.justCompacted ||
898
+ breakerSnap.pendingShadowSwitchMiss)
899
+ ) {
900
+ writeBreakerStateSnapshot(
901
+ sessionId,
902
+ {
903
+ ...breakerSnap,
904
+ updatedAt: nowMs,
905
+ pending_downshift: null,
906
+ pendingDownshiftModel: null,
907
+ pendingShadowSwitchMiss: null,
908
+ justCompacted: false
909
+ },
910
+ cwdOptions
911
+ );
912
+ }
913
+ }
914
+
915
+ verdict = {
916
+ ...verdict,
917
+ ...(recordedPendingDownshift ? { pending_downshift: recordedPendingDownshift } : {}),
918
+ turnsCompletedUsed: turnsCompleted,
919
+ apiCallsCompletedUsed: apiCallsCompleted ?? null,
920
+ requestsPerTurnUsed: verdict.breakEven?.requestsPerTurn ?? requestsPerTurn ?? 1,
921
+ rptEstimateSource,
922
+ rptSampleSize,
923
+ rawRollingMedianRequestsPerTurn,
924
+ rawCumulativeRequestsPerTurn,
925
+ rptShrinkageWeight,
926
+ rptPriorUsed,
927
+ isPlaceholderRptPrior,
928
+ rptTurnsAgree,
929
+ rptEffectiveMinTrustedTurns,
930
+ contextGrowthPerTurnUsed: verdict.breakEven?.contextGrowthPerTurn ?? contextGrowthPerTurn ?? 0,
931
+ promptGrowthEstimateSource,
932
+ promptGrowthSampleSize,
933
+ outputEstimateSource,
934
+ outputSampleSize,
935
+ rawRollingMedianOutputTokens,
936
+ shrinkageWeight
937
+ };
938
+
939
+ const interceptionLogPath =
940
+ options.interceptionLogPath || globalThis.process?.env?.AH_INTERCEPTION_LOG_PATH;
941
+ if (typeof interceptionLogPath === 'string' && interceptionLogPath.trim()) {
942
+ try {
943
+ const logTarget = interceptionLogPath.trim();
944
+ const logDir = path.dirname(logTarget);
945
+ if (logDir && logDir !== '.' && !fs.existsSync(logDir)) {
946
+ fs.mkdirSync(logDir, { recursive: true });
947
+ }
948
+ fs.appendFileSync(
949
+ logTarget,
950
+ `${JSON.stringify({
951
+ timestampMs: nowMs,
952
+ sessionId,
953
+ fromModel: currentModel,
954
+ toModel: targetModel,
955
+ turnsCompletedUsed: turnsCompleted,
956
+ apiCallsCompleted: apiCallsCompleted ?? null,
957
+ requestsPerTurn: verdict.breakEven?.requestsPerTurn ?? requestsPerTurn ?? null,
958
+ rptEstimateSource,
959
+ rptSampleSize,
960
+ rawRollingMedianRequestsPerTurn,
961
+ rawCumulativeRequestsPerTurn,
962
+ rptShrinkageWeight,
963
+ rptPriorUsed,
964
+ isPlaceholderRptPrior,
965
+ rptTurnsAgree,
966
+ rptEffectiveMinTrustedTurns,
967
+ contextGrowthPerTurn: verdict.breakEven?.contextGrowthPerTurn ?? contextGrowthPerTurn ?? 0,
968
+ promptGrowthEstimateSource,
969
+ promptGrowthSampleSize,
970
+ outputEstimateSource,
971
+ outputSampleSize,
972
+ rawRollingMedianOutputTokens,
973
+ shrinkageWeight,
974
+ expectedOutputTokens: verdict.breakEven?.expectedOutputTokens ?? null,
975
+ cachedTokens,
976
+ breakEvenTokens: verdict.breakEven?.breakEvenTokens ?? null,
977
+ horizonMaxCachedTokens:
978
+ verdict.breakEven?.horizonMaxCachedTokens === Infinity
979
+ ? 'Infinity'
980
+ : (verdict.breakEven?.horizonMaxCachedTokens ?? null),
981
+ coldWritePenaltyUSD: verdict.breakEven?.coldWritePenaltyUSD ?? null,
982
+ perTurnPostSwitchSavingUSD: verdict.breakEven?.perTurnPostSwitchSavingUSD ?? null,
983
+ averagePostSwitchSavingUSD: verdict.breakEven?.averagePostSwitchSavingUSD ?? null,
984
+ horizonNetSavingsUSD: verdict.breakEven?.horizonNetSavingsUSD ?? null,
985
+ paybackTurns: verdict.breakEven?.paybackTurns ?? null,
986
+ paybackWarmRequests: verdict.breakEven?.paybackWarmRequests ?? null,
987
+ expectedRemainingTurns: verdict.breakEven?.expectedRemainingTurns ?? null,
988
+ postSwitchRemainingTurns: verdict.breakEven?.postSwitchRemainingTurns ?? null,
989
+ expectedRemainingRequests: verdict.breakEven?.expectedRemainingRequests ?? null,
990
+ horizonUnit: verdict.breakEven?.horizonUnit ?? 'turns',
991
+ priorNativeUnit: verdict.breakEven?.priorNativeUnit ?? null,
992
+ priorBucket: verdict.breakEven?.priorBucket ?? null,
993
+ isPlaceholderPrior: Boolean(verdict.breakEven?.isPlaceholderPrior),
994
+ horizonPriorSource: verdict.breakEven?.horizonPriorSource ?? null,
995
+ contextCeilingUsed: verdict.breakEven?.contextCeilingUsed ?? null,
996
+ initialPrefixTokensUsed: verdict.breakEven?.initialPrefixTokensUsed ?? null,
997
+ belowMinSwitchPenaltyUSD: Boolean(verdict.belowMinSwitchPenaltyUSD),
998
+ minSwitchPenaltyUSD: verdict.minSwitchPenaltyUSD ?? null,
999
+ notableAllowNote: verdict.notableAllowNote ?? null,
1000
+ ruleVersion: verdict.breakEven?.ruleVersion ?? null,
1001
+ decision: verdict.decision,
1002
+ reason: verdict.reason ?? null
1003
+ })}\n`,
1004
+ 'utf8'
1005
+ );
1006
+ } catch {
1007
+ // Never fail PreModelSwitch hook on diagnostic log write
1008
+ }
1009
+ }
1010
+
1011
+ const shouldRecordSwitchTelemetry =
1012
+ options.recordSwitchTelemetry !== false &&
1013
+ Boolean(
1014
+ options.cliInvocation ||
1015
+ options.homeDir ||
1016
+ options.telemetryPath ||
1017
+ options.recordSwitchTelemetry ||
1018
+ globalThis.process?.env?.AH_MODEL_SWITCH_TELEMETRY_PATH
1019
+ );
1020
+ if (shouldRecordSwitchTelemetry) {
1021
+ try {
1022
+ recordPreModelSwitchEvent(event, verdict.decision, {
1023
+ homeDir: options.homeDir,
1024
+ telemetryPath: options.telemetryPath
1025
+ });
1026
+ } catch {
1027
+ // Never fail PreModelSwitch hook on local acceptance telemetry error
1028
+ }
1029
+ }
1030
+
1031
+ const avoidedPenaltyUSD = Math.max(
1032
+ 0,
1033
+ Number(verdict.breakEven?.coldWritePenaltyUSD ?? 0)
1034
+ );
1035
+
141
1036
  if (
142
1037
  (verdict.blocked || verdict.decision === 'ask') &&
143
1038
  cachedTokens > 0 &&
1039
+ avoidedPenaltyUSD > 0 &&
144
1040
  options.recordLedger !== false &&
145
1041
  Boolean(event.cwd || options.cwd || options.ledgerPath || options.recordLedger)
146
1042
  ) {
147
- const avoidedPenaltyUSD = Math.max(
148
- 0,
149
- Number(
150
- verdict.breakEven?.netSwitchSavingsUSD < 0
151
- ? Math.abs(verdict.breakEven.netSwitchSavingsUSD)
152
- : verdict.breakEven?.coldTargetTurnUSD || 0
153
- )
154
- );
155
1043
  recordInterventionSavings(
156
1044
  {
157
1045
  sessionId,
@@ -180,6 +1068,22 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
180
1068
  verdict
181
1069
  };
182
1070
  }
1071
+ if (verdict.notableAllowNote) {
1072
+ const hookSpecificOutput = {
1073
+ hookEventName: 'PreModelSwitch',
1074
+ permissionDecision: 'allow',
1075
+ permissionDecisionReason: verdict.notableAllowNote
1076
+ };
1077
+ return {
1078
+ exitCode: 0,
1079
+ stdout: JSON.stringify({
1080
+ systemMessage: verdict.notableAllowNote,
1081
+ hookSpecificOutput
1082
+ }),
1083
+ stderr: '',
1084
+ verdict
1085
+ };
1086
+ }
183
1087
  return {
184
1088
  exitCode: 0,
185
1089
  stdout: '',
@@ -220,9 +1124,14 @@ export async function executePreModelSwitchCli(cliOptions = {}) {
220
1124
  const readPayload = cliOptions.readPayload || readStdinJsonAsync;
221
1125
  const runHook = cliOptions.runHook || runPreModelSwitchHook;
222
1126
  const ioOverride = cliOptions.ioOverride || {};
1127
+ const isRealCliRun =
1128
+ !cliOptions.ioOverride && !cliOptions.readPayload && !cliOptions.runHook;
223
1129
  try {
224
1130
  const payload = await readPayload(cliOptions.timeoutMs);
225
- const res = runHook(payload, cliOptions.hookOptions);
1131
+ const res = runHook(payload, {
1132
+ cliInvocation: isRealCliRun,
1133
+ ...(cliOptions.hookOptions || {})
1134
+ });
226
1135
  if (res.exitCode === 2) {
227
1136
  exitHardBlockStderr(res.stderr, 'PreModelSwitch', ioOverride);
228
1137
  } else if (res.stdout) {