code-review-graph 2.0.0__tar.gz → 2.1.0__tar.gz

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code",
-    "version": "2.0.0"
+    "version": "2.1.0"
   },
   "plugins": [
     {
       "name": "code-review-graph",
       "source": "./",
       "description": "Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code",
-      "version": "2.0.0",
+      "version": "2.1.0",
       "category": "development",
       "keywords": ["code-review", "knowledge-graph", "incremental", "tree-sitter", "mcp", "claude-code"]
     }

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "code-review-graph",
   "description": "Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "author": {
     "name": "Tirth Kanani",
     "email": "tirthkanani18@gmail.com",

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-review-graph
-Version: 2.0.0
+Version: 2.1.0
 Summary: Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code
 Project-URL: Homepage, https://github.com/tirth8205/code-review-graph
 Project-URL: Repository, https://github.com/tirth8205/code-review-graph
@@ -59,17 +59,18 @@ Description-Content-Type: text/markdown
 </p>
 
 <p align="center">
+  <a href="https://code-review-graph.com"><img src="https://img.shields.io/badge/website-code--review--graph.com-blue?style=flat-square" alt="Website"></a>
   <a href="https://github.com/tirth8205/code-review-graph/stargazers"><img src="https://img.shields.io/github/stars/tirth8205/code-review-graph?style=flat-square" alt="Stars"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT Licence"></a>
   <a href="https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml"><img src="https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue.svg?style=flat-square" alt="Python 3.10+"></a>
   <a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP-compatible-green.svg?style=flat-square" alt="MCP"></a>
-  <a href="#"><img src="https://img.shields.io/badge/version-2.0.0-purple.svg?style=flat-square" alt="v2.0.0"></a>
+  <a href="#"><img src="https://img.shields.io/badge/version-2.1.0-purple.svg?style=flat-square" alt="v2.1.0"></a>
 </p>
 
 <br>
 
-Claude Code re-reads your entire codebase on every task. `code-review-graph` fixes that. It builds a structural map of your code with [Tree-sitter](https://tree-sitter.github.io/tree-sitter/), tracks changes incrementally, and gives Claude precise context so it reads only what matters.
+AI coding tools re-read your entire codebase on every task. `code-review-graph` fixes that. It builds a structural map of your code with [Tree-sitter](https://tree-sitter.github.io/tree-sitter/), tracks changes incrementally, and gives your AI assistant precise context via [MCP](https://modelcontextprotocol.io/) so it reads only what matters.
 
 <p align="center">
   <img src="diagrams/diagram1_before_vs_after.png" alt="The Token Problem: 8.2x average token reduction across 6 real repositories" width="85%" />
@@ -80,12 +81,16 @@ Claude Code re-reads your entire codebase on every task. `code-review-graph` fix
 ## Quick Start
 
 ```bash
-pip install code-review-graph
+pip install code-review-graph                     # or: pipx install code-review-graph
 code-review-graph install          # auto-detects and configures all supported platforms
 code-review-graph build            # parse your codebase
 ```
 
-One command sets up everything. `install` detects which AI coding tools you have and writes the correct MCP configuration for each one. Restart your editor/tool after installing.
+One command sets up everything. `install` detects which AI coding tools you have, writes the correct MCP configuration for each one, and injects graph-aware instructions into your platform rules. It auto-detects whether you installed via `uvx` or `pip`/`pipx` and generates the right config. Restart your editor/tool after installing.
+
+<p align="center">
+  <img src="diagrams/diagram8_supported_platforms.png" alt="One Install, Every Platform: auto-detects Claude Code, Cursor, Windsurf, Zed, Continue, OpenCode, and Antigravity" width="85%" />
+</p>
 
 To target a specific platform:
 
@@ -94,18 +99,7 @@ code-review-graph install --platform cursor      # configure only Cursor
 code-review-graph install --platform claude-code  # configure only Claude Code
 ```
 
-Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).
-
-### Supported Platforms
-
-| Platform | Config file | Auto-detected |
-|----------|-------------|:---:|
-| **Claude Code** | `.mcp.json` | Yes |
-| **Cursor** | `.cursor/mcp.json` | Yes |
-| **Windsurf** | `.windsurf/mcp.json` | Yes |
-| **Zed** | `.zed/settings.json` | Yes |
-| **Continue** | `.continue/config.json` | Yes |
-| **OpenCode** | `.opencode/config.json` | Yes |
+Requires Python 3.10+. For the best experience, install [uv](https://docs.astral.sh/uv/) (the MCP config will use `uvx` if available, otherwise falls back to the `code-review-graph` command directly).
 
 Then open your project and ask your AI assistant:
 
@@ -119,27 +113,25 @@ The initial build takes ~10 seconds for a 500-file project. After that, the grap
 
 ## How It Works
 
-Your repository is parsed into an AST with Tree-sitter, stored as a graph of nodes (functions, classes, imports) and edges (calls, inheritance, test coverage), then queried at review time to compute the minimal set of files Claude needs to read.
+<p align="center">
+  <img src="diagrams/diagram7_mcp_integration_flow.png" alt="How your AI assistant uses the graph: User asks for review, AI checks MCP tools, graph returns blast radius and risk scores, AI reads only what matters" width="80%" />
+</p>
+
+Your repository is parsed into an AST with Tree-sitter, stored as a graph of nodes (functions, classes, imports) and edges (calls, inheritance, test coverage), then queried at review time to compute the minimal set of files your AI assistant needs to read.
 
 <p align="center">
   <img src="diagrams/diagram2_architecture_pipeline.png" alt="Architecture pipeline: Repository to Tree-sitter Parser to SQLite Graph to Blast Radius to Minimal Review Set" width="100%" />
 </p>
 
-<details>
-<summary><strong>Blast-radius analysis</strong></summary>
-<br>
+### Blast-radius analysis
 
-When a file changes, the graph traces every caller, dependent, and test that could be affected. This is the "blast radius" of the change. Claude reads only these files instead of scanning the whole project.
+When a file changes, the graph traces every caller, dependent, and test that could be affected. This is the "blast radius" of the change. Your AI reads only these files instead of scanning the whole project.
 
 <p align="center">
   <img src="diagrams/diagram3_blast_radius.png" alt="Blast radius visualization showing how a change to login() propagates to callers, dependents, and tests" width="70%" />
 </p>
 
-</details>
-
-<details>
-<summary><strong>Incremental updates in &lt; 2 seconds</strong></summary>
-<br>
+### Incremental updates in < 2 seconds
 
 On every git commit or file save, a hook fires. The graph diffs changed files, finds their dependents via SHA-256 hash checks, and re-parses only what changed. A 2,900-file project re-indexes in under 2 seconds.
 
@@ -147,22 +139,30 @@ On every git commit or file save, a hook fires. The graph diffs changed files, f
   <img src="diagrams/diagram4_incremental_update.png" alt="Incremental update flow: git commit triggers diff, finds dependents, re-parses only 5 files while 2,910 are skipped" width="90%" />
 </p>
 
-</details>
+### The monorepo problem, solved
 
-<details>
-<summary><strong>18 supported languages</strong></summary>
-<br>
+Large monorepos are where token waste is most painful. The graph cuts through the noise — 27,700+ files excluded from review context, only ~15 files actually read.
+
+<p align="center">
+  <img src="diagrams/diagram6_monorepo_funnel.png" alt="Next.js monorepo: 27,732 files funnelled through code-review-graph down to ~15 files — 49x fewer tokens" width="80%" />
+</p>
 
-Python, TypeScript/TSX, JavaScript, Vue, Go, Rust, Java, Scala, C#, Ruby, Kotlin, Swift, PHP, Solidity, C/C++, Dart, R, Perl
+### 19 languages + Jupyter notebooks
 
-Each language has full Tree-sitter grammar support for functions, classes, imports, call sites, inheritance, and test detection.
+<p align="center">
+  <img src="diagrams/diagram9_language_coverage.png" alt="19 languages organized by category: Web, Backend, Systems, Mobile, Scripting, plus Jupyter/Databricks notebook support" width="90%" />
+</p>
 
-</details>
+Full Tree-sitter grammar support for functions, classes, imports, call sites, inheritance, and test detection in every language. Plus Jupyter/Databricks notebook parsing (`.ipynb`) with multi-language cell support (Python, R, SQL), and Perl XS files (`.xs`).
 
 ---
 
 ## Benchmarks
 
+<p align="center">
+  <img src="diagrams/diagram5_benchmark_board.png" alt="Benchmarks across real repos: 4.9x to 27.3x fewer tokens, higher review quality" width="85%" />
+</p>
+
 All numbers come from the automated evaluation runner against 6 real open-source repositories (13 commits total). Reproduce with `code-review-graph eval --all`. Raw data in [`evaluate/reports/summary.md`](evaluate/reports/summary.md).
 
 <details>
@@ -230,6 +230,30 @@ The blast-radius analysis never misses an actually impacted file (perfect recall
 
 ---
 
+## Features
+
+| Feature | Details |
+|---------|---------|
+| **Incremental updates** | Re-parses only changed files. Subsequent updates complete in under 2 seconds. |
+| **19 languages + notebooks** | Python, TypeScript/TSX, JavaScript, Vue, Go, Rust, Java, Scala, C#, Ruby, Kotlin, Swift, PHP, Solidity, C/C++, Dart, R, Perl, Lua, Jupyter/Databricks (.ipynb) |
+| **Blast-radius analysis** | Shows exactly which functions, classes, and files are affected by any change |
+| **Auto-update hooks** | Graph updates on every file edit and git commit without manual intervention |
+| **Semantic search** | Optional vector embeddings via sentence-transformers, Google Gemini, or MiniMax |
+| **Interactive visualisation** | D3.js force-directed graph with edge-type toggles and search |
+| **Local storage** | SQLite file in `.code-review-graph/`. No external database, no cloud dependency. |
+| **Watch mode** | Continuous graph updates as you work |
+| **Execution flows** | Trace call chains from entry points, sorted by criticality |
+| **Community detection** | Cluster related code via Leiden algorithm or file grouping |
+| **Architecture overview** | Auto-generated architecture map with coupling warnings |
+| **Risk-scored reviews** | `detect_changes` maps diffs to affected functions, flows, and test gaps |
+| **Refactoring tools** | Rename preview, dead code detection, community-driven suggestions |
+| **Wiki generation** | Auto-generate markdown wiki from community structure |
+| **Multi-repo registry** | Register multiple repos, search across all of them |
+| **MCP prompts** | 5 workflow templates: review, architecture, debug, onboard, pre-merge |
+| **Full-text search** | FTS5-powered hybrid search combining keyword and vector similarity |
+
+---
+
 ## Usage
 
 <details>
@@ -268,10 +292,10 @@ code-review-graph serve            # Start MCP server
 </details>
 
 <details>
-<summary><strong>MCP tools</strong></summary>
+<summary><strong>22 MCP tools</strong></summary>
 <br>
 
-Claude uses these automatically once the graph is built.
+Your AI assistant uses these automatically once the graph is built.
 
 | Tool | Description |
 |------|-------------|
@@ -303,30 +327,6 @@ Claude uses these automatically once the graph is built.
 
 </details>
 
----
-
-## Features
-
-| Feature | Details |
-|---------|---------|
-| **Incremental updates** | Re-parses only changed files. Subsequent updates complete in under 2 seconds. |
-| **18 languages** | Python, TypeScript/TSX, JavaScript, Vue, Go, Rust, Java, Scala, C#, Ruby, Kotlin, Swift, PHP, Solidity, C/C++, Dart, R, Perl |
-| **Blast-radius analysis** | Shows exactly which functions, classes, and files are affected by any change |
-| **Auto-update hooks** | Graph updates on every file edit and git commit without manual intervention |
-| **Semantic search** | Optional vector embeddings via sentence-transformers, Google Gemini, or MiniMax |
-| **Interactive visualisation** | D3.js force-directed graph with edge-type toggles and search |
-| **Local storage** | SQLite file in `.code-review-graph/`. No external database, no cloud dependency. |
-| **Watch mode** | Continuous graph updates as you work |
-| **Execution flows** | Trace call chains from entry points, sorted by criticality |
-| **Community detection** | Cluster related code via Leiden algorithm or file grouping |
-| **Architecture overview** | Auto-generated architecture map with coupling warnings |
-| **Risk-scored reviews** | `detect_changes` maps diffs to affected functions, flows, and test gaps |
-| **Refactoring tools** | Rename preview, dead code detection, community-driven suggestions |
-| **Wiki generation** | Auto-generate markdown wiki from community structure |
-| **Multi-repo registry** | Register multiple repos, search across all of them |
-| **MCP prompts** | 5 workflow templates: review, architecture, debug, onboard, pre-merge |
-| **Full-text search** | FTS5-powered hybrid search combining keyword and vector similarity |
-
 <details>
 <summary><strong>Configuration</strong></summary>
 <br>
@@ -379,6 +379,7 @@ MIT. See [LICENSE](LICENSE).
 
 <p align="center">
 <br>
+<a href="https://code-review-graph.com">code-review-graph.com</a><br><br>
 <code>pip install code-review-graph && code-review-graph install</code><br>
-<sub>Works with Claude Code, Cursor, Windsurf, Zed, Continue, and OpenCode</sub>
+<sub>Works with Claude Code, Cursor, Windsurf, Zed, Continue, OpenCode, and Antigravity</sub>
 </p>

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/README.md

@@ -5,17 +5,18 @@
 </p>
 
 <p align="center">
+  <a href="https://code-review-graph.com"><img src="https://img.shields.io/badge/website-code--review--graph.com-blue?style=flat-square" alt="Website"></a>
   <a href="https://github.com/tirth8205/code-review-graph/stargazers"><img src="https://img.shields.io/github/stars/tirth8205/code-review-graph?style=flat-square" alt="Stars"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square" alt="MIT Licence"></a>
   <a href="https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml"><img src="https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue.svg?style=flat-square" alt="Python 3.10+"></a>
   <a href="https://modelcontextprotocol.io/"><img src="https://img.shields.io/badge/MCP-compatible-green.svg?style=flat-square" alt="MCP"></a>
-  <a href="#"><img src="https://img.shields.io/badge/version-2.0.0-purple.svg?style=flat-square" alt="v2.0.0"></a>
+  <a href="#"><img src="https://img.shields.io/badge/version-2.1.0-purple.svg?style=flat-square" alt="v2.1.0"></a>
 </p>
 
 <br>
 
-Claude Code re-reads your entire codebase on every task. `code-review-graph` fixes that. It builds a structural map of your code with [Tree-sitter](https://tree-sitter.github.io/tree-sitter/), tracks changes incrementally, and gives Claude precise context so it reads only what matters.
+AI coding tools re-read your entire codebase on every task. `code-review-graph` fixes that. It builds a structural map of your code with [Tree-sitter](https://tree-sitter.github.io/tree-sitter/), tracks changes incrementally, and gives your AI assistant precise context via [MCP](https://modelcontextprotocol.io/) so it reads only what matters.
 
 <p align="center">
   <img src="diagrams/diagram1_before_vs_after.png" alt="The Token Problem: 8.2x average token reduction across 6 real repositories" width="85%" />
@@ -26,12 +27,16 @@ Claude Code re-reads your entire codebase on every task. `code-review-graph` fix
 ## Quick Start
 
 ```bash
-pip install code-review-graph
+pip install code-review-graph                     # or: pipx install code-review-graph
 code-review-graph install          # auto-detects and configures all supported platforms
 code-review-graph build            # parse your codebase
 ```
 
-One command sets up everything. `install` detects which AI coding tools you have and writes the correct MCP configuration for each one. Restart your editor/tool after installing.
+One command sets up everything. `install` detects which AI coding tools you have, writes the correct MCP configuration for each one, and injects graph-aware instructions into your platform rules. It auto-detects whether you installed via `uvx` or `pip`/`pipx` and generates the right config. Restart your editor/tool after installing.
+
+<p align="center">
+  <img src="diagrams/diagram8_supported_platforms.png" alt="One Install, Every Platform: auto-detects Claude Code, Cursor, Windsurf, Zed, Continue, OpenCode, and Antigravity" width="85%" />
+</p>
 
 To target a specific platform:
 
@@ -40,18 +45,7 @@ code-review-graph install --platform cursor      # configure only Cursor
 code-review-graph install --platform claude-code  # configure only Claude Code
 ```
 
-Requires Python 3.10+ and [uv](https://docs.astral.sh/uv/).
-
-### Supported Platforms
-
-| Platform | Config file | Auto-detected |
-|----------|-------------|:---:|
-| **Claude Code** | `.mcp.json` | Yes |
-| **Cursor** | `.cursor/mcp.json` | Yes |
-| **Windsurf** | `.windsurf/mcp.json` | Yes |
-| **Zed** | `.zed/settings.json` | Yes |
-| **Continue** | `.continue/config.json` | Yes |
-| **OpenCode** | `.opencode/config.json` | Yes |
+Requires Python 3.10+. For the best experience, install [uv](https://docs.astral.sh/uv/) (the MCP config will use `uvx` if available, otherwise falls back to the `code-review-graph` command directly).
 
 Then open your project and ask your AI assistant:
 
@@ -65,27 +59,25 @@ The initial build takes ~10 seconds for a 500-file project. After that, the grap
 
 ## How It Works
 
-Your repository is parsed into an AST with Tree-sitter, stored as a graph of nodes (functions, classes, imports) and edges (calls, inheritance, test coverage), then queried at review time to compute the minimal set of files Claude needs to read.
+<p align="center">
+  <img src="diagrams/diagram7_mcp_integration_flow.png" alt="How your AI assistant uses the graph: User asks for review, AI checks MCP tools, graph returns blast radius and risk scores, AI reads only what matters" width="80%" />
+</p>
+
+Your repository is parsed into an AST with Tree-sitter, stored as a graph of nodes (functions, classes, imports) and edges (calls, inheritance, test coverage), then queried at review time to compute the minimal set of files your AI assistant needs to read.
 
 <p align="center">
   <img src="diagrams/diagram2_architecture_pipeline.png" alt="Architecture pipeline: Repository to Tree-sitter Parser to SQLite Graph to Blast Radius to Minimal Review Set" width="100%" />
 </p>
 
-<details>
-<summary><strong>Blast-radius analysis</strong></summary>
-<br>
+### Blast-radius analysis
 
-When a file changes, the graph traces every caller, dependent, and test that could be affected. This is the "blast radius" of the change. Claude reads only these files instead of scanning the whole project.
+When a file changes, the graph traces every caller, dependent, and test that could be affected. This is the "blast radius" of the change. Your AI reads only these files instead of scanning the whole project.
 
 <p align="center">
   <img src="diagrams/diagram3_blast_radius.png" alt="Blast radius visualization showing how a change to login() propagates to callers, dependents, and tests" width="70%" />
 </p>
 
-</details>
-
-<details>
-<summary><strong>Incremental updates in &lt; 2 seconds</strong></summary>
-<br>
+### Incremental updates in < 2 seconds
 
 On every git commit or file save, a hook fires. The graph diffs changed files, finds their dependents via SHA-256 hash checks, and re-parses only what changed. A 2,900-file project re-indexes in under 2 seconds.
 
@@ -93,22 +85,30 @@ On every git commit or file save, a hook fires. The graph diffs changed files, f
   <img src="diagrams/diagram4_incremental_update.png" alt="Incremental update flow: git commit triggers diff, finds dependents, re-parses only 5 files while 2,910 are skipped" width="90%" />
 </p>
 
-</details>
+### The monorepo problem, solved
 
-<details>
-<summary><strong>18 supported languages</strong></summary>
-<br>
+Large monorepos are where token waste is most painful. The graph cuts through the noise — 27,700+ files excluded from review context, only ~15 files actually read.
+
+<p align="center">
+  <img src="diagrams/diagram6_monorepo_funnel.png" alt="Next.js monorepo: 27,732 files funnelled through code-review-graph down to ~15 files — 49x fewer tokens" width="80%" />
+</p>
 
-Python, TypeScript/TSX, JavaScript, Vue, Go, Rust, Java, Scala, C#, Ruby, Kotlin, Swift, PHP, Solidity, C/C++, Dart, R, Perl
+### 19 languages + Jupyter notebooks
 
-Each language has full Tree-sitter grammar support for functions, classes, imports, call sites, inheritance, and test detection.
+<p align="center">
+  <img src="diagrams/diagram9_language_coverage.png" alt="19 languages organized by category: Web, Backend, Systems, Mobile, Scripting, plus Jupyter/Databricks notebook support" width="90%" />
+</p>
 
-</details>
+Full Tree-sitter grammar support for functions, classes, imports, call sites, inheritance, and test detection in every language. Plus Jupyter/Databricks notebook parsing (`.ipynb`) with multi-language cell support (Python, R, SQL), and Perl XS files (`.xs`).
 
 ---
 
 ## Benchmarks
 
+<p align="center">
+  <img src="diagrams/diagram5_benchmark_board.png" alt="Benchmarks across real repos: 4.9x to 27.3x fewer tokens, higher review quality" width="85%" />
+</p>
+
 All numbers come from the automated evaluation runner against 6 real open-source repositories (13 commits total). Reproduce with `code-review-graph eval --all`. Raw data in [`evaluate/reports/summary.md`](evaluate/reports/summary.md).
 
 <details>
@@ -176,6 +176,30 @@ The blast-radius analysis never misses an actually impacted file (perfect recall
 
 ---
 
+## Features
+
+| Feature | Details |
+|---------|---------|
+| **Incremental updates** | Re-parses only changed files. Subsequent updates complete in under 2 seconds. |
+| **19 languages + notebooks** | Python, TypeScript/TSX, JavaScript, Vue, Go, Rust, Java, Scala, C#, Ruby, Kotlin, Swift, PHP, Solidity, C/C++, Dart, R, Perl, Lua, Jupyter/Databricks (.ipynb) |
+| **Blast-radius analysis** | Shows exactly which functions, classes, and files are affected by any change |
+| **Auto-update hooks** | Graph updates on every file edit and git commit without manual intervention |
+| **Semantic search** | Optional vector embeddings via sentence-transformers, Google Gemini, or MiniMax |
+| **Interactive visualisation** | D3.js force-directed graph with edge-type toggles and search |
+| **Local storage** | SQLite file in `.code-review-graph/`. No external database, no cloud dependency. |
+| **Watch mode** | Continuous graph updates as you work |
+| **Execution flows** | Trace call chains from entry points, sorted by criticality |
+| **Community detection** | Cluster related code via Leiden algorithm or file grouping |
+| **Architecture overview** | Auto-generated architecture map with coupling warnings |
+| **Risk-scored reviews** | `detect_changes` maps diffs to affected functions, flows, and test gaps |
+| **Refactoring tools** | Rename preview, dead code detection, community-driven suggestions |
+| **Wiki generation** | Auto-generate markdown wiki from community structure |
+| **Multi-repo registry** | Register multiple repos, search across all of them |
+| **MCP prompts** | 5 workflow templates: review, architecture, debug, onboard, pre-merge |
+| **Full-text search** | FTS5-powered hybrid search combining keyword and vector similarity |
+
+---
+
 ## Usage
 
 <details>
@@ -214,10 +238,10 @@ code-review-graph serve            # Start MCP server
 </details>
 
 <details>
-<summary><strong>MCP tools</strong></summary>
+<summary><strong>22 MCP tools</strong></summary>
 <br>
 
-Claude uses these automatically once the graph is built.
+Your AI assistant uses these automatically once the graph is built.
 
 | Tool | Description |
 |------|-------------|
@@ -249,30 +273,6 @@ Claude uses these automatically once the graph is built.
 
 </details>
 
----
-
-## Features
-
-| Feature | Details |
-|---------|---------|
-| **Incremental updates** | Re-parses only changed files. Subsequent updates complete in under 2 seconds. |
-| **18 languages** | Python, TypeScript/TSX, JavaScript, Vue, Go, Rust, Java, Scala, C#, Ruby, Kotlin, Swift, PHP, Solidity, C/C++, Dart, R, Perl |
-| **Blast-radius analysis** | Shows exactly which functions, classes, and files are affected by any change |
-| **Auto-update hooks** | Graph updates on every file edit and git commit without manual intervention |
-| **Semantic search** | Optional vector embeddings via sentence-transformers, Google Gemini, or MiniMax |
-| **Interactive visualisation** | D3.js force-directed graph with edge-type toggles and search |
-| **Local storage** | SQLite file in `.code-review-graph/`. No external database, no cloud dependency. |
-| **Watch mode** | Continuous graph updates as you work |
-| **Execution flows** | Trace call chains from entry points, sorted by criticality |
-| **Community detection** | Cluster related code via Leiden algorithm or file grouping |
-| **Architecture overview** | Auto-generated architecture map with coupling warnings |
-| **Risk-scored reviews** | `detect_changes` maps diffs to affected functions, flows, and test gaps |
-| **Refactoring tools** | Rename preview, dead code detection, community-driven suggestions |
-| **Wiki generation** | Auto-generate markdown wiki from community structure |
-| **Multi-repo registry** | Register multiple repos, search across all of them |
-| **MCP prompts** | 5 workflow templates: review, architecture, debug, onboard, pre-merge |
-| **Full-text search** | FTS5-powered hybrid search combining keyword and vector similarity |
-
 <details>
 <summary><strong>Configuration</strong></summary>
 <br>
@@ -325,6 +325,7 @@ MIT. See [LICENSE](LICENSE).
 
 <p align="center">
 <br>
+<a href="https://code-review-graph.com">code-review-graph.com</a><br><br>
 <code>pip install code-review-graph && code-review-graph install</code><br>
-<sub>Works with Claude Code, Cursor, Windsurf, Zed, Continue, and OpenCode</sub>
+<sub>Works with Claude Code, Cursor, Windsurf, Zed, Continue, OpenCode, and Antigravity</sub>
 </p>

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/code_review_graph/__init__.py

@@ -1,3 +1,3 @@
 """Code Review Graph - MCP server for persistent incremental code knowledge graphs."""
 
-__version__ = "2.0.0"
+__version__ = "2.1.0"

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/code_review_graph/cli.py

@@ -104,6 +104,8 @@ def _handle_init(args: argparse.Namespace) -> None:
 
     dry_run = getattr(args, "dry_run", False)
     target = getattr(args, "platform", "all") or "all"
+    if target == "claude-code":
+        target = "claude"
 
     print("Installing MCP server config...")
     configured = install_platform_configs(repo_root, target=target, dry_run=dry_run)
@@ -117,28 +119,35 @@ def _handle_init(args: argparse.Namespace) -> None:
         print("\n[dry-run] No files were modified.")
         return
 
-    # Handle --skills, --hooks, --all flags
-    install_all = getattr(args, "install_all", False)
-    want_skills = getattr(args, "skills", False) or install_all
-    want_hooks = getattr(args, "hooks", False) or install_all
-
-    if want_skills or want_hooks:
-        from .skills import generate_skills, inject_claude_md, install_hooks
+    # Skills and hooks are installed by default so Claude actually uses the
+    # graph tools proactively.  Use --no-skills / --no-hooks to opt out.
+    skip_skills = getattr(args, "no_skills", False)
+    skip_hooks = getattr(args, "no_hooks", False)
+    # Legacy: --skills/--hooks/--all still accepted (no-op, everything is default)
+
+    from .skills import (
+        generate_skills,
+        inject_claude_md,
+        inject_platform_instructions,
+        install_hooks,
+    )
 
-        if want_skills:
-            skills_dir = generate_skills(repo_root)
-            print(f"Generated skills in {skills_dir}")
-            inject_claude_md(repo_root)
-            print("Updated CLAUDE.md with MCP tools reference")
+    if not skip_skills:
+        skills_dir = generate_skills(repo_root)
+        print(f"Generated skills in {skills_dir}")
+        inject_claude_md(repo_root)
+        updated = inject_platform_instructions(repo_root)
+        if updated:
+            print(f"Injected graph instructions into: {', '.join(updated)}")
 
-        if want_hooks:
-            install_hooks(repo_root)
-            print(f"Installed hooks in {repo_root / '.claude' / 'settings.json'}")
+    if not skip_hooks:
+        install_hooks(repo_root)
+        print(f"Installed hooks in {repo_root / '.claude' / 'settings.json'}")
 
     print()
     print("Next steps:")
     print("  1. code-review-graph build    # build the knowledge graph")
-    print("  2. Restart Claude Code        # to pick up the new MCP server")
+    print("  2. Restart your AI coding tool to pick up the new config")
 
 
 def main() -> None:
@@ -162,21 +171,22 @@ def main() -> None:
         help="Show what would be done without writing files",
     )
     install_cmd.add_argument(
-        "--skills", action="store_true",
-        help="Generate Claude Code skill files in .claude/skills/",
-    )
-    install_cmd.add_argument(
-        "--hooks", action="store_true",
-        help="Install Claude Code hooks in .claude/settings.json",
+        "--no-skills", action="store_true",
+        help="Skip generating Claude Code skill files",
     )
     install_cmd.add_argument(
-        "--all", action="store_true", dest="install_all",
-        help="Install skills, hooks, and CLAUDE.md integration",
+        "--no-hooks", action="store_true",
+        help="Skip installing Claude Code hooks",
     )
+    # Legacy flags (kept for backwards compat, now no-ops since all is default)
+    install_cmd.add_argument("--skills", action="store_true", help=argparse.SUPPRESS)
+    install_cmd.add_argument("--hooks", action="store_true", help=argparse.SUPPRESS)
+    install_cmd.add_argument("--all", action="store_true", dest="install_all",
+                             help=argparse.SUPPRESS)
     install_cmd.add_argument(
         "--platform",
         choices=[
-            "claude", "cursor", "windsurf", "zed",
+            "claude", "claude-code", "cursor", "windsurf", "zed",
             "continue", "opencode", "antigravity", "all",
         ],
         default="all",
@@ -192,21 +202,21 @@ def main() -> None:
         help="Show what would be done without writing files",
     )
     init_cmd.add_argument(
-        "--skills", action="store_true",
-        help="Generate Claude Code skill files in .claude/skills/",
+        "--no-skills", action="store_true",
+        help="Skip generating Claude Code skill files",
     )
     init_cmd.add_argument(
-        "--hooks", action="store_true",
-        help="Install Claude Code hooks in .claude/settings.json",
-    )
-    init_cmd.add_argument(
-        "--all", action="store_true", dest="install_all",
-        help="Install skills, hooks, and CLAUDE.md integration",
+        "--no-hooks", action="store_true",
+        help="Skip installing Claude Code hooks",
     )
+    init_cmd.add_argument("--skills", action="store_true", help=argparse.SUPPRESS)
+    init_cmd.add_argument("--hooks", action="store_true", help=argparse.SUPPRESS)
+    init_cmd.add_argument("--all", action="store_true", dest="install_all",
+                             help=argparse.SUPPRESS)
     init_cmd.add_argument(
         "--platform",
         choices=[
-            "claude", "cursor", "windsurf", "zed",
+            "claude", "claude-code", "cursor", "windsurf", "zed",
             "continue", "opencode", "antigravity", "all",
         ],
         default="all",
@@ -432,6 +442,21 @@ def main() -> None:
             print(f"Files: {stats.files_count}")
             print(f"Languages: {', '.join(stats.languages)}")
             print(f"Last updated: {stats.last_updated or 'never'}")
+            # Show branch info and warn if stale
+            stored_branch = store.get_metadata("git_branch")
+            stored_sha = store.get_metadata("git_head_sha")
+            if stored_branch:
+                print(f"Built on branch: {stored_branch}")
+            if stored_sha:
+                print(f"Built at commit: {stored_sha[:12]}")
+            from .incremental import _git_branch_info
+            current_branch, current_sha = _git_branch_info(repo_root)
+            if stored_branch and current_branch and stored_branch != current_branch:
+                print(
+                    f"WARNING: Graph was built on '{stored_branch}' "
+                    f"but you are now on '{current_branch}'. "
+                    f"Run 'code-review-graph build' to rebuild."
+                )
 
         elif args.command == "watch":
             watch(repo_root, store)

{code_review_graph-2.0.0 → code_review_graph-2.1.0}/code_review_graph/embeddings.py

@@ -62,7 +62,11 @@ class LocalEmbeddingProvider(EmbeddingProvider):
         if self._model is None:
             try:
                 from sentence_transformers import SentenceTransformer
-                self._model = SentenceTransformer(self._model_name)
+                self._model = SentenceTransformer(
+                    self._model_name,
+                    trust_remote_code=True,
+                    model_kwargs={"trust_remote_code": True},
+                )
             except ImportError:
                 raise ImportError(
                     "sentence-transformers not installed. "