Distillation

Date: September 10, 2026

• 🔴 (03:05) User-provided background version-check implementation is non-throwing: errors are caught and reported to Sentry; expected abort errors caused by process exit are not reported.
• 🔴 (03:05) User-provided update-notification design coordinates the human-only update banner with another notification path using once-per-process state so the two never double-emit.
• 🔴 (03:05) User-provided update-banner logic suppresses output for non-TTY stderr and returns null on errors; errors are caught and reported to Sentry.
• 🔴 (03:05) User-provided background version-check code tracks cancellation through pendingAbortController: AbortController | null and exports abortPendingVersionCheck().
• 🔴 (03:05) User-provided background version-check code includes maybePrefetchPatches() and calls prefetchNightlyPatches(latestVersion, signal, source) for nightly patch prefetching.
• 🔴 (03:05) In /home/byk/.local/share/opencode/worktree/0e8c2f3bbe145a3280d6fb6ed900a5121f382cf0/toolkit-bridge-upgrade/packages/cli/src/commands/cli/upgrade.ts, the command’s func() calls resolveContext(version, flags), then runs resolveTargetWithFallback() inside withProgress({ message: "Checking for updates...", json: flags.json }, ...).
• 🔴 (03:05) In upgrade.ts, when resolveTargetWithFallback() returns kind === "done", the command returns its result immediately; for an online action === "checked" result where currentVersion !== targetVersion, it first obtains result.changelog through startChangelogFetch() using channel, CLI_VERSION, result.targetVersion, offline: false, and resolved.source.
• 🔴 (03:05) In upgrade.ts, once a target is resolved, startChangelogFetch() begins before the upgrade so changelog retrieval runs in parallel with the download.
• 🔴 (03:05) In upgrade.ts, offline --check can produce kind: "target" from resolveTargetWithFallback(); if (flags.check) prevents an actual upgrade and returns buildCheckResultWithChangelog() instead.
• 🔴 (03:05) In upgrade.ts, the command returns action: "up-to-date" without upgrading when CLI_VERSION === target, unless flags.force is set or channelChanged is true.
• 🔴 (03:05) In upgrade.ts, downgrade detection uses isDowngrade(CLI_VERSION, target) and determines the final action as "downgraded" or "upgraded".
• 🔴 (03:05) In upgrade.ts, nightly upgrades are GitHub-only: when channel === "nightly" and method !== "curl", migrateToStandaloneForNightly() migrates the installation to a standalone binary and returns possible warnings.
• 🔴 (03:05) In upgrade.ts, all upgrades other than the non-curl nightly migration use executeStandardUpgrade() with method, channel, versionArg, target, this.process.execPath, this.process.argv?.[1], this.process.env.PATH, offline, flags.json, flags["no-agent-skills"], and source.
• 🔴 (03:05) In upgrade.ts, the final UpgradeResult includes action, currentVersion: CLI_VERSION, targetVersion: target, channel, method, forced: flags.force, conditional offline, possible migration warnings, and the awaited changelog.