# fwcd/kotlin-language-server architecture

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

- Interactive diagram: https://gitdiagram.com/fwcd/kotlin-language-server
- Repository: https://github.com/fwcd/kotlin-language-server

## Overview

This repository implements a Kotlin Language Server Protocol server. An editor sends document and workspace requests; the server maintains source files and compiler state, then returns language features such as completion, diagnostics, navigation, and symbols. The README documents the feature set and classpath discovery; the excerpts show document handling, compilation/indexing, and custom protocol extensions. Several feature implementations are present in the tree but were not sampled, so their nodes are included without speculative call edges.

Main entry points: [`server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt) (Document service), [`server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt`](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt) (Workspace service), [`server/src/main/kotlin/org/javacs/kt/SourcePath.kt`](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/SourcePath.kt) (Source compilation), [`server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt`](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt) (Classpath management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Server and LSP"]
  node_main["Server entry<br/>[Main.kt]"]
  node_lspserver["Language server"]
  node_document["Document service"]
  node_workspace_service["Workspace service"]
  node_extensions["Protocol extensions"]
end

subgraph group_workspace["Workspace and compilation"]
  node_config["Configuration<br/>[Configuration.kt]"]
  node_sourcefiles["Open source files<br/>[SourceFiles.kt]"]
  node_sourcepath["Source compilation<br/>[SourcePath.kt]"]
  node_compiled["Compiled file model<br/>[CompiledFile.kt]"]
  node_compiler["Kotlin compiler<br/>[Compiler.kt]"]
  node_index[("Symbol index<br/>[SymbolIndex.kt]")]
end

subgraph group_features["Language features"]
  node_completion["Completion<br/>[Completions.kt]"]
  node_diagnostics["Diagnostics"]
  node_navigation["Navigation and references<br/>[GoToDefinition.kt]"]
  node_symbols["Document and workspace symbols<br/>[Symbols.kt]"]
  node_codeactions["Code actions<br/>[CodeAction.kt]"]
  node_formatting["Formatting"]
  node_otherfeatures["Other language features"]
end

subgraph group_project["Project dependencies"]
  node_classpath["Classpath management"]
  node_resolver["Classpath resolvers"]
  node_database[("Persistent database<br/>[DatabaseService.kt]")]
end

node_editor(("LSP editor"))
node_external["Maven or Gradle projects"]

node_editor -->|"starts server"| node_main
node_main -->|"starts"| node_lspserver
node_editor -->|"sends document requests"| node_document
node_editor -->|"sends workspace requests"| node_workspace_service
node_document -->|"opens documents"| node_sourcefiles
node_document -->|"recovers compiled files"| node_sourcepath
node_document -->|"requests completions"| node_completion
node_document -->|"requests actions"| node_codeactions
node_document -->|"formats documents"| node_formatting
node_document -->|"publishes diagnostics"| node_diagnostics
node_workspace_service -->|"updates settings"| node_config
node_workspace_service -->|"changes workspace roots"| node_sourcefiles
node_workspace_service -->|"refreshes project paths"| node_classpath
node_extensions -->|"compiles requested file"| node_sourcepath
node_extensions -->|"reads build output"| node_classpath
node_sourcepath -->|"compiles sources"| node_compiler
node_sourcepath -->|"creates compiled state"| node_compiled
node_sourcepath -->|"updates declarations"| node_index
node_compiled -->|"recompiles expressions"| node_compiler
node_completion -->|"queries symbols"| node_index
node_codeactions -->|"queries symbols"| node_index
node_workspace_service -->|"serves workspace symbols"| node_symbols
node_classpath -->|"resolves dependencies"| node_resolver
node_resolver -->|"invokes build tools"| node_external
node_classpath -->|"initializes storage"| node_database
node_classpath -->|"configures compiler"| node_compiler

click node_main "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/Main.kt"
click node_lspserver "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinLanguageServer.kt"
click node_document "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt"
click node_workspace_service "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt"
click node_extensions "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinProtocolExtensionService.kt"
click node_config "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/Configuration.kt"
click node_sourcefiles "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/SourceFiles.kt"
click node_sourcepath "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/SourcePath.kt"
click node_compiled "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/CompiledFile.kt"
click node_compiler "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/compiler/Compiler.kt"
click node_index "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/index/SymbolIndex.kt"
click node_completion "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/completion/Completions.kt"
click node_diagnostics "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/diagnostic/ConvertDiagnostic.kt"
click node_navigation "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/definition/GoToDefinition.kt"
click node_symbols "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/symbols/Symbols.kt"
click node_codeactions "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/codeaction/CodeAction.kt"
click node_formatting "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/formatting/FormattingService.kt"
click node_otherfeatures "https://github.com/fwcd/kotlin-language-server/tree/main/server/src/main/kotlin/org/javacs/kt"
click node_classpath "https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt"
click node_resolver "https://github.com/fwcd/kotlin-language-server/tree/main/shared/src/main/kotlin/org/javacs/kt/classpath"
click node_database "https://github.com/fwcd/kotlin-language-server/blob/main/shared/src/main/kotlin/org/javacs/kt/database/DatabaseService.kt"

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_main,node_lspserver,node_document,node_workspace_service,node_extensions toneBlue
class node_config,node_sourcefiles,node_sourcepath,node_compiled,node_compiler,node_index toneAmber
class node_completion,node_diagnostics,node_navigation,node_symbols,node_codeactions,node_formatting,node_otherfeatures toneMint
class node_classpath,node_resolver,node_database toneRose
class node_editor,node_external toneIndigo
```

## Components

### Server and LSP

- [Server entry](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/Main.kt): `server/src/main/kotlin/org/javacs/kt/Main.kt`
- [Language server](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinLanguageServer.kt): `server/src/main/kotlin/org/javacs/kt/KotlinLanguageServer.kt`
- [Document service](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt): `server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`
- [Workspace service](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt): `server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt`
- [Protocol extensions](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/KotlinProtocolExtensionService.kt): `server/src/main/kotlin/org/javacs/kt/KotlinProtocolExtensionService.kt`

### Workspace and compilation

- [Configuration](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/Configuration.kt): `server/src/main/kotlin/org/javacs/kt/Configuration.kt`
- [Open source files](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/SourceFiles.kt): `server/src/main/kotlin/org/javacs/kt/SourceFiles.kt`
- [Source compilation](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/SourcePath.kt): `server/src/main/kotlin/org/javacs/kt/SourcePath.kt`
- [Compiled file model](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/CompiledFile.kt): `server/src/main/kotlin/org/javacs/kt/CompiledFile.kt`
- [Kotlin compiler](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/compiler/Compiler.kt): `server/src/main/kotlin/org/javacs/kt/compiler/Compiler.kt`
- [Symbol index](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/index/SymbolIndex.kt): `server/src/main/kotlin/org/javacs/kt/index/SymbolIndex.kt`

### Language features

- [Completion](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/completion/Completions.kt): `server/src/main/kotlin/org/javacs/kt/completion/Completions.kt`
- [Diagnostics](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/diagnostic/ConvertDiagnostic.kt): `server/src/main/kotlin/org/javacs/kt/diagnostic/ConvertDiagnostic.kt`
- [Navigation and references](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/definition/GoToDefinition.kt): `server/src/main/kotlin/org/javacs/kt/definition/GoToDefinition.kt`
- [Document and workspace symbols](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/symbols/Symbols.kt): `server/src/main/kotlin/org/javacs/kt/symbols/Symbols.kt`
- [Code actions](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/codeaction/CodeAction.kt): `server/src/main/kotlin/org/javacs/kt/codeaction/CodeAction.kt`
- [Formatting](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/formatting/FormattingService.kt): `server/src/main/kotlin/org/javacs/kt/formatting/FormattingService.kt`
- [Other language features](https://github.com/fwcd/kotlin-language-server/tree/main/server/src/main/kotlin/org/javacs/kt): `server/src/main/kotlin/org/javacs/kt`

### Project dependencies

- [Classpath management](https://github.com/fwcd/kotlin-language-server/blob/main/server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt): `server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt`
- [Classpath resolvers](https://github.com/fwcd/kotlin-language-server/tree/main/shared/src/main/kotlin/org/javacs/kt/classpath): `shared/src/main/kotlin/org/javacs/kt/classpath`
- [Persistent database](https://github.com/fwcd/kotlin-language-server/blob/main/shared/src/main/kotlin/org/javacs/kt/database/DatabaseService.kt): `shared/src/main/kotlin/org/javacs/kt/database/DatabaseService.kt`

### Other components

- **LSP editor**
- **Maven or Gradle projects**

## Connections

- LSP editor → Server entry: starts server (evidence: `README.md`)
- Server entry → Language server: starts (evidence: `server/src/main/kotlin/org/javacs/kt/Main.kt`)
- LSP editor → Document service: sends document requests (evidence: `README.md`)
- LSP editor → Workspace service: sends workspace requests (evidence: `README.md`)
- Document service → Open source files: opens documents (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`)
- Document service → Source compilation: recovers compiled files (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`)
- Document service → Completion: requests completions (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`)
- Document service → Code actions: requests actions (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`)
- Document service → Formatting: formats documents (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinTextDocumentService.kt`)
- Document service → Diagnostics: publishes diagnostics (evidence: `README.md`)
- Workspace service → Configuration: updates settings (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt`)
- Workspace service → Open source files: changes workspace roots (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt`)
- Workspace service → Classpath management: refreshes project paths (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt`)
- Protocol extensions → Source compilation: compiles requested file (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinProtocolExtensionService.kt`)
- Protocol extensions → Classpath management: reads build output (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinProtocolExtensionService.kt`)
- Source compilation → Kotlin compiler: compiles sources (evidence: `server/src/main/kotlin/org/javacs/kt/SourcePath.kt`)
- Source compilation → Compiled file model: creates compiled state (evidence: `README.md`)
- Source compilation → Symbol index: updates declarations (evidence: `server/src/main/kotlin/org/javacs/kt/SourcePath.kt`)
- Compiled file model → Kotlin compiler: recompiles expressions (evidence: `README.md`)
- Completion → Symbol index: queries symbols (evidence: `server/src/main/kotlin/org/javacs/kt/completion/Completions.kt`)
- Code actions → Symbol index: queries symbols (evidence: `server/src/main/kotlin/org/javacs/kt/codeaction/CodeAction.kt`)
- Workspace service → Document and workspace symbols: serves workspace symbols (evidence: `server/src/main/kotlin/org/javacs/kt/KotlinWorkspaceService.kt`)
- Classpath management → Classpath resolvers: resolves dependencies (evidence: `server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt`)
- Classpath resolvers → Maven or Gradle projects: invokes build tools (evidence: `README.md`)
- Classpath management → Persistent database: initializes storage (evidence: `server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt`)
- Classpath management → Kotlin compiler: configures compiler (evidence: `server/src/main/kotlin/org/javacs/kt/CompilerClassPath.kt`)
