v2

type CaproniConfig struct {
	// Version is the configuration schema version (required, must be 2).
	Version int `yaml:"version"`

	Cluster      types.ClusterConfig                               `yaml:"cluster"`
	Repositories *orderedmap.OrderedMap[string, *RepositoryConfig] `yaml:"repositories"`

	// Deployers configuration (v2 only).
	Deployers *orderedmap.OrderedMap[string, *DeployerConfig] `yaml:"deployers,omitempty"`

	// Reloaders configuration (v2 only).
	Reloaders *orderedmap.OrderedMap[string, *ReloaderConfig] `yaml:"reloaders,omitempty"`

	// ConfigFile is the absolute path to the configuration file.
	// This field is populated by LoadCaproniConfig and is not part of the YAML.
	ConfigFile string `yaml:"-"`

	// ConfigDir is the absolute path to the directory containing the configuration file.
	// This field is populated by LoadCaproniConfig and is not part of the YAML.
	// Use this to resolve relative paths in repository configurations.
	ConfigDir string `yaml:"-"`

	// CopySleepImage is the Docker image used for deployment copies in edit mode.
	// Populated by LoadCaproniConfig from GL_COPY_SLEEP_IMAGE; not configurable in caproni.yaml.
	CopySleepImage string `yaml:"-"`
}

type DeployerConfig struct {
	Type       string      `yaml:"type"`                 // Required: "helm", etc.
	Repository *string     `yaml:"repository,omitempty"` // Optional: reference to repository name
	EditMode   bool        `yaml:"edit_mode,omitempty"`  // Default: false
	Helm       *HelmConfig `yaml:"helm,omitempty"`       // Required if type=="helm"
}

type DynamicOverrideConfig struct {
	Type             string `yaml:"type"`                         // Required: "gitlab_repo_version_files" or "release_manifest"
	GitLabSourceRepo string `yaml:"gitlab_source_repo,omitempty"` // Required if type=="gitlab_repo_version_files"
	VersionMap       string `yaml:"version_map,omitempty"`        // Required if type=="gitlab_repo_version_files"
}

type FilesystemConfig struct {
	Mode      string            `yaml:"mode,omitempty"`       // Optional: Filesystem mode ("write", "local", "localwithoverrides", "read"). Default: "write"
	ReadWrite []string          `yaml:"read_write,omitempty"` // Optional: Regex patterns for read-write paths
	ReadOnly  []string          `yaml:"read_only,omitempty"`  // Optional: Regex patterns for read-only paths
	Mapping   map[string]string `yaml:"mapping,omitempty"`    // Optional: Path remapping rules (regex pattern -> replacement string)
}

type HelmConfig struct {
	Namespace        string                  `yaml:"namespace"` // Required
	ValuesFile       string                  `yaml:"values_file,omitempty"`
	DynamicOverrides []DynamicOverrideConfig `yaml:"dynamic_overrides,omitempty"`
	Repository       *HelmRepositoryConfig   `yaml:"repository,omitempty"` // Optional: for non-edit mode
	Release          *HelmReleaseConfig      `yaml:"release,omitempty"`    // Optional: for non-edit mode
}

type HelmReleaseConfig struct {
	Name  string `yaml:"name"`  // Required: release name
	Chart string `yaml:"chart"` // Required: chart name (e.g., "gitlab/gitlab")
}

type HelmRepositoryConfig struct {
	Name string `yaml:"name"` // Required: name for helm repo add
	URL  string `yaml:"url"`  // Required: URL of the Helm repository
}

type LifecycleHookConfig struct {
	Type         string `yaml:"type"` // Required: "edit_mode_prepare", "edit_mode_start", "edit_mode_stop", "edit_mode_shutdown"
	Script       string `yaml:"script,omitempty"`
	MirrorScript string `yaml:"mirror_script,omitempty"`
	Job          string `yaml:"job,omitempty"`
}

type MirrorConfig struct {
	Target            *MirrorTargetConfig                            `yaml:"target"`               // Required: Target resource configuration
	Filesystem        *FilesystemConfig                              `yaml:"filesystem,omitempty"` // Optional: Filesystem configuration
	Network           *MirrorNetworkConfig                           `yaml:"network,omitempty"`    // Optional: Network configuration
	EditModeProcesses *orderedmap.OrderedMap[string, *ProcessConfig] `yaml:"edit_mode_processes"`  // Required: At least one process must be defined
	LifecycleHooks    []LifecycleHookConfig                          `yaml:"lifecycle_hooks,omitempty"`
}

type MirrorNetworkConfig struct {
	Outgoing *MirrorOutgoingConfig `yaml:"outgoing,omitempty"`
}

type MirrorOutgoingConfig struct {
	IgnoreLocalhost bool `yaml:"ignore_localhost,omitempty"`
}

type MirrorTargetConfig struct {
	Namespace      string `yaml:"namespace"`           // Required: Kubernetes namespace
	KubernetesType string `yaml:"kubernetes_type"`     // Required: "deployment", "statefulset", "daemonset", or "pod"
	Name           string `yaml:"name"`                // Required: Resource name
	Container      string `yaml:"container,omitempty"` // Optional: Target a specific container within the resource
}

type ProcessConfig struct {
	Command string `yaml:"command"`        // Required
	Port    int    `yaml:"port,omitempty"` // Optional (1-65535)
}

type ReloaderConfig struct {
	Name       string          `yaml:"-"`                   // Populated by ApplyDefaults from the config key
	Type       string          `yaml:"type"`                // Required: "mirror", "skaffold"
	Repository string          `yaml:"repository"`          // Required: reference to repository name
	EditMode   bool            `yaml:"edit_mode,omitempty"` // Default: false
	Mirror     *MirrorConfig   `yaml:"mirror,omitempty"`    // Required if type=="mirror"
	Skaffold   *SkaffoldConfig `yaml:"skaffold,omitempty"`  // Required if type=="skaffold"
}

type RepositoryConfig struct {
	Repository string `yaml:"repository"` // Required (URI format)
	Directory  string `yaml:"directory"`  // Required
}

type SkaffoldConfig struct {
	Namespace  string `yaml:"namespace"`   // Required: Kubernetes namespace
	ConfigFile string `yaml:"config_file"` // Required: Path to skaffold.yaml
}