Skip to content
C.W.K.
Stream
Lesson 01 of 05 · published

The Vault Is Ground Truth

~12 min · authority, vault, sync, source-of-truth

Level 0Trace
0 XP0/36 lessons0/12 achievements
0/100 XP to next level100 XP to go0% complete

Authority lives where legitimate writes land

Memory changes through editors, mobile sync, and live brain sessions. The live vault is where those legitimate paths meet. If a versioning tool calls its convenient mirror the source, actual human work becomes external input and the tool wins every conflict.

Source does not mean the most sophisticated store. It means the place where authorized change occurs. It may have less elegant formatting or slower history queries, but if edits originate there and propagate to devices, authority lives there.

A projection is dangerous because it is useful

The mirror is better for search, diffs, and commits. It creates a stable tree without editor locks or synchronization internals. That convenience makes it feel cleaner and therefore more authoritative, which is exactly why direction must be an invariant.

Allowed arrows run from live vault to mirror, then from mirror to indexes and ledger. No reverse arrow bypasses the write path. Even restore reintroduces historical content as a new present event through mediated mutation.

A sync conflict does not transfer authority

When synchronization produces conflicting files, the mirror does not become judge. The conflict is itself an event from live truth, presenting two traces for a person to compare. A derived system may expose both but must not silently decide which memory is real.

This boundary makes rebuilding cheap. A bad mirror or index can be discarded and recreated from the vault. If live truth depends on derived state, nothing can be thrown away safely and a cache failure becomes a source failure.

Write the authority table first

Before implementation, list each datum, who writes it, and what can rebuild it. A value with a named rebuild source is a projection; a value receiving normal authorized writes is a candidate authority. A row marked as both is a warning. Genuine bidirectional synchronization needs a separately designed conflict owner and merge semantics.

Ground truth is not the fanciest store; it is where legitimate change first arrives. Every derived state should be disposable and rebuildable from it.

Code

Build a projection from source without a reverse path·python
from pathlib import Path
import shutil

source = Path("demo/live")
mirror = Path("demo/mirror")
source.mkdir(parents=True, exist_ok=True)
source.joinpath("memory.md").write_text("live truth\n")
mirror.mkdir(parents=True, exist_ok=True)
shutil.copy2(source / "memory.md", mirror / "memory.md")
assert source.joinpath("memory.md").read_text() == mirror.joinpath("memory.md").read_text()

External links

Exercise

Classify your stores as authoritative, derived, or cache. Find every arrow from derived or cache toward authority and remove it or convert it into an explicit mediated command.
Hint
If it can be discarded and rebuilt, it is derived. If authorized users write there normally, it may be authority.

Progress

Progress is local-only — sign in to sync across devices.
Spotted a bug or have feedback on this page?Report an Issue

Comments 0

🔔 Reply notifications (sign in)
Sign inPlease sign in to comment.

No comments yet — be the first.