Logseq DB Sync over Cloudflare

Logseq is an open-source outliner whose newer DB graphs keep pages and blocks in a DataScript database (an in-memory triple store). It is replacing RTC sync with db-sync: the server keeps an authoritative, append-only transaction log per graph and does no merging. Each client uploads DataScript transactions, applies others' changes and rebases pending work. Rebasing local edits over remote ones can create parent cycles, orphan blocks under a remotely deleted page, collide sibling orders or loop a class hierarchy, and every client must still converge, including after long offline sessions.

The agent writes the sync engine in the DB worker behind a pinned set of functions: record every local transaction as a pending change, build an upload batch, drop accepted changes, and apply pulled remote data while rebasing pending work. The server protocol is fixed: a batch is accepted only against the latest log position, and pulls return transactions in log order. Rebasing replays local changes after remote ones, with the local value winning on the same attribute. A change that would break an invariant yields while the rest apply. Deletes cover whole subtrees. DB validation, parent and page consistency, acyclic hierarchies and distinct sibling orders hold after every step.

The offline sandbox (4 CPUs, 8 GB, 4 hours) holds a full-history Logseq checkout with Node 22, Java 17, the Clojure CLI and every dependency installed. Worked examples include a small in-process server. The multi-client harness and its seeds are held out.

The committed HEAD is rebuilt from a clean checkout in a separate environment. A hidden harness drives two or three clients against a protocol-conforming server over 23 families of 12 seeded scenarios each: targeted conflicts, online and offline sessions, and randomized mixes of concurrent edits, moves, deletes and deep trees. Invariants are checked after every step, then convergence and rebase-rule outcomes. Seven targeted families must pass every scenario and the other 16 at least 90%, and the main ClojureScript suite and three library suites must still pass.