From e0342c3f6a8846193be8885e98d0108e66a86119 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sat, 14 Nov 2026 22:57:34 +0700 Subject: [PATCH] docs: preserve approved GAIN GUI across concurrent PR integrations (#699) --- AGENTS.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 1bca12415..f2d6d2777 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,6 +12,12 @@ **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. **Naming across the repository and CI:** ArSonMix is the mixer. Harmonice is its built-in vocal harmony plugin. Use mixer terminology for shared controls, including MUTE/SOLO/PFL and SOF, and name the actual subsystem in test labels (plugin DSP, mixer PCM, ASIO). Do not schedule Windows builds for specification-only changes. +### Accepted GAIN GUI checkpoint / cross-thread preservation — 2026-11-14 + +**When working on GAIN, GUI integration, Pages, SonKu, LMS, FX or native controls, consult [cross-thread safety ledger #699](https://github.com/masarray/arsonmix/issues/699) and re-audit LIVE `main` plus relevant PR files.** The accepted operator GAIN baseline was shipped via #690 → #694 → #696 → #698 (`a01fe350` at that moment): static steel PNG knob with shadow, 58px default cap / 84×25px recessed green-on-black LCD and 30-segment LED arc, no click-to-seek, 6px intentional drag arm, 0dB capture ±1.6dB / release ±3.2dB, and native ACK/readback. Use the current approved `/preview/` and targeted visual/gesture tests; *do not replay these historical PR commits*. + +**High-risk old integration branches:** draft #661 and #649 carry pre-checkpoint GAIN HTML/CSS/bridge; draft #635 changes Pages assembler/CI, while SonKu P7–P8 is a stacked, physically unqualified research/field chain. Reconcile only relevant, source-owned hunks onto the latest `main`; do not copy whole old GUI files, merge the stacked drafts en masse, force-push or overwrite other threads. This ledger is a collision warning, **not a new coordination/owner gate**. Continue independent work normally and treat any physical audio FAT separately from Chromium/UI success. + ## 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.