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]>
47 lines
2.3 KiB
Markdown
47 lines
2.3 KiB
Markdown
# Linear-Film Conformance Corpus
|
|
|
|
Vectors for the linear-film extension (`wai.film.linear`). The criterion is
|
|
**film-equivalence**: given the same film, a conforming sink MUST compute
|
|
the identical per-frame identity — `BLAKE3(world state hash at the frame's
|
|
tick || the interpolated camera pose)` — hence the identical per-frame
|
|
hashes and the identical Merkle root over them, on every machine, no
|
|
tolerance parameter.
|
|
|
|
**Provenance.** Generated here: `wai_film_vectors gen` writes every vector from shots authored in code. No footage.
|
|
|
|
A film composes two things already proven elsewhere: the embedded world's
|
|
**replay-equivalence** (every sink agrees on the state hash at every tick —
|
|
the `world-conformance/` corpus) and the `wai.det.fixed64` camera track
|
|
(interpolated trig-free, like the splat/skeletal tracks). The render — the
|
|
actual pixels — is the sink's presentation, not the verified quantity.
|
|
|
|
## Layout
|
|
|
|
- `vectors/<name>.wflm` — the `WFLM` container: a film contract, an embedded
|
|
sealed `wai.world.replay` (`WWLD`), and a camera track.
|
|
- `expected_hashes.json` — per film: `frames`, `start_tick`,
|
|
`ticks_per_frame`, `film_hash` (identity), and `frames_root` (the Merkle
|
|
root over the per-frame reconstruction hashes — the conformance quantity).
|
|
|
|
Vectors (each a complete film/reel in ~1 KB — the world plus the camera(s)):
|
|
- `dolly` — one subject drifting; the camera dollies from behind to the side.
|
|
- `twoshot` — two subjects moving apart; the camera holds, then pushes in
|
|
(a two-leg move).
|
|
- `rise` — a subject climbing; the camera cranes up and tilts (a quaternion
|
|
lerp), starting at a non-zero tick.
|
|
- `character` — the embedded world is a skeletal humanoid (the avatars sim)
|
|
waving; film composes with avatar.
|
|
- `coverage` (`.wrel`, a **reel**) — the character beat cut three ways: a wide
|
|
establishing shot, a low push-in, then a cut **back in time** to a high
|
|
angle on the same moment. `kind: "reel"` in the manifest, checked against
|
|
`reel_hash` + `frames_root`.
|
|
|
|
## Running
|
|
|
|
```
|
|
cd ../wai-rs
|
|
cargo run --features film --bin wai_film_vectors -- verify ../film-conformance
|
|
cargo run --features film --bin wai_film_vectors -- gen ../film-conformance # regenerate
|
|
```
|
|
|
|
Pass = film-hash + frames-root + frame-count equality, on every machine.
|