Skip to content

RFC: Git (v1)

Status: Draft
Version: v1
Scope: Durable streams and distribution
Non-goals: Runtime execution


1. Purpose

Git is used as:

  • durable stream
  • replication mechanism
  • backup format

Git is optional.


2. Model

  • machines = orphan branches
  • runs = forks
  • events = commits
  • snapshots = commits

History is append-only.


3. Identity

  • commit hashes are canonical IDs
  • same algorithm used with or without Git

4. SmartHTTP

/<repo>.git/**

Standard Git semantics apply.


5. Invariants

  1. No history rewriting
  2. Git is optional
  3. Append-only semantics

6. Lock statement

Git is a durable, append-only stream for XMachines.
This is Git v1.