docs(scripts): --after names the trigger's epoch, never a file mtime

Both drivers' help text recommended `--after "$(stat -c %Y <journal>)"`. Measured
2026-11-04 that epoch is answered by whatever scan finished before the question was
asked: on Jellyfin it reads an earlier task's EndTimeUtc, and the Plex door cannot be
a waiter at all, since PMS stamps section_locations.scanned_at when it accepts the
request. The laws are on the vault pages (main 146c28d); this puts the warning at
point of use, in the text an agent reads before calling the door.
This commit is contained in:
dank committed 2026-11-04 12:24:56 -08:00
1 parent 146c28da9f
commit 8f2c3bb378
2 files changed
+8 -4

No files matched your search

+4 -3
View File
@@ -7,7 +7,8 @@
`status` answers {"scan": true, "taskState": "Running", "recentMedia": 17}: the
Scan Media Library row plus the rows the database has taken in recently; with
`--after` (a journal mtime) it also answers `scannedAfter` and exits non-zero
`--after` (the trigger's epoch — a file mtime is already passed by an earlier scan) it
also answers `scannedAfter` and exits non-zero
while the last finished scan predates it. `wait` calls the library settled only
on the page's law: a sighting of the task Running — or a run that finished while
it watched, or a `--after` the task already passes — and THEN `--require-quiet`
@@ -140,8 +141,8 @@ def main() -> None:
ap.add_argument("--require-quiet", type=int, default=3,
help="wait: consecutive quiet reads before the library counts as settled")
ap.add_argument("--after", type=float, default=None,
help="status/wait: an epoch (a journal mtime) the scan must have "
"finished after; status exits non-zero while it has not")
help="status/wait: an epoch the scan must have finished after — pass "
"the trigger's, not a file mtime an earlier scan already passes")
ap.add_argument("--start-window", type=float, default=120.0,
help="wait: seconds to allow the scan to start before reporting "
"that the 204 queued nothing")