ctxtop 4.1.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (318) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +51 -44
  4. package/LICENSE +27 -27
  5. package/README.md +90 -56
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ctxtop.mjs +267 -54
  9. package/config/modelCatalog.json +847 -273
  10. package/hooks/handlers/hookIpcClient.mjs +8 -4
  11. package/hooks/handlers/post-model-switch.mjs +39 -2
  12. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  13. package/hooks/handlers/post-tool-use.mjs +54 -321
  14. package/hooks/handlers/pre-model-switch.mjs +115 -5
  15. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  16. package/hooks/handlers/pre-tool-use.mjs +61 -571
  17. package/hooks/handlers/stop-gate.mjs +20 -8
  18. package/hooks/handlers/user-prompt-submit.mjs +111 -2
  19. package/hooks/post_tool_use.mjs +17 -4
  20. package/hooks/pre_tool_use.mjs +84 -54
  21. package/hooks.json +56 -56
  22. package/package.json +4 -3
  23. package/packages/antigravity/package.json +10 -3
  24. package/packages/antigravity/src/adapter.mjs +109 -0
  25. package/packages/antigravity/src/index.mjs +7 -1
  26. package/packages/claude-code/package.json +10 -3
  27. package/packages/claude-code/src/adapter.mjs +194 -0
  28. package/packages/claude-code/src/index.mjs +8 -2
  29. package/packages/claude-code/src/register.js +726 -0
  30. package/packages/core/package.json +6 -2
  31. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  32. package/packages/core/src/catalog/index.mjs +1 -0
  33. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  34. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  35. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  36. package/packages/core/src/coach/microSkills.mjs +1 -0
  37. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  38. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  39. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  40. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  41. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  42. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  43. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  44. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  45. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  46. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  47. package/packages/core/src/control/callTree.mjs +338 -0
  48. package/packages/core/src/control/coachLatches.mjs +126 -0
  49. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  50. package/packages/core/src/control/index.mjs +49 -0
  51. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  52. package/packages/core/src/control/toolSuspension.mjs +197 -0
  53. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  54. package/packages/core/src/diagnostics/index.mjs +9 -0
  55. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  56. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  57. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  58. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  59. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  60. package/packages/core/src/economics/driftLatency.mjs +433 -0
  61. package/packages/core/src/economics/dualTtl.mjs +198 -0
  62. package/packages/core/src/economics/index.mjs +47 -0
  63. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  64. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  65. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  66. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  67. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  68. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  69. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  70. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  71. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  72. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  73. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  74. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  75. package/packages/core/src/index.js +27 -0
  76. package/packages/core/src/index.mjs +25 -1
  77. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  78. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  79. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  80. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  81. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  82. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  83. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  84. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  85. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  86. package/packages/core/src/ui/modViews.mjs +1558 -0
  87. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  88. package/packages/core/src/ustf/index.mjs +7 -0
  89. package/packages/core/src/ustf/normalizer.mjs +512 -0
  90. package/packages/core/src/ustf/schema.mjs +186 -0
  91. package/packages/core/src/utils/runtime.mjs +962 -0
  92. package/packages/engine-node/package.json +6 -2
  93. package/packages/engine-node/src/db/index.mjs +58 -0
  94. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  95. package/packages/engine-node/src/db/probe.mjs +342 -0
  96. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  97. package/packages/engine-node/src/index.mjs +11 -1
  98. package/packages/engine-node/src/ipc/client.mjs +447 -0
  99. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  100. package/packages/engine-node/src/ipc/index.mjs +24 -0
  101. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  102. package/packages/engine-node/src/ipc/server.mjs +445 -0
  103. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  104. package/packages/engine-node/src/offloader/index.mjs +6 -0
  105. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  106. package/packages/engine-node/src/rsl/index.mjs +3 -0
  107. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  108. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  109. package/packages/engine-node/src/sensors/index.mjs +7 -0
  110. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  111. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  112. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  113. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  114. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  115. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  116. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  117. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  118. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  119. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  120. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  121. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  122. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  123. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  124. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  125. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  126. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  127. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  128. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  129. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  181. package/packages/mcp/package.json +7 -3
  182. package/packages/mcp/src/server.mjs +115 -14
  183. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  184. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  185. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  186. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  187. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  188. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  189. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  190. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  191. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  192. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  193. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  194. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  195. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  196. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  197. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  198. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  199. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  200. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  201. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  202. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  203. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  204. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  256. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  257. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  258. package/packages/pro/package.json +23 -16
  259. package/packages/pro/src/index.mjs +9 -3
  260. package/packages/pro/src/pro_license.mjs +547 -0
  261. package/packages/pro/src/team_finops_pack.mjs +241 -241
  262. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  263. package/plugin.json +1 -1
  264. package/sidecars/horizon-daemon/server.mjs +482 -44
  265. package/src/cli/doctor.mjs +11 -2
  266. package/src/cli/horizon_hud.mjs +31 -15
  267. package/src/cli/init.mjs +46 -13
  268. package/src/config/modelCatalog.json +886 -231
  269. package/src/core/classifier.mjs +25 -11
  270. package/src/core/coach/circuit_breakers.mjs +84 -6
  271. package/src/core/coach/task_quota_router.mjs +8 -0
  272. package/src/core/code_fold_lite.mjs +169 -0
  273. package/src/core/config.mjs +44 -0
  274. package/src/core/constants.mjs +175 -12
  275. package/src/core/detectors_det01_to_16.mjs +44 -3
  276. package/src/core/fts5_output_compressor.mjs +272 -35
  277. package/src/core/horizon_config.mjs +42 -0
  278. package/src/core/parser.mjs +86 -11
  279. package/src/core/pro_license.mjs +174 -12
  280. package/src/core/pruner.mjs +7 -146
  281. package/src/core/quota.mjs +14 -2
  282. package/src/core/rsl_distiller.mjs +31 -9
  283. package/src/core/rsl_ledger.mjs +66 -6
  284. package/src/core/rsl_triage.mjs +159 -17
  285. package/src/core/session_auditor.mjs +476 -25
  286. package/src/core/shadow_auto_ledger.mjs +205 -0
  287. package/src/core/sqlite_client.mjs +10 -4
  288. package/src/core/subagents.mjs +18 -2
  289. package/src/core/task_quota_router.mjs +61 -4
  290. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  291. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  292. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +54 -20
  293. package/src/core-isomorphic/config/anthropicModelCatalog.json +1 -0
  294. package/src/core-isomorphic/config/catalogLoader.mjs +6 -3
  295. package/src/core-isomorphic/config/horizonConfig.mjs +1 -1
  296. package/src/core-isomorphic/economics/cacheGravity.mjs +3 -1
  297. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  298. package/src/core-isomorphic/guards/bucketBGamma.mjs +1 -1
  299. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +77 -1
  300. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +395 -130
  301. package/src/core-isomorphic/ui/modViews.mjs +62 -8
  302. package/src/diagnostics/claudeHookCapabilities.mjs +32 -2
  303. package/src/diagnostics/doctorEngine.mjs +28 -2
  304. package/src/engine-node/ipc/fast_client.mjs +191 -0
  305. package/src/engine-node/ipc/index.mjs +2 -0
  306. package/src/engine-node/multi_host_mcp.mjs +168 -0
  307. package/src/hooks/antigravity_rsl_hook.mjs +24 -2
  308. package/src/hooks/claude_rsl_hook.mjs +22 -2
  309. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  310. package/src/hooks/fast_hook_ipc.mjs +295 -0
  311. package/src/hooks/post_invocation.mjs +37 -597
  312. package/src/hooks/post_invocation_core.mjs +623 -0
  313. package/src/hooks/pre_invocation.mjs +103 -1668
  314. package/src/hooks/pre_invocation_core.mjs +1830 -0
  315. package/src/utils/sessionCalibration.mjs +52 -5
  316. package/src/webview/advanced_view.html +34 -18
  317. package/src/webview/horizon_panel.html +3233 -675
  318. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,464 @@
1
+ /**
2
+ * @file src/coach/ttlWatchdog.mjs
3
+ * 5-Minute Anthropic KV-Cache TTL Cliff Watchdog, Zero-Token `StateBaton` T-10s Pre-Snapshotter,
4
+ * and Inter-Turn Pause Distribution Analyzer (>= 3.1% 5m-to-60m pause ratio -> 1h tier recommendation).
5
+ *
6
+ * Strictly zero outbound network sockets: never sends synthetic un-credentialed HTTPS pings.
7
+ */
8
+
9
+ import {
10
+ normalizeModelId,
11
+ computeTotalPromptTokens,
12
+ resolveEffectiveRates
13
+ } from '../config/catalogLoader.mjs';
14
+ import { FLIGHT_MODES, normalizeFlightMode, isSilentOrOffMode } from './cacheGravityRouter.mjs';
15
+
16
+ export const DEFAULT_MIN_CACHED_TOKENS_FOR_WATCHDOG = 25000;
17
+ export const DEFAULT_AMBER_THRESHOLD_SECONDS = 45;
18
+ export const DEFAULT_KEEP_ALIVE_THRESHOLD_SECONDS = 15;
19
+ export const DEFAULT_SNAPSHOT_THRESHOLD_SECONDS = 10;
20
+ export const ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD = 0.031; // 3.1% (~1 in 30 turns)
21
+ export const FIVE_MINUTES_SECONDS = 300;
22
+ export const SIXTY_MINUTES_SECONDS = 3600;
23
+
24
+ /**
25
+ * Formats remaining seconds into compact `4m12s` or `42s` display format.
26
+ * @param {number} remainingSeconds
27
+ * @returns {string}
28
+ */
29
+ export function formatRemainingTtl(remainingSeconds = 0) {
30
+ const sec = Math.max(0, Math.floor(Number(remainingSeconds || 0)));
31
+ if (sec <= 0) return '0s';
32
+ const mins = Math.floor(sec / 60);
33
+ const remSec = sec % 60;
34
+ if (mins === 0) return `${remSec}s`;
35
+ return `${mins}m${String(remSec).padStart(2, '0')}s`;
36
+ }
37
+
38
+ /**
39
+ * Builds a lightweight zero-token `StateBaton` pre-snapshot at T-10s before cache expiry.
40
+ * @param {object} context
41
+ * @returns {object}
42
+ */
43
+ export function buildPreExpiryStateBaton(context = {}) {
44
+ return {
45
+ schemaVersion: '2026.11.1',
46
+ trigger: 'TTL_T_MINUS_10S_PRE_SNAPSHOT',
47
+ createdAt: context.nowMs || Date.now(),
48
+ sessionId: context.sessionId || 'default',
49
+ modelId: normalizeModelId(context.modelId || 'claude-opus-5-5'),
50
+ cachedTokensAtSnapshot: Math.max(0, Number(context.cachedTokens || 0)),
51
+ remainingSeconds: Math.max(0, Number(context.remainingSeconds || 0)),
52
+ activeGoal: context.activeGoal || 'Preserve active implementation state across 5m KV-cache TTL boundary',
53
+ workingSetFiles: Array.isArray(context.workingSetFiles) ? [...context.workingSetFiles] : [],
54
+ verifiedInvariants: Array.isArray(context.verifiedInvariants) ? [...context.verifiedInvariants] : [],
55
+ deadEndsAndFailures: Array.isArray(context.deadEndsAndFailures) ? [...context.deadEndsAndFailures] : [],
56
+ queuedCacheMutations: Array.isArray(context.queuedCacheMutations) ? [...context.queuedCacheMutations] : []
57
+ };
58
+ }
59
+
60
+ /**
61
+ * Evaluates inter-turn pause durations (in seconds) and advises upgrading the session
62
+ * cache tier to `1h` when `>= 3.1%` of pauses fall in the un-pinged 5-to-60 minute window.
63
+ *
64
+ * @param {Array<number>} pauseDurationsSeconds - Array of inter-turn pause durations in seconds
65
+ * @param {number} [thresholdRatio=0.031]
66
+ * @returns {{
67
+ * totalIntervals: number,
68
+ * fiveToSixtyMinCount: number,
69
+ * fiveToSixtyMinRatio: number,
70
+ * fiveToSixtyMinPct: number,
71
+ * thresholdRatio: number,
72
+ * recommend1hTierUpgrade: boolean,
73
+ * advisoryMessage: string | null
74
+ * }}
75
+ */
76
+ export function evaluatePauseDistribution(
77
+ pauseDurationsSeconds = [],
78
+ thresholdRatio = ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD
79
+ ) {
80
+ const validPauses = Array.isArray(pauseDurationsSeconds)
81
+ ? pauseDurationsSeconds.map((v) => Number(v)).filter((v) => Number.isFinite(v) && v >= 0)
82
+ : [];
83
+
84
+ const totalIntervals = validPauses.length;
85
+ if (totalIntervals === 0) {
86
+ return {
87
+ totalIntervals: 0,
88
+ fiveToSixtyMinCount: 0,
89
+ fiveToSixtyMinRatio: 0,
90
+ fiveToSixtyMinPct: 0,
91
+ thresholdRatio,
92
+ recommend1hTierUpgrade: false,
93
+ advisoryMessage: null
94
+ };
95
+ }
96
+
97
+ const fiveToSixtyMinCount = validPauses.filter(
98
+ (sec) => sec > FIVE_MINUTES_SECONDS && sec <= SIXTY_MINUTES_SECONDS
99
+ ).length;
100
+
101
+ const fiveToSixtyMinRatio = Number((fiveToSixtyMinCount / totalIntervals).toFixed(4));
102
+ const fiveToSixtyMinPct = Number((fiveToSixtyMinRatio * 100).toFixed(2));
103
+ const recommend1hTierUpgrade = fiveToSixtyMinRatio >= thresholdRatio;
104
+
105
+ const advisoryMessage = recommend1hTierUpgrade
106
+ ? `Inter-turn pause telemetry: ${fiveToSixtyMinPct}% of turns (${fiveToSixtyMinCount}/${totalIntervals}) ` +
107
+ `followed a 5-to-60 minute pause (>= ${(thresholdRatio * 100).toFixed(1)}% break-even threshold). ` +
108
+ `Upgrade session prompt cache tier from 5m (1.25x) to 1h (2.0x) to prevent recurring cold prefix rewrites.`
109
+ : null;
110
+
111
+ return {
112
+ totalIntervals,
113
+ fiveToSixtyMinCount,
114
+ fiveToSixtyMinRatio,
115
+ fiveToSixtyMinPct,
116
+ thresholdRatio,
117
+ recommend1hTierUpgrade,
118
+ advisoryMessage
119
+ };
120
+ }
121
+
122
+ /**
123
+ * 5-Minute TTL Cliff Watchdog.
124
+ * Tracks `prompt_cache.expires_at` on a 1-second tick, pulses amber countdown alerts at `<= 45s`,
125
+ * takes zero-token `StateBaton` pre-snapshots at `T-10s` in `AUTO_PILOT` mode, and tracks
126
+ * inter-turn pause distribution (`>= 3.1%` -> recommend `1h` cache tier).
127
+ */
128
+ export class TtlWatchdog {
129
+ /**
130
+ * @param {object} [options={}]
131
+ */
132
+ constructor(options = {}) {
133
+ this.options = options;
134
+ this.mode = normalizeFlightMode(options.mode || FLIGHT_MODES.COACH);
135
+ this.minCachedTokens = Number(
136
+ options.minCachedTokens ?? DEFAULT_MIN_CACHED_TOKENS_FOR_WATCHDOG
137
+ );
138
+ this.amberThresholdSeconds = Number(
139
+ options.amberThresholdSeconds ?? DEFAULT_AMBER_THRESHOLD_SECONDS
140
+ );
141
+ this.keepAliveThresholdSeconds = Number(
142
+ options.keepAliveThresholdSeconds ?? DEFAULT_KEEP_ALIVE_THRESHOLD_SECONDS
143
+ );
144
+ this.snapshotThresholdSeconds = Number(
145
+ options.snapshotThresholdSeconds ?? DEFAULT_SNAPSHOT_THRESHOLD_SECONDS
146
+ );
147
+ this.pauseRatioThreshold = Number(
148
+ options.pauseRatioThreshold ?? ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD
149
+ );
150
+
151
+ this.lastTurnTimestampMs = options.lastTurnTimestampMs ?? null;
152
+ this.pauseDurationsSeconds = Array.isArray(options.pauseDurationsSeconds)
153
+ ? [...options.pauseDurationsSeconds]
154
+ : [];
155
+ this.lastFileChangedAtMs = options.lastFileChangedAtMs ?? null;
156
+ this.workingSetFiles = new Set(options.workingSetFiles || []);
157
+ this.lastSnapshotExpiryCycle = null;
158
+ this.lastKeepAliveExpiryCycle = null;
159
+ this.latestSnapshot = null;
160
+ this.onSnapshotCallback = typeof options.onSnapshot === 'function' ? options.onSnapshot : null;
161
+ this.onKeepAliveCallback =
162
+ typeof options.onKeepAlive === 'function' ? options.onKeepAlive : null;
163
+ this.enableLocalKeepAlive = Boolean(options.enableLocalKeepAlive);
164
+ }
165
+
166
+ /**
167
+ * Sets Flight Computer mode (`OFF | COACH | AUTO_PILOT`).
168
+ * @param {string} mode
169
+ */
170
+ setMode(mode) {
171
+ this.mode = normalizeFlightMode(mode);
172
+ return this.mode;
173
+ }
174
+
175
+ /**
176
+ * Records a workspace `FileChanged` event so the watchdog knows active edits are in progress.
177
+ * @param {string} [filePath]
178
+ * @param {number} [nowMs=Date.now()]
179
+ */
180
+ recordFileChanged(filePath = '', nowMs = Date.now()) {
181
+ this.lastFileChangedAtMs = nowMs;
182
+ if (filePath) {
183
+ this.workingSetFiles.add(String(filePath));
184
+ }
185
+ }
186
+
187
+ /**
188
+ * Clears the recent workspace edit flag (e.g. after commit, test pass, or compaction).
189
+ */
190
+ clearRecentEdits() {
191
+ this.lastFileChangedAtMs = null;
192
+ this.workingSetFiles.clear();
193
+ }
194
+
195
+ /**
196
+ * Records a turn timestamp and updates inter-turn pause distribution telemetry.
197
+ * @param {number} [nowMs=Date.now()]
198
+ * @returns {object} Pause distribution summary
199
+ */
200
+ recordTurnTimestamp(nowMs = Date.now()) {
201
+ if (this.lastTurnTimestampMs !== null && nowMs >= this.lastTurnTimestampMs) {
202
+ const pauseSec = (nowMs - this.lastTurnTimestampMs) / 1000;
203
+ this.pauseDurationsSeconds.push(Number(pauseSec.toFixed(2)));
204
+ }
205
+ this.lastTurnTimestampMs = nowMs;
206
+ return this.getPauseDistribution();
207
+ }
208
+
209
+ /**
210
+ * Directly records an inter-turn pause duration in seconds.
211
+ * @param {number} pauseSeconds
212
+ * @returns {object} Pause distribution summary
213
+ */
214
+ recordPauseDurationSeconds(pauseSeconds) {
215
+ const sec = Number(pauseSeconds);
216
+ if (Number.isFinite(sec) && sec >= 0) {
217
+ this.pauseDurationsSeconds.push(sec);
218
+ }
219
+ return this.getPauseDistribution();
220
+ }
221
+
222
+ /**
223
+ * Evaluates current inter-turn pause distribution against the 3.1% 1h-tier threshold.
224
+ */
225
+ getPauseDistribution() {
226
+ return evaluatePauseDistribution(this.pauseDurationsSeconds, this.pauseRatioThreshold);
227
+ }
228
+
229
+ /**
230
+ * Evaluates a 1-second watchdog tick against the active prompt cache expiration deadline.
231
+ *
232
+ * @param {object} [tickState={}]
233
+ * @param {boolean} [tickState.cacheWarm=false]
234
+ * @param {number} [tickState.cachedTokens=0]
235
+ * @param {number|string|null} [tickState.expiresAt=null] - Epoch ms or ISO timestamp
236
+ * @param {number} [tickState.remainingSeconds] - Optional explicit remaining seconds
237
+ * @param {string} [tickState.modelId='claude-opus-5-5']
238
+ * @param {boolean} [tickState.hasRecentWorkspaceEdits] - Defaults to true if FileChanged recorded
239
+ * @param {string} [tickState.mode] - Optional mode override (`OFF | COACH | AUTO_PILOT`)
240
+ * @param {number} [tickState.nowMs=Date.now()]
241
+ */
242
+ evaluateTick(tickState = {}) {
243
+ const nowMs = tickState.nowMs ?? Date.now();
244
+ const activeMode = tickState.mode ? normalizeFlightMode(tickState.mode) : this.mode;
245
+ const modelId = normalizeModelId(tickState.modelId || 'claude-opus-5-5');
246
+ const cachedTokens = Math.max(0, Number(tickState.cachedTokens ?? 0));
247
+
248
+ const force5mDrop =
249
+ Boolean(tickState.aiCreditOveragesActive) ||
250
+ Boolean(tickState.isSubagent) ||
251
+ String(tickState.billingMode || '').toLowerCase() === 'api';
252
+ const effectiveTtlSeconds =
253
+ tickState.planDefaultTtlSeconds != null
254
+ ? (force5mDrop ? FIVE_MINUTES_SECONDS : Math.max(60, Number(tickState.planDefaultTtlSeconds)))
255
+ : ((tickState.cacheTtlTier || tickState.ttlTier || this.options?.cacheTtlTier) === '1h'
256
+ ? (force5mDrop ? FIVE_MINUTES_SECONDS : SIXTY_MINUTES_SECONDS)
257
+ : FIVE_MINUTES_SECONDS);
258
+ const ttlDroppedTo5m =
259
+ (tickState.planDefaultTtlSeconds != null && Number(tickState.planDefaultTtlSeconds) > FIVE_MINUTES_SECONDS && effectiveTtlSeconds === FIVE_MINUTES_SECONDS) ||
260
+ (((tickState.cacheTtlTier || tickState.ttlTier || this.options?.cacheTtlTier) === '1h') && force5mDrop);
261
+
262
+ let expiresAtMs = null;
263
+ if (typeof tickState.expiresAt === 'number' && Number.isFinite(tickState.expiresAt)) {
264
+ expiresAtMs = tickState.expiresAt < 1e11 ? tickState.expiresAt * 1000 : tickState.expiresAt;
265
+ } else if (typeof tickState.expiresAt === 'string' && tickState.expiresAt.trim()) {
266
+ const parsed = Date.parse(tickState.expiresAt);
267
+ if (!Number.isNaN(parsed)) expiresAtMs = parsed;
268
+ }
269
+
270
+ let remainingSeconds = 0;
271
+ if (typeof tickState.remainingSeconds === 'number' && Number.isFinite(tickState.remainingSeconds)) {
272
+ remainingSeconds = Math.max(0, Math.ceil(tickState.remainingSeconds));
273
+ if (expiresAtMs === null) {
274
+ expiresAtMs = nowMs + remainingSeconds * 1000;
275
+ }
276
+ } else if (expiresAtMs !== null) {
277
+ remainingSeconds = Math.max(0, Math.ceil((expiresAtMs - nowMs) / 1000));
278
+ } else if (typeof tickState.elapsedSeconds === 'number' && Number.isFinite(tickState.elapsedSeconds)) {
279
+ remainingSeconds = Math.max(0, Math.ceil(effectiveTtlSeconds - Math.max(0, tickState.elapsedSeconds)));
280
+ expiresAtMs = nowMs + remainingSeconds * 1000;
281
+ }
282
+
283
+ const cacheExpired =
284
+ typeof tickState.elapsedSeconds === 'number'
285
+ ? tickState.elapsedSeconds > effectiveTtlSeconds
286
+ : remainingSeconds <= 0 && cachedTokens > 0 && tickState.cacheWarm === false;
287
+
288
+ const cacheWarm =
289
+ tickState.cacheWarm !== undefined
290
+ ? Boolean(tickState.cacheWarm) && !cacheExpired
291
+ : cachedTokens > 0 && !cacheExpired;
292
+
293
+ const hasRecentWorkspaceEdits =
294
+ tickState.hasRecentWorkspaceEdits !== undefined
295
+ ? Boolean(tickState.hasRecentWorkspaceEdits)
296
+ : this.lastFileChangedAtMs !== null;
297
+
298
+ const tier = effectiveTtlSeconds >= SIXTY_MINUTES_SECONDS ? '1h' : '5m';
299
+ const totalPromptTokens = Math.max(cachedTokens, computeTotalPromptTokens(tickState));
300
+ const rates = resolveEffectiveRates(
301
+ tickState.modelId || 'claude-opus-5-5',
302
+ totalPromptTokens,
303
+ this.options
304
+ );
305
+ const hasKnownPrices = Boolean(rates && !rates.unknownModel && rates.readPer1M !== null);
306
+ const writeRate = hasKnownPrices
307
+ ? (tier === '1h' ? rates.write1hPer1M : rates.write5mPer1M)
308
+ : null;
309
+ // Cost of losing the warm cache and rewriting it at writeRate (1.25x 5m / 2.0x 1h) instead of reading at readPer1M
310
+ const expiryPenaltyUSD = hasKnownPrices
311
+ ? Number(((cachedTokens / 1_000_000) * (writeRate - rates.readPer1M)).toFixed(6))
312
+ : null;
313
+
314
+ const formattedRemaining = formatRemainingTtl(remainingSeconds);
315
+ const pauseDistribution = this.getPauseDistribution();
316
+
317
+ const suppressed = isSilentOrOffMode(activeMode);
318
+ const meetsWatchdogCriteria =
319
+ !suppressed &&
320
+ cacheWarm &&
321
+ cachedTokens >= this.minCachedTokens &&
322
+ remainingSeconds > 0 &&
323
+ remainingSeconds <= this.amberThresholdSeconds &&
324
+ hasRecentWorkspaceEdits;
325
+
326
+ if (!meetsWatchdogCriteria) {
327
+ let statusReason = 'IDLE';
328
+ if (suppressed) {
329
+ statusReason = 'MODE_SILENT';
330
+ } else if (!cacheWarm || remainingSeconds <= 0) {
331
+ statusReason = 'CACHE_COLD_OR_EXPIRED';
332
+ } else if (cachedTokens < this.minCachedTokens) {
333
+ statusReason = 'BELOW_MIN_CACHED_TOKENS';
334
+ } else if (!hasRecentWorkspaceEdits) {
335
+ statusReason = 'IDLE_NO_EDITS';
336
+ } else if (remainingSeconds > this.amberThresholdSeconds) {
337
+ statusReason = 'TTL_HEALTHY';
338
+ }
339
+
340
+ return {
341
+ detectorId: 'DET-10',
342
+ mode: activeMode,
343
+ statusReason,
344
+ effectiveTtlSeconds,
345
+ ttlDroppedTo5m,
346
+ cacheExpired,
347
+ cacheWarm: cacheWarm && remainingSeconds > 0,
348
+ cachedTokens,
349
+ remainingSeconds,
350
+ formattedRemaining,
351
+ amberAlertActive: false,
352
+ alertLevel: (remainingSeconds === 0 && cacheWarm) || cacheExpired ? 'EXPIRED' : 'NONE',
353
+ expiryPenaltyUSD,
354
+ availableActions: [],
355
+ preSnapshotTriggered: false,
356
+ stateBatonSnapshot: null,
357
+ bannerText: null,
358
+ pauseDistribution
359
+ };
360
+ }
361
+
362
+ // Amber alert is active (remainingSeconds <= 45)
363
+ let alertLevel = 'AMBER';
364
+ let preSnapshotTriggered = false;
365
+ let keepAliveTriggered = false;
366
+ let stateBatonSnapshot = null;
367
+ const availableActions =
368
+ activeMode === FLIGHT_MODES.COACH
369
+ ? ['KEEP_ALIVE_PROMPT', 'SNAPSHOT_STATE_BATON']
370
+ : ['AUTO_SNAPSHOT_STATE_BATON', 'LOCAL_CLI_KEEP_ALIVE'];
371
+
372
+ const cycleKey = expiresAtMs ? Math.round(expiresAtMs / 1000) : 'active_cycle';
373
+
374
+ if (
375
+ activeMode === FLIGHT_MODES.AUTO_PILOT &&
376
+ (this.enableLocalKeepAlive || tickState.optInLocalKeepAlive === true) &&
377
+ remainingSeconds <= this.keepAliveThresholdSeconds &&
378
+ this.lastKeepAliveExpiryCycle !== cycleKey
379
+ ) {
380
+ this.lastKeepAliveExpiryCycle = cycleKey;
381
+ keepAliveTriggered = true;
382
+ if (this.onKeepAliveCallback) {
383
+ this.onKeepAliveCallback({
384
+ sessionId: tickState.sessionId || 'default',
385
+ modelId,
386
+ cachedTokens,
387
+ remainingSeconds,
388
+ expiryPenaltyUSD
389
+ });
390
+ }
391
+ }
392
+
393
+ if (
394
+ remainingSeconds <= this.snapshotThresholdSeconds &&
395
+ (activeMode === FLIGHT_MODES.AUTO_PILOT || tickState.optInAutoSnapshot === true)
396
+ ) {
397
+ alertLevel = 'CRITICAL_SNAPSHOT';
398
+ if (this.lastSnapshotExpiryCycle !== cycleKey) {
399
+ this.lastSnapshotExpiryCycle = cycleKey;
400
+ preSnapshotTriggered = true;
401
+ stateBatonSnapshot = buildPreExpiryStateBaton({
402
+ nowMs,
403
+ sessionId: tickState.sessionId || 'default',
404
+ modelId,
405
+ cachedTokens,
406
+ remainingSeconds,
407
+ activeGoal: tickState.activeGoal,
408
+ workingSetFiles:
409
+ tickState.workingSetFiles || Array.from(this.workingSetFiles),
410
+ verifiedInvariants: tickState.verifiedInvariants,
411
+ deadEndsAndFailures: tickState.deadEndsAndFailures,
412
+ queuedCacheMutations: tickState.queuedCacheMutations
413
+ });
414
+ this.latestSnapshot = stateBatonSnapshot;
415
+ if (this.onSnapshotCallback) {
416
+ this.onSnapshotCallback(stateBatonSnapshot);
417
+ }
418
+ } else {
419
+ stateBatonSnapshot = this.latestSnapshot;
420
+ }
421
+ }
422
+
423
+ const penaltySuffix =
424
+ expiryPenaltyUSD !== null
425
+ ? ` ($${expiryPenaltyUSD.toFixed(2)} rewrite)`
426
+ : ' (prices unknown)';
427
+ const bannerText = preSnapshotTriggered
428
+ ? `amber TTL cliff (${formattedRemaining}): zero-token StateBaton pre-snapshot saved at T-${remainingSeconds}s (protects ${(cachedTokens / 1000).toFixed(1)}k cache${penaltySuffix}).`
429
+ : `amber TTL warning (${formattedRemaining}): ${(cachedTokens / 1000).toFixed(1)}k warm cache on ${rates.shortLabel} expires soon${expiryPenaltyUSD !== null ? ` (+$${expiryPenaltyUSD.toFixed(2)} rewrite penalty)` : '; prices unknown'}.`;
430
+
431
+ return {
432
+ detectorId: 'DET-10',
433
+ mode: activeMode,
434
+ statusReason: preSnapshotTriggered ? 'PRE_SNAPSHOT_SAVED' : 'AMBER_WARNING',
435
+ effectiveTtlSeconds,
436
+ ttlDroppedTo5m,
437
+ cacheExpired,
438
+ cacheWarm: true,
439
+ cachedTokens,
440
+ remainingSeconds,
441
+ formattedRemaining,
442
+ amberAlertActive: true,
443
+ alertLevel,
444
+ expiryPenaltyUSD,
445
+ availableActions,
446
+ keepAliveTriggered,
447
+ preSnapshotTriggered,
448
+ stateBatonSnapshot,
449
+ bannerText,
450
+ pauseDistribution
451
+ };
452
+ }
453
+ }
454
+
455
+ export default {
456
+ DEFAULT_MIN_CACHED_TOKENS_FOR_WATCHDOG,
457
+ DEFAULT_AMBER_THRESHOLD_SECONDS,
458
+ DEFAULT_SNAPSHOT_THRESHOLD_SECONDS,
459
+ ONE_HOUR_UPGRADE_PAUSE_RATIO_THRESHOLD,
460
+ formatRemainingTtl,
461
+ buildPreExpiryStateBaton,
462
+ evaluatePauseDistribution,
463
+ TtlWatchdog
464
+ };