composeadapter

type Adapter interface {
	// Version returns the installed `docker compose` version.
	Version(ctx context.Context) (VersionInfo, error)

	// Validate runs `docker compose config --quiet` to confirm the file is valid.
	Validate(ctx context.Context) error

	// RenderConfigJSON returns the fully-resolved project configuration.
	// This is the source of truth for services and image references.
	RenderConfigJSON(ctx context.Context) (*RenderedConfig, error)

	// PsJSON returns the current container states for the project.
	PsJSON(ctx context.Context) ([]ContainerStatus, error)

	// Pull runs `docker compose pull <services>`, streaming progress to the
	// supplied writer. Empty services means "every service in the project".
	// See ADR 0010.
	Pull(ctx context.Context, services []string, progress io.Writer) error

	// Up runs `docker compose up -d` with the configured options, streaming
	// progress output to progress.
	Up(ctx context.Context, opts UpOptions, progress io.Writer) error
}

type ContainerStatus struct {
	Name     string `json:"Name"`
	Service  string `json:"Service"`
	State    string `json:"State"`
	Health   string `json:"Health"`
	Status   string `json:"Status"`
	ExitCode int    `json:"ExitCode"`
}

type Exec interface {
	Output(ctx context.Context, name string, args ...string) ([]byte, []byte, error)
	RunWithStream(ctx context.Context, progress io.Writer, name string, args ...string) error
}

type RenderedConfig struct {
	Name     string                     `json:"name"`
	Services map[string]RenderedService `json:"services"`
}

type RenderedService struct {
	Image string `json:"image"`
}

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

type ShellOptions struct {
	ComposeFiles []string
	ProjectName  string
	Logger       *slog.Logger
	Exec         Exec
}

type UpOptions struct {
	Services      []string
	RemoveOrphans bool
	Wait          bool
	Timeout       time.Duration
	// ForceRecreate passes `--force-recreate` to compose up. Intended as a
	// per-deploy debug escape hatch for the fresh-build-same-tag case where
	// Compose's digest-diff misfires. See ADR 0011.
	ForceRecreate bool
	// ExtraFiles are appended after the adapter's base compose files for this
	// single call. Used by the rollback flow to inject a pinned-image override
	// without rebuilding the adapter.
	ExtraFiles []string
}

type VersionInfo struct {
	Raw             string
	Parsed          doctor.ComposeVersion
	SupportsWait    bool
	SupportsJSONOut bool
	IsHyphenated    bool
}