Skip to content

[INTEGRATION/FAT v7 G0] Canonical JUCE WebView ACK/PCM evidence and exact-SHA release gate - #270

Closed
masarray wants to merge 240 commits into
mainfrom
work/integration-fat-console-v6
Closed

masarray wants to merge 240 commits into
mainfrom
work/integration-fat-console-v6

Conversation

@masarray

@masarray masarray commented Nov 1, 2026 •

Copy link
Copy Markdown
Owner

M2.5 RECONCILIATION HOLD. Historical branch shares critical src/LiveAudioEngine.h / src/Main.cpp / engine core with sole ENGINE #266. Preserve unique hardware FAT and exact-SHA Windows evidence, but DO NOT merge the historical production engine/GUI files wholesale. Rebase or port only scoped work on current main after the engine owner has published a compatible callback. Coordinated by #397; no release qualification while #15 hardware FAT pending.

FAT/RELEASE AUTHORITY: PR #278 V8 IS THE MAIN APPROVED GUI; GUI #271 MUST ADAPT IT TO THE ACTUAL JUCE MIXER (2026-11-02). Code scripts/check_pr278_console_authority.mjs and scripts/check_console_puzzle.mjs --release block visual drift in addition to native ChannelId/PCM/ACK and #15 hardware gates. Exact joined 2f8eb8f5046368991dcdc1ce100bbc50601a4f97 contains ENGINE 40a059785993cc6a4bb593020bf9749de92746f9, GUI 8c4205dd166c9f8933d8b303f630f567db9ca157, FAT 2c4d261ef307787e1903c88a94c2f29f4af2a25e, PR278 reference eda57f931ae3cc2872579df29cdf4e1486592b64. Source-only authority: 10/15 MATCH, 5 GUI release blockers. Screenshot/real callback/Windows package NOT QUALIFIED; #278 simulated HTML is never a production engine. Previous v5.1/v7 notes below are historical; PRD v5.2 §9 + ARD v5.2 §K supersede them. Single release ledger.


STOP-SHIP / MANDATORY PRD v5.1 + ARD v5.1 / PUZZLE SOCKET V8 — Product PRD · Architecture ARD · Owner delivery packet. FAT must validate SAME actual native C++ fixture/GUI schema and actual callback PCM; own CI merge/composition + exact integrated SHA. Synthetic fixture is not hardware certification. No customer UAT until full product. Promotion BLOCKED pending S0 actual producer→GUI→FAT same-fixture proof, S1 real callback, S2 complete mixer and S3 exact-SHA Windows/Chromium + independent QA or explicitly pending hardware. This draft PR is NOT customer test/release ready.

HARD PUZZLE-SOCKET BLOCKER — PR #279. Owner FAT: Validator: import exactly the same canonical fixture, then real engine-produced JSON; one combined SHA product branch integration/product-*, strict --release preflight before build; no synthetic PCM release claim. A green independent PR is NOT an integrated product. Follow shared contract, pass node scripts/check_console_puzzle.mjs; final integration branch must pass --release before heavy CI. Report exact SHA/real runtime evidence in #192. No user UAT before finished G4.

v7 G0 correction — exact FAT HEAD c314153

Scope = INTEGRATION schema and FAT tooling, NOT shipped native Console. Latest validator uses arsonmix.console-v6.acceptance-trace.v2, native WebView arMixConsoleSnapshot/Intent/Ack, canonical decimal-string uint64 ChannelId/device epoch/graph and roster revisions, session-scoped opaque requestId, native supportedOps, accepted snapshot-after-ACK, stale/replay/unsupported rejection, verified physical pins and independent ARM truth. Existing v1 synthetic tests were incompatible with v7 and superseded. All self-tests remain SYNTHETIC; productionCallbackCertified:false, hardwareCertified:false. Engineering physical #15 and First Sound #273 remain blockers.

Release train: #276 archived internal M4 staging; no customer UAT. ENGINE #266 latest G0 JUCE bridge is reject-only and lacks full native dynamic callback/pins; GUI #271 v6 serializer still uses restart-prone bare numeric requestId and nondecimal mock ChannelIds. Owner coordination in epic #192. No source/engine/web ownership files changed here. G0 is NOT closed until actual native producer/GUI consumer agree; G1/G2/G3 and one exact-head combined full-mixer native PCM + GUI + Windows packaging MUST pass before G4 UAT.


ACTIVE DELIVERY LOCK (2026-11-01): ONE PRODUCT RELEASE TRAIN v7 · OWNER WORK PACKET. G0 schema/branch reconciliation → G1 full native callback and First Sound → G2 real channel/VST/Group/FX Return/Monitor/Show → G3 same-SHA quality/packaging/internal FAT → G4 ONE finished product for customer UAT. No half-built First Sound customer testing. See epic #192 and v7 comment in this PR.

INTEGRATION/FAT owner deliverable — not a mixer/GUI engine change

Implements the v6 release validation lane from main@b911c07260388448ab3bfc33084ea114773fe487 without touching src/**, engine/core/**, or web/**.

Substantive acceptance gate

  • New offline scripts/console_v6_fat_gate.mjs: versioned native accepted ConsoleSnapshot → intent → ACK → full accepted snapshot replay, stale revision/device epoch rejection, unique string ChannelId, native capability integrity, rollback/no surprise ARM.
  • PCM sample validation: two distinct sources IN1→CH7 and IN2→CH2, serial GROUP gain, wet-only parallel FX RETURN, double-dry rejection, independent MONITOR mute/destination, physical-output PCM MASTER MUTE. Requires real native trace export for production acceptance; included sample test data is synthetic only.
  • SHA/provenance gate: both Windows and Chromium CI exact source SHA, existing Windows native CTest/package verifier, actual EXE digest vs BUILD_PROVENANCE, separate ZIP/trace/PCM digest evidence. Hardware P0 — Crackling with 0 VST3: diagnose WASAPI clock/input/output buffering before engine expansion #15 acceptance record requires wired 30-minute 0FX, OUTPUT_ONLY_TONE, CAPTURE_ONLY, dry-through, backend/rate/buffer/pins, full diagnostic report and human witness. The validator deliberately returns certified:false even with complete evidence.
  • Existing Windows/UI workflows each run this one targeted Node test suite; no new workflows/fanout or extra manual reruns. PR Windows artifacts remain disabled by existing rule; packaging of universal candidate is not authorized.
  • New docs/CONSOLE_V6_FAT_EVIDENCE_GATE_20261101.md records exact known baseline CI/provenance and release blockers.

Coordination / deliberately incomplete

  • ENGINE #266 still owns actual JUCE production callback/PCM/VST3/Show/native snapshot implementation.
  • GUI #268 owns native-state-driven operator console and Playwright.
  • Contract terminology and trace format require sign-off at #192. This PR does not claim a production trace emitter exists.
  • Real wired audio crackle #15 remains OPEN. No assertion of sound clean/0ms render latency or hardware certified.
  • One exact combined release tree should be tested only after native+GUI merge prerequisites are met; do not merge this validator as a substitute.

Closes no hardware or engine issues.

Coordination #397 — workstream ownership

FAT owns independent tests and release evidence; stop edits to engine-owned DSP/src or integrator-owned Main.cpp and CMake. Handoff required.


2026-11-08 reconciliation: ARCHIVED, NOT MERGED

Parked FAT v7/G0 branch references obsolete #278/v8 authority and pre-single-owner integration; current exact approved /preview/, #418 native bridge, owner-comment CI and released Windows package supersede this 87-file historical branch. Keep actual hardware crackle and physical FAT gaps open in #15/#389/#412. Never merge old native callback/GUI wholesale.

Current authority: main, #418. Historical branch retained; hardware FAT not inferred.

…H-N Group/FX Return, no RT allocations or catalog remap
…one prepared PCM, state retention and zero RT heap
…pointer mismatch, no duplicate plugin render, retain through graph republish
…n new native ChannelId fixture after M4 suite

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

ENGINE B2 dependency now merged into ENGINE #266 at e6a92d1744744d47bea0beecaffce17ad76ef270. Child CTest 54/54 PASS at de347b32123ee3523f2bc7d743631b752e1ce305 (run 41803989638); owner merge CI pending. Canonical native roster/accepted snapshot now carries stable edgeId/from/to/tap/gainLinear, with production LiveDryRoutingLab::nativeBusStatus().edges in scoped accepted nativeBus readback and scoped NATIVE_APPLY_WIRE_TRANSACTION control. #380/#382 closed as redundant. FAT owner: v8 generic schema contracts/console-puzzle-v8.json still lacks graph.edges and generic APPLY_WIRE_TRANSACTION/combined producer→GUI consumer. Keep productionCallbackLive=false until actual callback/Show/VST parity and UI v8 same-revision ACK/snapshot are verified on ONE joined SHA; don't mark Pages or native dry tests hardware-certified. Continue physical #15 0FX OUTPUT_ONLY/CAPTURE_ONLY/DRY_THROUGH test with driver-side evidence.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

ENGINE C1 v8 accepted-graph adapter implemented in draft #384 @f56056a68d8582c2ee0d3bf58e5f55dea03982c4; Windows exact SHA CI 41811922398 pending. Producer projects native graph.channels[]/edges[] only after real installed ChannelId PCM nativeBus admission, with exact graph/roster revisions. Generic APPLY_WIRE_TRANSACTION uses same Main.cpp → ConsoleLiveBridgeV6 → LiveAudioEngine → LiveDryRoutingLab path as B2, and ACK now returns actual accepted PCM revision. Tests cover >2^53 epoch, native EdgeId, accepted ACK/snapshot, duplicate/stale and wrong-focused-source rejection. contracts/console-puzzle-v8.json, GUI consumer #271 and joined Windows FAT remain yours; DO NOT infer product-LIVE or release eligibility. SnapshotV2 fixed 10CH/4AUX still explicitly rejects nativeBusStructural Show save/recall; physical issue #15 unresolved. Please enforce same-SHA producer/consumer/release validation before moving release gate.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

Joined GUI↔ENGINE WIRE FAT input: Published main GUI f182e676 and reconciliation PR #385 define the approved V59 visual and v8 ChannelId/EdgeId bridge semantics. ENGINE sole-owner #266 with C1 #384 stacked; native GUI #271 remains separate. Please gate one exact combined SHA, native-produced APPLY_WIRE_TRANSACTION accepted/rejected ACK, matching graph.edges[] and roster/device revision snapshot, and selected-only visual/main OUT projection. Existing C1 diagnostic nativeBus channel/edge fields are not the v8 GUI validator shape; non-LIVE graph rows/ops need a narrowly scoped, truthful staged protocol decision, never fake productionCallbackLive=true. Preserve M4 CH1/VST3/AUX/Show and #15 physical crackle stop-ship; Pages success is not audible PCM evidence. No duplicate workflow or new DSP.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

INTEGRATION/FAT release gate. Do not certify a Windows EXE that renders the old M4 shell or ENGINE's web/console-native.html replacement. Its visual must match exactly the generated output of https://masarray.github.io/arsonmix/preview/ for the same qualified SHA. Require screenshot/DOM/asset parity and a native ACK/PCM/VST3 acceptance separately. Green CTest or Pages simulation alone never proves the right GUI was embedded.

OWNER CORRECTION — EXACT USER-APPROVED GUI, NO RECREATION (2026-11-04)

The user explicitly confirms that https://masarray.github.io/arsonmix/preview/ is the ONLY approved Windows mixer GUI/UX target. ENGINE must be stitched into that GUI; never redesign/reimagine another native console.

Verified source provenance (main at GUI V59, PR #383):

  • site/preview/index.html is only the wrapper; its iframe actually loads ../preview-buttons/index.html.
  • scripts/build_pages.py creates dist-pages/preview-buttons/index.html at publish time, taking all current HTML/WIRE/fader/meter/FX layout and assets from site/preview-v2/** but substituting the user-approved site/preview-buttons/assets/mixer-control-keys.css, mixer-control-keys.js, and PNG artwork. This generated page, NOT site/preview/mixer.html or the plain site/preview-v2/index.html alone, is the effective /preview/ screen.
  • web/index.html is retired legacy UI and web/console-native.html/.css/.js is a divergent native-created screen. Neither is approved as a replacement visual source.
  • PR INTEGRATION (DRAFT): approved M3 Console in native JUCE, real snapshot/intent path — universal still blocked #356 already attempted a Pages→JUCE source port, but it is stale (M3/V48) and not merged. Reuse only applicable native wiring/resource patterns after reconciling with current /preview/ V59; do not merge its old graphics or old engine wholesale.

Binding implementation contract: preserve the exact generated /preview/ renderer, asset material, geometry, selected-only WIRE, folded quiet MAIN, original fader/LED/FX/button behaviors, replacing simulated state with a thin native accepted-snapshot/intent/ACK adapter. Stable ChannelId/EdgeId (decimal uint64 strings), graph revisions and real VST3/PCM come exclusively from the sole JUCE engine. The existing preview's JS demo model is never DSP authority. Maintain one native callback; no parallel GUI, router or generic replacement layout. Do not substitute a fresh 'native console' just because it is easy to wire.

Acceptance before Windows GUI promotion: automatic source/asset provenance assertion against a freshly generated /preview-buttons/ bundle, rendered screenshot and interaction parity at 1366×768 + standard/compact/expanded views, actual EXE embedding proof, controls→real native ACK+same-revision snapshot tests, and real PCM/VST3 FAT separately. Fail closed on a different GUI. No UAT or feature-complete claim until native joined evidence.

This corrects conflicting older PR #271/#266 assumptions; avoid another GUI design study or duplicate CI workflow. Focus directly on reusing the approved GUI and binding ENGINE.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

FINAL OVERRIDE / RETRACTION OF PREVIOUS /preview-v2/ DIRECTION (2026-11-04). The user's ONLY approved GUI is https://masarray.github.io/arsonmix/preview/ — NOT bare /preview-v2/. Previous agent statements suggesting /preview-v2/ is product authority were wrong and MUST NOT guide work. The actual /preview/ GUI is the assembly of internal HTML/WIRE/fader/FX source with approved PNG MUTE/SOLO/PFL CSS/JS/sprite (site/preview-buttons/assets). Pages publication now serves just /preview/; legacy /preview-v2, /preview-buttons and Vxx paths are redirect-only. Native Windows EXE must embed the EXACT generated /preview/ assembled HTML/assets and preserve every visual/gesture, then connect one native accepted v8 Snapshot/Intent/ACK adapter and genuine PCM/VST3. NO alternate renderer (web/index, web/mixer-layout old shell, web/console-native). Reference issue #389, AGENTS.md and docs/workstreams/HANDOFF_APPROVED_PREVIEW_V2_NATIVE_20261104.md (historical filename; content corrected). Do not merge old #271/#356 visual UI. Engine #266/#387 continues ONLY as native audio work, FAT #270 gates exact compiled GUI and PCM.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

Milestone A FAT integration note (see #389 and draft #398): release gate must certify ONLY the approved https://masarray.github.io/arsonmix/preview/ assembly bundled by scripts/build_approved_native_gui.py (including PNG keys), NOT old web/mixer-layout.js, web/index.html or web/console-native.*. Main already merged M2 #394; this provides truthful native G0 Subscribe/Intent/Snapshot/ACK, NOT universal PCM. Once #266 lands, FAT should verify a SINGLE exact SHA across accepted ChannelId PCM graph, control ACK/same-revision snapshot, VST3 leases and Windows screenshots, followed by real ASIO/WASAPI and #15 crackle. New static gate #398 is not hardware proof; no UAT claims until measured.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

Coordination #397 — FAT evidence owner (active). Keep FAT independent: hardware/Windows smoke, joined GUI↔PCM proof, packaging safety and crackle #15. src/Main.cpp, CMakeLists.txt belong to INTEGRATOR; actual DSP/engine files belong to ENGINE #266. This old draft's cross-owner source changes must be extracted/handoff, not merged raw. New PRs after #395 will automatically fail on such edits via PR #400. Please provide tested exact SHA, reproducible FAT fixture and stop-ship verdict rather than creating another renderer/PCM path.

masarray commented Nov 4, 2026

Copy link
Copy Markdown
Owner Author

FAT owner handoff: main now 0d23ff90 (#396 native approved GUI IIFE/fader + #398 source gate merged). PR #270 is old draft with ~87 changed files including src/Main.cpp, src/LiveAudioEngine.h, ENGINE/GUI legacy copy and CMake from old base. Do not raw merge. Extract hardware FAT evidence, exact built-EXE SHA verifier/packaging tests and independent FAT scripts onto latest main without replacing currently-approved GUI/native socket. Require actual 0FX wired dry 44.1/48k, 2 genuine VST3, ASIO/WASAPI, ACK→accepted snapshot, screen parity; #15 remains stop ship. See #397 for file ownership and ordered milestone A convergence.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant