Struct GraphWalk 

pub struct GraphWalk {
    pub direction: WalkDirection,
    pub weight_floor: Option<f64>,
    pub max_hops: u32,
    pub max_neighbors_per_hop: Option<usize>,
    pub relation_filter: Option<String>,
}

Traversal parameters. Every caller states its own explicitly.

Fields

direction: WalkDirection

Directed or bidirectional edge following.

weight_floor: Option<f64>

Minimum edge weight; None follows every edge regardless of weight.

max_hops: u32

Maximum hop distance from the seeds.

max_neighbors_per_hop: Option<usize>

Keep only the first k unvisited neighbours of each expansion.

relation_filter: Option<String>

Follow only edges carrying this relation label.

Implementations

impl GraphWalk

pub fn directed(min_weight: f64, max_hops: u32) -> Self

Directed walk with a weight floor — the shape used by recall, hybrid-search and deep-research.

pub fn bidirectional(min_weight: f64, max_hops: u32) -> Self

Bidirectional walk with a weight floor — the shape used by related.

pub fn with_neighbor_cap(self, cap: Option<usize>) -> Self

Sets the per-expansion neighbour cap.

pub fn with_relation_filter(self, relation: Option<String>) -> Self

Restricts the walk to a single relation label.

pub fn run<S: NeighborSource>( &self, source: &S, seed_entity_ids: &[i64], ) -> Result<WalkOutcome, AppError>

Runs the walk, discarding per-edge observations.

Errors

Propagates AppError::Database (exit 10) on SQLite query failures.

pub fn run_observed<S, F>( &self, source: &S, seed_entity_ids: &[i64], on_edge: F, ) -> Result<WalkOutcome, AppError>

where S: NeighborSource, F: FnMut(&EdgeArrival, u32),

Runs the walk, invoking on_edge(edge, depth_of_neighbour) for every edge examined — including edges that lead back to an already-visited entity. Callers that render an edge list (graph traverse) need those; callers that only need reachable entities ignore them.

Errors

Propagates AppError::Database (exit 10) on SQLite query failures.

Trait Implementations

impl Clone for GraphWalk

fn clone(&self) -> GraphWalk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GraphWalk

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

Formats the value using the given formatter.