Initialise a new version-controlled golden dataset at dataset_path.

Creates a .golden_dataset/ directory there. Fails if one already exists at that path — delete .golden_dataset/ manually to start fresh.

Add a question-answer pair to the working tree of a golden dataset.

Entries added here are NOT yet versioned — call commit_version to snapshot them. dataset_path must already be initialised.

Update fields of an existing working-tree entry by its id.

Only fields you provide are changed; omitted fields are left as-is. Raises an error if entry_id is not found in the working tree.

Remove an entry from the working tree by its id. Does not affect already-committed versions.

List entries in a dataset. Omit version to see the uncommitted working tree; pass a version (e.g. '1.0') to see a committed snapshot.

Snapshot the current working tree as a new immutable dataset version.

Versions auto-increment (1.0 -> 1.1 -> 1.2...). Fails if the working tree is empty.

Show entries added, removed, or changed between two committed versions.

Score actual LLM/RAG-generated answers against the golden dataset using TF-IDF cosine similarity (no LLM call, no API key needed).

actual_answers must be supplied in the same order as the entries in the target version. Omit version to evaluate against the current committed version.

Show the current state of a golden dataset: name, current version, and working tree size.