config

type Config struct {
	// Meta is first so it lands at the top of the marshalled project.toml,
	// where users will look for "what version of this file is this."
	Meta     MetaConfig               `toml:"meta"`
	Project  ProjectConfig            `toml:"project"`
	Dev      DevConfig                `toml:"dev"`
	Secrets  SecretsConfig            `toml:"secrets"`
	Scaffold ScaffoldConfig           `toml:"scaffold"`
	Service  map[string]ServiceConfig `toml:"service,omitempty"`
}

type DBEngine string

type DBMode string

type DevConfig struct {
	Containerized bool `toml:"containerized"`
	HotReload     bool `toml:"hot_reload"`
}

type MetaConfig struct {
	// Schema is the project.toml schema version. Written by maestro at
	// init time; bumped by migrations.
	Schema int `toml:"schema"`
}

type ProjectConfig struct {
	Name      string `toml:"name"`
	RepoOwner string `toml:"repo_owner"`
}

type RedisMode string

type ScaffoldConfig struct {
	// CI controls whether `.github/workflows/ci.yml` is scaffolded.
	CI bool `toml:"ci"`
	// License controls whether a starter `LICENSE` is scaffolded at the
	// project root.
	License bool `toml:"license"`
}

type SecretsConfig struct {
	Provider SecretsProvider `toml:"provider"`
	// DopplerProject is the Doppler project the whole repo belongs to; each
	// service maps to its own config within it. Empty unless Provider is
	// Doppler.
	DopplerProject string `toml:"doppler_project,omitempty"`
}

type SecretsProvider string

type ServiceConfig struct {
	Shape  ServiceShape `toml:"shape,omitempty"`
	DB     DBEngine     `toml:"db,omitempty"`
	DBMode DBMode       `toml:"db_mode,omitempty"`
	// Redis records a Redis dependency provisioned alongside this service
	// (docker sidecar) or pointed at a live instance. Independent of the DB
	// engine — a service can use Redis without a database, like the gateway.
	Redis RedisMode `toml:"redis,omitempty"`
	Port  int       `toml:"port,omitempty"`
	// DBRef names another service in the same project whose Postgres sidecar
	// this service should share, instead of provisioning its own. Mutually
	// exclusive with DB and DBMode — the target decides the engine and mode.
	// Validated cross-service in Config.Validate: the target must exist, run
	// postgres in docker mode, and not itself be a ref (no chains).
	DBRef string `toml:"db_ref,omitempty"`
	// Preset records the preset that scaffolded this service, if any. It lets
	// refresh regenerate the service's provider=none dev secrets, which live
	// under the git-ignored .secrets/ and so are absent on a fresh clone.
	// Empty for hand-created services (`maestro service`).
	Preset string `toml:"preset,omitempty"`
}

type ServiceShape string