Write the decision-complete spec #15

Activity

1. ranokay

   added

   wayfinder:taskWayfinder task ticketWayfinder task ticket

   on Sep 1, 2026
2. ranokay

   added a parent issue on Sep 1, 2026

   • Wayfinder map: Apple Music as a second provider in Waves #1
3. ranokay

   marked this as blocked by 10 issues on Sep 1, 2026

   • Choose the Apple engine approach #8
   • Design the Provider abstraction seam #9
   • Lyrics & album-art policy matrix #10
   • Config-first settings architecture for two providers #11
   • Stereo + Atmos dual-download behavior #12
   • Per-download chooser & provider-sectioned search UI #13
   • Apple Music account + one-time decryption setup (human) #14
   • ALAC verification & quarantine: user-facing UX and policy #16
   • Apple session supervision: wrapper lifecycle & Apple-side failure recovery #17
   • Recognizing Apple files & provider-aware IN LIBRARY / DOWNLOADED badges #18
4. ranokay

   self-assigned this

   on Sep 1, 2026
5. ranokay commented on Sep 1, 2026

   

   ranokay

   on Sep 1, 2026

   OwnerAuthor

   More actions

   Resolution

   The decision-complete spec is written: docs/apple-music-provider-spec.md on branch spec/apple-music-provider (branched on the stacked research branches, so every cited research doc rides along).

   It synthesizes all sixteen resolved tickets into the destination artifact: the chosen Engine (gamdl embedded + wrapper-v2 for ALAC, N_m3u8DL-RE mode, WorldObs-v3 fallback) and its two-tier setup; the Provider seam (fused interface, row-dict contract, namespaced ids, Waves quality enum, composition, Atmos fence); dual-download semantics; the always-on integrity gate with quarantine; session supervision; the Variant-A search/Chooser UX; the lyrics/art matrix; the two-axis settings architecture with its one migration; and the packaging constraints.

   Fog resolved into the spec (the map's Not-yet-specified is now empty):

   • Packaging & distribution (§10): nothing Apple-engine inside Waves' signed package — everything provisioned at setup, FFmpeg-manager style; the APK is user-supplied, never redistributed or fetched by Waves (Apple proprietary; the SHA-verify + scripted-extraction path was proven in the setup run); engine bumps ride the updater.
   • Apple previews in v1 (§7.4): confirmed with the human — the documented 30-second preview URL through the existing shared preview player; full-track preview stays TIDAL-only (PREVIEW capability).
   • Handoff (§13): implementation ticketing is the next effort and consumes this spec as its complete input; a non-binding sequencing of eight slices is included.

   Spec-level syntheses, flagged for review (each grounded in recorded evidence, listed in the spec's appendix): Apple search gates on enabled while sign-in gates downloading (reconciles the prototype phrasing with the engine decision's search-before-setup intent); initial values for the tunables (pacing 30 s / 25 songs, 2 integrity retries, 5-min idle sidecar stop).

   The map is complete: this was its last open ticket and its fog is clear.
6. ranokay

   closed this as completedon Sep 1, 2026