engine

type BuildOptions struct {
	BuildArgs        []string // extra KEY=VALUE build args (override compose)
	NoCache          bool     // force --no-cache
	Pull             bool     // force --pull
	Quiet            bool     // -q/--quiet
	Memory           string   // -m/--memory
	WithDependencies bool     // also build the named services' dependencies
	Push             bool     // push each built image after building
}

type ContainerStatus struct {
	Name    string
	Service string
	Status  string
	Image   string
	Ports   string
}

type CreateOptions struct {
	Scale         map[string]int
	NoBuild       bool   // skip building images for services with a build section
	Pull          string // "always" pulls images before creating
	RemoveOrphans bool   // remove containers for services not in the compose file
	ForceRecreate bool   // recreate existing containers even if unchanged
	NoRecreate    bool   // leave existing containers in place even if changed
	QuietPull     bool   // suppress pull progress
}

type DownOptions struct {
	// RemoveVolumes also deletes the project's named volumes.
	RemoveVolumes bool
	// RemoveOrphans removes containers for services not in the compose file.
	RemoveOrphans bool
	// Timeout overrides each container's shutdown grace period (seconds).
	Timeout *int
	// RemoveImages removes service images: "all" (every image) or "local"
	// (only images with no custom name, i.e. locally built). Empty = keep.
	RemoveImages string
}

type Engine struct {
	Runner runner.Runner
	// Out receives human-readable progress messages.
	Out io.Writer
	// Now returns the current time; injectable for tests. Defaults to time.Now.
	Now func() time.Time
	// Sleep pauses for d or until ctx is cancelled; injectable for tests.
	Sleep func(ctx context.Context, d time.Duration) error
	// StateDir is where fruitbox writes generated per-container files
	// (e.g. /etc/hosts, /etc/hostname). Defaults to <tmp>/fruitbox.
	StateDir string
}

type Event struct {
	Name   string
	Action string // create, start, die, destroy
}

type ExecOptions struct {
	Interactive bool
	TTY         bool
	Detach      bool
	Index       int
	User        string
	WorkingDir  string
	Env         []string
}

type ExitError struct{ Code int }

type ImageInfo struct {
	Service string
	Image   string
}

type LogOptions struct {
	// Follow streams new output (--follow).
	Follow bool
	// Tail is the number of lines from the end ("all" or "" for everything).
	Tail string
	// Index selects a single replica (1-based); 0 means all replicas.
	Index int
	// NoPrefix omits the per-service line prefix (--no-log-prefix).
	NoPrefix bool
	// NoColor disables ANSI color in the prefix (--no-color).
	NoColor bool
	// Timestamps prepends an RFC3339 timestamp to each line (--timestamps).
	Timestamps bool
}

type ProjectSummary struct {
	Name           string
	ContainerCount int
	RunningCount   int
}

type PullOptions struct {
	Quiet           bool   // suppress progress logs
	IncludeDeps     bool   // also pull transitive dependencies of the named services
	IgnoreFailures  bool   // continue when an individual pull fails
	IgnoreBuildable bool   // skip services that have a build section
	Policy          string // pull policy: "never" skips; "always"/"missing"/"" pull
}

type PushOptions struct {
	Quiet          bool // suppress progress logs
	IncludeDeps    bool // also push dependencies of the named services
	IgnoreFailures bool // continue when an individual push fails
}

type RmOptions struct {
	Force   bool // also remove running containers
	Stop    bool // stop containers before removing
	Volumes bool // also remove anonymous volumes attached to the containers
}

type RunOneOffOptions struct {
	// Command overrides the service command for this run.
	Command []string
	// Detach runs the one-off container in the background.
	Detach bool
	// Remove deletes the container after it exits (default true for run).
	Remove bool
	// NoDeps skips starting the service's dependencies.
	NoDeps bool
	// Name overrides the generated one-off container name.
	Name string
	// Interactive/TTY wire the container to the terminal.
	Interactive bool
	TTY         bool
	// Env are additional environment variables (KEY=VALUE) for this run.
	Env []string

	// Override flags mirroring `docker compose run`.
	Entrypoint    string   // --entrypoint
	EntrypointSet bool     // whether --entrypoint was provided (allows clearing)
	User          string   // --user
	WorkDir       string   // --workdir
	Labels        []string // --label KEY=VALUE
	Volumes       []string // --volume specs
	Publish       []string // --publish specs
	CapAdd        []string // --cap-add
	CapDrop       []string // --cap-drop
	ServicePorts  bool     // --service-ports: map the service's declared ports
	Build         bool     // --build: build image before running
	RemoveOrphans bool     // --remove-orphans
	Pull          string   // --pull: "always" pulls the image before running
	EnvFromFile   []string // --env-from-file: files of KEY=VALUE env entries
	Quiet         bool     // --quiet: suppress progress/warnings
	QuietBuild    bool     // --quiet-build
	QuietPull     bool     // --quiet-pull
}

type StartOptions struct {
	Wait        bool // block until healthcheck'd services are healthy
	WaitTimeout int  // bound for Wait (seconds); 0 = unbounded
}

type StatsOptions struct {
	NoStream bool   // --no-stream: print one snapshot and exit
	Format   string // --format: table|json|yaml
}

type SuperviseOptions struct {
	// AbortOnExit stops all containers when any one exits.
	AbortOnExit bool
	// AbortOnFailure stops all containers when any one exits non-zero.
	AbortOnFailure bool
	// ExitCodeFrom returns the exit code of this service's container (and
	// implies AbortOnExit).
	ExitCodeFrom string
}

type UpOptions struct {
	// Detach starts service containers in the background.
	Detach bool
	// NoBuild skips building images for services with a build section.
	NoBuild bool
	// Scale overrides the replica count per service name (compose --scale).
	Scale map[string]int
	// RemoveOrphans removes containers for services not in the compose file.
	RemoveOrphans bool
	// NoStart creates containers (and resources) without starting them.
	NoStart bool
	// Pull is the pull policy: "always" pulls every image before starting.
	Pull string
	// Wait blocks until started services are healthy/running before returning.
	Wait bool
	// WaitTimeout bounds Wait (seconds); 0 means no bound.
	WaitTimeout int
	// ForceRecreate recreates containers even if their config is unchanged.
	ForceRecreate bool
	// NoRecreate leaves existing containers in place even if their config changed.
	NoRecreate bool
	// Services restricts the up to these services (empty = all). Their
	// dependencies are included unless NoDeps is set.
	Services []string
	// NoDeps starts only the selected services, not their dependencies.
	NoDeps bool
	// Timeout overrides the stop grace period (seconds) when recreating.
	Timeout *int
	// QuietBuild / QuietPull suppress build / pull progress.
	QuietBuild bool
	QuietPull  bool
	// AbortOnExit stops all containers (foreground) when any one exits.
	AbortOnExit bool
	// AbortOnFailure stops all containers (foreground) when any one fails.
	AbortOnFailure bool
	// ExitCodeFrom returns this service's exit code from a foreground up.
	ExitCodeFrom string
	// AlwaysRecreateDeps force-recreates dependency containers too.
	AlwaysRecreateDeps bool
	// Attach restricts foreground log streaming to these services (empty = all
	// started). NoAttach excludes services. AttachDependencies also streams the
	// logs of dependency services.
	Attach             []string
	NoAttach           []string
	AttachDependencies bool
	// Foreground log formatting (mirrors `logs`).
	NoLogPrefix   bool
	NoColor       bool
	LogTimestamps bool
}

type WatchOptions struct {
	NoUp  bool // don't build & start services before watching
	Quiet bool // suppress build/sync progress logs
	Prune bool // remove synced files from the container when deleted from source
}