pi-lens 4.3.0 → 4.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (659) hide show
  1. package/CHANGELOG.md +1159 -0
  2. package/README.md +116 -25
  3. package/config/dependency-cruiser-eager-allowlist.json +6 -2
  4. package/dist/chunk-2BEMIWEW.js +51 -0
  5. package/dist/chunk-2EECBNC5.js +89 -0
  6. package/dist/chunk-2FQ62SPM.js +83 -0
  7. package/dist/chunk-2UMYMRI3.js +118 -0
  8. package/dist/chunk-34OCDWOS.js +48 -0
  9. package/dist/chunk-3FERWMCH.js +144 -0
  10. package/dist/chunk-3JL6IFD7.js +97 -0
  11. package/dist/chunk-3JSEWUWI.js +327 -0
  12. package/dist/chunk-3MED75HT.js +37 -0
  13. package/dist/chunk-3MRXIJ6I.js +79 -0
  14. package/dist/chunk-3P4PF2BX.js +2250 -0
  15. package/dist/chunk-3PNFWVHT.js +201 -0
  16. package/dist/chunk-3TTPKMEF.js +162 -0
  17. package/dist/chunk-5JHXUETW.js +326 -0
  18. package/dist/chunk-5W3R6LFT.js +24 -0
  19. package/dist/chunk-64LU2OVH.js +341 -0
  20. package/dist/chunk-6B5I6ICN.js +44 -0
  21. package/dist/chunk-6P54TMWL.js +274 -0
  22. package/dist/chunk-6UYA642J.js +145 -0
  23. package/dist/chunk-6XX5HCLK.js +398 -0
  24. package/dist/chunk-7AXO3ZDF.js +30 -0
  25. package/dist/chunk-7BX5DWSA.js +1907 -0
  26. package/dist/chunk-7ELY2CSM.js +902 -0
  27. package/dist/chunk-7M4T5N3V.js +38 -0
  28. package/dist/chunk-7U2IDNXN.js +37 -0
  29. package/dist/chunk-ABBOA7UD.js +157 -0
  30. package/dist/chunk-AFZYMAIV.js +756 -0
  31. package/dist/chunk-ALQRYH6O.js +112 -0
  32. package/dist/chunk-AXKPQ6ZI.js +1610 -0
  33. package/dist/chunk-BHWHXMQ2.js +62 -0
  34. package/dist/chunk-BJF25SUG.js +22 -0
  35. package/dist/chunk-BNKLYOOO.js +18 -0
  36. package/dist/chunk-BW5KFIQC.js +59 -0
  37. package/dist/chunk-CBD2B5CP.js +599 -0
  38. package/dist/chunk-CFYISHUW.js +42 -0
  39. package/dist/chunk-CMU4RMJB.js +30 -0
  40. package/dist/chunk-CULQYFLU.js +14 -0
  41. package/dist/chunk-D65GOCJB.js +289 -0
  42. package/dist/chunk-D6YF5HKX.js +59 -0
  43. package/dist/chunk-DMS52BEP.js +342 -0
  44. package/dist/chunk-ELVWJYRV.js +211 -0
  45. package/dist/chunk-EUT3B22Y.js +27 -0
  46. package/dist/chunk-F5VLZHUW.js +146 -0
  47. package/dist/chunk-FC4RP4I2.js +12 -0
  48. package/dist/chunk-FGALODG3.js +55 -0
  49. package/dist/chunk-G3RLJYA2.js +2358 -0
  50. package/dist/chunk-GAYGGICG.js +32 -0
  51. package/dist/chunk-H2W2AXD3.js +419 -0
  52. package/dist/chunk-H5EV3VMF.js +114 -0
  53. package/dist/chunk-HREZQCT3.js +106 -0
  54. package/dist/chunk-HSIRMK2D.js +517 -0
  55. package/dist/chunk-IMSQR4WO.js +184 -0
  56. package/dist/chunk-IQZXOZ7S.js +4816 -0
  57. package/dist/chunk-IR6XFA5P.js +37 -0
  58. package/dist/chunk-IUKPRZER.js +78 -0
  59. package/dist/chunk-IUR76K6A.js +262 -0
  60. package/dist/chunk-J3FZR3YY.js +98 -0
  61. package/dist/chunk-J6DFZDFA.js +562 -0
  62. package/dist/chunk-J7WJZ6W7.js +50 -0
  63. package/dist/chunk-JONGANYH.js +202 -0
  64. package/dist/chunk-KJCWXUUS.js +425 -0
  65. package/dist/chunk-KJN4IOEJ.js +17 -0
  66. package/dist/chunk-KMGPUKFD.js +25 -0
  67. package/dist/chunk-LD7WFTRX.js +4533 -0
  68. package/dist/chunk-LJDODBBZ.js +78 -0
  69. package/dist/chunk-LNOMA3MP.js +169 -0
  70. package/dist/chunk-MGIWSROG.js +2334 -0
  71. package/dist/chunk-MQA2YBAH.js +308 -0
  72. package/dist/chunk-MTDRLSI7.js +21720 -0
  73. package/dist/chunk-N2IRDBZI.js +2355 -0
  74. package/dist/chunk-N77WFUL7.js +50 -0
  75. package/dist/chunk-N7YNJE5R.js +466 -0
  76. package/dist/chunk-NABLC7W3.js +148 -0
  77. package/dist/chunk-NFXP47RV.js +999 -0
  78. package/dist/chunk-NJF2X5XF.js +45 -0
  79. package/dist/chunk-NXL4FFQQ.js +47 -0
  80. package/dist/chunk-O7HZX7CA.js +309 -0
  81. package/dist/chunk-OC7LYAU5.js +708 -0
  82. package/dist/chunk-OEX24ECI.js +348 -0
  83. package/dist/chunk-OYOB3ZFG.js +78 -0
  84. package/dist/chunk-OYTMZXRF.js +41 -0
  85. package/dist/chunk-OZJINN4O.js +84 -0
  86. package/dist/chunk-PCHDGUKT.js +23 -0
  87. package/dist/chunk-QOZXJ4NA.js +3364 -0
  88. package/dist/chunk-QYF5S6P6.js +45 -0
  89. package/dist/chunk-RJFED73B.js +79 -0
  90. package/dist/chunk-RTQNRM5X.js +27 -0
  91. package/dist/chunk-S6AMWKPC.js +189 -0
  92. package/dist/chunk-T4QZ6FEH.js +308 -0
  93. package/dist/chunk-T54VJRAD.js +5456 -0
  94. package/dist/chunk-TA5L5KWQ.js +167 -0
  95. package/dist/chunk-TQFBZVCG.js +27 -0
  96. package/dist/chunk-U52SAGRM.js +62 -0
  97. package/dist/chunk-UEAHAMEI.js +5814 -0
  98. package/dist/chunk-UGSMCQ4D.js +327 -0
  99. package/dist/chunk-UOPVJQ4N.js +103 -0
  100. package/dist/chunk-USHG4DLH.js +459 -0
  101. package/dist/chunk-UXVNL3D7.js +23 -0
  102. package/dist/chunk-V5MEBST3.js +4139 -0
  103. package/dist/chunk-VGEVL5EQ.js +29 -0
  104. package/dist/chunk-VPWKF3GN.js +87 -0
  105. package/dist/chunk-VSMJK3ZJ.js +1250 -0
  106. package/dist/chunk-VYKKMYVT.js +560 -0
  107. package/dist/chunk-VZHJS6DR.js +442 -0
  108. package/dist/chunk-WATC3IQR.js +213 -0
  109. package/dist/chunk-WPE5FPGR.js +54 -0
  110. package/dist/chunk-WSEWKCXU.js +188 -0
  111. package/dist/chunk-WW5BLB74.js +659 -0
  112. package/dist/chunk-XGUL4SLQ.js +406 -0
  113. package/dist/chunk-XHSCVSOL.js +170 -0
  114. package/dist/chunk-XIMYZ3JA.js +27 -0
  115. package/dist/chunk-YLN4K6WD.js +385 -0
  116. package/dist/chunk-Z3CCVDUB.js +76 -0
  117. package/dist/chunk-Z54ZSOBZ.js +61 -0
  118. package/dist/chunk-Z6BB4JLQ.js +478 -0
  119. package/dist/chunk-Z7QQA2KT.js +27 -0
  120. package/dist/chunk-ZETYB3XG.js +2626 -0
  121. package/dist/chunk-ZMOMPX2Z.js +87 -0
  122. package/dist/chunk-ZOEYVXSV.js +149 -0
  123. package/dist/chunk-ZZUFZUQZ.js +12120 -0
  124. package/dist/index.js +39712 -29876
  125. package/dist/mcp/analyze-cli.js +186 -232
  126. package/dist/mcp/cli.js +137 -98
  127. package/dist/mcp/server.js +22688 -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 +5 -4
  135. package/docs/configuration.md +28 -2
  136. package/docs/custom-rules.md +25 -2
  137. package/docs/environment-variables.md +86 -8
  138. package/docs/features.md +45 -5
  139. package/docs/globalconfig.md +2 -1
  140. package/docs/io-bridge-v2-migration.md +94 -0
  141. package/docs/lsp-capability-matrix.md +37 -4
  142. package/docs/lsp-idle-eviction.md +124 -0
  143. package/docs/mcp.md +21 -5
  144. package/docs/merge-queue-rollout.md +77 -0
  145. package/docs/pi-lens-fixer.md +160 -88
  146. package/docs/pi-lens-investigator.md +74 -26
  147. package/docs/pi-lens-merge-policy.md +736 -0
  148. package/docs/pi-lens-monitor.md +75 -7
  149. package/docs/pi-lens-retro.md +6 -4
  150. package/docs/pi-lens-reviewer.md +189 -48
  151. package/docs/pi-lens-subagent.md +246 -45
  152. package/docs/pi-lens-warden.md +18 -7
  153. package/docs/public-api-stability.md +55 -0
  154. package/docs/release-qa-baseline.md +84 -17
  155. package/docs/rfcs/3654-unified-io-bridge-v2.md +316 -0
  156. package/docs/schema/pi-lens-config-v1.json +530 -0
  157. package/docs/servercapabilities.md +56 -49
  158. package/docs/settings.md +1 -0
  159. package/docs/usage.md +5 -1
  160. package/docs/word-index.md +6 -0
  161. package/grammars/tree-sitter-bash.wasm +0 -0
  162. package/grammars/tree-sitter-bash.wasm.json +3 -3
  163. package/package.json +19 -7
  164. package/rules/ast-grep-rules/rule-tests/advisory-registry-subset-test.yml +41 -0
  165. package/rules/ast-grep-rules/rule-tests/no-identity-operator-on-literals-test.yml +12 -2
  166. package/rules/ast-grep-rules/rule-tests/throw-new-error-js-test.yml +2 -0
  167. package/rules/ast-grep-rules/rule-tests/throw-new-error-test.yml +2 -0
  168. package/rules/ast-grep-rules/rules/advisory-registry-subset.yml +50 -0
  169. package/rules/ast-grep-rules/rules/no-identity-operator-on-literals.yml +20 -12
  170. package/rules/ast-grep-rules/rules/throw-new-error-js.yml +2 -2
  171. package/rules/ast-grep-rules/rules/throw-new-error.yml +2 -2
  172. package/scripts/analyze-pi-lens-logs.mjs +1275 -62
  173. package/scripts/download-grammars.js +5 -0
  174. package/scripts/grammars.lock.json +6 -1
  175. package/scripts/install-selftest.mjs +33 -34
  176. package/scripts/lib/host-provided-deps.mjs +13 -4
  177. package/scripts/lib/web-tree-sitter-dir.mjs +18 -0
  178. package/dist/clients/actionable-warnings-logger.js +0 -35
  179. package/dist/clients/actionable-warnings.js +0 -1610
  180. package/dist/clients/advisory-provenance.js +0 -593
  181. package/dist/clients/agent-behavior-client.js +0 -147
  182. package/dist/clients/agent-nudge.js +0 -325
  183. package/dist/clients/analysed-root.js +0 -1
  184. package/dist/clients/ast-grep-client.js +0 -731
  185. package/dist/clients/ast-grep-rule-manager.js +0 -146
  186. package/dist/clients/ast-grep-tool-logger.js +0 -118
  187. package/dist/clients/ast-grep-types.js +0 -10
  188. package/dist/clients/ast-grep-yaml-synth.js +0 -154
  189. package/dist/clients/atomic-write-staging.js +0 -75
  190. package/dist/clients/atomic-write.js +0 -189
  191. package/dist/clients/availability-probe-flight.js +0 -12
  192. package/dist/clients/bash-file-access.js +0 -1056
  193. package/dist/clients/biome-client.js +0 -357
  194. package/dist/clients/blocker-freshness.js +0 -837
  195. package/dist/clients/blocker-past-eof.js +0 -129
  196. package/dist/clients/bootstrap.js +0 -569
  197. package/dist/clients/bounded-cache.js +0 -190
  198. package/dist/clients/bounded-pid-file-lock.js +0 -202
  199. package/dist/clients/bounded-telemetry.js +0 -295
  200. package/dist/clients/build-identity.js +0 -95
  201. package/dist/clients/bundled-resource-health.js +0 -113
  202. package/dist/clients/bus-events-logger.js +0 -105
  203. package/dist/clients/bus-publish.js +0 -171
  204. package/dist/clients/cache/rule-cache.js +0 -190
  205. package/dist/clients/cache-manager.js +0 -524
  206. package/dist/clients/cache-observability.js +0 -1313
  207. package/dist/clients/call-graph.js +0 -852
  208. package/dist/clients/cargo-manifest.js +0 -422
  209. package/dist/clients/cascade-budget.js +0 -196
  210. package/dist/clients/cascade-format.js +0 -315
  211. package/dist/clients/cascade-logger.js +0 -31
  212. package/dist/clients/cascade-types.js +0 -9
  213. package/dist/clients/child-unref.js +0 -124
  214. package/dist/clients/code-quality-warnings.js +0 -286
  215. package/dist/clients/codebase-model.js +0 -173
  216. package/dist/clients/collateral-test-role.js +0 -40
  217. package/dist/clients/complexity-client.js +0 -462
  218. package/dist/clients/config-core/deny.js +0 -221
  219. package/dist/clients/config-core/index.js +0 -50
  220. package/dist/clients/config-core/merge.js +0 -357
  221. package/dist/clients/config-core/normalize.js +0 -340
  222. package/dist/clients/config-core/process-spec.js +0 -248
  223. package/dist/clients/config-core/provenance.js +0 -164
  224. package/dist/clients/config-core/records.js +0 -218
  225. package/dist/clients/config-core/resolve.js +0 -125
  226. package/dist/clients/config-core/safe-object.js +0 -78
  227. package/dist/clients/config-core/schema.js +0 -165
  228. package/dist/clients/config-diagnostic-codes.js +0 -285
  229. package/dist/clients/config-locations.js +0 -388
  230. package/dist/clients/config-resolve.js +0 -798
  231. package/dist/clients/config-schema.js +0 -251
  232. package/dist/clients/config-warn.js +0 -407
  233. package/dist/clients/console-guard-install.js +0 -26
  234. package/dist/clients/cooperative-budget.js +0 -42
  235. package/dist/clients/dead-code-client.js +0 -510
  236. package/dist/clients/dead-code-logger.js +0 -30
  237. package/dist/clients/deadline-utils.js +0 -280
  238. package/dist/clients/debug-handles.js +0 -211
  239. package/dist/clients/debug-heap.js +0 -174
  240. package/dist/clients/deferred-lsp-work.js +0 -106
  241. package/dist/clients/degradation-ledger.js +0 -426
  242. package/dist/clients/demoted-finding-render.js +0 -169
  243. package/dist/clients/dependency-checker.js +0 -885
  244. package/dist/clients/deps/ast-grep-napi.js +0 -22
  245. package/dist/clients/deps/js-yaml.js +0 -9
  246. package/dist/clients/deps/minimatch.js +0 -4
  247. package/dist/clients/deps/pi-tui.js +0 -14
  248. package/dist/clients/deps/typebox.js +0 -14
  249. package/dist/clients/deps/vscode-jsonrpc.js +0 -1
  250. package/dist/clients/deps/web-tree-sitter.js +0 -24
  251. package/dist/clients/diagnostic-dispositions.js +0 -630
  252. package/dist/clients/diagnostic-line-freshness.js +0 -305
  253. package/dist/clients/diagnostic-logger.js +0 -73
  254. package/dist/clients/diagnostic-tracker.js +0 -105
  255. package/dist/clients/diagnostics-publish.js +0 -230
  256. package/dist/clients/dispatch/ast-grep-catalog.js +0 -65
  257. package/dist/clients/dispatch/auxiliary-lsp.js +0 -343
  258. package/dist/clients/dispatch/collect-later-tier.js +0 -35
  259. package/dist/clients/dispatch/diagnostic-taxonomy.js +0 -66
  260. package/dist/clients/dispatch/dispatcher.js +0 -1269
  261. package/dist/clients/dispatch/fact-provider-types.js +0 -1
  262. package/dist/clients/dispatch/fact-rule-runner.js +0 -17
  263. package/dist/clients/dispatch/fact-runner.js +0 -30
  264. package/dist/clients/dispatch/fact-scheduler.js +0 -68
  265. package/dist/clients/dispatch/fact-store.js +0 -377
  266. package/dist/clients/dispatch/facts/comment-facts.js +0 -22
  267. package/dist/clients/dispatch/facts/file-content.js +0 -19
  268. package/dist/clients/dispatch/facts/function-facts.js +0 -348
  269. package/dist/clients/dispatch/facts/import-facts.js +0 -204
  270. package/dist/clients/dispatch/facts/tree-sitter-facts.js +0 -34
  271. package/dist/clients/dispatch/facts/try-catch-facts.js +0 -119
  272. package/dist/clients/dispatch/finding-policy.js +0 -339
  273. package/dist/clients/dispatch/indent-detect.js +0 -417
  274. package/dist/clients/dispatch/inline-suppressions.js +0 -89
  275. package/dist/clients/dispatch/integration.js +0 -2377
  276. package/dist/clients/dispatch/lazy.js +0 -11
  277. package/dist/clients/dispatch/pending-runner-findings.js +0 -87
  278. package/dist/clients/dispatch/plan.js +0 -278
  279. package/dist/clients/dispatch/priorities.js +0 -20
  280. package/dist/clients/dispatch/rule-id-normalize.js +0 -50
  281. package/dist/clients/dispatch/rule-ignores.js +0 -69
  282. package/dist/clients/dispatch/rule-policy.js +0 -135
  283. package/dist/clients/dispatch/rules/async-noise.js +0 -40
  284. package/dist/clients/dispatch/rules/async-unnecessary-wrapper.js +0 -27
  285. package/dist/clients/dispatch/rules/cors-wildcard.js +0 -54
  286. package/dist/clients/dispatch/rules/error-obscuring.js +0 -32
  287. package/dist/clients/dispatch/rules/error-swallowing.js +0 -31
  288. package/dist/clients/dispatch/rules/framework-call-noise.js +0 -67
  289. package/dist/clients/dispatch/rules/high-complexity.js +0 -72
  290. package/dist/clients/dispatch/rules/high-fan-out.js +0 -74
  291. package/dist/clients/dispatch/rules/high-import-coupling.js +0 -37
  292. package/dist/clients/dispatch/rules/missing-error-propagation.js +0 -62
  293. package/dist/clients/dispatch/rules/no-commented-credentials.js +0 -52
  294. package/dist/clients/dispatch/rules/pass-through-wrappers.js +0 -42
  295. package/dist/clients/dispatch/rules/placeholder-comments.js +0 -40
  296. package/dist/clients/dispatch/rules/unsafe-boundary.js +0 -126
  297. package/dist/clients/dispatch/runner-context.js +0 -52
  298. package/dist/clients/dispatch/runners/actionlint.js +0 -111
  299. package/dist/clients/dispatch/runners/ast-grep-napi.js +0 -1196
  300. package/dist/clients/dispatch/runners/biome-check.js +0 -296
  301. package/dist/clients/dispatch/runners/cpp-check.js +0 -219
  302. package/dist/clients/dispatch/runners/credo.js +0 -82
  303. package/dist/clients/dispatch/runners/cue-vet.js +0 -416
  304. package/dist/clients/dispatch/runners/dart-analyze.js +0 -183
  305. package/dist/clients/dispatch/runners/detekt.js +0 -176
  306. package/dist/clients/dispatch/runners/dotnet-build.js +0 -164
  307. package/dist/clients/dispatch/runners/elixir-check.js +0 -195
  308. package/dist/clients/dispatch/runners/eslint.js +0 -137
  309. package/dist/clients/dispatch/runners/fact-rules.js +0 -29
  310. package/dist/clients/dispatch/runners/fish-indent.js +0 -69
  311. package/dist/clients/dispatch/runners/gleam-check.js +0 -167
  312. package/dist/clients/dispatch/runners/go-vet.js +0 -104
  313. package/dist/clients/dispatch/runners/golangci-lint.js +0 -135
  314. package/dist/clients/dispatch/runners/hadolint.js +0 -91
  315. package/dist/clients/dispatch/runners/helm-lint.js +0 -171
  316. package/dist/clients/dispatch/runners/helm-render.js +0 -940
  317. package/dist/clients/dispatch/runners/htmlhint.js +0 -117
  318. package/dist/clients/dispatch/runners/index.js +0 -108
  319. package/dist/clients/dispatch/runners/javac.js +0 -99
  320. package/dist/clients/dispatch/runners/ktlint.js +0 -110
  321. package/dist/clients/dispatch/runners/lsp.js +0 -379
  322. package/dist/clients/dispatch/runners/markdownlint.js +0 -167
  323. package/dist/clients/dispatch/runners/mypy.js +0 -102
  324. package/dist/clients/dispatch/runners/oxlint.js +0 -414
  325. package/dist/clients/dispatch/runners/php-lint.js +0 -85
  326. package/dist/clients/dispatch/runners/phpstan.js +0 -120
  327. package/dist/clients/dispatch/runners/prisma-validate.js +0 -62
  328. package/dist/clients/dispatch/runners/psscriptanalyzer.js +0 -445
  329. package/dist/clients/dispatch/runners/pyright.js +0 -169
  330. package/dist/clients/dispatch/runners/rubocop.js +0 -99
  331. package/dist/clients/dispatch/runners/ruff.js +0 -88
  332. package/dist/clients/dispatch/runners/rust-clippy.js +0 -256
  333. package/dist/clients/dispatch/runners/shellcheck.js +0 -173
  334. package/dist/clients/dispatch/runners/shfmt.js +0 -102
  335. package/dist/clients/dispatch/runners/spellcheck.js +0 -128
  336. package/dist/clients/dispatch/runners/spotbugs.js +0 -259
  337. package/dist/clients/dispatch/runners/sqlfluff.js +0 -183
  338. package/dist/clients/dispatch/runners/stylelint.js +0 -166
  339. package/dist/clients/dispatch/runners/swiftlint.js +0 -163
  340. package/dist/clients/dispatch/runners/taplo.js +0 -174
  341. package/dist/clients/dispatch/runners/terragrunt.js +0 -168
  342. package/dist/clients/dispatch/runners/tflint.js +0 -125
  343. package/dist/clients/dispatch/runners/tree-sitter.js +0 -643
  344. package/dist/clients/dispatch/runners/trivy-config.js +0 -253
  345. package/dist/clients/dispatch/runners/utils/availability-policy.js +0 -496
  346. package/dist/clients/dispatch/runners/utils/candidate-probe.js +0 -90
  347. package/dist/clients/dispatch/runners/utils/diagnostic-parsers.js +0 -95
  348. package/dist/clients/dispatch/runners/utils/lazy-installer.js +0 -274
  349. package/dist/clients/dispatch/runners/utils/runner-helpers.js +0 -1701
  350. package/dist/clients/dispatch/runners/utils/spawn-outcome.js +0 -101
  351. package/dist/clients/dispatch/runners/utils/tool-failure.js +0 -235
  352. package/dist/clients/dispatch/runners/utils/toolchain-availability.js +0 -169
  353. package/dist/clients/dispatch/runners/utils.js +0 -15
  354. package/dist/clients/dispatch/runners/vale.js +0 -128
  355. package/dist/clients/dispatch/runners/yaml-rule-parser.js +0 -242
  356. package/dist/clients/dispatch/runners/yamllint.js +0 -95
  357. package/dist/clients/dispatch/runners/zig-check.js +0 -79
  358. package/dist/clients/dispatch/suppress-writer.js +0 -79
  359. package/dist/clients/dispatch/tool-profile.js +0 -30
  360. package/dist/clients/dispatch/types.js +0 -21
  361. package/dist/clients/dispatch/utils/format-utils.js +0 -45
  362. package/dist/clients/dispatch/utils/lsp-diagnostics.js +0 -35
  363. package/dist/clients/disposition-logger.js +0 -32
  364. package/dist/clients/disposition-publish.js +0 -124
  365. package/dist/clients/durable-store.js +0 -97
  366. package/dist/clients/effective-config.js +0 -415
  367. package/dist/clients/env-utils.js +0 -83
  368. package/dist/clients/error-class.js +0 -23
  369. package/dist/clients/eval-timestamp.js +0 -17
  370. package/dist/clients/event-loop-hold.js +0 -274
  371. package/dist/clients/event-loop-monitor.js +0 -250
  372. package/dist/clients/extension-log.js +0 -504
  373. package/dist/clients/extension-mode.js +0 -73
  374. package/dist/clients/feature-hints.js +0 -103
  375. package/dist/clients/file-kinds.js +0 -412
  376. package/dist/clients/file-role.js +0 -134
  377. package/dist/clients/file-time.js +0 -160
  378. package/dist/clients/file-utils.js +0 -1032
  379. package/dist/clients/finding-delivery-gate.js +0 -494
  380. package/dist/clients/finding-identity.js +0 -88
  381. package/dist/clients/fix-worklog.js +0 -103
  382. package/dist/clients/format-events-publish.js +0 -343
  383. package/dist/clients/format-service.js +0 -222
  384. package/dist/clients/formatters-lazy.js +0 -9
  385. package/dist/clients/formatters.js +0 -2032
  386. package/dist/clients/freshness-cadence.js +0 -17
  387. package/dist/clients/freshness.js +0 -38
  388. package/dist/clients/generated-artifacts.js +0 -394
  389. package/dist/clients/generation-guard.js +0 -215
  390. package/dist/clients/git-guard.js +0 -1136
  391. package/dist/clients/git-tracked-ignore.js +0 -243
  392. package/dist/clients/gitleaks-client.js +0 -509
  393. package/dist/clients/go-client.js +0 -104
  394. package/dist/clients/govulncheck-client.js +0 -605
  395. package/dist/clients/gradle-ktfmt-style.js +0 -348
  396. package/dist/clients/grammar-source.js +0 -465
  397. package/dist/clients/gzip-stage-write.js +0 -135
  398. package/dist/clients/hashline-anchor.js +0 -424
  399. package/dist/clients/hook-budgets.js +0 -76
  400. package/dist/clients/host-edit-normalize.js +0 -140
  401. package/dist/clients/host-ports.js +0 -39
  402. package/dist/clients/indent-retarget.js +0 -154
  403. package/dist/clients/inline-blocker-dispositions.js +0 -186
  404. package/dist/clients/install-diagnostics.js +0 -156
  405. package/dist/clients/installer/index.js +0 -5416
  406. package/dist/clients/installer/managed-tool-refresh-session.js +0 -58
  407. package/dist/clients/installer/managed-tool-refresh.js +0 -783
  408. package/dist/clients/instance-reaper-state.js +0 -7
  409. package/dist/clients/instance-reaper.js +0 -1137
  410. package/dist/clients/instance-registry-lock.js +0 -145
  411. package/dist/clients/instance-registry.js +0 -773
  412. package/dist/clients/jscpd-client.js +0 -378
  413. package/dist/clients/json-cache-read.js +0 -65
  414. package/dist/clients/knip-client.js +0 -788
  415. package/dist/clients/language-policy.js +0 -252
  416. package/dist/clients/language-profile.js +0 -361
  417. package/dist/clients/language-registry.js +0 -603
  418. package/dist/clients/latency-logger.js +0 -727
  419. package/dist/clients/lazy-import.js +0 -21
  420. package/dist/clients/ledger-bounds.js +0 -54
  421. package/dist/clients/lens-config.js +0 -404
  422. package/dist/clients/lens-engine.js +0 -358
  423. package/dist/clients/lens-events.js +0 -125
  424. package/dist/clients/lens-flag-registry.js +0 -467
  425. package/dist/clients/lens-map.js +0 -1156
  426. package/dist/clients/live-bus-emitter.js +0 -74
  427. package/dist/clients/log-cleanup.js +0 -222
  428. package/dist/clients/lsp/aggregation.js +0 -178
  429. package/dist/clients/lsp/cascade-tier.js +0 -421
  430. package/dist/clients/lsp/client.js +0 -4593
  431. package/dist/clients/lsp/config.js +0 -691
  432. package/dist/clients/lsp/content-limits.js +0 -41
  433. package/dist/clients/lsp/diagnostic-binding.js +0 -225
  434. package/dist/clients/lsp/document-drift.js +0 -467
  435. package/dist/clients/lsp/edits.js +0 -1219
  436. package/dist/clients/lsp/index.js +0 -8305
  437. package/dist/clients/lsp/inferred-project.js +0 -216
  438. package/dist/clients/lsp/jvm-runtime.js +0 -298
  439. package/dist/clients/lsp/language.js +0 -63
  440. package/dist/clients/lsp/launch.js +0 -746
  441. package/dist/clients/lsp/lombok.js +0 -158
  442. package/dist/clients/lsp/path-utils.js +0 -5
  443. package/dist/clients/lsp/pending-aux-coverage.js +0 -251
  444. package/dist/clients/lsp/position-encoding.js +0 -61
  445. package/dist/clients/lsp/ruby-drive-dirs.js +0 -83
  446. package/dist/clients/lsp/server.js +0 -3290
  447. package/dist/clients/lsp/session-roots.js +0 -192
  448. package/dist/clients/lsp/spawn-history.js +0 -17
  449. package/dist/clients/lsp/sync-kind.js +0 -56
  450. package/dist/clients/lsp/tsserver-sync.js +0 -332
  451. package/dist/clients/lsp/wait-policy/capability-snapshot.js +0 -1
  452. package/dist/clients/lsp/wait-policy/classification.js +0 -85
  453. package/dist/clients/lsp/wait-policy/index.js +0 -10
  454. package/dist/clients/lsp/wait-policy/strategies.js +0 -392
  455. package/dist/clients/lsp/watch-queue.js +0 -61
  456. package/dist/clients/lsp/workspace-diagnostics-cache.js +0 -639
  457. package/dist/clients/lsp/workspace-diagnostics-session.js +0 -30
  458. package/dist/clients/lsp/workspace-sweep-hold.js +0 -184
  459. package/dist/clients/lsp-budget.js +0 -186
  460. package/dist/clients/lsp-document-symbols.js +0 -110
  461. package/dist/clients/lsp-lazy.js +0 -9
  462. package/dist/clients/lsp-mutation.js +0 -396
  463. package/dist/clients/lsp-status.js +0 -59
  464. package/dist/clients/map-with-concurrency.js +0 -40
  465. package/dist/clients/mcp/analyze.js +0 -420
  466. package/dist/clients/mcp/host-shim.js +0 -31
  467. package/dist/clients/mcp/ipc.js +0 -523
  468. package/dist/clients/mcp/review.js +0 -197
  469. package/dist/clients/mcp/session.js +0 -412
  470. package/dist/clients/memory-sampler.js +0 -208
  471. package/dist/clients/message-end-attribution.js +0 -30
  472. package/dist/clients/metrics-client.js +0 -107
  473. package/dist/clients/metrics-history.js +0 -327
  474. package/dist/clients/middle-man-analysis.js +0 -263
  475. package/dist/clients/model-provider.js +0 -53
  476. package/dist/clients/module-report-lsp.js +0 -189
  477. package/dist/clients/module-report.js +0 -2150
  478. package/dist/clients/mutating-tool.js +0 -651
  479. package/dist/clients/mutation-attribution.js +0 -368
  480. package/dist/clients/mutation-bridge.js +0 -240
  481. package/dist/clients/ndjson-logger.js +0 -734
  482. package/dist/clients/observed-mutation-sources.js +0 -101
  483. package/dist/clients/observed-mutation.js +0 -1253
  484. package/dist/clients/oldtext-autopatch.js +0 -128
  485. package/dist/clients/opaque-mutation-scan.js +0 -496
  486. package/dist/clients/opengrep-client.js +0 -333
  487. package/dist/clients/opengrep-config.js +0 -76
  488. package/dist/clients/package-manager.js +0 -607
  489. package/dist/clients/package-root.js +0 -38
  490. package/dist/clients/partial-edit-apply.js +0 -439
  491. package/dist/clients/path-attribution-telemetry.js +0 -43
  492. package/dist/clients/path-keyed-map.js +0 -108
  493. package/dist/clients/path-utils.js +0 -1244
  494. package/dist/clients/performance-report.js +0 -331
  495. package/dist/clients/persist-debounce.js +0 -70
  496. package/dist/clients/persistent-reverify.js +0 -271
  497. package/dist/clients/php-cs-fixer-config.js +0 -119
  498. package/dist/clients/pipeline.js +0 -1480
  499. package/dist/clients/post-autofix-notice.js +0 -37
  500. package/dist/clients/print-mode.js +0 -21
  501. package/dist/clients/probe-home-state.js +0 -228
  502. package/dist/clients/process-bridge.js +0 -66
  503. package/dist/clients/process-singletons.js +0 -210
  504. package/dist/clients/process-snapshot.js +0 -68
  505. package/dist/clients/project-changes.js +0 -181
  506. package/dist/clients/project-conventions.js +0 -171
  507. package/dist/clients/project-diagnostics/cache.js +0 -137
  508. package/dist/clients/project-diagnostics/extractors.js +0 -109
  509. package/dist/clients/project-diagnostics/fresh-fetch.js +0 -668
  510. package/dist/clients/project-diagnostics/runner-adapters/call-graph-impact.js +0 -118
  511. package/dist/clients/project-diagnostics/runner-adapters/dead-code.js +0 -47
  512. package/dist/clients/project-diagnostics/runner-adapters/gitleaks.js +0 -40
  513. package/dist/clients/project-diagnostics/runner-adapters/govulncheck.js +0 -34
  514. package/dist/clients/project-diagnostics/runner-adapters/jscpd.js +0 -38
  515. package/dist/clients/project-diagnostics/runner-adapters/knip.js +0 -47
  516. package/dist/clients/project-diagnostics/runner-adapters/madge.js +0 -48
  517. package/dist/clients/project-diagnostics/runner-adapters/opengrep.js +0 -40
  518. package/dist/clients/project-diagnostics/runner-adapters/runner-findings.js +0 -127
  519. package/dist/clients/project-diagnostics/runner-adapters/trivy.js +0 -81
  520. package/dist/clients/project-diagnostics/scanner.js +0 -520
  521. package/dist/clients/project-diagnostics/types.js +0 -1
  522. package/dist/clients/project-lens-config.js +0 -807
  523. package/dist/clients/project-report.js +0 -701
  524. package/dist/clients/project-scale.js +0 -237
  525. package/dist/clients/project-scan-policy.js +0 -11
  526. package/dist/clients/project-snapshot-fingerprint.js +0 -48
  527. package/dist/clients/project-snapshot-persist-worker.js +0 -20
  528. package/dist/clients/project-snapshot.js +0 -1653
  529. package/dist/clients/project-trust.js +0 -181
  530. package/dist/clients/python-environment.js +0 -217
  531. package/dist/clients/python-provenance.js +0 -639
  532. package/dist/clients/quiet-window-config.js +0 -47
  533. package/dist/clients/quiet-window.js +0 -236
  534. package/dist/clients/read-bridge.js +0 -139
  535. package/dist/clients/read-expansion.js +0 -266
  536. package/dist/clients/read-guard-logger.js +0 -251
  537. package/dist/clients/read-guard-tool-lines.js +0 -1306
  538. package/dist/clients/read-guard.js +0 -1561
  539. package/dist/clients/recent-touches.js +0 -240
  540. package/dist/clients/redact/secrets.js +0 -449
  541. package/dist/clients/resource-sampler.js +0 -628
  542. package/dist/clients/reverse-deps.js +0 -270
  543. package/dist/clients/review-graph/builder.js +0 -5126
  544. package/dist/clients/review-graph/format.js +0 -33
  545. package/dist/clients/review-graph/git-identity.js +0 -163
  546. package/dist/clients/review-graph/import-resolvers.js +0 -481
  547. package/dist/clients/review-graph/persist-worker.js +0 -10
  548. package/dist/clients/review-graph/query.js +0 -244
  549. package/dist/clients/review-graph/revision-drift.js +0 -21
  550. package/dist/clients/review-graph/service.js +0 -96
  551. package/dist/clients/review-graph/shared-extraction-ir.js +0 -82
  552. package/dist/clients/review-graph/symbol-id.js +0 -103
  553. package/dist/clients/review-graph/tsconfig-paths.js +0 -299
  554. package/dist/clients/review-graph/types.js +0 -1
  555. package/dist/clients/review-graph/workspace-modules.js +0 -449
  556. package/dist/clients/review-graph-logger.js +0 -81
  557. package/dist/clients/ruff-client.js +0 -179
  558. package/dist/clients/rules-scanner.js +0 -131
  559. package/dist/clients/run-duration.js +0 -55
  560. package/dist/clients/runtime-agent-end.js +0 -746
  561. package/dist/clients/runtime-config.js +0 -77
  562. package/dist/clients/runtime-context.js +0 -211
  563. package/dist/clients/runtime-coordinator.js +0 -1324
  564. package/dist/clients/runtime-session.js +0 -2485
  565. package/dist/clients/runtime-tool-call.js +0 -1295
  566. package/dist/clients/runtime-tool-result.js +0 -2049
  567. package/dist/clients/runtime-turn.js +0 -3767
  568. package/dist/clients/rust-client.js +0 -97
  569. package/dist/clients/safe-spawn.js +0 -2357
  570. package/dist/clients/sanitize.js +0 -286
  571. package/dist/clients/scan-utils.js +0 -25
  572. package/dist/clients/scratch-tree-policy.js +0 -165
  573. package/dist/clients/search-read-registration.js +0 -94
  574. package/dist/clients/secret-findings.js +0 -114
  575. package/dist/clients/security-scan-client.js +0 -352
  576. package/dist/clients/session-event-guard.js +0 -297
  577. package/dist/clients/session-lifecycle.js +0 -484
  578. package/dist/clients/session-start-observability.js +0 -94
  579. package/dist/clients/session-state-store.js +0 -101
  580. package/dist/clients/session-summary.js +0 -15
  581. package/dist/clients/sessionstart-logger.js +0 -27
  582. package/dist/clients/sg-runner.js +0 -876
  583. package/dist/clients/sgconfig.js +0 -347
  584. package/dist/clients/shared-checkout-guard.js +0 -338
  585. package/dist/clients/single-flight.js +0 -158
  586. package/dist/clients/situational-tool-telemetry.js +0 -108
  587. package/dist/clients/skills-resolver.js +0 -141
  588. package/dist/clients/slow-fs.js +0 -138
  589. package/dist/clients/smells-rollup.js +0 -231
  590. package/dist/clients/source-filter.js +0 -596
  591. package/dist/clients/source-walker.js +0 -211
  592. package/dist/clients/spawn-output-cap.js +0 -120
  593. package/dist/clients/spawn-timeout-cooldown.js +0 -110
  594. package/dist/clients/stale-marker.js +0 -17
  595. package/dist/clients/startup-scan.js +0 -400
  596. package/dist/clients/startup-timing.js +0 -130
  597. package/dist/clients/string-utils.js +0 -33
  598. package/dist/clients/subagent-mode.js +0 -111
  599. package/dist/clients/symbol-containment.js +0 -24
  600. package/dist/clients/symbol-types.js +0 -5
  601. package/dist/clients/test-runner-client.js +0 -2507
  602. package/dist/clients/test-runner-delivery.js +0 -287
  603. package/dist/clients/todo-scanner.js +0 -229
  604. package/dist/clients/tool-agreement.js +0 -423
  605. package/dist/clients/tool-config.js +0 -249
  606. package/dist/clients/tool-cwd.js +0 -270
  607. package/dist/clients/tool-definition.js +0 -47
  608. package/dist/clients/tool-event.js +0 -105
  609. package/dist/clients/tool-policy.js +0 -2755
  610. package/dist/clients/tool-probe.js +0 -53
  611. package/dist/clients/tool-render.js +0 -156
  612. package/dist/clients/tool-set-policy.js +0 -118
  613. package/dist/clients/tree-sitter-cache.js +0 -364
  614. package/dist/clients/tree-sitter-client.js +0 -4195
  615. package/dist/clients/tree-sitter-logger.js +0 -100
  616. package/dist/clients/tree-sitter-navigator.js +0 -269
  617. package/dist/clients/tree-sitter-query-loader.js +0 -569
  618. package/dist/clients/tree-sitter-shared.js +0 -158
  619. package/dist/clients/tree-sitter-symbol-extractor.js +0 -1265
  620. package/dist/clients/trivy-client.js +0 -467
  621. package/dist/clients/tui-fit.js +0 -50
  622. package/dist/clients/turn-context.js +0 -52
  623. package/dist/clients/turn-end/lane.js +0 -51
  624. package/dist/clients/turn-end/lanes/govulncheck.js +0 -112
  625. package/dist/clients/turn-end/lanes/secrets.js +0 -204
  626. package/dist/clients/turn-summary-render.js +0 -72
  627. package/dist/clients/turn-summary.js +0 -132
  628. package/dist/clients/typos-config.js +0 -29
  629. package/dist/clients/user-notify.js +0 -51
  630. package/dist/clients/vanished-instance-marker.js +0 -57
  631. package/dist/clients/warm-attach.js +0 -305
  632. package/dist/clients/widget-state.js +0 -1808
  633. package/dist/clients/word-index-logger.js +0 -49
  634. package/dist/clients/word-index-store.js +0 -459
  635. package/dist/clients/word-index.js +0 -2080
  636. package/dist/clients/workspace-topology.js +0 -443
  637. package/dist/clients/write-ordering-guard.js +0 -65
  638. package/dist/clients/zizmor-config.js +0 -340
  639. package/dist/i18n.js +0 -69
  640. package/dist/mcp/build-staleness.js +0 -124
  641. package/dist/scripts/lib/process-scan.mjs +0 -583
  642. package/dist/scripts/lib/skills-predicate.mjs +0 -129
  643. package/dist/scripts/lib/web-tree-sitter-dir.mjs +0 -123
  644. package/dist/tools/activate-tools.js +0 -87
  645. package/dist/tools/ast-grep-outline.js +0 -137
  646. package/dist/tools/ast-grep-replace.js +0 -244
  647. package/dist/tools/ast-grep-search.js +0 -762
  648. package/dist/tools/effective-config.js +0 -90
  649. package/dist/tools/lens-diagnostic-mark.js +0 -375
  650. package/dist/tools/lens-diagnostics.js +0 -2571
  651. package/dist/tools/lsp-diagnostics.js +0 -1745
  652. package/dist/tools/lsp-navigation.js +0 -1367
  653. package/dist/tools/lsp-structured-output.js +0 -294
  654. package/dist/tools/module-report.js +0 -382
  655. package/dist/tools/project-report.js +0 -86
  656. package/dist/tools/render-compact.js +0 -374
  657. package/dist/tools/scan-progress.js +0 -53
  658. package/dist/tools/shared.js +0 -29
  659. 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
- }