# 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.