[Feature Request] Surface upload rejection reasons when CLI returns success but no report lands
Nobody has claimed this yet.
Assessment
- Difficulty
- 5/5
- Estimated time
- Over a week
- Newbie friendliness
- 35/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Quiet
- Domain
- api, backend-api-design, cli
Research direction
Start by mapping the Codecov CLI upload flow, the API response handling, and the repos_commits_retrieve polling path mentioned in the issue. Trace how upload slugs, response errors, and queued-status messages are produced. Done should make submission and post-acceptance failures visible with actionable reasons, accurate result URLs, and an observable status in the CLI or UI.
Written by the indexing model from the issue text.
Description
What product do you want to improve?
Codecov CLI / Upload pipeline
Is your feature request related to a problem? Please describe.
The Codecov CLI can return a successful response while the upload actually fails on our backend, with no error or reason surfaced to the user. This forces customers into hours of blind trial-and-error. We've seen this manifest in at least two concrete ways:
-
CLI returns
200witherror=None, warnings=[]but the upload never lands on the commit page. This happens when fields like the uploadname(-nflag) exceed length limits or contain unsupported characters. The upload appears successful to the user but is silently dropped post-acceptance, with no error in the UI either. -
CLI prints a "queued for processing" success message containing a result URL that does not match where it actually POSTed. For example, the CLI can tell the user results will be available at
app.codecov.io/github/<expected-org>/<repo>/commit/<sha>while actually POSTing to<different-org>/<repo>(because the slug auto-resolved from a fork'soriginremote, even though the rest of the CLI output was consistent with the expected org). The backend returns a 400 Bad Request, but the CLI surfaces "Upload queued for processing complete."
In both cases the user is told the upload succeeded, has no way to see the actual failure, and the UI shows nothing — leading to hours of guessing at the problem.
Describe the solution you'd like
- Surface rejection reasons in the CLI response (or via a status field the CLI can poll) when an upload is accepted but later dropped during processing.
- Validate critical fields (e.g.
namelength / character constraints) at submission time and return them as actionable errors instead of silently dropping. - When the CLI receives a non-2xx response from the API, propagate it clearly to the user instead of printing a generic success message.
- Make the success message's "results will be available at" URL reflect the actual slug the CLI used to POST, not just the slug the user might have expected.
- Make any post-acceptance rejection visible somewhere in the Codecov UI on the affected commit page (or surface it via a queryable status endpoint).
Describe alternatives you've considered
- Polling the
repos_commits_retrieveAPI after upload (works but requires bespoke client logic and doesn't surface the underlying reason). - Using
fail_ci_if_error: true(only catches CLI-level errors, not post-acceptance rejections).
Additional context
Hit by multiple customers trialing Codecov. In one case, the user lost ~a day debugging blindly before discovering shortening the -n value made uploads work. In another, a user spent significant time confused about why uploads weren't appearing for the expected repo, eventually tracing it to the CLI auto-detecting the slug from a fork's origin remote while still printing a "results will be at " URL. The lack of error propagation is a significant friction point for adoption.
- Dominant language
- No language data
- Stars
- 52
- Forks
- 25
- PR merge metrics
- No merged PRs in 30d
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from codecov/feedback
-
Difficulty 2/5 1-3 hours Newbie friendliness 62/100
-
Bundle analysis: `normalizePath` replaces everything after the first `-` in a file name, so different assets collidePossibly taken @ChiptenIsCool claimed this 16 days ago. Open
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
-
Docs Waiting for: Product Owner
Difficulty 1/5 Under an hour Newbie friendliness 65/100
-
Difficulty 4/5 3-5 days Newbie friendliness 52/100
-
Difficulty 4/5 1-2 days Newbie friendliness 42/100
All issues in codecov/feedback
Similar issues
-
backlog-skill bot cat:tech-debt effort:s ready-for-agent refactor sev:low
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
LucasSantana-Dev/Lucky#3283 ·
Maintainers usually reply within 1 day
-
area: backend bug priority: low
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
snapotter-hq/SnapOtter#5194 ·
Maintainers usually reply within 1 day
-
go good first issue help wanted
Difficulty 2/5 1-3 hours Newbie friendliness 86/100
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
aws/aws-emulator#610 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 72/100
jxxghp/MoviePilot#7531 ·
Maintainers usually reply within 1 day