Package dev.dokimos.core.gate

Record Class BaselineFile

java.lang.Object
java.lang.Record
dev.dokimos.core.gate.BaselineFile
Record Components:
formatVersion - the format version; readers reject a version newer than they support
experiment - the experiment name
dataset - dataset summary (advisory)
pairing - "positional" or "dataset_item_id"
runsPerItem - observations per item this file represents (v1: always 1)
items - the per-item projections, sorted by key
provenance - build/judge context, kept separate and excluded from the byte-stability guarantee
public record BaselineFile(int formatVersion, String experiment, BaselineFile.DatasetInfo dataset, String pairing, int runsPerItem, List<BaselineFile.BaselineItem> items, BaselineFile.Provenance provenance) extends Record
The committed regression-gate baseline (format v1).

This is a stable projection of a run, not a serialized RunResult. It excludes the model's actual outputs, each evaluator's prose reason, and call metrics — the comparison engine reads none of them — so the file changes only when measured quality changes, keeping git diffs minimal. It carries exactly what the comparison needs: a stable item key plus per-evaluator score and verdict.

Determinism contract (enforced by BaselineStore): scores are rounded to 6 decimals (matching the engine), evaluators are a list sorted by name, and items are sorted by key, so two writes of the same run are byte-identical.

  • Field Details

    • CURRENT_VERSION

      public static final int CURRENT_VERSION
      The current supported format version.
      See Also:

  • Constructor Details

  • Method Details

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object

    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object

    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. Reference components are compared with Objects::equals(Object,Object); primitive components are compared with '=='.
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.

    • formatVersion

      public int formatVersion()
      Returns the value of the formatVersion record component.
      Returns:
      the value of the formatVersion record component

    • experiment

      public String experiment()
      Returns the value of the experiment record component.
      Returns:
      the value of the experiment record component

    • dataset

      public BaselineFile.DatasetInfo dataset()
      Returns the value of the dataset record component.
      Returns:
      the value of the dataset record component

    • pairing

      public String pairing()
      Returns the value of the pairing record component.
      Returns:
      the value of the pairing record component

    • runsPerItem

      public int runsPerItem()
      Returns the value of the runsPerItem record component.
      Returns:
      the value of the runsPerItem record component

    • items

      public List<BaselineFile.BaselineItem> items()
      Returns the value of the items record component.
      Returns:
      the value of the items record component

    • provenance

      public BaselineFile.Provenance provenance()
      Returns the value of the provenance record component.
      Returns:
      the value of the provenance record component