Struct Node 

pub struct Node {
    pub id: String,
    pub title: String,
    pub category: Option<String>,
    pub source_id: Option<String>,
    pub is_canonical: bool,
    pub canonical_id: Option<String>,
    pub node_type: NodeType,
    pub metadata: HashMap<String, Value>,
}

A node in the knowledge graph.

Nodes represent content items (concepts, theorems, chapters, etc.). The metadata field stores domain-specific attributes as key-value pairs.

Fields

id: String

Unique identifier (e.g., “picardy-third”, “group-theory”).

title: String

Human-readable title.

category: Option<String>

Optional category for grouping (e.g., “harmony”, “algebra”).

source_id: Option<String>

Optional source identifier (e.g., “tymoczko”, “dummit-foote”).

is_canonical: bool

Whether this is a canonical node (vs. source-specific variant).

canonical_id: Option<String>

If not canonical, the ID of the canonical node this relates to.

node_type: NodeType

Type of this node (Domain, UserQuery, Custom).

metadata: HashMap<String, Value>

Domain-specific metadata as key-value pairs.

Implementations

impl Node

pub fn new(id: impl Into<String>, title: impl Into<String>) -> Self

Creates a new canonical domain node with the given ID and title.

pub fn with_category(self, category: impl Into<String>) -> Self

Sets the category.

pub fn with_source(self, source_id: impl Into<String>) -> Self

Sets the source ID.

pub fn as_variant_of(self, canonical_id: impl Into<String>) -> Self

Marks this as a variant of a canonical node.

pub fn with_node_type(self, node_type: NodeType) -> Self

Sets the node type.

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

Adds a metadata key-value pair.

Trait Implementations

impl Clone for Node

fn clone(&self) -> Node

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Node

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Node

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&Node> for NodeSummary

fn from(node: &Node) -> Self

Converts to this type from the input type.

impl PartialEq for Node

fn eq(&self, other: &Node) -> 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 Node

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Node