Distillation

🔴 (01:11) User specified that waitForBinaryVisible throws UpgradeError when the downloaded binary never becomes visible or stays empty.
🔴 (01:11) User documented a Windows + Bun 1.3.9 issue (CLI-1D3) involving streaming writes via Bun.file().writer().
🔴 (01:11) Nightly builds are stored in GHCR as sentry-<os>-<arch>.gz, with platform-dependent alternatives.
🔴 (01:11) downloadNightlyToPath() downloads a nightly blob and writes the resulting binary to a destination path, decompressing gzip content when applicable and falling back to a raw download.
🔴 (01:11) The binary-visibility retry schedule includes attempt 3 after 300 ms, with a 400 ms cumulative delay.
🔴 (01:11) Nightly upgrade handling is selected using isNightlyVersion.
🔴 (01:11) Offline upgrade failure reports: Cannot upgrade to ${version} — the network is unavailable and no pre-downloaded update was found.
🔴 (01:11) After an update is consumed, the implementation clears the patch cache because patches for the old version are no longer useful.
🔴 (01:11) The upgrade preparation result includes { tempBinaryPath: tempPath, lockPath, patchBytes }.
🔴 (01:11) executeUpgradeHomebrew() is used for the Homebrew upgrade path.

Observations