lifecycle

type Action string

type Entry struct {
	Instance discovery.Instance
	Procs    map[Target]ProcSnapshot
}

type Manager interface {
	Do(ctx context.Context, key string, target Target, action Action) error
	// Dismiss hides an inactive instance from the dashboard: it drops any
	// registry ghost and suppresses the InstanceKey so a natively-scanned
	// stopped instance (e.g. a stopped compose container) stops appearing.
	// The suppression auto-clears when the instance is seen running again.
	// It always succeeds and never touches Docker.
	Dismiss(ctx context.Context, key string) error
	// ClearInactive dismisses every currently fully-stopped instance and
	// returns how many distinct instances were dismissed.
	ClearInactive(ctx context.Context) (int, error)
}

type ProcController interface {
	Snapshot(pid int) (ProcSnapshot, error)
	Terminate(pid int) error
	Kill(pid int) error
	Alive(pid int) bool
}

type ProcSnapshot struct {
	PID     int
	Argv    []string
	Dir     string
	LogPath string // stdout/stderr destination for the re-run; "" discards
}

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

type Starter interface {
	Start(argv []string, dir, logPath string) error
}

type Target string