ctxtop 4.0.0 → 4.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (357) hide show
  1. package/.antigravity-plugin/plugin.json +1 -1
  2. package/.claude-plugin/plugin.json +21 -18
  3. package/CHECKSUMS.sha256 +81 -57
  4. package/LICENSE +27 -27
  5. package/README.md +385 -330
  6. package/SECURITY.md +7 -1
  7. package/assets/hero-demo.svg +1 -1
  8. package/bin/ah-statusline.mjs +30 -0
  9. package/bin/ctxtop.mjs +587 -49
  10. package/config/default_flightcheck.json +19 -0
  11. package/config/modelCatalog.json +952 -213
  12. package/hooks/handlers/compact-lifecycle.mjs +323 -8
  13. package/hooks/handlers/config-change.mjs +402 -0
  14. package/hooks/handlers/hookIo.mjs +56 -0
  15. package/hooks/handlers/hookIpcClient.mjs +8 -4
  16. package/hooks/handlers/post-model-switch.mjs +148 -0
  17. package/hooks/handlers/post-tool-use-core.mjs +394 -0
  18. package/hooks/handlers/post-tool-use.mjs +54 -220
  19. package/hooks/handlers/pre-model-switch.mjs +933 -24
  20. package/hooks/handlers/pre-tool-use-core.mjs +680 -0
  21. package/hooks/handlers/pre-tool-use.mjs +61 -304
  22. package/hooks/handlers/stop-gate.mjs +310 -12
  23. package/hooks/handlers/user-prompt-submit.mjs +334 -1
  24. package/hooks/hooks.json +50 -0
  25. package/hooks/post_tool_use.mjs +24 -3
  26. package/hooks/pre_tool_use.mjs +84 -54
  27. package/hooks/register.js +48 -9
  28. package/hooks/session_start.mjs +11 -1
  29. package/hooks/stop.mjs +11 -1
  30. package/hooks.json +56 -56
  31. package/package.json +12 -4
  32. package/packages/antigravity/package.json +10 -3
  33. package/packages/antigravity/src/adapter.mjs +109 -0
  34. package/packages/antigravity/src/index.mjs +7 -1
  35. package/packages/claude-code/package.json +10 -3
  36. package/packages/claude-code/src/adapter.mjs +194 -0
  37. package/packages/claude-code/src/index.mjs +8 -2
  38. package/packages/claude-code/src/register.js +726 -0
  39. package/packages/core/package.json +6 -2
  40. package/packages/core/src/catalog/detectorCatalog.mjs +558 -0
  41. package/packages/core/src/catalog/index.mjs +1 -0
  42. package/packages/core/src/catalog/safeguardGuide.mjs +412 -0
  43. package/packages/core/src/coach/cacheGravityRouter.mjs +1547 -0
  44. package/packages/core/src/coach/effortShiftDetector.mjs +316 -0
  45. package/packages/core/src/coach/microSkills.mjs +1 -0
  46. package/packages/core/src/coach/promptHygieneGovernor.mjs +1 -0
  47. package/packages/core/src/coach/repoCalibration.mjs +254 -0
  48. package/packages/core/src/coach/resumeToolsetAuditor.mjs +321 -0
  49. package/packages/core/src/coach/savedQuotaLedger.mjs +527 -0
  50. package/packages/core/src/coach/smartCompactAdvisor.mjs +339 -0
  51. package/packages/core/src/coach/stateBatonHydrator.mjs +810 -0
  52. package/packages/core/src/coach/ttlWatchdog.mjs +464 -0
  53. package/packages/core/src/config/anthropicModelCatalog.json +607 -0
  54. package/packages/core/src/config/catalogLoader.mjs +1271 -0
  55. package/packages/core/src/config/horizonConfig.mjs +1055 -0
  56. package/packages/core/src/control/callTree.mjs +338 -0
  57. package/packages/core/src/control/coachLatches.mjs +126 -0
  58. package/packages/core/src/control/controlStateMachine.mjs +205 -0
  59. package/packages/core/src/control/index.mjs +49 -0
  60. package/packages/core/src/control/swarmWorktree.mjs +109 -0
  61. package/packages/core/src/control/toolSuspension.mjs +197 -0
  62. package/packages/core/src/diagnostics/drift_guard.mjs +382 -0
  63. package/packages/core/src/diagnostics/index.mjs +9 -0
  64. package/packages/core/src/diagnostics/micro_skills.mjs +471 -0
  65. package/packages/core/src/diagnostics/prompt_hygiene_governor.mjs +888 -0
  66. package/packages/core/src/economics/billingBlocks.mjs +251 -0
  67. package/packages/core/src/economics/cacheGravity.mjs +371 -0
  68. package/packages/core/src/economics/cliffBreaker.mjs +256 -0
  69. package/packages/core/src/economics/driftLatency.mjs +433 -0
  70. package/packages/core/src/economics/dualTtl.mjs +198 -0
  71. package/packages/core/src/economics/index.mjs +47 -0
  72. package/packages/core/src/economics/retentionRadar.mjs +348 -0
  73. package/packages/core/src/economics/shadowAutoModel.mjs +228 -0
  74. package/packages/core/src/guards/bucketBAlphaBeta.mjs +860 -0
  75. package/packages/core/src/guards/bucketBGamma.mjs +442 -0
  76. package/packages/core/src/guards/bucketBHeuristics.mjs +37 -0
  77. package/packages/core/src/guards/circuitBreakers.mjs +1202 -0
  78. package/packages/core/src/guards/det01_03_shell_secret.mjs +1184 -0
  79. package/packages/core/src/guards/det04_12_thrash_rot.mjs +572 -0
  80. package/packages/core/src/guards/det13_20_mcp_scope.mjs +913 -0
  81. package/packages/core/src/guards/docIndexCore.mjs +446 -0
  82. package/packages/core/src/guards/losslessPostSanitizer.mjs +317 -0
  83. package/packages/core/src/guards/slopsquatGate.mjs +551 -0
  84. package/packages/core/src/index.js +27 -0
  85. package/packages/core/src/index.mjs +25 -1
  86. package/packages/core/src/telemetry/otelExporter.mjs +187 -0
  87. package/packages/core/src/telemetry/scopeLockRegistry.mjs +522 -0
  88. package/packages/core/src/telemetry/sprintMetrics.mjs +327 -0
  89. package/packages/core/src/telemetry/swarmTopology.mjs +152 -0
  90. package/packages/core/src/telemetry/telemetryBridge.mjs +1232 -0
  91. package/packages/core/src/ui/brailleSparkline.mjs +142 -0
  92. package/packages/core/src/ui/costRadarSvg.mjs +276 -0
  93. package/packages/core/src/ui/horizonGrid.mjs +475 -0
  94. package/packages/core/src/ui/horizonPanelHtml.mjs +1502 -0
  95. package/packages/core/src/ui/modViews.mjs +1558 -0
  96. package/packages/core/src/ui/pdfReceiptGenerator.mjs +329 -0
  97. package/packages/core/src/ustf/index.mjs +7 -0
  98. package/packages/core/src/ustf/normalizer.mjs +512 -0
  99. package/packages/core/src/ustf/schema.mjs +186 -0
  100. package/packages/core/src/utils/runtime.mjs +962 -0
  101. package/packages/engine-node/package.json +6 -2
  102. package/packages/engine-node/src/db/index.mjs +58 -0
  103. package/packages/engine-node/src/db/jsonl_fallback.mjs +184 -0
  104. package/packages/engine-node/src/db/probe.mjs +342 -0
  105. package/packages/engine-node/src/db/sqlite_wrapper.mjs +122 -0
  106. package/packages/engine-node/src/index.mjs +11 -1
  107. package/packages/engine-node/src/ipc/client.mjs +447 -0
  108. package/packages/engine-node/src/ipc/fast_client.mjs +191 -0
  109. package/packages/engine-node/src/ipc/index.mjs +24 -0
  110. package/packages/engine-node/src/ipc/protocol.mjs +177 -0
  111. package/packages/engine-node/src/ipc/server.mjs +445 -0
  112. package/packages/engine-node/src/multi_host_mcp.mjs +168 -0
  113. package/packages/engine-node/src/offloader/index.mjs +6 -0
  114. package/packages/engine-node/src/offloader/tool_offloader.mjs +241 -0
  115. package/packages/engine-node/src/rsl/index.mjs +3 -0
  116. package/packages/engine-node/src/sensors/blindspots.mjs +376 -0
  117. package/packages/engine-node/src/sensors/git_merge_tree.mjs +223 -0
  118. package/packages/engine-node/src/sensors/index.mjs +7 -0
  119. package/packages/engine-node/src/vendor/config/default_flightcheck.json +133 -0
  120. package/packages/engine-node/src/vendor/config/modelCatalog.json +1359 -0
  121. package/packages/engine-node/src/vendor/config/platformQuirks.json +19 -0
  122. package/packages/engine-node/src/vendor/core/atomic_io.mjs +124 -0
  123. package/packages/engine-node/src/vendor/core/constants.mjs +2150 -0
  124. package/packages/engine-node/src/vendor/core/doc_indexer.mjs +338 -0
  125. package/packages/engine-node/src/vendor/core/rsl_clash_auditor.mjs +423 -0
  126. package/packages/engine-node/src/vendor/core/rsl_distiller.mjs +394 -0
  127. package/packages/engine-node/src/vendor/core/rsl_ledger.mjs +1029 -0
  128. package/packages/engine-node/src/vendor/core/rsl_triage.mjs +1051 -0
  129. package/packages/engine-node/src/vendor/core/shield_manager.mjs +1417 -0
  130. package/packages/engine-node/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  131. package/packages/engine-node/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  132. package/packages/engine-node/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  133. package/packages/engine-node/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  134. package/packages/engine-node/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  135. package/packages/engine-node/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  136. package/packages/engine-node/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  137. package/packages/engine-node/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  138. package/packages/engine-node/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  139. package/packages/engine-node/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  140. package/packages/engine-node/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  141. package/packages/engine-node/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  142. package/packages/engine-node/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  143. package/packages/engine-node/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  144. package/packages/engine-node/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  145. package/packages/engine-node/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  146. package/packages/engine-node/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  147. package/packages/engine-node/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  148. package/packages/engine-node/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  149. package/packages/engine-node/src/vendor/core-isomorphic/control/index.mjs +49 -0
  150. package/packages/engine-node/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  151. package/packages/engine-node/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  152. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  153. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  154. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  155. package/packages/engine-node/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  156. package/packages/engine-node/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  157. package/packages/engine-node/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  158. package/packages/engine-node/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  159. package/packages/engine-node/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  160. package/packages/engine-node/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  161. package/packages/engine-node/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  162. package/packages/engine-node/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  163. package/packages/engine-node/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  164. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  165. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  166. package/packages/engine-node/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  167. package/packages/engine-node/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  168. package/packages/engine-node/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  169. package/packages/engine-node/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  170. package/packages/engine-node/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  171. package/packages/engine-node/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  172. package/packages/engine-node/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  173. package/packages/engine-node/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  174. package/packages/engine-node/src/vendor/core-isomorphic/index.js +27 -0
  175. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  176. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  177. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  178. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  179. package/packages/engine-node/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  180. package/packages/engine-node/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  181. package/packages/engine-node/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  182. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  183. package/packages/engine-node/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  184. package/packages/engine-node/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  185. package/packages/engine-node/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  186. package/packages/engine-node/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  187. package/packages/engine-node/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  188. package/packages/engine-node/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  189. package/packages/engine-node/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  190. package/packages/mcp/package.json +7 -3
  191. package/packages/mcp/src/server.mjs +115 -14
  192. package/packages/mcp/src/vendor/config/default_flightcheck.json +133 -0
  193. package/packages/mcp/src/vendor/config/modelCatalog.json +1359 -0
  194. package/packages/mcp/src/vendor/config/platformQuirks.json +19 -0
  195. package/packages/mcp/src/vendor/core/atomic_io.mjs +124 -0
  196. package/packages/mcp/src/vendor/core/coach/saved_quota_ledger.mjs +615 -0
  197. package/packages/mcp/src/vendor/core/constants.mjs +2150 -0
  198. package/packages/mcp/src/vendor/core/doc_indexer.mjs +338 -0
  199. package/packages/mcp/src/vendor/core/fts5_output_compressor.mjs +596 -0
  200. package/packages/mcp/src/vendor/core/hook_diagnostics.mjs +158 -0
  201. package/packages/mcp/src/vendor/core/paths.mjs +311 -0
  202. package/packages/mcp/src/vendor/core/session_auditor.mjs +1109 -0
  203. package/packages/mcp/src/vendor/core/sqlite_client.mjs +289 -0
  204. package/packages/mcp/src/vendor/core/telemetry/scope_lock_registry.mjs +578 -0
  205. package/packages/mcp/src/vendor/core-isomorphic/catalog/detectorCatalog.mjs +558 -0
  206. package/packages/mcp/src/vendor/core-isomorphic/catalog/index.mjs +1 -0
  207. package/packages/mcp/src/vendor/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  208. package/packages/mcp/src/vendor/core-isomorphic/coach/cacheGravityRouter.mjs +1547 -0
  209. package/packages/mcp/src/vendor/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  210. package/packages/mcp/src/vendor/core-isomorphic/coach/microSkills.mjs +1 -0
  211. package/packages/mcp/src/vendor/core-isomorphic/coach/promptHygieneGovernor.mjs +1 -0
  212. package/packages/mcp/src/vendor/core-isomorphic/coach/repoCalibration.mjs +254 -0
  213. package/packages/mcp/src/vendor/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  214. package/packages/mcp/src/vendor/core-isomorphic/coach/savedQuotaLedger.mjs +527 -0
  215. package/packages/mcp/src/vendor/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  216. package/packages/mcp/src/vendor/core-isomorphic/coach/stateBatonHydrator.mjs +810 -0
  217. package/packages/mcp/src/vendor/core-isomorphic/coach/ttlWatchdog.mjs +464 -0
  218. package/packages/mcp/src/vendor/core-isomorphic/config/anthropicModelCatalog.json +607 -0
  219. package/packages/mcp/src/vendor/core-isomorphic/config/catalogLoader.mjs +1271 -0
  220. package/packages/mcp/src/vendor/core-isomorphic/config/horizonConfig.mjs +1055 -0
  221. package/packages/mcp/src/vendor/core-isomorphic/control/callTree.mjs +338 -0
  222. package/packages/mcp/src/vendor/core-isomorphic/control/coachLatches.mjs +126 -0
  223. package/packages/mcp/src/vendor/core-isomorphic/control/controlStateMachine.mjs +205 -0
  224. package/packages/mcp/src/vendor/core-isomorphic/control/index.mjs +49 -0
  225. package/packages/mcp/src/vendor/core-isomorphic/control/swarmWorktree.mjs +109 -0
  226. package/packages/mcp/src/vendor/core-isomorphic/control/toolSuspension.mjs +197 -0
  227. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/drift_guard.mjs +382 -0
  228. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/index.mjs +9 -0
  229. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/micro_skills.mjs +471 -0
  230. package/packages/mcp/src/vendor/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +888 -0
  231. package/packages/mcp/src/vendor/core-isomorphic/economics/billingBlocks.mjs +251 -0
  232. package/packages/mcp/src/vendor/core-isomorphic/economics/cacheGravity.mjs +371 -0
  233. package/packages/mcp/src/vendor/core-isomorphic/economics/cliffBreaker.mjs +256 -0
  234. package/packages/mcp/src/vendor/core-isomorphic/economics/driftLatency.mjs +433 -0
  235. package/packages/mcp/src/vendor/core-isomorphic/economics/dualTtl.mjs +198 -0
  236. package/packages/mcp/src/vendor/core-isomorphic/economics/index.mjs +47 -0
  237. package/packages/mcp/src/vendor/core-isomorphic/economics/retentionRadar.mjs +348 -0
  238. package/packages/mcp/src/vendor/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  239. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  240. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  241. package/packages/mcp/src/vendor/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  242. package/packages/mcp/src/vendor/core-isomorphic/guards/circuitBreakers.mjs +1202 -0
  243. package/packages/mcp/src/vendor/core-isomorphic/guards/det01_03_shell_secret.mjs +1184 -0
  244. package/packages/mcp/src/vendor/core-isomorphic/guards/det04_12_thrash_rot.mjs +572 -0
  245. package/packages/mcp/src/vendor/core-isomorphic/guards/det13_20_mcp_scope.mjs +913 -0
  246. package/packages/mcp/src/vendor/core-isomorphic/guards/docIndexCore.mjs +446 -0
  247. package/packages/mcp/src/vendor/core-isomorphic/guards/losslessPostSanitizer.mjs +317 -0
  248. package/packages/mcp/src/vendor/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  249. package/packages/mcp/src/vendor/core-isomorphic/index.js +27 -0
  250. package/packages/mcp/src/vendor/core-isomorphic/telemetry/otelExporter.mjs +187 -0
  251. package/packages/mcp/src/vendor/core-isomorphic/telemetry/scopeLockRegistry.mjs +522 -0
  252. package/packages/mcp/src/vendor/core-isomorphic/telemetry/sprintMetrics.mjs +327 -0
  253. package/packages/mcp/src/vendor/core-isomorphic/telemetry/swarmTopology.mjs +152 -0
  254. package/packages/mcp/src/vendor/core-isomorphic/telemetry/telemetryBridge.mjs +1232 -0
  255. package/packages/mcp/src/vendor/core-isomorphic/ui/brailleSparkline.mjs +142 -0
  256. package/packages/mcp/src/vendor/core-isomorphic/ui/costRadarSvg.mjs +276 -0
  257. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonGrid.mjs +475 -0
  258. package/packages/mcp/src/vendor/core-isomorphic/ui/horizonPanelHtml.mjs +1502 -0
  259. package/packages/mcp/src/vendor/core-isomorphic/ui/modViews.mjs +1558 -0
  260. package/packages/mcp/src/vendor/core-isomorphic/ui/pdfReceiptGenerator.mjs +329 -0
  261. package/packages/mcp/src/vendor/core-isomorphic/ustf/index.mjs +7 -0
  262. package/packages/mcp/src/vendor/core-isomorphic/ustf/normalizer.mjs +512 -0
  263. package/packages/mcp/src/vendor/core-isomorphic/ustf/schema.mjs +186 -0
  264. package/packages/mcp/src/vendor/core-isomorphic/utils/runtime.mjs +962 -0
  265. package/packages/mcp/src/vendor/engine-node/db/probe.mjs +342 -0
  266. package/packages/mcp/src/vendor/pro/pro_license.mjs +547 -0
  267. package/packages/pro/package.json +23 -16
  268. package/packages/pro/src/index.mjs +9 -3
  269. package/packages/pro/src/pro_license.mjs +547 -0
  270. package/packages/pro/src/team_finops_pack.mjs +241 -241
  271. package/packages/pro/workers/polar_webhook_worker.mjs +219 -215
  272. package/plugin.json +1 -1
  273. package/sidecars/horizon-daemon/server.mjs +514 -40
  274. package/skills/handoff/SKILL.md +8 -0
  275. package/src/adapters/antigravity/index.mjs +31 -1
  276. package/src/adapters/claude-code/index.mjs +40 -1
  277. package/src/cli/doctor.mjs +11 -2
  278. package/src/cli/horizon_hud.mjs +283 -65
  279. package/src/cli/init.mjs +46 -13
  280. package/src/config/modelCatalog.json +952 -213
  281. package/src/core/bucket_b_runtime.mjs +1200 -0
  282. package/src/core/classifier.mjs +25 -11
  283. package/src/core/coach/circuit_breakers.mjs +84 -6
  284. package/src/core/coach/task_quota_router.mjs +8 -0
  285. package/src/core/code_fold_lite.mjs +169 -0
  286. package/src/core/config.mjs +44 -0
  287. package/src/core/constants.mjs +365 -15
  288. package/src/core/detectors_det01_to_16.mjs +98 -8
  289. package/src/core/doc_indexer.mjs +338 -0
  290. package/src/core/fts5_output_compressor.mjs +272 -35
  291. package/src/core/horizon_config.mjs +42 -0
  292. package/src/core/layer5_hygiene.mjs +118 -0
  293. package/src/core/parser.mjs +88 -12
  294. package/src/core/paths.mjs +3 -2
  295. package/src/core/pro_license.mjs +174 -12
  296. package/src/core/pruner.mjs +7 -146
  297. package/src/core/quota.mjs +14 -2
  298. package/src/core/rsl_clash_auditor.mjs +423 -0
  299. package/src/core/rsl_distiller.mjs +394 -0
  300. package/src/core/rsl_ledger.mjs +1029 -0
  301. package/src/core/rsl_triage.mjs +1051 -0
  302. package/src/core/session_auditor.mjs +1109 -0
  303. package/src/core/shadow_auto_ledger.mjs +205 -0
  304. package/src/core/shield_manager.mjs +1417 -0
  305. package/src/core/sqlite_client.mjs +10 -4
  306. package/src/core/subagents.mjs +18 -2
  307. package/src/core/task_quota_router.mjs +62 -5
  308. package/src/core-isomorphic/catalog/safeguardGuide.mjs +412 -0
  309. package/src/core-isomorphic/coach/cacheGravityRouter.mjs +874 -47
  310. package/src/core-isomorphic/coach/effortShiftDetector.mjs +316 -0
  311. package/src/core-isomorphic/coach/resumeToolsetAuditor.mjs +321 -0
  312. package/src/core-isomorphic/coach/smartCompactAdvisor.mjs +339 -0
  313. package/src/core-isomorphic/coach/ttlWatchdog.mjs +13 -6
  314. package/src/core-isomorphic/config/anthropicModelCatalog.json +405 -1
  315. package/src/core-isomorphic/config/catalogLoader.mjs +549 -46
  316. package/src/core-isomorphic/config/horizonConfig.mjs +47 -1
  317. package/src/core-isomorphic/diagnostics/prompt_hygiene_governor.mjs +266 -0
  318. package/src/core-isomorphic/economics/cacheGravity.mjs +21 -1
  319. package/src/core-isomorphic/economics/cliffBreaker.mjs +98 -12
  320. package/src/core-isomorphic/economics/driftLatency.mjs +114 -0
  321. package/src/core-isomorphic/economics/shadowAutoModel.mjs +228 -0
  322. package/src/core-isomorphic/guards/bucketBAlphaBeta.mjs +860 -0
  323. package/src/core-isomorphic/guards/bucketBGamma.mjs +442 -0
  324. package/src/core-isomorphic/guards/bucketBHeuristics.mjs +37 -0
  325. package/src/core-isomorphic/guards/circuitBreakers.mjs +191 -191
  326. package/src/core-isomorphic/guards/det01_03_shell_secret.mjs +154 -5
  327. package/src/core-isomorphic/guards/det04_12_thrash_rot.mjs +103 -11
  328. package/src/core-isomorphic/guards/det13_20_mcp_scope.mjs +311 -1
  329. package/src/core-isomorphic/guards/docIndexCore.mjs +446 -0
  330. package/src/core-isomorphic/guards/losslessPostSanitizer.mjs +16 -0
  331. package/src/core-isomorphic/guards/slopsquatGate.mjs +551 -0
  332. package/src/core-isomorphic/index.js +1 -0
  333. package/src/core-isomorphic/telemetry/telemetryBridge.mjs +113 -13
  334. package/src/core-isomorphic/ui/horizonPanelHtml.mjs +684 -363
  335. package/src/core-isomorphic/ui/modViews.mjs +95 -15
  336. package/src/diagnostics/claudeHookCapabilities.mjs +426 -0
  337. package/src/diagnostics/doctorEngine.mjs +122 -4
  338. package/src/engine-node/db/probe.mjs +234 -2
  339. package/src/engine-node/index.mjs +3 -0
  340. package/src/engine-node/ipc/fast_client.mjs +191 -0
  341. package/src/engine-node/ipc/index.mjs +2 -0
  342. package/src/engine-node/multi_host_mcp.mjs +168 -0
  343. package/src/engine-node/sensors/blindspots.mjs +13 -6
  344. package/src/hooks/antigravity_rsl_hook.mjs +272 -0
  345. package/src/hooks/claude_rsl_hook.mjs +308 -0
  346. package/src/hooks/daemon_hook_bridge.mjs +256 -0
  347. package/src/hooks/fast_hook_ipc.mjs +295 -0
  348. package/src/hooks/post_invocation.mjs +37 -405
  349. package/src/hooks/post_invocation_core.mjs +623 -0
  350. package/src/hooks/pre_invocation.mjs +103 -958
  351. package/src/hooks/pre_invocation_core.mjs +1830 -0
  352. package/src/hooks/session_start.mjs +39 -1
  353. package/src/utils/modelSwitchTelemetry.mjs +308 -0
  354. package/src/utils/sessionCalibration.mjs +704 -0
  355. package/src/webview/advanced_view.html +34 -18
  356. package/src/webview/horizon_panel.html +4191 -625
  357. package/src/webview/simple_view.html +1 -1
@@ -0,0 +1,122 @@
1
+ /**
2
+ * @file src/engine-node/db/sqlite_wrapper.mjs
3
+ * Read-only wrapper around node:sqlite DatabaseSync.
4
+ *
5
+ * Strictly enforces { readOnly: true } invariant and rejects any mutating SQL.
6
+ */
7
+
8
+ import path from 'node:path';
9
+ import { getDatabaseSyncClass } from './probe.mjs';
10
+
11
+ const MUTATION_SQL_RE = /^\s*(INSERT|UPDATE|DELETE|DROP|ALTER|CREATE|REPLACE|ATTACH|DETACH|VACUUM|REINDEX)\b/i;
12
+
13
+ export class SqliteDatabaseSyncWrapper {
14
+ /**
15
+ * @param {string} dbPath
16
+ * @param {object} options
17
+ * @param {boolean} options.readOnly - Must strictly be true
18
+ * @param {Function} [options.DatabaseSync] - Optional constructor override
19
+ */
20
+ constructor(dbPath, options = {}) {
21
+ if (!options || options.readOnly !== true) {
22
+ throw new Error('[Zero-Trust SQLite Guard] SqliteDatabaseSyncWrapper strictly requires { readOnly: true }');
23
+ }
24
+ if (!dbPath || typeof dbPath !== 'string') {
25
+ throw new TypeError('SqliteDatabaseSyncWrapper requires a non-empty dbPath string');
26
+ }
27
+
28
+ this.dbPath = (dbPath === ':memory:' || dbPath.startsWith('file:')) ? dbPath : path.resolve(dbPath);
29
+ this.readOnly = true;
30
+ this.isOpen = true;
31
+
32
+ const DbCtor = options.DatabaseSync || getDatabaseSyncClass(options);
33
+ if (!DbCtor) {
34
+ throw new Error('DatabaseSync constructor is unavailable in this runtime');
35
+ }
36
+
37
+ this.db = new DbCtor(this.dbPath, { readOnly: true, readonly: true });
38
+ try {
39
+ if (typeof this.db.exec === 'function') {
40
+ this.db.exec('PRAGMA busy_timeout = 3000;');
41
+ }
42
+ } catch {
43
+ // Ignore pragma rejection on immutable/locked handles
44
+ }
45
+ }
46
+
47
+ _assertNotMutating(sql) {
48
+ if (!sql || typeof sql !== 'string') return;
49
+ const stripped = sql
50
+ .replace(/\/\*[\s\S]*?\*\//g, ' ')
51
+ .replace(/--.*$/gm, ' ')
52
+ .trim();
53
+
54
+ const statements = stripped.split(';').map(s => s.trim()).filter(Boolean);
55
+ for (const stmt of statements) {
56
+ if (MUTATION_SQL_RE.test(stmt)) {
57
+ throw new Error(`[Zero-Trust SQLite Guard] Mutation query not permitted on read-only database: ${sql}`);
58
+ }
59
+ if (/^\s*WITH\b/i.test(stmt) && /\b(DELETE|INSERT|UPDATE|DROP|ALTER|REPLACE)\b/i.test(stmt)) {
60
+ throw new Error(`[Zero-Trust SQLite Guard] Mutation query not permitted on read-only database: ${sql}`);
61
+ }
62
+ }
63
+ }
64
+
65
+ get(sql, params = []) {
66
+ if (!this.isOpen) throw new Error('Database handle is closed');
67
+ this._assertNotMutating(sql);
68
+ const stmt = this.db.prepare(sql);
69
+ if (Array.isArray(params)) return stmt.get(...params);
70
+ if (params !== undefined && params !== null) return stmt.get(params);
71
+ return stmt.get();
72
+ }
73
+
74
+ all(sql, params = []) {
75
+ if (!this.isOpen) throw new Error('Database handle is closed');
76
+ this._assertNotMutating(sql);
77
+ const stmt = this.db.prepare(sql);
78
+ if (Array.isArray(params)) return stmt.all(...params);
79
+ if (params !== undefined && params !== null) return stmt.all(params);
80
+ return stmt.all();
81
+ }
82
+
83
+ searchFts(query, limit = 10, { table = null } = {}) {
84
+ if (!this.isOpen) throw new Error('Database handle is closed');
85
+ if (!query || typeof query !== 'string') return [];
86
+
87
+ let targetTable = table;
88
+ if (!targetTable) {
89
+ try {
90
+ const tables = this.all("SELECT name FROM sqlite_master WHERE type='table' AND sql LIKE '%fts5%'");
91
+ if (tables.length > 0) targetTable = tables[0].name;
92
+ } catch {
93
+ // Fall back to null
94
+ }
95
+ }
96
+
97
+ if (!targetTable) return [];
98
+
99
+ try {
100
+ const sanitized = query.replace(/['"*]/g, ' ').trim();
101
+ if (!sanitized) return [];
102
+ const sql = `SELECT *, snippet(${targetTable}, -1, '[', ']', '...', 16) AS snippet, bm25(${targetTable}) AS score ` +
103
+ `FROM ${targetTable} WHERE ${targetTable} MATCH ? ORDER BY score LIMIT ?`;
104
+ return this.all(sql, [sanitized, limit]);
105
+ } catch {
106
+ return [];
107
+ }
108
+ }
109
+
110
+ close() {
111
+ if (this.isOpen) {
112
+ this.isOpen = false;
113
+ try {
114
+ if (typeof this.db.close === 'function') this.db.close();
115
+ } catch {
116
+ // Safe close
117
+ }
118
+ }
119
+ }
120
+ }
121
+
122
+ export default SqliteDatabaseSyncWrapper;
@@ -1 +1,11 @@
1
- export * from '../../../src/engine-node/index.mjs';
1
+ /**
2
+ * @file packages/engine-node/src/index.mjs
3
+ * Highbeam Node.js >=20 runtime engine barrel (@ctxtop/engine-node).
4
+ * Standalone publishable SQLite + JSONL fallback, Micro-IPC, offloader, git sensors & RSL.
5
+ */
6
+
7
+ export * from './db/index.mjs';
8
+ export * from './sensors/index.mjs';
9
+ export * from './offloader/index.mjs';
10
+ export * from './ipc/index.mjs';
11
+ export * from './rsl/index.mjs';
@@ -0,0 +1,447 @@
1
+ /**
2
+ * @file src/engine-node/ipc/client.mjs
3
+ * Highbeam Micro-IPC Client.
4
+ *
5
+ * Implements high-performance (<0.8ms SLA, p95 ~0.13ms) local IPC communication
6
+ * with persistent warm socket reuse, message demultiplexing, and 15ms failover
7
+ * to local in-process fallback execution when daemon is offline.
8
+ * Strictly 0 npm dependencies (uses only standard node:* built-ins).
9
+ */
10
+
11
+ import net from 'node:net';
12
+ import {
13
+ resolveIpcPath,
14
+ formatJsonRpcRequest,
15
+ JsonRpcStreamParser,
16
+ IPC_LIMITS
17
+ } from './protocol.mjs';
18
+
19
+ export class MicroIpcClient {
20
+ /**
21
+ * @param {object} [options]
22
+ * @param {string} [options.ipcPath]
23
+ * @param {number} [options.connectTimeoutMs=15]
24
+ * @param {number} [options.requestTimeoutMs=500]
25
+ * @param {boolean} [options.persistent=true]
26
+ */
27
+ constructor(options = {}) {
28
+ this.ipcPath = resolveIpcPath(options);
29
+ this.connectTimeoutMs = options.connectTimeoutMs ?? IPC_LIMITS.DEFAULT_CONNECT_TIMEOUT_MS;
30
+ this.requestTimeoutMs = options.requestTimeoutMs ?? IPC_LIMITS.DEFAULT_REQUEST_TIMEOUT_MS;
31
+ this.persistent = options.persistent ?? true;
32
+
33
+ // Warm socket management
34
+ this.activeSocket = null;
35
+ this.streamParser = null;
36
+ this.connectingPromise = null;
37
+
38
+ // In-flight pending requests: Map<reqId, { resolve, reject, timer, method }>
39
+ this.pendingRequests = new Map();
40
+ this.isClosed = false;
41
+ }
42
+
43
+ /**
44
+ * Returns the warm active socket if connected and writable, or initiates
45
+ * a new connection if none exists or the previous socket was closed.
46
+ *
47
+ * @param {number} connectTimeoutMs
48
+ * @returns {Promise<import('node:net').Socket>}
49
+ * @private
50
+ */
51
+ async _ensureConnected(connectTimeoutMs) {
52
+ if (this.isClosed) {
53
+ this.isClosed = false;
54
+ }
55
+
56
+ if (
57
+ this.activeSocket &&
58
+ !this.activeSocket.destroyed &&
59
+ !this.activeSocket.connecting &&
60
+ this.activeSocket.writable
61
+ ) {
62
+ return this.activeSocket;
63
+ }
64
+
65
+ if (this.connectingPromise) {
66
+ return this.connectingPromise;
67
+ }
68
+
69
+ this.connectingPromise = this._connect(connectTimeoutMs);
70
+ try {
71
+ return await this.connectingPromise;
72
+ } finally {
73
+ this.connectingPromise = null;
74
+ }
75
+ }
76
+
77
+ /**
78
+ * Establishes a new connection to the IPC socket / pipe.
79
+ *
80
+ * @param {number} connectTimeoutMs
81
+ * @returns {Promise<import('node:net').Socket>}
82
+ * @private
83
+ */
84
+ _connect(connectTimeoutMs) {
85
+ return new Promise((resolve, reject) => {
86
+ let settled = false;
87
+ let connectTimer = null;
88
+ let socket = null;
89
+
90
+ const cleanupTimer = () => {
91
+ if (connectTimer) {
92
+ clearTimeout(connectTimer);
93
+ connectTimer = null;
94
+ }
95
+ };
96
+
97
+ try {
98
+ socket = net.connect(this.ipcPath);
99
+ } catch (err) {
100
+ return reject(err);
101
+ }
102
+
103
+ // Fast connection timeout guard (default 15ms)
104
+ connectTimer = setTimeout(() => {
105
+ if (!settled) {
106
+ settled = true;
107
+ cleanupTimer();
108
+ try {
109
+ socket.destroy();
110
+ } catch (_err) {
111
+ void _err;
112
+ }
113
+ reject(new Error(`[MicroIPC] Connection timeout (${connectTimeoutMs}ms) to ${this.ipcPath}`));
114
+ }
115
+ }, connectTimeoutMs);
116
+
117
+ // Create stream parser attached to this socket
118
+ const parser = new JsonRpcStreamParser(
119
+ (msg) => this._onMessage(msg),
120
+ (parseErr) => this._onParseError(parseErr, socket)
121
+ );
122
+
123
+ socket.on('connect', () => {
124
+ if (settled) return;
125
+ settled = true;
126
+ cleanupTimer();
127
+
128
+ // Unref warm idle socket so it does not keep Node.js event loop alive unnecessarily
129
+ socket.unref();
130
+
131
+ this.activeSocket = socket;
132
+ this.streamParser = parser;
133
+ resolve(socket);
134
+ });
135
+
136
+ socket.on('data', (chunk) => {
137
+ parser.feed(chunk);
138
+ });
139
+
140
+ socket.on('error', (err) => {
141
+ if (!settled) {
142
+ settled = true;
143
+ cleanupTimer();
144
+ reject(err);
145
+ }
146
+ this._handleSocketError(socket, err);
147
+ });
148
+
149
+ socket.on('close', () => {
150
+ if (!settled) {
151
+ settled = true;
152
+ cleanupTimer();
153
+ reject(new Error('[MicroIPC] Socket closed during connection'));
154
+ }
155
+ this._handleSocketClose(socket);
156
+ });
157
+ });
158
+ }
159
+
160
+ /**
161
+ * Handles unexpected socket errors, cleans up active state, and rejects in-flight requests.
162
+ *
163
+ * @param {import('node:net').Socket} socket
164
+ * @param {Error} err
165
+ * @private
166
+ */
167
+ _handleSocketError(socket, err) {
168
+ if (this.activeSocket === socket) {
169
+ this.activeSocket = null;
170
+ this.streamParser = null;
171
+ }
172
+ const errorMsg = err?.message || 'Unknown socket error';
173
+ this._rejectAllPending(new Error(`[MicroIPC] Socket error: ${errorMsg}`));
174
+ }
175
+
176
+ /**
177
+ * Handles socket close / disconnect events, cleans up active state, and rejects in-flight requests.
178
+ *
179
+ * @param {import('node:net').Socket} socket
180
+ * @private
181
+ */
182
+ _handleSocketClose(socket) {
183
+ if (this.activeSocket === socket) {
184
+ this.activeSocket = null;
185
+ this.streamParser = null;
186
+ }
187
+ this._rejectAllPending(new Error('[MicroIPC] Socket closed before receiving response'));
188
+ }
189
+
190
+ /**
191
+ * Handles JSON-RPC stream parser errors (e.g. buffer overrun).
192
+ *
193
+ * @param {Error} parseErr
194
+ * @param {import('node:net').Socket} socket
195
+ * @private
196
+ */
197
+ _onParseError(parseErr, socket) {
198
+ if (this.activeSocket === socket) {
199
+ this.activeSocket = null;
200
+ this.streamParser = null;
201
+ try {
202
+ socket.destroy();
203
+ } catch (_err) {
204
+ void _err;
205
+ }
206
+ }
207
+ this._rejectAllPending(parseErr);
208
+ }
209
+
210
+ /**
211
+ * Rejects all currently pending in-flight requests with the given error.
212
+ *
213
+ * @param {Error} error
214
+ * @private
215
+ */
216
+ _rejectAllPending(error) {
217
+ const entries = Array.from(this.pendingRequests.entries());
218
+ this.pendingRequests.clear();
219
+ for (const [id, pending] of entries) {
220
+ if (pending.timer) {
221
+ clearTimeout(pending.timer);
222
+ pending.timer = null;
223
+ }
224
+ try {
225
+ pending.reject(error);
226
+ } catch (_err) {
227
+ void _err;
228
+ }
229
+ }
230
+ }
231
+
232
+ /**
233
+ * Dispatches incoming parsed JSON-RPC responses to their matching pending request.
234
+ *
235
+ * @param {object} msg
236
+ * @private
237
+ */
238
+ _onMessage(msg) {
239
+ if (!msg || typeof msg !== 'object') return;
240
+ const id = msg.id;
241
+ if (id === null || id === undefined) return;
242
+
243
+ const pending = this.pendingRequests.get(id);
244
+ if (!pending) return;
245
+
246
+ this.pendingRequests.delete(id);
247
+ if (pending.timer) {
248
+ clearTimeout(pending.timer);
249
+ pending.timer = null;
250
+ }
251
+
252
+ if (msg.error) {
253
+ const errMsg = typeof msg.error === 'string'
254
+ ? msg.error
255
+ : (msg.error.message || 'JSON-RPC Error');
256
+ const err = new Error(errMsg);
257
+ if (typeof msg.error === 'object' && msg.error.code !== undefined) {
258
+ err.code = msg.error.code;
259
+ }
260
+ if (typeof msg.error === 'object' && msg.error.data !== undefined) {
261
+ err.data = msg.error.data;
262
+ }
263
+ pending.reject(err);
264
+ } else {
265
+ pending.resolve(msg.result);
266
+ }
267
+ }
268
+
269
+ /**
270
+ * Executes a remote JSON-RPC 2.0 method over the warm local IPC socket/pipe.
271
+ *
272
+ * @param {string} method
273
+ * @param {*} [params={}]
274
+ * @param {object} [options={}]
275
+ * @param {number} [options.connectTimeoutMs]
276
+ * @param {number} [options.requestTimeoutMs]
277
+ * @param {boolean} [options.persistent]
278
+ * @returns {Promise<*>} Result payload
279
+ */
280
+ async call(method, params = {}, options = {}) {
281
+ const connectTimeout = options.connectTimeoutMs ?? this.connectTimeoutMs;
282
+ const requestTimeout = options.requestTimeoutMs ?? this.requestTimeoutMs;
283
+ const isPersistent = options.persistent ?? this.persistent;
284
+ const id = Date.now() + Math.random().toString(36).slice(2, 8);
285
+
286
+ const socket = await this._ensureConnected(connectTimeout);
287
+
288
+ return new Promise((resolve, reject) => {
289
+ let requestTimer = null;
290
+
291
+ requestTimer = setTimeout(() => {
292
+ if (this.pendingRequests.has(id)) {
293
+ this.pendingRequests.delete(id);
294
+ // When a request times out, destroy the socket to cleanly cancel remote work
295
+ // and trigger server-side suspension cleanup without leaks.
296
+ if (this.activeSocket === socket) {
297
+ this.activeSocket = null;
298
+ this.streamParser = null;
299
+ try {
300
+ socket.destroy();
301
+ } catch (_err) {
302
+ void _err;
303
+ }
304
+ }
305
+ reject(new Error(`[MicroIPC] Request timeout (${requestTimeout}ms) for method ${method}`));
306
+ }
307
+ }, requestTimeout);
308
+
309
+ this.pendingRequests.set(id, {
310
+ resolve: (result) => {
311
+ if (!isPersistent) {
312
+ this.close();
313
+ }
314
+ resolve(result);
315
+ },
316
+ reject: (err) => {
317
+ if (!isPersistent) {
318
+ this.close();
319
+ }
320
+ reject(err);
321
+ },
322
+ timer: requestTimer,
323
+ method
324
+ });
325
+
326
+ try {
327
+ const payload = formatJsonRpcRequest(method, params, id);
328
+ socket.write(payload, (writeErr) => {
329
+ if (writeErr) {
330
+ if (this.pendingRequests.has(id)) {
331
+ this.pendingRequests.delete(id);
332
+ if (requestTimer) {
333
+ clearTimeout(requestTimer);
334
+ requestTimer = null;
335
+ }
336
+ if (this.activeSocket === socket) {
337
+ this.activeSocket = null;
338
+ this.streamParser = null;
339
+ try {
340
+ socket.destroy();
341
+ } catch (_e) {
342
+ void _e;
343
+ }
344
+ }
345
+ reject(writeErr);
346
+ }
347
+ }
348
+ });
349
+ } catch (err) {
350
+ if (this.pendingRequests.has(id)) {
351
+ this.pendingRequests.delete(id);
352
+ if (requestTimer) {
353
+ clearTimeout(requestTimer);
354
+ requestTimer = null;
355
+ }
356
+ }
357
+ if (this.activeSocket === socket) {
358
+ this.activeSocket = null;
359
+ this.streamParser = null;
360
+ try {
361
+ socket.destroy();
362
+ } catch (_e) {
363
+ void _e;
364
+ }
365
+ }
366
+ reject(err);
367
+ }
368
+ });
369
+ }
370
+
371
+ /**
372
+ * Calls a remote method, seamlessly falling back to local evaluation if the IPC
373
+ * daemon is unreachable, delayed >15ms, or errors.
374
+ *
375
+ * @param {string} method
376
+ * @param {*} params
377
+ * @param {Function} fallbackFn
378
+ * @param {object} [options]
379
+ * @returns {Promise<{ source: 'ipc' | 'fallback', result: *, fallbackReason?: string }>}
380
+ */
381
+ async callWithFallback(method, params, fallbackFn, options = {}) {
382
+ try {
383
+ const result = await this.call(method, params, options);
384
+ return { source: 'ipc', result };
385
+ } catch (err) {
386
+ try {
387
+ const fallbackResult = await fallbackFn(params, err);
388
+ return {
389
+ source: 'fallback',
390
+ result: fallbackResult,
391
+ fallbackReason: err.message
392
+ };
393
+ } catch (fallbackErr) {
394
+ throw fallbackErr;
395
+ }
396
+ }
397
+ }
398
+
399
+ /**
400
+ * Pings the IPC daemon. Returns true if responsive within timeout, false otherwise.
401
+ * Defaults to this.requestTimeoutMs or 500ms instead of hardcoded 15ms.
402
+ *
403
+ * @param {number} [timeoutMs]
404
+ * @returns {Promise<boolean>}
405
+ */
406
+ async ping(timeoutMs = this.requestTimeoutMs ?? 500) {
407
+ const effectiveTimeout = timeoutMs ?? this.requestTimeoutMs ?? 500;
408
+ try {
409
+ await this.call('daemon.ping', {}, { connectTimeoutMs: effectiveTimeout, requestTimeoutMs: effectiveTimeout });
410
+ return true;
411
+ } catch (_err) {
412
+ return false;
413
+ }
414
+ }
415
+
416
+ /**
417
+ * Closes the active socket connection and cleans up pending requests.
418
+ *
419
+ * @returns {Promise<void>}
420
+ */
421
+ async close() {
422
+ if (this.isClosed) return;
423
+ this.isClosed = true;
424
+ const sock = this.activeSocket;
425
+ this.activeSocket = null;
426
+ this.streamParser = null;
427
+ this.connectingPromise = null;
428
+
429
+ if (sock && !sock.destroyed) {
430
+ try {
431
+ sock.end();
432
+ sock.destroy();
433
+ } catch (_err) {
434
+ void _err;
435
+ }
436
+ }
437
+
438
+ this._rejectAllPending(new Error('[MicroIPC] Client closed'));
439
+ }
440
+
441
+ /**
442
+ * Alias for close() for stream/socket lifecycle compatibility.
443
+ */
444
+ destroy() {
445
+ this.close();
446
+ }
447
+ }