Distillation

Date: Sep 10, 2026

• 🔴 (04:37) User requires nightly builds to always use the "curl" installation method for GitHub lookup, regardless of the current installation method, because nightly builds are GitHub-only.
• 🔴 (04:37) User requires trailing path separators to be stripped for PATH comparison, but never from a bare root such as /; stripTrailingSep(p: string) returns p.slice(0, -1) only when p.length > 1 && p.endsWith(sep), allowing ~/.local/bin/ to compare equal to ~/.local/bin.
• 🔴 (04:37) User requires a successful source-probe response to be returned to the caller so the caller never repeats the request.
• 🔴 (04:37) User specified CLI help text: "sentry cli upgrade nightly" means "Switch to nightly channel and update".
• 🟡 (04:37) Upgrade resolution now derives pinnedTarget from non-channel versionArg values using versionArg.replace(VERSION_PREFIX_REGEX, ""); pinned nightly versions use resolvePinnedVersion("curl", pinnedTarget), while other pinned versions use the selected installation method.
• 🟡 (04:37) Standalone, unpinned upgrades use resolveLatestUpgradeVersion(channel) and carry its branded source; target selection order is pinnedTarget, then latestResolution?.version, then fetchLatestVersion(method, channel).
• 🟡 (04:37) Upgrade checks and execution now use resolvedTarget; target results return { kind: "target", target: resolvedTarget, source }, and check results also preserve source.
• 🟡 (04:37) Nightly standalone migration is selected using isNightlyVersion(target) && method !== "curl" rather than merely channel === "nightly" && method !== "curl". migrateToStandaloneForNightly() now receives source and channel; executeStandardUpgrade() now receives source.
• 🟡 (04:37) Upgrade provenance defines UpgradeSource with readonly fields githubRepo, ghcrRepo, and tagPrefix. Ordered UPGRADE_SOURCES are: 1. { githubRepo: "getsentry/toolkit", ghcrRepo: "getsentry/toolkit", tagPrefix: "cli@" }; 2. { githubRepo: "getsentry/cli", ghcrRepo: "getsentry/cli", tagPrefix: "" }. Resolution falls through only on HTTP 404, and PRIMARY_UPGRADE_SOURCE is UPGRADE_SOURCES[0].