vinzenz/hyperhive
vinzenz/hyperhive
Watch
0
0
Fork
You've already forked hyperhive
 0
Code Activity

docs: hive-forge list's paging trailer

Browse source
This commit is contained in:
atlas 2026-10-20 21:28:51 +02:00
commit 3543942e4c
1 changed files with 6 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

7
docs/tools/forge.md
View file

@ -346,7 +346,12 @@ to discover valid label names before triaging or to audit the label set.
most 50 rows. The stderr trailer (printed in `--json` mode too) most 50 rows. The stderr trailer (printed in `--json` mode too)
reports the real total from the response's `X-Total-Count` reports the real total from the response's `X-Total-Count`
(`… 50 of 187 shown … 137 more`), so trust the trailer, not the row (`… 50 of 187 shown … 137 more`), so trust the trailer, not the row
count, when deciding whether you've seen everything. count, when deciding whether you've seen everything. The trailer
reports the rows shown so far, out of the total when the forge sent
one, plus a `re-run with --page N+1` hint. The last page prints no
trailer and no hint, so silence means the list is complete. Without
`X-Total-Count` it falls back to `N shown … more results may exist`
on a full page.
- `repo-search` reads `X-Total-Count` the same way `list` does and warns - `repo-search` reads `X-Total-Count` the same way `list` does and warns
with the real remaining count when it's present (`… 50 of 187 shown … with the real remaining count when it's present (`… 50 of 187 shown …
137 more exist`); without it (an older forge, a stripping proxy) it 137 more exist`); without it (an older forge, a stripping proxy) it