Struct Commit 

pub struct Commit {
    pub id: ObjectId,
    pub state_root: ObjectId,
    pub parents: Vec<ObjectId>,
    pub timestamp: DateTime<Utc>,
    pub agent_id: AgentId,
    pub authority: Authority,
    pub intent: Intent,
    pub reasoning: Option<String>,
    pub confidence: Option<f64>,
    pub tool_calls: Vec<ToolCall>,
}

An immutable record that links a state tree to its history and provenance metadata.

Fields

id: ObjectId

Content-address of this commit (BLAKE3 hash of all other fields).

state_root: ObjectId

Root of the state tree at this commit.

parents: Vec<ObjectId>

Parent commit(s). Empty for initial commit, one for normal, two+ for merge.

timestamp: DateTime<Utc>

When this commit was created.

agent_id: AgentId

The agent or human who made this state change.

authority: Authority

The authorization chain for this action.

intent: Intent

Structured intent metadata.

reasoning: Option<String>

Agent’s chain-of-thought or explanation.

confidence: Option<f64>

Agent’s self-assessed confidence (0.0 to 1.0).

tool_calls: Vec<ToolCall>

Tool calls that contributed to this state change.

Implementations

impl Commit

pub fn enforce_caps(&mut self)

Apply the same size caps CommitBuilder::build uses to a commit loaded from storage. Idempotent — commits already within caps are returned unchanged.

CommitBuilder::build truncates on construction, but a .db file seeded out-of-band (older ASG versions without caps, or a malicious operator) may contain unbounded description / reasoning / agent_id / tool_calls. Blame/log would otherwise replay them verbatim to untrusted readers. Higher-level APIs that surface commits to callers invoke this implicitly. (security threat model v2, F3)

Note: this mutates the commit in place and does NOT recompute the content-addressed id — a commit’s id is a historical identifier of what was stored, and re-hashing on read would break log/blame identity. The caps here exist purely to bound what’s shown to readers, not to rewrite history.

Trait Implementations

impl Clone for Commit

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Commit

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Commit

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Commit

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for Commit

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 Commit