gemel 0.11.1

Evidence-native version control for agentic software development: canonical object encoding, content-addressed identity, immutable object store, change workflow, Git-carried exchange rollups, network transports, and CLI.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

//! Object identity hashing (OBJECT_MODEL.md §2).
//!
//! `ObjectId = BLAKE3-256(canonical envelope bytes)`.

use crate::error::ObjectError;
use crate::gid::Gid;
use crate::value::Object;

/// The BLAKE3-256 identity digest of canonical envelope bytes.
/// BLAKE3-256 of arbitrary bytes (exchange pack/frontier identities;
/// EXCHANGE.md §6, §8).
pub fn blake3_256(bytes: &[u8]) -> [u8; 32] {
    *blake3::hash(bytes).as_bytes()
}

/// BLAKE3-256 of an object envelope (object identity; OBJECT_MODEL.md §2).
pub fn object_id_bytes(bytes: &[u8]) -> [u8; 32] {
    *blake3::hash(bytes).as_bytes()
}

/// Derives the identity of an encoded object (family from the envelope).
pub fn gid_from_envelope(bytes: &[u8]) -> Option<Gid> {
    let family = crate::family::Family::from_code(*bytes.get(5)?)?;
    Some(Gid::new(family, object_id_bytes(bytes)))
}

/// Derives the identity of an object (encodes it first).
pub fn object_id(obj: &Object, limits: &crate::limits::Limits) -> Result<Gid, ObjectError> {
    let bytes = crate::encode::encode_object(obj, limits)?;
    Ok(Gid::new(obj.family, object_id_bytes(&bytes)))
}