validator

type Invocation struct {
	File string   // workflow file the invocation was found in
	Line int      // 1-based line in that file
	Step string   // name of the step, when the workflow gives one
	Args []string // arguments passed to cidx, in order
}

type Job struct {
	Name  string   // Job name
	Needs []string // Dependencies (needs: [job1, job2])
	Steps []Step   // Steps in the job
}

type StaleInvocation struct {
	Invocation
	Reason string
}

type Step struct {
	Name string // Step name
	Run  string // Command to run
}

type ValidationResult struct {
	Pipeline       string   // Pipeline name (e.g., "ci")
	WorkflowFile   string   // Workflow file path
	Success        bool     // Whether validation passed
	MissingInGH    []string // Phases in cidx.toml but not in GitHub workflow
	MissingInLocal []string // Phases in GitHub workflow but not in cidx.toml
	OrderMismatch  bool     // Whether phase order differs
	LocalOrder     []string // Order in cidx.toml
	GitHubOrder    []string // Order in GitHub workflow
}

type WorkflowDefinition struct {
	Name   string         // Workflow name (e.g., "ci", "release")
	File   string         // Workflow file path
	Jobs   map[string]Job // Jobs defined in the workflow
	Phases []string       // Extracted phases from "cidx run <phase>" commands
}

type WorkflowJobYAML struct {
	Name  string             `yaml:"name"`
	Needs interface{}        `yaml:"needs"` // Can be string or []string
	Steps []WorkflowStepYAML `yaml:"steps"`
}

type WorkflowStepYAML struct {
	Name string `yaml:"name"`
	Run  string `yaml:"run"`
}

type WorkflowYAML struct {
	Name string                     `yaml:"name"`
	Jobs map[string]WorkflowJobYAML `yaml:"jobs"`
}