Skip to content

feat(release-mirror): publish complete Stable and Beta update feeds - #77

Merged
yaacovcorcos merged 6 commits into
mainfrom
claude/mirror-update-feed-20261116
Nov 17, 2026
Merged

yaacovcorcos merged 6 commits into
mainfrom
claude/mirror-update-feed-20261116

Conversation

@yaacovcorcos

@yaacovcorcos yaacovcorcos commented Nov 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Extend the existing release-mirror worker (the single publisher) to copy complete Stable and Beta electron-updater feeds into immutable release directories before promoting per-platform channel manifests. Payloads and manifests are checked against the release handoff; updater payloads additionally match their manifest SHA-512. Relative URLs keep requests on Scient's mirror, preserve previous-version blockmap paths, and include release notes.

The separate desktop feed-default switch MUST NOT land before this worker is deployed, feeds are populated, and live verification succeeds. No production deployment is requested in this PR.

Documentation and source-version impact

Documentation impact: Updated — README.md deployment/cache/verification runbook; docs/architecture/desktop-downloads.md architecture. No app-help source/version change.

Validation

  • bun run check
  • Desktop and relevant mobile preview evidence recorded, with limitations stated
  • Product owner authorized merge/auto-merge, or requested manual preview review completed

Candidate efeae95. macOS arm64 local bun run check: format, Astro/functions/events/mirror typechecks, generated-worker types, tests (211 passed, 2 skipped), static build and edge build passed. One existing deprecated navigator.platform hint. Five regression cases fail on the pre-fix implementation (existing-object digest mismatch, missing ZIP, missing blockmap, Stable/Beta rollback) and pass after the fix. Extra arm64 Linux/deb feed coverage added.

Live C1 cache rules applied (ruleset 8356b52a036146aca8769c7e516967ec): download host only; immutable /scient-desktop/v* respects origin TTLs; HTTP 300–599 never stored; channel metadata/stable.json bypassed. A full v0.6.29 arm64 DMG request returned HIT and matched SHA-256 c0f90ee1513e9c7d2282dd6851523f259935c68f9649926040d55c6abf430851; range 0–99 returned 206, 100 bytes, HIT. Moving stable.json remains no-store; repeated missing EXE requests are 404/DYNAMIC, never HIT. Worker/feed deployment is not performed: new updater metadata currently returns 404/DYNAMIC.

Backend worker change, no new rendered UI; no human preview or native installed-app update was exercised. Signed macOS/Windows application, Linux installation, and real Worker streaming/R2 publication remain unqualified.

Quality Review

Codex's first pass confirmed three publication-guard defects: reused assets skipped SHA-512 checks; CAS did not reject a sequential stale source; manifest presence did not guarantee required payloads/blockmaps. All fixed in efeae95 with regression negative controls. Fresh Codex re-check: PASS at efeae95; all three findings closed, no new confirmed regressions. Reviewer independently passed 32 worker tests and mirror typecheck. Existing immutable-write/pointer-last implementation reused, no second publisher.

Integration Readiness Review

Source review passed at efeae95; local bun run check passed at that head. Ready for maintainer review, not merged or deployed. Real Worker/R2 publication and native update qualification are still outstanding. No claim of signed macOS/Windows apply or Linux installation. The desktop client default switch remains draft until deployment verification. No automatic merge enabled.

Deployment impact

Pages deployment does not deploy the mirror worker. After merge, an explicitly authorized operator deploys the worker from main, verifies Paid-plan limits, populates both channels, confirms cache/Range and SHA-512/size/noCache checks against the newly mirrored files, then qualifies the desktop switch #967. The narrow C1 cache policy above is already active independently; no worker or desktop feed change deployed. Old release objects remain immutable and retained.

Model/harness attribution: implementation from previous Claude session; independent review by Codex GPT-6.1 Sol; integration/verification through Scient.

… feeds

The release mirror worker now copies each channel's whole electron-updater set
(channel manifests, macOS ZIPs and DMGs, NSIS EXE, AppImage, blockmaps) from the
desktop GitHub releases into the immutable scient-desktop/<tag>/ directories and
then promotes generic feeds at scient-desktop/updates/{stable,beta}/.

- Every manifest must match the release handoff's size and SHA-256; every file it
  names must be a bare name the handoff lists with the same size, and must hash to
  the manifest's SHA-512 while streaming (the last chunk is held back until it does).
- Channel manifests are written last, each as a compare-and-swap on the version
  seen before asking GitHub, so a feed never names missing bytes and a slow run
  cannot undo a newer promotion. Old objects are kept; nothing is redirected.
- The feed copy only re-points file URLs to ../../<tag>/<name> (resolved by
  electron-updater against the feed) and adds releaseName/releaseNotes from the
  release's Atom entry, as GitHub's provider showed them. Digests are untouched.
- Beta is discovered from the beta repository's releases feed, by version.
- C1: versioned objects stay one-year immutable; feed manifests are no-store.
- The mirror worker remains the only publisher; README has the deploy/verify runbook.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Deploying scientfactory-website with  Cloudflare Pages  Cloudflare Pages

Latest commit: 92c7512
Status: ✅  Deploy successful!
Preview URL: https://4d3be10d.scientfactory-website.pages.dev
Branch Preview URL: https://claude-mirror-update-feed-20.scientfactory-website.pages.dev

View logs

@yaacovcorcos
yaacovcorcos marked this pull request as ready for review November 16, 2026 20:42
@yaacovcorcos
yaacovcorcos merged commit cb0fc6e into main Nov 17, 2026
2 checks passed
@yaacovcorcos
yaacovcorcos deleted the claude/mirror-update-feed-20261116 branch November 17, 2026 07:14
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.

1 participant