---
id: "record-revisions"
type: "concept"
title: "Record revisions and stale-write conflicts"
summary: "Writes carry an expected revision; stale writers cannot overwrite newer data."
problem: "Lost updates when concurrent writers race."
why: "Revision preconditions preserve newer data and force explicit recovery."
mentalModel: "Load → mutate → write with expected revision → reload on conflict."
audiences: ["developers", "builders"]
related: ["raw-records"]
---
# Record revisions and stale-write conflicts

Writes carry an expected revision; stale writers cannot overwrite newer data.

## Problem

Lost updates when concurrent writers race.

## Why

Revision preconditions preserve newer data and force explicit recovery.

## Mental model

Load → mutate → write with expected revision → reload on conflict.