Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,12 @@
**ONLY approved/public/product GUI: https://masarray.github.io/arsonmix/preview/**. There must be ONE public preview, ONE actual rendered GUI, and ONE native Windows GUI. **/preview-v2/ is rejected**: do not display, promote, publish or base native design on it as a separate UI. Do not substitute another console from `web/index.html`, `web/mixer-layout.js`, `web/console-native.html`, PR #278 or old M3/V48 mock. **The JUCE ENGINE must stitch into the EXACT approved /preview/ GUI**, never redesign it.


## Binding contextual-console owner decision — 2026-11-13

**READ FIRST when working on input GAIN, FX RACK, Sends on Faders, PRE/POST, WIRE SEND, or related UI/PCM:** [Owner-approved Contextual Console PRD](docs/PRD_CONTEXTUAL_CONSOLE_GAIN_SOF_20261113.md) and [companion ARD](docs/ARD_CONTEXTUAL_CONSOLE_GAIN_SOF_20261113.md). These are **normative feature specifications** (not a claim the native DSP is already implemented); they supersede inconsistent older v5/MS5 contextual UI/tap descriptions for that scope. Preserve the exact single approved assembled `/preview/` mixer and hardware PNG/SVG styling; GAIN/FX RACK are one interlocked shared strip area, SOF is a target-specific fader-flip layout, and PRE/POST/ON/level belong to the selected **EdgeId**. PRE_FADER (post-insert) is NOT legacy PRE_FX. SOF minimum/OFF never deletes WIRE; no auto-patching. Real native controls require installed PCM ACK/readback.

**2026-11-13 implementation starting point:** at that checkpoint [#604](https://github.com/masarray/arsonmix/pull/604) was a browser reference UI draft and [#606](https://github.com/masarray/arsonmix/pull/606) was the more advanced in-scope integration draft **including #604** and SonKu. Refresh live main and PR heads first; reconcile the most advanced source without reimplementing it, losing plugin/editor work, or double-merging. Harmonice is the **vocal FX plugin**, not the mixer name. Do not schedule Windows builds for specification-only changes.

## Long-term maintainability execution — 2026-11-11

For real source ownership and future feature-extension work, read [Current Architecture](docs/architecture/README.md), [Maintainability Execution Blueprint](docs/architecture/MAINTAINABILITY_EXECUTION_V1_20261111.md), and [Fast Feature Playbook](docs/architecture/FEATURE_EXTENSION_PLAYBOOK.md). A [ready-to-copy next-thread implementation prompt](docs/architecture/NEXT_THREAD_EXECUTION_PROMPT.md) begins coding M1 instead of repeating architecture research. [Issue #527](https://github.com/masarray/arsonmix/issues/527) tracks progress. These are implementation aids, NOT an extra coordination gate or an override of the approved /preview/, single native PCM callback, hard RT/audio safety, owner-authorized smart CI, or physical FAT rules. Keep the plan updated after proven source changes; do not create a new high-level plan instead of shipping a testable milestone.
Expand Down
2 changes: 2 additions & 0 deletions docs/ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
> **OWNER-APPROVED 2026-11-13 CONTEXTUAL-CONSOLE ARD ADDENDUM:** For GAIN/FX RACK, SOF, post-insert PRE_FADER (distinct from PRE_FX), per-send EdgeId/tap/level/ON and PCM/ACK requirements, read [Contextual Console ARD](ARD_CONTEXTUAL_CONSOLE_GAIN_SOF_20261113.md) and [PRD](PRD_CONTEXTUAL_CONSOLE_GAIN_SOF_20261113.md) first. Those scoped requirements override conflicting historical sections below; single callback, real PCM, existing WIRE/device/VST3 safety remain binding. Specification **does not** establish native qualification.

> **FINAL 2026-11-04 GUI REPLACEMENT:** All GUI authority in this historical document is superseded by **https://masarray.github.io/arsonmix/preview/** (the only approved GUI, including its approved PNG button variant). Bare `/preview-v2/` is rejected. Only one public preview (redirect old URLs), one JUCE GUI, one native PCM graph. Read [single handoff](workstreams/HANDOFF_APPROVED_PREVIEW_V2_NATIVE_20261104.md) and root AGENTS.md. Older native DSP/safety/ABI/Show/FAT constraints remain valid. GUI work #389, engine #266/#387, FAT #270.

# ArSonMix ARD v5.2 — Universal Realtime Mixer Graph + Operator-First Console
Expand Down
Loading