config

type ContainerNameParams struct {
	ServiceName string
	SpecName    string
	Type        string // "db", "http", "kafka", etc.
}

type ContainerNaming struct {
	DatabaseContainer string `yaml:"database_container"`  // Template for DB container name
	NetworkAlias      string `yaml:"network_alias"`       // Network alias for database (e.g., "real-db")
	KafkaContainer    string `yaml:"kafka_container"`     // Template for Kafka container name
	ProxyContainer    string `yaml:"proxy_container"`     // Template for proxy container name
	AppContainer      string `yaml:"app_container"`       // Template for app container name
	NetworkName       string `yaml:"network_name"`        // Template for network name
	MigrateContainer  string `yaml:"migrate_container"`   // Template for migration container name
	ProjectMountPath  string `yaml:"project_mount_path"`  // Mount path for project (default: /app/project)
	RegistryMountPath string `yaml:"registry_mount_path"` // Mount path for registry (default: /app/registry)
}

type DatabaseConfig struct {
	Name       string `yaml:"name"` // Logical name used to identify this database (required when using databases: list)
	Type       string `yaml:"type"` // mysql, postgresql
	Image      string `yaml:"image"`
	Port       int    `yaml:"port"`
	Container  string `yaml:"container"` // service name in docker-compose
	InitScript string `yaml:"init_script"`
	Database   string `yaml:"database"`
	Username   string `yaml:"username"`
	Password   string `yaml:"password"`
	Host       string `yaml:"host"`            // Host alias the app uses to connect (proxy occupies this alias on the Docker network)
	Proxy      *bool  `yaml:"proxy,omitempty"` // Whether to use a proxy for this database (enables interception)
}

type DependencyConfig struct {
	Name              string            `yaml:"name"`
	Type              string            `yaml:"type"` // http, grpc, database
	Host              string            `yaml:"host"`
	Port              int               `yaml:"port"`
	Proxy             bool              `yaml:"proxy"`
	HostAlias         string            `yaml:"host_alias"`
	Headers           map[string]string `yaml:"headers,omitempty"`
	GRPCDescriptorSet string            `yaml:"grpc_descriptor_set,omitempty"`
}

type EmbeddingConfig struct {
	Provider            string  `yaml:"provider"`             // voyage, openai, etc.
	IndexModel          string  `yaml:"index_model"`          // e.g., voyage-4-large (for indexing documents at 2048 dims)
	QueryModel          string  `yaml:"query_model"`          // e.g., voyage-4-lite (for queries at 2048 dims)
	APIKey              string  `yaml:"api_key"`              // Can be "${ENV_VAR_NAME}" or literal
	SimilarityThreshold float64 `yaml:"similarity_threshold"` // default: 0.50
	IndexOnComplete     bool    `yaml:"index_on_complete"`    // default: true
}

type FrameworkConfig interface {
	GetStartCommand(port string) []string
	GetMigrationCommand() []string
	NeedsWarmup() bool
	GetWarmupEndpoint() string
	GetWarmupDelay() time.Duration
}

type GenericFrameworkConfig struct {
	CustomStartCommand  string
	CustomMigrationCmd  string
	NeedsWarmupFlag     bool
	WarmupEndpointValue string
	WarmupDelayMs       int
}

type InfrastructureConfig struct {
	Kafka      bool   `yaml:"kafka"`
	Database   bool   `yaml:"database"`
	Redis      bool   `yaml:"redis"`
	GRPC       bool   `yaml:"grpc"`
	ExternalDB bool   `yaml:"external_db"` // Don't manage DB, service has its own
	ProxyImage string `yaml:"proxy_image"` // Docker image for protocol proxies (default: linespec:latest)
}

type JobBackendConfig struct {
	Type  string `yaml:"type"`            // redis | kafka | scheduled
	Queue string `yaml:"queue,omitempty"` // Redis queue key (e.g. "queue:default") or Kafka topic
}

type LineSpecConfig struct {
	Service            ServiceConfig          `yaml:"service"`
	Database           *DatabaseConfig        `yaml:"database,omitempty"`  // Single-database form (backward compat). Normalised into Databases by applyDefaults.
	Databases          []DatabaseConfig       `yaml:"databases,omitempty"` // Multi-database form. Takes precedence over Database when both are set.
	Infrastructure     InfrastructureConfig   `yaml:"infrastructure"`
	Dependencies       []DependencyConfig     `yaml:"dependencies,omitempty"`
	Provenance         *ProvenanceConfig      `yaml:"provenance,omitempty"`
	ContainerNaming    *ContainerNaming       `yaml:"container_naming,omitempty"`
	PortConfig         *PortConfig            `yaml:"ports,omitempty"`
	SchemaDiscovery    *SchemaDiscoveryConfig `yaml:"schema_discovery,omitempty"`
	Payload            *PayloadConfig         `yaml:"payload,omitempty"`
	JobBackend         *JobBackendConfig      `yaml:"job_backend,omitempty"`
	TestTimeoutSeconds int                    `yaml:"timeout_seconds,omitempty"`
	StrictPassthrough  bool                   `yaml:"strict_passthrough,omitempty"`
	GRPCDescriptorSet  string                 `yaml:"grpc_descriptor_set,omitempty"`
	Created            time.Time              `yaml:"-"`
	BaseDir            string                 `yaml:"-"`
}

type PayloadConfig struct {
	Directory        string            `yaml:"directory"`         // payload directory name (default: payloads)
	StatusField      string            `yaml:"status_field"`      // field path for HTTP status code (default: "status")
	AuthExtraction   map[string]string `yaml:"auth_extraction"`   // custom auth extraction rules
	SupportedFormats []string          `yaml:"supported_formats"` // list of supported formats
}

type PortConfig struct {
	MinPort        int  `yaml:"min_port"`         // Minimum port number for dynamic allocation
	MaxPort        int  `yaml:"max_port"`         // Maximum port number for dynamic allocation
	DynamicPorts   bool `yaml:"dynamic_ports"`    // Enable dynamic port allocation (default: true)
	FixedProxyPort int  `yaml:"fixed_proxy_port"` // Fixed port for proxy verification (0 = dynamic)
}

type ProvenanceConfig struct {
	Enforcement                  string             `yaml:"enforcement"`                      // none | warn | strict
	Dir                          string             `yaml:"dir"`                              // relative to repo root
	ExcludePaths                 []string           `yaml:"exclude_paths"`                    // glob/regex/path patterns for files exempt from provenance rules
	SharedRepos                  []SharedRepoConfig `yaml:"shared_repos"`                     // named remote repositories for cross-repo resolution
	CacheTTLMinutes              int                `yaml:"cache_ttl_minutes"`                // cache freshness TTL in minutes; defaults to 60
	CommitTagRequired            bool               `yaml:"commit_tag_required"`              // whether commits must reference a prov ID
	AutoAffectedScope            bool               `yaml:"auto_affected_scope"`              // whether to auto-populate affected_scope from git diffs
	RunAssociatedSpecsOnComplete bool               `yaml:"run_associated_specs_on_complete"` // whether to run associated_specs before committing a completion transition
	OverlapSpecsOnComplete       string             `yaml:"overlap_specs_on_complete"`        // severity of the cross-record overlap teeth at completion: block (default) | warn | off
	CommitOnStatusChange         bool               `yaml:"commit_on_status_change"`          // whether to auto-commit after open, complete, or deprecate transitions
	Embedding                    *EmbeddingConfig   `yaml:"embedding,omitempty"`              // embedding API configuration
	ManifestURL                  string             `yaml:"manifest_url,omitempty"`           // source manifest URL set by linespec clone
}

type SchemaDiscoveryConfig struct {
	Mode          string   `yaml:"mode"`           // auto, static, none
	Tables        []string `yaml:"tables"`         // explicit list when mode is static
	ExcludeTables []string `yaml:"exclude_tables"` // tables to ignore in auto mode
	CacheFile     string   `yaml:"cache_file"`     // path to cache discovered schema
}

type ServiceConfig struct {
	Name             string            `yaml:"name"`
	ServiceDir       string            `yaml:"service_dir"` // Directory containing service code (e.g., "user-service")
	Type             string            `yaml:"type"`        // web, worker, consumer
	Framework        string            `yaml:"framework"`
	Port             int               `yaml:"port"`
	HealthEndpoint   string            `yaml:"health_endpoint"`
	DockerCompose    string            `yaml:"docker_compose"`
	BuildContext     string            `yaml:"build_context"`
	StartCommand     string            `yaml:"start_command"`
	MigrationCommand string            `yaml:"migration_command"`      // Custom migration command (overrides framework default)
	WarmupEndpoint   string            `yaml:"warmup_endpoint"`        // Custom warmup endpoint (overrides framework default)
	WarmupDelayMs    int               `yaml:"warmup_delay_ms"`        // Custom warmup delay in milliseconds
	NeedsWarmup      *bool             `yaml:"needs_warmup,omitempty"` // Whether framework needs warmup (overrides framework default)
	Environment      map[string]string `yaml:"environment"`
}

type SharedRepoConfig struct {
	Name string `yaml:"name"` // short alias used in log output and disambiguation
	URL  string `yaml:"url"`  // git-cloneable remote URL
	Ref  string `yaml:"ref"`  // branch or tag to fetch from; defaults to "main"
	Dir  string `yaml:"dir"`  // subdirectory containing provenance records; defaults to "provenance"
}