process

type DefaultRunner struct{}

type ExecSpec struct {
	// Command is the raw shell command string, run via the system shell.
	Command string
	// Name is a logical name used for logging.
	Name string
	// Dir is the working directory to change to before the replacement ("" keeps the current directory).
	Dir string
	// Env is the fully merged environment, used verbatim. ATMOS_SHLVL is NOT
	// incremented: the session replaces Atmos rather than nesting under it.
	Env []string
	// DryRun logs the command without executing it.
	DryRun bool
}

type Result struct {
	Command    string
	Args       []string
	ExitCode   int
	Err        error
	Started    bool
	Canceled   bool
	StartedAt  time.Time
	FinishedAt time.Time
}

type Runner interface {
	Run(ctx context.Context, spec TaskSpec) Result
}

type ShellSessionSpec struct {
	// Command is the raw shell command string, run via the system shell.
	Command string
	// Name is a logical name used for logging.
	Name string
	// Dir is the working directory.
	Dir string
	// Env is the fully merged environment. When empty, os.Environ() is used.
	Env []string
	// TTY allocates a pseudo-terminal when the platform supports it.
	TTY bool
	// Interactive forwards host stdin to the session and suspends the Atmos
	// SIGINT-exit handler so Ctrl-C is handled by the child process.
	Interactive bool
	// DryRun logs the command without executing it.
	DryRun bool
	// Masker applies secret masking to PTY output. When nil, it defaults to
	// iolib.GetContext().Masker() with EnableMasking from the `mask` setting,
	// so call sites don't need masking wiring.
	Masker iolib.Masker
	// EnableMasking enables secret masking of session output where supported.
	EnableMasking bool
}

type Streams struct {
	Stdin  io.Reader
	Stdout io.Writer
	Stderr io.Writer
}

type TaskSpec struct {
	Command string
	Args    []string
	Dir     string
	Env     []string
	Streams Streams
	DryRun  bool
}