Releases: optave/ops-codegraph-tool
v3.8.1
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.
Bug Fixes
- native: resolve dataflow null paramIndex and import edge key mismatch (#788)
- native: keep nativeDb open through finalize for correct build_meta (#784)
- embed: handle absolute file paths from native engine (#780, #783)
- default watcher to polling on Windows to avoid ReFS BSOD (#778)
- scope native import-edge skip to Windows only (#777)
- run analysis phases after native Rust build orchestrator (#757)
- skip native build orchestrator for addon ≤3.8.0 and fix path bug (#758)
- auto-install @huggingface/transformers in non-TTY environments (#779)
- remove duplicate function definitions in leiden optimiser (#786)
- replace empty catch blocks with structured error handling (#764)
- replace console.log with structured logging in non-CLI-output code (#765)
- ci: add concurrency group to codegraph-impact workflow (#785)
- bench: resolve query benchmark CI failure and increase embedding timeout (#749)
Performance
- route query analysis through native Rust engine (#745)
- optimize cycles and stats for large codebases (#781)
- filter reverse-dep files from native build analysis scope (#782)
- forward langId hint to native standalone analysis functions (#743)
Refactors
- decompose ast-analysis visitor framework (#771)
- Titan v3.8.0 — decompose god-functions, structured logging, error handling (#775)
- extract class declaration handlers in language extractors (#769)
- split hybridSearchData into keyword, vector, and merge steps (#768)
- decompose makePartition into focused graph operations (#766)
- extract rendering sub-functions from inspect and diff-impact-mermaid (#767)
- address quality warnings in shared modules (#770)
v3.8.0
34 languages and a fully native build pipeline. This release completes Phase 7 (Expanded Language Support) by shipping the final 11 languages — F#, Gleam, Clojure, Julia, R, Erlang, Solidity, Objective-C, CUDA, Groovy, and Verilog — bringing codegraph from 23 to 34 supported languages. On the performance side, the entire build pipeline now runs natively in Rust: graph algorithms (BFS, shortest path, Louvain, centrality), import edge building with barrel resolution, and build-glue queries all migrate from JS to napi-rs. A new Rust build orchestration layer coordinates the full native pipeline end-to-end.
Features
- add F#, Gleam, Clojure, Julia, R, Erlang language support (#722)
- add Solidity, Objective-C, CUDA, Groovy, Verilog language support (#729)
- full Rust build orchestration (#740)
Bug Fixes
- native: enable bulkInsertNodes native path (#736)
- native: enable bulkInsertNodes native path — null-visibility serialisation (#737)
- native: prevent SQLITE_CORRUPT in incremental pipeline (#728)
- ocaml: use LANGUAGE_OCAML_INTERFACE grammar for .mli files (#730)
- address unresolved review feedback from batch4 language extractors (#731)
- bench: report partial native results when incremental rebuild fails (#741)
Performance
- migrate graph algorithms (BFS, shortest path, Louvain, centrality) to Rust (#732)
- migrate import edge building + barrel resolution to Rust (#738)
- native: expose standalone complexity/CFG/dataflow analysis via napi-rs (#733)
- native Rust build-glue queries (detect-changes, finalize, incremental) (#735)
Refactors
- native: remove call kind from AST node extraction (#734)
v3.7.0
Six more languages and a CFG stability fix. Codegraph now supports Elixir, Lua, Dart, Zig, Haskell, and OCaml — bringing the total to 23 languages with dual-engine extractors. A WAL conflict in the native CFG bulk-insert path is also fixed, preventing database corruption when JS and native connections overlap during control-flow graph writes.
Features
- add Elixir, Lua, Dart, Zig, Haskell, OCaml language support (#718)
Bug Fixes
- cfg: avoid dual-connection WAL conflict in native bulkInsertCfg (#719)
v3.6.0
Six new languages and a parser abstraction layer. This release adds first-class support for C, C++, Kotlin, Swift, Scala, and Bash — bringing the total supported languages to 17. A new parser abstraction layer decouples language extractors from tree-sitter internals, making it straightforward to add more languages. The native Rust engine gains batched query methods for the read path, WAL corruption is fixed when native and JS connections overlap, and WASM call-AST extraction is restored for full engine parity.
Features
- add C, C++, Kotlin, Swift, Scala, Bash language support (#708)
Bug Fixes
- parity: restore call AST node extraction in WASM engine (#705)
- native: suspend JS connection around native writes to prevent WAL corruption (#704)
- native visibility crash and dual-SQLite WAL corruption in benchmarks (#689)
- ci: resolve visibility null crash and sequence dataflow annotation (#693)
- publish: update repository URLs for npm provenance (#682)
Performance
- queries: batched native Rust query methods for read path (#698)
Refactors
v3.5.0
Full rusqlite database migration and sub-100ms incremental rebuilds. This release completes the migration of all SQLite operations from better-sqlite3 to native Rust/rusqlite via napi-rs, delivering major performance gains across the entire build pipeline. Incremental rebuilds drop from 466ms to 67–80ms, and bulk inserts for nodes, edges, roles, AST nodes, CFG, and dataflow all run through the native engine. better-sqlite3 is now lazy-loaded only as a fallback. Path aliases are restored with TS 6.x-compatible subpath imports, and several WASM/native parity bugs are fixed.
Features
- config: restore path aliases with TS 6.x-compatible subpath imports (#672)
Bug Fixes
- db: fold reverse-dep edge deletion into NativeDatabase.purgeFilesData (#670, #679)
- wasm: extract call-site AST nodes in ast-store-visitor (#678)
- parser: close WASM–native engine parity gap (#649, #657)
- test: remove constant-kind exclusion from parity test (#676, #680)
Performance
- db: NativeDatabase napi-rs class for rusqlite connection lifecycle (6.13) (#666)
- db: migrate Repository read queries to NativeDatabase rusqlite (6.14) (#671)
- db: migrate build pipeline writes to NativeDatabase (6.15) (#669)
- db: generic query execution on NativeDatabase (6.16) (#677)
- db: bulk CFG and dataflow DB writes via rusqlite (#653)
- build: native Rust/rusqlite for roles & edge insertion (6.12) (#658)
- insert-nodes: native Rust/rusqlite pipeline for node insertion (#654)
- ast: bulk-insert AST nodes via native Rust/rusqlite (#651)
- sub-100ms incremental rebuilds (466ms → 67–80ms) (#644)
- hooks: narrow Bash hook matchers to git commands only (#655)
Refactors
- db: lazy-load better-sqlite3 and remove standalone napi functions (6.17) (#673)
Chores
v3.4.1
Post-migration stabilization and native engine accuracy. This release fixes a Rust findCaller bug that misattributed 68 call edges, adds compound database indexes to restore query performance after the TypeScript migration, and delivers a 96% speedup to incremental role classification (255ms → 9ms). WASM builds are more resilient, incremental rebuilds handle JSONC and version changes correctly, and error handling is safer across the board.
Bug Fixes
- native: remove spurious else-if in Rust
findCallerthat misattributed 68 call edges (#637) - native: recurse into
await_expressionchildren inwalk_ast_nodes(#618) - build: JSONC parse and version-aware incremental rebuilds (#631)
- WASM build resilience and lint cleanup from TypeScript migration (#629)
- dogfood fixes 9.1–9.4 — version warning, barrel exports, quieter tsconfig, Set compatibility (#634)
- use safe error coercion in debug catch blocks (#630)
- add debug logging to empty catch blocks across infrastructure and domain layers (#616)
- bench: use
dist/for npm benchmark installs to avoid Node type-stripping error (#624) - bench: repair benchmark workflow broken by TypeScript migration (#612)
- skills: prevent
/reviewfrom spamming@greptileaiwhen already approved (#628)
Performance
- db: add compound indexes to fix query regression from TypeScript migration (#632)
- build: incremental rebuild optimizations — roles 255ms → 9ms (#622)
Refactors
- errors: extract shared
toErrorMessagehelper (#633) - extract
MAX_WALK_DEPTHconstant to extractors helpers (#620) - address SLOC warnings in domain and features layers (#621)
- split
cfg-visitor.tsby control-flow construct (#619)
Chores
- titan: first full Titan Paradigm pipeline run — audit report generation and skill improvements (#623)
v3.4.0
TypeScript migration complete, Leiden community detection, and native engine hardening. The entire codebase — all 271 source files — is now TypeScript with zero .js files remaining. Community detection upgrades from Louvain to a vendored Leiden algorithm with true probabilistic refinement, removing the graphology dependency. Go gains structural interface matching and C# gets proper implements disambiguation. The native Rust engine now extracts call-site AST nodes and bypasses the JS CFG visitor entirely on native builds. MCP server shutdown is graceful, and several edge-attribution and WASM fallback bugs are fixed.
Features
- types: complete TypeScript migration — all 271 source files migrated from JavaScript, zero
.jsfiles remaining. Covers leaf modules, core domain, graph algorithms, builder stages, search, CLI layer (48 command handlers), AST analysis, features, presentation, MCP tools, and test suite (#553, #554, #555, #558, #566, #570, #579, #580, #581, #588) - communities: vendor Leiden community detection algorithm, replacing
graphology-communities-louvain— full control over resolution, quality functions, and probabilistic refinement (#545, #552, #556) - resolution: Go structural interface matching — post-extraction pass matches struct method sets against interface method sets; C#
implementsdisambiguation via post-walk reclassification ofextendsentries targeting known interfaces (#522) - native: extract call-site AST nodes in Rust during native parse, fixing WASM fallback path for incomplete extraction (#591)
- native: extract
base_listfor C# classes in the Rust engine (#577) - cfg: bypass JS CFG visitor entirely on native builds; fix Go
for-rangeCFG parity between engines (#595)
Bug Fixes
- edges: remove
findCallerfallback that misattributed file-scope calls to unrelated functions (#607) - mcp: add graceful shutdown to prevent "MCP Failed" errors on session clear (#598)
- resolver: apply JS-side
.js→.tsextension remap after native resolution (#594) - resolver: normalize paths in native resolver for
.js→.tsremap (#600) - deps: patch 5 high-severity transitive vulnerabilities (#583)
- types: narrow parser return types,
cachedStmtinbuildTestFileIds, WASM parser path, and triage query results (#569, #576, #578) - scripts: use version-aware
strip-typesflag inpackage.jsonscripts (#599) - tests: use
fs.cpSyncfor fixture copy to handle subdirectories (#584)
Performance
- native: fix WASM fallback bypass so native builds skip redundant JS analysis passes; batch SQL inserts for node/edge operations (#606)
- queries: apply
cachedStmttobuildTestFileIdsstatic SQL for faster test filtering (#575)
Tests
- strengthen weak assertions and add presentation layer coverage (#586)
Chores
v3.3.1
Incremental rebuild accuracy and post-3.3.0 stabilization. This patch fixes a critical edge gap in the file watcher's single-file rebuild path where call edges were silently dropped during incremental rebuilds, aligns the native Rust engine's edge builder kind filters with the JS engine for parity, plugs a WASM tree memory leak in native engine typeMap backfill, and restores query performance to pre-3.1.4 levels. Several post-reorganization import path issues are also corrected.
Bug Fixes
- watcher: close edge gap in single-file rebuild — incremental rebuilds now correctly preserve call edges by coercing native typeMap arrays to Maps and rebuilding edges for reverse-dependency files (#533, #542)
- native: align edge builder kind filters with JS engine parity — ensures native and WASM engines produce identical edge sets (#541)
- native: free leaked WASM trees in native engine typeMap backfill (#534)
- cli: correct
astcommand import path after src/ reorganization (#532) - benchmarks: stabilize benchmark targets across engines and preserve README links (#527)
- benchmarks: update benchmark script import paths after src/ restructure (#521)
- ci: sync Cargo.toml version before native binary build (#538)
Performance
- queries: reduce query latency regression from 3.1.4 to 3.3.0 — cached prepared statements for
findReverseDepsanddeleteOutgoingEdges(#528)
Tests
- watcher: incremental edge parity CI check — ensures watcher rebuilds produce identical edge sets to full builds (#539)
Chores
- ci: add dynamic import verification to catch stale paths (#540)
3.3.0 (2026-03-19)
Resolution accuracy reaches a new level. This release delivers Phase 4 resolution improvements — type inference across all typed languages, receiver type tracking with graded confidence, package.json exports field resolution, and monorepo workspace resolution. Method calls like repo.findCallers() now resolve through receiver types instead of matching any findCallers in scope. Barrel files correctly show re-exported symbols. A precision/recall benchmark suite tracks call resolution accuracy across versions. On the infrastructure side, all hardcoded behavioral constants are centralized into DEFAULTS with recursive deep merge, and the TypeScript migration begins with project setup and core type definitions.
v3.3.0
Resolution accuracy reaches a new level. This release delivers Phase 4 resolution improvements — type inference across all typed languages, receiver type tracking with graded confidence, package.json exports field resolution, and monorepo workspace resolution. Method calls like repo.findCallers() now resolve through receiver types instead of matching any findCallers in scope. Barrel files correctly show re-exported symbols. A precision/recall benchmark suite tracks call resolution accuracy across versions. On the infrastructure side, all hardcoded behavioral constants are centralized into DEFAULTS with recursive deep merge, and the TypeScript migration begins with project setup and core type definitions.
Features
- resolution: type inference for all typed languages (TS, Java, Go, Rust, C#, PHP, Python) —
obj.method()resolves through declared types in both WASM and native engines (#501) - resolution: receiver type tracking with graded confidence — constructors (
new Foo()) at 1.0, annotations at 0.9, factory methods at 0.7; highest-confidence assignment wins per variable (#505) - resolution:
package.jsonexportsfield and monorepo workspace resolution — conditional exports, subpath patterns, npm/pnpm/Yarn workspaces resolved with high confidence instead of brute-force filesystem probing (#509) - exports: show re-exported symbols for barrel files —
codegraph exportsnow traces through re-exports to show the actual consumers of each symbol (#515) - roles: dead role sub-categories —
dead-leaf,dead-entry,dead-ffi,dead-unresolvedreplace the coarsedeadrole for more precise dead code classification (#504) - config: centralize all hardcoded behavioral constants into
DEFAULTSwith recursive deep merge — partial.codegraphrc.jsonoverrides now preserve sibling keys (#506) - benchmarks: call resolution precision/recall benchmark suite — hand-annotated fixtures per language with expected-edges manifests, CI gate on accuracy regression (#507)
- benchmarks: child-process isolation for benchmarks — benchmark runner spawns builds in separate processes to prevent state leaks (#512)
- typescript: project setup for incremental migration —
tsconfig.json, build pipeline,dist/output with source maps (#508) - typescript: core type definitions (
src/types.ts) — comprehensive types for symbols, edges, nodes, config, queries, and all domain model interfaces (#516) - languages: add
.pyi,.phtml,.rake,.gemspecextensions to Python, PHP, and Ruby parsers (#502)
Bug Fixes
v3.2.0
Post-Phase 3 decomposition and dead code accuracy. This release completes a thorough decomposition of the remaining monolithic modules — language extractors, AST analysis visitors, domain analysis functions, and feature modules are all broken into focused, single-responsibility helpers. Dead code detection now correctly classifies symbols that are only referenced by tests as "test-only" instead of "dead", and constants are properly included in edge building so they no longer appear as false-positive dead exports. A new brief command provides token-efficient file summaries designed for AI hook context injection. The native engine gains a MAX_WALK_DEPTH guard to prevent stack overflows on deeply nested ASTs.
Features
- cli:
codegraph brief <file>command — token-efficient file summary with symbols, roles, caller counts, and risk tiers; designed for hook-based context injection (#480)
Bug Fixes
- roles: classify test-only-called symbols as "test-only" instead of "dead" — reduces false positives in dead code detection (#497)
- builder: include constant nodes in edge building — constants no longer appear as false-positive dead exports (#495)
- native: add MAX_WALK_DEPTH guard to native engine AST walkers — prevents stack overflows on deeply nested files (#484)
- cli: support repeated
--fileflag for multi-file scoping across all commands (#498) - versioning: use semver-compliant dev version numbering (
-dev.0suffix instead of non-standard format) (#479)
Refactors
- extractors: decompose monolithic language extractors (JS/TS, Python, Java) into per-category handlers (#490)
- ast-analysis: decompose AST analysis visitors and domain builder stages into focused helpers (#491)
- domain: decompose domain analysis and feature modules into single-responsibility functions (#492)
- presentation: split data fetching from formatting and extract CLI/MCP subcommand dispatch (#493)
- cleanup: dead code removal, shared abstractions, and empty catch block replacement across all layers (#489)