Skip to content

feat: allow atomic, opt-in game provisioning holds #43

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
Seagulls wants to merge 7 commits into
base: main
Choose a base branch
from
+1,985 −49
Draft

feat: allow atomic, opt-in game provisioning holds #43

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
4b50182
store: persist a per-game provisioning hold
Oct 8, 2026
e840f37
sync: keep a held game out of every transfer path
Oct 8, 2026
3b760e2
test: prove a held game survives restart and one-sided release
Oct 8, 2026
1508845
sync: fail closed when a provisioning hold cannot be read
Oct 9, 2026
af05e65
api: stage a hold release without turning AutoSync on
Oct 9, 2026
eb60926
test: make provisioning safety contracts clear and upstream-neutral
Oct 9, 2026
2fee76f
test: give the 100-game fixture a real agreed base
Oct 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,23 @@
All notable changes to OpenSave are documented here. This project adheres to
[Semantic Versioning](https://semver.org/).

## [Unreleased]

### Added

- **A game can be tracked or placed without syncing until it is released.**
`provisioningHold: true` (or `autoSync: false`) on `POST /api/games` and
`POST /api/offered-games/{id}/place` records the game and a hold in one
step. The hold survives a daemon restart and is not the ordinary AutoSync
flag: peers cannot pull or push that game's saves, and releasing one game
does not sync the rest of the library. `POST /api/games/{id}/release-provisioning`
clears the hold. An empty body turns AutoSync on, so reconcile can sync
that game with every online peer that is not still held. `{"autoSync": false}`
clears the hold and leaves AutoSync off, so reconcile, reconnect and the
watcher do not sync it; the caller syncs explicitly. A PATCH cannot clear
the hold. `provisioningHoldUnknown` is true when the hold cannot be read,
and `provisioningHold` is not reported false in that case. See issue #40.

## [2.4.1] — 2026-10-02

A security update: please install it on every device. A paired device could
Expand Down
Loading