Skip to content

Document edge-served 304 metadata contract - #6

Merged
AMBRA7592 merged 2 commits into
mainfrom
agent/document-304-edge-contract
Aug 4, 2026
Merged

AMBRA7592 merged 2 commits into
mainfrom
agent/document-304-edge-contract

Conversation

@AMBRA7592

@AMBRA7592 AMBRA7592 commented Aug 4, 2026 •

Copy link
Copy Markdown
Owner

Summary

  • distinguish origin-generated 200 metadata headers from edge-served 304 responses
  • make the non-immutable supersession index the authoritative status and successor-discovery surface
  • explain why the pre-coexistence production build returns 404 for an inactive v0.1.3 ID while the coexistence preview returns 200 with inactive status
  • tell release operators to assert only 304 status and an empty body
  • require a one-time cache-busting metadata probe to show x-vercel-cache: MISS, making origin delivery observable

Why

The pre-activation staging audit observed that Vercel can answer a conditional request from its edge cache with a compliant zero-byte 304 while omitting application-defined x-trialdiff-* metadata headers. The application still emits those headers at origin, but clients and release operators must not treat them as a conditional-revalidation contract.

Impact

Documentation only. No application code, migration, frozen package, manifest, implementation hash, database state, deployment, activation, or publication changes.

Verification

  • python3 -m unittest discover -s tests: 95 passed
  • alpha and v0.1.1/v0.1.2/v0.1.3 package validators: passed
  • root, calibration, and all event-class package manifests: verified
  • git diff --check: passed
  • runtime and frozen-package diff against main: empty

@AMBRA7592
AMBRA7592 marked this pull request as ready for review August 4, 2026 01:42
@AMBRA7592
AMBRA7592 merged commit 44ae562 into main Aug 4, 2026
3 checks passed
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