Distillation

Date: September 10, 2026

• 🔴 (00:04) User stated checkForUpdateInBackgroundImpl() never throws; errors are caught and reported to Sentry.
• 🔴 (00:04) User-provided packages/cli/src/lib/version-check.ts documents checkForUpdateInBackgroundImpl() as non-blocking: it starts a fetch in the background and reports errors to Sentry in a detached span.
• 🔴 (00:04) User-provided packages/cli/src/lib/version-check.ts wraps shouldCheckForUpdate() in try/catch; if database access fails, it calls Sentry.captureException(error) and returns without crashing the CLI.
• 🔴 (00:04) User-provided packages/cli/src/lib/delta-upgrade.ts replaces direct use of GITHUB_RELEASES_URL and GHCR_REPO with source-aware imports getGitHubReleasesUrl, PRIMARY_UPGRADE_SOURCE, and UpgradeSource from ./binary.js.
• 🔴 (00:04) User-provided packages/cli/src/lib/delta-upgrade.ts changes stableSource() to stableSource(source: UpgradeSource). It obtains the release endpoint with getGitHubReleasesUrl(source) and supplies a wrapped sourceFetch to githubReleaseSource(...).
• 🔴 (00:04) In stableSource(source), sourceFetch only rewrites successful release-list responses when source.tagPrefix is present and the requested URL starts with ${releasesUrl}?; other responses pass through unchanged.
• 🔴 (00:04) In stableSource(source), rewritten GitHub release-list responses are validated with isGitHubRelease, exclude draft and prerelease entries, retain only releases whose tag_name starts with source.tagPrefix, and strip that prefix from the returned tag_name.
• 🔴 (00:04) User-provided fetchRecentReleases(signal?: AbortSignal, source: UpgradeSource = getPrimaryUpgradeSource()) in packages/cli/src/lib/delta-upgrade.ts requests ${getGitHubReleasesUrl(source)}?per_page=12 with GitHub API accept headers and User-Agent: sentry-cli/${CLI_VERSION}.
• 🔴 (00:04) fetchRecentReleases(...) returns [] for non-OK responses, non-array JSON, or caught errors; valid arrays are filtered through isGitHubRelease, exclude drafts and prereleases, require tag_name to begin with source.tagPrefix, and return tags with that prefix removed.
• 🔴 (00:04) User-provided prefetchStablePatches(targetVersion: string, signal?: AbortSignal, source: UpgradeSource = getPrimaryUpgradeSource()) now invokes prefetch(stableSource(source), targetVersion, signal), making stable patch prefetching source-aware while defaulting to the primary upgrade source.