Struct HookExecutor 

pub struct HookExecutor { /* private fields */ }

Manages hook execution with background processing and state persistence

Implementations

impl HookExecutor

pub fn new(config: HookExecutionConfig) -> Result<Self>

Create a new hook executor with the specified configuration

pub fn with_default_config() -> Result<Self>

Create a hook executor with default configuration

pub async fn execute_hooks_background( &self, directory_path: PathBuf, config_hash: String, hooks: Vec<Hook>, ) -> Result<String>

Start executing hooks in the background for a directory

pub async fn get_execution_status( &self, directory_path: &Path, ) -> Result<Option<HookExecutionState>>

Get the current execution status for a directory

pub async fn get_execution_status_for_instance( &self, directory_path: &Path, config_hash: &str, ) -> Result<Option<HookExecutionState>>

Get execution status for a specific instance (directory + config)

pub async fn get_fast_status( &self, directory_path: &Path, ) -> Result<Option<HookExecutionState>>

Fast check if any hooks are active for a directory (no config hash needed). This is the hot path for Starship - skips config hash computation entirely. Returns None if no hooks running, Some(state) if hooks active.

pub fn state_manager(&self) -> &StateManager

Get a reference to the state manager (for marker operations from execute_hooks)

pub fn get_fast_status_sync( &self, directory_path: &Path, ) -> Result<Option<HookExecutionState>>

Synchronous fast status check - no tokio runtime required. This is the hot path for Starship/shell prompts when no async runtime is available. Returns None if no hooks running, Some(state) if hooks active.

pub async fn wait_for_completion( &self, directory_path: &Path, config_hash: &str, timeout_seconds: Option<u64>, ) -> Result<HookExecutionState>

Wait for hook execution to complete, with optional timeout in seconds

pub async fn cancel_execution( &self, directory_path: &Path, config_hash: &str, reason: Option<String>, ) -> Result<bool>

Cancel execution for a directory

pub async fn cleanup_old_states(&self, older_than: Duration) -> Result<usize>

Clean up completed execution states older than the specified duration

pub async fn execute_single_hook(&self, hook: Hook) -> Result<HookResult>

Execute a single hook and return the result

Trait Implementations

impl Debug for HookExecutor

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

Formats the value using the given formatter.