setup

type EnsureOpts struct {
	Home     string // the managed root, e.g. ~/.dexaflow
	GOOS     string
	GOARCH   string
	Libc     string
	LookPath func(string) (string, error)
	Stat     func(string) (os.FileInfo, error)
	Client   *http.Client
	Logf     func(string, ...any) // optional progress callback
}

type PostgresBuild struct {
	URL     string
	SHA256  string
	Version string
}

type Probe struct {
	GOOS     string
	GOARCH   string
	LookPath func(string) (string, error) // os/exec.LookPath
	Stat     func(string) (fs.FileInfo, error)
	Getwd    func() (string, error)
}

type PythonBuild struct {
	URL     string
	SHA256  string
	Version string
}

type Report struct {
	OS              string
	Arch            string
	Libc            string // "glibc" or "musl" on linux; empty on darwin
	PythonAvailable bool   // a usable Python 3.11+ interpreter is on PATH
	PythonPath      string // path to the chosen interpreter; empty when none is on PATH
	// Python311Path is a host python3.11 SPECIFICALLY, empty when there is none.
	//
	// It is separate from PythonPath because the two answer different questions
	// and the answers disagree on a very common machine. PythonPath answers
	// "what can parse a dag.py", and 3.12 or 3.13 can, because the Lite parser
	// shim is stdlib-only (ADR 0024). This field answers "will `dexaflow setup`
	// have to download a managed CPython", and only a 3.11 avoids that, because
	// setup.EnsurePython resolves the host interpreter with LookPath("python3.11")
	// and nothing else qualifies.
	//
	// Reporting only the first made `doctor` and `setup --dry-run` tell a host
	// with just 3.12 that its system Python would be used and nothing
	// downloaded, and then setup downloaded (#1224). Neither component was
	// wrong on its own; they were answering different questions in the same
	// sentence.
	Python311Path string
	Docker        bool
	K3d           bool
	Kubectl       bool
	UnderMnt      bool // cwd under /mnt (WSL 9p mount): inotify hot-reload is unreliable
	Tier          Tier
}

type Runner func(ctx context.Context, name string, args ...string) error

type Tier int