Adds the "carries whatever it can reconstruct, verifies whatever it
carries" surface on top of the existing neural/codec WAI. All builds
green against this base (wai-rs all-features tests + clippy, wai-web
wasm, wai-spz-gen, wai-relay).
Reconstruct half — each a spec + conformance corpus + in-tab browser
sink that re-derives the corpus hash, over one wai.det.fixed64 floor:
- interactive worlds replay-equivalence (3 sim registrants,
relay multiplayer, session receipts, glTF + real-SPZ assets)
- spatial audio mixdown-equivalence
- haptics sample-equivalence
- state-feeds replay-equivalence (non-physics sim)
- avatars / digital humans pose-equivalence (+ telepresence)
- volumetric / 4D splats frame-state-equivalence (WebGPU EWA render)
Verify half (lever 4):
- asset provenance — signed, energy-accounted lineage for opaque
captured content WAI does not reconstruct; tamper-evident in-tab.
Cross-cutting: per-class JWP receipt profiles; a native energy meter
(IOReport via macmon, no sudo) emitting receipts with real measured
joules. Codecs gated behind a `codecs` feature (default on) so the
world/wasm sinks build without the C codec chain.
Excludes the separately-evolving neural subsystem (semantic path, GLC
rANS, ONNX tooling) to avoid reverting newer origin work.
Co-Authored-By: Claude Opus 4.8 <[email protected]>
35 lines
1.2 KiB
Markdown
35 lines
1.2 KiB
Markdown
# Haptics Conformance Corpus
|
|
|
|
Vectors for the haptics extension's **sample-equivalence** criterion:
|
|
given the same `wai.haptic.signal`, a conforming sink MUST reconstruct
|
|
the identical canonical `u8` buffer (per-channel interleaved
|
|
`[intensity, sharpness]`), hence the identical BLAKE3 — on every
|
|
machine, no tolerance parameter. The touch counterpart of
|
|
replay/mixdown-equivalence, with the tick replaced by the haptic sample.
|
|
|
|
All vectors reconstruct in the `wai.det.fixed64` floor (Fx linear
|
|
interpolation of the keyframed envelope → u8). Signals are
|
|
self-contained (no external sources), so each vector is just a `.whap`
|
|
file + its expected `signal_hash`.
|
|
|
|
## Layout
|
|
|
|
- `vectors/<name>.whap` — the `WHAP` container (contract + channel
|
|
signals).
|
|
- `expected_hashes.json` — per signal: `channels` and `signal_hash`.
|
|
|
|
Vectors:
|
|
- `ramp` — intensity 0→1 over the duration.
|
|
- `thud` — full sharp hit, decaying.
|
|
- `dual_pulse` — two channels (dual-rumble): a strong pulse + a soft
|
|
steady channel.
|
|
|
|
## Running
|
|
|
|
```
|
|
cd ../wai-rs
|
|
cargo run --features haptic --bin wai_haptic_vectors -- verify ../haptic-conformance
|
|
cargo run --features haptic --bin wai_haptic_vectors -- gen ../haptic-conformance # regenerate
|
|
```
|
|
|
|
Pass = hash equality.
|