Struct LifecycleEvent 

pub struct LifecycleEvent {
    pub from_state: GovernedArtifactState,
    pub to_state: GovernedArtifactState,
    pub timestamp: String,
    pub actor: String,
    pub reason: String,
    pub ticket_ref: Option<String>,
    pub tenant_id: Option<String>,
}

Record of a lifecycle state change.

Every state transition is recorded with:

• Who/what initiated the change
• Why the change was made
• When it occurred
• Optional reference to approval/review ticket

Audit Trail

LifecycleEvents form an append-only audit trail that captures the full history of an artifact’s governance journey.

Fields

from_state: GovernedArtifactState

Previous state

to_state: GovernedArtifactState

New state

timestamp: String

ISO 8601 timestamp

actor: String

Who or what initiated the change (user, system, policy engine)

reason: String

Reason for the state change

ticket_ref: Option<String>

Optional link to approval/review ticket

tenant_id: Option<String>

Optional tenant scope (if transition is tenant-specific)

Implementations

impl LifecycleEvent

pub fn new( from_state: GovernedArtifactState, to_state: GovernedArtifactState, actor: impl Into<String>, reason: impl Into<String>, ) -> LifecycleEvent

Create a new lifecycle event with current timestamp.

Note: For portability, this uses a simple ISO 8601 string. Production systems should inject the timestamp from a trusted source.

pub fn with_ticket(self, ticket: impl Into<String>) -> LifecycleEvent

Add a ticket reference.

pub fn with_tenant(self, tenant_id: impl Into<String>) -> LifecycleEvent

Add tenant scope.

pub fn with_timestamp(self, timestamp: impl Into<String>) -> LifecycleEvent

Set explicit timestamp (for replay/testing).

Trait Implementations

impl Clone for LifecycleEvent

fn clone(&self) -> LifecycleEvent

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LifecycleEvent

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LifecycleEvent

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LifecycleEvent

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.