docs(lsp): update CLAUDE.md and create README.md

- Add Vue and Dart servers to supported servers list
- Document new methods: definition, references, completion
- Add LSPManager methods reference table
- Create comprehensive README with API reference

Author: amondnet

packages/lsp/CLAUDE.md

@@ -4,7 +4,7 @@ LSP (Language Server Protocol) client implementation for AI coding tools.
 
 ## Overview
 
-This package provides a unified interface for interacting with multiple language servers, enabling real-time diagnostics, hover information, and symbol navigation.
+This package provides a unified interface for interacting with multiple language servers, enabling real-time diagnostics, code navigation, completions, and symbol navigation.
 
 ## Architecture
 
@@ -22,11 +22,13 @@ src/
 |--------|-----|------------|----------------|
 | TypeScript | `typescript` | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | package-lock.json, bun.lockb, bun.lock, yarn.lock, pnpm-lock.yaml |
 | Deno | `deno` | .ts, .tsx, .js, .jsx, .mjs | deno.json, deno.jsonc |
+| Vue | `vue` | .vue | package.json, package-lock.json, bun.lockb, bun.lock, pnpm-lock.yaml, yarn.lock |
 | Oxlint | `oxlint` | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | .oxlintrc.json, package-lock.json, bun.lockb, bun.lock, pnpm-lock.yaml, yarn.lock, package.json |
 | Pyright | `pyright` | .py, .pyi | pyproject.toml, setup.py, requirements.txt, pyrightconfig.json |
 | Gopls | `gopls` | .go | go.work, go.mod, go.sum |
 | Rust Analyzer | `rust-analyzer` | .rs | Cargo.toml, Cargo.lock |
 | Kotlin | `kotlin` | .kt, .kts | build.gradle.kts, build.gradle, settings.gradle.kts, settings.gradle, pom.xml |
+| Dart | `dart` | .dart | pubspec.yaml, pubspec.lock |
 
 ## Adding a New Server
 
@@ -89,13 +91,39 @@ const diags = await manager.diagnostics()
 // Get hover info
 const hover = await manager.hover({ file, line, character })
 
+// Go to definition
+const defs = await manager.definition({ file, line, character })
+
+// Find all references
+const refs = await manager.references({ file, line, character, includeDeclaration: true })
+
+// Get code completions
+const completions = await manager.completion({ file, line, character })
+
 // Search symbols
 const symbols = await manager.workspaceSymbol('query')
 
+// Get document symbols
+const docSymbols = await manager.documentSymbol(uri)
+
 // Cleanup
 await manager.shutdown()
 ```
 
+### LSPManager Methods
+
+| Method | LSP Request | Description |
+|--------|-------------|-------------|
+| `touchFile()` | `textDocument/didOpen` | Open file in LSP servers |
+| `diagnostics()` | `textDocument/publishDiagnostics` | Get all diagnostics |
+| `hover()` | `textDocument/hover` | Get hover information |
+| `definition()` | `textDocument/definition` | Go to definition |
+| `references()` | `textDocument/references` | Find all references |
+| `completion()` | `textDocument/completion` | Get code completions |
+| `workspaceSymbol()` | `workspace/symbol` | Search workspace symbols |
+| `documentSymbol()` | `textDocument/documentSymbol` | Get document symbols |
+| `shutdown()` | `shutdown` | Close all clients |
+
 ### Server Utilities
 
 ```typescript

packages/lsp/README.md

@@ -0,0 +1,129 @@
+# @pleaseai/code-lsp
+
+LSP (Language Server Protocol) client implementation for AI coding tools.
+
+## Installation
+
+```bash
+bun add @pleaseai/code-lsp
+```
+
+## Features
+
+- Multi-server support with automatic lifecycle management
+- Code navigation (definition, references)
+- Code completions
+- Diagnostics and hover information
+- Symbol search (workspace and document)
+- Auto-download for Kotlin, Dart, and Vue language servers
+
+## Quick Start
+
+```typescript
+import { LSPManager } from '@pleaseai/code-lsp'
+
+const manager = new LSPManager('/path/to/project')
+
+// Open a file to initialize LSP
+await manager.touchFile('src/index.ts', true)
+
+// Get diagnostics
+const diagnostics = await manager.diagnostics()
+
+// Go to definition
+const definitions = await manager.definition({
+  file: 'src/index.ts',
+  line: 10,
+  character: 5,
+})
+
+// Find all references
+const references = await manager.references({
+  file: 'src/index.ts',
+  line: 10,
+  character: 5,
+  includeDeclaration: true,
+})
+
+// Get completions
+const completions = await manager.completion({
+  file: 'src/index.ts',
+  line: 10,
+  character: 5,
+})
+
+// Cleanup
+await manager.shutdown()
+```
+
+## Supported Language Servers
+
+| Language | Server | Auto-download |
+|----------|--------|---------------|
+| TypeScript/JavaScript | typescript-language-server | No |
+| Deno | deno lsp | No |
+| Vue | @vue/language-server | Yes |
+| Python | pyright-langserver | No |
+| Go | gopls | No |
+| Rust | rust-analyzer | No |
+| Kotlin | JetBrains Kotlin LSP | Yes |
+| Dart | dart language-server | Yes |
+| Linting | oxlint | No |
+
+## API Reference
+
+### LSPManager
+
+| Method | Description |
+|--------|-------------|
+| `touchFile(file, waitForDiagnostics?)` | Open file in LSP servers |
+| `diagnostics()` | Get all diagnostics |
+| `hover({ file, line, character })` | Get hover information |
+| `definition({ file, line, character })` | Go to definition |
+| `references({ file, line, character, includeDeclaration? })` | Find all references |
+| `completion({ file, line, character })` | Get code completions |
+| `workspaceSymbol(query)` | Search workspace symbols |
+| `documentSymbol(uri)` | Get document symbols |
+| `status()` | Get connected server status |
+| `shutdown()` | Close all clients |
+
+### Types
+
+```typescript
+import {
+  // Position and Range
+  Position,
+  Range,
+  Location,
+  LocationLink,
+
+  // Symbols
+  Symbol,
+  DocumentSymbol,
+  SymbolKind,
+
+  // Completions
+  CompletionItem,
+  CompletionList,
+  CompletionItemKind,
+
+  // Diagnostics
+  Diagnostic,
+} from '@pleaseai/code-lsp'
+```
+
+## Server Utilities
+
+```typescript
+import { getServerById, getServersForExtension } from '@pleaseai/code-lsp'
+
+// Get server by ID
+const tsServer = getServerById('typescript')
+
+// Get servers for file extension
+const servers = getServersForExtension('.ts')
+```
+
+## License
+
+MIT