process

type ManagedProcess struct {
	// ID is the unique identifier for this process.
	ID string

	// ProjectPath is the working directory for the process.
	ProjectPath string

	// Command is the executable to run.
	Command string

	// Args are the command arguments.
	Args []string

	// Env holds environment variables for the process (KEY=VALUE format).
	// If nil, the daemon's environment is used.
	Env []string

	// Labels provide metadata for filtering/grouping.
	Labels map[string]string
	// contains filtered or unexported fields
}

type ManagerConfig struct {
	// DefaultTimeout is the default process timeout (0 = no timeout).
	DefaultTimeout time.Duration
	// MaxOutputBuffer is the per-stream buffer size in bytes.
	MaxOutputBuffer int
	// GracefulTimeout is how long to wait for graceful shutdown before SIGKILL.
	GracefulTimeout time.Duration
	// HealthCheckPeriod is how often to check process health (0 = disabled).
	HealthCheckPeriod time.Duration
	// PIDTracker is an optional tracker for persisting PIDs for orphan cleanup.
	PIDTracker PIDTracker
}

type PIDTracker interface {
	Add(id string, pid int, pgid int, projectPath string) error
	Remove(id string, projectPath string) error
}

type ProcessConfig struct {
	ID          string
	ProjectPath string
	Command     string
	Args        []string
	Env         []string // Environment variables (KEY=VALUE format), nil = inherit daemon's env
	Labels      map[string]string
	BufferSize  int           // Per-stream buffer size (0 = default)
	Timeout     time.Duration // 0 = no timeout
}

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

type ProcessState uint32

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

type StartOrReuseResult struct {
	Process      *ManagedProcess
	Reused       bool   // True if an existing running process was returned
	Cleaned      bool   // True if a stopped/failed process was cleaned up before starting
	PortRetried  bool   // True if a port conflict was detected and resolved
	PortsCleared []int  // Ports that were cleared due to conflicts
	PortError    string // Non-empty if port conflict couldn't be resolved (e.g., managed process blocking)
}