diaryx.org / projects /

prov

Rust MIT / Apache-2.0

Plaintext Records, Organized and Verifiable — a self-describing workspace of plain documents.

A prov workspace is a set of documents whose structure lives in the documents' own embedded metadata (frontmatter) — not in the filesystem layout, and not in an app-private sidecar folder. The files describe themselves, so anything that can read text can read the whole organization.

  • Documents. Plain Markdown with YAML frontmatter; no database, no proprietary container.
  • Relations. An index lists what belongs to it; each child names its parent. Both halves written down, in the files.
  • Identity. Permanent opaque identifiers minted into the record itself, stable across renames, moves, and republication.
  • Fixity. Content hashes that make silent drift detectable instead of assumed absent.
  • A thin CLI. The prov binary for working with workspaces without any app at all.

Where it fits

prov is the vault engine underneath Diaryx — the part that makes a folder of Markdown behave like an archive. It stands on fig for the frontmatter and twig for the documents. Standalone, it's a Rust library anyone can build on.

Status

Works for simple workspaces; active development is incorporating it into Diaryx. Released to crates.io as eleven crates via one tagged commit.