Skip to content

README.md

Latest commit

 

History

History
32 lines (30 loc) · 2.95 KB

README.md

File metadata and controls

32 lines (30 loc) · 2.95 KB
Raw

mkit specifications

The authoritative wire-format, on-disk, and subsystem specifications. Each spec carries its own status (stable / normative / draft) in its front matter.

  • SPEC-ATTESTATIONS — native attestations: in-toto v1 statements in DSSE envelopes.
  • SPEC-CONCURRENCY — the total mkit lock order across worktree, ref-history, and CAS locks.
  • SPEC-CONFIG-SECURITY — user-vs-repo config trust boundary and key classification rules.
  • SPEC-CONVENTIONS — shared vocabulary (RFC 2119 keywords, status vocabulary, encoding notation) for the SPEC-*.md corpus.
  • SPEC-DELTA — delta encoding for packfile objects.
  • SPEC-EXTERNAL-SIGNER — subprocess protocol for out-of-process signers (HSM, TPM, WebAuthn, …).
  • SPEC-FASTCDC — deterministic content-defined chunking for chunked blobs.
  • SPEC-GC — garbage collection, object pruning, and recovery.
  • SPEC-GIT-BRIDGE — mkit→git export bridge (fork mode) and its verifiers.
  • SPEC-GIT-IMPORT — git→mkit import bridge (one-way fork) and its verifiers.
  • SPEC-HISTORY-PROOF — MMR-based history proofs for light-client verification.
  • SPEC-INDEX — repo-local staging-area index (advisory, not exchanged).
  • SPEC-KEYSTORE — key vault interface, backends, and mkit key CLI surface.
  • SPEC-MERKLE-OBJECTS — merkelized ChunkedBlob and Tree object hashing.
  • SPEC-OBJECTS — on-disk object model and canonical serialization over BLAKE3 IDs.
  • SPEC-PACK-SHARDS — sharded pack production and transport delivery.
  • SPEC-PACKFILE — packfile wire format for object exchange.
  • SPEC-REFS — ref names, storage, and CAS update variants.
  • SPEC-RELEASE-THRESHOLD — BLS threshold signatures for release-party attestation.
  • SPEC-RPC — shared stdio protobuf framing for subprocess protocols.
  • SPEC-SIGNING — commit / remix / tag signing hashes and verification.
  • SPEC-SPARSE-CHECKOUT — verifiable server-side sparse checkout over HTTP/S3.
  • SPEC-TRANSPORT — seven-verb transport wire protocol (file, SSH, HTTP, S3, memory).
  • SPEC-TRANSPORT-CONNECT — draft mkit.transport.v1 Connect service, the canonical remote protocol superseding SPEC-TRANSPORT §5.
  • SPEC-TRANSPORT-ENC — self-contained encrypted-stream transport (mkit+enc://).
  • SPEC-WORKTREE — linked working trees: common-dir/per-tree state split, discovery, and cross-worktree locking.