Struct SessionData 

pub struct SessionData {
    pub project_name: String,
    pub metadata: SessionMetadata,
    pub run: Option<RunState>,
    pub progress: Option<RunProgress>,
    pub load_error: Option<String>,
    pub is_main_session: bool,
    pub is_stale: bool,
    pub live_output: Option<LiveState>,
    pub cached_user_stories: Option<Vec<UserStory>>,
}

Data for a single session in the Active Runs view.

This struct represents one running session, which can be from the main repo or a worktree. Multiple sessions can belong to the same project (when using worktree mode).

Fields

project_name: String

Project name (e.g., “autom8”).

metadata: SessionMetadata

Session metadata (includes session_id, worktree_path, branch).

run: Option<RunState>

The active run state for this session.

progress: Option<RunProgress>

Progress through the spec (loaded from spec file).

load_error: Option<String>

Error message if state file is corrupted or unreadable.

is_main_session: bool

Whether this is the main repo session (vs. a worktree).

is_stale: bool

Whether this session is stale (worktree was deleted).

live_output: Option<LiveState>

Live output state for streaming Claude output (from live.json).

cached_user_stories: Option<Vec<UserStory>>

Cached user stories from the spec (to avoid file I/O on every render frame). This is populated during load_sessions() and should be used by load_story_items().

Implementations

impl SessionData

pub fn display_title(&self) -> String

Format the display title for this session. Returns “project-name (main)” or “project-name (abc12345)”.

pub fn has_fresh_heartbeat(&self) -> bool

Check if this session has a fresh heartbeat (run is actively progressing).

A session is considered “alive” if:

• It has live output data AND
• The heartbeat is recent (< 10 seconds old)

This is the authoritative check for whether a run is actively progressing. The GUI/TUI should use this to determine if a run is truly active, rather than just checking is_running from metadata.

pub fn is_actively_running(&self) -> bool

Check if this session should be considered actively running.

A session is actively running if:

• It’s not stale (worktree exists) AND
• It’s marked as running AND
• It either has a fresh heartbeat OR there’s no live data yet (run just started)

This provides a lenient check that accounts for runs that just started and haven’t written live.json yet.

pub fn appears_stuck(&self) -> bool

Check if this session appears to be stuck (marked as running but heartbeat is stale).

This helps identify crashed or stuck runs that need user intervention. Returns true if:

• Session is marked as running AND
• Live output exists AND
• Heartbeat is stale (> 10 seconds old)

pub fn truncated_worktree_path(&self) -> String

Get a truncated worktree path for display (last 2 components).

Trait Implementations

impl Clone for SessionData

fn clone(&self) -> SessionData

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SessionData

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

Formats the value using the given formatter.