Development

The repository is an npm workspace with apps for API and worker, packages for contracts/core/database/queue/execution/browser/SDK, a deterministic fixture, integration tests, and a versioned static documentation site.

Every workspace owns its external runtime dependencies. Public packages export dist/index.js plus dist/index.d.ts; the development condition resolves source files only for local scripts and tests. Run npm run build before packing or consuming packages without that condition.

PostgreSQL schema definitions live in packages/database/src/schema.ts; reviewed SQL migrations live in drizzle/ and run through Drizzle's migration API. Redis is queue/cache infrastructure only; durable run results remain in PostgreSQL. Do not add Docker or a dashboard as a V1 milestone.

Keep domain behavior independent of Fastify, Playwright, Redis, and PostgreSQL where the behavior does not require them. New packages should represent real architectural boundaries.

CI uses Node.js 24 with isolated PostgreSQL and Redis services, migrations, coverage thresholds, Chromium golden tests, generated OpenAPI consistency, documentation builds, formatting, type checking, and dependency auditing.