lifecycle

type Event string

type ExecutionOptions struct {
	Executable     string
	Directory      string
	GlobalArgs     []string
	Environment    []string
	Streams        process.Streams
	Runner         process.Runner
	Concurrency    int
	KeepGoing      bool
	Grouped        bool
	ResourceGuards map[string]func(*dependency.Node) func()
	// NodeEnvironment optionally returns KEY=VALUE entries applied on top of the
	// child environment for one node. It runs on scheduler workers, so it must be
	// safe for concurrent use.
	NodeEnvironment func(node *dependency.Node) []string
	// OnStart and OnComplete report live progress separately from child logs.
	// Calls are serialized. Start occurs only after acquiring the resource guard.
	OnStart    func(*dependency.Node)
	OnComplete func(*dependency.Node, error)
}

type Filter struct {
	Tags   []string
	Labels map[string]string
}

type Handler struct {
	Path  []string
	Args  []schema.CommandArgument
	Flags []schema.CommandFlag
	Err   error
	// HookEvents are the actual per-component hook events fired by this command.
	HookEvents []string
	// ApprovalArgs opt into the component's own non-interactive approval behavior.
	ApprovalArgs []string
	// NewResourceGuard creates one shared lock domain for this invocation.
	NewResourceGuard func(*schema.AtmosConfiguration) func(*dependency.Node) func()
	// WorkerEnvironment supplies execution policy owned by this component type.
	WorkerEnvironment func(int) []string
}

type Notice struct {
	Kind, Stack, Component, Reason string
}

type Plan struct {
	Graph    *dependency.Graph
	Commands map[string][]string
	Notices  []Notice
	Handlers map[string]*Handler
	// Deleted counts notices for selected definitions removed from configuration.
	Deleted int
}

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

type Selection struct {
	// Operation determines preflight and deletion notices; empty preserves deploy semantics.
	Operation Event
	Stack     string
	// Components selects exact names across kinds before expansion; empty selects every name.
	Components []string
	// A nil Affected selects all nodes; a non-nil empty slice selects none.
	Affected []schema.Affected
	// Zero disables expansion, -1 expands without a depth limit.
	Dependencies int
	Dependents   int
	Reverse      bool
	// Filter narrows the initial selection by component tags and labels.
	Filter *Filter
}