workflow

type LoadError struct {
	File string
	Err  error
}

type ParentSpec struct {
	Title       string
	Description string // = interpolated spec (may be empty)
}

type Plan struct {
	TemplateName string
	Vars         map[string]string
	Spec         string // interpolated; the shared-context block (may be empty)
	Parent       ParentSpec
	Steps        []StepSpec
}

type Step struct {
	ID    string `yaml:"id"`
	Title string `yaml:"title"`
	// Description is per-step instructions — acceptance criteria, the
	// specific job, any references downstream agents will need.
	// {{var}} interpolation applies. The template's spec is prepended
	// at instantiation so each step issue is self-contained.
	Description string   `yaml:"description,omitempty"`
	Type        string   `yaml:"type,omitempty"`
	Priority    *int     `yaml:"priority,omitempty"`
	Needs       []string `yaml:"needs,omitempty"`
	Agent       string   `yaml:"agent,omitempty"` // pre-assigns the step to an agent lane
	Wait        *Wait    `yaml:"wait,omitempty"`
}

type StepSpec struct {
	StepID      string // template step id (e.g. "build")
	Title       string // interpolated
	Description string // interpolated; spec + "\n\n---\n\n" + per-step desc, when set
	Type        string // "task" or "checkpoint"
	Priority    int
	Needs       []string // step ids, not issue ids
	Agent       string   // pre-assigned agent lane; "" = unassigned
	Wait        *Wait    // checkpoint config; nil for tasks
	IsLeaf      bool     // no other step needs this one — parent depends on it
}

type Template struct {
	Name        string `yaml:"name"`
	Description string `yaml:"description,omitempty"`
	// Spec is shared context prepended to every step's description on
	// instantiation. Inline string, or @<path> to load from a file
	// relative to the template (so a 50-line scaffold-spec.md can live
	// next to the template). {{var}} placeholders interpolate.
	Spec  string         `yaml:"spec,omitempty"`
	Vars  map[string]Var `yaml:"vars,omitempty"`
	Steps []Step         `yaml:"steps"`
}

type Var struct {
	Required bool   `yaml:"required,omitempty"`
	Default  string `yaml:"default,omitempty"`
	Pattern  string `yaml:"pattern,omitempty"`
	// Label is a short human-readable name for the variable. Used by
	// the interactive prompt today; future surfaces (docs, GUI, JSON
	// schemas) will reuse the same string. Defaults to the var name
	// when empty.
	Label string `yaml:"label,omitempty"`
}

type Wait struct {
	Manual   bool     `yaml:"manual,omitempty"`
	Approval []string `yaml:"approval,omitempty"`
}