# vmikhailov/code-explorer architecture

> Architecture diagram of the GitHub repository vmikhailov/code-explorer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vmikhailov/code-explorer
- Repository: https://github.com/vmikhailov/code-explorer

## Overview

CodeExplorer builds a polyglot codebase knowledge graph, then exposes it through CLI queries, MCP, diagram export, and an interactive VS Code architecture explorer. The principal workflow is repository ingestion → layered parsing and semantic enrichment → embedded graph persistence → architecture/query access → visual or agent-facing results. README-backed capabilities include local intent inference, test-impact intelligence, and diagram generation. Some parser wiring and UI transport details were not sampled, so uncertain connections are omitted or marked dashed.

Main entry points: [`cli/src/Core/CodeExplorer.Core/Database/SqliteGraphClient.cs`](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Database/SqliteGraphClient.cs) (SQLite graph), [`cli/src/Core/CodeExplorer.Core/Parser/WorkspaceIndexer.cs`](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Parser/WorkspaceIndexer.cs) (Workspace indexer), [`cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs`](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs) (CLI query), [`vscode-extension/src/webview/App.tsx`](https://github.com/vmikhailov/code-explorer/blob/main/vscode-extension/src/webview/App.tsx) (VS Code explorer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Indexing and analysis"]
  node_workspace_indexer["Workspace indexer"]
  node_layer_parsers["Layered parsers<br/>[Layers]"]
  node_language_parsers["Language parsers"]
  node_semantic_extensions["Semantic extensions"]
end

subgraph group_graph["Graph and query"]
  node_graph_store[("SQLite graph")]
  node_cypher_compiler["Cypher compiler<br/>[SqliteCompiler.cs]"]
  node_query_manager["Project queries"]
end

subgraph group_interfaces["Developer interfaces"]
  node_cli_ingest["CLI ingest"]
  node_cli_query["CLI query"]
  node_mcp["MCP server<br/>[Mcp]"]
  node_diagram_export["Diagram export<br/>[DiagramExporter.cs]"]
  node_vscode_app["VS Code explorer<br/>[App.tsx]"]
  node_domain_view["Domain architecture view"]
end

subgraph group_insight["Architecture insights"]
  node_intent_analysis["Intent inference"]
  node_test_intelligence["Test intelligence"]
  node_architecture_engine["Architecture views"]
  node_query_service["Architecture queries"]
  node_embedded_model["Local model"]
end

node_developer(("Developer"))
node_ai_agent(("AI agent"))

node_developer -->|"starts indexing"| node_cli_ingest
node_cli_ingest -->|"invokes"| node_workspace_indexer
node_workspace_indexer -.->|"parses layers"| node_layer_parsers
node_layer_parsers -.->|"uses language parsers"| node_language_parsers
node_language_parsers -.->|"enriches semantics"| node_semantic_extensions
node_workspace_indexer -->|"persists graph"| node_graph_store
node_graph_store -->|"uses compiler"| node_cypher_compiler
node_developer -->|"submits query"| node_cli_query
node_cli_query -->|"loads custom queries"| node_query_manager
node_cli_query -->|"executes query"| node_graph_store
node_query_service -->|"queries graph"| node_graph_store
node_query_service -->|"builds architecture views"| node_architecture_engine
node_developer -->|"explores architecture"| node_vscode_app
node_vscode_app -->|"renders domain view"| node_domain_view
node_vscode_app -.->|"requests graph data"| node_architecture_engine
node_ai_agent -->|"requests graph insight"| node_mcp
node_mcp -.->|"queries graph"| node_graph_store
node_developer -->|"exports diagrams"| node_diagram_export
node_workspace_indexer -.->|"enables intent analysis"| node_intent_analysis
node_intent_analysis -.->|"infers intent"| node_embedded_model
node_developer -.->|"requests test impact"| node_test_intelligence
node_test_intelligence -.->|"reads graph"| node_graph_store

click node_cli_ingest "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/UI/CodeExplorer/Commands/IngestCommandHandler.cs"
click node_workspace_indexer "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Parser/WorkspaceIndexer.cs"
click node_layer_parsers "https://github.com/vmikhailov/code-explorer/tree/main/cli/src/Core/CodeExplorer.Core/Parser/Layers"
click node_language_parsers "https://github.com/vmikhailov/code-explorer/tree/main/cli/src/Parsers"
click node_semantic_extensions "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Parser/ISemanticExtension.cs"
click node_intent_analysis "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/CodeIntentAnalyzer.cs"
click node_test_intelligence "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/Testing/TestIntelligenceService.cs"
click node_graph_store "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Database/SqliteGraphClient.cs"
click node_cypher_compiler "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Cypher/CodeExplorer.Cypher/Compiler/SqliteCompiler.cs"
click node_query_manager "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Mcp/ProjectQueryManager.cs"
click node_architecture_engine "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureViewEngine.cs"
click node_query_service "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureQueryService.cs"
click node_cli_query "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs"
click node_mcp "https://github.com/vmikhailov/code-explorer/tree/main/cli/src/Core/CodeExplorer.Core/Mcp"
click node_diagram_export "https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Diagrams/DiagramExporter.cs"
click node_vscode_app "https://github.com/vmikhailov/code-explorer/blob/main/vscode-extension/src/webview/App.tsx"
click node_domain_view "https://github.com/vmikhailov/code-explorer/blob/main/vscode-extension/src/webview/components/DomainArchitectureView.tsx"

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_workspace_indexer,node_layer_parsers,node_language_parsers,node_semantic_extensions toneBlue
class node_graph_store,node_cypher_compiler,node_query_manager toneAmber
class node_cli_ingest,node_cli_query,node_mcp,node_diagram_export,node_vscode_app,node_domain_view toneMint
class node_intent_analysis,node_test_intelligence,node_architecture_engine,node_query_service,node_embedded_model toneRose
class node_developer,node_ai_agent toneIndigo
```

## Components

### Indexing and analysis

- [Workspace indexer](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Parser/WorkspaceIndexer.cs): `cli/src/Core/CodeExplorer.Core/Parser/WorkspaceIndexer.cs`
- [Layered parsers](https://github.com/vmikhailov/code-explorer/tree/main/cli/src/Core/CodeExplorer.Core/Parser/Layers): `cli/src/Core/CodeExplorer.Core/Parser/Layers`
- [Language parsers](https://github.com/vmikhailov/code-explorer/tree/main/cli/src/Parsers): `cli/src/Parsers`
- [Semantic extensions](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Parser/ISemanticExtension.cs): `cli/src/Core/CodeExplorer.Core/Parser/ISemanticExtension.cs`

### Graph and query

- [SQLite graph](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Database/SqliteGraphClient.cs): `cli/src/Core/CodeExplorer.Core/Database/SqliteGraphClient.cs`
- [Cypher compiler](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Cypher/CodeExplorer.Cypher/Compiler/SqliteCompiler.cs): `cli/src/Cypher/CodeExplorer.Cypher/Compiler/SqliteCompiler.cs`
- [Project queries](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Mcp/ProjectQueryManager.cs): `cli/src/Core/CodeExplorer.Core/Mcp/ProjectQueryManager.cs`

### Developer interfaces

- [CLI ingest](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/UI/CodeExplorer/Commands/IngestCommandHandler.cs): `cli/src/UI/CodeExplorer/Commands/IngestCommandHandler.cs`
- [CLI query](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs): `cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs`
- [MCP server](https://github.com/vmikhailov/code-explorer/tree/main/cli/src/Core/CodeExplorer.Core/Mcp): `cli/src/Core/CodeExplorer.Core/Mcp`
- [Diagram export](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Diagrams/DiagramExporter.cs): `cli/src/Core/CodeExplorer.Core/Diagrams/DiagramExporter.cs`
- [VS Code explorer](https://github.com/vmikhailov/code-explorer/blob/main/vscode-extension/src/webview/App.tsx): `vscode-extension/src/webview/App.tsx`
- [Domain architecture view](https://github.com/vmikhailov/code-explorer/blob/main/vscode-extension/src/webview/components/DomainArchitectureView.tsx): `vscode-extension/src/webview/components/DomainArchitectureView.tsx`

### Architecture insights

- [Intent inference](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/CodeIntentAnalyzer.cs): `cli/src/Core/CodeExplorer.Core/Analysis/CodeIntentAnalyzer.cs`
- [Test intelligence](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/Testing/TestIntelligenceService.cs): `cli/src/Core/CodeExplorer.Core/Analysis/Testing/TestIntelligenceService.cs`
- [Architecture views](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureViewEngine.cs): `cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureViewEngine.cs`
- [Architecture queries](https://github.com/vmikhailov/code-explorer/blob/main/cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureQueryService.cs): `cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureQueryService.cs`
- **Local model**

### Other components

- **Developer**
- **AI agent**

## Connections

- Developer → CLI ingest: starts indexing
- CLI ingest → Workspace indexer: invokes (evidence: `cli/src/UI/CodeExplorer/Commands/IngestCommandHandler.cs`)
- Workspace indexer → Layered parsers: parses layers (evidence: `cli/src/Core/CodeExplorer.Core/Parser/WorkspaceIndexer.cs`)
- Layered parsers → Language parsers: uses language parsers
- Language parsers → Semantic extensions: enriches semantics (evidence: `cli/src/Parsers/CodeExplorer.Parser.CSharp/Libraries/HttpClientLibraryParser.cs`)
- Workspace indexer → SQLite graph: persists graph (evidence: `cli/src/UI/CodeExplorer/Commands/IngestCommandHandler.cs`)
- SQLite graph → Cypher compiler: uses compiler (evidence: `cli/src/Core/CodeExplorer.Core/Database/SqliteGraphClient.cs`)
- Developer → CLI query: submits query
- CLI query → Project queries: loads custom queries (evidence: `cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs`)
- CLI query → SQLite graph: executes query (evidence: `cli/src/UI/CodeExplorer/Commands/QueryCommandHandler.cs`)
- Architecture queries → SQLite graph: queries graph (evidence: `cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureQueryService.cs`)
- Architecture queries → Architecture views: builds architecture views (evidence: `cli/src/Core/CodeExplorer.Core/Analysis/ArchitectureQueryService.cs`)
- Developer → VS Code explorer: explores architecture
- VS Code explorer → Domain architecture view: renders domain view (evidence: `vscode-extension/src/webview/App.tsx`)
- VS Code explorer → Architecture views: requests graph data
- AI agent → MCP server: requests graph insight
- MCP server → SQLite graph: queries graph
- Developer → Diagram export: exports diagrams
- Workspace indexer → Intent inference: enables intent analysis
- Intent inference → Local model: infers intent
- Developer → Test intelligence: requests test impact
- Test intelligence → SQLite graph: reads graph
