yonlu
cdf8bff01a
- Rename milestone from 'Features & Extensibility' to 'Multi-Library Support' - Replace old phases 10-14 (TAG/SMRT/GAP/MB/LAYOUT/PLUG) with 20 multi-library requirements (LIB/LSCAN/VIEW/PLAY/DATA) - Move deferred features to Future Requirements - Update research files with multi-library research (Stack, Features, Architecture, Pitfalls) - Architecture: hybrid model (library_id on audio_files only), libraries in DB, sequential scanning, phantom tracks
5.5 KiB
gsd_state_version, milestone, milestone_name, status, last_updated, progress
| gsd_state_version | milestone | milestone_name | status | last_updated | progress | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1.0 | v1.1 | Multi-Library Support | planning | 2026-03-08 |
|
YellowJacket — Project State
Project Reference
See: .planning/PROJECT.md (updated 2026-03-08)
Core value: The music player works reliably and feels solid — every interaction is correct, responsive, and trustworthy. Current focus: v1.1 Multi-Library Support — roadmap planning
Current Position
Phase: 9 — Scan Cancellation & Keyboard Shortcuts (last completed) Plan: 5 of 5 Status: Complete — awaiting multi-library roadmap Progress: Roadmap creation in progress Last activity: 2026-03-08 — Restructured v1.1 milestone for multi-library support
Phase Overview
| Phase | Status |
|---|---|
| 9. Scan Cancellation & Keyboard Shortcuts | Complete (5/5 plans) ✅ |
| 10+ Multi-Library phases | Awaiting roadmap creation |
Performance Metrics
v1.0 baseline: 8 phases, 17 plans, 34 tasks in 6 days (107 commits) v1.1 scope: Phase 9 complete (5 plans), multi-library phases TBD (20 requirements)
| Phase | Plan | Duration | Tasks | Files |
|---|---|---|---|---|
| 09-01 | scan control backend | 16 min | 2 | 5 |
| 09-02 | keyboard shortcuts config & service | 35 min | 2 | 12 |
| 09-04 | keyboard shortcuts settings UI | 5 min | 2 | 2 |
| 09-03 | scan control UI | 2 min | 1 | 3 |
| 09-05 | integration testing & verification | 3 min | 2 | 1 |
Accumulated Context
Key Decisions
Decisions from v1.0 are archived in PROJECT.md Key Decisions table. Key patterns to carry forward:
- Mutex-protected setter pattern (lock → write → release → callbacks)
- SAFETY comment convention for hand-crafted SQL
- AST-based codegen for cross-language constant sync
- Design tokens via
:hostscoped CSS custom properties - queueMicrotask coalescing for store notifications
.renderItem+.keyFunction(notrepeat()children) for lit-virtualizer
v1.1 Roadmap Decisions
| Decision | Rationale |
|---|---|
| Phase 9 = Scan Cancel + Shortcuts | Quick wins, validate context cancellation and config extension patterns |
| v1.1 restructured for multi-library | Tag editing, smart playlists, gapless, MusicBrainz, layout, plugins deferred to future milestones |
| Hybrid model (library_id on audio_files only) | Physical files belong to libraries; logical entities (artists, albums, genres) are global/shared |
| Libraries in DB, not TOML | CRUD through UI shouldn't require TOML manipulation; DB is source of truth |
| SET NULL for playlist_tracks FK | Phantom tracks preserve playlist structure when library removed |
| CASCADE for queue_tracks FK | Queue is ephemeral, not user-curated like playlists |
| Sequential scanning | SQLite single-writer makes parallel scans pointless |
| Backend filtering, not frontend | Don't load 150K tracks when viewing one library |
Warnings (carry forward)
- Player lock ordering (
p.mubeforespeaker.Lock(), goroutine dispatch in beep callback) — carry forward - modernc.org/libc version must match exactly when updating modernc.org/sqlite
@lit-labs/signalsis experimental (v0.2.0) — not blocking but noted- Scan cancellation: skip orphan cleanup on cancelled scans — Phase 9 ✅ (implemented in 09-01)
- Volume mutations (ChangeVolume/MuteToggle) must emit events + persist state — Phase 9 ✅ (fixed in 09-05)
- ALTER TABLE ADD COLUMN requires DEFAULT for NOT NULL — create libraries table first
- Table rebuild must audit ALL CASCADE FKs (playlist_tracks AND queue_tracks)
- FTS5 contentless can't DELETE rows — stale entries accumulate after library removal; consider contentless_delete migration
- Orphan cleanup must not delete shared entities across libraries (reference-counting bottom-up)
- Existing user migration must be seamless (TOML DirectoryPath to DB libraries table)
Research Flags
- Multi-library research complete — see
.planning/research/(STACK.md, FEATURES.md, ARCHITECTURE.md, PITFALLS.md, SUMMARY.md)
Session Continuity
Last Session
Date: 2026-03-08 What happened: Restructured v1.1 milestone from "Features & Extensibility" to "Multi-Library Support". Ran 4 parallel researchers (Stack, Features, Architecture, Pitfalls). Defined 20 multi-library requirements (LIB, LSCAN, VIEW, PLAY, DATA). Deferred TAG/SMRT/GAP/MB/LAYOUT/PLUG to future milestones. Updated PROJECT.md, REQUIREMENTS.md, STATE.md, ROADMAP.md. Where we stopped: Planning documents updated, ready for roadmap creation Next action: Run gsd-roadmapper to create phased multi-library roadmap (phases 10+)
State initialized: 2026-02-27
Quick Tasks Completed
| # | Description | Date | Commit | Directory |
|---|---|---|---|---|
| 16 | add ctrl+a hotkey to multi-select views to select all items | 2026-03-07 | 043c74c |
16-add-ctrl-a-hotkey-to-multi-select-views- |
| 17 | refactor playlist view to use subpages | 2026-03-08 | 955cd68 |
17-refactor-playlist-view-to-use-subpages-l |
| 18 | add multi-column metadata display to playlist-details | 2026-03-08 | ce23177 |
18-add-multi-column-metadata-display-to-pla |
Last activity: 2026-03-08 - Completed quick task 18: add multi-column metadata display to playlist-details Last updated: 2026-03-08 — v1.1 restructured for multi-library support