# mkit-core
Content-addressed VCS primitives for mkit: BLAKE3 hashing, canonical objects,
refs, packs, and the transport trait every backend implements.
The byte layout this crate produces is defined, normatively, in
`docs/specs/SPEC-OBJECTS.md` (version `0x01`, magic `"MKT1"`) — any change here
must update the spec in the same PR. The crate depends only on `std`: no
`serde`, no `anyhow`, no panics on unchecked input.
## What's in here
- `hash` / `object` — BLAKE3 hashing and the canonical v1 byte encoding for
blobs, trees, commits, remixes, and chunked blobs.
- `pack` / `index` — packfile format and the index over it.
- `refs` — ref storage semantics shared by every transport.
- `store` — the on-disk object store (worktree, `.mkit/` layout, `ignore`,
`repo_lock`).
- `sign` — Ed25519 signing/verification for commits and remixes (see
`docs/specs/SPEC-SIGNING.md`).
- `protocol` — the `Transport` trait (`list_refs`, `read_ref`, `write_ref`,
`pack_exists`, `download_pack`, `upload_pack`) every `mkit-transport-*`
crate implements.
- `chunker` / `delta` — `FastCDC` content-defined chunking and delta encoding
for large blobs.
- `ops` — the higher-level repository operations (`commit`, `merge`,
`rebase`, `cherry-pick`, …) `mkit-cli` drives.
Optional features (`history-mmr`, `sparse-checkout`, `pack-shards`) gate
heavier `commonware-*`-backed paths — see the crate's `Cargo.toml` for what
each pulls in.