wip on autotagging

backend/database/sql/schemas/_libraries.sql

@@ -1,6 +1,7 @@
 CREATE TABLE IF NOT EXISTS libraries (
-    id         INTEGER PRIMARY KEY,
-    name       TEXT NOT NULL,
-    path       TEXT NOT NULL UNIQUE,
-    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+    id                     INTEGER PRIMARY KEY,
+    name                   TEXT NOT NULL,
+    path                   TEXT NOT NULL UNIQUE,
+    created_at             DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    autotag_warning_acked  INTEGER NOT NULL DEFAULT 0
 );

backend/database/sql/schemas/audio_files.sql

@@ -13,6 +13,11 @@ CREATE TABLE IF NOT EXISTS audio_files (
   library_id int NOT NULL DEFAULT 0,
   play_count int NOT NULL DEFAULT 0,
   last_played datetime,
+  tag_status TEXT NOT NULL DEFAULT 'untagged'
+    CHECK(tag_status IN (
+      'untagged', 'auto_matched', 'user_confirmed', 'user_skipped_permanent'
+    )),
+  group_key TEXT NOT NULL DEFAULT '',
   FOREIGN KEY(file_type_id) REFERENCES file_types(id),
   FOREIGN KEY(recording_id) REFERENCES recordings(id),
   FOREIGN KEY(library_id) REFERENCES libraries(id)
@@ -24,3 +29,11 @@ CREATE INDEX IF NOT EXISTS idx_audio_files_recording_id
 -- idx_audio_files_library_id is created by migration 6 (not here) because
 -- on existing databases this schema file is a no-op (CREATE TABLE IF NOT EXISTS)
 -- and the library_id column doesn't exist until the migration adds it.
+--
+-- idx_audio_files_tag_status_untagged + idx_audio_files_group_key are
+-- created by migrations 31 and 32 for the same reason — on a pre-31
+-- database the partial index predicates (`WHERE tag_status = '...'`
+-- and `WHERE group_key != ''`) would reference columns that don't
+-- yet exist, since CREATE TABLE IF NOT EXISTS does not add columns
+-- to existing tables.  sqlc still sees the columns above, and fresh
+-- DBs pick up the indexes inside the migrations.

backend/database/sql/schemas/release_groups.sql

@@ -3,7 +3,18 @@ CREATE TABLE IF NOT EXISTS release_groups (
   name                   TEXT NOT NULL,
   cover_art_id           INTEGER,
   album_artist_credit_id INTEGER,
+  -- year is the *technical release year* of the album as it lives
+  -- in the user's library — typically the file's ID3 year tag,
+  -- which for remasters/reissues is the reissue year.
   year                   INTEGER,
+  -- original_year is the album's *first-release-date* year sourced
+  -- from MusicBrainz' release-group.first-release-date.  For a 2010
+  -- remaster of a 1973 album, year=2010 and original_year=1973.
+  -- Populated by autotag apply; NULL until the user accepts a
+  -- candidate (or for libraries that have never been autotagged).
+  -- Reads should COALESCE(original_year, year) to get the
+  -- preferred user-facing year.
+  original_year          INTEGER,
   total_tracks           INTEGER,
   total_discs            INTEGER,
   mbid                   TEXT,

backend/database/sql/schemas/tagging_items.sql

@@ -0,0 +1,27 @@
+CREATE TABLE IF NOT EXISTS tagging_items (
+  group_key               TEXT PRIMARY KEY,
+  library_id              INTEGER NOT NULL,
+  track_count             INTEGER NOT NULL DEFAULT 0,
+  album_name              TEXT NOT NULL DEFAULT '',
+  album_artist            TEXT NOT NULL DEFAULT '',
+  disc_number             INTEGER NOT NULL DEFAULT 0,
+  best_match_release_mbid TEXT,
+  score                   REAL,
+  last_checked_at         DATETIME,
+  status                  TEXT NOT NULL DEFAULT 'pending'
+    CHECK(status IN ('pending', 'matched', 'confirmed', 'skipped')),
+  -- cleared_at is set when the user explicitly removes the item
+  -- from the queue ("clear completed entries").  Cleared rows are
+  -- excluded from the queue list but kept in the table so a
+  -- subsequent rescan of the same folder doesn't reset the
+  -- review state.
+  cleared_at              DATETIME,
+  created_at              DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  FOREIGN KEY(library_id) REFERENCES libraries(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_tagging_items_library_status
+    ON tagging_items(library_id, status);
+
+CREATE INDEX IF NOT EXISTS idx_tagging_items_status_pending
+    ON tagging_items(library_id) WHERE status = 'pending';

backend/database/sql/schemas/track_metadata_view.sql

@@ -15,7 +15,13 @@ SELECT
          WHERE rg_sub.recording_id = r.id),
         ''
     ) AS TEXT) AS genre,
-    COALESCE(r.year, 0) AS year,
+    -- Year defaults to the release group's original release year
+    -- (MusicBrainz first-release-date) so a 1973 album shows as
+    -- 1973 even if the user owns the 2010 remaster.  Falls back
+    -- to release-group year (file tag), then to recording year.
+    -- See release_groups.original_year for full semantics.
+    COALESCE(rg.original_year, rg.year, r.year, 0) AS year,
+    COALESCE(rg.year, r.year, 0) AS release_year,
     COALESCE(r.composer, '') AS composer,
     COALESCE(ft.extension, '') AS file_type,
     af.sample_rate,