codegraph-engine 2.2.1__py3-none-any.whl → 2.3.0__py3-none-any.whl

codegraph/symbol_history.py

@@ -0,0 +1,275 @@
+"""Deterministic Symbol History Engine.
+
+Traces the evolutionary history of a symbol across Git commits:
+- Symbol introduced / added
+- Symbol modified (signature, body, docstring)
+- Symbol renamed (tracked via AST structure & body hashes)
+- Symbol moved across files (tracked via Git renames and structural equality)
+- Symbol deleted
+
+Epistemic states:
+- FACT: Exact body hash match, canonical ID continuity, or Git rename (-M) metadata
+- POSSIBLE: Structural or signature similarity without identical body hash
+- AMBIGUOUS: Multiple candidate replacements detected
+- UNKNOWN: Disappeared with no identifiable successor
+"""
+from __future__ import annotations
+
+import hashlib
+import sqlite3
+import subprocess
+from dataclasses import dataclass, field
+from pathlib import Path
+from typing import Any
+
+from codegraph.git import recent_commits
+from codegraph.indexing.parser import parse
+from codegraph.indexing.scanner import LANGUAGES
+
+
+@dataclass
+class SymbolHistoryEvent:
+    commit_sha: str
+    date: str
+    author: str
+    message: str
+    event_type: str  # "INTRODUCED" | "MODIFIED" | "RENAMED" | "MOVED" | "DELETED"
+    path: str
+    old_path: str | None = None
+    old_name: str | None = None
+    new_name: str | None = None
+    confidence: str = "FACT"  # "FACT" | "POSSIBLE" | "AMBIGUOUS" | "UNKNOWN"
+    evidence: str = ""
+
+    def as_dict(self) -> dict[str, Any]:
+        return {
+            "commit_sha": self.commit_sha,
+            "date": self.date,
+            "author": self.author,
+            "message": self.message,
+            "event_type": self.event_type,
+            "path": self.path,
+            "old_path": self.old_path,
+            "old_name": self.old_name,
+            "new_name": self.new_name,
+            "confidence": self.confidence,
+            "evidence": self.evidence,
+        }
+
+
+@dataclass
+class SymbolHistoryReport:
+    symbol: str
+    current_path: str | None
+    events: list[SymbolHistoryEvent] = field(default_factory=list)
+    total_commits_evaluated: int = 0
+    status: str = "SUCCESS"  # "SUCCESS" | "NOT_FOUND" | "AMBIGUOUS"
+    detail: str = ""
+
+    def as_dict(self) -> dict[str, Any]:
+        return {
+            "symbol": self.symbol,
+            "current_path": self.current_path,
+            "events": [e.as_dict() for e in self.events],
+            "total_commits_evaluated": self.total_commits_evaluated,
+            "status": self.status,
+            "detail": self.detail,
+        }
+
+
+def _run_git(repository: Path, *args: str, timeout: int = 15) -> str | None:
+    for arg in args:
+        if any(c in arg for c in (";", "|", "&", "`", "$", "\n", "\r")):
+            return None
+    try:
+        res = subprocess.run(
+            ["git", *args],
+            cwd=str(repository),
+            capture_output=True,
+            text=True,
+            timeout=timeout,
+        )
+        return res.stdout if res.returncode == 0 else None
+    except (FileNotFoundError, subprocess.TimeoutExpired, OSError):
+        return None
+
+
+_BODY_HASH_CACHE: dict[tuple[int, str, str, str], tuple[str | None, int | None]] = {}
+
+
+def _get_symbol_body_hash(content: str, lang: str, file_path: str, symbol_name: str) -> tuple[str | None, int | None]:
+    """Parse content and compute content hash for symbol body with caching."""
+    if not content:
+        return None, None
+    c_hash = hash(content)
+    cache_key = (c_hash, lang, file_path, symbol_name)
+    if cache_key in _BODY_HASH_CACHE:
+        return _BODY_HASH_CACHE[cache_key]
+    try:
+        res = parse(content, lang, file_path)
+        for s in res.symbols:
+            if s.name == symbol_name:
+                lines = content.splitlines()
+                snippet = "\n".join(lines[max(0, s.start_line - 1) : s.end_line]).strip()
+                b_hash = hashlib.sha256(snippet.encode("utf-8", errors="replace")).hexdigest()[:16]
+                result = (b_hash, s.start_line)
+                if len(_BODY_HASH_CACHE) > 2000:
+                    _BODY_HASH_CACHE.clear()
+                _BODY_HASH_CACHE[cache_key] = result
+                return result
+        _BODY_HASH_CACHE[cache_key] = (None, None)
+        return None, None
+    except Exception:
+        return None, None
+
+
+def trace_symbol_history(
+    repository: Path,
+    symbol: str,
+    path: str | None = None,
+    con: sqlite3.Connection | None = None,
+    max_commits: int = 15,
+) -> SymbolHistoryReport:
+    """Trace the history of a symbol across Git commits deterministically."""
+    from codegraph.structural_diff import _get_file_content_at_ref
+
+    # 1. Resolve path if not provided
+    resolved_path = path
+    if not resolved_path and con is not None:
+        try:
+            row = con.execute("SELECT path FROM symbols WHERE name=? LIMIT 1", (symbol,)).fetchone()
+            if row:
+                resolved_path = str(row[0])
+        except (sqlite3.OperationalError, sqlite3.DatabaseError):
+            pass
+
+    # 2. Get commits affecting the file or symbol
+    commits = recent_commits(repository, n=max_commits * 2, path=resolved_path)
+    if not commits:
+        return SymbolHistoryReport(
+            symbol=symbol,
+            current_path=resolved_path,
+            events=[],
+            total_commits_evaluated=0,
+            status="NOT_FOUND",
+            detail=f"No Git commits found for symbol '{symbol}' or path '{resolved_path}'.",
+        )
+
+    events: list[SymbolHistoryEvent] = []
+    current_sym_name = symbol
+    current_sym_path = resolved_path or ""
+
+    prev_parent_content: str | None = None
+    prev_parent_hash: str | None = None
+    prev_parent_line: int | None = None
+    prev_parent_path: str | None = None
+
+    for c in commits:
+        if len(events) >= max_commits:
+            break
+
+        ext = Path(current_sym_path).suffix.lower() if current_sym_path else ".py"
+        lang = LANGUAGES.get(ext, "python")
+
+        # Fast path: check if curr_content was already loaded as parent in previous iteration
+        curr_content: str | None = None
+        curr_hash: str | None = None
+        curr_line: int | None = None
+
+        if prev_parent_content is not None and prev_parent_path == current_sym_path:
+            curr_content = prev_parent_content
+            curr_hash, curr_line = prev_parent_hash, prev_parent_line
+        else:
+            curr_content = _get_file_content_at_ref(repository, c.sha, current_sym_path) if current_sym_path else None
+            curr_hash, curr_line = _get_symbol_body_hash(curr_content or "", lang, current_sym_path, current_sym_name) if curr_content else (None, None)
+
+        # Get file content at parent commit c.sha~1
+        parent_content = _get_file_content_at_ref(repository, f"{c.sha}~1", current_sym_path) if current_sym_path else None
+        parent_hash, parent_line = _get_symbol_body_hash(parent_content or "", lang, current_sym_path, current_sym_name) if parent_content else (None, None)
+
+        # Store for next iteration
+        prev_parent_content = parent_content
+        prev_parent_hash = parent_hash
+        prev_parent_line = parent_line
+        prev_parent_path = current_sym_path
+
+        if curr_hash is not None and parent_hash is not None:
+            if curr_hash != parent_hash:
+                events.append(
+                    SymbolHistoryEvent(
+                        commit_sha=c.sha,
+                        date=c.date,
+                        author=c.author,
+                        message=c.message,
+                        event_type="MODIFIED",
+                        path=current_sym_path,
+                        confidence="FACT",
+                        evidence=f"Symbol modified at line {curr_line} (body hash changed)",
+                    )
+                )
+        elif curr_hash is not None and parent_hash is None:
+            # Symbol appeared in this commit! Did it rename or move from somewhere else?
+            found_move = False
+            # Check git diff --name-status c.sha~1 c.sha for renames
+            raw_rename = _run_git(repository, "diff", "-M", "--name-status", f"{c.sha}~1", c.sha)
+            if raw_rename:
+                for line in raw_rename.splitlines():
+                    if line.startswith("R") and current_sym_path in line:
+                        parts = line.split("\t")
+                        if len(parts) >= 3 and parts[2] == current_sym_path:
+                            old_p = parts[1]
+                            events.append(
+                                SymbolHistoryEvent(
+                                    commit_sha=c.sha,
+                                    date=c.date,
+                                    author=c.author,
+                                    message=c.message,
+                                    event_type="MOVED",
+                                    path=current_sym_path,
+                                    old_path=old_p,
+                                    confidence="FACT",
+                                    evidence=f"File moved from {old_p} to {current_sym_path}",
+                                )
+                            )
+                            current_sym_path = old_p
+                            found_move = True
+                            break
+
+            if not found_move:
+                # Check if introduced
+                events.append(
+                    SymbolHistoryEvent(
+                        commit_sha=c.sha,
+                        date=c.date,
+                        author=c.author,
+                        message=c.message,
+                        event_type="INTRODUCED",
+                        path=current_sym_path,
+                        confidence="FACT",
+                        evidence=f"Symbol created at {current_sym_path}:{curr_line}",
+                    )
+                )
+                break
+        elif curr_hash is None and parent_hash is not None:
+            # Symbol was deleted or renamed in curr_content
+            events.append(
+                SymbolHistoryEvent(
+                    commit_sha=c.sha,
+                    date=c.date,
+                    author=c.author,
+                    message=c.message,
+                    event_type="DELETED",
+                    path=current_sym_path,
+                    confidence="FACT",
+                    evidence=f"Symbol removed in commit {c.sha[:8]}",
+                )
+            )
+
+    return SymbolHistoryReport(
+        symbol=symbol,
+        current_path=resolved_path,
+        events=events,
+        total_commits_evaluated=len(commits),
+        status="SUCCESS" if events else "NOT_FOUND",
+        detail=f"Traced {len(events)} history event(s) across {len(commits)} commits.",
+    )

{codegraph_engine-2.2.1.dist-info → codegraph_engine-2.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraph-engine
-Version: 2.2.1
+Version: 2.3.0
 Summary: Deep deterministic repository intelligence for AI coding agents (code, dependencies, databases, and runtime observations)
 Author: CodeGraph contributors
 License-Expression: MIT
@@ -35,52 +35,104 @@ Dynamic: license-file
   <img src="docs/assets/codegraph_logo.jpg" alt="CodeGraph MCP — Deep Deterministic Repository Intelligence for AI Coding Agents" width="500" />
 </p>
 
-<h1 align="center">CodeGraph MCP Engine (v2.2.1)</h1>
+<h1 align="center">CodeGraph MCP Engine (v2.3.0)</h1>
 
 <p align="center">
-  <strong>Deep deterministic repository intelligence for AI coding agents.</strong>
+  <strong>Deterministic Codebase Intelligence for AI Coding Agents.</strong><br>
+  <em>High-performance Model Context Protocol (MCP) server for Claude Code, Cursor, Antigravity, Cline, and Codex.</em>
 </p>
 
 <p align="center">
-  <a href="https://pypi.org/project/codegraph-engine/2.2.1/"><img src="https://img.shields.io/badge/pypi-codegraph--engine%20v2.2.1-blue.svg" alt="PyPI: codegraph-engine v2.2.1" /></a>
+  <a href="https://pypi.org/project/codegraph-engine/2.3.0/"><img src="https://img.shields.io/badge/pypi-codegraph--engine%20v2.3.0-blue.svg" alt="PyPI: codegraph-engine v2.3.0" /></a>
   <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.12%20%7C%203.13-3776AB.svg" alt="Python 3.12 | 3.13" /></a>
-  <a href="src/codegraph/mcp/server.py"><img src="https://img.shields.io/badge/MCP-14%20default%20%7C%2056%20full%20tools-2ea043.svg" alt="MCP Tools: 14 default | 56 full" /></a>
-  <a href="tests/"><img src="https://img.shields.io/badge/pytest-861%20passed-brightgreen.svg" alt="Tests: 861 passed" /></a>
+  <a href="src/codegraph/mcp/server.py"><img src="https://img.shields.io/badge/MCP-14%20default%20%7C%2062%20full%20tools-2ea043.svg" alt="MCP Tools: 14 default | 62 full" /></a>
+  <a href="tests/"><img src="https://img.shields.io/badge/pytest-871%20passed-brightgreen.svg" alt="Tests: 871 passed" /></a>
   <a href="pyproject.toml"><img src="https://img.shields.io/badge/ruff-0%20errors-success.svg" alt="Ruff: 0 errors" /></a>
-  <a href="src/codegraph/"><img src="https://img.shields.io/badge/mypy-0%20issues%20(80%20files)-blue.svg" alt="Mypy: strict" /></a>
+  <a href="src/codegraph/"><img src="https://img.shields.io/badge/mypy-0%20issues%20(87%20files)-blue.svg" alt="Mypy: strict" /></a>
+  <a href="https://raghurammrsd.github.io/CODE_GRAPH_MCP/"><img src="https://img.shields.io/badge/docs-GitHub%20Pages-0969da.svg" alt="Documentation: GitHub Pages" /></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT" /></a>
 </p>
 
 <p align="center">
-  <a href="https://pypi.org/project/codegraph-engine/2.2.1/"><strong>PyPI (v2.2.1)</strong></a> •
-  <a href="#1-whats-new-in-v220"><strong>What's New in v2.2.1</strong></a> •
+  <a href="https://raghurammrsd.github.io/CODE_GRAPH_MCP/"><strong>Documentation Site</strong></a> •
+  <a href="https://pypi.org/project/codegraph-engine/2.3.0/"><strong>PyPI Package</strong></a> •
+  <a href="#overview"><strong>Overview</strong></a> •
+  <a href="#1-whats-new-in-v230-git-aware-intelligence"><strong>What's New in v2.3.0</strong></a> •
   <a href="#2-quickstart-30-second-setup"><strong>Quickstart</strong></a> •
-  <a href="#4-real-world-cli-outputs"><strong>Real-World Outputs</strong></a> •
+  <a href="#4-real-world-cli-outputs"><strong>CLI Outputs</strong></a> •
   <a href="#6-database-intelligence"><strong>Database Intelligence</strong></a> •
   <a href="#7-zero-friction-runtime-intelligence--static-reconciliation"><strong>Runtime Evidence</strong></a> •
-  <a href="#9-measured-performance-and-scaling-benchmarks"><strong>Measured Performance</strong></a> •
-  <a href="docs/agent-brain.md"><strong>56-Tool Reference</strong></a> •
+  <a href="#8-git-aware-repository-intelligence"><strong>Git Intelligence</strong></a> •
+  <a href="#10-measured-performance-and-scaling-benchmarks"><strong>Benchmarks</strong></a> •
+  <a href="docs/agent-brain.md"><strong>62-Tool Reference</strong></a> •
   <a href="https://github.com/raghurammrsd/CODE_GRAPH_MCP"><strong>GitHub</strong></a>
 </p>
 
+---
+
+## Overview
+
+### The Problem
+
+When AI coding agents (such as Claude Code, Cursor, or Antigravity) explore complex enterprise repositories, text-based search (grep/ripgrep) forces them to parse large, multi-thousand-line files to reconstruct call chains, router mounts, dependency injection graphs, and ORM schemas. This consumes 60% to 80% of the LLM context window with irrelevant code and frequently leads to hallucinations regarding entity relationships and database structures.
+
+### The Solution: CodeGraph MCP
+
+**CodeGraph MCP provides deterministic, compiler-grade repository intelligence through the Model Context Protocol.** Instead of guessing based on lexical approximations, the AI agent queries a local, persistent SQLite index for verified AST relationships, framework router trees, database lineages, and live runtime observations—resolved in sub-5ms latency.
+
 ```text
-The AI reasons.
-CodeGraph MCP interrogates the repository.
-The evidence stays traceable.
+       ┌─────────────────────────────────────────────────────────────┐
+       │                      AI CODING AGENT                        │
+       │           (Claude Code  •  Cursor  •  Antigravity)          │
+       └──────────────────────────────┬──────────────────────────────┘
+                                      │  Model Context Protocol (stdio / SSE)
+                                      ▼
+       ┌─────────────────────────────────────────────────────────────┐
+       │                   CODEGRAPH MCP ENGINE                      │
+       ├──────────────────────────────┬──────────────────────────────┤
+       │  AST Code Relationships      │  Framework Route Hierarchy   │
+       │  (Callers, Callees, DI)      │  (FastAPI, Django, Express)  │
+       ├──────────────────────────────┼──────────────────────────────┤
+       │  Database Lineage & Schemas  │  Non-Invasive Dev Tracing    │
+       │  (SQLAlchemy, Prisma, ORM)   │  (HTTP metrics, exceptions)  │
+       └──────────────────────────────┴──────────────────────────────┘
+                                      │
+                                      ▼
+             Deterministic • Local-First • Verified Evidence
 ```
 
-**CodeGraph MCP gives AI coding agents an evidence-backed understanding of code, dependencies, databases, and optional runtime observations.**
-> **Supported Languages & Frameworks:** First-class **Python** (`FastAPI`, `Flask`, `Django`, `SQLAlchemy`, `Celery`, `pytest`) + **TypeScript / JavaScript** (`.ts`, `.tsx`, `.js`, `.jsx`) & **Express.js** support.
+### Core Architecture Capabilities
+
+- **Zero Hallucination Guarantee**: Every returned entity and relationship is statically verified via Abstract Syntax Trees or explicitly flagged as `UNKNOWN` / `POSSIBLE`.
+- **Sub-5ms Freshness Verification**: Monotonic commit tracking validates `git rev-parse HEAD` and porcelain status instantly, avoiding full-tree re-indexing on unchanged codebases.
+- **Context Window Optimization**: Yields 65% to 85% token reduction by returning structured, bounded source slices rather than entire file dumps.
+- **Zero-Friction Dev Interception (`codegraph run`)**: Wraps local development servers (e.g., `codegraph run npm run dev`, `codegraph run uvicorn main:app`) to capture real HTTP routes, latencies, and stack traces without application code changes.
+- **Multi-Agent Setup (`codegraph install`)**: Automatically detects, configures, and verifies integrations for Claude Code, Cursor, Antigravity, and Cline.
 
-When an AI coding agent works inside a complex Python or full-stack codebase, raw text search forces it to open dozens of files and mentally reconstruct call chains, router prefixes, dependency injection providers, and ORM table mappings inside its context window. CodeGraph MCP eliminates blind exploration by interrogating the codebase for deterministic, AST-verified facts.
+> **Supported Languages & Frameworks:** Python (`FastAPI`, `Flask`, `Django`, `SQLAlchemy`, `Celery`, `pytest`) and TypeScript / JavaScript (`.ts`, `.tsx`, `.js`, `.jsx`, `Express.js`).
 
 ![CodeGraph MCP v2.2.1 Architecture & Concurrency Pipeline](docs/assets/v22_concurrency_runtime_pipeline.svg)
 
 ---
 
-## 1. What's New in v2.2.1
+## 1. What's New in v2.3.0 (Git-Aware Intelligence)
 
-Version `2.2.1` solves the core operational, concurrency, context saturation, and developer friction bottlenecks in the Agent-MCP ecosystem:
+Version `2.3.0` introduces compiler-grade **Git-Aware Repository Intelligence**, allowing AI agents and CI/CD pipelines to understand how code evolves across branches, commits, and working tree edits:
+
+| Capability | CLI Command | MCP Tool | How It Solves Agent Failure Modes |
+| :--- | :--- | :--- | :--- |
+| **Working-Tree Freshness** | `codegraph git-state` | `get_git_state` | Tracks branch, HEAD vs indexed commit, modified/staged files with sub-millisecond status caching. Surfaces `CLEAN`, `DIRTY`, `STALE`, `REINDEXING`, `ERROR`. |
+| **Structural AST Diff** | `codegraph git-diff [base] [head]` | `compare_git` | Semantic diff across Git revisions: identifies added/removed/modified functions, changed parameter signatures, and affected routes—not merely raw line diffs. |
+| **Deep Impact & Visual Tree** | `codegraph git-impact --tree` | `get_change_impact` | Traverses downstream callers, callees, framework routes, DB writers, and affected test suites with token-bounded ranking and terminal ASCII tree visualization. |
+| **Semantic Merge Conflicts** | `codegraph git-conflicts [base] [head]` | `detect_semantic_conflicts` | Detects silent contract breaks before merge: invoking functions or route handlers that were deleted or modified on the target branch. |
+| **Context Freshness Gate** | `codegraph check-freshness [task]` | `check_context_freshness` | Determines whether previously compiled context remains `VALID`, `PARTIALLY_STALE`, or `STALE` without re-running full graph queries if unrelated files changed. |
+| **Deterministic Symbol History** | `codegraph symbol-history <sym>` | `trace_symbol_history` | Reconstructs the exact commit lifecycle of any symbol (introduced, modified, moved, renamed, or deleted) with confidence labels. |
+
+---
+
+## 1.1 What's New in v2.2.1
+
+Version `2.2.1` introduced runtime telemetry reconciliation, SQLite WAL concurrency, and multi-transport SSE resilience:
 
 | Bottleneck Solved | How It Worked Before | CodeGraph MCP v2.2.1 Solution | Impact |
 | :--- | :--- | :--- | :--- |
@@ -404,6 +456,60 @@ UNRESOLVED_REFERENCE / POSSIBLE_CALLS (status = "UNKNOWN" | "POSSIBLE")
 
 ---
 
+## 8. Git-Aware Repository Intelligence & Merge Conflict Safety
+
+CodeGraph MCP v2.3.0 tracks the exact evolution of repository code across commits, branches, and working tree changes:
+
+```text
+Repository state
+    ↓
+Git change detection (CLEAN / DIRTY / STALE)
+    ↓
+Structural AST diff (functions, parameters, routes)
+    ↓
+Downstream impact analysis (callers, callees, tests, DB)
+    ↓
+Context freshness validation (VALID / PARTIALLY_STALE / STALE)
+    ↓
+Evidence-backed answer
+```
+
+### 1. Working Tree & Index Freshness (`codegraph git-state`)
+Tracks current branch, current HEAD commit, indexed commit, and modified/staged files with sub-millisecond status caching:
+```bash
+codegraph git-state
+```
+Never silently serves stale repository facts. Explicitly reports `CLEAN`, `DIRTY`, `STALE`, `REINDEXING`, or `ERROR`.
+
+### 2. Deep Visual Downstream Impact Tree (`codegraph git-impact --tree`)
+Traverses affected callers, routes, tests, and DB writers with token-bounded results and visual ASCII hierarchy:
+```bash
+codegraph git-impact --tree
+```
+
+### 3. Semantic & Contract Merge Conflicts (`codegraph git-conflicts`)
+Detects silent merge conflicts before git merge or pull request landing—such as branch A invoking a function or route handler that branch B deleted or altered:
+```bash
+codegraph git-conflicts main HEAD
+```
+
+### 4. Structural AST Diff (`codegraph git-diff`)
+Computes semantic AST differences between Git revisions (added/removed/modified symbols, changed parameter signatures):
+```bash
+codegraph git-diff HEAD~1 HEAD
+```
+
+### 5. Deterministic Symbol History (`codegraph symbol-history`)
+Traces symbol lifecycle across commits (introduced, modified, moved, renamed, or deleted):
+```bash
+codegraph symbol-history resolve_target
+```
+
+### 6. GitHub Action for Pull Request Impact
+Automate change impact directly in your CI pipeline with `.github/workflows/codegraph-pr-impact.yml` and `.github/actions/codegraph-impact/action.yml`.
+
+---
+
 ## 9. Measured Performance and Scaling Benchmarks
 
 ### 4-Tier Scaling Summary (`54` → `2,504` Files)

{codegraph_engine-2.2.1.dist-info → codegraph_engine-2.3.0.dist-info}/RECORD

@@ -1,23 +1,27 @@
-codegraph/__init__.py,sha256=pqyOnZXBkTOv7tLVqCRVa0KLbC0GJkpQndd6HGuXGlA,845
+codegraph/__init__.py,sha256=EmyDwINWrwVqpTtH6eNgda5rgun2zkN-4M2G52Uobk4,845
 codegraph/agent.py,sha256=We0TWEXSMBBz6t2NQEGPB6gv-2P1IwyCmxoFGPN_CBA,911
 codegraph/agent_brain.py,sha256=xy0TWQsu4_xmuRlzrN-xbcLCBKcyTbwUAyW6PDW3FvI,130406
-codegraph/agent_capabilities.py,sha256=Gub8wZ-CGOs0x8UUl-CALHMfBk4MJ9xifGIwtCnZT-w,180705
+codegraph/agent_capabilities.py,sha256=88bZA1PpCEZ2Q-JwSxX-JuOEH-I9Dd1iTBTEOND8yXE,194853
 codegraph/agent_rules.py,sha256=wxy8N4-6jfCEeb_QSKF7AMOPF_kRW8rZsrYHQZO6N3w,37171
 codegraph/architecture.py,sha256=8QAiAihwCJ_-jIBTUS4eEY1uk_TwpYh09hWRQc8sBjc,14023
 codegraph/audit.py,sha256=j6fFL6b4vKfnAdUYU7goqQBv4ysrxy-ecBJvT8rYoSI,3301
 codegraph/binding_resolver.py,sha256=GgpXoUB2ue5vVF5LBoMAlXYk2ru1AHUhIynbq-y1afI,26569
+codegraph/branch_comparison.py,sha256=8sh6iTXDdGDPjJ2NN2Xtrsl66gCh1tvt7FSy4ioCaaE,6626
 codegraph/cache.py,sha256=42Fyl51EsMwcYDv5loosIicVvvrFnIw7JrqKJ7owZtw,2992
-codegraph/cli.py,sha256=LkodseN8BEiK-JVbOmCRI8EygZjgdN2kCtGBFiKX3QE,55121
+codegraph/change_impact.py,sha256=430-rtrgPVFZDZD6wPNbtom2rxlnRRp8TmUlHvJK4NI,13578
+codegraph/cli.py,sha256=0xR2Nsr7X4CJ9IYaObusM45h6atpdb9nkax4tX8KpN0,68362
 codegraph/cli_output.py,sha256=HK83BQ9iAqQjE0LPUrMBube4N7sXU5T4Y-y3Otq0Hyw,5677
 codegraph/config.py,sha256=8-LFxMfg84H77dcDhmsbJrLaB3g5lY_OiP77Qji2GK4,1975
 codegraph/constraints.py,sha256=AR_d07ENmbcDhWmcbruy4DvBYXsEdvSwkatyQ6JO-dE,8554
 codegraph/context.py,sha256=lXHZ0iPKuHVmmvMCBmZnqhoAf1L8hktAAFyUtuon9CQ,95413
+codegraph/context_freshness.py,sha256=UuYBNua8VteX6yGEtRAvDlvEdSMuuzxwLpMuJEb8YJs,14241
 codegraph/epistemic.py,sha256=xyGzFAHx8gtArVSrPLwSAN2PV20uUi1nUWtmgEKMS7Y,6051
 codegraph/errors.py,sha256=QZk92Fr95qx-rfU3W5FVOEy1KjnKgtlbMykTnj4Rhos,10299
 codegraph/evidence_contract.py,sha256=EYOcYeiCrdcmb7tQF8WkFUyz06iSTcUs5F-ssA4RFOA,22802
 codegraph/frameworks.py,sha256=c5KIE8BlWvU4vAkKnuTZVtxwIOFxcYOlTQHEwnbIH-w,30143
 codegraph/freshness.py,sha256=GIlva-vaugLBRUjvi6Eo9fQ36O5Lykgl6YBH0eqCudQ,12090
 codegraph/git.py,sha256=q86cpC_HyEccnK2kuZcWMp-39gjSECs0D4Qbvq27P2A,12069
+codegraph/git_state.py,sha256=gCTmaR0VF1yWz_zxk_jwrR-v5LaQzcltwc2vgyv-_R0,20305
 codegraph/installer.py,sha256=JwjOHWZv2oMYEjQ6vYIaAn_v94P-e-Ra0QcQWlLhhmo,66403
 codegraph/interrogation.py,sha256=1_lSamzTo-KVtIfq6qH7jr4UiEgJAdpO__Bvsz95K8U,81687
 codegraph/mcp_diagnostics.py,sha256=Am2Ad7OwBUPDxklHNk6XPTgBaba-_bi5q2mWYI-pVaE,33430
@@ -33,7 +37,10 @@ codegraph/ranking.py,sha256=Zku5csLQ0_-9RmsYcdQUzTr5sDrHzNHRFQXtrFwleAc,16975
 codegraph/resolver.py,sha256=CLYEarvBl5k8SWerRAgSQ1xx2mq-bNFm9W9qbvh6Jbg,127846
 codegraph/retrieval_policy.py,sha256=GwaiDfOZYDX_o6lvA0YhNL51iGkx0VIvKx_CEbD90d0,11318
 codegraph/route_composer.py,sha256=mPXQL4jivfp0QmltFFHMx-8eNkke5nq-U8tE6tH5wbY,15153
+codegraph/semantic_conflicts.py,sha256=1Qa0XoJS41i5x4UGKobb5IN9sEwtjszgZP6-xppYP7o,11388
 codegraph/semantic_decorators.py,sha256=dK0FlGFxV0yQnqAJvtZoPANdWYLx8swunufgGfMimH4,14900
+codegraph/structural_diff.py,sha256=BAlpCnXJe5DS5yLw2ODVcQoTtsDXE0xbrnMzOrwcSp8,20231
+codegraph/symbol_history.py,sha256=9PgINDtEWAG3kg5oPkrGkkfs_GtbD3ciUg_35hng5G0,10628
 codegraph/target_resolver.py,sha256=aE-R0oyCHI2uy35gOE_5I4mFOBoiajsypeK65l4TWj0,12965
 codegraph/task.py,sha256=dbku1uEfcBrrkY8bFCjoFMwRnTxa7oLxAfnTGzY5dTw,24740
 codegraph/tool_selection_eval.py,sha256=2TWkhHqQ9KKEohM_gcX0k5LqymU9K2VZTPCuYbhZI10,48833
@@ -58,7 +65,7 @@ codegraph/llm/__init__.py,sha256=rro4OuSOUFKhBq0-Rg-VAU7dvc6LS88YgdE8GfClb4E,89
 codegraph/llm/base.py,sha256=M5f4mawPchXqlb7U7DF0cnGlDEy66KbuhhZc1hExZdU,406
 codegraph/llm/context.py,sha256=TT5WIe3gTrvbQCASf2XDfyhwG3Cr5QPgqw9neXDM8qQ,641
 codegraph/mcp/__init__.py,sha256=BmjrnksGkbG7TPqwbyQvgYj9uei8pFSFpfkRpaGVdJU,63
-codegraph/mcp/server.py,sha256=He2ljWxfHuEVoGEmZ1A5OLjMjXvwvWRq5e-E1WlNQKc,62584
+codegraph/mcp/server.py,sha256=t2mXSezXtTFy6al8TDZPDMSTvAoWyEyQ4YUcuDOKgDo,67822
 codegraph/memory/__init__.py,sha256=yfQgSZ9Tii6PPZiLW0ImwC2k-Bg6m7mnUm_K1laBems,58
 codegraph/memory/store.py,sha256=K3iD9VWF5if4OmYCTb5KxtZ3zj45kfEKmz8yivWzP-M,1490
 codegraph/resources/__init__.py,sha256=KPpsePEf6cNVvpMI4tnIbYVSw6Q77kaOP6wcmEko7tE,1296
@@ -79,9 +86,9 @@ codegraph/search/semantic.py,sha256=QZaJVEoOZIZrp4O6SmUAzMiqMPfopgmPSpqzL3T7GVg,
 codegraph/security/__init__.py,sha256=L1j4pRC4XTBgYk6e243MmpXskq5mHDwOpd9JHV_-0j8,1249
 codegraph/security/paths.py,sha256=BPWbADXyuVCtCiqeZb8YSe4hYFTr-R-Gj1sYP4Jpy8M,5451
 codegraph/security/redaction.py,sha256=CfkBYrFswybGw-g8IeKbW-qkZ5OXaHoSVynLGmGIh2Y,23371
-codegraph_engine-2.2.1.dist-info/licenses/LICENSE,sha256=kMXNS9xyan1jJAG5_jORb8RyVeY-_Httz3JAtCjjyxI,1093
-codegraph_engine-2.2.1.dist-info/METADATA,sha256=T2XxDNl95H_LaZa2DqSNnGXJGohyD-4zKJW9xJ_RkE0,37393
-codegraph_engine-2.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-codegraph_engine-2.2.1.dist-info/entry_points.txt,sha256=U2xQ3yhqOaaDyFtV9p7N0FDref1VEk56RE_Bnvrnycc,48
-codegraph_engine-2.2.1.dist-info/top_level.txt,sha256=RqBj9sPbifZTb9aeHtnbxTgKJvfHIQdmYE1Brv8Wdkg,10
-codegraph_engine-2.2.1.dist-info/RECORD,,
+codegraph_engine-2.3.0.dist-info/licenses/LICENSE,sha256=kMXNS9xyan1jJAG5_jORb8RyVeY-_Httz3JAtCjjyxI,1093
+codegraph_engine-2.3.0.dist-info/METADATA,sha256=JOYl8i7Wtm9zpBnOC5yo1Y-BCkwK_ks_80pRKSH1jDY,44880
+codegraph_engine-2.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+codegraph_engine-2.3.0.dist-info/entry_points.txt,sha256=U2xQ3yhqOaaDyFtV9p7N0FDref1VEk56RE_Bnvrnycc,48
+codegraph_engine-2.3.0.dist-info/top_level.txt,sha256=RqBj9sPbifZTb9aeHtnbxTgKJvfHIQdmYE1Brv8Wdkg,10
+codegraph_engine-2.3.0.dist-info/RECORD,,