From 909958c03a6bcab81b4abe92e3c27f666a0951c2 Mon Sep 17 00:00:00 2001 From: Caleb Allen Date: Mon, 16 Mar 2026 16:15:49 -0400 Subject: [PATCH] docs: start milestone v1.2 Tag Editing --- .planning/PROJECT.md | 23 +++++++++++++++++++---- .planning/STATE.md | 16 ++++++++-------- 2 files changed, 27 insertions(+), 12 deletions(-) diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 0681bb7..8f8531c 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -51,7 +51,12 @@ The music player works reliably and feels solid. Every interaction is correct, r ### Active -(No active requirements — next milestone not yet defined) +- [ ] Single track metadata editing (title, artist, album, genre, year, track number, disc number, composer) +- [ ] Batch editing shared fields across multiple selected tracks +- [ ] Cover art set/replace from image file +- [ ] Write-to-temp-then-rename for file safety during tag writes +- [ ] Inline DB + FTS5 update after tag writes (no rescan needed) +- [ ] Tag writing for MP3 (ID3v2), FLAC (Vorbis Comments), OGG (Vorbis Comments) ### Deferred (Future Milestones) @@ -79,9 +84,19 @@ The music player works reliably and feels solid. Every interaction is correct, r - **v1.0 Consolidation** (2026-03-05) — Foundation: races fixed, tests added, SQL consolidated, performance optimized - **v1.1 Multi-Library Support** (2026-03-16) — Multi-library: CRUD, per-library scanning, filtered views, cross-library playlists, phantom tracks -## Next Milestone +## Current Milestone: v1.2 Tag Editing -Not yet defined. Run `/gsd-new-milestone` to plan the next milestone. +**Goal:** Enable users to edit track metadata and cover art directly within YellowJacket, with safe file writes and instant database synchronization. + +**Target features:** +- Single track tag editing (title, artist, album, genre, year, track/disc number, composer) +- Batch tag editing across multiple selected tracks +- Cover art set/replace from image file (embedded in audio file) +- Write-to-temp-then-rename for corruption-safe file writes +- Inline DB + FTS5 index update (no rescan needed after edits) +- Format support: MP3 (ID3v2), FLAC (Vorbis Comments), OGG (Vorbis Comments) + +**"Done" criteria:** Users can select tracks, edit metadata fields, set cover art, save changes to the actual audio files, and see updates reflected immediately in all views and search — without requiring a library rescan. ## Context @@ -137,4 +152,4 @@ Not yet defined. Run `/gsd-new-milestone` to plan the next milestone. | Event delegation on virtualizer | Zero per-item closures; data-index + closest() pattern | ✓ Good — eliminated GC pressure on large lists | --- -*Last updated: 2026-03-16 after v1.1 Multi-Library Support milestone* +*Last updated: 2026-03-16 after v1.2 Tag Editing milestone started* diff --git a/.planning/STATE.md b/.planning/STATE.md index 01e917a..6d8c36d 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -1,8 +1,8 @@ --- gsd_state_version: 1.0 -milestone: v1.1 -milestone_name: Multi-Library Support -status: milestone_complete +milestone: v1.2 +milestone_name: Tag Editing +status: defining_requirements last_updated: "2026-03-16T20:03:38.282Z" progress: total_phases: 6 @@ -18,14 +18,14 @@ progress: See: .planning/PROJECT.md (updated 2026-03-16) **Core value:** The music player works reliably and feels solid — every interaction is correct, responsive, and trustworthy. -**Current focus:** Planning next milestone +**Current focus:** v1.2 Tag Editing ## Current Position -Milestone: v1.1 Multi-Library Support — COMPLETE (shipped 2026-03-16) -All phases: 6/6 complete, 18/18 plans executed, 31/31 requirements fulfilled -Next: Run `/gsd-new-milestone` to plan next milestone -Last activity: 2026-03-16 — Completed v1.1 milestone archival +Phase: Not started (defining requirements) +Plan: — +Status: Defining requirements for v1.2 Tag Editing +Last activity: 2026-03-16 — Milestone v1.2 started ### Phase Overview