Repository navigation
Description
INT-1 — one user-testable Windows integration preview, not another endless refactor wave
Owner goal (20 Nov 2026, Asia/Jakarta): deliver ONE verifiable ArSonMix Windows x64 portable + installer from integrated main, with exact source SHA, so the owner can actually test the latest mixer/GUI/FX/audio work. Favor an early usable, truthfully scoped alpha over waiting for every experimental PR. This issue is the cross-thread coordination board, not a new status publisher, mutex, approval bureaucracy, or authorization to bypass branch protection. Any ChatGPT/Codex agent asked to resume a workstream should read this issue and AGENTS.md at that time; chat threads do not automatically receive GitHub comments or run in the background.
Canonical engineering invariants
- Keep ONE approved
/preview/GUI (same assembled WebView2 native GUI), one accepted native ChannelId/EdgeId PCM+FX render graph, single primary ASIO render-clock authority, native ACK + exact installed readback. Do not fork mixer state, bypass physical device identity, replace GUI, or regress approved GAIN/SOF. - Real-time callbacks: no allocation, lock, disk/COM/UI/driver open; secondary capture/output adapters are I/O-only with bounded FIFO/ASRC and MUST NOT render another mixer graph. No automatic speaker output arm, unsafe ASIO fallback or loss of
.smixsession. - Follow current
AGENTS.md, owner-approved PRD/ARD, protected exact-SHA CI and hardware FAT requirements. No force merge, no CI waiver, no fabricated test results, no premature dual-vendor ASIO marketing. - Autonomy with integration discipline: each lane continues useful work on its own branch; reconcile specific changed hunks against live main and related heads before protected merge. No central per-commit approval or expensive duplicate CI; freeze speculative new submilestones ONLY while that lane is shipping its immediate integration blocker.
Dependency DAG (refresh actual GitHub before acting)
| Lane / PR | Next required delivery and dependency | User-visible gate |
|---|---|---|
| GUI G-MV36 #832 | Finish exact-head Windows/Chromium/Codex/Required Merge Gate, reconcile main, protected merge | Native FX editor requests/Windows HWND ACK correctly correlated; no stale editor reopen |
| GUI G-MV38 #836 (stacked on #832) | After #832 merges, retarget/reconcile to fresh main, requalify exact SHA and protected merge | Single approved /preview/ FX editor surface incl. future built-in Graphic EQ |
| Native N-MOD/M2 #833 | Diagnose exact failing ImerSip Windows/native check, repair .smix SAVE/OPEN single-owner admission, review & protected merge | Preserved durable .smix, device restart recovery, native request/readback, no PCM regression |
| Multi-device IO-2C #825 | Fix unresolved Codex P1 primary restart / explicit qualified-map retirement (and any later findings); exact-head Windows/Codex/merge gate; merge only safe foundation | A primary playback/recovery not muted by retained B map; no unsupported LIVE GUI promise |
| IO-3 #830 (stacked on #825) | After parent merge: retarget, finish typed B readback, accepted GUI transaction + persistence gates when ready; keep unsafe feature OFF/draft | Do NOT claim installable dual-ASIO or independently routed BUS/CH B output without real two-vendor physical FAT |
| Built-in Graphic EQ 31 #835 | Exact-head Windows compile/CTest/FX editor/param and stability gate; reconcile FX editor policy before merge | 31 dbx-centered frequencies, real native insert, SVG faders, bypass and .smix recall |
| Legacy product drafts (#731, #708, #635, #668, #661 etc.) | Do not mass merge stale branches; cherry-pick/reimplement only needed validated hunks into fresh scoped PRs, preserve approved GUI and state | Guitar FX visual acceptance remains separate; unrelated experiments must not block first installer |
| Distribution #450 | Only after integrated SHA + gated Windows packaging qualification, use existing owner-only exact-SHA release controller | Verified portable and Inno setup/upgrade/uninstall, BUILD_PROVENANCE, SHA256, stable download URLs |
Snapshot only, not a current-status assertion: at board creation #832/#836/#825/#830/#833/#835 were open, and #835/#830 were drafts. #832 Windows CTest had recently passed; #825 contained a real P1 restart review; #833 a failing ImerSip Windows check. Every agent MUST re-fetch fresh heads, review threads, statuses and main before touching code.
Delivery waves with fail-closed feature flags
- INT-1A (first useful alpha): integrate verified GUI G-MV36/38 + N-MOD session/recovery + existing primary single-ASIO mixer/FX/VST3. Test real WebView2, direct ASIO monitoring, restore/restart, FX editor lifecycle,
.smix. Ship a Windows preview when these are green, even if experimental multi-device and Guitar FX visual overhaul remain pending. - INT-1B: integrate the Graphic EQ 31 native effect and matching editor only after the native FX and combined GUI gates pass; include in the first candidate if ready, otherwise next candidate with scope stated honestly.
- INT-1C: qualify multi-device capture end-to-end only with accepted B transaction/readback, persistent physical-intent/remap and attended two-vendor Windows FAT. Can merge safe isolated foundation independently if no regressions; no public LIVE dual-ASIO claim before this wave. Independent physical BUS/CH sink is distinct future work.
Integration owner handoff / file overlap
- GUI owns
web/approved-native-bridge.js, FX/view-models,tests/approved_native_m2_contract.test.cjsduring refactor(gui G-MV36): correlate FX editor requests, installed leases and native HWND ACK #832/refactor(gui G-MV38): single allowlisted FX editor surface policy for /preview/ #836; I/O must consume one native-approved inventory later, not invent parallel JS authority. - N-MOD owns native session/control
Main.cpp/native coordinator and.smixsemantics for refactor(native M2): single-owner .smix SAVE/OPEN admission and negative regression matrix #833. I/O owns B device source/ASRC/lease implementation and dedicated tests; coordinate any sharedLiveAudioEngine.h,CMakeLists.txtor publisher hunks by diff, never whole-file overwrite. - FX feat(native FX): Graphic EQ 31 with dbx frequencies and supplied SVG faders #835 owns native EQ DSP/editor and dedicated tests; coordinate surface/catalog entry with merged refactor(gui G-MV38): single allowlisted FX editor surface policy for /preview/ #836 rather than duplicating browser editor selectors.
- Every integrator records exact main SHA, PR HEAD, changed-file overlap, issues resolved, tests actually run, merge result, and one next action. Report owner-facing status CODED / CI TESTED / MERGED MAIN / INSTALLER EXISTS / PHYSICAL FAT DONE, never conflate them.
Release candidate acceptance checklist (one integrated exact commit)
- Latest main, stacked parent dependencies and critical PR review threads reconciled; no unresolved safety P1/P0.
- Approved /preview/ = assembled Windows WebView2 GUI. Full Chromium, native FX editor open/close/reopen, ACK/readback, fader/source/mute/SOF/route checks pass.
- Native Windows C++/CTest + focused PCM regression; primary ASIO identity remains stable, no output auto-arm, no regression when secondary is absent/disconnected, VST3 insert/editor + bypass.
-
.smixsave/open/restart/recovery, valid/invalid source map, crash-safe rollback, no durable state corruption; test Graphic EQ frequency/response/param/FX recall if included. - Tested installer + portable of the same exact SHA; Inno fresh install/upgrade/uninstall, provenance/checksums and URLs; release notes distinguish implemented vs untested hardware.
- Physical ASIO A+B, low-latency and two-vendor device-specific tests are tracked as NOT RUN until operator supplies real evidence; never infer from CI.
Agent execution protocol (small and actionable)
- On invocation, inspect
main, your PR HEAD/base/diff/checks/reviews and linked dependencies fresh; treat this issue as targets, not automatically current facts. - Fix the nearest blocking risk and close a meaningful user-testable vertical slice. No new PR series solely to increase milestone counters.
- Run fast contracts + the one relevant exact-head Windows/native/UI FAT, reconcile upstream, request targeted review, and protected squash merge only if all required checks pass.
- Post ONE compact milestone receipt on your PR and, when a dependency changes, ONE handoff to this issue:
LANE | SHA | MERGED/OPEN | CI | blocker | next owner/action | visible impact. Avoid spam or redundant CI. - When integrated candidate is green, hand off to the release owner for exact-SHA package; do not post /arsonmix-release casually. Owner gets download link only after verified artifact exists.
Definition of done for this board: owner can download a newly built Windows installer/portable from a traceable integrated source SHA and verify the core mixer + relevant GUI/FX/session workflows; remaining experimental I/O/Guitar FX limitations are explicitly itemized. This board remains a coordination record; it cannot remotely resume independent ChatGPT conversations.
Activity
masarray commentedon Nov 20, 2026
Coordination bootstrap — completed, 20 Nov 2026 (Asia/Jakarta)
Durable discovery is LIVE in
main: AGENTS.md navigation PR #838 protected-squash MERGED atf509028f7bf18319ef00e1a8767ba9787a37a9d5after exact-head Required CI Merge Gate SUCCESS (docs only). No native/GUI/ASIO change and no new installer made by this docs PR.Targeted PR handoffs already posted: GUI #832 → #836; N-MOD #833; IO #825 → #830; Graphic EQ #835; legacy native editor #731; Guitar FX #668. Linked from existing I/O epic #812 and N-MOD epic #527.
What is NOT done: No G-MV/N-MOD/I-O/Graphic-EQ production merge or combined Windows binary has been performed by this coordination task. Child agents/independent chats are not automatically woken by comments. When invoked, each must read
mainand this board, fix its own blocker, run actual protected gate and report exact-SHA results; no speculative release trigger on #450.Next integration checkpoint: #832 legitimately merges → #836 rebased/qualified; #833 actual ImerSip Windows issue fixed; #825 primary-restart P1 fixed → #830 staged as non-public until hardware FAT; #835 native DSP/FX gate. Release owner may then package first qualified single-ASIO Windows preview without waiting for speculative B physical support.
masarray commentedon Nov 20, 2026
INT-1 G-MV handoff (20 Nov, latest live):
main@f509028f7bf18319ef00e1a8767ba9787a37a9d5. G-MV36 #832 source HEADce673e9b48a71591a5f42e837093efa4946c355b: exact-head Full Chromium/preview/#44672547278 SUCCESS, fast GUI/native/FX/ImmerSIB PASS, Codex reviewed clean; protected Required Gate remainsPENDING nativeFullbecause exact-head Windows MSVC/CTest #44672591738 is still building. NO bypass/merge while pending. G-MV38 #836 reconciled onto latest #832 in a new two-parent commitfc5450b5125d3bf5c3cacc7a1e677a358013cb19; diff vs parent is ONLY four expected FX-editor VM, native bridge, M2 and Harmony contract files; Fast UI/Native & Codex review clean. Existing M/ST/G-MV37, one native PCM,/preview/and INT-1 AGENTS guidance retained. N-MOD #833 (C++ Main session) remains independent/OPEN, Graphic EQ #835 still DRAFT and IO-2C/#825 + IO-3/#830 independently OPEN. No integrated Windows installer/portable has been generated by G-MV yet, physical ASIO FAT NOT RUN. Next: #832 protected merge only when Windows gate green → retarget #836 to new main → exact-head Chromium plus appropriate Windows/FAT and merge after protected checks; then coordinate source-SHA installer with N-MOD/session integrator. No mass merge of other PRs.masarray commentedon Nov 20, 2026
INT-1 single-ASIO installer lane must remain independent of experimental qualified two-interface ASIO. Current IO-2 foundation #825 HEAD
e071e16e7136d58204acf8aaab6b1eb0d54d5d28is NOT merged and its exact-head Windows MSVC/CTest is in progress: https://github.com/masarray/arsonmix/actions/runs/44675354182. After fixing the original P1 primary restart retained-map retirement, latest Codex reviews identified separate callback-scratch and ASRC-clock STOP races. Both source fixes and deterministic concurrency regressions are committed to #825; Fast Native/Logical/M1–M2 pass. Protected Merge Gate remains pending; do not treat as release qualified yet.INT-1 unblocked: build/verify/package/test current
mainwith ONE verified ASIO A as intended. Do NOT wait for #825, #830, a second physical interface, IO-5.smixA+B schema or dual-vendor FAT. #830 remains draft; no Device B GUI picker must be exposed before hardware qualification. Do not merge this integration PR into an active INT-1 packaging branch while its own artifact/CI is being sealed. On a safe future main merge, reconcile exact main SHA and rerun whatever scope actually changed, but never reinterpret an earlier installer as dual-ASIO-qualified. Source coordination #812.masarray commentedon Nov 20, 2026
INT-1A N-MOD handoff, 20 Nov 2026 (Asia/Jakarta)
N-MOD |
c04ed7bcdd8b352b8905cb7d3d1fc9d99a9d6d5aonmain| MERGED #833 | Windows MSVC / realtime CTest 105/105, ImerSip Windows GUI + native CTest PASS, Required CI Merge Gate PASS, independent review complete without findings | N-MOD dependency cleared | G-MV owners rebase and qualify #832 then #836 against the newmain. INT-1 owner takes the integrated Windows installer candidate through #450 after the GUI gates | Windows ImerSip application build restored and native .smix SAVE/OPEN and checkpoint recovery qualified.Exact qualified PR head
5c02af1846383f4e687419a1c847a48da6fd91dband squash have identical tree1646bea4dbdf85d634d94983e6245a7f67285f86. Source merge simulations with the current G-MV #832 and I/O #825/#830 heads were clean. Single primary ASIO/PCM FX graph remains the INT-1A scope. Integrated installer and real hardware FAT remain open.masarray commentedon Nov 20, 2026
INT-1A / G-MV integrated code receipt (20 Nov 2026): We consolidated BOTH G-MV36 #832 and G-MV38 #836 into existing PR #836 exact HEAD
3bc60cebf5a4d94e310285f9f07e89a441caeb4aovermain@c04ed7bcdd8b352b8905cb7d3d1fc9d99a9d6d5a(the MERGED N-MOD #833). Main-diff: exactly six source/contract filessrc/Main.cpp,web/approved-native-bridge.js,web/approved-fx-rack-view-model.js,tests/approved_native_m2_contract.test.cjs,tests/imersip_p92_catalog_contract_test.py,tests/native_harmony_assembly_test.py; behind=0. Exact old FX HWNDrequestId/instanceIdlease ACK, offline and M4 readback, five approved built-in WebView editor selectors, logical vendor fallback, and G-MV37 M/ST survive. Native N-MOD.smixoptional editor.has_value()fix also survives. No I/O #825/#830, no Graphic EQ #835, no duplicate/preview/or PCM engine.Exact combined SHA checks so far: Fast UI #44676859044 SUCCESS; Fast Native #44676859040 SUCCESS; owned native FX editor Windows #44676859211 SUCCESS; exact HEAD Codex review: no major findings. Triggered ONE approved full Chromium UI run #44677094222 and ONE Windows FAT (MSVC/CTest + portable+Inno setup, no duplicate native runner) #44677134203; both IN PROGRESS at this receipt, zero final success claimed. Required protected merge gate pending, PR #836 still OPEN. No new INT-1 installer artifact verified yet; no physical ASIO FAT witnessed. #832 remains OPEN pending confirmation of complete absorption into successful protected #836 merge; close as superseded only after that merge. I/O #825 callback reclamation/hardware proof remains a distinct risk and is EXCLUDED from this single-ASIO candidate.
Next owner/action: resume exact-SHA run status and logs, repair real failures in #836 only, refresh Required Merge Gate through official workflows, protected squash merge if all exact-head scoped checks pass and main is up-to-date. Verify FAT artifact IDs/provenance/hash and provide user link; do not promote an older alpha package as this build.