Struct Operation 

pub struct Operation {
    pub parents: Vec<Cid>,
    pub view: Cid,
    pub predecessors: Option<BTreeMap<String, Vec<ChangeId>>>,
    pub author: String,
    pub agent_id: Option<String>,
    pub task_id: Option<String>,
    pub host: Option<String>,
    pub time: u64,
    pub description: String,
    pub signature: Option<Signature>,
    pub extra: BTreeMap<String, Ipld>,
}

A single mutation of repository state.

Fields

parents: Vec<Cid>

Parent operations (the op-heads observed when this op started). 0 for the root op; ≥2 after a concurrent-write merge.

view: Cid

Snapshot of the post-mutation state. A Link<View>.

predecessors: Option<BTreeMap<String, Vec<ChangeId>>>

For each rewritten commit, the ChangeIds of its predecessors. Keys are UUID-string representations of ChangeIds (DAG-CBOR map keys MUST be strings; SPEC §4.5).

author: String

Free-form author identifier.

agent_id: Option<String>

AI-agent identifier (when machine-generated).

task_id: Option<String>

Task / tool-call identifier for provenance.

host: Option<String>

Host identifier.

time: u64

Microseconds since Unix epoch.

description: String

Short human description (e.g. "commit: feat(auth): add OAuth").

signature: Option<Signature>

Optional cryptographic signature (SPEC §9.1). Attached via crate::sign::Signer::sign_operation; verified via crate::sign::Verifier::verify_operation.

extra: BTreeMap<String, Ipld>

Forward-compat extension map (SPEC §3.2).

Implementations

impl Operation

pub const KIND: &'static str = "operation"

The _kind discriminator on the wire.

pub fn new( view: Cid, author: impl Into<String>, time: u64, description: impl Into<String>, ) -> Self

Construct an operation with required fields and no parents / optionals.

pub fn with_parent(self, parent: Cid) -> Self

Append a parent operation. Returns self for chaining.

pub fn with_agent(self, agent_id: impl Into<String>) -> Self

Attach an agent identifier.

pub fn with_task(self, task_id: impl Into<String>) -> Self

Attach a task identifier.

pub fn with_host(self, host: impl Into<String>) -> Self

Attach a host identifier.

Trait Implementations

impl Clone for Operation

fn clone(&self) -> Operation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Operation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Operation

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl PartialEq for Operation

fn eq(&self, other: &Operation) -> 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 Operation

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Eq for Operation

impl StructuralPartialEq for Operation