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,33 +0,0 @@
1
- import * as path from "node:path";
2
- const MAX_SYMBOLS = 5;
3
- function displayList(items, maxFiles, map) {
4
- return items.slice(0, maxFiles).map((item) => (map ? map(item) : item));
5
- }
6
- export function formatImpactCascade(result, maxFiles = 4) {
7
- if (result.changedSymbols.length === 0 &&
8
- result.neighborFiles.length === 0 &&
9
- result.riskFlags.length === 0) {
10
- return undefined;
11
- }
12
- const lines = ["🕸️ Impact cascade from edited file:"];
13
- if (result.changedSymbols.length > 0) {
14
- const shown = result.changedSymbols.slice(0, MAX_SYMBOLS);
15
- const suffix = result.changedSymbols.length > shown.length
16
- ? ` (+${result.changedSymbols.length - shown.length} more)`
17
- : "";
18
- lines.push(`Changed symbols: ${shown.join(", ")}${suffix}`);
19
- }
20
- if (result.directImporters.length > 0) {
21
- lines.push(`Direct importers: ${displayList(result.directImporters, maxFiles, (item) => path.basename(item)).join(", ")}`);
22
- }
23
- if (result.directCallers.length > 0) {
24
- lines.push(`Direct callers: ${displayList(result.directCallers, maxFiles, (item) => path.basename(item)).join(", ")}`);
25
- }
26
- if (result.neighborFiles.length > 0) {
27
- lines.push(`Check next: ${displayList(result.neighborFiles, maxFiles, (item) => path.basename(item)).join(", ")}`);
28
- }
29
- if (result.riskFlags.length > 0) {
30
- lines.push(`Risk: ${result.riskFlags.join(", ")}`);
31
- }
32
- return lines.join("\n");
33
- }
@@ -1,163 +0,0 @@
1
- /**
2
- * Pure-filesystem git identity resolution for the review-graph snapshot
3
- * (#300). Resolves the current HEAD commit and worktree top-level path
4
- * WITHOUT spawning `git` — this runs on the persist path, which includes the
5
- * synchronous process-exit flush in builder.ts. Spawning a child process
6
- * during teardown crashes libuv on Windows (uv_async on a closing handle —
7
- * the #234 `pi update` crash), so every read here is a plain `fs` call
8
- * wrapped so any failure degrades to "not a git repo" (no stamp, no check —
9
- * identical to today's behavior).
10
- *
11
- * Handles both a normal repo (`.git` is a directory) and a linked worktree
12
- * (`.git` is a FILE containing `gitdir: <path>`, where HEAD lives in that
13
- * worktree-private gitdir but branch refs live in the shared `commondir`).
14
- */
15
- import * as fs from "node:fs";
16
- import * as path from "node:path";
17
- import { normalizeFilePath, walkUpDirs } from "../path-utils.js";
18
- /** A build-local memo: it is discarded when the build settles. */
19
- export function createGitIdentityResolver() {
20
- const memo = new Map();
21
- return (cwd) => {
22
- if (memo.has(cwd))
23
- return memo.get(cwd);
24
- const identity = resolveGitIdentity(cwd);
25
- memo.set(cwd, identity);
26
- return identity;
27
- };
28
- }
29
- // Kept as a compatibility no-op for tests that reset the former memo. Git
30
- // repository creation/removal is a process-lifecycle change, so the lookup
31
- // below must walk the filesystem on every call rather than cache presence or
32
- // absence by cwd.
33
- export function _resetGitIdentityCacheForTests() {
34
- return;
35
- }
36
- function readCommonDir(gitDir) {
37
- try {
38
- const raw = fs.readFileSync(path.join(gitDir, "commondir"), "utf-8").trim();
39
- if (!raw)
40
- return gitDir;
41
- return path.isAbsolute(raw) ? raw : path.resolve(gitDir, raw);
42
- }
43
- catch {
44
- return gitDir;
45
- }
46
- }
47
- /**
48
- * Walk up from `cwd` looking for a `.git` entry. Returns null when none is
49
- * found (not a git repo) or the entry is malformed in a way we can't resolve.
50
- */
51
- function resolveGitDir(cwd) {
52
- for (const dir of walkUpDirs(cwd)) {
53
- const gitPath = path.join(dir, ".git");
54
- let stat;
55
- try {
56
- stat = fs.statSync(gitPath);
57
- }
58
- catch {
59
- continue;
60
- }
61
- if (stat.isDirectory()) {
62
- return {
63
- gitDir: gitPath,
64
- commonDir: readCommonDir(gitPath),
65
- worktreeRoot: dir,
66
- };
67
- }
68
- if (stat.isFile()) {
69
- // Linked worktree: ".git" is a file with a single "gitdir: <path>" line.
70
- try {
71
- const contents = fs.readFileSync(gitPath, "utf-8").trim();
72
- const match = contents.match(/^gitdir:\s*(.+)$/);
73
- if (!match)
74
- return null;
75
- const linkedGitDir = path.isAbsolute(match[1])
76
- ? match[1]
77
- : path.resolve(dir, match[1]);
78
- if (!fs.statSync(linkedGitDir).isDirectory())
79
- return null;
80
- return {
81
- gitDir: linkedGitDir,
82
- commonDir: readCommonDir(linkedGitDir),
83
- worktreeRoot: dir,
84
- };
85
- }
86
- catch {
87
- return null;
88
- }
89
- }
90
- // Neither a dir nor a file at `.git` — treat as not-a-repo rather than
91
- // keep walking past what looks like a repo root.
92
- return null;
93
- }
94
- return null;
95
- }
96
- function getResolvedGitDir(cwd) {
97
- let resolved;
98
- try {
99
- resolved = resolveGitDir(cwd);
100
- }
101
- catch {
102
- resolved = null;
103
- }
104
- return resolved;
105
- }
106
- function resolveRefToSha(commonDir, ref) {
107
- // Loose ref file first (refs/heads/x), then packed-refs as fallback.
108
- try {
109
- const loose = fs.readFileSync(path.join(commonDir, ref), "utf-8").trim();
110
- if (loose)
111
- return loose;
112
- }
113
- catch {
114
- /* fall through to packed-refs */
115
- }
116
- try {
117
- const packed = fs.readFileSync(path.join(commonDir, "packed-refs"), "utf-8");
118
- for (const line of packed.split("\n")) {
119
- if (line.startsWith("#") || line.startsWith("^") || !line.trim())
120
- continue;
121
- const [sha, packedRef] = line.trim().split(/\s+/, 2);
122
- if (packedRef === ref)
123
- return sha;
124
- }
125
- }
126
- catch {
127
- /* no packed-refs — ref is simply unresolved */
128
- }
129
- return null;
130
- }
131
- /**
132
- * Resolve the current git HEAD commit + worktree root purely by reading
133
- * files — no `git` subprocess. Returns undefined for anything that isn't (or
134
- * can't be confidently resolved as) a git repo; callers treat that exactly
135
- * like "not a git repo" — no stamp, no check, today's behavior.
136
- */
137
- export function resolveGitIdentity(cwd) {
138
- try {
139
- const resolved = getResolvedGitDir(cwd);
140
- if (!resolved)
141
- return undefined;
142
- const headRaw = fs
143
- .readFileSync(path.join(resolved.gitDir, "HEAD"), "utf-8")
144
- .trim();
145
- const refMatch = headRaw.match(/^ref:\s*(.+)$/);
146
- let headCommit;
147
- if (refMatch) {
148
- headCommit = resolveRefToSha(resolved.commonDir, refMatch[1].trim());
149
- }
150
- else {
151
- headCommit = /^[0-9a-f]{7,40}$/i.test(headRaw) ? headRaw : null;
152
- }
153
- if (!headCommit)
154
- return undefined;
155
- return {
156
- headCommit,
157
- worktreeRoot: normalizeFilePath(resolved.worktreeRoot),
158
- };
159
- }
160
- catch {
161
- return undefined;
162
- }
163
- }
@@ -1,481 +0,0 @@
1
- /**
2
- * Internal-import resolution-to-file for tree-sitter languages (#249 follow-up).
3
- *
4
- * The review graph extracts import SOURCES per language (IMPORT_QUERIES), but a
5
- * raw source string ("os.path", "./foo", "github.com/me/p/pkg") isn't a graph
6
- * edge until it's resolved to an in-project FILE. jsts (localImportToFile) and
7
- * cxx (#include) already do this; these resolvers extend it to the tree-sitter
8
- * languages where an import maps cleanly to a file:
9
- *
10
- * - relative file paths : ruby (require_relative), zig (@import), bash
11
- * (source/.), dart (relative `import`)
12
- * - package/module roots : python (dotted → package file), java (package →
13
- * source-root file), go (import path → package DIR's
14
- * .go files)
15
- *
16
- * Languages whose imports are NOT a 1:1 file concept (rust mod-system,
17
- * c#/swift namespaces, kotlin/elixir multi-symbol files) are intentionally not
18
- * resolved — they stay honest `external:` nodes rather than misleading edges.
19
- *
20
- * Every resolver is pure + existence-checked + confined to `cwd`: an
21
- * unresolvable source returns `[]` and the caller keeps the unresolved node, so
22
- * a wrong guess can never fabricate an edge to a file that isn't there.
23
- */
24
- import * as fs from "node:fs";
25
- import * as path from "node:path";
26
- import { normalizeMapKey } from "../path-utils.js";
27
- import { aliasedImportTargets, referencedProjectImportTarget, } from "./tsconfig-paths.js";
28
- import { buildModuleGraph } from "./workspace-modules.js";
29
- /** True when `p` is inside (or equal to) `cwd` — blocks resolution escaping the workspace. */
30
- function isWithin(cwd, p) {
31
- const root = path.resolve(cwd);
32
- const rp = path.resolve(p);
33
- return rp === root || rp.startsWith(root + path.sep);
34
- }
35
- function isFile(p) {
36
- try {
37
- return fs.statSync(p).isFile();
38
- }
39
- catch {
40
- return false;
41
- }
42
- }
43
- function isDir(p) {
44
- try {
45
- return fs.statSync(p).isDirectory();
46
- }
47
- catch {
48
- return false;
49
- }
50
- }
51
- /** First candidate that exists as a file within cwd, normalized — or []. */
52
- function firstExistingFile(cwd, candidates) {
53
- for (const c of candidates) {
54
- if (isWithin(cwd, c) && isFile(c))
55
- return [normalizeMapKey(c)];
56
- }
57
- return [];
58
- }
59
- /** All `ext` files directly in `dir` (non-recursive), normalized — or []. */
60
- function sourceFilesIn(cwd, dir, ext) {
61
- if (!isWithin(cwd, dir) || !isDir(dir))
62
- return [];
63
- try {
64
- return fs
65
- .readdirSync(dir)
66
- .filter((n) => n.endsWith(ext))
67
- .map((n) => normalizeMapKey(path.join(dir, n)))
68
- .sort();
69
- }
70
- catch {
71
- return [];
72
- }
73
- }
74
- /** Resolve a path-ish source relative to the importing file's directory. */
75
- function resolveRelative(cwd, filePath, source, exts) {
76
- const base = path.resolve(path.dirname(filePath), source);
77
- return firstExistingFile(cwd, [base, ...exts.map((e) => base + e)]);
78
- }
79
- function resolveDart(cwd, filePath, source) {
80
- // package: / dart: imports are SDK/pub deps, not project files.
81
- if (source.startsWith("package:") || source.startsWith("dart:"))
82
- return [];
83
- return resolveRelative(cwd, filePath, source, [".dart"]);
84
- }
85
- // --- JS/TS -------------------------------------------------------------------
86
- // TS-as-ESM sources commonly write `import { x } from "./service.js"` while
87
- // the real file on disk is `service.ts` (Node's ESM resolver requires the
88
- // RUNTIME extension in the specifier, which is `.js` even for a `.ts` source —
89
- // this repo's own `clients/**/*.ts` does this throughout). Stripping a known
90
- // JS/TS extension from the specifier before re-appending candidate extensions
91
- // lets that universal pattern resolve to the real source file. Exported so
92
- // builder.ts's warm `localImportToFile` shares the exact same regex (#694).
93
- const JS_TS_EXT_RE = /\.(mjs|cjs|mts|cts|jsx?|tsx?)$/i;
94
- /**
95
- * Ordered candidate list for resolving a relative JS/TS import specifier
96
- * (already resolved to an absolute base path) to an on-disk file, with
97
- * SOURCE-TWIN PREFERENCE (#694): on a repo that compiles in place, `./foo.js`
98
- * commonly has BOTH the written `foo.js` (compiled artifact) and a `foo.ts`
99
- * source sitting next to it. Trying the `.ts`/`.tsx` (or `.mts`/`.cts` for an
100
- * `.mjs`/`.cjs` specifier) twin BEFORE the literal/compiled extension means
101
- * the edge lands on the file developers actually edit; the compiled artifact
102
- * is only used when no source twin exists on disk (pure-JS projects, vendored
103
- * `.js`, or a genuinely JS-only import). Every candidate is still
104
- * existence-checked by the caller — a wrong guess can never fabricate an edge
105
- * to a file that isn't there, it just tries the next candidate.
106
- *
107
- * Shared between the cold module_report path ({@link resolveJsTs} below) and
108
- * the warm review-graph builder's `localImportToFile` (builder.ts) so the two
109
- * resolution paths can never diverge on which twin wins (#694 — a divergent
110
- * second mapping was exactly the kind of thing to avoid).
111
- */
112
- /**
113
- * Shared tail of {@link jsTsCandidatePaths} and the workspace-package subpath
114
- * resolver below (#775) — both need "given a base path (already stripped of
115
- * any known JS/TS extension) and the original extension (if any), produce the
116
- * source-twin-preferring candidate list." Only how `base`/`strippedBase` are
117
- * computed differs (relative-to-importing-file vs. relative-to-package-root).
118
- */
119
- function jsTsExtensionCandidates(base, strippedBase, ext) {
120
- const candidates = [];
121
- if (ext === ".mjs")
122
- candidates.push(`${strippedBase}.mts`);
123
- if (ext === ".cjs")
124
- candidates.push(`${strippedBase}.cts`);
125
- if (ext === ".mts")
126
- candidates.push(`${strippedBase}.mts`);
127
- if (ext === ".cts")
128
- candidates.push(`${strippedBase}.cts`);
129
- candidates.push(`${strippedBase}.ts`, `${strippedBase}.tsx`, `${strippedBase}.mts`, `${strippedBase}.cts`);
130
- // The literal specifier path (covers both "no extension in the specifier"
131
- // — base === strippedBase — and the compiled/as-written extension itself).
132
- candidates.push(base, `${strippedBase}.js`, `${strippedBase}.jsx`, `${strippedBase}.mjs`, `${strippedBase}.cjs`);
133
- for (const index of [
134
- "index.ts",
135
- "index.tsx",
136
- "index.mts",
137
- "index.cts",
138
- "index.js",
139
- "index.jsx",
140
- "index.mjs",
141
- "index.cjs",
142
- ]) {
143
- candidates.push(path.join(base, index));
144
- }
145
- return [...new Set(candidates)];
146
- }
147
- export function jsTsCandidatePaths(filePath, source) {
148
- const base = path.resolve(path.dirname(filePath), source);
149
- const strippedSource = source.replace(JS_TS_EXT_RE, "");
150
- const strippedBase = strippedSource === source
151
- ? base
152
- : path.resolve(path.dirname(filePath), strippedSource);
153
- const ext = path.extname(source).toLowerCase();
154
- return jsTsExtensionCandidates(base, strippedBase, ext);
155
- }
156
- /**
157
- * Longest-name match of a bare specifier against known workspace package
158
- * names, handling `@scope/pkg/subpath` imports (subpath is everything after
159
- * the matched name + "/"). "Longest" only matters for the theoretical case of
160
- * two workspace packages whose names are string-prefixes of one another
161
- * (`@scope/pkg` vs `@scope/pkg-two`) — the required "/" boundary already
162
- * makes that case unambiguous, but longest-match is kept as a defensive tie
163
- * breaker rather than relying on Map iteration order.
164
- */
165
- function findWorkspaceModuleForSpecifier(modules, source) {
166
- let best;
167
- for (const mod of modules) {
168
- let subpath;
169
- if (source === mod.name)
170
- subpath = "";
171
- else if (source.startsWith(`${mod.name}/`))
172
- subpath = source.slice(mod.name.length + 1);
173
- if (subpath === undefined)
174
- continue;
175
- if (!best || mod.name.length > best.mod.name.length)
176
- best = { mod, subpath };
177
- }
178
- return best;
179
- }
180
- /** First string found among `exports`'s "." condition (or the field itself if
181
- * it's a bare string) — covers the common `"exports": "./index.js"` and
182
- * `"exports": {".": {"import": "./index.js", ...}}` shapes. Anything more
183
- * exotic (subpath patterns, condition arrays) falls through to the
184
- * index.ts/js fallback below rather than guessing. */
185
- function pickExportsMain(exportsField) {
186
- if (typeof exportsField === "string")
187
- return exportsField;
188
- if (!exportsField || typeof exportsField !== "object")
189
- return undefined;
190
- const obj = exportsField;
191
- const dot = obj["."] ?? obj;
192
- if (typeof dot === "string")
193
- return dot;
194
- if (dot && typeof dot === "object") {
195
- for (const key of ["import", "require", "default"]) {
196
- const v = dot[key];
197
- if (typeof v === "string")
198
- return v;
199
- }
200
- }
201
- return undefined;
202
- }
203
- /** Candidate entry-file paths for a workspace package root: package.json's
204
- * `main`/`module`/`exports`-main first, then the conventional index files. */
205
- function workspaceEntryCandidates(pkgRoot) {
206
- let main;
207
- try {
208
- const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, "package.json"), "utf-8"));
209
- main = pickExportsMain(pkg.exports) ?? pkg.module ?? pkg.main;
210
- }
211
- catch {
212
- // missing/unreadable package.json — fall through to index candidates
213
- }
214
- const candidates = [];
215
- if (main) {
216
- const mainPath = path.resolve(pkgRoot, main);
217
- const ext = path.extname(mainPath).toLowerCase();
218
- const stripped = mainPath.replace(JS_TS_EXT_RE, "");
219
- candidates.push(...jsTsExtensionCandidates(mainPath, stripped, ext));
220
- }
221
- for (const base of [pkgRoot, path.join(pkgRoot, "src")]) {
222
- candidates.push(path.join(base, "index.ts"), path.join(base, "index.tsx"), path.join(base, "index.mts"), path.join(base, "index.cts"), path.join(base, "index.js"), path.join(base, "index.jsx"), path.join(base, "index.mjs"), path.join(base, "index.cjs"));
223
- }
224
- return [...new Set(candidates)];
225
- }
226
- /** Candidate paths for a workspace-package SUBPATH import (`@scope/pkg/foo`)
227
- * — same source-twin-preferring extension probe as a relative import, rooted
228
- * at the package dir instead of the importing file's dir. */
229
- function workspaceSubpathCandidates(pkgRoot, subpath) {
230
- const base = path.join(pkgRoot, subpath);
231
- const strippedSubpath = subpath.replace(JS_TS_EXT_RE, "");
232
- const strippedBase = strippedSubpath === subpath ? base : path.join(pkgRoot, strippedSubpath);
233
- const ext = path.extname(subpath).toLowerCase();
234
- return jsTsExtensionCandidates(base, strippedBase, ext);
235
- }
236
- /** Resolve tsconfig paths aliases before workspace-package matching. */
237
- export function resolveAliasedImport(cwd, specifier, importerDir) {
238
- for (const target of aliasedImportTargets(specifier, importerDir)) {
239
- const ext = path.extname(target).toLowerCase();
240
- const stripped = target.replace(JS_TS_EXT_RE, "");
241
- const found = firstExistingFile(cwd, jsTsExtensionCandidates(target, stripped, ext));
242
- if (found.length)
243
- return found;
244
- }
245
- return [];
246
- }
247
- /** Resolve an exact package name declared by a tsconfig project reference. */
248
- export function resolveProjectReferenceImport(cwd, specifier, importerDir) {
249
- const target = referencedProjectImportTarget(specifier, importerDir);
250
- return target ? firstExistingFile(cwd, [target]) : [];
251
- }
252
- /**
253
- * Resolve a bare specifier that names a sibling workspace package (npm/pnpm
254
- * workspaces, cargo, go.work — detected by `workspace-modules.ts`) to that
255
- * package's entry file, or a file within it for a subpath import (#775). A
256
- * specifier that doesn't match any known workspace package name returns []
257
- * — an ordinary third-party dependency stays `external:`, unchanged.
258
- *
259
- * `buildModuleGraph` memoizes the workspace scan per cwd, so this costs a
260
- * real filesystem scan only once per graph build (first bare specifier hit),
261
- * not once per import edge.
262
- */
263
- export function resolveWorkspacePackageImport(cwd, source) {
264
- if (source.startsWith("."))
265
- return [];
266
- const graph = buildModuleGraph(cwd);
267
- if (!graph)
268
- return [];
269
- const match = findWorkspaceModuleForSpecifier(graph.modules.values(), source);
270
- if (!match)
271
- return [];
272
- const candidates = match.subpath
273
- ? workspaceSubpathCandidates(match.mod.root, match.subpath)
274
- : workspaceEntryCandidates(match.mod.root);
275
- return firstExistingFile(cwd, candidates);
276
- }
277
- /**
278
- * Resolve a relative ESM import (`./x`, `../y`) to an in-project file — see
279
- * {@link jsTsCandidatePaths} for the source-twin-preferring candidate order.
280
- * A bare specifier (`react`, `@scope/pkg`) is resolved against known
281
- * workspace package names (#775 — see {@link resolveWorkspacePackageImport});
282
- * anything that isn't a recognized workspace package stays an external dep,
283
- * returning []. Used only on the COLD module_report path: the warm jsts
284
- * builder resolves imports via `localImportToFile` (builder.ts), which shares
285
- * both candidate lists.
286
- */
287
- function resolveJsTs(cwd, filePath, source) {
288
- if (!source.startsWith(".")) {
289
- const aliased = resolveAliasedImport(cwd, source, path.dirname(filePath));
290
- if (aliased.length)
291
- return aliased;
292
- const referenced = resolveProjectReferenceImport(cwd, source, path.dirname(filePath));
293
- return referenced.length
294
- ? referenced
295
- : resolveWorkspacePackageImport(cwd, source);
296
- }
297
- return firstExistingFile(cwd, jsTsCandidatePaths(filePath, source));
298
- }
299
- // --- C / C++ -----------------------------------------------------------------
300
- /**
301
- * Resolve a C/C++ `#include` to an in-project header (#302). A system header
302
- * (`<stdio.h>`, captured with its angle brackets) is a toolchain/library dep →
303
- * external, so it returns []. A quoted local include (`#include "foo.h"` →
304
- * `foo.h` after quote-strip) resolves against the same candidate roots the warm
305
- * graph's `resolveCxxInclude` uses (the including file's dir, then cwd / include /
306
- * src), so cold and warm agree on which file a local include points to.
307
- */
308
- function resolveCxx(cwd, filePath, source) {
309
- if (source.startsWith("<"))
310
- return [];
311
- const dir = path.dirname(path.resolve(filePath));
312
- return firstExistingFile(cwd, [
313
- path.resolve(dir, source),
314
- path.resolve(cwd, source),
315
- path.resolve(cwd, "include", source),
316
- path.resolve(cwd, "src", source),
317
- ]);
318
- }
319
- // --- Python -----------------------------------------------------------------
320
- /** Candidate source roots for an absolute dotted import. */
321
- function pythonRoots(cwd, fileDir) {
322
- // The package root is the first ancestor of the importing file that is NOT
323
- // itself a package (no __init__.py) — that's where a top-level `import a.b`
324
- // is anchored. Add cwd and cwd/src as conventional fallbacks.
325
- let p = fileDir;
326
- const root = path.resolve(cwd);
327
- while (isWithin(cwd, p) && isFile(path.join(p, "__init__.py"))) {
328
- const parent = path.dirname(p);
329
- if (parent === p)
330
- break;
331
- p = parent;
332
- }
333
- const roots = new Set([p, root, path.join(root, "src")]);
334
- return [...roots].filter((r) => isDir(r));
335
- }
336
- function resolvePython(cwd, filePath, source) {
337
- const fileDir = path.dirname(path.resolve(filePath));
338
- if (source.startsWith(".")) {
339
- // Relative import: leading dots = how far up, remainder = dotted subpath.
340
- const m = source.match(/^(\.+)(.*)$/);
341
- if (!m)
342
- return [];
343
- const dots = m[1].length;
344
- let baseDir = fileDir;
345
- for (let i = 1; i < dots; i++)
346
- baseDir = path.dirname(baseDir);
347
- const rest = m[2] ? m[2].split(".") : [];
348
- const target = path.join(baseDir, ...rest);
349
- return firstExistingFile(cwd, [
350
- `${target}.py`,
351
- path.join(target, "__init__.py"),
352
- ]);
353
- }
354
- const parts = source.split(".");
355
- for (const root of pythonRoots(cwd, fileDir)) {
356
- const target = path.join(root, ...parts);
357
- const found = firstExistingFile(cwd, [
358
- `${target}.py`,
359
- path.join(target, "__init__.py"),
360
- ]);
361
- if (found.length)
362
- return found;
363
- }
364
- return [];
365
- }
366
- // --- Go ---------------------------------------------------------------------
367
- /** Walk up from the importing file to a go.mod and read its `module` path. */
368
- function findGoModule(cwd, filePath) {
369
- let dir = path.dirname(path.resolve(filePath));
370
- const root = path.resolve(cwd);
371
- while (true) {
372
- try {
373
- const content = fs.readFileSync(path.join(dir, "go.mod"), "utf-8");
374
- const m = content.match(/^\s*module\s+(\S+)/m);
375
- if (m)
376
- return { moduleDir: dir, modulePath: m[1] };
377
- }
378
- catch {
379
- // no go.mod here — keep climbing
380
- }
381
- if (dir === root)
382
- break;
383
- const parent = path.dirname(dir);
384
- if (parent === dir || !isWithin(cwd, parent))
385
- break;
386
- dir = parent;
387
- }
388
- return null;
389
- }
390
- function resolveGo(cwd, filePath, source) {
391
- const mod = findGoModule(cwd, filePath);
392
- if (!mod)
393
- return [];
394
- // Only same-module import paths map to a local package directory; stdlib and
395
- // third-party paths (no module prefix) stay external.
396
- if (source !== mod.modulePath && !source.startsWith(`${mod.modulePath}/`)) {
397
- return [];
398
- }
399
- const rel = source === mod.modulePath ? "" : source.slice(mod.modulePath.length + 1);
400
- // A Go package is a directory; edge to every .go file in it (who-imports
401
- // works at file granularity). Exclude nothing — _test.go files import too.
402
- return sourceFilesIn(cwd, path.join(mod.moduleDir, rel), ".go");
403
- }
404
- // --- Java -------------------------------------------------------------------
405
- function javaSourceRoots(cwd, filePath) {
406
- const root = path.resolve(cwd);
407
- const roots = new Set();
408
- for (const c of ["src/main/java", "src/test/java", "src", ""]) {
409
- roots.add(path.join(root, c));
410
- }
411
- // The importing file's own source root is one of its ancestors, so a
412
- // same-project import resolves even on a non-conventional layout.
413
- let p = path.dirname(path.resolve(filePath));
414
- while (true) {
415
- roots.add(p);
416
- if (p === root)
417
- break;
418
- const parent = path.dirname(p);
419
- if (parent === p || !isWithin(cwd, parent))
420
- break;
421
- p = parent;
422
- }
423
- return [...roots].filter((r) => isDir(r));
424
- }
425
- function resolveJava(cwd, filePath, source) {
426
- const parts = source.split(".");
427
- for (const root of javaSourceRoots(cwd, filePath)) {
428
- // import a.b.Foo → a/b/Foo.java
429
- const asFile = firstExistingFile(cwd, [
430
- `${path.join(root, ...parts)}.java`,
431
- ]);
432
- if (asFile.length)
433
- return asFile;
434
- // import a.b.* (captured as a.b) → every .java in the package dir
435
- const asPkg = sourceFilesIn(cwd, path.join(root, ...parts), ".java");
436
- if (asPkg.length)
437
- return asPkg;
438
- // static import a.b.Foo.bar → drop the member, resolve the class file
439
- if (parts.length > 1) {
440
- const dropLast = firstExistingFile(cwd, [
441
- `${path.join(root, ...parts.slice(0, -1))}.java`,
442
- ]);
443
- if (dropLast.length)
444
- return dropLast;
445
- }
446
- }
447
- return [];
448
- }
449
- /**
450
- * Resolve a single tree-sitter import source to in-project file(s). Returns
451
- * normalized paths (possibly several — a Go/Java package is a directory) or `[]`
452
- * when the source isn't a resolvable in-project file (keep it as external).
453
- */
454
- export function resolveImportToFiles(cwd, filePath, languageId, source) {
455
- switch (languageId) {
456
- case "typescript":
457
- case "tsx":
458
- case "javascript":
459
- case "jsts":
460
- return resolveJsTs(cwd, filePath, source);
461
- case "c":
462
- case "cpp":
463
- return resolveCxx(cwd, filePath, source);
464
- case "ruby":
465
- return resolveRelative(cwd, filePath, source, [".rb"]);
466
- case "zig":
467
- return resolveRelative(cwd, filePath, source, [".zig"]);
468
- case "bash":
469
- return resolveRelative(cwd, filePath, source, [".sh", ".bash"]);
470
- case "dart":
471
- return resolveDart(cwd, filePath, source);
472
- case "python":
473
- return resolvePython(cwd, filePath, source);
474
- case "go":
475
- return resolveGo(cwd, filePath, source);
476
- case "java":
477
- return resolveJava(cwd, filePath, source);
478
- default:
479
- return [];
480
- }
481
- }
@@ -1,10 +0,0 @@
1
- import { serveGzipStageWorker, } from "../gzip-stage-write.js";
2
- // Streamed gzip stage write runs off the main thread via the shared core (see
3
- // clients/gzip-stage-write.ts); this worker only echoes its routing fields.
4
- serveGzipStageWorker((request) => ({
5
- id: request.id,
6
- cwd: request.cwd,
7
- generation: request.generation,
8
- stagePath: request.stagePath,
9
- elements: request.elements,
10
- }));