Struct StudioState 

pub struct StudioState {

    pub repo: Option<Arc<GitRepo>>,
    pub git_status: GitStatus,
    pub git_status_loading: bool,
    pub config: Config,
    pub active_mode: Mode,
    pub focused_panel: PanelId,
    pub modes: ModeStates,
    pub modal: Option<Modal>,
    pub chat_state: ChatState,
    pub notifications: VecDeque<Notification>,
    pub iris_status: IrisStatus,
    pub companion: Option<CompanionService>,
    pub companion_display: CompanionSessionDisplay,
    pub dirty: bool,
    pub last_render: Instant,
}

Main application state for Iris Studio

Fields

repo: Option<Arc<GitRepo>>

Git repository reference

git_status: GitStatus

Cached git status

git_status_loading: bool

Whether git status is currently loading

config: Config

Application configuration

active_mode: Mode

Current active mode

focused_panel: PanelId

Focused panel

modes: ModeStates

Mode-specific states

modal: Option<Modal>

Active modal

chat_state: ChatState

Persistent chat state (survives modal close, universal across modes)

notifications: VecDeque<Notification>

Notification queue

iris_status: IrisStatus

Iris agent status

companion: Option<CompanionService>

Companion service for ambient awareness (optional - may fail to init)

companion_display: CompanionSessionDisplay

Companion session display data (updated periodically)

dirty: bool

Whether the UI needs redraw

last_render: Instant

Last render timestamp for animations

Implementations

impl StudioState

pub fn new(config: Config, repo: Option<Arc<GitRepo>>) -> Self

Create new studio state Note: Companion service is initialized asynchronously via load_companion_async() in app for fast startup

pub fn suggest_initial_mode(&self) -> Mode

Suggest the best initial mode based on repo state

pub fn switch_mode(&mut self, new_mode: Mode)

Switch to a new mode with context preservation

pub fn notify(&mut self, notification: Notification)

Add a notification

pub fn current_notification(&self) -> Option<&Notification>

Get the current notification (most recent non-expired)

pub fn cleanup_notifications(&mut self)

Clean up expired notifications

pub fn mark_dirty(&mut self)

Mark state as dirty (needs redraw)

pub fn check_dirty(&mut self) -> bool

Check and clear dirty flag

pub fn focus_next_panel(&mut self)

Focus the next panel

pub fn focus_prev_panel(&mut self)

Focus the previous panel

pub fn show_help(&mut self)

Open help modal

pub fn show_chat(&mut self)

Open chat modal (universal, persists across modes)

pub fn close_modal(&mut self)

Close any open modal

pub fn set_iris_thinking(&mut self, task: impl Into<String>)

Update Iris status

pub fn add_status_message(&mut self, message: StatusMessage)

Add a dynamic status message (received from fast model)

pub fn set_iris_idle(&mut self)

Set Iris idle

pub fn set_iris_complete(&mut self, message: impl Into<String>)

Set Iris complete with a message (stays until next task)

pub fn set_iris_error(&mut self, error: impl Into<String>)

Set Iris error

pub fn tick(&mut self)

Tick animations (spinner, etc.)

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

Get list of branch refs for selection

pub fn get_commit_presets(&self) -> Vec<PresetInfo>

Get list of commit-related presets for selection

pub fn get_emoji_list(&self) -> Vec<EmojiInfo>

Get list of emojis for selection (None, Auto, then all gitmojis)

pub fn update_companion_display(&mut self)

Update companion display from session data and git info

pub fn clear_companion_welcome(&mut self)

Clear welcome message (after user has seen it)

pub fn companion_touch_file(&mut self, path: PathBuf)

Record a file touch in companion (for manual tracking when watcher isn’t active)

pub fn companion_record_commit(&mut self, hash: String)

Record a commit in companion