Distillation

Date: September 10, 2026

• 🟡 (05:09) Tool output showed packages/cli/src/lib/upgrade.ts detects how the CLI was installed and provides self-upgrade functionality; shared binary-management helpers for download URLs, locking, and replacement live in binary.ts and are also used by the setup --install flow.
• 🟡 (05:09) Tool output showed packages/cli/src/lib/upgrade.ts imports binary helpers including acquireLock, getBinaryFilename, getPlatformBinaryName, and releaseLock; filesystem operations include chmodSync, closeSync, existsSync, and openSync.
• 🟡 (05:09) Tool output showed PackageManager is defined exactly as "npm" | "pnpm" | "bun" | "yarn" in packages/cli/src/lib/upgrade.ts.
• 🟡 (05:09) Tool output showed upgrade progress uses makeByteProgress and the SetMessage type from ./progress.js.
• 🟡 (05:09) Tool output showed standalone release parsing validates response shape based on source.tagPrefix: prefixed sources require an array, while sources without a tag prefix require a non-array response; mismatches are rejected.
• 🟡 (05:09) Tool output showed standalone release selection normalizes response data to an array, excludes releases where draft or prerelease is true, and strips source.tagPrefix from matching tags.
• 🟡 (05:09) Tool output identified a rolling nightly GitHub release tag used only as a stable fallback.