Distillation

Date: Sep 10, 2026

• 🟡 (04:40) At commit cea7b2afba91f11f1cdbb1785ea97ba61159520c, packages/cli/src/commands/cli/upgrade.ts:10 documents the nightly channel as tracking the rolling nightly prerelease built from main.
• 🟡 (04:40) packages/cli/src/lib/upgrade.ts:24 imports prerelease as semverPrerelease and valid as semverValid from semver.
• 🟡 (04:40) Stable GitHub release selection in packages/cli/src/lib/upgrade.ts:134 filters out releases where draft or prerelease is true; release metadata around line 511 supports { tag_name?: string; draft?: boolean; prerelease?: boolean }.
• 🟡 (04:40) Invalid stable-version metadata from an upgrade source produces the error ${source} returned an invalid stable version in packages/cli/src/lib/upgrade.ts:593.
• 🟡 (04:40) A comment in packages/cli/src/lib/upgrade.ts:1200 explains that the URL points to prerelease assets regardless of the version string.
• 🟡 (04:40) packages/cli/test/lib/upgrade.test.ts covers valid-method parsing; malformed GitHub release pagination classified as network_error; DNS/timeout-style failures represented by TypeError("fetch failed"); and a surfaced error message of Upgrade command failed.
• 🟡 (04:40) packages/cli/test/lib/upgrade.test.ts:201 includes a release fixture { tag_name: "cli@99.0.0-dev.1", prerelease: false }, exercising stable-version validation independently of the GitHub prerelease flag.
• 🟡 (04:40) Stable-version rejection fixtures in packages/cli/test/lib/upgrade.test.ts include not-semver, 1.2.3-beta.1, and 1.2.3-rc.1; invalid npm metadata is expected to throw npm registry returned an invalid stable version.
• 🟡 (04:40) versionExists() tests in packages/cli/test/lib/upgrade.test.ts:765+ reject prerelease pins such as 1.2.3-beta.1 before network access, with error Requested package version returned an invalid stable version.
• 🟡 (04:40) Upgrade-library tests cover rejecting empty successful metadata from an explicit source and track requested URLs with const requests: string[] = [];.
• 🟡 (04:40) Upgrade-library tests assert that the yarn method uses npm.
• 🟡 (04:40) Nightly-version discovery now reads a GHCR manifest annotation rather than version.json; associated mocks handle ghcr.io/token.
• 🟡 (04:40) packages/cli/test/commands/cli/upgrade.test.ts:1303 tests that a pinned stable version with Homebrew is rejected before network access.
• 🟡 (04:40) packages/cli/test/lib/upgrade.test.ts:1950 asserts isNightlyVersion("2.0.0-beta.1") is false.