GameCult/CultLib
Watch
9
0
Fork
You've already forked CultLib
 0
Code Issues Pull requests 1 Projects Releases Packages Wiki Activity Actions

Record variant fork 1: stable element ids everywhere
Some checks failed
CultMesh portability and performance / ubuntu-latest one-command multiplayer onboarding (push) Has been cancelled
Details
CultMesh portability and performance / windows-latest one-command multiplayer onboarding (push) Has been cancelled
Details
CultMesh portability and performance / ubuntu-latest reactive semantics and leases (push) Has been cancelled
Details
CultMesh portability and performance / windows-latest reactive semantics and leases (push) Has been cancelled
Details

Browse source 
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Meta Vens 2026-09-17 13:02:11 +02:00
commit 979fa42fb2
1 changed files with 14 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/document-variants-target.md
View file

@ -74,9 +74,20 @@ edited in CultCache Studio:
## Fork rulings (operator, 2026-09-17) ## Fork rulings (operator, 2026-09-17)
- **1, granularity: agreed.** Index addressing into lists is out, and addressing reuses - **1, granularity: stable element identity, ids everywhere** (operator, 2026-09-17: "ids
CultNet's member-path grammar. The Imagination pass still chooses between stable element everywhere").
identity and whole-element replacement, and that choice comes back as a fork. - Every object element in a list carries a stable id, minted when the element is created.
This is the approach of sequence CRDTs (RGA, YATA/Yjs, Automerge, Fugue).
- Matching algorithms (Myers, diff3, GumTree) are heuristics. They fail on look-alike
elements such as two `EnergyDraw` behaviors, which is why identity is minted, not
inferred.
- An override addresses an element id plus a member path in CultNet's grammar. An
insertion is a new element anchored after an existing id; a removal names the
removed id. Index addressing is out.
- Rebasing is deterministic. An override whose element id exists in the new base
re-applies. One whose element is missing is an explicit conflict that Studio shows,
to keep, retarget or clear; it is never silently retargeted.
- Existing stores get ids minted once, by a rewrite.
- **2, where resolution lives: at load, kept in memory** (operator: "agreed"). Resolution - **2, where resolution lives: at load, kept in memory** (operator: "agreed"). Resolution
computes a variant's complete document from its base chain and its overrides. computes a variant's complete document from its base chain and its overrides.
- The cache holds both the stored delta and the resolved document. - The cache holds both the stored delta and the resolved document.