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
@@ -2,6 +2,7 @@ import { EventEmitter } from 'node:events';
2
2
  import crypto from 'node:crypto';
3
3
  import fs from 'node:fs';
4
4
  import path from 'node:path';
5
+ import { fileURLToPath } from 'node:url';
5
6
  import { canonicalizePath } from './paths.mjs';
6
7
  import { loadHorizonConfig, filterFindingsByHorizonConfig } from './horizon_config.mjs';
7
8
  import { inspectGitArgs } from '../shims/agy_git_guard.mjs';
@@ -48,7 +49,46 @@ export function evaluateDet17ShadowFileBloat(steps = []) {
48
49
  };
49
50
  }
50
51
 
51
- function inspectSettingsContentHazards(rawContent = '', relLabel = '') {
52
+ function isVerifiedCanonicalRslHookCommand(cmd = '', relLabel = '', options = {}) {
53
+ if (!options?.scanWorkspace || !options?.wsRoot) return false;
54
+ if (!/\.agents[\\/]hooks\.json$/i.test(String(relLabel || ''))) return false;
55
+ const trimmed = String(cmd || '').trim();
56
+ if (
57
+ !/^node\s+(?:--no-warnings\s+)?plugins\/agy-horizon-flightcheck\/src\/hooks\/antigravity_rsl_hook\.mjs\s+--event=PreToolUse$/.test(
58
+ trimmed
59
+ )
60
+ ) {
61
+ return false;
62
+ }
63
+ try {
64
+ const wsScript = path.join(
65
+ options.wsRoot,
66
+ '.agents',
67
+ 'plugins',
68
+ 'agy-horizon-flightcheck',
69
+ 'src',
70
+ 'hooks',
71
+ 'antigravity_rsl_hook.mjs'
72
+ );
73
+ const canonicalScript = path.resolve(
74
+ path.dirname(fileURLToPath(import.meta.url)),
75
+ '..',
76
+ 'hooks',
77
+ 'antigravity_rsl_hook.mjs'
78
+ );
79
+ if (!fs.existsSync(wsScript) || !fs.existsSync(canonicalScript)) return false;
80
+ const hashLf = (filePath) =>
81
+ crypto
82
+ .createHash('sha256')
83
+ .update(fs.readFileSync(filePath, 'utf8').replace(/\r\n/g, '\n'), 'utf8')
84
+ .digest('hex');
85
+ return hashLf(wsScript) === hashLf(canonicalScript);
86
+ } catch {
87
+ return false;
88
+ }
89
+ }
90
+
91
+ function inspectSettingsContentHazards(rawContent = '', relLabel = '', options = {}) {
52
92
  const text = String(rawContent || '');
53
93
  const hazards = [];
54
94
 
@@ -117,7 +157,8 @@ function inspectSettingsContentHazards(rawContent = '', relLabel = '') {
117
157
  entry.cmd.includes('[CLI Output Dampener]') &&
118
158
  !entry.cmd.includes('child_process') &&
119
159
  !/\b(curl|wget|Invoke-WebRequest|iex|spawn|exec)\b/i.test(entry.cmd);
120
- if (!isTrustedPluginRootRelHook && !isTrustedHorizonPlugin && !isBenignDampener) {
160
+ const isVerifiedRslHook = isVerifiedCanonicalRslHookCommand(entry.cmd, relLabel, options);
161
+ if (!isTrustedPluginRootRelHook && !isTrustedHorizonPlugin && !isBenignDampener && !isVerifiedRslHook) {
121
162
  hazards.push('UNTRUSTED_HOOK_OR_MCP_COMMAND');
122
163
  break;
123
164
  }
@@ -201,7 +242,7 @@ export function evaluateDet18UntrustedWorkspaceSettings(paramsOrSteps = {}, cont
201
242
  } catch {
202
243
  continue;
203
244
  }
204
- const hazards = inspectSettingsContentHazards(raw, relFile);
245
+ const hazards = inspectSettingsContentHazards(raw, relFile, { wsRoot, scanWorkspace: true });
205
246
  if (hazards.length > 0) {
206
247
  return {
207
248
  id: 'DET-18',
@@ -610,8 +651,9 @@ export function tokenizeShellCommandSegments(cmdStr = '') {
610
651
  return segments;
611
652
  }
612
653
 
613
- export function isDestructiveOrBypassShellCommand(cmdStr = '', depth = 0) {
654
+ export function isDestructiveOrBypassShellCommand(cmdStr = '', depth = 0, options = {}) {
614
655
  if (!cmdStr || depth > 2) return false;
656
+ const userExplicitTestIntent = Boolean(options?.userExplicitTestIntent);
615
657
  const segments = tokenizeShellCommandSegments(cmdStr);
616
658
 
617
659
  for (const rawTokens of segments) {
@@ -696,16 +738,49 @@ export function isDestructiveOrBypassShellCommand(cmdStr = '', depth = 0) {
696
738
  if (subTokens.some(t => !t.quoted && (t.value === '--force' || /^-[a-zA-Z]*f[a-zA-Z]*$/.test(t.value)))) {
697
739
  return true;
698
740
  }
741
+ } else if (sub === 'checkout') {
742
+ const isBranchCreate = subTokens.some(t => !t.quoted && (t.value === '-b' || t.value === '-B' || t.value === '--orphan'));
743
+ if (!isBranchCreate) {
744
+ const isDiscard = subTokens.some(
745
+ t => !t.quoted && (t.value === '--' || t.value === '.' || t.value === '-f' || t.value === '--force')
746
+ );
747
+ if (isDiscard) return true;
748
+ }
749
+ } else if (sub === 'restore') {
750
+ const stagedOnly =
751
+ subTokens.some(t => !t.quoted && (t.value === '--staged' || t.value === '-S')) &&
752
+ !subTokens.some(t => !t.quoted && (t.value === '--worktree' || t.value === '-W'));
753
+ if (!stagedOnly && subTokens.some(t => t.value !== '--help' && t.value !== '-h')) {
754
+ return true;
755
+ }
756
+ } else if (sub === 'fsck' || sub === 'cat-file' || sub === 'reflog') {
757
+ return true;
758
+ } else if (
759
+ sub === 'log' &&
760
+ subTokens.some(t => !t.quoted && t.value === '--all') &&
761
+ subTokens.some(t => !t.quoted && (t.value === '-p' || t.value === '--patch'))
762
+ ) {
763
+ return true;
699
764
  }
700
765
  }
701
766
  continue;
702
767
  }
703
768
 
704
- if (exeBase === 'rm') {
769
+ if (exeBase === 'rm' || exeBase === 'unlink') {
705
770
  let hasRec = false;
706
771
  let hasForce = false;
707
772
  for (const t of argTokens) {
708
773
  if (/\.gemini[\\/]antigravity[\\/]brain/i.test(t.value)) return true;
774
+ if (
775
+ !userExplicitTestIntent &&
776
+ !t.value.startsWith('-') &&
777
+ isTestFilePath(t.value) &&
778
+ !/^(?:\/tmp\/|\/var\/folders\/)/i.test(t.value) &&
779
+ !/(?:^|[\\/])(?:tmp|temp|\.claude[\\/]cache|\.agents[\\/]tmp)[\\/]/i.test(t.value) &&
780
+ !/appdata[\\/]local[\\/]temp[\\/]/i.test(t.value)
781
+ ) {
782
+ return true;
783
+ }
709
784
  if (!t.quoted && t.value.startsWith('-')) {
710
785
  if (t.value === '--recursive') hasRec = true;
711
786
  else if (t.value === '--force') hasForce = true;
@@ -719,11 +794,21 @@ export function isDestructiveOrBypassShellCommand(cmdStr = '', depth = 0) {
719
794
  continue;
720
795
  }
721
796
 
722
- if (['del', 'erase', 'remove-item', 'ri', 'rd', 'rmdir', 'unlink'].includes(exeBase)) {
797
+ if (['del', 'erase', 'remove-item', 'ri', 'rd', 'rmdir'].includes(exeBase)) {
723
798
  let hasRec = false;
724
799
  let hasForce = false;
725
800
  for (const t of argTokens) {
726
801
  if (/\.gemini[\\/]antigravity[\\/]brain/i.test(t.value)) return true;
802
+ if (
803
+ !userExplicitTestIntent &&
804
+ !t.value.startsWith('-') &&
805
+ !t.value.startsWith('/') &&
806
+ isTestFilePath(t.value) &&
807
+ !/(?:^|[\\/])(?:tmp|temp|\.claude[\\/]cache|\.agents[\\/]tmp)[\\/]/i.test(t.value) &&
808
+ !/appdata[\\/]local[\\/]temp[\\/]/i.test(t.value)
809
+ ) {
810
+ return true;
811
+ }
727
812
  if (!t.quoted) {
728
813
  if (/^-recurse$/i.test(t.value)) hasRec = true;
729
814
  if (/^-force$/i.test(t.value)) hasForce = true;
@@ -739,8 +824,13 @@ export function isDestructiveOrBypassShellCommand(cmdStr = '', depth = 0) {
739
824
  }
740
825
 
741
826
  export function evaluateDet08DestructiveShell(stepsOrCmd = [], _context = {}) {
827
+ const shellOpts = {
828
+ userExplicitTestIntent: Boolean(
829
+ _context?.userExplicitTestIntent || _context?.userAuthorizedTestDeletion
830
+ )
831
+ };
742
832
  if (typeof stepsOrCmd === 'string') {
743
- const blocked = isDestructiveOrBypassShellCommand(stepsOrCmd);
833
+ const blocked = isDestructiveOrBypassShellCommand(stepsOrCmd, 0, shellOpts);
744
834
  return {
745
835
  id: 'DET-08',
746
836
  detectorId: 'DET-08',
@@ -767,7 +857,7 @@ export function evaluateDet08DestructiveShell(stepsOrCmd = [], _context = {}) {
767
857
  const args = call.args || call.arguments || call.input || {};
768
858
  const cmdStr = String(args.CommandLine || args.command || args.cmd || call.command || step.command || '').trim();
769
859
  const targetPath = String(args.Path || args.path || args.TargetFile || args.AbsolutePath || call.targetPath || '').trim();
770
- if (cmdStr && isDestructiveOrBypassShellCommand(cmdStr)) {
860
+ if (cmdStr && isDestructiveOrBypassShellCommand(cmdStr, 0, shellOpts)) {
771
861
  return {
772
862
  id: 'DET-08',
773
863
  detectorId: 'DET-08',
@@ -0,0 +1,338 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * @file src/core/doc_indexer.mjs
4
+ * Zero-Token Structural Document & Log Indexer (`< 20ms`, zero LLM calls).
5
+ *
6
+ * Exposes programmatic helpers (`resolveIndexPath`, `checkIndex`, `buildIndex`, `sliceFile`)
7
+ * and CLI flags:
8
+ * - `--check <file> [--cwd <dir>]` -> exits `0` (`FRESH`), `1` (`STALE`), or `2` (`MISSING`)
9
+ * - `--build <file> [--cwd <dir>]` -> writes cached `.index.md` under `.agents/cache/indices/`
10
+ * - `--slice <file> <start_line> <end_line>` -> prints 1-indexed line-numbered output
11
+ */
12
+
13
+ import fs from 'node:fs';
14
+ import path from 'node:path';
15
+ import crypto from 'node:crypto';
16
+ import { fileURLToPath } from 'node:url';
17
+ import { atomicWriteFileSync } from './atomic_io.mjs';
18
+ import {
19
+ isForbiddenSkuPath,
20
+ compareIndexFreshness,
21
+ buildStructuralIndexMarkdown,
22
+ formatSlicedLines
23
+ } from '../core-isomorphic/guards/docIndexCore.mjs';
24
+
25
+ export { isForbiddenSkuPath, compareIndexFreshness, buildStructuralIndexMarkdown, formatSlicedLines };
26
+
27
+ /**
28
+ * Computes canonical LF-normalized SHA-256 hex digest of text content.
29
+ *
30
+ * @param {string} rawText
31
+ * @returns {string}
32
+ */
33
+ export function computeFileContentSha256(rawText = '') {
34
+ const normalized = String(rawText ?? '').replace(/\r\n/g, '\n');
35
+ return crypto.createHash('sha256').update(normalized, 'utf8').digest('hex');
36
+ }
37
+
38
+ /**
39
+ * Resolves the gitignored `.agents/cache/indices/<slug>_<hash>.index.md` target path
40
+ * so indexing never dirties `git status` alongside workspace source files.
41
+ * Callers may pass `options.indexPath` when indexing an already-gitignored temp/cache file.
42
+ *
43
+ * @param {string} filePath
44
+ * @param {object} [options={}]
45
+ * @param {string} [options.cwd]
46
+ * @param {string} [options.indexPath]
47
+ * @returns {string}
48
+ */
49
+ export function resolveIndexPath(filePath, options = {}) {
50
+ if (typeof options.indexPath === 'string' && options.indexPath.trim()) {
51
+ return path.resolve(options.indexPath.trim());
52
+ }
53
+ const baseCwd = path.resolve(options.cwd || process.cwd());
54
+ const absFile = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(baseCwd, filePath);
55
+ const relRaw = path.relative(baseCwd, absFile).replace(/\\/g, '/');
56
+ const isInsideWorkspace = !relRaw.startsWith('..') && !path.isAbsolute(relRaw);
57
+
58
+ // If the file itself already lives inside a gitignored cache/tmp folder, allow adjacent `.index.md`
59
+ if (
60
+ isInsideWorkspace &&
61
+ /^(?:\.agents\/(?:tmp|cache|telemetry)|\.claude\/cache)\//i.test(relRaw)
62
+ ) {
63
+ return `${absFile}.index.md`;
64
+ }
65
+
66
+ const keyBasis = isInsideWorkspace ? relRaw : absFile.replace(/\\/g, '/');
67
+ const pathHash = crypto.createHash('sha256').update(keyBasis, 'utf8').digest('hex').slice(0, 12);
68
+ const safeSlug = (isInsideWorkspace ? relRaw : path.basename(absFile))
69
+ .replace(/[^A-Za-z0-9._-]+/g, '_')
70
+ .replace(/^_+|_+$/g, '')
71
+ .slice(-72);
72
+ return path.join(baseCwd, '.agents', 'cache', 'indices', `${safeSlug}_${pathHash}.index.md`);
73
+ }
74
+
75
+ function isBlockedTargetPath(absFile, baseCwd) {
76
+ const rel = path.relative(baseCwd, absFile).replace(/\\/g, '/');
77
+ return isForbiddenSkuPath(absFile) || isForbiddenSkuPath(rel);
78
+ }
79
+
80
+ /**
81
+ * Checks whether `<file>`'s structural index is `FRESH` (`0`), `STALE` (`1`), or `MISSING` (`2`).
82
+ *
83
+ * @param {string} filePath
84
+ * @param {object} [options={}]
85
+ * @returns {{ code: 0 | 1 | 2, status: 'FRESH' | 'STALE' | 'MISSING' | 'SKIPPED', indexPath: string, sha256: string | null }}
86
+ */
87
+ export function checkIndex(filePath, options = {}) {
88
+ const baseCwd = path.resolve(options.cwd || process.cwd());
89
+ const absFile = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(baseCwd, filePath);
90
+ const indexPath = resolveIndexPath(absFile, options);
91
+
92
+ if (isBlockedTargetPath(absFile, baseCwd)) {
93
+ return { code: 2, status: 'SKIPPED', indexPath, sha256: null };
94
+ }
95
+ if (!fs.existsSync(absFile) || !fs.statSync(absFile).isFile()) {
96
+ return { code: 2, status: 'MISSING', indexPath, sha256: null };
97
+ }
98
+
99
+ const rawText = fs.readFileSync(absFile, 'utf8');
100
+ const liveSha = computeFileContentSha256(rawText);
101
+ if (!fs.existsSync(indexPath)) {
102
+ return { code: 2, status: 'MISSING', indexPath, sha256: liveSha };
103
+ }
104
+ const indexMd = fs.readFileSync(indexPath, 'utf8');
105
+ const cmp = compareIndexFreshness(liveSha, indexMd);
106
+ return {
107
+ code: cmp.code,
108
+ status: cmp.status,
109
+ indexPath,
110
+ sha256: liveSha
111
+ };
112
+ }
113
+
114
+ /**
115
+ * Builds or refreshes the zero-token `.index.md` structural map for `<file>`.
116
+ *
117
+ * @param {string} filePath
118
+ * @param {object} [options={}]
119
+ * @returns {{
120
+ * ok: boolean,
121
+ * skipped: boolean,
122
+ * reason?: string,
123
+ * refreshed?: boolean,
124
+ * indexPath: string,
125
+ * relIndexPath: string,
126
+ * sha256: string | null,
127
+ * totalLines: number,
128
+ * spanCount: number,
129
+ * usedFallback: boolean,
130
+ * indexTokens: number,
131
+ * markdown: string
132
+ * }}
133
+ */
134
+ export function buildIndex(filePath, options = {}) {
135
+ const baseCwd = path.resolve(options.cwd || process.cwd());
136
+ const absFile = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(baseCwd, filePath);
137
+ const indexPath = resolveIndexPath(absFile, options);
138
+ const relIndexPath = path.relative(baseCwd, indexPath).replace(/\\/g, '/');
139
+
140
+ if (isBlockedTargetPath(absFile, baseCwd)) {
141
+ return {
142
+ ok: false,
143
+ skipped: true,
144
+ reason: 'SKU boundary: isolated directory excluded from ctxtop indexing',
145
+ indexPath,
146
+ relIndexPath,
147
+ sha256: null,
148
+ totalLines: 0,
149
+ spanCount: 0,
150
+ usedFallback: false,
151
+ indexTokens: 0,
152
+ markdown: ''
153
+ };
154
+ }
155
+
156
+ if (!fs.existsSync(absFile) || !fs.statSync(absFile).isFile()) {
157
+ return {
158
+ ok: false,
159
+ skipped: true,
160
+ reason: `Target file not found: ${absFile}`,
161
+ indexPath,
162
+ relIndexPath,
163
+ sha256: null,
164
+ totalLines: 0,
165
+ spanCount: 0,
166
+ usedFallback: false,
167
+ indexTokens: 0,
168
+ markdown: ''
169
+ };
170
+ }
171
+
172
+ const rawText = fs.readFileSync(absFile, 'utf8');
173
+ const liveSha = computeFileContentSha256(rawText);
174
+
175
+ if (!options.force && fs.existsSync(indexPath)) {
176
+ try {
177
+ const existingMd = fs.readFileSync(indexPath, 'utf8');
178
+ const cmp = compareIndexFreshness(liveSha, existingMd);
179
+ if (cmp.code === 0) {
180
+ const lineCount = rawText.length === 0 ? 0 : rawText.replace(/\r\n/g, '\n').split('\n').length;
181
+ return {
182
+ ok: true,
183
+ skipped: false,
184
+ refreshed: false,
185
+ indexPath,
186
+ relIndexPath,
187
+ sha256: liveSha,
188
+ totalLines: lineCount,
189
+ spanCount: Math.max(0, existingMd.split('\n').filter((l) => l.startsWith('| L')).length),
190
+ usedFallback: existingMd.includes('| Unstructured Span L'),
191
+ indexTokens: Math.max(1, Math.ceil(existingMd.length / 4)),
192
+ markdown: existingMd
193
+ };
194
+ }
195
+ } catch {
196
+ // Rebuild below
197
+ }
198
+ }
199
+
200
+ const relDisplay = path.relative(baseCwd, absFile).replace(/\\/g, '/');
201
+ const displayPath = !relDisplay.startsWith('..') && !path.isAbsolute(relDisplay)
202
+ ? relDisplay
203
+ : path.basename(absFile);
204
+
205
+ const built = buildStructuralIndexMarkdown({
206
+ filePath: absFile,
207
+ displayPath,
208
+ rawText,
209
+ sha256: liveSha
210
+ });
211
+
212
+ fs.mkdirSync(path.dirname(indexPath), { recursive: true });
213
+ atomicWriteFileSync(indexPath, built.markdown);
214
+
215
+ return {
216
+ ok: true,
217
+ skipped: false,
218
+ refreshed: true,
219
+ indexPath,
220
+ relIndexPath,
221
+ sha256: built.sha256,
222
+ totalLines: built.totalLines,
223
+ spanCount: built.spanCount,
224
+ usedFallback: built.usedFallback,
225
+ indexTokens: built.indexTokens,
226
+ markdown: built.markdown
227
+ };
228
+ }
229
+
230
+ /**
231
+ * Slices `<file>` between 1-indexed `startLine` and `endLine` inclusive across CRLF/LF.
232
+ *
233
+ * @param {string} filePath
234
+ * @param {number} startLine
235
+ * @param {number} endLine
236
+ * @param {object} [options={}]
237
+ * @returns {{ ok: boolean, skipped?: boolean, reason?: string, text: string, startLine: number, endLine: number, totalLines: number }}
238
+ */
239
+ export function sliceFile(filePath, startLine, endLine, options = {}) {
240
+ const baseCwd = path.resolve(options.cwd || process.cwd());
241
+ const absFile = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(baseCwd, filePath);
242
+ if (isBlockedTargetPath(absFile, baseCwd)) {
243
+ return {
244
+ ok: false,
245
+ skipped: true,
246
+ reason: 'SKU boundary: isolated directory excluded from ctxtop slicing',
247
+ text: '',
248
+ startLine: 0,
249
+ endLine: 0,
250
+ totalLines: 0
251
+ };
252
+ }
253
+ if (!fs.existsSync(absFile) || !fs.statSync(absFile).isFile()) {
254
+ return {
255
+ ok: false,
256
+ reason: `File not found: ${absFile}`,
257
+ text: '',
258
+ startLine: 0,
259
+ endLine: 0,
260
+ totalLines: 0
261
+ };
262
+ }
263
+ const rawText = fs.readFileSync(absFile, 'utf8');
264
+ const sliced = formatSlicedLines(rawText, startLine, endLine);
265
+ return {
266
+ ok: true,
267
+ ...sliced
268
+ };
269
+ }
270
+
271
+ /**
272
+ * CLI runner for `node src/core/doc_indexer.mjs <--check|--build|--slice> ...`.
273
+ *
274
+ * @param {string[]} [args=[]]
275
+ * @returns {{ exitCode: number, output: string }}
276
+ */
277
+ export function runDocIndexerCli(args = process.argv.slice(2)) {
278
+ const cwdIdx = args.indexOf('--cwd');
279
+ const cwd = cwdIdx !== -1 && args[cwdIdx + 1] ? path.resolve(args[cwdIdx + 1]) : process.cwd();
280
+ const outIdx = args.indexOf('--index-path');
281
+ const indexPath = outIdx !== -1 && args[outIdx + 1] ? path.resolve(args[outIdx + 1]) : undefined;
282
+ const opts = { cwd, ...(indexPath ? { indexPath } : {}) };
283
+
284
+ const checkIdx = args.indexOf('--check');
285
+ if (checkIdx !== -1 && args[checkIdx + 1]) {
286
+ const res = checkIndex(args[checkIdx + 1], opts);
287
+ return {
288
+ exitCode: res.code,
289
+ output: `${res.status} (${res.indexPath})`
290
+ };
291
+ }
292
+
293
+ const buildIdx = args.indexOf('--build');
294
+ if (buildIdx !== -1 && args[buildIdx + 1]) {
295
+ const res = buildIndex(args[buildIdx + 1], opts);
296
+ if (!res.ok) {
297
+ return {
298
+ exitCode: res.skipped ? 0 : 1,
299
+ output: res.reason || 'Skipped'
300
+ };
301
+ }
302
+ return {
303
+ exitCode: 0,
304
+ output: `${res.indexPath} (${res.totalLines} lines, ${res.spanCount} spans)`
305
+ };
306
+ }
307
+
308
+ const sliceIdx = args.indexOf('--slice');
309
+ if (sliceIdx !== -1 && args[sliceIdx + 1]) {
310
+ const target = args[sliceIdx + 1];
311
+ const start = Number(args[sliceIdx + 2] || 1);
312
+ const end = Number(args[sliceIdx + 3] || start + 149);
313
+ const res = sliceFile(target, start, end, opts);
314
+ if (!res.ok) {
315
+ return { exitCode: 1, output: res.reason || 'Slice failed' };
316
+ }
317
+ return { exitCode: 0, output: res.text };
318
+ }
319
+
320
+ return {
321
+ exitCode: 1,
322
+ output: 'Usage: doc_indexer.mjs <--check <file> | --build <file> | --slice <file> <start_line> <end_line>> [--cwd <dir>]'
323
+ };
324
+ }
325
+
326
+ const isMain = (() => {
327
+ try {
328
+ return process.argv[1] && fs.realpathSync(process.argv[1]) === fs.realpathSync(fileURLToPath(import.meta.url));
329
+ } catch {
330
+ return false;
331
+ }
332
+ })();
333
+
334
+ if (isMain) {
335
+ const res = runDocIndexerCli();
336
+ if (res.output) process.stdout.write(`${res.output}\n`);
337
+ process.exit(res.exitCode);
338
+ }