Struct Tree 

pub struct Tree {
    pub index: String,
    pub k: usize,
    pub depth: usize,
}

RAPTOR tree retrieval operator.

Searches the communities vector index, then descends the community→members hierarchy to collect leaf-chunk IDs that hydrate() can resolve into Hits.

Construction is fluent. Pass it to crate::RetrievalBuilder::with_root or compose with other operators via .and() / .or() / .fuse_rrf().

use lunaris_core::LunarisError;
use lunaris_retrieve::{Query, RetrievalBuilder};
use lunaris_retrieve::operators::tree::Tree;

let hits = builder
    .with_root(Tree::new("communities", 5))
    .execute(Query::text("What are the main themes across both reports?"))
    .await?;

Fields

index: String

Vector index to search for community summaries. Typically "communities".

k: usize

Number of top community nodes to retrieve from the vector index.

depth: usize

BFS descent depth: 1 = direct members only, 2 = members + their members, etc.

Implementations

impl Tree

pub fn new(index: impl Into<String>, k: usize) -> Tree

Build a Tree operator targeting the given community index with k top-level nodes and the default descent depth of DEFAULT_TREE_DEPTH.

k is clamped to super::MAX_K.

pub fn with_depth(self, depth: usize) -> Tree

Override the BFS descent depth (clamped to MAX_TREE_DEPTH).

depth = 1 (default): collect direct Community.members as leaf chunks. depth = 2: also expand sub-community members one additional level, etc.

pub fn and<R>(self, other: R) -> AndRetriever

where R: Retriever + 'static,

Convenience: wrap into the standard combinator builder.

pub fn or<R>(self, other: R) -> OrRetriever

where R: Retriever + 'static,

pub fn then<R>(self, other: R) -> ThenRetriever

where R: Retriever + 'static,

pub fn top(self, n: usize) -> TopRetriever

Cap the final result set after the operator tree resolves.

Trait Implementations

impl Clone for Tree

fn clone(&self) -> Tree

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Tree

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

Formats the value using the given formatter.

impl Retriever for Tree

fn retrieve<'life0, 'life1, 'async_trait>( &'life0 self, ctx: &'life1 QueryContext, ) -> Pin<Box<dyn Future<Output = Result<Vec<RawHit>, LunarisError>> + Send + 'async_trait>>

where 'life0: 'async_trait, 'life1: 'async_trait, Tree: 'async_trait,

Run the operator against ctx and return the unranked-or-ranked raw hits this operator produces. The downstream stage (combinator or fuse_rrf) decides what to do with them.

fn as_any(&self) -> &(dyn Any + 'static)

Cast this operator to &dyn Any so the RRF routing dispatcher can recover the concrete operator type. Concrete operators override with fn as_any(&self) -> &dyn Any { self }. The default returns a sentinel &() so unknown operators downcast as None (and the dispatcher falls back to client-side RRF instead of misrouting).