yonlu
2256f8f329
Archive v1.2 milestone: ROADMAP + REQUIREMENTS + phases to milestones/. Evolve PROJECT.md with v1.2 validated requirements and key decisions. Update RETROSPECTIVE.md with v1.2 lessons and cross-milestone trends. Clean STATE.md for next milestone.
70 lines
5.0 KiB
Markdown
70 lines
5.0 KiB
Markdown
# Milestones
|
|
|
|
## v1.0 Consolidation (Shipped: 2026-03-05)
|
|
|
|
**Phases completed:** 8 phases, 17 plans, 34 tasks
|
|
**Timeline:** 6 days (2026-02-27 → 2026-03-05)
|
|
**Stats:** 107 commits, 67 source files changed, +5,654/-465 lines, 84 tests added
|
|
|
|
**Delivered:** Strengthened the existing foundation — correctness, performance, code quality, UX polish, and test coverage — transforming YellowJacket from a working-but-fragile music player into a solid, trustworthy platform for future features.
|
|
|
|
**Key accomplishments:**
|
|
- Eliminated all concurrency races — 4 SetContext methods mutex-protected, app runs clean under `-race` detector
|
|
- Closed all error handling gaps — moved startupErr to struct, fixed config permissions, logged MPRIS errors, separated scan warnings from fatals
|
|
- Built comprehensive test suite — 84 new unit tests (queue, config, player, FTS5 search, library scan, entity cache) with shared in-memory test DB infrastructure
|
|
- Consolidated SQL and enforced code quality — `track_metadata` VIEW eliminating 60 lines of duplicated JOINs, `sqlc.slice()` migration, SAFETY comments on all 12 hand-crafted SQL statements, AST-based Go→TS event codegen
|
|
- Optimized backend performance — incremental queue persistence (O(1) add/remove), SetQueue Phase 2 dedup, deferred library loading for instant app shell
|
|
- Polished frontend performance and UX — queueMicrotask notification coalescing, design token system, classMap directives, visual consistency audit across all 15 components
|
|
|
|
**Archive:** [v1.0-ROADMAP.md](milestones/v1.0-ROADMAP.md) | [v1.0-REQUIREMENTS.md](milestones/v1.0-REQUIREMENTS.md)
|
|
|
|
---
|
|
|
|
|
|
## v1.1 Multi-Library Support (Shipped: 2026-03-16)
|
|
|
|
**Phases completed:** 6 phases, 18 plans
|
|
**Timeline:** 10 days (2026-03-06 → 2026-03-16)
|
|
**Stats:** ~85 commits, ~57,700 LOC (27.7K Go + 28.8K TS + 1.2K SQL), 31 requirements fulfilled
|
|
|
|
**Delivered:** Transformed YellowJacket from a single-directory player into a multi-library music manager — users can add, rename, and remove library directories through the UI, scan them independently, filter all views to a specific library, and playlists gracefully survive library removal with phantom track preservation and auto-resolution.
|
|
|
|
**Key accomplishments:**
|
|
- Cancellable/pausable library scans with per-scan context cancellation and sequential queue coordination
|
|
- Configurable keyboard shortcuts with record-style capture UI, scope-aware dispatch, and conflict detection
|
|
- Multi-library database schema (migration 6) with seamless single-directory migration preserving all user data
|
|
- Per-library scan pipeline with scan queue, progress UI per library, and cancel scope (single vs all)
|
|
- Full library CRUD API with 17-step atomic removal (orphan cleanup, phantom metadata, FTS5, cover art, queue compaction)
|
|
- Library filter dropdown in top bar — all views (tracks, albums, artists, genres, search) respect the active filter
|
|
- Cross-library playlists with phantom track auto-resolution via ScanHooks + M3U8 path matching
|
|
- Performance optimization: CSS containment, view caching, event delegation, content-visibility, scroll polish
|
|
|
|
**Archive:** [v1.1-ROADMAP.md](milestones/v1.1-ROADMAP.md) | [v1.1-REQUIREMENTS.md](milestones/v1.1-REQUIREMENTS.md)
|
|
|
|
---
|
|
|
|
|
|
## v1.2 Tag Editing (Shipped: 2026-03-18)
|
|
|
|
**Phases completed:** 4 phases, 9 plans, 17 tasks
|
|
**Timeline:** 3 days (2026-03-16 → 2026-03-18)
|
|
**Stats:** ~40 commits, ~61,600 LOC (31.2K Go + 30.4K TS), 19/20 requirements fulfilled
|
|
|
|
**Delivered:** Added full metadata tag editing to YellowJacket — users can edit any track's metadata and cover art from within the app (single or batch), with crash-safe file writes, instant database synchronization, and live progress feedback for batch operations. Supports MP3 (ID3v2) and FLAC (Vorbis Comments); OGG deferred as stretch goal.
|
|
|
|
**Key accomplishments:**
|
|
- FTS5 contentless_delete migration enabling row-level DELETE/UPDATE for tag edit sync without search index corruption
|
|
- General-purpose AtomicWrite utility (write-to-temp-then-rename) preventing audio file corruption during tag writes
|
|
- Format-specific tag writers for MP3 (ID3v2 via n10v/id3v2) and FLAC (Vorbis Comments + PICTURE blocks via go-flac) with 7 round-trip tests
|
|
- WriteTrackTags pipeline: format detection → file write → transactional DB sync (entity upsert-and-relink + FTS5 + orphan cleanup) → event emission, with player safety and scan/write mutual exclusion
|
|
- Single-track editor dialog with all 8 editable fields, cover art pick/replace/remove, diff-only saves, and automatic view refresh
|
|
- Batch editing: three-state field model (keep/set/clear), merged value display, confirmation guard, live progress bar with cancellation, partial failure reporting, batch cover art — accessible from all 4 view context menus
|
|
|
|
**Known Gaps:**
|
|
- WRITE-03: OGG Vorbis tag writing deferred (stretch goal — custom OGG page rewriter assessed as medium-high risk, MP3+FLAC covers vast majority of libraries)
|
|
|
|
**Archive:** [v1.2-ROADMAP.md](milestones/v1.2-ROADMAP.md) | [v1.2-REQUIREMENTS.md](milestones/v1.2-REQUIREMENTS.md)
|
|
|
|
---
|
|
|