uor-foundation 0.3.0

UOR Foundation — typed Rust traits for the complete ontology. Import and implement.
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

// @generated by uor-crate from uor-ontology — do not edit manually

//! `parallel/` namespace — Independent computations over provably disjoint site budgets. Formalizes when execution order is irrelevant..
//!
//! Space: Kernel

use crate::HostTypes;

/// A ∥ B: two computations with provably disjoint site targets. Execution order does not affect the result.
pub trait ParallelProduct<H: HostTypes> {
    /// Associated type for `MonoidalProduct`.
    type MonoidalProduct: crate::kernel::monoidal::MonoidalProduct<H>;
    /// The left parallel component (itself a sequential computation).
    fn left_computation(&self) -> &Self::MonoidalProduct;
    /// The right parallel component.
    fn right_computation(&self) -> &Self::MonoidalProduct;
    /// Associated type for `DisjointnessCertificate`.
    type DisjointnessCertificate: DisjointnessCertificate<H>;
    /// The certificate proving site disjointness.
    fn disjointness_cert(&self) -> &Self::DisjointnessCertificate;
    /// True iff site targets have zero overlap (no SynchronizationPoints required).
    fn is_fully_disjoint(&self) -> bool;
    /// Declares whether this parallel product commutes with disjoint effects per FX_4.
    fn disjointness_commutation(&self) -> bool;
    /// Associated type for `Partition`.
    type Partition: crate::bridge::partition::Partition<H>;
    /// The partition:Partition this parallel product is over.
    fn site_partition(&self) -> &Self::Partition;
    /// IRI of a proof of pairwise disjointness of the partition components.
    fn disjointness_witness(&self) -> &H::HostString;
}

/// A kernel-produced certificate attesting that the site targets of two computations are disjoint.
pub trait DisjointnessCertificate<H: HostTypes>: crate::bridge::cert::Certificate<H> {
    /// Associated type for `EffectTarget`.
    type EffectTarget: crate::kernel::effect::EffectTarget<H>;
    /// The site target of the left computation.
    fn cert_left_target(&self) -> &Self::EffectTarget;
    /// The site target of the right computation.
    fn cert_right_target(&self) -> &Self::EffectTarget;
}

/// A point where two parallel computations must agree on shared state before proceeding. Only applicable when parallelism is partial.
pub trait SynchronizationPoint<H: HostTypes> {
    /// Associated type for `SiteIndex`.
    type SiteIndex: crate::bridge::partition::SiteIndex<H>;
    /// The shared sites requiring synchronization.
    fn sync_sites(&self) -> &[Self::SiteIndex];
}

/// A computation trace recording interleaved steps from two parallel computations. Valid iff every interleaving produces the same final context.
pub trait ParallelTrace<H: HostTypes>: crate::bridge::trace::ComputationTrace<H> {}

/// A partition of the total site budget into disjoint subsets, one per parallel component. The sum of subset cardinalities equals the total site budget.
pub trait SitePartitioning<H: HostTypes> {
    /// Associated type for `EffectTarget`.
    type EffectTarget: crate::kernel::effect::EffectTarget<H>;
    /// The disjoint subsets composing the full site budget.
    fn partition_components(&self) -> &[Self::EffectTarget];
    /// Number of parallel components.
    fn component_count(&self) -> u64;
}