suaveplan/openspec/changes/REACT_AUDIO_WAVE_REWRITE_COMPLETE.md

React / R3F audio wave — rewrite COMPLETE

Rewrite date: 2026-05-15 Previous flag: NEEDS-REWRITE (predated 2026-05-14 architecture shift)

All five proposals have been rewritten against the unified architecture:

Change folder	Spec delta	Design
openspec/changes/enterprise-react-audio/	specs/react-audio/spec.md	design.md
openspec/changes/enterprise-react-audio-player/	specs/react-audio-player/spec.md	design.md
openspec/changes/enterprise-react-audio-stream/	specs/react-audio-stream/spec.md	design.md
openspec/changes/enterprise-react-audio-fingerprint/	specs/react-audio-fingerprint/spec.md	design.md
openspec/changes/enterprise-gaming-r3f-audio/	specs/r3f-audio/spec.md	design.md

What the rewrites collectively now satisfy

• Target path is packages/<plugin>/<pkg> per the current monorepo convention.
• @suaveplan/audio-engine references replaced by @suaveplan/audio-engine-browser (for rendering) + @suaveplan/audio-plugins-fx (for chain + plugin contract) + @suaveplan/audio-controllers (for MIDI binding).
• Spec deltas exist under specs/<capability>/spec.md in OpenSpec Requirement / Scenario / **Verified by:** form per openspec/AGENTS.md §0c.
• design.md exists with architecture, integration notes, and decisions.
• ## Impact → ### Affected dependents is per §14a template.
• Parity Checklist present where the proposal is a migration from upstream.
• Error codes use the dotted defineCodes form per AGENTS.md §7.
• Universal where possible, R3F-gated only where it belongs: r3f-audio consumes the four game-audio building blocks from audio-plugins-fx rather than re-implementing spatial / proximity / music / voice logic.

Prerequisite ordering

Each rewritten proposal lists its prerequisites at the top of its tasks.md. The conservative order:

1. enterprise-audio-plugins-fx (foundation FX + chain + ambient + bus registry)
2. enterprise-audio-engine-browser, enterprise-audio-engine-server (engine adapters)
3. enterprise-audio-controllers (MIDI binding helpers)
4. enterprise-audio-analysis-spectrum (FFT consumed by fingerprint)
5. enterprise-react-audio (umbrella React surface)
6. enterprise-react-audio-player, enterprise-react-audio-stream, enterprise-react-audio-fingerprint, enterprise-gaming-r3f-audio (in any order — siblings of the umbrella)

This file is retained as the historical record of the wave rewrite. It is informational only; the proposals themselves are the source of truth.