Struct Branch 

pub struct Branch {
    pub id: BranchId,
    pub fork_point: NodeId,
    pub head: NodeId,
    pub status: BranchStatus,
    pub parent_branch: Option<BranchId>,
    pub child_branches: Vec<BranchId>,
    pub nodes: Vec<NodeId>,
    pub metadata: HashMap<String, String>,
    pub created_at: i64,
    pub updated_at: i64,
    pub label: Option<String>,
}

A branch in the trajectory state machine.

Represents a linear path through the DAG from a fork point to a leaf (or to another fork point). Branches can be split off into independent state machines and later merged back.

Fields

id: BranchId

Unique identifier for this branch

fork_point: NodeId

Where this branch diverged from its parent

head: NodeId

Current tip (head) of the branch

status: BranchStatus

Current status of the branch

parent_branch: Option<BranchId>

Parent branch (if this is a child branch)

child_branches: Vec<BranchId>

Child branches that forked from this one

nodes: Vec<NodeId>

Nodes that belong exclusively to this branch

metadata: HashMap<String, String>

Metadata associated with this branch

created_at: i64

Timestamp when branch was created

updated_at: i64

Timestamp when branch was last updated

label: Option<String>

Human-readable label (optional)

Implementations

impl Branch

pub fn new(id: BranchId, fork_point: NodeId, head: NodeId) -> Self

Create a new branch.

pub fn root(id: BranchId, root_node: NodeId) -> Self

Create a root branch (no fork point).

pub fn is_active(&self) -> bool

Check if this branch is active.

pub fn is_root(&self) -> bool

Check if this branch is the main/root branch.

pub fn is_merged(&self) -> bool

Check if this branch has been merged.

pub fn archive(&mut self)

Archive this branch (preserve but mark inactive).

pub fn mark_merged(&mut self)

Mark this branch as merged.

pub fn recover(&mut self)

Recover this branch (reactivate from archived/orphaned).

pub fn add_node(&mut self, node_id: NodeId)

Add a node to this branch.

pub fn len(&self) -> usize

Get the length of this branch (number of nodes).

pub fn is_empty(&self) -> bool

Check if branch is empty.

pub fn set_label(&mut self, label: impl Into<String>)

Set a label for this branch.

pub fn add_metadata(&mut self, key: impl Into<String>, value: impl Into<String>)

Add metadata to this branch.

Trait Implementations

impl Clone for Branch

fn clone(&self) -> Branch

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Branch

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

Formats the value using the given formatter.