installer

type FactDefinition struct {
	// FilePath is the filename (e.g., "location.yaml")
	FilePath string

	// FactName is the top-level key in the YAML file (e.g., "location")
	FactName string

	// Fields maps CSV column names to fact field names
	// Example: {"account": "account", "environment": "environment"}
	Fields map[string]string
}

type InstallOptions struct {
	// DryRun simulates installation without executing real commands
	DryRun bool

	// SkipValidation skips prerequisite validations (use with caution!)
	SkipValidation bool

	// SkipTagging doesn't apply tags after installation (useful for testing)
	SkipTagging bool

	// MaxConcurrency defines maximum number of simultaneous installations
	MaxConcurrency int

	// Timeout global timeout per installation
	Timeout time.Duration

	// CustomOptions package-specific options
	// E.g., for Puppet: {"server": "puppet.example.com", "environment": "production"}
	CustomOptions map[string]string
}

type InstallResult struct {
	Instance  *cloud.Instance // Instance where it was installed
	Success   bool            // true if installation was successful
	Error     error           // Error if it failed
	Duration  time.Duration   // Time it took
	Output    string          // Output of executed commands
	StartTime time.Time       // When it started
	EndTime   time.Time       // When it finished
	Tagged    bool            // true if tags were applied successfully
}

type PackageInstaller interface {
	// Name returns the package name (puppet, docker, kubernetes-agent, etc)
	Name() string

	// GenerateInstallScript generates installation script based on the operating system.
	// os: detected operating system (ubuntu, debian, rhel, amzn)
	// options: custom options (version, specific configurations)
	// Returns: slice of shell commands to execute
	GenerateInstallScript(os string, options map[string]string) ([]string, error)

	// ValidatePrerequisites validates prerequisites BEFORE installing.
	// E.g., Puppet needs to validate connectivity with Puppet Server
	// E.g., Docker can validate if there are sufficient resources
	// Returns error if any prerequisite is not met.
	ValidatePrerequisites(ctx context.Context, instance *cloud.Instance, provider cloud.CloudProvider) error

	// VerifyInstallation verifies if installation was successful.
	// E.g., execute 'puppet --version' and verify exit code
	// E.g., execute 'docker ps' and verify it works
	// Returns error if verification fails.
	VerifyInstallation(ctx context.Context, instance *cloud.Instance, provider cloud.CloudProvider) error

	// GetSuccessTags returns tags that should be applied after successful installation.
	// E.g., puppet=true, puppet_server=puppet.example.com, puppet_installed_at=2025-01-15
	// This marks the instance and enables idempotency (don't reinstall).
	GetSuccessTags() map[string]string

	// GetFailureTags returns tags to apply when installation fails (optional).
	// E.g., puppet=failed, puppet_error=connection_timeout
	// Useful for troubleshooting and later retry.
	GetFailureTags(err error) map[string]string

	// GetInstallMetadata returns metadata from the last installation attempt.
	// E.g., os=rhel, certname=abc123.puppet, certname_preserved=true
	// Used for reporting and auditing purposes.
	// Returns empty map if no installation attempt was made yet.
	GetInstallMetadata() map[string]string
}

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

type PuppetOptions struct {
	Server      string                    // Puppet Server hostname (required)
	Port        int                       // Puppet Server port (default: 8140)
	Version     string                    // Puppet version (default: "7")
	Environment string                    // Puppet environment (default: "production")
	CustomFacts map[string]FactDefinition // Custom facts to create on instances (optional)
}