Struct TemporalKnowledgeGraph 

pub struct TemporalKnowledgeGraph { /* private fields */ }

A temporal knowledge graph that records how facts and relationships change.

All mutations are timestamped and appended to an internal timeline, enabling point-in-time queries and full history replay.

Implementations

impl TemporalKnowledgeGraph

pub fn new() -> Self

Create a new, empty temporal knowledge graph.

pub fn add_node(&mut self, label: String, ts: u64) -> Result<NodeId, TkgError>

Add a node with the given label at timestamp ts.

Returns the new NodeId on success.

pub fn delete_node(&mut self, id: NodeId, ts: u64) -> Result<(), TkgError>

Soft-delete node id at timestamp ts.

pub fn add_edge( &mut self, src: NodeId, dst: NodeId, relation: String, weight: f64, valid_from: u64, ) -> Result<EdgeId, TkgError>

Add an edge from src to dst with the given relation, weight, and start timestamp valid_from.

Both endpoint nodes must exist (not deleted) at valid_from.

pub fn delete_edge(&mut self, id: EdgeId, ts: u64) -> Result<(), TkgError>

Soft-delete edge id at timestamp ts.

pub fn set_property( &mut self, id: NodeId, key: String, value: String, ts: u64, ) -> Result<(), TkgError>

Set (or overwrite) a property on node id at timestamp ts.

pub fn query(&self, q: TkgQuery) -> TkgQueryResult

Execute a TkgQuery and return a TkgQueryResult.

pub fn snapshot_at(&self, t: u64) -> TkgSnapshot

Return a point-in-time snapshot: all nodes and edges valid at t.

pub fn temporal_path( &self, src: NodeId, dst: NodeId, at_t: u64, ) -> Option<Vec<NodeId>>

BFS to find a path from src to dst using only edges valid at at_t.

Returns None if no path exists or if either endpoint does not exist at at_t.

pub fn merge_graphs(&mut self, other: &Self, policy: TkgMergePolicy)

Merge other into self according to policy.

• TkgMergePolicy::KeepMine — on ID collision keep self’s data.
• TkgMergePolicy::KeepOther — on ID collision keep other’s data.
• TkgMergePolicy::UnionAll — keep all data; on ID collision prefer other.

pub fn stats(&self) -> TkgGraphStats

Compute aggregate statistics for the graph.

pub fn get_node(&self, id: NodeId) -> Option<&TkgNode>

Return a reference to the node with the given id, if it exists.

pub fn get_edge(&self, id: EdgeId) -> Option<&TkgEdge>

Return a reference to the edge with the given id, if it exists.

pub fn events_at(&self, ts: u64) -> &[TkgEvent]

Return all events recorded at exactly timestamp ts.

pub fn timeline_iter(&self) -> impl Iterator<Item = (u64, &[TkgEvent])>

Iterate over the timeline in chronological order.

pub fn node_count(&self) -> usize

Number of nodes (including deleted).

pub fn edge_count(&self) -> usize

Number of edges (including expired).

Trait Implementations

impl Clone for TemporalKnowledgeGraph

fn clone(&self) -> TemporalKnowledgeGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TemporalKnowledgeGraph

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

Formats the value using the given formatter.

impl Default for TemporalKnowledgeGraph

fn default() -> Self

Returns the “default value” for a type.