Struct Edge 

pub struct Edge {
    pub target: ObjectId,
    pub kind: EdgeKind,
    pub weight: f32,
    pub valid_from: u64,
    pub valid_to: u64,
    pub properties: HashMap<String, SochValue>,
}

A directed, typed, weighted, temporally-versioned edge between two Knowledge Objects.

Edges are embedded within the source object — when you load an object, you immediately have its outgoing relationships. This eliminates the separate graph lookup required by KV-backed edge stores.

Memory Layout (32 bytes per edge)

Field	Size	Purpose
target	32B	Target ObjectId (BLAKE3 hash)
kind	~24B	Edge type (enum + string)
weight	4B	Relationship strength [0.0, 1.0]
valid_from	8B	Temporal validity start
valid_to	8B	Temporal validity end
properties	var	Optional edge attributes

For the hot path (CSR-based graph traversal), edges are projected to (target_internal_id: u32, weight: f32) for cache efficiency.

Fields

target: ObjectId

Target object this edge points to.

kind: EdgeKind

The type/kind of this relationship.

weight: f32

Relationship strength/confidence in [0.0, 1.0].

• 1.0 = definitive relationship
• 0.5 = probable relationship
• 0.0 = hypothetical/weak relationship

valid_from: u64

Temporal validity interval for this edge. Uses the same HLC-encoded microsecond format as BitemporalCoord.

valid_to: u64

End of temporal validity (exclusive). u64::MAX = still valid.

properties: HashMap<String, SochValue>

Optional edge properties (e.g., “role”: “lead”, “confidence”: 0.95).

Implementations

impl Edge

pub fn new(target: ObjectId, kind: EdgeKind, weight: f32) -> Self

Create a new edge with default weight 1.0 and open-ended validity.

pub fn with_validity( target: ObjectId, kind: EdgeKind, weight: f32, valid_from: u64, valid_to: u64, ) -> Self

Create an edge with temporal validity.

pub fn with_property(self, key: impl Into<String>, value: SochValue) -> Self

Add a property to this edge.

pub fn valid_at(&self, time: u64) -> bool

Check if this edge is valid at a given time.

pub fn is_current(&self) -> bool

Check if this edge is currently valid (valid_to == MAX).

Trait Implementations

impl Clone for Edge

fn clone(&self) -> Edge

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Edge

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Edge

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Edge

impl PartialEq for Edge

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Edge

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.