Summary
Make Trusted Server cache policies effective through each runtime's actual shared-cache mechanism and move platform-specific cache rendering behind the EdgeZero adapter boundary.
PR #860 emits typed browser and runtime-specific edge-cache headers. Cloudflare Workers Cache can consume the emitted Cloudflare-CDN-Cache-Control header when enabled, but Fastly synthetic/egress responses still need explicit cache integration. Core handlers also hand-thread a platform constant that belongs at the runtime boundary.
Scope
- Fastly:
- choose and implement Core Cache/Simple Cache for synthetic responses such as TSJS;
- apply appropriate backend cache overrides for proxied responses;
- verify TTL and privacy/bypass behavior.
- Cache keys:
- prove
/static/tsjs= shared-cache keys preserve the v query parameter;
- prevent versioned immutable and missing/mismatched short-TTL responses from colliding.
- EdgeZero/runtime abstraction:
- own platform edge-cache header names and
CachePolicy rendering at the adapter boundary;
- remove hand-threaded
EdgeCacheHeader constants from Trusted Server core signatures.
- Cloudflare:
- verify Workers Cache hit/bypass behavior;
- upgrade
compatibility_date separately with integration coverage.
Acceptance criteria
References
Summary
Make Trusted Server cache policies effective through each runtime's actual shared-cache mechanism and move platform-specific cache rendering behind the EdgeZero adapter boundary.
PR #860 emits typed browser and runtime-specific edge-cache headers. Cloudflare Workers Cache can consume the emitted
Cloudflare-CDN-Cache-Controlheader when enabled, but Fastly synthetic/egress responses still need explicit cache integration. Core handlers also hand-thread a platform constant that belongs at the runtime boundary.Scope
/static/tsjs=shared-cache keys preserve thevquery parameter;CachePolicyrendering at the adapter boundary;EdgeCacheHeaderconstants from Trusted Server core signatures.compatibility_dateseparately with integration coverage.Acceptance criteria
References
docs/superpowers/specs/2026-07-06-cache-control-header-design.mddocs/superpowers/plans/2026-07-06-cache-control-header-implementation-plan.md