feat(schema): subtitle/explicit columns, authors+publishers arrays, float series numbers

Phase 1 of the series/collections/metadata overhaul (~/.opencode/plan/series-collections-metadata-overhaul.md). Schema (in place, idempotent): - media_items.series_number INTEGER -> DOUBLE PRECISION: real-world ordinals are decimals (0.5, 1.5 novellas); INTEGER silently truncated them (calibre 2.5 pinned as 2 in tests). - + subtitle TEXT, explicit BOOLEAN (sidecar ingest; ABS explicit / Audible isAdult). - + authors/authors_search/publishers/publishers_search TEXT[] NOT NULL (narrators A2a precedent). Arrays are write truth; author/publisher varchars become trigger-regenerated display strings (sync_author_publisher_display) so every varchar consumer (trgm search, facets, API, OPDS/Kobo) keeps working unchanged. - Row-level NULL normalization for the new arrays in set_library_type_name (A2 lesson: Go nil -> explicit NULL -> 23502). - Backfills ARRAY[author]/ARRAY[publisher] — deliberately no comma-splitting ('Tolkien, J.R.R.' would corrupt; scanner kept only authors[0] historically). - collection_items.position INTEGER + (collection_id, position) index for playlist ordering. Go: sqlc regen; MediaMetadata/handler params gain Subtitle/Explicit/ Authors/Publishers (legacy singles still accepted, arrays win); SeriesNumber int32 -> float64 end to end; metadata_overrides adapted with legacy override keys ('author'/'publisher') preserved so existing user overrides survive; bulk author edit writes the array. Pins widened (docs/contract_pins.md): raw sqlc row key set + the six new columns; changelog entry added. Verified: unit suite green; integration sweep (bulk/smart collections/ scanner/stats/sync/queue/calibre/pins/audiobooks) green against the shared dev DB after in-place migration. Pre-existing unrelated red: TestOwnershipAndAdminTestSuite/TestAdminCreateUser timezone inheritance fails identically at the pre-change commit (live shared state).
2026-10-19 14:17:50 -04:00
1 parent f7dc8189a1
commit 646477afad
@@ -152,8 +152,8 @@ GROUP BY l.id;
 -- narrators/narrators_search are NOT NULL DEFAULT '{}' (A2): callers MUST
 -- pass empty slices, never Go nil (an explicit NULL INSERT bypasses the
 -- column default and 23502s). The API create handler normalizes nil.
-INSERT INTO media_items (library_id, title, author, isbn, description, file_path, file_size, mime_type, cover_image_path, series, series_number, tags, tags_search, asin, date_published, publisher, contributors, contributors_search, language, edition, page_count, genre, copyright_year, goodreads_id, openlibrary_id, google_books_id, added_by_admin_id, created_at, imported_at, manga_type, reading_direction, series_count, volume, imprint, age_rating, web_url, story_arc, is_black_and_white, metadata_notes, community_rating, alternate_info, scan_information, summary, library_type_name, audio_metadata, narrators, narrators_search, abridged)
-VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24, $25, $26, $27, $28, $29, $30, $31, $32, $33, $34, $35, $36, $37, $38, $39, $40, $41, $42, $43, $44, $45, $46, $47, $48)
+INSERT INTO media_items (library_id, title, subtitle, authors, authors_search, isbn, description, file_path, file_size, mime_type, cover_image_path, series, series_number, tags, tags_search, asin, date_published, publishers, publishers_search, contributors, contributors_search, language, edition, page_count, genre, copyright_year, goodreads_id, openlibrary_id, google_books_id, added_by_admin_id, created_at, imported_at, manga_type, reading_direction, series_count, volume, imprint, age_rating, web_url, story_arc, is_black_and_white, metadata_notes, community_rating, alternate_info, scan_information, summary, library_type_name, audio_metadata, narrators, narrators_search, abridged, explicit)
+VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24, $25, $26, $27, $28, $29, $30, $31, $32, $33, $34, $35, $36, $37, $38, $39, $40, $41, $42, $43, $44, $45, $46, $47, $48, $49, $50, $51, $52)
 ON CONFLICT (library_id, file_path) DO UPDATE SET updated_at = NOW()
 RETURNING *;

@@ -164,8 +164,8 @@ RETURNING *;
 -- and a duplicate flag instead of pretending it created something.
 -- narrators NOT NULL: callers pass empty slices, never nil (see
 -- CreateMediaItem note).
-INSERT INTO media_items (library_id, title, author, isbn, description, file_path, file_size, mime_type, cover_image_path, series, series_number, tags, tags_search, asin, date_published, publisher, contributors, contributors_search, language, edition, page_count, genre, copyright_year, goodreads_id, openlibrary_id, google_books_id, added_by_admin_id, created_at, imported_at, manga_type, reading_direction, series_count, volume, imprint, age_rating, web_url, story_arc, is_black_and_white, metadata_notes, community_rating, alternate_info, scan_information, summary, library_type_name, audio_metadata, narrators, narrators_search, abridged)
-VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24, $25, $26, $27, $28, $29, $30, $31, $32, $33, $34, $35, $36, $37, $38, $39, $40, $41, $42, $43, $44, $45, $46, $47, $48)
+INSERT INTO media_items (library_id, title, subtitle, authors, authors_search, isbn, description, file_path, file_size, mime_type, cover_image_path, series, series_number, tags, tags_search, asin, date_published, publishers, publishers_search, contributors, contributors_search, language, edition, page_count, genre, copyright_year, goodreads_id, openlibrary_id, google_books_id, added_by_admin_id, created_at, imported_at, manga_type, reading_direction, series_count, volume, imprint, age_rating, web_url, story_arc, is_black_and_white, metadata_notes, community_rating, alternate_info, scan_information, summary, library_type_name, audio_metadata, narrators, narrators_search, abridged, explicit)
+VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13, $14, $15, $16, $17, $18, $19, $20, $21, $22, $23, $24, $25, $26, $27, $28, $29, $30, $31, $32, $33, $34, $35, $36, $37, $38, $39, $40, $41, $42, $43, $44, $45, $46, $47, $48, $49, $50, $51, $52)
 ON CONFLICT (library_id, file_path) DO NOTHING
 RETURNING *;

@@ -282,46 +282,50 @@ ORDER BY
 -- name: UpdateMediaItem :one
 UPDATE media_items SET
    title = $2,
-    author = $3,
-    isbn = $4,
-    description = $5,
-    cover_image_path = $6,
-    series = $7,
-    series_number = $8,
-    tags = $9,
-    tags_search = $10,
-    asin = $11,
-    date_published = $12,
-    publisher = $13,
-    contributors = $14,
-    contributors_search = $15,
-    language = $16,
-    edition = $17,
-    page_count = $18,
-    genre = $19,
-    copyright_year = $20,
-    goodreads_id = $21,
-    openlibrary_id = $22,
-    google_books_id = $23,
-    manga_type = $24,
-    reading_direction = $25,
-    series_count = $26,
-    volume = $27,
-    imprint = $28,
-    age_rating = $29,
-    web_url = $30,
-    metadata_notes = $31,
-    community_rating = $32,
-    story_arc = $33,
-    is_black_and_white = $34,
-    alternate_info = $35,
-    scan_information = $36,
-    summary = $37,
-    metadata_overrides = $38,
-    audio_metadata = $39,
-    narrators = $40,
-    narrators_search = $41,
-    abridged = $42,
+    subtitle = $3,
+    authors = $4,
+    authors_search = $5,
+    isbn = $6,
+    description = $7,
+    cover_image_path = $8,
+    series = $9,
+    series_number = $10,
+    tags = $11,
+    tags_search = $12,
+    asin = $13,
+    date_published = $14,
+    publishers = $15,
+    publishers_search = $16,
+    contributors = $17,
+    contributors_search = $18,
+    language = $19,
+    edition = $20,
+    page_count = $21,
+    genre = $22,
+    copyright_year = $23,
+    goodreads_id = $24,
+    openlibrary_id = $25,
+    google_books_id = $26,
+    manga_type = $27,
+    reading_direction = $28,
+    series_count = $29,
+    volume = $30,
+    imprint = $31,
+    age_rating = $32,
+    web_url = $33,
+    metadata_notes = $34,
+    community_rating = $35,
+    story_arc = $36,
+    is_black_and_white = $37,
+    alternate_info = $38,
+    scan_information = $39,
+    summary = $40,
+    metadata_overrides = $41,
+    audio_metadata = $42,
+    narrators = $43,
+    narrators_search = $44,
+    abridged = $45,
+    explicit = $46,
    updated_at = NOW()
 WHERE id = $1
 RETURNING *;
@@ -2917,7 +2921,7 @@ WHERE series = sqlc.narg('series')
  AND library_id = sqlc.narg('library_id')
  AND archived_at IS NULL
  AND missing_scan_count = 0
-ORDER BY series_number ASC NULLS LAST;
+ORDER BY series_number ASC NULLS LAST, title ASC;

 -- name: GetContinueSeriesItems :many
 WITH user_series_progress AS (