Skip to content

Spec: the snapshot artifact - #42

Merged
Maximilian-Nesslauer merged 1 commit into
mainfrom
spec-snapshot
Aug 11, 2026
Merged

Spec: the snapshot artifact#42
Maximilian-Nesslauer merged 1 commit into
mainfrom
spec-snapshot

Conversation

@Maximilian-Nesslauer

Copy link
Copy Markdown
Member

The client contract, written down. spec/ was reserved and empty, so this is its first document.

RFC 0033 defines the snapshot as one merged JSON document and stops there, which leaves a client author inferring the fields from two RFCs.

Closes #39.

- the top-level shape, plus listings, packs, index status and the game release list
- the builder joins, filters and attaches, and copies every document verbatim, so this page never becomes a second copy of RFC 0031's field tables
- no wall-clock field, so an unchanged index keeps its ETag and the backstop rebuild costs clients nothing
- an unknown snapshot_version refuses the whole document, where an unknown spec_version renders one entry as unknown
@Maximilian-Nesslauer
Maximilian-Nesslauer requested a review from a team as a code owner August 10, 2026 12:23
@Maximilian-Nesslauer Maximilian-Nesslauer added this to the M2 Spec v0.1 milestone Aug 10, 2026
@Maximilian-Nesslauer Maximilian-Nesslauer added area:index index hosting, distribution, mirrors area:client the manager application itself labels Aug 10, 2026
@Maximilian-Nesslauer
Maximilian-Nesslauer merged commit 4bc80c9 into main Aug 11, 2026
6 checks passed
@Maximilian-Nesslauer
Maximilian-Nesslauer deleted the spec-snapshot branch August 11, 2026 09:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:client the manager application itself area:index index hosting, distribution, mirrors

Projects

Status: Inbox

Development

Successfully merging this pull request may close these issues.

Spec: the snapshot artifact schema

2 participants