exec

type Call struct {
	Name string
	Args []string
	Dir  string
}

type DryRun struct {
	Inner    Runner
	IsRead   ReadOnly
	Announce func(cmdline string)
}

type ExitError struct {
	Cmd    string
	Result Result
}

type Fake struct {

	// Responses maps a command-line prefix to its canned result.
	Responses map[string]Response
	// Missing lists binaries that LookPath should fail for.
	Missing map[string]bool
	// Default is returned when no prefix matches.
	Default Response

	Calls    []Call
	Detached []Call
	// contains filtered or unexported fields
}

type Logger interface {
	Debug(msg any, keyvals ...any)
	Info(msg any, keyvals ...any)
}

type Opts struct {
	Name   string
	Args   []string
	Dir    string
	Env    []string // appended to os.Environ()
	Stdin  io.Reader
	Stream bool // when true, pipe stdout/stderr straight to the terminal

	// Secret suppresses verbose logging of this command's output. Set it for
	// anything that prints a credential (the keychain lookup, for example) so
	// that -vv can never leak a token into the log.
	Secret bool
}

type ReadOnly func(Opts) bool

type Real struct {
	Log Logger
	// DebugOutput mirrors -vv: log the full stdout/stderr of every command.
	DebugOutput bool
	// Stdout and Stderr receive streamed output; nil means the process's own.
	Stdout io.Writer
	Stderr io.Writer
}

type Response struct {
	Stdout   string
	Stderr   string
	ExitCode int
	Err      error
}

type Result struct {
	Stdout   string
	Stderr   string
	ExitCode int

	// Skipped reports that --dry-run announced this command instead of
	// running it, so the zero Stdout means "nothing ran" rather than "the
	// command produced no output". Any caller that parses Stdout must check
	// it; a caller that needs real output under --dry-run is asking a
	// read-only question and belongs on the unwrapped runner (App.ReadGit,
	// App.ReadHelm, App.ReadHerdr).
	Skipped bool
}

type Runner interface {
	// Run executes a command to completion.
	Run(ctx context.Context, opts Opts) (Result, error)

	// StartDetached spawns a command in its own session and returns without
	// waiting for it. Used for the editor, which must outlive flow.
	StartDetached(ctx context.Context, opts Opts) error

	// LookPath reports the absolute path of an executable on PATH.
	LookPath(name string) (string, error)
}