Wraps the PUT /repos/{owner}/{repo}/code-coverage/report API call,
handling gzip/base64 encoding, PR vs push event detection, SHA/ref
resolution, and PR number lookup automatically.
Supports both pull_request-triggered and push-only workflows.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>