Crate gemel 

Gemel — evidence-native version control for agentic software development.

This crate is the reference implementation of the Gemel Canonical Encoding (GCE) defined in docs/OBJECT_MODEL.md. It provides:

• the canonical primitives: varint, family table, Gid, hex, limits (varint, family, gid, hex, limits);
• the canonical value/object model (value);
• the normative per-family schema tables (spec);
• the fail-closed encoder (encode) and decoder (decode);
• BLAKE3-256 object identity (hash);
• family-specific validation (validate);
• the deterministic JSON projection (json);
• the executable golden fixtures (golden);
• the repository store, content layer, workflow, query surface, ignore matching, and default builders (store, content, workflow, query, ignore, defaults).

The store error type intentionally carries rich payloads (paths, gids, strings, tombstones) for precise diagnostics; boxing every variant would obscure construction sites for no measurable gain.

Re-exports

pub use error::ObjectError;

pub use value::Body;

pub use value::Field;

pub use value::Object;

pub use value::Value;

Modules

consts

Canonical encoding constants (OBJECT_MODEL.md §1.4).

content

The content layer (STORAGE.md §6, OBJECT_MODEL.md §6.2–§6.4).

court

The FRF court runner (Phase 8; HOSTED.md §7, brief §38).

decode

The fail-closed canonical decoder (OBJECT_MODEL.md §1, THREAT_MODEL.md §4).

defaults

Default object construction (producers, repository config).

encode

The canonical encoder (OBJECT_MODEL.md §1).

error

Canonical object errors (fail-closed catalog, THREAT_MODEL.md §4).

exchange

Git-carried exchange rollups (SPECIFICATION.md Phase 1.5, EXCHANGE.md).

family

The object family table.

gid

Object identities (Gid).

git_adapter

A narrowly isolated Git adapter (EXCHANGE.md §23, GIT_INTEROP.md).

git_interop

Deterministic Git interchange (GIT_INTEROP.md, Phase 4).

git_io

Minimal loose-object Git reader/writer (GIT_INTEROP.md §2–§4).

golden

Executable golden fixtures (OBJECT_MODEL.md §11–§12).

hash

Object identity hashing (OBJECT_MODEL.md §2).

hex

Deterministic lowercase hex encoding.

ignore

A .gitignore matcher implementing a documented subset of git semantics (STORAGE.md §6, content snapshotting).

json

The deterministic JSON projection of canonical objects (OBJECT_MODEL.md §10.3, AGENT_PROTOCOL.md §3).

limits

Resource limits enforced during parsing and validation (OBJECT_MODEL.md §5, THREAT_MODEL.md §5).

protocol

The lightweight agent protocol (Phase 7; brief §15.4, AGENT_PROTOCOL.md §10).

query

Query layer: log, show, status, derived statuses, and the Phase 2 agent-native surface (why/claims/evidence/residuals/attempts/trajectory/ checkpoint/context; AGENT_PROTOCOL.md §5–§6, §9).

reconcile

Reconciliation (SPECIFICATION.md Phase 3, OBJECT_MODEL.md §6.17, AGENT_PROTOCOL.md §5.10).

semantic

Semantic indexing (Phase 5, SPECIFICATION.md Phase 5).

spec

Normative per-family schema tables (OBJECT_MODEL.md §6).

store

The Gemel repository (STORAGE.md).

sync

Native distributed operation (Phase 6 + 8; SPECIFICATION.md Phase 6/8, STORAGE.md §10, GIT_INTEROP.md §6, HOSTED.md).

validate

Family-specific object validation (INVARIANTS.md §4) and path rules.

value

The canonical value and object model (OBJECT_MODEL.md §1, §6).

varint

Canonical variable-length integers.

workflow

The change workflow (SPECIFICATION.md Phase 1; brief §42).