docs(roadmap): align 2026 roadmap with shipped work and next priorities

- replace legacy roadmap with status-driven 2026 plan\n- reflect completed refactor, performance, UI, and release automation work\n- add trend adoption matrix and quarterly delivery phases\n- include Wear quality compliance, risks, mitigations, and DoD

Author: celestialtaha

roadmap.md

@@ -1,174 +1,158 @@
-# WearMusic Roadmap
-## 🎵 Core Music Features
-### High Priority
-- Playlist Management
-  
-  - Create, edit, and delete custom playlists
-  - Add/remove tracks from playlists
-  - Recently played and favorites playlists
-  - Quick playlist access from main screen
-- Enhanced Audio Controls
-  
-  - Shuffle mode implementation  (Done)
-  - Repeat modes (off, one, all) (Done)
-  - 15/30 second skip forward/backward
-  - Volume control with haptic feedback (Done - no haptic feedback on - no UI)
-  - Audio equalizer with presets
-- Smart Queue Management
-  
-  - "Play Next" and "Add to Queue" options
-  - Queue reordering via drag & drop
-  - Clear queue functionality
-  - Queue persistence across app restarts
-### Medium Priority
-- Advanced Search & Filtering
-  
-  - Search by title, artist, album, genre
-  - Filter by duration, year, file format
-  - Voice search integration
-- Music Discovery
-  
-  - "Similar tracks" recommendations
-  - Genre-based browsing
-  - Recently added tracks section
-  - Most played tracks analytics
-## ⚡ Performance Optimizations
-### Battery Life
-- Power Management
-  
-  - Implement doze mode compatibility
-  - Reduce background processing when inactive
-  - Optimize wake lock usage
-  - Battery usage analytics and reporting
-- Audio Processing Optimization
-  
-  - Implement audio focus management
-  - Reduce CPU usage during playback
-  - Optimize MediaSession callbacks
-  - Implement audio offloading when available
-### Memory & Storage
-- Efficient Data Loading (Done)
-  
-  - Implement pagination for large music libraries  (Done)
-  - Lazy loading of album artwork (Done)
-  - Cache management for metadata (Done)
-  - Background library scanning optimization (Done)
-- Resource Management
-  
-  - Optimize image loading and caching 
-  - Reduce APK size through resource optimization 
-  - Implement proper lifecycle management (Done)
-  - Memory leak detection and fixes (Done)
-## 🎨 User Experience Enhancements
-### Interface Improvements
-- Enhanced Player Screen
-  
-  - Larger, more responsive playback controls (Done)
-  - Progress bar with time indicators
-  - Animated album art transitions
-- Accessibility Features
-  
-  - Voice commands for playback control
-  - Text size adjustment options
-
-- Customization Options
-  
-  - Theme selection (dark/light/auto)
-  - Custom accent colors
-  - Layout density options
-  - Control button customization
-### Navigation & Gestures
-- Gesture Controls
-  - Crown rotation for volume/seeking (Done)
-  - Bezel rotation support (if available)
-  - Double-tap to play/pause
-  - Long-press context menus
-## 🔧 Technical Improvements
-### Architecture & Code Quality
-- Code Optimization
-  
-  - Migrate to Kotlin coroutines best practices
-  - Implement proper error handling
-  - Add comprehensive logging
-  - Unit and integration test coverage
-- Data Management
-  
-  - Implement Room database for metadata
-  - Add data backup/restore functionality
-  - Optimize MediaStore queries
-  - Implement proper data validation
-### Integration Features
-- Watch Face Integration
-  
-  - Enhanced complication with playback controls
-  - Multiple complication types support
-  - Real-time playback status updates
-  - Custom complication icons
-- Tile Enhancements
-  
-  - Quick playback controls in tile
-  - Recently played tracks access
-  - Playlist shortcuts
-  - Dynamic tile content updates
-## 🐛 Bug Fixes & Stability
-### Critical Issues
-- Playback Stability
-  
-  - Fix potential MediaController connection issues
-  - Handle audio focus conflicts properly
-  - Resolve notification persistence problems
-  - Fix track transition glitches
-- UI/UX Fixes
-  
-  - Fix swipe-to-dismiss navigation issues
-  - Resolve screen rotation problems
-  - Fix album art loading failures
-  - Improve touch target sizes for watch interaction
-### Performance Issues
-- Memory Management
-  - Fix potential memory leaks in ViewModels
-  - Optimize bitmap loading and disposal
-  - Resolve background service memory usage
-  - Fix cursor management in repository
-## 📱 Advanced Features
-### Smart Features
-- Contextual Playback
-  
-  - Auto-pause during calls
-  - Sleep timer functionality
-  - Workout mode with enhanced controls
-
-- Analytics & Insights
-  
-  - Listening habits tracking
-  - Most played artists/albums
-  - Playback statistics
-  - Export listening data
-### Connectivity
-- Companion App Integration
-  - Sync playlists with phone app
-  - Remote control from phone
-  - Music transfer optimization
-  - Settings synchronization
-## 🎯 Implementation Priority
-### Phase 1 (Immediate - 1-2 weeks)
-1. Fix critical playback stability issues
-2. Implement basic playlist management
-3. Add shuffle and repeat modes
-4. Optimize battery usage
-### Phase 2 (Short-term - 1 month)
-1. Enhanced player controls and UI
-2. Search and filtering capabilities
-3. Gesture control implementation
-4. Memory optimization
-### Phase 3 (Medium-term - 2-3 months)
-1. Advanced features (sleep timer, equalizer)
-2. Comprehensive testing and bug fixes
-3. Accessibility improvements
-4. Analytics implementation
-### Phase 4 (Long-term - 3+ months)
-1. Companion app development
-2. Advanced AI features
-3. Performance monitoring
-4. User feedback integration
-This roadmap prioritizes watch-specific optimizations, battery efficiency, and user experience improvements while maintaining the offline-first approach that's essential for a WearOS music player.
+# Weavelet Roadmap 2026
+
+Last updated: March 2026  
+Product: Offline-first Wear OS music player (standalone watch experience)
+
+Status legend:
+- `DONE` Completed and shipped
+- `ACTIVE` In progress / hardening
+- `NEXT` Planned for the next cycle
+- `LATER` Backlog
+
+---
+
+## 1) Product Goals (2026)
+
+### User goals
+- Start playback from watch in under 3 taps.
+- Keep playback stable during long sessions.
+- Make core controls usable on small round screens without clipping.
+
+### Engineering goals
+- Keep release pipeline deterministic and tag-driven.
+- Improve reliability and performance before adding heavy new features.
+- Grow test coverage for playback, library paging, and state transitions.
+
+### Success metrics
+- Crash-free sessions (player screens) > 99.5%.
+- Release lead time (tag to assets available) < 15 minutes.
+- Median time-to-first-play after app open < 3 seconds (warm library).
+
+---
+
+## 2) Current Delivery Snapshot
+
+## 2.1 Core playback & library
+- `DONE` Play/pause/next/previous controls
+- `DONE` Shuffle and repeat (off/all/one)
+- `DONE` Crown-based volume control with in-app HUD
+- `DONE` Library scan + pagination + lazy album art loading + metadata caching
+- `DONE` Sorting via settings
+- `ACTIVE` Search (title/artist/album implemented; advanced filters pending)
+- `LATER` Queue management and playlists
+
+## 2.2 Wear UI/UX
+- `DONE` Material 3 migration for Wear UI
+- `DONE` Adaptive round-screen player redesign
+- `DONE` Full-screen art backdrop + edge progress
+- `DONE` Home spacing improvements
+- `DONE` About page redesign + runtime version display
+- `NEXT` Dedicated seek mode (rotary seek vs volume mode)
+
+## 2.3 Stability/performance/refactor
+- `DONE` MediaController lifecycle hardening
+- `DONE` Playback state sync and progress tracking improvements
+- `DONE` Recomposition and media decoding optimization pass
+- `DONE` Modularized app structure (`core:data`, `core:player`, `core:ui`)
+- `DONE` Gradle 9 / AGP 9 migration compatibility
+- `ACTIVE` Additional battery-focused profiling and tuning
+
+## 2.4 OSS/release engineering
+- `DONE` Apache-2.0 licensing
+- `DONE` CI workflow on push/PR
+- `DONE` Tag-based APK release workflow + checksums
+- `DONE` Optional signing path via repo secrets
+- `ACTIVE` Workflow hardening for changing GitHub Actions runtime baseline
+- `NEXT` Add issue/PR templates + `CONTRIBUTING.md`
+
+## 2.5 Play Store and Wear quality compliance
+- `ACTIVE` Keep target SDK policy aligned with current Wear Play requirements
+- `NEXT` Add explicit QA checklist pass for Wear app quality requirements (touch targets, font scaling, edge clipping, swipe-to-dismiss)
+- `NEXT` Add release checklist for Play listing assets (Wear screenshots, feature mentions, tile/complication mentions when applicable)
+- `LATER` Automate quality gate checks where possible (lint + screenshot sanity + manifest checks)
+
+---
+
+## 3) 2026 Trend Adoption Matrix (Wear OS + design)
+
+| Trend / Direction | Why it matters | Weavelet action | Status |
+|---|---|---|---|
+| Round-first, glanceable Wear UI patterns | Better readability and faster wrist interactions | Keep compact controls, edge-aware indicators, high-contrast overlays | `DONE` + `ACTIVE` |
+| Compose for Wear + Material 3 component consistency | Faster iteration + platform-consistent UX | Continue replacing custom primitives where platform components fit | `ACTIVE` |
+| Richer motion and depth (including glass-like surfaces) | Modern look, clearer focus hierarchy | Add an **experimental** “glass” visual mode for non-critical overlays only, gated by contrast checks | `NEXT` |
+| Release automation for open-source apps | Better trust and easier installs for users | Keep tag-driven releases with APK assets + checksums | `DONE` |
+| Reliability-first media apps (Media3 lifecycle rigor) | Prevent playback dropouts and state drift | Expand regression tests around controller/session lifecycle | `NEXT` |
+| Voice/assistant-driven quick actions on wearables | Faster no-touch interactions | Evaluate App Actions for “play artist/album” entry points | `LATER` |
+
+Notes:
+- “Glass” styling should remain optional and accessibility-safe (contrast, blur cost, and battery impact validated on device).
+
+---
+
+## 4) Feature Roadmap (Prioritized)
+
+## P0: Reliability and release confidence
+1. `ACTIVE` Finalize release workflow hardening (including signing edge cases).
+2. `NEXT` Add smoke tests for playback lifecycle and library loading.
+3. `NEXT` Add failure telemetry hooks/logging for release troubleshooting.
+4. `NEXT` Add formal release checklist for Wear app quality + Play listing compliance.
+
+## P1: Core playback upgrades
+1. `NEXT` Add 15/30s seek controls.
+2. `NEXT` Add sleep timer.
+3. `LATER` Add equalizer/preset support (device capability dependent).
+
+## P1: Library and queue
+1. `NEXT` Improve search (tokenization + better matching).
+2. `NEXT` Add queue screen with clear/reorder basics.
+3. `LATER` Playlist MVP (create/rename/delete + add/remove track).
+
+## P2: Wear-native enhancements
+1. `NEXT` Rotary mode switch (volume vs seek) with clear UI affordance.
+2. `LATER` Expand tile actions (resume, quick controls, recent tracks).
+3. `LATER` More complication variants and richer state text.
+
+## P2: Visual polish track
+1. `NEXT` Build optional “glass-lite” UI experiment for selected surfaces.
+2. `NEXT` Validate contrast, battery, and readability on small/large round watches.
+3. `LATER` Theme tokens for deeper user customization.
+
+---
+
+## 5) Delivery Plan (2026)
+
+### Q2 2026
+- Release pipeline stability + signing reliability.
+- Seek shortcuts and sleep timer.
+- Search quality improvements.
+
+### Q3 2026
+- Queue management MVP.
+- Playback regression tests + CI quality gates.
+- Tile/complication incremental upgrades.
+
+### Q4 2026
+- Playlist MVP.
+- Optional glass-style visual mode (if accessibility/perf targets pass).
+- Broader accessibility and customization pass.
+
+---
+
+## 6) Risks and Mitigations
+
+| Risk | Impact | Mitigation |
+|---|---|---|
+| GitHub Actions runtime/tooling changes | Release failures | Keep workflows pinned, monitor deprecations, test tag flow monthly |
+| Wear device variability (rotary deltas, screen sizes) | UI/interaction inconsistency | Keep adaptive thresholds/layouts and test on multiple watch profiles |
+| Visual trend overreach (glass effects) | Readability/battery regressions | Gate behind accessibility/perf criteria and keep optional |
+| Feature creep (playlists + queue + advanced audio together) | Delayed releases | Keep strict P0/P1/P2 sequencing and small deliverables |
+
+---
+
+## 7) Definition of Done (for roadmap items)
+
+An item is considered `DONE` only when:
+1. Implemented in app code.
+2. Verified on-device (or emulator where appropriate).
+3. Build passes in CI.
+4. User-facing behavior is documented/releasable.