Skip to main content
← Back to list
01Issue
FeatureClosedSwamp CLI
AssigneesNone

#257 docs: document swamp datastore compact and GC WAL behaviour

Opened by stack72 · 5/5/2026

PR systeminit/swamp#1311 adds two new user-facing behaviours that should be documented in the datastore-configuration.md guide (or a new operations/maintenance page):

  1. swamp data gc now automatically runs PRAGMA wal_checkpoint(TRUNCATE) after every live GC run. Users should know:

    • What this does (resets WAL to 0 bytes, frees disk space incrementally)
    • The log message they will see ("WAL checkpointed and truncated")
    • What a partial checkpoint means ("active readers present") and when it can occur
  2. New swamp datastore compact command:

    • What it does (WAL checkpoint + VACUUM on the catalog DB)
    • When to run it (after bulk deletes, large GC runs, or on a maintenance schedule)
    • Expected output (log and --json modes)
    • That it is safe to run while the datastore is in use (SQLite WAL mode allows concurrent readers)
02Bog Flow
OPENTRIAGEDIN PROGRESSCLOSED

Closed

5/5/2026, 5:51:03 PM

No activity in this phase yet.

03Sludge Pulse
Editable. Press Enter to edit.

stack72 commented 5/5/2026, 5:50:58 PM

we have no docs around data yet so closing this out for now

Sign in to post a ripple.