diff --git a/AGENTS.md b/AGENTS.md index dd0f8865a..be76be13d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,3 +1,5 @@ +> **ACTIVE RELEASE ORCHESTRATION v7 (2026-11-01):** [ONE PRODUCT RELEASE TRAIN](docs/RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md) and owner packets [ENGINE](docs/workstreams/ENGINE_DELIVERY_V7.md), [GUI](docs/workstreams/GUI_DELIVERY_V7.md), [INTEGRATION/RELEASE](docs/workstreams/INTEGRATION_RELEASE_DELIVERY_V7.md). Complete one real feature-parity Windows mixer BEFORE requesting owner/customer UAT. PRD/ARD v5 remain normative product/architecture; v7 supersedes older v6 delivery sequencing, not v6 realtime safety. #274/#275 are GUI patch sources and #276 is partial staging, not a final user build. + # ArSonMix — SINGLE EXECUTION AUTHORITY (v6 / 2026-11-01) **READ FIRST:** [PRD v5](docs/PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md) + [ARD v5](docs/ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md) + [EXECUTION LOCK v6](docs/EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md). Workstream handoffs: [ENGINE](docs/workstreams/ENGINE_UNIVERSAL_CONSOLE_V6.md), [GUI](docs/workstreams/GUI_OPERATOR_CONSOLE_V6.md), [INTEGRATION/FAT](docs/workstreams/INTEGRATION_FAT_CONSOLE_V6.md). diff --git a/README.md b/README.md index f7208189a..a0de622ba 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,5 @@ +> **Current coordinated delivery:** [RELEASE TRAIN v7](docs/RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md) · [ENGINE](docs/workstreams/ENGINE_DELIVERY_V7.md) · [GUI](docs/workstreams/GUI_DELIVERY_V7.md) · [INTEGRATION](docs/workstreams/INTEGRATION_RELEASE_DELIVERY_V7.md). The owner will be asked for UAT only after one integrated feature-complete Windows mixer; do not send individual First Sound/partial staging EXEs as a finished product. + # ArSonMix — Native Realtime Live Mixer and VST3 Host A Windows-first **live performance digital mixing console** for stage, karaoke, podcast/radio and flexible physical/virtual output, using the *console workflows* of Studio One / Adobe Audition and *live banking/routing* concepts of Waves eMotion LV1. Not a timeline/DAW audio editor, recorder or OBS-only utility. diff --git a/docs/EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md b/docs/EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md index 6370f91fe..982e36861 100644 --- a/docs/EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md +++ b/docs/EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md @@ -1,3 +1,5 @@ +> **SEQUENCING UPDATE:** [RELEASE TRAIN v7](RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md) is the active staged delivery and 3-thread synchronization contract, superseding this v6 plan where its merge/test order conflicts. PRD/ARD v5 and v6 audio safety invariants remain binding. Do not request customer test of an incomplete First Sound candidate. + # ArSonMix — EXECUTION LOCK v6 / UNIVERSAL LIVE CONSOLE **Established:** 2026-11-01. **Role:** binding implementation plan; not an attestation of shipping features. **Spec authority:** [PRD v5](PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md) and [ARD v5](ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md). v6 governs **execution sequencing, branch ownership and stop rules**, not a new product scope. Contradictory older milestone/GUI plans are historical, not actionable. diff --git a/docs/RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md b/docs/RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md new file mode 100644 index 000000000..87384cc58 --- /dev/null +++ b/docs/RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md @@ -0,0 +1,68 @@ +# ArSonMix — ONE PRODUCT RELEASE TRAIN v7 (2026-11-01) + +**Binding delivery orchestration, not a shipped-feature claim.** PRD v5 + ARD v5 define functionality and native architecture. Existing execution lock v6 retains safety rules. This v7 document supersedes earlier workstream sequencing and partial user-testing invitations. + +## Product commitment — ONE COMPLETE WINDOWS LIVE DIGITAL MIXER BEFORE USER UAT +The owner should not debug another half-completed EXE. Internal developers must first build and integrate a coherent operator-facing realtime mixer with the Console functions of Studio One, Adobe Audition Mixer and Waves eMotion LV1: visible IN / processing M-ST / ordered genuine VST3 FX / PRE-POST SEND / independent OUT / PAN / MUTE / SOLO / accurate native meters and faders, dynamic channels, Group, parallel wet FX Return, independent Monitor, Show and lightweight adaptive GUI. This is functional Console parity, NOT timeline/audio editing, MIDI, recorder or copyrighted visual cloning. No claim of 0ms physical latency. + +No requests for customer First Sound, hardware debugging or half-feature beta testing. Internal Windows CTest and UI simulation first; an independently equipped engineer/QA rig must complete physical qualification when available. If the rig is unavailable, explicitly mark hardware FAT PENDING, not passed; do not shift early QA onto the customer. User UAT is invited once after G3 integrated feature readiness and truthful reporting. + +## CURRENT GitHub collision ledger (check live HEAD before any change) +- main e5a3d076: native #269 offline accepted ChannelId PCM golden tests merged; production still legacy fixed M4 10CH+4AUX. +- ENGINE #266 is the single native implementation. GUI #271 / work/operator-console-v6 is the single primary Console UI implementation. FAT #270 owns evidence and workflow YAML. #192 is the cross-owner schema and merge control; #273 first-sound defects and #15 physical crackle remain blockers. +- Native integration #272 is a reusable codec/test patch requiring ENGINE adoption into its actual JUCE WebView dispatcher; a green header CTest does not create the dispatcher. +- #274 is a generated HTML parity patch stacked on GUI branch. #275 is an overlapping M4 First Sound UI improvement: GUI owner must selectively reconcile its useful work into #271, never promote an independent second GUI. +- #276 packages a partial First Sound Windows candidate: an INTERNAL staging experiment, not a universal-console finished product or customer UAT. FAT owner must not declare it ready for the user ahead of ENGINE full-fidelity callback migration. +- Separate green tests of #266/#271/#270 never equal one integrated successful SHA. + +## THREE OWNERS ONLY +ENGINE thread: PR #266, owns engine/core/**, src/**, C++ DSP/device/bridge tests, native one-callback VST ownership/telemetry/Show. Never modify web/**. +GUI thread: PR #271, owns web/**, UI tests, generated standalone HTML using existing CSS/HTML generator. Never modify src/** or engine/core/**; no separate JS PCM/router. +INTEGRATION/RELEASE thread: PR #270, #192 and controlled promotion branch, owns cross-layer schema tests, CI workflows, Windows packaging/provenance and internal physical FAT; never forks GUI/engine production code. #272 reviewed by ENGINE, #274/#275 absorbed by GUI, #276 staging only. + +## FROZEN DATA CONTRACT — one actual native authority +The ENGINE control thread implements arMixConsoleSubscribe -> full accepted ConsoleSnapshot, arMixConsoleIntent -> native control request and arMixConsoleAck -> explicit ACCEPTED/REJECTED/REQUIRES_DEVICE_CHANGE. The browser is only a projection. +Intent example: {requestId:"unique-session:1",deviceEpoch:"69",baseGraphRevision:"3",baseRosterRevision:"4",operation:"SET_SOURCE",targetChannelId:"7",payload:{...}}. +Every ChannelId, device epoch and graph/roster revision is a CANONICAL DECIMAL STRING (native uint64; browser BigInt comparison), NOT a JavaScript Number or strip ordinal. RequestId is a unique-per-editor-connection opaque printable string (not reset-only "1"), echoed byte-for-byte in ACK. No duplicate/replay/stale-epoch/stale-graph accepted. +Snapshot: {schemaVersion:6,productionCallbackLive,device:{epoch,backend, captureDevice,playbackDevice, enabledInputs, enabledOutputs, inputEndpoints,outputEndpoints,sampleRate,bufferFrames,outputArmed},graph:{revision,rosterRevision,channels,destinations,capabilities:{supportedOps,dynamicChannels,groups,fxReturns,monitor}},telemetry:{rawCapture,channelPCM,mainPCM,monitorPCM}}. Field names, allowed operations and native fail-closed behavior must be version-tested against the ACTUAL ENGINE producer; mock fixtures must be generated from this contract, not a competing schema. ACK alone is never physical PCM/LIVE; wait for same-epoch fresh accepted snapshot. + +SOURCE (physical MONO/STEREO pins) and PROCESSING M/ST (channel width) are separate: a mono mic can feed stereo processing but cannot pretend physical stereo IN1/IN1. Verified input/output pins are obtained from active backend mask and mapped to callback ordinals, not invented IN2 or adjacent L/R. A physical route is separate from serial primary Group OUT and parallel wet FX Send. Monitor outputs are separately selectable legal device pins. All RT callbacks remain allocation/lock/scan/GUI free, structural graph/VST edits prepared off callback with rollback; fader/mute/solo/pan/send continuous controls stay RT-bounded. + +## INTEGRATED GATES — all three threads work in parallel WITHIN each gate +### G0 — source/branch reconciliation and wire freeze +ENGINE: incorporate validated #272 schema into sole native bridge design, identify exact production cutover/CH1/Show blockers, publish actual ACK and supportedOps inventory. +GUI: reconcile #274 generated parity and #275 direct First Sound improvements into #271, remove duplicate wizard paths, ensure unique request IDs and accepted-snapshot-only LIVE. +FAT: owns single combined Windows and Chromium workflow YAML, JSON contract fixture from native writer; reconcile #276 as staging only. Verify no cross-owner file collision. +EXIT: one versioned schema, no competing UI/audio renderers, all three owners understand native ops and feature gating. + +### G1 — ONE real production callback + FIRST SOUND, NOT user testing +ENGINE: full M4-fidelity migration of occupied CH01 vendor VST3/Orbit/editor, CH02-10 independent FX, four AUX, sends, MAIN/MONITOR/secondary, Show into one ChannelId JUCE callback. Real active device capture/output pins, raw/channel/main PCM telemetry and Intent/ACK. +GUI: one compact Console home with direct per-strip IN/OUT, single DEVICE drawer; advanced crosspoint/Software Input alias hidden and optional. One verified pin -> IN1 MONO only and clear NO RAW if unfed; no stereo IN1/IN1; no multi-APPLY workflow for normal routing. +FAT: internal native actual-callback PCM test (CH07 IN1, CH02 IN2 when verified), single-pin/NO PCM, native-source rejection/rollback, MAIN mute, hotplug, explicit VB-Cable input feeder diagnosis, 0FX/2FX parity. +EXIT: genuine independent native audio callback and operator-first GUI agree on the same accepted data; no customer test invitation. + +### G2 — full core professional Console functionality +ENGINE: real dynamic CH11+, Group Selected serial PCM with exclusive primary OUT, parallel wet FX Return PRE/POST sends, independent MONITOR to legal physical/virtual output, native per-role VST3 rack load/reorder/bypass/editor, Show with vendor chunks/IDs. +GUI: every native role gets working IN (where legal), M/ST, inserts, sends, OUT, fader/meter, mute/solo/pan, dynamic banks, +CHANNEL, group and FX Return creation and pinned MAIN; all operations display accepted ACK and errors correctly, no dead or decorative controls. +FAT: golden PCM for real inserts/Group/wet Return/monitor, no double-dry, channel/lease stability, Show and failure rollback. Performance and VST failure scenarios covered internally. +EXIT: full user-requested LIVE CONSOLE core feature matrix operational end-to-end in one integration tree. + +### G3 — performance, full integration and release qualification +ENGINE: enforce real-time heap/lock rules, no click on edit/drop/bypass, device and clock fail-safe, deterministic tests with real/native callback. +GUI: responsive GPU-light 1024x600 / 1366x768 / 1680x900, no blur-heavy/hover lag, no relayout on drag; correct mono and independent L/R LED meters and compact consistent faders. +FAT: resolve combined SHA conflicts, CSS/HTML generator parity, Chromium/Playwright+Windows MSVC/CTest and package on ONE exact SHA; Windows EXE checksum, source provenance. Internal real hardware 0FX & full FX QA and 30min crackle #15 as available, disclose unverified hardware honestly. +EXIT: integrated, feature-complete, internally qualified EXE with factual remaining limitations; no separate-branch PASS accepted. + +### G4 — ONE UAT/release candidate +Only now ask the customer to test the finished mixer once, with one EXE and clear device setup; never send G1/G2 partial artifacts as product. Hardware FAT remains pending if no independent rig exists. Do not claim clean sound or parity where evidence is absent. + +## PER-OWNER REPORT AND CI RULES +Each milestone report to #192 MUST include exact SHA and changed files, currently REAL capability vs stub/demo, native PCM/GUI evidence, remaining inter-thread dependency, and integration action. No cosmetic "milestone completed" claim. Targeted tests locally/cheap first, consolidated Windows+Chromium gate only at meaningful slice, read exact logs and fix root cause rather than blindly rerun CI. FAT retains ownership of .github/workflows/*.yml; GUI retains source/generator; ENGINE retains callback. Old PRs are reconciled into these owners, not multiplied. + +## ACCEPTANCE MATRIX — no owner FAT request until all core stages complete +1. Real interface (ASIO/WASAPI) chosen once, 1 pin correctly exposed, silent input correctly diagnosed, no invalid stereo, direct CH IN and verified physical OUT. +2. IN1 -> arbitrary CH07 and IN2 -> arbitrary CH02 (on two-port rig); two actual independent VST3, bypass/reorder/editor, accurate audio and channel meters. +3. Add live CH11, group selected channels to GROUP->MAIN without double-dry, parallel FX Return wet SEND PRE/POST, Monitor to separate compatible physical output. +4. Real mute/solo/fader/pan, Main/Cue controls and one safe device reconfiguration; no callback heap/crackle/unsafe auto-arm. +5. Show save/recall with stable ChannelId, VST3 vendor chunks, pin mapping remap prompt/rollback. +6. One coherent fast UI (not 3-tab wizard), bundled native WebView HTML parity, one exact SHA ZIP/EXE and internal qualification evidence; user UAT invited only at G4. diff --git a/docs/workstreams/ENGINE_DELIVERY_V7.md b/docs/workstreams/ENGINE_DELIVERY_V7.md new file mode 100644 index 000000000..b9b427cfa --- /dev/null +++ b/docs/workstreams/ENGINE_DELIVERY_V7.md @@ -0,0 +1,12 @@ +# ENGINE OWNER — v7 deliverables (PR #266, no second engine) +Source: ../RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md. The product is a real realtime LIVE MIXER with Studio One/Adobe Audition-style Console, NOT a DAW editor. Do NOT ask the customer to test partial engine builds. + +P0 / G0 — Reconcile current main e5a3d076, your existing PR #266, native codec PR #272; NEVER overwrite your occupied CH1 or vendor work with an offline dry-only graph. Publish actual v6 protocol in #192: arMixConsoleSubscribe/Intent/Ack, exact operation names and allowedOps, canonical decimal-string u64 ChannelId/epoch/revisions, unique opaque request IDs, idempotent ACK, old accepted graph on rejection. Native accepted snapshot includes verified device pins, output arms, telemetry and real hosted VST state. Runtime capability remains false until actual callback installed. + +P1 / G1 — Bring ENTIRE occupied M4 signal path into the ONE production JUCE ChannelId callback. Keep real CH01 vendor VST3/Orbit/editor/vendor chunk, CH02-10 VST3, four AUX, MAIN/MONITOR/secondary, sends, faders, meters and Show without regressions. No duplicate sound renderer or parallel permanent legacy owner. Implement the actual WebView control-thread producer and subscriber, not only offline C++ classes. Bind real active ASIO/WASAPI capture pins to callback ordinals, mono IN1 valid for a one-pin device, physical STEREO L/R requires distinct pins, mono source may feed stereo processing. Native PCM stages RAW -> CH -> MAIN/MONITOR and output safety/epoch truth; no invented IN2 or faked LIVE. Golden source mapping IN1->CH7 and IN2->CH2 on verified two-pin emulation, 0FX and two real VST3, source ACK/rollback and output mute. Never require manual customer hardware QA. + +P2 / G2 — Only after G1 fidelity: true dynamic CH11+ native PCM, Group Selected serial primary output (no double-dry), wet parallel FX Return PRE/POST send, independent MONITOR/Cue to selectable legal outputs, identical native VST3 insert rack on each role including unpatched SILENT channels (load/bypass/reorder/native editor); keep plugin identity/latency and Show roundtrip. Control-thread graph+plugin prepare/publish/retirement with bounded RT control for fader/mute/solo/pan/send; reject cycles and incompatible layout, preserve previous accepted sound on invalid changes. + +P3 / G3 — Windows MSVC/CTest+PCM+VST lease and vendor chunks, heap/lock-free RT, controlled bypass/FX drop crackle, device hotplug/clock fail-safe; external engineering hardware rig validates physical audio (#15) if available. Report exactly what is real and what remains unavailable. No fabricated 0ms latency. Do not mark real sound CLEAN without hardware evidence. + +Own only engine/core/**, src/** and ENGINE C++ tests; do not touch web/**, or CI YAML owned by FAT. Deliver one cohesive draft PR #266 and exact SHA/actual callback admission proof in #192 at each gate. Do not claim CH11/Group/Return shipped based only on offline DynamicAcceptedSession. diff --git a/docs/workstreams/ENGINE_UNIVERSAL_CONSOLE_V6.md b/docs/workstreams/ENGINE_UNIVERSAL_CONSOLE_V6.md index 44d1d0178..305868fac 100644 --- a/docs/workstreams/ENGINE_UNIVERSAL_CONSOLE_V6.md +++ b/docs/workstreams/ENGINE_UNIVERSAL_CONSOLE_V6.md @@ -1,3 +1,5 @@ +> **SUPERSEDED FOR DELIVERY ORDER:** current implementation packets are [ENGINE v7](ENGINE_DELIVERY_V7.md) and [RELEASE TRAIN v7](../RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md). Keep this v6 document as technical history/safety reference; no customer test until G4. + # ENGINE WORKSTREAM — ArSonMix Universal Live Console v6 **Branch/PR owner:** existing [draft PR #266](https://github.com/masarray/arsonmix/pull/266) only, plus epic [#192](https://github.com/masarray/arsonmix/issues/192). Do **NOT** start another native dynamic-engine implementation. Canonical scope is [PRD v5](../PRD_ARSONMIX_OPERATOR_FIRST_LIVE_MIXER_V5_20261101.md) + [ARD v5](../ARD_ARSONMIX_UNIVERSAL_REALTIME_CONSOLE_V5_20261101.md) + [execution lock](../EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md). diff --git a/docs/workstreams/GUI_DELIVERY_V7.md b/docs/workstreams/GUI_DELIVERY_V7.md new file mode 100644 index 000000000..60b0b0206 --- /dev/null +++ b/docs/workstreams/GUI_DELIVERY_V7.md @@ -0,0 +1,12 @@ +# GUI OWNER — v7 deliverables (PR #271, work/operator-console-v6) +Source: ../RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md. This is a full functional live operator Console redesign, not another set of modal tabs or a copied Studio One visual skin. Customer does not test G1/G2 partial builds. + +P0 / G0 — Preserve current GUI #271, reconcile #274 generated-HTML parity and useful #275 First Sound source as patches TO THIS BRANCH, NOT parallel GUIs. Inspect #276 staged combination only as reference, not release. Keep single CSS/HTML source/generator; resolve workflow YAML with FAT #270, do not edit other owners. Follow ENGINE #266 real v6 ConsoleSnapshot/Intent/Ack and native supportedOps. All ChannelId/epoch/revisions canonical decimal strings, requestId unique per WebView session (not fixed v6 + local counter), no optimistic LIVE until ACK and fresh native snapshot. + +P1 / G1 — One-screen compact professional Console HOME with light responsive GPU footprint and pinned MAIN. Audio device setup is a compact drawer for real ASIO/WASAPI hardware names, enabled physical capture/render pins, rate/buffer, native signal evidence. NO mandatory ten-row IN wizard, software input creation, advanced matrix, manual STAGE→MUTE→APPLY→ARM for ordinary channel edits, or duplicate "apply" controls. Operator directly chooses IN and legal OUT on any strip, a single gesture triggers native ACK; choose actual IN1 Mono when only one pin and correctly disable missing IN2 and invalid physical Stereo IN1/IN1. Capture CABLE Output without feeder PCM displays SILENT even with route ACK. Separate SOURCE pin format from processing M/ST width. Distinguish unpatched, pending, ACKed but silent, device missing, output disarmed and genuine LIVE PCM. + +P2 / G2 — Every accepted INPUT/GROUP/FX_RETURN/AUX/MONITOR/MAIN strip shows name+role, direct source where legal, M/ST processing, true ordered VST3 FX slots (load/open editor/bypass/reorder), PRE/POST sends, serial OUT, pan/mute/solo, accurate mono or independent L/R native LED meter and real fader. +CHANNEL, Group Selected, wet FX Return, independent Monitor, sends-on-faders and role banks with pinned MAIN, Show session save/recall. The GUI NEVER creates mock channels or fake VST when native capability missing; disabled items explain unavailable runtime. CH10 labeled FX Return in legacy UI is NOT actual native wet return. + +P3 / G3 — One coherent visual quality on normal iGPU Windows: compact readable strips, high contrast, no blur-heavy glow, no hover-induced relayout, stable fader SVG and LED colors, no expensive per-meter React/DOM remounts. Browser/Playwright fixtures for 1-pin silent case, 2-pin IN1->CH7 IN2->CH2, two VST editors, direct Group/FX Return/Monitor on ACK, rejected rollback, Show and 1024x600 / 1366x768 / 1680x900. Native-hosted WebView source and generated standalone MUST match exact deterministic generator. Do not request customer screenshots until G4. + +Own web/**, UI JS/Playwright tests and generated standalone only. No src/** or engine/core/** changes; no second JS audio engine/router. Consolidate PR #271 rather than multiple UI products. Post real functionality by precise native accepted status + SHA at gates to #192. diff --git a/docs/workstreams/GUI_OPERATOR_CONSOLE_V6.md b/docs/workstreams/GUI_OPERATOR_CONSOLE_V6.md index ba1f9d525..e3daf93a1 100644 --- a/docs/workstreams/GUI_OPERATOR_CONSOLE_V6.md +++ b/docs/workstreams/GUI_OPERATOR_CONSOLE_V6.md @@ -1,3 +1,5 @@ +> **SUPERSEDED FOR DELIVERY ORDER:** use [GUI v7](GUI_DELIVERY_V7.md) and [RELEASE TRAIN v7](../RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md). #274/#275 are patches into GUI #271, not new GUI owners. Do not request partial EXE tests. + # GUI WORKSTREAM — ArSonMix Operator Console v6 **Branch owner:** `work/operator-console-v6` from `main@bb6dff6b`. **UI issue:** created as separate owner, links from epic [#192](https://github.com/masarray/arsonmix/issues/192). **Engine owner** remains [PR #266](https://github.com/masarray/arsonmix/pull/266). Canonical [execution lock](../EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md), PRD/ARD v5. Do not implement a duplicate routing/audio engine. diff --git a/docs/workstreams/INTEGRATION_FAT_CONSOLE_V6.md b/docs/workstreams/INTEGRATION_FAT_CONSOLE_V6.md index 6a0bd13a0..ed0e998e2 100644 --- a/docs/workstreams/INTEGRATION_FAT_CONSOLE_V6.md +++ b/docs/workstreams/INTEGRATION_FAT_CONSOLE_V6.md @@ -1,3 +1,5 @@ +> **SUPERSEDED FOR DELIVERY ORDER:** use [INTEGRATION/RELEASE v7](INTEGRATION_RELEASE_DELIVERY_V7.md) and [RELEASE TRAIN v7](../RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md). #276 is staging only; final UAT after G4 integrated product. + # INTEGRATION / RELEASE / HARDWARE FAT WORKSTREAM — ArSonMix v6 **Coordination epic:** [issue #192](https://github.com/masarray/arsonmix/issues/192). **Hardware root issue:** [#15](https://github.com/masarray/arsonmix/issues/15). **Native PR:** [#266](https://github.com/masarray/arsonmix/pull/266). **UI branch:** `work/operator-console-v6`. Read [execution lock](../EXECUTION_LOCK_UNIVERSAL_LIVE_CONSOLE_V6_20261101.md), PRD/ARD v5. This lane coordinates, tests and releases; it does not invent a separate graph or own engine/GUI implementation files. diff --git a/docs/workstreams/INTEGRATION_RELEASE_DELIVERY_V7.md b/docs/workstreams/INTEGRATION_RELEASE_DELIVERY_V7.md new file mode 100644 index 000000000..9f348a30a --- /dev/null +++ b/docs/workstreams/INTEGRATION_RELEASE_DELIVERY_V7.md @@ -0,0 +1,14 @@ +# INTEGRATION / RELEASE OWNER — v7 deliverables (PR #270, coordination #192) +Source: ../RELEASE_TRAIN_UNIVERSAL_CONSOLE_V7_20261101.md. Make ONE combined finished Windows product. Do not ask customer to test partial First Sound or G1/G2 candidates. + +P0 / G0 — Inspect live main plus ENGINE #266, GUI #271, native contract #272, and FAT #270. Treat #274 as GUI generated-parity supplement, #275 as overlapping GUI First Sound patch to be absorbed by GUI owner, and #276 as disposable/staging-only partial product. Never blindly merge #276 into main or deliver its partial EXE to customer. Freeze a canonical v6 JSON producer/consumer contract with ENGINE: decimal string ChannelId/epoch/roster/graph, requestId unique opaque per WebView session, arMixConsoleSubscribe/Intent/Ack with exact keys, live supportedOps and actual device pin/PCM fields. Real native publisher drives both GUI and FAT fixture; do not test an alternate synthetic schema. Own one existing Chromium workflow and one Windows workflow, preserve both GUI Playwright + FAT gates; no extra CI fanout. + +P1 / G1 — Develop internal end-to-end native test harness: one-input/one-output and two physical-pin mask cases, mono channel input even when processing stereo, invalid same-pin physical stereo rejection, IN1->CH7 and IN2->CH2 native accepted source+PCM, genuine independent VST3 lease, RAW/CH/MAIN/physical arm truth, stale epoch/rejected-graph audio rollback, OUTPUT mute, VB-Cable feeder absent raw silence. Confirm production JUCE callback, not offline-only DynamicPreparedMixerBlock. No customer manual FAT yet. + +P2 / G2 — Own controlled integration branch built from main then verified native contract #272, ENGINE #266 full-fidelity runtime, GUI #271 single Console and generated assets, FAT #270 evidence/packaging. Do not overwrite GUI-owned web handlers or ENGINE-owned src. Reconcile conflicts at their owner, accept only exact shared schema. Add automated full mixer graph acceptance: native CH11, 2 genuine VST3 with editor/reorder/bypass, serial Vocal Group, wet parallel FxReturn PRE/POST, independent MONITOR, MAIN controls, normal bank navigation, Show save/reload, no double-dry, no spoofed LIVE. + +P3 / G3 — Exact SHA Windows MSVC/CTest/packaging + Chromium/Playwright/test provenance in ONE integrated tree; measure latency/CPU/RT allocations, Windows device loss and WebView host responsive GUI on standard PC. Hardware engineer/QA (not customer) assesses 0FX/loaded FX, real 30-min crackle #15, virtual/physical endpoint selection, volume and safe device/clock changes. If independent physical rig unavailable, report PENDING and no clean-sound certification. Release one verifiable EXE ZIP with source SHA, binary SHA256 and limitations only when G1 and G2 feature-complete. + +P4 / G4 — Now invite the owner to perform UAT on ONE finished professional mixer, not an unfinished candidate. If any must-have live role lacks real engine parity, refuse partial "Studio One comparable" release claim and continue implementation. + +Own cross-layer tests, package scripts, CI YAML, provenance, FAT docs and integration branch only; never fork JS or JUCE DSP. Post progress and exact SHA/gates in #192; one consolidated CI per meaningful release-train gate, not cosmetic commit loops.