code-graph-rag 0.3.2__tar.gz → 0.4.5__tar.gz

{code_graph_rag-0.3.2/code_graph_rag.egg-info → code_graph_rag-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.3.2
+Version: 0.4.5
 Summary: The ultimate RAG for your monorepo. Query, understand, and edit multi-language codebases with the power of AI and knowledge graphs
 License-Expression: MIT
 Keywords: rag,retrieval-augmented-generation,knowledge-graph,code-analysis,tree-sitter,mcp,mcp-server,llm,graph-database,semantic-search,codebase,memgraph,developer-tools,monorepo
@@ -19,7 +19,8 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp<2,>=1.30.0
+Requires-Dist: mcp<3,>=2.3.0
+Requires-Dist: jsonschema>=4.20.0
 Requires-Dist: pydantic-ai-slim[anthropic,google,openai]>=2.0.0
 Requires-Dist: pydantic-settings>=2.12.0
 Requires-Dist: python-dotenv>=1.2.1
@@ -38,8 +39,9 @@ Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: huggingface-hub[hf-xet]>=1.7.2
 Requires-Dist: pathspec>=1.0.4
 Requires-Dist: pygments>=2.20.0
+Requires-Dist: certifi>=2026.10.23
 Requires-Dist: regex>=2024.11.6
-Requires-Dist: cgr-graph-rs<0.2,>=0.1.0; platform_python_implementation == "CPython" and ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64"))
+Requires-Dist: cgr-graph-rs<0.2,>=0.1.4; platform_python_implementation == "CPython" and ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64"))
 Provides-Extra: test
 Requires-Dist: jedi>=0.19; extra == "test"
 Requires-Dist: pytest>=8.4.1; extra == "test"
@@ -78,11 +80,13 @@ Requires-Dist: tree-sitter-sql>=0.3.11; extra == "treesitter-full"
 Requires-Dist: tree-sitter-markdown>=0.5.1; extra == "treesitter-full"
 Provides-Extra: semantic
 Requires-Dist: qdrant-client>=1.9.0; extra == "semantic"
+Requires-Dist: grpcio>=1.84.1; extra == "semantic"
 Requires-Dist: sqlite-vec>=0.1.9; ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64")) and extra == "semantic"
 Requires-Dist: torch>=2.6.0; extra == "semantic"
 Requires-Dist: transformers>=5.0.0; extra == "semantic"
 Provides-Extra: milvus
 Requires-Dist: pymilvus[milvus-lite]>=3.0.0; extra == "milvus"
+Requires-Dist: grpcio>=1.84.1; extra == "milvus"
 Provides-Extra: sqlite-vec
 Requires-Dist: sqlite-vec>=0.1.9; extra == "sqlite-vec"
 Provides-Extra: ast-grep

{code_graph_rag-0.3.2 → code_graph_rag-0.4.5}/README.md

@@ -61,7 +61,7 @@ Code-Graph-RAG parses a multi-language codebase with Tree-sitter, sharpened by c
 ## Latest News 🔥
 
 <!-- SECTION:latest_news -->
-- **SBOM**: CycloneDX SBOM and Docker image attestation published with each release.
+- **MiniMax Models Added**: Current MiniMax text models have been included.
 <!-- /SECTION:latest_news -->
 
 See [NEWS.md](NEWS.md) for the full history.
@@ -188,6 +188,7 @@ Code-Graph-RAG runs as an [MCP](https://modelcontextprotocol.io) server so Claud
 - [Real-Time Updates](docs/guide/realtime-updates.md)
 - [C/C++ Semantic Mode](docs/guide/cpp-semantic-mode.md)
 - [MCP Server](docs/guide/mcp-server.md)
+- [Porting Between Languages](docs/guide/porting.md)
 
 **Architecture**
 - [Overview](docs/architecture/overview.md)
@@ -229,6 +230,10 @@ For issues or questions, check the [Troubleshooting](docs/advanced/troubleshooti
 
 If cgr is useful to you, please consider pledging support on [GitHub Sponsors](https://github.com/sponsors/vitali87). cgr links the page under `cgr --version` and, in a terminal, after most commands finish; set `CGR_SPONSOR_PLEDGE=false` to hide that line.
 
+## Accessibility
+
+[ACCESSIBILITY.md](ACCESSIBILITY.md) describes what cgr and its documentation support for people using assistive technology or alternative settings, the known limitations and their workarounds, and how to report a barrier.
+
 ## License
 
 MIT. See [LICENSE](LICENSE).

{code_graph_rag-0.3.2 → code_graph_rag-0.4.5/code_graph_rag.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.3.2
+Version: 0.4.5
 Summary: The ultimate RAG for your monorepo. Query, understand, and edit multi-language codebases with the power of AI and knowledge graphs
 License-Expression: MIT
 Keywords: rag,retrieval-augmented-generation,knowledge-graph,code-analysis,tree-sitter,mcp,mcp-server,llm,graph-database,semantic-search,codebase,memgraph,developer-tools,monorepo
@@ -19,7 +19,8 @@ Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: loguru>=0.7.3
-Requires-Dist: mcp<2,>=1.30.0
+Requires-Dist: mcp<3,>=2.3.0
+Requires-Dist: jsonschema>=4.20.0
 Requires-Dist: pydantic-ai-slim[anthropic,google,openai]>=2.0.0
 Requires-Dist: pydantic-settings>=2.12.0
 Requires-Dist: python-dotenv>=1.2.1
@@ -38,8 +39,9 @@ Requires-Dist: defusedxml>=0.7.1
 Requires-Dist: huggingface-hub[hf-xet]>=1.7.2
 Requires-Dist: pathspec>=1.0.4
 Requires-Dist: pygments>=2.20.0
+Requires-Dist: certifi>=2026.10.23
 Requires-Dist: regex>=2024.11.6
-Requires-Dist: cgr-graph-rs<0.2,>=0.1.0; platform_python_implementation == "CPython" and ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64"))
+Requires-Dist: cgr-graph-rs<0.2,>=0.1.4; platform_python_implementation == "CPython" and ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64"))
 Provides-Extra: test
 Requires-Dist: jedi>=0.19; extra == "test"
 Requires-Dist: pytest>=8.4.1; extra == "test"
@@ -78,11 +80,13 @@ Requires-Dist: tree-sitter-sql>=0.3.11; extra == "treesitter-full"
 Requires-Dist: tree-sitter-markdown>=0.5.1; extra == "treesitter-full"
 Provides-Extra: semantic
 Requires-Dist: qdrant-client>=1.9.0; extra == "semantic"
+Requires-Dist: grpcio>=1.84.1; extra == "semantic"
 Requires-Dist: sqlite-vec>=0.1.9; ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64")) and extra == "semantic"
 Requires-Dist: torch>=2.6.0; extra == "semantic"
 Requires-Dist: transformers>=5.0.0; extra == "semantic"
 Provides-Extra: milvus
 Requires-Dist: pymilvus[milvus-lite]>=3.0.0; extra == "milvus"
+Requires-Dist: grpcio>=1.84.1; extra == "milvus"
 Provides-Extra: sqlite-vec
 Requires-Dist: sqlite-vec>=0.1.9; extra == "sqlite-vec"
 Provides-Extra: ast-grep

{code_graph_rag-0.3.2 → code_graph_rag-0.4.5}/code_graph_rag.egg-info/SOURCES.txt

@@ -42,6 +42,7 @@ codebase_rag/graph_dialects.py
 codebase_rag/graph_loader.py
 codebase_rag/graph_query.py
 codebase_rag/graph_updater.py
+codebase_rag/instructions_trust.py
 codebase_rag/interface_skip.py
 codebase_rag/language_spec.py
 codebase_rag/logs.py
@@ -52,12 +53,15 @@ codebase_rag/models.py
 codebase_rag/parser_fingerprint.py
 codebase_rag/parser_loader.py
 codebase_rag/path_filters.py
+codebase_rag/port_cli.py
+codebase_rag/port_parity.py
 codebase_rag/project_selection.py
 codebase_rag/prompts.py
 codebase_rag/readme_sections.py
 codebase_rag/schema_builder.py
 codebase_rag/schema_parse.py
 codebase_rag/schemas.py
+codebase_rag/sensitive_paths.py
 codebase_rag/sql_names.py
 codebase_rag/sqlite_vectors.py
 codebase_rag/structural_check.py
@@ -148,6 +152,7 @@ codebase_rag/constants/lang_tooling.py
 codebase_rag/constants/languages.py
 codebase_rag/constants/mcp.py
 codebase_rag/constants/notebook.py
+codebase_rag/constants/port.py
 codebase_rag/constants/providers.py
 codebase_rag/constants/security.py
 codebase_rag/constants/sqlite_vectors.py
@@ -162,6 +167,7 @@ codebase_rag/editing/imports.py
 codebase_rag/editing/occurrences.py
 codebase_rag/editing/patcher.py
 codebase_rag/editing/rename.py
+codebase_rag/editing/signature.py
 codebase_rag/editing/signature_bind.py
 codebase_rag/editing/signature_contract.py
 codebase_rag/editing/signature_spec.py
@@ -217,12 +223,15 @@ codebase_rag/parsers/interface_fingerprint.py
 codebase_rag/parsers/java_generated.py
 codebase_rag/parsers/java_lombok.py
 codebase_rag/parsers/module_docstring.py
+codebase_rag/parsers/native_trees.py
 codebase_rag/parsers/notebook.py
 codebase_rag/parsers/parameter_nodes.py
 codebase_rag/parsers/positional_params.py
 codebase_rag/parsers/python_source_roots.py
 codebase_rag/parsers/rpc_exposure.py
 codebase_rag/parsers/semantic_call_join.py
+codebase_rag/parsers/sql_ddl.py
+codebase_rag/parsers/sql_recovery.py
 codebase_rag/parsers/stdlib_extractor.py
 codebase_rag/parsers/string_call.py
 codebase_rag/parsers/structure_processor.py

{code_graph_rag-0.3.2 → code_graph_rag-0.4.5}/code_graph_rag.egg-info/requires.txt

@@ -1,5 +1,6 @@
 loguru>=0.7.3
-mcp<2,>=1.30.0
+mcp<3,>=2.3.0
+jsonschema>=4.20.0
 pydantic-ai-slim[anthropic,google,openai]>=2.0.0
 pydantic-settings>=2.12.0
 python-dotenv>=1.2.1
@@ -18,10 +19,11 @@ defusedxml>=0.7.1
 huggingface-hub[hf-xet]>=1.7.2
 pathspec>=1.0.4
 pygments>=2.20.0
+certifi>=2026.10.23
 regex>=2024.11.6
 
 [:platform_python_implementation == "CPython" and ((sys_platform == "linux" and (platform_machine == "x86_64" or platform_machine == "aarch64")) or sys_platform == "darwin" or (sys_platform == "win32" and platform_machine == "AMD64"))]
-cgr-graph-rs<0.2,>=0.1.0
+cgr-graph-rs<0.2,>=0.1.4
 
 [ast-grep]
 ast-grep-py>=0.51.0
@@ -35,6 +37,7 @@ pymgclient>=1.6.0
 
 [milvus]
 pymilvus[milvus-lite]>=3.0.0
+grpcio>=1.84.1
 
 [neo4j]
 neo4j>=5.28.1
@@ -44,6 +47,7 @@ jedi>=0.19
 
 [semantic]
 qdrant-client>=1.9.0
+grpcio>=1.84.1
 torch>=2.6.0
 transformers>=5.0.0
 

{code_graph_rag-0.3.2 → code_graph_rag-0.4.5}/codebase_rag/check_isolation.py

@@ -45,7 +45,7 @@ from __future__ import annotations
 
 from collections.abc import Sequence
 from pathlib import Path
-from typing import Protocol, cast
+from typing import Protocol
 
 from . import constants as cs
 from . import cypher_queries as cq
@@ -138,7 +138,7 @@ def _props(raw: object) -> PropertyDict | None:
     scalars), but it is the graph's own property set read back, so it is
     written back as it was read.
     """
-    return cast(PropertyDict, dict(raw)) if isinstance(raw, dict) else None
+    return dict(raw) if isinstance(raw, dict) else None
 
 
 def _discard_pending(store: GraphStore) -> None:

{code_graph_rag-0.3.2 → code_graph_rag-0.4.5}/codebase_rag/cli.py

@@ -8,7 +8,7 @@ import subprocess
 import sys
 import tempfile
 import time
-from collections.abc import Callable, Coroutine, Iterable, Iterator
+from collections.abc import Callable, Coroutine, Generator, Iterable
 from contextlib import ExitStack, contextmanager
 from fnmatch import fnmatch
 from functools import partial, wraps
@@ -59,6 +59,7 @@ from .editor_links import (
 from .graph_cli import cli as graph_cli
 from .graph_dialects import DIALECT_MEMGRAPH
 from .parser_loader import load_parsers
+from .port_cli import cli as port_cli
 from .project_selection import ProjectChoice, choose_project, scope_refusal
 from .services.gloss_cleanup import prune_orphaned_glosses
 from .services.graph_diff import DiffError, diff_indexes, diff_is_empty
@@ -78,7 +79,10 @@ from .sync_guard import RUNNING_SYNC_TOKENS as _RUNNING_SYNC_TOKENS
 from .sync_guard import OwnerCheck as _OwnerCheck
 from .sync_guard import SyncRefusedError, mark_sync_incomplete, release_project_claim
 from .sync_guard import clear_sync_incomplete as _clear_sync_incomplete
+from .sync_guard import partial_graph_refusal as _partial_graph_refusal
 from .sync_guard import project_owner_refusal as _project_owner_refusal
+from .sync_guard import retire_stranded_runs as _retire_stranded_runs
+from .sync_guard import stranded_runs as _stranded_runs
 from .sync_guard import sync_marker_params as _sync_marker_params
 from .sync_guard import sync_owner as _sync_owner
 from .sync_lock import SyncLockError, repo_sync_lock
@@ -94,6 +98,7 @@ from .types_defs import (
     DuplicatesReport,
     ProjectSync,
     PropertyValue,
+    ReingestReport,
     ResultRow,
     ResultValue,
 )
@@ -114,6 +119,7 @@ from .workspaces.cli import cli as workspace_cli
 
 if TYPE_CHECKING:
     from .graph_updater import GraphUpdater
+    from .watch import WriteMarker
 
 
 def _vendored_click_exception() -> type[click.ClickException]:
@@ -570,7 +576,7 @@ def _start_active_projects(
 
 
 @contextmanager
-def _console_on_stderr() -> Iterator[None]:
+def _console_on_stderr() -> Generator[None]:
     console = app_context.console
     app_context.console = terminal_aware_console(stderr=True)
     try:
@@ -942,7 +948,7 @@ def _release_project_claim(batch_size: int, project_name: str, repo: Path) -> No
 @contextmanager
 def _project_claim(
     batch_size: int, project_name: str, repo: Path, *, clean: bool, assume_yes: bool
-) -> Iterator[list[str] | None]:
+) -> Generator[list[str] | None]:
     """Hold this sync's claim on its project name while the sync runs (#2411).
 
     Yields the roots `_mark_sync_incomplete` must still find on the Project.
@@ -980,7 +986,7 @@ def _mark_sync_incomplete(
 
 
 @contextmanager
-def _sync_lock_or_exit(repo: Path, project_name: str) -> Iterator[None]:
+def _sync_lock_or_exit(repo: Path, project_name: str) -> Generator[None]:
     """Hold the checkout's sync lock for the whole sync, or stop first (#2441).
 
     Taken before the `--clean` wipe and the `:IncompleteRun` marker, so a
@@ -1103,16 +1109,17 @@ def _sweep_glosses_after_failed_delete(
 
 
 def _run_updater_deferring_interrupt(
-    updater: "GraphUpdater",
+    updater: "GraphUpdater", *, rebuild: bool = False
 ) -> KeyboardInterrupt | None:
     """Run the sync's graph update; return a Ctrl+C that landed after its commit.
 
     The run stamps the sync time as part of its commit (#2444), and the
     caller clears its marker before re-raising what this returns; a Ctrl+C
-    before the commit raises `SyncInterrupted` instead.
+    before the commit raises `SyncInterrupted` instead. `rebuild` forces a
+    full re-index over runs another writer left part-way.
     """
     try:
-        updater.run()
+        updater.run(force=rebuild)
     except ex.EmbeddingsInterrupted as stop:
         # Raised only after the run committed, so the graph is whole and
         # the sync is recorded like any other; the interrupt then ends
@@ -1182,6 +1189,15 @@ def _run_graph_sync(
             # hits and can map onto unrelated nodes in the rebuilt graph.
             clear_all_embeddings()
 
+        # Read before this sync marks: the runs whose markers its rebuild
+        # supersedes (review of PR #3493).
+        stranded = _stranded_runs(ingestor, project_name, cs.CLI_SYNC_RUN_ID)
+        if stranded:
+            logger.warning(
+                ls.REBUILD_OVER_STRANDED_RUNS.format(
+                    project=project_name, count=len(stranded)
+                )
+            )
         # After the wipe, which would delete the marker with everything else,
         # and before `ensure_constraints`, whose migration can already purge.
         _mark_sync_incomplete(ingestor, project_name, owner, owned_roots)
@@ -1201,8 +1217,9 @@ def _run_graph_sync(
             capture=_capture_selection(capture),
             skip_embeddings=skip_embeddings,
         )
-        interrupted = _run_updater_deferring_interrupt(updater)
+        interrupted = _run_updater_deferring_interrupt(updater, rebuild=bool(stranded))
         _clear_sync_incomplete(ingestor, project_name)
+        _retire_stranded_runs(ingestor, project_name, stranded)
         # Taken before the export: counting it made a no-op sync of a small
         # repo report the time to dump the whole shared graph (issue #2440).
         elapsed = time.monotonic() - elapsed
@@ -2002,7 +2019,12 @@ def mcp_server(
     workspace: str | None = typer.Option(
         None, "--workspace", help=ch.HELP_MCP_WORKSPACE
     ),
+    read_only: bool = typer.Option(False, "--read-only", help=ch.HELP_MCP_READ_ONLY),
 ) -> None:
+    # `is True`: typer passes a bool, while a direct call that omits the
+    # flag passes the truthy OptionInfo default, which must not turn the
+    # setting on.
+    settings.MCP_READ_ONLY = settings.MCP_READ_ONLY or read_only is True
     try:
         if transport == cs.MCPTransport.HTTP:
             from codebase_rag.mcp import serve_http
@@ -2176,6 +2198,18 @@ def graph_command(ctx: typer.Context) -> None:
     _run_delegated_group(graph_cli, ctx)
 
 
+@app.command(
+    name=ch.CLICommandName.PORT,
+    help=ch.CMD_PORT,
+    short_help=ch.CMD_PORT,
+    add_help_option=False,
+    context_settings=_DELEGATED_GROUP_CONTEXT,
+    rich_help_panel=ch.PANEL_USE,
+)
+def port_command(ctx: typer.Context) -> None:
+    _run_delegated_group(port_cli, ctx)
+
+
 @app.command(
     name=ch.CLICommandName.CHECK,
     help=ch.CMD_CHECK,
@@ -2235,6 +2269,75 @@ def check_command(
         raise typer.Exit(code=1)
 
 
+EditReingest = Callable[[list[str]], ReingestReport]
+
+
+@contextmanager
+def _guarded_edit_reingest(
+    ingestor: MemgraphIngestor, updater: "GraphUpdater", project_name: str, repo: Path
+) -> Generator[tuple[EditReingest, "WriteMarker"]]:
+    """The re-ingest an applied edit is measured through, behind the marker.
+
+    Refuses before anything is planned when a run left the project's graph
+    partial: the plan reads its call sites from the graph, so a caller a
+    stopped sync deleted would be neither rewritten nor reported (Greptile
+    review, PR #2164). The MCP tools refuse the same graph through
+    `_guarded_rename_reingest`.
+
+    The checkout's sync lock is held for the whole edit, from that check to
+    the marker's clear: a sync taking the checkout between the check and the
+    plan would leave the plan reading a graph it is rewriting (Greptile
+    review, PR #3493). It waits behind a running sync, as a scoped re-ingest
+    does, and the re-ingest re-enters it.
+
+    The callback is `cgr watch`'s scoped re-ingest. The marker goes down from
+    `before_write`, where the read-only prologue ends, and comes off once the
+    re-ingest returned. A failure after the first write leaves it down, so
+    the next edit, `cgr status` and the MCP server know the graph is partial;
+    the edit's `graph_incomplete` alone would not outlive this process.
+    """
+    held = ExitStack()
+    try:
+        held.enter_context(repo_sync_lock(repo, project_name, wait=True))
+    except SyncLockError as refused:
+        typer.echo(str(refused), err=True)
+        raise typer.Exit(code=1) from None
+    with held:
+        if (refusal := _partial_graph_refusal(ingestor, project_name)) is not None:
+            typer.echo(refusal, err=True)
+            raise typer.Exit(code=1)
+        from .watch import WriteMarker
+
+        with _sync_owner() as owner:
+            marker = WriteMarker(ingestor, project_name, owner, None)
+
+            def reingest(paths: list[str]) -> ReingestReport:
+                report = updater.reingest(paths, before_write=marker.mark_scoped)
+                if updater.reingest_mutated:
+                    marker.clear()
+                return report
+
+            yield reingest, marker
+
+
+def _mark_edit_partial(marker: "WriteMarker", project_name: str) -> str | None:
+    """Mark the graph partial after an edit reported `graph_incomplete`.
+
+    The edit's report decides, as in the MCP tools: a rollback whose
+    re-ingest stopped before its first write put no marker down, yet left
+    the graph describing files the rollback has since restored. Returns the
+    error to print after the edit's JSON when the marker cannot go down, so
+    the report of what changed is not lost.
+    """
+    try:
+        marker.mark()
+    except SyncRefusedError as refused:
+        return cs.CLI_ERR_EDIT_MARKER_FAILED.format(
+            project=project_name, error=refused.__cause__ or refused
+        )
+    return None
+
+
 @app.command(
     name=ch.CLICommandName.RENAME,
     help=ch.CMD_RENAME,
@@ -2275,31 +2378,141 @@ def rename_command(
             queries=queries,
             project_name=name,
         )
-        try:
-            report = rename(
-                repo_path.resolve(),
-                fetch_all,
-                name,
-                qualified_name,
-                new_name,
-                allow_heuristic=allow_heuristic,
-                dry_run=dry_run,
-                reingest=updater.reingest,
-                heuristic_opt_in=cs.RENAME_CLI_ALLOW_HEURISTIC,
+        with _guarded_edit_reingest(ingestor, updater, name, repo_path.resolve()) as (
+            reingest,
+            marker,
+        ):
+            try:
+                report = rename(
+                    repo_path.resolve(),
+                    fetch_all,
+                    name,
+                    qualified_name,
+                    new_name,
+                    allow_heuristic=allow_heuristic,
+                    dry_run=dry_run,
+                    reingest=reingest,
+                    heuristic_opt_in=cs.RENAME_CLI_ALLOW_HEURISTIC,
+                )
+            except RenameRefused as refused:
+                typer.echo(str(refused), err=True)
+                for site in sites_for([*refused.ambiguous, *refused.unplanned]):
+                    typer.echo(f"  {site}", err=True)
+                for entry in refused.unlocatable:
+                    typer.echo(f"  {entry}", err=True)
+                raise typer.Exit(code=1) from refused
+            marker_error = (
+                _mark_edit_partial(marker, name) if report.graph_incomplete else None
             )
-        except RenameRefused as refused:
-            typer.echo(str(refused), err=True)
-            for site in sites_for([*refused.ambiguous, *refused.unplanned]):
-                typer.echo(f"  {site}", err=True)
-            for entry in refused.unlocatable:
-                typer.echo(f"  {entry}", err=True)
-            raise typer.Exit(code=1) from refused
     payload = dict(report._asdict())
     payload[cs.KEY_SITES] = sites_for(report.sites)
     payload[cs.KEY_AMBIGUOUS] = sites_for(report.ambiguous)
     payload[cs.KEY_UNPLANNED] = sites_for(report.unplanned)
     payload["verdict"] = report.verdict._asdict() if report.verdict else None
     typer.echo(json.dumps(payload, indent=cs.MCP_JSON_INDENT, sort_keys=True))
+    if marker_error is not None:
+        typer.echo(marker_error, err=True)
+        raise typer.Exit(code=1)
+    if not report.applied and not dry_run:
+        raise typer.Exit(code=1)
+
+
+@app.command(
+    name=ch.CLICommandName.CHANGE_SIGNATURE,
+    help=ch.CMD_CHANGE_SIGNATURE,
+    short_help=ch.CMD_CHANGE_SIGNATURE,
+    epilog=ch.EXAMPLES_CHANGE_SIGNATURE,
+    rich_help_panel=ch.PANEL_USE,
+)
+def change_signature_command(
+    qualified_name: str = typer.Argument(..., help=ch.HELP_CHANGE_SIGNATURE_QN),
+    new_params: list[str] = typer.Argument(..., help=ch.HELP_CHANGE_SIGNATURE_PARAMS),
+    repo_path: Path = typer.Option(
+        Path(cs.MCP_DEFAULT_DIRECTORY),
+        "--repo-path",
+        exists=True,
+        file_okay=False,
+        help=ch.HELP_GRAPH_REPO_PATH,
+    ),
+    project: str | None = typer.Option(None, "--project", help=ch.HELP_GRAPH_PROJECT),
+    mapping: list[str] | None = typer.Option(
+        None, "--map", help=ch.HELP_CHANGE_SIGNATURE_MAP
+    ),
+    allow_heuristic: bool = typer.Option(
+        False, "--allow-heuristic", help=ch.HELP_CHANGE_SIGNATURE_ALLOW_HEURISTIC
+    ),
+    dry_run: bool = typer.Option(
+        False, "--dry-run", help=ch.HELP_CHANGE_SIGNATURE_DRY_RUN
+    ),
+) -> None:
+    from .editing.signature import change_signature
+    from .editing.signature_spec import (
+        SignatureRefused,
+        parse_mapping,
+        sites_for,
+        unmapped_for,
+    )
+    from .graph_cli import _project_and_fetch
+    from .graph_query import source_root_for
+
+    try:
+        parsed = parse_mapping(mapping or [])
+    except SignatureRefused as refused:
+        typer.echo(str(refused), err=True)
+        raise typer.Exit(code=1) from refused
+    name, fetch_all, ingestor = _project_and_fetch(project, repo_path)
+    with ingestor:
+        # An explicit --project may name a graph indexed from another
+        # checkout; its repo-relative paths must not be edited under this
+        # one. The MCP handler refuses the same mismatch.
+        if source_root_for(fetch_all, name, repo_path) is None:
+            typer.echo(
+                cs.SIGNATURE_CLI_WRONG_ROOT.format(
+                    project=name, root=repo_path.resolve()
+                ),
+                err=True,
+            )
+            raise typer.Exit(code=1)
+        parsers, queries = load_parsers()
+        from .graph_updater import GraphUpdater
+
+        updater = GraphUpdater(
+            ingestor=ingestor,
+            repo_path=repo_path.resolve(),
+            parsers=parsers,
+            queries=queries,
+            project_name=name,
+        )
+        with _guarded_edit_reingest(ingestor, updater, name, repo_path.resolve()) as (
+            reingest,
+            marker,
+        ):
+            try:
+                report = change_signature(
+                    repo_path.resolve(),
+                    fetch_all,
+                    name,
+                    qualified_name,
+                    new_params,
+                    parsed,
+                    allow_heuristic=allow_heuristic,
+                    dry_run=dry_run,
+                    reingest=reingest,
+                )
+            except SignatureRefused as refused:
+                typer.echo(str(refused), err=True)
+                raise typer.Exit(code=1) from refused
+            marker_error = (
+                _mark_edit_partial(marker, name) if report.graph_incomplete else None
+            )
+    payload = dict(report._asdict())
+    payload[cs.KEY_SITES] = sites_for(report.sites)
+    payload[cs.KEY_UNMAPPED] = unmapped_for(report.unmapped)
+    payload[cs.KEY_VERDICT] = report.verdict._asdict() if report.verdict else None
+    typer.echo(json.dumps(payload, indent=cs.MCP_JSON_INDENT, sort_keys=True))
+    if marker_error is not None:
+        typer.echo(marker_error, err=True)
+        raise typer.Exit(code=1)
     if not report.applied and not dry_run:
         raise typer.Exit(code=1)