Function triage_reference

atomic-canonical/src/triage_ref.rs:45–53

The `urn:atomic:triage: ` reference for a set of pins. `candidate_changes` is sorted before hashing so a triage over the same set of changes in a different order produces the same reference. The map is already canonical (BTreeMap), and JCS sorts object keys, so the reference is a pure function of the pinned facts.

(pins: &TriagePins)

/// canonical (BTreeMap), and JCS sorts object keys, so the reference is a pure
/// function of the pinned facts.
pub fn triage_reference(pins: &TriagePins) -> String {
    let mut canonical_pins = pins.clone();
    canonical_pins.candidate_changes.sort();
    let value =
        serde_json::to_value(&canonical_pins).expect("TriagePins serialization is infallible");
    let canonical = jcs::canonicalize(&value);
    let digest = blake3::hash(canonical.as_bytes());
    format!("urn:atomic:triage:{}", digest.to_hex())
}

/// Recompute the reference for `pins` and compare it to `reference`. True iff the
/// pins hash to exactly this reference (order-insensitive for candidate changes).