ADR 0007: U3 AcousticPlane — Symbolic & Spectral-First Audio

Status

Accepted (2026-06-17)

Context

QualiaDB’s phenomenal viewport (U2) projects the shared [α, μ, σ] truth layer from Tensor10D SOA into linear RGB via CIE Gaussian CMFs. Users expect the same semantic manifold to be heard as well as seen — without introducing a second truth stack or routing neural PCM from the LLM inference universe (U0).

Competing approaches considered:

  1. LLM waveform generation — U0 emits PCM buffers. Rejected: blows 42 MB Sentinel budget, adds non-deterministic latency, violates zero-heap hot paths.
  2. <audio> tag + MP3 URLs — Simple but lossy; psychoacoustic discard destroys sovereignty over dynamic range (α).
  3. Web Audio API from JS — Reintroduces V8 spectral math the migration plan retires.
  4. Symbolic tokens + spectral sheets + parametric DSP — Matches visual cold/hot split (bake → resident → render).

Browser constraints add a transport decision: AudioWorklet runs off the main thread; uniform updates must be either postMessage or SharedArrayBuffer (requires COOP/COEP).

Decision

Introduce ComputeUniverse::AcousticPlane (U3) as a read-only alias of the U1 Tensor10D ledger partition with its own hot-path consumer:

Layer Mechanism
Truth (cold) STFT/CQT mmap sidecars (Q4AU header) + inline α, μ, σ in tensor
Events (hot) 64-bit Sonic Tokens over SPSC ring (U0/U1 → U3)
Synthesis (hot) Browser AudioWorklet: parametric carrier + overlap-add inverse-STFT grains + analytic binaural HRTF
Transport 1024 B Q3AS SharedArrayBuffer when crossOriginIsolated; else Float32Array MessagePort

Locked invariants

  1. U0 never emits PCM — only Sonic Tokens and graph structure.
  2. σ parity — visual λ (400–700 nm) and auditory Hz (1760–110) derive from the same fract(σ) mapping (portal_acoustic.rs).
  3. U3 muted in Reserve — acoustic synthesis yields to LLM KV retention under VRAM pressure.
  4. Analytic HRTF in hot path — KEMAR tables, if adopted, are cold-path assets only.
  5. Sonic Token layout — 8-byte Pod; tensor index at bits 32–47; SONIC_MAGIC 0x53 in flags.

Consequences

Positive

Negative

Neutral

References