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
@@ -1,26 +1,10 @@
1
1
  /**
2
2
  * @file hooks/handlers/post-tool-use.mjs
3
- * Tier 2 Command Hook handler for `PostToolUse` (`Bash|PowerShell|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
4
- * Runs lossless output sanitization, 100% critical error-line recovery,
5
- * >4,000 token programmatic artifact offloading (excluding workspace `Read`),
6
- * and `DET-19` subagent IPI boundary & Unicode tag stripping (`ISS-034`, `ISS-053`).
3
+ * Thin Tier-2 Command Hook Fast-Shell for `PostToolUse`
4
+ * (`Bash|PowerShell|Grep|Glob|Task|Agent|WebFetch|mcp__.*`).
7
5
  */
8
6
 
9
- import { sanitizePostToolOutput } from '../../src/core-isomorphic/guards/losslessPostSanitizer.mjs';
10
- import {
11
- CircuitBreakerEngine,
12
- evaluateDet19SubagentIpiSanitizer,
13
- readBreakerStateSnapshot,
14
- writeBreakerStateSnapshot
15
- } from '../../src/core-isomorphic/guards/circuitBreakers.mjs';
16
- import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
17
- import { recordWorkspaceShellOutcome } from '../../src/core-isomorphic/coach/microSkills.mjs';
18
- import { evaluateTaskBoundaryTurn } from '../../src/core-isomorphic/coach/smartCompactAdvisor.mjs';
19
- import { recordSavingsReceipt } from '../../src/core-isomorphic/coach/savedQuotaLedger.mjs';
20
- import { readLiveStateSnapshot } from '../../src/core-isomorphic/telemetry/telemetryBridge.mjs';
21
- import { resolveEffectiveRates, computeTotalPromptTokens } from '../../src/core-isomorphic/config/catalogLoader.mjs';
22
- import { runBucketBPostToolPass } from '../../src/core/bucket_b_runtime.mjs';
23
- import { handleClaudeRslHook } from '../../src/hooks/claude_rsl_hook.mjs';
7
+ import { createRequire } from 'node:module';
24
8
  import {
25
9
  isCliEntrypoint,
26
10
  readStdinJsonAsync,
@@ -28,312 +12,28 @@ import {
28
12
  exitDiagnosticZero,
29
13
  exitWithStdoutJson
30
14
  } from './hookIo.mjs';
31
-
32
- /**
33
- * Extracts text from a string or structured `tool_response` object.
34
- * @param {object} event
35
- * @returns {string}
36
- */
37
- function extractPostToolText(event = {}) {
38
- const resp = event.tool_response ?? event.tool_output ?? event.toolOutput ?? event.output;
39
- if (typeof resp === 'string') return resp;
40
- if (resp && typeof resp === 'object') {
41
- const parts = [resp.stdout, resp.stderr, resp.output, resp.content, resp.error]
42
- .filter((x) => typeof x === 'string' && x.length > 0);
43
- if (parts.length > 0) return parts.join('\n');
44
- return '';
45
- }
46
- return resp !== undefined && resp !== null ? String(resp) : '';
47
- }
48
-
49
- /**
50
- * Determines whether a completed tool call failed (`is_error`, non-zero `exit_code`, etc.).
51
- * @param {object} event
52
- * @returns {boolean}
53
- */
54
- function didToolExecutionFail(event = {}) {
55
- if (
56
- event.is_error === true ||
57
- event.isError === true ||
58
- event.succeeded === false ||
59
- Boolean(event.tool_error || event.error) ||
60
- (typeof event.exit_code === 'number' && event.exit_code !== 0) ||
61
- (typeof event.exitCode === 'number' && event.exitCode !== 0)
62
- ) {
63
- return true;
64
- }
65
- const resp = event.tool_response;
66
- if (resp && typeof resp === 'object') {
67
- if (
68
- resp.is_error === true ||
69
- resp.isError === true ||
70
- resp.succeeded === false ||
71
- resp.status === 'error' ||
72
- resp.status === 'failed' ||
73
- Boolean(resp.error) ||
74
- (typeof resp.exit_code === 'number' && resp.exit_code !== 0) ||
75
- (typeof resp.exitCode === 'number' && resp.exitCode !== 0) ||
76
- (typeof resp.returncode === 'number' && resp.returncode !== 0)
77
- ) {
78
- return true;
79
- }
80
- }
81
- return false;
15
+ import {
16
+ tryFastDaemonRpc,
17
+ tryTier1PostToolFastPath
18
+ } from '../../src/hooks/fast_hook_ipc.mjs';
19
+
20
+ const requireFromHere = createRequire(import.meta.url);
21
+ let _coreMod = null;
22
+ function getCoreSync() {
23
+ if (!_coreMod) _coreMod = requireFromHere('./post-tool-use-core.mjs');
24
+ return _coreMod;
82
25
  }
83
26
 
84
27
  /**
85
- * Evaluates a `PostToolUse` hook payload and returns the contract response.
86
- * @param {object} event
28
+ * Synchronous programmatic wrapper delegating to `post-tool-use-core.mjs`.
29
+ *
30
+ * @param {object} [event={}]
87
31
  * @param {object} [options={}]
88
32
  */
89
33
  export function runPostToolUseHook(event = {}, options = {}) {
90
- const toolName = String(event.tool_name || event.toolName || 'Bash');
91
- const rawOutput = extractPostToolText(event);
92
- const tier1Active = Boolean(
93
- options.tier1ModActive ||
94
- event.tier1ModActive ||
95
- globalThis.process?.env?.AH_TIER1_MOD_ACTIVE === '1'
96
- );
97
- if (tier1Active && /^(Grep|Glob)$/i.test(toolName) && rawOutput.length < 16000 && !didToolExecutionFail(event)) {
98
- return {
99
- exitCode: 0,
100
- stdout: '',
101
- stderr: '',
102
- fastPath: 'tier1_mod_active',
103
- sanitized: { modified: false, offloaded: false }
104
- };
105
- }
106
- const sessionId = event.session_id || event.sessionId || 'default';
107
- const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
108
- const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
109
-
110
- const hasExplicitCwd = Boolean(event.cwd || options.cwd);
111
- let loadedPriorSnap = null;
112
- const shouldPersistState =
113
- options.persistState !== false &&
114
- Boolean(event.cwd || options.cwd || options.breakerStatePath || options.persistState);
115
-
116
- if (shouldPersistState) {
117
- if (hasExplicitCwd && options.enableRsl !== false) {
118
- try {
119
- handleClaudeRslHook(event, { ...cwdOptions, event: 'PostToolUse' });
120
- } catch {
121
- // Fail open for RSL step telemetry
122
- }
123
- }
124
- const failed = didToolExecutionFail(event);
125
- const priorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
126
- loadedPriorSnap = priorSnap;
127
- const engine = new CircuitBreakerEngine({
128
- ...cwdOptions,
129
- horizonConfig,
130
- mode: event.mode || options.mode || horizonConfig.flightMode || 'COACH',
131
- initialState: priorSnap
132
- });
133
- const toolInput = event.tool_input || event.toolInput || {};
134
- const cmdStr = String(toolInput.command || toolInput.cmd || event.command || '');
135
- const rawExit =
136
- event.exit_code ??
137
- event.exitCode ??
138
- event.tool_response?.exit_code ??
139
- event.tool_response?.exitCode;
140
- engine.recordToolOutcome(!failed, toolName);
141
- if (/^(Bash|PowerShell|pwsh|cmd|sh|run_command|execute_bash)$/i.test(toolName)) {
142
- engine.recordVerificationOutcome({
143
- succeeded: !failed,
144
- command: cmdStr,
145
- outputText: rawOutput
146
- });
147
- }
148
- if (failed && engine.modifiedFilesInTurn.size > 0) {
149
- // If a test command failed, code edits remain unverified
150
- engine.codeEditedSinceLastTest = true;
151
- }
152
- const boundaryEval = evaluateTaskBoundaryTurn(
153
- {
154
- toolName,
155
- command: cmdStr,
156
- failed,
157
- exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0)
158
- },
159
- engine.taskBoundaryState
160
- );
161
- engine.taskBoundaryState = {
162
- openFailure: boundaryEval.openFailure,
163
- editsSinceBoundary: boundaryEval.editsSinceBoundary,
164
- lastBoundarySuggestedTurn: engine.taskBoundaryState?.lastBoundarySuggestedTurn ?? null
165
- };
166
- const nextTurnBoundaryReached =
167
- boundaryEval.detectorState === 'mid_debug'
168
- ? false
169
- : boundaryEval.boundaryDetected
170
- ? true
171
- : Boolean(priorSnap?.turnBoundaryReached);
172
- const nextTurnMidDebug =
173
- boundaryEval.detectorState === 'mid_debug'
174
- ? true
175
- : boundaryEval.boundaryDetected
176
- ? false
177
- : Boolean(priorSnap?.turnMidDebug);
178
- if (Array.isArray(event.active_background_tasks || event.activeBackgroundTasks)) {
179
- engine.activeBackgroundTasks = (event.active_background_tasks || event.activeBackgroundTasks)
180
- .filter(Boolean)
181
- .map((t) => (typeof t === 'string' ? t : String(t?.id || t?.command || 'bg_task')));
182
- }
183
- writeBreakerStateSnapshot(
184
- sessionId,
185
- {
186
- ...engine.exportStateSnapshot(),
187
- turnBoundaryReached: nextTurnBoundaryReached,
188
- turnMidDebug: nextTurnMidDebug
189
- },
190
- cwdOptions
191
- );
192
-
193
- // RSI-04 ('micro-skills'): Capture shell failure -> recovery pairs within <= 3 turns
194
- if (/^(Bash|PowerShell|pwsh|cmd|sh)$/i.test(toolName) && resolveDetectorOverride('micro-skills', horizonConfig) !== 'off') {
195
- if (cmdStr) {
196
- recordWorkspaceShellOutcome(
197
- {
198
- command: cmdStr,
199
- exitCode: typeof rawExit === 'number' ? rawExit : (failed ? 1 : 0),
200
- turn: Number(event.turnId ?? event.turn_id ?? event.turn ?? 1),
201
- sessionId: String(sessionId),
202
- confirmSessions: Number(horizonConfig.thresholds?.microSkillConfirmSessions ?? 2)
203
- },
204
- cwdOptions
205
- );
206
- }
207
- }
208
- }
209
-
210
- if (!loadedPriorSnap && options.bucketBShadow !== false && hasExplicitCwd && /^(?:Grep|Glob)$/i.test(toolName)) {
211
- loadedPriorSnap = readBreakerStateSnapshot(sessionId, cwdOptions);
212
- }
213
- const bAlphaPost =
214
- options.bucketBShadow === false
215
- ? { triggered: false, updatedOutput: rawOutput, savedTokens: 0 }
216
- : runBucketBPostToolPass({
217
- platform: 'claude',
218
- sessionId,
219
- cwd: event.cwd || options.cwd || '',
220
- hasExplicitCwd,
221
- toolName,
222
- toolInput: event.tool_input || event.toolInput || {},
223
- rawOutput,
224
- lastUserPrompt: event.prompt || loadedPriorSnap?.lastUserPrompt || '',
225
- activeFiles: event.activeFiles || loadedPriorSnap?.modifiedFilesInTurn || [],
226
- dirtyFiles: event.dirtyFiles || [],
227
- lastEditedFile:
228
- event.lastEditedFile || (loadedPriorSnap?.modifiedFilesInTurn || []).slice(-1)[0] || '',
229
- webFetchesInTurn: Number(event.webFetchesInTurn || 1),
230
- options: {
231
- ...options,
232
- mode: event.mode || options.mode || horizonConfig.flightMode,
233
- horizonConfig
234
- }
235
- });
236
-
237
- const effectiveRawOutput = bAlphaPost.triggered ? bAlphaPost.updatedOutput : rawOutput;
238
-
239
- const sanitized = sanitizePostToolOutput(
240
- {
241
- toolName,
242
- toolOutput: effectiveRawOutput
243
- },
244
- cwdOptions
245
- );
246
-
247
- let finalOutput = sanitized.updatedToolOutput;
248
- let wasModified = sanitized.sanitized || Boolean(bAlphaPost.triggered);
249
-
250
- // Apply DET-19 IPI sanitizer if output comes from a subagent (Task/Agent/agentId) or external WebFetch/MCP tool
251
- const isSubagentSource =
252
- Boolean(event.agentId || event.subagentId) || /^(Task|Agent)$/i.test(toolName);
253
- const isUntrustedSource =
254
- isSubagentSource || /^(WebFetch|mcp__.+)$/i.test(toolName);
255
-
256
- if (
257
- isUntrustedSource &&
258
- finalOutput &&
259
- resolveDetectorOverride('DET-19', horizonConfig) !== 'off'
260
- ) {
261
- const ipi = evaluateDet19SubagentIpiSanitizer({
262
- text: finalOutput,
263
- wrapUntrusted: isSubagentSource
264
- });
265
- if (ipi.triggered || isSubagentSource) {
266
- finalOutput = ipi.sanitizedText;
267
- wasModified = true;
268
- }
269
- }
270
-
271
- const totalSavedTokens = sanitized.savedTokens + Number(bAlphaPost.savedTokens || 0);
272
- if (
273
- totalSavedTokens > 0 &&
274
- options.recordLedger !== false &&
275
- (sanitized.savedTokens > 0 || hasExplicitCwd || options.ledgerPath || options.recordLedger === true)
276
- ) {
277
- const liveState = options.telemetryState || readLiveStateSnapshot(sessionId, cwdOptions);
278
- const rawEventModel =
279
- typeof event.model === 'string'
280
- ? event.model
281
- : event.model?.id || event.model?.model_id || event.modelId || event.model_id;
282
- const modelId = rawEventModel || liveState?.modelId || 'claude-sonnet-5-5';
283
- const usageSource =
284
- event.usage || event.context_window?.current_usage || liveState?.contextWindow || {};
285
- const totalPromptTokens = computeTotalPromptTokens(usageSource);
286
- const rates = resolveEffectiveRates(modelId, totalPromptTokens, cwdOptions);
287
- const computedSavedUSD =
288
- rates && !rates.unknownModel && Number.isFinite(rates.inputPer1M)
289
- ? Number(((totalSavedTokens / 1_000_000) * rates.inputPer1M).toFixed(6))
290
- : 0;
291
-
292
- recordSavingsReceipt(
293
- {
294
- sessionId,
295
- modelId: rates.unknownModel ? (rates.rawModelId || modelId) : rates.modelId,
296
- category: sanitized.offloaded
297
- ? 'ARTIFACT_OFFLOAD_4K'
298
- : sanitized.savedTokens > 0
299
- ? 'LOSSLESS_POST_SANITIZER'
300
- : bAlphaPost.code || 'BUCKET_B_POST_SHIELD',
301
- savedTokens: totalSavedTokens,
302
- savedUSD: computedSavedUSD,
303
- detail: `${toolName} output compressed (+${totalSavedTokens} tokens saved)`
304
- },
305
- cwdOptions
306
- );
307
- }
308
-
309
- if (!wasModified) {
310
- return {
311
- exitCode: 0,
312
- stdout: '',
313
- stderr: '',
314
- sanitized
315
- };
316
- }
317
-
318
- // ISS-034: updatedMCPToolOutput applies strictly to MCP tools; built-in tools use additionalContext!
319
- const isMcpTool = /^mcp__/i.test(toolName);
320
- const hookSpecificOutput = isMcpTool
321
- ? {
322
- hookEventName: 'PostToolUse',
323
- updatedMCPToolOutput: finalOutput
324
- }
325
- : {
326
- hookEventName: 'PostToolUse',
327
- additionalContext: finalOutput
328
- };
329
-
330
- return {
331
- exitCode: 0,
332
- stdout: JSON.stringify({ hookSpecificOutput }),
333
- stderr: '',
334
- sanitized,
335
- hookSpecificOutput
336
- };
34
+ const fast = tryTier1PostToolFastPath(event, options);
35
+ if (fast) return fast;
36
+ return getCoreSync().runPostToolUseHook(event, options);
337
37
  }
338
38
 
339
39
  /**
@@ -344,11 +44,44 @@ export function runPostToolUseHook(event = {}, options = {}) {
344
44
  */
345
45
  export async function executePostToolUseCli(cliOptions = {}) {
346
46
  const readPayload = cliOptions.readPayload || readStdinJsonAsync;
347
- const runHook = cliOptions.runHook || runPostToolUseHook;
348
47
  const ioOverride = cliOptions.ioOverride || {};
349
48
  try {
350
49
  const payload = await readPayload(cliOptions.timeoutMs);
351
- const res = runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
50
+ const hasCustomOptions = Boolean(cliOptions.runHook || cliOptions.hookOptions);
51
+
52
+ if (cliOptions.runHook) {
53
+ const res = cliOptions.runHook(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
54
+ if (res.stdout) {
55
+ exitWithStdoutJson(res.stdout, ioOverride);
56
+ } else {
57
+ exitPassThrough(ioOverride.exitFn);
58
+ }
59
+ return;
60
+ }
61
+
62
+ if (!hasCustomOptions) {
63
+ if (tryTier1PostToolFastPath(payload)) {
64
+ exitPassThrough(ioOverride.exitFn);
65
+ return;
66
+ }
67
+
68
+ const ipcRes = await tryFastDaemonRpc(
69
+ 'hook.claude.postToolUse',
70
+ { event: payload },
71
+ { ipcPath: cliOptions.ipcPath }
72
+ );
73
+ if (ipcRes && ipcRes.fullVerdict === true) {
74
+ if (ipcRes.stdout) {
75
+ exitWithStdoutJson(ipcRes.stdout, ioOverride);
76
+ } else {
77
+ exitPassThrough(ioOverride.exitFn);
78
+ }
79
+ return;
80
+ }
81
+ }
82
+
83
+ const { runPostToolUseHook: runCore } = await import('./post-tool-use-core.mjs');
84
+ const res = runCore(payload, { persistState: true, ...(cliOptions.hookOptions || {}) });
352
85
  if (res.stdout) {
353
86
  exitWithStdoutJson(res.stdout, ioOverride);
354
87
  } else {
@@ -26,6 +26,7 @@ import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomo
26
26
  import { CacheGravityRouter } from '../../src/core-isomorphic/coach/cacheGravityRouter.mjs';
27
27
  import { recordInterventionSavings } from '../../src/core-isomorphic/coach/savedQuotaLedger.mjs';
28
28
  import { requireProFeature } from '../../src/core/pro_license.mjs';
29
+ import { recordShadowAutoMiss } from '../../src/core/shadow_auto_ledger.mjs';
29
30
  import { recordPreModelSwitchEvent } from '../../src/utils/modelSwitchTelemetry.mjs';
30
31
  import {
31
32
  isCliEntrypoint,
@@ -768,16 +769,121 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
768
769
  }
769
770
  : null;
770
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
+
771
872
  if (shouldPersistBreaker) {
772
- if (recordedPendingDownshift) {
873
+ if (recordedPendingDownshift || pendingShadowSwitchMiss) {
773
874
  writeBreakerStateSnapshot(
774
875
  sessionId,
775
876
  {
776
877
  ...(breakerSnap || {}),
777
878
  updatedAt: nowMs,
778
- pending_downshift: recordedPendingDownshift,
779
- pendingDownshiftModel: recordedPendingDownshift.toModel,
780
- lastModelId: verdict.breakEven.currentModel,
879
+ ...(recordedPendingDownshift
880
+ ? {
881
+ pending_downshift: recordedPendingDownshift,
882
+ pendingDownshiftModel: recordedPendingDownshift.toModel
883
+ }
884
+ : {}),
885
+ ...(pendingShadowSwitchMiss ? { pendingShadowSwitchMiss } : {}),
886
+ lastModelId: verdict.breakEven?.currentModel || currentModel,
781
887
  lastContextTokens: cachedTokens
782
888
  },
783
889
  cwdOptions
@@ -786,7 +892,10 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
786
892
  !verdict.blocked &&
787
893
  !verdict.advisory &&
788
894
  breakerSnap &&
789
- (breakerSnap.pending_downshift || breakerSnap.pendingDownshiftModel || breakerSnap.justCompacted)
895
+ (breakerSnap.pending_downshift ||
896
+ breakerSnap.pendingDownshiftModel ||
897
+ breakerSnap.justCompacted ||
898
+ breakerSnap.pendingShadowSwitchMiss)
790
899
  ) {
791
900
  writeBreakerStateSnapshot(
792
901
  sessionId,
@@ -795,6 +904,7 @@ export function runPreModelSwitchHook(event = {}, options = {}) {
795
904
  updatedAt: nowMs,
796
905
  pending_downshift: null,
797
906
  pendingDownshiftModel: null,
907
+ pendingShadowSwitchMiss: null,
798
908
  justCompacted: false
799
909
  },
800
910
  cwdOptions