report

type Abort struct {
	Reason   string        `json:"reason"`
	Grace    time.Duration `json:"-"`
	Inflight []string      `json:"inflight"`
}

type Attempt struct {
	N        int           `json:"n"`
	Method   string        `json:"method"`
	URL      string        `json:"url"`
	Status   int           `json:"status,omitempty"`
	Error    string        `json:"error,omitempty"`
	Duration time.Duration `json:"-"`
}

type Diagnostic struct {
	Code     string `json:"code"`
	Severity string `json:"severity,omitempty"`
	Message  string `json:"message"`
	File     string `json:"file,omitempty"`
	Line     int    `json:"line,omitempty"`
	Column   int    `json:"column,omitempty"`
}

type Hook struct {
	Phase       string        `json:"phase"`
	Level       string        `json:"level"`
	Step        string        `json:"step"`
	Index       int           `json:"index"`
	Status      string        `json:"status"`
	Duration    time.Duration `json:"-"`
	Diagnostics []Diagnostic  `json:"diagnostics,omitempty"`
	Nodes       []Node        `json:"nodes,omitempty"`
}

type Lane struct {
	Label string `json:"label"`
	Nodes []Node `json:"nodes"`
}

type Node struct {
	Path        string         `json:"path"`
	ID          string         `json:"id"`
	Type        string         `json:"type"`
	Name        string         `json:"name,omitempty"`
	Status      string         `json:"status"`
	Handled     bool           `json:"handled,omitempty"` // failed, but on_error let the run continue
	Reason      string         `json:"reason,omitempty"`  // why a skipped node was skipped, when the person chose it
	Started     time.Time      `json:"started,omitzero"`
	Duration    time.Duration  `json:"-"`
	Outputs     map[string]any `json:"outputs,omitempty"`
	Diagnostics []Diagnostic   `json:"diagnostics,omitempty"`
	Attempts    []Attempt      `json:"attempts,omitempty"`
	Hooks       []Hook         `json:"hooks,omitempty"`
	Lanes       []Lane         `json:"lanes,omitempty"`
}

type Note struct {
	Path string `json:"path"`
	Text string `json:"text"`
}

type OutputValue struct {
	Name  string `json:"name"`
	Type  string `json:"type,omitempty"`
	Value any    `json:"value"`
}

type Run struct {
	ID         string `json:"id"`
	Kind       string `json:"kind"` // "flow" or "send"
	FlowID     string `json:"flow_id,omitempty"`
	FlowPath   string `json:"flow_path,omitempty"`
	FlowName   string `json:"flow_name,omitempty"`
	Collection string `json:"collection,omitempty"`
	Env        string `json:"env,omitempty"`
	// Overlay is the run-level flowi overlay the run was started with, if any.
	Overlay  string        `json:"overlay,omitempty"`
	Status   string        `json:"status"`
	Seed     uint64        `json:"seed"`
	Started  time.Time     `json:"started,omitzero"`
	Duration time.Duration `json:"-"`
	Nodes    []Node        `json:"nodes"`
	// Vars are the flow's variables when the run ended, masked: what a later
	// partial run needs to carry on from here.
	Vars map[string]any `json:"vars,omitempty"`
	// Outputs are the flow's declared outputs as the run ended, in declared
	// order and masked. One that could not be worked out (the run failed
	// before it had its value) is left out, never filled with a wrong value.
	Outputs  []OutputValue `json:"outputs,omitempty"`
	Warnings []Diagnostic  `json:"warnings,omitempty"`
	Notes    []Note        `json:"notes,omitempty"`
	Versions []VersionUse  `json:"versions,omitempty"`
	Aborted  *Abort        `json:"aborted,omitempty"`
}

type Sequence struct {
	Title string
	Hosts []string // the hosts the run called, in the order it first called them; Flowi is implied
	Steps []SequenceStep
}

type SequenceStep struct {
	Kind   string
	Host   int
	Text   string
	Failed bool
}

type VersionUse struct {
	Path        string `json:"path"`
	RequestID   string `json:"request_id"`
	RequestPath string `json:"request_path"`
	Version     string `json:"version"`
	Source      string `json:"source"`
}