ctxtop 0.0.0-stage → 4.1.0

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 (262) hide show
  1. package/.antigravity-plugin/plugin.json +36 -0
  2. package/.claude-plugin/plugin.json +18 -0
  3. package/CHECKSUMS.sha256 +166 -0
  4. package/LICENSE +27 -0
  5. package/README.md +350 -2
  6. package/SECURITY.md +22 -0
  7. package/agents/ah-flash-scout.md +25 -0
  8. package/assets/advanced_view_loaded_420px.png +0 -0
  9. package/assets/hero-demo.svg +188 -0
  10. package/assets/logo.svg +19 -0
  11. package/assets/simple_view_lean_420px.png +0 -0
  12. package/assets/simple_view_loaded_420px.png +0 -0
  13. package/assets/social-preview.svg +72 -0
  14. package/assets/zone_c_step3_shield_full.png +0 -0
  15. package/bin/ah-statusline.mjs +175 -0
  16. package/bin/cli.mjs +3 -0
  17. package/bin/ctxtop.mjs +1799 -0
  18. package/commands/cost-radar.md +11 -0
  19. package/commands/evolve.md +10 -0
  20. package/commands/handoff.md +10 -0
  21. package/commands/horizon.md +10 -0
  22. package/commands/inspect.md +10 -0
  23. package/commands/precheck.md +10 -0
  24. package/config/default_flightcheck.json +133 -0
  25. package/config/modelCatalog.json +785 -0
  26. package/config/platformQuirks.json +19 -0
  27. package/hooks/handlers/compact-lifecycle.mjs +577 -0
  28. package/hooks/handlers/config-change.mjs +402 -0
  29. package/hooks/handlers/hookIo.mjs +311 -0
  30. package/hooks/handlers/hookIpcClient.mjs +83 -0
  31. package/hooks/handlers/post-model-switch.mjs +111 -0
  32. package/hooks/handlers/post-tool-use.mjs +366 -0
  33. package/hooks/handlers/pre-model-switch.mjs +1048 -0
  34. package/hooks/handlers/pre-tool-use.mjs +632 -0
  35. package/hooks/handlers/stop-gate.mjs +526 -0
  36. package/hooks/handlers/user-prompt-submit.mjs +367 -0
  37. package/hooks/hooks.json +131 -0
  38. package/hooks/post_invocation.mjs +13 -0
  39. package/hooks/post_tool_use.mjs +25 -0
  40. package/hooks/pre_invocation.mjs +14 -0
  41. package/hooks/pre_tool_use.mjs +97 -0
  42. package/hooks/register.js +726 -0
  43. package/hooks/session_start.mjs +24 -0
  44. package/hooks/stop.mjs +23 -0
  45. package/hooks.json +56 -0
  46. package/package.json +110 -4
  47. package/packages/antigravity/package.json +14 -0
  48. package/packages/antigravity/src/index.mjs +1 -0
  49. package/packages/claude-code/package.json +14 -0
  50. package/packages/claude-code/src/index.mjs +2 -0
  51. package/packages/core/package.json +14 -0
  52. package/packages/core/src/index.mjs +1 -0
  53. package/packages/engine-node/package.json +14 -0
  54. package/packages/engine-node/src/index.mjs +1 -0
  55. package/packages/mcp/package.json +17 -0
  56. package/packages/mcp/src/server.mjs +396 -0
  57. package/packages/pro/LICENSE-COMMERCIAL.md +19 -0
  58. package/packages/pro/README-SIGNING.md +30 -0
  59. package/packages/pro/package.json +16 -0
  60. package/packages/pro/src/index.mjs +3 -0
  61. package/packages/pro/src/team_finops_pack.mjs +241 -0
  62. package/packages/pro/workers/polar_webhook_worker.mjs +215 -0
  63. package/plugin.json +36 -0
  64. package/rules/AGENTS.md +10 -0
  65. package/sidecars/horizon-daemon/ipcServer.mjs +24 -0
  66. package/sidecars/horizon-daemon/server.mjs +2038 -0
  67. package/sidecars/horizon-daemon/sidecar.json +19 -0
  68. package/skills/cost-radar/SKILL.md +21 -0
  69. package/skills/evolve/SKILL.md +21 -0
  70. package/skills/handoff/SKILL.md +50 -0
  71. package/skills/horizon/SKILL.md +17 -0
  72. package/skills/inspect/SKILL.md +18 -0
  73. package/skills/precheck/SKILL.md +44 -0
  74. package/src/adapters/antigravity/index.mjs +109 -0
  75. package/src/adapters/claude-code/index.mjs +194 -0
  76. package/src/cli/cost_radar.mjs +70 -0
  77. package/src/cli/doctor.mjs +351 -0
  78. package/src/cli/horizon_hud.mjs +888 -0
  79. package/src/cli/init.mjs +425 -0
  80. package/src/cli/postmortem.mjs +515 -0
  81. package/src/coach/cacheGravityRouter.mjs +12 -0
  82. package/src/config/modelCatalog.json +704 -0
  83. package/src/config/platformQuirks.json +19 -0
  84. package/src/core/action_queue.mjs +264 -0
  85. package/src/core/ag_bridge.mjs +346 -0
  86. package/src/core/atomic_io.mjs +124 -0
  87. package/src/core/baseline.mjs +607 -0
  88. package/src/core/blindspot_sensors.mjs +399 -0
  89. package/src/core/bucket_b_runtime.mjs +1200 -0
  90. package/src/core/classifier.mjs +1757 -0
  91. package/src/core/coach/circuit_breakers.mjs +650 -0
  92. package/src/core/coach/contradiction_auditor.mjs +239 -0
  93. package/src/core/coach/effort_advisor.mjs +143 -0
  94. package/src/core/coach/handoff_hydrator.mjs +483 -0
  95. package/src/core/coach/progressive_checkpointer.mjs +551 -0
  96. package/src/core/coach/prompt_decomposer_coach.mjs +141 -0
  97. package/src/core/coach/reflector_queue.mjs +505 -0
  98. package/src/core/coach/saved_quota_ledger.mjs +615 -0
  99. package/src/core/coach/subagent_ipi_sanitizer.mjs +200 -0
  100. package/src/core/coach/subagent_phantom_auditor.mjs +261 -0
  101. package/src/core/coach/task_quota_router.mjs +955 -0
  102. package/src/core/coach/turn_zero_gate.mjs +574 -0
  103. package/src/core/compaction_coach.mjs +1126 -0
  104. package/src/core/config.mjs +214 -0
  105. package/src/core/constants.mjs +1987 -0
  106. package/src/core/detectors_det01_to_16.mjs +1523 -0
  107. package/src/core/doc_indexer.mjs +338 -0
  108. package/src/core/episodic_memory.mjs +135 -0
  109. package/src/core/fts5_output_compressor.mjs +359 -0
  110. package/src/core/git_ledger.mjs +189 -0
  111. package/src/core/handoff_audit.mjs +558 -0
  112. package/src/core/history.mjs +221 -0
  113. package/src/core/hook_diagnostics.mjs +158 -0
  114. package/src/core/horizon_classifier.mjs +326 -0
  115. package/src/core/horizon_config.mjs +802 -0
  116. package/src/core/host_watchdog.mjs +200 -0
  117. package/src/core/layer5_hygiene.mjs +1084 -0
  118. package/src/core/log_resolver.mjs +231 -0
  119. package/src/core/mcp_auditor.mjs +138 -0
  120. package/src/core/micro_skills_store.mjs +91 -0
  121. package/src/core/offenders.mjs +161 -0
  122. package/src/core/parser.mjs +1997 -0
  123. package/src/core/path_canonicalizer.mjs +73 -0
  124. package/src/core/paths.mjs +311 -0
  125. package/src/core/prefix_cache_shield.mjs +386 -0
  126. package/src/core/pro_license.mjs +385 -0
  127. package/src/core/prompt_rubric.mjs +518 -0
  128. package/src/core/pruner.mjs +433 -0
  129. package/src/core/quota.mjs +1860 -0
  130. package/src/core/rsi_instinct_engine.mjs +1197 -0
  131. package/src/core/rsl_clash_auditor.mjs +423 -0
  132. package/src/core/rsl_distiller.mjs +372 -0
  133. package/src/core/rsl_ledger.mjs +969 -0
  134. package/src/core/rsl_triage.mjs +909 -0
  135. package/src/core/sanitizer.mjs +121 -0
  136. package/src/core/session_auditor.mjs +658 -0
  137. package/src/core/session_forensics.mjs +303 -0
  138. package/src/core/session_timeline.mjs +358 -0
  139. package/src/core/settings.mjs +99 -0
  140. package/src/core/shared/detectors.mjs +1342 -0
  141. package/src/core/shared/fnv1a64.mjs +85 -0
  142. package/src/core/shared/handoff_schema.mjs +123 -0
  143. package/src/core/shared/index.mjs +5 -0
  144. package/src/core/shared/ipi_sanitizer.mjs +165 -0
  145. package/src/core/shared/micro_skills.mjs +1 -0
  146. package/src/core/shared/plugin_validator.mjs +202 -0
  147. package/src/core/shared/prompt_hygiene_governor.mjs +1 -0
  148. package/src/core/shield_manager.mjs +1417 -0
  149. package/src/core/sidecar_store.mjs +302 -0
  150. package/src/core/sprint_metrics.mjs +366 -0
  151. package/src/core/sqlite_client.mjs +283 -0
  152. package/src/core/storage_doctor.mjs +358 -0
  153. package/src/core/subagents.mjs +609 -0
  154. package/src/core/swarm_topology.mjs +360 -0
  155. package/src/core/task_quota_router.mjs +1656 -0
  156. package/src/core/telemetry/cache_ttl_watchdog.mjs +284 -0
  157. package/src/core/telemetry/scope_lock_registry.mjs +578 -0
  158. package/src/core/telemetry/shadow_file_detector.mjs +291 -0
  159. package/src/core/telemetry/trajectory_watcher.mjs +259 -0
  160. package/src/core/timeline_svg.mjs +236 -0
  161. package/src/core/tool_surgeon.mjs +305 -0
  162. package/src/core/trajectory_stitcher.mjs +645 -0
  163. package/src/core/u_shaped_optimizer.mjs +789 -0
  164. package/src/core/wal_hygiene.mjs +233 -0
  165. package/src/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  166. package/src/core-isomorphic/catalog/index.mjs +1 -0
  167. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  168. package/src/core-isomorphic/coach/microSkills.mjs +1 -0
  169. package/src/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  170. package/src/core-isomorphic/coach/repoCalibration.mjs +254 -0
  171. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  172. package/src/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  173. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +305 -0
  174. package/src/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  175. package/src/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  176. package/src/core-isomorphic/config/anthropicModelCatalog.json +606 -0
  177. package/src/core-isomorphic/config/catalogLoader.mjs +1268 -0
  178. package/src/core-isomorphic/config/horizonConfig.mjs +1055 -0
  179. package/src/core-isomorphic/control/callTree.mjs +338 -0
  180. package/src/core-isomorphic/control/coachLatches.mjs +126 -0
  181. package/src/core-isomorphic/control/controlStateMachine.mjs +205 -0
  182. package/src/core-isomorphic/control/index.mjs +49 -0
  183. package/src/core-isomorphic/control/swarmWorktree.mjs +109 -0
  184. package/src/core-isomorphic/control/toolSuspension.mjs +197 -0
  185. package/src/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  186. package/src/core-isomorphic/diagnostics/index.mjs +9 -0
  187. package/src/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  188. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  189. package/src/core-isomorphic/economics/billingBlocks.mjs +251 -0
  190. package/src/core-isomorphic/economics/cacheGravity.mjs +369 -0
  191. package/src/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  192. package/src/core-isomorphic/economics/driftLatency.mjs +433 -0
  193. package/src/core-isomorphic/economics/dualTtl.mjs +198 -0
  194. package/src/core-isomorphic/economics/index.mjs +47 -0
  195. package/src/core-isomorphic/economics/retentionRadar.mjs +348 -0
  196. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  197. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  198. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  199. package/src/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  200. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  201. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  202. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  203. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  204. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  205. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  206. package/src/core-isomorphic/index.js +27 -0
  207. package/src/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  208. package/src/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  209. package/src/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  210. package/src/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  211. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +1156 -0
  212. package/src/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  213. package/src/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  214. package/src/core-isomorphic/ui/horizonGrid.mjs +475 -0
  215. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +1237 -0
  216. package/src/core-isomorphic/ui/modViews.mjs +1504 -0
  217. package/src/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  218. package/src/core-isomorphic/ustf/index.mjs +7 -0
  219. package/src/core-isomorphic/ustf/normalizer.mjs +512 -0
  220. package/src/core-isomorphic/ustf/schema.mjs +186 -0
  221. package/src/core-isomorphic/utils/runtime.mjs +962 -0
  222. package/src/demo/synthetic_states.mjs +661 -0
  223. package/src/diagnostics/bugReportGenerator.mjs +253 -0
  224. package/src/diagnostics/claudeHookCapabilities.mjs +396 -0
  225. package/src/diagnostics/doctorEngine.mjs +295 -0
  226. package/src/engine-node/db/index.mjs +58 -0
  227. package/src/engine-node/db/jsonl_fallback.mjs +184 -0
  228. package/src/engine-node/db/probe.mjs +342 -0
  229. package/src/engine-node/db/sqlite_wrapper.mjs +122 -0
  230. package/src/engine-node/index.mjs +12 -0
  231. package/src/engine-node/ipc/client.mjs +447 -0
  232. package/src/engine-node/ipc/index.mjs +22 -0
  233. package/src/engine-node/ipc/protocol.mjs +177 -0
  234. package/src/engine-node/ipc/server.mjs +445 -0
  235. package/src/engine-node/offloader/index.mjs +6 -0
  236. package/src/engine-node/offloader/tool_offloader.mjs +241 -0
  237. package/src/engine-node/sensors/blindspots.mjs +376 -0
  238. package/src/engine-node/sensors/git_merge_tree.mjs +223 -0
  239. package/src/engine-node/sensors/index.mjs +7 -0
  240. package/src/hooks/antigravity_rsl_hook.mjs +250 -0
  241. package/src/hooks/claude_rsl_hook.mjs +288 -0
  242. package/src/hooks/portfolio_runtime.mjs +858 -0
  243. package/src/hooks/post_invocation.mjs +611 -0
  244. package/src/hooks/pre_invocation.mjs +1725 -0
  245. package/src/hooks/session_start.mjs +199 -0
  246. package/src/shims/agy_cli_compressor.mjs +705 -0
  247. package/src/shims/agy_git_guard.mjs +749 -0
  248. package/src/shims/ah_log_query.mjs +39 -0
  249. package/src/ui/costRadarSvg.mjs +6 -0
  250. package/src/ui/horizonGrid.mjs +1 -0
  251. package/src/ui/horizonPanelHtml.mjs +1 -0
  252. package/src/ui/horizon_panel.css +167 -0
  253. package/src/ui/horizon_panel.js +212 -0
  254. package/src/ui/modViews.mjs +1 -0
  255. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  256. package/src/utils/nodeIo.mjs +59 -0
  257. package/src/utils/runtime.mjs +1 -0
  258. package/src/utils/sessionCalibration.mjs +657 -0
  259. package/src/webview/advanced_view.html +1808 -0
  260. package/src/webview/horizon_panel.html +12397 -0
  261. package/src/webview/registry.mjs +80 -0
  262. package/src/webview/simple_view.html +1370 -0
@@ -0,0 +1,1048 @@
1
+ /**
2
+ * @file hooks/handlers/pre-model-switch.mjs
3
+ * Tier 2 Command Hook handler for `PreModelSwitch` (`DET-08` Warm KV-Cache Cross-Model Switch Guard).
4
+ */
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';
15
+ import { readLiveStateSnapshot } from '../../src/core-isomorphic/telemetry/telemetryBridge.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';
25
+ import { loadHorizonConfig, resolveDetectorOverride } from '../../src/core-isomorphic/config/horizonConfig.mjs';
26
+ import { CacheGravityRouter } from '../../src/core-isomorphic/coach/cacheGravityRouter.mjs';
27
+ import { recordInterventionSavings } from '../../src/core-isomorphic/coach/savedQuotaLedger.mjs';
28
+ import { requireProFeature } from '../../src/core/pro_license.mjs';
29
+ import { recordPreModelSwitchEvent } from '../../src/utils/modelSwitchTelemetry.mjs';
30
+ import {
31
+ isCliEntrypoint,
32
+ readStdinJsonAsync,
33
+ exitPassThrough,
34
+ exitHardBlockStderr,
35
+ exitWithStdoutJson
36
+ } from './hookIo.mjs';
37
+
38
+ const PRIOR_CACHE_TTL_MS = 3_600_000;
39
+
40
+ export const MIN_LOCAL_RPT_PRIOR_SESSIONS = 3;
41
+
42
+ function isExcludedBenchmarkTranscript(filePath = '', content = '') {
43
+ const normPath = String(filePath || '').replace(/\\/g, '/').toLowerCase();
44
+ if (
45
+ normPath.includes('model-switch-benchmark') ||
46
+ normPath.includes('smart-compact') ||
47
+ normPath.includes('e2e_harness') ||
48
+ normPath.includes('ctxtop-model-switch')
49
+ ) {
50
+ return true;
51
+ }
52
+ if (typeof content === 'string' && content.includes('Benchmark-Run-Salt:')) {
53
+ return true;
54
+ }
55
+ return false;
56
+ }
57
+
58
+ /**
59
+ * Samples recent local Claude Code session assistant-turn counts and requests/turn (read-only,
60
+ * bounded to 50 files, deduplicated by `message.id`, 1h disk cache under
61
+ * `~/.attention-horizon/cache/ah_session_prior.json`).
62
+ * Excludes the current session (`excludeSessionId` / `excludeTranscriptPath`) and benchmark/harness
63
+ * transcripts (`excludeBenchmarkSessions !== false`), requiring `>= 3` qualifying sessions for
64
+ * `medianRequestsPerTurn`.
65
+ *
66
+ * @param {object} [options={}]
67
+ * @returns {{ apiCounts: number[], medianRequestsPerTurn: number | null, sessionCount: number } | null}
68
+ */
69
+ export function loadLocalClaudeSessionPriors(options = {}) {
70
+ if (Array.isArray(options.historicalSessionApiCalls)) {
71
+ return {
72
+ apiCounts: options.historicalSessionApiCalls,
73
+ medianRequestsPerTurn:
74
+ Number.isFinite(Number(options.historicalSessionRequestsPerTurn))
75
+ ? Number(options.historicalSessionRequestsPerTurn)
76
+ : null,
77
+ sessionCount: options.historicalSessionApiCalls.length
78
+ };
79
+ }
80
+ const home =
81
+ options.homeDir ||
82
+ globalThis.process?.env?.HOME ||
83
+ globalThis.process?.env?.USERPROFILE ||
84
+ os.homedir();
85
+ const cachePath = path.join(home, '.attention-horizon', 'cache', 'ah_session_prior.json');
86
+ const nowMs = Number.isFinite(Number(options.nowMs)) ? Number(options.nowMs) : Date.now();
87
+ const excludeSessionId =
88
+ options.excludeSessionId && options.excludeSessionId !== 'default'
89
+ ? String(options.excludeSessionId).trim()
90
+ : null;
91
+ const excludeTranscriptPathNorm = options.excludeTranscriptPath
92
+ ? path.resolve(String(options.excludeTranscriptPath)).replace(/\\/g, '/').toLowerCase()
93
+ : null;
94
+ const excludeBenchmarks = options.excludeBenchmarkSessions !== false;
95
+
96
+ const cached = readJsonSafe(cachePath, null, options);
97
+ if (
98
+ cached &&
99
+ Array.isArray(cached.sessions) &&
100
+ Number.isFinite(cached.sampledAtMs) &&
101
+ nowMs - cached.sampledAtMs < PRIOR_CACHE_TTL_MS
102
+ ) {
103
+ const filtered = cached.sessions.filter((s) => {
104
+ if (excludeSessionId && s.sessionId === excludeSessionId) return false;
105
+ if (excludeTranscriptPathNorm && s.normPath === excludeTranscriptPathNorm) return false;
106
+ if (excludeBenchmarks && s.isBenchmark) return false;
107
+ return true;
108
+ });
109
+ if (filtered.length >= 1) {
110
+ const apiCounts = filtered.map((s) => s.assistantTurns);
111
+ const rpts = filtered.map((s) => s.rpt).filter((r) => Number.isFinite(r) && r >= 1);
112
+ return {
113
+ apiCounts,
114
+ medianRequestsPerTurn:
115
+ rpts.length >= MIN_LOCAL_RPT_PRIOR_SESSIONS
116
+ ? computeRollingMedianFloat(rpts, rpts.length)
117
+ : null,
118
+ sessionCount: apiCounts.length
119
+ };
120
+ }
121
+ return null;
122
+ }
123
+
124
+ try {
125
+ const ccProjects = path.join(home, '.claude', 'projects');
126
+ if (!fs.existsSync(ccProjects)) return null;
127
+
128
+ const jsonlFiles = [];
129
+ const queue = [ccProjects];
130
+ while (queue.length > 0 && jsonlFiles.length < 150) {
131
+ const dir = queue.shift();
132
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
133
+ const full = path.join(dir, entry.name);
134
+ if (entry.isDirectory()) {
135
+ if (entry.name !== 'subagents') queue.push(full);
136
+ } else if (entry.name.endsWith('.jsonl')) {
137
+ const st = fs.statSync(full);
138
+ if (st.size >= 512 && st.size <= 5_000_000) {
139
+ jsonlFiles.push({ path: full, mtimeMs: st.mtimeMs });
140
+ }
141
+ }
142
+ }
143
+ }
144
+ jsonlFiles.sort((a, b) => b.mtimeMs - a.mtimeMs);
145
+ const allSessions = [];
146
+ for (const item of jsonlFiles.slice(0, 50)) {
147
+ let fd = null;
148
+ try {
149
+ const normPath = path.resolve(item.path).replace(/\\/g, '/').toLowerCase();
150
+ const fileSessionId = path.basename(item.path, '.jsonl');
151
+ fd = fs.openSync(item.path, 'r');
152
+ const txt = fs.readFileSync(fd, 'utf8');
153
+ const isBenchmark = isExcludedBenchmarkTranscript(item.path, txt);
154
+ const assistantMsgIds = new Set();
155
+ let humanTurnCount = 0;
156
+ let idx = 0;
157
+ for (const line of txt.split(/\r?\n/)) {
158
+ idx += 1;
159
+ if (!line.includes('"assistant"') && !line.includes('"user"')) continue;
160
+ try {
161
+ const obj = JSON.parse(line);
162
+ if (isRealHumanUserTranscriptEntry(obj)) {
163
+ humanTurnCount += 1;
164
+ } else if (obj?.type === 'assistant') {
165
+ assistantMsgIds.add(obj?.message?.id || `line_${idx}`);
166
+ }
167
+ } catch {
168
+ if (line.includes('"type":"assistant"')) assistantMsgIds.add(`raw_${idx}`);
169
+ }
170
+ }
171
+ const assistantTurns = assistantMsgIds.size;
172
+ if (assistantTurns >= 2) {
173
+ const rpt =
174
+ humanTurnCount >= 1
175
+ ? Math.max(1, Number((assistantTurns / humanTurnCount).toFixed(4)))
176
+ : null;
177
+ allSessions.push({
178
+ sessionId: fileSessionId,
179
+ normPath,
180
+ isBenchmark,
181
+ assistantTurns,
182
+ rpt
183
+ });
184
+ }
185
+ } catch {
186
+ // Ignore unreadable session file
187
+ } finally {
188
+ if (fd !== null) {
189
+ try {
190
+ fs.closeSync(fd);
191
+ } catch {
192
+ // Ignore close failure
193
+ }
194
+ }
195
+ }
196
+ }
197
+ const filtered = allSessions.filter((s) => {
198
+ if (excludeSessionId && s.sessionId === excludeSessionId) return false;
199
+ if (excludeTranscriptPathNorm && s.normPath === excludeTranscriptPathNorm) return false;
200
+ if (excludeBenchmarks && s.isBenchmark) return false;
201
+ return true;
202
+ });
203
+ const apiCounts = filtered.map((s) => s.assistantTurns);
204
+ const sessionRpts = filtered.map((s) => s.rpt).filter((r) => Number.isFinite(r) && r >= 1);
205
+ const medianRequestsPerTurn =
206
+ sessionRpts.length >= MIN_LOCAL_RPT_PRIOR_SESSIONS
207
+ ? computeRollingMedianFloat(sessionRpts, sessionRpts.length)
208
+ : null;
209
+ if (allSessions.length >= 1) {
210
+ writeJsonAtomic(
211
+ cachePath,
212
+ {
213
+ sampledAtMs: nowMs,
214
+ sessions: allSessions,
215
+ apiCounts,
216
+ medianRequestsPerTurn,
217
+ sessionCount: apiCounts.length
218
+ },
219
+ options
220
+ );
221
+ }
222
+ if (apiCounts.length >= 1) {
223
+ return { apiCounts, medianRequestsPerTurn, sessionCount: apiCounts.length };
224
+ }
225
+ } catch {
226
+ // Fallback to built-in 496-session prior
227
+ }
228
+ return null;
229
+ }
230
+
231
+ /**
232
+ * Backward-compatible accessor returning `apiCounts` once >= 5 local sessions exist
233
+ * (or any explicit `options.historicalSessionApiCalls` override).
234
+ * @param {object} [options={}]
235
+ * @returns {number[] | null}
236
+ */
237
+ export function loadLocalClaudeSessionApiCalls(options = {}) {
238
+ if (Array.isArray(options.historicalSessionApiCalls)) {
239
+ return options.historicalSessionApiCalls;
240
+ }
241
+ const priors = loadLocalClaudeSessionPriors(options);
242
+ return Array.isArray(priors?.apiCounts) && priors.apiCounts.length >= 5 ? priors.apiCounts : null;
243
+ }
244
+
245
+ /**
246
+ * Evaluates a `PreModelSwitch` event against `CacheGravityRouter` break-even threshold `C*`.
247
+ * @param {object} event
248
+ * @param {object} [options={}]
249
+ */
250
+ export function runPreModelSwitchHook(event = {}, options = {}) {
251
+ const sessionId = event.session_id || event.sessionId || 'default';
252
+ const cwdOptions = event.cwd && !options.cwd ? { ...options, cwd: event.cwd } : options;
253
+ const horizonConfig = options.horizonConfig || loadHorizonConfig(cwdOptions);
254
+ const det08Override = resolveDetectorOverride('DET-08', horizonConfig);
255
+
256
+ if (det08Override === 'off') {
257
+ return {
258
+ exitCode: 0,
259
+ stdout: '',
260
+ stderr: '',
261
+ verdict: {
262
+ detectorId: null,
263
+ triggered: false,
264
+ decision: 'allow',
265
+ blocked: false,
266
+ overriddenByConfig: 'off',
267
+ suppressedDetectorId: 'DET-08',
268
+ reason: null
269
+ }
270
+ };
271
+ }
272
+
273
+ const liveState = options.telemetryState || readLiveStateSnapshot(sessionId, cwdOptions);
274
+ const configHasDiskSource = Boolean(
275
+ horizonConfig?.sources?.projectLoaded || horizonConfig?.sources?.globalLoaded
276
+ );
277
+ const rawEffectiveMode =
278
+ event.mode ||
279
+ options.mode ||
280
+ options.telemetryState?.flightMode ||
281
+ (configHasDiskSource
282
+ ? horizonConfig.flightMode
283
+ : liveState?.flightMode || horizonConfig?.flightMode || 'COACH');
284
+ const proAutoPilot =
285
+ rawEffectiveMode === 'AUTO_PILOT' ? requireProFeature('auto_pilot_locks', options) : { allowed: true };
286
+ const effectiveMode =
287
+ rawEffectiveMode === 'AUTO_PILOT' && !proAutoPilot.allowed ? 'COACH' : rawEffectiveMode;
288
+
289
+ const rawRemainingTurns =
290
+ event.expected_remaining_turns ??
291
+ event.expectedRemainingTurns ??
292
+ options.expectedRemainingTurns ??
293
+ horizonConfig?.expectedRemainingTurns;
294
+ const useEmpiricalHorizonPrior = Boolean(
295
+ event.use_empirical_horizon_prior ??
296
+ event.useEmpiricalHorizonPrior ??
297
+ options.useEmpiricalHorizonPrior ??
298
+ horizonConfig?.useEmpiricalHorizonPrior
299
+ );
300
+ const sessionCal =
301
+ options.useSessionCalibration === false
302
+ ? null
303
+ : readSessionCalibration(sessionId, event, cwdOptions);
304
+ const turnsCompleted = Number(
305
+ event.current_turn ??
306
+ event.currentTurn ??
307
+ (sessionCal?.turnsCompleted > 0 ? sessionCal.turnsCompleted : undefined) ??
308
+ liveState?.turnsCompleted ??
309
+ 0
310
+ );
311
+ const localPriorsOptions = {
312
+ ...cwdOptions,
313
+ excludeSessionId: sessionId,
314
+ excludeTranscriptPath:
315
+ event.transcript_path || event.transcriptPath || sessionCal?.transcriptPath || null
316
+ };
317
+ const localPriors =
318
+ options.useLocalRptPrior !== false &&
319
+ (options.homeDir ||
320
+ options.cliInvocation ||
321
+ options.useLocalRptPrior === true ||
322
+ useEmpiricalHorizonPrior ||
323
+ Boolean(sessionCal))
324
+ ? loadLocalClaudeSessionPriors(localPriorsOptions)
325
+ : null;
326
+ const localSurvivalApiCalls =
327
+ localPriors && Array.isArray(localPriors.apiCounts) && localPriors.apiCounts.length >= 5
328
+ ? localPriors.apiCounts
329
+ : null;
330
+ const historicalSessionApiCalls =
331
+ useEmpiricalHorizonPrior && (rawRemainingTurns === undefined || rawRemainingTurns === null)
332
+ ? (localSurvivalApiCalls ?? loadLocalClaudeSessionApiCalls(localPriorsOptions))
333
+ : options.historicalSessionApiCalls;
334
+
335
+ const router =
336
+ options.router ||
337
+ new CacheGravityRouter({
338
+ ...cwdOptions,
339
+ ...(historicalSessionApiCalls ? { historicalSessionApiCalls } : {}),
340
+ mode: effectiveMode,
341
+ strictBlock:
342
+ det08Override === 'block' ? true : (event.strictBlock ?? options.strictBlock)
343
+ });
344
+
345
+ const shouldPersistBreaker =
346
+ options.persistState !== false &&
347
+ Boolean(
348
+ options.persistState === true ||
349
+ options.cliInvocation ||
350
+ options.breakerStatePath ||
351
+ event.persistState ||
352
+ event.cwd
353
+ );
354
+ const breakerSnap = shouldPersistBreaker
355
+ ? readBreakerStateSnapshot(sessionId, cwdOptions)
356
+ : null;
357
+ const justCompacted = Boolean(
358
+ event.just_compacted ?? event.justCompacted ?? breakerSnap?.justCompacted
359
+ );
360
+
361
+ const currentModel =
362
+ event.current_model ||
363
+ event.currentModel ||
364
+ event.from_model ||
365
+ event.fromModel ||
366
+ liveState.modelId ||
367
+ 'claude-opus-5-5';
368
+ const targetModel =
369
+ event.target_model ||
370
+ event.targetModel ||
371
+ event.to_model ||
372
+ event.toModel ||
373
+ event.requested_model ||
374
+ event.requestedModel ||
375
+ event.model ||
376
+ 'claude-sonnet-5-5';
377
+ const explicitCachedTokens =
378
+ event.cached_tokens ??
379
+ event.cachedTokens ??
380
+ event.context_tokens ??
381
+ event.contextTokens;
382
+ const cachedTokens = Number(
383
+ explicitCachedTokens ??
384
+ (justCompacted
385
+ ? (liveState.contextWindow?.cacheReadTokens ?? liveState.contextWindow?.cachedTokens ?? 0)
386
+ : (liveState.contextWindow?.cachedTokens ?? 0))
387
+ );
388
+ const explicitUncachedWrite =
389
+ event.uncached_write_tokens ?? event.uncachedWriteTokens;
390
+ const uncachedWriteTokens = Math.max(
391
+ 0,
392
+ Number(
393
+ explicitUncachedWrite ??
394
+ (justCompacted ? (liveState.contextWindow?.cacheCreationTokens ?? 0) : 0)
395
+ )
396
+ );
397
+ const nowMs = Number.isFinite(Number(options.nowMs)) ? Number(options.nowMs) : Date.now();
398
+ const rawExpiresAt = liveState?.promptCache?.expiresAt;
399
+ const liveCacheExpired =
400
+ rawExpiresAt !== null &&
401
+ rawExpiresAt !== undefined &&
402
+ Number.isFinite(Number(rawExpiresAt)) &&
403
+ Number(rawExpiresAt) > 0 &&
404
+ nowMs >= Number(rawExpiresAt);
405
+ const explicitCacheWarm =
406
+ event.cache_warm ??
407
+ event.cacheWarm ??
408
+ event.prompt_cache_warm ??
409
+ event.promptCacheWarm;
410
+ const cacheWarm =
411
+ explicitCacheWarm !== undefined
412
+ ? Boolean(explicitCacheWarm)
413
+ : liveCacheExpired
414
+ ? false
415
+ : justCompacted && cachedTokens === 0
416
+ ? false
417
+ : Boolean(liveState.promptCache?.warm);
418
+
419
+ const uncachedDeltaTokens = Number(
420
+ event.uncached_delta_tokens ?? event.uncachedDeltaTokens ?? 0
421
+ );
422
+ const rawTier =
423
+ event.cache_ttl_tier ??
424
+ event.cacheTtlTier ??
425
+ event.cache_ttl ??
426
+ event.cacheTtl ??
427
+ event.prompt_cache?.ttl ??
428
+ liveState.promptCache?.ttlTier ??
429
+ '5m';
430
+ const cacheTtlTier =
431
+ rawTier === '1h' || rawTier === '3600s' || Number(rawTier) > 300 ? '1h' : '5m';
432
+ const usageSource =
433
+ event.usage || event.context_window?.current_usage || liveState.contextWindow || {};
434
+ const totalPromptTokens = Math.max(
435
+ cachedTokens + uncachedDeltaTokens + uncachedWriteTokens,
436
+ computeTotalPromptTokens(event),
437
+ computeTotalPromptTokens(usageSource)
438
+ );
439
+
440
+ const isNativePreModelSwitch = Boolean(
441
+ event.hook_event_name === 'PreModelSwitch' ||
442
+ event.from_model !== undefined ||
443
+ event.to_model !== undefined ||
444
+ event.fromModel !== undefined ||
445
+ event.toModel !== undefined ||
446
+ options.nativeHook === true
447
+ );
448
+ const resolvedAutoPilotDecision =
449
+ det08Override === 'block'
450
+ ? 'deny'
451
+ : (event.autoPilotDecision ??
452
+ options.autoPilotDecision ??
453
+ horizonConfig?.autoPilotDecision ??
454
+ (isNativePreModelSwitch ? 'ask' : 'deny'));
455
+
456
+ const apiCallsCompletedRaw =
457
+ event.api_calls_completed ??
458
+ event.apiCallsCompleted ??
459
+ sessionCal?.apiCallsCompleted;
460
+ const apiCallsCompleted =
461
+ apiCallsCompletedRaw !== undefined &&
462
+ apiCallsCompletedRaw !== null &&
463
+ Number.isFinite(Number(apiCallsCompletedRaw))
464
+ ? Math.max(0, Number(apiCallsCompletedRaw))
465
+ : undefined;
466
+ const explicitRptRaw =
467
+ event.requests_per_turn ?? event.requestsPerTurn ?? options.requestsPerTurn;
468
+ const rptShrinkageMinTurns = Number(
469
+ options.rptShrinkageMinTurns ?? horizonConfig?.thresholds?.rptShrinkageMinTurns ?? 5
470
+ );
471
+ const rptShrinkagePriorDefault = Number(
472
+ options.rptShrinkagePrior ??
473
+ horizonConfig?.thresholds?.rptShrinkagePrior ??
474
+ DEFAULT_RPT_SHRINKAGE_PRIOR
475
+ );
476
+ let requestsPerTurn;
477
+ let rptEstimateSource = `placeholder_rpt_prior_${rptShrinkagePriorDefault}`;
478
+ let rptSampleSize = 0;
479
+ let rawRollingMedianRequestsPerTurn = sessionCal?.rollingMedianRequestsPerTurn ?? null;
480
+ let rawCumulativeRequestsPerTurn = sessionCal?.requestsPerTurn ?? null;
481
+ let rptShrinkageWeight = 0;
482
+ let rptPriorUsed = rptShrinkagePriorDefault;
483
+ let isPlaceholderRptPrior = true;
484
+ let rptTurnsAgree = false;
485
+ let rptEffectiveMinTrustedTurns = rptShrinkageMinTurns;
486
+
487
+ if (
488
+ explicitRptRaw !== undefined &&
489
+ explicitRptRaw !== null &&
490
+ Number.isFinite(Number(explicitRptRaw)) &&
491
+ Number(explicitRptRaw) > 0
492
+ ) {
493
+ requestsPerTurn = Number(explicitRptRaw);
494
+ rptEstimateSource = 'explicit';
495
+ rptSampleSize = Number(sessionCal?.rptSampleSize ?? sessionCal?.turnsCompleted ?? 0);
496
+ rptShrinkageWeight = 1;
497
+ rptPriorUsed = null;
498
+ isPlaceholderRptPrior = false;
499
+ rptTurnsAgree = false;
500
+ rptEffectiveMinTrustedTurns = rptShrinkageMinTurns;
501
+ } else if (sessionCal) {
502
+ const localMedianRpt =
503
+ options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn ?? null;
504
+ const hasLocalRptPrior =
505
+ options.useLocalRptPrior !== false &&
506
+ Number.isFinite(Number(localMedianRpt)) &&
507
+ Number(localMedianRpt) >= 1;
508
+ const rawRollingRpt =
509
+ sessionCal.rollingMedianRequestsPerTurn ?? sessionCal.requestsPerTurn ?? null;
510
+ const sampleTurns = Number(
511
+ sessionCal.rptSampleSize ??
512
+ (Array.isArray(sessionCal.recentTurnRequestCounts)
513
+ ? sessionCal.recentTurnRequestCounts.length
514
+ : sessionCal.turnsCompleted || 0)
515
+ );
516
+ const shrunkRpt = shrinkRollingRequestsPerTurn(rawRollingRpt, sampleTurns, {
517
+ minTrustedTurns: rptShrinkageMinTurns,
518
+ priorRequestsPerTurn: hasLocalRptPrior ? localMedianRpt : rptShrinkagePriorDefault,
519
+ priorSource: hasLocalRptPrior ? 'local_transcripts' : 'placeholder',
520
+ recentTurnRequestCounts: sessionCal.recentTurnRequestCounts
521
+ });
522
+ requestsPerTurn = shrunkRpt.expectedRequestsPerTurn;
523
+ rptEstimateSource = shrunkRpt.source;
524
+ rptSampleSize = shrunkRpt.sampleSize;
525
+ rawRollingMedianRequestsPerTurn = shrunkRpt.rawRollingMedianRequestsPerTurn;
526
+ rptShrinkageWeight = shrunkRpt.shrinkageWeight;
527
+ rptPriorUsed = shrunkRpt.priorRequestsPerTurn;
528
+ isPlaceholderRptPrior = shrunkRpt.isPlaceholderShrinkagePrior;
529
+ rptTurnsAgree = shrunkRpt.turnsAgree;
530
+ rptEffectiveMinTrustedTurns = shrunkRpt.effectiveMinTrustedTurns;
531
+ } else if (
532
+ options.useLocalRptPrior !== false &&
533
+ Number.isFinite(Number(options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn)) &&
534
+ Number(options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn) >= 1
535
+ ) {
536
+ requestsPerTurn = Number(
537
+ Number(options.historicalSessionRequestsPerTurn ?? localPriors?.medianRequestsPerTurn).toFixed(4)
538
+ );
539
+ rptEstimateSource = 'local_transcript_rpt_prior';
540
+ rptPriorUsed = requestsPerTurn;
541
+ isPlaceholderRptPrior = false;
542
+ }
543
+
544
+ const explicitGrowthRaw =
545
+ event.context_growth_per_turn ?? event.contextGrowthPerTurn ?? options.contextGrowthPerTurn;
546
+ const allowObservedGrowth =
547
+ (event.useObservedPromptGrowth ?? options.useObservedPromptGrowth) !== false;
548
+ let contextGrowthPerTurn = 0;
549
+ let promptGrowthEstimateSource = 'default_0';
550
+ let promptGrowthSampleSize = Number(sessionCal?.promptGrowthSampleSize ?? 0);
551
+ const hasRecentRptHistory =
552
+ Array.isArray(sessionCal?.recentTurnRequestCounts) &&
553
+ sessionCal.recentTurnRequestCounts.length >= 2;
554
+ const growthRegimeTrusted =
555
+ turnsCompleted >= 5 &&
556
+ promptGrowthSampleSize >= 4 &&
557
+ (!hasRecentRptHistory || Boolean(rptTurnsAgree));
558
+ if (
559
+ explicitGrowthRaw !== undefined &&
560
+ explicitGrowthRaw !== null &&
561
+ Number.isFinite(Number(explicitGrowthRaw)) &&
562
+ Number(explicitGrowthRaw) >= 0
563
+ ) {
564
+ contextGrowthPerTurn = Math.max(0, Math.round(Number(explicitGrowthRaw)));
565
+ promptGrowthEstimateSource = 'explicit';
566
+ } else if (
567
+ allowObservedGrowth &&
568
+ sessionCal?.rollingMedianPromptGrowthTokens !== null &&
569
+ sessionCal?.rollingMedianPromptGrowthTokens !== undefined &&
570
+ Number.isFinite(Number(sessionCal.rollingMedianPromptGrowthTokens)) &&
571
+ Number(sessionCal.rollingMedianPromptGrowthTokens) >= 0
572
+ ) {
573
+ if (growthRegimeTrusted) {
574
+ contextGrowthPerTurn = Math.max(
575
+ 0,
576
+ Math.round(Number(sessionCal.rollingMedianPromptGrowthTokens))
577
+ );
578
+ promptGrowthEstimateSource = 'stop_hook_rolling_growth_median';
579
+ } else {
580
+ contextGrowthPerTurn = 0;
581
+ promptGrowthEstimateSource =
582
+ turnsCompleted < 5
583
+ ? 'capped_early_session_no_extrapolation'
584
+ : 'capped_unstable_regime_no_extrapolation';
585
+ }
586
+ }
587
+ const contextCeilingRaw =
588
+ event.context_ceiling ??
589
+ event.contextCeiling ??
590
+ event.context_window_size ??
591
+ event.contextWindowSize ??
592
+ event.context_window?.context_window_size ??
593
+ options.contextCeiling ??
594
+ liveState?.contextWindow?.contextCeiling;
595
+ const contextCeiling =
596
+ contextCeilingRaw !== undefined &&
597
+ contextCeilingRaw !== null &&
598
+ Number.isFinite(Number(contextCeilingRaw)) &&
599
+ Number(contextCeilingRaw) >= 10_000
600
+ ? Math.round(Number(contextCeilingRaw))
601
+ : undefined;
602
+
603
+ const shrinkageMinTurns = Number(
604
+ options.outputShrinkageMinTurns ?? horizonConfig?.thresholds?.outputShrinkageMinTurns ?? 5
605
+ );
606
+ const shrinkagePriorTokens = Number(
607
+ options.outputShrinkagePriorTokens ?? horizonConfig?.thresholds?.outputShrinkagePriorTokens ?? 500
608
+ );
609
+
610
+ let resolvedExpectedOutputTokens =
611
+ event.expectedOutputTokens ?? event.expected_output_tokens ?? options.expectedOutputTokens;
612
+ let outputEstimateSource =
613
+ resolvedExpectedOutputTokens !== undefined ? 'explicit' : 'default_1500';
614
+ let outputSampleSize = 0;
615
+ let rawRollingMedianOutputTokens = null;
616
+ let shrinkageWeight = resolvedExpectedOutputTokens !== undefined ? 1 : 0;
617
+ const allowObservedOutput =
618
+ (event.useObservedOutputTokens ?? options.useObservedOutputTokens) !== false;
619
+ if (resolvedExpectedOutputTokens === undefined && allowObservedOutput) {
620
+ const turnsDone = Number(liveState?.turnsCompleted || 0);
621
+ const cumOut =
622
+ Number(liveState?.cumulative?.outputTokens || 0) +
623
+ Number(liveState?.cumulative?.thinkingTokens || 0);
624
+ const lastOut =
625
+ Number(liveState?.contextWindow?.lastOutputTokens || 0) +
626
+ Number(liveState?.contextWindow?.lastThinkingTokens || 0);
627
+ if (Number(sessionCal?.rollingMedianOutputTokens) > 0) {
628
+ const calSampleSize = Math.max(
629
+ 1,
630
+ Number(
631
+ sessionCal.outputSampleSize ??
632
+ (Array.isArray(sessionCal.recentTurnOutputs)
633
+ ? sessionCal.recentTurnOutputs.length
634
+ : sessionCal.turnsCompleted || 0)
635
+ )
636
+ );
637
+ const shrunk = shrinkRollingOutputEstimate(
638
+ sessionCal.rollingMedianOutputTokens,
639
+ calSampleSize,
640
+ { minTrustedTurns: shrinkageMinTurns, priorTokens: shrinkagePriorTokens }
641
+ );
642
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
643
+ outputEstimateSource = shrunk.source;
644
+ outputSampleSize = shrunk.sampleSize;
645
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
646
+ shrinkageWeight = shrunk.shrinkageWeight;
647
+ } else if (Number(liveState?.rollingMedianOutputTokens) > 0) {
648
+ const liveSampleSize = Math.max(1, turnsDone);
649
+ const shrunk = shrinkRollingOutputEstimate(
650
+ liveState.rollingMedianOutputTokens,
651
+ liveSampleSize,
652
+ { minTrustedTurns: shrinkageMinTurns, priorTokens: shrinkagePriorTokens }
653
+ );
654
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
655
+ outputEstimateSource =
656
+ shrunk.shrinkageWeight < 1 ? 'live_state_shrunk_median' : 'live_state_rolling_median';
657
+ outputSampleSize = shrunk.sampleSize;
658
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
659
+ shrinkageWeight = shrunk.shrinkageWeight;
660
+ } else if (turnsDone > 0 && cumOut > 0) {
661
+ const shrunk = shrinkRollingOutputEstimate(Math.round(cumOut / turnsDone), turnsDone, {
662
+ minTrustedTurns: shrinkageMinTurns,
663
+ priorTokens: shrinkagePriorTokens
664
+ });
665
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
666
+ outputEstimateSource =
667
+ shrunk.shrinkageWeight < 1 ? 'live_state_shrunk_mean' : 'live_state_mean';
668
+ outputSampleSize = shrunk.sampleSize;
669
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
670
+ shrinkageWeight = shrunk.shrinkageWeight;
671
+ } else if (lastOut > 0) {
672
+ const shrunk = shrinkRollingOutputEstimate(lastOut, 1, {
673
+ minTrustedTurns: shrinkageMinTurns,
674
+ priorTokens: shrinkagePriorTokens
675
+ });
676
+ resolvedExpectedOutputTokens = shrunk.expectedOutputTokens;
677
+ outputEstimateSource = 'live_state_shrunk_last';
678
+ outputSampleSize = 1;
679
+ rawRollingMedianOutputTokens = shrunk.rawRollingMedianOutputTokens;
680
+ shrinkageWeight = shrunk.shrinkageWeight;
681
+ }
682
+ }
683
+
684
+ let verdict = router.evaluateModelSwitch({
685
+ currentModel,
686
+ targetModel,
687
+ cachedTokens,
688
+ uncachedDeltaTokens,
689
+ uncachedWriteTokens,
690
+ justCompacted,
691
+ totalPromptTokens,
692
+ cacheWarm,
693
+ cacheTtlTier,
694
+ turnsCompleted,
695
+ ...(apiCallsCompleted !== undefined ? { apiCallsCompleted } : {}),
696
+ ...(requestsPerTurn !== undefined ? { requestsPerTurn } : {}),
697
+ ...(contextGrowthPerTurn > 0 ? { contextGrowthPerTurn } : {}),
698
+ ...(contextCeiling !== undefined ? { contextCeiling } : {}),
699
+ initialPrefixTokens: sessionCal?.initialPrefixTokens,
700
+ expectedOutputTokens: resolvedExpectedOutputTokens ?? 1500,
701
+ ...(event.minSwitchPenaltyUSD !== undefined ||
702
+ event.min_switch_penalty_usd !== undefined ||
703
+ options.minSwitchPenaltyUSD !== undefined ||
704
+ horizonConfig?.thresholds?.minSwitchPenaltyUSD !== undefined
705
+ ? {
706
+ minSwitchPenaltyUSD:
707
+ event.minSwitchPenaltyUSD ??
708
+ event.min_switch_penalty_usd ??
709
+ options.minSwitchPenaltyUSD ??
710
+ horizonConfig?.thresholds?.minSwitchPenaltyUSD
711
+ }
712
+ : {}),
713
+ ...(event.notableAllowPenaltyUSD !== undefined ||
714
+ event.notable_allow_penalty_usd !== undefined ||
715
+ options.notableAllowPenaltyUSD !== undefined ||
716
+ horizonConfig?.thresholds?.notableAllowPenaltyUSD !== undefined
717
+ ? {
718
+ notableAllowPenaltyUSD:
719
+ event.notableAllowPenaltyUSD ??
720
+ event.notable_allow_penalty_usd ??
721
+ options.notableAllowPenaltyUSD ??
722
+ horizonConfig?.thresholds?.notableAllowPenaltyUSD
723
+ }
724
+ : {}),
725
+ ...(rawRemainingTurns !== undefined && rawRemainingTurns !== null
726
+ ? { expectedRemainingTurns: Number(rawRemainingTurns) }
727
+ : useEmpiricalHorizonPrior
728
+ ? { useEmpiricalHorizonPrior: true }
729
+ : {}),
730
+ strictBlock:
731
+ det08Override === 'block' ? true : (event.strictBlock ?? options.strictBlock),
732
+ autoPilotDecision: resolvedAutoPilotDecision
733
+ });
734
+
735
+ if (det08Override === 'warn' && verdict.blocked) {
736
+ verdict = {
737
+ ...verdict,
738
+ decision: 'allow',
739
+ blocked: false,
740
+ advisory: true,
741
+ overriddenByConfig: 'warn'
742
+ };
743
+ } else if (det08Override === 'block' && verdict.breakEven?.shouldHoldModel && !verdict.blocked) {
744
+ verdict = {
745
+ ...verdict,
746
+ decision: 'deny',
747
+ blocked: true,
748
+ advisory: false,
749
+ overriddenByConfig: 'block'
750
+ };
751
+ }
752
+
753
+ const isHeldDownshift = Boolean(
754
+ (verdict.blocked || verdict.advisory) &&
755
+ verdict.breakEven?.shouldHoldModel &&
756
+ !verdict.belowMinSwitchPenaltyUSD &&
757
+ !verdict.breakEven?.isCapabilityUpshift &&
758
+ !verdict.breakEven?.unknownModel &&
759
+ verdict.breakEven?.currentModel &&
760
+ verdict.breakEven?.targetModel &&
761
+ verdict.breakEven.currentModel !== verdict.breakEven.targetModel
762
+ );
763
+ const recordedPendingDownshift = isHeldDownshift
764
+ ? {
765
+ fromModel: verdict.breakEven.currentModel,
766
+ toModel: verdict.breakEven.targetModel,
767
+ recordedAt: new Date(nowMs).toISOString()
768
+ }
769
+ : null;
770
+
771
+ if (shouldPersistBreaker) {
772
+ if (recordedPendingDownshift) {
773
+ writeBreakerStateSnapshot(
774
+ sessionId,
775
+ {
776
+ ...(breakerSnap || {}),
777
+ updatedAt: nowMs,
778
+ pending_downshift: recordedPendingDownshift,
779
+ pendingDownshiftModel: recordedPendingDownshift.toModel,
780
+ lastModelId: verdict.breakEven.currentModel,
781
+ lastContextTokens: cachedTokens
782
+ },
783
+ cwdOptions
784
+ );
785
+ } else if (
786
+ !verdict.blocked &&
787
+ !verdict.advisory &&
788
+ breakerSnap &&
789
+ (breakerSnap.pending_downshift || breakerSnap.pendingDownshiftModel || breakerSnap.justCompacted)
790
+ ) {
791
+ writeBreakerStateSnapshot(
792
+ sessionId,
793
+ {
794
+ ...breakerSnap,
795
+ updatedAt: nowMs,
796
+ pending_downshift: null,
797
+ pendingDownshiftModel: null,
798
+ justCompacted: false
799
+ },
800
+ cwdOptions
801
+ );
802
+ }
803
+ }
804
+
805
+ verdict = {
806
+ ...verdict,
807
+ ...(recordedPendingDownshift ? { pending_downshift: recordedPendingDownshift } : {}),
808
+ turnsCompletedUsed: turnsCompleted,
809
+ apiCallsCompletedUsed: apiCallsCompleted ?? null,
810
+ requestsPerTurnUsed: verdict.breakEven?.requestsPerTurn ?? requestsPerTurn ?? 1,
811
+ rptEstimateSource,
812
+ rptSampleSize,
813
+ rawRollingMedianRequestsPerTurn,
814
+ rawCumulativeRequestsPerTurn,
815
+ rptShrinkageWeight,
816
+ rptPriorUsed,
817
+ isPlaceholderRptPrior,
818
+ rptTurnsAgree,
819
+ rptEffectiveMinTrustedTurns,
820
+ contextGrowthPerTurnUsed: verdict.breakEven?.contextGrowthPerTurn ?? contextGrowthPerTurn ?? 0,
821
+ promptGrowthEstimateSource,
822
+ promptGrowthSampleSize,
823
+ outputEstimateSource,
824
+ outputSampleSize,
825
+ rawRollingMedianOutputTokens,
826
+ shrinkageWeight
827
+ };
828
+
829
+ const interceptionLogPath =
830
+ options.interceptionLogPath || globalThis.process?.env?.AH_INTERCEPTION_LOG_PATH;
831
+ if (typeof interceptionLogPath === 'string' && interceptionLogPath.trim()) {
832
+ try {
833
+ const logTarget = interceptionLogPath.trim();
834
+ const logDir = path.dirname(logTarget);
835
+ if (logDir && logDir !== '.' && !fs.existsSync(logDir)) {
836
+ fs.mkdirSync(logDir, { recursive: true });
837
+ }
838
+ fs.appendFileSync(
839
+ logTarget,
840
+ `${JSON.stringify({
841
+ timestampMs: nowMs,
842
+ sessionId,
843
+ fromModel: currentModel,
844
+ toModel: targetModel,
845
+ turnsCompletedUsed: turnsCompleted,
846
+ apiCallsCompleted: apiCallsCompleted ?? null,
847
+ requestsPerTurn: verdict.breakEven?.requestsPerTurn ?? requestsPerTurn ?? null,
848
+ rptEstimateSource,
849
+ rptSampleSize,
850
+ rawRollingMedianRequestsPerTurn,
851
+ rawCumulativeRequestsPerTurn,
852
+ rptShrinkageWeight,
853
+ rptPriorUsed,
854
+ isPlaceholderRptPrior,
855
+ rptTurnsAgree,
856
+ rptEffectiveMinTrustedTurns,
857
+ contextGrowthPerTurn: verdict.breakEven?.contextGrowthPerTurn ?? contextGrowthPerTurn ?? 0,
858
+ promptGrowthEstimateSource,
859
+ promptGrowthSampleSize,
860
+ outputEstimateSource,
861
+ outputSampleSize,
862
+ rawRollingMedianOutputTokens,
863
+ shrinkageWeight,
864
+ expectedOutputTokens: verdict.breakEven?.expectedOutputTokens ?? null,
865
+ cachedTokens,
866
+ breakEvenTokens: verdict.breakEven?.breakEvenTokens ?? null,
867
+ horizonMaxCachedTokens:
868
+ verdict.breakEven?.horizonMaxCachedTokens === Infinity
869
+ ? 'Infinity'
870
+ : (verdict.breakEven?.horizonMaxCachedTokens ?? null),
871
+ coldWritePenaltyUSD: verdict.breakEven?.coldWritePenaltyUSD ?? null,
872
+ perTurnPostSwitchSavingUSD: verdict.breakEven?.perTurnPostSwitchSavingUSD ?? null,
873
+ averagePostSwitchSavingUSD: verdict.breakEven?.averagePostSwitchSavingUSD ?? null,
874
+ horizonNetSavingsUSD: verdict.breakEven?.horizonNetSavingsUSD ?? null,
875
+ paybackTurns: verdict.breakEven?.paybackTurns ?? null,
876
+ paybackWarmRequests: verdict.breakEven?.paybackWarmRequests ?? null,
877
+ expectedRemainingTurns: verdict.breakEven?.expectedRemainingTurns ?? null,
878
+ postSwitchRemainingTurns: verdict.breakEven?.postSwitchRemainingTurns ?? null,
879
+ expectedRemainingRequests: verdict.breakEven?.expectedRemainingRequests ?? null,
880
+ horizonUnit: verdict.breakEven?.horizonUnit ?? 'turns',
881
+ priorNativeUnit: verdict.breakEven?.priorNativeUnit ?? null,
882
+ priorBucket: verdict.breakEven?.priorBucket ?? null,
883
+ isPlaceholderPrior: Boolean(verdict.breakEven?.isPlaceholderPrior),
884
+ horizonPriorSource: verdict.breakEven?.horizonPriorSource ?? null,
885
+ contextCeilingUsed: verdict.breakEven?.contextCeilingUsed ?? null,
886
+ initialPrefixTokensUsed: verdict.breakEven?.initialPrefixTokensUsed ?? null,
887
+ belowMinSwitchPenaltyUSD: Boolean(verdict.belowMinSwitchPenaltyUSD),
888
+ minSwitchPenaltyUSD: verdict.minSwitchPenaltyUSD ?? null,
889
+ notableAllowNote: verdict.notableAllowNote ?? null,
890
+ ruleVersion: verdict.breakEven?.ruleVersion ?? null,
891
+ decision: verdict.decision,
892
+ reason: verdict.reason ?? null
893
+ })}\n`,
894
+ 'utf8'
895
+ );
896
+ } catch {
897
+ // Never fail PreModelSwitch hook on diagnostic log write
898
+ }
899
+ }
900
+
901
+ const shouldRecordSwitchTelemetry =
902
+ options.recordSwitchTelemetry !== false &&
903
+ Boolean(
904
+ options.cliInvocation ||
905
+ options.homeDir ||
906
+ options.telemetryPath ||
907
+ options.recordSwitchTelemetry ||
908
+ globalThis.process?.env?.AH_MODEL_SWITCH_TELEMETRY_PATH
909
+ );
910
+ if (shouldRecordSwitchTelemetry) {
911
+ try {
912
+ recordPreModelSwitchEvent(event, verdict.decision, {
913
+ homeDir: options.homeDir,
914
+ telemetryPath: options.telemetryPath
915
+ });
916
+ } catch {
917
+ // Never fail PreModelSwitch hook on local acceptance telemetry error
918
+ }
919
+ }
920
+
921
+ const avoidedPenaltyUSD = Math.max(
922
+ 0,
923
+ Number(verdict.breakEven?.coldWritePenaltyUSD ?? 0)
924
+ );
925
+
926
+ if (
927
+ (verdict.blocked || verdict.decision === 'ask') &&
928
+ cachedTokens > 0 &&
929
+ avoidedPenaltyUSD > 0 &&
930
+ options.recordLedger !== false &&
931
+ Boolean(event.cwd || options.cwd || options.ledgerPath || options.recordLedger)
932
+ ) {
933
+ recordInterventionSavings(
934
+ {
935
+ sessionId,
936
+ category: 'DET_08_MODEL_SWITCH_HOLD',
937
+ modelId: currentModel,
938
+ savedTokens: cachedTokens,
939
+ savedUSD: avoidedPenaltyUSD,
940
+ dedupeId: event.turn_id || event.turnId || `${currentModel}->${targetModel}:${cachedTokens}`,
941
+ detail: `DET-08 held warm prefix (${cachedTokens.toLocaleString()} tok) on ${currentModel} vs ${targetModel}`
942
+ },
943
+ cwdOptions
944
+ );
945
+ }
946
+
947
+ if (!verdict.blocked) {
948
+ if (verdict.advisory && verdict.reason) {
949
+ const hookSpecificOutput = {
950
+ hookEventName: 'PreModelSwitch',
951
+ permissionDecision: 'allow',
952
+ additionalContext: verdict.reason
953
+ };
954
+ return {
955
+ exitCode: 0,
956
+ stdout: JSON.stringify({ hookSpecificOutput }),
957
+ stderr: '',
958
+ verdict
959
+ };
960
+ }
961
+ if (verdict.notableAllowNote) {
962
+ const hookSpecificOutput = {
963
+ hookEventName: 'PreModelSwitch',
964
+ permissionDecision: 'allow',
965
+ permissionDecisionReason: verdict.notableAllowNote
966
+ };
967
+ return {
968
+ exitCode: 0,
969
+ stdout: JSON.stringify({
970
+ systemMessage: verdict.notableAllowNote,
971
+ hookSpecificOutput
972
+ }),
973
+ stderr: '',
974
+ verdict
975
+ };
976
+ }
977
+ return {
978
+ exitCode: 0,
979
+ stdout: '',
980
+ stderr: '',
981
+ verdict
982
+ };
983
+ }
984
+
985
+ if (options.useJsonDecision || verdict.decision === 'ask') {
986
+ const hookSpecificOutput = {
987
+ hookEventName: 'PreModelSwitch',
988
+ permissionDecision: verdict.decision === 'ask' ? 'ask' : 'deny',
989
+ permissionDecisionReason: verdict.reason
990
+ };
991
+ return {
992
+ exitCode: 0,
993
+ stdout: JSON.stringify({ hookSpecificOutput }),
994
+ stderr: '',
995
+ verdict
996
+ };
997
+ }
998
+
999
+ return {
1000
+ exitCode: 2,
1001
+ stdout: '',
1002
+ stderr: verdict.reason,
1003
+ verdict
1004
+ };
1005
+ }
1006
+
1007
+ /**
1008
+ * Fail-closed CLI runner for `PreModelSwitch` (`ISS-035`).
1009
+ * Any uncaught error exits `2` via `exitHardBlockStderr`.
1010
+ *
1011
+ * @param {object} [cliOptions={}]
1012
+ */
1013
+ export async function executePreModelSwitchCli(cliOptions = {}) {
1014
+ const readPayload = cliOptions.readPayload || readStdinJsonAsync;
1015
+ const runHook = cliOptions.runHook || runPreModelSwitchHook;
1016
+ const ioOverride = cliOptions.ioOverride || {};
1017
+ const isRealCliRun =
1018
+ !cliOptions.ioOverride && !cliOptions.readPayload && !cliOptions.runHook;
1019
+ try {
1020
+ const payload = await readPayload(cliOptions.timeoutMs);
1021
+ const res = runHook(payload, {
1022
+ cliInvocation: isRealCliRun,
1023
+ ...(cliOptions.hookOptions || {})
1024
+ });
1025
+ if (res.exitCode === 2) {
1026
+ exitHardBlockStderr(res.stderr, 'PreModelSwitch', ioOverride);
1027
+ } else if (res.stdout) {
1028
+ exitWithStdoutJson(res.stdout, ioOverride);
1029
+ } else {
1030
+ exitPassThrough(ioOverride.exitFn);
1031
+ }
1032
+ } catch (err) {
1033
+ exitHardBlockStderr(
1034
+ `[Highbeam Fail-Closed] ${err?.message || String(err)}`,
1035
+ 'PreModelSwitch',
1036
+ ioOverride
1037
+ );
1038
+ }
1039
+ }
1040
+
1041
+ if (isCliEntrypoint(import.meta.url)) {
1042
+ executePreModelSwitchCli().catch((err) => {
1043
+ exitHardBlockStderr(
1044
+ `[Highbeam Fail-Closed] ${err?.message || String(err)}`,
1045
+ 'PreModelSwitch'
1046
+ );
1047
+ });
1048
+ }