Struct GraphBuilder 

pub struct GraphBuilder<E: GraphExtractor> { /* private fields */ }

Builder for constructing knowledge graphs.

Generic over E: GraphExtractor to support any domain.

Caching

When a cache path is configured via with_cache_path, the builder checks if the cached graph is fresh before rebuilding. On cache hit, the graph is loaded from disk in milliseconds instead of re-parsing all content files.

Implementations

impl<E: GraphExtractor> GraphBuilder<E>

pub fn new(extractor: E) -> Self

Creates a new builder with the given extractor.

pub fn with_content_path(self, path: impl Into<PathBuf>) -> Self

Sets the content directory path.

pub fn with_manual_edges(self, path: impl Into<PathBuf>) -> Self

Adds manual edges from a JSON file (Amendment §2f-iii).

pub fn with_error_handling(self, handling: ErrorHandling) -> Self

Sets the error handling strategy.

pub fn with_cache_path(self, path: impl Into<PathBuf>) -> Self

Sets the cache file path for graph persistence.

When set, the builder will:

1. Check if the cache is fresh before building (by comparing content hashes)
2. Load from cache on hit (fast path)
3. Save to cache after a successful build (for next time)

pub fn skip_cache(self) -> Self

Forces a rebuild even if the cache is fresh.

pub async fn build(self) -> Result<(GraphData, BuildStats)>

Builds the graph.

Uses a two-phase approach (adapted from Taproot):

• Phase 1: Extract and add all nodes
• Phase 2: Extract and add all edges (with dedup and dangling ref tracking)

If a cache path is configured and the cache is fresh, loads from cache instead.