policy

type Budgets struct {
	MaxTurns  int    `yaml:"max_turns" json:"max_turns,omitempty"`
	MaxTokens int    `yaml:"max_tokens" json:"max_tokens,omitempty"`
	MaxWall   string `yaml:"max_wall" json:"max_wall,omitempty"`
}

type Command struct {
	Argv []string `yaml:"argv" json:"argv"`
	// Image is the image the command runs in on a container executor. When the lane resolves to
	// the command runner it wins over run.image; when it resolves to ynh it is ignored.
	Image string `yaml:"image" json:"image,omitempty"`
	// ImageUser keeps the image's own user and home, as a ynh-built agent image does, instead of
	// running as ynf's user. It is for an image whose command needs its own user; a docker executor
	// only.
	ImageUser  bool   `yaml:"image_user" json:"image_user,omitempty"`
	ResultFile string `yaml:"result_file" json:"result_file,omitempty"`
}

type Defaults struct {
	Executor  string  `yaml:"executor" json:"executor,omitempty"`
	Attempts  int     `yaml:"attempts" json:"attempts,omitempty"`
	Retention string  `yaml:"retention" json:"retention,omitempty"`
	NoCIAfter string  `yaml:"no_ci_after" json:"no_ci_after,omitempty"`
	Egress    *Egress `yaml:"egress" json:"egress,omitempty"`
	Stop      *Stop   `yaml:"stop" json:"stop,omitempty"`
	PR        *PR     `yaml:"pr" json:"pr,omitempty"`
	Labels    *Labels `yaml:"labels" json:"labels,omitempty"`
}

type Egress struct {
	Allow []string `yaml:"allow" json:"allow"`
}

type Factory struct {
	Version  int                       `yaml:"version" json:"version"`
	Repos    []string                  `yaml:"repos" json:"repos"`
	Trackers map[string]map[string]any `yaml:"trackers" json:"trackers,omitempty"`
	Forges   map[string]map[string]any `yaml:"forges" json:"forges,omitempty"`
}

type File struct {
	Version  int             `yaml:"version" json:"version"`
	Defaults Defaults        `yaml:"defaults" json:"defaults"`
	Lanes    map[string]Lane `yaml:"lanes" json:"lanes"`
}

type Guards struct {
	Eligible string `yaml:"eligible" json:"eligible,omitempty"`
}

type Intake struct {
	GitHubSearch string `yaml:"github.search" json:"github.search,omitempty"`
	JiraSearch   string `yaml:"jira.search" json:"jira.search,omitempty"`
	Every        string `yaml:"every" json:"every,omitempty"`
}

type LabelChange struct {
	Add    []string `yaml:"add" json:"add,omitempty"`
	Remove []string `yaml:"remove" json:"remove,omitempty"`
}

type Labels struct {
	OnClaim    *LabelChange `yaml:"on_claim" json:"on_claim,omitempty"`
	OnPropose  *LabelChange `yaml:"on_propose" json:"on_propose,omitempty"`
	OnReview   *LabelChange `yaml:"on_review" json:"on_review,omitempty"`
	OnEscalate *LabelChange `yaml:"on_escalate" json:"on_escalate,omitempty"`
	OnDone     *LabelChange `yaml:"on_done" json:"on_done,omitempty"`
}

type Lane struct {
	Name string `yaml:"-" json:"name"`
	// ID is the lane's own id for telemetry, when it declares one; otherwise the id is where the
	// lane is defined plus its name (ADR-006).
	ID        string              `yaml:"id" json:"id,omitempty"`
	Kind      string              `yaml:"kind" json:"kind"`
	Enabled   *bool               `yaml:"enabled" json:"enabled,omitempty"`
	Intake    []Intake            `yaml:"intake" json:"intake"`
	Guards    Guards              `yaml:"guards" json:"guards"`
	Run       Run                 `yaml:"run" json:"run"`
	When      map[string]Reaction `yaml:"when" json:"when"`
	PR        PR                  `yaml:"pr" json:"pr"`
	Stop      Stop                `yaml:"stop" json:"stop"`
	Executor  string              `yaml:"executor" json:"executor,omitempty"`
	Attempts  int                 `yaml:"attempts" json:"attempts,omitempty"`
	Retention string              `yaml:"retention" json:"retention,omitempty"`
	// NoCIAfter is how long a proposed head commit may have no check or status at all before the
	// item reacts (when: no_ci). Empty means DefaultNoCIAfter; 0s switches it off.
	NoCIAfter string  `yaml:"no_ci_after" json:"no_ci_after,omitempty"`
	Labels    *Labels `yaml:"labels" json:"labels,omitempty"`
}

type PR struct {
	AllowedPaths   []string `yaml:"allowed_paths" json:"allowed_paths,omitempty"`
	ProtectedPaths []string `yaml:"protected_paths" json:"protected_paths,omitempty"`
	Draft          *bool    `yaml:"draft" json:"draft,omitempty"`
}

type Pin struct {
	Repo string `json:"repo"`
	Ref  string `json:"ref"`
	// URL is the repository as the clone tools are given it, set only when it differs from Repo:
	// a bare host and path is cloned over https.
	URL string `json:"url,omitempty"`
}

type Reaction struct {
	Action     string `json:"action,omitempty"`
	Retry      int    `json:"retry,omitempty"`
	Then       string `json:"then,omitempty"`
	ResumeWith string `json:"resume_with,omitempty"`
	Max        int    `json:"max,omitempty"`
}

type Run struct {
	Runner   string   `yaml:"runner" json:"runner,omitempty"`
	Executor string   `yaml:"executor" json:"executor,omitempty"`
	Image    string   `yaml:"image" json:"image,omitempty"`
	Egress   *Egress  `yaml:"egress" json:"egress,omitempty"`
	Env      []string `yaml:"env" json:"env,omitempty"`
	Ynh      *Ynh     `yaml:"ynh" json:"ynh,omitempty"`
	Command  *Command `yaml:"command" json:"command,omitempty"`
}

type Stop struct {
	YieldFloor        float64 `yaml:"yield_floor" json:"yield_floor,omitempty"`
	ReviewTimeCeiling string  `yaml:"review_time_ceiling" json:"review_time_ceiling,omitempty"`
	EscapedDefects    int     `yaml:"escaped_defects" json:"escaped_defects,omitempty"`
	MaxOpenProposals  int     `yaml:"max_open_proposals" json:"max_open_proposals,omitempty"`
	MinSample         int     `yaml:"min_sample" json:"min_sample,omitempty"`
}

type Ynh struct {
	Harness string `yaml:"harness" json:"harness"`
	Vendor  string `yaml:"vendor" json:"vendor,omitempty"`
	Base    string `yaml:"base" json:"base,omitempty"`
	Focus   string `yaml:"focus" json:"focus,omitempty"`
	Profile string `yaml:"profile" json:"profile,omitempty"`
	Sandbox string `yaml:"sandbox" json:"sandbox,omitempty"`
	// Model is ynh's --model: the model the agent runs on, as the vendor names it. Empty is the
	// vendor's default. The schema limits it to a plain name, so it never reaches argv as a flag.
	Model string `yaml:"model" json:"model,omitempty"`
	// Effort is ynh's --effort (low, medium or high): the reasoning effort the agent is asked to
	// run at, which ynh maps to each vendor's own setting and refuses where a vendor has none.
	// Empty is the harness's agent.effort, else the vendor's default. It needs ynh 0.10.0 or later.
	Effort string `yaml:"effort" json:"effort,omitempty"`
	// AutoApprove is ynh's --auto-approve (edits or all): the worker runs without approval prompts.
	// ynf passes it only to a contained run (ADR-007).
	AutoApprove string            `yaml:"auto_approve" json:"auto_approve,omitempty"`
	Budgets     *Budgets          `yaml:"budgets" json:"budgets,omitempty"`
	SensorScope map[string]string `yaml:"sensor_scope" json:"sensor_scope,omitempty"`
	// TelemetryRelay sets YNH_TELEMETRY_RELAY=1 for the lane's runs, so ynh agent run starts ynr
	// relay beside the vendor CLI and the vendor's telemetry reaches the run's spool folder.
	TelemetryRelay bool `yaml:"telemetry_relay" json:"telemetry_relay,omitempty"`
}