Skip to content

[INT-1][DELIVERY] One testable Windows Integration Preview — G-MV + N-MOD + I/O + Graphic EQ #837

Open

Description

@masarray

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 .smix session.
  • 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

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.
  • .smix save/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)

  1. On invocation, inspect main, your PR HEAD/base/diff/checks/reviews and linked dependencies fresh; treat this issue as targets, not automatically current facts.
  2. Fix the nearest blocking risk and close a meaningful user-testable vertical slice. No new PR series solely to increase milestone counters.
  3. 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.
  4. 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.
  5. 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

  1. masarray commented on Nov 20, 2026

    @masarray
    OwnerAuthor

    Coordination bootstrap — completed, 20 Nov 2026 (Asia/Jakarta)

    Durable discovery is LIVE in main: AGENTS.md navigation PR #838 protected-squash MERGED at f509028f7bf18319ef00e1a8767ba9787a37a9d5 after 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 main and 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.

  2. masarray commented on Nov 20, 2026

    @masarray
    OwnerAuthor

    INT-1 G-MV handoff (20 Nov, latest live): main@f509028f7bf18319ef00e1a8767ba9787a37a9d5. G-MV36 #832 source HEAD ce673e9b48a71591a5f42e837093efa4946c355b: exact-head Full Chromium /preview/ #44672547278 SUCCESS, fast GUI/native/FX/ImmerSIB PASS, Codex reviewed clean; protected Required Gate remains PENDING nativeFull because 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 commit fc5450b5125d3bf5c3cacc7a1e677a358013cb19; 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.

  3. masarray commented on Nov 20, 2026

    @masarray
    OwnerAuthor

    INT-1 single-ASIO installer lane must remain independent of experimental qualified two-interface ASIO. Current IO-2 foundation #825 HEAD e071e16e7136d58204acf8aaab6b1eb0d54d5d28 is 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 main with ONE verified ASIO A as intended. Do NOT wait for #825, #830, a second physical interface, IO-5 .smix A+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.

  4. masarray commented on Nov 20, 2026

    @masarray
    OwnerAuthor

    INT-1A N-MOD handoff, 20 Nov 2026 (Asia/Jakarta)

    N-MOD | c04ed7bcdd8b352b8905cb7d3d1fc9d99a9d6d5a on main | 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 new main. 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 5c02af1846383f4e687419a1c847a48da6fd91db and squash have identical tree 1646bea4dbdf85d634d94983e6245a7f67285f86. 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.

  5. masarray commented on Nov 20, 2026

    @masarray
    OwnerAuthor

    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 3bc60cebf5a4d94e310285f9f07e89a441caeb4a over main@c04ed7bcdd8b352b8905cb7d3d1fc9d99a9d6d5a (the MERGED N-MOD #833). Main-diff: exactly six source/contract files src/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 HWND requestId/instanceId lease ACK, offline and M4 readback, five approved built-in WebView editor selectors, logical vendor fallback, and G-MV37 M/ST survive. Native N-MOD .smix optional 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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions