bluegreen

type DeployConfig struct {
	// ProjectRoot is the nSelf project root (contains docker-compose.yml).
	ProjectRoot string

	// CanaryPercent is the initial canary traffic percentage (1-99).
	// 0 means skip canary and go straight to full flip.
	CanaryPercent int

	// SoakMinutes is the canary soak period in minutes. Default: 5.
	SoakMinutes int

	// ErrorThresholdPct is the error rate percentage that triggers auto-rollback.
	// Default: 1.0.
	ErrorThresholdPct float64

	// HealthTimeoutSec is the number of seconds to wait for green health.
	// Default: 30.
	HealthTimeoutSec int

	// ForceMigration disables canary and performs a full downtime deploy.
	// Required when a migration is not backward-compatible.
	ForceMigration bool

	// SkipCanary skips the canary phase and flips to 100% immediately.
	SkipCanary bool

	// DryRun prints steps without executing them.
	DryRun bool

	// BluePortOffset is the port offset for blue containers. Default: 0.
	BluePortOffset int

	// GreenPortOffset is the port offset for green containers. Default: 100.
	GreenPortOffset int
}

type DeployResult struct {
	// Success is true when the deploy completed without error.
	Success bool

	// Steps is the ordered list of deploy steps with their status.
	Steps []DeployStep

	// Duration is how long the deploy took.
	Duration time.Duration

	// CanaryPercent is the final canary percentage (100 if fully promoted).
	CanaryPercent int

	// RolledBack is true when an auto-rollback was triggered during the soak.
	RolledBack bool

	// Error is set on failure.
	Error string
}

type DeployState struct {
	// Active is the currently live environment ("blue" or "green").
	Active string `json:"active"`

	// BlueVersion is the image tag running in blue.
	BlueVersion string `json:"blue_version,omitempty"`

	// GreenVersion is the image tag running in green.
	GreenVersion string `json:"green_version,omitempty"`

	// CanaryPercent is the current canary traffic split (0 = not in canary).
	CanaryPercent int `json:"canary_percent"`

	// LastDeploy is the timestamp of the last successful deploy.
	LastDeploy time.Time `json:"last_deploy"`

	// LastRollback is the timestamp of the last rollback, if any.
	LastRollback *time.Time `json:"last_rollback,omitempty"`
}

type DeployStep struct {
	Name   string `json:"name"`
	Status string `json:"status"` // pending, running, done, failed, skipped
}

type MigrationCheckResult struct {
	// Compatible is true when all pending migrations are safe to run during canary.
	Compatible bool

	// IncompatibleFiles lists migration files that are NOT backward-compatible.
	IncompatibleFiles []string

	// Reason explains the incompatibility in human-readable terms.
	Reason string
}

type RollbackResult struct {
	// Success is true when the rollback completed without error.
	Success bool

	// Duration is how long the rollback took.
	Duration time.Duration

	// Error is set on failure.
	Error string
}