flow

type Flow struct {
	// Name is a human-readable title for the pipeline.
	Name string `yaml:"name"`

	// Description is an optional longer description of the pipeline's purpose.
	Description string `yaml:"description,omitempty"`

	// Steps is the ordered list of pipeline steps.
	Steps []FlowStep `yaml:"steps"`
}

type FlowStep struct {
	// Name is a human-readable label for the step.
	Name string `yaml:"name"`

	// Command is the cloop subcommand to invoke (e.g., "lint", "run", "report").
	Command string `yaml:"command"`

	// Args are extra arguments passed to the cloop subcommand.
	Args []string `yaml:"args,omitempty"`

	// If is a shell condition evaluated before executing the step.
	// The step is skipped when the condition exits non-zero.
	// Example: "test -f go.mod"
	If string `yaml:"if,omitempty"`

	// OnFailure controls behaviour when the step's Command fails.
	// Valid values: "continue" (default), "abort", "retry".
	OnFailure OnFailurePolicy `yaml:"on_failure,omitempty"`

	// Env holds extra environment variables injected for this step only.
	Env map[string]string `yaml:"env,omitempty"`

	// MaxRetries is the number of additional attempts when OnFailure is "retry".
	// Defaults to 2.
	MaxRetries int `yaml:"max_retries,omitempty"`
}

type OnFailurePolicy string

type RunConfig struct {
	// WorkDir is the directory from which cloop commands are executed.
	WorkDir string

	// CloopBin is the path to the cloop binary. Defaults to the current executable.
	CloopBin string

	// DryRun prints commands without executing them.
	DryRun bool

	// Stdout and Stderr for step output. Defaults to os.Stdout/Stderr.
	Stdout *os.File
	Stderr *os.File
}

type StepResult struct {
	StepName string
	Skipped  bool
	Err      error
	Duration time.Duration
	Attempts int
}