diff --git a/AGENTS.md b/AGENTS.md index b28b6129f..c16363894 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,8 @@ # ArSonMix — SINGLE APPROVED GUI: /preview/ **BINDING OWNER CORRECTION 2026-11-04 — overrides prior incorrect /preview-v2/ target.** +**BINDING OWNER DELIVERY POLICY 2026-11-09:** [Autonomous Fast Delivery Contract](docs/AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md). A ChatGPT agent should code autonomously toward one *usable product milestone* with the relevant engine/GUI/tests on one coherent PR; do not stop for a separate architecture-spike approval, Lab/admission, owner to press Actions, or one PR per small patch. Proceed with independent coding while quick CI is pending; resolve real failures before heavy qualification/merge. Run only the relevant exact-SHA milestone UI, native or FAT; when a Windows installer is wanted, choose **FAT instead of a duplicate native** run and deliver user-test build as soon as M1 works. All physical identity, single callback, approved /preview/, branch protection, true CI and physical FAT rules remain mandatory. + **ONLY approved/public/product GUI: https://masarray.github.io/arsonmix/preview/**. There must be ONE public preview, ONE actual rendered GUI, and ONE native Windows GUI. **/preview-v2/ is rejected**: do not display, promote, publish or base native design on it as a separate UI. Do not substitute another console from `web/index.html`, `web/mixer-layout.js`, `web/console-native.html`, PR #278 or old M3/V48 mock. **The JUCE ENGINE must stitch into the EXACT approved /preview/ GUI**, never redesign it. ## New ChatGPT thread / repository-agent entrypoint — MUST READ FIRST (2026-11-06) @@ -15,14 +17,18 @@ must **act on the repo**, not ask the owner to operate Actions manually: 2. Fetch **fresh** `main` SHA, open PRs, latest active integration PR HEAD, changed files, CI jobs, artifacts and recent work before any edit. Historical handoff SHAs/PR states and old workstream plans are **not live authority**. - Continue the existing applicable integration PR (currently P0 #418; verify - its state each session), rather than stacking duplicate PRs or redoing - completed work. Do not overwrite another agent's newer HEAD; use an - expected-SHA lease and reconcile concurrent changes. -3. Plan one meaningful vertical product milestone; make targeted changes and - tests together. Use the GitHub connector to create/commit/update a branch, - inspect failures and PR evidence, and merge a **scoped, actually verified** - PR when appropriate. Never equate green CI with real physical audio FAT. + Reuse a currently active in-scope integration PR if present; **old P0 #418 + is historical and not a mandatory present-day entrypoint**. For a distinct + feature (e.g. native ArSon Player), one scoped integrated product PR is + allowed; no stacked mini PRs. Never overwrite another agent's HEAD; use + an expected-SHA lease and reconcile concurrent changes. +3. Execute one meaningful vertical product milestone, with targeted engine, + bridge, GUI and tests together; use M0 technical tracing **inside the M1 + implementation PR**, not as an extra signoff. Continue independent coding + while fast CI runs. Use the GitHub connector to commit/reconcile/inspect + and merge a scoped, **actually verified** PR when permitted. Deliver the + first working installer early via one deliberate FAT lane, not repeated + Windows jobs. Never equate green CI with physical audio FAT. 4. **CI cost contract:** relevant PR pushes get lightweight Linux checks; no per-commit Chromium, Windows MSVC or ZIP. Docs/instructions-only edits normally need diff and contract inspection, **not** a Windows/Chromium diff --git a/docs/ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md b/docs/ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md index 940f3696a..e8f910d6d 100644 --- a/docs/ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md +++ b/docs/ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md @@ -1,5 +1,5 @@ # ADR — ArSonMix Smart Zero-Friction Operator Workflow (Player + Mixer) -**Status:** APPROVED PRODUCT-DIRECTION DESIGN / NOT YET IMPLEMENTED · 2026-11-09 +**Status:** APPROVED PRODUCT-DIRECTION DESIGN / NOT YET IMPLEMENTED · 2026-11-09 · **Autonomous implementation and CI** follow [Fast Delivery Contract](AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md): no standalone M0 gate, one product PR through M1, early exact-SHA FAT artifact, no repeated Windows/Chromium or manual Actions clicks. **Owner correction:** No user-facing Lab mode, admission gate, ARM/MONITOR chore, confirmation checkbox, routing-approval dialog, repeated Start, or technical wizard in the normal first-sound/player path. **Authority:** This ADR clarifies and supersedes contradictory player-workflow sentences in [PRD](PRD_ARSON_PLAYER_LIVE_SETLIST_UX_20261109.md), [ARD](ARD_ARSON_PLAYER_NATIVE_AUDIO_ARCHITECTURE_20261109.md), and [agent workpack](workstreams/ARSON_PLAYER_IMPLEMENTATION_WORKPACK_20261109.md). Preserve [single approved /preview/](../AGENTS.md), correct physical output identity, actual PCM ACK and one JUCE render callback. It does **not** claim implementation, and does not authorize unverified hardware rerouting. diff --git a/docs/AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md b/docs/AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md new file mode 100644 index 000000000..83bb88be2 --- /dev/null +++ b/docs/AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md @@ -0,0 +1,96 @@ +# ArSonMix — Autonomous Fast Delivery Contract (GitHub ↔ ChatGPT) +**Binding owner policy · 2026-11-09 · Status: operative development workflow; not a claim of new product code** + +**Priority:** ship the next actually usable ArSonMix vertical milestone as rapidly as reliable engineering allows. **Speed = fewer handoffs, fewer duplicate jobs, fewer redundant revisions, less waiting, and more complete user-tested software — not weaker tests.** This document supplements [AGENTS.md](../AGENTS.md) and [Smart CI runbook](SMART_CI_RUNNER_WORKFLOW.md). Product-specific goals for ArSon Player: [Zero-friction workflow](ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md), [Agent Workpack](workstreams/ARSON_PLAYER_IMPLEMENTATION_WORKPACK_20261109.md). + +## 1. Agent operating mode — autonomous, scoped, evidence-driven + +1. **One quick live inspection** per working session: fetch main/active relevant PR/HEAD/changed files/current fast checks, then go straight into editing. Do not read 50 unrelated threads or repeatedly survey all CI until needed. Inactive historical PRs and snapshots are not barriers. Honor expected-SHA leases and re-check main before merge. +2. **Do work, not another planning cycle.** Read existing PRD/ARD once, identify the direct PCM/bridge/UI integration seam, implement it and add targeted tests. No new Lab, special permission/reviewer gate, coordinate-only PR, “architecture spike pending signoff”, or a chain of tiny PRs before user hears sound. +3. **Single product owner, single integration PR** per coherent deliverable, covering engine + GUI + bridge + tests + packaging as appropriate. Use short local commits/connector updates under that PR. Avoid stacked dependencies and a new PR for each class, unit test, or UI knob. Reuse an existing in-scope PR when safe; do not overwrite another agent's HEAD. +4. **Build correct by design:** start with stable ChannelId/source contracts and accepted native graph; define callback-safe ownership; keep one JUCE render, one approved `/preview/`, one command/readback authority. Do not route around broken P0 by creating WebAudio, fake pin ordinals or a second audio graph. Performance comes from architecture, not patches. +5. **Agent owns complete GitHub workflow inside this live task:** create/commit/push PR through connector, read CI evidence, fix actual failures, selectively trigger exact-SHA UI or native/FAT with the connected owner PR-comment dispatcher, inspect artifacts and merge if protected conditions allow. Don't delegate routine GitHub operations or repeated “Run workflow” requests to owner. +6. **Never fake progress.** Declare real source, test pass/fail, merge and usable artifact with exact GitHub links; mark physical ASIO FAT PENDING when untested. A completed TODO skeleton or browser demo does not count as the user-visible vertical slice. + +## 2. The fast path (normal agent execution) + +```text +SESSION: read exact main+active PR -> select one user-observable milestone + -> implement engine + one fixture + native command/readback + approved GUI + -> run smallest relevant local/fast check + -> fix red tests; continue independent coding while CI is queued/running + -> one integrated PR / push meaningful working revision + -> inspect quick CI only when necessary for expensive dispatch + -> select exact-SHA lane: + docs-only: NONE + GUI-only: UI + native-only: NATIVE + combined GUI+native: UI + (NATIVE or FAT) + playable Windows artifact requested: UI (if GUI changed) + FAT [FAT includes native] + -> read terminal evidence and FAT artifact provenance + -> merge scoped verified PR (if permitted) or leave open with exact blocker + -> hand off a real tested user workflow, not the number of commits +``` + +**No stop-the-world effect:** A pending quick or long-running Chromium/MSVC job must **not** suspend unrelated source edits; work on independent tests/GUI/contracts immediately. **Before a costly dispatch** verify latest exact HEAD has applicable quick success; **before merge** verify all mandatory code/GUI gates at the exact source version. Never bypass relevant failures, stale SHA checks, branch protection or hardware safety. + +**CI checking cadence:** after push/check event; before exact-SHA milestone dispatch; at actual completion/failure; and before merge. Avoid polling every few seconds and posting identical commands. An in-progress Windows FAT can coexist with code work but its package applies only to the **old immutable SHA**; if the subsequent code changes audio behavior, requalification of the *new candidate* is required. + +**Do not introduce artificial approval:** No ChatGPT “do you approve plan?”/reviewer admission/agent-owner wait/prompt for user to click Actions/disabled Play until lab pass. For genuine physical hardware listening, use the packaged FAT as soon as a meaningful vertical works; not every intermediate commit. Explicit user approval is still necessary when changing an unknown physical output; not for routine software graph preparation on trusted hardware. + +## 3. CI policy: minimal reliable gates, no repeated heavyweight work + +| Change/milestone | Automatic on PR update | Deliberate milestone (exact SHA) | +| --- | --- | --- | +| Documentation only | None (review diff and links) | None | +| C++/PCM/VST3/driver | Path-scoped Linux fast native | **native** MSVC/CTest once if no installable artifact needed; **fat** INSTEAD of native when installer is needed | +| Approved /preview/ GUI/CSS/JS | Path-scoped Linux fast UI | **ui** Chromium screenshot/gesture smoke once | +| Player MVP (native + GUI; executable wanted) | Fast native + fast UI only | **ui + fat**, no redundant `native` run | +| Audio runtime bug after initial FAT | Affected fast checks | One newly relevant exact-SHA `fat` after real fix, not repeated same-SHA reruns | +| Existing successful/running exact-SHA lane | Nothing extra | Reuse results; no duplicate dispatch | +| Relevant main merge/release | Existing main-required full checks | Never suppress release hardening or physical FAT claims | + +This is already the design of repository workflows `p1-windows.yml`, `ui-smoke.yml`, and `chat-ci-milestone.yml`: **do not add more CI jobs or modify the release pipeline without evidence of an actual bottleneck.** The owner-authenticated dispatcher is one PR Conversation comment `/arsonmix-ci `; agent posts via GitHub connector. `fat` includes MSVC/CTest and Windows ZIP verification. The agent does not ask user to navigate Actions. + +**Safe CI optimizations:** path filtering; cancel superseded *quick PR* checks, never cancel user-requested immutable qualification; prepare first scoped failure fixtures before Windows; reuse prior successful same-SHA jobs/artifacts; run focused CTest/JS/Python locally before pushing; skip historical migration suites unless the affected surface warrants them. Avoid multi-OS release matrix during every iteration, but run platform/release qualification when release work actually requires it. + +**Forbidden shortcuts:** fake green check, altered assertions to mask regression, removing relevant audio safety/rollback tests, disabling native runtime check on code change, treating current-source failure as “CI noise”, uploading a ZIP before build/verify, treating FAT artifact as physical listening PASS, silently publishing a release, or bypassing protected branch policy. CI optimization must optimize *work*, not weaken *evidence*. + +## 4. Product milestones are vertical, not artificial stages + +**For ArSon Player**, M0 is an **internal engineering slice in the same ongoing M1 implementation PR**, not a separate “architecture spike PR” or approval gate. Native typed virtual source + player-first-sound planner + deterministic tests feed directly into: file drop/import → prepared decoder PCM → stable MUSIC ChannelId → trusted MAIN WIRE → FX/fader/MAIN → physical output → native ACK → real approved GUI. + +**First user-test artifact target:** as soon as that end-to-end flow works, run fast checks, one `ui` if GUI changed, one `fat` for an actual Windows playable package. Do not wait for advanced marker/crossfade/stems/tempo analyzer to produce the first installer; do not ship unimplemented KEY/TEMPO UI as fake controls. Real pitch/tempo DSP may be M2 on the same product branch or subsequent small tested milestone, not a reason to postpone usable M1. + +**M2/M3/M4:** add independent pitch/tempo, setlist live-safety and eventually advanced dual decks; keep the initial simple workflow intact and avoid cross-thread workstream gates. Only branch for separate coherent work when actually necessary; do not mix alpha release candidate or unrelated Harmony/Vocal Throw work. + +## 5. Optimized engineering quality rules + +- **One source of truth:** stable ChannelId, verified graph revision, one native PCM callback, one approved `/preview/`. Apply control intents atomically with ACK/readback; reject without damaging previous accepted graph. +- **Audio RT:** no allocations, locks, disk I/O, decoder, FFT/time-stretch, vendor construction/destruction, JS or logging in ASIO callback. Precompute DSP, use bounded worker PCM rings and frame-aligned publication. Mic monitoring must not gain latency when file player is enabled. +- **Reduce patch debt:** repair root ownership/callback problem rather than layering a second compatibility route, manual setup switch or “temporary” alternate renderer. Keep focused tests of core invariants for every structural change. +- **User mental model:** drop song → Play → output. Native engine builds trusted default MUSIC channel/wire itself; preserve user-changed SOURCE ONLY/BUS/MAIN MUTE and never change hardware output covertly. Errors have one inline contextual action, not Lab/admission/checkbox. +- **Design-to-code path:** trace actual production host/source paths, not detached classes or demo HTML. Prefer minimal coherent refactor with clear ownership and provenance. New native commands belong to existing bridge/dispatcher contract. +- **Budget discipline:** tests first at cheapest relevant layer, batch related changes into one useful PR revision, choose expensive qualification only at an actually runnable milestone, inspect failures before retry, deliver physical-test package early. + +## 6. Autonomous decision/stop policy + +Proceed without asking for a repeated plan or user approval when the user already requested development and the next scope is clear; do not ask the user to run CI manually. **Stop only for true external blockers** such as untrusted device identity requiring an endpoint choice, unavailable connector permissions, impossible-to-merge branch protection, or physical tests that cannot be simulated. Describe the precise blocker and complete all other feasible work. CI failure is normally an agent debugging task, not a reason to stop and ask a user to act. + +Release sign-off remains distinct from implementation completion: source merge, CI success, verified downloadable ZIP, and independently witnessed physical ASIO/OBS testing are different facts. Report each accurately. + +## 7. One-screen handoff required after actual work + +```text +Goal and user-observable change: +Repository, current main SHA: +Active product PR/branch/exact HEAD SHA: +Actual source changes and focused regression fixtures: +Fast Linux UI/native: PASS/FAIL/PENDING or not applicable + run URLs +Heavy CI chosen: UI / NATIVE / FAT / NONE; exact SHA + job/result URLs +Executable: verified unqualified Windows artifact link or not yet built +Physical ASIO FAT: witnessed PASS / PENDING / FAIL +Blocker (only if real) + next directly actionable milestone: +``` + +**The core KPI is first playable, reliable user workflow per useful PR; CI minutes and number of commits are costs, not progress.** diff --git a/docs/SMART_CI_RUNNER_WORKFLOW.md b/docs/SMART_CI_RUNNER_WORKFLOW.md index 660873a21..ac1841f17 100644 --- a/docs/SMART_CI_RUNNER_WORKFLOW.md +++ b/docs/SMART_CI_RUNNER_WORKFLOW.md @@ -1,5 +1,7 @@ # Smart CI: fast feedback, deliberate expensive qualification +**Binding fast-delivery update (2026-11-09):** [Autonomous Fast Delivery Contract](AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md) is the operative agent behavior. Develop independently while quick CI runs; do not convert the M0 source audit into a separate PR/reviewer gate; one product PR and meaningful revisions; first working ArSon Player MVP gets one exact-SHA `ui + fat` (fat already includes native) for an early testable installer. No repeated Windows/Chromium on each push. Preserve current secure owner-only dispatcher, exact SHA/required tests, release and physical FAT safety. **No changes to Actions workflow code are necessary unless a measured bottleneck is found.** + ## Mandatory start for a new ChatGPT / Codex thread 1. Open [root AGENTS.md](../AGENTS.md) and this runbook from **current @@ -11,11 +13,15 @@ runs and artifacts. Resume the **existing** integration milestone if it covers the request; do not fork a second PCM/GUI authority or open a redundant PR. A previous chat or a snapshot SHA is not source authority. -3. Implement one significant, reviewable product increment with the smallest - safe diff and deterministic tests. Preserve the approved assembled - `/preview/`, native ACK/readback, realtime callback and VST3 state. - Frequent small pushes do **not** justify heavyweight runner jobs. -4. The agent owns the GitHub workflow end to end **in the active chat**: +3. Implement one significant, reviewable **vertical product increment** in one + coherent PR with deterministic tests. An M0 architecture/PCM trace is part + of M1 end-to-end implementation, **not a separate signoff PR**. Preserve + `/preview/`, native ACK/readback, realtime callback, and VST3 state. Push + only useful revisions; small edits do **not** justify heavyweight jobs. +4. The agent may continue independent coding while fast CI is pending; it does + **not** wait for a full Windows/Chromium check to continue other tasks. Fix + relevant CI failures before milestone dispatch/merge. The agent owns the + GitHub workflow end to end **in the active chat**: branch/commit or PR update, fast-failure investigation, selective exact-SHA milestone PR comment, downstream job/artifact inspection, and merge when evidence is sufficient. Do not ask the user to open GitHub Actions to @@ -40,6 +46,7 @@ not override this policy. | C++, VST3 host, DSP, device, ASIO, IPC/control | One `native` request after quick checks; inspect MSVC + CTest | | Physical hardware FAT requires an executable | One `fat` request; MSVC + CTest + verified unqualified ZIP | | Mixed GUI and native product milestone | `ui` plus either `native` or `fat`, only if needed and not already qualified | +| Player MVP requiring a real user-test ZIP | One `ui` plus one `fat` at the accepted exact SHA, after fast UI/native; **never** duplicate with `native` for that SHA | | Existing same-SHA success/running request | Reuse its result; do not post another dispatch comment | | Any relevant `main` promotion | Normal `main` safety CI / guarded Pages deployment, never skipped to save time | @@ -160,3 +167,7 @@ Unresolved risk and next significant milestone: ## Historical CSS migrations Full current-product UI qualification keeps archived V8–V27 migration tests disabled unless `historical_css: true` is explicitly requested. Current approved GUI, native interaction, browser and provenance checks remain mandatory. + +## Operator-first fast delivery amendment (2026-11-09) + +Read [Autonomous Fast Delivery Contract](AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md). Continue code editing while fast CI runs when tasks are independent; finish one real native Player→MUSIC→MAIN workflow before cosmetic or M2 features. No separate M0 plan/review/merge gate, repeated owner approvals, parallel micro PRs or dummy commits to start expensive Actions. Preserve fail-closed hardware identity, Native/Browser quality, exact-SHA jobs, permissions and branch protection. Trigger early unqualified Windows FAT installer **once** when M1 native audio is integrated, so owner can field-test; any later runtime fix requires a new exact-SHA qualification. Do not claim physical FAT on CI success. diff --git a/docs/workstreams/ARSON_PLAYER_IMPLEMENTATION_WORKPACK_20261109.md b/docs/workstreams/ARSON_PLAYER_IMPLEMENTATION_WORKPACK_20261109.md index aed74a932..09895b43d 100644 --- a/docs/workstreams/ARSON_PLAYER_IMPLEMENTATION_WORKPACK_20261109.md +++ b/docs/workstreams/ARSON_PLAYER_IMPLEMENTATION_WORKPACK_20261109.md @@ -1,5 +1,5 @@ # Agent Workpack — ArSon Player Native Music / Setlist -**Date:** 2026-11-09 · **Scope:** executable vertical implementation plan from [PRD](../PRD_ARSON_PLAYER_LIVE_SETLIST_UX_20261109.md) and [ARD](../ARD_ARSON_PLAYER_NATIVE_AUDIO_ARCHITECTURE_20261109.md) · **Status:** PLANNED, NOT IMPLEMENTED. +**Date:** 2026-11-09 · **Scope:** executable vertical implementation plan from [PRD](../PRD_ARSON_PLAYER_LIVE_SETLIST_UX_20261109.md) and [ARD](../ARD_ARSON_PLAYER_NATIVE_AUDIO_ARCHITECTURE_20261109.md) · **Status:** PLANNED, NOT IMPLEMENTED. **Delivery policy:** [Autonomous Fast Delivery Contract](../AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md) is binding; no standalone M0 PR or approval. **M0 and M1 form one continuous native + GUI integration effort with an early testable Windows FAT artifact.** > **Read [AGENTS.md](../../AGENTS.md), [Smart CI](../SMART_CI_RUNNER_WORKFLOW.md), and newer [Zero-Friction Smart Workflow ADR](../ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md).** Binding owner requirement: import → Play → MUSIC PCM to verified MAIN automatically, no Lab, ARM, MONITOR, Apply, checkbox, routing approval or second Start. Preserve user-custom SOURCE ONLY/BUS and unknown physical-output safety. Design only; re-fetch current main/active PRs. @@ -17,7 +17,7 @@ ## 2. Milestone / independently testable vertical slices -### M0 — Architecture spike and exact baseline (no UI feature promise) +### M0 — Embedded engineering groundwork for M1 (same product PR, no intermediate approval) **Goal:** capture actual current render path and make player integration design non-speculative. Tasks: @@ -28,7 +28,7 @@ Tasks: **Exit gate:** legacy input PCM unaffected, native virtual source works, planner auto-provisions exactly one MUSIC→verified MAIN route; user custom routes remain; unknown device cannot be chosen silently. No extra callback or Lab, ARM, MONITOR, approval checkbox in intended operator journey. -### M1 — One truthful player, library & setlist (meaningful first product milestone) +### M1 — First playable deliverable in the SAME product integration PR as M0 **Goal:** usable integrated player with WAV/MP3/FLAC verified formats and manual track transition, **no pitch GUI promise before DSP**. Native: @@ -42,7 +42,7 @@ UI: 6. Extend the **approved Pages source and assembler** with toolbar `Player`, mini transport + compact non-modal left drawer, tabs SETLIST/LIBRARY/QUEUE, dense rows & +Music; simple transport current/next/ACK and intuitive error labels. Keep MAIN visible and one renderer. 7. Keep approved premium CSS: one Add Music/drop empty state, auto-generated setlist and Play controls; Library/Queue contextual, no huge cards, Lab mode, native context menu regression or checkbox wizard. -**Exit gate:** novice B01–B13: drop one song → one Play → native PCM via MUSIC→verified MAIN without PATCH, ARM, MONITOR, confirmation or second Start. 20-file auto-setlist; repeated Play/Stop x100 no duplicate route, SOURCE ONLY and BUS preserved, missing output one contextual selection; 44.1/48/96k, mic ASIO/decoder starvation tested. Omit pitch controls until DSP actually works. +**Exit gate:** novice B01–B13: drop one song → one Play → native PCM via MUSIC→verified MAIN without PATCH, ARM, MONITOR, confirmation or second Start. 20-file auto-setlist; repeated Play/Stop x100 no duplicate route, SOURCE ONLY and BUS preserved, missing output one contextual selection; 44.1/48/96k, mic ASIO/decoder starvation tested. **At the first working M1 vertical milestone**, run fast UI/native then exact-SHA **ui + fat** once to produce a verified UNQUALIFIED user-test Windows ZIP/installer; **never** add duplicate `native` to FAT. Physical listening remains PENDING until witnessed. Omit pitch controls until DSP actually works. ### M2 — Pitch + speed with quality evidence **Goal:** native continuous -6…+6 semitone and 80…120% speed, independent of mic sample clock and with click-free change. @@ -130,7 +130,7 @@ Measure: click samples (>chosen test threshold, disclose), pitch ratio in cents ## 6. Workflow/CI cost policy -M0 design/tests: add unit fixture, fast test only. M1/M2 C++ and JS: fast native+UI first, one `ui` visual run and one `native` lane (or `fat` in place of native if user needs installer) after exact-sha quick gates and duplicate check. Never launch 3 similar Windows packages just for progress. The repo's approved CI dispatcher uses one-line owner PR Conversation commands and exact SHA; inspect existing run before sending. Docs-only revisions require source/diff inspection only. Real ASIO sound, routing and crackle require operator FAT and should be **PENDING** until actually witnessed. +M0 in SAME M1 PR: add native source fixture and first-sound planner with fast checks; continue independent M1 engine/bridge/GUI development while fast CI runs, **no M0-only review, merge, or waiting for manual approval**. At first real M1 playback milestone choose fast UI/native, then exact-SHA `ui + fat` for a user-test artifact (FAT includes native MSVC/CTest); no duplicate `native`. Never launch 3 similar Windows packages just for progress. The repo's approved CI dispatcher uses one-line owner PR Conversation commands and exact SHA; inspect existing run before sending. Docs-only revisions require source/diff inspection only. Real ASIO sound, routing and crackle require operator FAT and should be **PENDING** until actually witnessed. ## 7. Mandatory handoff template per agent @@ -152,3 +152,7 @@ Do not merge docs or implementation PR into alpha.6 release branch. If reviewer/ ## 8. Binding beginner-first release gate (owner correction 2026-11-09) Read [Zero-Friction Smart Workflow ADR](../ADR_ARSON_PLAYER_ZERO_FRICTION_SMART_WORKFLOW_20261109.md) and execute B01–B13 before any product completion claim. M0 must test `ensurePlayerFirstSound` decision/planner and idempotency. M1 must prove actual drop single file → one Play → native PCM to owned MUSIC channel → trusted MAIN, without any manual PATCH/ARM/MONITOR/confirmation/second Start or Lab. Hardware identity remains fail-closed when new/unverified, and intentional SOURCE ONLY/BUS/MAIN MUTE remains sovereign. One actual /preview/ GUI and one ASIO callback only. Browser demo screenshots alone do not certify first sound. + +## 9. Fast-delivery override (2026-11-09) + +[Autonomous Fast Delivery Contract](../AUTONOMOUS_FAST_DELIVERY_CONTRACT_20261109.md) overrides any historical suggestion to split M0 and M1 into separate PRs or await a review before source coding. M0 is an internal engineering fixture/first-sound planner inside the **same implementation PR** as a real M1 user-audible player; continue independent coding while quick CI runs. At a working M1 source→ChannelId→trusted MAIN native PCM + approved GUI, request one exact-SHA UI test and one Windows FAT package (not native plus FAT). Provide the owner a genuinely installable *unqualified* artifact promptly; only real ASIO equipment can complete physical FAT. No manual owner Actions/CI triggers, synthetic progress, Lab UI or permission checkbox.