workflow

type Step struct {
	Kind string
	Name string
}

type Workflow struct {
	// Name is the colon-namespaced lowercased addressable name (e.g.
	// "release:cut-rc"). Two files whose names collide after
	// lowercasing are reported as a load-time warning; the
	// alphabetically-earlier source path wins.
	Name string

	// Description is the workflow's one-line summary. Empty when the
	// file did not declare a description; CLI surfaces emit
	// `(missing description)` in that case.
	Description string

	// Steps is the ordered list declared in the file. Always non-empty
	// for successfully-loaded workflows (the loader rejects files with
	// no steps via WORKFLOW_INVALID).
	Steps []Step

	// SourcePath is the absolute path to the YAML file on disk. Used
	// in warnings and error messages so the operator can find the
	// offending file quickly.
	SourcePath string
}