cli

type Env struct {
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
	// Getenv reads an environment variable.
	Getenv func(string) string
	// Dir is the working directory, where the project's .aboard file lives.
	Dir string
	// Executable returns the path of the running aboard binary, used to start the
	// local server in the background.
	Executable func() (string, error)
	// Rand is the source of randomness for idempotency keys.
	Rand io.Reader
	// Terminal is true when standard input and output are a terminal, so a command may
	// ask questions.
	Terminal bool
	// StdoutTerminal and StderrTerminal are true when that stream is a terminal, so text
	// written to it may be colored.
	StdoutTerminal, StderrTerminal bool
	// OpenBrowser opens a URL in the person's browser, failing when no browser could be
	// started.
	OpenBrowser func(ctx context.Context, url string) error
}

type Error struct {
	Code    string
	Message string
	Hint    string
	Details map[string]any
	// Exit is the process exit code; zero means exitError.
	Exit int
	// Usage is printed to stderr after the error, for usage errors.
	Usage string
	// Err is the underlying cause, if any. It is never shown to the user as is.
	Err error
}