v1alpha1

type Run struct {
	metav1.TypeMeta   `json:",inline"`
	metav1.ObjectMeta `json:"metadata,omitempty"`

	Spec   RunSpec   `json:"spec,omitempty"`
	Status RunStatus `json:"status,omitempty"`
}

type RunList struct {
	metav1.TypeMeta `json:",inline"`
	metav1.ListMeta `json:"metadata,omitempty"`
	Items           []Run `json:"items"`
}

type RunPhase string

type RunSpec struct {
	// Runs is the list of source configurations, identical to CLI YAML format.
	// Each entry maps a source name to its raw configuration.
	// +kubebuilder:validation:Required
	Runs []apiextensionsv1.JSON `json:"runs"`

	// Schedule is a cron expression. When set, a CronJob is created instead of a one-shot Job.
	// +optional
	Schedule string `json:"schedule,omitempty"`

	// Suspend tells the controller to suspend subsequent executions.
	// Applies only when Schedule is set.
	// +optional
	Suspend *bool `json:"suspend,omitempty"`

	// ConcurrencyPolicy specifies how to treat concurrent executions of a Job.
	// Valid values are Allow, Forbid, Replace.
	// +kubebuilder:validation:Enum=Allow;Forbid;Replace
	// +kubebuilder:default=Forbid
	// +optional
	ConcurrencyPolicy batchv1.ConcurrencyPolicy `json:"concurrencyPolicy,omitempty"`

	// BackoffLimit specifies the number of retries before marking a Job as failed.
	// +kubebuilder:default=3
	// +optional
	BackoffLimit *int32 `json:"backoffLimit,omitempty"`

	// ActiveDeadlineSeconds specifies the duration in seconds relative to the
	// startTime that the Job may be active before the system tries to terminate it.
	// +optional
	ActiveDeadlineSeconds *int64 `json:"activeDeadlineSeconds,omitempty"`

	// SuccessfulJobsHistoryLimit is the number of successful finished CronJobs to retain.
	// +kubebuilder:default=3
	// +optional
	SuccessfulJobsHistoryLimit *int32 `json:"successfulJobsHistoryLimit,omitempty"`

	// FailedJobsHistoryLimit is the number of failed finished CronJobs to retain.
	// +kubebuilder:default=1
	// +optional
	FailedJobsHistoryLimit *int32 `json:"failedJobsHistoryLimit,omitempty"`

	// Resources overrides the container resource requirements for the ingestion Job pod.
	// +optional
	Resources *corev1.ResourceRequirements `json:"resources,omitempty"`

	// PodLabels are additional labels applied to the pod template of the Job or CronJob.
	// +optional
	PodLabels map[string]string `json:"podLabels,omitempty"`

	// PodAnnotations are additional annotations applied to the pod template of the Job or CronJob.
	// +optional
	PodAnnotations map[string]string `json:"podAnnotations,omitempty"`

	// TeardownOnDelete controls whether all assets created by this pipeline are
	// destroyed when the Run resource is deleted. Defaults to true.
	// +kubebuilder:default=true
	// +optional
	TeardownOnDelete *bool `json:"teardownOnDelete,omitempty"`
}

type RunStatus struct {
	// ObservedGeneration reflects the generation of the most recently observed Run spec.
	// +optional
	ObservedGeneration int64 `json:"observedGeneration,omitempty"`

	// Phase is the high-level summary of the Run state.
	// +optional
	Phase RunPhase `json:"phase,omitempty"`

	// LastRunTime is the last time a Job was started (scheduled or manually triggered).
	// +optional
	LastRunTime *metav1.Time `json:"lastRunTime,omitempty"`

	// LastSuccessfulTime is the last time a Job completed successfully.
	// +optional
	LastSuccessfulTime *metav1.Time `json:"lastSuccessfulTime,omitempty"`

	// Active is the number of currently running Jobs.
	// +optional
	Active int32 `json:"active,omitempty"`

	// Conditions represent the latest available observations of the Run's state.
	// +optional
	Conditions []metav1.Condition `json:"conditions,omitempty"`
}