Merge remote-tracking branch 'origin/main' into perf/query-latency-regression

Impact: 3 functions changed, 8 affected

Author: carlos-alm

.claude/skills/dogfood/SKILL.md

@@ -69,7 +69,17 @@ Your goal is to install the published package, exercise every feature, compare e
    ```
    This should report `engine: native`. If it falls back to `wasm`, record why.
 5. Record: platform, OS version, Node version, native binary package name + version, engine reported by `info`.
-6. **Do NOT rebuild the graph yet.** The first phase tests commands against the codegraph source repo without a pre-existing graph.
+6. **Update the native binary in the source repo.** The source repo's `node_modules` may have a stale native binary from a previous release. Since Phases 1–4 run commands against the source repo (using `--db` or directly), a version mismatch produces wrong results for **all phases**, not just benchmarks. Check and fix immediately:
+   ```bash
+   # In the codegraph source repo:
+   node -e "const p = require('@optave/codegraph-win32-x64-msvc/package.json'); console.log('Source repo native binary:', p.version)"
+   ```
+   If the version does **not** match `$ARGUMENTS`, install the correct binary now:
+   - **Stable release:** `npm install @optave/codegraph-win32-x64-msvc@$ARGUMENTS` (adjust platform suffix)
+   - **Dev build:** `npm install https://github.com/optave/codegraph/releases/download/dev-v$ARGUMENTS/optave-codegraph-win32-x64-msvc-$ARGUMENTS.tgz`
+
+   Verify with `npx codegraph info` in the source repo. Revert `package.json` / `package-lock.json` changes after the session (do not commit them on the fix branch).
+7. **Do NOT rebuild the graph yet.** The first phase tests commands against the codegraph source repo without a pre-existing graph.
 
 ---
 
@@ -202,30 +212,13 @@ Run all four benchmark scripts from the codegraph source repo and record results
 
 ### Pre-flight: verify native binary version
 
-**Before running any benchmarks**, confirm the native binary in the source repo matches the version being dogfooded. A stale binary will produce misleading results (e.g., the Rust engine may lack features added in the release, causing silent WASM fallback during the complexity phase).
+If you followed Phase 0 step 6, the source repo's native binary should already match `$ARGUMENTS`. Double-check before benchmarking:
 
 ```bash
-# In the codegraph source repo — adjust the platform package name as needed:
-node -e "const r=require('module').createRequire(require('url').pathToFileURL(__filename).href); const pkg=r.resolve('@optave/codegraph-win32-x64-msvc/package.json'); const p=require(pkg); console.log('Native binary version:', p.version)"
+node -e "const p = require('@optave/codegraph-win32-x64-msvc/package.json'); console.log('Native binary version:', p.version)"
 ```
 
-If the version does **not** match `$ARGUMENTS`:
-
-**Stable release** (no `-dev.` in version):
-1. Update `optionalDependencies` in `package.json` to pin all `@optave/codegraph-*` packages to `$ARGUMENTS`.
-2. Run `npm install` to fetch the correct binaries.
-3. Verify with `npx codegraph info` that the native engine loads at the correct version.
-4. Revert the `package.json` / `package-lock.json` changes after benchmarking (do not commit them on the fix branch).
-
-**Dev build** (version contains `-dev.`):
-Native binaries for dev builds are not on npm — they are in the GitHub release tarballs. Install the platform binary directly:
-1. Download the platform tarball into the source repo:
-   ```bash
-   # Example for Windows x64 — adjust platform suffix as needed:
-   npm install https://github.com/optave/codegraph/releases/download/dev-v$ARGUMENTS/optave-codegraph-win32-x64-msvc-$ARGUMENTS.tgz
-   ```
-2. Verify with `npx codegraph info` that the native engine loads at the correct version.
-3. Revert the `package.json` / `package-lock.json` changes after benchmarking (do not commit them on the fix branch).
+If it doesn't match, go back to Phase 0 step 6 and fix it — **all benchmark results with a stale binary are invalid.**
 
 **Why this matters:** The native engine computes complexity metrics during the Rust parse phase. If the binary is from an older release that lacks this, the complexity phase silently falls back to WASM — inflating native complexity time by 50-100x and making native appear slower than WASM.
 

generated/benchmarks/BUILD-BENCHMARKS.md

@@ -166,6 +166,18 @@ remains at 6.6 ms/file (vs 5.0 in v2.0.0). The WASM/Native ratio widened from
 2.0x to 3.5x. Further optimization of WASM boundary crossings in the JS
 extractor is needed to recover the regression.
 
+**Build regression (v3.1.4 3.5 ms/file → v3.3.0 8 ms/file, +129% native):** The codebase grew from
+398 to 429 files (+8%), but the per-file regression is real and driven by richer extraction. Between
+v3.1.4 and v3.3.0, type inference was extended to all typed languages (#501), receiver type tracking
+with graded confidence was added (#505), re-exported barrel file symbols are now tracked (#515), and
+package.json exports + monorepo workspace resolution was introduced (#509). These produce 33% more
+nodes/file (13.4 → 17.8) and 28% more edges/file (28.8 → 36.8). The Parse phase tripled on native
+(468 → 1511 ms) because extractors now perform additional AST traversals for type annotations and
+receiver resolution. The Complexity phase grew 10× (16 → 179 ms) because 33% more functions each
+require full AST analysis. Major refactors also decomposed monolithic extractors into per-category
+handlers (#490) and split domain/feature modules (#491, #492), adding 31 new source files — the
+benchmark measures codegraph on itself, so more source files amplify per-file overhead.
+
 **Native build regression (v3.0.0 4.4 ms/file → v3.0.3 12.3 ms/file):** The regression is entirely
 from new build phases added in v3.0.1 that are now default-on: AST node extraction (651ms),
 dataflow analysis (367ms), and CFG construction (169ms) — totalling ~1,187ms of new work. The original

generated/benchmarks/INCREMENTAL-BENCHMARKS.md

@@ -6,6 +6,8 @@ Import resolution: native batch vs JS fallback throughput.
 
 | Version | Engine | Files | Full Build | No-op | 1-File | Resolve (native) | Resolve (JS) |
 |---------|--------|------:|-----------:|------:|-------:|------------------:|-------------:|
+| 3.3.0 | native | 429 | 3.0s ↑141% | 10ms ↑67% | 417ms ↑74% | 10ms ↑700% | 26ms ↑888% |
+| 3.3.0 | wasm | 429 | 4.3s ↑29% | 11ms ~ | 479ms ↑41% | 10ms ↑700% | 26ms ↑888% |
 | 3.1.4 | native | 398 | 1.3s ↑9% | 6ms ~ | 240ms ↓11% | 1ms ↓37% | 3ms ↓45% |
 | 3.1.4 | wasm | 398 | 3.3s ↑10% | 11ms ↑83% | 340ms ↓28% | 1ms ↓37% | 3ms ↓45% |
 | 3.1.3 | native | 236 | 1.2s ~ | 6ms ↑20% | 271ms ↑3% | 2ms ↓5% | 5ms ~ |
@@ -31,37 +33,87 @@ Import resolution: native batch vs JS fallback throughput.
 
 ### Latest results
 
-**Version:** 3.1.4 | **Files:** 398 | **Date:** 2026-03-16
+**Version:** 3.3.0 | **Files:** 429 | **Date:** 2026-03-19
 
 #### Native (Rust)
 
 | Metric | Value |
 |--------|------:|
-| Full build | 1.3s |
-| No-op rebuild | 6ms |
-| 1-file rebuild | 240ms |
+| Full build | 3.0s |
+| No-op rebuild | 10ms |
+| 1-file rebuild | 417ms |
 
 #### WASM
 
 | Metric | Value |
 |--------|------:|
-| Full build | 3.3s |
+| Full build | 4.3s |
 | No-op rebuild | 11ms |
-| 1-file rebuild | 340ms |
+| 1-file rebuild | 479ms |
 
 #### Import Resolution
 
 | Metric | Value |
 |--------|------:|
-| Import pairs | 175 |
-| Native batch | 1ms |
-| JS fallback | 3ms |
+| Import pairs | 664 |
+| Native batch | 10ms |
+| JS fallback | 26ms |
 | Per-import (native) | 0ms |
 | Per-import (JS) | 0ms |
-| Speedup ratio | 2.2x |
+| Speedup ratio | 2.7x |
 
 <!-- INCREMENTAL_BENCHMARK_DATA
 [
+  {
+    "version": "3.3.0",
+    "date": "2026-03-19",
+    "files": 429,
+    "wasm": {
+      "fullBuildMs": 4265,
+      "noopRebuildMs": 11,
+      "oneFileRebuildMs": 479,
+      "oneFilePhases": {
+        "setupMs": 1.7,
+        "parseMs": 193.6,
+        "insertMs": 8.3,
+        "resolveMs": 1.7,
+        "edgesMs": 14.7,
+        "structureMs": 16.5,
+        "rolesMs": 50.4,
+        "astMs": 0.2,
+        "complexityMs": 0.1,
+        "cfgMs": 0.1,
+        "dataflowMs": 0.2,
+        "finalizeMs": 13.3
+      }
+    },
+    "native": {
+      "fullBuildMs": 3048,
+      "noopRebuildMs": 10,
+      "oneFileRebuildMs": 417,
+      "oneFilePhases": {
+        "setupMs": 1.2,
+        "parseMs": 134,
+        "insertMs": 7.9,
+        "resolveMs": 1.6,
+        "edgesMs": 25.1,
+        "structureMs": 19.6,
+        "rolesMs": 45.9,
+        "astMs": 0.3,
+        "complexityMs": 0.1,
+        "cfgMs": 0.2,
+        "dataflowMs": 0.2,
+        "finalizeMs": 12
+      }
+    },
+    "resolve": {
+      "imports": 664,
+      "nativeBatchMs": 9.6,
+      "jsFallbackMs": 25.7,
+      "perImportNativeMs": 0,
+      "perImportJsMs": 0
+    }
+  },
   {
     "version": "3.1.4",
     "date": "2026-03-16",