quality

Snapshot measurable PNG traits, then fail CI when committed assets drift beyond their reviewed envelope. This command is offline, provider-neutral, and does not approve art.

pixelkiln quality snapshot \
  --inputs config/quality-inputs.json \
  --out quality/pixelkiln.quality.json
pixelkiln quality check --from quality/pixelkiln.quality.json

The input file is a JSON array of { id, path, record?, tolerances? }. Paths are relative to that file. The baseline stores portable paths relative to itself and records dimensions, palette, transparency, partial alpha, edge density and contrast, isolated-pixel ratio, and the PNG hash. A linked refinement record must be current and own the image.

snapshot leaves a different existing baseline untouched unless --force is explicit. check exits nonzero for missing files, dimension or metric drift, new colors, soft or partial-alpha edges, excessive isolated pixels, exact-hash violations, or changed refinement records. Hash-only changes are warnings unless requireExactHash is enabled or a linked record binds the bytes. Review changes visually before replacing a baseline.