@sdsrs/code-graph 0.5.48 → 0.7.0

package/README.md

@@ -4,10 +4,11 @@ A high-performance code knowledge graph server implementing the [Model Context P
 
 ## Features
 
-- **Multi-language parsing** — Tree-sitter AST extraction for TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML, CSS
+- **Multi-language parsing** — Tree-sitter AST extraction for 16 languages: TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, C#, Kotlin, Ruby, PHP, Swift, Dart, HTML, CSS
 - **Semantic code search** — Hybrid BM25 full-text + vector semantic search with Reciprocal Rank Fusion (RRF), powered by sqlite-vec
 - **Call graph traversal** — Recursive CTE queries to trace callers/callees with cycle detection
-- **HTTP route tracing** — Map route paths to backend handler functions (Express, Flask/FastAPI, Go)
+- **HTTP route tracing** — Map route paths to backend handler functions (Express, Flask/FastAPI, Go, ASP.NET, Rails, Laravel, Vapor)
+- **Dead code detection** — Find unreferenced symbols with smart Orphan/Exported-Unused classification
 - **Impact analysis** — Determine the blast radius of code changes by tracing all dependents
 - **Incremental indexing** — Merkle tree change detection with file system watcher for real-time updates. Smart event filtering skips metadata-only changes (chmod, xattr)
 - **Context compression** — Token-aware snippet extraction for LLM context windows (L0→full code, L1→summaries, L2→file groups, L3→directory overview). Compact JSON output saves 15-20% tokens
@@ -44,6 +45,18 @@ Single binary, embedded SQLite, bundled sqlite-vec extension, optional local emb
 
 Every design decision — from token-aware compression to node_id-based snippet expansion — is optimized for LLM context windows. Works out of the box with Claude Code, Cursor, Windsurf, and any MCP-compatible client.
 
+## Performance
+
+| Metric | Value |
+|--------|-------|
+| Indexing speed | **300+ files/second** (single-threaded, release build) |
+| Incremental re-index | **<250ms** no-change detection via BLAKE3 Merkle tree |
+| FTS search P50 / P99 | **<300us / <1ms** |
+| Database overhead | **~3.5MB** per 800 nodes |
+| Token savings | **5-20x fewer tokens** per code understanding task vs grep+read |
+
+Run `code-graph-mcp benchmark` on your own project to measure.
+
 ## Efficiency: code-graph vs Traditional Tools
 
 Real-world benchmarks comparing code-graph-mcp tools against traditional approaches (Grep + Read + Glob) on a 33-file Rust project (~537 AST nodes).
@@ -88,13 +101,15 @@ Real-world benchmarks comparing code-graph-mcp tools against traditional approac
 
 ```
 src/
+├── domain.rs     # Shared constants, relation types, env-var config
 ├── mcp/          # MCP protocol layer (JSON-RPC, tool registry, server)
-├── parser/       # Tree-sitter parsing, relation extraction, language support
+│   └── server/   # McpServer with IndexingState + CacheState sub-structs
+├── parser/       # Tree-sitter parsing, relation extraction, LanguageConfig dispatch
 ├── indexer/      # 3-phase pipeline, Merkle tree, file watcher
-├── storage/      # SQLite schema, CRUD, FTS5 full-text search
+├── storage/      # SQLite schema (v6), CRUD, FTS5, migrations
 ├── graph/        # Recursive CTE call graph queries
 ├── search/       # RRF fusion search combining BM25 + vector
-├── embedding/    # Candle embedding model (optional)
+├── embedding/    # Candle embedding model (optional, masked mean pooling)
 ├── sandbox/      # Context compressor with token estimation
 └── utils/        # Language detection, config
 ```
@@ -212,9 +227,12 @@ npm uninstall -g @sdsrs/code-graph
 | `trace_http_chain` | Full request flow: route → handler → downstream call chain |
 | `impact_analysis` | Analyze the blast radius of changing a symbol |
 | `module_overview` | High-level overview of a module's structure and exports |
-| `dependency_graph` | Visualize dependency relationships between modules |
-| `find_similar_code` | Find code snippets similar to a given pattern |
-| `get_ast_node` | Extract a specific code symbol with signature, body, and relations |
+| `dependency_graph` | Visualize dependency relationships between modules. Supports `compact` mode |
+| `find_similar_code` | Find semantically similar code via embeddings. Requires `symbol_name` or `node_id` |
+| `get_ast_node` | Extract a specific code symbol with signature, body, and relations. Supports `compact` mode |
+| `ast_search` | Search AST nodes by text and/or structural filters (type, return type, params) |
+| `find_references` | Find all references to a symbol (callers, importers, inheritors). Supports `compact` mode |
+| `find_dead_code` | Find unused code — orphan symbols and exported-but-unused public APIs |
 
 ## Plugin Slash Commands
 
@@ -228,9 +246,26 @@ Available when installed as a Claude Code plugin:
 | `/status` | Show code-graph index status and embedding progress |
 | `/rebuild` | Force a full code-graph index rebuild |
 
-## Supported Languages
-
-TypeScript, JavaScript, Go, Python, Rust, Java, C, C++, HTML, CSS
+## Supported Languages (16)
+
+| Language | Extensions | Relations Extracted |
+|----------|-----------|-------------------|
+| TypeScript | .ts, .tsx | calls, imports, exports, inherits, implements, routes_to |
+| JavaScript | .js, .jsx, .mjs, .cjs | calls, imports, exports, inherits, routes_to |
+| Go | .go | calls, imports, routes_to |
+| Python | .py, .pyi | calls, imports, inherits, routes_to |
+| Rust | .rs | calls, imports, inherits, implements |
+| Java | .java | calls, imports, inherits, implements |
+| C# | .cs | calls, imports, inherits, implements |
+| Kotlin | .kt, .kts | calls, imports, inherits |
+| Ruby | .rb | calls, imports, inherits |
+| PHP | .php | calls, imports, inherits, implements |
+| Swift | .swift | calls, imports, inherits |
+| Dart | .dart | calls, imports, implements |
+| C | .c, .h | calls, imports |
+| C++ | .cpp, .cc, .cxx, .hpp | calls, imports, inherits |
+| HTML | .html, .htm | structural parsing |
+| CSS | .css | structural parsing |
 
 ## Storage
 
@@ -283,6 +318,9 @@ cargo test --no-default-features
 
 # Check compilation
 cargo check
+
+# Run performance benchmarks (indexing, search, call graph)
+cargo bench --no-default-features
 ```
 
 ## License

package/claude-plugin/.claude-plugin/plugin.json

@@ -4,7 +4,7 @@
   "author": {
     "name": "sdsrs"
   },
-  "version": "0.5.48",
+  "version": "0.7.0",
   "keywords": [
     "code-graph",
     "ast",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdsrs/code-graph",
-  "version": "0.5.48",
+  "version": "0.7.0",
   "description": "MCP server that indexes codebases into an AST knowledge graph with semantic search, call graph traversal, and HTTP route tracing",
   "license": "MIT",
   "repository": {
@@ -33,10 +33,10 @@
     "node": ">=16"
   },
   "optionalDependencies": {
-    "@sdsrs/code-graph-linux-x64": "0.5.48",
-    "@sdsrs/code-graph-linux-arm64": "0.5.48",
-    "@sdsrs/code-graph-darwin-x64": "0.5.48",
-    "@sdsrs/code-graph-darwin-arm64": "0.5.48",
-    "@sdsrs/code-graph-win32-x64": "0.5.48"
+    "@sdsrs/code-graph-linux-x64": "0.7.0",
+    "@sdsrs/code-graph-linux-arm64": "0.7.0",
+    "@sdsrs/code-graph-darwin-x64": "0.7.0",
+    "@sdsrs/code-graph-darwin-arm64": "0.7.0",
+    "@sdsrs/code-graph-win32-x64": "0.7.0"
   }
 }