From 2e4073a15b37b4811930374df50bb1c7b0e929f8 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Thu, 29 Oct 2026 17:59:52 +0700 Subject: [PATCH 1/3] docs: reconcile main, open PRs and hard production gates after R1 --- ...ONICAL_PROGRESS_RECONCILIATION_20261029.md | 130 ++++++++++++++++++ 1 file changed, 130 insertions(+) create mode 100644 docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md diff --git a/docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md b/docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md new file mode 100644 index 000000000..55a5ff788 --- /dev/null +++ b/docs/CANONICAL_PROGRESS_RECONCILIATION_20261029.md @@ -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. From a26d81957a28abefbc95e27b3a3339996b3d4c92 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Thu, 29 Oct 2026 18:00:15 +0700 Subject: [PATCH 2/3] docs: make verified R1 reconciliation the first agent entrypoint --- AGENTS.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 9ec3994fd..c6a269a2f 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. From 3f4d4b3f8026120ea42747b799b630beecce3fc9 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Thu, 29 Oct 2026 18:00:19 +0700 Subject: [PATCH 3/3] docs: mark previous handoff superseded by current verified status --- docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md b/docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md index 964a14b7e..df1bd9853 100644 --- a/docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md +++ b/docs/HANDOFF_ARSONMIX_NEXT_THREAD_20261029.md @@ -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