CI

Required checks

For your project: TypeScript checks, the Vitest workflow tests, and the tests against real PostgreSQL.

For this documentation site, the same job also runs the format lint and the JS lint, then a plain build followed by a CHECK_LINKS=true build, then the documentation contract, the typecheck, and the lightweight #46 documentation test. It finishes with the Slidev build for the workshop deck.

Keep the outputs separate. A green typecheck sitting on top of a failed test run looks like a pass at a glance, and someone will read it that way.

Evidence

Record the commit, the Node.js and pnpm versions, the resolved package set, the PostgreSQL image, the test output, and the documentation build output.

A CI artifact proves a command ran. That’s all it proves — it says nothing about whether the thing it built can be delivered anywhere.

Workshop gate

G14 is the documentation check: the route map, every anchor the slide deck links to, and the internal link validator. It’s what stops a slide from pointing at a heading that no longer exists.

Only link the route table from the deck once it’s green.