Struct GitMark 

pub struct GitMark {
    pub commit_sha: String,
    pub repo: String,
    pub branch: String,
    pub parent: Option<String>,
}

The cheap-tier git commit captured for a pod write.

Fields

commit_sha: String

Git SHA-1 of the commit the write produced.

repo: String

Pod repo slug (the pod’s first path segment / pubkey).

branch: String

Branch the commit landed on. Pinned to "main" by init.rs.

parent: Option<String>

Prior commit SHA (the append-only chain link), or None for the genesis commit of a freshly-initialised repo.

Implementations

impl GitMark

pub fn to_gitmark_envelope( &self, vout: u32, genesis_sha: &str, nick: impl Into<String>, package: impl Into<String>, ) -> GitMarkEnvelope

Project this internal GitMark onto the canonical 5-key gitmark.json envelope (ADR-124, C7).

• vout is the seal output index for this mark’s @id (gitmark:<commit_sha>:<vout>).
• genesis_sha is the trail’s first commit SHA; pass this mark’s own commit_sha for the genesis mark (then genesis == @id).
• nick/package are the additive projection fields; repository defaults to ./ (repo-relative root, matching the ground truth).

branch/parent are intentionally NOT emitted — they are not part of the on-disk envelope. Parent-linkage is carried by blocktrails.json.

pub fn to_gitmark_json( &self, vout: u32, genesis_sha: &str, nick: impl Into<String>, package: impl Into<String>, ) -> Result<String, ProvenanceError>

Serialise this mark to the canonical gitmark.json text (5-key envelope, ADR-124). Convenience over Self::to_gitmark_envelope + serde_json::to_string_pretty.

Trait Implementations

impl Clone for GitMark

fn clone(&self) -> GitMark

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GitMark

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GitMark

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for GitMark

impl PartialEq for GitMark

fn eq(&self, other: &GitMark) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for GitMark

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GitMark