recipe

type Recipe struct {
	// Name is the unique identifier for the recipe (used as the file stem).
	Name string `yaml:"name"`

	// Description is a short human-readable summary.
	Description string `yaml:"description,omitempty"`

	// Version is an optional semantic version string (e.g. "1.0.0").
	Version string `yaml:"version,omitempty"`

	// Author is the optional creator name or email.
	Author string `yaml:"author,omitempty"`

	// FlowYAML is the embedded flow pipeline definition (YAML text).
	// It is rendered as a Go text/template before execution; use {{.Goal}},
	// {{.Name}}, or any key from ExtraVars.
	FlowYAML string `yaml:"flow_yaml"`

	// GoalTemplate is an optional Go text/template that generates the cloop
	// goal string. The template receives a TemplateData value.
	// When empty, the --goal flag value is used verbatim.
	GoalTemplate string `yaml:"goal_template,omitempty"`

	// Hooks defines shell commands to run at plan/task lifecycle events.
	Hooks hooks.Config `yaml:"hooks,omitempty"`

	// EnvVars lists environment variables to set before running the recipe.
	// These are merged with the project's existing env vars (recipe values win).
	EnvVars []env.Var `yaml:"env_vars,omitempty"`
}

type RunConfig struct {
	// Goal overrides the default goal. Required when GoalTemplate is non-empty
	// and no default is embedded in the recipe.
	Goal string

	// ExtraVars are additional key→value pairs available inside templates.
	ExtraVars map[string]string

	// WorkDir is the project working directory.
	WorkDir string

	// CloopBin is the path to the cloop binary (defaults to os.Executable).
	CloopBin string

	// DryRun prints steps without executing them.
	DryRun bool
}

type RunResult struct {
	// Recipe is the recipe that was executed.
	Recipe *Recipe

	// FlowResults contains per-step outcomes.
	FlowResults []flow.StepResult

	// Err is the first fatal error, if any.
	Err error
}

type TemplateData struct {
	// Goal is the goal string provided via --goal or the recipe default.
	Goal string
	// Name is the recipe name.
	Name string
	// Timestamp is the current UTC time.
	Timestamp time.Time
	// Extra holds any additional key→value pairs passed by the caller.
	Extra map[string]string
}