* fix(scanner): stop classifying "other" content folders as extras Regression from #322 (trailers and extras for movies and series), which introduced the extrasDirKinds map. The extras directory classifier mapped the generic labels "other" and "others" to ExtraKindOther. These are not part of the Jellyfin/Plex extras folder convention the map claims to mirror, and they collide with real content-scope folder names. A library organized as "movies/other/<Title (year) {ids}>/<file>" tripped the depth-2 ancestor lookup in classifyExtraPath: every title two levels under the scope folder "other" was classified as an "other"-kind extra. Such files are partitioned out of primary root/group inference and matching, then deferred in processExtraFiles because their parent cannot resolve (they are the primary titles, not children of one). The result on one deployment was ~10k movies under a folder named "other" funneled through the slow extras path every scan (parent-unresolved deferrals at ~9.5/s), stalling the scan and freezing that scope for new/changed primary content. Remove "other"/"others" from extrasDirKinds. The ExtraKindOther kind stays reachable through genuine convention labels (extra/extras/interviews/ scenes/shorts). Add regression coverage asserting titles under a scope folder named other/others stay primary. * perf(scanner): rewrite identity-only changes without re-probing A pure identity/grouping change on an already-probed file — a root_assignment_changed or group_assignment_changed reason with nothing else — used to fall into the full update branch, which unconditionally ran ffprobe (probeFile) and then upserted every column, including probe columns, from the freshly built row. When a group-key or root scheme changes across the library (see #319), this reprobed nearly every file on the next scan: an incremental scan that normally takes ~1h ran 7h+ as a full-library ffprobe storm, even though the media bytes were untouched. Add a metadata-only update path in processFile: when identityOnlyUpdateReasons reports every reason is a root/group reassignment, rewrite just the derived identity columns via the new FileRepository.UpdateIdentity and skip ffprobe, OSHash, and marker fetch entirely. UpdateIdentity issues a targeted UPDATE of the root/group/identity and edition/presentation columns only, mirroring Upsert's column handling, and leaves probe data, file bytes/mtime/hash, subtitles, chapters, markers, and content/episode/extra linkage intact. The stored group key converges to the recomputed value on the next scan, so the file takes the unchanged fast-path thereafter — without a probe storm. The shared identity-column population is extracted into populateScanIdentity so the full path and the metadata-only path stay in lockstep. Verification: unit test for the identityOnlyUpdateReasons classifier; a DB-backed test (skipped without SILO_TEST_DATABASE_URL) asserting UpdateIdentity rewrites grouping while preserving probe/linkage columns; the UPDATE statement was also exercised against the live schema inside a rolled-back transaction. * fix(scanner): harden identity fast path and extras scope classification Review follow-ups for the two scan-regression fixes on this branch, addressing both Codex review comments on PR #341 plus adversarial-review findings. Identity fast path (processFile/UpdateIdentity): - Gate the metadata-only path on existing.ExtraID == "": a row still linked as an extra reaching processFile is being reclassified as primary, and only the full upsert clears extra linkage; UpdateIdentity would have frozen it out of matching forever (match backlog filters extra_id IS NULL). - Gate on existing.FileHash != "": the full path backfills the OSHash and fetches hash-keyed S3 intro/credits markers, which no later scan reason would repair; hash-less legacy rows now take the full path once instead of silently losing that repair channel. file_hash is added to the scan-state row shape to support the gate. - Clear match_suppressed_at like every other scan write, so files with fresh identity re-enter the match backlog (suppression is documented as lasting "until retried or seen by a new scan"). - Write media_folder_id, mirroring Upsert's ON CONFLICT reassignment. - Return ErrFileNotFound when the row vanished mid-scan (concurrent delete) and fall through to the full upsert path instead of surfacing a per-file scan error. - Return only the row id instead of RETURNING all ~75 columns: the fast path fires once per file during library-wide grouping migrations, and dragging the track/chapter JSONB payloads along for a million rows dominated the cost of the path built to be cheap. - Extract identityColumnDefaults shared by Upsert and UpdateIdentity so the defaulting rules cannot drift, and drop the no-op editionConfidence indirection copied between them. - Use populateScanIdentity in the new-file insert path too; it still carried a verbatim copy of the extracted block (with a provably dead existingByPath lookup). Extras classification: - Restore "other" to extrasDirKinds: it is part of both the documented Jellyfin and Plex extras-folder conventions (the removed-label fix overshot and broke "movies/<Title>/Other/<file>" libraries, ingesting their extras as bogus primary titles). "others" stays removed - it is in neither convention. - Replace label removal with the structural guard the PR had deferred: classifyExtraPath now rejects a supplemental-named directory sitting at library-scope depth (the dir, any supplemental ancestor, or the first non-supplemental ancestor is a configured library root). This fixes the original "movies/other/<Title>" defer-storm generically, covering every convention label (shorts, scenes, extras, ...) used as a content-scope folder. - Scope extras parent binding by folder.Paths instead of the walk roots, so a subtree scan targeting a single movie folder still binds that movie's own extras instead of deferring them. Tests: eligibility-gate unit tests, scope-guard classifier cases (convention Other/ inside a title binds; scope-level other/shorts stay primary), and the DB-backed UpdateIdentity test now also covers folder moves, suppression clearing, and ErrFileNotFound. Full scanner suite ran green against a migrated scratch PostgreSQL 17 container. * refactor(scanner): simplify extras scope guard to title-folder rule Replace the ancestor-walking supplementalDirAtScopeDepth loop with the plain rule it was approximating: a convention-named directory counts as an extras dir only when it sits inside a title folder — it must not be a configured library root or directly under one. Same outcome for the layouts that matter (movies/other/<Title> stays primary, <Title>/Other classifies), less machinery. * test(scanner): assert all rewritten identity columns in UpdateIdentity test * fix(scanner): make extras scope classification structure-aware The title-folder rule from 53632022 anchored on library roots, so it missed both directions: chained convention dirs at the root ("movies/extras/behind the scenes/clip.mkv") classified as extras with an unresolvable parent (deferred forever), and category folders nested below the root ("movies/4K/other/<Title>/") still misclassified their titles. Replace the root-distance heuristic with the structural property that actually distinguishes the two cases: a convention-named directory only counts as an extras dir when its owner (first non-supplemental ancestor) is a title folder — a directory that holds media of its own. The new extrasClassifier derives that from the scan's walked path list (no extra I/O): movie folders must hold a file directly beside the extras dir; series folders may hold episodes one level down in season folders (media hiding inside a folder's own extras dirs doesn't count). Library roots never qualify. Watch-event scans, which have no walked list, probe ownership with bounded os.ReadDir instead. This handles title folders at any depth below the root and keeps scope/category folders primary at any depth, with two known edges: a title folder holding only extras (its media file missing) stays primary until the file appears, and a mixed dir holding both loose media and a category folder degrades to deferral, never wrong linkage. resolveExtraParent's inline supplemental-chain walk is extracted into the shared firstNonSupplementalAncestor.
161 lines
5.8 KiB
Go
161 lines
5.8 KiB
Go
package scanner
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"os"
|
|
"testing"
|
|
"time"
|
|
|
|
"github.com/jackc/pgx/v5/pgxpool"
|
|
|
|
"github.com/Silo-Server/silo-server/internal/models"
|
|
)
|
|
|
|
// TestUpdateIdentityPreservesProbeData covers the scanner's metadata-only update
|
|
// path (issue #319 hardening): rewriting a file's derived identity/grouping must
|
|
// persist the new root/group columns while leaving probe data, file bytes, and
|
|
// content linkage untouched — no ffprobe, no probe-column churn. Like every
|
|
// scan write it must clear match suppression, and it must follow folder moves.
|
|
func TestUpdateIdentityPreservesProbeData(t *testing.T) {
|
|
dsn := os.Getenv("SILO_TEST_DATABASE_URL")
|
|
if dsn == "" {
|
|
t.Skip("SILO_TEST_DATABASE_URL is not set")
|
|
}
|
|
ctx := context.Background()
|
|
pool, err := pgxpool.New(ctx, dsn)
|
|
if err != nil {
|
|
t.Fatalf("connect test database: %v", err)
|
|
}
|
|
t.Cleanup(pool.Close)
|
|
|
|
suffix := time.Now().UnixNano()
|
|
contentID := fmt.Sprintf("ui-content-%d", suffix)
|
|
path := fmt.Sprintf("/tmp/ui-%d/Movie (2020) {tvdb-1}/Movie (2020).mkv", suffix)
|
|
probedAt := time.Now().Add(-72 * time.Hour).UTC().Truncate(time.Second)
|
|
|
|
var folderID, movedFolderID int
|
|
if err := pool.QueryRow(ctx, `
|
|
INSERT INTO media_folders (type, name, enabled) VALUES ('movies', 'UI Test', true) RETURNING id
|
|
`).Scan(&folderID); err != nil {
|
|
t.Fatalf("seed folder: %v", err)
|
|
}
|
|
if err := pool.QueryRow(ctx, `
|
|
INSERT INTO media_folders (type, name, enabled) VALUES ('movies', 'UI Test Moved', true) RETURNING id
|
|
`).Scan(&movedFolderID); err != nil {
|
|
t.Fatalf("seed moved folder: %v", err)
|
|
}
|
|
t.Cleanup(func() {
|
|
_, _ = pool.Exec(ctx, `DELETE FROM media_files WHERE media_folder_id = ANY($1)`, []int{folderID, movedFolderID})
|
|
_, _ = pool.Exec(ctx, `DELETE FROM media_folders WHERE id = ANY($1)`, []int{folderID, movedFolderID})
|
|
})
|
|
|
|
var fileID int
|
|
if err := pool.QueryRow(ctx, `
|
|
INSERT INTO media_files (
|
|
content_id, media_folder_id, file_path, file_size,
|
|
observed_root_path, canonical_root_path, content_group_key, group_key_version,
|
|
base_title, base_year, base_type,
|
|
codec_video, codec_audio, resolution, container, duration, bitrate,
|
|
video_tracks, audio_tracks, chapters, probe_source, probe_updated_at,
|
|
match_suppressed_at
|
|
) VALUES (
|
|
$1, $2, $3, 123456,
|
|
'/old/root', '/old/root', 'v1|movie|movie|2020', 1,
|
|
'Movie', 2020, 'movie',
|
|
'h264', 'aac', '1080p', 'mkv', 7200, 5000,
|
|
'[{"index":0}]'::jsonb, '[{"index":1}]'::jsonb, '[]'::jsonb, 'local', $4,
|
|
NOW()
|
|
) RETURNING id
|
|
`, contentID, folderID, path, probedAt).Scan(&fileID); err != nil {
|
|
t.Fatalf("seed media file: %v", err)
|
|
}
|
|
|
|
repo := NewFileRepository(pool)
|
|
updatedID, err := repo.UpdateIdentity(ctx, models.MediaFile{
|
|
MediaFolderID: movedFolderID,
|
|
FilePath: path,
|
|
ObservedRootPath: "/new/root",
|
|
CanonicalRootPath: "/new/root",
|
|
ContentGroupKey: "v1|movie|anchor|tvdb-1",
|
|
GroupKeyVersion: 1,
|
|
BaseTitle: "Movie",
|
|
BaseYear: 2020,
|
|
BaseType: "movie",
|
|
})
|
|
if err != nil {
|
|
t.Fatalf("UpdateIdentity: %v", err)
|
|
}
|
|
if updatedID != fileID {
|
|
t.Errorf("UpdateIdentity id = %d, want %d", updatedID, fileID)
|
|
}
|
|
|
|
updated, err := repo.GetByPath(ctx, path)
|
|
if err != nil {
|
|
t.Fatalf("GetByPath after UpdateIdentity: %v", err)
|
|
}
|
|
|
|
// Identity/grouping columns rewritten.
|
|
if updated.ContentGroupKey != "v1|movie|anchor|tvdb-1" {
|
|
t.Errorf("content_group_key = %q, want anchored form", updated.ContentGroupKey)
|
|
}
|
|
if updated.ObservedRootPath != "/new/root" {
|
|
t.Errorf("observed_root_path = %q, want /new/root", updated.ObservedRootPath)
|
|
}
|
|
if updated.CanonicalRootPath != "/new/root" {
|
|
t.Errorf("canonical_root_path = %q, want /new/root", updated.CanonicalRootPath)
|
|
}
|
|
if updated.BaseTitle != "Movie" || updated.BaseYear != 2020 || updated.BaseType != "movie" {
|
|
t.Errorf("base title/year/type = %q/%d/%q, want Movie/2020/movie",
|
|
updated.BaseTitle, updated.BaseYear, updated.BaseType)
|
|
}
|
|
if updated.MediaFolderID != movedFolderID {
|
|
t.Errorf("media_folder_id = %d, want moved folder %d", updated.MediaFolderID, movedFolderID)
|
|
}
|
|
|
|
// Probe data and linkage preserved.
|
|
if updated.ContentID != contentID {
|
|
t.Errorf("content_id = %q, want preserved %q", updated.ContentID, contentID)
|
|
}
|
|
if updated.CodecVideo != "h264" || updated.CodecAudio != "aac" || updated.Resolution != "1080p" {
|
|
t.Errorf("probe codecs mutated: video=%q audio=%q res=%q", updated.CodecVideo, updated.CodecAudio, updated.Resolution)
|
|
}
|
|
if updated.Duration != 7200 {
|
|
t.Errorf("duration = %d, want preserved 7200", updated.Duration)
|
|
}
|
|
if updated.ProbeSource != "local" {
|
|
t.Errorf("probe_source = %q, want preserved local", updated.ProbeSource)
|
|
}
|
|
if updated.ProbeUpdatedAt == nil || !updated.ProbeUpdatedAt.Equal(probedAt) {
|
|
t.Errorf("probe_updated_at = %v, want preserved %v", updated.ProbeUpdatedAt, probedAt)
|
|
}
|
|
if len(updated.VideoTracks) != 1 || len(updated.AudioTracks) != 1 {
|
|
t.Errorf("track arrays mutated: video=%d audio=%d", len(updated.VideoTracks), len(updated.AudioTracks))
|
|
}
|
|
if updated.FileSize != 123456 {
|
|
t.Errorf("file_size = %d, want preserved 123456", updated.FileSize)
|
|
}
|
|
|
|
// Match suppression cleared like any other scan write, so the fresh
|
|
// identity re-enters the match backlog.
|
|
var suppressed bool
|
|
if err := pool.QueryRow(ctx, `
|
|
SELECT match_suppressed_at IS NOT NULL FROM media_files WHERE id = $1
|
|
`, fileID).Scan(&suppressed); err != nil {
|
|
t.Fatalf("read match_suppressed_at: %v", err)
|
|
}
|
|
if suppressed {
|
|
t.Error("match_suppressed_at still set, want cleared by identity update")
|
|
}
|
|
|
|
// A vanished row surfaces as ErrFileNotFound so the scanner can fall back
|
|
// to the full upsert path.
|
|
if _, err := repo.UpdateIdentity(ctx, models.MediaFile{
|
|
MediaFolderID: folderID,
|
|
FilePath: path + ".does-not-exist",
|
|
}); !errors.Is(err, ErrFileNotFound) {
|
|
t.Errorf("UpdateIdentity on missing row: err = %v, want ErrFileNotFound", err)
|
|
}
|
|
}
|