Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# Repository instructions — ArSonMix (all future threads and AI coding agents)

> **FACTORY FX PRODUCT CONTRACT (2026-10-30):** [Six-effect Factory FX PRD](docs/PRD_FACTORY_FX_20261030.md) + [native VST3 bundle ADR](docs/ADR_FACTORY_FX_BUNDLE_20261030.md) + [verified manifest schema](docs/factoryfx-release-manifest.schema.json) + [issue #185](https://github.com/masarray/arsonmix/issues/185). Official public installer and portable use SAME features and will include real ArSonEQ/Comp/Verb/Harmony/Color/ArSonKuPik VST3 when each is verified; NEVER ship user's own Vault or secret license tooling. ASKPVST source private/release v0.5.26 exists, EQ feature branch code but not main/release, Verb licence not final, other three future independent DSP. Factory modules are separate immutable VST3 bundles verified by hash/class ID and loaded by current native JUCE host; no parallel audio engine, no guessed UI LIVE, no full scan at every launch. G5A #178 and MS1 #184 are now MERGED; do not redo them. Crossrepo owner gates askp-vst #60, arson-eq #6, arsonverb #4. #95 G5B/PDC, #85 user Vault, #174 shared AUX and #15 hardware FAT remain dependencies. No heavy CI on docs-only changes.


> **MS1/G5A INTEGRATION REALITY — MERGED 2026-10-30:** Independent MONO/STEREO channel processing vs physical source [MS1 #184](https://github.com/masarray/arsonmix/pull/184) is now in **main@`961c286d0f12e0f6223bb52251e67580922e4ca5`**, after exact-head Chromium [40984090092](https://github.com/masarray/arsonmix/actions/runs/40984090092) + Windows MSVC/CTest/package [40984090111](https://github.com/masarray/arsonmix/actions/runs/40984090111) SUCCESS. Native routing command schemaVersion 2 has typed `sourceKind/sourceFormat/channelFormat`, backward-compatible v1, fail-closed MUTE/APPLY/ACK; the same 10CH graph handles mono input→stereo channel, stereo source→mono channel, and mono/stereo BUS receiving. DRY Show snapshot **V4** preserves real per-channel format; V2/V3 migrate safely. MIX/PATCH native format controls belong to existing one JS routing controller and **MUST preserve L2 11-strip fader geometry #176**. G5A [#178](https://github.com/masarray/arsonmix/pull/178) also MERGED immediately before MS1, providing prepared multi-insert graph internals only: **G5B UI/native command/ACK, PDC, GROUP bus types, real hardware multi-outputs, VST vendor Show restore are STILL UNDELIVERED**. Read [MS1 handoff](docs/MS1_NATIVE_CHANNEL_FORMAT_20261030.md), [R5 ADR](docs/ADR_R5_NATIVE_MONO_STEREO_CHANNEL_BUS_ROUTING_20261030.md), then continue **MS2 #174** and **MS3 #175** without duplicating graphs or unmuting. **#15 actual 0FX crackle remains hardware unqualified**. Post-merge integration main CI is not the exact-head PR test; check its final result before calling the combined G5A+MS1 artifact qualified.

> **CURRENT BENCHMARK/ROADMAP 2026-10-30 — READ BEFORE NEW MILESTONES:** [LV1 + Fender Studio Pro 8.2 status / dependency / FAT roadmap](docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md), [product epic #170](https://github.com/masarray/arsonmix/issues/170). Stage **MS0 #15 hardware 0FX safety always parallel**, MS1 [#173](https://github.com/masarray/arsonmix/issues/173) typed source/channel, MS2 [#174](https://github.com/masarray/arsonmix/issues/174) native AUX/GROUP, MS3 [#175](https://github.com/masarray/arsonmix/issues/175) physical output patch, MS4 [#95](https://github.com/masarray/arsonmix/issues/95) all-channel FX/PDC (G5A [PR #178](https://github.com/masarray/arsonmix/pull/178) in flight at audit, not merged), MS5 [#179](https://github.com/masarray/arsonmix/issues/179) CHANNEL/banked/sends-on-faders, MS6 [#180](https://github.com/masarray/arsonmix/issues/180) Show/Recall Safe/portable, MS7 metrics/low-end release. **No full DAW clone or fake 64ch.** Respect L2 [#176](https://github.com/masarray/arsonmix/issues/176), single typed graph and separate CODE/CI/HARDWARE status. Recheck main and PR #178 before graph edits.
Expand Down
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# ArSonMix — Windows Live Mixer & Native VST3 Host

**Factory FX / SIX BUILT-IN EFFECTS (owner requirement, 2026-10-30):** [Factory FX PRD](docs/PRD_FACTORY_FX_20261030.md), [ADR/packaging/manifest architecture](docs/ADR_FACTORY_FX_BUNDLE_20261030.md), [manifest schema](docs/factoryfx-release-manifest.schema.json) and [product epic #185](https://github.com/masarray/arsonmix/issues/185). Future official installer/portable must contain six FIRST-PARTY VST3: ArSonEQ, ArSonComp, ArSonVerb, ArSonHarmony, ArSonColor and ArSonKuPik Enhancer; USER-selected VST3 remain separately imported to private Studio vault #85. At audit ASKPVST public Windows v0.5.26 binary exists on vst-enhancer release; EQ is on arson-eq feature branch (main only LICENSE), Verb requires outbound licence, Comp/Harmony/Color not yet built. **No factory binaries shipped in current ArSonMix release.** Use separately verified VST3 artifacts and existing native host/G5A, not a second FX engine or public CI clone of private askp source. Preserve actual #184 MS1, #178 G5A, L2 #176, #15 real hardware safety; factory licence/activation and JUCE gates before release.


**Merged functional milestone MS1 + G5A (2026-10-30):** [MS1 #184](https://github.com/masarray/arsonmix/pull/184) delivered independently switchable native MONO/STEREO **processing channel** separate from physical INPUT source, live MIX/PATCH controls and one muted native `schemaVersion:2` route transaction, plus DRY Show snapshot V4 source/format-safe capture/recall and V2/V3 migration. [G5A #178](https://github.com/masarray/arsonmix/pull/178) delivered an internal eight-slot prepared FX foundation, **not yet** the user-editable G5B multi-insert contract or PDC. MS1 exact-head [Chromium PASS](https://github.com/masarray/arsonmix/actions/runs/40984090092) and [Windows native+CTest+package PASS](https://github.com/masarray/arsonmix/actions/runs/40984090111). Both are merged by `main@961c286d`; post-merge main integration CI and real hardware #15 require separate verification. Remaining [MS2 mono/stereo buses #174](https://github.com/masarray/arsonmix/issues/174), [MS3 output patch #175](https://github.com/masarray/arsonmix/issues/175), [universal VST/PDC #95](https://github.com/masarray/arsonmix/issues/95) and [VST-equipped Show #180](https://github.com/masarray/arsonmix/issues/180) are NOT yet complete. Preserve [L2 GUI lock #176](https://github.com/masarray/arsonmix/issues/176).

**Benchmark & delivery roadmap (2026-10-30):** [eMotion LV1 + Studio One/Fender Studio Pro 8.2 parity plan](docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md) maps actual code versus missing audio functionality, milestones MS0–MS7, dependencies and real-hardware FAT. [Epic #170](https://github.com/masarray/arsonmix/issues/170); [MS1 #173](https://github.com/masarray/arsonmix/issues/173), [MS2 #174](https://github.com/masarray/arsonmix/issues/174), [MS3 #175](https://github.com/masarray/arsonmix/issues/175), [MS4 #95](https://github.com/masarray/arsonmix/issues/95) + G5A [PR #178](https://github.com/masarray/arsonmix/pull/178) *in-flight at audit*, [MS5 #179](https://github.com/masarray/arsonmix/issues/179), [MS6 #180](https://github.com/masarray/arsonmix/issues/180). #15 actual 0FX crackle remains release-blocking; no CI claim equals hardware FAT.
Expand Down
57 changes: 57 additions & 0 deletions docs/ADR_FACTORY_FX_BUNDLE_20261030.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
# ADR FXF1 — ArSonMix Factory FX: six first-party VST3, one native host
Date: 2026-10-30 | Status: ARCHITECTURE APPROVED, RUNTIME FACTORY BUNDLE NOT DELIVERED
Source audited: ArSonMix main@aa9b9c810353ed78c3df941213c939432d486d26. Product epic: https://github.com/masarray/arsonmix/issues/185. Recheck latest main before implementation; MS1 PR #184 and G5A PR #178 are MERGED, not to be recreated.

## Binding decision
Official ArSonMix installer AND portable ZIP must eventually include six truly functional first-party effects: **ArSonEQ, ArSonComp, ArSonVerb/Reverb, ArSonHarmony, ArSonColor and ArSonKuPik Enhancer**. Any user may also import their own VST3 and use identical application features. The app contains no owner-specific/private user VSTs, presets or credentials.

Integrate the six as complete **separately built VST3 modules**, loaded by ONE existing ArSonMix native JUCE host/FX graph, not as copied source, a new internal Web Audio renderer, one JUCE runtime linked into another, or fake FX toolbar buttons. VST3 binaries may be built with different JUCE revisions; same-ABI host compatibility must be verified empirically. Do not ship standalone EXEs inside the Factory bundle.

## 1. Sibling-source audit / exact build ownership
- **ArSonKuPik**: source private masarray/askp-vst master@d09fc11, product v0.5.26, JUCE8, manufacturer code MsAr, plugin code AkVs. Public Windows-x64-VST3 ZIP and SHA256SUMS on https://github.com/masarray/vst-enhancer/releases/tag/v0.5.26 . vst-enhancer is release/site distribution, NOT DSP source. Proprietary EULA/activation/redistribution and current JUCE tier must be approved before ArSonMix public inclusion. Never silently disable the licence mechanism. Owner issue https://github.com/masarray/askp-vst/issues/60
- **ArSonEQ**: masarray/arson-eq on feature branch feat/initial-vst3-eq-architecture@1f9513d contains DSP/editor and JUCE9 VST3+Standalone CMake target (ArsN / ArEQ), AGPL source licence. Default main@d9e2b22 contains only LICENSE, and there is no public GitHub Release at audit. Do not pull main expecting an EQ plugin; require pinned candidate artifact, host qualification, then branch/release promotion. Owner issue https://github.com/masarray/arson-eq/issues/6
- **ArSonVerb**: masarray/arsonverb main@69fe83c has reusable C++ DSP and opt-in JUCE9 VST3 (Arst / Arvb), BUT LICENSE-STATUS.md says outbound licence undecided and there is no release. Public bundle blocked until owner chooses licence and completes host validation. Owner issue https://github.com/masarray/arsonverb/issues/4
- **ArSonComp**, **ArSonHarmony**, **ArSonColor**: dedicated owned sibling source repositories were not found at audit; require real independently testable DSP + VST3 wrappers, no invented placeholder effects. Compressor requires attack/release/knee/ratio/makeup and measured gain reduction; Harmony requires musical pitch/formant tracking and declared latency; Color requires musical saturation/tone, measured alias/oversampling and headroom.

## 2. Distribution layout: immutable Factory vs user-owned Vault
Proposed portable layout:
ArSonMix/
AR MIX Studio.exe
portable_mode.txt
FactoryFX/
factoryfx-manifest.json # generated only from actually shipped/validated binaries
ArSonEQ/ArSonEQ.vst3 # complete Windows bundle once signed off
ArSonKuPik/ArSonKuPik.vst3 # after entitlement approval
ArSonVerb/ArSonVerb.vst3 # after legal/host signoff
licenses/ # all per-product notices/EULA
Studio/
Plugins/VST3/ # user-owned; empty on public release
Shows/Presets/ # private user data; empty on public release

Installed EXE uses its installation directory for read-only/atomic-update FactoryFX, and existing installed/portable PortableWorkspace data root for USER plugins. FactoryFX is NEVER the destination for manual user imports. Factory binaries are NOT committed to Git nor silently downloaded by every app startup.

## 3. Versioned manifest / Factory Plugin Registry
Add a lightweight Factory registry into existing src/PluginCatalog.h and existing native plugin state pipeline; do not implement a separate scan or DSP graph.
Each actually SHIPPED manifest entry carries:
- stable productId, name, FX category EQ/COMP/REVERB/HARMONY/COLOR/ENHANCER
- pinned plugin version, source commit/tag, approved distribution/legal notice version
- verified Windows x64 VST3 relative bundle path; complete archive digest and per-file SHA256
- actual discovered VST3 CLASS ID and supported I/O layout/sidechain, not an invented class ID derived from manufacturer/plugin-code text
- host-compatibility qualification, selected licence/activation status, available presets and migration metadata.

Startup resolves only manifest-listed Factory modules, off RT; bounded fingerprint check and durable PluginDescription cache keyed by approved artifact digest+class identity. No repeated global directory scan or all-vendor plugin loading every launch. Missing/modified DLL, wrong class ID, mismatched dependency or inaccessible path is a visible failure, not a fallback to an unrelated plugin with the same name. Only actual installed/validated entries can appear usable in Factory picker. Internal logical Show references use factory://productId with version+plugin class identity and vendor binary state; USER workspace:// paths keep independent ownership and existing compatibility rules.

## 4. Packaging and licence gates
A separate controlled packaging pipeline (NOT a public CI clone of private source) obtains immutable approved sibling release artifacts, checks official SHA256 provenance, extracts full VST3 bundle with path traversal/symlink protection, checks x64 binary resources/class ID and per-file hashes, includes all required notices and then atomically stages one complete FactoryFX folder. Official release MUST FAIL if a required plugin is unavailable or its hash/legal approval is missing; an engineering partial bundle must be explicitly named as partial, never called six-effect production bundle. Do not copy user Vault or private activation/signing keys into ZIP.

ArSonMix host is AGPL; ArSonEQ is AGPL; ASKP-VST has separate proprietary terms and licence manager; ArSonVerb outbound licence is TBD. Being the product owner and distributing VST3 adjacent to an AGPL host does NOT itself settle distribution compatibility. Record an explicit reviewed owner decision for each package/JUCE8-or-9 dependency, third-party source, source notices, redistribution and FX entitlement. ArSonKuPik remains activated/evaluation according to valid licence terms unless the owner formally approves a new included entitlement; no bypass by host. The UI distinguishes installed, active/licensed, inactive and incompatible.

## 5. One native host, not new engine or plugin bypass
Reuse current native G5A (#178) prepared multislots, existing CH1 FX/Orbit and evolving G5B #95 user-facing multi-insert. Mono/stereo source/channel from merged MS1 #184 must be respected; plugin bus layouts and latency/PDC on control thread, plus PRE/POST FX AUX from MS2 #174. No VST instantiation, hashing, license networking, file scanning or state serialization on realtime audio callback. Use existing graph revision, MUTE, native ACK, positive/negative rollback and Safe Show state (#180). Vendor VST GUI opens lazily and does not multiply WebView2 renderers for idle mixer strips. L2 #176 all eleven fader tracks remain fixed and aligned.

## 6. Release milestones (complete vertical deliverables)
FXF1: qualify existing ASKPVST v0.5.26 and ArSonEQ feature branch for Windows, approve licensing, create verified Factory registry+cache, staging scripts, exact release manifest, Factory/My Plugins picker, one public/portable executable product that loads actual two original FX in CH1/CH2, handles vendor Show state and produces exact-head Windows ZIP with real VST3 assets. An EQ source branch or ASKPVST release URL is NOT a shipped factory plugin.
FXF2: certify and package ArSonVerb after licence decision; develop original ArSonComp, ArSonColor and ArSonHarmony from core DSP through independently testable VST3, and ship all SIX effects with meaningful presets and real response.
FXF3: atomic Factory FX upgrades/rollback, version-safe Show migrations, plugin failure handling and multi-channel/PDC profiling.

Acceptance: actual Windows x64 VST3 load and multiple instances, mono/stereo and sidechain compatibility, sample rate 44.1/48/96k and actual supported buffers, bypass/automation, state capture/restore, shared AUX reverb, latency/null and CPU measurement, WebView2 editor and native fallback where offered, test on ordinary integrated GPU Windows PC. Valid native graph ACK and Windows compile do NOT clear actual zero-FX hardware crackle blocker #15. Use targeted tests before one exact-head packaging CI. No full CI for docs-only change.
3 changes: 3 additions & 0 deletions docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# ArSonMix — ARD v2.0: Unified Mixer, Native Hardware I/O, FX Rack and AUX/Bus Routing

**ADR FXF1 architecture amendment (2026-10-30):** [Factory VST3 bundle ADR](ADR_FACTORY_FX_BUNDLE_20261030.md) + [manifest schema](factoryfx-release-manifest.schema.json) and [six plugin PRD](PRD_FACTORY_FX_20261030.md), epic #185. FactoryFX/ contains only hash/identity/licence verified FIRST-PARTY VST3 built in independent sibling repos; Studio/Plugins/VST3 remains USER-owned and unshipped in public package. Reuse one PluginCatalog/LiveChannelFxGraph lifecycle and validated graph PDC/Show, no JUCE8/9 source linking, no RT scanning/hashing, no fake FX or blanket rescan. Crossrepo ASKPVST #60, ArSonEQ #6, ArSonVerb #4. Merged G5A #178 eight-slot graph foundation != full GUI multi-insert, and MS1 #184 mono/stereo native != general VST bus layout negotiation. Existing 10CH/4AUX/ACK and L2 #176 remain. #15 hardware quality gate separate.


**R6 engineering correction / precedence (2026-10-30):** [current code audit and implementable native slices](R6_CURRENT_STATE_ARCHITECTURE_EXECUTION_20261030.md) and [professional GUI operator contract](R6_OPERATOR_WORKFLOW_CONTRACT_20261030.md) override earlier statements in this file that still refer to G1/G2 as future work. Latest audited main@8251bd6e already includes L2 #171 and G3 #168; protect immutable [L2 #176](https://github.com/masarray/arsonmix/issues/176), no master fader shrink or top toolbar. Source/channel MONO/STEREO coupling, stereo-only VST adapter, non-format-aware sends and only MAIN HW0/1 remain open; don't mark future typed groups, master FX, hardware monitor outs or full Show LIVE. Preserve one native graph, plugin ownership and revisioned epoch ACK. Implementation issues #173/#174/#175 then #95; #15 hardware zero-VST release gate runs parallel.


Expand Down
3 changes: 3 additions & 0 deletions docs/EXECUTION_HANDOFF_MONO_STEREO_REFORM_20261030.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# EXECUTION HANDOFF — Mono/Stereo Native Channel / Bus Reform

**FACTORY FX CROSS-THREAD HANDOFF (2026-10-30):** Study [ADR Factory FX](ADR_FACTORY_FX_BUNDLE_20261030.md), [PRD](PRD_FACTORY_FX_20261030.md) and [epic #185](https://github.com/masarray/arsonmix/issues/185) before modifying PluginCatalog, PluginVault, Show schema, package_native_windows.ps1 or plugin-ui. Factory effect binaries must come as pinned, complete Windows .vst3 sibling artifacts with approved license/activation, identity+SHA validation and manifest-only fast discovery. ASKPVST has public binary v0.5.26, EQ exists on feature branch, Verb licensing TBD, other three unbuilt. Never blindly clone private source in public CI. Reuse merged #178 G5A and #184 MS1, preserve user Vault #85, future #95 PDC, #174 AUX, #15 real FAT. Do not change audio graph in this docs PR.


**R6 current-state amendment (2026-10-30):** [R6 native roadmap](R6_CURRENT_STATE_ARCHITECTURE_EXECUTION_20261030.md) and [L2-preserving GUI contract](R6_OPERATOR_WORKFLOW_CONTRACT_20261030.md). Re-read current main SHA; original main@890cc310 snapshot below is historical. L2 GUI #171 is MERGED and frozen by #176; G3 #168 is MERGED. Don't rebuild old mixer shell. Start #173 whole independent channel mono/stereo native+GUI slice, then #174 typed buses/sends, #175 multi-output, #95 PDC/multi-FX; #15 physical crackle in parallel. No decorative channel toggle / fake Master FX and no extra height in CH1–10 or MASTER.


Expand Down
Loading