spec

type Autoscaling struct {
	Enabled     bool     `json:"enabled,omitempty" yaml:"enabled,omitempty"`
	MinReplicas int      `json:"minReplicas,omitempty" yaml:"minReplicas,omitempty"`
	MaxReplicas int      `json:"maxReplicas,omitempty" yaml:"maxReplicas,omitempty"`
	Metrics     []Metric `json:"metrics,omitempty" yaml:"metrics,omitempty"`
}

type Component struct {
	// Role selects the default deployment strategy for the component.
	Role ComponentRole `json:"role,omitempty" yaml:"role,omitempty"`
	// EnvFile is the path to a component-specific dotenv file.
	EnvFile string `json:"envFile,omitempty" yaml:"envFile,omitempty"`
	// ConfigFile is the path to a component-specific config file.
	ConfigFile string `json:"configFile,omitempty" yaml:"configFile,omitempty"`
	// Environments limits the component to the named environments.
	Environments []string `json:"environments,omitempty" yaml:"environments,omitempty"`
	// Kind selects stateless or stateful deployment behavior.
	Kind ComponentKind `json:"kind,omitempty" yaml:"kind,omitempty"`
	// Image is the container image reference.
	Image string `json:"image" yaml:"image"`
	// Command overrides the container entrypoint.
	Command []string `json:"command,omitempty" yaml:"command,omitempty"`
	// Args overrides the container command arguments.
	Args []string `json:"args,omitempty" yaml:"args,omitempty"`
	// Port is the primary container port for services.
	Port int `json:"port,omitempty" yaml:"port,omitempty"`
	// Autoscaling configures horizontal pod autoscaling.
	Autoscaling *Autoscaling `json:"autoscaling,omitempty" yaml:"autoscaling,omitempty"`
	// Resources sets explicit CPU, memory, and storage requests and limits.
	Resources Resources `json:"resources" yaml:"resources,omitempty"`
	// ResourcePreset selects a named resource profile when Resources is empty.
	ResourcePreset ResourcePreset `json:"resourcePreset,omitempty" yaml:"resourcePreset,omitempty"`
	// Ingress exposes the component through an HTTP or HTTPS route.
	Ingress *Ingress `json:"ingress,omitempty" yaml:"ingress,omitempty"`
	// Env sets static environment variables for the container.
	Env map[string]string `json:"env,omitempty" yaml:"env,omitempty"`
	// Health configures ready and alive checks for the component.
	Health *Health `json:"health,omitempty" yaml:"health,omitempty"`
}

type ComponentKind string

type ComponentRole string

type DefaultValues map[string]any

type Environment struct {
	// Name is the environment identifier (e.g. "staging").
	Name string `json:"name" yaml:"name"`
	// EnvFile is the path to a dotenv file for this environment.
	EnvFile string `json:"envFile,omitempty" yaml:"envFile,omitempty"`
	// ConfigFile is the path to an environment-specific config file.
	ConfigFile string `json:"configFile,omitempty" yaml:"configFile,omitempty"`
	// Context is the Kubernetes context to use for this environment.
	Context string `json:"context,omitempty" yaml:"context,omitempty"`
	// Variables holds inline key-value overrides for this environment.
	Variables map[string]string `json:"variables,omitempty" yaml:"variables,omitempty"`
}

type Health struct {
	// Ready controls the readiness check. Provide a path to upgrade from TCP
	// to HTTP. Set to false to disable readiness and startup checks entirely.
	Ready *HealthReady `json:"ready,omitempty" yaml:"ready,omitempty"`
	// Alive controls the alive check. Provide a path to upgrade from TCP to
	// HTTP. Set to false to disable the alive check entirely.
	Alive *HealthAlive `json:"alive,omitempty" yaml:"alive,omitempty"`
}

type HealthAlive struct {
	// Disabled is true when the developer set alive: false.
	Disabled bool `json:"-" yaml:"-"`
	// Path is the HTTP endpoint that must return 2xx for the pod to be
	// considered alive. Must start with /. Check only internal process
	// state here, not external dependencies.
	Path string `json:"path,omitempty" yaml:"path,omitempty"`
	// Interval is how often to check the endpoint (e.g. "10s", "1m").
	// Defaults to "10s" when omitted.
	Interval string `json:"interval,omitempty" yaml:"interval,omitempty"`
	// RestartAfter is how long the endpoint must fail continuously before
	// the pod is restarted (e.g. "60s", "2m"). Defaults to "60s" when
	// omitted. The effective window rounds up to the nearest multiple of
	// Interval.
	RestartAfter string `json:"restartAfter,omitempty" yaml:"restartAfter,omitempty"`
}

type HealthReady struct {
	// Disabled is true when the developer set ready: false.
	Disabled bool `json:"-" yaml:"-"`
	// Path is the HTTP endpoint that must return 2xx for the component to
	// receive traffic. Must start with /.
	Path string `json:"path,omitempty" yaml:"path,omitempty"`
}

type Ingress struct {
	Host string `json:"host" yaml:"host"`
	TLS  bool   `json:"tls" yaml:"tls"`
}

type Metric struct {
	Type   MetricType `json:"type" yaml:"type"`
	Target int        `json:"target" yaml:"target"`
}

type MetricType string

type ResourcePreset string

type Resources struct {
	CPU              *string `json:"cpu,omitempty" yaml:"cpu,omitempty"`
	Memory           *string `json:"memory,omitempty" yaml:"memory,omitempty"`
	EphemeralStorage *string `json:"ephemeralStorage,omitempty" yaml:"ephemeralStorage,omitempty"`
}

type Spec struct {
	// APIVersion is the schema version of the spec (e.g., "v1-alpha.1").
	APIVersion string `json:"apiVersion,omitempty" yaml:"apiVersion,omitempty"`
	// Project is the project name.
	Project string `json:"project" yaml:"project"`
	// Environments is a list of environment definitions.
	Environments []Environment `json:"environments,omitempty" yaml:"environments,omitempty"`
	// Components is a map of component names to their configuration.
	Components map[string]Component `json:"components" yaml:"components"`
}