Module knowledge 

The experiment-pool tools — Case-Based Reasoning over past runs.

The four CBR steps map onto the tools directly: Retrieve is find_similar, Reuse is reading the run_dir a hit points at, Revise is branch_from followed by an actual run, and Retain is record_conclusion.

Handlers stay thin on purpose: they parse arguments, ask the knowledge base, and hand the answer to crate::render. All the text a model sees is produced by pure functions over there, where it is snapshot-tested.

Functions

branch_from

Revise: point .soma/HEAD at a run so the next one branches from it.

diff

Compare any two experiments — related or not.

find_similar

Retrieve: rank past experiments against a description of the problem at hand.

lineage

The experiment tree around one run, with the move on every edge.

record_conclusion

Retain: append a conclusion to an existing experiment.

stats

Orientation: how big the pool is and how much of it is usable.

summarize_run

Summarize a run directory on demand.