Fix GitHub Primary Rate Limit Errors Not Retried
Mantenedores costumam responder em até 1 dia
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Facilidade para iniciantes
- 72/100
- Tipo de issue
- Bug
- Clareza
- Claramente especificada
- Status de atividade
- Ativa
- Stack de tecnologia
- github, typescript
- Domínio
- backend-api-design, distributed-systems
Direção de pesquisa
Start in packages/provider-github/src/http.ts, especially withRetry and assertResponseOk, then read the GitHubError definition and nearby tests. Add coverage for primary rate limit 403 responses, reset-header backoff, and Retry-After handling. Done means these errors retry using the provided timing headers where present, and the issue’s listed typecheck, test, and lint commands pass.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
Summary
Codra's GitHub API client retries secondary rate limit errors (HTTP 403 with body "secondary rate limit") and HTTP 429/5xx errors, but does not retry primary rate limit errors. GitHub returns HTTP 403 (not 429) for primary rate limits, so these requests fail immediately and permanently, aborting in-progress reviews.
Affected File
packages/provider-github/src/http.ts - withRetry (lines 45-85):
const isSecondaryRateLimit =
error instanceof GitHubError &&
error.status === 403 &&
error.body?.toLowerCase().includes("secondary rate limit");
const isRetryable =
isSecondaryRateLimit ||
(error instanceof GitHubError && (error.status === 429 || error.status >= 500)) ||
error.name === "TimeoutError" ||
error.message.includes("timeout");
Why GitHub Uses 403 for Primary Rate Limits
GitHub's REST API returns HTTP 403 Forbidden with the error body "API rate limit exceeded for installation ID ..." and includes these response headers:
x-ratelimit-remaining: 0- confirms the quota is exhaustedx-ratelimit-reset: <epoch>- UTC epoch second when the quota resets
Since the check only recognizes "secondary rate limit" text, primary rate limit 403s fall through to the non-retryable path and immediately throw, causing the review to fail.
Proposed Fix
- Detect primary rate limit 403s:
const isPrimaryRateLimit =
error instanceof GitHubError &&
error.status === 403 &&
(error.body?.toLowerCase().includes("rate limit exceeded") ||
error.body?.toLowerCase().includes("api rate limit"));
- Capture
x-ratelimit-resetfrom response headers and use it to calculate precise sleep duration:
// In assertResponseOk - capture headers
throw new GitHubError(response.status, errText, path, `...`, response.headers);
// In withRetry - respect x-ratelimit-reset
const rateLimitReset = error.headers?.get("x-ratelimit-reset");
const delay = rateLimitReset
? Math.max(0, parseInt(rateLimitReset, 10) * 1000 - Date.now()) + 1000
: Math.pow(2, attempt) * 30000;
Done When
- HTTP 403 responses with primary rate limit body text are retried with appropriate backoff
-
x-ratelimit-resetheader is used to calculate wait time where present -
Retry-Afterheader on 429 responses is also respected -
GitHubErrorcarries response headers for use in retry logic - Tests cover primary rate limit 403 retry and
x-ratelimit-resetbackoff calculation -
npm run typecheck,npm test, andnpm run lintall pass
- Linguagem predominante
- TypeScript
- Estrelas
- 125
- Forks
- 23
- Merge médio
- 2d 13h
- PRs com merge (30d)
- 12
Preparar o ambiente
- Inclui um Dockerfile ou arquivo Docker Compose
- Tem um modelo de pull request
- Ler o guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de devarshishimpi/codra
-
bug good first issue
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
devarshishimpi/codra#178 ·
Mantenedores costumam responder em até 1 dia
-
bug good first issue
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 78/100
devarshishimpi/codra#176 ·
Mantenedores costumam responder em até 1 dia
-
enhancement good first issue
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 48/100
devarshishimpi/codra#186 ·
Mantenedores costumam responder em até 1 dia
-
enhancement good first issue
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 55/100
devarshishimpi/codra#185 ·
Mantenedores costumam responder em até 1 dia
-
enhancement good first issue
Dificuldade 4/5 3-5 dias Facilidade para iniciantes 58/100
devarshishimpi/codra#184 ·
Mantenedores costumam responder em até 1 dia
Todas as issues de devarshishimpi/codra
Issues semelhantes
-
Dificuldade 1/5 1-3 horas Facilidade para iniciantes 83/100
gofish-graphics/gofish-graphics#1384 ·
Mantenedores costumam responder em até 1 dia
-
adapter bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 83/100
Olanetsoft/agent-lookout#353 ·
Mantenedores costumam responder em até 1 dia
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 68/100
vicharanashala/vibe#1542 ·
Mantenedores costumam responder em até 1 dia
-
bug chore P2 size:XS
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 77/100
josephfung/curia#2666 ·
Mantenedores costumam responder em até 1 dia
-
area: batch
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
inabagumi/shinju-date#7294 ·
Mantenedores costumam responder em até 1 dia