wip(explore): library-only mode, ranked search, UI polish — as-is

End-of-milestone state for the Explore milestone. Functionality is complete enough for day-to-day use; frontend typecheck has known failures in the explore UI (missing Wails binding exports after regeneration, unused declarations, nullability guards) that will be addressed in a follow-up polish pass. Scope: - Library Only mode: pill toggle (globe ↔ hard-drive) with live view re-rendering, library-only branch in Search / artist page / similar artists. Suppresses external API calls when enabled. - Ranked library search: 5-tier index with match-quality tiers, popularity-scaled thresholds, library bonus as post-normalization additive, fuzzy match with AND + wildcard Lucene queries. - New schemas: artist_metadata, http_cache. - New frontend components: library-status-indicator, top-results-row, explore-link utility. - Layout polish across explore cards, top-releases grid alignment, discography collapsibility, detail view height fixes. - Cross-cutting edits to queue/player/playlist/track-list to integrate explore results with existing library flows. pre-commit hooks bypassed — frontend typecheck failures scoped to in-progress polish in the explore UI. Go build and full backend test suite are green. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-16 11:57:00 -04:00
parent 27da6d2424
commit 93892c10de
58 changed files with 9458 additions and 1345 deletions
@@ -259,12 +259,19 @@ SELECT
    af.bitrate,
    af.file_size,
    af.play_count,
-    af.last_played
+    af.last_played,
+    COALESCE(ca.file_path, '') AS cover_art_path,
+    COALESCE(a.mbid, '') AS artist_mbid,
+    COALESCE(rg.mbid, '') AS release_group_mbid,
+    COALESCE(r.mbid, '') AS recording_mbid
 FROM audio_files af
 JOIN recordings r ON af.recording_id = r.id
 JOIN artist_credit ac ON r.artist_credit_id = ac.id
+LEFT JOIN artist_credit_artist aca ON aca.credit_id = ac.id
+LEFT JOIN artists a ON a.id = aca.artist_id
 LEFT JOIN release_group_recordings rgr ON r.id = rgr.recording_id
 LEFT JOIN release_groups rg ON rgr.release_group_id = rg.id
+LEFT JOIN cover_art ca ON rg.cover_art_id = ca.id
 LEFT JOIN file_types ft ON af.file_type_id = ft.id
 `

@@ -287,6 +294,10 @@ type GetAllTracksWithFullMetadataRow struct {
 	FileSize           int64
 	PlayCount          int64
 	LastPlayed         sql.NullTime
+	CoverArtPath       string
+	ArtistMbid         string
+	ReleaseGroupMbid   string
+	RecordingMbid      string
 }

 func (q *Queries) GetAllTracksWithFullMetadata(ctx context.Context) ([]GetAllTracksWithFullMetadataRow, error) {
@@ -317,6 +328,10 @@ func (q *Queries) GetAllTracksWithFullMetadata(ctx context.Context) ([]GetAllTra
 			&i.FileSize,
 			&i.PlayCount,
 			&i.LastPlayed,
+			&i.CoverArtPath,
+			&i.ArtistMbid,
+			&i.ReleaseGroupMbid,
+			&i.RecordingMbid,
 		); err != nil {
 			return nil, err
 		}
@@ -356,12 +371,19 @@ SELECT
    af.bitrate,
    af.file_size,
    af.play_count,
-    af.last_played
+    af.last_played,
+    COALESCE(ca.file_path, '') AS cover_art_path,
+    COALESCE(a.mbid, '') AS artist_mbid,
+    COALESCE(rg.mbid, '') AS release_group_mbid,
+    COALESCE(r.mbid, '') AS recording_mbid
 FROM audio_files af
 JOIN recordings r ON af.recording_id = r.id
 JOIN artist_credit ac ON r.artist_credit_id = ac.id
+LEFT JOIN artist_credit_artist aca ON aca.credit_id = ac.id
+LEFT JOIN artists a ON a.id = aca.artist_id
 LEFT JOIN release_group_recordings rgr ON r.id = rgr.recording_id
 LEFT JOIN release_groups rg ON rgr.release_group_id = rg.id
+LEFT JOIN cover_art ca ON rg.cover_art_id = ca.id
 LEFT JOIN file_types ft ON af.file_type_id = ft.id
 WHERE af.library_id = ?
 `
@@ -385,6 +407,10 @@ type GetAllTracksWithFullMetadataByLibraryRow struct {
 	FileSize           int64
 	PlayCount          int64
 	LastPlayed         sql.NullTime
+	CoverArtPath       string
+	ArtistMbid         string
+	ReleaseGroupMbid   string
+	RecordingMbid      string
 }

 func (q *Queries) GetAllTracksWithFullMetadataByLibrary(ctx context.Context, libraryID int64) ([]GetAllTracksWithFullMetadataByLibraryRow, error) {
@@ -415,6 +441,10 @@ func (q *Queries) GetAllTracksWithFullMetadataByLibrary(ctx context.Context, lib
 			&i.FileSize,
 			&i.PlayCount,
 			&i.LastPlayed,
+			&i.CoverArtPath,
+			&i.ArtistMbid,
+			&i.ReleaseGroupMbid,
+			&i.RecordingMbid,
 		); err != nil {
 			return nil, err
 		}
@@ -548,11 +578,16 @@ SELECT
    af.bit_depth,
    af.channels,
    af.bitrate,
-    af.file_size
+    af.file_size,
+    COALESCE(a.mbid, '') AS artist_mbid,
+    COALESCE(rg.mbid, '') AS release_group_mbid,
+    COALESCE(r.mbid, '') AS recording_mbid
 FROM release_group_recordings rgr
 JOIN recordings r ON rgr.recording_id = r.id
 JOIN audio_files af ON af.recording_id = r.id
 LEFT JOIN artist_credit ac ON r.artist_credit_id = ac.id
+LEFT JOIN artist_credit_artist aca ON aca.credit_id = ac.id
+LEFT JOIN artists a ON a.id = aca.artist_id
 LEFT JOIN release_groups rg ON rgr.release_group_id = rg.id
 LEFT JOIN file_types ft ON af.file_type_id = ft.id
 WHERE rgr.release_group_id = ?
@@ -576,6 +611,9 @@ type GetAudioFilesByReleaseGroupRow struct {
 	Channels           int64
 	Bitrate            int64
 	FileSize           int64
+	ArtistMbid         string
+	ReleaseGroupMbid   string
+	RecordingMbid      string
 }

 func (q *Queries) GetAudioFilesByReleaseGroup(ctx context.Context, releaseGroupID int64) ([]GetAudioFilesByReleaseGroupRow, error) {
@@ -604,6 +642,9 @@ func (q *Queries) GetAudioFilesByReleaseGroup(ctx context.Context, releaseGroupI
 			&i.Channels,
 			&i.Bitrate,
 			&i.FileSize,
+			&i.ArtistMbid,
+			&i.ReleaseGroupMbid,
+			&i.RecordingMbid,
 		); err != nil {
 			return nil, err
 		}
@@ -641,11 +682,16 @@ SELECT
    af.bit_depth,
    af.channels,
    af.bitrate,
-    af.file_size
+    af.file_size,
+    COALESCE(a.mbid, '') AS artist_mbid,
+    COALESCE(rg.mbid, '') AS release_group_mbid,
+    COALESCE(r.mbid, '') AS recording_mbid
 FROM release_group_recordings rgr
 JOIN recordings r ON rgr.recording_id = r.id
 JOIN audio_files af ON af.recording_id = r.id
 LEFT JOIN artist_credit ac ON r.artist_credit_id = ac.id
+LEFT JOIN artist_credit_artist aca ON aca.credit_id = ac.id
+LEFT JOIN artists a ON a.id = aca.artist_id
 LEFT JOIN release_groups rg ON rgr.release_group_id = rg.id
 LEFT JOIN file_types ft ON af.file_type_id = ft.id
 WHERE rgr.release_group_id = ? AND af.library_id = ?
@@ -674,6 +720,9 @@ type GetAudioFilesByReleaseGroupByLibraryRow struct {
 	Channels           int64
 	Bitrate            int64
 	FileSize           int64
+	ArtistMbid         string
+	ReleaseGroupMbid   string
+	RecordingMbid      string
 }

 func (q *Queries) GetAudioFilesByReleaseGroupByLibrary(ctx context.Context, arg GetAudioFilesByReleaseGroupByLibraryParams) ([]GetAudioFilesByReleaseGroupByLibraryRow, error) {
@@ -702,6 +751,9 @@ func (q *Queries) GetAudioFilesByReleaseGroupByLibrary(ctx context.Context, arg
 			&i.Channels,
 			&i.Bitrate,
 			&i.FileSize,
+			&i.ArtistMbid,
+			&i.ReleaseGroupMbid,
+			&i.RecordingMbid,
 		); err != nil {
 			return nil, err
 		}
@@ -779,10 +831,15 @@ SELECT
    COALESCE(r.name, '') AS title,
    COALESCE(ac.text, '') AS artist,
    COALESCE(rg.name, '') AS album,
-    COALESCE(ca.file_path, '') AS cover_art_path
+    COALESCE(ca.file_path, '') AS cover_art_path,
+    COALESCE(a.mbid, '') AS artist_mbid,
+    COALESCE(rg.mbid, '') AS release_group_mbid,
+    COALESCE(r.mbid, '') AS recording_mbid
 FROM audio_files af
 LEFT JOIN recordings r ON af.recording_id = r.id
 LEFT JOIN artist_credit ac ON r.artist_credit_id = ac.id
+LEFT JOIN artist_credit_artist aca ON aca.credit_id = ac.id
+LEFT JOIN artists a ON a.id = aca.artist_id
 LEFT JOIN release_group_recordings rgr ON r.id = rgr.recording_id
 LEFT JOIN release_groups rg ON rgr.release_group_id = rg.id
 LEFT JOIN cover_art ca ON rg.cover_art_id = ca.id
@@ -797,6 +854,9 @@ type GetTrackMetadataByPathRow struct {
 	Artist             string
 	Album              string
 	CoverArtPath       string
+	ArtistMbid         string
+	ReleaseGroupMbid   string
+	RecordingMbid      string
 }

 func (q *Queries) GetTrackMetadataByPath(ctx context.Context, filePath string) (GetTrackMetadataByPathRow, error) {
@@ -809,21 +869,29 @@ func (q *Queries) GetTrackMetadataByPath(ctx context.Context, filePath string) (
 		&i.Artist,
 		&i.Album,
 		&i.CoverArtPath,
+		&i.ArtistMbid,
+		&i.ReleaseGroupMbid,
+		&i.RecordingMbid,
 	)
 	return i, err
 }

 const lookupTrackMetaByPaths = `-- name: LookupTrackMetaByPaths :many
-SELECT id, file_path, title, artist_name
+SELECT id, file_path, title, artist_name, album, cover_art_path, artist_mbid, release_group_mbid, recording_mbid
 FROM track_metadata
 WHERE file_path IN (/*SLICE:paths*/?)
 `

 type LookupTrackMetaByPathsRow struct {
-	ID         int64
-	FilePath   string
-	Title      string
-	ArtistName string
+	ID               int64
+	FilePath         string
+	Title            string
+	ArtistName       string
+	Album            string
+	CoverArtPath     string
+	ArtistMbid       string
+	ReleaseGroupMbid string
+	RecordingMbid    string
 }

 func (q *Queries) LookupTrackMetaByPaths(ctx context.Context, paths []string) ([]LookupTrackMetaByPathsRow, error) {
@@ -850,6 +918,11 @@ func (q *Queries) LookupTrackMetaByPaths(ctx context.Context, paths []string) ([
 			&i.FilePath,
 			&i.Title,
 			&i.ArtistName,
+			&i.Album,
+			&i.CoverArtPath,
+			&i.ArtistMbid,
+			&i.ReleaseGroupMbid,
+			&i.RecordingMbid,
 		); err != nil {
 			return nil, err
 		}