reporter

type ColorMode int

type Event struct {
	Kind     EventKind     `json:"kind"`
	Time     time.Time     `json:"time"`
	RunID    string        `json:"runId,omitempty"`
	Pipeline string        `json:"pipeline,omitempty"`
	Task     string        `json:"task,omitempty"`
	Step     string        `json:"step,omitempty"`
	Stream   string        `json:"stream,omitempty"` // stdout|stderr
	Line     string        `json:"line,omitempty"`
	Status   string        `json:"status,omitempty"`
	ExitCode int           `json:"exitCode,omitempty"`
	Duration time.Duration `json:"durationMs,omitempty"`
	Message  string        `json:"message,omitempty"`
	// Attempt is 1-based and present on task-retry (the attempt that just
	// failed) and on task-end (the attempt that produced the final outcome).
	Attempt int `json:"attempt,omitempty"`
	// Results holds resolved Pipeline.spec.results on a run-end event.
	// Map values are one of: string, []string, map[string]string. Empty
	// or nil when the pipeline declared no results.
	Results map[string]any `json:"results,omitempty"`
	// DisplayName is the human-readable label for the entity this event
	// describes. Carried on:
	//   - run-start, run-end:    Pipeline.spec.displayName
	//   - task-start/end/skip/retry: PipelineTask.displayName
	//   - step-log:              Step.displayName
	// Empty when the source YAML didn't set a displayName. Agents
	// should fall back to the corresponding `pipeline` / `task` / `step`
	// name field.
	//
	// Note: step-start / step-end are defined as event kinds but are
	// not emitted by production code today (v1.5). If they are added
	// later, they will carry DisplayName the same way step-log does.
	DisplayName string `json:"display_name,omitempty"`

	// Description carries:
	//   - run-start: Pipeline.spec.description
	//   - task-start: TaskSpec.description (the resolved Task)
	// Omitted from terminal events to keep line size down — the start
	// event already carried it. Also omitted from step-log to avoid
	// ballooning every line of streamed output.
	Description string `json:"description,omitempty"`

	// Resolver names the resolver protocol (git | hub | http | bundles |
	// cluster | <custom-in-remote-mode>).
	Resolver string `json:"resolver,omitempty"`
	// Cached is true when resolver-end fires for a per-run cache hit
	// (no fresh fetch happened). Surfaces in pretty output as "(cached)".
	Cached bool `json:"cached,omitempty"`
	// SHA256 is the hex digest of the resolved bytes. Used by the
	// on-disk cache invalidation diagnostics; agents can compare across
	// runs to detect upstream drift.
	SHA256 string `json:"sha256,omitempty"`
	// Source is a human-readable origin string for the resolver (e.g.
	// "git: github.com/tektoncd/catalog@abc123 -> task/...").
	Source string `json:"source,omitempty"`

	// Matrix is set on task-start / task-end / task-skip events
	// emitted from a PipelineTask.matrix expansion. Nil for
	// ordinary tasks (omitempty). Carries the original PipelineTask
	// name (Parent), the 0-based row index, the total expansion
	// count, and the row's matrix-contributed params.
	Matrix *MatrixEvent `json:"matrix,omitempty"`
}

type EventKind string

type LogSink struct {
	// contains filtered or unexported fields
}

type MatrixEvent struct {
	Parent string            `json:"parent"`
	Index  int               `json:"index"`
	Of     int               `json:"of"`
	Params map[string]string `json:"params,omitempty"`
}

type PrettyOptions struct {
	Color     bool      // already resolved via ResolveColor
	Verbosity Verbosity // Quiet | Normal | Verbose
}

type Reporter interface {
	Emit(e Event)
	Close() error
}

type Tee struct {
	// contains filtered or unexported fields
}

type Verbosity int