Files

T

yonlu b776f3acb9 docs(17-01): complete backend bridge & frontend plumbing plan

- Created 17-01-SUMMARY.md
- Updated STATE.md with position, decisions, metrics
- Updated ROADMAP.md with plan progress
- Marked EDIT-01 and EDIT-04 complete in REQUIREMENTS.md

2026-03-17 21:07:19 -04:00

4.7 KiB

Raw Blame History

phase, plan, subsystem, tags, requires, provides, affects, tech-stack, key-files, key-decisions, patterns-established, requirements-completed, duration, completed

phase

plan

subsystem

tags

requires

provides

affects

tech-stack

key-files

key-decisions

patterns-established

requirements-completed

duration

completed

17-single-track-edit

api

tagwriter

wails-bindings

file-picker

context-menu

library-store

events

phase	provides
16-tag-writing-database-sync	WriteTrackTags pipeline, TagChanges type, TrackMetadataChanged event

WriteTrackTagsByPath method (filePath → trackID resolution)

ImageFilePicker native file dialog for cover art selection

TrackMetadataChanged event handler in LibraryStore

Track Details context menu accessible from any right-clicked track

17-single-track-edit

added

patterns

Path-based wrapper pattern — frontend identifies tracks by FilePath, backend resolves to ID internally

Full cache invalidation on low-frequency edit events

created

modified

frontend/wailsjs/go/tagwriter/TagWriter.js

frontend/wailsjs/go/tagwriter/TagWriter.d.ts

backend/tagwriter/pipeline.go

backend/frontendutil/frontendutil.go

frontend/wailsjs/go/frontendutil/FrontendUtil.js

frontend/wailsjs/go/frontendutil/FrontendUtil.d.ts

frontend/src/store/library-store.ts

frontend/src/components/track-list/track-list.ts

frontend/src/components/queue-panel/queue-panel.ts

frontend/src/components/cover-grid/cover-grid.ts

frontend/src/components/playlist-details/playlist-details.ts

Manually added Wails bindings since wails generate runs at dev/build time, not via go generate

Track Details opens for first selected track when multiple are selected

Path-based wrapper: WriteTrackTagsByPath resolves filePath to trackID, then delegates to WriteTrackTags

EDIT-01

EDIT-04

11min

2026-03-18

Phase 17 Plan 01: Backend Bridge & Frontend Plumbing Summary

WriteTrackTagsByPath path→ID resolver, ImageFilePicker for cover art, TrackMetadataChanged store handler, and unrestricted Track Details context menu

Performance

Duration: 11 min
Started: 2026-03-18T00:53:49Z
Completed: 2026-03-18T01:05:17Z
Tasks: 2
Files modified: 11

Accomplishments

WriteTrackTagsByPath method resolves frontend FilePath to backend trackID via GetAudioFileByPath, then delegates to WriteTrackTags pipeline
ImageFilePicker opens native OS file dialog filtered to JPEG/PNG for cover art selection
LibraryStore now listens for TrackMetadataChanged event and invalidates all caches + re-fetches data
"Track Details" context menu item appears for any right-clicked track regardless of selection state across all 4 views

Task Commits

Each task was committed atomically:

Task 1: Add WriteTrackTagsByPath and ImageFilePicker backend methods - 4235b4a (feat)
Task 2: Add TrackMetadataChanged handler and fix context menu conditions - fc5cf70 (feat)

Files Created/Modified

backend/tagwriter/pipeline.go - Added WriteTrackTagsByPath method
backend/frontendutil/frontendutil.go - Added ImageFilePicker method
frontend/wailsjs/go/tagwriter/TagWriter.js - Wails binding for WriteTrackTagsByPath
frontend/wailsjs/go/tagwriter/TagWriter.d.ts - TypeScript declaration for WriteTrackTagsByPath
frontend/wailsjs/go/frontendutil/FrontendUtil.js - Wails binding for ImageFilePicker
frontend/wailsjs/go/frontendutil/FrontendUtil.d.ts - TypeScript declaration for ImageFilePicker
frontend/src/store/library-store.ts - Added TrackMetadataChanged event listener
frontend/src/components/track-list/track-list.ts - Removed selection gate on Track Details
frontend/src/components/queue-panel/queue-panel.ts - Removed selection gate on Track Details
frontend/src/components/cover-grid/cover-grid.ts - Changed condition to check only track context (not selection size)
frontend/src/components/playlist-details/playlist-details.ts - Removed selection gate on Track Details

Decisions Made

Manually created Wails TypeScript bindings rather than running wails generate (which requires full dev server startup). The binding pattern matches existing generated files exactly.
Track Details action uses filePaths[0] / indices[0] when multiple tracks are selected, opening details for the first selected (or right-clicked) track.

Deviations from Plan

None - plan executed exactly as written.

Issues Encountered

None

User Setup Required

None - no external service configuration required.

Next Phase Readiness

Backend methods ready for Plan 02 to wire the track-details dialog edit mode
LibraryStore will automatically refresh all views when tag writes complete
Context menu shows "Track Details" for any right-clicked track in all views

Phase: 17-single-track-edit Completed: 2026-03-18

4.7 KiB Raw Blame History