[NaNIsaac]

Purpose

Create reproducible synthetic test inputs before modifying QoraFlow's current loader and integrator architecture. This provides a baseline for future HDF5/Zarr adapters without inventing a beamline Zarr schema.

Changes

• Add a deterministic generator of five miniature PAL-shaped HDF5 cases with independent JSON expected values.
• Add parameterized real-loader tests for frame/pump/QBPM alignment, missing metadata/pump flags, and disjoint timestamps.
• Document a proposed format-neutral shot contract, known omissions, and prerequisites for designing a Zarr adapter.

Deliberate non-goals

• No production loader/integrator changes, no existing model or API rewrites.
• No Zarr package yet: actual input hierarchy, chunking and shot-identification semantics must be known first.
• No private measurement data distributed.

Validation

Existing GitHub Actions test matrix is required before merge. Keep PR as Draft until tests pass.