Baseline Object

The baseline object identifies a previous report used as a comparison reference when computing insights. It enables delta analysis between the current run and a known baseline, supporting trend detection and regression analysis.

info

The baseline object is optional and is typically added by consumers during post-processing rather than by test reporters directly.

Properties

Property	Type	Required	Description
reportId	String	Required	The UUID of the baseline report. Must be a valid UUID.
timestamp	String	Optional	When the baseline report was generated (RFC 3339 / ISO 8601 format).
source	String	Optional	A descriptive label (such as a branch or environment) or URL identifying the baseline report or its source. No specific format is required.
buildNumber	Integer	Optional	The build number of the baseline run.
buildName	String	Optional	The build name of the baseline run.
buildUrl	String	Optional	URL to the baseline build for reference.
commit	String	Optional	Git commit SHA of the baseline run.
extra	Object	Optional	Extension point for arbitrary baseline-related metadata.

Example

"baseline": {
  "reportId": "550e8400-e29b-41d4-a716-446655440000",
  "timestamp": "2025-01-20T10:30:00Z",
  "source": "https://reports.example.com/ctrf/550e8400",
  "buildName": "main-pipeline",
  "buildNumber": 1540,
  "buildUrl": "https://ci.example.com/builds/1540",
  "commit": "f1e2d3c4b5a6"
}

Usage with Insights

The baseline is used in conjunction with the Insights Object to compute metric deltas. When a baseline is specified, insight metrics can include both current and baseline values, along with the computed change between them.