Struct StateManager 

pub struct StateManager { /* private fields */ }

Manages persistent state for hook execution sessions

Implementations

impl StateManager

pub fn new(state_dir: PathBuf) -> Self

Create a new state manager with the specified state directory

pub fn default_state_dir() -> Result<PathBuf>

Get the default state directory.

Uses platform-appropriate paths:

• Linux: ~/.local/state/cuenv/state
• macOS: ~/Library/Application Support/cuenv/state
• Windows: %APPDATA%\cuenv\state

pub fn with_default_dir() -> Result<Self>

Create a state manager using the default state directory

pub fn get_state_dir(&self) -> &Path

Get the state directory path

pub async fn ensure_state_dir(&self) -> Result<()>

Ensure the state directory exists

pub fn get_state_file_path(&self, instance_hash: &str) -> PathBuf

Get the state file path for a given directory hash (public for PID files)

pub async fn save_state(&self, state: &HookExecutionState) -> Result<()>

Save execution state to disk with atomic write and locking

pub async fn load_state( &self, instance_hash: &str, ) -> Result<Option<HookExecutionState>>

Load execution state from disk with shared locking

pub async fn remove_state(&self, instance_hash: &str) -> Result<()>

Remove state file for a directory

pub async fn list_active_states(&self) -> Result<Vec<HookExecutionState>>

List all active execution states

pub fn compute_directory_key(path: &Path) -> String

Compute a key for directory-only lookups (used for fast status checks). This hashes just the canonicalized directory path, without config hash.

pub async fn create_directory_marker( &self, directory_path: &Path, instance_hash: &str, ) -> Result<()>

Create a marker file linking directory to instance hash. Called when hooks start to enable fast status lookups.

pub async fn remove_directory_marker(&self, directory_path: &Path) -> Result<()>

Remove marker file for a directory. Called when hooks complete/fail and display timeout expires.

pub fn has_active_marker(&self, directory_path: &Path) -> bool

Fast synchronous check: does a marker exist for this directory? This is the hot path for Starship - just a single stat() syscall.

pub async fn get_marker_instance_hash( &self, directory_path: &Path, ) -> Option<String>

Read the instance hash from a marker file (if it exists).

pub fn get_marker_instance_hash_sync( &self, directory_path: &Path, ) -> Option<String>

Read the instance hash from a marker file synchronously. This is the sync equivalent of get_marker_instance_hash for the fast path.

pub fn load_state_sync( &self, instance_hash: &str, ) -> Result<Option<HookExecutionState>>

Load execution state from disk synchronously with shared locking. This is the sync equivalent of load_state for the fast path.

pub async fn cleanup_state_directory(&self) -> Result<usize>

Clean up the entire state directory

pub async fn cleanup_orphaned_states(&self, max_age: Duration) -> Result<usize>

Clean up orphaned state files (states without corresponding processes)

Trait Implementations

impl Clone for StateManager

fn clone(&self) -> StateManager

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StateManager

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

Formats the value using the given formatter.