pki.sgit.ai / documents / history-append-only

History Is The Append-Only Log: The Objects Are Immutable And The Reference Is Not

TypeArchitecture brief Versionv0.33.61 Date20 August 2026 AuthorDinis Cruz (project lead) and collaborators LicenceCC BY 4.0 Sourceraw markdown · view on GitHub

Summary

The brief that dissolves a tension between two of this site's own published rules. Revocation-as-a-signed-append and size-bounded records pull against each other only while the entry is treated as a record that accumulates; seen as a file inside a commit graph, the two rules govern different structures and the conflict disappears. It also corrects a comfortable assumption: blobs, trees and commits are content-addressed and immutable, but branch references are mutable and a history reset is a shipped command — so append-only history is a policy about one pointer, not a property of the store. The fix is the site's own standard: publish the head, signed and dated, so a rewrite becomes falsifiable by any reader who kept the last one. And it names the register's central query — what did this identity look like on this date — as the one piece with no command behind it.

Key concepts

Key ideas

On this site

Folded into the MVP pack as change-control entries C7 and C8, and into the rules page as the proposed fifth rule about the reference.

Read the document

📄 Original document · v0.33.61 · 20 August 2026 · rendered from the raw markdown (the source of truth)