diff --git a/architecture.md b/architecture.md index 6117c03..64b39d9 100644 --- a/architecture.md +++ b/architecture.md @@ -158,6 +158,22 @@ remain controllable. Extend MIDI learn, capability/state reporting and TUI editing through the server owner; use confirmed playback state for feedback. Resolve multiple matches explicitly rather than choosing an arbitrary player. This controls players such as QBZ directly, without synthetic keyboard input. +The approved Media tab lists configured player/control sets with stable IDs, +labels, explicit exact/regex selectors and observed state. Discovery supplies a +picker without a builtin player catalogue; manual selectors remain available. +Multiple matches are ambiguous and block commands. The server advertises session +bus availability to the client: no running players is an empty list, not a reason +to hide the tab; a later disconnect retains the tab with an unavailable status. +The scope includes Stop/Next/Previous, relative and absolute seeking, shuffle, +repeat and playlist discovery/activation, gated by player capabilities. Playlist +content editing is not included. Learn/unbind, validated editing and persisted +configuration follow the mixer conventions. +Feedback uses confirmed state, with exclusive Play/Pause/Stop indicators and +explicit device-specific colour mappings; default note output is same-note 127/0. +Global and per-fader/per-media-entry switches gate MIDI output. Global off sends +no messages (even clearing messages), so existing lights may remain lit until +feedback is re-enabled and resynchronized. These additions remain planned until +their individual M13 acceptance criteria pass. The protocol boundary follows the [MPRIS Player interface](https://specifications.freedesktop.org/mpris/latest/Player_Interface.html). diff --git a/task.md b/task.md index 0bd01ef..07f580a 100644 --- a/task.md +++ b/task.md @@ -602,6 +602,31 @@ YouTube capture use case; no browser-name condition is needed. saved configuration, TUI controls and confirmed playback-state feedback with a fake D-Bus adapter before opt-in player integration checks. +Approved implementation slices for M13.3 (each independently tested/committed): +- [ ] **M13.3a Feedback switches:** persisted global MIDI-feedback gate and + per-fader/per-media-entry gates; global off overrides local settings and sends + no output, including clearing messages; re-enable resynchronizes observed state. +- [ ] **M13.3b MPRIS adapter:** session-bus discovery independent of audio streams, + bounded calls, capability reporting, owner-change handling and reconnects. + Verify dependency license, native prerequisites and Rust 1.88 compatibility. +- [ ] **M13.3c Media entries:** stable IDs, labels, exact/regex selectors on bus + name, desktop entry or identity; live picker plus manual entry; reject ambiguous + targets rather than selecting arbitrarily. Persist MIDI action bindings. +- [ ] **M13.3d Media tab:** server-advertised availability, A/E/D editing, + validated Save and exit, MIDI Learn with U to unbind; retain offline entries. + Support Play, Pause, Stop, PlayPause, Next and Previous with capability checks. +- [ ] **M13.3e Playback feedback:** confirmed Playing/Paused/Stopped exclusively + lights the corresponding transport buttons; default same-note 127/0, explicit + device-specific colour values; clear unavailable targets only when enabled. + Deduplicate and resync after reconnect; failed commands never imply success. +- [ ] **M13.3f Extended controls:** relative seeking with configurable steps and + absolute position where supported; shuffle toggle/set; repeat Off/Track/Playlist + set/cycle; discover/select/activate playlists with MIDI bindings and confirmed + feedback where reported. Playlist-content editing is outside this scope. +- [ ] **M13.3g Qualification:** document schema/UI, save/reload/restart tests, + fake-bus failures and capability changes, workspace gates, opt-in QBZ/controller + integration checks. No keyboard simulation or playerctl dependency. + ## User requirement coverage | # | Requirement | Work items |