[pgranger23]

Second step of following SPINE releases: spine-reader gets a version of its own, so that "files from SPINE Y need spine-reader X" has an X to point at, and a job log shows which X read a file. After this is merged and CI passes on the merge commit, v0.1.0 can be tagged.

What changes

• One version source. project(spine-reader VERSION 0.1.0) stays the only place the number is written. It reaches the library as a private compile definition, returned by the new spine::version() (include/spine/version.hpp, included by reader.hpp).

• SchemaReport::summary(): the line after the path now names both programs.

  before:  SPINE 1.4.1, format_version 1 (V1), read with model 1.4.0
  after:   SPINE 1.4.1, format_version 1 (V1); read by spine-reader 0.1.0 (model from SPINE 1.4.0)
  

  A model older than the file now reads as a normal lag, not a mismatch. SchemaReport keeps its layout. This line is the only change the CAFMakers' logs show. SBN's A/B script, which compares standard output with a baseline, will need a new baseline once.

• spine-dump --version prints spine-dump: spine-reader 0.1.0 (model from SPINE 1.4.0) and exits 0, whatever other arguments are given.

• Tests:

  • test_reader.cpp and check_spine_dump.cmake no longer write the spine-reader or model version as literals. tests/CMakeLists.txt reads the model version from model.hpp, and reconfigures when the header is regenerated.
  • spine_dump_output also checks --version.

• Docs: a Versions section in the README (tags made from project(VERSION), ci/check_tag_version.sh, SameMinorVersion, nothing ever moved or deleted). The EGM.md contracts describe the new function, the summary line and --version.

Checked

• EL9, LCG_110 (gcc 13, HDF5 1.14.6): the build gives no warnings under -Wall -Wextra -Wpedantic. All ctest entries pass, and spine_reader_real_files is skipped as designed.
• With spine::version() deliberately returning a wrong string, spine_dump_output fails. It passes again once restored.
• ci/sl7-ups.sh (SL7, UPS gcc 12, C++17, HDF5 1.12.2): 133 test cases and 108,844 assertions pass.
• The SBN and FD CAFMaker ports (Read SPINE files with spine-reader instead of the HDF5 C++ API justinjmueller/sbn_ml_cafmaker#8, Read SPINE files with spine-reader instead of the HDF5 C++ API; SPINE energies in GeV DUNE/dune_ml_cafmaker#1) build against this branch with no code change.