Skip to content

Overlay reads

Reads check ephemeral first, then fall through to durable baseline.

Overlay read behavior:

  • If file exists in ephemeral, return that.
  • Otherwise read from durable baseline snapshot.

Why it matters:

  • Session startup stays cheap.
  • Agent sees a stable baseline for session lifetime.
  • Conflict handling is deferred to promote time.

Writes always land in ephemeral until human promotion.