update

type Activation struct {
	Status string `json:"status" enum:"queued,running,active,failed,unknown"`
	Detail string `json:"detail"`
}

type Adapter interface {
	Name() string
	// Activate asks the provider to make artifact active and returns a
	// durable reference. Acceptance is not activation.
	Activate(ctx context.Context, artifact Artifact) (string, error)
	// Status reports the state of a reference returned by Activate.
	Status(ctx context.Context, ref string) (Activation, error)
}

type Artifact struct {
	Version string `json:"version"`
	ID      string `json:"id" doc:"Immutable artifact identity, e.g. an image reference or archive name"`
	Digest  string `json:"digest" doc:"sha256:… from the release source; empty when the source publishes none"`
	Source  string `json:"source"`
	// Migrations and Themes are compatibility data the release source may
	// publish; nil means the source did not say.
	Migrations []string `json:"migrations,omitempty"`
	Themes     []string `json:"themes,omitempty"`
}

type Config struct {
	// RunningVersion is the serving process identity (the build string),
	// never a selected artifact or saved target.
	RunningVersion string
	Source         Source
	Adapter        Adapter
	// AllowDowngrade lets a lower target pass compatibility when the
	// operator accepts the recorded downgrade constraints.
	AllowDowngrade bool
	// RequireDigest fails verification when the source publishes no digest.
	RequireDigest bool
	// ActivationTimeout bounds waiting for a provider or operator to
	// activate the artifact (default 15 minutes). PollInterval is how often
	// the adapter status is read (default 10 seconds).
	ActivationTimeout time.Duration
	PollInterval      time.Duration
	// LeaseTTL and Heartbeat protect the operation across processes
	// (defaults 2 minutes and 30 seconds).
	LeaseTTL  time.Duration
	Heartbeat time.Duration
	// HealthLinks are absolute URLs that must answer 2xx after activation.
	HealthLinks []string

	// Evidence providers, supplied by the host (nil ones record
	// "unavailable" and fail the phase that needs them).
	Compatibility func(ctx context.Context, target string) (Report, error)
	Backup        func(ctx context.Context) (Report, error)
	Health        func(ctx context.Context) (Report, error)
	Link          func(ctx context.Context, url string) error
	// Schema lists the applied migrations ("module/name"); the difference
	// before and after activation decides whether the prior artifact is
	// still compatible with the current data.
	Schema func(ctx context.Context) ([]string, error)
}

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

type ErrConflict struct {
	OperationID string
	Holder      string
	Reason      string
}

type ErrLeaseHeld struct {
	Holder      string
	OperationID string
	ExpiresAt   string
}

type Holder struct {
	Holder, Owner, OperationID, ExpiresAt string
}

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

type ManualAdapter struct{}

type Operation struct {
	ID               string    `json:"id"`
	Status           string    `json:"status" enum:"pending,running,succeeded,failed,interrupted,rolled_back,rollback_failed"`
	CurrentPhase     string    `json:"current_phase"`
	RequestedVersion string    `json:"requested_version" doc:"Target asked for"`
	RunningVersion   string    `json:"running_version" doc:"Serving identity when the operation was requested"`
	ActivatedVersion *string   `json:"activated_version" doc:"Identity confirmed by the serving process after activation; null until then"`
	AcceptedVersion  *string   `json:"accepted_version" doc:"Target durably accepted after every required check passed; null otherwise"`
	ExpectedDigest   string    `json:"expected_digest"`
	Artifact         *Artifact `json:"artifact" doc:"Verified release identity; null before verification"`
	Previous         *Artifact `json:"previous" doc:"Prior artifact eligible for runtime rollback on current data; null when unknown"`
	BackupStamp      string    `json:"backup_stamp"`
	DeploymentRef    string    `json:"deployment_ref" doc:"Provider reference; accepted is not active"`
	RollbackRef      string    `json:"rollback_ref"`
	MigrationState   string    `` /* 135-byte string literal not displayed */
	Source           string    `json:"source"`
	Adapter          string    `json:"adapter"`
	RequestedBy      string    `json:"requested_by"`
	Error            string    `json:"error"`
	Remediation      string    `json:"remediation"`
	Retryable        bool      `json:"retryable"`
	HeartbeatAt      *string   `json:"heartbeat_at"`
	CreatedAt        string    `json:"created_at"`
	StartedAt        *string   `json:"started_at"`
	FinishedAt       *string   `json:"finished_at"`
	UpdatedAt        string    `json:"updated_at"`
	Phases           []Phase   `json:"phases"`
}

type Phase struct {
	Name        string          `json:"name"`
	Status      string          `json:"status" enum:"pending,running,passed,failed,skipped,interrupted"`
	StartedAt   *string         `json:"started_at"`
	FinishedAt  *string         `json:"finished_at"`
	DurationMS  *int64          `json:"duration_ms" doc:"Null until the phase finished"`
	Progress    *float64        `json:"progress" doc:"0..1 when measurable, else null"`
	Attempts    int             `json:"attempts"`
	Result      json.RawMessage `json:"result" doc:"Phase evidence; never credentials or hosts"`
	Error       string          `json:"error"`
	Remediation string          `json:"remediation"`
	Retryable   bool            `json:"retryable"`
}

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

type Report struct {
	OK          bool
	Reason      string
	Remediation string
	Retryable   bool
	Data        map[string]any
}

type Request struct {
	Version        string `json:"version" doc:"Release version to activate, e.g. 0.15.0"`
	ExpectedDigest string `json:"expected_digest,omitempty" doc:"Optional sha256:… the verified artifact must match"`
	RequestedBy    string `json:"-"`
}

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

type Source interface {
	Name() string
	Resolve(ctx context.Context, version string) (Artifact, error)
	Latest(ctx context.Context) (Artifact, error)
}

type TargetVerifier interface {
	CanActivate(ctx context.Context, artifact Artifact) error
}