Distillation

Date: Sep 10, 2026

• 🔴 (04:37) User stated package managers always need network access to fetch and install packages; --offline upgrades are supported only for curl-installed binaries.
• 🔴 (04:37) User requires nightly builds to always use curl with a GitHub lookup, regardless of the current installation method.
• 🔴 (04:37) User stated sentry cli upgrade nightly means “Switch to nightly channel and update.”
• 🔴 (04:37) User requires trailing path separators to be stripped for comparison except from a bare root such as /; for example, ~/.local/bin/ must compare equal to ~/.local/bin.
• 🔴 (04:37) User requires source-selection callers to receive and reuse the successful probe response so the request is never repeated.
• 🟡 (04:37) packages/cli/src/commands/cli/upgrade.ts now imports isNightlyVersion and type UpgradeSource from packages/cli/src/lib/binary.ts.
• 🟡 (04:37) validateMethod() in packages/cli/src/commands/cli/upgrade.ts no longer accepts channel; it derives pinnedVersion by treating values in CHANNEL_VERSIONS as unpinned and otherwise removing VERSION_PREFIX_REGEX. Homebrew rejects a pinned version only when !isNightlyVersion(pinnedVersion).
• 🟡 (04:37) Version-target resolution in packages/cli/src/commands/cli/upgrade.ts now returns { kind: "target", target: resolvedTarget, source }; executeStandardUpgrade() accepts and destructures optional source?: UpgradeSource.
• 🟡 (04:37) packages/cli/src/commands/cli/upgrade.ts defines SPAWN_RETRY_BASE_MS = 500; spawn retry delay is documented as attempt * base.
• 🟡 (04:37) Upgrade warnings in packages/cli/src/commands/cli/upgrade.ts say the existing package-manager installation may appear earlier in PATH and provide removal hints: npm → npm uninstall -g sentry, pnpm → pnpm remove -g sentry, bun → bun remove -g sentry, yarn → yarn global remove sentry, brew → brew uninstall getsentry/tools/sentry.
• 🟡 (04:37) packages/cli/src/lib/binary.ts defines InstallationMethod as "curl" | "brew" | "npm" | "pnpm" | "bun" | "yarn" | "unknown".
• 🟡 (04:37) packages/cli/src/lib/binary.ts adds source-aware upgrade selection using UpgradeSource, with PRIMARY_UPGRADE_SOURCE as the default source. Only HTTP 404 advances to the next source; every other HTTP or transport outcome does not trigger source fallback. If every source returns HTTP 404, UpgradeSourceNotFoundError reports: No CLI upgrade source was found: every source returned HTTP 404.
• 🟡 (04:37) fetchWithUpgradeError() in packages/cli/src/lib/binary.ts now preserves arbitrary cancellation: when init.signal?.aborted, it throws init.signal.reason; an AbortError is also rethrown unchanged.
• 🟡 (04:37) fetchWithUpgradeError() now classifies TLS and connection failures as UpgradeTransportError rather than generic UpgradeError("network_error", ...); TLS details use buildTlsErrorDetail(error), while other failures report Failed to connect to ${serviceName}: ${msg}.
• 🟡 (04:37) getBinaryPaths(installPath) in packages/cli/src/lib/binary.ts derives tempPath: ${installPath}.download, oldPath: ${installPath}.old, and lockPath: ${installPath}.lock.
• 🟡 (04:37) Curl install-directory discovery in packages/cli/src/lib/binary.ts checks ~/.local/bin and ~/bin candidates already present in PATH; samePath makes this membership check case-insensitive on Windows and macOS.