Distillation

Date: Sep 9, 2026

• 🔴 (12:26) User directed work in /home/byk/.local/share/opencode/worktree/0e8c2f3bbe145a3280d6fb6ed900a5121f382cf0/toolkit-bridge-upgrade for getsentry/cli#1244.
• 🔴 [enforced-scope] (12:26) User required implementation ONLY in packages/cli/src/lib/version-check.ts, packages/cli/src/lib/release-notes.ts, and their existing tests.
• 🔴 (12:26) User explicitly instructed to write code.
• 🔴 (12:26) User requires one explicitly selected UpgradeSource to be threaded through stable/nightly background version discovery, patch prefetch, and source-sensitive release-note/changelog lookups; Toolkit and legacy must never mix.
• 🔴 (12:26) User requires integration with source-aware helper APIs from binary.ts, upgrade.ts, and delta-upgrade.ts where possible.
• 🔴 (12:26) User stated upgrade.ts is being changed concurrently; inspect its signatures before final edits and do not modify it.
• 🔴 (12:26) User stated defaults may preserve direct API compatibility.
• 🔴 (12:26) User stated Toolkit stable tags use the cli@ prefix, while legacy tags are unprefixed.
• 🔴 (12:26) User requires source-selection fallthrough only on HTTP 404 during selection, never independently in later stages.
• 🔴 (12:26) User requires background version checking and changelog behavior to remain best-effort and non-throwing.
• 🔴 [requested-tests] (12:26) User requested deterministic focused tests proving exact source affinity and, where applicable, no legacy access after primary-source success.
• 🔴 [enforced-scope] (12:26) User prohibited edits to binary.ts, ghcr.ts, upgrade.ts, delta-upgrade.ts, command files, the installer, and unrelated files.
• 🔴 [requested-tests] (12:26) User requested focused tests be run after implementation.
• 🔴 (12:26) User requested a report of changed files and test results.