config

type BuildConfig struct {
	// Version must be 1.
	Version int `yaml:"version"`

	// OutputPath is the destination path for the merged output.
	OutputPath string `yaml:"output_path"`

	// Write controls whether output is written to OutputPath (true) or stdout (false).
	// This field is not present in the YAML schema; it is set by the --write CLI flag.
	Write bool `yaml:"-"`

	// Overlays is the ordered list of repositories and files to merge.
	Overlays []Overlay `yaml:"overlays"`
}

type CLIFlags struct {
	Repo           string
	Ref            string
	Commit         string
	Files          []string
	OutputPath     string
	Write          bool
	Token          string
	Username       string
	Password       string
	SSHKeyPath     string
	SSHKeyPassword string
}

type Overlay struct {
	// Repo is a remote URL or local path. Remote URLs support https://, http://,
	// ssh://, git://, and git@ (SCP-style). Local paths may be absolute,
	// relative (./  ../), or file:// URIs.
	// Append //subdir to set a subdirectory (e.g. https://github.com/org/repo//configs).
	Repo string `yaml:"repo"`

	// Ref is the branch or tag reference (e.g. refs/heads/main).
	// Mutually exclusive with Commit.
	Ref string `yaml:"ref"`

	// Commit is an exact commit SHA to check out (7–40 hex characters).
	// Mutually exclusive with Ref.
	Commit string `yaml:"commit"`

	// Subdirectory is prepended to all file paths when reading from the repo.
	// For remote URLs the //subdir URL syntax may be used instead.
	Subdirectory string `yaml:"subdirectory"`

	// Files is the ordered list of file paths to extract and merge.
	Files []string `yaml:"files"`

	// Auth holds optional credentials for cloning the repository.
	Auth OverlayAuth `yaml:"auth"`
}

type OverlayAuth struct {
	Token          string `yaml:"token"`
	Username       string `yaml:"username"`
	Password       string `yaml:"password"`
	SSHKeyPath     string `yaml:"ssh_key_path"`
	SSHKeyPassword string `yaml:"ssh_key_password"`
}