Struct AuditLogger 

pub struct AuditLogger { /* private fields */ }

Async writer that appends AuditEntry records to a structured JSONL log.

Create via AuditLogger::from_config and share behind an Arc. Each executor that should emit audit records accepts the logger via a builder method (e.g. ShellExecutor::with_audit).

Thread safety

File writes are serialized through an internal tokio::sync::Mutex<File>. Multiple concurrent log calls are safe but may block briefly on the mutex.

Implementations

impl AuditLogger

pub async fn from_config( config: &AuditConfig, tui_mode: bool, ) -> Result<Self, Error>

Create a new AuditLogger from config.

When tui_mode is true and config.destination is "stdout", the destination is redirected to a file (audit.jsonl in the current directory) to avoid corrupting the TUI output with raw JSON lines.

Errors

Returns an error if a file destination cannot be opened.

pub async fn log(&self, entry: &AuditEntry)

Serialize entry to JSON and append it to the configured destination.

Serialization errors are logged via tracing::error! and silently swallowed so that audit failures never interrupt tool execution.

pub async fn log_egress(&self, event: &EgressEvent)

Serialize an EgressEvent onto the same JSONL destination as AuditEntry.

Ordering with respect to AuditLogger::log is preserved by the shared tokio::sync::Mutex<File> that serializes all writes on the same destination.

Serialization errors are logged via tracing::error! and silently swallowed so that egress logging failures never interrupt tool execution.

Trait Implementations

impl Debug for AuditLogger

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

Formats the value using the given formatter.