config

type AgentEntry struct {
	Name   string `yaml:"name,omitempty"`
	Source string `yaml:"source"`
}

type AgentEntryBuilder func(harnessName, commitSHA string) (string, error)

type AgentLister interface {
	AgentEntries() []AgentEntry
}

type AllowTargets struct {
	Orgs  []string `yaml:"orgs,omitempty"`
	Repos []string `yaml:"repos,omitempty"`
}

type AllowedResourcesReader interface {
	AllowedResources() []string
}

type CommentNotificationConfig struct {
	Start      string `yaml:"start,omitempty"`
	Completion string `yaml:"completion,omitempty"`
}

type ConfigReader interface {
	AgentLister
	KillSwitchReader
	AllowedResourcesReader
	CreateIssuesReader
	ConfigVersion() string
	IsOrgMode() bool
}

type ConfigWriter interface {
	ConfigReader
	SetKillSwitch(bool)
	SetAgents([]AgentEntry)
	SetAllowedRemoteResources([]string)
	Marshal() ([]byte, error)
	Validate() error
}

type CreateIssuesConfig struct {
	AllowTargets AllowTargets `yaml:"allow_targets"`
}

type CreateIssuesReader interface {
	IssueCreationConfig() *CreateIssuesConfig
}

type DirConfig struct {
	Agents                 []AgentEntry
	AllowedRemoteResources []string
	KillSwitch             bool
	IsOrg                  bool
	Org                    *OrgConfig
	PerRepo                *PerRepoConfig
}

type DispatchConfig struct {
	Platform string `yaml:"platform"`
	Mode     string `yaml:"mode,omitempty"`     // "oidc-mint"
	MintURL  string `yaml:"mint_url,omitempty"` // informational, set when mode=oidc-mint
}

type InferenceConfig struct {
	Provider string `yaml:"provider"`
}

type KillSwitchReader interface {
	IsKillSwitchActive() bool
}

type LoadOpts struct {
	// MissingOK returns an empty DirConfig when config.yaml is absent.
	MissingOK bool
}

type MergedAgent struct {
	Name     string // canonical agent name
	Source   string // URL (with #sha256=), local path, or scaffold URL
	IsConfig bool   // true = from config agents list; false = scaffold default
}

type OrgConfig struct {
	Version                string                `yaml:"version"`
	KillSwitch             bool                  `yaml:"kill_switch,omitempty"`
	Dispatch               DispatchConfig        `yaml:"dispatch"`
	Inference              InferenceConfig       `yaml:"inference,omitempty"`
	Defaults               RepoDefaults          `yaml:"defaults"`
	Repos                  map[string]RepoConfig `yaml:"repos"`
	Agents                 []AgentEntry          `yaml:"agents,omitempty"`
	AllowedRemoteResources []string              `yaml:"allowed_remote_resources,omitempty"`
	CreateIssues           *CreateIssuesConfig   `yaml:"create_issues,omitempty"`
}

type OrgConfigReader interface {
	ConfigReader
	DispatchSettings() DispatchConfig
	InferenceSettings() InferenceConfig
	OrgRepoDefaults() RepoDefaults
	RepoMap() map[string]RepoConfig
	EnabledRepos() []string
	StatusNotifications() *StatusNotificationConfig
}

type OrgConfigWriter interface {
	OrgConfigReader
	ConfigWriter
	SetDispatch(DispatchConfig)
	SetInference(InferenceConfig)
}

type PerRepoConfig struct {
	Version                string              `yaml:"version"`
	KillSwitch             bool                `yaml:"kill_switch,omitempty"`
	Runtime                string              `yaml:"runtime,omitempty"`
	Roles                  []string            `yaml:"roles,omitempty"`
	Agents                 []AgentEntry        `yaml:"agents,omitempty"`
	AllowedRemoteResources []string            `yaml:"allowed_remote_resources,omitempty"`
	CreateIssues           *CreateIssuesConfig `yaml:"create_issues,omitempty"`
}

type PerRepoConfigReader interface {
	ConfigReader
	ConfigRoles() []string
	ConfigRuntime() string
}

type RepoConfig struct {
	Roles   []string `yaml:"roles,omitempty"`
	Enabled bool     `yaml:"enabled"`
}

type RepoDefaults struct {
	Roles                    []string                  `yaml:"roles"`
	Runtime                  string                    `yaml:"runtime,omitempty"`
	MaxImplementationRetries int                       `yaml:"max_implementation_retries"`
	AutoMerge                bool                      `yaml:"auto_merge"`
	StatusNotifications      *StatusNotificationConfig `yaml:"status_notifications,omitempty"`
}

type StatusNotificationConfig struct {
	Comment CommentNotificationConfig `yaml:"comment,omitempty"`
}