release

type AggregateGateChecker interface {
	GateChecker
	CanIDeployMany(ctx context.Context, env string, selectors []broker.CanIDeploySelector) (*broker.CanIDeploySetResult, error)
}

type BrokerClient = GateChecker

type ComposeDeployer interface {
	Pull(ctx context.Context, services []string, progress io.Writer) error
	Up(ctx context.Context, opts composeadapter.UpOptions, progress io.Writer) error
	PsJSON(ctx context.Context) ([]composeadapter.ContainerStatus, error)
	RenderConfigJSON(ctx context.Context) (*composeadapter.RenderedConfig, error)
}

type DeployBroker interface {
	AggregateGateChecker
	RecordDeployment(ctx context.Context, in broker.RecordDeploymentInput) error
	HasRelation(rel string) bool
	APICallCount() int
}

type DeployDeps struct {
	Broker      DeployBroker
	Compose     ComposeDeployer
	Strategy    versioning.Strategy
	Logger      *slog.Logger
	UI          UI
	Progress    io.Writer
	Stderr      io.Writer
	SnapshotDir string
	// RollbackMode controls auto-rollback on compose-up / smoke failures.
	// Zero value defaults to RollbackOn (opt-out). See ADR-0006.
	RollbackMode RollbackMode
	// RollbackTimeout bounds the rollback's own `compose up --wait`. Defaults
	// to 2× Deploy.WaitTimeout, or 3 minutes if neither is set.
	RollbackTimeout time.Duration
	// ForceRecreate passes `--force-recreate` through to compose up. Debug
	// escape hatch for the fresh-build-same-tag case. See ADR 0011.
	ForceRecreate bool
}

type DeployReport struct {
	Plan             *Plan
	Outcomes         []GateOutcome
	Pre              *Snapshot
	Post             *Snapshot
	PreSnapshotFile  string
	PostSnapshotFile string
	FailedAtStep     FailedStep
	FailedCause      error
	Rollback         *RollbackReport
	StartedAt        time.Time
	FinishedAt       time.Time
}

type FailedStep string

type GateChecker interface {
	CanIDeploy(ctx context.Context, in broker.CanIDeployInput) (*broker.CanIDeployResult, error)
}

type GateOutcome struct {
	Service     string
	Pacticipant string
	Release     versioning.Release
	Deployable  bool
	Reason      string
	BrokerURL   string
	VerifyURL   string
	Err         error
}

type Plan struct {
	Env      string
	Services []string                         // order matters (output stability)
	Releases map[string]versioning.Release    // service -> release
	Mapping  map[string]config.ServiceMapping // service -> pacticipant mapping

	// AllOrNothing mirrors the environment's all_or_nothing setting. When
	// true, GateAll routes the check through a single matrix query so the
	// broker evaluates the candidate set together. False keeps the
	// per-service fan-out.
	AllOrNothing bool
}

type RollbackDeps struct {
	Compose     ComposeDeployer
	Logger      *slog.Logger
	UI          UI
	Progress    io.Writer
	SnapshotDir string // root under which snapshots & rollback artefacts are written
	WaitTimeout time.Duration
}

type RollbackHint struct {
	Env             string
	FailedAt        FailedStep
	Cause           error
	PreSnapshot     *Snapshot
	PreSnapshotFile string
	PostSnapshot    *Snapshot
	Rollback        *RollbackReport
}

type RollbackMode string

type RollbackPlan struct {
	Env              string            `json:"env"`
	FromSnapshotFile string            `json:"from_snapshot_file,omitempty"`
	Images           map[string]string `json:"images"`   // service → previous image ref
	Services         []string          `json:"services"` // sorted; stable output
}

type RollbackReport struct {
	Mode             RollbackMode  `json:"mode"`
	Attempted        bool          `json:"attempted"`
	Succeeded        bool          `json:"succeeded"`
	Skipped          bool          `json:"skipped,omitempty"`
	SkipReason       string        `json:"skip_reason,omitempty"`
	Plan             *RollbackPlan `json:"plan,omitempty"`
	OverrideFile     string        `json:"override_file,omitempty"`
	PostSnapshotFile string        `json:"post_snapshot_file,omitempty"`
	StartedAt        time.Time     `json:"started_at"`
	FinishedAt       time.Time     `json:"finished_at"`
	Duration         time.Duration `json:"duration"`
	Err              string        `json:"error,omitempty"`
	ReportFile       string        `json:"report_file,omitempty"`
}

type ServiceDelta struct {
	Service string
	Before  versioning.Release
	After   versioning.Release
	Changed bool
}

type Snapshot struct {
	CapturedAt time.Time                        `json:"captured_at"`
	Env        string                           `json:"env"`
	Releases   map[string]versioning.Release    `json:"releases,omitempty"`
	Containers []composeadapter.ContainerStatus `json:"containers"`
	// Images maps service name → resolved image reference at capture time.
	// Populated from `docker compose config --format json`. May be empty if
	// the render call fails; callers treat empty Images as "rollback not
	// possible from this snapshot".
	Images map[string]string `json:"images,omitempty"`
}

type UI interface {
	Step(label, detail string)
	Ok(label, detail string)
	Fail(label, detail string)
	Warn(label, detail string)
}

type VerifyDeps struct {
	Broker   GateChecker
	Strategy versioning.Strategy
}

type VerifyReport struct {
	Plan     *Plan
	Outcomes []GateOutcome
}