# daltskin/sysml-v2-lsp architecture

> Architecture diagram of the GitHub repository daltskin/sysml-v2-lsp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/daltskin/sysml-v2-lsp
- Repository: https://github.com/daltskin/sysml-v2-lsp

## Overview

SysML v2 Language Server parses editor documents, builds workspace symbols, and serves LSP features to VS Code, web, and Python clients. The principal flow is client requests → server/document lifecycle → parsing and symbol indexing → language features or model results. Separate branches cover standard-library resolution, semantic validation, complexity analysis, Mermaid diagrams, and MCP tools. README documents these capabilities; some implementation connections are not shown in the excerpts, so those links are omitted or marked unverified.

Main entry points: [`server/src/server.ts`](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/server.ts) (LSP Server), [`server/src/providers/semanticValidator.ts`](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/providers/semanticValidator.ts) (Semantic Validation), [`server/src/model/sysmlModelProvider.ts`](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/sysmlModelProvider.ts) (Model Provider), [`server/src/symbols/symbolTable.ts`](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/symbolTable.ts) (Symbol Table)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Clients"]
  node_vscode["VS Code<br/>[extension.ts]"]
  node_web["Web Client<br/>[server.mjs]"]
  node_python["Python Client"]
end

subgraph group_runtime["Server Runtime"]
  node_lsp["LSP Server<br/>[server.ts]"]
  node_documents["Document Manager<br/>[documentManager.ts]"]
end

subgraph group_language["Language Model"]
  node_parser["SysML Parser<br/>[parseDocument.ts]"]
  node_dfa["DFA Loader<br/>[dfaLoader.ts]"]
  node_dfa_snapshot["DFA Snapshot<br/>[dfaSnapshot.ts]"]
  node_symbols["Symbol Table<br/>[symbolTable.ts]"]
  node_element_registry["Element Registry<br/>[elementRegistry.ts]"]
  node_namespace["Namespace Resolver"]
  node_sysml_elements["SysML Elements<br/>[sysmlElements.ts]"]
  node_library[("Library Index<br/>[libraryIndex.ts]")]
end

subgraph group_features["Language Features"]
  node_lsp_features["Editor Providers"]
  node_semantic_validation["Semantic Validation"]
  node_text_validation["Text Validation"]
  node_model_provider["Model Provider"]
  node_model_types["Model DTOs<br/>[sysmlModelTypes.ts]"]
  node_element_lookup["Element Lookup"]
end

subgraph group_analysis["Analysis and Tools"]
  node_complexity["Complexity Analysis"]
  node_mermaid["Mermaid Generator"]
  node_mcp["MCP Tools<br/>[mcpCore.ts]"]
end

node_vscode -->|"sends LSP"| node_lsp
node_web -->|"bridges LSP"| node_lsp
node_python -->|"sends LSP"| node_lsp
node_lsp -->|"manages documents"| node_documents
node_documents -->|"parses text"| node_parser
node_parser -->|"uses DFA"| node_dfa
node_dfa -->|"loads snapshot"| node_dfa_snapshot
node_symbols -->|"reads parse tree"| node_parser
node_symbols -->|"updates registry"| node_element_registry
node_namespace -->|"resolves elements"| node_element_registry
node_lsp -->|"registers providers"| node_lsp_features
node_lsp -->|"registers provider"| node_semantic_validation
node_lsp -->|"configures provider"| node_text_validation
node_lsp -->|"serves model requests"| node_model_provider
node_model_provider -->|"reuses parse cache"| node_documents
node_model_provider -->|"produces DTOs"| node_model_types
node_lsp -->|"registers lookup"| node_element_lookup
node_semantic_validation -->|"resolves library types"| node_library
node_semantic_validation -->|"resolves names"| node_namespace
node_semantic_validation -->|"checks symbols"| node_symbols
node_model_provider -->|"uses analysis"| node_complexity
node_mcp -.->|"may generate diagrams"| node_mermaid

click node_vscode "https://github.com/daltskin/sysml-v2-lsp/blob/main/clients/vscode/src/extension.ts"
click node_web "https://github.com/daltskin/sysml-v2-lsp/blob/main/clients/web/server.mjs"
click node_python "https://github.com/daltskin/sysml-v2-lsp/blob/main/clients/python/sysml_lsp_client.py"
click node_lsp "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/server.ts"
click node_documents "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/documentManager.ts"
click node_parser "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/parser/parseDocument.ts"
click node_dfa "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/parser/dfaLoader.ts"
click node_dfa_snapshot "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/parser/dfaSnapshot.ts"
click node_symbols "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/symbolTable.ts"
click node_element_registry "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/elementRegistry.ts"
click node_namespace "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/namespaceResolver.ts"
click node_sysml_elements "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/sysmlElements.ts"
click node_library "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/library/libraryIndex.ts"
click node_lsp_features "https://github.com/daltskin/sysml-v2-lsp/tree/main/server/src/providers"
click node_semantic_validation "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/providers/semanticValidator.ts"
click node_text_validation "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/providers/textValidationProvider.ts"
click node_model_provider "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/sysmlModelProvider.ts"
click node_model_types "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/sysmlModelTypes.ts"
click node_element_lookup "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/elementLookupProvider.ts"
click node_complexity "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/analysis/complexityAnalyzer.ts"
click node_mermaid "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/mcp/mermaidGenerator.ts"
click node_mcp "https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/mcpCore.ts"

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_vscode,node_web,node_python toneBlue
class node_lsp,node_documents toneAmber
class node_parser,node_dfa,node_dfa_snapshot,node_symbols,node_element_registry,node_namespace,node_sysml_elements,node_library toneMint
class node_lsp_features,node_semantic_validation,node_text_validation,node_model_provider,node_model_types,node_element_lookup toneRose
class node_complexity,node_mermaid,node_mcp toneIndigo
```

## Components

### Clients

- [VS Code](https://github.com/daltskin/sysml-v2-lsp/blob/main/clients/vscode/src/extension.ts): `clients/vscode/src/extension.ts`
- [Web Client](https://github.com/daltskin/sysml-v2-lsp/blob/main/clients/web/server.mjs): `clients/web/server.mjs`
- [Python Client](https://github.com/daltskin/sysml-v2-lsp/blob/main/clients/python/sysml_lsp_client.py): `clients/python/sysml_lsp_client.py`

### Server Runtime

- [LSP Server](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/server.ts): `server/src/server.ts`
- [Document Manager](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/documentManager.ts): `server/src/documentManager.ts`

### Language Model

- [SysML Parser](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/parser/parseDocument.ts): `server/src/parser/parseDocument.ts`
- [DFA Loader](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/parser/dfaLoader.ts): `server/src/parser/dfaLoader.ts`
- [DFA Snapshot](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/parser/dfaSnapshot.ts): `server/src/parser/dfaSnapshot.ts`
- [Symbol Table](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/symbolTable.ts): `server/src/symbols/symbolTable.ts`
- [Element Registry](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/elementRegistry.ts): `server/src/symbols/elementRegistry.ts`
- [Namespace Resolver](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/namespaceResolver.ts): `server/src/symbols/namespaceResolver.ts`
- [SysML Elements](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/symbols/sysmlElements.ts): `server/src/symbols/sysmlElements.ts`
- [Library Index](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/library/libraryIndex.ts): `server/src/library/libraryIndex.ts`

### Language Features

- [Editor Providers](https://github.com/daltskin/sysml-v2-lsp/tree/main/server/src/providers): `server/src/providers`
- [Semantic Validation](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/providers/semanticValidator.ts): `server/src/providers/semanticValidator.ts`
- [Text Validation](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/providers/textValidationProvider.ts): `server/src/providers/textValidationProvider.ts`
- [Model Provider](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/sysmlModelProvider.ts): `server/src/model/sysmlModelProvider.ts`
- [Model DTOs](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/sysmlModelTypes.ts): `server/src/model/sysmlModelTypes.ts`
- [Element Lookup](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/model/elementLookupProvider.ts): `server/src/model/elementLookupProvider.ts`

### Analysis and Tools

- [Complexity Analysis](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/analysis/complexityAnalyzer.ts): `server/src/analysis/complexityAnalyzer.ts`
- [Mermaid Generator](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/mcp/mermaidGenerator.ts): `server/src/mcp/mermaidGenerator.ts`
- [MCP Tools](https://github.com/daltskin/sysml-v2-lsp/blob/main/server/src/mcpCore.ts): `server/src/mcpCore.ts`

## Connections

- VS Code → LSP Server: sends LSP
- Web Client → LSP Server: bridges LSP
- Python Client → LSP Server: sends LSP
- LSP Server → Document Manager: manages documents (evidence: `server/src/server.ts`)
- Document Manager → SysML Parser: parses text (evidence: `server/src/documentManager.ts`)
- SysML Parser → DFA Loader: uses DFA (evidence: `server/src/parser/parseDocument.ts`)
- DFA Loader → DFA Snapshot: loads snapshot (evidence: `server/src/parser/dfaLoader.ts`)
- Symbol Table → SysML Parser: reads parse tree (evidence: `server/src/symbols/symbolTable.ts`)
- Symbol Table → Element Registry: updates registry (evidence: `server/src/symbols/symbolTable.ts`)
- Namespace Resolver → Element Registry: resolves elements (evidence: `server/src/symbols/namespaceResolver.ts`)
- LSP Server → Editor Providers: registers providers (evidence: `server/src/server.ts`)
- LSP Server → Semantic Validation: registers provider (evidence: `server/src/server.ts`)
- LSP Server → Text Validation: configures provider (evidence: `server/src/server.ts`)
- LSP Server → Model Provider: serves model requests (evidence: `server/src/server.ts`)
- Model Provider → Document Manager: reuses parse cache (evidence: `server/src/model/sysmlModelProvider.ts`)
- Model Provider → Model DTOs: produces DTOs (evidence: `server/src/model/sysmlModelProvider.ts`)
- LSP Server → Element Lookup: registers lookup (evidence: `server/src/server.ts`)
- Semantic Validation → Library Index: resolves library types (evidence: `server/src/providers/semanticValidator.ts`)
- Semantic Validation → Namespace Resolver: resolves names (evidence: `server/src/providers/semanticValidator.ts`)
- Semantic Validation → Symbol Table: checks symbols (evidence: `server/src/providers/semanticValidator.ts`)
- Model Provider → Complexity Analysis: uses analysis (evidence: `server/src/model/sysmlModelProvider.ts`)
- MCP Tools → Mermaid Generator: may generate diagrams
