pi-lens 4.3.0 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (650) hide show
  1. package/CHANGELOG.md +1064 -0
  2. package/README.md +115 -25
  3. package/config/dependency-cruiser-eager-allowlist.json +6 -2
  4. package/dist/chunk-22AVIGXS.js +560 -0
  5. package/dist/chunk-27BBHSZC.js +106 -0
  6. package/dist/chunk-2BEMIWEW.js +51 -0
  7. package/dist/chunk-2EECBNC5.js +89 -0
  8. package/dist/chunk-34U7PLGE.js +23 -0
  9. package/dist/chunk-3I5QFT3N.js +181 -0
  10. package/dist/chunk-3MED75HT.js +37 -0
  11. package/dist/chunk-47D2BO4S.js +87 -0
  12. package/dist/chunk-4RERDEXR.js +348 -0
  13. package/dist/chunk-4W2PLC4J.js +27 -0
  14. package/dist/chunk-52H5B5TC.js +202 -0
  15. package/dist/chunk-54B42YRX.js +27 -0
  16. package/dist/chunk-5RXBNSW2.js +266 -0
  17. package/dist/chunk-5THXD6X5.js +201 -0
  18. package/dist/chunk-5W3R6LFT.js +24 -0
  19. package/dist/chunk-5ZEJHV35.js +341 -0
  20. package/dist/chunk-6P62QVEA.js +118 -0
  21. package/dist/chunk-6QIUX4EP.js +459 -0
  22. package/dist/chunk-6VCD4VKZ.js +78 -0
  23. package/dist/chunk-7F72PXY2.js +326 -0
  24. package/dist/chunk-7FBF7NPR.js +998 -0
  25. package/dist/chunk-7U2IDNXN.js +37 -0
  26. package/dist/chunk-ABBOA7UD.js +157 -0
  27. package/dist/chunk-AHDW3GPE.js +50 -0
  28. package/dist/chunk-AJ3QXTRQ.js +756 -0
  29. package/dist/chunk-AJVLWNFN.js +1610 -0
  30. package/dist/chunk-AJXODZY6.js +112 -0
  31. package/dist/chunk-ARFCXG7S.js +84 -0
  32. package/dist/chunk-AS44CFQ4.js +708 -0
  33. package/dist/chunk-AWE5TMPO.js +38 -0
  34. package/dist/chunk-B3I2UUT4.js +4692 -0
  35. package/dist/chunk-BRJKOBZP.js +331 -0
  36. package/dist/chunk-BW5KFIQC.js +59 -0
  37. package/dist/chunk-C2AUYXQH.js +149 -0
  38. package/dist/chunk-CGGAIP7J.js +29 -0
  39. package/dist/chunk-D6QS3U6M.js +30 -0
  40. package/dist/chunk-DFVMIKMQ.js +349 -0
  41. package/dist/chunk-DIULIWKU.js +169 -0
  42. package/dist/chunk-DQ2NZ7C4.js +2317 -0
  43. package/dist/chunk-E2WFBRHM.js +213 -0
  44. package/dist/chunk-E4MAEDPM.js +50 -0
  45. package/dist/chunk-EOKRQ3SA.js +30 -0
  46. package/dist/chunk-F3AU2TMM.js +2626 -0
  47. package/dist/chunk-F3P7VQ7H.js +170 -0
  48. package/dist/chunk-FC4RP4I2.js +12 -0
  49. package/dist/chunk-FJNKANOS.js +32 -0
  50. package/dist/chunk-GUOGVTCQ.js +146 -0
  51. package/dist/chunk-GVXA6CCE.js +18 -0
  52. package/dist/chunk-HHYAELLJ.js +2334 -0
  53. package/dist/chunk-HMFXILPV.js +83 -0
  54. package/dist/chunk-HVUZXSWK.js +421 -0
  55. package/dist/chunk-HWBZIGMJ.js +62 -0
  56. package/dist/chunk-I3R7GKDR.js +17 -0
  57. package/dist/chunk-I7SPGOWI.js +55 -0
  58. package/dist/chunk-IIXOAGHR.js +38 -0
  59. package/dist/chunk-IVP5KAB7.js +2250 -0
  60. package/dist/chunk-IXEBJSUE.js +22 -0
  61. package/dist/chunk-JOLITGCC.js +27 -0
  62. package/dist/chunk-K6VYLB2U.js +145 -0
  63. package/dist/chunk-LJDODBBZ.js +78 -0
  64. package/dist/chunk-LNAKEO63.js +78 -0
  65. package/dist/chunk-LSMJ6KBE.js +4139 -0
  66. package/dist/chunk-LW6XKDZQ.js +5565 -0
  67. package/dist/chunk-N3YQJI6O.js +899 -0
  68. package/dist/chunk-NABLC7W3.js +148 -0
  69. package/dist/chunk-NKOUFPQF.js +659 -0
  70. package/dist/chunk-NL5GLMFI.js +211 -0
  71. package/dist/chunk-NMABWBZN.js +327 -0
  72. package/dist/chunk-NTHH2J74.js +27 -0
  73. package/dist/chunk-NTUJEGDZ.js +59 -0
  74. package/dist/chunk-NXL4FFQQ.js +47 -0
  75. package/dist/chunk-NXPS2L6U.js +466 -0
  76. package/dist/chunk-O5WILGMI.js +42 -0
  77. package/dist/chunk-O6TQT6RI.js +48 -0
  78. package/dist/chunk-OAXNDZJ7.js +323 -0
  79. package/dist/chunk-ODEEOXPH.js +44 -0
  80. package/dist/chunk-OQGFCZJ4.js +4533 -0
  81. package/dist/chunk-ORTMY4Q4.js +282 -0
  82. package/dist/chunk-OS32RNR2.js +442 -0
  83. package/dist/chunk-PAK6IDME.js +189 -0
  84. package/dist/chunk-PWFHBTSF.js +406 -0
  85. package/dist/chunk-Q5U6FMDI.js +2352 -0
  86. package/dist/chunk-QOZXJ4NA.js +3364 -0
  87. package/dist/chunk-QYF5S6P6.js +45 -0
  88. package/dist/chunk-RIISMHKN.js +36 -0
  89. package/dist/chunk-RPD4ZSB7.js +25 -0
  90. package/dist/chunk-RPD5K5NC.js +79 -0
  91. package/dist/chunk-RUOG5D2C.js +262 -0
  92. package/dist/chunk-T4ERT73Y.js +599 -0
  93. package/dist/chunk-T6D4Q4AQ.js +54 -0
  94. package/dist/chunk-TGPXLY2J.js +391 -0
  95. package/dist/chunk-TLGFBM3F.js +12116 -0
  96. package/dist/chunk-TO6WL3GM.js +88 -0
  97. package/dist/chunk-TT22N74J.js +517 -0
  98. package/dist/chunk-TVN5N6GY.js +21216 -0
  99. package/dist/chunk-U3VGR4VU.js +308 -0
  100. package/dist/chunk-UK3CMEAL.js +1250 -0
  101. package/dist/chunk-UOPVJQ4N.js +103 -0
  102. package/dist/chunk-UXVNL3D7.js +23 -0
  103. package/dist/chunk-UY752QSN.js +45 -0
  104. package/dist/chunk-V5PXFSZK.js +188 -0
  105. package/dist/chunk-V7R425XG.js +398 -0
  106. package/dist/chunk-VCSRSYLF.js +81 -0
  107. package/dist/chunk-VD4JQCQC.js +162 -0
  108. package/dist/chunk-VDBPVIKD.js +62 -0
  109. package/dist/chunk-VHQLPIRJ.js +114 -0
  110. package/dist/chunk-VN2AXLEX.js +5414 -0
  111. package/dist/chunk-VNMT7C64.js +478 -0
  112. package/dist/chunk-WONERJTP.js +309 -0
  113. package/dist/chunk-XECLWQZN.js +85 -0
  114. package/dist/chunk-XIMYZ3JA.js +27 -0
  115. package/dist/chunk-XK4CIILI.js +144 -0
  116. package/dist/chunk-Y4T27COV.js +562 -0
  117. package/dist/chunk-YGVYKNSN.js +1860 -0
  118. package/dist/chunk-YLF3PPT5.js +308 -0
  119. package/dist/chunk-YSNFMJKN.js +14 -0
  120. package/dist/chunk-Z3CCVDUB.js +76 -0
  121. package/dist/chunk-Z54ZSOBZ.js +61 -0
  122. package/dist/chunk-ZAWW3AF6.js +97 -0
  123. package/dist/chunk-ZMOL6RQC.js +167 -0
  124. package/dist/index.js +16456 -8335
  125. package/dist/mcp/analyze-cli.js +186 -232
  126. package/dist/mcp/cli.js +137 -98
  127. package/dist/mcp/server.js +22589 -1573
  128. package/dist/mcp/worker.js +97 -38
  129. package/dist/probes/installer.js +135 -0
  130. package/dist/workers/project-snapshot-persist-worker.js +22 -0
  131. package/dist/workers/review-graph-persist-worker.js +15 -0
  132. package/docs/agent-guide.md +13 -4
  133. package/docs/agent-tools.md +42 -0
  134. package/docs/ast-grep_rules_catalog.md +3 -2
  135. package/docs/configuration.md +20 -1
  136. package/docs/environment-variables.md +52 -2
  137. package/docs/features.md +8 -4
  138. package/docs/globalconfig.md +1 -0
  139. package/docs/io-bridge-v2-migration.md +94 -0
  140. package/docs/lsp-capability-matrix.md +36 -4
  141. package/docs/lsp-idle-eviction.md +124 -0
  142. package/docs/mcp.md +21 -5
  143. package/docs/merge-queue-rollout.md +77 -0
  144. package/docs/pi-lens-fixer.md +156 -88
  145. package/docs/pi-lens-investigator.md +74 -26
  146. package/docs/pi-lens-merge-policy.md +694 -0
  147. package/docs/pi-lens-monitor.md +73 -7
  148. package/docs/pi-lens-retro.md +6 -4
  149. package/docs/pi-lens-reviewer.md +188 -48
  150. package/docs/pi-lens-subagent.md +246 -45
  151. package/docs/pi-lens-warden.md +18 -7
  152. package/docs/public-api-stability.md +55 -0
  153. package/docs/release-qa-baseline.md +84 -17
  154. package/docs/rfcs/3654-unified-io-bridge-v2.md +316 -0
  155. package/docs/servercapabilities.md +53 -49
  156. package/docs/settings.md +1 -0
  157. package/docs/usage.md +5 -1
  158. package/grammars/tree-sitter-bash.wasm +0 -0
  159. package/grammars/tree-sitter-bash.wasm.json +3 -3
  160. package/package.json +19 -7
  161. package/rules/ast-grep-rules/rule-tests/advisory-registry-subset-test.yml +41 -0
  162. package/rules/ast-grep-rules/rules/advisory-registry-subset.yml +50 -0
  163. package/scripts/analyze-pi-lens-logs.mjs +1275 -62
  164. package/scripts/download-grammars.js +5 -0
  165. package/scripts/grammars.lock.json +6 -1
  166. package/scripts/install-selftest.mjs +33 -34
  167. package/scripts/lib/host-provided-deps.mjs +13 -4
  168. package/scripts/lib/web-tree-sitter-dir.mjs +18 -0
  169. package/dist/clients/actionable-warnings-logger.js +0 -35
  170. package/dist/clients/actionable-warnings.js +0 -1610
  171. package/dist/clients/advisory-provenance.js +0 -593
  172. package/dist/clients/agent-behavior-client.js +0 -147
  173. package/dist/clients/agent-nudge.js +0 -325
  174. package/dist/clients/analysed-root.js +0 -1
  175. package/dist/clients/ast-grep-client.js +0 -731
  176. package/dist/clients/ast-grep-rule-manager.js +0 -146
  177. package/dist/clients/ast-grep-tool-logger.js +0 -118
  178. package/dist/clients/ast-grep-types.js +0 -10
  179. package/dist/clients/ast-grep-yaml-synth.js +0 -154
  180. package/dist/clients/atomic-write-staging.js +0 -75
  181. package/dist/clients/atomic-write.js +0 -189
  182. package/dist/clients/availability-probe-flight.js +0 -12
  183. package/dist/clients/bash-file-access.js +0 -1056
  184. package/dist/clients/biome-client.js +0 -357
  185. package/dist/clients/blocker-freshness.js +0 -837
  186. package/dist/clients/blocker-past-eof.js +0 -129
  187. package/dist/clients/bootstrap.js +0 -569
  188. package/dist/clients/bounded-cache.js +0 -190
  189. package/dist/clients/bounded-pid-file-lock.js +0 -202
  190. package/dist/clients/bounded-telemetry.js +0 -295
  191. package/dist/clients/build-identity.js +0 -95
  192. package/dist/clients/bundled-resource-health.js +0 -113
  193. package/dist/clients/bus-events-logger.js +0 -105
  194. package/dist/clients/bus-publish.js +0 -171
  195. package/dist/clients/cache/rule-cache.js +0 -190
  196. package/dist/clients/cache-manager.js +0 -524
  197. package/dist/clients/cache-observability.js +0 -1313
  198. package/dist/clients/call-graph.js +0 -852
  199. package/dist/clients/cargo-manifest.js +0 -422
  200. package/dist/clients/cascade-budget.js +0 -196
  201. package/dist/clients/cascade-format.js +0 -315
  202. package/dist/clients/cascade-logger.js +0 -31
  203. package/dist/clients/cascade-types.js +0 -9
  204. package/dist/clients/child-unref.js +0 -124
  205. package/dist/clients/code-quality-warnings.js +0 -286
  206. package/dist/clients/codebase-model.js +0 -173
  207. package/dist/clients/collateral-test-role.js +0 -40
  208. package/dist/clients/complexity-client.js +0 -462
  209. package/dist/clients/config-core/deny.js +0 -221
  210. package/dist/clients/config-core/index.js +0 -50
  211. package/dist/clients/config-core/merge.js +0 -357
  212. package/dist/clients/config-core/normalize.js +0 -340
  213. package/dist/clients/config-core/process-spec.js +0 -248
  214. package/dist/clients/config-core/provenance.js +0 -164
  215. package/dist/clients/config-core/records.js +0 -218
  216. package/dist/clients/config-core/resolve.js +0 -125
  217. package/dist/clients/config-core/safe-object.js +0 -78
  218. package/dist/clients/config-core/schema.js +0 -165
  219. package/dist/clients/config-diagnostic-codes.js +0 -285
  220. package/dist/clients/config-locations.js +0 -388
  221. package/dist/clients/config-resolve.js +0 -798
  222. package/dist/clients/config-schema.js +0 -251
  223. package/dist/clients/config-warn.js +0 -407
  224. package/dist/clients/console-guard-install.js +0 -26
  225. package/dist/clients/cooperative-budget.js +0 -42
  226. package/dist/clients/dead-code-client.js +0 -510
  227. package/dist/clients/dead-code-logger.js +0 -30
  228. package/dist/clients/deadline-utils.js +0 -280
  229. package/dist/clients/debug-handles.js +0 -211
  230. package/dist/clients/debug-heap.js +0 -174
  231. package/dist/clients/deferred-lsp-work.js +0 -106
  232. package/dist/clients/degradation-ledger.js +0 -426
  233. package/dist/clients/demoted-finding-render.js +0 -169
  234. package/dist/clients/dependency-checker.js +0 -885
  235. package/dist/clients/deps/ast-grep-napi.js +0 -22
  236. package/dist/clients/deps/js-yaml.js +0 -9
  237. package/dist/clients/deps/minimatch.js +0 -4
  238. package/dist/clients/deps/pi-tui.js +0 -14
  239. package/dist/clients/deps/typebox.js +0 -14
  240. package/dist/clients/deps/vscode-jsonrpc.js +0 -1
  241. package/dist/clients/deps/web-tree-sitter.js +0 -24
  242. package/dist/clients/diagnostic-dispositions.js +0 -630
  243. package/dist/clients/diagnostic-line-freshness.js +0 -305
  244. package/dist/clients/diagnostic-logger.js +0 -73
  245. package/dist/clients/diagnostic-tracker.js +0 -105
  246. package/dist/clients/diagnostics-publish.js +0 -230
  247. package/dist/clients/dispatch/ast-grep-catalog.js +0 -65
  248. package/dist/clients/dispatch/auxiliary-lsp.js +0 -343
  249. package/dist/clients/dispatch/collect-later-tier.js +0 -35
  250. package/dist/clients/dispatch/diagnostic-taxonomy.js +0 -66
  251. package/dist/clients/dispatch/dispatcher.js +0 -1269
  252. package/dist/clients/dispatch/fact-provider-types.js +0 -1
  253. package/dist/clients/dispatch/fact-rule-runner.js +0 -17
  254. package/dist/clients/dispatch/fact-runner.js +0 -30
  255. package/dist/clients/dispatch/fact-scheduler.js +0 -68
  256. package/dist/clients/dispatch/fact-store.js +0 -377
  257. package/dist/clients/dispatch/facts/comment-facts.js +0 -22
  258. package/dist/clients/dispatch/facts/file-content.js +0 -19
  259. package/dist/clients/dispatch/facts/function-facts.js +0 -348
  260. package/dist/clients/dispatch/facts/import-facts.js +0 -204
  261. package/dist/clients/dispatch/facts/tree-sitter-facts.js +0 -34
  262. package/dist/clients/dispatch/facts/try-catch-facts.js +0 -119
  263. package/dist/clients/dispatch/finding-policy.js +0 -339
  264. package/dist/clients/dispatch/indent-detect.js +0 -417
  265. package/dist/clients/dispatch/inline-suppressions.js +0 -89
  266. package/dist/clients/dispatch/integration.js +0 -2377
  267. package/dist/clients/dispatch/lazy.js +0 -11
  268. package/dist/clients/dispatch/pending-runner-findings.js +0 -87
  269. package/dist/clients/dispatch/plan.js +0 -278
  270. package/dist/clients/dispatch/priorities.js +0 -20
  271. package/dist/clients/dispatch/rule-id-normalize.js +0 -50
  272. package/dist/clients/dispatch/rule-ignores.js +0 -69
  273. package/dist/clients/dispatch/rule-policy.js +0 -135
  274. package/dist/clients/dispatch/rules/async-noise.js +0 -40
  275. package/dist/clients/dispatch/rules/async-unnecessary-wrapper.js +0 -27
  276. package/dist/clients/dispatch/rules/cors-wildcard.js +0 -54
  277. package/dist/clients/dispatch/rules/error-obscuring.js +0 -32
  278. package/dist/clients/dispatch/rules/error-swallowing.js +0 -31
  279. package/dist/clients/dispatch/rules/framework-call-noise.js +0 -67
  280. package/dist/clients/dispatch/rules/high-complexity.js +0 -72
  281. package/dist/clients/dispatch/rules/high-fan-out.js +0 -74
  282. package/dist/clients/dispatch/rules/high-import-coupling.js +0 -37
  283. package/dist/clients/dispatch/rules/missing-error-propagation.js +0 -62
  284. package/dist/clients/dispatch/rules/no-commented-credentials.js +0 -52
  285. package/dist/clients/dispatch/rules/pass-through-wrappers.js +0 -42
  286. package/dist/clients/dispatch/rules/placeholder-comments.js +0 -40
  287. package/dist/clients/dispatch/rules/unsafe-boundary.js +0 -126
  288. package/dist/clients/dispatch/runner-context.js +0 -52
  289. package/dist/clients/dispatch/runners/actionlint.js +0 -111
  290. package/dist/clients/dispatch/runners/ast-grep-napi.js +0 -1196
  291. package/dist/clients/dispatch/runners/biome-check.js +0 -296
  292. package/dist/clients/dispatch/runners/cpp-check.js +0 -219
  293. package/dist/clients/dispatch/runners/credo.js +0 -82
  294. package/dist/clients/dispatch/runners/cue-vet.js +0 -416
  295. package/dist/clients/dispatch/runners/dart-analyze.js +0 -183
  296. package/dist/clients/dispatch/runners/detekt.js +0 -176
  297. package/dist/clients/dispatch/runners/dotnet-build.js +0 -164
  298. package/dist/clients/dispatch/runners/elixir-check.js +0 -195
  299. package/dist/clients/dispatch/runners/eslint.js +0 -137
  300. package/dist/clients/dispatch/runners/fact-rules.js +0 -29
  301. package/dist/clients/dispatch/runners/fish-indent.js +0 -69
  302. package/dist/clients/dispatch/runners/gleam-check.js +0 -167
  303. package/dist/clients/dispatch/runners/go-vet.js +0 -104
  304. package/dist/clients/dispatch/runners/golangci-lint.js +0 -135
  305. package/dist/clients/dispatch/runners/hadolint.js +0 -91
  306. package/dist/clients/dispatch/runners/helm-lint.js +0 -171
  307. package/dist/clients/dispatch/runners/helm-render.js +0 -940
  308. package/dist/clients/dispatch/runners/htmlhint.js +0 -117
  309. package/dist/clients/dispatch/runners/index.js +0 -108
  310. package/dist/clients/dispatch/runners/javac.js +0 -99
  311. package/dist/clients/dispatch/runners/ktlint.js +0 -110
  312. package/dist/clients/dispatch/runners/lsp.js +0 -379
  313. package/dist/clients/dispatch/runners/markdownlint.js +0 -167
  314. package/dist/clients/dispatch/runners/mypy.js +0 -102
  315. package/dist/clients/dispatch/runners/oxlint.js +0 -414
  316. package/dist/clients/dispatch/runners/php-lint.js +0 -85
  317. package/dist/clients/dispatch/runners/phpstan.js +0 -120
  318. package/dist/clients/dispatch/runners/prisma-validate.js +0 -62
  319. package/dist/clients/dispatch/runners/psscriptanalyzer.js +0 -445
  320. package/dist/clients/dispatch/runners/pyright.js +0 -169
  321. package/dist/clients/dispatch/runners/rubocop.js +0 -99
  322. package/dist/clients/dispatch/runners/ruff.js +0 -88
  323. package/dist/clients/dispatch/runners/rust-clippy.js +0 -256
  324. package/dist/clients/dispatch/runners/shellcheck.js +0 -173
  325. package/dist/clients/dispatch/runners/shfmt.js +0 -102
  326. package/dist/clients/dispatch/runners/spellcheck.js +0 -128
  327. package/dist/clients/dispatch/runners/spotbugs.js +0 -259
  328. package/dist/clients/dispatch/runners/sqlfluff.js +0 -183
  329. package/dist/clients/dispatch/runners/stylelint.js +0 -166
  330. package/dist/clients/dispatch/runners/swiftlint.js +0 -163
  331. package/dist/clients/dispatch/runners/taplo.js +0 -174
  332. package/dist/clients/dispatch/runners/terragrunt.js +0 -168
  333. package/dist/clients/dispatch/runners/tflint.js +0 -125
  334. package/dist/clients/dispatch/runners/tree-sitter.js +0 -643
  335. package/dist/clients/dispatch/runners/trivy-config.js +0 -253
  336. package/dist/clients/dispatch/runners/utils/availability-policy.js +0 -496
  337. package/dist/clients/dispatch/runners/utils/candidate-probe.js +0 -90
  338. package/dist/clients/dispatch/runners/utils/diagnostic-parsers.js +0 -95
  339. package/dist/clients/dispatch/runners/utils/lazy-installer.js +0 -274
  340. package/dist/clients/dispatch/runners/utils/runner-helpers.js +0 -1701
  341. package/dist/clients/dispatch/runners/utils/spawn-outcome.js +0 -101
  342. package/dist/clients/dispatch/runners/utils/tool-failure.js +0 -235
  343. package/dist/clients/dispatch/runners/utils/toolchain-availability.js +0 -169
  344. package/dist/clients/dispatch/runners/utils.js +0 -15
  345. package/dist/clients/dispatch/runners/vale.js +0 -128
  346. package/dist/clients/dispatch/runners/yaml-rule-parser.js +0 -242
  347. package/dist/clients/dispatch/runners/yamllint.js +0 -95
  348. package/dist/clients/dispatch/runners/zig-check.js +0 -79
  349. package/dist/clients/dispatch/suppress-writer.js +0 -79
  350. package/dist/clients/dispatch/tool-profile.js +0 -30
  351. package/dist/clients/dispatch/types.js +0 -21
  352. package/dist/clients/dispatch/utils/format-utils.js +0 -45
  353. package/dist/clients/dispatch/utils/lsp-diagnostics.js +0 -35
  354. package/dist/clients/disposition-logger.js +0 -32
  355. package/dist/clients/disposition-publish.js +0 -124
  356. package/dist/clients/durable-store.js +0 -97
  357. package/dist/clients/effective-config.js +0 -415
  358. package/dist/clients/env-utils.js +0 -83
  359. package/dist/clients/error-class.js +0 -23
  360. package/dist/clients/eval-timestamp.js +0 -17
  361. package/dist/clients/event-loop-hold.js +0 -274
  362. package/dist/clients/event-loop-monitor.js +0 -250
  363. package/dist/clients/extension-log.js +0 -504
  364. package/dist/clients/extension-mode.js +0 -73
  365. package/dist/clients/feature-hints.js +0 -103
  366. package/dist/clients/file-kinds.js +0 -412
  367. package/dist/clients/file-role.js +0 -134
  368. package/dist/clients/file-time.js +0 -160
  369. package/dist/clients/file-utils.js +0 -1032
  370. package/dist/clients/finding-delivery-gate.js +0 -494
  371. package/dist/clients/finding-identity.js +0 -88
  372. package/dist/clients/fix-worklog.js +0 -103
  373. package/dist/clients/format-events-publish.js +0 -343
  374. package/dist/clients/format-service.js +0 -222
  375. package/dist/clients/formatters-lazy.js +0 -9
  376. package/dist/clients/formatters.js +0 -2032
  377. package/dist/clients/freshness-cadence.js +0 -17
  378. package/dist/clients/freshness.js +0 -38
  379. package/dist/clients/generated-artifacts.js +0 -394
  380. package/dist/clients/generation-guard.js +0 -215
  381. package/dist/clients/git-guard.js +0 -1136
  382. package/dist/clients/git-tracked-ignore.js +0 -243
  383. package/dist/clients/gitleaks-client.js +0 -509
  384. package/dist/clients/go-client.js +0 -104
  385. package/dist/clients/govulncheck-client.js +0 -605
  386. package/dist/clients/gradle-ktfmt-style.js +0 -348
  387. package/dist/clients/grammar-source.js +0 -465
  388. package/dist/clients/gzip-stage-write.js +0 -135
  389. package/dist/clients/hashline-anchor.js +0 -424
  390. package/dist/clients/hook-budgets.js +0 -76
  391. package/dist/clients/host-edit-normalize.js +0 -140
  392. package/dist/clients/host-ports.js +0 -39
  393. package/dist/clients/indent-retarget.js +0 -154
  394. package/dist/clients/inline-blocker-dispositions.js +0 -186
  395. package/dist/clients/install-diagnostics.js +0 -156
  396. package/dist/clients/installer/index.js +0 -5416
  397. package/dist/clients/installer/managed-tool-refresh-session.js +0 -58
  398. package/dist/clients/installer/managed-tool-refresh.js +0 -783
  399. package/dist/clients/instance-reaper-state.js +0 -7
  400. package/dist/clients/instance-reaper.js +0 -1137
  401. package/dist/clients/instance-registry-lock.js +0 -145
  402. package/dist/clients/instance-registry.js +0 -773
  403. package/dist/clients/jscpd-client.js +0 -378
  404. package/dist/clients/json-cache-read.js +0 -65
  405. package/dist/clients/knip-client.js +0 -788
  406. package/dist/clients/language-policy.js +0 -252
  407. package/dist/clients/language-profile.js +0 -361
  408. package/dist/clients/language-registry.js +0 -603
  409. package/dist/clients/latency-logger.js +0 -727
  410. package/dist/clients/lazy-import.js +0 -21
  411. package/dist/clients/ledger-bounds.js +0 -54
  412. package/dist/clients/lens-config.js +0 -404
  413. package/dist/clients/lens-engine.js +0 -358
  414. package/dist/clients/lens-events.js +0 -125
  415. package/dist/clients/lens-flag-registry.js +0 -467
  416. package/dist/clients/lens-map.js +0 -1156
  417. package/dist/clients/live-bus-emitter.js +0 -74
  418. package/dist/clients/log-cleanup.js +0 -222
  419. package/dist/clients/lsp/aggregation.js +0 -178
  420. package/dist/clients/lsp/cascade-tier.js +0 -421
  421. package/dist/clients/lsp/client.js +0 -4593
  422. package/dist/clients/lsp/config.js +0 -691
  423. package/dist/clients/lsp/content-limits.js +0 -41
  424. package/dist/clients/lsp/diagnostic-binding.js +0 -225
  425. package/dist/clients/lsp/document-drift.js +0 -467
  426. package/dist/clients/lsp/edits.js +0 -1219
  427. package/dist/clients/lsp/index.js +0 -8305
  428. package/dist/clients/lsp/inferred-project.js +0 -216
  429. package/dist/clients/lsp/jvm-runtime.js +0 -298
  430. package/dist/clients/lsp/language.js +0 -63
  431. package/dist/clients/lsp/launch.js +0 -746
  432. package/dist/clients/lsp/lombok.js +0 -158
  433. package/dist/clients/lsp/path-utils.js +0 -5
  434. package/dist/clients/lsp/pending-aux-coverage.js +0 -251
  435. package/dist/clients/lsp/position-encoding.js +0 -61
  436. package/dist/clients/lsp/ruby-drive-dirs.js +0 -83
  437. package/dist/clients/lsp/server.js +0 -3290
  438. package/dist/clients/lsp/session-roots.js +0 -192
  439. package/dist/clients/lsp/spawn-history.js +0 -17
  440. package/dist/clients/lsp/sync-kind.js +0 -56
  441. package/dist/clients/lsp/tsserver-sync.js +0 -332
  442. package/dist/clients/lsp/wait-policy/capability-snapshot.js +0 -1
  443. package/dist/clients/lsp/wait-policy/classification.js +0 -85
  444. package/dist/clients/lsp/wait-policy/index.js +0 -10
  445. package/dist/clients/lsp/wait-policy/strategies.js +0 -392
  446. package/dist/clients/lsp/watch-queue.js +0 -61
  447. package/dist/clients/lsp/workspace-diagnostics-cache.js +0 -639
  448. package/dist/clients/lsp/workspace-diagnostics-session.js +0 -30
  449. package/dist/clients/lsp/workspace-sweep-hold.js +0 -184
  450. package/dist/clients/lsp-budget.js +0 -186
  451. package/dist/clients/lsp-document-symbols.js +0 -110
  452. package/dist/clients/lsp-lazy.js +0 -9
  453. package/dist/clients/lsp-mutation.js +0 -396
  454. package/dist/clients/lsp-status.js +0 -59
  455. package/dist/clients/map-with-concurrency.js +0 -40
  456. package/dist/clients/mcp/analyze.js +0 -420
  457. package/dist/clients/mcp/host-shim.js +0 -31
  458. package/dist/clients/mcp/ipc.js +0 -523
  459. package/dist/clients/mcp/review.js +0 -197
  460. package/dist/clients/mcp/session.js +0 -412
  461. package/dist/clients/memory-sampler.js +0 -208
  462. package/dist/clients/message-end-attribution.js +0 -30
  463. package/dist/clients/metrics-client.js +0 -107
  464. package/dist/clients/metrics-history.js +0 -327
  465. package/dist/clients/middle-man-analysis.js +0 -263
  466. package/dist/clients/model-provider.js +0 -53
  467. package/dist/clients/module-report-lsp.js +0 -189
  468. package/dist/clients/module-report.js +0 -2150
  469. package/dist/clients/mutating-tool.js +0 -651
  470. package/dist/clients/mutation-attribution.js +0 -368
  471. package/dist/clients/mutation-bridge.js +0 -240
  472. package/dist/clients/ndjson-logger.js +0 -734
  473. package/dist/clients/observed-mutation-sources.js +0 -101
  474. package/dist/clients/observed-mutation.js +0 -1253
  475. package/dist/clients/oldtext-autopatch.js +0 -128
  476. package/dist/clients/opaque-mutation-scan.js +0 -496
  477. package/dist/clients/opengrep-client.js +0 -333
  478. package/dist/clients/opengrep-config.js +0 -76
  479. package/dist/clients/package-manager.js +0 -607
  480. package/dist/clients/package-root.js +0 -38
  481. package/dist/clients/partial-edit-apply.js +0 -439
  482. package/dist/clients/path-attribution-telemetry.js +0 -43
  483. package/dist/clients/path-keyed-map.js +0 -108
  484. package/dist/clients/path-utils.js +0 -1244
  485. package/dist/clients/performance-report.js +0 -331
  486. package/dist/clients/persist-debounce.js +0 -70
  487. package/dist/clients/persistent-reverify.js +0 -271
  488. package/dist/clients/php-cs-fixer-config.js +0 -119
  489. package/dist/clients/pipeline.js +0 -1480
  490. package/dist/clients/post-autofix-notice.js +0 -37
  491. package/dist/clients/print-mode.js +0 -21
  492. package/dist/clients/probe-home-state.js +0 -228
  493. package/dist/clients/process-bridge.js +0 -66
  494. package/dist/clients/process-singletons.js +0 -210
  495. package/dist/clients/process-snapshot.js +0 -68
  496. package/dist/clients/project-changes.js +0 -181
  497. package/dist/clients/project-conventions.js +0 -171
  498. package/dist/clients/project-diagnostics/cache.js +0 -137
  499. package/dist/clients/project-diagnostics/extractors.js +0 -109
  500. package/dist/clients/project-diagnostics/fresh-fetch.js +0 -668
  501. package/dist/clients/project-diagnostics/runner-adapters/call-graph-impact.js +0 -118
  502. package/dist/clients/project-diagnostics/runner-adapters/dead-code.js +0 -47
  503. package/dist/clients/project-diagnostics/runner-adapters/gitleaks.js +0 -40
  504. package/dist/clients/project-diagnostics/runner-adapters/govulncheck.js +0 -34
  505. package/dist/clients/project-diagnostics/runner-adapters/jscpd.js +0 -38
  506. package/dist/clients/project-diagnostics/runner-adapters/knip.js +0 -47
  507. package/dist/clients/project-diagnostics/runner-adapters/madge.js +0 -48
  508. package/dist/clients/project-diagnostics/runner-adapters/opengrep.js +0 -40
  509. package/dist/clients/project-diagnostics/runner-adapters/runner-findings.js +0 -127
  510. package/dist/clients/project-diagnostics/runner-adapters/trivy.js +0 -81
  511. package/dist/clients/project-diagnostics/scanner.js +0 -520
  512. package/dist/clients/project-diagnostics/types.js +0 -1
  513. package/dist/clients/project-lens-config.js +0 -807
  514. package/dist/clients/project-report.js +0 -701
  515. package/dist/clients/project-scale.js +0 -237
  516. package/dist/clients/project-scan-policy.js +0 -11
  517. package/dist/clients/project-snapshot-fingerprint.js +0 -48
  518. package/dist/clients/project-snapshot-persist-worker.js +0 -20
  519. package/dist/clients/project-snapshot.js +0 -1653
  520. package/dist/clients/project-trust.js +0 -181
  521. package/dist/clients/python-environment.js +0 -217
  522. package/dist/clients/python-provenance.js +0 -639
  523. package/dist/clients/quiet-window-config.js +0 -47
  524. package/dist/clients/quiet-window.js +0 -236
  525. package/dist/clients/read-bridge.js +0 -139
  526. package/dist/clients/read-expansion.js +0 -266
  527. package/dist/clients/read-guard-logger.js +0 -251
  528. package/dist/clients/read-guard-tool-lines.js +0 -1306
  529. package/dist/clients/read-guard.js +0 -1561
  530. package/dist/clients/recent-touches.js +0 -240
  531. package/dist/clients/redact/secrets.js +0 -449
  532. package/dist/clients/resource-sampler.js +0 -628
  533. package/dist/clients/reverse-deps.js +0 -270
  534. package/dist/clients/review-graph/builder.js +0 -5126
  535. package/dist/clients/review-graph/format.js +0 -33
  536. package/dist/clients/review-graph/git-identity.js +0 -163
  537. package/dist/clients/review-graph/import-resolvers.js +0 -481
  538. package/dist/clients/review-graph/persist-worker.js +0 -10
  539. package/dist/clients/review-graph/query.js +0 -244
  540. package/dist/clients/review-graph/revision-drift.js +0 -21
  541. package/dist/clients/review-graph/service.js +0 -96
  542. package/dist/clients/review-graph/shared-extraction-ir.js +0 -82
  543. package/dist/clients/review-graph/symbol-id.js +0 -103
  544. package/dist/clients/review-graph/tsconfig-paths.js +0 -299
  545. package/dist/clients/review-graph/types.js +0 -1
  546. package/dist/clients/review-graph/workspace-modules.js +0 -449
  547. package/dist/clients/review-graph-logger.js +0 -81
  548. package/dist/clients/ruff-client.js +0 -179
  549. package/dist/clients/rules-scanner.js +0 -131
  550. package/dist/clients/run-duration.js +0 -55
  551. package/dist/clients/runtime-agent-end.js +0 -746
  552. package/dist/clients/runtime-config.js +0 -77
  553. package/dist/clients/runtime-context.js +0 -211
  554. package/dist/clients/runtime-coordinator.js +0 -1324
  555. package/dist/clients/runtime-session.js +0 -2485
  556. package/dist/clients/runtime-tool-call.js +0 -1295
  557. package/dist/clients/runtime-tool-result.js +0 -2049
  558. package/dist/clients/runtime-turn.js +0 -3767
  559. package/dist/clients/rust-client.js +0 -97
  560. package/dist/clients/safe-spawn.js +0 -2357
  561. package/dist/clients/sanitize.js +0 -286
  562. package/dist/clients/scan-utils.js +0 -25
  563. package/dist/clients/scratch-tree-policy.js +0 -165
  564. package/dist/clients/search-read-registration.js +0 -94
  565. package/dist/clients/secret-findings.js +0 -114
  566. package/dist/clients/security-scan-client.js +0 -352
  567. package/dist/clients/session-event-guard.js +0 -297
  568. package/dist/clients/session-lifecycle.js +0 -484
  569. package/dist/clients/session-start-observability.js +0 -94
  570. package/dist/clients/session-state-store.js +0 -101
  571. package/dist/clients/session-summary.js +0 -15
  572. package/dist/clients/sessionstart-logger.js +0 -27
  573. package/dist/clients/sg-runner.js +0 -876
  574. package/dist/clients/sgconfig.js +0 -347
  575. package/dist/clients/shared-checkout-guard.js +0 -338
  576. package/dist/clients/single-flight.js +0 -158
  577. package/dist/clients/situational-tool-telemetry.js +0 -108
  578. package/dist/clients/skills-resolver.js +0 -141
  579. package/dist/clients/slow-fs.js +0 -138
  580. package/dist/clients/smells-rollup.js +0 -231
  581. package/dist/clients/source-filter.js +0 -596
  582. package/dist/clients/source-walker.js +0 -211
  583. package/dist/clients/spawn-output-cap.js +0 -120
  584. package/dist/clients/spawn-timeout-cooldown.js +0 -110
  585. package/dist/clients/stale-marker.js +0 -17
  586. package/dist/clients/startup-scan.js +0 -400
  587. package/dist/clients/startup-timing.js +0 -130
  588. package/dist/clients/string-utils.js +0 -33
  589. package/dist/clients/subagent-mode.js +0 -111
  590. package/dist/clients/symbol-containment.js +0 -24
  591. package/dist/clients/symbol-types.js +0 -5
  592. package/dist/clients/test-runner-client.js +0 -2507
  593. package/dist/clients/test-runner-delivery.js +0 -287
  594. package/dist/clients/todo-scanner.js +0 -229
  595. package/dist/clients/tool-agreement.js +0 -423
  596. package/dist/clients/tool-config.js +0 -249
  597. package/dist/clients/tool-cwd.js +0 -270
  598. package/dist/clients/tool-definition.js +0 -47
  599. package/dist/clients/tool-event.js +0 -105
  600. package/dist/clients/tool-policy.js +0 -2755
  601. package/dist/clients/tool-probe.js +0 -53
  602. package/dist/clients/tool-render.js +0 -156
  603. package/dist/clients/tool-set-policy.js +0 -118
  604. package/dist/clients/tree-sitter-cache.js +0 -364
  605. package/dist/clients/tree-sitter-client.js +0 -4195
  606. package/dist/clients/tree-sitter-logger.js +0 -100
  607. package/dist/clients/tree-sitter-navigator.js +0 -269
  608. package/dist/clients/tree-sitter-query-loader.js +0 -569
  609. package/dist/clients/tree-sitter-shared.js +0 -158
  610. package/dist/clients/tree-sitter-symbol-extractor.js +0 -1265
  611. package/dist/clients/trivy-client.js +0 -467
  612. package/dist/clients/tui-fit.js +0 -50
  613. package/dist/clients/turn-context.js +0 -52
  614. package/dist/clients/turn-end/lane.js +0 -51
  615. package/dist/clients/turn-end/lanes/govulncheck.js +0 -112
  616. package/dist/clients/turn-end/lanes/secrets.js +0 -204
  617. package/dist/clients/turn-summary-render.js +0 -72
  618. package/dist/clients/turn-summary.js +0 -132
  619. package/dist/clients/typos-config.js +0 -29
  620. package/dist/clients/user-notify.js +0 -51
  621. package/dist/clients/vanished-instance-marker.js +0 -57
  622. package/dist/clients/warm-attach.js +0 -305
  623. package/dist/clients/widget-state.js +0 -1808
  624. package/dist/clients/word-index-logger.js +0 -49
  625. package/dist/clients/word-index-store.js +0 -459
  626. package/dist/clients/word-index.js +0 -2080
  627. package/dist/clients/workspace-topology.js +0 -443
  628. package/dist/clients/write-ordering-guard.js +0 -65
  629. package/dist/clients/zizmor-config.js +0 -340
  630. package/dist/i18n.js +0 -69
  631. package/dist/mcp/build-staleness.js +0 -124
  632. package/dist/scripts/lib/process-scan.mjs +0 -583
  633. package/dist/scripts/lib/skills-predicate.mjs +0 -129
  634. package/dist/scripts/lib/web-tree-sitter-dir.mjs +0 -123
  635. package/dist/tools/activate-tools.js +0 -87
  636. package/dist/tools/ast-grep-outline.js +0 -137
  637. package/dist/tools/ast-grep-replace.js +0 -244
  638. package/dist/tools/ast-grep-search.js +0 -762
  639. package/dist/tools/effective-config.js +0 -90
  640. package/dist/tools/lens-diagnostic-mark.js +0 -375
  641. package/dist/tools/lens-diagnostics.js +0 -2571
  642. package/dist/tools/lsp-diagnostics.js +0 -1745
  643. package/dist/tools/lsp-navigation.js +0 -1367
  644. package/dist/tools/lsp-structured-output.js +0 -294
  645. package/dist/tools/module-report.js +0 -382
  646. package/dist/tools/project-report.js +0 -86
  647. package/dist/tools/render-compact.js +0 -374
  648. package/dist/tools/scan-progress.js +0 -53
  649. package/dist/tools/shared.js +0 -29
  650. package/dist/tools/symbol-search.js +0 -155
@@ -1 +0,0 @@
1
- export {};
@@ -1,17 +0,0 @@
1
- const rules = [];
2
- export function registerRule(r) {
3
- rules.push(r);
4
- }
5
- export function clearRules() {
6
- rules.length = 0;
7
- }
8
- export function evaluateRules(ctx) {
9
- const diagnostics = [];
10
- for (const rule of rules) {
11
- if (!rule.appliesTo(ctx))
12
- continue;
13
- const results = rule.evaluate(ctx, ctx.facts);
14
- diagnostics.push(...results);
15
- }
16
- return diagnostics;
17
- }
@@ -1,30 +0,0 @@
1
- import { scheduleProviders } from "./fact-scheduler.js";
2
- const providers = [];
3
- export function registerProvider(p) {
4
- providers.push(p);
5
- }
6
- export function clearProviders() {
7
- providers.length = 0;
8
- }
9
- /**
10
- * Run the registered fact providers for `ctx`, in dependency order.
11
- *
12
- * Providers + fact rules are registered eagerly at `integration.ts` import (the
13
- * dispatch entry) — including the tree-sitter-backed providers. That's safe for
14
- * pi-lens's eager graph because the parsing stack loads `web-tree-sitter` (an
15
- * optional dep) via a dynamic `import()` inside `client.init()`, not at module
16
- * import, so an unavailable grammar/runtime degrades there rather than crashing
17
- * the extension at load. As of #402 nothing here uses the `typescript` compiler,
18
- * so the old lazy-import-with-degrade indirection (#285/#335) is gone.
19
- */
20
- export async function runProviders(ctx) {
21
- const applicable = providers.filter((p) => p.appliesTo(ctx));
22
- const ordered = scheduleProviders(applicable);
23
- for (const provider of ordered) {
24
- // Skip if all provided facts are already present
25
- const allPresent = provider.provides.every((key) => ctx.facts.hasFileFact(ctx.filePath, key));
26
- if (allPresent)
27
- continue;
28
- await provider.run(ctx, ctx.facts);
29
- }
30
- }
@@ -1,68 +0,0 @@
1
- /**
2
- * Orders providers topologically so each provider's `requires` are satisfied
3
- * before it runs. Tie-breaks alphabetically by `id`. Detects cycles.
4
- *
5
- * Only deps that have a provider in the input list count toward in-degree;
6
- * external facts (provided outside this list) are treated as always available.
7
- */
8
- export function scheduleProviders(providers) {
9
- if (providers.length <= 1)
10
- return providers.slice();
11
- // Map: factKey → provider that provides it
12
- const factToProvider = new Map();
13
- for (const p of providers) {
14
- for (const key of p.provides) {
15
- factToProvider.set(key, p);
16
- }
17
- }
18
- // For each provider, track in-degree and which providers depend on it
19
- const inDegree = new Map();
20
- // dependents[id] = set of provider ids that require a fact provided by this provider
21
- const dependents = new Map();
22
- for (const p of providers) {
23
- if (!inDegree.has(p.id))
24
- inDegree.set(p.id, 0);
25
- if (!dependents.has(p.id))
26
- dependents.set(p.id, new Set());
27
- }
28
- for (const p of providers) {
29
- const seenDeps = new Set();
30
- for (const req of p.requires) {
31
- const dep = factToProvider.get(req);
32
- if (dep && dep.id !== p.id && !seenDeps.has(dep.id)) {
33
- seenDeps.add(dep.id);
34
- inDegree.set(p.id, (inDegree.get(p.id) ?? 0) + 1);
35
- dependents.get(dep.id).add(p.id);
36
- }
37
- }
38
- }
39
- const idToProvider = new Map(providers.map((p) => [p.id, p]));
40
- // Start with providers that have no unsatisfied deps, sorted by id
41
- let wave = providers
42
- .filter((p) => (inDegree.get(p.id) ?? 0) === 0)
43
- .sort((a, b) => a.id.localeCompare(b.id));
44
- const result = [];
45
- while (wave.length > 0) {
46
- const nextWave = [];
47
- for (const p of wave) {
48
- result.push(p);
49
- for (const depId of dependents.get(p.id) ?? []) {
50
- const newDegree = (inDegree.get(depId) ?? 0) - 1;
51
- inDegree.set(depId, newDegree);
52
- if (newDegree === 0) {
53
- nextWave.push(idToProvider.get(depId));
54
- }
55
- }
56
- }
57
- nextWave.sort((a, b) => a.id.localeCompare(b.id));
58
- wave = nextWave;
59
- }
60
- if (result.length < providers.length) {
61
- const cycleParticipants = providers
62
- .filter((p) => !result.includes(p))
63
- .map((p) => p.id)
64
- .sort((a, b) => a.localeCompare(b));
65
- throw new Error(`Cycle detected among FactProviders: ${cycleParticipants.join(", ")}`);
66
- }
67
- return result;
68
- }
@@ -1,377 +0,0 @@
1
- import { BoundedLruCache } from "../bounded-cache.js";
2
- import { normalizeMapKey } from "../path-utils.js";
3
- let capacityEvictionReporter;
4
- export function setFactStoreEvictionReporter(reporter) {
5
- capacityEvictionReporter = reporter;
6
- }
7
- export function getFactStoreEvictionReporter() {
8
- return capacityEvictionReporter;
9
- }
10
- // #2240: the dispatch store is module-scope in integration.ts, so it lives for
11
- // the whole process, and a review-graph project walk seeds facts for EVERY file
12
- // it visits. Nothing removed an entry except the next dispatch of that same
13
- // path, so a several-hundred-file batch retained one entry per distinct path
14
- // until the heap ran out. Bound the record count the way widget-state.ts bounds
15
- // its file records.
16
- const MAX_FILE_FACT_RECORDS = 1024;
17
- // Keep enough content for 1024 typical source files averaging 64 KiB, while
18
- // preventing a small number of generated or vendored files from retaining
19
- // hundreds of MiB for the process lifetime (#2247).
20
- const MAX_FILE_FACT_CONTENT_BYTES = 64 * 1024 * 1024;
21
- // Pinned records are exempt from capacity eviction. A dispatch reads its
22
- // file's facts back after the runner groups settle (`file.content` misses read as
23
- // empty content, not as "re-derive"), and the fire-and-forget blast-radius
24
- // build runs a whole-project walk against the SAME store meanwhile — plain LRU
25
- // recency would let that walk evict the file being dispatched. Every other holder
26
- // re-derives an evicted fact from disk.
27
- //
28
- // #2243 item 2: a dispatch pins its file at start (`clearFileFactsFor`) and
29
- // releases it at completion (`endDispatchFor`, in the dispatch's finally). The
30
- // pin set therefore tracks dispatches actually IN FLIGHT, not the last N files
31
- // touched.
32
- // #2282: `sessionFacts` below is a flat `Map<factId, value>` shared by two
33
- // unrelated fact shapes — a small FIXED vocabulary (tool availability keyed by
34
- // command, the singleton "session.reviewGraph") and PER-FILE families that
35
- // mint one key per file touched (session baseline, cascade baseline, review-
36
- // graph entity snapshots) and never shrink. Only the second shape grows with
37
- // batch size, so only it gets a bound; the fixed vocabulary stays on the plain
38
- // map, unbounded, because its cardinality is small and stable. Per-file
39
- // session facts opt into `boundedSessionFacts` instead, reusing fileFacts'
40
- // LRU-count-cap-and-report discipline rather than adding a third mechanism.
41
- // No pin exemption here (unlike fileFacts): every current per-file session
42
- // fact is read once near dispatch start and written once at dispatch end, so
43
- // nothing re-reads its OWN key later in the same dispatch the way a runner
44
- // re-reads `file.content` — an eviction mid-batch only means the next dispatch
45
- // of that path sees no previous baseline, the same safe state as its first
46
- // ever dispatch this session.
47
- //
48
- // That equivalence holds only where an absent baseline means "report
49
- // everything", which is true for the diagnostic baselines and false for the
50
- // review-graph entity snapshot: there, an absent snapshot read as an empty one
51
- // puts every symbol in `added` and drives a blast-radius run for a file that
52
- // did not change. So an eviction leaves a tombstone, and a reader that needs
53
- // the distinction asks `wasBoundedSessionFactEvicted`. Tombstones are keys
54
- // only, and carry the same cap, so the coldest of them fall off in turn and
55
- // that key reverts to first-dispatch semantics.
56
- //
57
- // Four per-file keys are minted per dispatched file today (diagnostic
58
- // baseline, cascade baseline, entity snapshot, changed symbols), so 4096
59
- // records covers roughly 1024 distinct files before the coldest file's
60
- // baseline starts degrading.
61
- const MAX_SESSION_FACT_RECORDS = 4096;
62
- export class FactStore {
63
- subject;
64
- // Insertion order is eviction order: the oldest-used record is evicted first.
65
- fileFacts = new Map();
66
- sessionFacts = new Map();
67
- // Bounded sibling of `sessionFacts` for per-file-keyed session facts (#2282).
68
- // True LRU: every fetch (get or create, see getBoundedSessionFact) refreshes
69
- // recency, so the oldest-UNUSED record is evicted first, not merely the
70
- // oldest-inserted.
71
- boundedSessionFacts = new BoundedLruCache(MAX_SESSION_FACT_RECORDS);
72
- // Keys evicted from `boundedSessionFacts` and not written since, so a reader
73
- // can tell "evicted" from "never seen" (#2282). Same cap, same FIFO order.
74
- evictedSessionFactKeys = new Set();
75
- // Pin refcount per file. A file is exempt from capacity eviction while its
76
- // count is > 0. Refcounted, not a Set, so two overlapping dispatches of the
77
- // same file both hold the pin until BOTH settle (#2243 item 2).
78
- pinnedFiles = new Map();
79
- // Running UTF-8 byte total for file.content only. Maintaining it at every
80
- // mutation keeps getFileFact/setFileFact O(1) amortized; never scan the map
81
- // to decide whether the byte budget is exceeded.
82
- retainedContentBytes = 0;
83
- // Subset of retainedContentBytes held by currently pinned files (#2247
84
- // review F2). Maintained incrementally the same way — a scan over
85
- // `pinnedFiles` looks small in isolation, but `evictColdFileFacts` calls it
86
- // on EVERY unpinned insert for as long as pinned bytes stay over budget, so
87
- // a scan there would re-walk a large pinned file's full string on every
88
- // single write admitted during that window. Keeping a running total avoids
89
- // reintroducing exactly the scan `retainedContentBytes` exists to avoid.
90
- pinnedContentBytesTotal = 0;
91
- /**
92
- * @param subject Discriminates this store's capacity-eviction telemetry
93
- * from every other production FactStore's (#2243 review round 3, F1).
94
- * Production callers pass a label naming the store (e.g. `"dispatch"`,
95
- * `"runtime-session-call-graph"`); the default is only for call sites
96
- * that never wired a reporter and tests that don't care.
97
- */
98
- constructor(subject = "session-fact-store") {
99
- this.subject = subject;
100
- }
101
- // All file-keyed methods normalize the path internally via normalizeMapKey().
102
- // Callers always pass raw/resolved paths — normalization is not their concern.
103
- getFileFact(filePath, factId) {
104
- return this.touchFileFacts(normalizeMapKey(filePath))?.get(factId);
105
- }
106
- setFileFact(filePath, factId, value) {
107
- const key = normalizeMapKey(filePath);
108
- let facts = this.touchFileFacts(key);
109
- if (!facts) {
110
- facts = new Map();
111
- this.fileFacts.set(key, facts);
112
- }
113
- if (factId === "file.content") {
114
- const delta = this.contentBytes(value) - this.contentBytes(facts.get(factId));
115
- this.retainedContentBytes += delta;
116
- if (this.pinnedFiles.has(key))
117
- this.pinnedContentBytesTotal += delta;
118
- }
119
- facts.set(factId, value);
120
- this.evictColdFileFacts();
121
- }
122
- hasFileFact(filePath, factId) {
123
- return this.fileFacts.get(normalizeMapKey(filePath))?.has(factId) ?? false;
124
- }
125
- /** Drop one file fact without disturbing the file's derived facts.
126
- * Removes the per-file entry too when the deleted fact was its last value. */
127
- deleteFileFact(filePath, factId) {
128
- const key = normalizeMapKey(filePath);
129
- const facts = this.fileFacts.get(key);
130
- if (!facts)
131
- return;
132
- if (factId === "file.content") {
133
- const dropped = this.contentBytes(facts.get(factId));
134
- this.retainedContentBytes -= dropped;
135
- if (this.pinnedFiles.has(key))
136
- this.pinnedContentBytesTotal -= dropped;
137
- }
138
- facts.delete(factId);
139
- if (facts.size === 0)
140
- this.fileFacts.delete(key);
141
- }
142
- /** Clear facts for one specific file only, and mark the file's dispatch as
143
- * begun. Use at the start of each per-file dispatch call.
144
- * Preserves facts for other files computed in the same turn.
145
- * Normalizes filePath internally — callers pass raw paths.
146
- * Pins the file against capacity eviction until the matching
147
- * {@link endDispatchFor} runs in the dispatch's settle path (#2243 item 2).
148
- * Every `clearFileFactsFor` MUST be paired with an `endDispatchFor`. */
149
- clearFileFactsFor(filePath) {
150
- const key = normalizeMapKey(filePath);
151
- this.deleteFileFactsRecord(key);
152
- this.pinFile(key);
153
- }
154
- /** Pin a file against capacity eviction for the duration of a dispatch,
155
- * WITHOUT clearing its existing facts. Pairs with {@link endDispatchFor}
156
- * exactly like {@link clearFileFactsFor} does.
157
- *
158
- * #2243 review round 3 (F5): `clearFileFactsFor`'s clear+re-derive is
159
- * right for a dispatch driven by a fresh edit, but the debounced
160
- * ast-grep warning scan runs ~2s AFTER the inline dispatch for that same
161
- * edit already re-derived every fact for this exact file — a second
162
- * clear there bought nothing but ~51ms of redundant re-parsing across
163
- * all five providers (measured; a warm-cache read is ~1ms). Use this
164
- * where the facts are very likely already fresh: `runProviders` still
165
- * re-derives any fact this file is missing (a genuine miss, e.g. the
166
- * fact was evicted meanwhile), so a read never depends on staleness. */
167
- beginDispatchFor(filePath) {
168
- this.pinFile(normalizeMapKey(filePath));
169
- }
170
- /** Release the pin a {@link clearFileFactsFor} or {@link beginDispatchFor}
171
- * took for one file's dispatch. Call once per matching call, from the
172
- * dispatch's finally/settle path, so the pin set tracks dispatches
173
- * actually in flight rather than the last N files touched (#2243 item 2). */
174
- endDispatchFor(filePath) {
175
- this.unpinFile(normalizeMapKey(filePath));
176
- this.evictColdFileFacts();
177
- }
178
- /** Clear one file's facts WITHOUT pinning. For sequential single-store scans
179
- * (project-diagnostics) that own their store and race no concurrent walk:
180
- * pinning there would exempt every scanned file from the capacity cap and
181
- * defeat it. Normalizes filePath internally. */
182
- dropFileFacts(filePath) {
183
- this.deleteFileFactsRecord(normalizeMapKey(filePath));
184
- }
185
- /** LRU touch: re-inserting an existing record moves it to the end of the
186
- * eviction order, so a record still in use is not the next victim. */
187
- touchFileFacts(key) {
188
- const facts = this.fileFacts.get(key);
189
- if (!facts)
190
- return undefined;
191
- this.fileFacts.delete(key);
192
- this.fileFacts.set(key, facts);
193
- return facts;
194
- }
195
- pinFile(key) {
196
- const count = this.pinnedFiles.get(key) ?? 0;
197
- // Transition from unpinned to pinned: this file's content joins the
198
- // pinned subset. A refcount bump past 1 (an already-pinned file, two
199
- // overlapping dispatches) does not — it is already counted.
200
- if (count === 0) {
201
- this.pinnedContentBytesTotal += this.contentBytes(this.fileFacts.get(key)?.get("file.content"));
202
- }
203
- this.pinnedFiles.set(key, count + 1);
204
- }
205
- unpinFile(key) {
206
- const count = this.pinnedFiles.get(key);
207
- if (count === undefined)
208
- return;
209
- if (count <= 1) {
210
- this.pinnedFiles.delete(key);
211
- // Transition from pinned to unpinned: this file's content leaves the
212
- // pinned subset.
213
- this.pinnedContentBytesTotal -= this.contentBytes(this.fileFacts.get(key)?.get("file.content"));
214
- }
215
- else {
216
- this.pinnedFiles.set(key, count - 1);
217
- }
218
- }
219
- /** Drop least-recently-used records past either cap, skipping the files whose
220
- * dispatch pinned them. Pinned content counts toward the byte total, but is
221
- * never evicted before endDispatchFor. Pins survive until clearAll.
222
- *
223
- * #2247 review F2: a leaked (or several overlapping) pin(s) can put pinned
224
- * bytes over budget ON THEIR OWN. Evicting every unpinned record can never
225
- * bring the total back under budget in that state — before this guard, the
226
- * loop below evicted each newly inserted unpinned record on the very next
227
- * call (it was always the sole remaining unpinned key), so unpinned writes
228
- * never retained anything: a silent, permanent collapse for the rest of
229
- * the process. Once byte pressure is unpinned-bytes-driven-only, stop
230
- * evicting and admit unpinned inserts as-is — best-effort under pin
231
- * pressure — and record the state distinctly so it is visible instead of
232
- * inferred from "the store stopped retaining anything". */
233
- evictColdFileFacts() {
234
- if (!this.overCapacity())
235
- return;
236
- for (const key of this.fileFacts.keys()) {
237
- if (this.pinnedFiles.has(key))
238
- continue;
239
- const axis = this.capacityAxis();
240
- if (axis === "bytes" &&
241
- this.pinnedContentBytesTotal > MAX_FILE_FACT_CONTENT_BYTES) {
242
- this.reportPinnedOverBudget();
243
- return;
244
- }
245
- this.deleteFileFactsRecord(key);
246
- this.reportCapacityEviction(key, axis);
247
- if (!this.overCapacity())
248
- return;
249
- }
250
- }
251
- overCapacity() {
252
- return (this.fileFacts.size > MAX_FILE_FACT_RECORDS ||
253
- this.retainedContentBytes > MAX_FILE_FACT_CONTENT_BYTES);
254
- }
255
- capacityAxis() {
256
- return this.fileFacts.size > MAX_FILE_FACT_RECORDS ? "count" : "bytes";
257
- }
258
- contentBytes(value) {
259
- return typeof value === "string" ? Buffer.byteLength(value, "utf8") : 0;
260
- }
261
- deleteFileFactsRecord(key) {
262
- const facts = this.fileFacts.get(key);
263
- if (!facts)
264
- return;
265
- const dropped = this.contentBytes(facts.get("file.content"));
266
- this.retainedContentBytes -= dropped;
267
- if (this.pinnedFiles.has(key))
268
- this.pinnedContentBytesTotal -= dropped;
269
- this.fileFacts.delete(key);
270
- }
271
- // #2243 item 4: the cap silently drops a fact a live dispatch may read back
272
- // as "" (dispatcher.ts reads `file.content` with `?? ""`). Emit through the
273
- // injected reporter so the drop is visible in the ledger instead of being
274
- // inferred from a downstream symptom. integration.ts routes this to
275
- // `recordDegradationOnce` keyed on THIS store's `subject` (#2243 review
276
- // round 3, F1), so the ledger's own per-kind+subject dedupe yields exactly
277
- // ONE record per session PER STORE (re-arming at session_start when the
278
- // ledger resets) — no latch or generation compare here, so fact-store
279
- // keeps no session-scoped state to forget to re-arm.
280
- reportCapacityEviction(evictedKey, axis) {
281
- capacityEvictionReporter?.(this.subject, axis, axis === "count"
282
- ? `file-fact store axis=count exceeded ${MAX_FILE_FACT_RECORDS} records; evicted least-recently-used fact for ${evictedKey}`
283
- : `file-fact store axis=bytes exceeded ${MAX_FILE_FACT_CONTENT_BYTES} retained content bytes; evicted least-recently-used fact for ${evictedKey}`);
284
- }
285
- // #2247 review F2: pinned bytes alone exceeding budget is not an eviction —
286
- // nothing is dropped — so it is reported through a distinct axis rather
287
- // than reusing `reportCapacityEviction`'s "evicted least-recently-used
288
- // fact for X" language, which would misdescribe what happened.
289
- reportPinnedOverBudget() {
290
- const pinnedBytes = this.pinnedContentBytesTotal;
291
- capacityEvictionReporter?.(this.subject, "pinned-over-budget", `file-fact store pinned content bytes (${pinnedBytes}) exceed the ` +
292
- `${MAX_FILE_FACT_CONTENT_BYTES}-byte budget; unpinned inserts are ` +
293
- `admitted without eviction until a pin releases`);
294
- }
295
- /** Running UTF-8 byte total for retained `file.content` values. Exposed so
296
- * tests can crosscheck it against a fresh sum over retained records
297
- * (#2247 review F3) — the running total is maintained incrementally on
298
- * every insert/delete path rather than recomputed, so a subtraction
299
- * dropped from one of those paths would otherwise drift silently. */
300
- getRetainedContentBytes() {
301
- return this.retainedContentBytes;
302
- }
303
- /** Running UTF-8 byte total for the pinned SUBSET of retained
304
- * `file.content` values. Exposed so tests can crosscheck it against a
305
- * fresh sum over `pinnedFiles ∩ fileFacts` (#2247 review F4) — like
306
- * `retainedContentBytes`, it is maintained incrementally on the pin
307
- * 0→1 transition, the unpin 1→0 transition, content overwrite/delete,
308
- * and `clearAll`, so a drop from any one of those paths would
309
- * otherwise drift silently instead of failing loudly. */
310
- getPinnedContentBytes() {
311
- return this.pinnedContentBytesTotal;
312
- }
313
- getSessionFact(factId) {
314
- return this.sessionFacts.get(factId);
315
- }
316
- setSessionFact(factId, value) {
317
- this.sessionFacts.set(factId, value);
318
- }
319
- hasSessionFact(factId) {
320
- return this.sessionFacts.has(factId);
321
- }
322
- /** Bounded counterpart to {@link getSessionFact} for per-file-keyed session
323
- * facts (#2282) — session baselines, cascade baselines, review-graph entity
324
- * snapshots. LRU touch: a read moves the record off the eviction end. */
325
- getBoundedSessionFact(factId) {
326
- if (!this.boundedSessionFacts.has(factId))
327
- return undefined;
328
- return this.boundedSessionFacts.get(factId);
329
- }
330
- /** Bounded counterpart to {@link setSessionFact}. Callers use this instead
331
- * of `setSessionFact` for any family that mints one key per file/entity
332
- * touched, so the store's count stays bounded across a large batch instead
333
- * of retaining one entry per distinct path for the process lifetime. */
334
- setBoundedSessionFact(factId, value) {
335
- this.evictedSessionFactKeys.delete(factId);
336
- const evicted = this.boundedSessionFacts.set(factId, value);
337
- for (const [oldestKey] of evicted) {
338
- this.evictedSessionFactKeys.add(oldestKey);
339
- while (this.evictedSessionFactKeys.size > MAX_SESSION_FACT_RECORDS) {
340
- const oldestTombstone = this.evictedSessionFactKeys
341
- .values()
342
- .next().value;
343
- if (oldestTombstone === undefined)
344
- break;
345
- this.evictedSessionFactKeys.delete(oldestTombstone);
346
- }
347
- capacityEvictionReporter?.(this.subject, "session-count", `session-fact store axis=count exceeded ${MAX_SESSION_FACT_RECORDS} records; evicted least-recently-used fact for ${oldestKey}`);
348
- }
349
- }
350
- hasBoundedSessionFact(factId) {
351
- return this.boundedSessionFacts.has(factId);
352
- }
353
- /** True when this key held a bounded session fact that capacity eviction
354
- * dropped and nothing has rewritten since (#2282). Readers whose "absent"
355
- * branch is not a safe default — the review-graph entity snapshot, where
356
- * absent would read as "every symbol is new" — use this to tell an evicted
357
- * key from one this session has never seen. */
358
- wasBoundedSessionFactEvicted(factId) {
359
- return this.evictedSessionFactKeys.has(factId);
360
- }
361
- /** O(1) entry count for memory-attribution sampling (#2282 Observability):
362
- * the fixed-vocabulary map plus the bounded per-file map, so a caller gets
363
- * this store's whole `sessionFacts` footprint in one number. */
364
- getSessionFactEntryCount() {
365
- return this.sessionFacts.size + this.boundedSessionFacts.size;
366
- }
367
- /** Call on session reset only. Clears everything including tool cache and baselines. */
368
- clearAll() {
369
- this.fileFacts.clear();
370
- this.sessionFacts.clear();
371
- this.boundedSessionFacts.clear();
372
- this.evictedSessionFactKeys.clear();
373
- this.pinnedFiles.clear();
374
- this.retainedContentBytes = 0;
375
- this.pinnedContentBytesTotal = 0;
376
- }
377
- }
@@ -1,22 +0,0 @@
1
- import { extractFactsFromTree, walk } from "./tree-sitter-facts.js";
2
- export const commentFactProvider = {
3
- id: "fact.file.comments",
4
- provides: ["file.comments"],
5
- requires: ["file.content"],
6
- appliesTo(ctx) {
7
- return /\.tsx?$/.test(ctx.filePath);
8
- },
9
- async run(ctx, store) {
10
- await extractFactsFromTree(ctx, store, { "file.comments": [] }, (root) => {
11
- // Tree-sitter attaches comments as `comment` nodes wherever they occur; a
12
- // pre-order walk yields them in source order (matching the old scanner pass).
13
- const comments = [];
14
- walk(root, (node) => {
15
- if (node.type === "comment") {
16
- comments.push({ line: node.startPosition.row + 1, text: node.text });
17
- }
18
- });
19
- return { "file.comments": comments };
20
- });
21
- },
22
- };
@@ -1,19 +0,0 @@
1
- import * as fs from "node:fs/promises";
2
- export const fileContentProvider = {
3
- id: "fact.file.content",
4
- provides: ["file.content"],
5
- requires: [],
6
- appliesTo(_ctx) {
7
- return true;
8
- },
9
- async run(ctx, store) {
10
- let content;
11
- try {
12
- content = await fs.readFile(ctx.filePath, "utf-8");
13
- }
14
- catch {
15
- content = null;
16
- }
17
- store.setFileFact(ctx.filePath, "file.content", content);
18
- },
19
- };