From 3a8b103841528bb4b8d4c2116c5660d28b0e9699 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 30 Oct 2026 08:28:28 +0700 Subject: [PATCH 1/3] docs(factoryfx): six first-party VST3 bundle architecture and product requirements --- docs/ADR_FACTORY_FX_BUNDLE_20261030.md | 57 ++++++++++++++++++++++++++ docs/PRD_FACTORY_FX_20261030.md | 20 +++++++++ 2 files changed, 77 insertions(+) create mode 100644 docs/ADR_FACTORY_FX_BUNDLE_20261030.md create mode 100644 docs/PRD_FACTORY_FX_20261030.md diff --git a/docs/ADR_FACTORY_FX_BUNDLE_20261030.md b/docs/ADR_FACTORY_FX_BUNDLE_20261030.md new file mode 100644 index 000000000..eb211f8be --- /dev/null +++ b/docs/ADR_FACTORY_FX_BUNDLE_20261030.md @@ -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. diff --git a/docs/PRD_FACTORY_FX_20261030.md b/docs/PRD_FACTORY_FX_20261030.md new file mode 100644 index 000000000..a470f331c --- /dev/null +++ b/docs/PRD_FACTORY_FX_20261030.md @@ -0,0 +1,20 @@ +# PRD — ArSonMix Factory FX Library +Date: 2026-10-30. Product requirement, NOT implementation claim. +Canonical technical rules: [ADR Factory FX](ADR_FACTORY_FX_BUNDLE_20261030.md) and [epic #185](https://github.com/masarray/arsonmix/issues/185). Retain L2 #176 and one installed/portable product feature set #85. + +## A usable mixer on first launch +The official completed factory package carries **ArSonEQ**, **ArSonComp**, **ArSonVerb**, **ArSonHarmony**, **ArSonColor** and **ArSonKuPik Enhancer**, as REAL bundled first-party VST3 (not empty cards or fake FX). Open the mixer offline, choose FACTORY in the existing compact FX picker, add effects, hear DSP, tune native plugin/editor parameters, save Show and restore identical sound and slot order. All users may additionally install personal VST3. Factory files live in read-only app-controlled FactoryFX; private Studio/Plugins/VST3 is never part of the official package. + +Product categories: EQ (transparent/dynamic equalization), COMP (vocal/music dynamics), REVERB (musical shared vocal space), HARMONY (pitch harmony with explicit latency), COLOR (musical saturation/tone), ENHANCER (ArSonKuPik smart enhancement). Each plugin may expose factory presets and vendor editor only after actual processing/host state acceptance. Use one native VST3 host for FACTORY and USER. No second audio engine, VST2 promise, internet requirement per launch, hidden license bypass or user-exclusive distribution. + +## Actual sibling readiness at audit +ASKPVST has private source and a public v0.5.26 Windows VST3 release on vst-enhancer; separate product licence approval needed before factory distribution. ArSonEQ has real C++ DSP/VST3 on a feature branch, but default main is only LICENSE and no public release. ArSonVerb core/VST3 exists but outgoing licence remains undecided. COMP/HARMONY/COLOR have no verified sibling repo or release. None is currently attested as shipped inside ArSonMix. Sibling release work: askp-vst #60, arson-eq #6, arsonverb #4. + +## Must-have UX and quality +FACTORY / MY PLUGINS tabs, search, compact category EQ/COMP/REVERB/HARMONY/COLOR/ENHANCER, actual installed/validated status and clear user-facing errors if not licensed, missing or wrong audio layout. No placeholder button that appears to process audio. Native scene/Show uses logical stable Factory ID and vendor binary state, not fragile absolute paths. No startup full system scan; registry loads only approved bundled modules and uses safe cached class identity. User-owned VST vault remains unrestricted. All plugins must be audible in real native CH/AUX/BUS/MAIN paths only where engine supports them, with mono/stereo layouts, bypass, plugin state, PDC/headroom and a safe retired-plugin lifecycle. Never resize the L2 eleven faders independently or add a new top toolbar. + +## Delivery sequencing +FXF1 = qualified existing original EQ/Enhancer binaries, manifest/cache/picker, installed/portable release and live native roundtrip. +FXF2 = genuine Reverb/Comp/Harmony/Color VST3 packages and presets, full six-effect bundle. +FXF3 = atomic updates, Show migration, licensing robustness, measured low-spec GUI and long hardware soak. +The source code milestones MS1/G5A are merged but **not proof that Factory FX is packed**. Actual release proof requires exact source artifact SHA256, whole VST3 resources, host tests, legal approval, Windows ZIP and real hardware FAT. #15 crackle remains independent release blocker. From 8af0d5c37515bfa5265b036eb89cdcd64956fb3a Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 30 Oct 2026 08:29:38 +0700 Subject: [PATCH 2/3] docs(factoryfx): define verified-only VST3 release manifest schema --- docs/factoryfx-release-manifest.schema.json | 145 ++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 docs/factoryfx-release-manifest.schema.json diff --git a/docs/factoryfx-release-manifest.schema.json b/docs/factoryfx-release-manifest.schema.json new file mode 100644 index 000000000..235ccfe6f --- /dev/null +++ b/docs/factoryfx-release-manifest.schema.json @@ -0,0 +1,145 @@ +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "title": "ArSonMix FactoryFX Release Manifest v1", + "description": "SCHEMA ONLY; actual shipped Factory FX manifest is generated after verified licenses, VST3 identities, artifacts and file hashes. Planned entries are not loadable.", + "type": "object", + "additionalProperties": false, + "required": [ + "schemaVersion", + "platform", + "hostFormat", + "distribution", + "plugins" + ], + "properties": { + "schemaVersion": { + "const": 1 + }, + "platform": { + "const": "windows-x64" + }, + "hostFormat": { + "const": "VST3" + }, + "distribution": { + "enum": [ + "engineering-partial", + "production-six" + ] + }, + "plugins": { + "type": "array", + "minItems": 1, + "maxItems": 6, + "items": { + "type": "object", + "additionalProperties": false, + "required": [ + "productId", + "displayName", + "category", + "pluginVersion", + "sourceRepo", + "sourceCommit", + "artifactSha256", + "bundleRelativePath", + "vst3ClassId", + "licenseReview", + "entitlementPolicy", + "notices", + "files" + ], + "properties": { + "productId": { + "enum": [ + "arson-eq", + "arson-comp", + "arson-verb", + "arson-harmony", + "arson-color", + "arsonkupik-enhancer" + ] + }, + "displayName": { + "type": "string", + "minLength": 2 + }, + "category": { + "enum": [ + "EQ", + "COMP", + "REVERB", + "HARMONY", + "COLOR", + "ENHANCER" + ] + }, + "pluginVersion": { + "type": "string", + "minLength": 1 + }, + "sourceRepo": { + "type": "string", + "pattern": "^masarray/[A-Za-z0-9_.-]+$" + }, + "sourceCommit": { + "type": "string", + "pattern": "^[0-9a-f]{40}$" + }, + "artifactSha256": { + "type": "string", + "pattern": "^[0-9a-f]{64}$" + }, + "bundleRelativePath": { + "type": "string", + "pattern": "^FactoryFX/[A-Za-z0-9_-]+/[A-Za-z0-9_.-]+\\.vst3$" + }, + "vst3ClassId": { + "type": "string", + "pattern": "^[A-Fa-f0-9]{32}$" + }, + "licenseReview": { + "const": "approved" + }, + "entitlementPolicy": { + "enum": [ + "unrestricted", + "separate-license", + "factory-entitlement" + ] + }, + "notices": { + "type": "array", + "minItems": 1, + "items": { + "type": "string", + "pattern": "^FactoryFX/licenses/[A-Za-z0-9_.-]+$" + } + }, + "files": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "additionalProperties": false, + "required": [ + "path", + "sha256" + ], + "properties": { + "path": { + "type": "string", + "minLength": 1 + }, + "sha256": { + "type": "string", + "pattern": "^[0-9a-f]{64}$" + } + } + } + } + } + } + } + } +} From 75d210dccf9f6bfa70039b9b85ff7039dfa6c557 Mon Sep 17 00:00:00 2001 From: Ari Sulistiono Date: Fri, 30 Oct 2026 08:30:51 +0700 Subject: [PATCH 3/3] docs(factoryfx): synchronize six bundled VST3 product contract into roadmap PRD ARD agents --- AGENTS.md | 3 +++ README.md | 3 +++ docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md | 3 +++ docs/EXECUTION_HANDOFF_MONO_STEREO_REFORM_20261030.md | 3 +++ docs/PRD_ARSONMIX_PRO_MIXER_WORKSPACE_ROUTING_20261030.md | 3 +++ docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md | 3 +++ 6 files changed, 18 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 37e334996..601cd9d8b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. diff --git a/README.md b/README.md index a27d0f1c8..3c9cdc399 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md b/docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md index 978834d69..814714ee2 100644 --- a/docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md +++ b/docs/ARD_PRD_MIXER_IO_AUX_BUS_REFORM_20261030.md @@ -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. diff --git a/docs/EXECUTION_HANDOFF_MONO_STEREO_REFORM_20261030.md b/docs/EXECUTION_HANDOFF_MONO_STEREO_REFORM_20261030.md index 90c15712b..d41336c0d 100644 --- a/docs/EXECUTION_HANDOFF_MONO_STEREO_REFORM_20261030.md +++ b/docs/EXECUTION_HANDOFF_MONO_STEREO_REFORM_20261030.md @@ -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. diff --git a/docs/PRD_ARSONMIX_PRO_MIXER_WORKSPACE_ROUTING_20261030.md b/docs/PRD_ARSONMIX_PRO_MIXER_WORKSPACE_ROUTING_20261030.md index 008954778..db71784a9 100644 --- a/docs/PRD_ARSONMIX_PRO_MIXER_WORKSPACE_ROUTING_20261030.md +++ b/docs/PRD_ARSONMIX_PRO_MIXER_WORKSPACE_ROUTING_20261030.md @@ -1,5 +1,8 @@ # ArSonMix — PRD v2.0: Pro Digital Mixer, Channel Modes, Hardware I/O and AUX/BUS +**Factory FX operator outcome:** official completed ArSonMix release includes genuine first-party EQ/COMP/REVERB/HARMONY/COLOR/ArSonKuPik VST3 (not six preview icons), while every user can still import their own VST3 to Studio. [Factory FX PRD](PRD_FACTORY_FX_20261030.md), [ADR](ADR_FACTORY_FX_BUNDLE_20261030.md), [tracked epic #185](https://github.com/masarray/arsonmix/issues/185). Factory modules must be immutable verified VST3 bundles, manifest/class-ID-backed, on-demand plugin editor and full Show state, installed/portable parity. Only two original existing candidates to integrate first: ASKPVST published v0.5.26 (owner entitlement needed) and ArSonEQ on development branch (no default-main package); Reverb outbound licence undecided, other effects unbuilt. No bundled Factory FX claimed today. + + **R6 authoritative execution update (audited main@8251bd6e):** [real source capability / architecture matrix](R6_CURRENT_STATE_ARCHITECTURE_EXECUTION_20261030.md), [selected-channel/bus/PATCH workflow acceptance](R6_OPERATOR_WORKFLOW_CONTRACT_20261030.md). [L2 #176](https://github.com/masarray/arsonmix/issues/176) is MERGED/owner-accepted and must not be visually regressed: identical 11 fader heights, left rail FX/ROUTE/SENDS, only three top workspaces. G3 is merged; standalone channelFormat MS1, format-aware bus MS2, hardware outputs MS3 and uniform plugin/PDC MS4 are goals, not delivered. Each feature requires actual native samples, positive/negative ACK, GUI geometry and exact-head Windows ZIP. One control graph, mutable drafts only until native APPLY. diff --git a/docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md b/docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md index 68d192a33..6fe18aa87 100644 --- a/docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md +++ b/docs/ROADMAP_LV1_STUDIO_PRO_MIXER_PARITY_20261030.md @@ -1,4 +1,7 @@ # ArSonMix — Roadmap menuju kelas eMotion LV1 + Studio One / Fender Studio Pro + +**NEW FACTORY FX REQUIREMENT (2026-10-30):** [ArSonMix Factory FX PRD](PRD_FACTORY_FX_20261030.md), [first-party VST3 distribution/architecture ADR](ADR_FACTORY_FX_BUNDLE_20261030.md), [manifest schema](factoryfx-release-manifest.schema.json), and [Factory FX epic #185](https://github.com/masarray/arsonmix/issues/185). Six bundled effects required: ArSonEQ, ArSonComp, ArSonVerb, ArSonHarmony, ArSonColor, ArSonKuPik Enhancer. FXF1 qualifies existing ArSonEQ feature-branch candidate + published ASKPVST binary and builds Factory registry/packaging/picker; FXF2 completes Reverb/Comp/Harmony/Color; FXF3 updates/portability/hardening. **No binaries shipped yet.** Keep MS0–MS7 milestones: Factory FX is a cross-cutting original-plugin delivery stream under MS4 FX plus MS6 portable Shows, NOT a second competing DSP roadmap. Preserve merged MS1 #184 and G5A #178, plus #15, L2 #176, independent user VST Vault #85. + > **ACTUAL MERGED DELTA / RECONCILIATION 2026-10-30 (supersedes audit rows below):** [G5A #178](https://github.com/masarray/arsonmix/pull/178) is now **MERGED** (internal eight-slot FX graph foundation, not user G5B multi-insert), and [MS1 #184](https://github.com/masarray/arsonmix/pull/184) is **MERGED** as `961c286d0f12e0f6223bb52251e67580922e4ca5`. MS1 adds native typed v2 physical source/processing channel format separation, MIX/PATCH GUI, preserved L2 geometry and actual DRY Show V4 channel format capture/recall. Exact-head MS1 [Chromium 40984090092](https://github.com/masarray/arsonmix/actions/runs/40984090092) and [Windows native/CTest 40984090111](https://github.com/masarray/arsonmix/actions/runs/40984090111) both SUCCESS. The source audit table below was recorded **before these PRs merged** and remains useful for its other constraints, but future threads must NOT recreate MS1 or G5A. Next [MS2 #174](https://github.com/masarray/arsonmix/issues/174) typed mono/stereo AUX/GROUP and [MS3 #175](https://github.com/masarray/arsonmix/issues/175) real physical output patch; G5B user-facing inserts/PDC (#95), full VST Show (#180), and physical #15 0FX hardware FAT remain pending. Recheck latest main and post-merge integrated CI before claiming combined qualification. **Tanggal audit:** 2026-10-30