COMPLETED.md — DeepDrftHome

Archive of items that have moved out of PLAN.md and CMS-PLAN.md. Per CONTEXT.md §6, completed items are moved here rather than deleted. Each entry preserves the original "What / Why / Shape" body so this file reads as a decision record, not just an outcome list.

Newest entries at the top. Group by phase/wave header (mirroring PLAN.md / CMS-PLAN.md themes) when there are enough entries to warrant it.

Landed: 2026-06-19 on dev.

What: The Fixed (embed) mode queue panel and the OQ1 Option-A iframe resize handshake. Release embeds now render an always-shown, read-only queue panel below the player-bar controls; the Queue button collapses/expands that panel and posts the iframe's new height to the host page so the outer <iframe> element resizes to match. Single-track embeds (TrackEntryKey mode) have no queue, no panel, and no Queue button — unchanged compact behaviour. Phase 17 is now complete (all four waves landed).
Why: Phase 11 wave 11.F armed release embeds with a queue (skip navigation, auto-advance), but the viewer had no way to see or jump within the queue. Wave 17.3 surfaces it in Fixed mode — read-only because a shared embed is not an editable playlist — and resolves OQ1 (Option A confirmed feasible: postMessage resize degrades gracefully if the host strips the script).
Shape:
- Fixed embed queue panel (AudioPlayerBar.razor): rendered conditionally on ShowFixedPanel && _fixedPanelOpen inside .deepdrft-queue-embed-panel; hosts <QueueList Items="QueueItems" CurrentIndex="QueueCurrentIndex" Editable="false" OnJump="@OnQueueJump" />. Read-only: no drag handles, no remove buttons. Row-jump (OQ2) calls PlayRelease(Items, index) — coherent from the armed-but-not-started state (PlayRelease already clears IsArmed and materializes a defensive copy).
- Queue button in Fixed mode (PlayerTransportZone): toggles _fixedPanelOpen; triggers a height post after the panel renders. Gated on ShowFixedPanel so single-track embeds see no button.
- EmbedSnippetBuilder.cs (DeepDrftPublic.Client/Helpers/EmbedSnippetBuilder.cs): ForRelease now mints a per-snippet random token (8 hex chars from Guid.NewGuid().ToString("N")[..8]). Token is used as the iframe id (deepdrft-embed-{token}) and threaded into the iframe src as &EmbedId={token}. Taller iframe height (release: 384 px vs. track: 196 px). Carries a host-side <script> listener that matches incoming {type:"deepdrft-embed-resize", embedId} messages against the snippet's own token and sets iframe.style.height — multiple release embeds on one host page resize independently (no cross-talk). Degrades to Option B if the host strips the script (panel still works inside the iframe at expanded height). ForTrack is unchanged (compact height 196 px, no script, no id token).
- embed-frame.ts (DeepDrftPublic/Interop/embed/embed-frame.ts; compiled output gitignored): new TypeScript interop module. Reads EmbedId from window.location.search once at module load; exports postHeight(element: HTMLElement) — measures the player element's rendered height (Math.ceil(getBoundingClientRect().height) + 2), builds {type:"deepdrft-embed-resize", height, embedId?} payload (omits embedId when absent for backward-compatible degradation), and calls window.parent.postMessage(payload, "*"). No-ops when not framed (window.parent === window) or the element is unmeasurable.
- CSS (DeepDrftPublic/wwwroot/styles/deepdrft-styles.css): new deepdrft-queue-embed-panel and related deepdrft- embed-panel classes for the fixed queue panel chrome.
- Tests (EmbedSnippetBuilderTests): height divergence (ForRelease taller than ForTrack), ForTrack-unchanged (height 196, no script), id uniqueness (two ForRelease calls yield distinct ids), id/script-token consistency (iframe id matches token in script), EmbedId-in-src (token appears as EmbedId= in the iframe src).

Landed: 2026-06-19 on dev.

What: The append-only Add-to-Queue affordance on detail pages — a new shared AddToQueueButton.razor control wired at every detail-page play site, enabling listeners to add a release or individual track to the queue without interrupting the current track. ReleaseGallery browse-grid cards are intentionally excluded (OQ10, deferred).
Why: Phase 11 wave 11.F built the Enqueue/EnqueueRange append path in the queue engine but gave it no UI entry point. Wave 17.4 lights that dormant path, completing the Add-to-Queue capability Daniel stated as commitment 4 of Phase 17. It was split from 17.2 because it depends only on the existing engine append members (not on 17.1's new Move/RemoveAt), allowing it to land in parallel.
Shape:
- AddToQueueButton.razor (DeepDrftPublic.Client/Controls/AddToQueueButton.razor): shared append-only button with two modes: track mode (Enqueue — called with a single TrackDto) and release mode (EnqueueRange — called with an ordered IReadOnlyList<TrackDto>). Material PlaylistAdd glyph; tooltip reads "Add to queue" (track mode) or "Add release to queue" (release mode). Reads the cascaded IQueueService; disabled until interactive / when the cascade is absent; append-only — does not play, does not navigate.
- CutDetail.razor (header): release-mode AddToQueueButton beside the header play affordance, passing the TrackNumber-ordered track list.
- CutDetail.razor (track rows): track-mode AddToQueueButton beside the per-row play affordance.
- SessionDetail.razor (hero play): track-mode AddToQueueButton beside the Session hero play button.
- MixDetail.razor (hero play): track-mode AddToQueueButton beside the Mix hero play button.
- Excluded sites: StreamNowButton (no fixed track to resolve — OQ9) and ReleaseGallery cards (no play button today — OQ10, deferred to TODO.md).

Landed: 2026-06-19 on dev.

What: The editable docked-player queue overlay — a Queue toggle button in the non-Fixed (docked) player bar and a new QueueOverlay.razor modal that hosts the shared QueueList in editable mode. Listeners can now see, reorder, remove from, and jump within the queue while a release is playing. Also fixed a pre-existing QueueChanged unsubscribe leak in AudioPlayerBar.DisposeAsync, hardened PlayRelease with a defensive copy, and styled the global deepdrft-queue-* CSS classes for the first time (first styling for the QueueList classes that 17.1 shipped unstyled).
Why: Phase 11 built the queue engine and Phase 17 wave 17.1 built the shared QueueList component, but neither surfaced the queue visually in the docked player. Wave 17.2 delivers Daniel's commitment 2 — a visible, editable queue panel in the non-Fixed player bar.
Shape:
- Queue toggle button (AudioPlayerBar / PlayerTransportZone): shown only when !Fixed && Items.Count > 0, placed below the transport-button row and left of the timestamp. Material QueueMusic glyph; renders in an active/highlighted state when the overlay is open.
- QueueOverlay.razor (DeepDrftPublic.Client/Controls/QueueOverlay.razor): screen-centered tinted modal borrowing the WaveformVisualizerControlPopover MudOverlay idiom (DarkBackground="true", Modal="true"). Panel stops click propagation; scrim-click closes the overlay (drag-safe: capture div sits above the scrim during a drag so releasing outside the panel never fires the close handler). Auto-closes if a removal empties the queue. Hosts QueueList in Editable="true" mode.
- AudioPlayerBar wiring: reorder → Move(fromIndex, toIndex); remove → RemoveAt(index) (auto-closes overlay when queue empties); row-jump → PlayRelease(Items, index); Clear header action → new ClearUpcoming(). Fixed pre-existing QueueChanged unsubscribe leak in DisposeAsync.
- QueueList.razor — current-row remove suppression: the remove (×) control is now hidden on the currently-playing row (Editable && !isCurrent), enforcing OQ3's "the current track cannot be removed" rule in the UI. Reorder of the current row is still permitted.
- Engine — ClearUpcoming() (IQueueService / QueueService): new additive member. Removes all queued items except the currently-playing one, leaving it as the sole item at CurrentIndex == 0; re-emits QueueChanged; touches no playback. Satisfies OQ5's requirement that Clear does not stop or remove the current track.
- Engine — PlayRelease defensive copy: PlayRelease now always materializes a defensive copy of its input list (tracks.ToList()) so it can never alias the caller's Items list — fixes a row-jump bug where jumping via PlayRelease(Items, index) could mutate the live Items reference mid-operation.
- CSS — deepdrft-queue-* classes (DeepDrftPublic/wwwroot/styles/deepdrft-styles.css): overlay/list chrome classes added to the global stylesheet (portaled overlay content cannot use scoped CSS). This is also the first styling pass for the QueueList classes 17.1 introduced without accompanying styles.

Landed: 2026-06-19 on dev.

What: The queue-engine additions and the shared presentational list component that waves 17.2 and 17.3 will consume. No player-bar wiring, overlay, embed, or Add-to-Queue affordance landed — those remain in waves 17.2 and 17.3.
Why: Wave 17.1 is the cold-start prerequisite for the full Phase 17 queue-view surface. The engine additions are interop-free state mutations that land without any UI decision being made; QueueList is the single presentational "view" both the docked overlay and the embedded panel will share (one source, multiple views), so it is cleanest to build and test it before the hosting contexts exist.
Shape:
- Engine — Move(int fromIndex, int toIndex) (IQueueService / QueueService): reorders Items in-place, adjusts CurrentIndex so the same track stays current across the move, re-emits QueueChanged. Never re-streams or interrupts the playing track. No-op (no QueueChanged) when either index is out of range or the indices are equal. Interop-free; safe during prerender.
- Engine — RemoveAt(int index) (IQueueService / QueueService): removes the item at index, adjusts CurrentIndex (a track before current decrements the index; a track after current leaves it unchanged; removing the current track does not stop playback — the track runs to natural end while CurrentIndex resolves to the new slot occupant; removing the last remaining item leaves the queue empty and dormant with CurrentIndex == -1). Re-emits QueueChanged. No-op when index is out of range. Interop-free; safe during prerender.
- Engine — dormant-Enqueue coherence (OQ8): Enqueue and EnqueueRange into an empty/dormant queue (CurrentIndex == -1) now set CurrentIndex to 0 so a subsequent play/skip is correct. Does not auto-play — add is not play. PlayCurrent is never called from these paths; the methods remain interop-free.
- QueueList.razor (DeepDrftPublic.Client/Controls/QueueList.razor): purely presentational component. Renders Items as an ordered list with the current track marked (position number + GraphicEq now-playing icon on the current row). Editable flag gates drag-reorder handles and per-row remove controls: when true, wraps rows in a MudDropContainer/MudDropZone for reorder; when false, renders a plain <div> (read-only; the embed's fixed-order shared queue). Reorder, remove, and row-jump are surfaced to the parent as EventCallback<(int FromIndex, int ToIndex)> OnReorder, EventCallback<int> OnRemove, and EventCallback<int> OnJump respectively — the component calls no IQueueService method itself. Owns no data fetch or player wiring. Runs during prerender without JS interop (drag work is client-only and inert when no drag occurs).
- QueueServiceTests: T1–T10 added, covering Move (in-range, out-of-range, same-index no-ops; current-track identity preserved across reorders) and RemoveAt (before/after/at current; last-item dormant; out-of-range no-op; playback not stopped).

Landed: 2026-06-19 on dev.

What: The capstone wave — the live home hero Plays card and the HomeStatsDto extension that powers it. NowPlayingStats.razor's third card, previously a static "XXX / Plays (Coming Soon)" odometer placeholder, now renders the live TotalPlays figure in the existing odometer treatment with a secondary "N listeners" line (UniqueListeners). No new fetch path, no new client service, no migration — the card consumes the same HomeStatsDto round-trip the other two cards already use. Privacy footer line (DeepDrftFooter.razor, .deepdrft-footer-privacy) also landed as part of the same merge: a quiet fine-print disclosure of the anonymous anonId token, using the Variant 1 approved copy from product-notes/phase-16-privacy-note.md.
Why: The Plays card was deliberately held as the final wave (sequenced bottom-up per Daniel's directive) so the substrate (16.1 capture + rollup, 16.2 bucket/channel, 16.3 anonId + distinct-listener aggregation) would be solid before any read surface appeared. Wave 16.4 (per-target / CMS stats views) was speculative and skipped; the event log supports it later if wanted. With 16.5 landing, Phase 16 is complete.
Shape:
- HomeStatsDto extended (DeepDrftModels/DTOs/HomeStatsDto.cs): two new fields — TotalPlays (long; site-wide sum of every play_counter row's PartialCount + SampledCount + CompleteCount, all-time; zero until the telemetry migration is applied — expected, not an error) and UniqueListeners (int; distinct non-null anon_id across all play events, all-time; over-counts by design, honestly labelled "listeners"). No other DTO changes.
- StatsController composition (DeepDrftAPI/Controllers/StatsController.cs): now injects ITrackService (existing) and IEventService (Phase 16 event domain). GetHome assembles HomeStatsDto in two sequential best-effort reads: track-domain aggregation via ITrackService.GetHomeStats (existing; failure returns 500 as before); play/listener figures via IEventService.GetTotalPlayCount and IEventService.GetDistinctListenerCount (Phase 16; a telemetry failure or not-yet-applied migration leaves them at 0 rather than 500-ing the whole endpoint). Neither domain reaches into the other's tables; the controller is the composition seam only.
- IEventService additions (DeepDrftData/IEventService.cs): GetTotalPlayCount(ct) → ResultContainer<long> and GetDistinctListenerCount(ct) → ResultContainer<int> (wave 16.3 added the distinct-listener overloads; GetTotalPlayCount is the one new member for 16.5).
- EventRepository.CountTotalPlaysAsync (DeepDrftData/Repositories/EventRepository.cs): sums PartialCount + SampledCount + CompleteCount directly over PlayCounters via LINQ — not PlayCounter.TotalPlays (which is an EF-ignored computed property and not translatable). An empty counter table sums to 0.
- NowPlayingStats.razor (DeepDrftPublic.Client/Controls/NowPlayingStats.razor): third card now renders @_stats.TotalPlays in .hero-stat-odometer and @_stats.UniqueListeners listeners as .hero-stat-sub. No change to the PersistentComponentState bridge or IStatsDataService fetch path — the DTO fields arrive in the same existing round-trip.
- DeepDrftFooter.razor (DeepDrftPublic.Client/Layout/DeepDrftFooter.razor): privacy disclosure paragraph (.deepdrft-footer-privacy) added: "We keep a random tag in your browser so we can count how many people a track reaches — not who they are. No account, no name, nothing personal, nothing shared with anyone else. Clear your browser data and the tag's gone."
- No migration. The play_counter rollup table was created by 20260619155610_AddPlayShareTelemetry (wave 16.1; authored, not yet applied — Daniel-gated). The CountTotalPlaysAsync query returns 0 gracefully until that migration runs.

Landed: 2026-06-19 on dev.

What: The anonymous telemetry substrate — foundation end-to-end with nothing reading it yet. No anonId written; no home-card/read surface changed (those are waves 16.3 and 16.5). The full capture-and-storage pipeline is in place: client-side play-session tracker and share tracker, sendBeacon transport with page-unload handler, proxied and rate-limited intake endpoints, append-only SQL event log with incremental rollup, and server-side release attribution.
Why: The home hero's Plays stat card (NowPlayingStats.razor's third card) has been a static "XXX / Plays (Coming Soon)" placeholder. Phase 16 builds the anonymous, privacy-light substrate that will eventually power it. Wave 16.1 is the cold-start foundation — nothing reads the log yet; correctness and storage are the deliverable, not the visible metric.
Shape:
- Client — PlayTracker (DeepDrftPublic.Client/Services/PlayTracker.cs): opens a play session on playback start, advances a high-water position on each progress tick (instrumented at StreamingAudioPlayerService, not at the HTTP layer, so seek-beyond-buffer re-fetches count as the same play), closes on track-switch / stop / organic-end / page-unload. Engagement floor: ≥3s OR ≥5% of duration (whichever is smaller). Three-bucket classification: partial < 30%, sampled 30–80%, complete > 80%. Emits at most one event per session via IPlayEventSink. Deliberately free of player, HTTP, and JS dependencies for testability.
- Client — ShareTracker (DeepDrftPublic.Client/Services/ShareTracker.cs): called by SharePopover after a successful clipboard write; applies a 60-second per-(target, channel) debounce so repeated copies of the same link in a session count as one share. Sends via sendBeacon. No anonId in wave 16.1.
- Client — BeaconInterop (DeepDrftPublic.Client/Services/BeaconInterop.cs): navigator.sendBeacon JS interop wrapper + page-unload handler that flushes any pending play event when the page is torn down.
- Public proxy — EventProxyController (DeepDrftPublic/Controllers/EventProxyController.cs): proxies POST api/event/play and POST api/event/share to DeepDrftAPI. Buffers and relays the small JSON body verbatim; forwards X-Forwarded-For for per-IP rate limiting on the API side. Opts out of antiforgery ([IgnoreAntiforgeryToken]) — sendBeacon cannot attach tokens.
- API — EventController (DeepDrftAPI/Controllers/EventController.cs): POST api/event/play and POST api/event/share, unauthenticated, rate-limited by the "events" fixed-window policy (30 requests / 60 s per IP, registered in Program.cs). Returns 202 Accepted (fire-and-forget contract). Payload-validates the track key and enum values; delegates writes to IEventService.
- API — rate limiter (DeepDrftAPI/Program.cs): AddRateLimiter + "events" fixed-window policy keyed on Connection.RemoteIpAddress; UseForwardedHeaders in production resolves the XFF chain into the real client IP. UseRateLimiter() added to the middleware pipeline.
- Data — EventRepository (DeepDrftData/Repositories/EventRepository.cs): append-only writes to play_event and share_event tables; incremental-on-write bump of the play_counter rollup (D6); server-side track→release resolution at write time (D4) — the client sends only the track EntryKey, the repository stamps the release id.
- Data — EventManager / IEventService (DeepDrftData/EventManager.cs): IEventService boundary (RecordPlay, RecordShare); EventManager wraps EventRepository and returns NetBlocks Result. Registered scoped in DeepDrftAPI/Program.cs alongside the existing track and release domain services.
- Migration 20260619155610_AddPlayShareTelemetry: adds play_event, share_event, and play_counter tables. Authored but not yet applied (Daniel-gated).

Phase 16 — Anonymous Play & Share Tracking: Wave 16.3 — Unique-listener `anonId` layer (landed 2026-06-19)

Landed: 2026-06-19 on dev (merge 297805b). No migration — anon_id varchar(64) columns and IX_play_event_anon_id/IX_share_event_anon_id indexes already shipped in the wave 16.1 migration.

What: The unique-listener anonId seam end-to-end — the "last metric layer" of the Phase 16 substrate. Client mints a first-party localStorage GUID on first visit, threads it onto play and share beacon payloads (omitted when null), server accepts and length-clamps it (reject-not-truncate, ≤64 chars), persists it to the reserved nullable anon_id columns, and exposes all-time distinct-listener aggregation. The distinct-count capability is in place but not yet surfaced on any read surface (16.5 consumes it). Privacy-notice copy deliberately not authored (Daniel-gated).
Why: The anonymous unique-listener metric (D5 / D3) is the final substrate wave before the home Plays card can be lit (16.5). It was sequenced last of the metric layers because it is the lowest-priority metric and carries no dependency — the event log captures anon_id on the same rows 16.1 already writes; 16.3 simply lights the seam that was reserved but unused.
Shape:
- Client — IAnonIdProvider / AnonIdProvider (DeepDrftPublic.Client/Services/IAnonIdProvider.cs, AnonIdProvider.cs): IAnonIdProvider exposes string? Current (synchronous cached read, safe on the unload path) and ValueTask EnsureLoadedAsync() (warms the cache from localStorage via JS interop — idempotent, best-effort, never throws). AnonIdProvider is the production implementation over the window.DeepDrftAnonId.get interop call. Degrades to null when localStorage is unavailable (private mode / blocked / partitioned iframe) — missing id is the accepted graceful path; over-counting is the direction of error (§3). Scoped (per-session cache); the token itself outlives the session in localStorage.
- Client — TypeScript interop (DeepDrftPublic/Interop/telemetry/anonid.ts): mints and reads the localStorage GUID. Exposes window.DeepDrftAnonId.get. Returns null without throwing when storage is unavailable.
- Client — BeaconPlayEventSink (DeepDrftPublic.Client/Services/BeaconPlayEventSink.cs): now injects IAnonIdProvider; reads _anonId.Current synchronously at emit time and sets PlayEventDto.AnonId. Null id produces an anonId-less payload (the field is omitted from the wire JSON entirely via WhenWritingNull — the API treats absent and null identically).
- Client — ShareTracker (DeepDrftPublic.Client/Services/ShareTracker.cs): now injects IAnonIdProvider; reads _anonId.Current at share time and sets ShareEventDto.AnonId. Same null-omit posture as the play sink.
- API — EventController (DeepDrftAPI/Controllers/EventController.cs): TryNormalizeAnonId helper on both POST api/event/play and POST api/event/share — whitespace-only / empty / null collapses to null (valid anonId-less event); a token longer than 64 chars is rejected with 400 Bad Request rather than truncated (truncation would collide distinct listeners onto one prefix); valid tokens are trimmed and passed through.
- Data — EventRepository (DeepDrftData/Repositories/EventRepository.cs): three new distinct-count queries (already in the repository as of 16.3): CountDistinctListenersAsync() (site-wide, nulls excluded), CountDistinctListenersForTrackAsync(trackEntryKey) (per-track), CountDistinctListenersForReleaseAsync(releaseId) (per-release, uses the stamped release_id on the play event row — D4 attribution).
- Data — IEventService / EventManager (DeepDrftData/EventManager.cs): three new members exposing the distinct-count capability: GetDistinctListenerCount(), GetDistinctListenerCountForTrack(trackEntryKey), GetDistinctListenerCountForRelease(releaseId) — each returns ResultContainer<int>. No read surface or card consumes them yet (16.5).
- No migration — the anon_id varchar(64) columns on play_event and share_event and their covering indexes (IX_play_event_anon_id, IX_share_event_anon_id) were already created by 20260619155610_AddPlayShareTelemetry (wave 16.1). Wave 16.3 only wires the client seam and adds the server-side aggregation queries.

Landed: absorbed into wave 16.1 (2026-06-19). All §4.1 deliverables shipped inside the foundation wave.

What: Three-bucket completion classification correct and exhaustive end to end, and share-channel split. Because these were structurally inseparable from the foundation (the tracker, payload, log table, and rollup all required the bucket column set from day one), they landed together with 16.1 rather than as a follow-on wave.
Why: The §4.2 spec listed bucket classification and share-channel split as wave 16.2 items, but the implementation showed they could not be cleanly deferred — the play_counter rollup columns are per-bucket by design (D6), and the share channel discriminator is a single non-null column on the share_event table. Building the log without them would have required a migration to add them in 16.2 anyway.
Shape:
- PlayBucket enum (DeepDrftModels.Enums): Partial (< 30%), Sampled (30–80%), Complete (> 80%) — exhaustive, non-overlapping. D1 resolved.
- PlayCounter rollup columns (DeepDrftModels.Entities.PlayCounter): PartialCount, SampledCount, CompleteCount (each long), TotalPlays (computed long sum). BumpCounterAsync in EventRepository switches on the bucket to increment the correct column in the same transaction as the event append.
- API-boundary bucket validation (EventController): Enum.IsDefined(payload.Bucket) guard — an undefined bucket value returns 400 Bad Request before the write reaches the repository.
- ShareChannel enum (DeepDrftModels.Enums): Link / Embed on ShareEvent.Channel. ShareTracker passes the channel through from the SharePopover clipboard action; EventController validates it is a defined ShareChannel value.
- Deferred: optional share_count rollup column on play_counter (per-track share count in the rollup table) — not built. Shares are not on the home-card hot path; per-target share reads are speculative wave 16.4 work.

Home Hero Stats — Live data wiring (landed 2026-06-18)

Landed: 2026-06-18 on dev (commits 5f0422a + 8fa330f, merged e9e6b60).

What: Replaced the hard-coded placeholder figures in the public home hero stat row (NowPlayingStats) with real SQL-backed aggregates. Resolves the "Real stat-row numbers" deferred item from Phase 0 §0.3.
Why: The stat row ("47+ / 2 / ∞") was intentionally hard-coded at Phase 0 with a TODO; the data model now has enough shape (releases, medium discriminator, track–release join) to serve real numbers in a single efficient query.
Shape:
- New SQL column: DurationSeconds (double?, column duration_seconds) on TrackEntity and TrackDto. Populated at upload via the existing dual-database add flow (TrackContentService extracts duration from vault audio; UnifiedTrackService persists it to SQL). Migration 20260618155002_AddTrackDuration. Configured in TrackConfiguration.
- New aggregate query: TrackRepository.GetHomeStatsAsync → HomeStatsDto (new DTO in DeepDrftModels/DTOs/). Returns cut track count, per-ReleaseType cut release counts (zero-count types suppressed), mix release count, and total mix runtime seconds (null durations counted as 0; tracks under soft-deleted releases excluded). Surfaced via ITrackService.GetHomeStats on TrackManager.
- New API endpoints: GET api/stats/home (StatsController, unauthenticated; returns HomeStatsDto bare) and POST api/track/duration/backfill (ApiKey-gated; one-time backfill of DurationSeconds for pre-existing rows from vault audio, delegated to UnifiedTrackService.BackfillDurationsAsync).
- New public proxy: StatsProxyController in DeepDrftPublic mirrors ReleaseProxyController; forwards GET api/stats/home from the browser to DeepDrftAPI.
- New client surface: StatsClient (Clients/, named "DeepDrft.API" client) + IStatsDataService / StatsClientDataService (Services/) registered scoped in Startup.ConfigureDomainServices. RuntimeFormat static helper (Helpers/) converts seconds to hh:mm.
- NowPlayingStats.razor: now renders live data — Studio Cuts card (cut track count + zero-suppressed Single/EP/Album breakdown), Mixes card (MixReleaseCount "Sets" + hh:mm runtime), Plays card (static "XXX / Coming Soon" odometer placeholder). Uses PersistentComponentState to bridge the SSR prerender fetch across the WASM seam (only persists on a successful load).

Phase 12 — About Page (public site editorial) (landed 2026-06-17)

Landed: 2026-06-17 on dev.

What: A real About page for the public site (/about), built entirely in the Home page's existing visual language — no new look. Three movements — the People, the Process, the Product — with ethos / pathos / logos woven through the prose as registers, not labelled blocks. The strategic frame (Daniel): the site is presentation and proof of effort — evidence that real people are pushing the classic club sound forward; the About page is where that claim is made explicit. Built as DeepDrftPublic.Client/Pages/About.razor + scoped About.razor.css; registered in the nav index (DeepDrftPublic.Client/Layout/Pages.cs). Images served statically from DeepDrftPublic/wwwroot/img/; image slots and Khabran's bio degrade gracefully until final assets/copy land.
Why: This is its own phase, not a graft onto Phase 11: Phase 11 was structural (release-cardinal browse, queue, GUID handles), whereas this is a net-new editorial surface. The page reuses Home's section primitives wholesale (.hero, .section-divider, two-column .section, dark .section-dark feature band, .section-split, .cta-banner, ParallaxImage full-bleed bands) — no new visual language introduced; the only candidate new styling is two member-bio cards, assembled from existing type tokens. Full spec: product-notes/about-page.md.
Shape: DeepDrftPublic.Client/Pages/About.razor (new; @page "/about"; three-movement editorial page using Home section primitives); DeepDrftPublic.Client/Pages/About.razor.css (new; scoped styles — Home section primitives currently re-declared here rather than shared globally, a known follow-up); DeepDrftPublic.Client/Layout/Pages.cs (nav index registration added). Static images from DeepDrftPublic/wwwroot/img/.

Voice constraint (hard): smart, serious, no AI-isms — underground Detroit/Midwest deep-club-house heritage carried to Charleston. All body prose remains DRAFT pending Daniel's approval — section headers and UI labels are set; any sentence/paragraph of site copy is a placeholder until Daniel passes it.

Open follow-ups: (1) ~~Final photo files for the five image slots~~ Photo slots largely resolved: bio portraits (Khabran + Daniel) now wired as circular framed portraits with a bw→colour hover crossfade (dd-khabran, dd-daniel); Process hands-on-gear figure now uses bespoke dd-mixer-2; the Liner Notes redesign removed the separate full-bleed atmosphere and closing-band slots, so the duo hero (dd-duo-2) and the hands-on-gear inset are the only full-bleed image positions remaining and both carry bespoke assets. Home page "Our Origin" split swapped the retired kp-shoulder for dd-pedals. (2) ~~Khabran's bio text still open~~ Khabran's bio is now wired (three paragraphs; bio-body render updated to emit each paragraph as its own <p class="bio-body"> — Daniel's single-paragraph bio is unaffected). (3) Optional promotion of the duplicated Home section primitives from About.razor.css to a shared global stylesheet. (4) ~~Whether CUTS/SESSIONS/MIXES are explained on the page~~ Resolved by the Liner Notes redesign: the triptych renders as a stacked editorial definition list (see Redesign addendum below).

Redesign — Liner Notes editorial treatment (2026-06-17): The page was rebuilt from the Home section primitives approach into a distinct "Liner Notes" editorial layout. Structure and copy (three-movement People / Process / Product) are unchanged; the visual treatment is entirely new. Key elements: numbered left rail (oversized Bodoni 01/02/03 movement numerals + continuous vertical hairline spine + mono marginalia captions), asymmetric content column, pull-quotes breaking left into the margin, hand-authored SVG waveform movement dividers (a self-contained decorative motif, not the live WaveformVisualizer component). The CUTS/SESSIONS/MIXES triptych is now a stacked editorial definition list rather than Home's medium-card image grid. Active-movement highlight on the left rail is progressive enhancement via a new DeepDrftPublic/Interop/about/about-rail.ts IntersectionObserver interop (compiled output gitignored). Superseded Home section primitives were removed from About.razor.css; the global stylesheet was untouched. Design authority: product-notes/about-page-distinction.md (Direction 1).

Phase 15 — Visualizer Controls Enhancements (landed 2026-06-17)

Landed: 2026-06-17 on dev.

What: A presentation and interaction rework of the waveform visualizer control surface — the eight-RadialKnob panel (Phase 12) hosted by WaveformVisualizerControlPopover. Not a renderer change: the WebGL2 visualizer, the eight continuous dial values + their defaults, and the Changed-event bridge seam are unchanged. The phase reworks how the controls are reached and presented, adds two on/off toggles (lava, waveform), and gives the panel a deterministic, sectioned layout that encodes the visualizer's composition (lava field + waveform ribbon, optionally overlaid).

Four tracks shipped as a single bundled PR (15.A → {15.B, 15.C} → 15.D):
- 15.A — State booleans + bridge wiring. Two new WaveformVisualizerControlState booleans: LavaEnabled and WaveformEnabled (both default true). WaveformVisualizer.ts gained a genuine per-subsystem draw-skip: when a subsystem is "off" it is not drawn, contributes no collisions, and incurs no render cost (not dimmed). The bridge pushes the new booleans on Changed alongside the eight existing dials. The per-subsystem draw-skip seam was built as part of this track (it did not exist prior).
- 15.B — Screen-centered tinted-modal primitive + NowPlayingCard chrome. WaveformVisualizerControlPopover changed from an anchored MudPopover to a screen-centered, tinted modal MudOverlay (DarkBackground, Modal="true"). The AnchorOrigin/TransformOrigin parameters were dropped — a centered modal has no anchor. Panel chrome follows the NowPlayingCard look: square corners, lighter-navy ground, thin light border. Chrome classes stay in the global deepdrft-styles.css (CSS isolation cannot reach portaled overlay content). Tint opacity resolves from a single --deepdrft-modal-scrim-alpha token. Knob-drag safety is preserved: RadialKnob mounts its own position:fixed capture div above the scrim while dragging, so releasing outside the panel does not close the modal.
- 15.C — Deterministic three-row layout + toggles + scroll slider. The flat eight-knob grid replaced by a three-row sectioned layout: Row 1 (MODE, always visible): two lamp toggles (lava / waveform) left-aligned + collisions knob (only when both subsystems on) + color knob pinned far-right. Row 2 (LAVA, visible only when lava on): "LAVA:" label + Gravity / Heat / FluidAmount / FluidViscosity knobs. Row 3 (WAVE, visible only when waveform on): "WAVE:" label + scroll/zoom MudSlider (bound to ScrollSpeed alone) + width knob pinned far-right. The lamp toggles use the DDIcons.LavaLamp / DDIcons.LavaLampFilled glyph (lit = on, unlit = off) and are green (Color.Primary) because they are interactive.
- 15.D — Tooltips + light icon colour. Each control received a playful, non-technical MudTooltip. Knob caption icons and section labels changed to light (Color.Default / CSS light token) per the resolved colour principle: green = interactive elements (toggles, knob arcs/pointers, scroll slider); light = static/decorative elements (section labels, caption icons).
Why: The eight-knob flat grid gave the user no signal about which knobs drive the lava vs. the waveform, and neither subsystem could be turned off independently. The new layout sections controls by subsystem, making "lava only" / "waveform only" first-class operating modes. The screen-centering solves the anchored-popover problem: MudPopover positions off its trigger's bounding rect — wrong for a control panel that should read as centered regardless of where the lava-lamp icon sits (Mix corner, Cut/Session ambient, NowPlaying corner).
Shape: DeepDrftPublic.Client/Controls/WaveformVisualizerControls.razor — three-row layout replacing the flat eight-knob grid; two ToggleLava/ToggleWaveform handlers; conditional row visibility; MudSlider for scroll speed. DeepDrftPublic.Client/Controls/WaveformVisualizerControlPopover.razor — MudPopover replaced by MudOverlay (centered, DarkBackground, Modal); AnchorOrigin/TransformOrigin parameters removed. DeepDrftPublic.Client/Services/WaveformVisualizerControlState.cs — two new boolean properties (LavaEnabled, WaveformEnabled) and matching DefaultLavaEnabled/DefaultWaveformEnabled consts (both true). DeepDrftPublic/Interop/visualizer/WaveformVisualizer.ts — per-subsystem draw-skip seam (lava physics + blob uploads skipped when lava off; ribbon SDF + collision boundary dropped when waveform off). DeepDrftPublic/wwwroot/styles/deepdrft-styles.css — --deepdrft-modal-scrim-alpha token; .waveform-visualizer-control-overlay centering; .waveform-visualizer-control-modal panel chrome (square corners, lighter-navy, thin border); row/section layout classes (wvc-row, wvc-row-mode, wvc-row-section, wvc-row-wave, wvc-section-label, wvc-toggle, wvc-slider). Full design, layout contract, primitive rationale, tooltip copy, and acceptance: product-notes/phase-15-visualizer-controls-enhancements.md.

Post-landing fixes (2026-06-17): Seven defects found during smoke-testing were remediated in a follow-up round on dev: (1) new --deepdrft-panel-ground CSS token so the blue slider reads against the panel background; (2) drag-scrollbar removed + body-scroll locked while the modal is open; (3) knob caption icons forced light so lamp toggles stay green; (4) WAVE-row slider vertically centered; (5) site-wide RadialKnob pointer-capture fix — drag no longer sticks when the cursor leaves the browser window, implemented via real setPointerCapture / releasePointerCapture (benefits every RadialKnob on the site, not just this panel); (6) modal scrim alpha softened (0.3 → 0.15); (7) modal overlay z-index raised above the header and player-dock footer. Fix #5 introduced a new TypeScript interop module in DeepDrftShared.Client: Interop/knob/knob.ts (exports capturePointer/releasePointer), compiled to wwwroot/js/knob/knob.js via Microsoft.TypeScript.MSBuild, lazy-imported by RadialKnob.razor as _content/DeepDrftShared.Client/js/knob/knob.js — following the existing parallax.ts precedent in the same RCL.

Polish round 2 (2026-06-17): Five further UI changes from Daniel's second review: (1) panel ground darkened further (--deepdrft-panel-ground #1e2028 → #1a1c22); (2) WAVE-row scroll/zoom control reverted from MudSlider back to a RadialKnob — Daniel's explicit call, reversing the §8 slider decision; the scroll control is now a knob like the other dials; (3) waveform toggle given its own distinct icon — new DDIcons.Waveform/WaveformFilled six-bar sound-wave glyph, so the waveform toggle and lava toggle each have a unique visual identity (lava toggle keeps the lamp); (4) strong active-state styling on both toggles — green-accent filled chip + ring when ON, dimmed when OFF, making subsystem state unmistakable at a glance; (5) WaveformVisualizerControlPopover.razor in-source comment refreshed to describe the setPointerCapture mechanism.

Phase 14 — CMS Releases Consolidation (landed 2026-06-17)

Landed: 2026-06-17 on dev.

What: Retired the CMS /tracks list view and consolidated all release browsing into a new standalone /releases page (DeepDrftManager/Components/Pages/Tracks/Releases.razor). The TRACKS|RELEASES BrowseMode toggle is gone. The /releases layout is: bulk-action buttons (Generate All Profiles / Backfill High-res) → medium tab strip (ALL / CUTS / SESSIONS / MIXES) → the active tab's grid. The unique per-track waveform-status columns (Profile / High-res, with per-row generate buttons) and the per-track info tooltip (EntryKey + OriginalFileName) now live in CmsAlbumBrowser's expanded child-row track table; page-level bulk runs and per-row generates share a refresh bridge (InvalidateWaveformStatusAsync + OnWaveformGenerated EventCallback wired through each medium container). The /catalogue dashboard cards changed from Tracks / Releases / Genres to CUTS / SESSIONS / MIXES, each deep-linking to /releases?medium=<medium> with the matching tab pre-selected. Old list routes /tracks, /tracks/albums, /tracks/archive are kept as aliases on Releases.razor so bookmarks don't 404; /tracks/genres was removed. Operational sub-routes (/tracks/upload, edit routes, /tracks/mixes, /tracks/sessions, etc.) stayed at /tracks/*. ICmsTrackService.GetGenreSummariesAsync removed (dead interface member). GetTrackCountAsync intentionally retained — planned for the public-site NowPlayingStats feature.
Why: The /tracks page mixed a list view and a releases browser behind a toggle (BrowseMode), and the waveform-status columns cluttered a per-track list that had no natural home once releases became the cardinal browse unit. Consolidating into a dedicated /releases page with a medium tab strip matches the release-medium mental model established in Phase 9 and makes waveform management a subordinate detail of the release's expanded track table rather than a top-level grid column. Retiring genre browse removes a dead-end CMS surface (genre is a filter, not a first-class browse dimension for the admin).
Shape: New: DeepDrftManager/Components/Pages/Tracks/Releases.razor (@page "/releases" + alias routes for /tracks, /tracks/albums, /tracks/archive). Deleted: TrackList.razor, CmsTrackGrid.razor (+ .css), CmsGenreBrowser.razor (+ .css), Services/CmsTrackBrowserViewModel.cs (+ its DI registration in Program.cs). Changed: Index.razor dashboard cards updated to CUTS / SESSIONS / MIXES deep-linking to /releases?medium=<medium>; CmsAlbumBrowser expanded child-row track table gains waveform-status columns + info tooltip + OnWaveformGenerated EventCallback; ICmsTrackService / CmsTrackService — GetGenreSummariesAsync removed.

Phase 13 — CMS Public Landing (landed 2026-06-17)

Landed: 2026-06-17 on dev.

What: Gave DeepDrftManager (the CMS) a true public face: an unauthenticated splash at / with DeepDrft branding and a single Login CTA; authenticated admins are redirected past it to the catalogue. Previously / was the [Authorize]-gated catalogue dashboard, so an anonymous hit fell straight through to the login form with no front door. Pattern borrowed from the MainHomeLayout / Home.razor idiom (dedicated public layout + HierarchicalRoleAuthorizeView redirect-the-authed-user), branded to the DeepDrft navy/green/off-white identity (DeepDrftPalettes.Cms). Additive — the admin experience is intact; only the catalogue's route moved. Routing decision: Option A — splash owns /, catalogue moves to /catalogue (Options B and C were weighed and rejected). New files: Components/Pages/Home.razor (@page "/", no [Authorize], CmsHomeLayout) wraps its body in <HierarchicalRoleAuthorizeView>: Authorized → <RedirectToCatalogue />; NotAuthorized → hero (img/cms-hero.png) + Login CTA (returnUrl → /catalogue). Components/Layout/CmsHomeLayout.razor — lean public layout (DeepDrftPalettes.Cms theme, "Deep Drft — Admin" AppBar, centered narrow MudContainer, MudPopoverProvider only). Components/RedirectToCatalogue.razor — inline NavigationManager.NavigateTo("/catalogue") redirect, mirroring RedirectToAccessDenied. Changed: Index.razor route @page "/" → @page "/catalogue"; CmsLayout.razor "Back to site" home button Href and tooltip updated to /catalogue / "Catalogue". AppBar wording resolved: "Deep Drft — Admin" in the bar, "Deep Drft" as the hero title.
Why: An anonymous visitor hitting the CMS root landed directly on the AuthBlocks login form with no DeepDrft context, branding, or explanation. The splash provides a proper front door while keeping the admin surface fully intact.
Shape: DeepDrftManager/Components/Pages/Home.razor (new); DeepDrftManager/Components/Layout/CmsHomeLayout.razor (new); DeepDrftManager/Components/RedirectToCatalogue.razor (new); DeepDrftManager/Components/Pages/Index.razor (route changed to /catalogue); DeepDrftManager/Components/Layout/CmsLayout.razor (home-button href + tooltip updated). Hero asset: DeepDrftManager/wwwroot/img/cms-hero.png (Daniel-supplied; page compiles and renders without it). Full spec: product-notes/cms-public-landing.md.

Phase 12 — Waveform Visualizer Generalization + NowPlayingHero Rewire (all tracks landed 2026-06-17)

Landed: 2026-06-17 on dev. Six tracks (12.A, 12.B1, 12.B2, 12.E, 12.C, 12.D) plus a bridge live-track fix, all merged.

What: Took the landed Mix WebGL2 lava visualizer (Phase 10 reframe) and made it the one track-cardinal visualizer — serving Mix detail, all Release Detail pages, and the home-page NowPlaying card — rendering the waveform of whatever track is currently playing/selected. Two deliverables: (1) the generalized engine serving three hosting modes, (2) the NowPlayingHero rewire. Full design, extraction analysis, per-track model, Direction B compute, wave decomposition: product-notes/phase-12-waveform-visualizer-generalization.md.
- 12.A — Rename to the abstraction. MixWaveformVisualizer → WaveformVisualizer, MixVisualizerControls → WaveformVisualizerControls, MixVisualizerControlState → WaveformVisualizerControlState, MixZoomMapping → WaveformZoomMapping, MixVisualizer.ts → WaveformVisualizer.ts. Mechanical rename across the five C#/Razor files + TS module + import path + DI registration. No behavior change; Mix detail identical after.
- 12.B1 — Generalize high-res compute to every track + backfill (Direction B). MixWaveformResolution → WaveformResolution. Vault mix-waveforms → track-waveforms (VaultConstants.TrackWaveforms), keyed per-track by EntryKey. New WaveformProfileService.ComputeAndStoreHighResAsync is the shared compute seam — upload path, CMS generate action, and Mix trigger all funnel through it. UnifiedTrackService.UploadAsync now computes the high-res datum for every new track. CMS generate action generalized to any track; a re-runnable "backfill high-res" batch action added in the CMS TrackList. WaveformStatusDto.HasHighRes added alongside the existing HasProfile. Backfill is Daniel-gated (CMS batch action; fetch 404s gracefully for not-yet-backfilled tracks).
- 12.B2 — Per-track datum fetch + bridge rewire. New track-cardinal endpoint GET api/track/{trackEntryKey}/waveform/high-res (unauthenticated) + public proxy; ITrackDataService.GetTrackWaveform; bridge resolves the current track's EntryKey and re-fetches on track change. Client GetMixWaveform read path retired; API-side release waveform endpoint kept as a caller-less legacy delegate. Mix renders the same high-res lava via the track-cardinal fetch.
- 12.E — Popover-hosted control panel. WaveformVisualizerControls became the panel content; new WaveformVisualizerControlPopover pairs the lava-lamp icon with the panel as overlay content (MudPopover). Panel styled to the NowPlaying Hero look from deepdrft-tokens.css (no hardcoded hex). A PanelChrome flag scopes panel chrome to the popover mount. One popover placed by the lava-lamp icon on every host — full parity across Mix, Cut, Session, and NowPlaying card.
- Bridge live-track fix. The visualizer now follows the live playing track (keys on host TrackId match OR shared host ReleaseEntryKey), not the fixed host TrackId.
- 12.C — Ambient slot on ReleaseDetailScaffold + mount on detail pages (mode B). New optional Ambient slot on ReleaseDetailScaffold (full-bleed layer behind content; absent slot = no regression). Cut mounts the ambient visualizer + the lava-lamp icon → popover. Session mounts the engine directly behind its hero (it doesn't compose the scaffold) + the popover. Mix swapped its inline controls bar for the lava-lamp icon → popover, keeping its own full-bleed mode-A mount.
- 12.D — NowPlayingHero rewire (mode C). NowPlayingCard replaced the 20 synthetic CSS bars with a contained <WaveformVisualizer> driven by the live cascaded player, pointed at the current track. Added a Fill container-sizing mode (CSS-only, defaults off). Placed the lava-lamp icon → popover on the card for full parity. Visualizer runs at-rest on the home page even before playback (deliberate; perf tuning deferred).
Why: The landed Mix visualizer was structurally track-cardinal below the surface (bridge keyed on TrackId; renderer a pure function of a loudness datum + duration) but named Mix* throughout and restricted to Mix-only data. "Generalize" was a rename + per-track high-res compute extension, not a rebuild. Direction B (high-res for all media) was chosen over the cheaper 512-bucket-fallback Direction A to deliver uniform waveform quality. Controls moved from per-page inline knob bars to a single popover-hosted panel to achieve zero-cost placement on any host including the small NowPlaying card.
Shape: DeepDrftPublic.Client/Controls/: WaveformVisualizer.razor (+ .razor.cs, .razor.css) — renamed engine, added [Parameter] bool Fill; WaveformVisualizerControls.razor — renamed, now panel content with PanelChrome flag; WaveformVisualizerControlPopover.razor — new, lava-lamp icon + MudPopover wrapping the panel; WaveformZoomMapping.cs — renamed; ReleaseDetailScaffold.razor (+ .razor.cs) — new optional Ambient RenderFragment slot; NowPlayingCard.razor — synthetic bars replaced, <WaveformVisualizer Fill="true"> + <WaveformVisualizerControlPopover>. DeepDrftPublic.Client/Services/: WaveformVisualizerControlState.cs — renamed. DeepDrftPublic.Client/Pages/: CutDetail.razor — mounts ambient visualizer + popover; SessionDetail.razor — mounts engine + popover directly; MixDetail.razor — swaps inline controls bar for popover. DeepDrftPublic/Interop/visualizer/WaveformVisualizer.ts — renamed TS module. DeepDrftContent/Processors/: WaveformResolution.cs — renamed; WaveformProfileService.cs — ComputeAndStoreHighResAsync added, medium-neutral. DeepDrftContent/Constants/VaultConstants.cs — TrackWaveforms = "track-waveforms". DeepDrftAPI/Controllers/TrackController.cs — GET api/track/{trackEntryKey}/waveform/high-res (unauthenticated) + POST api/track/{trackId}/waveform/high-res (ApiKey, generalized generate); WaveformStatusDto.HasHighRes populated. DeepDrftAPI/Services/UnifiedTrackService.cs — UploadAsync now calls ComputeAndStoreHighResAsync for every new track. DeepDrftPublic/Controllers/TrackProxyController.cs — proxy for the new high-res endpoint.

Phase 10 — Mix Visualizer Reframe: Waves R1–R4 (Lava tuning + eight-knob controls)

Landed: 2026-06-17 on dev.

What: A major reframe of the Mix visualizer's effects, controls, and color model, built on the landed WebGL2 Phase 10 renderer infrastructure. Four waves:
- Wave R1 — removed the static noise/frost texture (Daniel: "makes the screen look dirty"); implemented dynamic footer-height clip so the lava stops cleanly above the player bar; redrawn DDIcons.LavaLamp to the classic 1970s silhouette (wide truncated-cone base, bulbous→roundedly-pointed teardrop glass body, small cone cap — navy fluid + moss blobs, body currentColor).
- Wave R2 — CPU-side per-frame physics step (~16–32 Lagrangian wax blobs: position/velocity/temperature/radius), uploaded as uniforms each frame; smin SDF metaball render producing a flat, coalescing fluid (not blobs with radial hotspots); energy-coupled dynamics (high heat → many small turbulent bubbles; low heat → fewer large calm masses); 2D elastic collision on both blob↔waveform and blob↔blob pairs; collision strength knob sweeping from genuine soft mush to a high-elasticity upward-and-outward throw; waveform collision always on regardless of heat. Loudness profile smoothed with a ~15 ms envelope-follower at preprocessing only (RmsLoudnessAlgorithm.cs); there is no decode-time smoothing (smoothDatum was removed). Existing vault mixes gain the smoothing only after server-side reprocessing — they do not benefit automatically. Ribbon rendered with smootherstep sinusoid reconstruction.
- Wave R3 — replaced HSL mixHsl/vivify color with OKLab interpolation (structural fix for the cyan excursion artifact); three combined gradient motions: (1) A/B anchor rotation among three theme colors at the gradient-rotation-speed rate; (2) per-segment sinusoidal variation keyed to mix-time so colors travel with the segment as it scrolls; (3) per-bar gradient curve shifts with scroll height (mostly A at bottom → mostly B at top). Static noise texture removed. One source of truth (DeepDrftPalettes), no hardcoded hexes.
- Wave R4 — MixVisualizerControlState widened from four properties to eight: ScrollSpeed, GradientRotationSpeed, LavaGravity, LavaHeat, FluidAmount (replaces the former BlobDensity), FluidViscosity (new — cohesion / coalescence control, the second half of the bubbles split), CollisionStrength, WaveformWidth. MixVisualizerControls now renders eight RadialKnobs; the Visible parameter @if-gates the knob band while the container holds a reserved min-height so content below never pops when the lamp toggles. Scroll-speed knob range tuned to 60–110% band; gravity 0–75%; heat +20% at top; width default 50% / range 10–95%. The scaffold's TopRowCenter slot (added in the prior reframe) carries the controls in-flow between the back link and lava-lamp toggle.
Why: Daniel tested the Phase 10 effects end-to-end and rejected the visual result: lava read as "giant disconnected circles," colors drifted to cyan (HSL arc artifact), waveform and lava read as two unrelated layers. The diagnosis was that these were structural failures of the prior model (too few scripted blobs with no physics; HSL hue-arc through cyan), not tuning misses. The reframe replaced the model with CPU-physics wax blobs + OKLab gradients, fixing both root causes.
Shape: DeepDrftContent/Processors/RmsLoudnessAlgorithm.cs — ~15 ms envelope-follower smoothing added at preprocessing (server-side only; no decode-time smoothing). DeepDrftPublic/Interop/visualizer/MixVisualizer.ts — smootherstep sinusoid ribbon reconstruction; wax-blob physics loop; OKLab gradient; footer-clip; noise texture removed. DeepDrftPublic.Client/Services/MixVisualizerControlState.cs — widened to eight properties (FluidAmount + FluidViscosity replace BlobDensity; WaveformWidth range/default updated). DeepDrftPublic.Client/Controls/MixVisualizerControls.razor — eight RadialKnobs, Visible parameter gates knob band via @if while container holds reserved height. DeepDrftShared.Client/Common/DDIcons.cs — LavaLamp glyph redrawn. Full design, acceptance criteria, and phasing: product-notes/phase-10-mix-visualizer-lava-reframe.md.