Expand description
GTS (Graph Transport Substrate) format engine — docs/GTS-SPEC.md Draft v0.3.
A GTS file is a CBOR Sequence of one or more segments (#3.1), each an
append-only log: a Header followed by frames chained by BLAKE3 content-id
("id"/"prev", §6/§9.1). reader::read verifies the chain and folds
the log into a model::Graph (§7.5), degrading undecodable frames to
opaque nodes (§7.6) instead of aborting — the reader is total.
This crate is the Rust counterpart of the Python reference oracle
(src/gmeow_tools/gts/); both are gated against the same frozen
language-neutral conformance corpus in vectors/ (§18).
The Python side keeps the producer; this crate owns the format engine.
Re-exports§
pub use policy::evaluate_profile_policy;pub use policy::signature_trust;pub use policy::ProfileFinding;pub use policy::Severity;pub use policy::SignatureTrust;pub use policy::TrustPolicy;pub use visual_hashing as emojihash;
Modules§
- codec
- The GTS transform catalog (§8) — mirror of
src/gmeow_tools/gts/codec.py. - compact
- Streamable compaction (GTS-SPEC §10.1): re-author the ordering, only the
ordering — mirror of
packages/gts/src/gts/compact.py. - cose
- COSE_Sign1 (detached payload, EdDSA/Ed25519) over a frame id — GTS-SPEC §9.2.
- db
- Relational exports for the folded graph (§14).
- dumpdir
- Directory dump export for human and tool inspection.
- examples
- Runnable application examples built only on the core GTS crate.
- files
- Files-profile pack/unpack/diff logic for GTS archives (§13.2, §14.2).
- from_
nquads - The
nquads -> gtstransform: the inverse of the §14 fold projection. - from_
trig - The
trig -> gtstransform. - mmr
- Merkle-Mountain-Range commitments for
index.mmrand detached proof JSON. - model
- In-memory data model for the folded graph — mirror of
src/gmeow_tools/gts/model.py. - nested
- Bounded nested-GTS discovery for Full Reader callers.
- nquads
- The
gts → nquadstransform (§14) — mirror ofsrc/gmeow_tools/gts/nquads.py. - openpgp
- Minimal OpenPGP reader for Ed25519 armored public/secret keys (§9.2).
- policy
- Trust and profile-policy checks layered above core GTS validity.
- rdf_
events - RDF event adapter for folded GTS graphs.
- reader
- The GTS reader: parse a CBOR Sequence, verify the id/prev chain, fold the
log — mirror of
src/gmeow_tools/gts/reader.py. - replication
- Replication inventory helpers for the Rust CLI.
- stream
- The spec-owned
streamvocabulary (GTS-SPEC §13.3) — mirror ofpackages/gts/src/gts/stream.py. - trig
- The
gts -> trigtransform. - verify
- High-level embedded-key verification helpers.
- wire
- Wire primitives: deterministic CBOR, BLAKE3 content-ids, and the id/prev
rule — mirror of
src/gmeow_tools/gts/wire.py. - writer
- A GTS writer: build frames, maintain the id/prev chain, emit a CBOR Sequence.