cmd

type DevxConfig struct {
	Name          string                            `yaml:"name"`                 // Project name
	Domain        string                            `yaml:"domain"`               // Custom domain (BYOD)
	Kubeconfig    string                            `yaml:"kubeconfig,omitempty"` // KUBECONFIG to inject into run/action child commands
	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)
	Bridge        *DevxConfigBridge                 `yaml:"bridge"`               // Hybrid edge-to-local routing (Idea 46.1)
	State         *DevxConfigState                  `yaml:"state"`                // State replication settings (Idea 56)
	Telemetry     *DevxConfigTelemetry              `yaml:"telemetry"`            // Telemetry export endpoints
	Cron          []DevxConfigCron                  `yaml:"cron"`                 // Named cron jobs runnable via `devx cron run` (Idea 66)
	Logs          *bool                             `yaml:"logs,omitempty"`       // default log-streaming opt-in for all services
}

type DevxConfigBridge struct {
	Kubeconfig string                      `yaml:"kubeconfig"`  // Path to kubeconfig (default: ~/.kube/config)
	Context    string                      `yaml:"context"`     // Kube context to use
	Namespace  string                      `yaml:"namespace"`   // Default namespace for targets
	AgentImage string                      `yaml:"agent_image"` // Override agent container image (Idea 46.2)
	Targets    []DevxConfigBridgeTarget    `yaml:"targets"`     // Outbound: remote services to bridge (46.1)
	Intercepts []DevxConfigBridgeIntercept `yaml:"intercepts"`  // Inbound: traffic intercept targets (46.2)
}

type DevxConfigBridgeIntercept struct {
	Service   string `yaml:"service"`    // K8s service to intercept
	Namespace string `yaml:"namespace"`  // Override namespace (default: bridge.namespace)
	Port      int    `yaml:"port"`       // Remote service port to intercept
	LocalPort int    `yaml:"local_port"` // Local port to route traffic to (default: same as port)
	Mode      string `yaml:"mode"`       // "steal" or "mirror" (required)
}

type DevxConfigBridgeTarget struct {
	Service   string `yaml:"service"`    // K8s service name (e.g., "payments-api")
	Namespace string `yaml:"namespace"`  // K8s namespace (default: from bridge.namespace)
	Port      int    `yaml:"port"`       // Remote service port to forward
	LocalPort int    `yaml:"local_port"` // Local port to bind (0 = auto)
}

type DevxConfigContainerBuild struct {
	Context    string   `yaml:"context,omitempty"`    // build context dir (default ".")
	Dockerfile string   `yaml:"dockerfile,omitempty"` // Dockerfile path relative to context (default "Dockerfile")
	Tag        string   `yaml:"tag,omitempty"`        // image tag (default "dev")
	Platforms  []string `yaml:"platforms,omitempty"`  // target platforms; empty = builder default
}

type DevxConfigCron struct {
	Name        string            `yaml:"name"`                  // Unique identifier (e.g. "nightly-cleanup")
	Schedule    string            `yaml:"schedule"`              // Cron expression (informational in v1)
	Command     []string          `yaml:"command"`               // Argv to execute (e.g. ["node", "scripts/cleanup.js"])
	Description string            `yaml:"description,omitempty"` // Free-text purpose; surfaced in `devx cron list`
	Timeout     string            `yaml:"timeout,omitempty"`     // Go-duration string (e.g. "5m"); empty = no timeout
	Env         map[string]string `yaml:"env,omitempty"`         // Per-job env vars, merged on top of project env
}

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", "service_started", or "service_completed_successfully" (one-shot tasks)
}

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 DevxConfigKubernetesImage struct {
	Name       string   `yaml:"name"`                 // image name (becomes localhost:<port>/<name>:<tag>)
	Context    string   `yaml:"context,omitempty"`    // build context dir (default ".")
	Dockerfile string   `yaml:"dockerfile,omitempty"` // Dockerfile path relative to context (default "Dockerfile")
	Tag        string   `yaml:"tag,omitempty"`        // image tag (default "dev")
	Platforms  []string `yaml:"platforms,omitempty"`  // target platforms, e.g. [linux/amd64, linux/arm64]; empty = builder default
}

type DevxConfigKubernetesSync struct {
	Src       string `yaml:"src"`                 // local source dir (relative to the service dir)
	Dest      string `yaml:"dest"`                // destination path inside the pod
	Selector  string `yaml:"selector"`            // pod label selector, e.g. "app=brms-offer"
	Container string `yaml:"container,omitempty"` // container in the pod (default: first)
}

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"`
	Bridge    *DevxConfigBridge    `yaml:"bridge"` // Idea 46.1: override bridge config per profile
	Telemetry *DevxConfigTelemetry `yaml:"telemetry"`
}

type DevxConfigService struct {
	Name            string                            `yaml:"name"`
	Runtime         string                            `yaml:"runtime"`    // "host" (default), "container", "kubernetes", "cloud", "bridge"
	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
	OneShot         bool                              `yaml:"oneshot,omitempty"`          // run-to-completion task (e.g. a seed); dependents use condition: service_completed_successfully
	Sync            []DevxConfigSync                  `yaml:"sync,omitempty"`             // file sync mappings into containers
	BridgeTarget    *DevxConfigServiceBridgeTarget    `yaml:"bridge_target,omitempty"`    // Idea 46.3: inline outbound bridge
	BridgeIntercept *DevxConfigServiceBridgeIntercept `yaml:"bridge_intercept,omitempty"` // Idea 46.3: inline intercept
	Kubernetes      *DevxConfigServiceKubernetes      `yaml:"kubernetes,omitempty"`       // runtime: kubernetes deploy spec
	CloudRun        *DevxConfigServiceCloudRun        `yaml:"cloud_run,omitempty"`        // runtime: cloud (Cloud Run) deploy spec
	Container       *DevxConfigServiceContainer       `yaml:"container,omitempty"`        // runtime: container deploy spec
	Dir             string                            `yaml:"-"`                          // Internal: working directory (set by include resolver)
	Logs            *bool                             `yaml:"logs,omitempty"`             // per-service log-streaming opt-in (overrides top-level)
}

type DevxConfigServiceBridgeIntercept struct {
	Service   string `yaml:"service"`    // K8s service to intercept
	Namespace string `yaml:"namespace"`  // Override namespace (default: bridge.namespace)
	Port      int    `yaml:"port"`       // Remote service port
	LocalPort int    `yaml:"local_port"` // Local port to route traffic to
	Mode      string `yaml:"mode"`       // "steal" or "mirror" (required)
}

type DevxConfigServiceBridgeTarget struct {
	Service   string `yaml:"service"`    // K8s service name
	Namespace string `yaml:"namespace"`  // Override namespace (default: bridge.namespace)
	Port      int    `yaml:"port"`       // Remote service port
	LocalPort int    `yaml:"local_port"` // Local port to bind (0 = auto)
}

type DevxConfigServiceCloudRun struct {
	Image                string            `yaml:"image"`                           // container image to deploy (required)
	Service              string            `yaml:"service,omitempty"`               // Cloud Run service name (default: the service name)
	Region               string            `yaml:"region"`                          // GCP region, e.g. "us-central1" (required)
	Project              string            `yaml:"project"`                         // GCP project ID (required)
	Env                  map[string]string `yaml:"env,omitempty"`                   // env vars set on the service
	AllowUnauthenticated bool              `yaml:"allow_unauthenticated,omitempty"` // expose publicly (default: false)
	Flags                []string          `yaml:"flags,omitempty"`                 // extra `gcloud run deploy` flags (escape hatch)
}

type DevxConfigServiceContainer struct {
	Image string                    `yaml:"image,omitempty"` // pre-built image to run (mutually exclusive with build)
	Build *DevxConfigContainerBuild `yaml:"build,omitempty"` // build from local context (mutually exclusive with image)
	Args  []string                  `yaml:"args,omitempty"`  // extra flags appended to `<runtime> run`
}

type DevxConfigServiceKubernetes struct {
	Manifests   string                      `yaml:"manifests"`              // kustomize dir (default), raw manifest file/dir, or helm chart
	Renderer    string                      `yaml:"renderer,omitempty"`     // "kustomize" (default) | "raw" | "helm"
	Namespace   string                      `yaml:"namespace,omitempty"`    // target namespace (default: "default")
	Context     string                      `yaml:"context,omitempty"`      // kube context (default: current context)
	Kubeconfig  string                      `yaml:"kubeconfig,omitempty"`   // kubeconfig path (default: $KUBECONFIG or ~/.kube/config)
	Images      []DevxConfigKubernetesImage `yaml:"images,omitempty"`       // images devx builds + loads into the cluster registry before apply
	Release     string                      `yaml:"release,omitempty"`      // helm release name (renderer: helm; default: service name)
	Values      []string                    `yaml:"values,omitempty"`       // helm values files (renderer: helm)
	Sync        []DevxConfigKubernetesSync  `yaml:"sync,omitempty"`         // live-reload: local dirs synced into the deployed pod
	PortForward bool                        `yaml:"port_forward,omitempty"` // auto-discover Services and forward them to localhost
}

type DevxConfigState struct {
	Relay string `yaml:"relay"` // Upload destination: s3://... or gs://...
}

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 DevxConfigTelemetry struct {
	GrafanaURL   string `yaml:"grafana_url"`
	OtlpEndpoint string `yaml:"otlp_endpoint"`
}

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'
}