daemon

type Clock interface {
	After(time.Duration) <-chan time.Time
}

type CommandError struct {
	Name   string
	Code   int
	Output string
}

type Config struct {
	// Reporter configures each pass. Its Providers allowlist is the
	// daemon's; Run refuses to start without one. Out and Stop are set by
	// Run.
	Reporter reporter.Config
	// Interval is the time between successful passes. Zero means
	// DefaultInterval.
	Interval time.Duration
	// Dir holds daemon.lock and daemon.log. Empty means
	// ~/.firekeeper, using Reporter.Home when set.
	Dir string
	// Out, when set, also receives every log line.
	Out io.Writer

	// RunOnce, Heartbeat, Clock, and Rand replace the real implementations
	// in tests. Nil means reporter.RunOnce, reporter.Heartbeat, the system
	// clock, and math/rand/v2.Float64.
	RunOnce   func(context.Context, reporter.Config) (reporter.Summary, error)
	Heartbeat func(context.Context, reporter.Config, reporter.Summary) error
	Clock     Clock
	Rand      func() float64
}

type ExecRunner struct{}

type Reporting struct {
	// Installed reports whether the service definition file exists.
	Installed bool
	// Running reports whether the service is running or a daemon holds
	// the lock, such as one started in a terminal.
	Running bool
	// Foreground reports that the running daemon is not the service: the
	// service manager says it is stopped, yet a daemon holds the lock.
	Foreground bool
	// Server is the dashboard URL the daemon reports to: its --server
	// flag when the service has one, else the configured server, else
	// reporter.DefaultServer.
	Server string
	// Providers are the service's --provider flags, or the configured
	// providers when it has none.
	Providers []transcript.Provider
}

type Runner interface {
	Run(ctx context.Context, name string, args ...string) ([]byte, error)
}

type Service struct {
	// GOOS picks the service manager: "darwin" or "linux".
	GOOS string
	// Home is the user's home directory.
	Home string
	// UID is the user's numeric id, for the launchd gui/<uid> domain.
	UID int
	// Executable is the absolute path of the firekeeper binary to run.
	Executable string
	// Args follow "daemon" on the service's command line.
	Args []string
	// Env holds the variables written into the service definition.
	Env map[string]string
	// Runner runs launchctl and systemctl.
	Runner Runner
	// Out receives progress lines.
	Out io.Writer
	// Sleep waits between bootstrap retries. Nil means time.Sleep.
	Sleep func(time.Duration)
}

type Status struct {
	// Installed reports whether the service definition file exists.
	Installed bool
	// Loaded reports whether the service manager knows the service.
	Loaded bool
	// Running reports whether the daemon process is up.
	Running bool
	// State is the manager's own word for the service's state.
	State string
	PID   int
	// LastExit is the last exit status, or empty when unknown.
	LastExit string
}