Module graph 

Graph sub-module — CachedGraphStore, persistent graph/activation/Hebbian, causal reasoning, and graph store trait.

Re-exports core graph types from hirn_graph::graph for backward compatibility.

Modules

cached_graph_store

Two-tier graph store: in-memory hot cache backed by persistent cold tier.

causal

Causal reasoning, trust scoring, and contradiction detection.

graph_store

F-003 FIX: Unified async graph store trait.

persistent_activation

Async spreading activation on PersistentGraph.

persistent_graph

LanceDB-backed persistent graph engine.

persistent_hebbian

Async Hebbian learning on PersistentGraph.

Structs

CausalEdgeData

Data carried only on causal edges — boxed to keep GraphEdge small for the common non-causal case.

ConnectBuilder

Builder for creating graph edges.

GraphEdge

A typed, weighted edge in the property graph.

GraphNodeData

Minimal node data for persistence.

GraphSnapshot

Serialized form for persisting all edges.

PropertyGraph

In-memory property graph backed by petgraph’s directed graph.

Enums

CausalDirection

Causal direction for Rich CausalEdge.

Constants

MAX_EDGES_PER_NODE

Maximum number of edges per node (fan-out cap). Prevents graph injection attacks where a malicious agent floods a node with edges.

MAX_EDGE_METADATA_BYTES

Maximum logical metadata payload allowed on a single edge. Enforced on insert to keep hot-tier graph memory bounded.

Functions

edge_metadata_bytes

validate_edge_metadata

Type Aliases

EdgeId

A unique identifier for a graph edge.