service

type AttentionError struct {
	Msg string
}

type BuildInput struct {
	// Platform overrides the host. Empty uses the host platform.
	Platform Platform
	// StackName is the raw stack name. StackFile is absolute.
	StackName string
	StackFile string
	Port      int
	BasePort  int
	Watch     bool
	// RuntimeFlag is the global --runtime value, forwarded only when set.
	RuntimeFlag string
	Home        string
	// HomeOverridden reports state.HomeOverridden so the unit path stays
	// under an overridden home.
	HomeOverridden bool
	// Environ is the process environment to filter. Nil means os.Environ
	// is not consulted here; the caller passes the slice.
	Environ []string
	// PassphraseFile is an absolute path already verified by the caller.
	// It is written as GRIDCTL_VAULT_PASSPHRASE_FILE and is never read here.
	PassphraseFile string
	// Binary, when set, is used as-is (the caller already validated
	// --binary). Empty resolves the gridctl binary.
	Binary string
	Pack   string
}

type InfraError struct {
	Msg string
}

type InstallOptions struct {
	Spec           Spec
	DryRun         bool
	Force          bool
	NoEnable       bool
	Replace        bool
	HomeOverridden bool
	Notes          []string
}

type InstallResult struct {
	Name        string            `json:"name"`
	Platform    string            `json:"platform"`
	UnitPath    string            `json:"unit_path"`
	Label       string            `json:"label"`
	ExecStart   []string          `json:"exec_start"`
	Environment map[string]string `json:"environment"`
	Enabled     bool              `json:"enabled"`
	Running     bool              `json:"running"`
	PID         int               `json:"pid"`
	Linger      string            `json:"linger,omitempty"`
	Notes       []string          `json:"notes,omitempty"`
	DryRun      bool              `json:"dry_run"`
	Text        string            `json:"text,omitempty"`
	WouldEnable bool              `json:"would_enable,omitempty"`
}

type KV struct {
	Key   string
	Value string
}

type LogOptions struct {
	Lines  int
	Follow bool
	Stdout io.Writer
	Stderr io.Writer
}

type Manager struct {
	// contains filtered or unexported fields
}

type Platform string

type ResetRow struct {
	Name   string
	Client string
	Path   string
	Action string
	Detail string
	Error  string
}

type Row struct {
	Name        string `json:"name"`
	Platform    string `json:"platform"`
	State       string `json:"state"`
	Enabled     string `json:"enabled"`
	PID         int    `json:"pid,omitempty"`
	Port        int    `json:"port,omitempty"`
	Stack       string `json:"stack"`
	Unit        string `json:"unit"`
	Linger      string `json:"linger,omitempty"`
	Remediation string `json:"remediation,omitempty"`
	Label       string `json:"label,omitempty"`
	Pack        string `json:"pack,omitempty"`
	Detail      string `json:"detail,omitempty"`
}

type RuntimeState struct {
	// State is running, failed, inactive, not-loaded, or unknown.
	State   string
	Enabled bool
	PID     int
	Detail  string
}

type Spec struct {
	Platform               Platform
	Name                   string // sanitized service name
	StackName              string // raw stack name
	Label                  string
	Binary                 string
	Argv                   []string
	Env                    []KV
	Home                   string
	LogPath                string
	UnitPath               string
	PodmanSocketDependency bool
	StackFile              string
	Pack                   string
	Port                   int
	BasePort               int
}

type StopReport struct {
	// Present is true when a service lock entry exists.
	Present bool
	Path    string
	// OwnedPID is the supervisor's main PID when that process is the
	// recorded daemon, or the unit was active. Zero means the supervisor
	// does not own the recorded process. Destroy must not KillDaemon an
	// owned PID: Restart=on-failure would start it again.
	OwnedPID int
	// StoppedUnit is true when a loaded unit was stopped. Destroy prints
	// the re-enable message only then.
	StoppedUnit bool
	// NotLoaded means the user manager does not have the unit, or no
	// supervisor binary is installed. Destroy continues as unsupervised.
	NotLoaded bool
}

type Supervisor interface {
	Enable(ctx context.Context, spec Spec) error
	Disable(ctx context.Context, spec Spec) error
	// Stop stops the unit without disabling it. destroy uses this so
	// Restart=on-failure does not see a killed process.
	Stop(ctx context.Context, spec Spec) error
	Query(ctx context.Context, spec Spec) (RuntimeState, error)
	Logs(ctx context.Context, spec Spec, opts LogOptions) error
	// Linger reports "yes", "no", or "unknown". Non-Linux supervisors
	// return "unknown" and a nil error.
	Linger(ctx context.Context) (string, error)
	// DaemonReload refreshes the user manager after a unit file is
	// removed. Non-Linux supervisors return nil.
	DaemonReload(ctx context.Context) error
	// Restart reloads unit text and restarts a unit the supervisor
	// already owns. It is not KillDaemon: a five-second SIGKILL would
	// trip Restart=on-failure.
	Restart(ctx context.Context, spec Spec) error
}

type UninstallOptions struct {
	Force  bool
	DryRun bool
}

type UninstallResult struct {
	Name     string `json:"name"`
	Action   string `json:"action"`
	UnitPath string `json:"unit_path,omitempty"`
	Detail   string `json:"detail,omitempty"`
	DryRun   bool   `json:"dry_run"`
}