docs(agents): correct the pending figure again, and name the endpoint that lies #31

Merged
jlxq0 merged 1 commit from docs-pending-precision into main 2026-08-27 03:40:16 +00:00
Owner

Two corrections to one entry, both mine, and the second is the one that matters past this repo.

The 34 minutes was the wrong interval. It is the delay after cargo failed, not the time docker spent pending. There are exactly two docker rows on 287a005c, 15:11:32Z pending and 16:00:54Z failure, so it was pending for 49 minutes, of which 34 were post-dependency-failure.

And /commits/{sha}/statuses is the wrong instrument in general. It returns every row ever written, Forgejo's timestamps are second-resolution, and a skipped job writes pending and success in the same second, so any reduction picking one of a tie picks arbitrarily. Four repositories reported stranded pending statuses that way today and every one collapsed on /commits/{sha}/status, which dedupes.

This case survives, and I checked rather than assumed it. Its two rows are 49 minutes apart rather than tied, which is a property of the data and not of the reduction; the combined endpoint returns docker=failure for the same commit; and I verified empirically that my poll's group_by | .[0] selects the newest row, so seeing pending at 16:00:07Z means the failure row did not exist yet rather than that a tie broke the wrong way.

Third correction to one three-line entry in one evening. The claim has now failed for two different reasons — a window nobody justified, and a figure measuring the wrong interval — and neither was visible from inside the reading that produced it.

Two corrections to one entry, both mine, and the second is the one that matters past this repo. **The 34 minutes was the wrong interval.** It is the delay after `cargo` failed, not the time `docker` spent pending. There are exactly two `docker` rows on `287a005c`, `15:11:32Z pending` and `16:00:54Z failure`, so it was pending for **49 minutes**, of which 34 were post-dependency-failure. **And `/commits/{sha}/statuses` is the wrong instrument in general.** It returns every row ever written, Forgejo's timestamps are second-resolution, and a skipped job writes `pending` and `success` in the same second, so any reduction picking one of a tie picks arbitrarily. Four repositories reported stranded `pending` statuses that way today and every one collapsed on `/commits/{sha}/status`, which dedupes. **This case survives, and I checked rather than assumed it.** Its two rows are 49 minutes apart rather than tied, which is a property of the data and not of the reduction; the combined endpoint returns `docker=failure` for the same commit; and I verified empirically that my poll's `group_by | .[0]` selects the newest row, so seeing `pending` at `16:00:07Z` means the `failure` row did not exist yet rather than that a tie broke the wrong way. Third correction to one three-line entry in one evening. The claim has now failed for two different reasons — a window nobody justified, and a figure measuring the wrong interval — and neither was visible from inside the reading that produced it.
docs(agents): correct the pending figure again, and name the endpoint that lies
All checks were successful
CI / cargo (pull_request) Successful in 1m4s
CI / docker (pull_request) Successful in 56s
52fb8c3421
Two corrections to one entry, both mine.

The 34 minutes was the delay after cargo failed, not the time docker spent
pending. It has exactly two rows, 15:11:32Z pending and 16:00:54Z failure, so
it was pending for 49 minutes of which 34 were after the dependency failed.

And the plural statuses endpoint is the wrong instrument in general. It returns
every row ever written, Forgejo timestamps are second-resolution, and a skipped
job writes pending and success in the same second, so any reduction that picks
one of a tie picks arbitrarily. Four repositories reported stranded pending
statuses that way today and all four collapsed on /commits/{sha}/status. This
case survives because its rows are 49 minutes apart rather than tied, which is
a property of the data rather than of the reduction, and the combined endpoint
returns the same answer here.
jlxq0 merged commit 9c269f84c1 into main 2026-08-27 03:40:16 +00:00
jlxq0 deleted branch docs-pending-precision 2026-08-27 03:40:16 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
jlxq0/caldav-mcp!31
No description provided.