# sinaigross/code-graph-rag-for-cv architecture

> Architecture diagram of the GitHub repository sinaigross/code-graph-rag-for-cv, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sinaigross/code-graph-rag-for-cv
- Repository: https://github.com/sinaigross/code-graph-rag-for-cv

## Overview

Code-Graph-RAG indexes mixed-language repositories into a shared knowledge graph, then uses that graph to answer questions and support code changes. The main workflow runs from a user starting an index or asking a question, through parsing and graph storage, to graph-backed retrieval and an answer. Separate capabilities include structural editing, dead-code analysis, runtime trace overlays, and MCP access. The README documents these capabilities; the sampled source and index support selected internal links, but not every runtime dispatch.

Main entry points: [`codebase_rag/parsers/function_ingest.py`](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/function_ingest.py) (Language Parsing), [`codebase_rag/cli.py`](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/cli.py) (CLI Runtime), [`codebase_rag/services/graph_service.py`](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/services/graph_service.py) (Graph Service), [`codebase_rag/tools/codebase_query.py`](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/codebase_query.py) (Codebase Questions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_index["Indexing"]
  node_parser["Language Parsing<br/>[function_ingest.py]"]
  node_language["Language Specs<br/>[language_spec.py]"]
  node_endpoints["Route Extraction<br/>[endpoint_routes.py]"]
  node_go_builds["Go Build Discovery<br/>[builds.py]"]
  node_imports["Import Analysis"]
  node_parameters["Parameter Nodes<br/>[parameter_nodes.py]"]
  node_type_facts["Type Facts<br/>[type_facts.py]"]
end

subgraph group_graph["Graph Storage"]
  node_schema["Graph Schema<br/>[types_defs.py]"]
  node_queries["Cypher Queries<br/>[cypher_queries.py]"]
  node_graph_service["Graph Service<br/>[graph_service.py]"]
  node_embedded[("Embedded Graph<br/>[store.py]")]
end

subgraph group_assistant["Assistant and Editing"]
  node_llm["LLM Service<br/>[llm.py]"]
  node_providers["Model Providers<br/>[base.py]"]
  node_query_tool["Codebase Questions<br/>[codebase_query.py]"]
  node_retrieval["Source Retrieval<br/>[code_retrieval.py]"]
  node_editor["Code Editing<br/>[patcher.py]"]
end

subgraph group_analysis["Analysis and Tracing"]
  node_dead_code["Dead Code<br/>[dead_code.py]"]
  node_structural["AST Search"]
  node_trace["Trace Ingestion<br/>[ingest.py]"]
end

subgraph group_interfaces["Interfaces"]
  node_cli["CLI Runtime<br/>[cli.py]"]
  node_config["Configuration<br/>[config.py]"]
  node_mcp["MCP Server<br/>[server.py]"]
end

node_user(("Engineer"))

node_user -->|"starts workflow"| node_cli
node_cli -->|"loads settings"| node_config
node_cli -->|"indexes repository"| node_parser
node_parser -->|"uses language rules"| node_language
node_parser -->|"ingests graph"| node_graph_service
node_parser -.->|"extracts routes"| node_endpoints
node_parser -.->|"discovers Go builds"| node_go_builds
node_parser -->|"processes imports"| node_imports
node_parser -.->|"creates parameters"| node_parameters
node_parser -.->|"records type facts"| node_type_facts
node_graph_service -->|"uses graph types"| node_schema
node_graph_service -->|"runs Cypher"| node_queries
node_graph_service -->|"accesses store"| node_embedded
node_cli -->|"answers questions"| node_query_tool
node_query_tool -->|"generates queries"| node_llm
node_query_tool -->|"fetches graph results"| node_graph_service
node_llm -->|"uses provider"| node_providers
node_query_tool -.->|"retrieves source"| node_retrieval
node_cli -->|"edits code"| node_editor
node_cli -->|"finds dead code"| node_dead_code
node_cli -->|"searches AST"| node_structural
node_cli -->|"ingests traces"| node_trace
node_trace -->|"merges observations"| node_graph_service
node_user -->|"connects tools"| node_mcp

click node_cli "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/cli.py"
click node_config "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/config.py"
click node_parser "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/function_ingest.py"
click node_language "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/language_spec.py"
click node_endpoints "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/endpoint_routes.py"
click node_go_builds "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/go/builds.py"
click node_imports "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/import_processor.py"
click node_parameters "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/parameter_nodes.py"
click node_type_facts "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/type_facts.py"
click node_schema "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/types_defs.py"
click node_queries "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/cypher_queries.py"
click node_graph_service "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/services/graph_service.py"
click node_embedded "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/embedded_graph/store.py"
click node_llm "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/services/llm.py"
click node_providers "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/providers/base.py"
click node_query_tool "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/codebase_query.py"
click node_retrieval "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/code_retrieval.py"
click node_editor "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/editing/patcher.py"
click node_dead_code "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/dead_code.py"
click node_structural "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/ast_grep_service.py"
click node_trace "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/trace/ingest.py"
click node_mcp "https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/mcp/server.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_parser,node_language,node_endpoints,node_go_builds,node_imports,node_parameters,node_type_facts toneBlue
class node_schema,node_queries,node_graph_service,node_embedded toneAmber
class node_llm,node_providers,node_query_tool,node_retrieval,node_editor toneMint
class node_dead_code,node_structural,node_trace toneRose
class node_cli,node_config,node_mcp,node_user toneIndigo
```

## Components

### Indexing

- [Language Parsing](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/function_ingest.py): `codebase_rag/parsers/function_ingest.py`
- [Language Specs](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/language_spec.py): `codebase_rag/language_spec.py`
- [Route Extraction](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/endpoint_routes.py): `codebase_rag/parsers/endpoint_routes.py`
- [Go Build Discovery](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/go/builds.py): `codebase_rag/parsers/go/builds.py`
- [Import Analysis](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/import_processor.py): `codebase_rag/parsers/import_processor.py`
- [Parameter Nodes](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/parameter_nodes.py): `codebase_rag/parsers/parameter_nodes.py`
- [Type Facts](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/parsers/type_facts.py): `codebase_rag/parsers/type_facts.py`

### Graph Storage

- [Graph Schema](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/types_defs.py): `codebase_rag/types_defs.py`
- [Cypher Queries](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/cypher_queries.py): `codebase_rag/cypher_queries.py`
- [Graph Service](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/services/graph_service.py): `codebase_rag/services/graph_service.py`
- [Embedded Graph](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/embedded_graph/store.py): `codebase_rag/embedded_graph/store.py`

### Assistant and Editing

- [LLM Service](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/services/llm.py): `codebase_rag/services/llm.py`
- [Model Providers](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/providers/base.py): `codebase_rag/providers/base.py`
- [Codebase Questions](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/codebase_query.py): `codebase_rag/tools/codebase_query.py`
- [Source Retrieval](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/code_retrieval.py): `codebase_rag/tools/code_retrieval.py`
- [Code Editing](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/editing/patcher.py): `codebase_rag/editing/patcher.py`

### Analysis and Tracing

- [Dead Code](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/dead_code.py): `codebase_rag/dead_code.py`
- [AST Search](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/tools/ast_grep_service.py): `codebase_rag/tools/ast_grep_service.py`
- [Trace Ingestion](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/trace/ingest.py): `codebase_rag/trace/ingest.py`

### Interfaces

- [CLI Runtime](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/cli.py): `codebase_rag/cli.py`
- [Configuration](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/config.py): `codebase_rag/config.py`
- [MCP Server](https://github.com/sinaigross/code-graph-rag-for-cv/blob/main/codebase_rag/mcp/server.py): `codebase_rag/mcp/server.py`

### Other components

- **Engineer**

## Connections

- Engineer → CLI Runtime: starts workflow (evidence: `README.md`)
- CLI Runtime → Configuration: loads settings
- CLI Runtime → Language Parsing: indexes repository (evidence: `README.md`)
- Language Parsing → Language Specs: uses language rules (evidence: `codebase_rag/parsers/function_ingest.py`)
- Language Parsing → Graph Service: ingests graph (evidence: `README.md`)
- Language Parsing → Route Extraction: extracts routes
- Language Parsing → Go Build Discovery: discovers Go builds (evidence: `codebase_rag/parsers/function_ingest.py`)
- Language Parsing → Import Analysis: processes imports (evidence: `codebase_rag/parsers/function_ingest.py`)
- Language Parsing → Parameter Nodes: creates parameters (evidence: `codebase_rag/parsers/function_ingest.py`)
- Language Parsing → Type Facts: records type facts (evidence: `codebase_rag/parsers/function_ingest.py`)
- Graph Service → Graph Schema: uses graph types (evidence: `codebase_rag/services/graph_service.py`)
- Graph Service → Cypher Queries: runs Cypher (evidence: `codebase_rag/services/graph_service.py`)
- Graph Service → Embedded Graph: accesses store (evidence: `codebase_rag/services/graph_service.py`)
- CLI Runtime → Codebase Questions: answers questions (evidence: `README.md`)
- Codebase Questions → LLM Service: generates queries (evidence: `codebase_rag/tools/codebase_query.py`)
- Codebase Questions → Graph Service: fetches graph results (evidence: `codebase_rag/tools/codebase_query.py`)
- LLM Service → Model Providers: uses provider (evidence: `codebase_rag/services/llm.py`)
- Codebase Questions → Source Retrieval: retrieves source
- CLI Runtime → Code Editing: edits code (evidence: `README.md`)
- CLI Runtime → Dead Code: finds dead code (evidence: `README.md`)
- CLI Runtime → AST Search: searches AST (evidence: `README.md`)
- CLI Runtime → Trace Ingestion: ingests traces (evidence: `README.md`)
- Trace Ingestion → Graph Service: merges observations (evidence: `codebase_rag/trace/ingest.py`)
- Engineer → MCP Server: connects tools (evidence: `README.md`)
