Skip to content

fix(updater): pin stable fallback before downloading - #34076

Merged
OrcaWin merged 5 commits into
mainfrom
OrcaWin/bug-update-url-seems-wrong
Oct 26, 2026
Merged

OrcaWin merged 5 commits into
mainfrom
OrcaWin/bug-update-url-seems-wrong

Conversation

@OrcaWin

@OrcaWin OrcaWin commented Oct 26, 2026 •

Copy link
Copy Markdown
Collaborator

ELI5

Orca can remember one release's ZIP filename and later follow “latest” into a newer release where that file does not exist. Resolve “latest” once, then keep the manifest and download on that concrete release.

What Changed

  • Replace the default-channel moving-feed fallback with a validated stable tag resolved from GitHub's /releases/latest redirect.
  • Reuse the existing Electron net.request HEAD handling and platform manifest/asset readiness probes. net.fetch cancels manual redirects in real Electron, so it is not used for redirect discovery.
  • Return a retryable check failure when a ready concrete fallback cannot be resolved, and reject fallback results belonging to an expired check.
  • Update existing feed expectations and installer fixtures; cover stable fallback, Atom outages, unavailable fallback, late completions, redirect validation, and platform manifest selection.

Why

The normal path already pins a tag, but Atom outages and no-newer results still installed a /releases/latest/download provider. That provider retains relative filenames while GitHub's redirect can move between checking and downloading. Correct release manifests alone cannot prevent the mismatch.

Credit to @brennanb2025 for the original tag-pinning fix in #1797, and @nwparker for the attempt-ownership guard in #23160, which this change extends across the fallback lookup. Also reviewed @sechan-netizen's #30952 and its review thread: its release-manifest validation is a complementary safeguard because this race reproduces with correct manifests. No commits from that PR are copied here. That related proposal is now closed during cleanup, with an invitation to reopen for a concrete remaining manifest-integrity case.

This PR adopts @brennanb2025's audited #34075 lint fix (splitting three files that already exceeded main's line limits), with Brennan retained as a co-author. Independent byte-level audits preserve the moved runtime bodies and test groups; the follow-up replaces five test-only assertions with typed calls and emits identical JavaScript. The standalone PR is now closed as adopted; its earlier tree had repeated daemon-test CI/order sensitivity, while the combined tree here passed all CI, including that exact daemon test file (16 tests) in run 40398604134, job 121839803430.

Linked Issue

Fixes #34034

Related reports #15921 and #22621 are also closed. All three reports have a fix link and a request to reopen if the failure recurs after updating to a release/build containing the fix. The controlled race matches their URL signature and retry behavior; the reporter's original feed selection cannot be established without its logs.

Visual Proof

N/A — updater feed selection only; no presentation change. Verified the HTTP behavior using the production fallback resolver and electron-updater 6.8.10 with unmodified v1.4.240/v1.4.241 manifests and a controlled local release server:

Scenario Result
Old moving provider: read 240 manifest, advance latest to 241, download v1.4.241/Orca-1.4.240-arm64-mac.zip: 404
Retry the old download without a new check Same 404
Fresh check Correct 241 ZIP: 200
Fixed fallback: resolve 240 tag, advance latest to 241, download Correct 240 ZIP under tag 240: 200

No installer was executed and no app window was opened.

Testing

  • I manually tested these changes locally
  • Automated tests added/updated

ORCA_BACKGROUND_LAUNCH=1 pnpm check:changed --maxWorkers=2: all 26 checks pass on the combined branch, including formatting, lint, typechecks, affected tests, and ratchets. The earlier updater-only run also passed all 20 selected checks.

The controller regression run against the original implementation produces five failures with passing controls. The fixed implementation passes. Resolver tests exercise macOS arm64, Windows x64, Linux x64/arm64 manifest selection, invalid redirects, missing assets, and recovery after network failure; these platform variants use mocked transport.

A separate background Electron 43.8.1 smoke on macOS arm64 uses the production resolver and real Electron networking against GitHub, resolving the ready v1.4.241 tag. The controlled before/after reproduction also exercises the production resolver and actual GenericProvider. Neither proof exercises native installation.

All non-skipped GitHub CI checks pass for combined head c04a6ca95604e064fb4f91adb1a57ea3dcf9adf0: all five full unit shards, relay integration, Linux/Windows package checks, macOS updater regression tests, static analysis/typechecks, and the required aggregate check. Final independent review recommends merging that exact head as low risk with no code blockers.

AI Disclosure

Review

Independent sub-agent review found no actionable issues and rated the updater change low risk; 57 relevant tests passed independently. The prerequisite received two independent refactor audits, with identical moved runtime/test bodies and a merge-preservation gate reporting zero unexplained deletions and zero unrelated files. The five typed mock changes produce identical JavaScript. Also self-reviewed the feed-selection paths, timeout ownership, transport cleanup, and release-channel filtering. The added lookup runs only on the existing fallback path, uses HEAD for redirect discovery, retains five-second request deadlines, and reuses manifest/asset probes. No new polling, subprocess, persistent cache, or per-workspace work is introduced. Native Windows/Linux networking and installer execution were not exercised locally.

Review disposition for the DMG-only manifest comment: an independent executable comparison of the original and fixed implementations returned the same ready Atom result for a DMG-only manifest; the old fallback already handed that manifest directly to MacUpdater, which cannot select its required ZIP. This is an existing release-integrity limitation, not introduced or worsened by tag pinning. It remains outside this race fix; a complete integrity change must validate the native files list and architecture selection rather than merely finding any ZIP-like name.

Agent skill upstream boundary

  • Not applicable; no upstream skill source or fixtures copied.

Notes

Desktop updater implementation is shared with headless serve. No IPC/RPC contract, remote version requirement, mobile client code, filesystem path, or workspace-kind assumption changes. Existing RC/perf selection remains in place. If fallback discovery also fails, checks use the existing retry/error flow instead of launching a moving feed.

Checklist

  • This PR is focused on consistent release selection
  • Problem, behavior, and mechanism explained
  • Visual proof N/A with network verification recorded
  • Self-reviewed for correctness, security, and performance
  • Cross-platform, remote, mobile, and folder-workspace impact considered
  • Required changed-code checks pass

@coderabbitai

coderabbitai Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 6041bd2c-aa98-4c0e-a4f8-0a93c4f304b0
Commits

Reviewing files that changed from the base of the PR and between a3b5c65 and c04a6ca.

Files selected for processing: 6
  • src/main/ipc/worktrees-create-label-only-first-work.test.ts
  • src/main/ipc/worktrees-create-metadata-persistence.test.ts
  • src/main/runtime/runtime-local-worktree-create-pr-conflicts.test.ts
  • src/main/runtime/runtime-local-worktree-create.test.ts
  • src/renderer/src/components/native-chat/StructuredChatPaneMenuItems.tsx
  • src/renderer/src/components/native-chat/use-native-chat-context-menu.tsx
Files with no reviewable changes: 2
  • src/main/ipc/worktrees-create-metadata-persistence.test.ts
  • src/main/runtime/runtime-local-worktree-create.test.ts

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 5 remain after this review.

Walkthrough

The updater now resolves and validates a stable release tag before using a fallback feed URL. It checks platform manifest readiness and uses a tag-specific download URL. The changes also add updater fallback tests, reorganize worktree creation tests, and extract the structured chat pane menu into a separate component.

Priority: Normal

Severity of issue fixed: Medium

Merge Risk: Minimal · up to c04a6

No actionable merge blocker is established; complete the pending combined checks and CI before merging.

Pre-merge checks: Passed 3 · Failed 2

Failed Failed checks: 2 warnings

Check name Status Explanation Resolution
Out of Scope Changes check Warning The updater implementation, fixtures, and updater tests support [#34034]. The PR also adds unrelated worktree behavior tests in src/main/ipc/worktrees-create-label-only-first-work.test.ts and `src/m… Remove the unrelated worktree and native-chat changes from this PR, or move them to a separate PR. Keep the updater implementation, updater tests, and updater fixtures.
Docstring Coverage Warning Docstring coverage is 7.69% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 13 functions across 15 files. Write docstrings for the functions missing them to satisfy the coverage threshold.
Passed Passed checks: 3 passed
Check name Status Explanation
Title check Passed The title clearly identifies the primary change: pinning the updater’s stable fallback to a concrete release before downloading.
Linked Issues check Passed Issue [#34034] reports a mismatch between the release tag and installer filename. UpdaterReleaseFeed.pinDefaultReleaseFeed resolves fetchLatestStableReleaseTag() before the fallback feed and then …
Description check Passed The pull request description is complete and follows the repository template. It includes the user impact, implementation details, rationale, linked issue, visual-proof explanation, testing evidence, …
Full details: Linked Issues check

Explanation

Issue [#34034] reports a mismatch between the release tag and installer filename. UpdaterReleaseFeed.pinDefaultReleaseFeed resolves fetchLatestStableReleaseTag() before the fallback feed and then uses getReleaseDownloadUrl(stableTag). fetchLatestStableReleaseTag validates the GitHub release redirect and checks the platform manifest and assets. The updater tests cover stable fallback, unavailable fallback, and expired checks.

Full details: Description check

Explanation

The pull request description is complete and follows the repository template. It includes the user impact, implementation details, rationale, linked issue, visual-proof explanation, testing evidence, review notes, scope considerations, and checklist status. The AI Disclosure section is empty, which is acceptable for an internal contributor and does not affect the completeness of the description.

Full details: Out of Scope Changes check

Explanation

The updater implementation, fixtures, and updater tests support [#34034]. The PR also adds unrelated worktree behavior tests in src/main/ipc/worktrees-create-label-only-first-work.test.ts and src/main/runtime/runtime-local-worktree-create-pr-conflicts.test.ts, removes src/main/ipc/worktrees-create-metadata-persistence.test.ts and src/main/runtime/runtime-local-worktree-create.test.ts, and adds the unrelated StructuredChatPaneMenuItems renderer component. These changes do not support updater release selection or download consistency.

Resolution

Remove the unrelated worktree and native-chat changes from this PR, or move them to a separate PR. Keep the updater implementation, updater tests, and updater fixtures.

Finishing Touches: 💡 1
📝 Generate docstrings: 💡
  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1


Review info
Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Repository UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: ff0f6a1a-d11b-48a2-a400-230776b5f7cb
Commits

Reviewing files that changed from the base of the PR and between 1df8501 and a3b5c65.

Files selected for processing: 11
  • src/main/updater-latest-stable-feed.test.ts
  • src/main/updater-net-request.fixture.ts
  • src/main/updater-prerelease-feed.ts
  • src/main/updater-test-harness.ts
  • src/main/updater.build-channel-selection.test.ts
  • src/main/updater.check-failure.test.ts
  • src/main/updater.feed-attempt-lifetime.test.ts
  • src/main/updater.install-failure-cause.test.ts
  • src/main/updater.mac-install.test.ts
  • src/main/updater.publishing-window-feed.test.ts
  • src/main/updater/updater-release-feed.ts

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 4 remain after this review.

Comment thread src/main/updater-prerelease-feed.ts Resolved
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Bug]: Update URL seems wrong

2 participants