Relationships
#4098 Docs: document clearDirty on the datastore sync service and the SWAMP_V3_RESTORE_PROBE_MS variable
Opened by stack72 · 10/28/2026
What changed
swamp-club#4091 and swamp-club#4092 shipped two things that the manual under content/manual/reference/ does not describe yet.
Pages to update
extensions/datastore-provider.md: the sync-service method table listsmarkDirty,hydrateFileandfetchContent. Add a row:|
clearDirty|(relPaths: readonly string[]) => Promise<void>| No | Drop the per-path marks whose keys equalrelPaths, made before the call. Called after swamp undoes a refused push's writes. |Add a short paragraph below the
markDirtysection: exact keys only, marks made during or after the call are kept, bulk and overflow flags stay, nothing remote is touched, and swamp treats the method's presence as the capability. Point to theclear-dirtyconformance case.datastore-configuration.md: documentSWAMP_V3_RESTORE_PROBE_MS, a positive integer of milliseconds (default 4000) that bounds each listing swamp makes of a v3 replica while a restore runs. Raise it for a replica whose first listing is always slow (a far region, a slow S3-compatible store, a cold bucket); otherwise every lagging read on that checkout fails withdatastore_v3_catch_up_unreachable.
Open
No activity in this phase yet.
system commented 10/28/2026, 11:53:34 PM
Classified automatically when this issue was filed.
- Source: Swamp Club
If you feel this classification is incorrect, add a ripple to tell us so.
Sign in to post a ripple.