3fac029a71
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]>
14 lines
938 B
Markdown
14 lines
938 B
Markdown
# 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/`](../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).
|