Skip to content

INTEGRATION v6: opaque WebView request IDs, uint64 ChannelId integrity and ACK replay safety - #272

Closed
masarray wants to merge 3 commits into
mainfrom
work/integration-ack-wire-v6
Closed

masarray wants to merge 3 commits into
mainfrom
work/integration-ack-wire-v6

Conversation

@masarray

@masarray masarray commented Nov 1, 2026 •

Copy link
Copy Markdown
Owner

NATIVE ACK/ABI PATCH SOURCE ONLY — NOT A SECOND GUI/ENGINE (2026-11-02). The one approved GUI is PR #278 V8 mapped into production #271. Preserve useful opaque requestId/uint64/ACK safety here, but integrate through the common v8 schema and ENGINE #266 → GUI #271 → FAT #270; no competing Console workflow or standalone product. PRD v5.2 §9 / ARD v5.2 §K; epic #192.


Product-blocking interoperability fix, not a second engine

Corrects the real schema mismatch between GUI PR #271's native intent requestId='guiSession:sequence' and the merged C++ integration contract previously using numeric requestId.

  • integration/ConsoleNativeContractV6.h: opaque printable bounded string request/ACK correlation, dedup against native-control-writer-supplied recent completed IDs (no invalid numeric ordering across editor reconnects); canonical unsigned decimal ChannelId parser with 64-bit overflow and alias rejection; accepted snapshot projection fails closed when current GUI's epoch/revisions exceed JS Number.MAX_SAFE_INTEGER; explicit wire ACK status tokens.
  • tests/console_native_integration_test.cpp: existing real native PCM CH07/CH02/Group/wet Return/Monitor checks retained, plus duplicate, new editor sequence reset, nonprintable/long request, uint64 max/overflow and ACK echo.
  • docs/CONSOLE_BRIDGE_INTEGRATION_CONTRACT_V6.md: aligns concrete wire keys: requestId string, baseRevision, op, targetChannelId; assigns native WebView handler/ACK snapshots to ENGINE [ENGINE SOLE OWNER] One native callback → full-fidelity ChannelId cutover (draft) #266 and rendered controls to GUI GUI #271 — Native adaptation of approved PR #278 V8 Mixer Console (draft) #271.

No new callback, VST3 processor or JS routing engine. Native ENGINE must still actually implement arMixConsoleSubscribe/Intent/Ack using this contract and full-fidelity M4 VST owner/Show/physical pins before GUI's dynamic capability can turn on. The test is offline PCM and cannot certify hardware.

Merge conditions

Existing Windows MSVC/CTest exact PR SHA must pass; no CI re-run for cosmetic progress. Coordinate schema with epic #192; do not misstate new wire parser as a functioning production UI bridge. Refs #266 #270 #271 #15.

Update: typed serialization-ready C++ readback (cf3f2b94)

The integration branch now additionally exports toConsoleWireReadbackV6 (control-only) and regression checks for decimal-string device/roster/graph revision and ChannelId, canonical INPUT/GROUP/FX_RETURN/MONITOR/MAIN roles, MONO/STEREO, and exact uint64 values above JS 2^53. The current GUI #271 normalizes this flat snapshot; only the real ENGINE #266 JUCE dispatcher can supply physical pin/FX/armed state and certify installed callback. Native CTest pending; DO NOT merge until exact-head Windows passes.

masarray added a commit that referenced this pull request Nov 1, 2026
… synchronized implementation owners

Make one feature-complete Windows LIVE Console the only user UAT entry; coordinate ENGINE #266, GUI #271, FAT #270, integration #272, GUI patches #274/#275 and partial staging #276. Include explicit G0-G4 gates, native v6 wire freeze, exact source/CI and hardware QA ownership. Documentation and coordination only, not a runtime feature certification.

masarray commented Nov 1, 2026

Copy link
Copy Markdown
Owner Author

v7 OWNERSHIP/DELIVERY GATE: Release Train v7 is active. This C++ control-only codec must be adopted/reconciled by ENGINE #266 as its ACTUAL native WebView producer, and must not become an independent, green-test-only "GUI bridge shipped" milestone. Keep uint64 decimal strings, per-editor opaque nonce requestId, explicit ACK/accepted snapshot and real device pin semantics. No new JS producer, no dry-only universal group claiming sound. Hardware production test and full M4 fidelity precede G4 user testing. If current #272 CI fails, fix exact native regression first and document it, without forcing merge.

masarray commented Nov 2, 2026

Copy link
Copy Markdown
Owner Author

Closed as superseded standalone integration/old-WebView branch, not because ACK safety is optional. Confirmed integration/ConsoleNativeContractV6.h has identical Git blob 7b40f30857fe... in this PR and active ENGINE #266; GUI #271 already uses session nonce/decimal-string uint64 and matching accepted ACK/snapshot. Single schema owner: #192 and FAT #270. Preserving PR history but removing a competing open merge candidate. This is NOT audio/Windows certification.

@masarray masarray closed this Nov 2, 2026
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