feat(remote-cache): add self-hosted public cache server

[fengmk2]

Add packages/remote-cache for the server in #716, using Cloudflare Workers, primary D1 metadata, and a private R2 bucket. The server supports public reads and GitHub Actions OpenID Connect checks for writes. Stores use streaming uploads, atomic publication, storage limits, and automatic data expiry.

One workflow deploys related changes to a persistent staging Worker, D1 database, and R2 bucket. Internal PRs, main pushes, and manual runs share these resources. The workflow runs deployments and smoke tests in sequence, then updates PR comments with the tested revision and manual instructions. Each deployment replaces the previous revision. Closing a PR keeps staging available. Setup uses repository secrets and variables. Repository maintainers can configure staging without a GitHub environment.

The e2e plan defines automated checks and manual exercises. PR runs check public reads and rejected writes. Pushes to main also check authorized uploads, multipart storage, replacement, concurrency, and quotas. Local tests repeat smoke checks against reused storage and retain maximum-payload and scheduled-handler coverage. Real Cron execution and maximum payloads on Cloudflare require separate release exercises.

/fetch returns only { kind: "fallback", key } for fallback matches and does not read R2. Exact matches return the value and blob_id. A missing or unreadable exact value returns 503. Fetch misses and unavailable blobs return plain-text 404, as specified in the local RFC.

Setup rejects incompatible origins and repositories before it changes existing policies or saved configuration. Each Worker has separate rate-limit counters that remain stable across revisions. Workers Free CPU support remains unverified. The guide recommends Workers Paid for the full payload limits.

Motivation

Maintainers need a cache service in their own Cloudflare account. Developers and fork contributors must reuse public task results without login. Only trusted jobs on main should publish those results. Reviewers need one persistent staging environment and a clear verification result after each related change.

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​esbuild@​0.28.1
	npm/​tsx@​4.23.13
	npm/​jsonc-parser@​3.3.1
	npm/​wrangler@​4.131.1
	npm/​jose@​6.2.12
	npm/​cborg@​6.1.2
	npm/​@​cloudflare/​workers-types@​5.20260911.1
	npm/​miniflare@​5.20260911.0-alpha

View full report

[github-actions]

fspy benchmark

linux

dynamic/launch             change  +0.07%  [ -8.97% ..  +8.57%]  overhead  +264.05%
dynamic/access             change  +0.02%  [ -1.08% ..  +1.26%]  overhead   +15.12%
dynamic/access-relative    change  +0.01%  [ -0.89% ..  +1.00%]  overhead   +60.60%
dynamic/access-contended   change  -0.15%  [ -1.23% ..  +1.99%]  overhead   +13.66%
static/launch              change  +0.67%  [ -5.51% ..  +6.65%]  overhead  +729.40%
static/access              change  +0.08%  [ -0.88% ..  +1.42%]  overhead  +807.35%
static/access-relative     change  +0.21%  [ -0.79% ..  +1.44%]  overhead +1396.86%
static/access-contended    change  +0.03%  [ -0.71% ..  +0.64%]  overhead +3157.85%

macos

dynamic/launch             change  -0.34%  [ -2.98% ..  +3.05%]  overhead  +213.39%
dynamic/access             change  -0.78%  [ -3.50% ..  +2.41%]  overhead    +6.35%
dynamic/access-relative    change  +0.10%  [ -1.96% ..  +1.95%]  overhead  +262.54%
dynamic/access-contended   change  +1.26%  [ -3.03% ..  +5.95%]  overhead    +2.86%

windows

dynamic/launch             change  -0.06%  [ -8.88% .. +10.39%]  overhead   +22.04%
dynamic/access             change  +0.37%  [ -4.17% ..  +9.20%]  overhead    +1.70%
dynamic/access-relative    change  +0.18%  [ -2.63% ..  +3.81%]  overhead    +1.85%
dynamic/access-contended   change  -0.53%  [-11.13% .. +21.27%]  overhead    +1.07%

[github-actions]

Remote cache staging

Commit: b30dcd5b6d1943459a16d20bcbdc1d3a28d9a627

Cloudflare staging deployment and smoke tests passed. You can now perform manual verification.

Endpoint: https://vp-cache-ci-staging.voidzero-docs.workers.dev/projects/manual

Download the remote-cache-e2e-37270179886-1 artifact from the workflow run. It contains manual-fetch.cbor, manual-manifest.json, and report.json.

PR checks cover public reads and rejected writes. Main-branch push checks also cover authorized HTTP stores. This staging endpoint is shared by all PRs and main. A later deployment replaces its code and manual fixture. Compare the deployment ID in the response with the artifact before manual verification. Closing this PR does not remove staging.

Manual checks and complete e2e plan.

[fengmk2]

Deploy prompt:

Refer to the deployment instructions at https://github.com/voidzero-dev/vite-task/blob/feat/public-remote-cache/packages/remote-cache/docs/self-hosting.md to deploy a remote cache service for the current repo.