Validate a configuration value. Returns (is_valid, error_message)

Construct the text to embed for a Function node.

Get parent context for nested constructs.

Import a batch of edges.

Inject a mock embedder that returns a fixed vector.

Save Neo4j credentials to .env file (database setup only). Does NOT generate MCP config or configure IDE.

* Get the node's child at the given index, where zero represents the first child. * * This method is fairly fast, but its cost is technically lo

Creates a new job, assigns it a unique ID, and stores it.

Tool implementation for executing a read-only Cypher query. Write protection is layered: the regex guard rejects write keywords on every

Return the active git branch name for *repo_path*, or ``None``.

Return the configured result-count limit for *tool_name*. Resolution order ---------------- 1. ``TOOL_RESULT_LIMITS`` JSON entry for *too

Routes a tool call from the AI assistant to the appropriate handler function.

Checks if the database connection is currently active.

Run command and return output

Runs a command, captures its output, and handles execution. Returns the completed process object on success, None on failure.

Run SCIP CLI, write graph, supplement with Tree-sitter, write SCIP CALLS edges.

Persist ContextConfig to ~/.codegraphcontext/config.yaml.

Tests the Neo4j database connection. Returns: Tuple[bool, Optional[str]]: (is_connected, error_message)

Human-readable description of which config key produced *effective*.

Build a minimal GraphBuilder stub with the real update_file_in_graph method.

Check if a message at the given level should be logged

Return *value* if it is a bare Cypher identifier, else raise.

Simulates adding a new dependency edge.

Build DECORATED_BY rows from parsed decorator metadata on functions/classes.

Build CLI-facing metrics for a completed Tree-sitter indexing run.

Returns (inheritance_batch_rows, csharp_file_data_list).

Lightweight TCP preflight check for Neo4j endpoint reachability.

Log critical message if log level allows

Returns (files, ignore_root). *ignore_root* is used for .cgcignore relative matching. ``supported_extensions`` should be the set of extensio

Returns the database backend type.

Gets the remote FalkorDB connection, creating it if necessary. Thread-safe. Supports multiple graphs by name. Args:

Return an explicit port or a stable port unique to a Unix socket path.

Assembles all architectural metrics into a unified summary.

Check if GCF output format is enabled via environment variable.

Fetches the repository structure and relationships from the database.

Write the visualization HTML to a file and open it in the default browser. Parameters ---------- graph_data: Output of :func

Dispatch pre-scan by file extension; *parsers_keys* is the set of supported extensions (e.g. graph_builder.parsers.keys()).

Simulates removing dependency edges.

Generate and persist embeddings for all un-embedded Function nodes in repo.

A CGCBundle whose only real behaviour is its backend type.

Create CALLS relationships using fully label-specific UNWIND queries (V3). Both caller AND called sides use specific labels — no OR scans anyw

Find parent context for Ruby constructs.

Load the ``workspace_mappings`` section from config.yaml.