weavatrix 0.3.14 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (305) hide show
  1. package/LICENSE +1 -0
  2. package/README.md +231 -199
  3. package/bin/native/darwin-arm64/weavatrix +0 -0
  4. package/bin/native/darwin-x64/weavatrix +0 -0
  5. package/bin/native/linux-arm64/weavatrix +0 -0
  6. package/bin/native/linux-x64/weavatrix +0 -0
  7. package/bin/native/win32-arm64/weavatrix.exe +0 -0
  8. package/bin/native/win32-x64/weavatrix.exe +0 -0
  9. package/bin/resolve-binary.mjs +73 -0
  10. package/bin/run-native.mjs +26 -0
  11. package/bin/weavatrix-mcp.mjs +7 -6
  12. package/bin/weavatrix.mjs +5 -0
  13. package/package.json +8 -66
  14. package/skill/SKILL.md +62 -374
  15. package/skill/agents/openai.yaml +4 -0
  16. package/skill/references/tool-routing.md +45 -0
  17. package/SECURITY.md +0 -101
  18. package/docs/adr/0001-v0.3-offline-online-split.md +0 -60
  19. package/docs/agent-task-benchmark.md +0 -58
  20. package/docs/releases/v0.2.19.md +0 -33
  21. package/docs/releases/v0.3.0.md +0 -43
  22. package/docs/releases/v0.3.1.md +0 -30
  23. package/docs/releases/v0.3.10.md +0 -76
  24. package/docs/releases/v0.3.11.md +0 -55
  25. package/docs/releases/v0.3.12.md +0 -44
  26. package/docs/releases/v0.3.13.md +0 -34
  27. package/docs/releases/v0.3.14.md +0 -37
  28. package/docs/releases/v0.3.2.md +0 -15
  29. package/docs/releases/v0.3.3.md +0 -25
  30. package/docs/releases/v0.3.4.md +0 -40
  31. package/docs/releases/v0.3.5.md +0 -50
  32. package/docs/releases/v0.3.6.md +0 -44
  33. package/docs/releases/v0.3.7.md +0 -37
  34. package/docs/releases/v0.3.8.md +0 -21
  35. package/docs/releases/v0.3.9.md +0 -36
  36. package/scripts/run-agent-task-benchmark.mjs +0 -118
  37. package/src/analysis/allowed-test-runner.js +0 -70
  38. package/src/analysis/architecture/contract-graph.js +0 -119
  39. package/src/analysis/architecture/contract-schema.js +0 -110
  40. package/src/analysis/architecture/contract-storage.js +0 -35
  41. package/src/analysis/architecture/contract-verification.js +0 -168
  42. package/src/analysis/architecture-contract.js +0 -16
  43. package/src/analysis/audit-debt.js +0 -94
  44. package/src/analysis/audit-extensions.js +0 -60
  45. package/src/analysis/cargo-dependency-evidence.js +0 -108
  46. package/src/analysis/cargo-manifests.js +0 -81
  47. package/src/analysis/change-classification/diff-parser.js +0 -103
  48. package/src/analysis/change-classification/options.js +0 -40
  49. package/src/analysis/change-classification/symbol-classifier.js +0 -177
  50. package/src/analysis/change-classification.js +0 -188
  51. package/src/analysis/coverage-reports-tarpaulin.js +0 -112
  52. package/src/analysis/coverage-reports.js +0 -246
  53. package/src/analysis/cycle-route.js +0 -14
  54. package/src/analysis/data-flow-evidence.js +0 -114
  55. package/src/analysis/dead-check.js +0 -300
  56. package/src/analysis/dead-code-review/candidates.js +0 -194
  57. package/src/analysis/dead-code-review/policy.js +0 -23
  58. package/src/analysis/dead-code-review.js +0 -119
  59. package/src/analysis/dep-check-ecosystems.js +0 -205
  60. package/src/analysis/dep-check.js +0 -290
  61. package/src/analysis/dep-rules.js +0 -10
  62. package/src/analysis/dependency/conventions.js +0 -16
  63. package/src/analysis/dependency/scoped-dependencies.js +0 -51
  64. package/src/analysis/dependency/source-references.js +0 -21
  65. package/src/analysis/duplicate-groups.js +0 -104
  66. package/src/analysis/duplicates-worker.js +0 -11
  67. package/src/analysis/duplicates.compute.js +0 -269
  68. package/src/analysis/duplicates.js +0 -15
  69. package/src/analysis/duplicates.run.js +0 -52
  70. package/src/analysis/duplicates.tokenize.js +0 -199
  71. package/src/analysis/endpoints/common.js +0 -79
  72. package/src/analysis/endpoints/extract.js +0 -120
  73. package/src/analysis/endpoints/inventory.js +0 -84
  74. package/src/analysis/endpoints/mounts.js +0 -129
  75. package/src/analysis/endpoints-java.js +0 -260
  76. package/src/analysis/endpoints-rust.js +0 -124
  77. package/src/analysis/endpoints.js +0 -3
  78. package/src/analysis/findings.js +0 -70
  79. package/src/analysis/git-history/analytics.js +0 -177
  80. package/src/analysis/git-history/collector.js +0 -67
  81. package/src/analysis/git-history/options.js +0 -66
  82. package/src/analysis/git-history.js +0 -143
  83. package/src/analysis/git-ref-graph.js +0 -76
  84. package/src/analysis/go-dependency-evidence.js +0 -62
  85. package/src/analysis/graph-analysis.aggregate.js +0 -296
  86. package/src/analysis/graph-analysis.edges.js +0 -24
  87. package/src/analysis/graph-analysis.js +0 -7
  88. package/src/analysis/graph-analysis.refs.js +0 -202
  89. package/src/analysis/graph-analysis.summaries.js +0 -65
  90. package/src/analysis/health-capabilities.js +0 -83
  91. package/src/analysis/hot-path-review.js +0 -266
  92. package/src/analysis/http-contract-wrappers.js +0 -241
  93. package/src/analysis/http-contracts/analysis.js +0 -179
  94. package/src/analysis/http-contracts/client-call-detection.js +0 -82
  95. package/src/analysis/http-contracts/client-call-parser.js +0 -273
  96. package/src/analysis/http-contracts/graph-context.js +0 -143
  97. package/src/analysis/http-contracts/matching.js +0 -61
  98. package/src/analysis/http-contracts/shared.js +0 -85
  99. package/src/analysis/http-contracts.js +0 -6
  100. package/src/analysis/internal-audit/dependency-health.js +0 -113
  101. package/src/analysis/internal-audit/python-manifests.js +0 -78
  102. package/src/analysis/internal-audit/repo-files.js +0 -50
  103. package/src/analysis/internal-audit/supply-chain.js +0 -149
  104. package/src/analysis/internal-audit.collect.js +0 -213
  105. package/src/analysis/internal-audit.js +0 -9
  106. package/src/analysis/internal-audit.reach.js +0 -201
  107. package/src/analysis/internal-audit.run.js +0 -256
  108. package/src/analysis/java-source.js +0 -36
  109. package/src/analysis/jvm-artifact-index.js +0 -87
  110. package/src/analysis/jvm-dependency-evidence.js +0 -138
  111. package/src/analysis/jvm-manifests.js +0 -114
  112. package/src/analysis/manifests.js +0 -123
  113. package/src/analysis/package-reachability.js +0 -39
  114. package/src/analysis/source-complexity.ast.js +0 -97
  115. package/src/analysis/source-complexity.constants.js +0 -55
  116. package/src/analysis/source-complexity.js +0 -14
  117. package/src/analysis/source-complexity.report.js +0 -81
  118. package/src/analysis/source-complexity.walk.js +0 -228
  119. package/src/analysis/source-correctness/retry-patterns.js +0 -93
  120. package/src/analysis/source-correctness.js +0 -222
  121. package/src/analysis/static-test-reachability.js +0 -150
  122. package/src/analysis/structure/dependency-graph.js +0 -151
  123. package/src/analysis/structure/findings.js +0 -162
  124. package/src/analysis/task-retrieval.js +0 -107
  125. package/src/analysis/transport-contracts.js +0 -224
  126. package/src/analysis/transport-runtime-evidence.js +0 -155
  127. package/src/analysis-kit.mjs +0 -17
  128. package/src/bounds.js +0 -4
  129. package/src/build-graph.js +0 -209
  130. package/src/child-env.js +0 -7
  131. package/src/config.js +0 -5
  132. package/src/extension/local-services.mjs +0 -75
  133. package/src/git-exec.js +0 -67
  134. package/src/graph/build-worker.js +0 -49
  135. package/src/graph/builder/go-receiver-resolution.js +0 -112
  136. package/src/graph/builder/js/dynamic-import.js +0 -26
  137. package/src/graph/builder/js/queries.js +0 -48
  138. package/src/graph/builder/lang-csharp.js +0 -40
  139. package/src/graph/builder/lang-css.js +0 -29
  140. package/src/graph/builder/lang-go.js +0 -140
  141. package/src/graph/builder/lang-html.js +0 -29
  142. package/src/graph/builder/lang-java-calls.js +0 -142
  143. package/src/graph/builder/lang-java.js +0 -215
  144. package/src/graph/builder/lang-js.js +0 -291
  145. package/src/graph/builder/lang-python.js +0 -235
  146. package/src/graph/builder/lang-rust-calls.js +0 -63
  147. package/src/graph/builder/lang-rust.js +0 -299
  148. package/src/graph/builder/lang-solidity.js +0 -126
  149. package/src/graph/builder/lang-sql.js +0 -263
  150. package/src/graph/builder/pass2-resolution.js +0 -81
  151. package/src/graph/builder/spec-pkg.js +0 -87
  152. package/src/graph/community.js +0 -27
  153. package/src/graph/edge-provenance.js +0 -31
  154. package/src/graph/file-lock.js +0 -69
  155. package/src/graph/freshness-probe.js +0 -142
  156. package/src/graph/graph-filter.js +0 -63
  157. package/src/graph/incremental-refresh.js +0 -235
  158. package/src/graph/internal-builder.barrels.js +0 -235
  159. package/src/graph/internal-builder.build.js +0 -300
  160. package/src/graph/internal-builder.java.js +0 -33
  161. package/src/graph/internal-builder.js +0 -12
  162. package/src/graph/internal-builder.langs.js +0 -157
  163. package/src/graph/internal-builder.pass2.js +0 -163
  164. package/src/graph/internal-builder.resolvers.js +0 -286
  165. package/src/graph/layout.js +0 -51
  166. package/src/graph/node-id.js +0 -7
  167. package/src/graph/parser-artifact-boundary.js +0 -55
  168. package/src/graph/relations.js +0 -4
  169. package/src/graph/repo-registry.js +0 -124
  170. package/src/graph/resolvers/rust.js +0 -117
  171. package/src/infra/infra-items.js +0 -255
  172. package/src/infra/infra-registry.js +0 -184
  173. package/src/infra/infra.detect.js +0 -119
  174. package/src/infra/infra.js +0 -38
  175. package/src/infra/infra.match.js +0 -102
  176. package/src/infra/infra.scan.js +0 -93
  177. package/src/mcp/actions/graph-lifecycle.mjs +0 -148
  178. package/src/mcp/architecture-bootstrap.mjs +0 -168
  179. package/src/mcp/architecture-starter.mjs +0 -234
  180. package/src/mcp/catalog.mjs +0 -233
  181. package/src/mcp/company-contract-page.mjs +0 -142
  182. package/src/mcp/company-contract-reconcile.mjs +0 -87
  183. package/src/mcp/company-contract-verdict.mjs +0 -42
  184. package/src/mcp/evidence/bun-lock-graph.mjs +0 -209
  185. package/src/mcp/evidence/duplicate-member-order.mjs +0 -8
  186. package/src/mcp/evidence/package-graph-common.mjs +0 -115
  187. package/src/mcp/evidence/package-lock-graph.mjs +0 -92
  188. package/src/mcp/evidence-snapshot.architecture.mjs +0 -80
  189. package/src/mcp/evidence-snapshot.common.mjs +0 -158
  190. package/src/mcp/evidence-snapshot.duplicates.mjs +0 -213
  191. package/src/mcp/evidence-snapshot.health.mjs +0 -102
  192. package/src/mcp/evidence-snapshot.inventory.mjs +0 -148
  193. package/src/mcp/evidence-snapshot.mjs +0 -50
  194. package/src/mcp/evidence-snapshot.package-graph.mjs +0 -34
  195. package/src/mcp/evidence-snapshot.structure.mjs +0 -84
  196. package/src/mcp/extension-api.mjs +0 -77
  197. package/src/mcp/git-output.mjs +0 -7
  198. package/src/mcp/graph/context-core.mjs +0 -111
  199. package/src/mcp/graph/context-seeds.mjs +0 -207
  200. package/src/mcp/graph/context-state.mjs +0 -85
  201. package/src/mcp/graph/reverse-reach.mjs +0 -42
  202. package/src/mcp/graph/tools-core.mjs +0 -143
  203. package/src/mcp/graph/tools-query.mjs +0 -276
  204. package/src/mcp/graph-context.mjs +0 -5
  205. package/src/mcp/graph-diff.mjs +0 -218
  206. package/src/mcp/health/audit-format.mjs +0 -199
  207. package/src/mcp/health/audit.mjs +0 -199
  208. package/src/mcp/health/dead-code.mjs +0 -110
  209. package/src/mcp/health/duplicates.mjs +0 -121
  210. package/src/mcp/health/endpoints.mjs +0 -71
  211. package/src/mcp/health/structure.mjs +0 -220
  212. package/src/mcp/runtime-version.mjs +0 -31
  213. package/src/mcp/server/auto-refresh.mjs +0 -66
  214. package/src/mcp/server/runtime-config.mjs +0 -43
  215. package/src/mcp/server/shutdown.mjs +0 -40
  216. package/src/mcp/staleness-notice.mjs +0 -20
  217. package/src/mcp/sync/evidence-architecture.mjs +0 -54
  218. package/src/mcp/sync/evidence-common.mjs +0 -88
  219. package/src/mcp/sync/evidence-duplicates.mjs +0 -97
  220. package/src/mcp/sync/evidence-health.mjs +0 -56
  221. package/src/mcp/sync/evidence-packages.mjs +0 -95
  222. package/src/mcp/sync/payload-common.mjs +0 -97
  223. package/src/mcp/sync/payload-v2.mjs +0 -54
  224. package/src/mcp/sync/payload-v3.mjs +0 -79
  225. package/src/mcp/sync-evidence.mjs +0 -23
  226. package/src/mcp/sync-payload.mjs +0 -70
  227. package/src/mcp/tool-result.mjs +0 -54
  228. package/src/mcp/tools-actions.mjs +0 -11
  229. package/src/mcp/tools-architecture.mjs +0 -177
  230. package/src/mcp/tools-company.mjs +0 -251
  231. package/src/mcp/tools-context.mjs +0 -222
  232. package/src/mcp/tools-endpoints.mjs +0 -207
  233. package/src/mcp/tools-graph-hubs.mjs +0 -78
  234. package/src/mcp/tools-graph.mjs +0 -17
  235. package/src/mcp/tools-health.mjs +0 -24
  236. package/src/mcp/tools-history.mjs +0 -28
  237. package/src/mcp/tools-impact-change.mjs +0 -220
  238. package/src/mcp/tools-impact-precision.mjs +0 -89
  239. package/src/mcp/tools-impact.mjs +0 -169
  240. package/src/mcp/tools-source.mjs +0 -238
  241. package/src/mcp/tools-verified-change.mjs +0 -200
  242. package/src/mcp-rg.mjs +0 -50
  243. package/src/mcp-runtime.mjs +0 -2
  244. package/src/mcp-server.mjs +0 -298
  245. package/src/mcp-source-tools.mjs +0 -163
  246. package/src/path-classification.js +0 -226
  247. package/src/path-ignore.js +0 -69
  248. package/src/precision/lsp-client/constants.js +0 -12
  249. package/src/precision/lsp-client/environment.js +0 -20
  250. package/src/precision/lsp-client/errors.js +0 -15
  251. package/src/precision/lsp-client/lifecycle.js +0 -114
  252. package/src/precision/lsp-client/message-parser.js +0 -81
  253. package/src/precision/lsp-client/protocol.js +0 -212
  254. package/src/precision/lsp-client/registry.js +0 -59
  255. package/src/precision/lsp-client/repo-uri.js +0 -60
  256. package/src/precision/lsp-client/stdio-client.js +0 -140
  257. package/src/precision/lsp-client.js +0 -10
  258. package/src/precision/lsp-overlay/budget-policy.js +0 -78
  259. package/src/precision/lsp-overlay/build.js +0 -261
  260. package/src/precision/lsp-overlay/contract.js +0 -61
  261. package/src/precision/lsp-overlay/reference-results.js +0 -108
  262. package/src/precision/lsp-overlay/semantic-inputs.js +0 -62
  263. package/src/precision/lsp-overlay/source-session.js +0 -142
  264. package/src/precision/lsp-overlay/store.js +0 -150
  265. package/src/precision/lsp-overlay/target-index.js +0 -152
  266. package/src/precision/lsp-overlay/target-query.js +0 -55
  267. package/src/precision/lsp-overlay.js +0 -11
  268. package/src/precision/symbol-query.js +0 -224
  269. package/src/precision/typescript-lsp-provider.js +0 -12
  270. package/src/precision/typescript-provider/client.js +0 -89
  271. package/src/precision/typescript-provider/discovery.js +0 -124
  272. package/src/precision/typescript-provider/isolated-runtime.js +0 -39
  273. package/src/precision/typescript-provider/project-host.js +0 -254
  274. package/src/precision/typescript-provider/project-safety.js +0 -166
  275. package/src/precision/typescript-provider/reference-usage.js +0 -53
  276. package/src/process.js +0 -95
  277. package/src/repo-path.js +0 -53
  278. package/src/scan/discover.inventory.js +0 -78
  279. package/src/scan/discover.js +0 -5
  280. package/src/scan/discover.list.js +0 -79
  281. package/src/scan/discover.stack.js +0 -227
  282. package/src/scan/search.core.js +0 -24
  283. package/src/scan/search.git.js +0 -102
  284. package/src/scan/search.js +0 -9
  285. package/src/scan/search.node.js +0 -83
  286. package/src/scan/search.preview.js +0 -49
  287. package/src/scan/search.rg.js +0 -145
  288. package/src/security/advisory-store.js +0 -172
  289. package/src/security/installed-jvm-rust.js +0 -46
  290. package/src/security/installed.js +0 -280
  291. package/src/security/malware-file-heuristics.js +0 -121
  292. package/src/security/malware-heuristics.exclusions.js +0 -134
  293. package/src/security/malware-heuristics.js +0 -15
  294. package/src/security/malware-heuristics.roots.js +0 -145
  295. package/src/security/malware-heuristics.scan.js +0 -89
  296. package/src/security/malware-heuristics.sweep.js +0 -122
  297. package/src/security/malware-scoring.js +0 -105
  298. package/src/security/match.js +0 -85
  299. package/src/security/registry-sig.classify.js +0 -137
  300. package/src/security/registry-sig.js +0 -18
  301. package/src/security/registry-sig.rules.js +0 -192
  302. package/src/security/rust-advisory-report.js +0 -60
  303. package/src/security/typosquat.js +0 -81
  304. package/src/util.js +0 -40
  305. package/src/version.js +0 -7
@@ -1,291 +0,0 @@
1
- // JS / TS / JSX / TSX extractor for the built-in graph builder.
2
- // Symbols: functions, generators, classes, methods, top-level const/let/var (data + arrow/fn consts).
3
- // Imports: ESM `import`, CJS `require`, path-aliases (tsconfig/vite), and barrel re-exports (`export … from`).
4
- // Calls: bare `foo()`. Heritage: `class X extends Y`. Everything runs through the shared ctx (see internal-builder.js).
5
- import {
6
- CALLABLE, FUNCS, TOPVARS, TYPES, REQUIRE, parseExportSpecifiers,
7
- importTypeOnly, reexportTypeOnly,
8
- } from './js/queries.js';
9
- import {boundedUrlImportTarget} from './js/dynamic-import.js';
10
-
11
- export default {
12
- family: "js",
13
- grammars: ["javascript", "typescript", "tsx"],
14
- exts: { ".js": "javascript", ".jsx": "javascript", ".mjs": "javascript", ".cjs": "javascript", ".ts": "typescript", ".tsx": "tsx" },
15
- isWeb: false,
16
- calls: `(call_expression function: (identifier) @callee)`,
17
- heritage: [`(class_heritage (identifier) @super)`, `(class_heritage (extends_clause value: (identifier) @super))`],
18
-
19
- pass1(ctx) {
20
- const { grammar, tree, fileRel, caps, field, addSym, addImportEdge, addExternalImport, markExported, imports, resolveJsImport, resolveAlias } = ctx;
21
- const recordJsExport = typeof ctx.recordJsExport === "function" ? ctx.recordJsExport : () => {};
22
- // exported-ness of a declaration = an export_statement ancestor (export function/class/const …).
23
- // BOUNDED climb: web-tree-sitter's node.parent is O(depth) (re-walks a cursor from the root each call),
24
- // so an UNBOUNDED walk to `program` for every symbol was O(depth^3) and HUNG the build for minutes/hours
25
- // on deeply-nested / minified / bundled JS (regression). An export_statement is always a NEAR ancestor of
26
- // the declaration head (≤ ~5 hops), and hitting a statement_block means we're nested inside a function →
27
- // not a module-level export → bail immediately. See [[graph-builder-internalization]].
28
- // Early-out for nested scopes keeps this O(1); class members are intentionally never module exports even
29
- // when their owner class is exported. The hop cap remains a backstop for malformed/deep syntax trees.
30
- const exportStatementOf = (node) => {
31
- let p = node.parent;
32
- for (let hops = 0; p && hops < 6; hops++) {
33
- if (p.type === "export_statement") return p;
34
- if (p.type === "program" || p.type === "statement_block" || p.type === "class_body") return null;
35
- p = p.parent;
36
- }
37
- return null;
38
- };
39
- const isExportedDecl = (node) => !!exportStatementOf(node);
40
- const isModuleDeclaration = (node) => {
41
- let p = node.parent;
42
- for (let hops = 0; p && hops < 8; hops++) {
43
- if (p.type === "program") return true;
44
- if (p.type === "statement_block" || p.type === "class_body") return false;
45
- p = p.parent;
46
- }
47
- return false;
48
- };
49
- // a bare (package) specifier = non-relative AND not a path alias; alias-that-missed is a broken local, not a dep
50
- const isBareSpec = (spec) => !!spec && !spec.startsWith(".") && resolveAlias(fileRel, spec) == null;
51
- // broken local import (relative or alias path resolving to no file) — recorded for the "unresolved-import"
52
- // finding. Asset imports (svg/css-modules-adjacent/fonts/…) and ?query-suffixed specs that resolve once
53
- // the query is stripped (Vite ?raw/?url/?worker) are NOT code-graph concerns.
54
- const ASSET_RE = /\.(svg|png|jpe?g|gif|webp|avif|ico|bmp|woff2?|ttf|eot|otf|mp[34]|webm|wasm|pdf|txt|md|html?)$/i;
55
- const recordUnresolved = (rawSpec, kind, line, typeOnly = false) => {
56
- const clean = String(rawSpec || "").split("?")[0];
57
- if (!clean || ASSET_RE.test(clean)) return;
58
- if (clean !== rawSpec && resolveJsImport(fileRel, clean)) return; // only the ?query broke resolution
59
- addExternalImport({ spec: rawSpec, kind, line, unresolved: true, typeOnly });
60
- };
61
-
62
- // ---- symbols (export flag captured at declaration time) ----
63
- const methodMetadata = (nameNode) => {
64
- let method = nameNode.parent;
65
- while (method && method.type !== "method_definition") method = method.parent;
66
- let owner = method?.parent;
67
- while (owner && !["class_declaration", "class"].includes(owner.type)) owner = owner.parent;
68
- const ownerName = owner && field(owner, "name")?.text;
69
- const visibility = /^\s*private\b/.test(method?.text || "") ? "private"
70
- : /^\s*protected\b/.test(method?.text || "") ? "protected" : "public";
71
- return { symbolKind: "method", ...(ownerName ? { memberOf: ownerName } : {}), visibility };
72
- };
73
- for (const cap of caps(grammar, FUNCS, tree.rootNode)) {
74
- const isMethod = cap.name === "method";
75
- const exportStatement = !isMethod && exportStatementOf(cap.node);
76
- addSym(cap.node.text, cap.node.startPosition.row + 1, cap.name !== "class", {
77
- sourceNode: cap.node.parent,
78
- selectionNode: cap.node,
79
- ...(exportStatement ? { exported: true } : {}),
80
- ...(isMethod
81
- ? {...methodMetadata(cap.node), symbolSpace: "value"}
82
- : {
83
- symbolKind: cap.name === "class" ? "class" : "function",
84
- symbolSpace: cap.name === "class" ? "both" : "value",
85
- moduleDeclaration: isModuleDeclaration(cap.node),
86
- })
87
- });
88
- if (exportStatement) {
89
- recordJsExport({
90
- kind: "local",
91
- exported: /^\s*export\s+default\b/.test(exportStatement.text) ? "default" : cap.node.text,
92
- local: cap.node.text,
93
- typeOnly: false,
94
- line: exportStatement.startPosition.row + 1,
95
- });
96
- }
97
- }
98
- for (const cap of caps(grammar, TOPVARS, tree.rootNode)) {
99
- const nameNode = field(cap.node, "name"); if (!nameNode || nameNode.type !== "identifier") continue;
100
- const val = field(cap.node, "value");
101
- const exported = isExportedDecl(cap.node);
102
- addSym(nameNode.text, nameNode.startPosition.row + 1, !!(val && CALLABLE.test(val.type)), {
103
- sourceNode: val || cap.node,
104
- selectionNode: nameNode,
105
- ...(exported ? { exported: true } : {}),
106
- symbolKind: "variable",
107
- symbolSpace: "value",
108
- moduleDeclaration: true
109
- });
110
- if (exported) recordJsExport({
111
- kind: "local", exported: nameNode.text, local: nameNode.text, typeOnly: false,
112
- line: exportStatementOf(cap.node)?.startPosition.row + 1 || nameNode.startPosition.row + 1,
113
- });
114
- }
115
-
116
- // TypeScript has separate type and value namespaces. Keep interface/type declarations as
117
- // first-class type-space nodes instead of folding them into a same-named runtime declaration.
118
- // Enums and classes intentionally occupy both spaces because TypeScript emits runtime values.
119
- if (grammar !== "javascript") for (const cap of caps(grammar, TYPES, tree.rootNode)) {
120
- const declaration = cap.node.parent;
121
- const exportStatement = exportStatementOf(cap.node);
122
- const symbolKind = cap.name === "interface" ? "interface" : cap.name === "type" ? "type" : "enum";
123
- const symbolSpace = cap.name === "enum" ? "both" : "type";
124
- addSym(cap.node.text, cap.node.startPosition.row + 1, false, {
125
- sourceNode: declaration,
126
- selectionNode: cap.node,
127
- idSuffix: symbolSpace === "type" ? ":type" : "",
128
- ...(exportStatement ? {exported: true} : {}),
129
- symbolKind,
130
- symbolSpace,
131
- moduleDeclaration: isModuleDeclaration(cap.node),
132
- });
133
- if (exportStatement) recordJsExport({
134
- kind: "local",
135
- exported: cap.node.text,
136
- local: cap.node.text,
137
- typeOnly: symbolSpace === "type",
138
- line: exportStatement.startPosition.row + 1,
139
- symbolSpace,
140
- });
141
- }
142
-
143
- // ---- ESM imports ----
144
- for (const cap of caps(grammar, `(import_statement) @imp`, tree.rootNode)) {
145
- const node = cap.node; const srcNode = field(node, "source");
146
- const rawSpec = srcNode ? srcNode.text.replace(/^['"`]|['"`]$/g, "") : "";
147
- const line = node.startPosition.row + 1;
148
- const typeOnly = importTypeOnly(node);
149
- const tgt = resolveJsImport(fileRel, rawSpec);
150
- if (!tgt) {
151
- if (isBareSpec(rawSpec)) addExternalImport({ spec: rawSpec, kind: "esm", line, typeOnly });
152
- else if (rawSpec) recordUnresolved(rawSpec, "esm", line, typeOnly);
153
- continue;
154
- }
155
- addImportEdge(tgt, { typeOnly, line, specifier: rawSpec });
156
- const clause = node.namedChildren.find((c) => c.type === "import_clause"); if (!clause) continue;
157
- for (const c of clause.namedChildren) {
158
- if (c.type === "identifier") imports.set(c.text, { imported: "default", targetFile: tgt, typeOnly, line, specifier: rawSpec });
159
- else if (c.type === "namespace_import") { const id = c.namedChildren.find((x) => x.type === "identifier"); if (id) imports.set(id.text, { imported: "*", targetFile: tgt, typeOnly, line, specifier: rawSpec }); }
160
- else if (c.type === "named_imports") for (const s of c.namedChildren) { if (s.type !== "import_specifier") continue; const nm = field(s, "name"), al = field(s, "alias"); if (nm) imports.set((al || nm).text, { imported: nm.text, targetFile: tgt, typeOnly: typeOnly || /^\s*type\b/.test(s.text), line, specifier: rawSpec }); }
161
- }
162
- }
163
-
164
- // ---- CJS require (declarator form: local bindings + import edges) ----
165
- for (const cap of caps(grammar, REQUIRE, tree.rootNode)) {
166
- if (cap.name !== "src") continue;
167
- let dv = cap.node; while (dv && dv.type !== "variable_declarator") dv = dv.parent;
168
- const tgt = resolveJsImport(fileRel, cap.node.text); if (!tgt) continue;
169
- addImportEdge(tgt, { typeOnly: false, line: cap.node.startPosition.row + 1, specifier: cap.node.text });
170
- const lhs = dv && field(dv, "name");
171
- if (lhs && lhs.type === "identifier") imports.set(lhs.text, { imported: "*", targetFile: tgt, line: cap.node.startPosition.row + 1, specifier: cap.node.text });
172
- else if (lhs && lhs.type === "object_pattern") for (const p of lhs.namedChildren) { const key = field(p, "key") || (p.type === "shorthand_property_identifier_pattern" ? p : null); const val = field(p, "value"); const local = (val && val.type === "identifier") ? val : key; if (key && local) imports.set(local.text, { imported: key.text, targetFile: tgt, line: cap.node.startPosition.row + 1, specifier: cap.node.text }); }
173
- }
174
-
175
- // ---- CJS require, ALL forms (side-effect require("dotenv/config") included): bare-pkg records +
176
- // non-literal require(x) → dynamic marker so dep analysis can suppress false "unused" positives ----
177
- for (const cap of caps(grammar, `(call_expression function: (identifier) @fn)`, tree.rootNode)) {
178
- if (cap.node.text !== "require") continue;
179
- const call = cap.node.parent; const args = field(call, "arguments");
180
- const arg = args && args.namedChildren ? args.namedChildren[0] : null;
181
- const line = call.startPosition.row + 1;
182
- if (arg && arg.type === "string") {
183
- const rawSpec = arg.text.replace(/^['"`]|['"`]$/g, "");
184
- if (resolveJsImport(fileRel, rawSpec)) continue;
185
- if (isBareSpec(rawSpec)) addExternalImport({ spec: rawSpec, kind: "cjs", line });
186
- else recordUnresolved(rawSpec, "cjs", line);
187
- } else {
188
- addExternalImport({ dynamic: true, kind: "cjs", line });
189
- }
190
- }
191
-
192
- // ---- dynamic import(): literal bare → package record; literal local → dynamic marker with target;
193
- // non-literal → bare dynamic marker ----
194
- for (const cap of caps(grammar, `(call_expression function: (import) @imp)`, tree.rootNode)) {
195
- const call = cap.node.parent; const args = field(call, "arguments");
196
- const arg = args && args.namedChildren ? args.namedChildren[0] : null;
197
- const line = call.startPosition.row + 1;
198
- if (arg && arg.type === "string") {
199
- const rawSpec = arg.text.replace(/^['"`]|['"`]$/g, "");
200
- const tgt = resolveJsImport(fileRel, rawSpec);
201
- if (tgt) addExternalImport({ dynamic: true, spec: rawSpec, target: tgt, kind: "dynamic", line });
202
- else if (isBareSpec(rawSpec)) addExternalImport({ spec: rawSpec, kind: "dynamic", line });
203
- else if (rawSpec) recordUnresolved(rawSpec, "dynamic", line);
204
- } else {
205
- const bounded = boundedUrlImportTarget(arg, {field, fileRel, resolveJsImport});
206
- addExternalImport({ dynamic: true, kind: "dynamic", line, ...(bounded ? {spec: bounded.rawSpec, target: bounded.target} : {}) });
207
- }
208
- }
209
-
210
- // ---- re-exports (barrel/index files): edge so the real target isn't falsely DEAD; bare source → external ----
211
- for (const cap of caps(grammar, `(export_statement) @exp`, tree.rootNode)) {
212
- const node = cap.node; const srcNode = field(node, "source");
213
- if (!srcNode) continue;
214
- const rawSpec = srcNode.text.replace(/^['"`]|['"`]$/g, "");
215
- const line = node.startPosition.row + 1;
216
- const typeOnly = reexportTypeOnly(node);
217
- const tgt = resolveJsImport(fileRel, rawSpec);
218
- if (tgt) {
219
- addImportEdge(tgt, { relation: "re_exports", typeOnly, line, specifier: rawSpec });
220
- const text = node.text.trim();
221
- const star = text.match(/^export\s+(type\s+)?\*\s+from\b/);
222
- const namespace = text.match(/^export\s+(type\s+)?\*\s+as\s+([A-Za-z_$][\w$]*)\s+from\b/);
223
- const clause = text.match(/^export\s+(type\s+)?\{([\s\S]*?)\}\s+from\b/);
224
- if (namespace) {
225
- recordJsExport({ kind: "namespace", exported: namespace[2], imported: "*", targetFile: tgt, typeOnly: !!namespace[1], line, specifier: rawSpec });
226
- } else if (star) {
227
- recordJsExport({ kind: "star", exported: "*", imported: "*", targetFile: tgt, typeOnly: !!star[1], line, specifier: rawSpec });
228
- } else if (clause) {
229
- for (const spec of parseExportSpecifiers(clause[2])) {
230
- recordJsExport({ kind: "named", exported: spec.exported, imported: spec.imported, targetFile: tgt, typeOnly: !!clause[1] || spec.typeOnly, line, specifier: rawSpec });
231
- }
232
- }
233
- }
234
- else if (isBareSpec(rawSpec)) addExternalImport({ spec: rawSpec, kind: "reexport", line, typeOnly });
235
- else if (rawSpec) recordUnresolved(rawSpec, "reexport", line, typeOnly);
236
- }
237
-
238
- // Local aliases (`export { internal as publicName }`) and default identifiers are part of the
239
- // same export table used by the post-pass barrel resolver. Sourced clauses were recorded above.
240
- for (const cap of caps(grammar, `(export_statement) @exp`, tree.rootNode)) {
241
- const node = cap.node;
242
- if (field(node, "source")) continue;
243
- const text = node.text.trim();
244
- const clause = text.match(/^export\s+(type\s+)?\{([\s\S]*?)\}/);
245
- if (clause) for (const spec of parseExportSpecifiers(clause[2])) {
246
- recordJsExport({ kind: "local", exported: spec.exported, local: spec.imported, typeOnly: !!clause[1] || spec.typeOnly, line: node.startPosition.row + 1 });
247
- }
248
- const identifierDefault = text.match(/^export\s+default\s+([A-Za-z_$][\w$]*)\s*;?$/);
249
- if (identifierDefault) recordJsExport({ kind: "local", exported: "default", local: identifierDefault[1], typeOnly: false, line: node.startPosition.row + 1 });
250
- const defaultValue = field(node, "value");
251
- if (defaultValue?.type === "object") {
252
- // Service facades commonly expose local helpers through `export default { getSchema,
253
- // save: persist }`. Record the public member -> local binding instead of treating the
254
- // object as an opaque default export.
255
- recordJsExport({kind: "facade-root", exported: "default", local: "default", typeOnly: false, line: node.startPosition.row + 1});
256
- for (const property of defaultValue.namedChildren || []) {
257
- if (["shorthand_property_identifier", "shorthand_property_identifier_pattern"].includes(property.type)) {
258
- recordJsExport({kind: "facade-member", member: property.text, local: property.text, typeOnly: false, line: node.startPosition.row + 1});
259
- markExported(property.text);
260
- continue;
261
- }
262
- if (property.type !== "pair") continue;
263
- const key = field(property, "key");
264
- const value = field(property, "value");
265
- if (!key || value?.type !== "identifier") continue;
266
- const member = key.text.replace(/^['"`]|['"`]$/g, "");
267
- if (!/^[A-Za-z_$][\w$]*$/.test(member)) continue;
268
- recordJsExport({kind: "facade-member", member, local: value.text, typeOnly: false, line: node.startPosition.row + 1});
269
- markExported(value.text);
270
- }
271
- }
272
- }
273
-
274
- // ---- export markers beyond declarations: `export { a, b }`, `export default X`, CJS module.exports ----
275
- for (const cap of caps(grammar, `(export_statement (export_clause (export_specifier name: (identifier) @n)))`, tree.rootNode)) {
276
- let st = cap.node.parent; while (st && st.type !== "export_statement") st = st.parent;
277
- if (st && !field(st, "source")) markExported(cap.node.text); // with a source it's a re-export, not a local symbol
278
- }
279
- for (const cap of caps(grammar, `(export_statement value: (identifier) @def)`, tree.rootNode)) markExported(cap.node.text);
280
- for (const cap of caps(grammar, `(assignment_expression left: (member_expression) @lhs right: (identifier) @rhs)`, tree.rootNode)) {
281
- if (cap.name !== "rhs") continue;
282
- const lhs = field(cap.node.parent, "left"); const l = lhs ? lhs.text : "";
283
- if (l === "module.exports" || l.startsWith("exports.") || l.startsWith("module.exports.")) markExported(cap.node.text);
284
- }
285
- for (const cap of caps(grammar, `(assignment_expression left: (member_expression) right: (object (shorthand_property_identifier) @p))`, tree.rootNode)) {
286
- let ae = cap.node.parent; while (ae && ae.type !== "assignment_expression") ae = ae.parent;
287
- const lhs = ae && field(ae, "left");
288
- if (lhs && (lhs.text === "module.exports" || lhs.text.startsWith("exports."))) markExported(cap.node.text);
289
- }
290
- },
291
- };
@@ -1,235 +0,0 @@
1
- // Python extractor. Symbols: def/class (methods included) + module-level assignments (data consts).
2
- // Imports: `import a.b [as c]` and `from [.]*mod import name [as alias]` with dotted + relative (leading-dot)
3
- // resolution to <path>.py / <path>/__init__.py — tried from the repo root, src/ (src-layout), and the
4
- // importing file's own directory (script-style sys.path). Absolute imports that resolve to NO repo file
5
- // are recorded as external imports (stdlib → builtin, else ecosystem "PyPI") for dependency analysis.
6
- // Calls: bare `foo()`. Heritage: class superclasses.
7
- import { pySpecToPkg, PY_STDLIB } from "./spec-pkg.js";
8
-
9
- export default {
10
- family: "py",
11
- grammars: ["python"],
12
- exts: { ".py": "python", ".pyi": "python" },
13
- isWeb: false,
14
- customCalls: true,
15
- calls: `(call function: (identifier) @callee)`,
16
- heritage: [`(class_definition superclasses: (argument_list (identifier) @super))`],
17
-
18
- pass1(ctx) {
19
- const { grammar, tree, fileRel, code, caps, field, addSym, addImportEdge, addExternalImport, markExported, imports, links, nameToId, resolvePyPath, pyBaseDir, pyTopDirs } = ctx;
20
- // the importing file's own dir is on sys.path when it runs as a script — try siblings for absolute
21
- // imports, EXCEPT stdlib names (a sibling logging.py must not shadow `import logging`; py3 absolute
22
- // imports always pick the stdlib, and a wrong internal edge distorts dead-code + reachability)
23
- const scriptDir = pyBaseDir(fileRel, 1);
24
- const resolveAbs = (parts) => resolvePyPath("", parts) || (scriptDir && !PY_STDLIB.has(parts[0]) ? resolvePyPath(scriptDir, parts) : null);
25
- const recordExternal = (dottedName, line) => {
26
- const top = String(dottedName).split(".")[0];
27
- if (pyTopDirs && pyTopDirs.has(top)) return; // repo-local namespace package (no __init__.py) — internal, not a dep
28
- const r = pySpecToPkg(top);
29
- if (r && !r.ambiguous) addExternalImport({ spec: dottedName, pkg: r.pkg, builtin: r.builtin, ecosystem: "PyPI", kind: "py-import", line });
30
- };
31
-
32
- // ---- symbols (decorated defs are framework-entered — @app.route/@app.event/@pytest.fixture — the
33
- // flag keeps dead-code checks from calling them dead; tree wraps them in decorated_definition) ----
34
- const ownedMethods = [];
35
- for (const cap of caps(grammar, `(function_definition name: (identifier) @fn) (class_definition name: (identifier) @class)`, tree.rootNode)) {
36
- const decorated = cap.node.parent?.parent?.type === "decorated_definition";
37
- let ownerName = null;
38
- if (cap.name === "fn") {
39
- let parent = cap.node.parent?.parent;
40
- while (parent && !["function_definition", "class_definition", "module"].includes(parent.type)) parent = parent.parent;
41
- if (parent?.type === "class_definition") ownerName = field(parent, "name")?.text || null;
42
- }
43
- const visibility = /^__[^_].*/.test(cap.node.text) ? "private"
44
- : /^_[^_]/.test(cap.node.text) ? "protected" : "public";
45
- const id = addSym(cap.node.text, cap.node.startPosition.row + 1, cap.name === "fn", {
46
- sourceNode: cap.node.parent,
47
- selectionNode: cap.node,
48
- ...(decorated ? { decorated: true } : {}),
49
- symbolKind: cap.name === "class" ? "class" : ownerName ? "method" : "function",
50
- ...(ownerName ? {memberOf: ownerName, visibility} : {moduleDeclaration: true}),
51
- });
52
- if (ownerName) ownedMethods.push({ownerName, id});
53
- }
54
- for (const method of ownedMethods) {
55
- const ownerId = nameToId.get(method.ownerName);
56
- if (ownerId) links.push({source: ownerId, target: method.id, relation: "contains", confidence: "EXTRACTED"});
57
- }
58
- for (const cap of caps(grammar, `(module (expression_statement (assignment left: (identifier) @var)))`, tree.rootNode))
59
- addSym(cap.node.text, cap.node.startPosition.row + 1, false, { sourceNode: cap.node.parent, selectionNode: cap.node, symbolKind: "variable", moduleDeclaration: true });
60
-
61
- // Static __all__ is authoritative for wildcard imports. The assignment itself remains indexed,
62
- // while listed declarations are marked as the explicit public module surface.
63
- const allMatch = String(code || "").match(/(?:^|\n)\s*__all__\s*=\s*[\[(]([\s\S]*?)[\])]/m);
64
- if (allMatch) for (const match of allMatch[1].matchAll(/["']([A-Za-z_]\w*)["']/g)) markExported(match[1]);
65
-
66
- // ---- import a.b [as c] ----
67
- for (const cap of caps(grammar, `(import_statement) @imp`, tree.rootNode)) {
68
- for (const child of cap.node.namedChildren) {
69
- const modNode = child.type === "aliased_import" ? field(child, "name") : (child.type === "dotted_name" ? child : null);
70
- if (!modNode) continue;
71
- const parts = modNode.text.split(".");
72
- const tgt = resolveAbs(parts);
73
- if (tgt) { addImportEdge(tgt); const local = child.type === "aliased_import" ? field(child, "alias")?.text : parts[0]; if (local) imports.set(local, { imported: "*", targetFile: tgt }); }
74
- else recordExternal(modNode.text, modNode.startPosition.row + 1);
75
- }
76
- }
77
-
78
- // ---- from [.]*mod import name [, name as alias] ----
79
- for (const cap of caps(grammar, `(import_from_statement) @imp`, tree.rootNode)) {
80
- const node = cap.node; const modNode = field(node, "module_name");
81
- let dots = 0, modParts = [];
82
- if (modNode) {
83
- if (modNode.type === "relative_import") { const t = modNode.text; while (dots < t.length && t[dots] === ".") dots++; const rest = t.slice(dots); modParts = rest ? rest.split(".") : []; }
84
- else if (modNode.type === "dotted_name") modParts = modNode.text.split(".");
85
- }
86
- const baseDir = pyBaseDir(fileRel, dots);
87
- const wildcard = node.namedChildren.some((child) => child.type === "wildcard_import");
88
- if (wildcard) {
89
- const modFile = resolvePyPath(baseDir, modParts) || (dots === 0 ? resolveAbs(modParts) : null);
90
- if (modFile) {
91
- addImportEdge(modFile);
92
- imports.set(`*:${node.startPosition.row + 1}`, {imported: "*", targetFile: modFile, wildcard: true, line: node.startPosition.row + 1});
93
- } else if (dots === 0 && modParts.length) recordExternal(modParts.join("."), node.startPosition.row + 1);
94
- continue;
95
- }
96
- const names = node.namedChildren.filter((c) => c !== modNode && (c.type === "dotted_name" || c.type === "aliased_import"));
97
- let externalDone = false; // one record per statement, not per imported name
98
- for (const nm of names) {
99
- const impName = nm.type === "aliased_import" ? field(nm, "name")?.text : nm.text;
100
- const local = nm.type === "aliased_import" ? field(nm, "alias")?.text : impName;
101
- if (!impName) continue;
102
- const asSub = resolvePyPath(baseDir, [...modParts, impName]) || (dots === 0 ? resolveAbs([...modParts, impName]) : null); // name may itself be a submodule file
103
- if (asSub) { addImportEdge(asSub); if (local) imports.set(local, { imported: "*", targetFile: asSub }); continue; }
104
- const modFile = resolvePyPath(baseDir, modParts) || (dots === 0 ? resolveAbs(modParts) : null);
105
- if (modFile) { addImportEdge(modFile); if (local) imports.set(local, { imported: impName, targetFile: modFile }); }
106
- else if (dots === 0 && modParts.length && !externalDone) { externalDone = true; recordExternal(modParts.join("."), node.startPosition.row + 1); }
107
- }
108
- }
109
- },
110
-
111
- pass2(ctx) {
112
- const {grammar, tree, fileRel, caps, field, enclosing, links, nodeById, perFileSymbols, symByFileName, importedLocals, resolveCall} = ctx;
113
- const imports = importedLocals.get(fileRel) || new Map();
114
- const wildcardImports = [...imports.values()].filter((entry) => entry?.wildcard && entry.targetFile);
115
- const emitted = new Set();
116
- const addCall = (caller, target, line, evidence) => {
117
- if (!caller || !target || target === caller.id) return;
118
- const key = `${caller.id}\0${target}\0${line}`;
119
- if (emitted.has(key) || links.some((link) => link.source === caller.id && link.target === target && link.relation === "calls" && link.line === line)) return;
120
- emitted.add(key);
121
- const provenance = ["receiver-type", "wildcard-import", "module-member"].includes(evidence) ? "RESOLVED" : "INFERRED";
122
- links.push({source: caller.id, target, relation: "calls", confidence: "INFERRED", provenance, line, pythonResolution: evidence});
123
- };
124
- const moduleSymbol = (targetFile, name) => {
125
- const id = symByFileName.get(targetFile)?.get(name);
126
- if (!id) return null;
127
- const node = nodeById.get(id);
128
- return node?.member_of ? null : id;
129
- };
130
- const wildcardCandidates = (name) => {
131
- const candidates = [];
132
- for (const imp of wildcardImports) {
133
- const symbols = perFileSymbols.get(imp.targetFile) || [];
134
- const explicitAll = symbols.some((symbol) => symbol.name === "__all__");
135
- const symbol = symbols.find((entry) => entry.name === name && !entry.memberOf);
136
- if (!symbol || (explicitAll ? nodeById.get(symbol.id)?.exported !== true : name.startsWith("_"))) continue;
137
- candidates.push(symbol.id);
138
- }
139
- return [...new Set(candidates)];
140
- };
141
- const classInfo = (name) => {
142
- const local = symByFileName.get(fileRel)?.get(name);
143
- if (local && nodeById.get(local)?.symbol_kind === "class") return {id: local, name, file: fileRel};
144
- const imp = imports.get(name);
145
- if (imp?.targetFile && !imp.wildcard) {
146
- const targetFile = imp.originFile || imp.targetFile;
147
- const targetName = imp.originName || imp.imported || name;
148
- const id = symByFileName.get(targetFile)?.get(targetName);
149
- if (id && nodeById.get(id)?.symbol_kind === "class") return {id, name: targetName, file: targetFile};
150
- }
151
- const wildcard = wildcardCandidates(name).filter((id) => nodeById.get(id)?.symbol_kind === "class");
152
- if (wildcard.length === 1) {
153
- const node = nodeById.get(wildcard[0]);
154
- return {id: wildcard[0], name: node.label || name, file: node.source_file};
155
- }
156
- return null;
157
- };
158
- const methodOf = (klass, method) => (perFileSymbols.get(klass.file) || [])
159
- .find((symbol) => symbol.memberOf === String(nodeById.get(klass.id)?.label || klass.name).replace(/\(.*$/, "") && symbol.name === method)?.id || null;
160
- const bindings = new Map();
161
- const shadows = new Set();
162
- const scopeKey = (caller, name) => `${caller?.id || ""}\0${name}`;
163
- const bind = (caller, name, klass) => { if (caller && name && klass) bindings.set(scopeKey(caller, name), klass); };
164
- const typeName = (node) => {
165
- const text = String(node?.text || "").replace(/^['"]|['"]$/g, "");
166
- return (text.match(/[A-Za-z_]\w*/) || [])[0] || "";
167
- };
168
-
169
- for (const cap of caps(grammar, `(parameters (identifier) @param) (typed_parameter) @typed`, tree.rootNode)) {
170
- const line = cap.node.startPosition.row + 1;
171
- const caller = enclosing(fileRel, line);
172
- if (!caller) continue;
173
- if (cap.name === "param") {
174
- shadows.add(scopeKey(caller, cap.node.text));
175
- continue;
176
- }
177
- const name = cap.node.namedChildren.find((child) => child.type === "identifier")?.text;
178
- if (!name) continue;
179
- shadows.add(scopeKey(caller, name));
180
- bind(caller, name, classInfo(typeName(field(cap.node, "type"))));
181
- }
182
- for (const cap of caps(grammar, `(assignment) @assign`, tree.rootNode)) {
183
- const assignment = cap.node;
184
- const caller = enclosing(fileRel, assignment.startPosition.row + 1);
185
- if (!caller) continue;
186
- const left = field(assignment, "left");
187
- const right = field(assignment, "right");
188
- let receiver = "";
189
- if (left?.type === "identifier") receiver = left.text;
190
- else if (left?.type === "attribute") receiver = left.text;
191
- if (!receiver) continue;
192
- shadows.add(scopeKey(caller, receiver));
193
- const annotation = typeName(field(assignment, "type"));
194
- const constructor = right?.type === "call" && field(right, "function")?.type === "identifier"
195
- ? field(right, "function").text : "";
196
- bind(caller, receiver, classInfo(annotation || constructor));
197
- }
198
-
199
- for (const cap of caps(grammar, `(call function: (identifier) @callee)`, tree.rootNode)) {
200
- const line = cap.node.startPosition.row + 1;
201
- const caller = enclosing(fileRel, line);
202
- if (!caller || shadows.has(scopeKey(caller, cap.node.text))) continue;
203
- let target = resolveCall(cap.node.text, fileRel);
204
- if (target && nodeById.get(target)?.member_of) target = null;
205
- let evidence = "bare";
206
- if (!target) {
207
- const candidates = wildcardCandidates(cap.node.text);
208
- if (candidates.length === 1) { target = candidates[0]; evidence = "wildcard-import"; }
209
- }
210
- addCall(caller, target, line, evidence);
211
- }
212
-
213
- for (const cap of caps(grammar, `(call function: (attribute) @attributeCall)`, tree.rootNode)) {
214
- const attribute = cap.node;
215
- const object = field(attribute, "object");
216
- const member = field(attribute, "attribute");
217
- if (!object || !member) continue;
218
- const line = attribute.startPosition.row + 1;
219
- const caller = enclosing(fileRel, line);
220
- if (!caller) continue;
221
- if (object.type === "identifier") {
222
- const moduleImport = imports.get(object.text);
223
- if (moduleImport?.targetFile && moduleImport.imported === "*" && !moduleImport.wildcard) {
224
- addCall(caller, moduleSymbol(moduleImport.targetFile, member.text), line, "module-member");
225
- continue;
226
- }
227
- }
228
- let klass = null;
229
- if (["self", "cls"].includes(object.text) && caller.memberOf) klass = classInfo(caller.memberOf);
230
- if (!klass) klass = bindings.get(scopeKey(caller, object.text));
231
- if (!klass && object.type === "call" && field(object, "function")?.type === "identifier") klass = classInfo(field(object, "function").text);
232
- addCall(caller, klass && methodOf(klass, member.text), line, "receiver-type");
233
- }
234
- },
235
- };
@@ -1,63 +0,0 @@
1
- // Rust scoped-call resolution (`Path::method()`), split from lang-rust.js. Resolved with the full
2
- // qualifier in hand so an external associated function (`OpenOptions::new()`, `Vec::from()`) never binds
3
- // its bare final name to an unrelated same-named function in the directory. Only heads with real evidence
4
- // produce an edge: crate/self/super anchors, `use`-bound names (including sibling-crate modules),
5
- // fully-qualified sibling crates, and local types whose exact impl method is indexed. A std/external
6
- // type head is left unresolved on purpose.
7
-
8
- // Symbol kinds that can own an associated function via `Type::method`.
9
- const TYPE_KINDS = new Set(["struct", "enum", "trait", "type", "union"]);
10
-
11
- // `pathParts` and `inlineAncestors` stay owned by lang-rust.js (pass 1 uses them too) and are passed in,
12
- // so this module never imports back from lang-rust.js.
13
- export function rustScopedCalls(ctx, { pathParts, inlineAncestors }) {
14
- const { grammar, tree, fileRel, caps, enclosing, links, nodeById, importedLocals,
15
- dirSymbols, resolveNamedSymbol, resolveRustMethod, resolveRustPath, resolveRustCratePath } = ctx;
16
- const dir = fileRel.includes("/") ? fileRel.slice(0, fileRel.lastIndexOf("/")) : "";
17
- const localSyms = dirSymbols?.get(dir);
18
- const emitCall = (node, target) => {
19
- const caller = enclosing(fileRel, node.startPosition.row + 1);
20
- if (caller && target && target !== caller.id) {
21
- links.push({ source: caller.id, target, relation: "calls", confidence: "INFERRED", line: node.startPosition.row + 1 });
22
- }
23
- };
24
- for (const cap of caps(grammar, `(call_expression function: (scoped_identifier) @path)`, tree.rootNode)) {
25
- const node = cap.node;
26
- const segments = pathParts(node);
27
- if (segments.length < 2) continue;
28
- const head = segments[0];
29
- const method = segments.at(-1);
30
-
31
- if (["crate", "self", "super"].includes(head)) {
32
- const resolved = resolveRustPath(fileRel, segments, { inlineModules: inlineAncestors(node), unqualified: false });
33
- if (resolved) emitCall(node, resolveNamedSymbol(resolved.targetFile, method, "value"));
34
- continue;
35
- }
36
-
37
- const bound = importedLocals?.get(fileRel)?.get(head);
38
- if (bound?.targetFile) {
39
- emitCall(node, resolveNamedSymbol(bound.targetFile, method, "value"));
40
- continue;
41
- }
42
-
43
- const crateResolved = resolveRustCratePath ? resolveRustCratePath(head, segments.slice(1, -1)) : null;
44
- if (crateResolved) {
45
- emitCall(node, resolveNamedSymbol(crateResolved.targetFile, method, "value"));
46
- continue;
47
- }
48
-
49
- // Local type's associated function: resolve the exact impl member. Nothing else (enum-variant
50
- // construction, external types) has an indexed target, so it produces no edge.
51
- const headId = localSyms?.get(head);
52
- if (headId && TYPE_KINDS.has(nodeById.get(headId)?.symbol_kind)) {
53
- emitCall(node, resolveRustMethod(dir, head, method));
54
- continue;
55
- }
56
-
57
- // Head is a locally-declared outlined module used without `use` (`mod utils; utils::init()`), the
58
- // dominant flat-file idiom. resolveRustPath matches only a REAL repo module file, so an external type
59
- // head (OpenOptions, Vec) resolves to null and still produces no edge — no dir-scope mis-binding.
60
- const modResolved = resolveRustPath?.(fileRel, segments.slice(0, -1), { inlineModules: inlineAncestors(node), unqualified: true });
61
- if (modResolved) emitCall(node, resolveNamedSymbol(modResolved.targetFile, method, "value"));
62
- }
63
- }