Struct CommandContext 

pub struct CommandContext {
    pub actor_id: String,
    pub session_id: Option<String>,
    pub source_ip: Option<String>,
    pub user_agent: Option<String>,
    pub correlation_id: Uuid,
    pub causation_id: Option<Uuid>,
}

Request-scoped context for command dispatch.

Constructed once per HTTP request (or by CommandContext::system for internal jobs). Carries the data needed to build AuditMetadata for every event the command produces.

Fields

actor_id: String

Required. Aggregate UUID, "system", "anonymous", or "legacy-pre-hipaa". Must be non-empty.

session_id: Option<String>

Optional session id (paired with HIPAA-4 server-side session store).

source_ip: Option<String>

Source IP. None for system jobs.

user_agent: Option<String>

User-Agent header.

correlation_id: Uuid

Required. Groups every event from one logical request together.

causation_id: Option<Uuid>

Optional event id that triggered this command (saga / projection follow-up).

Implementations

impl CommandContext

pub fn for_actor(actor_id: impl Into<String>) -> Self

Convenience for an authenticated HTTP request. Synthesizes correlation_id if not supplied by the caller.

pub fn system() -> Self

System-internal context (cron, seeders, migrations).

pub fn caused_by(actor_id: impl Into<String>, triggering: &Event) -> Self

Build a context whose causation chains from a triggering event. Inherit the upstream correlation_id so the saga is traceable end-to-end.

pub fn to_audit(&self) -> Result<AuditMetadata, AuditError>

Convert into the AuditMetadata that will stamp produced events. Sets timestamp_utc_us = now. Validates before returning.

Trait Implementations

impl Clone for CommandContext

fn clone(&self) -> CommandContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CommandContext

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

Formats the value using the given formatter.