// Language Server Protocol 서버 구현 가이드. LSP 서버, 증분 파싱, 자동완성, 진단, Go-to-Definition, 호버를 구현할 때 사용한다.
| name | lsp-design |
| description | Language Server Protocol 서버 구현 가이드. LSP 서버, 증분 파싱, 자동완성, 진단, Go-to-Definition, 호버를 구현할 때 사용한다. |
Client Server
│ │
│── initialize ───────────────→ │
│←── initialize result ────────│
│── initialized ──────────────→ │
│ │
│── textDocument/didOpen ─────→ │ → parse → diagnostics
│←── publishDiagnostics ───────│
│ │
│── textDocument/didChange ───→ │ → incremental parse → diagnostics
│←── publishDiagnostics ───────│
│ │
│── textDocument/completion ──→ │
│←── completion items ─────────│
│ │
│── textDocument/definition ──→ │
│←── location ─────────────────│
│ │
│── textDocument/hover ───────→ │
│←── hover content ────────────│
│ │
│── shutdown ─────────────────→ │
│←── null ─────────────────────│
│── exit ─────────────────────→ │
파서가 예상치 못한 토큰을 만났을 때:
1. 에러 진단 추가 (위치 + 메시지)
2. 동기화 토큰까지 스킵 (;, }, EOF)
3. 파싱 계속 → 추가 에러 감지
4. 결과: 부분 AST + 에러 목록
GlobalScope
├── print (builtin function)
├── len (builtin function)
├── x (variable, line 1)
├── add (function, line 3)
│ └── FunctionScope
│ ├── a (parameter)
│ └── b (parameter)
└── main logic
└── BlockScope (if/while/for)
└── i (variable)
Raft 합의 알고리즘 설계 및 구현 가이드. 분산 시스템, 합의 프로토콜, 리더 선출, 로그 복제를 구현할 때 사용한다.
리액티브 스프레드시트 엔진 설계 가이드. 셀 수식 파싱, 의존성 그래프(DAG), 증분 재계산, 내장 함수 구현 시 사용한다.
바이트코드 컴파일러 + 스택 VM 설계 가이드. MiniLang을 바이트코드로 컴파일하고 VM에서 실행할 때 사용한다.
이벤트 소싱 + CQRS 패턴 설계 가이드. EventStore, Aggregate, Projection, Saga, Snapshot 구현 시 사용한다.
Express.js REST API design and implementation guide. Use when implementing REST API endpoints, creating Express routes, or setting up API project structure with MVC pattern.
Analyze and fix race conditions and concurrency bugs in async code. Use when debugging async bugs, fixing race conditions, resolving concurrency issues, or when shared state is accessed by multiple async operations.