open-standards/wai/byte-exact-conformance/README.md
Transaction Science 3fac029a71 wai: every corpus states the provenance of its content
Each *-conformance/README.md now has a line that begins **Provenance.**:
the generator that writes the corpus and its input, and for an input not
generated here its source and licence. OER/2's corpus is settled and left
as it is. byte-exact-conformance and quantum-ops-conformance get a README.
wai-rs/tests/vectors/README.md gives a row per vector directory. Where the
staged-delivery, staged-measurement and telemetry READMEs called their
content "synthetic", that sentence is now their provenance line.

Two vectors are recorded as not generated, from the provenance audit:
int_video's video_real (a pan over a third-party picture) and
neural-conformance's photo (a third-party picture, with a decoder trained on
unrecorded images). Their lines say so and that they are to be replaced;
the photo bullet no longer names the picture's source product.

tests/corpus_provenance.rs requires the line in every corpus and a row for
every vector directory; CI runs it with the carriage tests. CONTRIBUTING
states the rule: corpus content is generated here, or recorded with a
licence that permits redistribution, and a word like "synthetic" is not a
provenance line.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
2026-10-07 10:09:21 -04:00

938 B

byte-exact-conformance — cross-architecture byte equality

A crate that compiles WAI's pure-integer decode paths (the rANS entropy coder and the integer fixed-point syntheses, #[path]-included from wai-rs) without the system codec libraries, so the byte-equality matrices (.github/workflows/wai-byte-equality.yml, and cross-arch byte-equality in wai-conformance.yml) run them on every OS and architecture. cargo test --release here decodes the committed vectors and the staged-delivery corpus to the goldens in src/*_golden.rs, generated once on a reference machine, and must match them on every machine.

Provenance. The goldens are digests of decodes of the vectors under ../wai-rs/tests/vectors/ and of the staged-delivery corpus; that directory's README states each vector's provenance. Among them, the int_video half-pel clip (video_real) is not generated content (see there).