AGENTS.md

1# Repository Conventions
2 
3Conventions for humans and agents working on this repository.
4 
5## Style
6 
7- TypeScript strict mode. No `any`, `@ts-ignore`, `@ts-expect-error`, or enums.
8- ESM modules with `.js` suffix in import paths.
9- Tabs for indentation. Double quotes for strings.
10- Runtime is Node only.
11- Tests use vitest and should exercise Codex hook/MCP behavior before implementation changes.
12 
13## Commands
14 
15- `npm install` installs dependencies.
16- `npm test` runs the test suite once.
17- `npm run typecheck` runs strict TypeScript checking.
18- `npm run check` runs typecheck, Biome, and build.
19 
20## LSP Constraints
21 
22- LSP server processes are owned by `LspManager`.
23- Tool execution acquires clients through `withLspClient(...)` unless it only reports static status.
24- `lsp.rename` mutates files by applying workspace edits; keep it sequential at the MCP caller level.
25- `.mcp.json` sets `lsp` MCP server `startup_timeout_sec: 10` to bound startup; preserve the bound on edits.
26- Do not add pi-coding-agent or omo source dependencies. This package is standalone.
27