Distillation

Date: Sep 10, 2026

• 🟡 (11:58) Immutable Git verification established merge base ec83887a16f780f32fba4b7d710bad262dba3a22, base tree 110d6530e57ca4fbfb2a3f98e52013d2668b5b5e, and head tree 22f49363a13e32c36dcd9e1ca95916809c2dc271; the supplied base is the merge base and the revisions are linear.
• 🟡 (11:58) Immutable full-index patch SHA-256 is 4950719273dc17d5a9e061b8cfe70c62131fe3299dc1799d9c09bb522b112193; git diff --check produced no output and was reported clean.
• 🟡 (11:58) The patch modifies exactly 17 files: packages/cli/src/commands/cli/upgrade.ts, packages/cli/src/lib/binary.ts, packages/cli/src/lib/delta-upgrade.ts, packages/cli/src/lib/errors.ts, packages/cli/src/lib/ghcr.ts, packages/cli/src/lib/release-notes.ts, packages/cli/src/lib/upgrade.ts, packages/cli/src/lib/version-check.ts, packages/cli/test/commands/cli.test.ts, packages/cli/test/commands/cli/upgrade.test.ts, packages/cli/test/lib/binary.test.ts, packages/cli/test/lib/delta-upgrade.mocked.test.ts, packages/cli/test/lib/delta-upgrade.test.ts, packages/cli/test/lib/ghcr.test.ts, packages/cli/test/lib/release-notes.test.ts, packages/cli/test/lib/upgrade.test.ts, and packages/cli/test/lib/version-check.test.ts.
• 🟡 (11:59) Patch statistics are exactly 3,299 insertions and 433 deletions across 17 files. Per-file changes: packages/cli/src/commands/cli/upgrade.ts 180 lines, packages/cli/src/lib/binary.ts 191, packages/cli/src/lib/delta-upgrade.ts 170, packages/cli/src/lib/errors.ts 8, packages/cli/src/lib/ghcr.ts 213, packages/cli/src/lib/release-notes.ts 134, packages/cli/src/lib/upgrade.ts 520, packages/cli/src/lib/version-check.ts 21, packages/cli/test/commands/cli.test.ts 40, packages/cli/test/commands/cli/upgrade.test.ts 494, packages/cli/test/lib/binary.test.ts 188, packages/cli/test/lib/delta-upgrade.mocked.test.ts 14, packages/cli/test/lib/delta-upgrade.test.ts 220, packages/cli/test/lib/ghcr.test.ts 235, packages/cli/test/lib/release-notes.test.ts 221, packages/cli/test/lib/upgrade.test.ts 758, and packages/cli/test/lib/version-check.test.ts 125.
• 🔴 (11:59) User specified that package managers always need network access to fetch and install packages; --offline upgrade is supported only for curl-installed binaries, and other installation methods must raise UpgradeError("unsupported_operation", "Offline upgrade is only supported for curl-installed binaries.").
• 🔴 (11:59) User specified that nightly builds are GitHub-only and nightly-version existence checks must always use curl/GitHub lookup regardless of the current installation method.
• 🔴 (11:59) User specified the CLI usage behavior/example sentry cli upgrade nightly # Switch to nightly channel and update.
• 🔴 (11:59) User specified that trailing path separators should be stripped for comparison, but never from a bare root such as /; for example, ~/.local/bin/ must compare equal to ~/.local/bin.
• 🔴 (11:59) User specified that source probing should return the successful probe response to the caller so the caller never repeats the request.
• 🟡 (11:59) In packages/cli/src/commands/cli/upgrade.ts, validateMethod() no longer takes channel; it derives pinnedVersion by excluding CHANNEL_VERSIONS and removing VERSION_PREFIX_REGEX. Homebrew rejects pinned versions unless isNightlyVersion(pinnedVersion) is true.
• 🟡 (11:59) In packages/cli/src/commands/cli/upgrade.ts, resolveTargetVersion() distinguishes standalone resolution when channel === "nightly", method === "curl", or method === "brew"; pinned nightly targets use lookup method "curl", unpinned standalone targets use resolveLatestUpgradeVersion(channel), and the resolved UpgradeSource is returned with { kind: "target", target: resolvedTarget, source }.
• 🟡 (11:59) In packages/cli/src/commands/cli/upgrade.ts, executeStandardUpgrade() now accepts and propagates optional source?: UpgradeSource; spawn retries use base delay constant SPAWN_RETRY_BASE_MS = 500.
• 🟡 (11:59) In packages/cli/src/lib/binary.ts, InstallationMethod is exactly "curl" | "brew" | "npm" | "pnpm" | "bun" | "yarn" | "unknown".
• 🟡 (11:59) packages/cli/src/lib/binary.ts defines platform asset naming as sentry-<os>-<arch>[-musl][.exe]: OS is darwin, windows, or linux; architecture is arm64 or x64; musl adds -musl; Windows adds .exe.
• 🟡 (11:59) packages/cli/src/lib/binary.ts adds source-specific GitHub release and repository-probe URLs, including https://api.github.com/repos/${source.githubRepo} and a latest-release query using ?per_page=100; source fallback iterates options.sources ?? UPGRADE_SOURCES, treats responses other than HTTP 404 as a selected source, and throws UpgradeSourceNotFoundError when all configured sources return HTTP 404.
• 🟡 (11:59) packages/cli/src/lib/binary.ts changes transport failure classification from generic UpgradeError("network_error", ...) to UpgradeTransportError; TLS failures use buildTlsErrorDetail(error), other connection failures report Failed to connect to ${serviceName}: ${msg}, and an aborted supplied signal rethrows init.signal.reason while ordinary AbortError remains rethrown as-is.