code-review-graph 1.2.0__tar.gz

code_review_graph-1.2.0/.claude-plugin/plugin.json

@@ -0,0 +1,11 @@
+{
+  "name": "code-review-graph",
+  "description": "Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code",
+  "version": "1.0.0",
+  "author": {
+    "name": "Tirth"
+  },
+  "repository": "https://github.com/tirth/code-review-graph",
+  "license": "MIT",
+  "tags": ["code-review", "knowledge-graph", "incremental", "tree-sitter"]
+}

code_review_graph-1.2.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.10"
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+      - name: Lint with ruff
+        run: ruff check code_review_graph/
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: pip install -e ".[dev]" pytest-cov
+      - name: Run tests with coverage
+        run: pytest --tb=short -q --cov=code_review_graph --cov-report=term-missing

code_review_graph-1.2.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Graph database
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+.code-review-graph.db
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Node (if any JS tooling)
+node_modules/
+
+# Claude Code
+.claude/
+
+# Coverage
+htmlcov/
+.coverage
+.coverage.*
+
+# pytest
+.pytest_cache/
+
+# mypy
+.mypy_cache/

code_review_graph-1.2.0/.mcp.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "code-review-graph": {
+      "command": "python",
+      "args": ["-m", "code_review_graph.main"],
+      "cwd": "."
+    }
+  }
+}

code_review_graph-1.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tirth
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

code_review_graph-1.2.0/PKG-INFO

@@ -0,0 +1,323 @@
+Metadata-Version: 2.4
+Name: code-review-graph
+Version: 1.2.0
+Summary: Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code
+Author: Tirth
+License-Expression: MIT
+License-File: LICENSE
+Keywords: claude-code,code-review,knowledge-graph,mcp,tree-sitter
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Requires-Dist: fastmcp>=0.1.0
+Requires-Dist: gitpython>=3.1.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: networkx>=3.2
+Requires-Dist: tree-sitter-language-pack>=0.3.0
+Requires-Dist: tree-sitter>=0.23.0
+Requires-Dist: watchdog>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.3.0; extra == 'dev'
+Provides-Extra: embeddings
+Requires-Dist: numpy>=1.26; extra == 'embeddings'
+Requires-Dist: sentence-transformers>=3.0.0; extra == 'embeddings'
+Description-Content-Type: text/markdown
+
+# code-review-graph
+
+**Persistent incremental knowledge graph for token-efficient, context-aware code reviews with Claude Code.**
+
+[![GitHub stars](https://img.shields.io/github/stars/tirth8205/code-review-graph?style=flat-square)](https://github.com/tirth8205/code-review-graph/stargazers)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml/badge.svg)](https://github.com/tirth8205/code-review-graph/actions/workflows/ci.yml)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg?style=flat-square)](https://www.python.org/)
+[![MCP](https://img.shields.io/badge/MCP-compatible-green.svg?style=flat-square)](https://modelcontextprotocol.io/)
+[![v1.2.0](https://img.shields.io/badge/version-1.2.0-purple.svg?style=flat-square)](#)
+
+---
+
+> It turns Claude from "smart but forgetful tourist" into "local expert who already knows the map."
+
+Stop re-scanning your entire codebase on every review. `code-review-graph` builds a structural graph of your code using Tree-sitter, tracks it incrementally, and gives Claude Code the context it needs to review only what changed — and everything affected by those changes.
+
+| Without graph | With graph |
+|---|---|
+| Full repo scan every review | Only changed + impacted files |
+| No blast-radius awareness | Automatic impact analysis |
+| Token-heavy (entire codebase) | **5-10x fewer tokens** per review |
+| Manual "what else does this affect?" | Graph-powered dependency tracing |
+
+---
+
+## ✨ Features
+
+- **Incremental updates** — Only re-parses files that changed since last build. Subsequent updates take <2s.
+- **12+ languages** — Python, TypeScript, JavaScript, Go, Rust, Java, C#, Ruby, Kotlin, Swift, PHP, C/C++
+- **Blast-radius analysis** — See exactly which functions, classes, and files are impacted by any change
+- **Token-efficient reviews** — Send only changed + impacted code to the model, not your entire repo
+- **Auto-update hooks** — Graph stays current on every file edit and git commit
+- **Vector embeddings** — Optional semantic search across your codebase with sentence-transformers
+- **Watch mode** — Real-time graph updates as you code
+
+For the full feature list and changelog, see [docs/FEATURES.md](docs/FEATURES.md).
+
+---
+
+## 🚀 Quick Start
+
+### Installation (one command)
+
+```bash
+pip install code-review-graph
+```
+
+That's it. Works on Python 3.10+.
+
+With semantic search (optional):
+
+```bash
+pip install code-review-graph[embeddings]
+```
+
+### CLI
+
+```bash
+code-review-graph build      # Parse your entire codebase
+code-review-graph update     # Incremental update (only changed files)
+code-review-graph watch      # Real-time auto-updates as you code
+code-review-graph status     # Show graph statistics
+code-review-graph serve      # Start MCP server
+```
+
+No git clone. No manual venv. No Python upgrade needed.
+
+### Connect to Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "code-review-graph": {
+      "command": "code-review-graph",
+      "args": ["serve"]
+    }
+  }
+}
+```
+
+### Use the skills
+
+```
+/code-review-graph:build-graph    # Parse your codebase (~10s for 500 files)
+/code-review-graph:review-delta   # Review only what changed
+/code-review-graph:review-pr      # Full PR review with blast-radius
+```
+
+**Before**: Claude reads 200 files, uses ~150k tokens.
+**After**: Claude reads 8 changed + 12 impacted files, uses ~25k tokens.
+
+For detailed usage instructions, see [docs/USAGE.md](docs/USAGE.md).
+
+---
+
+## 🛠️ How It Works
+
+```
+┌─────────────────────────────────────────────┐
+│                Claude Code                   │
+│  ┌─────────┐  ┌──────────┐  ┌────────────┐ │
+│  │  Skills  │  │  Hooks   │  │   Agent    │ │
+│  └────┬────┘  └────┬─────┘  └─────┬──────┘ │
+│       │            │               │         │
+│       └────────────┼───────────────┘         │
+│                    │                         │
+│              ┌─────▼─────┐                   │
+│              │ MCP Server │                  │
+│              └─────┬─────┘                   │
+└────────────────────┼────────────────────────┘
+                     │
+         ┌───────────┼───────────┐
+         │           │           │
+    ┌────▼───┐  ┌───▼────┐  ┌──▼──────────┐
+    │ Parser │  │ Graph  │  │ Incremental │
+    │(sitter)│  │(SQLite)│  │  (git diff) │
+    └────────┘  └────────┘  └─────────────┘
+```
+
+| Component | File | Role |
+|-----------|------|------|
+| **Parser** | `code_review_graph/parser.py` | Tree-sitter multi-language AST parser. Extracts nodes and relationships. |
+| **Graph** | `code_review_graph/graph.py` | SQLite-backed knowledge graph with NetworkX for traversal queries. |
+| **Incremental** | `code_review_graph/incremental.py` | Git-aware delta detection. Re-parses only changed files + dependents. |
+| **MCP Server** | `code_review_graph/main.py` | Exposes 8 tools to Claude Code via the Model Context Protocol. |
+| **Skills** | `skills/` | Three review workflows: `build-graph`, `review-delta`, `review-pr`. |
+| **Hooks** | `hooks/` | Auto-updates the graph on file edits and git commits. |
+
+For the full architecture walkthrough, see [docs/architecture.md](docs/architecture.md).
+
+---
+
+## 📚 Deep Dive
+
+Everything beyond the quick start lives in the [docs/](docs/) folder. Start with [docs/USAGE.md](docs/USAGE.md) for the full workflow guide.
+
+| Document | What's inside |
+|----------|---------------|
+| [Usage Guide](docs/USAGE.md) | Installation, workflows, and tips |
+| [Commands Reference](docs/COMMANDS.md) | All MCP tools, skills, and CLI commands |
+| [Features & Changelog](docs/FEATURES.md) | What's included and what changed |
+| [Architecture](docs/architecture.md) | System design and data flow |
+| [Schema](docs/schema.md) | Graph node/edge types and SQLite tables |
+| [Troubleshooting](docs/TROUBLESHOOTING.md) | Common issues and fixes |
+| [LLM-Optimized Reference](docs/LLM-OPTIMIZED-REFERENCE.md) | Token-optimized reference used by Claude Code |
+| [Roadmap](docs/ROADMAP.md) | Planned features |
+| [Legal & Privacy](docs/LEGAL.md) | License and data handling |
+
+---
+
+## Graph Schema
+
+### Nodes
+
+| Kind | Properties |
+|------|-----------|
+| **File** | path, language, last_parsed_hash, size |
+| **Class** | name, file, line_start, line_end, modifiers |
+| **Function** | name, file, class (nullable), line_start, line_end, params, return_type, is_test |
+| **Type** | name, file, kind (enum, interface, etc.) |
+| **Test** | name, file, tested_function |
+
+### Edges
+
+| Kind | Direction | Meaning |
+|------|-----------|---------|
+| **CALLS** | Function -> Function | Function calls another function |
+| **IMPORTS_FROM** | File -> File/Module | File imports from another |
+| **INHERITS** | Class -> Class | Class extends another |
+| **IMPLEMENTS** | Class -> Interface | Class implements an interface |
+| **CONTAINS** | File/Class -> Function/Class | Containment hierarchy |
+| **TESTED_BY** | Function -> Test | Function has a test |
+| **DEPENDS_ON** | Node -> Node | General dependency |
+
+For the full schema documentation, see [docs/schema.md](docs/schema.md).
+
+---
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `build_or_update_graph_tool` | Full or incremental graph build |
+| `get_impact_radius_tool` | Blast radius analysis for changed files |
+| `query_graph_tool` | Predefined relationship queries (callers, callees, tests, imports) |
+| `get_review_context_tool` | Token-optimized review context with source snippets |
+| `semantic_search_nodes_tool` | Search code entities by name/keyword/semantic similarity |
+| `embed_graph_tool` | Compute vector embeddings for semantic search |
+| `list_graph_stats_tool` | Graph statistics and health check |
+| `get_docs_section_tool` | Retrieve specific documentation sections (minimal tokens) |
+
+For usage details and examples, see [docs/COMMANDS.md](docs/COMMANDS.md).
+
+---
+
+## Supported Languages
+
+| Language | Extensions | Status |
+|----------|-----------|--------|
+| Python | `.py` | Full support |
+| TypeScript | `.ts`, `.tsx` | Full support |
+| JavaScript | `.js`, `.jsx` | Full support |
+| Go | `.go` | Full support |
+| Rust | `.rs` | Full support |
+| Java | `.java` | Full support |
+| C# | `.cs` | Full support |
+| Ruby | `.rb` | Full support |
+| Kotlin | `.kt` | Full support |
+| Swift | `.swift` | Full support |
+| PHP | `.php` | Full support |
+| C/C++ | `.c`, `.h`, `.cpp`, `.hpp` | Full support |
+
+---
+
+## Configuration
+
+Create a `.code-review-graphignore` file in your repo root to exclude paths:
+
+```
+# Ignore generated files
+generated/**
+*.generated.ts
+*.pb.go
+
+# Ignore vendor
+vendor/**
+third_party/**
+```
+
+---
+
+## 🧪 Testing
+
+```bash
+pip install -e ".[dev]"
+pytest
+ruff check code_review_graph/
+```
+
+47 tests covering parser, graph storage, MCP tools, and multi-language support (Go, Rust, Java).
+
+---
+
+## 🤝 Contributing
+
+### Adding a new language
+
+1. Add the extension mapping in `code_review_graph/parser.py` → `EXTENSION_TO_LANGUAGE`
+2. Add node type mappings in `_CLASS_TYPES`, `_FUNCTION_TYPES`, `_IMPORT_TYPES`, `_CALL_TYPES`
+3. Test with a sample file in that language
+4. Submit a PR
+
+### Development setup
+
+```bash
+git clone https://github.com/tirth8205/code-review-graph.git
+cd code-review-graph
+python3 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+pytest
+```
+
+---
+
+## Comparison
+
+| Feature | code-review-graph | code-graph-rag | CocoIndex |
+|---------|:-:|:-:|:-:|
+| Review-first design | Yes | No | No |
+| Claude Code integration | Native | No | No |
+| Incremental updates | Yes | Partial | Yes |
+| No external DB needed | Yes (SQLite) | No (Neo4j) | No |
+| Auto-update hooks | Yes | No | No |
+| Impact/blast radius | Yes | No | No |
+| Multi-language | 12+ languages | Python only | Varies |
+| Token-efficient reviews | Yes | No | No |
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE) for details.
+
+---
+
+<p align="center">Built with ❤️ for better code reviews</p>