types

type ArgReference struct {
	Name         string
	HasDefault   bool
	DefaultValue string
	IsEscaped    bool
}

type DependencyGraph struct {
	AllNodes map[string]*DependencyNode `json:"-" yaml:"-"`
	Nodes    map[string]*DependencyNode `json:"nodes" yaml:"nodes"`
}

type DependencyLink struct {
	*DependencyNode `yaml:",inline"`
	Type            string `json:"dependency_type" yaml:"dependency_type"`
}

type DependencyNode struct {
	Name      string                    `json:"name" yaml:"name"`
	Status    string                    `json:"process_status" yaml:"process_status"`
	IsReady   string                    `json:"is_ready" yaml:"is_ready"`
	DependsOn map[string]DependencyLink `json:"depends_on,omitempty" yaml:"depends_on,omitempty" swaggertype:"object"`
}

type DependsOnConfig map[string]ProcessDependency

type DeprecationParams struct {
	StartTime time.Time
}

type EnvCmd map[string]string

type Environment []string

type LogRotationConfig struct {
	// Directory to log to when filelogging is enabled
	Directory string `yaml:"directory,omitempty" json:"directory,omitempty"`
	// Filename is the name of the logfile which will be placed inside the directory
	Filename string `yaml:"filename,omitempty" json:"filename,omitempty"`
	// MaxSize the max size in MB of the logfile before it's rolled
	MaxSize int `yaml:"max_size_mb,omitempty" json:"maxSize,omitempty"`
	// MaxBackups the max number of rolled files to keep
	MaxBackups int `yaml:"max_backups,omitempty" json:"maxBackups,omitempty"`
	// MaxAge the max age in days to keep a logfile
	MaxAge int `yaml:"max_age_days,omitempty" json:"maxAge,omitempty"`
	// Compress determines if the rotated log files should be compressed
	// using gzip. The default is not to perform compression.
	Compress bool `yaml:"compress,omitempty" json:"compress,omitempty"`
}

type LoggerConfig struct {
	// Rotation is the configuration for logging rotation
	Rotation *LogRotationConfig `yaml:"rotation,omitempty" json:"rotation,omitempty"`
	// FieldsOrder is the order in which fields are logged
	FieldsOrder []string `yaml:"fields_order,omitempty" json:"fieldsOrder,omitempty"`
	// DisableJSON disables log JSON formatting
	DisableJSON bool `yaml:"disable_json,omitempty" json:"disableJSON,omitempty"`
	// TimestampFormat is the format of the timestamp
	TimestampFormat string `yaml:"timestamp_format,omitempty" json:"timestampFormat,omitempty"`
	// NoColor disables coloring
	NoColor bool `yaml:"no_color,omitempty" json:"noColor,omitempty"`
	// NoMetadata disables log metadata (process, replica)
	NoMetadata bool `yaml:"no_metadata,omitempty" json:"noMetadata,omitempty"`
	// AddTimestamp adds timestamp to log
	AddTimestamp bool `yaml:"add_timestamp,omitempty" json:"addTimestamp,omitempty"`
	// FlushEachLine flushes the logger on each line
	FlushEachLine bool `yaml:"flush_each_line,omitempty" json:"flushEachLine,omitempty"`
}

type MCPArgument struct {
	Name        string          `yaml:"name"`
	Type        MCPArgumentType `yaml:"type"`
	Description string          `yaml:"description,omitempty"`
	Required    bool            `yaml:"required,omitempty"`
	Default     string          `yaml:"default,omitempty"`
}

type MCPArgumentType string

type MCPProcessConfig struct {
	Type      MCPProcessType `yaml:"type"`
	Arguments []MCPArgument  `yaml:"arguments,omitempty"`
	Timeout   string         `yaml:"timeout,omitempty"` // Optional: overrides global timeout
}

type MCPProcessType string

type MCPServerConfig struct {
	Host               string `yaml:"host,omitempty"`
	Port               int    `yaml:"port,omitempty"`
	Transport          string `yaml:"transport,omitempty"`            // Optional: defaults to "sse"
	Timeout            string `yaml:"timeout,omitempty"`              // Optional: defaults to "5m"
	ExposeControlTools bool   `yaml:"expose_control_tools,omitempty"` // Optional: when true, expose built-in pc_* control tools
}

type MemoryState struct {
	Allocated      uint64 `json:"allocated"`
	TotalAllocated uint64 `json:"totalAllocated"`
	SystemMemory   uint64 `json:"systemMemory"`
	GcCycles       uint32 `json:"gcCycles"`
}

type MonitorFor int

type ProcessCondition int

type ProcessConfig struct {
	Name                    string                 `yaml:",omitempty" json:"name,omitempty"`
	Disabled                bool                   `yaml:"disabled,omitempty" json:"disabled,omitempty"`
	IsDaemon                bool                   `yaml:"is_daemon,omitempty" json:"isDaemon,omitempty"`
	Command                 string                 `yaml:"command,omitempty" json:"command,omitempty"`
	Entrypoint              []string               `yaml:"entrypoint,omitempty" json:"entrypoint,omitempty"`
	LogLocation             string                 `yaml:"log_location,omitempty" json:"logLocation,omitempty"`
	LoggerConfig            *LoggerConfig          `yaml:"log_configuration,omitempty" json:"loggerConfig,omitempty"`
	Environment             Environment            `yaml:"environment,omitempty" json:"environment,omitempty"`
	EnvFile                 string                 `yaml:"env_file,omitempty" json:"envFile,omitempty"`
	RestartPolicy           RestartPolicyConfig    `yaml:"availability,omitempty" json:"restartPolicy,omitempty"`
	DependsOn               DependsOnConfig        `yaml:"depends_on,omitempty" json:"dependsOn,omitempty"`
	LivenessProbe           *health.Probe          `yaml:"liveness_probe,omitempty" json:"livenessProbe,omitempty"`
	ReadinessProbe          *health.Probe          `yaml:"readiness_probe,omitempty" json:"readinessProbe,omitempty"`
	ReadyLogLine            string                 `yaml:"ready_log_line,omitempty" json:"readyLogLine,omitempty"`
	ShutDownParams          ShutDownParams         `yaml:"shutdown,omitempty" json:"shutDownParams,omitempty"`
	DisableAnsiColors       bool                   `yaml:"disable_ansi_colors,omitempty" json:"disableAnsiColors,omitempty"`
	WorkingDir              string                 `yaml:"working_dir,omitempty" json:"workingDir,omitempty"`
	Namespace               string                 `yaml:"namespace,omitempty" json:"namespace,omitempty"`
	Replicas                int                    `yaml:"replicas,omitempty" json:"replicas,omitempty"`
	Extensions              map[string]interface{} `yaml:",inline" json:"extensions,omitempty"`
	Description             string                 `yaml:"description,omitempty" json:"description,omitempty"`
	Vars                    Vars                   `yaml:"vars,omitempty" json:"vars,omitempty"`
	IsForeground            bool                   `yaml:"is_foreground,omitempty" json:"isForeground,omitempty"`
	IsTty                   bool                   `yaml:"is_tty,omitempty" json:"isTty,omitempty"`
	IsElevated              bool                   `yaml:"is_elevated,omitempty" json:"isElevated,omitempty"`
	IsInteractive           bool                   `yaml:"is_interactive,omitempty" json:"isInteractive,omitempty"`
	LaunchTimeout           int                    `yaml:"launch_timeout_seconds,omitempty" json:"launchTimeout,omitempty"`
	IsDisabled              string                 `yaml:"is_disabled,omitempty" json:"isDisabled,omitempty"`
	DisableDotEnv           bool                   `yaml:"is_dotenv_disabled,omitempty" json:"disableDotEnv,omitempty"`
	OriginalConfig          string                 `yaml:"original_config,omitempty" json:"originalConfig,omitempty"`
	ReplicaNum              int                    `yaml:"replica_num,omitempty" json:"replicaNum,omitempty"`
	ReplicaName             string                 `yaml:"replica_name,omitempty" json:"replicaName,omitempty"`
	Executable              string                 `yaml:"executable,omitempty" json:"executable,omitempty"`
	Args                    []string               `yaml:"args,omitempty" json:"args,omitempty"`
	Schedule                *ScheduleConfig        `yaml:"schedule,omitempty" json:"schedule,omitempty"`
	MCP                     *MCPProcessConfig      `yaml:"mcp,omitempty" json:"mcp,omitempty"`
	TruncateLog             bool                   `yaml:"truncate_log,omitempty" json:"truncateLog,omitempty"`
	DisableCommandRendering bool                   `yaml:"is_template_disabled,omitempty" json:"disableCommandRendering,omitempty"`
	MonitorFor              MonitorFor             `yaml:"monitor_for,omitempty" json:"monitorFor,omitempty" jsonschema:"type=string,enum=none,enum=activity,enum=silence"`
	MonitorSilenceThreshold time.Duration          `yaml:"monitor_silence_threshold,omitempty" json:"monitorSilenceThreshold,omitempty"`
}

type ProcessDependency struct {
	Condition  ProcessCondition       `` /* 193-byte string literal not displayed */
	Extensions map[string]interface{} `yaml:",inline" json:"extensions,omitempty"`
}

type ProcessFunc func(process ProcessConfig) error

type ProcessPorts struct {
	Name     string   `json:"name"`
	TcpPorts []uint16 `json:"tcp_ports"`
	UdpPorts []uint16 `json:"udp_ports"`
}

type ProcessState struct {
	Name             string        `json:"name"`
	Namespace        string        `json:"namespace"`
	Status           string        `json:"status"`
	SystemTime       string        `json:"system_time"`
	Age              time.Duration `json:"age" swaggertype:"primitive,integer"`
	Health           string        `json:"is_ready"`
	HasHealthProbe   bool          `json:"has_ready_probe"`
	Restarts         int           `json:"restarts"`
	ExitCode         int           `json:"exit_code"`
	Pid              int           `json:"pid"`
	IsElevated       bool          `json:"is_elevated"`
	PasswordProvided bool          `json:"password_provided"`
	Mem              int64         `json:"mem"`
	CPU              float64       `json:"cpu"`
	IsRunning        bool          `json:"is_running"`
	NextRunTime      *time.Time    `json:"next_run_time,omitempty"`
	LastActivityTime *time.Time    `json:"last_activity_time,omitempty"`
	MaxLogicalLine   int64         `json:"-"` // TUI-only: furthest logical line reached in terminal
	// ProcessStartTime is the wall-clock time the process (first) entered a
	// running/launched state. Used by `process-compose analyze critical-chain`.
	ProcessStartTime *time.Time `json:"process_start_time,omitempty"`
	// ProcessReadyTime is the wall-clock time the process became ready. For
	// processes with a readiness probe or a `ready_log_line`, this is set when
	// the probe succeeds / the line is observed. For processes without any
	// readiness probe, it equals ProcessStartTime.
	ProcessReadyTime *time.Time `json:"process_ready_time,omitempty"`
	// ProcessEndTime is the wall-clock time the process ended (completed,
	// errored, terminated, or was skipped).
	ProcessEndTime *time.Time `json:"process_end_time,omitempty"`
}

type ProcessStateEvent struct {
	// Snapshot is true for events emitted as part of the initial replay on
	// subscribe, false for live transitions.
	Snapshot bool `json:"snapshot,omitempty"`
	// State is a self-contained copy of the process state at the moment of
	// the event.
	State ProcessState `json:"state"`
}

type Processes map[string]ProcessConfig

type ProcessesState struct {
	States []ProcessState `json:"data"`
}

type Project struct {
	Version             string               `yaml:",omitempty"`
	Name                string               `yaml:"name,omitempty"`
	LogLocation         string               `yaml:"log_location,omitempty"`
	LogLevel            string               `yaml:"log_level,omitempty"`
	LogLength           int                  `yaml:"log_length,omitempty"`
	LoggerConfig        *LoggerConfig        `yaml:"log_configuration,omitempty"`
	LogFormat           string               `yaml:"log_format,omitempty"`
	Processes           Processes            `yaml:"processes"`
	Environment         Environment          `yaml:"environment,omitempty"`
	ShellConfig         *command.ShellConfig `yaml:"shell,omitempty"`
	IsStrict            bool                 `yaml:"is_strict,omitempty"`
	Vars                Vars                 `yaml:"vars,omitempty"`
	DisableEnvExpansion bool                 `yaml:"disable_env_expansion,omitempty"`
	IsTuiDisabled       bool                 `yaml:"is_tui_disabled,omitempty"`
	ExtendsProject      string               `yaml:"extends,omitempty"`
	EnvCommands         EnvCmd               `yaml:"env_cmds,omitempty"`
	IsOrderedShutdown   bool                 `yaml:"ordered_shutdown,omitempty"`
	FileNames           []string             `yaml:"file_names,omitempty"`
	EnvFileNames        []string             `yaml:"env_file_names,omitempty"`
	DotEnvVars          map[string]string    `yaml:"dot_env_vars,omitempty"`
	Extensions          map[string]any       `yaml:",inline"`
	MCPServer           *MCPServerConfig     `yaml:"mcp_server,omitempty"`
}

type ProjectState struct {
	FileNames         []string      `json:"fileNames"`
	UpTime            time.Duration `json:"upTime" swaggertype:"primitive,integer"`
	StartTime         time.Time     `json:"startTime"`
	ProcessNum        int           `json:"processNum"`
	RunningProcessNum int           `json:"runningProcessNum"`
	UserName          string        `json:"userName"`
	Version           string        `json:"version"`
	ProjectName       string        `json:"projectName"`
	MemoryState       *MemoryState  `json:"memoryState,omitempty"`
}

type RestartPolicy int

type RestartPolicyConfig struct {
	Restart        RestartPolicy `yaml:",omitempty" json:"restart,omitempty" jsonschema:"type=string,enum=always,enum=on_failure,enum=exit_on_failure,enum=no"`
	BackoffSeconds int           `yaml:"backoff_seconds,omitempty" json:"backoffSeconds,omitempty"`
	MaxRestarts    int           `yaml:"max_restarts,omitempty" json:"maxRestarts,omitempty"`
	ExitOnEnd      bool          `yaml:"exit_on_end,omitempty" json:"exitOnEnd,omitempty"`
	ExitOnSkipped  bool          `yaml:"exit_on_skipped,omitempty" json:"exitOnSkipped,omitempty"`
}

type ScheduleConfig struct {
	// Cron expression for cron-based scheduling (e.g., "0 2 * * *")
	Cron string `yaml:"cron,omitempty" json:"cron,omitempty"`

	// Timezone for cron expression (e.g., "UTC", "America/New_York")
	Timezone string `yaml:"timezone,omitempty" json:"timezone,omitempty"`

	// Interval for interval-based scheduling (e.g., "30m", "1h", "5s")
	Interval string `yaml:"interval,omitempty" json:"interval,omitempty"`

	// RunOnStart determines whether to run immediately when process-compose starts
	RunOnStart bool `yaml:"run_on_start,omitempty" json:"run_on_start,omitempty"`

	// MaxConcurrent limits concurrent executions (default: 1)
	MaxConcurrent int `yaml:"max_concurrent,omitempty" json:"max_concurrent,omitempty"`
}

type ShutDownParams struct {
	ShutDownCommand string `yaml:"command,omitempty" json:"shutDownCommand,omitempty"`
	ShutDownTimeout int    `yaml:"timeout_seconds,omitempty" json:"shutDownTimeout,omitempty"`
	Signal          int    `yaml:"signal,omitempty" json:"signal,omitempty"`
	ParentOnly      bool   `yaml:"parent_only,omitempty" json:"parentOnly,omitempty"`
}

type StateObserver interface {
	// Notify is called for every event delivered to this observer. If the
	// observer cannot accept the event (e.g. its buffer is full), it should
	// drop or close itself rather than block.
	Notify(ev ProcessStateEvent)
	// UniqueID identifies this observer for subscribe/unsubscribe.
	UniqueID() string
}

type Vars map[string]any