Suite of AT Protocol TypeScript libraries built on web standards
1# Agent Guidelines for ATP Monorepo
2
3## Build & Test Commands
4
5- Run all tests: `deno test -P`
6- Run single test file: `deno test -P path/to/file_test.ts`
7- Run specific test: `deno test -P --filter "test name" path/to/file_test.ts`
8- Format code: `deno fmt`
9- Lint code: `deno lint`
10- Check code: `deno check`
11
12## Code Style
13
14- **NO COMMENTS** unless explicitly requested
15- Use JSDoc only for exported types/functions with `@prop`, `@param`, `@returns`
16 tags
17- Test files: `*_test.ts` pattern (e.g., `car_test.ts`), use Deno.test(),
18 imports from `@std/assert`
19- Types: Explicit types for function parameters/returns, prefer `interface` over
20 `type` for objects
21- Error handling: Use custom error classes extending base errors, include
22 `ErrorOptions` with `cause`
23- Imports: Use JSR/npm imports from deno.json, absolute imports (e.g.,
24 `@atp/crypto`, `@std/assert`)
25- Naming: camelCase for vars/functions, PascalCase for classes/types, UPPER_CASE
26 for constants
27- Exports: Use `export` directly, re-export from `mod.ts` for public API
28- Async: Prefer async/await over promises, use AsyncGenerator for streams
29- Formatting: 2 spaces indent, semicolons, trailing commas, 80 char soft limit