code-review-graph vs ESLint

Parses source code using Tree-sitter AST parsing across 40+ languages, extracting structural entities (functions, classes, types, imports) and storing them in a persistent knowledge graph. Tracks file changes via SHA-256 hashing to enable incremental updates—only re-parsing modified files rather than rescanning the entire codebase on each invocation. The parser system maintains a directed graph of code entities and their relationships (CALLS, IMPORTS_FROM, INHERITS, CONTAINS, TESTED_BY, DEPENDS_ON) without requiring full re-indexing.

Unique: Uses Tree-sitter AST parsing with SHA-256 incremental tracking instead of regex or line-based analysis, enabling structural awareness across 40+ languages while avoiding redundant re-parsing of unchanged files. The incremental update system (diagram 4) tracks file hashes to determine which entities need re-extraction, reducing indexing time from O(n) to O(delta) for large codebases.

vs alternatives: Faster and more accurate than LSP-based indexing for offline analysis because it maintains a persistent graph that survives session boundaries and doesn't require a running language server per language.

When a file changes, the system traces the directed graph to identify all potentially affected code entities—callers, dependents, inheritors, and tests. This 'blast radius' computation uses graph traversal algorithms (BFS/DFS) to walk the CALLS, IMPORTS_FROM, INHERITS, DEPENDS_ON, and TESTED_BY edges, producing a minimal set of files and functions that Claude must review. The system excludes irrelevant files from context, reducing token consumption by 6.8x to 49x depending on repository structure and change scope.

Unique: Implements graph-based blast radius computation (diagram 3) that traces structural dependencies to identify affected code, rather than heuristic-based approaches like 'files in the same directory' or 'files modified in the same commit'. The system achieves 49x token reduction on monorepos by excluding 27,000+ irrelevant files from review context.

vs alternatives: More precise than git-based impact analysis (which only tracks file co-modification history) because it understands actual code dependencies and can exclude files that changed together but don't affect each other.

Includes an automated evaluation framework (`code-review-graph eval --all`) that benchmarks the tool against real open-source repositories, measuring token reduction, impact analysis accuracy, and query performance. The framework compares naive full-file context inclusion against graph-optimized context, reporting metrics like average token reduction (8.2x across tested repos, up to 49x on monorepos), precision/recall of blast radius analysis, and query latency. Results are aggregated and visualized in benchmark reports, enabling teams to understand the expected token savings for their codebase.

Unique: Includes an automated evaluation framework that benchmarks token reduction against real open-source repositories, reporting metrics like 8.2x average reduction and up to 49x on monorepos. The framework enables teams to understand expected cost savings and validate tool performance on their specific codebase.

vs alternatives: More rigorous than anecdotal claims because it provides quantified metrics from real repositories and enables teams to measure performance on their own code, rather than relying on vendor claims.

Persists the knowledge graph to a local SQLite database, enabling the graph to survive across sessions and be queried without re-parsing the entire codebase. The storage layer maintains tables for nodes (entities), edges (relationships), and metadata, with indexes optimized for common query patterns (entity lookup, relationship traversal, impact analysis). The SQLite backend is lightweight, requires no external services, and supports concurrent read access, making it suitable for local development workflows and CI/CD integration.

Unique: Uses SQLite as a lightweight, zero-configuration graph storage backend with indexes optimized for common query patterns (entity lookup, relationship traversal, impact analysis). The storage layer supports concurrent read access and requires no external services.

vs alternatives: Simpler than cloud-based graph databases (Neo4j, ArangoDB) because it requires no external services or configuration, making it suitable for local development and CI/CD pipelines.

Exposes the knowledge graph as an MCP (Model Context Protocol) server that Claude Code and other LLM assistants can query via standardized tool calls. The MCP server implements a set of tools (graph management, query, impact analysis, review context, semantic search, utility, and advanced analysis tools) that allow Claude to request only the relevant code context for a task instead of re-reading entire files. Integration is bidirectional: Claude sends queries (e.g., 'what functions call this one?'), and the MCP server returns structured graph results that fit within token budgets.

Unique: Implements MCP server with a comprehensive tool suite (graph management, query, impact analysis, review context, semantic search, utility, and advanced analysis tools) that allows Claude to query the knowledge graph directly rather than relying on manual context injection. The MCP integration is bidirectional—Claude can request specific code context and receive only what's needed.

vs alternatives: More efficient than context injection (copy-pasting code into Claude) because the MCP server can return only the relevant subgraph, and Claude can make follow-up queries without re-reading the entire codebase.

Generates embeddings for code entities (functions, classes, documentation) and stores them in a vector index, enabling semantic search queries like 'find functions that handle authentication' or 'locate all database connection logic'. The system uses embedding models (likely OpenAI or similar) to convert code and natural language queries into vector space, then performs similarity search to retrieve relevant code entities without requiring exact keyword matches. Results are ranked by semantic relevance and integrated into the MCP tool suite for Claude to query.

Unique: Integrates semantic search into the MCP tool suite, allowing Claude to discover code by meaning rather than keyword matching. The system generates embeddings for code entities and maintains a vector index that supports similarity queries, enabling Claude to find related code patterns without explicit keyword searches.

vs alternatives: More effective than regex or keyword-based search for discovering related code patterns because it understands semantic relationships (e.g., 'authentication' and 'login' are related even if they don't share keywords).

Monitors the filesystem for code changes (via file watchers or git hooks) and automatically triggers incremental graph updates without manual intervention. When files are modified, the system detects changes via SHA-256 hashing, re-parses only affected files, and updates the knowledge graph in real-time. Auto-update hooks integrate with git workflows (pre-commit, post-commit) to keep the graph synchronized with the working directory, ensuring Claude always has current structural information.

Unique: Implements filesystem-level watch mode with git hook integration (diagram 4) that automatically triggers incremental graph updates without manual intervention. The system uses SHA-256 change detection to identify modified files and re-parses only those files, keeping the graph synchronized in real-time.

vs alternatives: More convenient than manual graph rebuild commands because it runs continuously in the background and integrates with git workflows, ensuring the graph is always current without developer action.

Generates concise, token-optimized summaries of code changes and their context by combining blast radius analysis with semantic search. Instead of sending entire files to Claude, the system produces structured summaries that include: changed code snippets, affected functions/classes, test coverage, and related code patterns. The summaries are designed to fit within Claude's context window while providing sufficient information for accurate code review, achieving 6.8x to 49x token reduction compared to naive full-file inclusion.

Unique: Combines blast radius analysis with semantic search to generate token-optimized code review context that includes changed code, affected entities, and related patterns. The system achieves 6.8x to 49x token reduction by excluding irrelevant files and providing structured summaries instead of full-file context.

vs alternatives: More efficient than sending entire changed files to Claude because it uses graph-based impact analysis to identify only the relevant code and semantic search to find related patterns, resulting in significantly lower token consumption.

Executes ESLint rules against the active editor file as the user types or on file save, rendering violations as colored squiggles and inline decorations directly in the editor gutter. The extension hooks into VS Code's diagnostic API to push linting results from the ESLint library (installed locally or globally) into the editor's rendering pipeline, enabling immediate visual feedback without requiring manual linting commands.

Unique: Integrates directly with VS Code's native diagnostic API and editor rendering pipeline, allowing ESLint violations to appear as native squiggles and gutter decorations rather than as separate panel output; uses the ESLint library's rule engine directly without wrapping or re-implementing linting logic.

vs alternatives: Tighter VS Code integration than generic linting tools because it leverages VS Code's built-in diagnostic system and respects editor theme colors for error/warning rendering, whereas standalone linters require separate output parsing.

Automatically applies ESLint's `--fix` capability to the active file when saved, modifying the file in-place to correct fixable violations (e.g., formatting, semicolon insertion, import sorting). The extension triggers the ESLint library's fix mode on the save event, applies the corrected code back to the editor buffer, and updates diagnostics to reflect the post-fix state.

Unique: Leverages ESLint's native `--fix` API rather than implementing a separate formatting engine; integrates the fix operation into VS Code's save event lifecycle, allowing fixes to be applied transparently without user interaction or separate command invocation.

vs alternatives: More reliable than Prettier-only solutions because it respects ESLint rule configuration and can fix non-formatting issues (e.g., import sorting, variable naming); more integrated than running ESLint as a separate task because fixes are applied synchronously on save.

Caches linting results for files that have not changed, avoiding redundant ESLint execution and improving performance for large codebases. The extension tracks file modifications and only re-runs ESLint for changed files, reducing computational overhead and latency for real-time linting feedback.

Unique: Implements file-level caching to avoid redundant ESLint execution, tracking file modifications and only re-linting changed files; caching strategy is transparent to users and requires no configuration.

vs alternatives: More performant than re-linting all files on every change because it only processes modified files; more transparent than manual cache management because caching is automatic and invisible to users.

Maps ESLint rule severity levels (error, warning, off) to VS Code diagnostic severity levels (Error, Warning, Information), rendering violations with appropriate colors and icons in the editor. The extension translates ESLint's severity classification into VS Code's diagnostic system, enabling consistent visual representation across the editor and Problems panel.

Unique: Maps ESLint severity levels directly to VS Code's diagnostic API, enabling native severity rendering without custom UI; respects VS Code's theme and editor settings for diagnostic colors and icons.

vs alternatives: More integrated than custom severity rendering because it uses VS Code's native diagnostic system; more consistent than separate severity indicators because it leverages the editor's built-in visual language.

Aggregates all linting violations from the active file and workspace into VS Code's built-in Problems panel, displaying violations with severity levels (error, warning, info) and allowing filtering by severity. The extension pushes diagnostic data into VS Code's diagnostic collection, which automatically populates the Problems panel and respects the `eslint.quiet` setting to suppress info-level messages.

Unique: Uses VS Code's native diagnostic collection API to push ESLint violations into the Problems panel, allowing seamless integration with VS Code's built-in error aggregation and navigation UI rather than implementing a custom panel.

vs alternatives: More discoverable than inline-only linting because violations are visible in a dedicated panel even when the file is not in focus; more integrated than external linting tools because it uses VS Code's native UI rather than requiring a separate output window.

Automatically detects and loads ESLint configuration from either flat config format (`eslint.config.js`, `.mjs`, `.cjs`, `.ts`, `.mts`) or legacy format (`.eslintrc.*` in JSON, JS, YAML) based on what exists in the workspace. The extension respects the `eslint.useFlatConfig` setting to force flat config mode for ESLint 8.57.0+, and falls back to legacy config detection for older versions.

Unique: Implements automatic detection of both flat and legacy config formats without requiring explicit user configuration; uses the `eslint.useFlatConfig` setting to allow users to force flat config mode for ESLint 8.57+, enabling gradual migration from legacy to flat config.

vs alternatives: More flexible than tools that only support one config format because it handles both legacy and flat configs transparently; more user-friendly than requiring manual config path specification because it automatically discovers configs in standard locations.

Allows users to specify which file types should be linted by configuring the `eslint.validate` setting with an array of VS Code language identifiers (e.g., `["javascript", "typescript", "javascriptreact"]`). The extension checks each file's language identifier against the configured list before running ESLint, skipping linting for files not in the list.

Unique: Uses VS Code's language identifier system to filter files before linting, allowing granular control over which file types are processed; integrates with VS Code's language detection rather than implementing custom file type detection.

vs alternatives: More precise than file extension-based filtering because it respects VS Code's language detection (e.g., distinguishing between JavaScript and JSX); more flexible than ESLint's built-in ignore patterns because it operates at the extension level before ESLint is invoked.

Provides a `eslint.quiet` boolean setting that, when enabled, suppresses ESLint info-level diagnostic messages while preserving error and warning messages. The extension filters diagnostics before pushing them to VS Code's diagnostic collection, removing entries with severity below warning level.

Unique: Implements message filtering at the extension level after ESLint execution, allowing users to suppress info-level messages without modifying ESLint configuration or rules; provides a simple boolean toggle rather than complex filtering logic.

vs alternatives: Simpler than configuring ESLint rules to disable info-level messages because it requires only a single setting change; more effective than ESLint's built-in severity configuration because it applies uniformly across all rules.