command

type ExecParams struct {
	// Command is the executable name or path.
	Command string
	// Args are the command arguments.
	Args []string
	// Cwd is the optional working directory.
	Cwd string
	// Timeout is the timeout in seconds (0 = default 30s).
	Timeout int
}

type Executor struct {
	provider.FactsAware
	// contains filtered or unexported fields
}

type Provider interface {
	// Exec executes a command directly without a shell.
	Exec(params ExecParams) (*Result, error)
	// Shell executes a command through /bin/sh -c.
	Shell(params ShellParams) (*Result, error)
}

type Result struct {
	// Stdout is the standard output.
	Stdout string `json:"stdout"`
	// Stderr is the standard error output.
	Stderr string `json:"stderr"`
	// ExitCode is the process exit code.
	ExitCode int `json:"exit_code"`
	// DurationMs is the execution time in milliseconds.
	DurationMs int64 `json:"duration_ms"`
	// Changed indicates whether the command modified system state.
	Changed bool `json:"changed"`
}

type ShellParams struct {
	// Command is the full shell command string.
	Command string
	// Cwd is the optional working directory.
	Cwd string
	// Timeout is the timeout in seconds (0 = default 30s).
	Timeout int
}