Struct HookMatcher 

#[non_exhaustive]
pub struct HookMatcher {
    pub tool: Option<String>,
    pub tool_glob: Option<String>,
    pub safety: Vec<SafetyClass>,
}

Matching conditions for a single hook.

Shape is identical to defect-config’s HookMatcher; the agent crate does not depend on config, so this is defined independently and the CLI translates the config shape into the agent shape at assembly time. See hooks design for trust model.

All fields empty = match all triggers under that event.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

tool: Option<String>

Match by exact tool name (only for *ToolUse* events).

tool_glob: Option<String>

Glob match by tool name (only for *ToolUse* events).

safety: Vec<SafetyClass>

Filter by SafetyClass (only PreToolUse); any match triggers. Empty vec = no filter.

Implementations

impl HookMatcher

pub fn matches_step( &self, tool: Option<&str>, safety: Option<SafetyClass>, ) -> bool

Matches a step model by tool name and safety (both taken from the step envelope; non-tool steps pass None).

All fields empty = matches everything. tool is exact, tool_glob is a glob pattern, safety matches any (empty vec = no filter).

Trait Implementations

impl Clone for HookMatcher

fn clone(&self) -> HookMatcher

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HookMatcher

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

Formats the value using the given formatter.

impl Default for HookMatcher

fn default() -> HookMatcher

Returns the “default value” for a type.