commands

type CLIConfig struct {
	// CLIName is used in help text and log file naming (e.g. "celerity", "bluelink").
	CLIName string

	// EnvVarPrefix is prepended to environment variable names for config binding
	// (e.g. "CELERITY_CLI", "BLUELINK_CLI").
	EnvVarPrefix string

	// DefaultBlueprintFile is the default blueprint file name
	// (e.g. "app.blueprint.yaml", "project.blueprint.yaml").
	DefaultBlueprintFile string

	// DefaultDeployConfig is the default deploy configuration file name
	// (e.g. "celerity.deploy.json", "bluelink.deploy.json").
	DefaultDeployConfig string

	// DefaultConfigFile is the default CLI configuration file name
	// (e.g. "celerity.config.toml", "bluelink.config.toml").
	DefaultConfigFile string

	// Palette provides the color scheme for TUI styling.
	Palette styles.ColorPalette

	// PreflightFactory optionally creates a preflight check model
	// (e.g. plugin dependency verification). Nil to skip preflight checks.
	PreflightFactory PreflightFactory

	// PreCommandStep is called before stage/deploy commands interact with
	// the deploy engine. For example, Celerity uses this to trigger a build
	// step and inject build artifact context variables.
	// Nil to skip pre-command steps.
	PreCommandStep precommand.Step

	// EnableCodeOnlyApproval enables the --auto-approve-code-only flag on deploy.
	// When true, the flag is registered and the code-only approval logic is available.
	// This is intended for CLIs that use transformer plugins with resource category annotations.
	EnableCodeOnlyApproval bool
}

type PreflightFactory interface {
	// CreatePreflight creates a bubbletea model for preflight checks.
	// Returns nil if no preflight checks are needed.
	CreatePreflight(
		confProvider *config.Provider,
		commandName string,
		styles *styles.Styles,
		headless bool,
		writer io.Writer,
		jsonMode bool,
	) tea.Model
}