# LanguageSession 关闭契约

本文档描述 LspCpp 当前的 shutdown 行为，用于记录现有语义，避免 embedder 误用
clangd 特有的 exit code 规则。

## 期望客户端顺序

1. `initialize` 请求/响应
2. 可选 `initialized` 通知
3. 正常 LSP 流量
4. `shutdown` 请求，返回 `result: null`
5. `exit` 通知

## 当前 LspCpp 行为

| 场景 | 当前行为 |
| --- | --- |
| 正常 `shutdown` 后 `exit` | `exit` 通知 handler 会执行，会话正常结束。 |
| 未 `shutdown` 直接 `exit` | `exit` 通知 handler 仍会执行；LspCpp 不强制进程退出码。 |
| 首帧前 stdin EOF | 消息读取线程结束；不会派发 `exit` 通知。 |
| 带 id 的不支持请求 | 未注册 handler/parser 时返回 `-32601`。 |
| endpoint `stop()` | 未完成 outbound 请求失败，处理线程 join。 |

## 可选限制

`RemoteEndPointLimits::max_pending_outgoing_requests` 默认为 `0`（无限制）。
设置后，pending reply 映射达到上限时会拒绝新的 server→client 请求。

## 兼容性说明

这些语义由借鉴 clangd 场景的 characterization tests 覆盖。
若未来调整行为，需同步更新本文档与对应测试。