Struct AttemptRecord 

pub struct AttemptRecord {

    pub id: Uuid,
    pub timestamp: DateTime<Utc>,
    pub cmd: String,
    pub cwd: String,
    pub session_id: String,
    pub tag: Option<String>,
    pub source_client: String,
    pub machine_id: Option<String>,
    pub hostname: Option<String>,
    pub executable: Option<String>,
    pub format_hint: Option<String>,
    pub metadata: HashMap<String, Value>,
    pub date: NaiveDate,
}

An attempt record (the start of a command execution).

This represents the “attempt” to run a command - recorded at invocation start. The outcome (completion) is recorded separately in OutcomeRecord.

Fields

id: Uuid

Unique identifier (UUIDv7 for time-ordering).

timestamp: DateTime<Utc>

When the attempt started.

cmd: String

The full command string.

cwd: String

Working directory when invocation was executed.

session_id: String

Session identifier (groups related invocations).

tag: Option<String>

User-defined tag (unique alias for this invocation, like git tags).

source_client: String

Client identifier (user@hostname or application name).

machine_id: Option<String>

Machine identifier (for multi-machine setups).

hostname: Option<String>

Hostname where invocation was executed.

executable: Option<String>

Extracted executable name (e.g., “make” from “make test”).

format_hint: Option<String>

Detected output format (e.g., “gcc”, “pytest”).

metadata: HashMap<String, Value>

Extensible metadata (user-defined key-value pairs). Stored as MAP(VARCHAR, JSON) in DuckDB.

date: NaiveDate

Date for partitioning.

Implementations

impl AttemptRecord

pub fn new( session_id: impl Into<String>, cmd: impl Into<String>, cwd: impl Into<String>, source_client: impl Into<String>, ) -> Self

Create a new attempt record.

If BIRD_INVOCATION_UUID is set in the environment, uses that UUID to enable deduplication across nested BIRD clients.

pub fn with_id( id: Uuid, session_id: impl Into<String>, cmd: impl Into<String>, cwd: impl Into<String>, source_client: impl Into<String>, ) -> Self

Create an attempt record with an explicit UUID.

pub fn with_tag(self, tag: impl Into<String>) -> Self

Set the tag (unique alias for this invocation).

pub fn with_machine_id(self, machine_id: impl Into<String>) -> Self

Set the machine ID.

pub fn with_format_hint(self, hint: impl Into<String>) -> Self

Set the format hint.

pub fn with_metadata(self, key: impl Into<String>, value: Value) -> Self

Add metadata entry.

pub fn date(&self) -> NaiveDate

Get the date portion of the timestamp (for partitioning).

Trait Implementations

impl Clone for AttemptRecord

fn clone(&self) -> AttemptRecord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AttemptRecord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AttemptRecord

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AttemptRecord

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

where __S: Serializer,

Serialize this value into the given Serde serializer.