Skip to content

Commit 92fbc04

Browse files
committed
docs(CHANGES) Add import pagination, rate limit, and retry entries
why: PR #518 adds several bug fixes and features that need changelog entries. what: - Document silent truncation fix for GitLab/GitHub results - Document HTTP 429 retry with exponential backoff - Document --limit 0 as "no limit" convention - Document GitLab rate-limit header logging
1 parent 9f97e0a commit 92fbc04

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

CHANGES

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -33,6 +33,42 @@ $ uvx --from 'vcspull' --prerelease allow vcspull
3333
_Notes on upcoming releases will be added here_
3434
<!-- END PLACEHOLDER - ADD NEW CHANGELOG ENTRIES BELOW THIS LINE -->
3535

36+
### Bug fixes
37+
38+
#### `vcspull import`: Fix silent truncation of GitLab/GitHub results (#518)
39+
40+
Previously, `--limit 100` (the default) would silently discard repositories
41+
beyond the cap with no indication that more were available.
42+
43+
- GitLab: Read `x-total` and `x-next-page` response headers to detect
44+
truncation and warn users
45+
- GitHub search: Use `total_count` from the JSON body to detect truncation
46+
- GitHub user/org: Detect mid-page limit hit as a "more available" signal
47+
- All providers now print:
48+
`Showing N of M repositories (use --limit 0 to fetch all)`
49+
50+
#### `vcspull import`: Fix HTTP 429 rate-limit failures on large imports (#518)
51+
52+
Rate-limited API requests previously failed immediately with an unrecoverable
53+
error. Large imports that triggered rate limits had to be manually restarted.
54+
55+
- Add automatic retry with exponential backoff (up to 3 attempts) on HTTP 429
56+
- Honor the `Retry-After` response header when present (capped at 120 s)
57+
- Fall back to exponential backoff with jitter when the header is absent
58+
59+
### New features
60+
61+
#### `vcspull import`: `--limit 0` means "no limit" (#518)
62+
63+
`--limit 0` now fetches every repository instead of raising a validation
64+
error. This follows the common CLI convention where 0 means unlimited.
65+
66+
#### `vcspull import`: GitLab rate-limit header logging (#518)
67+
68+
GitLab `ratelimit-remaining` / `ratelimit-limit` headers are now logged
69+
after each API request, matching the existing GitHub rate-limit logging.
70+
A warning is emitted when fewer than 10 requests remain.
71+
3672
## vcspull v1.56.0 (2026-02-15)
3773

3874
### New features

0 commit comments

Comments
 (0)