stack-ids 0.1.2

Shared identity, scope, trace, and digest primitives for the local-first AI systems stack
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

//! Receipt module for stack-ids.
//!
//! Receipts are emitted at the crate's canonical output boundary for auditability.

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

/// Audit receipt for stack-ids operations.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CrateReceiptV1 {
    pub crate_name: &'static str,
    pub operation: String,
    pub timestamp: DateTime<Utc>,
    pub digest: String,
    pub outcome: Outcome,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum Outcome {
    Success,
    Failure { reason: String },
}

impl CrateReceiptV1 {
    /// Emit a success receipt.
    pub fn success(operation: impl Into<String>, digest: impl Into<String>) -> Self {
        Self {
            crate_name: env!("CARGO_PKG_NAME"),
            operation: operation.into(),
            timestamp: Utc::now(),
            digest: digest.into(),
            outcome: Outcome::Success,
        }
    }

    /// Emit a failure receipt.
    pub fn failure(operation: impl Into<String>, digest: impl Into<String>, reason: impl Into<String>) -> Self {
        Self {
            crate_name: env!("CARGO_PKG_NAME"),
            operation: operation.into(),
            timestamp: Utc::now(),
            digest: digest.into(),
            outcome: Outcome::Failure { reason: reason.into() },
        }
    }
}