feat: separate deleted videos from missing ones

[dialmaster]

Every video without a file looked the same. A video deleted in the app, one removed by automatic cleanup, and one whose file disappeared from disk all showed the same red Missing state, and they piled up on the Videos page with no way to clear them out.

Deleted vs. missing

• Youtarr now records why a video lost its file (removed_reason, removed_at, removed_detail) and shows it as Deleted (grey) or Missing (red). The chip tooltip and the video modal give the reason in plain words and say the video can be downloaded again. Videos removed before this change show as Deleted.
• The Videos page hides deleted videos by default and remembers the choice in the browser. Channel and playlist pages still list both, so either kind can be re-downloaded. In hot-load mode the list reloads from page one after a delete or mark, since refetching a later page kept the removed rows around; classic pagination stays on its page.
• Missing videos can be marked as deleted in three places:
  • A selection on the Videos page (sent in batches of 1000, showing the server's message if it's refused).
  • One video from the video modal, on any page.
  • All of them at once from Settings > Maintenance.
• Maintenance also has "Empty trash...", which forgets the chosen videos and can remove their download archive entries too. Its dialog opens on the first choice that's available and disables archive removal up front while a download is running.
• A purge that removes archive entries is refused while downloads are running, and new downloads wait until that kind of purge finishes.
• Channel "Download all" and playlist downloads skip videos the archive lists without a database row. Before, they queued those videos on every run and yt-dlp skipped them every time.

Unmounted drives and shares

• Before marking anything missing, Youtarr checks that the downloads folder and each __subfolder exist and aren't empty. If the downloads folder itself fails, every video is in doubt. If a subfolder fails, only the videos stored in it are. Every failing subfolder gets reported, and an unreadable one counts as worse than an empty one, so an unreadable share is never mistaken for a folder that was emptied on purpose. An empty subfolder with no videos stored in it (say, one a channel was moved out of) doesn't block anything.
• Files and folders Youtarr creates itself (.youtarr_tmp, __playlists__, leftover health-check files) don't count, because a sweep or a restart creates them on the bare mount point while a share is down.
• While the check puts videos in doubt:
  • The file check leaves those videos alone, and the Videos page shows a warning that can be dismissed.
  • The rescan fails if the downloads folder itself is the problem. If it's a subfolder, the rescan still runs but doesn't mark that subfolder's videos missing, and the run is recorded as partial.
  • Automatic cleanup and the orphan folder sweep record a skipped run if present videos are affected.
  • Manual deletes refuse each affected video with the same message, instead of marking it deleted while its file sits on the share.
  • Emptying missing videos from the trash is refused if any of them are affected.
• The messages name a subfolder by its own name and never show the container path, since that path doesn't mean anything on the host.
• For a folder that's empty on purpose (only when it's empty, never when it's gone or unreadable), the Maintenance card has two ways around the check:
  • "Rescan anyway" runs a manual rescan that skips the check once and marks the gone files missing. The scheduled rescan never skips the check, and the run record says when it was skipped.
  • "Mark all missing as deleted" goes ahead once the user confirms they removed the files themselves.

Smaller fixes

• The file check only turns a present video missing and only restores a removed one, so a delete that happens mid-request keeps its reason. Job recovery leaves the removal columns alone when it can't find the file.
• The channel page shows the file check's result on the same load. Its table view no longer shows a download format for a removed video whose old path is still stored.
• A present file in the playlist modal reads as downloaded even when YouTube has removed the video.
• On a touch screen, tapping an Availability chip opens its tooltip without also selecting or expanding the row underneath. Mouse clicks still go through to the row.
• The Deleted filter chip looks neutral when it's at its default, and the File Deleted/Missing overlay is readable on any thumbnail and fits in a phone's player.

Known limitation, follow-up PR
A download that finishes while a share is down still creates channel folders on the bare mount point, and from then on the check can't tell the share is missing. I plan to fix that in a separate PR by holding downloads through the existing storage pause while the library looks unmounted. That PR will also keep library repair from recreating lost videos as missing while the folder looks unmounted, and make the archive write for single entries atomic.

Refs: #670

[github-actions]

📊 Test Coverage Report

Backend Coverage

Type	Coverage	Status
Lines	91.24%	🟢
Statements	91.11%	🟢
Functions	91.08%	🟢
Branches	85.11%	🟢

Frontend Coverage

Type	Coverage	Status
Lines	89.47%	🟢
Statements	87.95%	🟢
Functions	81.42%	🟢
Branches	82.42%	🟢

Coverage Requirements

• Minimum threshold: 70% line coverage
• Backend: ✅ Passes
• Frontend: ✅ Passes

---

Coverage report generated for commit 006bb04