diff

type ApplyOptions struct {
	// Yes skips per-delete interactive confirmation. Required when
	// stdin is not a TTY and the plan contains deletes.
	Yes bool
	// ChangeSetSlug is the slug used when opening a per-Space
	// ChangeSet for updates. Defaults to
	// changeset.DefaultSlug(time.Now()) when empty.
	ChangeSetSlug string
	// ChangeSetDescription is the human-readable description on the
	// opened ChangeSet. Defaults to a generic "installer update" line
	// when empty.
	ChangeSetDescription string
	// Targets maps a Space slug to the target ref forwarded to
	// `cub unit create --target` for adds in that Space. The ref is the
	// explicit --target (slug, space/slug, or UUID) when the operator
	// passed one, otherwise the Space's recorded TargetID annotation
	// (resolved by the CLI before Apply runs). A missing or empty entry
	// means no target binding.
	Targets map[string]string
	// Annotations and Labels are the operator's --unit-annotation /
	// --unit-label values, forwarded to `cub unit create` for adds. They
	// are NOT applied to existing Units on update — that would clobber
	// user post-install metadata edits, which Principle 1
	// (read-only-to-installer for post-install state in ConfigHub) does
	// not allow. (The PackageVersion annotation is the one exception —
	// see updateUnit — because it tracks which package version last
	// touched each Unit, which the installer owns.)
	Annotations []string
	Labels      []string
	// Stdout/Stderr override the I/O streams; nil uses os.Stdout/Stderr.
	// Tests pass buffers to capture output.
	Stdout io.Writer
	Stderr io.Writer
	// PostSpaceHook runs after each Space's Unit + link changes. The
	// CLI passes a hook that refreshes the installer-record Unit so
	// the cub-side spec stays in sync with local. Nil = no-op.
	PostSpaceHook PackageRefresher
}

type ApplyResult struct {
	Created          int
	Updated          int
	Deleted          int
	ChangeSetsOpened []ChangeSetRef
}

type ChangeSetRef struct {
	Space        string
	Slug         string
	Component    string
	UpdatedSlugs []string
}

type PackageRefresher func(ctx context.Context, sp SpacePlan) error

type Plan struct {
	Spaces []SpacePlan
}

type SlugDiff struct {
	Slug string
	// Path is the rendered manifest file. Set for Adds and Updates;
	// empty for Deletes. For AppConfig updates this is unused — the
	// raw env content is staged from AppCfg.Content at apply time.
	Path string
	// DiffText is the cub -o mutations human-readable diff for this
	// slug, ANSI-stripped. Set only for Updates.
	DiffText string
	// AppCfg is non-nil for the AppConfig Unit of an AppConfig
	// manifest (the carrier ConfigMap that upload split into AppConfig
	// + placeholder + renderer Target). Apply uses it to stage raw env
	// content for the merge-external-source update. Nil for regular
	// Kubernetes manifests.
	AppCfg *upload.AppConfigManifest
}

type SpacePlan struct {
	// Package is the source-package name (the value of the Package
	// label).
	Package string
	// PackageVersion is informational; rendered alongside Package.
	PackageVersion string
	// SpaceSlug is the ConfigHub Space slug.
	SpaceSlug string
	// Adds are slugs that exist in the rendered output but not in
	// ConfigHub. Path points to the rendered manifest file.
	Adds []SlugDiff
	// Updates are slugs that exist in both, with cub's dry-run
	// reporting non-empty mutations. DiffText is the cub -o mutations
	// output (ANSI-stripped).
	Updates []SlugDiff
	// Deletes are slugs that exist in ConfigHub (under the Package
	// label) but not in the rendered output. The installer-record Unit
	// is excluded.
	Deletes []SlugDiff
	// Images is the post-render image set for the footer; one entry per
	// container per workload found in rendered output.
	Images []WorkloadImage
}

type WorkloadImage struct {
	Kind      string // Deployment, StatefulSet, DaemonSet, Job, CronJob, Pod, ReplicaSet
	Name      string // metadata.name
	Container string // .name from the container spec
	Image     string // .image
	// Init reports whether this entry came from initContainers.
	Init bool
}