config

type Config struct {
	Version int      `yaml:"version"`
	Repos   []string `yaml:"repos"`
	// Factory names the configuration repository, which enrols repositories instead of Repos.
	Factory *struct {
		Repo string `yaml:"repo"`
	} `yaml:"factory"`
	Store   string `yaml:"store"`
	WorkDir string `yaml:"work_dir"`
	Owner   string `yaml:"owner"`
	GitHub  struct {
		TokenEnv string `yaml:"token_env"`
		Author   *struct {
			Name  string `yaml:"name"`
			Email string `yaml:"email"`
		} `yaml:"author"`
	} `yaml:"github"`
	Lease struct {
		TTL       string `yaml:"ttl"`
		Heartbeat string `yaml:"heartbeat"`
	} `yaml:"lease"`
	Poll struct {
		CI     string `yaml:"ci"`
		Review string `yaml:"review"`
	} `yaml:"poll"`
	// Executor inline declares this instance runs inside containment the operator provides, such
	// as the factory image as a job (ADR-007): every run is inline, as InlineUser.
	Executor   string `yaml:"executor"`
	InlineUser string `yaml:"inline_user"`
	Images     struct {
		Build *bool `yaml:"build"`
	} `yaml:"images"`
	Memory *struct {
		Provider  string `yaml:"provider"`
		Namespace string `yaml:"namespace"`
		Cwd       string `yaml:"cwd"`
		// Transport is cli (the ynm CLI, a store chosen by cwd) or http (a hosted ynm at
		// Endpoint, with the bearer token in TokenEnv): the shared store for a pool or CI.
		Transport string `yaml:"transport"`
		Endpoint  string `yaml:"endpoint"`
		TokenEnv  string `yaml:"token_env"`
		// Level is personal or distributed; over http it defaults to distributed, since a hosted
		// store keeps nothing at the personal level.
		Level string `yaml:"level"`
	} `yaml:"memory"`

	// Telemetry is where ynf and its runs write OpenTelemetry, and whether ynf starts ynr serve for
	// a factory job (ADR-009, ADR-011). Without it, ynf writes where the environment says.
	Telemetry *struct {
		// Spool is the spool root: factory/ for ynf, runs/<run id>/ for each run, and
		// manifests/<run id>.json.
		Spool string `yaml:"spool"`
		// RunQuota is how large a run's folder may grow, such as 64MiB.
		RunQuota  string `yaml:"run_quota"`
		Collector *struct {
			Enabled  bool   `yaml:"enabled"`
			ID       string `yaml:"id"`
			Instance string `yaml:"instance"`
			Upstream string `yaml:"upstream"`
			// Archive is how long ynr serve has at a job's end to ship what is left.
			Archive string `yaml:"archive"`
		} `yaml:"collector"`
	} `yaml:"telemetry"`

	Path     string   `yaml:"-"` // the file it was loaded from
	Shadowed []string `yaml:"-"` // other candidates found at the same level
}

type TelemetrySettings struct {
	Root      string // the spool root, absolute; empty when none is configured
	Quota     int64  // bytes a run's folder may hold; 0 is the default
	Collector spool.Collector
}