Struct BrainSession 

pub struct BrainSession { /* private fields */ }

Implementations

impl BrainSession

pub fn open(start: &Path) -> KimetsuResult<Self>

pub fn open_readonly(start: &Path) -> KimetsuResult<Self>

pub fn retrieve_context( &self, stage: &str, query: &str, budget_tokens: u32, ) -> KimetsuResult<ContextBundle>

pub fn retrieve_context_with_request( &self, request: ContextRequest, ) -> KimetsuResult<ContextBundle>

v0.6: full-request variant used by kimetsu_brain_context MCP tool and retrieve_context_readonly_with_request to expose tags, min_score, max_capsules, and prefer_roles.

pub fn retrieve_proactive( &self, request: ContextRequest, ) -> KimetsuResult<ContextBundle>

v0.8: proactive (mid-work) retrieval. Pins [NoopEmbedder] so it stays lexical-FTS-only — NO embedding model is loaded even in --features embeddings builds, keeping the per-tool-call hook cheap. request.kinds should restrict to actionable kinds; the caller sets a high min_score and max_capsules: 1 so recall is rare and confident (the human-brain “it comes to you” model).

pub fn repo_root(&self) -> &Path

pub fn user_conn(&self) -> Option<&Connection>

v0.4.1: expose the user-brain connection so callers (e.g. kimetsu brain status) can report counts/paths without re-opening the file. Returns None when the user brain is disabled or unresolvable.