Struct FileKnowledgeBase 

pub struct FileKnowledgeBase { /* private fields */ }

JSONL-backed KnowledgeBase (one ExperimentRecord per line).

Default location: .soma/experiments.jsonl.

Implementations

impl FileKnowledgeBase

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Open (or create) the knowledge base at path, loading every parseable line. A corrupt trailing line — the signature of a crash mid-append — is skipped with a warning; a corrupt line in the middle of the file is an error.

pub fn path(&self) -> &Path

Path of the backing JSONL file.

Trait Implementations

impl KnowledgeBase for FileKnowledgeBase

fn record(&mut self, experiment: ExperimentRecord) -> Result<()>

Store a new experiment record.

fn all(&self) -> Result<Vec<ExperimentRecord>>

Every record this base holds, in insertion order.

fn get(&self, id: &str) -> Result<Option<ExperimentRecord>>

Get an experiment by ID.

fn len(&self) -> usize

Total number of experiments.

fn refresh(&mut self) -> Result<usize>

Pick up records another process appended since this handle was opened. Returns how many were newly loaded.

fn is_empty(&self) -> bool

Whether the base holds no records at all.

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

Substring search over name, hypothesis, notes, tags and pipeline.

fn retrieve(&self, query: &RetrievalQuery) -> Result<Vec<ScoredRecord>>

Rank records against a query by relevance, structure, recency and importance. See crate::retrieval for the formula.

fn lineage(&self, id: &str) -> Result<Option<Lineage>>

An experiment with its ancestors and descendants.

fn experiments_in_line(&self, line: &str) -> Result<Vec<ExperimentRecord>>

List experiments in a research line, ordered chronologically.

fn research_lines(&self) -> Result<Vec<ResearchLine>>

Get all research lines with trend analysis.

fn promising_lines(&self, metric: &str) -> Result<Vec<ResearchLine>>

Find promising research lines (improving trend, high metric values).

fn trajectory(&self, line: &str, metric: &str) -> Result<Vec<(String, f64)>>

Get the metric trajectory for a research line.

fn change_points( &self, line: &str, metric: &str, threshold: f64, ) -> Result<Vec<ChangePoint>>

Detect change points where metrics shifted significantly.

fn children(&self, experiment_id: &str) -> Result<Vec<ExperimentRecord>>

Direct children of an experiment.