Module record 

Data types for experiment tracking: records, research lines, trends.

ExperimentRecord is the line format of experiments.jsonl — the contract between whatever produces runs and whatever reasons about them. Every field added after the first release is #[serde(default)] and every unknown field is ignored, so a journal written by a newer soma still loads on an older one and vice versa. The back-compat tests at the bottom of this file are that promise, in code.

Structs

ChangePoint

A point where experiment results changed significantly.

Embedding

A dense vector attached to a record, with the identity of whatever produced it — a vector from a different model is not comparable, and silently mixing the two is worse than having none.

ExperimentRecord

A recorded experiment in the knowledge base.

ResearchLine

A research line: a group of related experiments tracking evolution.

Enums

RecordKind

What a journal line is.

Trend

Trend direction of a research line.

Constants

RECORD_SCHEMA_VERSION

Current ExperimentRecord schema version.

Functions

slugify

Lowercase, hyphen-separated, alphanumerics only — a stable research line name derived from a run name.