codecompass-mcp 3.1.0__tar.gz → 3.2.0__tar.gz

{codecompass_mcp-3.1.0 → codecompass_mcp-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codecompass-mcp
-Version: 3.1.0
+Version: 3.2.0
 Summary: Structural code context for AI coding agents — a local code knowledge graph for blast radius, impact, deps, dead code, and flow tracing
 Author: CodeCompass contributors
 License: MIT

{codecompass_mcp-3.1.0 → codecompass_mcp-3.2.0}/codecompass_mcp.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codecompass-mcp
-Version: 3.1.0
+Version: 3.2.0
 Summary: Structural code context for AI coding agents — a local code knowledge graph for blast radius, impact, deps, dead code, and flow tracing
 Author: CodeCompass contributors
 License: MIT

{codecompass_mcp-3.1.0 → codecompass_mcp-3.2.0}/graph/code_graph_client.py

@@ -60,18 +60,30 @@ def _strip_code_ext(path: str) -> str:
     return path
 
 
-def _import_resolves_to(import_str: str, from_file: str, target_file: str) -> bool:
+def _import_resolves_to(import_str: str, from_file: str, target_file: str,
+                        psr4: dict[str, str] | None = None) -> bool:
     """True if `import_str` written in `from_file` refers to `target_file`.
 
     Resolves relative CommonJS/ESM specifiers (`./response`, `../lib/response`,
-    with an implicit `/index`) and dotted module names (`lib.response`) against
-    the target's extension-stripped path. Package imports (`router`, `express`)
-    never match a project file and return False.
+    with an implicit `/index`), dotted module names (`lib.response`), and — via a
+    composer PSR-4 map — PHP namespaces (`GuzzleHttp.Client` → `src/Client.php`)
+    against the target's extension-stripped path. Package imports never match a
+    project file and return False.
     """
     if not import_str or not target_file:
         return False
     target_base = _strip_code_ext(target_file).replace("\\", "/")
 
+    # PSR-4 (PHP): namespace prefix -> directory, from composer.json autoload.
+    if psr4:
+        for prefix, directory in psr4.items():
+            pfx = prefix + "."
+            if import_str.startswith(pfx):
+                rest = import_str[len(pfx):].replace(".", "/")
+                base = f"{directory.rstrip('/')}/{rest}".replace("\\", "/")
+                if base == target_base:
+                    return True
+
     if import_str.startswith("."):
         from_dir = os.path.dirname(from_file)
         resolved = os.path.normpath(os.path.join(from_dir, import_str)).replace("\\", "/")
@@ -931,10 +943,33 @@ class LocalGraphClient:
 
         return results, target_file
 
+    def _psr4(self) -> dict[str, str]:
+        """PHP composer PSR-4 map: dotted namespace prefix -> source directory
+        (e.g. {'GuzzleHttp': 'src/'}), so `use GuzzleHttp\\Client` resolves to a
+        file. Read once from composer.json at the repo root; empty if none."""
+        if hasattr(self, "_psr4_cache"):
+            return self._psr4_cache
+        m: dict[str, str] = {}
+        repo = os.path.dirname(os.path.dirname(self.storage_path))
+        try:
+            with open(os.path.join(repo, "composer.json")) as f:
+                data = json.load(f)
+            for key in ("autoload", "autoload-dev"):
+                for ns, path in (data.get(key, {}).get("psr-4", {}) or {}).items():
+                    prefix = ns.rstrip("\\").replace("\\", ".")
+                    paths = path if isinstance(path, list) else [path]
+                    if prefix and paths:
+                        m[prefix] = paths[0]
+        except Exception:
+            pass
+        self._psr4_cache = m
+        return m
+
     def _direct_importers(self, target_file: str) -> list[str]:
         """Source files with an IMPORTS edge whose module string resolves to
-        target_file. Handles both relative (`./response`) and dotted-module
-        (`lib.response`) import spellings."""
+        target_file. Handles relative (`./response`), dotted-module
+        (`lib.response`), and PHP PSR-4 namespace (`GuzzleHttp\\Client`) spellings."""
+        psr4 = self._psr4()
         importers: list[str] = []
         for _u, v, data in self.graph.edges(data=True):
             if data.get("type") != "IMPORTS":
@@ -943,7 +978,7 @@ class LocalGraphClient:
             if not from_file:
                 continue
             import_str = self.graph.nodes[v].get("name", "")
-            if _import_resolves_to(import_str, from_file, target_file):
+            if _import_resolves_to(import_str, from_file, target_file, psr4):
                 importers.append(from_file)
         return sorted(set(importers))
 

{codecompass_mcp-3.1.0 → codecompass_mcp-3.2.0}/main.py

@@ -26,8 +26,10 @@ _CODECOMPASS_START = "<!-- codecompass-code-graph-start -->"
 _CODECOMPASS_END = "<!-- codecompass-code-graph-end -->"
 _CODECOMPASS_READ_INSTRUCTION = (
     "Orient through the code graph first: start from an entry point, see what's "
-    "there, then trace its flow and dependencies — rather than blind grepping. "
-    "Reach for grep/cat when you already know the string or symbol, or to verify."
+    "there, then trace its flow and dependencies — never use `cat`, `grep`, or "
+    "`rg` to search or read code content. Use the `codecompass query` commands "
+    "below for discovery and tracing, then read only the specific slices the "
+    "graph points you to."
 )
 
 
@@ -324,6 +326,7 @@ def ingest_code(repo_path: str, normalize: bool = False, dump_triples: str | Non
 def _register_project_agents_md(repo_path: str) -> None:
     """Write or update the Code graph section in the project's AGENTS.md."""
     block = f"""{_CODECOMPASS_START}
+<!-- This file must stay byte-for-byte identical to its counterpart in pi-package/templates/. Run scripts/check-pi-package-sync.sh to verify. -->
 ## Code graph
 
 **{_CODECOMPASS_READ_INSTRUCTION}**
@@ -360,8 +363,18 @@ All commands default to the current directory — run them from the project root
 3. **Read** the specific slice the graph pointed you to (Read tool / `sed -n`),
    not the whole file.
 
-4. **Edit** — and before editing, `--impact`/`--blast-radius` the target so you
-   don't miss a caller or dependent. After adding/deleting files, re-ingest.
+4. **Edit** — before editing, verify the target fully so you don't break callers or dependents:
+   - Run `--deps <file>` to understand what the file relies on.
+   - Run `--flow <entry_symbol> --format json` (or `--flow-summary <entry_symbol>`) to trace the logic end-to-end.
+   - Run `--impact <symbol>` for every symbol you plan to change.
+   - Run `--blast-radius <file>` for every file you plan to change.
+   - Read the specific slices the graph identified.
+   - Then make the smallest correct change.
+
+   After any code change (edits, additions, deletions, renames, refactors), re-ingest so the graph stays current:
+   ```bash
+   codecompass ingest-code
+   ```
 
 ### Reading the results
 
@@ -403,8 +416,9 @@ scripts). Results are split into "likely dead" and (with `--include-entrypoints`
 "possible entry points".
 
 This is STATIC analysis: dynamic dispatch, reflection, and string-based
-invocation are invisible. Treat every result as a candidate — grep the name
-across the repo to confirm it is truly unused before deleting it.
+invocation are invisible. Treat every result as a candidate — use
+`codecompass query --grep <name>` or `--search <name>` to confirm it is truly
+unused before deleting it.
 
 ### Project notes: `overview.md`, `memory.md`, `learnings.md`
 
@@ -432,7 +446,7 @@ doc → `memory.md`; code-comment warning to the next person → `learnings.md`.
 
 ### When to re-ingest
 
-- After adding, renaming, or deleting source files
+- After every code change: edits, additions, deletions, renames, refactors
 - After major refactors (moved functions, renamed classes)
 - If query results look stale or incomplete
 

{codecompass_mcp-3.1.0 → codecompass_mcp-3.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codecompass-mcp"
-version = "3.1.0"
+version = "3.2.0"
 description = "Structural code context for AI coding agents — a local code knowledge graph for blast radius, impact, deps, dead code, and flow tracing"
 readme = "README.md"
 license = {text = "MIT"}

{codecompass_mcp-3.1.0 → codecompass_mcp-3.2.0}/tests/test_accuracy_fixes.py

@@ -339,6 +339,18 @@ def test_python_public_method_marked_exported():
     assert by_name.get("_private") is False, "underscore method is not exported"
 
 
+def test_php_psr4_import_resolution():
+    from graph.code_graph_client import _import_resolves_to
+    psr4 = {"GuzzleHttp": "src/", "GuzzleHttp.Tests": "tests/"}
+    assert _import_resolves_to("GuzzleHttp.Client", "src/Pool.php", "src/Client.php", psr4)
+    assert _import_resolves_to("GuzzleHttp.Handler.CurlFactory", "src/x.php",
+                               "src/Handler/CurlFactory.php", psr4)
+    assert _import_resolves_to("GuzzleHttp.Tests.ClientTest", "src/x.php",
+                               "tests/ClientTest.php", psr4)
+    assert not _import_resolves_to("GuzzleHttp.Client", "src/Pool.php", "src/Other.php", psr4)
+    assert not _import_resolves_to("Vendor.Lib.Thing", "src/x.php", "src/Client.php", psr4)
+
+
 def test_inheritance_super_resolution_all_langs():
     cases = [
         (".py", "class Command:\n    def invoke(self, c): pass\n"