Testing

Octipus uses Vitest for its main automated test suite.

Command	Scope
npm test	Main unit and database projects
npm run typecheck	TypeScript checking
npm run lint	Lint rules
npm run test:integration	Integration suite against the configured PostgreSQL test service
npm run test:e2e	Backend end-to-end coverage
npm run test:web	Browser UI tests
npm run test:acceptance	Deterministic scripted-provider acceptance flow
npm run eval	Evaluation harness

Follow docs/TESTING.md for prerequisites and environment variables. Integration tests use a dedicated database and must never target a development or production database.

Test totals change as the suite grows, so a successful run and its commit are stronger evidence than a count copied into documentation. Deterministic acceptance tests validate wiring without proving a live model provider’s quality. Likewise, dry-run red-team checks validate the harness; only configured live runs exercise an actual provider.