sillsdev / sillsdev/languageforge-lexbox

[claude] Make fw-headless sync commit the CRDT and its merge base atomically

Open
#2,512 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Data bug
Dominant language
C#
Stars
9
Forks
8
Avg merge
2d 13h
Merged PRs (30d)
49

Description

[Claude, autonomous]

Placeholder. The real write-up is on branch atomic-fw-headless-sync:

In one paragraph: a sync that dies part way through leaves the CRDT advanced and {project}_snapshot.json (the merge base) untouched. The next sync re-applies work already done, and its second pass — a plain state push with no authorship input — writes the leftovers into fwdata over the top of FieldWorks users' edits. The branch runs the CRDT side of a sync against a staged copy of the database and moves the staged database and its merge base into place as one journalled step, so an interrupted sync costs time and nothing else. The merge base also records which CRDT commit it was read from, so staleness becomes a checkable claim.

The branch is one commit for now; it is meant to be split before review.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

The issue is a placeholder; start by reading docs/sync-atomicity/README.md and docs/sync-atomicity/merge-plan.md on the atomic-fw-headless-sync branch. Use the invariant, failure matrix, and eight-PR merge plan to understand the intended work. Done means the branch's atomic staging and merge-base guarantees are split into reviewable changes.

Written by the indexing model from the issue text.

Assessment

Tech stack
csharp
Domain
backend, databases, distributed-systems
Issue type
Refactor
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.