Struct StopHandler 

pub struct StopHandler {
    sync: Option<SyncService>,
    auto_sync: bool,
    timeout_ms: u64,
}

Handles Stop hook events.

Performs session analysis and sync at session end. Includes timeout enforcement to prevent hanging (RES-M2).

Fields

sync: Option<SyncService>

Sync service.

auto_sync: bool

Whether to auto-sync on stop.

timeout_ms: u64

Timeout for stop hook operations in milliseconds.

Implementations

impl StopHandler

pub const fn new() -> Self

Creates a new handler with default 30s timeout.

pub const fn with_timeout_ms(self, timeout_ms: u64) -> Self

Sets the timeout in milliseconds.

Operations that exceed this timeout will return a partial response.

pub fn with_sync(self, sync: SyncService) -> Self

Sets the sync service.

pub const fn with_auto_sync(self, enabled: bool) -> Self

Enables or disables auto-sync.

fn generate_summary(&self, input: &Value) -> SessionSummary

Generates a session summary.

fn extract_namespace_counts(input: &Value) -> HashMap<String, NamespaceStats>

Extracts namespace statistics from input.

fn extract_tags_used(input: &Value) -> Vec<(String, usize)>

Extracts tags used with frequencies, sorted by count descending.

fn extract_query_patterns(input: &Value) -> Vec<String>

Extracts query patterns from the session.

fn extract_resources_read(input: &Value) -> Vec<String>

Extracts MCP resources read during the session.

fn perform_sync(&self) -> Option<SyncResult>

Performs sync if enabled and available.

fn build_metadata( summary: &SessionSummary, sync_result: Option<&SyncResult>, ) -> Value

Builds metadata JSON from session summary.

fn build_context_lines( summary: &SessionSummary, sync_result: Option<&SyncResult>, ) -> String

Builds context message lines from session summary.

Trait Implementations

impl Default for StopHandler

fn default() -> Self

Returns the “default value” for a type.

impl HookHandler for StopHandler

fn event_type(&self) -> &'static str

The hook event type this handler processes.

fn handle(&self, input: &str) -> Result<String>

Handles the hook event.