Repository Conventions

Conventions for human contributors and AI agents working on this repository.

Style

Terse technical prose. No emojis in commits, issues, PR comments, or code.
TypeScript strict mode. No any, no unknown casts where avoidable, no @ts-ignore, no @ts-expect-error, no enums.
ESM modules with .js suffix in import paths (Node16 resolution).
Tabs for indentation. Double quotes for strings (matches biome config).
Tests use vitest with #given .. #when .. #then description style or plain // given / // when / // then body comments.

npm install — install dependencies.
npm test — run vitest test suite once.
npm run typecheck — strict TypeScript check (no emit).
npm run check — type check + biome.
pi -e ./src/index.ts — load the extension into a local pi session for manual smoke testing.

No Bun APIs. Runtime is Node only.
No dependency on pi-coding-agent internal modules outside the documented public extension API in @mariozechner/pi-coding-agent.
Keep network behavior bounded: abort-aware fetches, timeout cap, and response size cap.
Tool renderers read typed details returned by execute; renderers must not parse formatted strings.

No git add -A or git add .. Stage only the files you changed.
No git commit --no-verify. No force pushes. No history rewriting on shared branches.