code-graph-rag 0.0.845__tar.gz → 0.0.945__tar.gz

{code_graph_rag-0.0.845/code_graph_rag.egg-info → code_graph_rag-0.0.945}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.845
+Version: 0.0.945
 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
@@ -52,6 +52,8 @@ Requires-Dist: ast-grep-py>=0.44.0; extra == "test"
 Requires-Dist: pyyaml>=6.0; extra == "test"
 Provides-Extra: cpp
 Requires-Dist: libclang>=18.1.1; extra == "cpp"
+Provides-Extra: neo4j
+Requires-Dist: neo4j>=5.28.1; extra == "neo4j"
 Provides-Extra: treesitter-full
 Requires-Dist: tree-sitter-python>=0.23.6; extra == "treesitter-full"
 Requires-Dist: tree-sitter-javascript>=0.23.1; extra == "treesitter-full"

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/README.md

@@ -51,12 +51,9 @@ Code-Graph-RAG parses a multi-language codebase with Tree-sitter, builds a knowl
 ## Latest News 🔥
 
 <!-- SECTION:latest_news -->
-- **Index Consistency**: Ensure incremental deletes match clean index states.
-- **Patch Reporting**: Distinguish between unverifiable and verified patches in reports.
-- **Windows Teardown**: Clear the read-only bit when removing a temp repo for successful Windows teardown.
-- **TypeScript Grading**: Grade TypeScript inheritance against the tsc oracle for improved accuracy.
-- **Exclude Set Handling**: Record the exclusion set to ensure `--exclude` flags are correctly applied across runs.
-- **MCP Indexing**: Honour `.cgrignore` and `.gitignore` in MCP index and update processes, matching the CLI.
+- **UTF-8 Handling**: Improved handling of invalid UTF-8 bytes prevents file definitions from being dropped.
+- **Neo4j Backend Support**: Added support for Neo4j as a graph backend through a pluggable dialect seam.
+- **Gloss Node & Notes**: Introduced the Gloss node for agent-authored notes and enabled writing and reading Gloss notes via the MCP server.
 <!-- /SECTION:latest_news -->
 
 See [NEWS.md](NEWS.md) for the full history.

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945/code_graph_rag.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-graph-rag
-Version: 0.0.845
+Version: 0.0.945
 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
@@ -52,6 +52,8 @@ Requires-Dist: ast-grep-py>=0.44.0; extra == "test"
 Requires-Dist: pyyaml>=6.0; extra == "test"
 Provides-Extra: cpp
 Requires-Dist: libclang>=18.1.1; extra == "cpp"
+Provides-Extra: neo4j
+Requires-Dist: neo4j>=5.28.1; extra == "neo4j"
 Provides-Extra: treesitter-full
 Requires-Dist: tree-sitter-python>=0.23.6; extra == "treesitter-full"
 Requires-Dist: tree-sitter-javascript>=0.23.1; extra == "treesitter-full"

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/code_graph_rag.egg-info/SOURCES.txt

@@ -28,8 +28,13 @@ codebase_rag/embedder.py
 codebase_rag/exceptions.py
 codebase_rag/flow_verdict.py
 codebase_rag/function_registry.py
+codebase_rag/gloss.py
+codebase_rag/gloss_repair.py
 codebase_rag/graph_audit.py
+codebase_rag/graph_cli.py
+codebase_rag/graph_dialects.py
 codebase_rag/graph_loader.py
+codebase_rag/graph_query.py
 codebase_rag/graph_updater.py
 codebase_rag/language_spec.py
 codebase_rag/logs.py
@@ -44,6 +49,8 @@ codebase_rag/schema_builder.py
 codebase_rag/schema_parse.py
 codebase_rag/schemas.py
 codebase_rag/sql_names.py
+codebase_rag/structural_check.py
+codebase_rag/structural_delta.py
 codebase_rag/taint.py
 codebase_rag/tool_errors.py
 codebase_rag/types_defs.py
@@ -129,14 +136,17 @@ codebase_rag/constants/structural.py
 codebase_rag/constants/trace.py
 codebase_rag/editing/__init__.py
 codebase_rag/editing/cli.py
+codebase_rag/editing/contract.py
 codebase_rag/editing/imports.py
 codebase_rag/editing/patcher.py
+codebase_rag/editing/rename.py
 codebase_rag/editing/transaction.py
 codebase_rag/mcp/__init__.py
 codebase_rag/mcp/client.py
 codebase_rag/mcp/server.py
 codebase_rag/mcp/tools.py
 codebase_rag/parsers/__init__.py
+codebase_rag/parsers/anchor_hash.py
 codebase_rag/parsers/ast_fingerprint.py
 codebase_rag/parsers/ast_grep_tier.py
 codebase_rag/parsers/build_lock.py
@@ -144,6 +154,7 @@ codebase_rag/parsers/call_processor.py
 codebase_rag/parsers/call_resolver.py
 codebase_rag/parsers/contract_linking.py
 codebase_rag/parsers/contracts.py
+codebase_rag/parsers/definition_docstring.py
 codebase_rag/parsers/definition_processor.py
 codebase_rag/parsers/dependency_parser.py
 codebase_rag/parsers/dispatch_registry.py
@@ -153,18 +164,22 @@ codebase_rag/parsers/endpoint_routes.py
 codebase_rag/parsers/endpoints.py
 codebase_rag/parsers/export_detection.py
 codebase_rag/parsers/factory.py
+codebase_rag/parsers/field_nodes.py
 codebase_rag/parsers/flat_module.py
 codebase_rag/parsers/frontend_mode.py
 codebase_rag/parsers/function_ingest.py
 codebase_rag/parsers/import_processor.py
 codebase_rag/parsers/java_generated.py
 codebase_rag/parsers/java_lombok.py
+codebase_rag/parsers/module_docstring.py
+codebase_rag/parsers/parameter_nodes.py
 codebase_rag/parsers/python_source_roots.py
 codebase_rag/parsers/rpc_exposure.py
 codebase_rag/parsers/semantic_call_join.py
 codebase_rag/parsers/stdlib_extractor.py
 codebase_rag/parsers/string_call.py
 codebase_rag/parsers/structure_processor.py
+codebase_rag/parsers/type_facts.py
 codebase_rag/parsers/type_inference.py
 codebase_rag/parsers/utils.py
 codebase_rag/parsers/ast_grep_patterns/bash.yaml
@@ -276,9 +291,11 @@ codebase_rag/providers/litellm.py
 codebase_rag/services/__init__.py
 codebase_rag/services/anthropic_token_counter.py
 codebase_rag/services/filtering.py
+codebase_rag/services/gloss_cleanup.py
 codebase_rag/services/graph_diff.py
 codebase_rag/services/graph_service.py
 codebase_rag/services/llm.py
+codebase_rag/services/neo4j_driver.py
 codebase_rag/services/protobuf_service.py
 codebase_rag/services/provenance.py
 codebase_rag/services/resource_cleanup.py
@@ -310,6 +327,7 @@ codebase_rag/tools/web_search.py
 codebase_rag/trace/__init__.py
 codebase_rag/trace/cli.py
 codebase_rag/trace/cpuprofile.py
+codebase_rag/trace/dispatch_site.py
 codebase_rag/trace/ebpf_pprof.py
 codebase_rag/trace/ingest.py
 codebase_rag/trace/instrumented.py

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/code_graph_rag.egg-info/requires.txt

@@ -30,6 +30,9 @@ libclang>=18.1.1
 [milvus]
 pymilvus[milvus-lite]>=3.0.0
 
+[neo4j]
+neo4j>=5.28.1
+
 [python-semantics]
 jedi>=0.19
 

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/cli.py

@@ -36,6 +36,7 @@ from .editor_links import (
     resolve_editor,
     url_template_problem,
 )
+from .graph_cli import cli as graph_cli
 from .graph_updater import GraphUpdater
 from .main import (
     _create_configuration_table,
@@ -1090,6 +1091,135 @@ def edits_command(ctx: typer.Context) -> None:
     _run_delegated_group(edits_cli, ctx)
 
 
+@app.command(
+    name=ch.CLICommandName.GRAPH,
+    help=ch.CMD_GRAPH,
+    short_help=ch.CMD_GRAPH,
+    add_help_option=False,
+    context_settings=_DELEGATED_GROUP_CONTEXT,
+    rich_help_panel=ch.PANEL_GRAPH,
+)
+def graph_command(ctx: typer.Context) -> None:
+    _run_delegated_group(graph_cli, ctx)
+
+
+@app.command(
+    name=ch.CLICommandName.CHECK,
+    help=ch.CMD_CHECK,
+    short_help=ch.CMD_CHECK,
+    epilog=ch.EXAMPLES_CHECK,
+    rich_help_panel=ch.PANEL_USE,
+)
+def check_command(
+    base: str = typer.Option("HEAD", "--base", help=ch.HELP_CHECK_BASE),
+    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),
+    fail_on_found: bool = typer.Option(
+        False, "--fail-on-found", help=ch.HELP_CHECK_FAIL_ON_FOUND
+    ),
+) -> None:
+    from .structural_check import CheckError, indexed_scope, run_check
+    from .structural_delta import has_findings
+    from .utils.path_utils import derive_project_name
+
+    root = repo_path.resolve()
+    name = project or derive_project_name(root)
+    parsers, queries = load_parsers()
+    with connect_memgraph(batch_size=settings.resolve_batch_size(None)) as ingestor:
+        if name not in ingestor.list_projects():
+            typer.echo(cs.CHECK_NOT_INDEXED.format(project=name), err=True)
+            raise typer.Exit(code=1)
+        try:
+            exclude_paths, unignore_paths = indexed_scope(
+                root, name, explicit=project is not None
+            )
+            delta = run_check(
+                root,
+                base,
+                name,
+                ingestor,
+                parsers,
+                queries,
+                exclude_paths=exclude_paths,
+                unignore_paths=unignore_paths,
+            )
+        except CheckError as error:
+            typer.echo(str(error), err=True)
+            raise typer.Exit(code=1) from error
+    typer.echo(json.dumps(delta, indent=cs.MCP_JSON_INDENT))
+    if fail_on_found and has_findings(delta):
+        raise typer.Exit(code=1)
+
+
+@app.command(
+    name=ch.CLICommandName.RENAME,
+    help=ch.CMD_RENAME,
+    short_help=ch.CMD_RENAME,
+    epilog=ch.EXAMPLES_RENAME,
+    rich_help_panel=ch.PANEL_USE,
+)
+def rename_command(
+    qualified_name: str = typer.Argument(..., help=ch.HELP_RENAME_QN),
+    new_name: str = typer.Argument(..., help=ch.HELP_RENAME_NEW_NAME),
+    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),
+    allow_heuristic: bool = typer.Option(
+        False, "--allow-heuristic", help=ch.HELP_RENAME_ALLOW_HEURISTIC
+    ),
+    dry_run: bool = typer.Option(False, "--dry-run", help=ch.HELP_RENAME_DRY_RUN),
+) -> None:
+    from .editing.rename import RenameRefused, rename, sites_for
+    from .graph_cli import _project_and_fetch
+
+    name, fetch_all, ingestor = _project_and_fetch(project, repo_path)
+    with ingestor:  # type: ignore[attr-defined]
+        parsers, queries = load_parsers()
+        updater = GraphUpdater(
+            ingestor=ingestor,  # type: ignore[arg-type]
+            repo_path=repo_path.resolve(),
+            parsers=parsers,
+            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,
+            )
+        except RenameRefused as refused:
+            typer.echo(str(refused), err=True)
+            for site in sites_for(refused.ambiguous):
+                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["verdict"] = report.verdict._asdict() if report.verdict else None
+    typer.echo(json.dumps(payload, indent=cs.MCP_JSON_INDENT, sort_keys=True))
+    if not report.applied and not dry_run:
+        raise typer.Exit(code=1)
+
+
 @app.command(
     name=ch.CLICommandName.HELP,
     help=ch.CMD_HELP,
@@ -1171,6 +1301,18 @@ def status_command() -> None:
         app_context.console.print(f"  - {project}: last sync {ts}")
 
 
+def _status_mark(passed: bool, encoding: str) -> str:
+    """The pass/fail mark the console's stream can encode.
+
+    Rich substitutes ASCII box characters on a non-UTF stream but leaves
+    text alone, so the glyph raised UnicodeEncodeError on a CP950 Windows
+    terminal before a single check was shown (issue #1910).
+    """
+    if encoding.lower().startswith(cs.ENCODING_UTF_PREFIX):
+        return cs.HEALTH_MARK_PASS if passed else cs.HEALTH_MARK_FAIL
+    return cs.HEALTH_MARK_PASS_ASCII if passed else cs.HEALTH_MARK_FAIL_ASCII
+
+
 @app.command(
     name=ch.CLICommandName.DOCTOR,
     help=ch.CMD_DOCTOR,
@@ -1186,8 +1328,9 @@ def doctor() -> None:
     table = Table(show_header=False, box=None, padding=(0, 2))
     table.add_column(style="cyan", no_wrap=False)
 
+    encoding = app_context.console.encoding
     for result in results:
-        status = "✓" if result.passed else "✗"
+        status = _status_mark(result.passed, encoding)
         status_color = cs.Color.GREEN if result.passed else cs.Color.RED
         status_text = style(status, status_color, cs.StyleModifier.NONE)
 
@@ -1314,6 +1457,7 @@ def _dead_code_config(
     include_classes: bool,
     entry_points: list[str],
     decorator_roots: list[str],
+    min_resolution: cs.EdgeResolution | None = None,
 ) -> DeadCodeConfig:
     # test_patterns is always set: included tests become roots; excluded, it
     # filters test modules out of module-load roots so test-only code stays dead.
@@ -1326,6 +1470,7 @@ def _dead_code_config(
         ),
         entry_points=tuple(entry_points),
         test_patterns=tuple(cs.TEST_PATH_PATTERNS),
+        min_resolution=str(min_resolution) if min_resolution is not None else None,
     )
 
 
@@ -1473,6 +1618,9 @@ def dead_code(
     fail_on_found: bool = typer.Option(
         False, "--fail-on-found", help=ch.HELP_DEADCODE_FAIL_ON_FOUND
     ),
+    min_resolution: cs.EdgeResolution | None = typer.Option(
+        None, "--min-resolution", help=ch.HELP_DEADCODE_MIN_RESOLUTION
+    ),
 ) -> None:
     from .dead_code import collect_dead_code_with_coverage
 
@@ -1494,7 +1642,11 @@ def dead_code(
                     ingestor,
                     resolved,
                     _dead_code_config(
-                        include_tests, include_classes, entry_point, decorator_root
+                        include_tests,
+                        include_classes,
+                        entry_point,
+                        decorator_root,
+                        min_resolution,
                     ),
                 )
     except Exception as e:

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/cli_help.py

@@ -18,6 +18,9 @@ class CLICommandName(StrEnum):
     WORKSPACE = "workspace"
     TRACE = "trace"
     EDITS = "edits"
+    GRAPH = "graph"
+    CHECK = "check"
+    RENAME = "rename"
     STOP = "stop"
     STATUS = "status"
     HELP = "help"
@@ -93,6 +96,55 @@ HELP_EDITS_REPO_PATH = (
     "Repository root holding .cgr-edit-history.json (default: current directory)."
 )
 HELP_EDITS_DIFF = "Print each transaction's unified diff."
+CMD_GRAPH = "Deterministic graph queries (resolve, definition, callers, callees, implementors, overrides, importers, tests-reaching) as JSON, no LLM."
+CMD_GRAPH_GROUP = CMD_GRAPH
+CMD_GRAPH_RESOLVE = "Resolve a name, dotted suffix, or path:line to qualified names."
+CMD_GRAPH_DEFINITION = "File, span, docstring and source of one definition."
+CMD_GRAPH_CALLERS = "Call sites that invoke a qualified name, one row per site."
+CMD_GRAPH_CALLEES = "Call sites inside a qualified name, one row per site."
+CMD_GRAPH_IMPLEMENTORS = "Types that inherit from or implement a type."
+CMD_GRAPH_OVERRIDES = "Methods overriding a method, and the method it overrides."
+CMD_GRAPH_IMPORTERS = (
+    "Modules importing a module, with each import statement's location."
+)
+CMD_GRAPH_TESTS_REACHING = (
+    "Tests from which a qualified name is reachable, with distance."
+)
+EPILOG_GRAPH = "Run 'cgr help graph COMMAND' for command-specific help."
+HELP_GRAPH_PROJECT = "Project name in the graph (default: derived from --repo-path)."
+HELP_GRAPH_REPO_PATH = (
+    "Repository root the project name derives from and source is read from."
+)
+HELP_GRAPH_DEPTH = "How many hops to follow (1 to 5)."
+CMD_CHECK = (
+    "Report the structural delta of the working tree against a git ref: "
+    "dangling callers, arity findings, new duplicates, new import cycles, "
+    "tests reaching the edited symbols."
+)
+EXAMPLES_CHECK = (
+    "Examples:\n  cgr check --base HEAD\n  cgr check --base origin/main --fail-on-found"
+)
+HELP_CHECK_BASE = (
+    "Git ref the graph was indexed at; files differing from it are re-ingested."
+)
+HELP_CHECK_FAIL_ON_FOUND = (
+    "Exit with status 1 when the delta reports dangling callers, arity "
+    "findings, new duplicates or new import cycles."
+)
+CMD_RENAME = (
+    "Rename a definition everywhere the graph references it (definition, call "
+    "and reference sites, imports, overrides, __all__); refuses on guessed sites."
+)
+EXAMPLES_RENAME = (
+    "Examples:\n  cgr rename myproj.pkg.util.helper assist --dry-run\n"
+    "  cgr rename myproj.pkg.Store.get fetch --allow-heuristic"
+)
+HELP_RENAME_QN = "Qualified name of the definition to rename."
+HELP_RENAME_NEW_NAME = "The new identifier."
+HELP_RENAME_ALLOW_HEURISTIC = (
+    "Rewrite through heuristic, overload and trace-only sites as well."
+)
+HELP_RENAME_DRY_RUN = "Print the plan and diff without writing anything."
 CMD_TRACE_INGEST = "Resolve a trace file against a project and write dynamic edges"
 CMD_TRACE_CONVERT = "Convert a V8 .cpuprofile (node --cpu-prof) to a trace file"
 
@@ -353,6 +405,10 @@ HELP_DEADCODE_CLASSES = (
 )
 HELP_DEADCODE_FORMAT = "Report format: table or json."
 HELP_DEADCODE_OUTPUT = "Write the report to this file instead of stdout."
+HELP_DEADCODE_MIN_RESOLUTION = (
+    "Ignore call edges below this confidence when deciding liveness: "
+    "heuristic < overload < exact < trace_confirmed (dynamic counts as confirmed)."
+)
 HELP_DEADCODE_FAIL_ON_FOUND = (
     "Exit with status 1 when any candidate is found. Useful in CI."
 )
@@ -407,6 +463,9 @@ CLI_COMMANDS: dict[CLICommandName, str] = {
     CLICommandName.DAEMON: CMD_DAEMON,
     CLICommandName.TRACE: CMD_TRACE,
     CLICommandName.EDITS: CMD_EDITS,
+    CLICommandName.GRAPH: CMD_GRAPH,
+    CLICommandName.CHECK: CMD_CHECK,
+    CLICommandName.RENAME: CMD_RENAME,
     CLICommandName.WORKSPACE: CMD_WORKSPACE,
     CLICommandName.STOP: CMD_STOP,
     CLICommandName.STATUS: CMD_STATUS,

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/config.py

@@ -9,12 +9,13 @@ from typing import TypedDict, Unpack
 
 from dotenv import load_dotenv
 from loguru import logger
-from pydantic import Field
+from pydantic import Field, field_validator
 from pydantic_settings import BaseSettings, SettingsConfigDict
 
 from . import constants as cs
 from . import exceptions as ex
 from . import logs
+from .graph_dialects import DIALECT_MEMGRAPH, available_dialects
 from .types_defs import CgrignorePatterns, ModelConfigKwargs
 
 # Load only the configuration file in the invocation directory.  The default
@@ -103,6 +104,16 @@ def format_missing_api_key_errors(
 
 LOCAL_PROVIDERS = frozenset({cs.Provider.OLLAMA})
 
+# The provider-owned variable `validate_api_key` accepts INSTEAD of the role's
+# own `<ROLE>_API_KEY`. Module level so `cgr doctor` can name the same variable
+# the gate reads rather than restating the rule and drifting from it (#1910).
+# A provider absent here is satisfied only by the role variable.
+PROVIDER_ENV_KEYS = {
+    cs.Provider.ANTHROPIC: cs.ENV_ANTHROPIC_API_KEY,
+    cs.Provider.AZURE: cs.ENV_AZURE_API_KEY,
+    cs.Provider.MINIMAX: cs.ENV_MINIMAX_API_KEY,
+}
+
 
 @dataclass
 class ModelConfig:
@@ -124,12 +135,7 @@ class ModelConfig:
 
     def validate_api_key(self, role: str = cs.DEFAULT_MODEL_ROLE) -> None:
         provider_lower = self.provider.lower()
-        provider_env_keys = {
-            cs.Provider.ANTHROPIC: cs.ENV_ANTHROPIC_API_KEY,
-            cs.Provider.AZURE: cs.ENV_AZURE_API_KEY,
-            cs.Provider.MINIMAX: cs.ENV_MINIMAX_API_KEY,
-        }
-        env_key = provider_env_keys.get(provider_lower)
+        env_key = PROVIDER_ENV_KEYS.get(provider_lower)
         if (
             provider_lower in LOCAL_PROVIDERS
             or (
@@ -159,11 +165,24 @@ class AppConfig(BaseSettings):
         case_sensitive=False,
     )
 
+    # Which graph engine the ingestor talks to. Memgraph stays the default,
+    # so an existing install keeps its behaviour without touching config;
+    # see `graph_dialects` for what actually differs between engines.
+    GRAPH_BACKEND: str = DIALECT_MEMGRAPH
+
     MEMGRAPH_HOST: str = "localhost"
     MEMGRAPH_PORT: int = 7687
     MEMGRAPH_HTTP_PORT: int = 7444
     MEMGRAPH_USERNAME: str | None = None
     MEMGRAPH_PASSWORD: str | None = None
+
+    # Neo4j connects by URI rather than host/port: the scheme carries the
+    # routing mode (`neo4j://` for a cluster, `bolt://` for one instance)
+    # and TLS (`+s`/`+ssc`), none of which a host/port pair can express.
+    NEO4J_URI: str = "bolt://localhost:7687"
+    NEO4J_USERNAME: str | None = None
+    NEO4J_PASSWORD: str | None = None
+    NEO4J_DATABASE: str = "neo4j"
     LAB_PORT: int = 3000
     MEMGRAPH_BATCH_SIZE: int = 1000
     AGENT_RETRIES: int = 3
@@ -364,6 +383,25 @@ class AppConfig(BaseSettings):
     QUERY_MEMORY_LIMIT_MB: int = Field(default=4096, gt=0)
     QUERY_TIMEOUT_S: float = Field(default=60.0, gt=0)
 
+    @field_validator("GRAPH_BACKEND")
+    @classmethod
+    def _known_backend(cls, value: str) -> str:
+        """Reject an unknown engine name at startup.
+
+        Defaulting an unrecognised value to Memgraph would send Memgraph
+        DDL to whatever server is actually configured, and
+        `MemgraphIngestor.ensure_constraints` swallows DDL failures -- so
+        a typo would surface much later as a graph built with no
+        constraints rather than as a startup error.
+        """
+        normalised = value.strip().lower()
+        if normalised not in available_dialects():
+            raise ValueError(
+                f"GRAPH_BACKEND must be one of {', '.join(available_dialects())}; "
+                f"got {value!r}"
+            )
+        return normalised
+
     OLLAMA_HEALTH_TIMEOUT: float = 5.0
     LITELLM_HEALTH_TIMEOUT: float = 5.0
 

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_cpp.py

@@ -51,7 +51,6 @@ class CppNodeType(StrEnum):
     TYPE_DESCRIPTOR = "type_descriptor"
 
 
-CPP_MODULE_EXTENSIONS = (".ixx", ".cppm", ".ccm", ".mxx")
 CPP_MODULE_PATH_MARKERS = frozenset({"interfaces", "modules"})
 
 # C++ module declaration prefixes
@@ -82,6 +81,7 @@ CPP_KEYWORD_STRUCT = "struct"
 # `static` storage on a declaration: internal linkage, TU-local symbol.
 CPP_KEYWORD_STATIC = "static"
 TS_CPP_STORAGE_CLASS_SPECIFIER = "storage_class_specifier"
+TS_CPP_TYPE_QUALIFIER = "type_qualifier"
 CPP_EXPORTED_CLASS_KEYWORDS = frozenset({CPP_KEYWORD_CLASS, CPP_KEYWORD_STRUCT})
 
 # A C/C++ class/struct/union tag with no body is a forward declaration

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_csharp.py

@@ -145,6 +145,8 @@ TS_CSHARP_MODIFIER_PROTECTED = "protected"
 # of the parameter_list (grammar quirk), captured directly.
 TS_CSHARP_PARAMETER = "parameter"
 TS_CSHARP_ARRAY_TYPE = "array_type"
+# `params T[] items` renders as the modifier plus the array type (#1527).
+CSHARP_PARAMS_PREFIX = "params "
 TS_CSHARP_PARAMETER_LIST = "parameter_list"
 
 # Local/field declarations for type inference. A local is a variable_declaration

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_dart.py

@@ -81,6 +81,11 @@ DART_NESTED_SCOPE_NODE_TYPES = frozenset(
     }
 )
 TS_DART_INITIALIZED_IDENTIFIER_LIST = "initialized_identifier_list"
+TS_DART_STATIC_FINAL_DECLARATION_LIST = "static_final_declaration_list"
+TS_DART_STATIC_FINAL_DECLARATION = "static_final_declaration"
+TS_DART_CONST_BUILTIN = "const_builtin"
+TS_DART_FINAL_BUILTIN = "final_builtin"
+TS_DART_LATE = "late"
 TS_DART_INITIALIZED_IDENTIFIER = "initialized_identifier"
 TS_DART_INITIALIZED_VARIABLE_DEFINITION = "initialized_variable_definition"
 TS_DART_FORMAL_PARAMETER = "formal_parameter"

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_go.py

@@ -82,6 +82,10 @@ TS_GO_POINTER_TYPE = "pointer_type"
 # `pkg.Type` in a signature; kept as dotted text so a binding typed to an
 # external package's type stays TYPED (and drops) instead of trie-guessed.
 TS_GO_QUALIFIED_TYPE = "qualified_type"
+TS_GO_GENERIC_TYPE = "generic_type"
+# Field names of a `qualified_type` (`pkg.Name`): the package identifier and
+# the type name; a `composite_literal` carries its constructed type in `type`.
+FIELD_GO_PACKAGE = "package"
 # Go composite types a method may return; a chained call lands on the CONTAINER,
 # not its element, so return-type inference must not unwrap these (a `[]Command`
 # return must not resolve `.Run()` to `Command.Run`).

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_java.py

@@ -21,6 +21,9 @@ TS_FORMAL_PARAMETER = "formal_parameter"
 TS_SPREAD_PARAMETER = "spread_parameter"
 TS_LOCAL_VARIABLE_DECLARATION = "local_variable_declaration"
 TS_FIELD_DECLARATION = "field_declaration"
+# An interface field. The grammar names it after what it implicitly is
+# (`public static final`), so the keywords are usually absent from source.
+TS_JAVA_CONSTANT_DECLARATION = "constant_declaration"
 TS_ASSIGNMENT_EXPRESSION = "assignment_expression"
 
 TS_OBJECT_CREATION_EXPRESSION = "object_creation_expression"

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_lua.py

@@ -28,6 +28,13 @@ LUA_METHOD_SEPARATOR = ":"
 TS_LUA_CHUNK = "chunk"
 TS_LUA_FUNCTION_DECLARATION = "function_declaration"
 TS_LUA_FUNCTION_DEFINITION = "function_definition"
+# A `key = value` entry of a table constructor (`{ f = function() end }`): the
+# key is the `name` field (an identifier, or a string for `["key"] =`), the
+# value the `value` field.
+TS_LUA_FIELD = "field"
+# The token that opens a computed or string key: `["k"] = v`, `[k] = v`.
+LUA_OPEN_BRACKET = "["
+TS_LUA_TABLE_CONSTRUCTOR = "table_constructor"
 
 # Import processor function names
 IMPORT_REQUIRE = "require"

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_nodes.py

@@ -217,6 +217,7 @@ TS_PRIVATE_PROPERTY_IDENTIFIER = "private_property_identifier"
 
 TS_IMPORT_DECLARATION = "import_declaration"
 TS_STATIC = "static"
+TS_READONLY = "readonly"
 TS_SCOPED_IDENTIFIER = "scoped_identifier"
 TS_ASTERISK = "asterisk"
 

{code_graph_rag-0.0.845 → code_graph_rag-0.0.945}/codebase_rag/constants/ast_php.py

@@ -32,6 +32,11 @@ TS_PHP_ATTRIBUTE_LIST = "attribute_list"
 TS_PHP_ATTRIBUTE = "attribute"
 TS_PHP_ATTRIBUTE_GROUP = "attribute_group"
 TS_PHP_VISIBILITY_MODIFIER = "visibility_modifier"
+TS_PHP_STATIC_MODIFIER = "static_modifier"
+TS_PHP_PROPERTY_DECLARATION = "property_declaration"
+TS_PHP_PROPERTY_ELEMENT = "property_element"
+TS_PHP_DECLARATION_LIST = "declaration_list"
+TS_PHP_VARIABLE_NAME = "variable_name"
 TS_PHP_USE_DECLARATION = "use_declaration"
 
 # FLOWS_TO lean-walk node types (issue #1174). PHP variables carry a `$` prefix