domain

type ComputePort interface {
	// Create sets up compute resources for an environment.
	Create(ctx context.Context, envName string, branch string) (*ComputeResources, error)

	// Start starts per-environment services (infra containers, etc).
	Start(ctx context.Context, envName string, ports PortMap) error

	// Stop stops services without destroying data or resources.
	Stop(ctx context.Context, envName string) error

	// Destroy tears down all compute resources.
	Destroy(ctx context.Context, envName string) error

	// IsRunning checks if environment compute resources are active.
	IsRunning(ctx context.Context, envName string) (bool, error)
}

type ComputeResources struct {
	WorktreePath string `json:"worktreePath,omitempty"` // local mode
	VMId         string `json:"vmId,omitempty"`         // preview/sandbox mode
	ExternalIP   string `json:"externalIp,omitempty"`   // preview/sandbox mode
}

type CoreConfig struct {
	Services map[string]CoreServiceConfig `yaml:"services,omitempty"`
}

type CoreServiceConfig struct {
	Outputs []string          `yaml:"outputs,omitempty"`
	Hooks   *CoreServiceHooks `yaml:"hooks,omitempty"`
}

type CoreServiceHooks struct {
	Init    string `yaml:"init,omitempty"`
	Seed    string `yaml:"seed,omitempty"`
	Reset   string `yaml:"reset,omitempty"`
	Destroy string `yaml:"destroy,omitempty"`
}

type EnvPort interface {
	// Generate writes .env.local files for all services in the environment.
	Generate(ctx context.Context, envName string, workdir string, ports PortMap, coreOutputs map[string]map[string]string) error

	// SymlinkSharedEnvFiles symlinks shared .env files from the main worktree.
	SymlinkSharedEnvFiles(ctx context.Context, workdir string) error

	// Cleanup removes generated env files.
	Cleanup(ctx context.Context, workdir string) error
}

type EnvironmentDetail struct {
	Entry        *EnvironmentEntry `json:"entry"`
	InfraRunning bool              `json:"infraRunning"`
}

type EnvironmentEntry struct {
	Name        string                       `json:"name"`
	Mode        EnvironmentMode              `json:"mode"`
	Branch      string                       `json:"branch"`
	Status      EnvironmentStatus            `json:"status"`
	CreatedAt   time.Time                    `json:"createdAt"`
	UpdatedAt   time.Time                    `json:"updatedAt"`
	Ports       PortMap                      `json:"ports"`
	CoreOutputs map[string]map[string]string `json:"coreOutputs"`
	Local       *LocalMeta                   `json:"local,omitempty"`
	Remote      *RemoteMeta                  `json:"remote,omitempty"`
}

type EnvironmentMode string

type EnvironmentStatus string

type HookContext struct {
	EnvName      string
	Branch       string
	ProjectName  string
	ProjectRoot  string
	WorktreePath string
	Ports        PortMap
	CoreOutputs  map[string]map[string]string
	Step         string
	Phase        string // "before" or "after"
}

type HookDef struct {
	Run             string `yaml:"run"`
	ContinueOnError bool   `yaml:"continue_on_error,omitempty"`
}

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

type HooksConfig map[string]StepHooks

type InfraService struct {
	Name   string
	Image  string
	Port   int
	EnvVar string // e.g., "REDIS_PORT" (extracted from ${REDIS_PORT:-6379} patterns)
}

type InfrastructureConfig struct {
	ComposeFile string `yaml:"compose_file"`
}

type LocalConfig struct {
	Worktree WorktreeConfig `yaml:"worktree"`
}

type LocalMeta struct {
	WorktreePath       string `json:"worktreePath"`
	ComposeProjectName string `json:"composeProjectName"`
}

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

type ManagerDeps struct {
	Compute     ComputePort
	Networking  NetworkingPort
	EnvGen      EnvPort
	State       StatePort
	Progress    ProgressReporter
	Config      *ProjectConfig
	ProjectRoot string
}

type NetworkingPort interface {
	// AllocatePorts returns deterministic port assignments for all services and infrastructure.
	AllocatePorts(envName string) (PortMap, error)

	// GetServiceURL returns the URL to reach a named service in the environment.
	GetServiceURL(envName string, service string) (string, error)
}

type NoopReporter struct{}

type PortMap map[string]int

type ProgressReporter interface {
	OnStep(event StepEvent)
}

type ProjectConfig struct {
	Version        int                      `yaml:"version"`
	Name           string                   `yaml:"name"`
	Core           CoreConfig               `yaml:"core"`
	Infrastructure *InfrastructureConfig    `yaml:"infrastructure,omitempty"`
	Services       map[string]ServiceConfig `yaml:"services"`
	Local          *LocalConfig             `yaml:"local,omitempty"`
	Hooks          HooksConfig              `yaml:"hooks,omitempty"`

	// Mode is the deployment mode (e.g., "local"). Set at load time, not from YAML.
	Mode string `yaml:"-"`

	// InfraServices is populated by parsing the compose file referenced in
	// Infrastructure.ComposeFile. It is not read from YAML directly.
	InfraServices map[string]InfraService `yaml:"-"`
}

type ProvisionerPort interface {
	Provision(ctx context.Context, envName string, spec VMSpec) (*VMInfo, error)
	Deprovision(ctx context.Context, vmID string) error
	Status(ctx context.Context, vmID string) (*VMInfo, error)
}

type RemoteMeta struct {
	VMId       string `json:"vmId"`
	ExternalIP string `json:"externalIp"`
}

type ServiceConfig struct {
	Path      string            `yaml:"path"`
	Command   string            `yaml:"command,omitempty"`
	DependsOn []string          `yaml:"depends_on,omitempty"`
	Env       map[string]string `yaml:"env,omitempty"`
	EnvFile   string            `yaml:"env_file,omitempty"` // relative to path, defaults to ".env.local"
}

type State struct {
	Version      int                          `json:"version"`
	Environments map[string]*EnvironmentEntry `json:"environments"`
}

type StatePort interface {
	// Load returns the full state.
	Load(ctx context.Context) (*State, error)

	// Save persists the full state.
	Save(ctx context.Context, state *State) error

	// GetEnvironment returns a single environment entry, or nil if not found.
	GetEnvironment(ctx context.Context, name string) (*EnvironmentEntry, error)

	// SetEnvironment creates or updates an environment entry.
	SetEnvironment(ctx context.Context, name string, entry *EnvironmentEntry) error

	// RemoveEnvironment deletes an environment entry.
	RemoveEnvironment(ctx context.Context, name string) error
}

type StepEvent struct {
	Step    string // e.g. "allocate_ports", "create_worktree", "create_database"
	Status  StepStatus
	Message string // human-readable detail
	Error   error  // non-nil when Status == StepFailed
}

type StepHooks struct {
	Before []HookDef `yaml:"before,omitempty"`
	After  []HookDef `yaml:"after,omitempty"`
}

type StepStatus string

type TemplateContext struct {
	ServicePorts   PortMap
	InfraPorts     PortMap
	CoreOutputs    map[string]map[string]string
	CurrentService string // set per-service during rendering, enables {{self.port}}
}

type VMInfo struct {
	ID         string
	ExternalIP string
	Status     string
}

type VMSpec struct {
	MachineType string
	DiskSizeGB  int
	Image       string
	Region      string
}

type ValidationError struct {
	Errors []string
}

type WorktreeConfig struct {
	// SymlinkPatterns are glob patterns for gitignored files to symlink from the
	// main worktree into each new worktree (e.g. ".env" matches .env files recursively).
	// These are typically secret/config files that exist in the main repo but aren't
	// tracked by git. Each pattern is matched recursively across the entire repo.
	SymlinkPatterns []string `yaml:"symlink_patterns,omitempty"`
}