Struct Stack 

pub struct Stack {
    pub id: Uuid,
    pub name: String,
    pub description: Option<String>,
    pub base_branch: String,
    pub working_branch: Option<String>,
    pub entries: Vec<StackEntry>,
    pub entry_map: HashMap<Uuid, StackEntry>,
    pub status: StackStatus,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub is_active: bool,
}

Represents a complete stack of commits

Fields

id: Uuid

Unique identifier for this stack

name: String

Human-readable name for the stack

description: Option<String>

Description of what this stack implements

base_branch: String

Base branch this stack is built on

working_branch: Option<String>

Working branch where commits are made (e.g., feature-1)

entries: Vec<StackEntry>

All entries in this stack (ordered)

entry_map: HashMap<Uuid, StackEntry>

Map of entry ID to entry for quick lookup

status: StackStatus

Current status of the stack

created_at: DateTime<Utc>

When this stack was created

updated_at: DateTime<Utc>

When this stack was last updated

is_active: bool

Whether this stack is active (current working stack)

Implementations

impl Stack

pub fn new( name: String, base_branch: String, description: Option<String>, ) -> Self

Create a new empty stack

pub fn push_entry( &mut self, branch: String, commit_hash: String, message: String, ) -> Uuid

Add a new entry to the top of the stack

pub fn pop_entry(&mut self) -> Option<StackEntry>

Remove the top entry from the stack

pub fn get_entry(&self, id: &Uuid) -> Option<&StackEntry>

Get an entry by ID

pub fn get_entry_mut(&mut self, id: &Uuid) -> Option<&mut StackEntry>

Get a mutable entry by ID

pub fn update_entry_commit_hash( &mut self, entry_id: &Uuid, new_commit_hash: String, ) -> Result<(), String>

Update an entry’s commit hash in both entries Vec and entry_map This ensures the two data structures stay in sync

pub fn get_base_entry(&self) -> Option<&StackEntry>

Get the base (first) entry of the stack

pub fn get_top_entry(&self) -> Option<&StackEntry>

Get the top (last) entry of the stack

pub fn get_children(&self, entry_id: &Uuid) -> Vec<&StackEntry>

Get all entries that are children of the given entry

pub fn get_parent(&self, entry_id: &Uuid) -> Option<&StackEntry>

Get the parent of the given entry

pub fn is_empty(&self) -> bool

Check if the stack is empty

pub fn len(&self) -> usize

Get the number of entries in the stack

pub fn mark_entry_submitted( &mut self, entry_id: &Uuid, pull_request_id: String, ) -> bool

Mark an entry as submitted with a pull request ID

pub fn repair_data_consistency(&mut self)

Force synchronization of entries from entry_map (public method for fixing corrupted data)

pub fn mark_entry_synced(&mut self, entry_id: &Uuid) -> bool

Mark an entry as synced

pub fn mark_entry_merged(&mut self, entry_id: &Uuid, merged: bool) -> bool

Mark an entry as merged (or unmerged)

pub fn update_status(&mut self, status: StackStatus)

Update stack status

pub fn set_active(&mut self, active: bool)

Set this stack as active

pub fn get_branch_names(&self) -> Vec<String>

Get all branch names in this stack

pub fn validate(&self) -> Result<String, String>

Validate the stack structure and Git state integrity

pub fn validate_git_integrity( &self, git_repo: &GitRepository, ) -> Result<String, String>

Validate Git state integrity (requires Git repository access) This checks that branch HEADs match the expected commit hashes

Trait Implementations

impl Clone for Stack

fn clone(&self) -> Stack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Stack

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Stack

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Stack

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

where __S: Serializer,

Serialize this value into the given Serde serializer.