Struct KnowledgeSnapshot 

pub struct KnowledgeSnapshot {
    pub project_root: String,
    pub project_hash: String,
    pub facts: Vec<KnowledgeFact>,
    pub patterns: Vec<ProjectPattern>,
    pub insights: Vec<ConsolidatedInsight>,
    pub relations: Vec<KnowledgeEdge>,
}

A consistent read of a project’s knowledge (facts + patterns + insights) and its relation graph, taken at one point in time. The single source of truth for outbound renderings (ctxpkg, OKF).

Fields

project_root: String

project_hash: String

facts: Vec<KnowledgeFact>

All facts, including superseded ones (ctxpkg keeps the history).

patterns: Vec<ProjectPattern>

insights: Vec<ConsolidatedInsight>

Consolidated insights (the project’s history).

relations: Vec<KnowledgeEdge>

Typed relations between facts (relations.json).

Implementations

impl KnowledgeSnapshot

pub fn collect(project_root: &str) -> Self

Loads a project’s knowledge and relation graph from disk into one snapshot. Missing stores yield empty collections rather than an error, so callers can treat “no knowledge yet” via KnowledgeSnapshot::is_empty.

pub fn from_project( knowledge: &ProjectKnowledge, relations: Vec<KnowledgeEdge>, ) -> Self

Builds a snapshot from an already-loaded ProjectKnowledge plus its relation edges. Keeps the collection logic in one place for callers that already hold the knowledge (e.g. inside a lock).

pub fn is_empty(&self) -> bool

True when there is nothing worth exporting (no facts, patterns, or insights). Relations alone never make a bundle — they are edges between facts that, without endpoints, carry no standalone meaning.

pub fn current_facts(&self) -> Vec<&KnowledgeFact>

The current (non-superseded, temporally valid) facts — the human-facing view portable exports render. Superseded history stays in Self::facts for ctxpkg fidelity but would only confuse a hand-edited OKF bundle.

Trait Implementations

impl Clone for KnowledgeSnapshot

fn clone(&self) -> KnowledgeSnapshot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KnowledgeSnapshot

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

Formats the value using the given formatter.