Add Sonos integration spec and document Hum API surface#2

Draft

betmoar wants to merge 18 commits into

mainfrom

Commits on Jun 10, 2026

Update README to current API surface; add audited Sonos integration spec
claude
committed
Fix four spec issues found in review: fMP4 container ordering, _looks_live inversion, cache eviction formula, Subsonic auth specifics
Copilot
authored
Fix internal inconsistencies left by the review-fix commit
claude
committed
Scaffold hum-subsonic-shim: Phase 1 Subsonic endpoints
claude
committed
Shim startup UX: API_BEARER_TOKEN fallback + concise missing-settings error
claude
committed
Fix startup footguns: repo-root .env anchoring + hum stray-arg guard
betmoar
committed
Phase 2 browsing: synthetic hierarchy + playlist drill-in (Search + Playlists)
betmoar
committed
Phase 5: favourites (star/unstar/getStarred2) + scrobble
betmoar
committed
Phase 5: cover-art sizing + richer error envelopes
betmoar
committed
Phase 5: harden ffmpeg pipe lifecycle
betmoar
committed
Phase 5: seekable remux via cached temp file + Range (spec §4 mode b)
betmoar
committed
Phase 5: opt-in live integration harness + fix unhandled Hum-transport errors
betmoar
committed
Spec: mark Phases 0-2 + code-able Phase 5 done; resolve hierarchy decision
betmoar
committed
Serve 200 at / so Amperfy Auto-Detect probe doesn't 404
betmoar
committed
Fix Amperfy login: emit XML when client doesn't request f=json
betmoar
committed
Phase 2: populate Sonos Playlist shelf from pinned + starred playlists
betmoar
committed
Phase 2/5: Internet Radio shelf from Hum /api/radio (Sonos via bonob)
betmoar
committed
Add Sonos shim validation runbook (pick-up guide)
betmoar
committed