# Agent Notes (flagboat)

## Commands
- Install deps: `bun install`
- Check types: `bun typecheck`
- Run bot locally: `timeout 5 bun run .`
- Tests: WE DON'T DO TESTS!

## Code Style
- TypeScript ESM (`"type": "module"`).
- Always use `import type { ... }` or `import { type ... }` when possible.
- Use 4-space indentation, double quotes, and semicolons.
- Keep imports grouped and sorted: external first, then local.
- Prefer `let` over `const`, `async/await` over nested callbacks, and early returns.
- Handle `strict` TS + `noUncheckedIndexedAccess`: null-check before use.
- Errors: `throw new Error(...)` (avoid throwing strings); log context, don’t log secrets.
- Naming: `camelCase` for vars/functions, `PascalCase` for classes/types, `SCREAMING_SNAKE_CASE` for constants.