Releases: optave/ops-codegraph-tool
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
Dev build 3.5.1-dev.8
Dev build from commit 08090239335df67b4eed15b115d3c1b9c4d564b9 on main.
Dev build 3.5.1-dev.3
Dev build from commit 0dd2d345ad4416e96c361647bd5c0a4a5538955d on main.
Dev build 3.5.1-dev.1
Dev build from commit 7631c23416b334ef74e5dc9d97e3ae20a34e3223 on main.
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)
v3.1.5
Phase 3 architectural refactoring completes. This release finishes the remaining two Phase 3 roadmap tasks — domain directory grouping (3.15) and CLI composability (3.16) — bringing Phase 3 to 14 of 14 tasks complete. The src/ directory is now reorganized into domain/, features/, and presentation/ layers. A new openGraph() helper eliminates DB-open/close boilerplate across CLI commands, and a universal output formatter adds --table and --csv output to all commands. Several post-reorganization bugs are fixed: complexity/CFG/dataflow analysis restored after the move, MCP server imports corrected, worktree boundary escapes prevented, CJS require() support added, and LIKE wildcard injection in queries patched.
Features
- cli:
openGraph()helper and universal output formatter with--tableand--csvoutput formats — eliminates per-command DB boilerplate and format-switching logic (#461)
Bug Fixes
- builder: restore complexity/CFG/dataflow analysis that silently stopped running after src/ reorganization (#469)
- db: prevent
findDbPathfrom escaping git worktree boundary — stops codegraph from accidentally using a parent repo's database (#457) - mcp: update MCP server import path after src/ reorganization (#466)
- api: add CJS
require()support to package exports — fixesERR_REQUIRE_ESMfor CommonJS consumers (#472) - db: escape LIKE wildcards in
NodeQuery.fileFilterandnameLike— prevents filenames containing%or_from matching unrelated rows (#446)
Refactors
- architecture: reorganize
src/intodomain/,features/,presentation/layers — completes Phase 3.15 domain directory grouping (#456) - architecture: move remaining flat
src/files into subdirectories (#458) - architecture: resolve three post-reorganization issues (circular imports, barrel exports, path corrections) (#459)
- queries: deduplicate BFS impact traversal and centralize config loading (#463)
- tests: migrate integration tests to InMemoryRepository for faster execution (#462)
Tests
- db: add
findRepoRootandfindDbPathceiling boundary tests (#475)