Verification & snapshots

flowchart LR
  Code["source change"] --> Fast["focused tests"]
  Fast --> Harness["affected fixtures"]
  Harness --> Look["inspect PNGs"]
  Look --> Bless["golden:update<br/>intentional only"]
  Bless --> Verify["pnpm verify"]
  Verify --> CI["quality job + 11 family shards"]

What pnpm verify runs

1. Prettier formatting check.
2. ast-grep structural rules: determinism, family purity, no barrels, and braced control flow.
3. strict TypeScript project references.
4. production build of this developer-docs app.
5. unit, property, contract, renderer, metric, performance, and golden tests.
6. every fixture through rendering and metric gates.

Three snapshot layers

Digest	Detects
Geometry / NGD	Contract or coordinate changes, including invisible fields
SVG	Renderer serialization and semantic skin changes
PNG	Actual pixels users see

CI shards the expensive fixture and image checks by all eleven families. The quality job performs formatting, linting, types, docs, and core tests once.

Intentional changes

pnpm harness run 'sequence/*'
open out/index.html
pnpm golden:update
pnpm verify

Snapshot updates are the final record of a reviewed result, never the mechanism for making a red test disappear.