runtime

type ActionResult struct {
	Name     string
	Success  bool
	Duration time.Duration
	Message  string
	Stderr   string // raw stderr for failure visibility — renderer tails this
}

type Capability string

type InvokerType string

type LifecycleBackend interface {
	Name() string
	Capabilities() []Capability

	// Validate checks backend prerequisites (CLI availability, config completeness).
	Validate(ctx context.Context, cfg *config.Config, rctx *RuntimeContext) error

	// Prepare sets up the execution environment (kubeconfig, docker context, etc.).
	// Must register cleanup via rctx.Resolved.AddCleanup().
	Prepare(ctx context.Context, cfg *config.Config, rctx *RuntimeContext) error

	// Plan computes what will be done. Must be deterministic:
	// identical config + runtime inputs → identical output.
	Plan(ctx context.Context, cfg *config.Config, rctx *RuntimeContext) (*LifecyclePlan, error)

	// Execute dispatches planned actions. Must be idempotent for reconciliation backends:
	// repeated execution must converge to the same state without side effects.
	Execute(ctx context.Context, plan *LifecyclePlan, rctx *RuntimeContext) (*LifecycleResult, error)

	// Cleanup removes backend-specific ephemeral state.
	Cleanup(rctx *RuntimeContext)
}

type LifecyclePlan struct {
	Mode    string
	Backend string
	Actions []PlannedAction
	// Declined are units the backend deliberately did NOT act on (e.g. Flux
	// kustomizations that failed audition validation under skip-invalid policy).
	// They are reported, not executed — Execute never touches them.
	Declined []PlannedAction
	DryRun   bool
	// Notes are backend-recorded run facts for the renderer (e.g. the resolved
	// auth method) — DATA, not output; presentation belongs to the cmd layer.
	Notes map[string]string
}

type LifecycleResult struct {
	Actions []ActionResult
}

type PlannedAction struct {
	Name        string // e.g. "reconcile flux-system/infrastructure" or "anchorage/grafana"
	Description string // human-readable reason (e.g. "IaC files changed since last deployment")
	Order       int
	Action      string            // intended action: "reconcile", "up", "noop", "error"
	Metadata    map[string]string // backend-specific detail (host, hash, drift tier, etc.)
}

type ResolvedState struct {
	KubeconfigPath string // isolated tmpfile (gitops)
	CAPath         string // decoded CA tmpfile if from B64
	KubectlPath    string // resolved kubectl binary (cluster-identity queries)

	Backend LifecycleBackend // selected backend instance
	// contains filtered or unexported fields
}

type RuntimeContext struct {
	CI       *ci.CIContext // existing CI/local detection
	Invoker  InvokerType   // ci | local | api
	RepoRoot string        // workspace root

	// DryRun controls whether Execute phase is skipped.
	DryRun bool

	// Resolved state — populated during Prepare phase, cleaned up after.
	Resolved ResolvedState
	// contains filtered or unexported fields
}

type RuntimeError struct {
	Phase   string
	Backend string
	Message string
	Cause   error
}