Distillation

Date: September 9, 2026

• 🔴 (12:25) User directed work in /home/byk/.local/share/opencode/worktree/0e8c2f3bbe145a3280d6fb6ed900a5121f382cf0/toolkit-bridge-upgrade on getsentry/cli#1244.
• 🔴 [enforced-scope] (12:25) User required implementation ONLY in packages/cli/src/lib/delta-upgrade.ts and packages/cli/test/lib/delta-upgrade.test.ts (or its exact existing corresponding test file).
• 🔴 (12:25) User explicitly requested writing code.
• 🔴 (12:25) User required threading an explicit UpgradeSource through stable and nightly delta source construction, attemptDeltaUpgrade, and stable/nightly prefetch.
• 🔴 (12:25) User stated a selected upgrade operation never mixes getsentry/toolkit and getsentry/cli.
• 🔴 (12:25) User required GitHub release APIs to use source.githubRepo and GHCR operations to use source.ghcrRepo.
• 🔴 (12:25) User allowed defaults to remain PRIMARY_UPGRADE_SOURCE for direct helper compatibility, while requiring production callers to be able to pass an explicit source.
• 🔴 (12:25) User required preserving binpatch semantics, patch metadata (sha256-<binary>, from-version), chain limits, telemetry, in-memory patching, and fallback behavior.
• 🔴 [requested-tests] (12:25) User requested focused deterministic tests proving exact repository URLs/repository arguments and source affinity, including the legacy source.
• 🔴 [enforced-scope] (12:25) User prohibited edits to upgrade.ts, command files, binary.ts, ghcr.ts, version-check.ts, release-notes.ts, the installer, and unrelated files.
• 🔴 [requested-tests] (12:25) User required running focused tests and reporting changed files plus exact test results.
• 🟡 (12:26) Repository root contains .craft.yml, .git, .github/, .gitignore, .lore.md, .nojekyll, .npmrc, AGENTS.md, apps/, CHANGELOG.md, codemods/, LICENSE.md, node_modules/, package.json, packages/, pnpm-lock.yaml, pnpm-workspace.yaml, and README.md.
• 🔴 (12:26) Repository guidance in AGENTS.md defines the pipeline as triage → explore → plan → implement → review → ship; worker is a deprecated alias of implement.
• 🔴 (12:26) Repository guidance states long-term project knowledge for the Outpost repository lives in .lore.md when present, and target repositories’ AGENTS.md / CONTRIBUTING.md should be read first.
• 🔴 (12:26) User directive from AGENTS.md: Always load repo-setup before situation skills.
• 🟡 (12:26) Existing delta-upgrade test files found: packages/cli/test/lib/delta-upgrade.test.ts, packages/cli/test/lib/delta-upgrade.mocked.test.ts, and packages/cli/test/e2e/delta-upgrade.test.ts.