Enum HookSettingsShape 

pub enum HookSettingsShape {
    Grouped,
    Flat,
}

How a harness lays out the hook registrations in its settings file.

Variants

Grouped

Claude Code’s shape, shared by Open Agents and Codex: every event holds groups, and every group holds typed hook entries.

{"hooks": {"PreToolUse": [{"hooks": [{"type": "command", "command": "sh …"}]}]}}

Flat

Cursor’s shape: every event holds the entries directly, and the file carries a version beside hooks.

{"version": 1, "hooks": {"preToolUse": [{"command": "sh …"}]}}

Implementations

impl HookSettingsShape

pub fn command_fragment(self, native_event: &str, command: &str) -> Value

The fragment that registers one command under one native event.

pub fn validate_fragment(self, fragment: &Value) -> Result<()>

Refuse anything that is not a hooks-only fragment. A whole settings file pasted in by mistake would otherwise be merged key by key into the harness’s real one.

pub fn merge_fragment( self, settings_relpath: &str, existing: Option<&[u8]>, fragment: &Value, ) -> Result<Vec<u8>>

Merge a hooks-only fragment into the harness’s settings file, given the bytes it holds now, and return the bytes it should hold next.

Everything the user already has is kept. tuff add is re-runnable and a pack may be installed over an existing install, so a group the event already registers is not appended again; the harness would otherwise run that hook once per copy.

Trait Implementations

impl Clone for HookSettingsShape

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for HookSettingsShape

impl Debug for HookSettingsShape

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

Formats the value using the given formatter.

impl Eq for HookSettingsShape

impl PartialEq for HookSettingsShape

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for HookSettingsShape

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for HookSettingsShape