0022. Toolchain, repository layout, and Docker scope
- Status: Accepted
- Date: 2026-11-08
Context
Section titled “Context”The open items “language toolchain and repository layout” were to be fixed by the first code. The architecture in ADR 0008 and the boundaries in ADR 0018 determine most of it.
Decision
Section titled “Decision”- TypeScript (strict) with pnpm workspaces and TypeScript project references (
tsc -b). No build orchestrator until build time requires one. - Hono for HTTP, zod for schemas (and OpenAPI generation), Kysely for SQL (ADR 0010), the MCP TypeScript SDK for MCP.
- ESLint and Prettier; dependency-cruiser for module rules.
- vitest for all tests;
@cloudflare/vitest-plugin(the renamed@cloudflare/vitest-pool-workers) for Workers, Durable Objects, and Queues in Miniflare. - wrangler for the Cloudflare target, both deployment and local development.
- Layout as in ADR 0018.
- Docker is used only for
apps/node. CI builds the image only in thenodejob, boots theallentrypoint against Postgres, and runs a smoke scenario.
Consequences
Section titled “Consequences”- Tool versions are pinned in the first code pull request.