depgraph-core 1.5.1 → 1.8.0

package/README.md

@@ -3,13 +3,13 @@
 [![npm version](https://img.shields.io/npm/v/depgraph-core.svg)](https://www.npmjs.com/package/depgraph-core)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**DepGraph Core** is a powerful static analysis CLI that maps code dependencies and simulates the ripple-effect impact of changes across multi-language codebases — supporting JavaScript, TypeScript, Python, Go, C#, Java, Kotlin, PHP, Ruby, and Swift. By parsing imports, exports, functions, classes, interfaces, and methods, DepGraph constructs a comprehensive dependency graph, computes centrality metrics, and generates impact simulations — helping you prevent regression bugs in large systems.
+**DepGraph Core** is a powerful static analysis CLI that maps code dependencies and simulates the ripple-effect impact of changes across multi-language codebases — supporting JavaScript, TypeScript, Python, Go, C#, Java, Kotlin, PHP, Ruby, Swift, and Rust. By parsing imports, exports, functions, classes, interfaces, and methods, DepGraph constructs a comprehensive dependency graph, computes centrality metrics, and generates impact simulations — helping you prevent regression bugs in large systems.
 
 ---
 
 ## Key Features
 
-- **Multi-Language AST & Regex Code Parsing**: Comprehensive native extractors for **10 languages**:
+- **Multi-Language AST & Regex Code Parsing**: Comprehensive native extractors for **11 languages**:
   - **JavaScript / TypeScript / React** (`.js`, `.jsx`, `.ts`, `.tsx`, `.mjs`, `.cjs`)
   - **Python** (`.py`)
   - **Go** (`.go`)
@@ -19,6 +19,7 @@
   - **PHP** (`.php`)
   - **Ruby** (`.rb`)
   - **Swift** (`.swift`)
+  - **Rust** (`.rs`)
 - **Dependency Graph Reconstruction**: Resolves local imports, aliases, namespace packages, and cross-file relationships to build a full topology map of your codebase.
 - **Metrics & Centrality Analysis**: Calculates in-degree, out-degree, and centrality scores for every entity to automatically identify **Critical Nodes**.
 - **Impact Simulation Engine**: Runs a reverse BFS to model the cascading impact of changing a specific function or class. Generates a risk score, lists affected nodes, and provides an actionable testing plan.
@@ -30,7 +31,7 @@
 
 ## Supported Languages
 
-DepGraph Core provides native parsing and symbol extraction across 10 major programming languages:
+DepGraph Core provides native parsing and symbol extraction across 11 major programming languages:
 
 | Language | Extensions | Extracted Entities | Import & Resolution Features |
 | :--- | :--- | :--- | :--- |
@@ -43,6 +44,7 @@ DepGraph Core provides native parsing and symbol extraction across 10 major prog
 | **PHP** | `.php` | Classes (abstract, final), Interfaces, Traits, Enums, Functions, Methods | Namespaces, single & grouped `use` statements, `use ... as` aliases, `require`/`include` file paths |
 | **Ruby** | `.rb` | Classes, Modules, Instance methods, Class methods (`def self.`), `attr_accessor`/`reader`/`writer` | `require`, `require_relative`, `load`, `include`, `extend`, `prepend` |
 | **Swift** | `.swift` | Classes, Structs, Enums, Protocols, Actors, Extensions (including `where` constraints), Functions, Initializers | Module imports, sub-module imports, kind-specifier imports (`import class/func/...`) |
+| **Rust** | `.rs` | Functions, Structs (named & tuple fields), Enums (tuple & struct variants), Traits, Impl blocks, Methods | Single & grouped `use` statements, `crate::`/`super::`/`self::` modules, aliases (`as`) |
 
 ---
 
@@ -222,7 +224,7 @@ Recommendations
 Output written to ./depgraph-output.json
 ```
 
-**Supported languages for diff parsing:** All 10 languages (JavaScript/TypeScript, Python, Go, C#, Java, Kotlin, PHP, Ruby, and Swift) are fully supported via shared entity pattern registries and fallbacks.
+**Supported languages for diff parsing:** All 11 languages (JavaScript/TypeScript, Python, Go, C#, Java, Kotlin, PHP, Ruby, Swift, and Rust) are fully supported via shared entity pattern registries and fallbacks.
 
 ---
 
@@ -303,6 +305,45 @@ When running `--impact` or `--git-impact`, the tool performs:
 
 ---
 
+## Claude Code Integration (MCP)
+
+DepGraph ships an **MCP server** (`depgraph-mcp`) that lets Claude analyze your codebase and simulate impact directly inside a conversation — no copy-pasting output required.
+
+### Quick setup
+
+**1. Build the MCP server**
+```bash
+npm install
+npm run release:all   # compiles + bundles both CLI and MCP server
+```
+
+**2. Register with Claude Code** (run once)
+```bash
+claude mcp add depgraph -- node /absolute/path/to/depgraph/depgraph-mcp.js
+```
+
+**3. Use it** — open Claude Code in any project and ask naturally:
+```
+Summarize the dependency graph of /Users/me/my-app
+What is the risk of changing getUserById in /Users/me/my-app?
+Show the impact of the last commit in /Users/me/my-app
+```
+
+### Available MCP tools
+
+| Tool | What it does |
+| :--- | :--- |
+| `get_graph_summary` | Quick overview — counts, critical nodes, entry/leaf points |
+| `analyze_project` | Full dependency graph — all nodes, edges, and file metadata |
+| `simulate_impact` | Risk score + affected nodes for a named function or class |
+| `git_impact` | Detect git-changed entities and simulate their downstream impact |
+
+For the full reference (parameters, examples, removal) see [docs/claude-code-integration.md](docs/claude-code-integration.md).
+
+> **Backward compatible** — the existing `depgraph` CLI is untouched. All current scripts and CI pipelines continue to work without changes.
+
+---
+
 ## Development & Contribution
 
 ### Setup
@@ -317,8 +358,11 @@ npm install
 | Command | Description |
 | :--- | :--- |
 | `npm run build` | Compile TypeScript → `dist/` |
-| `npm run bundle` | Bundle `dist/main.js` → `depgraph.js` via esbuild |
-| `npm run release` | Build + bundle in one step |
+| `npm run bundle` | Bundle CLI → `depgraph.js` via esbuild |
+| `npm run bundle:mcp` | Bundle MCP server → `depgraph-mcp.js` via esbuild |
+| `npm run release` | Build + bundle CLI |
+| `npm run release:mcp` | Build + bundle MCP server |
+| `npm run release:all` | Build + bundle both CLI and MCP server |
 | `npm run test` | Run tests in watch mode (vitest) |
 | `npm run test:run` | Run tests once (for CI) |