docs(media): the music relayout is mid-flight, and the array takes one writer

The page said the music plan "was applied" while 62k of its 131k journal rows
were still being written; a runbook line that gets believed is worse than none.
Also lands the single-writer law the audiobook handoff exists to honour, and the
durable plan path (/tmp is not a record).
This commit is contained in:
dank committed 2026-10-31 00:40:30 -07:00
1 parent 3613f69593
commit 254fb41fd0
1 file changed
+7 -6
@@ -295,12 +295,9 @@ What it refuses:
rename to `.m4a` would claim it is; **audio no provider row names parks** too, rename to `.m4a` would claim it is; **audio no provider row names parks** too,
because unmatched audio is a tagging job, not a renaming job. because unmatched audio is a tagging job, not a renaming job.
The plan was applied on 2026-10-31; its journal is The plan applies on 2026-10-31 through `/mnt/entropy/media-relayout-music.jsonl`;
`/mnt/entropy/media-relayout-music.jsonl` and its rollback is that journal run its rollback is that journal run through `media-apply.py rollback --apply`. ONE
through `media-apply.py rollback --apply`. Whatever the tags could not name sits writer at a time on this array: two rename passes race, and neither journal tells.
in `Music/_unsorted`, keeping the relative path it had, for a human to review:
the pile is mostly sidecars in a folder holding two albums, plus audio no
provider row names, which is a tagging job and not a renaming job.
## The audiobook library's own relayout ## The audiobook library's own relayout
@@ -356,6 +353,10 @@ no chapter row names, and a loose file in a folder holding two books all park un
that unrelated books share, or a chapter number mistagged as the artist (`0.4`). that unrelated books share, or a chapter number mistagged as the artist (`0.4`).
`Various Artists` is not a placeholder — that is a multi-cast read. `Various Artists` is not a placeholder — that is a multi-cast read.
The plan stands reviewed at `/mnt/entropy/media-relayout-audiobooks-plan.tsv`
(55,114 moves, 7,764 parked, executor preflight refused nothing); it applies on its
own journal, behind the music writer, and then refreshes the Plex section.
## Laws ## Laws
- **A moved file is a 404 in [[Plex]] until its section is rescanned.** The - **A moved file is a 404 in [[Plex]] until its section is rescanned.** The