codegraph-engine 2.1.1__py3-none-any.whl → 2.1.3__py3-none-any.whl

codegraph/__init__.py

@@ -1,6 +1,6 @@
 """CodeGraph MCP: local, evidence-backed codebase intelligence."""
 
-__version__ = "2.1.1"
+__version__ = "2.1.3"
 from codegraph.errors import (
     CodeGraphError,
     ErrorCode,

codegraph/frameworks.py

@@ -79,6 +79,7 @@ class RouteDetection:
     resolution_status: str = "RESOLVED"  # RESOLVED | UNRESOLVED | AMBIGUOUS
     evidence: str = ""
     module: str = ""
+    endpoint_id_override: str | None = None
 
     @property
     def route_signature(self) -> str:
@@ -87,13 +88,18 @@ class RouteDetection:
 
     @property
     def endpoint_id(self) -> str:
-        """Stable, globally unique endpoint identifier scoped by module to prevent collisions."""
-        if self.module:
-            mod = self.module
-        else:
-            from codegraph.indexing.models import normalize_module
-            mod = normalize_module(self.file_path)
-        return f"API_ENDPOINT:{mod}:{self.http_method} {self.normalized_route}"
+        """Stable, deterministic, globally unique endpoint identifier for a route declaration."""
+        if self.endpoint_id_override:
+            return self.endpoint_id_override
+
+        clean_path = self.file_path.replace("\\", "/").strip()
+        while clean_path.startswith("./"):
+            clean_path = clean_path[2:]
+        clean_path = clean_path.lstrip("/") or "root"
+
+        handler_part = f"#{self.handler_name}" if self.handler_name else ""
+        fw_part = f":{self.framework}" if self.framework else ""
+        return f"API_ENDPOINT{fw_part}:{clean_path}:{self.line}:{self.http_method} {self.normalized_route}{handler_part}"
 
     def as_dict(self) -> dict[str, object]:
         return {

codegraph/indexing/indexer.py

@@ -655,7 +655,18 @@ class Indexer:
             con.executemany(
                 "INSERT INTO framework_routes(endpoint_id, framework, http_method, route_path, "
                 "normalized_route, handler_name, handler_canonical_id, file_path, line, evidence, confidence) "
-                "VALUES (?,?,?,?,?,?,?,?,?,?,?)",
+                "VALUES (?,?,?,?,?,?,?,?,?,?,?) "
+                "ON CONFLICT(endpoint_id) DO UPDATE SET "
+                "framework=excluded.framework, "
+                "http_method=excluded.http_method, "
+                "route_path=excluded.route_path, "
+                "normalized_route=excluded.normalized_route, "
+                "handler_name=excluded.handler_name, "
+                "handler_canonical_id=excluded.handler_canonical_id, "
+                "file_path=excluded.file_path, "
+                "line=excluded.line, "
+                "evidence=excluded.evidence, "
+                "confidence=excluded.confidence",
                 [
                     (
                         r.endpoint_id,
@@ -794,6 +805,7 @@ class Indexer:
                 line=int(r["line"]),
                 evidence=str(r["evidence"]),
                 confidence=str(r["confidence"]),
+                endpoint_id_override=str(r["endpoint_id"]),
             )
             for r in rt_rows
         ]
@@ -930,6 +942,20 @@ def check_database_health(con: sqlite3.Connection, repository: Path | None = Non
     if parser_ver and parser_ver != PARSER_VERSION:
         issues.append(f"Parser version mismatch: indexed with {parser_ver}, active parser is {PARSER_VERSION}.")
 
+    # 8. Orphan framework routes
+    orphan_routes = con.execute(
+        "SELECT count(*) FROM framework_routes r LEFT JOIN files f ON r.file_path = f.path WHERE f.path IS NULL"
+    ).fetchone()[0]
+    if orphan_routes > 0:
+        issues.append(f"Found {orphan_routes} orphan route(s) referencing non-existent files.")
+
+    # 9. Duplicate endpoint IDs
+    dup_routes = con.execute(
+        "SELECT endpoint_id, count(*) FROM framework_routes GROUP BY endpoint_id HAVING count(*) > 1"
+    ).fetchall()
+    if dup_routes:
+        issues.append(f"Found {len(dup_routes)} duplicate route endpoint ID(s).")
+
     status = "OK" if not issues else "ISSUES_FOUND"
     return {
         "status": status,

codegraph/resources/__init__.py

@@ -16,7 +16,8 @@ from .cache import (
 )
 from .coalescer import RequestCoalescer, get_global_coalescer
 from .debouncer import FileChangeDebouncer
-from .governor import ResourceGovernor, get_global_governor, get_process_memory_mb
+from .governor import ResourceGovernor, get_global_governor
+from .monitor import get_process_memory_mb
 from .policy import (
     ActivityMode,
     PressureLevel,

codegraph/resources/governor.py

@@ -5,13 +5,12 @@ throttling background indexing, managing process memory, and cooperatively yield
 """
 from __future__ import annotations
 
-import resource
-import sys
 import threading
 import time
 from collections.abc import Iterator
 from contextlib import contextmanager
 
+from .monitor import get_process_memory_mb
 from .policy import (
     ActivityMode,
     PressureLevel,
@@ -22,18 +21,6 @@ from .policy import (
 )
 
 
-def get_process_memory_mb() -> float:
-    """Return estimated resident process memory in megabytes portably."""
-    try:
-        usage = resource.getrusage(resource.RUSAGE_SELF).ru_maxrss
-        if sys.platform == "darwin":
-            return round(usage / (1024 * 1024), 2)
-        else:
-            return round(usage / 1024, 2)
-    except Exception:
-        return 0.0
-
-
 class ResourceGovernor:
     """Thread-safe central resource governor and priority scheduler."""
 
@@ -97,17 +84,17 @@ class ResourceGovernor:
         with self._lock:
             active_inter = self._active_interactive
 
-        if limit_mb and mem_mb >= limit_mb * 0.90:
+        if mem_mb is not None and limit_mb and mem_mb >= limit_mb * 0.90:
             return PressureLevel.CRITICAL
         if active_inter >= self.policy.max_interactive_workers * 2:
             return PressureLevel.CRITICAL
 
-        if limit_mb and mem_mb >= limit_mb * 0.75:
+        if mem_mb is not None and limit_mb and mem_mb >= limit_mb * 0.75:
             return PressureLevel.HIGH
         if active_inter > self.policy.max_interactive_workers:
             return PressureLevel.HIGH
 
-        if limit_mb and mem_mb >= limit_mb * 0.60:
+        if mem_mb is not None and limit_mb and mem_mb >= limit_mb * 0.60:
             return PressureLevel.ELEVATED
         if active_inter > 0:
             return PressureLevel.ELEVATED

codegraph/resources/monitor.py

@@ -0,0 +1,102 @@
+"""Cross-platform process resource monitoring for CodeGraph.
+
+Provides portable resident memory (RSS) measurements across Windows, macOS,
+and Linux without requiring Unix-only APIs at import or runtime.
+"""
+from __future__ import annotations
+
+import sys
+from typing import Any
+
+
+def _get_unix_memory_mb() -> float | None:
+    """Read process RSS using standard library resource module on Unix."""
+    try:
+        import resource  # Unix-only standard library module
+
+        usage = resource.getrusage(resource.RUSAGE_SELF).ru_maxrss
+        if sys.platform == "darwin":
+            # macOS ru_maxrss is returned in bytes
+            return round(usage / (1024 * 1024), 2)
+        else:
+            # Linux and BSD ru_maxrss is returned in kilobytes
+            return round(usage / 1024, 2)
+    except Exception:
+        return None
+
+
+def _get_psutil_memory_mb() -> float | None:
+    """Read process RSS using psutil if installed."""
+    try:
+        import psutil  # type: ignore[import-untyped]
+
+        rss_bytes = float(psutil.Process().memory_info().rss)
+        return round(rss_bytes / (1024 * 1024), 2)
+    except Exception:
+        return None
+
+
+def _get_windows_memory_mb_ctypes() -> float | None:
+    """Read process RSS on Windows using standard library ctypes (zero dependencies)."""
+    try:
+        import ctypes
+        from ctypes import wintypes
+
+        class PROCESS_MEMORY_COUNTERS(ctypes.Structure):
+            _fields_ = [
+                ("cb", wintypes.DWORD),
+                ("PageFaultCount", wintypes.DWORD),
+                ("PeakWorkingSetSize", ctypes.c_size_t),
+                ("WorkingSetSize", ctypes.c_size_t),
+                ("QuotaPeakPagedPoolUsage", ctypes.c_size_t),
+                ("QuotaPagedPoolUsage", ctypes.c_size_t),
+                ("QuotaPeakNonPagedPoolUsage", ctypes.c_size_t),
+                ("QuotaNonPagedPoolUsage", ctypes.c_size_t),
+                ("PagefileUsage", ctypes.c_size_t),
+                ("PeakPagefileUsage", ctypes.c_size_t),
+            ]
+
+        windll: Any = getattr(ctypes, "windll", None)
+        if windll is None:
+            return None
+
+        handle = windll.kernel32.GetCurrentProcess()
+        counters = PROCESS_MEMORY_COUNTERS()
+        counters.cb = ctypes.sizeof(PROCESS_MEMORY_COUNTERS)
+
+        # On Windows 7+, K32GetProcessMemoryInfo is in kernel32; otherwise in psapi
+        get_info = getattr(windll.kernel32, "K32GetProcessMemoryInfo", None)
+        if get_info is None:
+            psapi = getattr(windll, "psapi", None)
+            if psapi is not None:
+                get_info = getattr(psapi, "GetProcessMemoryInfo", None)
+
+        if get_info is not None and bool(get_info(handle, ctypes.byref(counters), counters.cb)):
+            # WorkingSetSize is the resident set size in bytes
+            return round(float(counters.WorkingSetSize) / (1024 * 1024), 2)
+    except Exception:
+        return None
+    return None
+
+
+def get_process_memory_mb() -> float | None:
+    """Return estimated resident process memory in megabytes cross-platform.
+
+    Returns:
+        float: Estimated memory in MB if measurement is supported and succeeds.
+        None: If measurement is unsupported or fails (degrades gracefully to UNKNOWN).
+    """
+    if sys.platform == "win32":
+        # 1. On Windows: try psutil first, then ctypes Windows API
+        mem = _get_psutil_memory_mb()
+        if mem is not None:
+            return mem
+        return _get_windows_memory_mb_ctypes()
+
+    # 2. On Unix-like platforms (macOS, Linux): try standard resource module
+    mem = _get_unix_memory_mb()
+    if mem is not None:
+        return mem
+
+    # 3. Fallback to psutil on any platform if resource module failed or is unavailable
+    return _get_psutil_memory_mb()

codegraph/resources/policy.py

@@ -113,7 +113,7 @@ class ResourceState:
     queued_tasks: int = 0
     recent_cpu_time_ms: float = 0.0
     recent_wall_time_ms: float = 0.0
-    estimated_memory_mb: float = 0.0
+    estimated_memory_mb: float | None = None
     pressure_level: str = PressureLevel.NORMAL.value
     activity_mode: str = ActivityMode.IDLE.value
     indexing_active: bool = False

{codegraph_engine-2.1.1.dist-info → codegraph_engine-2.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codegraph-engine
-Version: 2.1.1
+Version: 2.1.3
 Summary: Evidence-backed local codebase intelligence for MCP clients
 Author: CodeGraph contributors
 License-Expression: MIT
@@ -11,6 +11,8 @@ Requires-Dist: pydantic>=2.7
 Requires-Dist: typer>=0.12
 Provides-Extra: mcp
 Requires-Dist: mcp<2,>=1.0; extra == "mcp"
+Provides-Extra: system
+Requires-Dist: psutil>=5.9; extra == "system"
 Provides-Extra: dev
 Requires-Dist: pytest>=8; extra == "dev"
 Requires-Dist: pytest-cov>=5; extra == "dev"

{codegraph_engine-2.1.1.dist-info → codegraph_engine-2.1.3.dist-info}/RECORD

@@ -1,4 +1,4 @@
-codegraph/__init__.py,sha256=_fvuBpqIOyFtG6zV5ouDbAzcHh6kaZOODpnBo5zKE8A,845
+codegraph/__init__.py,sha256=thPpcGX8Jit9lAYlhWDftcMUr5nLgXns6eHeIGUD81Q,845
 codegraph/agent.py,sha256=We0TWEXSMBBz6t2NQEGPB6gv-2P1IwyCmxoFGPN_CBA,911
 codegraph/architecture.py,sha256=m6RZgXDMoDkSx8KO0xuQHtz5rT0h5B7Jjh1yVE2H2LI,12069
 codegraph/audit.py,sha256=j6fFL6b4vKfnAdUYU7goqQBv4ysrxy-ecBJvT8rYoSI,3301
@@ -9,7 +9,7 @@ codegraph/constraints.py,sha256=AR_d07ENmbcDhWmcbruy4DvBYXsEdvSwkatyQ6JO-dE,8554
 codegraph/context.py,sha256=S_NJ6obPrdmlpA0RO6qD-L06d8sU-UaujzllZ1I2pSI,52219
 codegraph/epistemic.py,sha256=ShvLKjRBE6FKCBc1oARDji-NIyw3Molyrj3Eu8TzY3g,2465
 codegraph/errors.py,sha256=uzuXQe1NsOXV94xr0nmjvINPidGiTc9705tKqT928jQ,9967
-codegraph/frameworks.py,sha256=ZdBnA0WExyJ0ShgUHxSlB82xHF24wO32b_PReVyqWnk,16165
+codegraph/frameworks.py,sha256=Cdv8NBr0Hb920rZStiZUMZFY-3Whcj2YUHVP2VU-2mE,16491
 codegraph/freshness.py,sha256=PVV7pLFz2xfDIj2DhLWB85ppn-0GZyxjoglxEdr3GBY,10041
 codegraph/git.py,sha256=DLFsvuOKiCLiBXMuxRCoMK06y1FaxT_D13pwpIA1Jek,8528
 codegraph/interrogation.py,sha256=jQ7AQOLJBeWgJe3P1qduYb4toRaDRcM8reB1xtNoT9c,54755
@@ -31,7 +31,7 @@ codegraph/graph/models.py,sha256=qq7RY4CkoDof8GS4cJIznfIB239Wo83yq2cOaIvUrXY,930
 codegraph/graph/traversal.py,sha256=3gLp1drVLCSRpRVQYtfAmi_6nZOES-pd9C2zE3vfvuA,49848
 codegraph/indexing/__init__.py,sha256=Svr4c_L0j3neb5WiTcWDYPyqAdvpsuOIBhOAXFvBv1E,149
 codegraph/indexing/classifier.py,sha256=PKY54vjj2RFk665xXYctIZuzR8OshIfFdzGuOWfuAfQ,7101
-codegraph/indexing/indexer.py,sha256=2HEi2DOW3JGm9xnuVXIm6n8sngkvjeCNIu7p3gSxbqY,37908
+codegraph/indexing/indexer.py,sha256=XEOz0C522QJdJypqWnGBXbSlgjfvp-DIDAbM_I_P6bE,39158
 codegraph/indexing/models.py,sha256=h0ssLYF2Hbw5Ma05Lz4hXnxsoQXCrhZEdvgQHV2YzNU,11612
 codegraph/indexing/parser.py,sha256=YhR8_xs9gDGO95sw2oq3SfQwwZIw5fla5TjXVc6d4UM,46643
 codegraph/indexing/scanner.py,sha256=jEbqnDeAtxrNqMKuMHvW63C3U08SxpSzfYEJ3l7B6gU,6375
@@ -43,20 +43,21 @@ codegraph/mcp/__init__.py,sha256=BmjrnksGkbG7TPqwbyQvgYj9uei8pFSFpfkRpaGVdJU,63
 codegraph/mcp/server.py,sha256=CnBdY5Qa9T5LkAFpA3TwwpTkGetkauY7JmiGO2U9ocg,31395
 codegraph/memory/__init__.py,sha256=yfQgSZ9Tii6PPZiLW0ImwC2k-Bg6m7mnUm_K1laBems,58
 codegraph/memory/store.py,sha256=K3iD9VWF5if4OmYCTb5KxtZ3zj45kfEKmz8yivWzP-M,1490
-codegraph/resources/__init__.py,sha256=14FNWGRA0ZXr_m-smhFUxY8dvhgH2f1EqmyXaV6TxHA,1276
+codegraph/resources/__init__.py,sha256=KPpsePEf6cNVvpMI4tnIbYVSw6Q77kaOP6wcmEko7tE,1296
 codegraph/resources/cache.py,sha256=mdhlrXjhbBGChiF_rR1SnMN27oVxjpx9f4zu5jV-hbI,4054
 codegraph/resources/coalescer.py,sha256=bKbTmX8q-R0FjNJjZQrh3Us2ZcuYsIKTrH0WimWcxQs,2510
 codegraph/resources/debouncer.py,sha256=LjDv7uGxixlH-N7vVNkphvlhvtGh6t4jGKFAGg_nX7A,3084
-codegraph/resources/governor.py,sha256=mk9pgxlflvrvm87aZQqexqUt5H6aiJlOlY-AjwiaWWg,8971
-codegraph/resources/policy.py,sha256=pJScYxmhJiSk8c9FlfORTpxf68ZpM2UwNgd4U_LhUWQ,4026
+codegraph/resources/governor.py,sha256=JFZrjwXb19YtPUGoVg2I9yiKBg8Dbw3q1H8Q2J9RW68,8681
+codegraph/resources/monitor.py,sha256=TZMpxvtNS4nwG1w511LAkpef4XThQjNCYZP8qu__Iy0,3753
+codegraph/resources/policy.py,sha256=Xv0Bd1ZzvCcXhAObrbABxTAxdKxFoUUgCrVNSLY5u5w,4034
 codegraph/search/__init__.py,sha256=LFdgDMGE_cGWFFBk--uoRappyC_LnKvfKedogv-p5kQ,504
 codegraph/search/hybrid.py,sha256=pqdRZSwe7wEEETxmUjV5Ns7_oxus60jggnOPNRfFpg0,9617
 codegraph/search/semantic.py,sha256=QZaJVEoOZIZrp4O6SmUAzMiqMPfopgmPSpqzL3T7GVg,836
 codegraph/security/__init__.py,sha256=QsucVn1YOuC1IFrd9-EHeZd9kdHv8XUQgRZ9bTz_6_4,142
 codegraph/security/paths.py,sha256=BtiVvDgMzfL7_Dj3COt6B2Aui4A7hH13QwPUgl5-7No,1241
-codegraph_engine-2.1.1.dist-info/licenses/LICENSE,sha256=I6wm9APPQhaH4Cj9H9z8I2jahgYh7ik-9x7wFrmsGOo,1079
-codegraph_engine-2.1.1.dist-info/METADATA,sha256=A5yelC6QUOe9FKbvQfbQnMHra-hAPoxfQZY19e8B4bI,13240
-codegraph_engine-2.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-codegraph_engine-2.1.1.dist-info/entry_points.txt,sha256=U2xQ3yhqOaaDyFtV9p7N0FDref1VEk56RE_Bnvrnycc,48
-codegraph_engine-2.1.1.dist-info/top_level.txt,sha256=RqBj9sPbifZTb9aeHtnbxTgKJvfHIQdmYE1Brv8Wdkg,10
-codegraph_engine-2.1.1.dist-info/RECORD,,
+codegraph_engine-2.1.3.dist-info/licenses/LICENSE,sha256=I6wm9APPQhaH4Cj9H9z8I2jahgYh7ik-9x7wFrmsGOo,1079
+codegraph_engine-2.1.3.dist-info/METADATA,sha256=5ZWgJ24vTGtBD7TQ1eOhRr2FlizC9vGNDBplfBCN49s,13309
+codegraph_engine-2.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+codegraph_engine-2.1.3.dist-info/entry_points.txt,sha256=U2xQ3yhqOaaDyFtV9p7N0FDref1VEk56RE_Bnvrnycc,48
+codegraph_engine-2.1.3.dist-info/top_level.txt,sha256=RqBj9sPbifZTb9aeHtnbxTgKJvfHIQdmYE1Brv8Wdkg,10
+codegraph_engine-2.1.3.dist-info/RECORD,,