SuppliedCommitRange

Fields

A caller-supplied commit range WITH its boundary refs.

3 fields

base: string or null
Commit the range starts AFTER (exclusive) — the baseline ref.
commits: array of SuppliedCommit
head: string or null
Commit the range ends AT (inclusive) — usually this run's commit.

Raw schema (JSON)

{
  "description": "A caller-supplied commit range WITH its boundary refs.\n\nThe original US-8.1 wire shape for ``commit_range`` was a bare list of\ncommits, which threw away the range's boundary: the backend stored\n``base_commit = NULL`` and nobody downstream could reconstruct what the\nrange was *relative to*. That makes the row useless as test-impact\n(Epic 10) training data. This object form carries the boundary the\ncaller already knows (it ran ``git log base..head`` to build the list).\n\nBoth wire shapes stay accepted — ``commit_range`` is\n``list[SuppliedCommit] | SuppliedCommitRange`` on every ingest schema,\nso existing SDK/CLI callers that push a bare list are unaffected.\nField aliases accept ``base``/``base_commit`` and ``head``/``head_commit``\nso callers do not have to guess which spelling we wanted.",
  "properties": {
    "base": {
      "anyOf": [
        {
          "maxLength": 64,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Commit the range starts AFTER (exclusive) — the baseline ref.",
      "title": "Base"
    },
    "commits": {
      "items": {
        "$ref": "#/components/schemas/SuppliedCommit"
      },
      "maxItems": 100,
      "title": "Commits",
      "type": "array"
    },
    "head": {
      "anyOf": [
        {
          "maxLength": 64,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Commit the range ends AT (inclusive) — usually this run's commit.",
      "title": "Head"
    }
  },
  "title": "SuppliedCommitRange",
  "type": "object"
}

Used by endpoints

2 endpoints send or return this schema, on its own or inside another schema.

POST /api/v1/ingest — Ingest test results (JSON batch)
POST /api/v1/stream/sessions — Create Session

Used by schemas

More details

Specification: OpenAPI JSON