Skip to main content

receipts_core/
lib.rs

1pub mod compiler;
2pub mod schema;
3
4pub use compiler::artifacts::ArtifactRef;
5pub use compiler::contradictions::detect_auto_contradictions;
6pub use compiler::evidence::{PacketValidationError, validate_packet_sources};
7pub use compiler::journal::{JournalEvent, append_decision_log, append_event_jsonl};
8pub use compiler::lookup::lookup_sources;
9pub use compiler::packets::{CompilerInputBundle, build_next_pass_packet};
10pub use compiler::promotion::{PromotionCandidate, promotion_record_from_candidate};
11pub use compiler::receipts::{
12    append_receipt, git_tree_state, load_verified_receipts, store_artifact,
13};
14pub use compiler::signals::detect_recurring_failure_patterns;
15pub use compiler::snapshot::{SnapshotValidationError, build_snapshot};
16pub use compiler::trust::{PacketizableItem, TrustAssessment, TrustDecision, assess_packet_item};
17
18#[cfg(test)]
19mod contract_tests {
20    use serde_json::Value;
21
22    #[test]
23    fn bundled_schemas_are_valid_json() {
24        for schema in [
25            include_str!("../schemas/next_pass_packet.schema.json"),
26            include_str!("../schemas/snapshot.schema.json"),
27            include_str!("../schemas/decision_log_record.schema.json"),
28            include_str!("../schemas/promotion_record.schema.json"),
29        ] {
30            let parsed: Value = serde_json::from_str(schema).expect("schema must parse");
31            assert_eq!(
32                parsed["$schema"],
33                "https://json-schema.org/draft/2020-12/schema"
34            );
35        }
36    }
37
38    #[test]
39    fn next_pass_packet_schema_exposes_evidence_contract() {
40        let parsed: Value =
41            serde_json::from_str(include_str!("../schemas/next_pass_packet.schema.json"))
42                .expect("schema must parse");
43
44        let required = parsed["required"].as_array().expect("required array");
45        assert!(required.iter().any(|value| value == "evidence"));
46        assert!(
47            required.iter().any(|value| value == "schema_version"),
48            "packet schema must require schema_version"
49        );
50        let versions = parsed["properties"]["schema_version"]["enum"]
51            .as_array()
52            .expect("schema_version enum");
53        assert!(
54            versions.iter().any(|value| value == "2.0.0")
55                && versions.iter().any(|value| value == "1.2.0")
56                && versions.iter().any(|value| value == "1.1.0"),
57            "packet schema_version enum must cover current + legacy versions"
58        );
59        assert!(parsed["$defs"]["evidenceRecord"].is_object());
60        assert!(parsed["$defs"]["evidenceRecord"]["properties"]["source_refs"].is_object());
61        assert!(parsed["$defs"]["verifierFinding"]["properties"]["source_refs"].is_object());
62        let source_ref_required = parsed["$defs"]["sourceRef"]["required"]
63            .as_array()
64            .expect("sourceRef.required");
65        assert!(
66            source_ref_required.iter().any(|value| value == "hash_alg"),
67            "sourceRef must require hash_alg"
68        );
69        assert_eq!(
70            parsed["$defs"]["sourceRef"]["properties"]["hash"]["pattern"],
71            "^(?:[0-9a-f]{16}|[0-9a-f]{64})$",
72            "sourceRef.hash must cover legacy FNV and BLAKE3-256 digest shapes"
73        );
74        let hash_algs = parsed["$defs"]["sourceRef"]["properties"]["hash_alg"]["enum"]
75            .as_array()
76            .expect("hash_alg enum");
77        assert!(hash_algs.iter().any(|value| value == "fnv1a-64"));
78        assert!(hash_algs.iter().any(|value| value == "blake3-256"));
79        assert!(
80            parsed["$defs"]["haltSignal"]["required"]
81                .as_array()
82                .expect("halt signal required")
83                .iter()
84                .any(|value| value == "source_ids")
85        );
86    }
87
88    #[test]
89    fn snapshot_schema_exposes_source_integrity_contract() {
90        let parsed: Value = serde_json::from_str(include_str!("../schemas/snapshot.schema.json"))
91            .expect("snapshot schema must parse");
92
93        let required = parsed["required"].as_array().expect("required array");
94        assert!(
95            required.iter().any(|value| value == "schema_version"),
96            "snapshot schema must require schema_version"
97        );
98        assert_eq!(
99            parsed["$defs"]["sourceRef"]["properties"]["hash_alg"]["enum"][0]
100                .as_str()
101                .unwrap_or_default(),
102            "fnv1a-64",
103            "snapshot sourceRef.hash_alg must enumerate fnv1a-64"
104        );
105    }
106
107    #[test]
108    fn decision_log_schema_matches_raw_record_contract() {
109        let parsed: Value =
110            serde_json::from_str(include_str!("../schemas/decision_log_record.schema.json"))
111                .expect("schema must parse");
112
113        let required = parsed["required"].as_array().expect("required array");
114        assert!(required.iter().any(|value| value == "decision_kind"));
115        assert!(required.iter().all(|value| value != "payload"));
116    }
117}