pi-lens 4.2.1 → 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 (671) hide show
  1. package/CHANGELOG.md +1562 -0
  2. package/README.md +157 -24
  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 +19039 -8956
  125. package/dist/mcp/analyze-cli.js +186 -228
  126. package/dist/mcp/cli.js +137 -98
  127. package/dist/mcp/server.js +22592 -1564
  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/adr/0001-stale-advisory-live-arm.md +29 -0
  133. package/docs/adr/0002-workspace-hash-rendezvous.md +30 -0
  134. package/docs/adr/0003-git-guard-latch-writer.md +203 -0
  135. package/docs/adr/0004-disposition-policy-seam.md +38 -0
  136. package/docs/adr/0005-tool-availability-enforcement-seam.md +29 -0
  137. package/docs/adr/0006-derived-state-benchmark-first.md +31 -0
  138. package/docs/adr/0007-end-to-end-witness-per-seam-slice.md +38 -0
  139. package/docs/adr/0008-turn-end-lane-interface.md +165 -0
  140. package/docs/adr/0009-reported-path-attribution.md +114 -0
  141. package/docs/adr/README.md +26 -0
  142. package/docs/agent-guide.md +13 -4
  143. package/docs/agent-tools.md +60 -1
  144. package/docs/ast-grep_rules_catalog.md +6 -4
  145. package/docs/configuration.md +75 -2
  146. package/docs/engineering-principles.md +202 -0
  147. package/docs/environment-variables.md +113 -6
  148. package/docs/features.md +10 -6
  149. package/docs/globalconfig.md +7 -1
  150. package/docs/io-bridge-v2-migration.md +94 -0
  151. package/docs/language-coverage.md +17 -0
  152. package/docs/lsp-capability-matrix.md +131 -32
  153. package/docs/lsp-idle-eviction.md +124 -0
  154. package/docs/mcp.md +21 -5
  155. package/docs/merge-queue-rollout.md +77 -0
  156. package/docs/pi-lens-fixer.md +161 -39
  157. package/docs/pi-lens-investigator.md +77 -20
  158. package/docs/pi-lens-merge-policy.md +694 -0
  159. package/docs/pi-lens-monitor.md +73 -7
  160. package/docs/pi-lens-retro.md +6 -4
  161. package/docs/pi-lens-reviewer.md +190 -34
  162. package/docs/pi-lens-subagent.md +247 -37
  163. package/docs/pi-lens-warden.md +18 -7
  164. package/docs/public-api-stability.md +56 -0
  165. package/docs/release-qa-baseline.md +86 -17
  166. package/docs/rfcs/3654-unified-io-bridge-v2.md +316 -0
  167. package/docs/servercapabilities.md +66 -52
  168. package/docs/settings.md +13 -3
  169. package/docs/subagent-compat.md +1 -1
  170. package/docs/usage.md +5 -1
  171. package/grammars/tree-sitter-bash.wasm +0 -0
  172. package/grammars/tree-sitter-bash.wasm.json +3 -3
  173. package/package.json +23 -9
  174. package/rules/ast-grep-rules/rule-tests/advisory-registry-subset-test.yml +41 -0
  175. package/rules/ast-grep-rules/rule-tests/no-assert-tuple-test.yml +13 -0
  176. package/rules/ast-grep-rules/rule-tests/no-boolean-in-except-test.yml +26 -0
  177. package/rules/ast-grep-rules/rule-tests/no-http-headers-bracket-access-test.yml +10 -0
  178. package/rules/ast-grep-rules/rule-tests/unchecked-numeric-parse-python-test.yml +18 -0
  179. package/rules/ast-grep-rules/rule-tests/unchecked-throwing-call-python-test.yml +4 -3
  180. package/rules/ast-grep-rules/rules/advisory-registry-subset.yml +50 -0
  181. package/rules/ast-grep-rules/rules/go-no-fmt-println.yml +2 -2
  182. package/rules/ast-grep-rules/rules/no-assert-tuple.yml +23 -13
  183. package/rules/ast-grep-rules/rules/no-boolean-in-except.yml +7 -3
  184. package/rules/ast-grep-rules/rules/no-console-except-error-js.yml +2 -2
  185. package/rules/ast-grep-rules/rules/no-console-except-error.yml +2 -2
  186. package/rules/ast-grep-rules/rules/no-http-headers-bracket-access.yml +12 -7
  187. package/rules/ast-grep-rules/rules/unchecked-numeric-parse-python.yml +44 -0
  188. package/rules/ast-grep-rules/rules/unchecked-throwing-call-python.yml +5 -3
  189. package/rules/tree-sitter-queries/typescript/console-statement.yml +2 -2
  190. package/scripts/analyze-pi-lens-logs.mjs +1275 -62
  191. package/scripts/download-grammars.js +5 -0
  192. package/scripts/grammars.lock.json +6 -1
  193. package/scripts/install-selftest.mjs +38 -35
  194. package/scripts/lib/host-provided-deps.mjs +13 -4
  195. package/scripts/lib/web-tree-sitter-dir.mjs +141 -0
  196. package/dist/clients/actionable-warnings-logger.js +0 -35
  197. package/dist/clients/actionable-warnings.js +0 -1594
  198. package/dist/clients/advisory-provenance.js +0 -457
  199. package/dist/clients/agent-behavior-client.js +0 -147
  200. package/dist/clients/agent-nudge.js +0 -325
  201. package/dist/clients/analysed-root.js +0 -1
  202. package/dist/clients/ast-grep-client.js +0 -731
  203. package/dist/clients/ast-grep-rule-manager.js +0 -146
  204. package/dist/clients/ast-grep-tool-logger.js +0 -118
  205. package/dist/clients/ast-grep-types.js +0 -10
  206. package/dist/clients/ast-grep-yaml-synth.js +0 -154
  207. package/dist/clients/atomic-write-staging.js +0 -75
  208. package/dist/clients/atomic-write.js +0 -189
  209. package/dist/clients/availability-probe-flight.js +0 -12
  210. package/dist/clients/bash-file-access.js +0 -1056
  211. package/dist/clients/biome-client.js +0 -357
  212. package/dist/clients/blocker-freshness.js +0 -837
  213. package/dist/clients/blocker-past-eof.js +0 -129
  214. package/dist/clients/bootstrap.js +0 -569
  215. package/dist/clients/bounded-cache.js +0 -190
  216. package/dist/clients/bounded-pid-file-lock.js +0 -202
  217. package/dist/clients/bounded-telemetry.js +0 -295
  218. package/dist/clients/build-identity.js +0 -95
  219. package/dist/clients/bundled-resource-health.js +0 -113
  220. package/dist/clients/bus-events-logger.js +0 -105
  221. package/dist/clients/bus-publish.js +0 -171
  222. package/dist/clients/cache/rule-cache.js +0 -190
  223. package/dist/clients/cache-manager.js +0 -465
  224. package/dist/clients/cache-observability.js +0 -1313
  225. package/dist/clients/call-graph.js +0 -852
  226. package/dist/clients/cargo-manifest.js +0 -422
  227. package/dist/clients/cascade-budget.js +0 -196
  228. package/dist/clients/cascade-format.js +0 -315
  229. package/dist/clients/cascade-logger.js +0 -31
  230. package/dist/clients/cascade-types.js +0 -9
  231. package/dist/clients/child-unref.js +0 -115
  232. package/dist/clients/code-quality-warnings.js +0 -286
  233. package/dist/clients/codebase-model.js +0 -173
  234. package/dist/clients/collateral-test-role.js +0 -40
  235. package/dist/clients/complexity-client.js +0 -462
  236. package/dist/clients/config-core/deny.js +0 -221
  237. package/dist/clients/config-core/index.js +0 -50
  238. package/dist/clients/config-core/merge.js +0 -357
  239. package/dist/clients/config-core/normalize.js +0 -340
  240. package/dist/clients/config-core/process-spec.js +0 -248
  241. package/dist/clients/config-core/provenance.js +0 -164
  242. package/dist/clients/config-core/records.js +0 -218
  243. package/dist/clients/config-core/resolve.js +0 -125
  244. package/dist/clients/config-core/safe-object.js +0 -78
  245. package/dist/clients/config-core/schema.js +0 -165
  246. package/dist/clients/config-diagnostic-codes.js +0 -283
  247. package/dist/clients/config-locations.js +0 -160
  248. package/dist/clients/config-resolve.js +0 -792
  249. package/dist/clients/config-schema.js +0 -251
  250. package/dist/clients/config-warn.js +0 -407
  251. package/dist/clients/console-guard-install.js +0 -26
  252. package/dist/clients/cooperative-budget.js +0 -42
  253. package/dist/clients/dead-code-client.js +0 -510
  254. package/dist/clients/dead-code-logger.js +0 -30
  255. package/dist/clients/deadline-utils.js +0 -280
  256. package/dist/clients/debug-handles.js +0 -211
  257. package/dist/clients/debug-heap.js +0 -174
  258. package/dist/clients/deferred-lsp-work.js +0 -106
  259. package/dist/clients/degradation-ledger.js +0 -396
  260. package/dist/clients/demoted-finding-render.js +0 -169
  261. package/dist/clients/dependency-checker.js +0 -862
  262. package/dist/clients/deps/ast-grep-napi.js +0 -22
  263. package/dist/clients/deps/js-yaml.js +0 -9
  264. package/dist/clients/deps/minimatch.js +0 -4
  265. package/dist/clients/deps/pi-tui.js +0 -14
  266. package/dist/clients/deps/typebox.js +0 -14
  267. package/dist/clients/deps/vscode-jsonrpc.js +0 -1
  268. package/dist/clients/deps/web-tree-sitter.js +0 -24
  269. package/dist/clients/diagnostic-dispositions.js +0 -594
  270. package/dist/clients/diagnostic-line-freshness.js +0 -305
  271. package/dist/clients/diagnostic-logger.js +0 -73
  272. package/dist/clients/diagnostic-tracker.js +0 -105
  273. package/dist/clients/diagnostics-publish.js +0 -230
  274. package/dist/clients/dispatch/ast-grep-catalog.js +0 -65
  275. package/dist/clients/dispatch/auxiliary-lsp.js +0 -343
  276. package/dist/clients/dispatch/collect-later-tier.js +0 -35
  277. package/dist/clients/dispatch/diagnostic-taxonomy.js +0 -66
  278. package/dist/clients/dispatch/dispatcher.js +0 -1269
  279. package/dist/clients/dispatch/fact-provider-types.js +0 -1
  280. package/dist/clients/dispatch/fact-rule-runner.js +0 -17
  281. package/dist/clients/dispatch/fact-runner.js +0 -30
  282. package/dist/clients/dispatch/fact-scheduler.js +0 -68
  283. package/dist/clients/dispatch/fact-store.js +0 -377
  284. package/dist/clients/dispatch/facts/comment-facts.js +0 -22
  285. package/dist/clients/dispatch/facts/file-content.js +0 -19
  286. package/dist/clients/dispatch/facts/function-facts.js +0 -348
  287. package/dist/clients/dispatch/facts/import-facts.js +0 -204
  288. package/dist/clients/dispatch/facts/tree-sitter-facts.js +0 -34
  289. package/dist/clients/dispatch/facts/try-catch-facts.js +0 -119
  290. package/dist/clients/dispatch/finding-policy.js +0 -222
  291. package/dist/clients/dispatch/indent-detect.js +0 -411
  292. package/dist/clients/dispatch/inline-suppressions.js +0 -70
  293. package/dist/clients/dispatch/integration.js +0 -2377
  294. package/dist/clients/dispatch/lazy.js +0 -11
  295. package/dist/clients/dispatch/pending-runner-findings.js +0 -87
  296. package/dist/clients/dispatch/plan.js +0 -278
  297. package/dist/clients/dispatch/priorities.js +0 -20
  298. package/dist/clients/dispatch/rule-id-normalize.js +0 -50
  299. package/dist/clients/dispatch/rule-ignores.js +0 -62
  300. package/dist/clients/dispatch/rule-policy.js +0 -135
  301. package/dist/clients/dispatch/rules/async-noise.js +0 -40
  302. package/dist/clients/dispatch/rules/async-unnecessary-wrapper.js +0 -27
  303. package/dist/clients/dispatch/rules/cors-wildcard.js +0 -54
  304. package/dist/clients/dispatch/rules/error-obscuring.js +0 -32
  305. package/dist/clients/dispatch/rules/error-swallowing.js +0 -31
  306. package/dist/clients/dispatch/rules/framework-call-noise.js +0 -67
  307. package/dist/clients/dispatch/rules/high-complexity.js +0 -72
  308. package/dist/clients/dispatch/rules/high-fan-out.js +0 -74
  309. package/dist/clients/dispatch/rules/high-import-coupling.js +0 -37
  310. package/dist/clients/dispatch/rules/missing-error-propagation.js +0 -62
  311. package/dist/clients/dispatch/rules/no-commented-credentials.js +0 -52
  312. package/dist/clients/dispatch/rules/pass-through-wrappers.js +0 -42
  313. package/dist/clients/dispatch/rules/placeholder-comments.js +0 -40
  314. package/dist/clients/dispatch/rules/unsafe-boundary.js +0 -126
  315. package/dist/clients/dispatch/runner-context.js +0 -52
  316. package/dist/clients/dispatch/runners/actionlint.js +0 -113
  317. package/dist/clients/dispatch/runners/ast-grep-napi.js +0 -1196
  318. package/dist/clients/dispatch/runners/biome-check.js +0 -283
  319. package/dist/clients/dispatch/runners/cpp-check.js +0 -236
  320. package/dist/clients/dispatch/runners/credo.js +0 -80
  321. package/dist/clients/dispatch/runners/cue-vet.js +0 -398
  322. package/dist/clients/dispatch/runners/dart-analyze.js +0 -202
  323. package/dist/clients/dispatch/runners/detekt.js +0 -169
  324. package/dist/clients/dispatch/runners/dotnet-build.js +0 -159
  325. package/dist/clients/dispatch/runners/elixir-check.js +0 -210
  326. package/dist/clients/dispatch/runners/eslint.js +0 -154
  327. package/dist/clients/dispatch/runners/fact-rules.js +0 -29
  328. package/dist/clients/dispatch/runners/fish-indent.js +0 -69
  329. package/dist/clients/dispatch/runners/gleam-check.js +0 -87
  330. package/dist/clients/dispatch/runners/go-vet.js +0 -90
  331. package/dist/clients/dispatch/runners/golangci-lint.js +0 -120
  332. package/dist/clients/dispatch/runners/hadolint.js +0 -79
  333. package/dist/clients/dispatch/runners/helm-lint.js +0 -171
  334. package/dist/clients/dispatch/runners/helm-render.js +0 -940
  335. package/dist/clients/dispatch/runners/htmlhint.js +0 -108
  336. package/dist/clients/dispatch/runners/index.js +0 -108
  337. package/dist/clients/dispatch/runners/javac.js +0 -89
  338. package/dist/clients/dispatch/runners/ktlint.js +0 -136
  339. package/dist/clients/dispatch/runners/lsp.js +0 -378
  340. package/dist/clients/dispatch/runners/markdownlint.js +0 -160
  341. package/dist/clients/dispatch/runners/mypy.js +0 -101
  342. package/dist/clients/dispatch/runners/oxlint.js +0 -398
  343. package/dist/clients/dispatch/runners/php-lint.js +0 -62
  344. package/dist/clients/dispatch/runners/phpstan.js +0 -120
  345. package/dist/clients/dispatch/runners/prisma-validate.js +0 -62
  346. package/dist/clients/dispatch/runners/psscriptanalyzer.js +0 -445
  347. package/dist/clients/dispatch/runners/pyright.js +0 -169
  348. package/dist/clients/dispatch/runners/rubocop.js +0 -90
  349. package/dist/clients/dispatch/runners/ruff.js +0 -89
  350. package/dist/clients/dispatch/runners/rust-clippy.js +0 -251
  351. package/dist/clients/dispatch/runners/shellcheck.js +0 -169
  352. package/dist/clients/dispatch/runners/shfmt.js +0 -102
  353. package/dist/clients/dispatch/runners/spellcheck.js +0 -121
  354. package/dist/clients/dispatch/runners/spotbugs.js +0 -259
  355. package/dist/clients/dispatch/runners/sqlfluff.js +0 -174
  356. package/dist/clients/dispatch/runners/stylelint.js +0 -158
  357. package/dist/clients/dispatch/runners/swiftlint.js +0 -154
  358. package/dist/clients/dispatch/runners/taplo.js +0 -168
  359. package/dist/clients/dispatch/runners/terragrunt.js +0 -168
  360. package/dist/clients/dispatch/runners/tflint.js +0 -110
  361. package/dist/clients/dispatch/runners/tree-sitter.js +0 -620
  362. package/dist/clients/dispatch/runners/trivy-config.js +0 -247
  363. package/dist/clients/dispatch/runners/utils/availability-policy.js +0 -496
  364. package/dist/clients/dispatch/runners/utils/candidate-probe.js +0 -90
  365. package/dist/clients/dispatch/runners/utils/diagnostic-parsers.js +0 -85
  366. package/dist/clients/dispatch/runners/utils/lazy-installer.js +0 -274
  367. package/dist/clients/dispatch/runners/utils/runner-helpers.js +0 -1701
  368. package/dist/clients/dispatch/runners/utils/spawn-outcome.js +0 -101
  369. package/dist/clients/dispatch/runners/utils/tool-failure.js +0 -235
  370. package/dist/clients/dispatch/runners/utils/toolchain-availability.js +0 -169
  371. package/dist/clients/dispatch/runners/utils.js +0 -15
  372. package/dist/clients/dispatch/runners/vale.js +0 -116
  373. package/dist/clients/dispatch/runners/yaml-rule-parser.js +0 -242
  374. package/dist/clients/dispatch/runners/yamllint.js +0 -85
  375. package/dist/clients/dispatch/runners/zig-check.js +0 -91
  376. package/dist/clients/dispatch/suppress-writer.js +0 -69
  377. package/dist/clients/dispatch/tool-profile.js +0 -30
  378. package/dist/clients/dispatch/types.js +0 -21
  379. package/dist/clients/dispatch/utils/format-utils.js +0 -45
  380. package/dist/clients/dispatch/utils/lsp-diagnostics.js +0 -35
  381. package/dist/clients/disposition-logger.js +0 -32
  382. package/dist/clients/disposition-publish.js +0 -124
  383. package/dist/clients/durable-store.js +0 -97
  384. package/dist/clients/effective-config.js +0 -413
  385. package/dist/clients/env-utils.js +0 -83
  386. package/dist/clients/error-class.js +0 -23
  387. package/dist/clients/eval-timestamp.js +0 -17
  388. package/dist/clients/event-loop-hold.js +0 -274
  389. package/dist/clients/event-loop-monitor.js +0 -250
  390. package/dist/clients/extension-log.js +0 -504
  391. package/dist/clients/extension-mode.js +0 -73
  392. package/dist/clients/feature-hints.js +0 -103
  393. package/dist/clients/file-kinds.js +0 -412
  394. package/dist/clients/file-role.js +0 -134
  395. package/dist/clients/file-time.js +0 -160
  396. package/dist/clients/file-utils.js +0 -1032
  397. package/dist/clients/finding-delivery-gate.js +0 -463
  398. package/dist/clients/finding-identity.js +0 -88
  399. package/dist/clients/fix-worklog.js +0 -103
  400. package/dist/clients/format-events-publish.js +0 -343
  401. package/dist/clients/format-service.js +0 -222
  402. package/dist/clients/formatters-lazy.js +0 -9
  403. package/dist/clients/formatters.js +0 -1994
  404. package/dist/clients/freshness-cadence.js +0 -17
  405. package/dist/clients/freshness.js +0 -38
  406. package/dist/clients/generated-artifacts.js +0 -394
  407. package/dist/clients/generation-guard.js +0 -215
  408. package/dist/clients/git-guard.js +0 -923
  409. package/dist/clients/git-tracked-ignore.js +0 -243
  410. package/dist/clients/gitleaks-client.js +0 -509
  411. package/dist/clients/go-client.js +0 -104
  412. package/dist/clients/govulncheck-client.js +0 -605
  413. package/dist/clients/gradle-ktfmt-style.js +0 -252
  414. package/dist/clients/grammar-source.js +0 -465
  415. package/dist/clients/gzip-stage-write.js +0 -135
  416. package/dist/clients/hashline-anchor.js +0 -424
  417. package/dist/clients/hook-budgets.js +0 -76
  418. package/dist/clients/host-edit-normalize.js +0 -140
  419. package/dist/clients/host-ports.js +0 -39
  420. package/dist/clients/indent-retarget.js +0 -154
  421. package/dist/clients/install-diagnostics.js +0 -143
  422. package/dist/clients/installer/index.js +0 -5167
  423. package/dist/clients/installer/managed-tool-refresh-session.js +0 -58
  424. package/dist/clients/installer/managed-tool-refresh.js +0 -783
  425. package/dist/clients/instance-reaper-state.js +0 -7
  426. package/dist/clients/instance-reaper.js +0 -1137
  427. package/dist/clients/instance-registry-lock.js +0 -145
  428. package/dist/clients/instance-registry.js +0 -773
  429. package/dist/clients/jscpd-client.js +0 -370
  430. package/dist/clients/json-cache-read.js +0 -65
  431. package/dist/clients/knip-client.js +0 -788
  432. package/dist/clients/language-policy.js +0 -252
  433. package/dist/clients/language-profile.js +0 -361
  434. package/dist/clients/language-registry.js +0 -603
  435. package/dist/clients/latency-logger.js +0 -719
  436. package/dist/clients/lazy-import.js +0 -21
  437. package/dist/clients/ledger-bounds.js +0 -54
  438. package/dist/clients/lens-config.js +0 -346
  439. package/dist/clients/lens-engine.js +0 -358
  440. package/dist/clients/lens-events.js +0 -125
  441. package/dist/clients/lens-flag-registry.js +0 -467
  442. package/dist/clients/lens-map.js +0 -1156
  443. package/dist/clients/live-bus-emitter.js +0 -74
  444. package/dist/clients/log-cleanup.js +0 -222
  445. package/dist/clients/lsp/aggregation.js +0 -178
  446. package/dist/clients/lsp/cascade-tier.js +0 -421
  447. package/dist/clients/lsp/client.js +0 -4465
  448. package/dist/clients/lsp/config.js +0 -689
  449. package/dist/clients/lsp/diagnostic-binding.js +0 -225
  450. package/dist/clients/lsp/document-drift.js +0 -467
  451. package/dist/clients/lsp/edits.js +0 -1219
  452. package/dist/clients/lsp/index.js +0 -8305
  453. package/dist/clients/lsp/inferred-project.js +0 -216
  454. package/dist/clients/lsp/jvm-runtime.js +0 -298
  455. package/dist/clients/lsp/language.js +0 -63
  456. package/dist/clients/lsp/launch.js +0 -725
  457. package/dist/clients/lsp/lombok.js +0 -158
  458. package/dist/clients/lsp/path-utils.js +0 -5
  459. package/dist/clients/lsp/pending-aux-coverage.js +0 -251
  460. package/dist/clients/lsp/position-encoding.js +0 -61
  461. package/dist/clients/lsp/ruby-drive-dirs.js +0 -83
  462. package/dist/clients/lsp/server.js +0 -3209
  463. package/dist/clients/lsp/session-roots.js +0 -192
  464. package/dist/clients/lsp/spawn-history.js +0 -17
  465. package/dist/clients/lsp/sync-kind.js +0 -42
  466. package/dist/clients/lsp/tsserver-sync.js +0 -332
  467. package/dist/clients/lsp/wait-policy/capability-snapshot.js +0 -1
  468. package/dist/clients/lsp/wait-policy/classification.js +0 -85
  469. package/dist/clients/lsp/wait-policy/index.js +0 -10
  470. package/dist/clients/lsp/wait-policy/strategies.js +0 -303
  471. package/dist/clients/lsp/watch-queue.js +0 -61
  472. package/dist/clients/lsp/workspace-diagnostics-cache.js +0 -639
  473. package/dist/clients/lsp/workspace-diagnostics-session.js +0 -30
  474. package/dist/clients/lsp/workspace-sweep-hold.js +0 -184
  475. package/dist/clients/lsp-budget.js +0 -186
  476. package/dist/clients/lsp-document-symbols.js +0 -110
  477. package/dist/clients/lsp-lazy.js +0 -9
  478. package/dist/clients/lsp-mutation.js +0 -396
  479. package/dist/clients/lsp-status.js +0 -59
  480. package/dist/clients/map-with-concurrency.js +0 -40
  481. package/dist/clients/mcp/analyze.js +0 -420
  482. package/dist/clients/mcp/host-shim.js +0 -31
  483. package/dist/clients/mcp/ipc.js +0 -335
  484. package/dist/clients/mcp/review.js +0 -151
  485. package/dist/clients/mcp/session.js +0 -412
  486. package/dist/clients/memory-sampler.js +0 -208
  487. package/dist/clients/message-end-attribution.js +0 -30
  488. package/dist/clients/metrics-client.js +0 -107
  489. package/dist/clients/metrics-history.js +0 -327
  490. package/dist/clients/middle-man-analysis.js +0 -263
  491. package/dist/clients/model-provider.js +0 -53
  492. package/dist/clients/module-report-lsp.js +0 -189
  493. package/dist/clients/module-report.js +0 -2150
  494. package/dist/clients/mutating-tool.js +0 -651
  495. package/dist/clients/mutation-attribution.js +0 -368
  496. package/dist/clients/mutation-bridge.js +0 -240
  497. package/dist/clients/ndjson-logger.js +0 -734
  498. package/dist/clients/observed-mutation-sources.js +0 -101
  499. package/dist/clients/observed-mutation.js +0 -1253
  500. package/dist/clients/oldtext-autopatch.js +0 -128
  501. package/dist/clients/opaque-mutation-scan.js +0 -496
  502. package/dist/clients/opengrep-client.js +0 -328
  503. package/dist/clients/opengrep-config.js +0 -76
  504. package/dist/clients/package-manager.js +0 -607
  505. package/dist/clients/package-root.js +0 -38
  506. package/dist/clients/partial-edit-apply.js +0 -439
  507. package/dist/clients/path-attribution-telemetry.js +0 -43
  508. package/dist/clients/path-keyed-map.js +0 -108
  509. package/dist/clients/path-utils.js +0 -1244
  510. package/dist/clients/performance-report.js +0 -331
  511. package/dist/clients/persist-debounce.js +0 -70
  512. package/dist/clients/persistent-reverify.js +0 -271
  513. package/dist/clients/php-cs-fixer-config.js +0 -119
  514. package/dist/clients/pipeline.js +0 -1425
  515. package/dist/clients/post-autofix-notice.js +0 -37
  516. package/dist/clients/print-mode.js +0 -21
  517. package/dist/clients/probe-home-state.js +0 -228
  518. package/dist/clients/process-bridge.js +0 -66
  519. package/dist/clients/process-singletons.js +0 -210
  520. package/dist/clients/process-snapshot.js +0 -68
  521. package/dist/clients/project-changes.js +0 -181
  522. package/dist/clients/project-conventions.js +0 -171
  523. package/dist/clients/project-diagnostics/cache.js +0 -137
  524. package/dist/clients/project-diagnostics/extractors.js +0 -109
  525. package/dist/clients/project-diagnostics/fresh-fetch.js +0 -650
  526. package/dist/clients/project-diagnostics/runner-adapters/call-graph-impact.js +0 -118
  527. package/dist/clients/project-diagnostics/runner-adapters/dead-code.js +0 -47
  528. package/dist/clients/project-diagnostics/runner-adapters/gitleaks.js +0 -40
  529. package/dist/clients/project-diagnostics/runner-adapters/govulncheck.js +0 -34
  530. package/dist/clients/project-diagnostics/runner-adapters/jscpd.js +0 -38
  531. package/dist/clients/project-diagnostics/runner-adapters/knip.js +0 -47
  532. package/dist/clients/project-diagnostics/runner-adapters/madge.js +0 -48
  533. package/dist/clients/project-diagnostics/runner-adapters/opengrep.js +0 -40
  534. package/dist/clients/project-diagnostics/runner-adapters/runner-findings.js +0 -127
  535. package/dist/clients/project-diagnostics/runner-adapters/trivy.js +0 -81
  536. package/dist/clients/project-diagnostics/scanner.js +0 -520
  537. package/dist/clients/project-diagnostics/types.js +0 -1
  538. package/dist/clients/project-lens-config.js +0 -799
  539. package/dist/clients/project-report.js +0 -701
  540. package/dist/clients/project-scale.js +0 -237
  541. package/dist/clients/project-scan-policy.js +0 -11
  542. package/dist/clients/project-snapshot-fingerprint.js +0 -48
  543. package/dist/clients/project-snapshot-persist-worker.js +0 -20
  544. package/dist/clients/project-snapshot.js +0 -1653
  545. package/dist/clients/project-trust.js +0 -181
  546. package/dist/clients/python-environment.js +0 -217
  547. package/dist/clients/python-provenance.js +0 -639
  548. package/dist/clients/quiet-window-config.js +0 -47
  549. package/dist/clients/quiet-window.js +0 -236
  550. package/dist/clients/read-bridge.js +0 -139
  551. package/dist/clients/read-expansion.js +0 -266
  552. package/dist/clients/read-guard-logger.js +0 -251
  553. package/dist/clients/read-guard-tool-lines.js +0 -1306
  554. package/dist/clients/read-guard.js +0 -1561
  555. package/dist/clients/recent-touches.js +0 -240
  556. package/dist/clients/redact/secrets.js +0 -449
  557. package/dist/clients/resource-sampler.js +0 -628
  558. package/dist/clients/reverse-deps.js +0 -270
  559. package/dist/clients/review-graph/builder.js +0 -5118
  560. package/dist/clients/review-graph/format.js +0 -33
  561. package/dist/clients/review-graph/git-identity.js +0 -157
  562. package/dist/clients/review-graph/import-resolvers.js +0 -481
  563. package/dist/clients/review-graph/persist-worker.js +0 -10
  564. package/dist/clients/review-graph/query.js +0 -244
  565. package/dist/clients/review-graph/revision-drift.js +0 -21
  566. package/dist/clients/review-graph/service.js +0 -96
  567. package/dist/clients/review-graph/shared-extraction-ir.js +0 -82
  568. package/dist/clients/review-graph/symbol-id.js +0 -103
  569. package/dist/clients/review-graph/tsconfig-paths.js +0 -299
  570. package/dist/clients/review-graph/types.js +0 -1
  571. package/dist/clients/review-graph/workspace-modules.js +0 -449
  572. package/dist/clients/review-graph-logger.js +0 -81
  573. package/dist/clients/ruff-client.js +0 -152
  574. package/dist/clients/rules-scanner.js +0 -131
  575. package/dist/clients/run-duration.js +0 -55
  576. package/dist/clients/runtime-agent-end.js +0 -746
  577. package/dist/clients/runtime-config.js +0 -77
  578. package/dist/clients/runtime-context.js +0 -211
  579. package/dist/clients/runtime-coordinator.js +0 -1290
  580. package/dist/clients/runtime-session.js +0 -2485
  581. package/dist/clients/runtime-tool-call.js +0 -1284
  582. package/dist/clients/runtime-tool-result.js +0 -2034
  583. package/dist/clients/runtime-turn.js +0 -3600
  584. package/dist/clients/rust-client.js +0 -97
  585. package/dist/clients/safe-spawn.js +0 -2166
  586. package/dist/clients/sanitize.js +0 -286
  587. package/dist/clients/scan-utils.js +0 -25
  588. package/dist/clients/scratch-tree-policy.js +0 -165
  589. package/dist/clients/search-read-registration.js +0 -94
  590. package/dist/clients/secret-findings.js +0 -114
  591. package/dist/clients/security-scan-client.js +0 -352
  592. package/dist/clients/session-event-guard.js +0 -297
  593. package/dist/clients/session-lifecycle.js +0 -484
  594. package/dist/clients/session-start-observability.js +0 -94
  595. package/dist/clients/session-state-store.js +0 -101
  596. package/dist/clients/session-summary.js +0 -15
  597. package/dist/clients/sessionstart-logger.js +0 -27
  598. package/dist/clients/sg-runner.js +0 -876
  599. package/dist/clients/sgconfig.js +0 -347
  600. package/dist/clients/shared-checkout-guard.js +0 -338
  601. package/dist/clients/single-flight.js +0 -158
  602. package/dist/clients/situational-tool-telemetry.js +0 -108
  603. package/dist/clients/skills-resolver.js +0 -141
  604. package/dist/clients/slow-fs.js +0 -138
  605. package/dist/clients/smells-rollup.js +0 -231
  606. package/dist/clients/source-filter.js +0 -596
  607. package/dist/clients/source-walker.js +0 -211
  608. package/dist/clients/spawn-output-cap.js +0 -37
  609. package/dist/clients/spawn-timeout-cooldown.js +0 -110
  610. package/dist/clients/stale-marker.js +0 -17
  611. package/dist/clients/startup-scan.js +0 -400
  612. package/dist/clients/startup-timing.js +0 -130
  613. package/dist/clients/string-utils.js +0 -33
  614. package/dist/clients/subagent-mode.js +0 -111
  615. package/dist/clients/symbol-containment.js +0 -24
  616. package/dist/clients/symbol-types.js +0 -5
  617. package/dist/clients/test-runner-client.js +0 -2507
  618. package/dist/clients/test-runner-delivery.js +0 -287
  619. package/dist/clients/todo-scanner.js +0 -229
  620. package/dist/clients/tool-agreement.js +0 -423
  621. package/dist/clients/tool-config.js +0 -249
  622. package/dist/clients/tool-cwd.js +0 -270
  623. package/dist/clients/tool-definition.js +0 -47
  624. package/dist/clients/tool-event.js +0 -105
  625. package/dist/clients/tool-policy.js +0 -2755
  626. package/dist/clients/tool-probe.js +0 -53
  627. package/dist/clients/tool-render.js +0 -156
  628. package/dist/clients/tool-set-policy.js +0 -118
  629. package/dist/clients/tree-sitter-cache.js +0 -364
  630. package/dist/clients/tree-sitter-client.js +0 -4134
  631. package/dist/clients/tree-sitter-logger.js +0 -100
  632. package/dist/clients/tree-sitter-navigator.js +0 -269
  633. package/dist/clients/tree-sitter-query-loader.js +0 -569
  634. package/dist/clients/tree-sitter-shared.js +0 -158
  635. package/dist/clients/tree-sitter-symbol-extractor.js +0 -1265
  636. package/dist/clients/trivy-client.js +0 -467
  637. package/dist/clients/tui-fit.js +0 -50
  638. package/dist/clients/turn-context.js +0 -52
  639. package/dist/clients/turn-summary-render.js +0 -72
  640. package/dist/clients/turn-summary.js +0 -132
  641. package/dist/clients/typos-config.js +0 -29
  642. package/dist/clients/user-notify.js +0 -51
  643. package/dist/clients/vanished-instance-marker.js +0 -57
  644. package/dist/clients/warm-attach.js +0 -246
  645. package/dist/clients/widget-state.js +0 -1677
  646. package/dist/clients/word-index-logger.js +0 -49
  647. package/dist/clients/word-index-store.js +0 -459
  648. package/dist/clients/word-index.js +0 -2080
  649. package/dist/clients/workspace-topology.js +0 -389
  650. package/dist/clients/write-ordering-guard.js +0 -65
  651. package/dist/clients/zizmor-config.js +0 -327
  652. package/dist/i18n.js +0 -69
  653. package/dist/mcp/build-staleness.js +0 -124
  654. package/dist/scripts/lib/process-scan.mjs +0 -583
  655. package/dist/scripts/lib/skills-predicate.mjs +0 -129
  656. package/dist/tools/activate-tools.js +0 -87
  657. package/dist/tools/ast-grep-outline.js +0 -137
  658. package/dist/tools/ast-grep-replace.js +0 -244
  659. package/dist/tools/ast-grep-search.js +0 -762
  660. package/dist/tools/effective-config.js +0 -90
  661. package/dist/tools/lens-diagnostic-mark.js +0 -375
  662. package/dist/tools/lens-diagnostics.js +0 -2544
  663. package/dist/tools/lsp-diagnostics.js +0 -1634
  664. package/dist/tools/lsp-navigation.js +0 -1367
  665. package/dist/tools/lsp-structured-output.js +0 -294
  666. package/dist/tools/module-report.js +0 -382
  667. package/dist/tools/project-report.js +0 -86
  668. package/dist/tools/render-compact.js +0 -374
  669. package/dist/tools/scan-progress.js +0 -53
  670. package/dist/tools/shared.js +0 -29
  671. package/dist/tools/symbol-search.js +0 -155
@@ -1,462 +0,0 @@
1
- /**
2
- * Complexity Metrics Client for pi-lens
3
- *
4
- * Language-agnostic AST-based code complexity metrics, computed over the shared
5
- * tree-sitter client (#402 — no `typescript` compiler dependency). Supported
6
- * grammars are keyed in LANGUAGE_NODES (JS/TS, Python, Go, Rust today; adding a
7
- * language is one table entry).
8
- *
9
- * Tracks: max nesting depth, function length, cyclomatic + cognitive complexity,
10
- * maintainability index (Halstead-free), LOC/comments, code entropy, and AI-slop
11
- * indicators. These are silent metrics surfaced in the session summary.
12
- */
13
- import { createSubsystemLogger } from "./extension-log.js";
14
- import * as fs from "node:fs";
15
- import * as path from "node:path";
16
- import { calcCyclomaticComplexity } from "./dispatch/facts/function-facts.js";
17
- import { firstChildOfType, withTreeSitterRoot, isComplexityLanguageId, isComplexitySupportedFile, resolveTreeSitterLanguage, walk, } from "./tree-sitter-shared.js";
18
- // JS/TS/JSX share one grammar shape.
19
- const JSTS = {
20
- functionLike: new Set([
21
- "function_declaration",
22
- "method_definition",
23
- "function_expression",
24
- "arrow_function",
25
- "generator_function",
26
- "generator_function_declaration",
27
- ]),
28
- nesting: new Set([
29
- "if_statement",
30
- "while_statement",
31
- "for_statement",
32
- "for_in_statement",
33
- "switch_statement",
34
- "function_declaration",
35
- "function_expression",
36
- "arrow_function",
37
- "method_definition",
38
- "class_declaration",
39
- "try_statement",
40
- "catch_clause",
41
- ]),
42
- decision: new Set([
43
- "if_statement",
44
- "while_statement",
45
- "for_statement",
46
- "for_in_statement",
47
- "switch_case",
48
- "ternary_expression",
49
- ]),
50
- cognitive: new Set([
51
- "if_statement",
52
- "while_statement",
53
- "for_statement",
54
- "for_in_statement",
55
- "switch_statement",
56
- "switch_case",
57
- "ternary_expression",
58
- "catch_clause",
59
- ]),
60
- logicalOpNodes: new Set(),
61
- logicalBinaryOps: new Set(["&&", "||", "??"]),
62
- tryNode: "try_statement",
63
- nameChildTypes: ["identifier", "property_identifier"],
64
- };
65
- const PYTHON = {
66
- functionLike: new Set(["function_definition", "lambda"]),
67
- nesting: new Set([
68
- "if_statement",
69
- "for_statement",
70
- "while_statement",
71
- "match_statement",
72
- "function_definition",
73
- "class_definition",
74
- "try_statement",
75
- "except_clause",
76
- "elif_clause",
77
- ]),
78
- decision: new Set([
79
- "if_statement",
80
- "elif_clause",
81
- "for_statement",
82
- "while_statement",
83
- "case_clause",
84
- "conditional_expression",
85
- ]),
86
- cognitive: new Set([
87
- "if_statement",
88
- "elif_clause",
89
- "for_statement",
90
- "while_statement",
91
- "match_statement",
92
- "case_clause",
93
- "conditional_expression",
94
- "except_clause",
95
- ]),
96
- logicalOpNodes: new Set(["boolean_operator"]),
97
- logicalBinaryOps: new Set(),
98
- tryNode: "try_statement",
99
- nameChildTypes: ["identifier"],
100
- };
101
- const GO = {
102
- functionLike: new Set([
103
- "function_declaration",
104
- "method_declaration",
105
- "func_literal",
106
- ]),
107
- nesting: new Set([
108
- "if_statement",
109
- "for_statement",
110
- "expression_switch_statement",
111
- "type_switch_statement",
112
- "select_statement",
113
- "function_declaration",
114
- "method_declaration",
115
- ]),
116
- decision: new Set([
117
- "if_statement",
118
- "for_statement",
119
- "expression_case",
120
- "type_case",
121
- "communication_case",
122
- ]),
123
- cognitive: new Set([
124
- "if_statement",
125
- "for_statement",
126
- "expression_switch_statement",
127
- "type_switch_statement",
128
- "select_statement",
129
- "expression_case",
130
- "type_case",
131
- "communication_case",
132
- ]),
133
- logicalOpNodes: new Set(),
134
- logicalBinaryOps: new Set(["&&", "||"]),
135
- tryNode: undefined, // Go has no try/catch (error returns)
136
- nameChildTypes: ["identifier", "field_identifier"],
137
- };
138
- const RUST = {
139
- functionLike: new Set(["function_item", "closure_expression"]),
140
- nesting: new Set([
141
- "if_expression",
142
- "while_expression",
143
- "for_expression",
144
- "loop_expression",
145
- "match_expression",
146
- "function_item",
147
- ]),
148
- decision: new Set([
149
- "if_expression",
150
- "while_expression",
151
- "for_expression",
152
- "loop_expression",
153
- "match_arm",
154
- ]),
155
- cognitive: new Set([
156
- "if_expression",
157
- "while_expression",
158
- "for_expression",
159
- "loop_expression",
160
- "match_expression",
161
- "match_arm",
162
- ]),
163
- logicalOpNodes: new Set(),
164
- logicalBinaryOps: new Set(["&&", "||"]),
165
- tryNode: undefined, // Rust uses Result/? — no try/catch
166
- nameChildTypes: ["identifier"],
167
- };
168
- /**
169
- * Node configuration per grammar. Keyed by {@link ComplexityLanguageId}, whose
170
- * list lives in `tree-sitter-shared.ts` so `isComplexitySupportedFile` can
171
- * answer without loading this module (#2467). `Record` over a finite union
172
- * requires EXACTLY these keys, so the two cannot drift.
173
- */
174
- const LANGUAGE_NODES = {
175
- typescript: JSTS,
176
- tsx: JSTS,
177
- javascript: JSTS,
178
- python: PYTHON,
179
- go: GO,
180
- rust: RUST,
181
- };
182
- const COMMENT_TYPES = new Set(["comment", "line_comment", "block_comment"]);
183
- // --- Metric helpers (module-level, node-config-driven) ---
184
- function isLogicalOp(node, nodes) {
185
- if (nodes.logicalOpNodes.has(node.type))
186
- return true;
187
- if (nodes.logicalBinaryOps.size > 0 && node.type === "binary_expression") {
188
- return (node.children ?? []).some((c) => c && nodes.logicalBinaryOps.has(c.type));
189
- }
190
- return false;
191
- }
192
- /** Cyclomatic contribution of a subtree: decision points + logical operators. */
193
- function subtreeCyclomatic(root, nodes) {
194
- // Dispatch uses 1-based McCabe; this client exposes 0-based contributions (#2697).
195
- if (nodes === JSTS)
196
- return calcCyclomaticComplexity(root) - 1;
197
- let cc = 0;
198
- walk(root, (n) => {
199
- if (nodes.decision.has(n.type))
200
- cc++;
201
- if (isLogicalOp(n, nodes))
202
- cc++;
203
- });
204
- return cc;
205
- }
206
- /** Cognitive complexity (SonarSource-style: base + nesting penalty). */
207
- function subtreeCognitive(node, nesting, nodes) {
208
- let complexity = 0;
209
- if (nodes.cognitive.has(node.type))
210
- complexity += 1 + nesting;
211
- // Labeled break/continue add complexity.
212
- if ((node.type === "break_statement" || node.type === "continue_statement") &&
213
- (node.children ?? []).some((c) => c &&
214
- (c.type === "statement_identifier" ||
215
- c.type === "identifier" ||
216
- c.type === "label_name" ||
217
- c.type === "label"))) {
218
- complexity += 1 + nesting;
219
- }
220
- if (isLogicalOp(node, nodes))
221
- complexity += 1;
222
- const childNesting = nodes.nesting.has(node.type) ? nesting + 1 : nesting;
223
- for (const child of node.children ?? []) {
224
- if (child)
225
- complexity += subtreeCognitive(child, childNesting, nodes);
226
- }
227
- return complexity;
228
- }
229
- function subtreeMaxNesting(node, currentDepth, nodes) {
230
- let maxDepth = currentDepth;
231
- if (nodes.nesting.has(node.type)) {
232
- currentDepth++;
233
- maxDepth = Math.max(maxDepth, currentDepth);
234
- }
235
- for (const child of node.children ?? []) {
236
- if (child) {
237
- maxDepth = Math.max(maxDepth, subtreeMaxNesting(child, currentDepth, nodes));
238
- }
239
- }
240
- return maxDepth;
241
- }
242
- function functionName(fnNode, nodes) {
243
- for (const t of nodes.nameChildTypes) {
244
- const id = firstChildOfType(fnNode, t);
245
- if (id)
246
- return id.text;
247
- }
248
- return undefined;
249
- }
250
- function collectFunctionMetrics(root, nodes) {
251
- const functions = [];
252
- const visit = (node, nestingLevel) => {
253
- if (nodes.functionLike.has(node.type)) {
254
- const startLine = node.startPosition.row;
255
- const endLine = node.endPosition.row;
256
- functions.push({
257
- name: functionName(node, nodes) ?? `<anonymous@L${startLine + 1}>`,
258
- line: startLine + 1,
259
- length: endLine - startLine + 1,
260
- cyclomatic: subtreeCyclomatic(node, nodes),
261
- cognitive: subtreeCognitive(node, nestingLevel, nodes),
262
- nestingDepth: subtreeMaxNesting(node, 0, nodes),
263
- });
264
- }
265
- const newNesting = nodes.nesting.has(node.type)
266
- ? nestingLevel + 1
267
- : nestingLevel;
268
- for (const child of node.children ?? []) {
269
- if (child)
270
- visit(child, newNesting);
271
- }
272
- };
273
- visit(root, 0);
274
- return functions;
275
- }
276
- function countTryCatch(root, nodes) {
277
- if (!nodes.tryNode)
278
- return 0;
279
- let count = 0;
280
- walk(root, (n) => {
281
- if (n.type === nodes.tryNode)
282
- count++;
283
- });
284
- return count;
285
- }
286
- function countLines(content, root) {
287
- const lines = content.split(/\r?\n/);
288
- const commentLineSet = new Set();
289
- walk(root, (n) => {
290
- if (COMMENT_TYPES.has(n.type)) {
291
- for (let l = n.startPosition.row; l <= n.endPosition.row; l++) {
292
- commentLineSet.add(l);
293
- }
294
- }
295
- });
296
- const codeLines = lines.filter((line, i) => {
297
- if (line.trim().length === 0)
298
- return false;
299
- if (!commentLineSet.has(i))
300
- return true;
301
- // Line has a comment — keep it only if code remains after stripping it.
302
- const stripped = line
303
- .replace(/\/\/.*$/, "")
304
- .replace(/\/\*[\s\S]*?\*\//g, "")
305
- .replace(/#.*$/, "")
306
- .trim();
307
- return stripped.length > 0;
308
- }).length;
309
- return { codeLines, commentLines: commentLineSet.size };
310
- }
311
- const AI_COMMENT_PATTERNS = [
312
- /(?:🔍|✅|📝|🔧|🐛|⚠️|🚀|💡|🎯|📌|🏷️|🔑|🏗️|🧪|🗑️|🔄|♻️|📋|🔖|📊|💬|🔥|💎|⭐|🌟|🎨|🛠️)/u,
313
- /(?:\/\/|#)\s*(Initialize|Setup|Clean up|Create|Define|Check if|Handle|Process|Validate|Return|Get|Set|Add|Remove|Update|Fetch)\b/i,
314
- /(?:\/\/|#)\s*(This function|This method|This code|Here we|Now we)\b/i,
315
- /\/\*\*?\s*(Overview|Summary|Description|Example|Usage)\s*\*?\//i,
316
- ];
317
- function countAICommentPatterns(sourceText) {
318
- let count = 0;
319
- for (const line of sourceText.split(/\r?\n/)) {
320
- const trimmed = line.trim();
321
- if (trimmed.startsWith("//") ||
322
- trimmed.startsWith("/*") ||
323
- trimmed.startsWith("*") ||
324
- trimmed.startsWith("#")) {
325
- for (const pattern of AI_COMMENT_PATTERNS) {
326
- if (pattern.test(line)) {
327
- count++;
328
- break;
329
- }
330
- }
331
- }
332
- }
333
- return count;
334
- }
335
- function calculateCodeEntropy(sourceText) {
336
- const tokens = sourceText
337
- .replace(/\/\/.*/g, "")
338
- .replace(/\/\*[\s\S]*?\*\//g, "")
339
- .replace(/["'`][^"'`]*["'`]/g, "STR")
340
- .replace(/\b\d+(\.\d+)?\b/g, "NUM")
341
- .split(/[\s\n\r\t,;:()[\]{}=<>!&|+\-*/%^~?]+/)
342
- .filter((t) => t.length > 0);
343
- if (tokens.length === 0)
344
- return 0;
345
- const freq = new Map();
346
- for (const token of tokens)
347
- freq.set(token, (freq.get(token) || 0) + 1);
348
- let entropy = 0;
349
- for (const count of freq.values()) {
350
- const p = count / tokens.length;
351
- if (p > 0)
352
- entropy -= p * Math.log2(p);
353
- }
354
- return entropy;
355
- }
356
- /**
357
- * Maintainability index, Halstead-free variant:
358
- * MI = max(0, (171 - 0.23·Cyclomatic - 16.2·ln(LOC)) · 100/171) + comment bonus.
359
- */
360
- function calculateMaintainabilityIndex(cyclomatic, loc, comments) {
361
- if (loc === 0)
362
- return 100;
363
- const lnLOC = Math.log(loc);
364
- let mi = ((171 - 0.23 * cyclomatic - 16.2 * lnLOC) * 100) / 171;
365
- const commentBonus = Math.min(10, (comments / loc) * 50);
366
- mi += commentBonus;
367
- return Math.max(0, Math.min(100, mi));
368
- }
369
- function calculateMaxParams(functions) {
370
- // Estimate from average function length (kept from the original heuristic).
371
- return Math.min(10, Math.max(2, Math.round(functions.reduce((a, f) => a + f.length, 0) /
372
- Math.max(1, functions.length) /
373
- 5)));
374
- }
375
- function countSingleUseFunctions(functions) {
376
- return functions.filter((f) => f.length < 10 &&
377
- f.cyclomatic <= 2 &&
378
- /^(get|set|check|is|has|validate|format|parse|convert|create|make)/i.test(f.name)).length;
379
- }
380
- // --- Client ---
381
- export class ComplexityClient {
382
- log;
383
- constructor(verbose = false) {
384
- this.log = verbose ? createSubsystemLogger("complexity") : () => { };
385
- }
386
- /** True if the file's grammar has a complexity node mapping.
387
- *
388
- * Delegates to the module-free predicate in `tree-sitter-shared.ts`: the
389
- * same question is asked by `handleToolCallImpl` BEFORE the analyzer
390
- * bootstrap is loaded (#2467), and two copies of it would be two answers. */
391
- isSupportedFile(filePath) {
392
- return isComplexitySupportedFile(filePath);
393
- }
394
- /** Analyze complexity metrics for a file (null if unsupported / unparseable). */
395
- async analyzeFile(filePath) {
396
- const absolutePath = path.resolve(filePath);
397
- const languageId = resolveTreeSitterLanguage(absolutePath);
398
- const nodes = languageId && isComplexityLanguageId(languageId)
399
- ? LANGUAGE_NODES[languageId]
400
- : undefined;
401
- if (!nodes)
402
- return null;
403
- let content;
404
- try {
405
- if (!fs.existsSync(absolutePath))
406
- return null;
407
- content = fs.readFileSync(absolutePath, "utf-8");
408
- }
409
- catch (err) {
410
- this.log(`Read error for ${filePath}: ${err.message}`);
411
- return null;
412
- }
413
- try {
414
- const parsed = await withTreeSitterRoot(absolutePath, content, (root) => this.computeMetrics(absolutePath, content, root, nodes));
415
- return parsed.parsed ? parsed.value : null;
416
- }
417
- catch (err) {
418
- this.log(`Analysis error for ${filePath}: ${err.message}`);
419
- return null;
420
- }
421
- }
422
- computeMetrics(absolutePath, content, root, nodes) {
423
- const { codeLines, commentLines } = countLines(content, root);
424
- const functions = collectFunctionMetrics(root, nodes);
425
- const maxNestingDepth = subtreeMaxNesting(root, 0, nodes);
426
- const cognitive = subtreeCognitive(root, 0, nodes);
427
- const funcStats = this.aggregateFunctionStats(functions);
428
- return {
429
- filePath: path.relative(process.cwd(), absolutePath),
430
- maxNestingDepth,
431
- avgFunctionLength: funcStats.avgLength,
432
- maxFunctionLength: funcStats.maxLength,
433
- functionCount: functions.length,
434
- cyclomaticComplexity: funcStats.avgCyclomatic,
435
- maxCyclomaticComplexity: funcStats.maxCyclomatic,
436
- cognitiveComplexity: cognitive,
437
- maintainabilityIndex: Math.round(calculateMaintainabilityIndex(funcStats.avgCyclomatic, codeLines, commentLines) * 10) / 10,
438
- linesOfCode: codeLines,
439
- commentLines,
440
- codeEntropy: Math.round(calculateCodeEntropy(content) * 100) / 100,
441
- maxParamsInFunction: calculateMaxParams(functions),
442
- aiCommentPatterns: countAICommentPatterns(content),
443
- singleUseFunctions: countSingleUseFunctions(functions),
444
- tryCatchCount: countTryCatch(root, nodes),
445
- functions,
446
- };
447
- }
448
- aggregateFunctionStats(functions) {
449
- if (functions.length === 0) {
450
- return { avgLength: 0, maxLength: 0, avgCyclomatic: 1, maxCyclomatic: 1 };
451
- }
452
- const lengths = functions.map((f) => f.length);
453
- const cyclomatics = functions.map((f) => f.cyclomatic);
454
- const sum = (arr) => arr.reduce((a, b) => a + b, 0);
455
- return {
456
- avgLength: Math.round(sum(lengths) / lengths.length),
457
- maxLength: Math.max(...lengths),
458
- avgCyclomatic: Math.max(1, Math.round(sum(cyclomatics) / cyclomatics.length)),
459
- maxCyclomatic: Math.max(1, Math.max(...cyclomatics)),
460
- };
461
- }
462
- }
@@ -1,221 +0,0 @@
1
- /**
2
- * Monotonic deny precedence (#2425, scope item 4; #2415 AC 3).
3
- *
4
- * Ordinary config values are last-tier-wins. Denials are not. A denial is a
5
- * SECURITY decision, and the tier that made it is usually the tier the user
6
- * actually controls, so the ordinary rule is exactly backwards for it: today a
7
- * repository can hand pi-lens a `.pi-lens.json` that re-enables a server the
8
- * user disabled globally, and nothing notices.
9
- *
10
- * The rule, in one sentence: a denial from an OPERATOR tier is never lifted, and
11
- * a denial from any other tier is lifted only by an explicit operator allow of
12
- * higher precedence. `provenance.ts` owns the three-way tier classification;
13
- * this module owns what it means.
14
- *
15
- * The third class is why the sentence says "any other tier" rather than "a repo
16
- * tier" (#2440 review finding F3). `builtin` is `default`, not `operator`: a
17
- * denial pi-lens itself ships is liftable by the person running pi-lens — their
18
- * global config, their environment, their command line — and remains unliftable
19
- * by anything that arrived with a checkout. Treating a shipped default as an
20
- * operator decision made it permanent for everyone, which is a hard-coded
21
- * decision rather than a default.
22
- *
23
- * The two shapes a denial takes (`schema.ts`'s `x-deny`):
24
- *
25
- * - `boolean-false` — `enabled: false`. Resolution below.
26
- * - `array-union` — `disabledServers: ["x"]`. The union of every tier's
27
- * members, always. There is no vocabulary for UN-denying a member, so a
28
- * nearer tier that omits one is expressing nothing, not an allow. This is the
29
- * one place `x-merge-strategy` does not decide the outcome: a `replace`
30
- * strategy still governs how the array is SPELLED across tiers, and the deny
31
- * union still governs which members survive. A deny that a merge strategy
32
- * could erase would not be monotonic.
33
- *
34
- * Pure functions over their arguments. No state, no ledger writes: a denial
35
- * being honored is the normal case, not a degradation.
36
- */
37
- import { isOperatorTier, tierPrecedence, } from "./provenance.js";
38
- function provenanceOfContribution(source, key) {
39
- if (!source)
40
- return undefined;
41
- return {
42
- tier: source.tier,
43
- key,
44
- ...(source.file === undefined ? {} : { file: source.file }),
45
- ...(source.trust === undefined ? {} : { trust: source.trust }),
46
- };
47
- }
48
- /** Build a provenance entry for a resolved deny leaf. */
49
- export function denyProvenance(contributions, resolution, key) {
50
- return provenanceOfContribution(contributions[resolution.winner], key);
51
- }
52
- /**
53
- * One provenance entry per SURVIVING member of an `array-union`, keyed by the
54
- * member's own JSON pointer.
55
- *
56
- * The array's own entry still exists and still names the first denying tier;
57
- * these are strictly additional, so a consumer that asks about the array is
58
- * unaffected and a consumer that asks about a member gets the tier that
59
- * actually denied it (#2427 review round 2, F2).
60
- */
61
- export function denyMemberProvenance(contributions, resolution, key) {
62
- const entries = [];
63
- resolution.memberWinners.forEach((index, position) => {
64
- const pointer = `${key}/${position}`;
65
- const entry = provenanceOfContribution(contributions[index], pointer);
66
- if (entry)
67
- entries.push(entry);
68
- });
69
- return entries;
70
- }
71
- /** The `memberWinners` of a leaf with no members. One shared frozen empty. */
72
- const EMPTY_MEMBER_WINNERS = Object.freeze([]);
73
- /** Contributions sorted by tier precedence, lowest first, ties in caller order. */
74
- function byPrecedence(contributions) {
75
- return contributions
76
- .map((contribution, index) => ({ contribution, index }))
77
- .sort((left, right) => tierPrecedence(left.contribution.tier) -
78
- tierPrecedence(right.contribution.tier));
79
- }
80
- /**
81
- * Resolve a `boolean-false` deny.
82
- *
83
- * - No `false` anywhere: ordinary last-tier-wins.
84
- * - An OPERATOR tier said `false`: DENIED, pinned, unliftable by anything. The
85
- * winner is the LOWEST-precedence operator denial, because that is the answer
86
- * to "who denied this" — the first authority to say no, not the last tier to
87
- * repeat it. This holds even for a nearer operator tier: `cli: true` does not
88
- * lift `global: false`. The escape hatch for an operator who changes their
89
- * mind is to change the operator-tier config that denied, not to out-rank it
90
- * from another operator tier.
91
- * - Otherwise every denial came from `default` or `repo` tiers, and an OPERATOR
92
- * tier ranked above the FIRST such denial lifts it by saying `true` outright.
93
- * That is what makes a built-in default a default (`builtin: false` +
94
- * `global: true` -> `true`) while keeping repository content out of the
95
- * decision (`builtin: false` + `project: true` -> `false`). A repo tier never
96
- * lifts anything, its own class included.
97
- *
98
- * The lift test asks `isOperatorTier`, NOT `!isRepoTier`. The negative spelling
99
- * is what silently swept `builtin` into the operator class and made every
100
- * shipped default permanent; the affirmative one cannot.
101
- *
102
- * Non-boolean contributions are ignored here: `normalize.ts` has already
103
- * dropped values that failed the schema, so anything left is a boolean.
104
- */
105
- export function resolveBooleanDeny(contributions) {
106
- const ordered = byPrecedence(contributions);
107
- if (ordered.length === 0)
108
- return {
109
- value: undefined,
110
- winner: -1,
111
- denied: false,
112
- memberWinners: EMPTY_MEMBER_WINNERS,
113
- };
114
- const denials = ordered.filter((entry) => entry.contribution.value === false);
115
- if (denials.length === 0) {
116
- const last = ordered[ordered.length - 1];
117
- return {
118
- value: last.contribution.value,
119
- winner: last.index,
120
- denied: false,
121
- memberWinners: EMPTY_MEMBER_WINNERS,
122
- };
123
- }
124
- const operatorDenial = denials.find((entry) => isOperatorTier(entry.contribution.tier));
125
- if (operatorDenial) {
126
- return {
127
- value: false,
128
- winner: operatorDenial.index,
129
- denied: true,
130
- memberWinners: EMPTY_MEMBER_WINNERS,
131
- };
132
- }
133
- // Every denial came from a shipped default or from repo content. An operator
134
- // tier ranked above the FIRST such denial may lift it by saying `true`.
135
- const firstDenial = denials[0];
136
- const lift = ordered.find((entry) => entry.contribution.value === true &&
137
- isOperatorTier(entry.contribution.tier) &&
138
- tierPrecedence(entry.contribution.tier) >
139
- tierPrecedence(firstDenial.contribution.tier));
140
- if (lift) {
141
- return {
142
- value: true,
143
- winner: lift.index,
144
- denied: false,
145
- memberWinners: EMPTY_MEMBER_WINNERS,
146
- };
147
- }
148
- return {
149
- value: false,
150
- winner: firstDenial.index,
151
- denied: true,
152
- memberWinners: EMPTY_MEMBER_WINNERS,
153
- };
154
- }
155
- /**
156
- * Resolve an `array-union` deny: the union of every tier's members.
157
- *
158
- * Members keep first-contribution order, lowest precedence first, so the
159
- * resolved list reads oldest-authority-first and is stable across runs.
160
- * Duplicates are folded by their JSON encoding, which is exact for the
161
- * primitives a deny list holds and conservative (keeps both) for anything else.
162
- *
163
- * The winner is the FIRST tier that contributed a surviving member: the tier
164
- * that answers "why can I not turn this back on".
165
- */
166
- export function resolveArrayDeny(contributions) {
167
- const ordered = byPrecedence(contributions);
168
- const seen = new Set();
169
- const members = [];
170
- // Positionally parallel to `members`: the contribution that introduced each
171
- // surviving member, which is the per-member answer to "who denied this"
172
- // (#2427 review round 2, F2).
173
- const memberWinners = [];
174
- let winner = -1;
175
- for (const entry of ordered) {
176
- const value = entry.contribution.value;
177
- if (!Array.isArray(value))
178
- continue;
179
- for (const member of value) {
180
- const identity = primitiveIdentity(member);
181
- if (identity !== undefined) {
182
- if (seen.has(identity))
183
- continue;
184
- seen.add(identity);
185
- }
186
- members.push(member);
187
- memberWinners.push(entry.index);
188
- if (winner === -1)
189
- winner = entry.index;
190
- }
191
- }
192
- if (winner === -1) {
193
- // Nothing denied. Still report the array so a consumer sees an empty list
194
- // rather than an absent field, and attribute it to the last contributor.
195
- const last = ordered[ordered.length - 1];
196
- return {
197
- value: members,
198
- winner: last ? last.index : -1,
199
- denied: false,
200
- memberWinners,
201
- };
202
- }
203
- return { value: members, winner, denied: members.length > 0, memberWinners };
204
- }
205
- /**
206
- * A fold key for a primitive member, or `undefined` for anything else.
207
- *
208
- * Only primitives are de-duplicated. Two structurally equal objects can carry
209
- * different meaning, and keeping both is the conservative half of a deny list —
210
- * a union that dropped one would be un-denying something.
211
- */
212
- function primitiveIdentity(member) {
213
- if (typeof member === "string")
214
- return `s:${member}`;
215
- if (typeof member === "number" || typeof member === "boolean") {
216
- return `p:${String(member)}`;
217
- }
218
- if (member === null)
219
- return "null";
220
- return undefined;
221
- }