Struct KnowledgeIndex 

pub struct KnowledgeIndex { /* private fields */ }

In-memory knowledge index for a session’s vault.

Built from a Lago manifest + blob store. Provides name/path resolution, scored search, and graph traversal over wikilink edges.

Implementations

impl KnowledgeIndex

pub fn build( manifest: &[ManifestEntry], store: &BlobStore, ) -> Result<Self, KnowledgeError>

Build an index from a Lago manifest and blob store.

Reads all .md entries, parses frontmatter, extracts wikilinks, and builds the name/path maps and graph adjacency list.

pub fn resolve_wikilink(&self, target: &str) -> Option<&Note>

Resolve a wikilink target to a Note.

Tries name lookup first, then path lookup. Strips heading anchors (Note#heading → Note).

pub fn get_note(&self, path: &str) -> Option<&Note>

Get a note by its exact path.

pub fn notes(&self) -> &HashMap<String, Note>

Get all notes in the index.

pub fn len(&self) -> usize

Number of notes in the index.

pub fn is_empty(&self) -> bool

Whether the index is empty.

pub fn is_stale(&self, ttl: Duration) -> bool

Check if the index is stale based on a TTL.

impl KnowledgeIndex

pub fn search(&self, query: &str, max_results: usize) -> Vec<SearchResult>

Search notes by query terms with scoring.

Scoring:

• +2 per term match in note name
• +1 per term match in body text
• +1 per tag match in frontmatter

Returns results sorted by score descending, limited to max_results.

impl KnowledgeIndex

pub fn traverse( &self, start: &str, depth: usize, max_notes: usize, ) -> Vec<TraversalResult>

BFS traversal from a starting note, up to depth hops and max_notes total results.

The start note is resolved via wikilink resolution (name or path). Returns notes in BFS order with their depth from the start.