report

type Group struct {
	N           int           `json:"n"`
	Signature   string        `json:"signature"`
	Requests    int           `json:"requests"`
	Drifts      int           `json:"drifts"`
	Example     compare.Drift `json:"example"`
	Explanation string        `json:"explanation"`
	Routes      []Location    `json:"routes,omitempty"`
	RouteCount  int           `json:"route_count,omitempty"`
}

type Location struct {
	Route  string `json:"route"`
	Action string `json:"action,omitempty"`
	File   string `json:"file,omitempty"`
}

type Percentiles struct {
	P50 int64 `json:"p50_ms"`
	P95 int64 `json:"p95_ms"`
}

type Report struct {
	Version  int      `json:"version"`
	Tag      string   `json:"tag"`
	Against  string   `json:"against"`
	Compared int      `json:"compared"`
	Passed   int      `json:"passed"`
	Drifted  int      `json:"drifted"`
	Skipped  int      `json:"skipped"`
	Observed int      `json:"observed"`
	Results  []Result `json:"results"`
	Groups   []Group  `json:"groups"`
	// The status changes shared by requests, the most common first: one
	// cause, whatever drifts follow from it.
	StatusChanges []StatusGroup `json:"status_changes,omitempty"`
	// What review, accept and report need to find the compared sets again.
	Baseline string `json:"baseline,omitempty"` // the baseline compared against, when it is one: its name
	Level    string `json:"level,omitempty"`
	Mode     string `json:"mode,omitempty"`
	Created  string `json:"created,omitempty"`
	// What accept checks to know the comparison still describes the compared
	// sets (manifest of the baseline, records of the capture), and the
	// requests it has accepted from it since.
	BaselineDigest string   `json:"baseline_digest,omitempty"`
	CaptureDigest  string   `json:"capture_digest,omitempty"`
	Accepted       []string `json:"accepted,omitempty"`
	// Requests skipped because their private body is not on this machine;
	// the result is incomplete unless they were skipped on purpose
	// (--skip-private).
	PrivateMissing []string `json:"private_missing,omitempty"`
	SkipPrivate    bool     `json:"skip_private,omitempty"`
	// Requests skipped because the baseline has no response for them.
	NoBaseline []string `json:"no_baseline,omitempty"`
	// Allowlist rules that applied to no change in this comparison: a stale
	// rule (a renamed value, a request that is gone) stays unnoticed
	// otherwise. A warning, never a failure.
	UnusedRules []allowlist.Unused `json:"unused_rules,omitempty"`
	// Response times of the two sides, as information (CompareTimings).
	Timings *Timings `json:"timings,omitempty"`
	// Origins name the services whose two sides were captured from
	// different origins, each taken as the other ("http://localhost:8080 ≙
	// http://localhost:8081").
	Origins []string `json:"origins,omitempty"`
}

type Result struct {
	ID      string          `json:"id"`
	Outcome string          `json:"outcome"`
	Level   string          `json:"level,omitempty"`
	Note    string          `json:"note,omitempty"`
	Drifts  []compare.Drift `json:"drifts,omitempty"`
	// StatusChange is how the status changed, when it did. Collapsed is
	// how many of the drifts follow from it (the body, headers other than
	// location and content type): text, markdown and JUnit summarize them
	// in one line by default; Drifts has them all.
	StatusChange *StatusChange `json:"status_change,omitempty"`
	Collapsed    int           `json:"collapsed,omitempty"`
	// Notes say how the comparison went where that is not a drift: an
	// array the allowlist pairs by key whose items were paired by position.
	Notes []string `json:"notes,omitempty"`
}

type Slower struct {
	ID       string `json:"id"`
	Baseline int64  `json:"baseline_ms"`
	Current  int64  `json:"current_ms"`
}

type StatusChange struct {
	From     string `json:"from"`
	To       string `json:"to"`
	Location string `json:"location,omitempty"`
}

type StatusGroup struct {
	StatusChange
	Requests []string `json:"requests"`
}

type Timings struct {
	Requests int         `json:"requests"` // compared requests timed on both sides
	Baseline Percentiles `json:"baseline"`
	Current  Percentiles `json:"current"`
	Slower   []Slower    `json:"slower,omitempty"` // the most added time first
}