feat: add generic EVIO+HIPO reader service

[baltzell]

This Clas12Reader is EvioToEvioReader + HipoToHipoReader, currently chosen at runtime based on .hipo file suffix. This will become useful with the (multi-threaded) DecoderEngine in #1229.

The previous Clas12Reader was DecoderReader + HipoToHipoReader. That was a bit confusing and could be restored with a different name, probably Clas12Decoder fits.

[Copilot]

Pull request overview

Adds a new CLARA I/O service (Clas12Reader) intended to read either EVIO or HIPO files and forward events unchanged, selecting the backend reader based on the input filename suffix. This is positioned as a simpler replacement for the prior “DecoderReader + HipoToHipoReader” behavior and a building block for the upcoming multi-threaded decoding work (see #1229).

Changes:

• Introduces org.jlab.io.clara.Clas12Reader to read EVIO via EvioSource or HIPO via HipoReader and expose the corresponding EngineDataType.
• Adds a CLARA service descriptor Clas12Reader.yaml.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
common-tools/clara-io/src/main/java/org/jlab/io/clara/Clas12Reader.java	New generic EVIO/HIPO reader service with suffix-based backend selection and event passthrough.
common-tools/clara-io/src/main/resources/org/jlab/io/clara/Clas12Reader.yaml	Registers the new Clas12Reader service for CLARA deployment.

Comments suppressed due to low confidence (1)

common-tools/clara-io/src/main/java/org/jlab/io/clara/Clas12Reader.java:70

• There is dead/commented-out code returning an EvioDataEvent, and the EvioDataEvent import becomes unused. Please remove the commented line (and the unused import) to avoid confusion about the intended EVIO payload type.

                return ((EvioSource)reader).getEventBuffer(eventNumber, true);
                //return new EvioDataEvent(b.array(), readByteOrder());
            }

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.