workflow

type ActionRef struct {
	Owner string // e.g. "actions"
	Repo  string // e.g. "checkout"
	Path  string // e.g. "" or "/subdir"
	Ref   string // e.g. "v4" or a full SHA
	Node  *yaml.Node
}

type Job struct {
	ID          string
	Node        *yaml.Node
	Permissions *Permissions
	Steps       []Step
}

type NodeSnapshot struct {
	Value       string
	LineComment string
}

type Permissions struct {
	Node    *yaml.Node
	IsEmpty bool              // true when the key is absent
	Values  map[string]string // e.g. {"contents": "read", "packages": "write"}
	IsAll   bool              // true when set to a bare string like "write-all"
}

type Step struct {
	Name string
	Uses *ActionRef // nil when the step is a `run:` step
	Node *yaml.Node
}

type Workflow struct {
	Path      string // filesystem path to the YAML file
	Raw       []byte // original bytes from disk
	Doc       yaml.Node
	Snapshots map[*yaml.Node]NodeSnapshot // original node values

	Permissions *Permissions
	Jobs        []Job
}