Struct Node 

pub struct Node {
    pub key: String,
    pub kind: NodeKind,
    pub name: String,
    pub path: Option<String>,
    pub lang: Option<String>,
    pub blob_hash: Option<String>,
    pub span: Option<Span>,
    pub provenance: Provenance,
    pub meta: Value,
}

A node in the knowledge graph.

Node::key is the deterministic natural identity used for upserts (e.g. sym:rust:src/lib.rs#Store); the database row id is an internal detail.

Fields

key: String

Deterministic, unique natural key.

kind: NodeKind

The kind of thing this node represents.

name: String

Human-facing name (need not be unique).

path: Option<String>

Repository-relative source path, if any.

lang: Option<String>

Language token (e.g. rust), if applicable.

blob_hash: Option<String>

Git blob hash this node was extracted from, if applicable.

span: Option<Span>

Byte span within the source blob, if applicable.

provenance: Provenance

Which layer produced this node: Provenance::Derived (tree-sitter extraction), Provenance::Authored (ADR/blueprint/lat sections), or Provenance::Inferred (Graphify import). Lets layer-scoped operations — e.g. a derived-only incremental sync — target one layer without disturbing the others.

Defaults to Derived when absent — correct for a legacy extraction object-cache entry (derived-only) written before this field existed. A legacy persisted import layer also deserializes its nodes as Derived, but the store repairs that on load (an import node is never derived), so the default never mislabels a durable import layer.

meta: Value

Arbitrary structured metadata.

Implementations

impl Node

pub fn new( key: impl Into<String>, kind: NodeKind, name: impl Into<String>, ) -> Self

Construct a node with the given key, kind, and name; all optional fields unset, meta null, and provenance Provenance::Derived (extraction is the common case — authored/inferred producers call Node::with_provenance).

pub fn with_provenance(self, provenance: Provenance) -> Self

Set the producing layer, returning the node (builder style). Used by the authored (ADR/blueprint/lat) and inferred (Graphify) producers.

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 Eq for Node

impl PartialEq for Node

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

Equality operator ==.

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

Inequality operator !=.

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