discovery

type DiscoveryError struct {
	Service string // service name within the stack
	Path    string // file or directory path the error points at
	Reason  string // human-readable explanation
}

type Infra struct {
	Name           string // compose service name, e.g., "postgres-json-keys"
	Service        string // owning service name
	Stack          string // owning stack name
	Dockerfile     string // referenced Dockerfile (for build)
	HasHealthcheck bool
	DependsOn      []string
	Ports          []string
	Environment    map[string]string
	Volumes        []string // volume mounts the infra declares
}

type Service struct {
	Name        string // e.g., "service-json-keys"
	Stack       string // owning stack name
	Path        string // absolute path to the service directory
	ComposePath string // absolute path to its compose file
	Targets     []*Target
	Infra       []*Infra
	Volumes     []*Volume
	Networks    []string // network names declared at compose top-level
	// Dependency edges, one per compose `depends_on` entry. Each edge
	// connects two compose-service names (target or infra); resolution
	// to *Target/*Infra is done by ResolveDeps at the daemon level.
	DependsOn map[string][]string // compose-service-name → [list of names it depends on]
}

type Stack struct {
	Name     string
	Path     string
	Default  bool
	Services []*Service
	// Errors collected during discovery for this stack. Non-fatal —
	// surfaced via Status / startup logs so the user can fix them without
	// the daemon refusing to start outright. Strict-failure cases (the
	// stack path doesn't exist at all) are returned as the function's
	// error, not added here.
	Errors []DiscoveryError
}

type Target struct {
	Name        string     // e.g., "rest" (cmd directory name)
	ComposeName string     // e.g., "service-json-keys-rest" (compose service name)
	Service     string     // owning service name
	Stack       string     // owning stack name
	Profile     string     // compose profile name (same as Name by convention)
	Kind        TargetKind // OneShot | LongRunner
	CmdDir      string     // absolute path to cmd/<name>/
	Dockerfile  string     // absolute path to the build's Dockerfile (may be "")
	DependsOn   []string   // compose-service-names this target depends_on
	Ports       []string   // raw "${VAR}:N" port mappings (parsed by phase 4)
	Environment map[string]string
}

type TargetKind int

type Volume struct {
	Name    string // bare name, e.g., "json-keys-postgres-data"
	Service string
	Stack   string
}