zenith-session 0.0.0-beta.1

Zenith document identity, ephemeral session DAG, and content-addressed version store.
Documentation

zenith-session: local-machine history/session state for .zen documents.

Pure crate with injected fs/clock/rng adapters; never depended on by the deterministic render pipeline.

Module layout

  • [adapter] — injectable trait boundaries (filesystem, clock, RNG)
  • [mod@bundle] — deterministic DEFLATE bundle/unbundle for portable transfer
  • [datadir] — platform data-directory resolution
  • [docid] — ULID document-identity minting
  • [error] — [SessionError] (the single error type for this crate)
  • [mod@gc] — object garbage collection ([gc()])
  • [global] — global cross-document LRU storage cap ([enforce_global_cap])
  • [identity] — document-identity reconciliation ([reconcile])
  • [layout] — [StorePaths] pure path builders
  • [manifest] — [HistoryRecord] schema and append-only JSONL manifest I/O
  • [retention] — Time-Machine-style retention thinning for Tier-2 version history
  • [revspec] — revision-spec resolver: map a human/agent revspec string to a record id
  • [session] — Tier-1 ephemeral session: snapshot DAG with HEAD + redo stack
  • [store] — content-addressed object store (SHA-256 + DEFLATE)
  • [previews] — [PreviewRecord] schema and append-only preview-artifact log
  • [runs] — [RunRecord] schema and append-only agent-run provenance log
  • [scratch] — [CandidateEntry] schema and append-only scratch/candidate index
  • [tier2] — Tier-2 durable version history: bounded flat list in versions.jsonl