Brings one library's files up to date with its storage profile and variant set (storage.reconcile, V205): copies objects where the profile wants them, unlinks them where it no longer does, and makes, remakes or deletes sizes by the set. PhoenixKit.Modules.Storage.Reconciler does the work of a batch.

One run per library (scope {"library", uuid}). That is what lets an admin see a library's state, check it, pause it and read who did what (dev_docs/plans/2026-10-03-job-runs.md, §6.2). A run with no library scope walks every library, as the old pass did.

Started by itself — trigger/1 starts a run for each library that has files the reconciler may take, whenever a profile, a variant set or one of their rows changes (their revision is bumped), a library moves to another one, an upload made fewer copies or sizes than wanted, and by the daily prune and on boot. It is called by Storage.Workers.ReconcileJob, the Oban job those places have always queued (so they work inside a transaction too, and an older job still in the queue does the right thing). An admin starts one with Check now.

restart/0 is :restart: a change made while a pass runs starts the pass again from the beginning at its next batch boundary, because its cursor would skip files the change made stale.

Throttled: ten files a batch, two seconds between batches, on the file_processing queue, so copying and ImageMagick/FFmpeg work stay bounded by that queue. A file that could not be finished waits ten minutes before it is tried again (reconcile_attempted_at).

Counts. done is files reconciled, failed files that could not be finished yet (they stay stale), total the files this pass starts with. A pass whose batch was interrupted counts that batch's already-finished files in nobody's tally (see PhoenixKit.Jobs.Kind).