From f620c10115c0c586aa27765079e380e968dd44de Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Sun, 8 Nov 2026 20:32:08 +0700 Subject: [PATCH] docs(release): stage unqualified alpha.6 candidate notes and exact-SHA promotion gates --- docs/releases/v0.5.0-alpha.6.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 docs/releases/v0.5.0-alpha.6.md diff --git a/docs/releases/v0.5.0-alpha.6.md b/docs/releases/v0.5.0-alpha.6.md new file mode 100644 index 000000000..5cecc4b64 --- /dev/null +++ b/docs/releases/v0.5.0-alpha.6.md @@ -0,0 +1,29 @@ +# ArSonMix v0.5.0-alpha.6 — Native Compressor & Unified FX Controls + +> **RELEASE CANDIDATE / UNPUBLISHED.** Community-test alpha, not certified for live stage or mission-critical use. No GitHub Release or installer is published merely by creating this branch. Do not replace the existing `v0.5.0-alpha.5` binaries. + +## Changes since alpha.5 + +- **Built-in native Compressor.** Add `armix.builtin.channel-compressor.v1` to the approved FX catalog and ordered ChannelId native PCM insert graph. Stereo-linked feed-forward dynamics, threshold, ratio, soft knee, attack, release, makeup and parallel wet/dry. No lookahead or oversampling; the processor declares **zero additional sample latency** (not zero interface/driver round-trip latency). +- **Compact DAW-style FX editor.** A modeless, approximately 558px-wide Compressor panel inside the one approved assembled `/preview/` GUI, with transfer curve, draggable threshold, gain-reduction display, seven working controls and a header preset dropdown (Default, Vocal, Speech, Gentle, Drum, Custom). +- **Consistent window controls.** Common Close styling across dialogs; Close flashes red on press. EQ and Compressor Power visually distinguish accepted insert ON, insert BYPASS, parent FX rack OFF and unavailable state. No optimistic claim that a UI click has modified audio until the native graph readback confirms it. +- **Native state lifecycle.** Bounded control queues, instance/revision-gated DSP ACK and readback, session state restore, bypass behavior, deterministic UI and no callback-side heap allocation/logging. The native source stays the mixer/audio authority; browser preview is visual-only. +- **Distribution UX updates already integrated into main.** Explicit Windows/Linux/macOS download choices, Git-connected Cloudflare Pages build support and documentation reconciliation. No automatic new binary or extra VST3 entitlement is implied by website availability. + +## Scope and limitations + +- FactoryFX bonus VST3 modules remain optional. Stage only independently approved and verified bundles; the last tested Windows FAT report included **no extra FactoryFX packages**. Built-in EQ and Compressor require none. +- Hardware-dependent IN → FX → WIRE/BUS → MAIN, hotplug/reconnect, ASIO xrun/crackle and Show restore still require owner field evidence. See [audio workflow #412](https://github.com/masarray/arsonmix/issues/412), [crackle #15](https://github.com/masarray/arsonmix/issues/15), [dynamic channels #192](https://github.com/masarray/arsonmix/issues/192), and [GUI/native parity #389](https://github.com/masarray/arsonmix/issues/389). **Do not advertise a certified or production-stable release.** +- Browser Chromium tests and native CTest are software verification, **not** physical ASIO listening or measured live-stream latency. Input Gain, look-ahead, auto modes and external sidechain are not claimed as operational Compressor UI controls. +- Linux/macOS are eligible only after real same-SHA platform-native CMake/CTest and package integrity checks. macOS binaries use ad-hoc signing, not Apple Developer ID notarization. + +## Candidate promotion gates + +1. Source authority: squash-merged [PR #466](https://github.com/masarray/arsonmix/pull/466) to `main`, commit `8accbc4af3391efc8c3bd8f2c99feb955e8f69db`; this candidate branch must be pinned to its **own final 40-character HEAD** and all shipped assets must share that exact source. +2. Main qualification: full approved `/preview/` Chromium checks and Windows MSVC/CTest pass on the main merge commit. PR exact-SHA GUI qualification: [42484361883](https://github.com/masarray/arsonmix/actions/runs/42484361883). PR native Windows software/FAT preview: [42483705030](https://github.com/masarray/arsonmix/actions/runs/42483705030) (`f470ebf...`, matching product runtime; later PR changes were tests only). **That older preview ZIP is not the alpha.6 release binary.** +3. For release: Windows installer/portable, FactoryFX stage report, embedded GUI manifest, SHA256 and installer-upgrade contract **must be built and verified from the final alpha.6 release-branch SHA**, not reused from the PR or main. +4. Qualify Linux and macOS from the same immutable candidate SHA before offering those downloads. Do not silently relabel a Windows binary or promise a platform package without its own tests. +5. Have the owner run the real audio-interface FAT on the exact candidate executable: first sound, source-only/MAIN WIRE, bus send, EQ/Compressor FX and bypass, Show restore, reconnect and low-buffer ASIO observations. Record test interface/driver/sample rate/buffer and observed results; unresolved findings block production-use claims. +6. Only after candidate gate review, use the owner-authorized release controller on [#450](https://github.com/masarray/arsonmix/issues/450) with `/arsonmix-release v0.5.0-alpha.6 `. **Do not dispatch this publication command during release preparation.** + +This alpha's notes describe intended test functionality and known constraints; they do not constitute acoustic FAT or public-release approval.