stack

type APIVersionKind struct {
	APIVersion string `yaml:"apiVersion,omitempty" json:"apiVersion,omitempty"`
	Kind       string `yaml:"kind,omitempty" json:"kind,omitempty"`
}

type AdaptiveConcurrency struct {
	Target int
	Max    int
	Min    int
	// contains filtered or unexported fields
}

type AdaptiveConcurrencyOptions struct {
	Min int

	// WindowSize controls how many recent outcomes influence shrink/ramp.
	WindowSize int

	// RampAfterSuccesses controls how many clean successes are required before
	// increasing concurrency by 1.
	RampAfterSuccesses int

	// RampMaxFailureRate blocks ramp-up when the recent failure rate exceeds this.
	RampMaxFailureRate float64

	// CooldownSuccessesByClass controls how many subsequent successes must pass
	// (without ramping) after a failure of a given class.
	CooldownSuccessesByClass map[string]int
}

type ApplyCacheDecision struct {
	Skip           bool
	CacheHit       bool
	Reason         string
	DesiredDigest  string
	ObservedDigest string
	HasHooks       bool
}

type ApplyCacheEntry struct {
	DesiredDigest string
	HasHooks      bool
	LastRunID     string
	UpdatedAtNS   int64
}

type ApplyCacheKey struct {
	ClusterKey         string
	Namespace          string
	ReleaseName        string
	Command            string
	EffectiveInputHash string
}

type ApplyOptions struct {
	Atomic          *bool          `yaml:"atomic,omitempty" json:"atomic,omitempty"`
	Timeout         *time.Duration `yaml:"timeout,omitempty" json:"timeout,omitempty"`
	Wait            *bool          `yaml:"wait,omitempty" json:"wait,omitempty"`
	CreateNamespace *bool          `yaml:"createNamespace,omitempty" json:"createNamespace,omitempty"`
}

type BudgetWaitFields struct {
	BudgetType string
	BudgetKey  string
	Limit      int64
	Used       int64
}

type BundleKey struct {
	APIVersion string `json:"apiVersion"`
	Type       string `json:"type"` // ed25519
	PublicKey  string `json:"publicKey"`
	// PrivateKey is base64 of ed25519.PrivateKey (64 bytes).
	PrivateKey string `json:"privateKey,omitempty"`
	// Seed is base64 of 32-byte seed (optional alternative).
	Seed string `json:"seed,omitempty"`
}

type BundleMissingNodeError struct {
	NodeID string
}

type BundleSignature struct {
	APIVersion     string `json:"apiVersion"`
	CreatedAt      string `json:"createdAt"`
	Algorithm      string `json:"algorithm"` // ed25519
	PublicKey      string `json:"publicKey"`
	ManifestSHA256 string `json:"manifestSha256"`
	Signature      string `json:"signature"`
}

type ClusterTarget struct {
	Name       string `yaml:"name,omitempty" json:"name,omitempty"`
	Kubeconfig string `yaml:"kubeconfig,omitempty" json:"kubeconfig,omitempty"`
	Context    string `yaml:"context,omitempty" json:"context,omitempty"`
}

type CompileOptions struct {
	Profile string
}

type ConcurrencyFields struct {
	From     int
	To       int
	Reason   string
	Class    string
	Window   int
	FailRate float64
}

type DeleteOptions struct {
	Timeout *time.Duration `yaml:"timeout,omitempty" json:"timeout,omitempty"`
}

type EffectiveApplyInput struct {
	Atomic          bool   `json:"atomic"`
	Wait            bool   `json:"wait"`
	CreateNamespace bool   `json:"createNamespace"`
	Timeout         string `json:"timeout"`
	Digest          string `json:"digest,omitempty"`
}

type EffectiveChartInput struct {
	Ref             string `json:"ref"`
	Version         string `json:"version,omitempty"`
	ResolvedVersion string `json:"resolvedVersion,omitempty"`
	Digest          string `json:"digest,omitempty"`
}

type EffectiveDeleteInput struct {
	Timeout string `json:"timeout"`
	Digest  string `json:"digest,omitempty"`
}

type EffectiveInput struct {
	APIVersion string `json:"apiVersion"`

	StackGitCommit string `json:"stackGitCommit,omitempty"`
	StackGitDirty  bool   `json:"stackGitDirty,omitempty"`

	TorqueVersion   string `json:"torqueVersion,omitempty"`
	TorqueGitCommit string `json:"torqueGitCommit,omitempty"`

	NodeID string `json:"nodeId"`

	Chart EffectiveChartInput `json:"chart"`

	Values []FileDigest `json:"values,omitempty"`

	SetDigest     string `json:"setDigest,omitempty"`
	ClusterDigest string `json:"clusterDigest,omitempty"`

	Apply  EffectiveApplyInput  `json:"apply"`
	Delete EffectiveDeleteInput `json:"delete"`
	Verify EffectiveVerifyInput `json:"verify"`
}

type EffectiveInputHashOptions struct {
	StackRoot             string
	IncludeValuesContents bool
	StackGitIdentity      *GitIdentity
}

type EffectiveVerifyInput struct {
	Enabled           bool                         `json:"enabled"`
	FailOnWarnings    bool                         `json:"failOnWarnings"`
	WarnOnly          bool                         `json:"warnOnly"`
	EventsWindow      string                       `json:"eventsWindow"`
	Timeout           string                       `json:"timeout"`
	DenyReasons       []string                     `json:"denyReasons,omitempty"`
	AllowReasons      []string                     `json:"allowReasons,omitempty"`
	RequireConditions []VerifyConditionRequirement `json:"requireConditions,omitempty"`
	Digest            string                       `json:"digest,omitempty"`
}

type FailureCluster struct {
	ErrorClass     string   `json:"errorClass"`
	ErrorDigest    string   `json:"errorDigest"`
	FailedEvents   int      `json:"failedEvents"`
	AffectedNodes  int      `json:"affectedNodes"`
	ExampleNodeIDs []string `json:"exampleNodeIds,omitempty"`
}

type FileDigest struct {
	Path   string `json:"path"`
	Digest string `json:"digest"`
}

type GitIdentity struct {
	Commit string
	Dirty  bool
}

type Graph struct {
	// contains filtered or unexported fields
}

type HTTPHookConfig struct {
	Method  string            `yaml:"method,omitempty" json:"method,omitempty"`
	URL     string            `yaml:"url,omitempty" json:"url,omitempty"`
	Headers map[string]string `yaml:"headers,omitempty" json:"headers,omitempty"`
	Body    string            `yaml:"body,omitempty" json:"body,omitempty"`
}

type HookSpec struct {
	Name    string         `yaml:"name,omitempty" json:"name,omitempty"`
	Type    string         `yaml:"type,omitempty" json:"type,omitempty"` // kubectl|script|http
	RunOnce bool           `yaml:"runOnce,omitempty" json:"runOnce,omitempty"`
	When    string         `yaml:"when,omitempty" json:"when,omitempty"` // success|failure|always
	Timeout *time.Duration `yaml:"timeout,omitempty" json:"timeout,omitempty"`
	Retry   *int           `yaml:"retry,omitempty" json:"retry,omitempty"` // max attempts, includes the initial attempt

	Kubeconfig string `yaml:"kubeconfig,omitempty" json:"kubeconfig,omitempty"`
	Context    string `yaml:"context,omitempty" json:"context,omitempty"`
	Namespace  string `yaml:"namespace,omitempty" json:"namespace,omitempty"`

	Kubectl *KubectlHookConfig `yaml:"kubectl,omitempty" json:"kubectl,omitempty"`
	Script  *ScriptHookConfig  `yaml:"script,omitempty" json:"script,omitempty"`
	HTTP    *HTTPHookConfig    `yaml:"http,omitempty" json:"http,omitempty"`
}

type InferDepsOptions struct {
	IncludeConfigRefs bool
	Secrets           *deploy.SecretOptions
}

type InferredNeed struct {
	Name    string           `json:"name"`
	Reasons []InferredReason `json:"reasons,omitempty"`
}

type InferredReason struct {
	Type     string `json:"type"`
	Evidence string `json:"evidence,omitempty"`
}

type InputBundleManifest struct {
	APIVersion string `json:"apiVersion"`
	CreatedAt  string `json:"createdAt"`
	PlanHash   string `json:"planHash,omitempty"`

	Nodes []InputBundleNode `json:"nodes"`
}

type InputBundleNode struct {
	ID       string             `json:"id"`
	ChartDir string             `json:"chartDir"`
	Values   []InputBundleValue `json:"values,omitempty"`
}

type InputBundleValue struct {
	OriginalPath string `json:"originalPath,omitempty"`
	BundlePath   string `json:"bundlePath"`
	Digest       string `json:"digest,omitempty"`
}

type KubectlHookConfig struct {
	Args []string `yaml:"args,omitempty" json:"args,omitempty"`
}

type LoadSealedPlanOptions struct {
	// StateStoreRoot is written into Plan.StackRoot so the run uses the current stack root
	// for state storage, even when inputs are loaded from a sealed artifact.
	StateStoreRoot string

	// Exactly one of SealedDir or BundlePath must be set.
	SealedDir    string
	BundlePath   string
	VerifyBundle bool

	RequireSigned bool
	TrustedPubKey []byte
}

type LoadedRun struct {
	RootDir     string
	RunID       string
	Plan        *Plan
	StatusByID  map[string]string
	AttemptByID map[string]int
}

type NodeDiffSummary struct {
	Add     int            `json:"add"`
	Change  int            `json:"change"`
	Replace int            `json:"replace"`
	Destroy int            `json:"destroy"`
	Risky   map[string]int `json:"risky,omitempty"`
	Error   string         `json:"error,omitempty"`
}

type NodeExecutor interface {
	RunNode(ctx context.Context, node *runNode, command string) error
}

type NodeMetaFields struct {
	Cluster          string
	Namespace        string
	Name             string
	ExecutionGroup   int
	ParallelismGroup string
	PrimaryKind      string
	Critical         bool
}

type NodeStepCheckpoint struct {
	Step          string
	Attempt       int
	StartedAtNS   int64
	CompletedAtNS int64
	Status        string
	Message       string
	ErrorClass    string
	ErrorMessage  string
	ErrorDigest   string
	CursorJSON    string
}

type PhaseFields struct {
	Phase   string
	Status  string
	Message string
}

type Plan struct {
	StackRoot string                        `json:"stackRoot"`
	StackName string                        `json:"stackName"`
	Profile   string                        `json:"profile"`
	Nodes     []*ResolvedRelease            `json:"nodes"`
	Order     []string                      `json:"order,omitempty"`
	Runner    RunnerResolved                `json:"runner,omitempty"`
	Hooks     StackHooksConfig              `json:"hooks,omitempty"`
	ByID      map[string]*ResolvedRelease   `json:"-"`
	ByCluster map[string][]*ResolvedRelease `json:"-"`
}

type ReleaseDefaults struct {
	Cluster    ClusterTarget     `yaml:"cluster,omitempty" json:"cluster,omitempty"`
	Namespace  string            `yaml:"namespace,omitempty" json:"namespace,omitempty"`
	Values     []string          `yaml:"values,omitempty" json:"values,omitempty"`
	Set        map[string]string `yaml:"set,omitempty" json:"set,omitempty"`
	Apply      ApplyOptions      `yaml:"apply,omitempty" json:"apply,omitempty"`
	Delete     DeleteOptions     `yaml:"delete,omitempty" json:"delete,omitempty"`
	Verify     VerifyOptions     `yaml:"verify,omitempty" json:"verify,omitempty"`
	Tags       []string          `yaml:"tags,omitempty" json:"tags,omitempty"`
	Extra      map[string]any    `yaml:",inline" json:"-"`
	RawIgnored map[string]any    `yaml:"-" json:"-"`
}

type ReleaseFile struct {
	APIVersionKind `yaml:",inline" json:",inline"`

	Name         string            `yaml:"name,omitempty" json:"name,omitempty"`
	Chart        string            `yaml:"chart,omitempty" json:"chart,omitempty"`
	ChartVersion string            `yaml:"chartVersion,omitempty" json:"chartVersion,omitempty"`
	Wave         int               `yaml:"wave,omitempty" json:"wave,omitempty"`
	Critical     bool              `yaml:"critical,omitempty" json:"critical,omitempty"`
	Parallelism  string            `yaml:"parallelismGroup,omitempty" json:"parallelismGroup,omitempty"`
	Cluster      ClusterTarget     `yaml:"cluster,omitempty" json:"cluster,omitempty"`
	Namespace    string            `yaml:"namespace,omitempty" json:"namespace,omitempty"`
	Values       []string          `yaml:"values,omitempty" json:"values,omitempty"`
	Set          map[string]string `yaml:"set,omitempty" json:"set,omitempty"`
	Tags         []string          `yaml:"tags,omitempty" json:"tags,omitempty"`
	Needs        []string          `yaml:"needs,omitempty" json:"needs,omitempty"`
	Apply        ApplyOptions      `yaml:"apply,omitempty" json:"apply,omitempty"`
	Delete       DeleteOptions     `yaml:"delete,omitempty" json:"delete,omitempty"`
	Hooks        StackHooksConfig  `yaml:"hooks,omitempty" json:"hooks,omitempty"`
}

type ReleaseSpec struct {
	Name         string            `yaml:"name,omitempty" json:"name,omitempty"`
	Chart        string            `yaml:"chart,omitempty" json:"chart,omitempty"`
	ChartVersion string            `yaml:"chartVersion,omitempty" json:"chartVersion,omitempty"`
	Wave         int               `yaml:"wave,omitempty" json:"wave,omitempty"`
	Critical     bool              `yaml:"critical,omitempty" json:"critical,omitempty"`
	Parallelism  string            `yaml:"parallelismGroup,omitempty" json:"parallelismGroup,omitempty"`
	Cluster      ClusterTarget     `yaml:"cluster,omitempty" json:"cluster,omitempty"`
	Namespace    string            `yaml:"namespace,omitempty" json:"namespace,omitempty"`
	Values       []string          `yaml:"values,omitempty" json:"values,omitempty"`
	Set          map[string]string `yaml:"set,omitempty" json:"set,omitempty"`
	Tags         []string          `yaml:"tags,omitempty" json:"tags,omitempty"`
	Needs        []string          `yaml:"needs,omitempty" json:"needs,omitempty"`
	Apply        ApplyOptions      `yaml:"apply,omitempty" json:"apply,omitempty"`
	Delete       DeleteOptions     `yaml:"delete,omitempty" json:"delete,omitempty"`
	Verify       VerifyOptions     `yaml:"verify,omitempty" json:"verify,omitempty"`
	Hooks        StackHooksConfig  `yaml:"hooks,omitempty" json:"hooks,omitempty"`
}

type ResolvedRelease struct {
	ID        string        `json:"id"`
	Name      string        `json:"name"`
	Dir       string        `json:"dir"`
	Cluster   ClusterTarget `json:"cluster"`
	Namespace string        `json:"namespace"`

	Chart        string            `json:"chart"`
	ChartVersion string            `json:"chartVersion,omitempty"`
	Wave         int               `json:"wave,omitempty"`
	Critical     bool              `json:"critical,omitempty"`
	Parallelism  string            `json:"parallelismGroup,omitempty"`
	Values       []string          `json:"values"`
	Set          map[string]string `json:"set"`

	Tags  []string `json:"tags"`
	Needs []string `json:"needs"`

	Apply  ApplyOptions  `json:"apply"`
	Delete DeleteOptions `json:"delete"`
	Verify VerifyOptions `json:"verify,omitempty"`

	Hooks StackHooksConfig `json:"hooks,omitempty"`

	SelectedBy []string `json:"selectedBy,omitempty"`

	InferredNeeds       []InferredNeed `json:"inferredNeeds,omitempty"`
	InferredRole        string         `json:"inferredRole,omitempty"`
	InferredPrimaryKind string         `json:"inferredPrimaryKind,omitempty"`

	EffectiveInputHash string          `json:"effectiveInputHash,omitempty"`
	EffectiveInput     *EffectiveInput `json:"effectiveInput,omitempty"`
	ExecutionGroup     int             `json:"executionGroup,omitempty"`
}

type RetryScheduledFields struct {
	Backoff string
}

type RunAudit struct {
	APIVersion    string `json:"apiVersion"`
	RunID         string `json:"runId"`
	Status        string `json:"status"`
	CreatedAt     string `json:"createdAt"`
	UpdatedAt     string `json:"updatedAt"`
	CompletedAt   string `json:"completedAt,omitempty"`
	CreatedBy     string `json:"createdBy,omitempty"`
	Host          string `json:"host,omitempty"`
	PID           int    `json:"pid,omitempty"`
	CIRunURL      string `json:"ciRunUrl,omitempty"`
	GitAuthor     string `json:"gitAuthor,omitempty"`
	Kubeconfig    string `json:"kubeconfig,omitempty"`
	KubeContext   string `json:"kubeContext,omitempty"`
	StatePath     string `json:"statePath,omitempty"`
	FollowCommand string `json:"followCommand,omitempty"`
	RunDigest     string `json:"runDigest,omitempty"`

	Integrity       RunIntegrity     `json:"integrity"`
	Summary         *RunSummary      `json:"summary,omitempty"`
	FailureClusters []FailureCluster `json:"failureClusters,omitempty"`

	Plan   *RunPlan   `json:"plan,omitempty"`
	Events []RunEvent `json:"events,omitempty"`
}

type RunAuditOptions struct {
	RootDir       string
	RunID         string
	Verify        bool
	EventsLimit   int
	IncludePlan   bool
	IncludeEvents bool
}

type RunBundleManifest struct {
	APIVersion  string `json:"apiVersion"`
	Kind        string `json:"kind"`
	CreatedAt   string `json:"createdAt"`
	RunID       string `json:"runId"`
	RunDigest   string `json:"runDigest,omitempty"`
	StateSHA256 string `json:"stateSha256"`
}

type RunConsole struct {
	// contains filtered or unexported fields
}

type RunConsoleOptions struct {
	Enabled bool
	Verbose bool
	Width   int

	// ShowNoisyPhases forces the Phase column to include phases that are normally
	// suppressed in non-verbose mode (e.g. pre-apply/post-apply).
	ShowNoisyPhases bool

	// NodeFilter controls which nodes are shown in the node table.
	// Supported values: all|running|failed.
	NodeFilter string

	// ShowHooks renders a recent-hook activity panel below the node table.
	ShowHooks bool

	// HookTail caps stored hook events in the HOOKS panel (0 uses a default).
	HookTail int

	// ShowDetails renders an expanded per-node details panel (hooks + helm tail).
	ShowDetails bool

	// DetailsTail caps lines shown per node in the details panel (0 uses a default).
	DetailsTail int

	// Now returns the current time for elapsed calculations. Defaults to time.Now.
	Now func() time.Time

	// Color toggles ANSI styling for the TTY surface.
	Color bool

	// ShowHelmLogs renders HELM_LOG events under each node.
	ShowHelmLogs bool

	// CaptureHelmLogs stores HELM_LOG events for failure hints and the details
	// panel even when ShowHelmLogs is false.
	CaptureHelmLogs bool

	// HelmLogsMode controls which nodes are included in the HELM LOGS section.
	// Supported values: off|on|all. "on" shows only non-succeeded nodes.
	HelmLogsMode string

	// HelmLogTail caps stored log lines per node (0 uses a default).
	HelmLogTail int
}

type RunError struct {
	Class   string `json:"class,omitempty"`
	Message string `json:"message,omitempty"`
	Digest  string `json:"digest,omitempty"`
}

type RunEvent struct {
	Seq     int64          `json:"seq,omitempty"`
	TS      string         `json:"ts"`
	RunID   string         `json:"runId"`
	NodeID  string         `json:"nodeId,omitempty"`
	Type    string         `json:"type"`
	Attempt int            `json:"attempt"`
	Message string         `json:"message,omitempty"`
	Fields  map[string]any `json:"fields,omitempty"`
	Error   *RunError      `json:"error,omitempty"`

	PrevDigest string `json:"prevDigest,omitempty"`
	Digest     string `json:"digest,omitempty"`
	CRC32      string `json:"crc32,omitempty"`
}

type RunEventObserver interface {
	ObserveRunEvent(RunEvent)
}

type RunEventObserverFunc func(RunEvent)

type RunEventType string

type RunIndexEntry struct {
	RunID      string    `json:"runId"`
	RunRoot    string    `json:"runRoot"`
	StackName  string    `json:"stackName,omitempty"`
	Profile    string    `json:"profile,omitempty"`
	Status     string    `json:"status,omitempty"`
	StartedAt  string    `json:"startedAt,omitempty"`
	UpdatedAt  string    `json:"updatedAt,omitempty"`
	Totals     RunTotals `json:"totals,omitempty"`
	HasSummary bool      `json:"hasSummary"`
}

type RunIntegrity struct {
	EventsOK         bool   `json:"eventsOk"`
	EventsError      string `json:"eventsError,omitempty"`
	LastEventDigest  string `json:"lastEventDigest,omitempty"`
	StoredLastDigest string `json:"storedLastDigest,omitempty"`

	RunDigestOK       bool   `json:"runDigestOk"`
	RunDigestExpected string `json:"runDigestExpected,omitempty"`
	RunDigestStored   string `json:"runDigestStored,omitempty"`
	RunDigestError    string `json:"runDigestError,omitempty"`
}

type RunNodeSummary struct {
	Status  string `json:"status"`
	Attempt int    `json:"attempt,omitempty"`
	Error   string `json:"error,omitempty"`
}

type RunOptions struct {
	Command     string
	Plan        *Plan
	Concurrency int
	FailFast    bool
	AutoApprove bool
	DryRun      bool
	Diff        bool
	CacheApply  bool
	Executor    NodeExecutor
	Secrets     *deploy.SecretOptions

	HelmLogs bool

	KubeQPS   float32
	KubeBurst int

	MaxConcurrencyPerNamespace int
	MaxConcurrencyByKind       map[string]int
	ParallelismGroupLimit      int
	Adaptive                   *AdaptiveConcurrencyOptions

	ResumeStatusByID  map[string]string
	ResumeFromRunID   string
	ResumeAttemptByID map[string]int
	ResumeStepsByID   map[string]map[int]map[string]NodeStepCheckpoint

	ProgressiveConcurrency bool
	Lock                   bool
	LockOwner              string
	LockTTL                time.Duration
	TakeoverLock           bool

	Kubeconfig      *string
	KubeContext     *string
	LogLevel        *string
	RemoteAgentAddr *string

	RunID string

	Selector        RunSelector
	FailMode        string
	MaxAttempts     int
	InitialAttempts map[string]int

	EventObservers []RunEventObserver
}

type RunPlan struct {
	APIVersion  string             `json:"apiVersion"`
	RunID       string             `json:"runId"`
	PlanHash    string             `json:"planHash,omitempty"`
	StackRoot   string             `json:"stackRoot"`
	StackName   string             `json:"stackName"`
	Command     string             `json:"command"`
	Profile     string             `json:"profile"`
	Concurrency int                `json:"concurrency"`
	FailMode    string             `json:"failMode"`
	Selector    RunSelector        `json:"selector,omitempty"`
	Nodes       []*ResolvedRelease `json:"nodes"`
	Runner      RunnerResolved     `json:"runner,omitempty"`

	StackGitCommit string `json:"stackGitCommit,omitempty"`
	StackGitDirty  bool   `json:"stackGitDirty,omitempty"`

	TorqueVersion   string `json:"torqueVersion,omitempty"`
	TorqueGitCommit string `json:"torqueGitCommit,omitempty"`
}

type RunSelector struct {
	Clusters             []string `json:"clusters,omitempty"`
	Tags                 []string `json:"tags,omitempty"`
	FromPaths            []string `json:"fromPaths,omitempty"`
	Releases             []string `json:"releases,omitempty"`
	GitRange             string   `json:"gitRange,omitempty"`
	GitIncludeDeps       bool     `json:"gitIncludeDeps,omitempty"`
	GitIncludeDependents bool     `json:"gitIncludeDependents,omitempty"`
	IncludeDeps          bool     `json:"includeDeps,omitempty"`
	IncludeDependents    bool     `json:"includeDependents,omitempty"`
	AllowMissingDeps     bool     `json:"allowMissingDeps,omitempty"`
}

type RunSummary struct {
	APIVersion string                    `json:"apiVersion"`
	RunID      string                    `json:"runId"`
	Status     string                    `json:"status"`
	StartedAt  string                    `json:"startedAt"`
	UpdatedAt  string                    `json:"updatedAt"`
	Totals     RunTotals                 `json:"totals"`
	Nodes      map[string]RunNodeSummary `json:"nodes"`
	Order      []string                  `json:"order,omitempty"`
}

type RunTotals struct {
	Planned   int `json:"planned"`
	Succeeded int `json:"succeeded"`
	Failed    int `json:"failed"`
	Blocked   int `json:"blocked"`
	Running   int `json:"running"`
}

type RunnerAdaptive struct {
	Mode               string   `yaml:"mode,omitempty" json:"mode,omitempty"`
	Min                *int     `yaml:"min,omitempty" json:"min,omitempty"`
	Window             *int     `yaml:"window,omitempty" json:"window,omitempty"`
	RampAfterSuccesses *int     `yaml:"rampAfterSuccesses,omitempty" json:"rampAfterSuccesses,omitempty"`
	RampMaxFailureRate *float64 `yaml:"rampMaxFailureRate,omitempty" json:"rampMaxFailureRate,omitempty"`
	CooldownSevere     *int     `yaml:"cooldownSevere,omitempty" json:"cooldownSevere,omitempty"`
}

type RunnerAdaptiveResolved struct {
	Mode               string  `json:"mode,omitempty"`
	Min                int     `json:"min,omitempty"`
	Window             int     `json:"window,omitempty"`
	RampAfterSuccesses int     `json:"rampAfterSuccesses,omitempty"`
	RampMaxFailureRate float64 `json:"rampMaxFailureRate,omitempty"`
	CooldownSevere     int     `json:"cooldownSevere,omitempty"`
}

type RunnerConfig struct {
	Concurrency            *int           `yaml:"concurrency,omitempty" json:"concurrency,omitempty"`
	ProgressiveConcurrency *bool          `yaml:"progressiveConcurrency,omitempty" json:"progressiveConcurrency,omitempty"`
	KubeQPS                *float32       `yaml:"kubeQPS,omitempty" json:"kubeQPS,omitempty"`
	KubeBurst              *int           `yaml:"kubeBurst,omitempty" json:"kubeBurst,omitempty"`
	Limits                 RunnerLimits   `yaml:"limits,omitempty" json:"limits,omitempty"`
	Adaptive               RunnerAdaptive `yaml:"adaptive,omitempty" json:"adaptive,omitempty"`
	Extra                  map[string]any `yaml:",inline" json:"-"`
	RawIgnored             map[string]any `yaml:"-" json:"-"`
}

type RunnerLimits struct {
	MaxParallelPerNamespace *int           `yaml:"maxParallelPerNamespace,omitempty" json:"maxParallelPerNamespace,omitempty"`
	MaxParallelKind         map[string]int `yaml:"maxParallelKind,omitempty" json:"maxParallelKind,omitempty"`
	ParallelismGroupLimit   *int           `yaml:"parallelismGroupLimit,omitempty" json:"parallelismGroupLimit,omitempty"`
}

type RunnerLimitsResolved struct {
	MaxParallelPerNamespace int            `json:"maxParallelPerNamespace,omitempty"`
	MaxParallelKind         map[string]int `json:"maxParallelKind,omitempty"`
	ParallelismGroupLimit   int            `json:"parallelismGroupLimit,omitempty"`
}

type RunnerResolved struct {
	Concurrency            int                    `json:"concurrency"`
	ProgressiveConcurrency bool                   `json:"progressiveConcurrency"`
	KubeQPS                float32                `json:"kubeQPS,omitempty"`
	KubeBurst              int                    `json:"kubeBurst,omitempty"`
	Limits                 RunnerLimitsResolved   `json:"limits,omitempty"`
	Adaptive               RunnerAdaptiveResolved `json:"adaptive,omitempty"`
}

type ScriptHookConfig struct {
	Command []string          `yaml:"command,omitempty" json:"command,omitempty"`
	Env     map[string]string `yaml:"env,omitempty" json:"env,omitempty"`
	WorkDir string            `yaml:"workDir,omitempty" json:"workDir,omitempty"`
}

type SealedPlanError struct {
	Kind   SealedPlanErrorKind
	NodeID string
	Want   string
	Got    string
}

type SealedPlanErrorKind string

type SelectResult struct {
	Plan     *Plan
	Selected []*ResolvedRelease
}

type Selector struct {
	Tags      []string
	FromPaths []string
	Releases  []string
	GitRange  string

	GitIncludeDeps       bool
	GitIncludeDependents bool

	IncludeDeps       bool
	IncludeDependents bool

	// AllowMissingDeps relaxes validation and treats missing needs as "skipped":
	// the selected plan is pruned so nodes only depend on other selected nodes.
	AllowMissingDeps bool
}

type StackApplyCLIConfig struct {
	DryRun *bool `yaml:"dryRun,omitempty" json:"dryRun,omitempty"`
	Diff   *bool `yaml:"diff,omitempty" json:"diff,omitempty"`

	FailFast *bool              `yaml:"failFast,omitempty" json:"failFast,omitempty"`
	Retry    *int               `yaml:"retry,omitempty" json:"retry,omitempty"`
	Lock     StackLockCLIConfig `yaml:"lock,omitempty" json:"lock,omitempty"`
}

type StackCLIConfig struct {
	// Selector sets default release selection constraints.
	Selector StackSelectorConfig `yaml:"selector,omitempty" json:"selector,omitempty"`

	// InferDeps controls whether selection includes inferred edges via manifest rendering.
	InferDeps       *bool `yaml:"inferDeps,omitempty" json:"inferDeps,omitempty"`
	InferConfigRefs *bool `yaml:"inferConfigRefs,omitempty" json:"inferConfigRefs,omitempty"`

	// Output sets default output format for commands that support it (e.g. plan/runs).
	Output string `yaml:"output,omitempty" json:"output,omitempty"`

	// Apply/Delete are CLI defaults specific to the run commands.
	Apply  StackApplyCLIConfig  `yaml:"apply,omitempty" json:"apply,omitempty"`
	Delete StackDeleteCLIConfig `yaml:"delete,omitempty" json:"delete,omitempty"`
	Resume StackResumeCLIConfig `yaml:"resume,omitempty" json:"resume,omitempty"`
}

type StackCLIResolved struct {
	Clusters []string
	Selector Selector

	InferDeps       bool
	InferConfigRefs bool
	Output          string

	ApplyDryRun    *bool
	ApplyDiff      *bool
	ApplyFailFast  *bool
	ApplyRetry     *int
	ApplyLock      *bool
	ApplyTakeover  *bool
	ApplyLockTTL   *time.Duration
	ApplyLockOwner *string

	DeleteConfirmThreshold *int
	DeleteFailFast         *bool
	DeleteRetry            *int
	DeleteLock             *bool
	DeleteTakeover         *bool
	DeleteLockTTL          *time.Duration
	DeleteLockOwner        *string

	ResumeAllowDrift  *bool
	ResumeRerunFailed *bool
}

type StackDeleteCLIConfig struct {
	ConfirmThreshold *int `yaml:"confirmThreshold,omitempty" json:"confirmThreshold,omitempty"`

	FailFast *bool              `yaml:"failFast,omitempty" json:"failFast,omitempty"`
	Retry    *int               `yaml:"retry,omitempty" json:"retry,omitempty"`
	Lock     StackLockCLIConfig `yaml:"lock,omitempty" json:"lock,omitempty"`
}

type StackDiffSummary struct {
	APIVersion string                     `json:"apiVersion"`
	CreatedAt  string                     `json:"createdAt,omitempty"`
	PlanHash   string                     `json:"planHash"`
	Nodes      map[string]NodeDiffSummary `json:"nodes"`
}

type StackFile struct {
	APIVersionKind `yaml:",inline" json:",inline"`

	Name           string                  `yaml:"name,omitempty" json:"name,omitempty"`
	DefaultProfile string                  `yaml:"defaultProfile,omitempty" json:"defaultProfile,omitempty"`
	Profiles       map[string]StackProfile `yaml:"profiles,omitempty" json:"profiles,omitempty"`

	Defaults ReleaseDefaults  `yaml:"defaults,omitempty" json:"defaults,omitempty"`
	Runner   RunnerConfig     `yaml:"runner,omitempty" json:"runner,omitempty"`
	CLI      StackCLIConfig   `yaml:"cli,omitempty" json:"cli,omitempty"`
	Hooks    StackHooksConfig `yaml:"hooks,omitempty" json:"hooks,omitempty"`
	Releases []ReleaseSpec    `yaml:"releases,omitempty" json:"releases,omitempty"`
}

type StackHooksConfig struct {
	PreApply   []HookSpec `yaml:"preApply,omitempty" json:"preApply,omitempty"`
	PostApply  []HookSpec `yaml:"postApply,omitempty" json:"postApply,omitempty"`
	PreDelete  []HookSpec `yaml:"preDelete,omitempty" json:"preDelete,omitempty"`
	PostDelete []HookSpec `yaml:"postDelete,omitempty" json:"postDelete,omitempty"`
}

type StackLock struct {
	Owner     string
	RunID     string
	CreatedAt time.Time
	TTL       time.Duration
}

type StackLockCLIConfig struct {
	Enabled  *bool          `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	Takeover *bool          `yaml:"takeover,omitempty" json:"takeover,omitempty"`
	TTL      *time.Duration `yaml:"ttl,omitempty" json:"ttl,omitempty"`
	Owner    *string        `yaml:"owner,omitempty" json:"owner,omitempty"`
}

type StackPlanBundleManifest struct {
	APIVersion         string `json:"apiVersion"`
	Kind               string `json:"kind"`
	CreatedAt          string `json:"createdAt,omitempty"`
	PlanHash           string `json:"planHash"`
	InputsBundleSha256 string `json:"inputsBundleSha256,omitempty"`
	StackName          string `json:"stackName,omitempty"`
	Profile            string `json:"profile,omitempty"`
}

type StackProfile struct {
	Defaults ReleaseDefaults  `yaml:"defaults,omitempty" json:"defaults,omitempty"`
	Runner   RunnerConfig     `yaml:"runner,omitempty" json:"runner,omitempty"`
	CLI      StackCLIConfig   `yaml:"cli,omitempty" json:"cli,omitempty"`
	Hooks    StackHooksConfig `yaml:"hooks,omitempty" json:"hooks,omitempty"`
}

type StackResumeCLIConfig struct {
	AllowDrift  *bool `yaml:"allowDrift,omitempty" json:"allowDrift,omitempty"`
	RerunFailed *bool `yaml:"rerunFailed,omitempty" json:"rerunFailed,omitempty"`
}

type StackSelectorConfig struct {
	Clusters  []string `yaml:"clusters,omitempty" json:"clusters,omitempty"`
	Tags      []string `yaml:"tags,omitempty" json:"tags,omitempty"`
	FromPaths []string `yaml:"fromPaths,omitempty" json:"fromPaths,omitempty"`
	Releases  []string `yaml:"releases,omitempty" json:"releases,omitempty"`
	GitRange  string   `yaml:"gitRange,omitempty" json:"gitRange,omitempty"`

	GitIncludeDeps       *bool `yaml:"gitIncludeDeps,omitempty" json:"gitIncludeDeps,omitempty"`
	GitIncludeDependents *bool `yaml:"gitIncludeDependents,omitempty" json:"gitIncludeDependents,omitempty"`

	IncludeDeps       *bool `yaml:"includeDeps,omitempty" json:"includeDeps,omitempty"`
	IncludeDependents *bool `yaml:"includeDependents,omitempty" json:"includeDependents,omitempty"`

	AllowMissingDeps *bool `yaml:"allowMissingDeps,omitempty" json:"allowMissingDeps,omitempty"`
}

type StatusOptions struct {
	RootDir string
	RunID   string
	Follow  bool
	Limit   int
	Format  string // raw|table|json|tty

	HelmLogs string
}

type Universe struct {
	RootDir        string
	StackName      string
	DefaultProfile string

	Stacks   map[string]StackFile
	Releases []discoveredRelease
}

type VerifyCacheEntry struct {
	LastOKAtNS       int64
	LastCheckedAtNS  int64
	LastResult       string
	LastMessage      string
	LastEventRVJSON  string
	LastEvidenceJSON string
	UpdatedAtNS      int64
}

type VerifyCacheKey struct {
	ClusterKey  string
	Namespace   string
	ReleaseName string
}

type VerifyConditionRequirement struct {
	Group         string `yaml:"group,omitempty" json:"group,omitempty"`   // e.g. example.com
	Kind          string `yaml:"kind,omitempty" json:"kind,omitempty"`     // e.g. Widget
	ConditionType string `yaml:"type,omitempty" json:"type,omitempty"`     // e.g. Ready
	RequireStatus string `yaml:"status,omitempty" json:"status,omitempty"` // True|False|Unknown
	AllowMissing  bool   `yaml:"allowMissing,omitempty" json:"allowMissing,omitempty"`
}

type VerifyOptions struct {
	// Enabled toggles post-apply verification for this release.
	Enabled *bool `yaml:"enabled,omitempty" json:"enabled,omitempty"`
	// FailOnWarnings fails the release when matching Warning events are observed.
	FailOnWarnings *bool `yaml:"failOnWarnings,omitempty" json:"failOnWarnings,omitempty"`
	// WarnOnly records verify findings but never fails the release.
	WarnOnly *bool `yaml:"warnOnly,omitempty" json:"warnOnly,omitempty"`
	// EventsWindow limits how far back to consider Warning events (prevents old noisy events
	// from failing new runs). Defaults to 15m when enabled.
	EventsWindow *time.Duration `yaml:"eventsWindow,omitempty" json:"eventsWindow,omitempty"`
	// Timeout bounds how long verify may run for this release. Defaults to 2m when enabled.
	Timeout *time.Duration `yaml:"timeout,omitempty" json:"timeout,omitempty"`

	// DenyReasons fails when a Warning event reason matches any entry (case-insensitive).
	// When empty, all Warning reasons are considered.
	DenyReasons []string `yaml:"denyReasons,omitempty" json:"denyReasons,omitempty"`
	// AllowReasons allows only these Warning event reasons when non-empty (case-insensitive).
	AllowReasons []string `yaml:"allowReasons,omitempty" json:"allowReasons,omitempty"`

	// RequireConditions enforces status.conditions on matching custom resources (CRs).
	RequireConditions []VerifyConditionRequirement `yaml:"requireConditions,omitempty" json:"requireConditions,omitempty"`
}