Copilot instructions

1# continues — Code Review Standards
2 
3## Read-Only Semantics
4 
5- Session data is NEVER modified. Any PR that writes to `~/.claude/`, `~/.codex/`, `~/.copilot/`, `~/.gemini/`, `~/.factory/`, `~/.cursor/`, or `~/.local/share/opencode/` is a critical bug.
6- Handoff files (`.continues-handoff.md`) write only to the project's own working directory — never to tool storage paths.
7 
8## ESM Conventions
9 
10- All local imports must use `.js` extensions, even for `.ts` source files: `import { foo } from './bar.js'`
11- Never use `require()` — this is an ESM-only codebase (`"type": "module"` in `package.json`)
12- Use `process.exitCode = N` instead of `process.exit(N)` — allows cleanup handlers to run
13 
14## Error Handling
15 
16- Use typed errors from `src/errors.ts` (`ParseError`, `SessionNotFoundError`, `ToolNotAvailableError`) for user-facing error paths — not bare `throw new Error()`
17- Parsers must silently skip malformed session data with `catch {}` — never propagate parse errors to the caller
18 
19## Registry Completeness
20 
21- Every `SessionSource` member in `src/types/tool-names.ts` must have a registered `ToolAdapter` in `src/parsers/registry.ts`
22- The completeness assertion at the bottom of `registry.ts` throws at module load if any adapter is missing — a missing entry crashes the CLI at startup
23- Adding a tool to `TOOL_NAMES` without a registry entry is always a bug; changes to `SessionSource` require coordinated updates in the registry, fixtures, and tests
24 
25## Code Quality
26 
27- Biome handles all formatting and style — do not introduce ESLint, Prettier, or TSLint configs
28- No synchronous file I/O (`readFileSync`, `writeFileSync`) in parser code — blocks the event loop when scanning large session directories
29- Shared helpers `cleanSummary`, `extractRepoFromCwd`, and `homeDir` live in `src/utils/parser-helpers.ts` — do not duplicate them in individual parsers
30 
31## Performance
32 
33- Parsers run in parallel via `Promise.allSettled` in the session index builder — a slow parser delays only its own results
34- The session index uses a 5-minute TTL cache at `~/.continues/sessions.jsonl` — cache bypasses should be explicitly justified
35