Struct HookGateRecord 

pub struct HookGateRecord {
    pub v: u32,
    pub ts: DateTime<Utc>,
    pub gate: String,
    pub hook_event: String,
    pub tool: String,
    pub subject: String,
    pub verdict: String,
    pub detail: Option<String>,
    pub session_id: Option<String>,
    pub tool_use_id: Option<String>,
}

One structured hook outcome, appended as one JSON line to record_file by kranz hook-guard. Session-writable evidence — parsed tolerantly, never trusted (see module docs).

Fields

v: u32

SPEC_VERSION at write time.

ts: DateTime<Utc>

gate: String

Gate identity (HOOK_GATE_ID).

hook_event: String

The lifecycle event that fired ("PreToolUse").

tool: String

The tool whose call was judged (Write, Edit, …).

subject: String

The judged target: the repo-relative path when it resolved inside the checkout, else the raw path / (unresolved).

verdict: String

"blocked" (the write was refused in-process) or "error" (the guard itself failed open — the action proceeded and only the engine-side sweep can judge it).

detail: Option<String>

The guard’s reason / error note.

session_id: Option<String>

The CLI’s session id from the hook payload, when present.

tool_use_id: Option<String>

The CLI’s tool-use id from the hook payload, when present.

Implementations

impl HookGateRecord

pub fn blocked( spec: &HookGateSpec, hook_event: &str, tool: &str, subject: &str, reason: &str, session_id: Option<&str>, tool_use_id: Option<&str>, ) -> Self

A blocked record for one refused tool call.

pub fn error(spec: &HookGateSpec, note: &str) -> Self

An error record: the guard loaded its spec but could not judge (unparseable hook payload, missing tool name) and failed open.

pub fn append_to(&self, record_file: &Path) -> Result<()>

Append this record as one JSON line to record_file. Best-effort by the caller: an append failure never changes the exit verdict.

Trait Implementations

impl Clone for HookGateRecord

fn clone(&self) -> HookGateRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HookGateRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HookGateRecord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for HookGateRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.