cmd

type DevxConfig struct {
	Name          string                            `yaml:"name"`          // Project name
	Domain        string                            `yaml:"domain"`        // Custom domain (BYOD)
	Env           []string                          `yaml:"env"`           // Vault sources for secret injection
	Include       []DevxConfigInclude               `yaml:"include"`       // External devx.yaml files to compose (Idea 44)
	Tunnels       []DevxConfigTunnel                `yaml:"tunnels"`       // List of ports to expose
	Databases     []DevxConfigDatabase              `yaml:"databases"`     // List of databases to provision
	Services      []DevxConfigService               `yaml:"services"`      // List of applications to orchestrate
	Test          DevxConfigTest                    `yaml:"test"`          // Test configuration
	Mocks         []DevxConfigMock                  `yaml:"mocks"`         // List of OpenAPI mock servers to provision
	Profiles      map[string]DevxConfigProfile      `yaml:"profiles"`      // Named environment overlays
	Pipeline      *DevxConfigPipeline               `yaml:"pipeline"`      // Explicit pipeline stages (Idea 45.2)
	CustomActions map[string]DevxConfigCustomAction `yaml:"customActions"` // Named tasks (scaffolded for Idea 45.3)
}

type DevxConfigCustomAction struct {
	Command  []string   `yaml:"command,omitempty"`
	Commands [][]string `yaml:"commands,omitempty"`
}

type DevxConfigDatabase struct {
	Engine string                 `yaml:"engine"`
	Port   int                    `yaml:"port"`
	Pull   DevxConfigDatabasePull `yaml:"pull"`
	Seed   DevxConfigDatabaseSeed `yaml:"seed"`
	Dir    string                 `yaml:"-"` // Internal: set by include resolver to the included project's dir
}

type DevxConfigDatabasePull struct {
	Command string `yaml:"command"` // Command that writes a dump to stdout
	Format  string `yaml:"format"`  // "custom" for pg_restore binary format (postgres only)
	Jobs    int    `yaml:"jobs"`    // Parallel workers for pg_restore (default: num CPUs)
}

type DevxConfigDatabaseSeed struct {
	Command string `yaml:"command"` // Command to run on the host to seed the database
}

type DevxConfigDependsOn struct {
	Name      string `yaml:"name"`
	Condition string `yaml:"condition"` // "service_healthy" or "service_started"
}

type DevxConfigHealthcheck struct {
	HTTP     string `yaml:"http"`     // HTTP endpoint to poll (e.g., "http://localhost:8080/health")
	TCP      string `yaml:"tcp"`      // TCP address to probe (e.g., "localhost:5432")
	Interval string `yaml:"interval"` // Duration string (e.g., "1s", "500ms")
	Timeout  string `yaml:"timeout"`  // Duration string (e.g., "30s")
	Retries  int    `yaml:"retries"`  // Number of consecutive successes required
}

type DevxConfigInclude struct {
	Path    string `yaml:"path"`     // Path to devx.yaml file (relative to the parent devx.yaml)
	EnvFile string `yaml:"env_file"` // Optional: override .env for this sub-project
}

type DevxConfigMock struct {
	Name string `yaml:"name"` // Friendly name (becomes env var MOCK_<NAME>_URL)
	URL  string `yaml:"url"`  // Remote OpenAPI spec URL (must be http:// or https://)
	Port int    `yaml:"port"` // Host port (0 = auto-assign a free port)
}

type DevxConfigPipeline struct {
	Test   *DevxConfigPipelineStage `yaml:"test,omitempty"`
	Lint   *DevxConfigPipelineStage `yaml:"lint,omitempty"`
	Build  *DevxConfigPipelineStage `yaml:"build,omitempty"`
	Verify *DevxConfigPipelineStage `yaml:"verify,omitempty"`
}

type DevxConfigPipelineStage struct {
	Command  []string   `yaml:"command,omitempty"`  // Single command shorthand
	Commands [][]string `yaml:"commands,omitempty"` // Multi-command sequential execution
	Before   [][]string `yaml:"before,omitempty"`   // Pre-stage hooks (Idea 45.3)
	After    [][]string `yaml:"after,omitempty"`    // Post-stage hooks (Idea 45.3)
}

type DevxConfigProfile struct {
	Databases []DevxConfigDatabase `yaml:"databases"`
	Tunnels   []DevxConfigTunnel   `yaml:"tunnels"`
	Services  []DevxConfigService  `yaml:"services"`
	Mocks     []DevxConfigMock     `yaml:"mocks"`
}

type DevxConfigService struct {
	Name        string                `yaml:"name"`
	Runtime     string                `yaml:"runtime"`    // "host" (default), "container", "kubernetes", "cloud"
	Command     []string              `yaml:"command"`    // e.g. ["npm", "run", "dev"]
	DependsOn   []DevxConfigDependsOn `yaml:"depends_on"` // services/databases that must be healthy first
	Healthcheck DevxConfigHealthcheck `yaml:"healthcheck"`
	Port        int                   `yaml:"port"`
	Env         map[string]string     `yaml:"env"`            // extra env vars
	Sync        []DevxConfigSync      `yaml:"sync,omitempty"` // file sync mappings into containers
	Dir         string                `yaml:"-"`              // Internal: working directory (set by include resolver)
}

type DevxConfigSync struct {
	Container string   `yaml:"container"` // Target container name (e.g., "my-api")
	Src       string   `yaml:"src"`       // Host source path (relative to devx.yaml)
	Dest      string   `yaml:"dest"`      // Container destination path
	Ignore    []string `yaml:"ignore"`    // Additional ignore patterns (on top of defaults)
}

type DevxConfigTest struct {
	UI DevxConfigTestUI `yaml:"ui"`
}

type DevxConfigTestUI struct {
	Setup   string `yaml:"setup"`   // Pre-processing steps (e.g., migrations) to run before tests
	Command string `yaml:"command"` // The actual test command to execute
}

type DevxConfigTunnel struct {
	Name      string `yaml:"name"`       // Subdomain explicitly requested
	Port      int    `yaml:"port"`       // Local port to forward traffic towards
	BasicAuth string `yaml:"basic_auth"` // basic auth literal value 'user:pass'
	Throttle  string `yaml:"throttle"`   // traffic shaping profile e.g. '3g'
}