Skip to content
Merged
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 @@ -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.
Expand Down