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
2 changes: 2 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Repository instructions — ArSonMix (all future threads and AI coding agents)

> **LATEST RECONCILED LIVE STATUS — 2026-10-29 17:55 WIB:** Read [docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md](docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md) FIRST and refresh GitHub before coding. Verified main 4d14251: R0A #144, input patch #146 and premium routing workbench already MERGED; R0B production graph still OPEN as #149; ACK hardening #147 OPEN; zero-FX hardware crackle #15 OPEN. Older assertions that R1 is unmerged or all 10CH routing is absent are superseded. No visual/engine redesign from historical status snapshots.

**CURRENT NEXT-THREAD ENTRYPOINT (2026-10-29):** Read [docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md](docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md) before changes. Baseline #129 merged; GUI performance, FX atomic reorder/de-click, Orbit POLAR and P1I native 10CH LAB must not regress. Historic v0.8 12+1 references and dated PR OPEN statements further below are retained for lineage but not authoritative over current 10CH+MASTER main. Native full Shows/Snapshots is NOT delivered by localStorage scene UX. Source/CI/hardware evidence takes precedence.


Expand Down
130 changes: 130 additions & 0 deletions docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
# ArSonMix — Canonical Progress Reconciliation & Next Execution (2026-10-29 17:55 WIB)

> **START HERE for cross-thread continuation.** This document is a verified status snapshot from GitHub. It supersedes *status claims* in older dated handoffs, README, AGENTS historical appendices and old issue descriptions, not their engineering evidence. Re-read live main/PRs/CI before code changes. No new feature or physical FAT is claimed by this documentation.

## 0. Verified frozen baseline

- Repository: https://github.com/masarray/arsonmix
- Main commit at audit: **4d14251bc21ed755e08a51b50aa3f1bcd2008cb2** (2026-10-29 10:01:14 UTC).
- Main Windows native build/CTest/package: **SUCCESS**, https://github.com/masarray/arsonmix/actions/runs/40854197486
- Main Chromium UI smoke: **SUCCESS**, https://github.com/masarray/arsonmix/actions/runs/40854197550
- Main Pages publish: **SUCCESS**, https://github.com/masarray/arsonmix/actions/runs/40854346099
- **None of the above is a certified physical ASIO/WASAPI clean-audio FAT.** Crackle issue #15 remains OPEN and must not be marked fixed based only on CI.

### Status contract

- **MERGED** = code in main and relevant automatic checks observed, not hardware-certified.
- **PARTIAL** = an important genuine working slice exists, but product acceptance not complete.
- **OPEN** = active issue/PR not merged, regardless of branch CI status.
- **FAT UNQUALIFIED** = no adequate real-hardware evidence of the quality claim.
- The current target is **ONE production live mixer**, not selectable Legacy CH1 vs operator Routing LAB.

## 1. Already delivered — DO NOT REBUILD

| Area | Actual status at verified main | Protected source / evidence |
| --- | --- | --- |
| Approved compact 10CH+MASTER skin; no heavy passive hover | MERGED | #140 universal LCD/splash, #145 hover-inert, main GUI CSS build parity |
| Native 10 input strips + 4 independent stereo AUX FX returns | MERGED but opt-in routing path | P1I/P1J/P1K, docs/P1K_TEN_INPUTS_FOUR_DEDICATED_AUX_20261029.md |
| Stable per-lane VST3 instance reuse across eligible route modifications | MERGED partial | P1J, LiveChannelFxGraph |
| CH1 legacy multi-FX and Orbit executes *inside* 10CH route graph | R0A MERGED, #144 | docs/R0_UNIFIED_CH1_LANE_MILESTONE_20261029.md |
| Real native input patch grid, sparse physical ports, stereo L/R, device epoch/ACK | R1 MERGED, #146 | docs/R1_NATIVE_INPUT_PATCH_MATRIX_20261029.md |
| Premium integrated ROUTING workspace rather than separate center dialog | MERGED in 4d14251 | docs/R0_PREMIUM_ROUTING_WORKSPACE_20261029.md |
| FX rack atomic MOVE, stable instance identity, bypass envelope, DearVR POLAR Orbit | MERGED foundations | #122, #107 and Orbit milestones; protect from old branches |
| MASTER native LUFS-I + 4x dBTP analysis | MERGED only for 48k DIRECT stereo | #142, docs/P1K_NATIVE_BS1770_DBTp_20261029.md |
| Portable Studio Plugin Vault and verified backup foundation | PARTIAL | #85, docs/ARD_PORTABLE_STUDIO_V1_20261027.md |
| Show/Snapshot schema, transactional storage, native zero-VST DRY Show SAVE | MERGED partial | P4 stages 1–3; not full FX-equipped live recall |
| Binary packaging/provenance independent verifier, lean Windows+Chromium CI | MERGED foundations | docs/P0_14_RELEASE_ENGINE_WORKFLOW_AUDIT_20261027.md; docs/CI_WORKFLOW_STRATEGY_20261028.md |

Do not duplicate a routing renderer, second audio callback, second FX bus graph, second snapshot authority or visual patchbay. Retain approved metal assets and CSS ownership; source-generated CSS/standalone parity is mandatory.

## 2. True remaining gaps, not cosmetic unfinished labels

### P0: native production graph consolidation — issue #149 (R0B)
- **OPEN / NOT delivered**: startup still has legacy CH1 vs opt-in LiveDryRoutingLab lifecycle; R0A does not equal full single production mixer.
- CH2–10 must not be presented as always-live if their native topology is not active/valid. CH1 FX ADD/REMOVE/MOVE/Orbit lifecycle has not been fully migrated to a continuous unified graph.
- Deliver one selected-device render graph, preserve processor identity/state/tail, ACK and mute/epoch fences, rollback, and output silence on missing ports.
- No UI rename-only shortcut. Issue: https://github.com/masarray/arsonmix/issues/149

### P0: real device/zero-FX reliability — issue #15
- **OPEN / FAT UNQUALIFIED**: physical zero-VST crackle was observed. Different capture/render clocks may contribute but are not proven sole cause. Use output-only, capture-only, dry-through and RT budget/provenance tests. Do not equate callback gaps with hardware render underruns.
- No physical acceptance for uninterrupted live changes, click-free FX moves, ASIO/WASAPI rates/devices just because Windows CI passes.
- Issue: https://github.com/masarray/arsonmix/issues/15

### P0: transactional negative ACK / pending state — PR #147
- **OPEN** on head 904c40ce828dc7832fe6ad53f58fc9143be4a01f. Targets Studio backup busy rejecting routingDryApply before the standard handler without a negative ACK, leaving UI APPLY pending.
- Branch Chromium SUCCESS https://github.com/masarray/arsonmix/actions/runs/40850266409 and Windows SUCCESS https://github.com/masarray/arsonmix/actions/runs/40850266555 . These are on PR head, NOT latest main.
- Reconcile tiny diff (Main.cpp, web/monitor.js, UI/tests), update base if required, rerun required exact-head validation and merge as an early corrective milestone. Avoid redundant reimplementation.

### P1: full native Show recall and safe UI persistence
- PR #141 **OPEN**, DRY-only Show browse/recall, zero FX. It is based on older code and uses legacy LAB UX. Salvage functional native validation/store/ACK, adapt to R0B and merged R1 workspace; do **not** bulk merge old Main.cpp / monitor.js / bridge.js.
- Issue #132 **OPEN**: browser UI-only snapshot mutation can be non-atomic on storage failure/malformed recall. Keep UI preview state separate from native truth until native SSOT is ready. One durable Show authority, no misleading real-VST claim.
- Full VST3 state capture/recall including plugin identity/Orbit, hardware remapping, snapshot safes, safe FX lifecycle and portable restore remain **NOT delivered**.
- PR #128 **OPEN stale**; its useful concept/code should be reviewed selectively; portions already merged/superseded.

### P1: internal FX/send and physical outputs
- Existing 4 dedicated AUX stereo **return to MAIN**; they are not four arbitrary hardware outputs. Current OUTPUT PATCH tab is **read only** MAIN L/R. Multi-bus physical output matrix not implemented.
- R2: consolidate internal send matrix/FX returns, mix vs FX bus semantics; preserve PRE/POST, no cycle/self-feedback and stable FX state. Do not create redundant AUX engine.
- R3: device-bound output patch for supported MAIN/monitor/record/sub/headphone ports, including mono/stereo and driver-masked sparse ports. Reject missing/stale/clock-incompatible endpoints; no UI fake functionality.
- Group/DCA/MATRIX/CUE and arbitrary bus-to-bus routes are **not automatically delivered** by 4 AUX.

### P1/P2: PDC, multitrack and platforms
- Plugin Delay Compensation and phase-aligned parallel dry/wet, seamless live topology edits, all-channel multi-insert VST3, master inserts and complete hardware output modes require dedicated gates.
- Native master LUFS-I / true peak currently qualified for **48k DIRECT** path only; 44.1/96k and independent clock are not silently supported. Issue #135 remains open for broader acceptance although #142 merged the 48k slice.
- Windows-first JUCE VST3. Mobile remote controller != Android native VST3 host; neither is yet a production deliverable. System audio capture, mix-minus, multitrack playback are later features.

## 3. Open PR triage — order, ownership and stale branches

| PR(s) | Disposition | Why |
| --- | --- | --- |
| #147 | PRIORITY review/rebase/merge | Small safety/UX pending-ACK defect, branch checks green |
| #141 | SALVAGE and reconcile after R0B contract | DRY Show recall, old LAB/GUI and older main base |
| #128 | DO NOT BULK MERGE | GUI/Audio Setup/snapshots overlap already merged main |
| #115, #117 | HISTORICAL/SUPERSEDED for production graph | Early dry routing code predates P1I/P1K; extract only unmerged tested behavior |
| #113, #59, #60 | HISTORICAL/DIAGNOSTIC | Old handoffs/GUI experiments, not source of current approved skin |
| #25, #26, #29 and #1–10 | HISTORICAL/EXPERIMENTAL | Do not replace merged P0 native device, FX or current GUI from old stacked heads |

**Do not close an old PR just to clean counters before checking unique functionality and owner instructions.** Mark it superseded with pointer/patch inventory if actually safe. Archive conflicts are not implementation evidence.

## 4. Issue reconciliation — avoid misleading task status

- Issue #143 is **CLOSED**, but full R0B was not delivered. NEW active issue #149 explicitly covers this gap. Do not reopen/rewrite #143's historical product request blindly.
- Issue #135 is OPEN although 48k direct MASTER measurement (#142) is already merged; preserve it for wider sample-rate/independent clock acceptance only, no second 48k analyzer.
- Issue #109 describes many capabilities as absent at its 2026-10-28 baseline; its IN PATCH/10CH/AUX requirements are partially implemented. Track remaining physical output/GROUP/graph capabilities without resetting the original graph.
- Issue #95 contains older all-CH rack and visual requirements; all-channel VST3 chain lifecycle remains incomplete while some drag/reorder/visual items are merged. Do not rebuild approved faders/hover/Orbit.
- Issue #85 continues to control unlimited **catalog import** vs bounded simultaneous realtime DSP; identical public/personal binary capabilities, no proprietary VST in public package, portable workspace, explicit device revalidation.
- Issue #137 is a **historical handoff snapshot** (older main and transient CI failure) and must not override this refreshed live audit.

## 5. Updated work sequence: dependencies, acceptance and CI economy

1. **G0: merge/resolve #147 ACK correctness**, after validating against latest main. Deliver negative ACK on busy/rejection, UI pending always releases and acceptedRoute remains unchanged. No Audio callback changes.
2. **G1: R0B #149 single production mixer**, end legacy CH1 opt-in LAB split; preserve native CH1 multi-insert, Orbit and 10CH+4AUX real routing. Explicit unit/control-graph tests; truthful startup; fail-silent hardware/device transitions.
3. **G2: R2 INTERNAL/send/FX refinement**, use existing 4 AUX foundation and unified graph; define FX-return vs mix-bus behavior rather than copy/paste new buses.
4. **G3: R3 actual device-bound OUTPUT PATCH**, enabled physical output ports, independent bus routing, sparse stereo/mono, gain/summing/headroom and per-output safety.
5. **G4: PDC + safe live structural FX edits**, preserved plugin state/tail, latency report and phase alignment; vendor/driver constraints explicit.
6. **G5: FULL Shows/Snapshots + Portable Studio**, on real native SSOT; transactional state capture and verified recovery, device remap and no auto-unmute.
7. **G6: playback/system audio/mix-minus/remote/mobile platform choices** only after native live core has acceptance evidence.

**Parallel lane:** issue #15 root-cause isolation and consolidated real-device hardware FAT. This is a release blocker, not a reason to revert useful already-merged work. Document the exact hardware, backend, clock, sample rate, buffer, plugin set, measured RT budget, provenance-tagged discontinuities and loopback latency before certification.

### Required merge gates

- Before implementation: refresh main SHA, open PRs, owned paths and build/test baseline. Never assume a milestone is open from older document.
- One subsystem owner per patch: realtime native C++ core, device bridge, native Show/Studio, web source/UI, generated artifacts. No competing threads overwrite identical source files without a deliberate dependency/rebase.
- Never allocate/lock/log/scan/serialize/perform file I/O or instantiate/release plugins inside the callback. Control prepares, validates, publishes atomically at buffer boundary, keeps bounded graph retirement.
- Structural routes require exact native physical mask, epoch/revision, expected current topology, fail-silent/OUTPUT MUTE gates where appropriate, and explicit accept/reject ACK. UI DRAFT != LIVE.
- Exact-head native MSVC+CTest and Chromium as relevant; dedicated hardware FAT separately; generated stylesheet and embedded preview byte parity when GUI changes.
- Keep CI efficient: one Windows workflow for real binary + native tests, one Chromium smoke for GUI, no redundant build matrices or test relaxations. Doc-only changes should not consume costly CI.
- Before claiming milestone done, point to changed implementation, passing automated tests on that exact SHA, user-visible native behavior and separate physical FAT qualification (or state explicitly that FAT is pending).

## 6. Customer voice translated into engineering priorities

Based on 85 primary comments + 47 replies retrieved for https://youtu.be/mFzR9xBzuao on 2026-10-29, the core signals are: configurable ASIO I/O and multi-output, true routing matrix, shared FX send/return (CPU/latency concern), AUX/group/monitor live workflow, stable distributable download, plus requests for multitrack, system-audio loopback, Android/macOS and vocal harmony. This is audience input, not proof of demand ranking across the global market.

**Product decision:** one Windows-first, cross-platform-ready, modular native mixer with 10CH+4AUX current baseline; capability-aware expandability, no proprietary device assumption, small responsive GUI, honest output availability, Shared FX and Portable Studio for everyone. Do not create separate Lab, premium/private engine or feature-limited public app.

## 7. Cross-thread handoff checklist

- Verify latest main/head and recent CI; use this doc as starting inventory, not permanent SHA pin.
- Read AGENTS.md, docs/GUI_BASELINE_LOCK_2026-10-25.md, docs/ARD_SMART_AUDIO_ENGINE_V1_2026-10-25.md, docs/R1_NATIVE_INPUT_PATCH_MATRIX_20261029.md, docs/R0_PREMIUM_ROUTING_WORKSPACE_20261029.md, docs/P1J_STABLE_FX_ROUTING_SESSION_20261029.md, docs/P1K_TEN_INPUTS_FOUR_DEDICATED_AUX_20261029.md and issues #149/#15/#85.
- Make one meaningful native milestone per PR; cite the exact current base, test evidence, capability claim and remaining release gates. Do not make docs into endless planning work.
- When production status materially changes, update this canonical status or link a newer reconciliation in AGENTS.md; don't leave contradictory old status as the only entrypoint.
2 changes: 2 additions & 0 deletions docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# ArSonMix — CANONICAL NEXT-THREAD HANDOFF (2026-10-29)

> **STATUS SUPERSEDED BY LATER RECONCILIATION (2026-10-29 17:55 WIB):** See [canonical status after R1 and R0 premium routing merged](CANONICAL_PROGRESS_RECONCILIATION_20261029.md). The original handoff below remains historical evidence. Do not run its old next steps without checking current main / PR statuses; R0B is #149 and #147 is the open ACK fix.

> CURRENT CONTINUATION ENTRYPOINT. Read this before editing. This supersedes status claims in the dated 2026-10-25/26/27/28 handoffs, NOT their historical engineering evidence. Every new thread must re-read live main, open PRs and CI because this snapshot can age.

## 0. Verified repository state at handoff
Expand Down