pipeline

type FailureDetail struct {
	Command  string // "docker push cr.pcfae.com/prplanit/stagefreight:dev-ff98a93"
	ExitCode int    // 1
	Reason   string // "HTTP 500 (registry)"
	Stderr   string // raw stderr for --verbose
}

type Phase struct {
	Name string
	Run  func(pc *PipelineContext) (*PhaseResult, error)
}

type PhaseResult struct {
	Name    string
	Status  string // "success", "failed", "skipped"
	Summary string // one-line detail
	Elapsed time.Duration
	Details map[string]string // optional structured metadata
	Failure *FailureDetail    // operator-facing error context; nil on success
}

type Pipeline struct {
	Phases []Phase
	Hooks  []PostBuildHook
}

type PipelineContext struct {
	Ctx           context.Context
	RootDir       string
	Config        *config.Config
	Writer        io.Writer
	Color         bool
	CI            bool
	Verbose       bool
	SkipLint      bool
	DryRun        bool
	Local         bool
	PipelineStart time.Time
	BuildPlan     *build.BuildPlan // set by build planning phases when applicable; nil for pipelines with no build plan
	Results       []PhaseResult    // accumulated by pipeline runner

	// Trace is the truth emission collector for this pipeline run.
	// All inputs, decisions, mutations, and side effects emit through it.
	// Panels render from it; enforcement validates completeness at end of run.
	// Never nil — initialized by Pipeline.Run if not set by caller.
	Trace *trace.Collector

	// Scratch is a state bag for command-specific data flowing between phases.
	// Keys are package-scoped conventions (e.g., "binary.steps", "docker.engine").
	// Cross-package pipeline state uses typed fields above, not Scratch.
	Scratch map[string]any
}

type PostBuildHook struct {
	Name      string
	Condition func(pc *PipelineContext) bool
	Run       func(pc *PipelineContext) (*PhaseResult, error)
}