Struct KnowledgeRelationGraph 

pub struct KnowledgeRelationGraph {
    pub project_hash: String,
    pub edges: Vec<KnowledgeEdge>,
    pub updated_at: DateTime<Utc>,
    /* private fields */
}

Fields

project_hash: String

edges: Vec<KnowledgeEdge>

updated_at: DateTime<Utc>

Implementations

impl KnowledgeRelationGraph

pub fn new(project_hash: &str) -> Self

pub fn path(project_hash: &str) -> Result<PathBuf, String>

pub fn load(project_hash: &str) -> Option<Self>

pub fn load_or_create(project_hash: &str) -> Self

pub fn mutate_locked<T>( project_root: &str, project_hash: &str, change: impl FnOnce(&mut Self) -> Option<T>, ) -> Result<Option<T>, String>

Load, change and save the graph under the project’s knowledge lock, the in-process and cross-process lock fact edits and the cognition loop hold, so a concurrent writer (another process, the dashboard, the cognition loop) never loses an edge. change returns None when it changed nothing; the graph is then not written. Must not be called while that lock is held.

pub fn save(&mut self) -> Result<(), String>

pub fn upsert_edge( &mut self, from: KnowledgeNodeRef, to: KnowledgeNodeRef, kind: KnowledgeEdgeKind, session_id: &str, ) -> bool

pub fn remove_edge( &mut self, from: &KnowledgeNodeRef, to: &KnowledgeNodeRef, kind: Option<KnowledgeEdgeKind>, ) -> usize

pub fn enforce_cap(&mut self, max_edges: usize) -> bool

pub fn strengthen_edge( &mut self, from: &KnowledgeNodeRef, to: &KnowledgeNodeRef, amount: f64, ) -> bool

Hebbian strengthening: saturating formula so strength approaches but never exceeds 1.0

pub fn decay_all_edges(&mut self, days_elapsed: f64)

Time-based exponential decay on all edge strengths

pub fn prune_weak_edges(&mut self, threshold: f64) -> usize

Remove edges whose strength has fallen below threshold

pub fn incident_edges(&self, node: &KnowledgeNodeRef) -> Vec<&KnowledgeEdge>

Returns only the edges incident to node, using the load-time index.

Trait Implementations

impl Clone for KnowledgeRelationGraph

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KnowledgeRelationGraph

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

Formats the value using the given formatter.

impl Default for KnowledgeRelationGraph

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for KnowledgeRelationGraph

where KnowledgeRelationGraph: Default,

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KnowledgeRelationGraph

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

where __S: Serializer,

Serialize this value into the given Serde serializer.