optave · carlos-alm · Apr 4, 2026 · Apr 4, 2026 · Apr 4, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,32 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [3.9.0](https://github.com/optave/ops-codegraph-tool/compare/v3.8.1...v3.9.0) (2026-04-04)
+
+**Engine parity hardening and cross-database queries.** This release closes the remaining native/WASM divergences — node counts, edge counts, complexity metrics, and import resolution now match across engines. A new `--db` flag on `branch-compare` and `info` lets you point at any `.codegraph/graph.db`, enabling cross-repo comparisons without rebuilding. WASM grammar loading is now lazy during incremental rebuilds, cutting rebuild times for large codebases. Windows users get a fix for `ENOENT` failures during auto-install.
+
+### Features
+
+* **cli:** add `--db` flag to `branch-compare` and `info` commands for cross-database queries ([#820](https://github.com/optave/ops-codegraph-tool/pull/820))
+* add resolution precision/recall metrics and version stamp to README benchmarks ([#796](https://github.com/optave/ops-codegraph-tool/pull/796))
+
+### Bug Fixes
+
+* respect `--engine wasm` in pipeline guard ([#819](https://github.com/optave/ops-codegraph-tool/pull/819))
+* resolve npm ENOENT on Windows for auto-install ([#818](https://github.com/optave/ops-codegraph-tool/pull/818))
+* resolve native/WASM engine divergence in node and edge counts ([#810](https://github.com/optave/ops-codegraph-tool/pull/810))
+* **native:** resolve importedNames priority and type map scope collisions ([#811](https://github.com/optave/ops-codegraph-tool/pull/811))
+* **native:** resolve import path mismatch and add post-native structure phase ([#807](https://github.com/optave/ops-codegraph-tool/pull/807))
+* **native:** extract export name for destructured dynamic imports ([#813](https://github.com/optave/ops-codegraph-tool/pull/813))
+* **native:** fix incremental barrel edges, median parity, and analysis data loss ([#806](https://github.com/optave/ops-codegraph-tool/pull/806))
+* **parity:** align native vs WASM complexity metrics ([#809](https://github.com/optave/ops-codegraph-tool/pull/809))
+* v3.8.1 regression fixes (fnDeps, WASM lazy-load, edge parity, CI guard) ([#815](https://github.com/optave/ops-codegraph-tool/pull/815))
+* **ci:** remove npm self-upgrade that breaks publish workflow ([#790](https://github.com/optave/ops-codegraph-tool/pull/790))
+
+### Performance
+
+* lazy-load WASM grammars for incremental rebuilds ([#808](https://github.com/optave/ops-codegraph-tool/pull/808))
+
 ## [3.8.1](https://github.com/optave/ops-codegraph-tool/compare/v3.8.0...v3.8.1) (2026-04-03)
 
 **Windows stability, native engine fixes, and large-codebase performance.** This patch hardens the v3.8.0 release with critical Windows fixes (polling watcher to avoid ReFS BSOD, Windows-scoped import-edge handling), several native engine corrections (dataflow parameter indexing, embedding path resolution, build orchestrator sequencing), and performance improvements for large codebases — cycle detection and stats queries are faster, and query-time analysis now routes through the native Rust engine.

diff --git a/README.md b/README.md
@@ -588,7 +588,7 @@ Codegraph also extracts symbols from common callback patterns: Commander `.comma
 
 Self-measured on every release via CI ([build benchmarks](generated/benchmarks/BUILD-BENCHMARKS.md) | [embedding benchmarks](generated/benchmarks/EMBEDDING-BENCHMARKS.md) | [query benchmarks](generated/benchmarks/QUERY-BENCHMARKS.md) | [incremental benchmarks](generated/benchmarks/INCREMENTAL-BENCHMARKS.md) | [resolution precision/recall](tests/benchmarks/resolution/)):
 
-*Last updated: v3.8.1 (2026-04-03)*
+*Last updated: v3.9.0 (2026-04-04)*
 
 | Metric | Latest |
 |---|---|

diff --git a/crates/codegraph-core/Cargo.toml b/crates/codegraph-core/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "codegraph-core"
-version = "3.8.1"
+version = "3.9.0"
 edition = "2021"
 license = "Apache-2.0"
 

diff --git a/docs/roadmap/BACKLOG.md b/docs/roadmap/BACKLOG.md
@@ -1,6 +1,6 @@
 # Codegraph Feature Backlog
 
-**Last updated:** 2026-04-03
+**Last updated:** 2026-04-04
 **Source:** Features derived from [COMPETITIVE_ANALYSIS.md](../../generated/competitive/COMPETITIVE_ANALYSIS.md) and internal roadmap discussions.
 
 ---

diff --git a/docs/roadmap/ROADMAP.md b/docs/roadmap/ROADMAP.md
@@ -1,6 +1,6 @@
 # Codegraph Roadmap
 
-> **Current version:** 3.8.1 | **Status:** Active development | **Updated:** 2026-04-03
+> **Current version:** 3.9.0 | **Status:** Active development | **Updated:** 2026-04-04
 
 Codegraph is a strong local-first code graph CLI. This roadmap describes planned improvements across fourteen phases -- closing gaps with commercial code intelligence platforms while preserving codegraph's core strengths: fully local, open source, zero cloud dependency by default.
 

diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@optave/codegraph",
-  "version": "3.8.1",
+  "version": "3.9.0",
   "description": "Local code graph CLI — parse codebases with tree-sitter, build dependency graphs, query them",
   "type": "module",
   "main": "dist/index.js",