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 {
	Databases map[string]DatabaseConfig `yaml:"databases,omitempty"`
}

type DatabaseConfig struct {
	Engine     string      `yaml:"engine"`
	Image      string      `yaml:"image"`
	Port       int         `yaml:"port"`
	User       string      `yaml:"user"`
	Password   string      `yaml:"password"`
	TemplateDb string      `yaml:"templateDb"`
	Seed       *SeedConfig `yaml:"seed,omitempty"`
}

type DatabaseInfo struct {
	Host             string `json:"host"`
	Port             int    `json:"port"`
	User             string `json:"user"`
	Password         string `json:"password"`
	Database         string `json:"database"`
	ConnectionString string `json:"connectionString"`
}

type DatabasePort interface {
	// EnsureInfrastructure ensures the database server is running and reachable.
	EnsureInfrastructure(ctx context.Context) error

	// SeedTemplate populates the template database from a snapshot or migration.
	// snapshotPath is optional; adapters may use config defaults.
	SeedTemplate(ctx context.Context, snapshotPath string) error

	// CreateDatabase creates an isolated database for the given environment.
	CreateDatabase(ctx context.Context, envName string) (*DatabaseInfo, error)

	// DestroyDatabase drops the environment's database.
	DestroyDatabase(ctx context.Context, envName string) error

	// ResetDatabase drops and re-creates the environment's database.
	ResetDatabase(ctx context.Context, envName string) (*DatabaseInfo, error)

	// DatabaseExists checks if the environment's database exists.
	DatabaseExists(ctx context.Context, envName string) (bool, error)
}

type DatabaseRef struct {
	Name     string `json:"name"`
	Provider string `json:"provider"`
}

type EnvPort interface {
	// Generate writes .env.local files for all services in the environment.
	Generate(ctx context.Context, envName string, workdir string, ports PortMap, databases map[string]*DatabaseInfo) 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"`
	DatabaseExists map[string]bool           `json:"databaseExists"`
	SnapshotInfo   map[string]*SnapshotState `json:"snapshotInfo"`
}

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"`
	Databases map[string]DatabaseRef `json:"databases"`
	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
	Databases    map[string]*DatabaseInfo
	Step         string
	Phase        string // "before" or "after"
}

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

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

type HooksConfig map[string]StepHooks

type InfraServiceConfig struct {
	Image string `yaml:"image"`
	Port  int    `yaml:"port"`
}

type LocalConfig struct {
	Worktree WorktreeConfig `yaml:"worktree"`
	// ComposeFile is the path to the docker compose file for per-env infrastructure,
	// relative to the project root. If empty, no per-env containers are started.
	ComposeFile string `yaml:"composeFile,omitempty"`
}

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

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

type ManagerDeps struct {
	Databases   map[string]DatabasePort
	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

	// 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"`
	PackageManager string                        `yaml:"packageManager,omitempty"`
	Core           CoreConfig                    `yaml:"core"`
	Infrastructure map[string]InfraServiceConfig `yaml:"infrastructure,omitempty"`
	Services       map[string]ServiceConfig      `yaml:"services"`
	Local          *LocalConfig                  `yaml:"local,omitempty"`
	Hooks          HooksConfig                   `yaml:"hooks,omitempty"`
}

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 SeedConfig struct {
	Strategy string          `yaml:"strategy"`
	Snapshot *SnapshotConfig `yaml:"snapshot,omitempty"`
	Script   string          `yaml:"script,omitempty"`
}

type ServiceConfig struct {
	Path      string            `yaml:"path"`
	Port      int               `yaml:"port"`
	Command   string            `yaml:"command,omitempty"`
	DependsOn []string          `yaml:"dependsOn,omitempty"`
	Env       map[string]string `yaml:"env,omitempty"`
}

type SnapshotConfig struct {
	Source string `yaml:"source"`
	Bucket string `yaml:"bucket"`
	Prefix string `yaml:"prefix"`
	Region string `yaml:"region"`
}

type SnapshotState struct {
	LastSeeded    *time.Time `json:"lastSeeded"`
	TemplateReady bool       `json:"templateReady"`
}

type SnapshotUpdate struct {
	LastSeeded    *time.Time
	TemplateReady *bool
}

type State struct {
	Version      int                          `json:"version"`
	Snapshots    map[string]*SnapshotState    `json:"snapshots"`
	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

	// UpdateSnapshot updates snapshot metadata for a named database.
	UpdateSnapshot(ctx context.Context, dbName string, info *SnapshotUpdate) 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 {
	Ports     PortMap
	Databases map[string]*DatabaseInfo
}

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 {
	BasePath string `yaml:"basePath"`
	// 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:"symlinkPatterns,omitempty"`
}