[tobyvee]

Wave 0 — foundations

Implements Wave 0 of the implementation roadmap (project/ROADMAP.md): the foundations that
de-risk everything after them, plus the project backlog and the discovery decisions. (Opening this PR
is the first run of the new CI.)

Code

• ENG-003 — CI. .github/workflows/ci.yml runs typecheck · lint · test · build on PRs and pushes
  to main (Node from .nvmrc, --frozen-lockfile, pnpm + Turborepo caching). CI badge + a
  "Continuous integration" section added to the root README.
• ENG-002 — Temporal workflow tests. apps/server/src/temporal/workflows.test.ts drives the
  durable workflows through @temporalio/testing time-skipping with mocked activities (no live
  services). 8 tests: happy-path → done (both gates), merge-gate-blocks, QA-fail → blocked,
  merge-fail → blocked, deploy-fail → blocked, roadmap-gate-blocks-then-decomposes, all shaping
  stages run, and heartbeat picks up the backlog. Adds @temporalio/testing to apps/server.

Planning docs (project/)

16 tickets (ENG-001..016) from a codebase review, PRD-001 (Kappa-style consensus for
implementation-direction decisions), and a dependency-sequenced ROADMAP.md with a README index.

Discovery decisions (recorded in the tickets)

• ENG-011 — issue tracker: GitHub Issues/Projects as the v1 default (Postgres for local);
  Linear/Jira deferred behind the IssueTracker port.
• ENG-012 — A2A protocol: decline now, monitor; keep any future adoption at the boundary behind
  a port (MCP is the higher-value near-term interop bet for a Claude-first project).
• ENG-015 — SurrealDB: no-go on a wholesale replacement (doesn't remove Postgres — Temporal
  needs it — and reverses the OSI-only license bar).

Verification

pnpm typecheck · pnpm lint · pnpm test (59 tests) all green locally.

Follow-ups needing a human (can't be committed from the codebase)

• Enable branch protection on main requiring the typecheck · lint · test · build check.
• ENG-015: ratify keeping the OSI-only license bar (recommended: decline BSL/SurrealDB for now).
• ENG-011: optional one-line CLAUDE.md edit to mark the tracker decision settled.

🤖 Generated with Claude Code