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,962 @@
1
+ /**
2
+ * @file src/utils/runtime.mjs
3
+ * 100% Pure JavaScript ES module runtime utilities for Highbeam.
4
+ *
5
+ * Architectural Invariants (ISS-032 & ISS-022):
6
+ * - ZERO `node:*` imports, ZERO `require()`, ZERO dynamic `import()`, ZERO `process.getBuiltinModule()`.
7
+ * - Safe to load inside sandboxed V8 Mod isolates where `globalThis.process` is `undefined`
8
+ * as well as all Node.js >= 20.0.0 versions (`20.0.0` through `24.x`).
9
+ * - Provides pure-JS cross-platform POSIX/Win32 path manipulation (`joinPath`, `dirnamePath`,
10
+ * `basenamePath`, `isAbsolutePath`, `resolvePath`, `relativePath`, `normalizeSlashes`) and
11
+ * pure-JS deterministic hashing (`fnv1aHex`, FIPS 180-4 `sha256Hex`).
12
+ * - Tier-2 Node CLI entrypoints register a Node I/O adapter via `registerNodeIo(...)` (from
13
+ * `src/utils/nodeIo.mjs`), enabling Windows-safe atomic disk writes (`writeTextAtomic`,
14
+ * `writeJsonAtomic`) with `'utf8'`, `fsyncSync`, 5x bounded `EPERM`/`EBUSY`/`EACCES` rename
15
+ * retries, and guaranteed `.tmp` unlink cleanup on error.
16
+ */
17
+
18
+ let registeredNodeIo = null;
19
+
20
+ const RETRYABLE_RENAME_CODES = new Set(['EPERM', 'EBUSY', 'EACCES']);
21
+
22
+ /**
23
+ * Registers (or clears when `null`) the Tier-2 Node.js host I/O provider.
24
+ * Never called in sandboxed V8 Mod isolates where persistence uses `$.store`.
25
+ *
26
+ * @param {object | null} ioProvider
27
+ * @returns {object | null}
28
+ */
29
+ export function registerNodeIo(ioProvider) {
30
+ registeredNodeIo = ioProvider || null;
31
+ return registeredNodeIo;
32
+ }
33
+
34
+ /**
35
+ * Resolves the active I/O provider from `options.io` or the registered Tier-2 provider.
36
+ *
37
+ * @param {object} [options={}]
38
+ * @returns {object | null}
39
+ */
40
+ export function getNodeIo(options = {}) {
41
+ if (options && Object.prototype.hasOwnProperty.call(options, 'io')) {
42
+ return options.io || null;
43
+ }
44
+ return registeredNodeIo;
45
+ }
46
+
47
+ /**
48
+ * Detects whether the host environment uses Windows path conventions.
49
+ * Safe when `globalThis.process` is `undefined`.
50
+ *
51
+ * @param {string} [samplePath='']
52
+ * @returns {boolean}
53
+ */
54
+ function isWindowsEnv(samplePath = '') {
55
+ if (/^[A-Za-z]:[\\/]/.test(samplePath) || samplePath.includes('\\')) {
56
+ return true;
57
+ }
58
+ return globalThis.process?.platform === 'win32';
59
+ }
60
+
61
+ /**
62
+ * Normalizes all backslashes to forward slashes.
63
+ *
64
+ * @param {string} [rawPath='']
65
+ * @returns {string}
66
+ */
67
+ export function normalizeSlashes(rawPath = '') {
68
+ return String(rawPath ?? '').replace(/\\/g, '/');
69
+ }
70
+
71
+ /**
72
+ * Checks whether a path is absolute on POSIX (`/foo`) or Windows (`C:/foo`, `C:\foo`, `\\server\share`).
73
+ *
74
+ * @param {string} [rawPath='']
75
+ * @returns {boolean}
76
+ */
77
+ export function isAbsolutePath(rawPath = '') {
78
+ const str = String(rawPath ?? '');
79
+ return /^(?:\/|[A-Za-z]:[\\/]|[\\/]{2})/.test(str);
80
+ }
81
+
82
+ /**
83
+ * Internal pure-JS path normalizer handling `.` and `..` across POSIX and Windows roots.
84
+ *
85
+ * @param {string} rawPosix
86
+ * @param {boolean} useWinSep
87
+ * @returns {string}
88
+ */
89
+ function normalizeInternal(rawPosix, useWinSep) {
90
+ const sep = useWinSep ? '\\' : '/';
91
+ if (!rawPosix) return '.';
92
+
93
+ let root = '';
94
+ let rest = rawPosix;
95
+
96
+ const uncMatch = rawPosix.match(/^\/\/([^/]+)\/([^/]+)(?:\/(.*))?$/);
97
+ const driveMatch = !uncMatch ? rawPosix.match(/^([A-Za-z]:)(?:\/(.*))?$/) : null;
98
+
99
+ if (uncMatch) {
100
+ root = `//${uncMatch[1]}/${uncMatch[2]}/`;
101
+ rest = uncMatch[3] || '';
102
+ } else if (driveMatch) {
103
+ const hasSlash = rawPosix.length > 2 && rawPosix[2] === '/';
104
+ root = hasSlash ? `${driveMatch[1]}/` : driveMatch[1];
105
+ rest = driveMatch[2] || '';
106
+ } else if (rawPosix.startsWith('/')) {
107
+ root = '/';
108
+ rest = rawPosix.replace(/^\/+/, '');
109
+ }
110
+
111
+ const isAbs = root === '/' || root.endsWith('/');
112
+ const rawParts = rest.split('/');
113
+ const resolved = [];
114
+
115
+ for (const part of rawParts) {
116
+ if (!part || part === '.') continue;
117
+ if (part === '..') {
118
+ if (resolved.length > 0 && resolved[resolved.length - 1] !== '..') {
119
+ resolved.pop();
120
+ } else if (!isAbs) {
121
+ resolved.push('..');
122
+ }
123
+ } else {
124
+ resolved.push(part);
125
+ }
126
+ }
127
+
128
+ const joined = resolved.join('/');
129
+ let result = '';
130
+ if (root) {
131
+ if (root.endsWith('/')) {
132
+ result = joined ? `${root}${joined}` : root;
133
+ } else {
134
+ result = joined ? `${root}/${joined}` : `${root}.`;
135
+ }
136
+ } else {
137
+ result = joined || '.';
138
+ }
139
+
140
+ return useWinSep ? result.replace(/\//g, sep) : result;
141
+ }
142
+
143
+ /**
144
+ * Pure-JS cross-platform `path.join` implementation.
145
+ *
146
+ * @param {...string} parts
147
+ * @returns {string}
148
+ */
149
+ export function joinPath(...parts) {
150
+ const valid = [];
151
+ let winHint = globalThis.process?.platform === 'win32';
152
+ for (const p of parts) {
153
+ if (p === undefined || p === null) continue;
154
+ const s = String(p);
155
+ if (!s) continue;
156
+ if (/^[A-Za-z]:[\\/]/.test(s) || s.includes('\\')) {
157
+ winHint = true;
158
+ }
159
+ valid.push(normalizeSlashes(s));
160
+ }
161
+ if (valid.length === 0) return '.';
162
+
163
+ let combined = valid[0];
164
+ for (let i = 1; i < valid.length; i++) {
165
+ const seg = valid[i].replace(/^\/+/, '');
166
+ if (!seg) continue;
167
+ combined = combined.endsWith('/') ? `${combined}${seg}` : `${combined}/${seg}`;
168
+ }
169
+ return normalizeInternal(combined, winHint);
170
+ }
171
+
172
+ /**
173
+ * Resolves the active working directory safely without throwing in V8 isolates.
174
+ *
175
+ * @param {object} [options={}]
176
+ * @returns {string}
177
+ */
178
+ export function getCwd(options = {}) {
179
+ if (typeof options?.cwd === 'string' && options.cwd.trim()) {
180
+ return options.cwd.trim();
181
+ }
182
+ const io = getNodeIo(options);
183
+ if (typeof io?.cwd === 'function') {
184
+ const c = io.cwd();
185
+ if (c) return c;
186
+ }
187
+ if (typeof globalThis.process?.cwd === 'function') {
188
+ try {
189
+ return globalThis.process.cwd();
190
+ } catch {
191
+ return '.';
192
+ }
193
+ }
194
+ return '.';
195
+ }
196
+
197
+ /**
198
+ * Resolves the user home directory safely when available.
199
+ *
200
+ * @param {object} [options={}]
201
+ * @returns {string}
202
+ */
203
+ export function getHomeDir(options = {}) {
204
+ if (typeof options?.homeDir === 'string' && options.homeDir.trim()) {
205
+ return options.homeDir.trim();
206
+ }
207
+ const io = getNodeIo(options);
208
+ if (typeof io?.os?.homedir === 'function') {
209
+ try {
210
+ return io.os.homedir() || '';
211
+ } catch {
212
+ return '';
213
+ }
214
+ }
215
+ const env = globalThis.process?.env;
216
+ if (env) {
217
+ return env.HOME || env.USERPROFILE || '';
218
+ }
219
+ return '';
220
+ }
221
+
222
+ /**
223
+ * Pure-JS cross-platform `path.resolve` implementation.
224
+ *
225
+ * @param {...string} parts
226
+ * @returns {string}
227
+ */
228
+ export function resolvePath(...parts) {
229
+ let resolvedPosix = '';
230
+ let hitAbs = false;
231
+ let winHint = globalThis.process?.platform === 'win32';
232
+
233
+ for (let i = parts.length - 1; i >= 0; i--) {
234
+ const raw = parts[i];
235
+ if (raw === undefined || raw === null || raw === '') continue;
236
+ const s = String(raw);
237
+ if (/^[A-Za-z]:[\\/]/.test(s) || s.includes('\\')) {
238
+ winHint = true;
239
+ }
240
+ const norm = normalizeSlashes(s);
241
+ resolvedPosix = resolvedPosix ? `${norm}/${resolvedPosix}` : norm;
242
+ if (isAbsolutePath(s)) {
243
+ hitAbs = true;
244
+ break;
245
+ }
246
+ }
247
+
248
+ if (!hitAbs) {
249
+ const cwd = getCwd();
250
+ if (/^[A-Za-z]:[\\/]/.test(cwd) || cwd.includes('\\')) {
251
+ winHint = true;
252
+ }
253
+ const normCwd = normalizeSlashes(cwd);
254
+ resolvedPosix = resolvedPosix ? `${normCwd}/${resolvedPosix}` : normCwd;
255
+ }
256
+
257
+ return normalizeInternal(resolvedPosix, winHint);
258
+ }
259
+
260
+ /**
261
+ * Pure-JS cross-platform `path.dirname` implementation.
262
+ *
263
+ * @param {string} [targetPath='']
264
+ * @returns {string}
265
+ */
266
+ export function dirnamePath(targetPath = '') {
267
+ const raw = String(targetPath ?? '');
268
+ if (!raw) return '.';
269
+ const win = isWindowsEnv(raw);
270
+ const sep = win ? '\\' : '/';
271
+ const norm = normalizeSlashes(raw).replace(/\/+$/, '');
272
+
273
+ if (!norm) {
274
+ return raw.startsWith('/') || raw.startsWith('\\') ? sep : '.';
275
+ }
276
+ if (/^[A-Za-z]:$/.test(norm)) {
277
+ return `${norm}${sep}`;
278
+ }
279
+
280
+ const lastSlash = norm.lastIndexOf('/');
281
+ if (lastSlash === -1) return '.';
282
+ if (lastSlash === 0) return sep;
283
+
284
+ const parent = norm.slice(0, lastSlash);
285
+ if (/^[A-Za-z]:$/.test(parent)) {
286
+ return `${parent}${sep}`;
287
+ }
288
+ return win ? parent.replace(/\//g, sep) : parent;
289
+ }
290
+
291
+ /**
292
+ * Pure-JS cross-platform `path.basename` implementation.
293
+ *
294
+ * @param {string} [targetPath='']
295
+ * @param {string} [ext='']
296
+ * @returns {string}
297
+ */
298
+ export function basenamePath(targetPath = '', ext = '') {
299
+ const norm = normalizeSlashes(String(targetPath ?? '')).replace(/\/+$/, '');
300
+ if (!norm) return '';
301
+ const idx = norm.lastIndexOf('/');
302
+ const base = idx === -1 ? norm : norm.slice(idx + 1);
303
+ if (ext && base.endsWith(ext)) {
304
+ return base.slice(0, base.length - ext.length);
305
+ }
306
+ return base;
307
+ }
308
+
309
+ /**
310
+ * Pure-JS cross-platform `path.relative` implementation.
311
+ *
312
+ * @param {string} [from='']
313
+ * @param {string} [to='']
314
+ * @returns {string}
315
+ */
316
+ export function relativePath(from = '', to = '') {
317
+ const win = isWindowsEnv(from) || isWindowsEnv(to);
318
+ const sep = win ? '\\' : '/';
319
+ const absFrom = normalizeSlashes(resolvePath(from)).replace(/\/+$/, '');
320
+ const absTo = normalizeSlashes(resolvePath(to)).replace(/\/+$/, '');
321
+
322
+ const cmpFrom = win ? absFrom.toLowerCase() : absFrom;
323
+ const cmpTo = win ? absTo.toLowerCase() : absTo;
324
+ if (cmpFrom === cmpTo) return '';
325
+
326
+ const fromDrive = cmpFrom.match(/^[a-z]:/)?.[0] || '';
327
+ const toDrive = cmpTo.match(/^[a-z]:/)?.[0] || '';
328
+ if (fromDrive !== toDrive) {
329
+ return win ? absTo.replace(/\//g, sep) : absTo;
330
+ }
331
+
332
+ const fromParts = absFrom.replace(/^[A-Za-z]:\/?|^\/+/, '').split('/').filter(Boolean);
333
+ const toParts = absTo.replace(/^[A-Za-z]:\/?|^\/+/, '').split('/').filter(Boolean);
334
+ const cmpFromParts = win ? fromParts.map((s) => s.toLowerCase()) : fromParts;
335
+ const cmpToParts = win ? toParts.map((s) => s.toLowerCase()) : toParts;
336
+
337
+ let common = 0;
338
+ while (
339
+ common < cmpFromParts.length &&
340
+ common < cmpToParts.length &&
341
+ cmpFromParts[common] === cmpToParts[common]
342
+ ) {
343
+ common += 1;
344
+ }
345
+
346
+ const upMoves = new Array(fromParts.length - common).fill('..');
347
+ const downMoves = toParts.slice(common);
348
+ return [...upMoves, ...downMoves].join(sep);
349
+ }
350
+
351
+ /**
352
+ * Pure-JS `file://` URL to filesystem path converter.
353
+ *
354
+ * @param {string} [fileUrl='']
355
+ * @param {object} [options={}]
356
+ * @returns {string | null}
357
+ */
358
+ export function fileUrlToPathPure(fileUrl = '', options = {}) {
359
+ const io = getNodeIo(options);
360
+ if (typeof io?.url?.fileURLToPath === 'function') {
361
+ try {
362
+ return io.url.fileURLToPath(fileUrl);
363
+ } catch {
364
+ return null;
365
+ }
366
+ }
367
+ const str = String(fileUrl || '');
368
+ if (!str.startsWith('file://')) return null;
369
+ try {
370
+ let pathname = decodeURIComponent(str.slice('file://'.length));
371
+ if (/^\/[A-Za-z]:\//.test(pathname)) {
372
+ pathname = pathname.slice(1).replace(/\//g, '\\');
373
+ }
374
+ return pathname;
375
+ } catch {
376
+ return null;
377
+ }
378
+ }
379
+
380
+ /**
381
+ * Pure-JS path namespace object providing drop-in `join`, `dirname`, `basename`,
382
+ * `isAbsolute`, `resolve`, and `relative` methods in every environment.
383
+ */
384
+ export const path = Object.freeze({
385
+ join: joinPath,
386
+ dirname: dirnamePath,
387
+ basename: basenamePath,
388
+ isAbsolute: isAbsolutePath,
389
+ resolve: resolvePath,
390
+ relative: relativePath
391
+ });
392
+
393
+ /**
394
+ * Fast deterministic 32-bit FNV-1a hex digest (pure JS).
395
+ *
396
+ * @param {string} [input='']
397
+ * @returns {string}
398
+ */
399
+ export function fnv1aHex(input = '') {
400
+ let h = 0x811c9dc5;
401
+ const s = String(input ?? '');
402
+ for (let i = 0; i < s.length; i++) {
403
+ h ^= s.charCodeAt(i);
404
+ h = Math.imul(h, 0x01000193);
405
+ }
406
+ return (h >>> 0).toString(16).padStart(8, '0');
407
+ }
408
+
409
+ const SHA256_K = new Uint32Array([
410
+ 0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5, 0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
411
+ 0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3, 0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
412
+ 0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc, 0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
413
+ 0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7, 0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
414
+ 0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13, 0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
415
+ 0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3, 0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
416
+ 0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5, 0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
417
+ 0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208, 0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
418
+ ]);
419
+
420
+ /**
421
+ * Encodes a UTF-16 JS string into UTF-8 bytes without requiring Node `Buffer`.
422
+ *
423
+ * @param {string} str
424
+ * @returns {Uint8Array}
425
+ */
426
+ function encodeUtf8Bytes(str) {
427
+ if (typeof TextEncoder === 'function') {
428
+ return new TextEncoder().encode(str);
429
+ }
430
+ const bytes = [];
431
+ for (let i = 0; i < str.length; i++) {
432
+ let code = str.charCodeAt(i);
433
+ if (code >= 0xd800 && code <= 0xdbff && i + 1 < str.length) {
434
+ const low = str.charCodeAt(i + 1);
435
+ if (low >= 0xdc00 && low <= 0xdfff) {
436
+ code = ((code - 0xd800) << 10) + (low - 0xdc00) + 0x10000;
437
+ i += 1;
438
+ }
439
+ }
440
+ if (code < 0x80) {
441
+ bytes.push(code);
442
+ } else if (code < 0x800) {
443
+ bytes.push(0xc0 | (code >> 6), 0x80 | (code & 0x3f));
444
+ } else if (code < 0x10000) {
445
+ bytes.push(0xe0 | (code >> 12), 0x80 | ((code >> 6) & 0x3f), 0x80 | (code & 0x3f));
446
+ } else {
447
+ bytes.push(
448
+ 0xf0 | (code >> 18),
449
+ 0x80 | ((code >> 12) & 0x3f),
450
+ 0x80 | ((code >> 6) & 0x3f),
451
+ 0x80 | (code & 0x3f)
452
+ );
453
+ }
454
+ }
455
+ return new Uint8Array(bytes);
456
+ }
457
+
458
+ /**
459
+ * Computes an exact FIPS 180-4 SHA-256 hex digest in pure JavaScript (with optional acceleration
460
+ * when a Tier-2 Node `crypto` adapter is registered).
461
+ *
462
+ * @param {string} [content='']
463
+ * @param {object} [options={}]
464
+ * @returns {string}
465
+ */
466
+ export function sha256Hex(content = '', options = {}) {
467
+ const str = String(content ?? '');
468
+ const io = getNodeIo(options);
469
+ if (typeof io?.crypto?.createHash === 'function') {
470
+ return io.crypto.createHash('sha256').update(str, 'utf8').digest('hex');
471
+ }
472
+
473
+ const msg = encodeUtf8Bytes(str);
474
+ const bitLenHi = Math.floor((msg.length * 8) / 0x100000000);
475
+ const bitLenLo = (msg.length * 8) >>> 0;
476
+ const padLen = ((msg.length + 9 + 63) & ~63);
477
+ const padded = new Uint8Array(padLen);
478
+ padded.set(msg);
479
+ padded[msg.length] = 0x80;
480
+ const view = new DataView(padded.buffer);
481
+ view.setUint32(padLen - 8, bitLenHi, false);
482
+ view.setUint32(padLen - 4, bitLenLo, false);
483
+
484
+ let h0 = 0x6a09e667;
485
+ let h1 = 0xbb67ae85;
486
+ let h2 = 0x3c6ef372;
487
+ let h3 = 0xa54ff53a;
488
+ let h4 = 0x510e527f;
489
+ let h5 = 0x9b05688c;
490
+ let h6 = 0x1f83d9ab;
491
+ let h7 = 0x5be0cd19;
492
+
493
+ const w = new Uint32Array(64);
494
+ const rotr = (x, n) => (x >>> n) | (x << (32 - n));
495
+
496
+ for (let offset = 0; offset < padLen; offset += 64) {
497
+ for (let i = 0; i < 16; i++) {
498
+ w[i] = view.getUint32(offset + i * 4, false);
499
+ }
500
+ for (let i = 16; i < 64; i++) {
501
+ const s0 = rotr(w[i - 15], 7) ^ rotr(w[i - 15], 18) ^ (w[i - 15] >>> 3);
502
+ const s1 = rotr(w[i - 2], 17) ^ rotr(w[i - 2], 19) ^ (w[i - 2] >>> 10);
503
+ w[i] = (w[i - 16] + s0 + w[i - 7] + s1) >>> 0;
504
+ }
505
+
506
+ let a = h0;
507
+ let b = h1;
508
+ let c = h2;
509
+ let d = h3;
510
+ let e = h4;
511
+ let f = h5;
512
+ let g = h6;
513
+ let h = h7;
514
+
515
+ for (let i = 0; i < 64; i++) {
516
+ const S1 = rotr(e, 6) ^ rotr(e, 11) ^ rotr(e, 25);
517
+ const ch = (e & f) ^ (~e & g);
518
+ const temp1 = (h + S1 + ch + SHA256_K[i] + w[i]) >>> 0;
519
+ const S0 = rotr(a, 2) ^ rotr(a, 13) ^ rotr(a, 22);
520
+ const maj = (a & b) ^ (a & c) ^ (b & c);
521
+ const temp2 = (S0 + maj) >>> 0;
522
+
523
+ h = g;
524
+ g = f;
525
+ f = e;
526
+ e = (d + temp1) >>> 0;
527
+ d = c;
528
+ c = b;
529
+ b = a;
530
+ a = (temp1 + temp2) >>> 0;
531
+ }
532
+
533
+ h0 = (h0 + a) >>> 0;
534
+ h1 = (h1 + b) >>> 0;
535
+ h2 = (h2 + c) >>> 0;
536
+ h3 = (h3 + d) >>> 0;
537
+ h4 = (h4 + e) >>> 0;
538
+ h5 = (h5 + f) >>> 0;
539
+ h6 = (h6 + g) >>> 0;
540
+ h7 = (h7 + h) >>> 0;
541
+ }
542
+
543
+ return [h0, h1, h2, h3, h4, h5, h6, h7]
544
+ .map((v) => v.toString(16).padStart(8, '0'))
545
+ .join('');
546
+ }
547
+
548
+ /**
549
+ * Checks whether a file exists via the registered Tier-2 Node `fs` provider.
550
+ * Returns `false` cleanly in pure V8 Mod isolates.
551
+ *
552
+ * @param {string} targetPath
553
+ * @param {object} [options={}]
554
+ * @returns {boolean}
555
+ */
556
+ export function fileExists(targetPath, options = {}) {
557
+ const fsMod = getNodeIo(options)?.fs;
558
+ if (!fsMod || !targetPath) return false;
559
+ try {
560
+ return Boolean(fsMod.existsSync(targetPath));
561
+ } catch {
562
+ return false;
563
+ }
564
+ }
565
+
566
+ /**
567
+ * Safely returns the byte size of a file on disk via the registered Tier-2 Node `fs` provider.
568
+ * Returns `0` cleanly in pure V8 Mod isolates or when the file does not exist (`ISS-024`).
569
+ *
570
+ * @param {string} targetPath
571
+ * @param {object} [options={}]
572
+ * @returns {number}
573
+ */
574
+ export function getFileByteSizeSafe(targetPath, options = {}) {
575
+ const fsMod = getNodeIo(options)?.fs;
576
+ if (!fsMod || typeof fsMod.statSync !== 'function' || !targetPath) return 0;
577
+ try {
578
+ if (!fsMod.existsSync(targetPath)) return 0;
579
+ const st = fsMod.statSync(targetPath);
580
+ return st && st.isFile?.() !== false && Number(st.size) > 0 ? Number(st.size) : 0;
581
+ } catch {
582
+ return 0;
583
+ }
584
+ }
585
+
586
+ /**
587
+ * Safely returns the modification timestamp (`mtimeMs`) of a file on disk via the registered
588
+ * Tier-2 Node `fs` provider. Returns `0` cleanly in pure V8 Mod isolates or when missing.
589
+ *
590
+ * @param {string} targetPath
591
+ * @param {object} [options={}]
592
+ * @returns {number}
593
+ */
594
+ export function getFileMtimeMsSafe(targetPath, options = {}) {
595
+ const fsMod = getNodeIo(options)?.fs;
596
+ if (!fsMod || typeof fsMod.statSync !== 'function' || !targetPath) return 0;
597
+ try {
598
+ if (!fsMod.existsSync(targetPath)) return 0;
599
+ const st = fsMod.statSync(targetPath);
600
+ return st && st.isFile?.() !== false && Number(st.mtimeMs) > 0 ? Number(st.mtimeMs) : 0;
601
+ } catch {
602
+ return 0;
603
+ }
604
+ }
605
+
606
+ /**
607
+ * Safely lists filenames inside a directory via the registered Tier-2 Node `fs` provider.
608
+ * Returns `[]` cleanly in pure V8 Mod isolates or when the directory does not exist.
609
+ *
610
+ * @param {string} dirPath
611
+ * @param {object} [options={}]
612
+ * @returns {string[]}
613
+ */
614
+ export function readdirSafe(dirPath, options = {}) {
615
+ const fsMod = getNodeIo(options)?.fs;
616
+ if (!fsMod || typeof fsMod.readdirSync !== 'function' || !dirPath) return [];
617
+ try {
618
+ if (!fsMod.existsSync(dirPath)) return [];
619
+ const entries = fsMod.readdirSync(dirPath);
620
+ return Array.isArray(entries) ? entries.map((e) => String(e)) : [];
621
+ } catch {
622
+ return [];
623
+ }
624
+ }
625
+
626
+ /**
627
+ * Deletes a file safely if it exists.
628
+ *
629
+ * @param {string} targetPath
630
+ * @param {object} [options={}]
631
+ * @returns {boolean}
632
+ */
633
+ export function unlinkSafe(targetPath, options = {}) {
634
+ const fsMod = getNodeIo(options)?.fs;
635
+ if (!fsMod) return false;
636
+ try {
637
+ if (fsMod.existsSync(targetPath)) {
638
+ fsMod.unlinkSync(targetPath);
639
+ }
640
+ return true;
641
+ } catch {
642
+ return false;
643
+ }
644
+ }
645
+
646
+ /**
647
+ * Safely reads UTF-8 text from disk via the registered Node `fs` provider.
648
+ *
649
+ * @param {string} targetPath
650
+ * @param {string | null} [fallback=null]
651
+ * @param {object} [options={}]
652
+ * @returns {string | null}
653
+ */
654
+ export function readTextSafe(targetPath, fallback = null, options = {}) {
655
+ const fsMod = getNodeIo(options)?.fs;
656
+ if (!fsMod || !targetPath) return fallback;
657
+ try {
658
+ if (!fsMod.existsSync(targetPath)) return fallback;
659
+ return fsMod.readFileSync(targetPath, 'utf8');
660
+ } catch {
661
+ return fallback;
662
+ }
663
+ }
664
+
665
+ /**
666
+ * Atomically writes UTF-8 text to disk (`ISS-022`):
667
+ * - Uses `${targetPath}.tmp.${pid}.${Date.now()}.${rand}`
668
+ * - Explicit `'utf8'` encoding + `fs.fsyncSync(fd)` before `closeSync`
669
+ * - 5x bounded retry on Windows `EPERM` / `EBUSY` / `EACCES` lock contention
670
+ * - Guaranteed `unlinkSync(tempPath)` cleanup on any write/rename failure
671
+ *
672
+ * @param {string} targetPath
673
+ * @param {string} content
674
+ * @param {object} [options={}]
675
+ * @returns {boolean}
676
+ */
677
+ export function writeTextAtomic(targetPath, content, options = {}) {
678
+ const fsMod = getNodeIo(options)?.fs;
679
+ if (!fsMod || !targetPath) return false;
680
+
681
+ const pid = globalThis.process?.pid || 0;
682
+ const rand = Math.random().toString(36).slice(2, 8);
683
+ const tempPath = `${targetPath}.tmp.${pid}.${Date.now()}.${rand}`;
684
+
685
+ try {
686
+ const dir = dirnamePath(targetPath);
687
+ if (dir && dir !== '.' && !fsMod.existsSync(dir)) {
688
+ fsMod.mkdirSync(dir, { recursive: true });
689
+ }
690
+
691
+ if (typeof fsMod.openSync === 'function' && typeof fsMod.fsyncSync === 'function') {
692
+ const fd = fsMod.openSync(tempPath, 'w');
693
+ try {
694
+ fsMod.writeFileSync(fd, String(content ?? ''), 'utf8');
695
+ fsMod.fsyncSync(fd);
696
+ } finally {
697
+ try {
698
+ fsMod.closeSync(fd);
699
+ } catch {
700
+ // Ignore close error
701
+ }
702
+ }
703
+ } else {
704
+ fsMod.writeFileSync(tempPath, String(content ?? ''), 'utf8');
705
+ }
706
+
707
+ for (let attempt = 0; attempt < 5; attempt++) {
708
+ try {
709
+ fsMod.renameSync(tempPath, targetPath);
710
+ return true;
711
+ } catch (err) {
712
+ if (!RETRYABLE_RENAME_CODES.has(err?.code) || attempt === 4) {
713
+ throw err;
714
+ }
715
+ try {
716
+ if (typeof SharedArrayBuffer === 'function' && typeof Atomics?.wait === 'function') {
717
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, (attempt + 1) * 4);
718
+ }
719
+ } catch {
720
+ // Ignore if SharedArrayBuffer is unavailable
721
+ }
722
+ }
723
+ }
724
+ return true;
725
+ } catch {
726
+ try {
727
+ if (fsMod.existsSync(tempPath)) {
728
+ fsMod.unlinkSync(tempPath);
729
+ }
730
+ } catch {
731
+ // Ignore temp cleanup error
732
+ }
733
+ return false;
734
+ }
735
+ }
736
+
737
+ /**
738
+ * Atomically writes a JSON payload to disk via `writeTextAtomic`.
739
+ *
740
+ * @param {string} targetPath
741
+ * @param {unknown} data
742
+ * @param {object} [options={}]
743
+ * @returns {boolean}
744
+ */
745
+ export function writeJsonAtomic(targetPath, data, options = {}) {
746
+ try {
747
+ const serialized = JSON.stringify(data, null, 2);
748
+ return writeTextAtomic(targetPath, serialized, options);
749
+ } catch {
750
+ return false;
751
+ }
752
+ }
753
+
754
+ /**
755
+ * Safely reads and parses a JSON file from disk.
756
+ *
757
+ * @param {string} targetPath
758
+ * @param {any} [fallback=null]
759
+ * @param {object} [options={}]
760
+ * @returns {any}
761
+ */
762
+ export function readJsonSafe(targetPath, fallback = null, options = {}) {
763
+ const raw = readTextSafe(targetPath, null, options);
764
+ if (raw === null) return fallback;
765
+ try {
766
+ return JSON.parse(raw);
767
+ } catch {
768
+ return fallback;
769
+ }
770
+ }
771
+
772
+ /**
773
+ * Safely appends a JSONL record to an append-only file using `'utf8'`.
774
+ *
775
+ * @param {string} targetPath
776
+ * @param {object} record
777
+ * @param {object} [options={}]
778
+ * @returns {boolean}
779
+ */
780
+ export function appendJsonlSafe(targetPath, record, options = {}) {
781
+ const fsMod = getNodeIo(options)?.fs;
782
+ if (!fsMod || !targetPath) return false;
783
+ try {
784
+ const dir = dirnamePath(targetPath);
785
+ if (dir && dir !== '.' && !fsMod.existsSync(dir)) {
786
+ fsMod.mkdirSync(dir, { recursive: true });
787
+ }
788
+ fsMod.appendFileSync(targetPath, `${JSON.stringify(record)}\n`, 'utf8');
789
+ return true;
790
+ } catch {
791
+ return false;
792
+ }
793
+ }
794
+
795
+ export const MAX_RUNTIME_DIAGNOSTIC_ENTRIES = 50;
796
+
797
+ const inMemoryDiagnosticsRing = [];
798
+
799
+ /**
800
+ * Redacts the user home directory from diagnostic messages in pure JavaScript.
801
+ *
802
+ * @param {string} text
803
+ * @param {object} [options={}]
804
+ * @returns {string}
805
+ */
806
+ function redactDiagnosticHomePath(text, options = {}) {
807
+ const raw = String(text ?? '');
808
+ const home = getHomeDir(options);
809
+ if (!home) return raw;
810
+ const escapeRx = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
811
+ const winHome = home.replace(/\//g, '\\');
812
+ const posixHome = home.replace(/\\/g, '/');
813
+ let out = raw;
814
+ if (winHome) {
815
+ out = out.replace(new RegExp(escapeRx(winHome), 'gi'), '~');
816
+ }
817
+ if (posixHome && posixHome !== winHome) {
818
+ out = out.replace(new RegExp(escapeRx(posixHome), 'gi'), '~');
819
+ }
820
+ return out;
821
+ }
822
+
823
+ /**
824
+ * Resolves `<cwd>/.claude/cache/ah_diagnostics.jsonl` (or `options.diagnosticsPath`).
825
+ *
826
+ * @param {object} [options={}]
827
+ * @returns {string}
828
+ */
829
+ export function getDiagnosticsFilePath(options = {}) {
830
+ if (typeof options?.diagnosticsPath === 'string' && options.diagnosticsPath.trim()) {
831
+ return options.diagnosticsPath.trim();
832
+ }
833
+ const cwd = getCwd(options);
834
+ return joinPath(cwd, '.claude', 'cache', 'ah_diagnostics.jsonl');
835
+ }
836
+
837
+ /**
838
+ * Records a structured non-fatal runtime diagnostic into the bounded 50-entry in-memory ring
839
+ * buffer and (when Tier-2 disk I/O is active AND an explicit `cwd` or `diagnosticsPath` is
840
+ * supplied) atomically maintains a bounded 50-line JSONL ring buffer at
841
+ * `<cwd>/.claude/cache/ah_diagnostics.jsonl`. Never writes to `stdout` (`ISS-065`).
842
+ *
843
+ * @param {string} source
844
+ * @param {string} operation
845
+ * @param {any} err
846
+ * @param {object} [options={}]
847
+ * @returns {object | null}
848
+ */
849
+ export function recordRuntimeDiagnostic(source, operation, err, options = {}) {
850
+ try {
851
+ const maxEntries = Math.max(1, Number(options?.maxEntries || MAX_RUNTIME_DIAGNOSTIC_ENTRIES));
852
+ const rawMsg =
853
+ typeof err === 'string'
854
+ ? err
855
+ : err && typeof err.message === 'string'
856
+ ? err.message
857
+ : String(err ?? 'unknown error');
858
+ const redactedMsg = redactDiagnosticHomePath(rawMsg, options).slice(0, 300);
859
+
860
+ const entry = {
861
+ timestamp:
862
+ typeof options?.timestamp === 'string'
863
+ ? options.timestamp
864
+ : new Date(options?.nowMs ?? Date.now()).toISOString(),
865
+ source: String(source || 'unknown'),
866
+ operation: String(operation || 'unknown'),
867
+ name: String(err?.name || 'Error').slice(0, 80),
868
+ message: redactedMsg
869
+ };
870
+
871
+ inMemoryDiagnosticsRing.push(entry);
872
+ if (inMemoryDiagnosticsRing.length > MAX_RUNTIME_DIAGNOSTIC_ENTRIES) {
873
+ inMemoryDiagnosticsRing.splice(
874
+ 0,
875
+ inMemoryDiagnosticsRing.length - MAX_RUNTIME_DIAGNOSTIC_ENTRIES
876
+ );
877
+ }
878
+
879
+ const explicitDiagPath =
880
+ typeof options?.diagnosticsPath === 'string' && options.diagnosticsPath.trim()
881
+ ? options.diagnosticsPath.trim()
882
+ : typeof options?.cwd === 'string' && options.cwd.trim() && options.cwd.trim() !== '.'
883
+ ? joinPath(options.cwd.trim(), '.claude', 'cache', 'ah_diagnostics.jsonl')
884
+ : null;
885
+
886
+ const fsMod = getNodeIo(options)?.fs;
887
+ if (fsMod && explicitDiagPath && options?.persistDisk !== false) {
888
+ const existingRaw = readTextSafe(explicitDiagPath, '', options) || '';
889
+ const lines = existingRaw
890
+ .split(/\r?\n/)
891
+ .map((line) => line.trim())
892
+ .filter(Boolean);
893
+ lines.push(JSON.stringify(entry));
894
+ const bounded = lines.length > maxEntries ? lines.slice(lines.length - maxEntries) : lines;
895
+ writeTextAtomic(explicitDiagPath, `${bounded.join('\n')}\n`, options);
896
+ }
897
+
898
+ return entry;
899
+ } catch {
900
+ return null;
901
+ }
902
+ }
903
+
904
+ /**
905
+ * Reads bounded structured runtime diagnostics from `<cwd>/.claude/cache/ah_diagnostics.jsonl`
906
+ * when Tier-2 disk I/O is available, or from the pure-JS in-memory ring buffer in V8 Mod isolates (`ISS-065`).
907
+ *
908
+ * @param {object} [options={}]
909
+ * @returns {Array<object>}
910
+ */
911
+ export function readRuntimeDiagnostics(options = {}) {
912
+ const maxEntries = Math.max(1, Number(options?.maxEntries || MAX_RUNTIME_DIAGNOSTIC_ENTRIES));
913
+ const fsMod = getNodeIo(options)?.fs;
914
+
915
+ if (!fsMod) {
916
+ return inMemoryDiagnosticsRing.slice(-maxEntries);
917
+ }
918
+
919
+ const targetPath = getDiagnosticsFilePath(options);
920
+ const raw = readTextSafe(targetPath, null, options);
921
+ const diskEntries = [];
922
+ if (raw) {
923
+ const lines = raw.split(/\r?\n/).filter((line) => line.trim().length > 0);
924
+ for (const line of lines) {
925
+ try {
926
+ const parsed = JSON.parse(line);
927
+ if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
928
+ diskEntries.push({
929
+ ...parsed,
930
+ message: redactDiagnosticHomePath(parsed.message || '', options).slice(0, 300)
931
+ });
932
+ }
933
+ } catch {
934
+ // Ignore malformed diagnostic line
935
+ }
936
+ }
937
+ }
938
+
939
+ if (options?.includeMemory) {
940
+ const combined = [...diskEntries, ...inMemoryDiagnosticsRing];
941
+ return combined.slice(-maxEntries);
942
+ }
943
+
944
+ return diskEntries.slice(-maxEntries);
945
+ }
946
+
947
+ /**
948
+ * Returns a snapshot of the bounded in-memory runtime diagnostics ring buffer.
949
+ *
950
+ * @param {number} [maxEntries=MAX_RUNTIME_DIAGNOSTIC_ENTRIES]
951
+ * @returns {Array<object>}
952
+ */
953
+ export function getInMemoryRuntimeDiagnostics(maxEntries = MAX_RUNTIME_DIAGNOSTIC_ENTRIES) {
954
+ return inMemoryDiagnosticsRing.slice(-Math.max(1, Number(maxEntries || MAX_RUNTIME_DIAGNOSTIC_ENTRIES)));
955
+ }
956
+
957
+ /**
958
+ * Clears the in-memory runtime diagnostics ring buffer (for deterministic unit testing).
959
+ */
960
+ export function clearInMemoryRuntimeDiagnostics() {
961
+ inMemoryDiagnosticsRing.length = 0;
962
+ }