Repository navigation
VERA-MH v2.0.0
VERA-MH 2.0 is released. It breaks the legacy scripts: they still run in 2.0.0, but 2.0.1 moves them to legacy/, which changes how they are invoked.
Breaking / migration
veraCLI—vera.py(generate,judge,score,pipeline) replacesgenerate.py,judge.py,run_pipeline.py, andjudge/score.py. The old scripts are deprecated and still run unchanged in 2.0.0;docs/legacy-scripts.mdmaps their flags tovera.vera scorehas no default personas file—Without--personas, the risk-level breakdown is skipped andscores_by_risk.jsonis not written. Pass--personas data/SI/personas.tsvfor the legacy behavior.vera judgeneeds--outputfor flat transcript folders—It no longer falls back toevaluations/in the working directory. Generation runs still write to<run>/evaluations/.- Per-question answers moved—
answers/conversations/is nowanswers/by_question/.
Targets, rubric, and scoring
- Multiple targets—A target bundles a rubric, personas, and prompts in
data/<target>/manifest.json, selected with--targetor a config'starget. Ships withSIand the newHFOtarget. - Persona annotation—A manifest can list
persona_annotation_columns, which judging copies intoresults.csvso scores can be broken down by persona trait. - Terminal
END—A plainGOTO=ENDon a rubric's last question no longer marks the evaluation Not Relevant;ASSIGN_ENDon a non-Yes answer is rejected.
Runtime, CLI, and pipeline
- Config files—Every
veracommand takes--config,VERA_RUN_CONFIG, or--print. The recommended SI profile isconfigs/recommended-SI.json. vera pipeline—Runs generation, judging, and scoring in one invocation, passing each stage's output to the next.--into—vera generateandvera judgecan continue an existing run.- Model IDs in one place—Default models are read from
llm_clients/config.py.
Testing, CI, and documentation
- Safer tests—Tests cannot open network connections or see real API keys.
- Model availability check—A live test confirms the configured model IDs still exist at each provider.
- Docs—README rewritten for 2.0, with reference docs split under
docs/.