cmd

type Command interface {
	// Complete populates derived fields and performs pre-validation setup.
	// This is called after flags are parsed but before validation.
	// Example: parsing version strings, creating clients, etc.
	Complete() error

	// Validate checks that all required fields are valid.
	// This is called after Complete and before Run.
	// Example: checking required flags, validating patterns, etc.
	Validate() error

	// Run executes the command logic.
	// This is called after Complete and Validate have succeeded.
	Run(ctx context.Context) error

	// AddFlags registers command-specific flags with the provided FlagSet.
	// This enables testing flag registration independently of Cobra.
	AddFlags(fs *pflag.FlagSet)
}