01"A dead source is never a clean result"
Collectors raise an error rather than return a short list, and anything under a sanity floor counts as down. Rules missing an input are skipped and reported as skipped. An unmounted share and an empty one look identical, so the app refuses to guess.
02"Never assert an authority you do not have"
Plex is wrong about IDs often enough that a conflict is shown as a choice between two resolved titles ("64691: a 1946 nutrition film" vs "64690: Drive, 2011"), not an automatic correction.
03Matching that verifies, never guesses
The old matcher picked the wrong page for 3 of 77 sampled films and flagged none. Now a page is used only if its reference poster appears in the film's TMDB images. Otherwise the app asks.
04Undo you can trust
Undo is captured at apply time from the value actually there, so it can only reverse what this process did. A fix whose value already matches doesn't clear the finding, because that would hide a live discrepancy.
05Safety bugs caught before deploy
An audit found Delete Everywhere permanently removing media. It now moves files to a trash and needs explicit confirmation. Three GET routes that changed state became POST.
06A migration rehearsed on a copy
4,841 posters were copied with every file hashed, refusing on any mismatch, into a database built in a temp file that only goes live when everything is in. The script refuses to run twice.
0726 MB to 300 KB
The startup snapshot shrank 99% on the wire, the item list went from 737 ms to 71 ms, and thumbnails are cached by source fingerprint and pre-warmed after each scan.
08Polite by design
ThePosterDB is read at 1.5 requests a second with retry on 429. Big set pages fill in as they arrive and are cached for 30 days. Background work yields to people.
09Dates recovered by hash
Posters carried over from the old tool had lost when they were chosen. A script matched each file to its original by SHA-1 and took the old file's date: 4,930 of 4,930 matched on a copy, as a dry run, before it was applied on the box.
10787 tests on fakes
Postarr has 282 pytest and 154 vitest tests, Reconcilarr 193 and 148, shared code 10, all on throwaway data with a fake Plex and a fake Postarr. They run before every commit, and a deploy ships nothing if one fails.