Recover files: bring back deleted or changed files from parity

[firsttris]

Adds a recycle bin. Until the next sync, the parity still holds every file as it was at the last sync. The new page Recover files (sidebar, under Dashboard) lists what changed since then and restores the picked files.

What it does

• Two tabs from snapraid diff:
  • Deleted: files removed since the last sync.
  • Changed: same name, other content. This covers files encrypted by ransomware or overwritten by mistake.
• Search and selection: search by part of the path or by the exact disk name, then tick single files or Select all shown files.
• Restore: Restore N files asks for confirmation. For changed files the confirmation says the current content is replaced and lost.
• Next sync warning: a notice shows when the next scheduled sync runs, because after it these files can no longer be restored.
• After restoring: restored files leave the list. A file restored in place can still show as changed in diff until the next sync. SnapRAID sometimes keeps the new modification time to avoid inode mix-ups; the content is the old one, and the page explains this.
• Sync preview: the "deleted files" hint now points to Recover files.

How

• Endpoint: POST /api/snapraid/restore takes {configPath, files: [{disk, path}]} and runs snapraid fix -d <disk> -f /<path>….
  • One job per disk, one after the other. A filter applies to every disk in a run, so a file with the same path on another disk would otherwise be reverted too.
  • The chain stops after a failed fix, or if another job starts in between.
  • At most 1000 files per request.
• Filter escaping: SnapRAID's filters have no backslash escape. Each *, ? and [ becomes a one-character class ([*]), so names like x[1] *.bin match literally.
• Verified by hand against SnapRAID 14.10: fix -f restores deleted files, and also changed files to the content of the last sync.

Tests

• Backend: 141 passed with Deno 2.5 (the CI version). New tests cover the exact filter with wildcards, one run per disk, and stopping on failure or a busy engine.
• Frontend: Biome, typecheck, Vitest 29. New tests cover splitting the diff into deleted and changed files, and the search.
• E2E: 17/17 locally. New tests:
  • a deleted file and an "encrypted" file are restored byte for byte;
  • a file with the same path on another disk stays untouched.
• Docs: Recover files section in usage.md (with a ransomware tip), API row in architecture.md, development.md, README feature. mkdocs build --strict passes.

🤖 Generated with Claude Code

https://claude.ai/code/session_01JuXnquCPdbG5sBbDyin7yF

---

Generated by Claude Code