open-standards/wai/haptic-conformance/README.md
Transaction Science 46c5688b86 wai: the WAI open standard — full cargo-class surface + provenance
Commit the WAI standard source: a content + capability-dispatch standard
whose thesis is "carries whatever it can reconstruct, verifies whatever
it carries." Source only — large vendored/model assets and build output
are gitignored.

Reconstruct classes (each: spec + conformance corpus + in-tab browser
sink that re-derives the corpus hash, one wai.det.fixed64 fixed-point
floor, one *-equivalence apiece):
  - interactive worlds  (replay-equivalence)   + 3 sim registrants,
    multiplayer over a relay, 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 over the relay
  - volumetric / 4D splats   (frame-state-equivalence) + WebGPU EWA render,
    real-SPZ-derived clip

Verify half (lever 4):
  - asset provenance: a signed, energy-accounted lineage for opaque
    captured content WAI does not reconstruct; tamper-evident, in-tab.

Cross-cutting: JWP receipt profiles per class; a native energy meter
(IOReport via macmon, no sudo) emitting receipts with REAL measured
joules; the learned-image/neural codec family and JPEG AI entropy port
from earlier work.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
2026-06-13 22:28:51 -04:00

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.