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:
1 parent
146c28da9f
commit
8f2c3bb378
2 files changed
+8
-4
No files matched your search
@@ -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")
|
||||
|
||||
Reference in new issue
Block a user