aa-gateway 0.0.1-beta.1

Control plane — policy enforcement engine and agent registry for Agent Assembly
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

//! Version metadata for a stored policy snapshot.

use serde::{Deserialize, Serialize};

/// Metadata sidecar for a versioned policy snapshot.
///
/// Persisted as `<timestamp>-<sha256-prefix>.meta.json` alongside
/// the YAML snapshot in the history directory.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PolicyVersionMeta {
    /// ISO 8601 UTC timestamp when the policy was applied.
    pub timestamp: String,
    /// Hex-encoded SHA-256 digest of the YAML content.
    pub sha256: String,
    /// Identity of the user or system that applied this version.
    pub applied_by: Option<String>,
    /// Original file path from which the policy was loaded.
    pub source_path: Option<String>,
    /// ISO 8601 UTC timestamp of the first event evaluated under this policy version.
    pub first_event_covered: Option<String>,
    /// Whether this version was created by a rollback operation.
    pub is_rollback: bool,
    /// Version identifier of the rollback target (set when `is_rollback` is true).
    pub rollback_target: Option<String>,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn meta_construction_with_required_fields() {
        let meta = PolicyVersionMeta {
            timestamp: "2026-04-28T12:00:00Z".to_string(),
            sha256: "abcdef1234567890".to_string(),
            applied_by: None,
            source_path: None,
            first_event_covered: None,
            is_rollback: false,
            rollback_target: None,
        };
        assert_eq!(meta.timestamp, "2026-04-28T12:00:00Z");
        assert!(!meta.is_rollback);
    }

    #[test]
    fn meta_json_round_trip() {
        let meta = PolicyVersionMeta {
            timestamp: "2026-04-28T12:00:00Z".to_string(),
            sha256: "abcdef1234567890".to_string(),
            applied_by: Some("alice".to_string()),
            source_path: Some("/etc/aa/policy.yaml".to_string()),
            first_event_covered: None,
            is_rollback: false,
            rollback_target: None,
        };
        let json = serde_json::to_string(&meta).unwrap();
        let deserialized: PolicyVersionMeta = serde_json::from_str(&json).unwrap();
        assert_eq!(meta, deserialized);
    }

    #[test]
    fn meta_rollback_fields() {
        let meta = PolicyVersionMeta {
            timestamp: "2026-04-28T13:00:00Z".to_string(),
            sha256: "fedcba0987654321".to_string(),
            applied_by: Some("ops-bot".to_string()),
            source_path: None,
            first_event_covered: Some("2026-04-28T13:01:00Z".to_string()),
            is_rollback: true,
            rollback_target: Some("abcdef1234567890".to_string()),
        };
        assert!(meta.is_rollback);
        assert_eq!(meta.rollback_target.as_deref(), Some("abcdef1234567890"));
    }
}