Struct AuditEvent 

pub struct AuditEvent {
    pub timestamp: DateTime<Utc>,
    pub actor: ActorRef,
    pub namespace: String,
    pub verb: String,
    pub decision: AuditDecision,
    pub deny_reason: Option<String>,
    pub obligations: Vec<Obligation>,
    pub gate_impl: String,
    pub session_id: Option<String>,
}

Structured audit record emitted once per gate consultation (ADR-033).

The JSON projection of this struct is the public contract — field names are stable. Adding fields is non-breaking; removing or renaming requires a new ADR.

In v0.2 events are emitted via tracing::info! as structured JSON. The EventStore write path is deferred to v0.3 when the VerbRegistry gains a runtime handle (see ADR-033 §“Implementation Status”).

Fields

timestamp: DateTime<Utc>

Wall-clock timestamp of the gate check (UTC, RFC3339 in JSON).

actor: ActorRef

Caller identity as given to the gate.

namespace: String

Namespace in which the verb was invoked.

verb: String

Verb being dispatched.

decision: AuditDecision

Gate outcome — "allow" or "deny".

deny_reason: Option<String>

Deny reason, present only when decision == "deny".

obligations: Vec<Obligation>

Obligations attached by the policy on Allow (empty array on Deny). Always serialized — obligations: [] is the wire shape when there are none, so non-Rust consumers do not need to special-case absence vs. emptiness.

gate_impl: String

Name of the gate implementation that produced this decision.

session_id: Option<String>

Correlation token — GateContext::session_id when present, else None.

Implementations

impl AuditEvent

pub fn from_check( req: &GateRequest, decision: &GateDecision, gate_impl: &str, ) -> AuditEvent

Build an AuditEvent from the gate inputs and output.

Trait Implementations

impl Clone for AuditEvent

fn clone(&self) -> AuditEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuditEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AuditEvent

fn deserialize<__D>( __deserializer: __D, ) -> Result<AuditEvent, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AuditEvent

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

where __S: Serializer,

Serialize this value into the given Serde serializer.