action

type Action interface {
	ID() string
	Name() string
	Description() string
	Group() ActionGroup

	// CanApply returns whether this action should run for the given target context.
	// Actions can use target.CurrentVersion, target.TargetVersion, or target.Client for filtering.
	CanApply(target Target) bool

	// Prepare returns the Task for the preparation phase (e.g., backups, pre-migration setup).
	// Returns nil if this action has no prepare phase.
	Prepare() Task

	// Run returns the Task for the migration execution phase.
	Run() Task
}

type ActionExecution struct {
	Action Action
	Result *result.ActionResult
	Error  error
}

type ActionGroup string

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

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

type RootRecorder interface {
	StepRecorder
	// Build constructs the final ActionResult with all recorded steps.
	Build() *result.ActionResult
}

type StepRecorder interface {
	// Child creates a derived recorder for a sub-step.
	// The child automatically nests under this recorder's step.
	Child(name string, description string) StepRecorder

	// Complete marks this step as complete with status and message.
	// Supports printf-style formatting with variadic arguments.
	Complete(status result.StepStatus, messageFormat string, args ...any)

	// AddDetail adds structured data to this step (for JSON/YAML output).
	AddDetail(key string, value any)

	// Record adds a simple completed sub-step (convenience method for quick recordings).
	// Supports printf-style formatting with variadic arguments.
	Record(name string, messageFormat string, status result.StepStatus, args ...any)
}

type Target struct {
	Client         client.Client
	CurrentVersion *semver.Version // Version being migrated FROM
	TargetVersion  *semver.Version // Version being migrated TO
	DryRun         bool
	SkipConfirm    bool
	OutputDir      string // Output directory for backups (used in prepare phase)
	Recorder       StepRecorder
	IO             iostreams.Interface
}

type Task interface {
	Validate(ctx context.Context, target Target) (*result.ActionResult, error)
	Execute(ctx context.Context, target Target) (*result.ActionResult, error)
}