# daltskin/vscode_sysml_extension architecture

> Architecture diagram of the GitHub repository daltskin/vscode_sysml_extension, 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/vscode_sysml_extension
- Repository: https://github.com/daltskin/vscode_sysml_extension

## Overview

This is a VS Code extension for SysML v2. The principal workflow is opening workspace models, parsing them through the language server, obtaining model data, and presenting it in explorers, dashboards, and interactive diagrams; users can also edit models and preview diagrams embedded in Markdown. The graph includes documented language-service features and optional MCP support, though the sampled evidence does not expose MCP implementation. Relationships are limited to README statements and source-index references or excerpts; unsampled subsystems are shown without guessed call paths.

Main entry points: [`src/providers/lspModelProvider.ts`](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/lspModelProvider.ts) (Model data provider), [`src/visualization/visualizationPanel.ts`](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/visualizationPanel.ts) (Diagram visualizer), [`src/markdown/markdownPreview.ts`](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/markdownPreview.ts) (Markdown preview), [`src/parseOrchestrator.ts`](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/parseOrchestrator.ts) (Parse orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_language["Language Services"]
  node_lspclient["LSP client<br/>[client.ts]"]
  node_server["SysML language server"]
  node_parse["Parse orchestration"]
end

subgraph group_model["Model Exploration"]
  node_modelprovider["Model data provider"]
  node_modeltypes["Model DTOs<br/>[sysmlModelTypes.ts]"]
  node_modelnames["Model naming<br/>[modelNames.ts]"]
  node_modelexplorer["Model Explorer"]
  node_featureexplorer["Feature Explorer"]
  node_featureinspector["Feature Inspector"]
  node_dashboard["Model dashboard"]
  node_architecture["Architecture explorer"]
  node_architecturepanel["Architecture panel"]
end

subgraph group_visual["Visualization"]
  node_visualpanel["Diagram visualizer"]
  node_snapshot["Model snapshots<br/>[modelSnapshot.ts]"]
  node_viewscope["Diagram view scope<br/>[viewScope.ts]"]
  node_diagramshell["Diagram renderer<br/>[diagramShell.ts]"]
  node_markdown["Markdown preview<br/>[markdownPreview.ts]"]
  node_fence["Diagram fence parser<br/>[fenceParser.ts]"]
  node_cache[("Diagram cache<br/>[diagramCache.ts]")]
  node_export["Diagram export<br/>[exportDiagrams.ts]"]
  node_plugin["Markdown diagram plugin"]
end

subgraph group_editing["Editing and Feedback"]
  node_editing["Model editing operations<br/>[modelEdits.ts]"]
  node_workbenchmodel["Workbench model<br/>[workbenchModel.ts]"]
  node_workbenchpanel["Model workbench"]
end

subgraph group_platform["Extension Platform"]
  node_extension["Extension activation<br/>[extension.ts]"]
  node_status["Status bar<br/>[statusBar.ts]"]
  node_limits["Resource safeguards<br/>[resourceLimits.ts]"]
  node_telemetry["Telemetry service"]
  node_mcp["MCP integration"]
end

node_user(("SysML user"))

node_user -->|"opens workspace"| node_extension
node_extension -->|"starts"| node_lspclient
node_extension -->|"orchestrates parsing"| node_parse
node_lspclient -->|"connects to"| node_server
node_parse -->|"updates progress"| node_status
node_parse -->|"loads models"| node_modelexplorer
node_modelprovider -->|"requests parsed model"| node_server
node_modelprovider -->|"returns DTOs"| node_modeltypes
node_modelexplorer -->|"loads model data"| node_modelprovider
node_modelexplorer -->|"uses display names"| node_modelnames
node_featureexplorer -->|"reads model data"| node_modelprovider
node_featureinspector -->|"reads model data"| node_modelprovider
node_dashboard -->|"reads model data"| node_modelprovider
node_architecturepanel -->|"uses graph"| node_architecture
node_architecturepanel -->|"reads model data"| node_modelprovider
node_visualpanel -->|"fetches models"| node_modelprovider
node_visualpanel -->|"converts elements"| node_snapshot
node_visualpanel -->|"renders diagrams"| node_diagramshell
node_visualpanel -.->|"scopes diagrams"| node_viewscope
node_markdown -->|"parses fences"| node_fence
node_markdown -->|"caches models"| node_cache
node_markdown -->|"loads models"| node_modelprovider
node_markdown -->|"opens visualizer"| node_visualpanel
node_plugin -->|"uses cache"| node_cache
node_export -->|"uses renderer"| node_diagramshell
node_export -->|"uses snapshots"| node_snapshot
node_workbenchpanel -->|"uses model"| node_workbenchmodel
node_workbenchpanel -->|"applies edits"| node_editing
node_workbenchmodel -->|"uses edit operations"| node_editing
node_user -.->|"uses agent integration"| node_mcp

click node_extension "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/extension.ts"
click node_lspclient "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/lsp/client.ts"
click node_parse "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/parseOrchestrator.ts"
click node_modelprovider "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/lspModelProvider.ts"
click node_modeltypes "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/sysmlModelTypes.ts"
click node_modelnames "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/modelNames.ts"
click node_modelexplorer "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/explorer/modelExplorerProvider.ts"
click node_featureexplorer "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/explorer/featureExplorerProvider.ts"
click node_featureinspector "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/featureInspectorPanel.ts"
click node_dashboard "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/modelDashboardPanel.ts"
click node_architecture "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/architecture/architectureGraph.ts"
click node_architecturepanel "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/architectureExplorerPanel.ts"
click node_visualpanel "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/visualizationPanel.ts"
click node_snapshot "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/core/modelSnapshot.ts"
click node_viewscope "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/core/viewScope.ts"
click node_diagramshell "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/core/diagramShell.ts"
click node_markdown "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/markdownPreview.ts"
click node_fence "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/fenceParser.ts"
click node_cache "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/diagramCache.ts"
click node_export "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/exportDiagrams.ts"
click node_plugin "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/markdownItPlugin.ts"
click node_editing "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/modelEditing/modelEdits.ts"
click node_workbenchmodel "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/modelEditing/workbenchModel.ts"
click node_workbenchpanel "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/modelWorkbenchPanel.ts"
click node_status "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/statusBar.ts"
click node_limits "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/resourceLimits.ts"
click node_telemetry "https://github.com/daltskin/vscode_sysml_extension/blob/main/src/telemetry/telemetryService.ts"
click node_mcp "https://github.com/daltskin/vscode_sysml_extension/tree/main/src"

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_lspclient,node_server,node_parse,node_user toneBlue
class node_modelprovider,node_modeltypes,node_modelnames,node_modelexplorer,node_featureexplorer,node_featureinspector,node_dashboard,node_architecture,node_architecturepanel toneAmber
class node_visualpanel,node_snapshot,node_viewscope,node_diagramshell,node_markdown,node_fence,node_cache,node_export,node_plugin toneMint
class node_editing,node_workbenchmodel,node_workbenchpanel toneRose
class node_extension,node_status,node_limits,node_telemetry,node_mcp toneIndigo
```

## Components

### Language Services

- [LSP client](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/lsp/client.ts): `src/lsp/client.ts`
- **SysML language server**
- [Parse orchestration](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/parseOrchestrator.ts): `src/parseOrchestrator.ts`

### Model Exploration

- [Model data provider](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/lspModelProvider.ts): `src/providers/lspModelProvider.ts`
- [Model DTOs](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/sysmlModelTypes.ts): `src/providers/sysmlModelTypes.ts`
- [Model naming](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/providers/modelNames.ts): `src/providers/modelNames.ts`
- [Model Explorer](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/explorer/modelExplorerProvider.ts): `src/explorer/modelExplorerProvider.ts`
- [Feature Explorer](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/explorer/featureExplorerProvider.ts): `src/explorer/featureExplorerProvider.ts`
- [Feature Inspector](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/featureInspectorPanel.ts): `src/panels/featureInspectorPanel.ts`
- [Model dashboard](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/modelDashboardPanel.ts): `src/panels/modelDashboardPanel.ts`
- [Architecture explorer](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/architecture/architectureGraph.ts): `src/architecture/architectureGraph.ts`
- [Architecture panel](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/architectureExplorerPanel.ts): `src/panels/architectureExplorerPanel.ts`

### Visualization

- [Diagram visualizer](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/visualizationPanel.ts): `src/visualization/visualizationPanel.ts`
- [Model snapshots](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/core/modelSnapshot.ts): `src/visualization/core/modelSnapshot.ts`
- [Diagram view scope](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/core/viewScope.ts): `src/visualization/core/viewScope.ts`
- [Diagram renderer](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/visualization/core/diagramShell.ts): `src/visualization/core/diagramShell.ts`
- [Markdown preview](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/markdownPreview.ts): `src/markdown/markdownPreview.ts`
- [Diagram fence parser](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/fenceParser.ts): `src/markdown/fenceParser.ts`
- [Diagram cache](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/diagramCache.ts): `src/markdown/diagramCache.ts`
- [Diagram export](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/exportDiagrams.ts): `src/markdown/exportDiagrams.ts`
- [Markdown diagram plugin](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/markdown/markdownItPlugin.ts): `src/markdown/markdownItPlugin.ts`

### Editing and Feedback

- [Model editing operations](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/modelEditing/modelEdits.ts): `src/modelEditing/modelEdits.ts`
- [Workbench model](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/modelEditing/workbenchModel.ts): `src/modelEditing/workbenchModel.ts`
- [Model workbench](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/panels/modelWorkbenchPanel.ts): `src/panels/modelWorkbenchPanel.ts`

### Extension Platform

- [Extension activation](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/extension.ts): `src/extension.ts`
- [Status bar](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/statusBar.ts): `src/statusBar.ts`
- [Resource safeguards](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/resourceLimits.ts): `src/resourceLimits.ts`
- [Telemetry service](https://github.com/daltskin/vscode_sysml_extension/blob/main/src/telemetry/telemetryService.ts): `src/telemetry/telemetryService.ts`
- [MCP integration](https://github.com/daltskin/vscode_sysml_extension/tree/main/src): `src`

### Other components

- **SysML user**

## Connections

- SysML user → Extension activation: opens workspace (evidence: `README.md`)
- Extension activation → LSP client: starts (evidence: `src/extension.ts`)
- Extension activation → Parse orchestration: orchestrates parsing (evidence: `src/extension.ts`)
- LSP client → SysML language server: connects to (evidence: `src/lsp/client.ts`)
- Parse orchestration → Status bar: updates progress (evidence: `src/parseOrchestrator.ts`)
- Parse orchestration → Model Explorer: loads models (evidence: `src/parseOrchestrator.ts`)
- Model data provider → SysML language server: requests parsed model (evidence: `src/providers/lspModelProvider.ts`)
- Model data provider → Model DTOs: returns DTOs (evidence: `src/providers/lspModelProvider.ts`)
- Model Explorer → Model data provider: loads model data (evidence: `src/explorer/modelExplorerProvider.ts`)
- Model Explorer → Model naming: uses display names (evidence: `src/explorer/modelExplorerProvider.ts`)
- Feature Explorer → Model data provider: reads model data (evidence: `src/explorer/featureExplorerProvider.ts`)
- Feature Inspector → Model data provider: reads model data (evidence: `src/panels/featureInspectorPanel.ts`)
- Model dashboard → Model data provider: reads model data (evidence: `src/panels/modelDashboardPanel.ts`)
- Architecture panel → Architecture explorer: uses graph (evidence: `src/panels/architectureExplorerPanel.ts`)
- Architecture panel → Model data provider: reads model data (evidence: `src/panels/architectureExplorerPanel.ts`)
- Diagram visualizer → Model data provider: fetches models (evidence: `src/visualization/visualizationPanel.ts`)
- Diagram visualizer → Model snapshots: converts elements (evidence: `src/visualization/visualizationPanel.ts`)
- Diagram visualizer → Diagram renderer: renders diagrams (evidence: `src/visualization/visualizationPanel.ts`)
- Diagram visualizer → Diagram view scope: scopes diagrams
- Markdown preview → Diagram fence parser: parses fences (evidence: `src/markdown/markdownPreview.ts`)
- Markdown preview → Diagram cache: caches models (evidence: `src/markdown/markdownPreview.ts`)
- Markdown preview → Model data provider: loads models (evidence: `src/markdown/markdownPreview.ts`)
- Markdown preview → Diagram visualizer: opens visualizer (evidence: `src/markdown/markdownPreview.ts`)
- Markdown diagram plugin → Diagram cache: uses cache (evidence: `src/markdown/markdownItPlugin.ts`)
- Diagram export → Diagram renderer: uses renderer (evidence: `src/markdown/exportDiagrams.ts`)
- Diagram export → Model snapshots: uses snapshots (evidence: `src/markdown/exportDiagrams.ts`)
- Model workbench → Workbench model: uses model (evidence: `src/panels/modelWorkbenchPanel.ts`)
- Model workbench → Model editing operations: applies edits (evidence: `src/panels/modelWorkbenchPanel.ts`)
- Workbench model → Model editing operations: uses edit operations (evidence: `src/modelEditing/workbenchModel.ts`)
- SysML user → MCP integration: uses agent integration (evidence: `README.md`)
