Distillation

Date: Sep 10, 2026

• 🔴 (04:23) User changed packages/cli/src/lib/delta-upgrade.ts to import prerelease as semverPrerelease and valid as semverValid from semver, supporting source-aware release normalization.
• 🔴 (04:23) User changed packages/cli/src/lib/delta-upgrade.ts imports from ./binary.js: replaced GITHUB_RELEASES_URL with getGitHubReleasesUrl, and added PRIMARY_UPGRADE_SOURCE plus type UpgradeSource.
• 🔴 (04:23) User removed the direct GHCR_REPO import from ./ghcr.js in packages/cli/src/lib/delta-upgrade.ts.
• 🔴 (04:23) User added primary-upgrade-source resolution that throws Error("No primary upgrade source is configured") when no primary source is available.
• 🔴 (04:23) User changed fetchRecentReleases() in packages/cli/src/lib/delta-upgrade.ts from fetchRecentReleases(signal?: AbortSignal): Promise<GitHubRelease[]> to fetchRecentReleases(signal?: AbortSignal, source: UpgradeSource = getPrimaryUpgradeSource()): Promise<NormalizedGitHubReleases>.
• 🔴 (04:23) User changed fetchRecentReleases() to request ${getGitHubReleasesUrl(source)}?per_page=12 rather than ${GITHUB_RELEASES_URL}?per_page=12; request headers remain Accept: "application/vnd.github.v3+json" and "User-Agent": \sentry-cli/${CLI_VERSION}``.
• 🔴 (04:23) User changed fetchRecentReleases() so successful array responses return normalizeStableReleases(data, source).
• 🔴 (04:23) User changed all empty-result paths in fetchRecentReleases() to return normalizeStableReleases([], source): non-OK HTTP responses, non-array JSON responses, and caught fetch/parsing errors.
• 🔴 (04:23) User retained debug logging for malformed release responses ("GitHub releases response is not an array") and caught failures ("Failed to fetch recent releases from GitHub").
• 🔴 (04:23) User changed the exported default GHCR repository constant from the literal GHCR_REPO = "getsentry/cli" to GHCR_REPO = PRIMARY_UPGRADE_SOURCE.ghcrRepo.
• 🔴 (04:23) User added GhcrManifestHttpError extends UpgradeError for non-successful OCI manifest HTTP responses. It exposes readonly status: number, sets this.name = "GhcrManifestHttpError", and constructs a "network_error" with message Failed to fetch manifest for tag "${tag}": HTTP ${status}.