run

type ActionOptions struct {
	BinaryName string

	// Names is the list of action names to execute (positional args).
	// Only the specified actions and their transitive dependsOn dependencies
	// are executed. Finally actions always run.
	Names []string

	// Action execution options
	ActionTimeout        time.Duration
	MaxActionConcurrency int
	DryRun               bool
	Verbose              bool
	ShowExecution        bool

	// File conflict strategy
	OnConflict string
	Force      bool
	Backup     bool

	// SkipFingerprint disables fingerprint-based up-to-date checks.
	SkipFingerprint bool

	// DynamicArgs are resolver parameters from positional key=value syntax.
	DynamicArgs []string
	// contains filtered or unexported fields
}

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

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

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

type ProviderOptions struct {
	BinaryName string
	IOStreams  *terminal.IOStreams
	CliParams  *settings.Run

	// kvx output integration
	cmdflags.KvxOutputFlags

	// ProviderName is the name of the provider to execute (positional arg).
	ProviderName string

	// PluginVersion is the version to pin the plugin provider to.
	// Set via --plugin-version flag or name@version positional syntax.
	PluginVersion string

	// InputParams are the provider input parameters (--input key=value or --input @file.yaml).
	InputParams []string

	// DynamicArgs are provider inputs from positional or dynamic-flag syntax
	// (e.g. key=value or --key=value, captured after the provider name).
	DynamicArgs []string

	// Capability specifies which capability to execute.
	// Defaults to the first capability declared by the provider.
	Capability string

	// DryRun shows what would be executed without running the provider.
	DryRun bool

	// PluginDirs are directories to scan for plugin providers.
	PluginDirs []string

	// ShowMetrics shows provider execution metrics after completion.
	ShowMetrics bool

	// Redact redacts sensitive fields in the output.
	Redact bool

	// OutputDir is the target directory for action file operations.
	// When set and capability is action, providers resolve relative paths
	// against this directory instead of CWD.
	OutputDir string

	// OnConflict is the default conflict strategy for file writes.
	OnConflict string

	// Backup enables .bak backup creation before mutating existing files.
	Backup bool
}

type ResolverExecutionConfig = execute.ResolverExecutionConfig

type ResolverExecutionResult = execute.ResolverExecutionResult

type ResolverOptions struct {
	BinaryName string

	// Names is the list of resolver names to execute (positional args).
	// If empty, all resolvers are executed.
	Names []string

	// Actions scopes resolver output to one or more actions by name.
	// When set, resolver names are extracted from each action's inputs
	// and the resolver execution is filtered to only those resolvers
	// (plus their transitive dependencies). Multiple values are unioned.
	Actions []string

	// SkipTransform skips the transform and validation phases,
	// returning raw resolved values.
	SkipTransform bool

	// Graph renders the resolver dependency graph instead of executing.
	Graph bool

	// GraphFormat controls the graph rendering format (ascii, dot, mermaid, json).
	GraphFormat string

	// Snapshot saves an execution snapshot to a file instead of normal output.
	Snapshot bool

	// SnapshotFile is the path to write the snapshot file.
	SnapshotFile string

	// Redact redacts sensitive values in the snapshot.
	Redact bool

	// ShowExecution includes the __execution metadata in output.
	ShowExecution bool

	// FailOnValidation makes the command exit with a non-zero status when any
	// resolver fails validation. By default, validation failures are reported as
	// non-fatal diagnostics (values are still shown) and the command exits 0.
	FailOnValidation bool

	// LintAfterValidate, when true, runs lint on the solution after resolver
	// validation passes. It is set by 'validate resolver' so that command acts
	// as a full gate (resolver validation + lint). 'run resolver' leaves it
	// false.
	LintAfterValidate bool

	// DynamicArgs are resolver parameters from positional key=value syntax
	// (e.g. env=prod region=us-east-1, captured from positional args containing '=').
	DynamicArgs []string
	// contains filtered or unexported fields
}

type SolutionOptions struct {
	BinaryName string

	// Action execution options
	ActionTimeout        time.Duration
	MaxActionConcurrency int
	DryRun               bool

	// Verbose enables additional detail in output. In dry-run mode, includes
	// materialized inputs. In normal execution, shows condition-based skips.
	Verbose bool

	// ShowExecution enables __execution metadata in output
	ShowExecution bool

	// OnConflict is the default conflict strategy for file writes.
	// When set, it is injected into the execution context so file providers
	// use it as their default instead of the built-in "error".
	OnConflict string

	// Force overrides --on-conflict to "skip-unchanged", allowing re-runs of
	// solutions that produce identical files without errors.
	Force bool

	// SkipFingerprint disables fingerprint-based up-to-date checks.
	// When true, all actions execute regardless of whether sources have changed.
	SkipFingerprint bool

	// Backup enables .bak backup creation before mutating existing files.
	Backup bool

	// ActionNames is the list of action names to execute selectively.
	// When set, only the specified actions and their transitive dependsOn
	// dependencies are executed. Finally actions always run.
	ActionNames []string
	// contains filtered or unexported fields
}

type SolutionValidationResult = execute.SolutionValidationResult