Skip to content

0022. Toolchain, repository layout, and Docker scope

  • Status: Accepted
  • Date: 2026-11-08

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.

  • 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 the node job, boots the all entrypoint against Postgres, and runs a smoke scenario.
  • Tool versions are pinned in the first code pull request.