config

type CatalogConfig struct {
	Dir           string   `yaml:"dir"`
	Subdirs       []string `yaml:"subdirs"`
	FrameworksDir string   `yaml:"frameworks_subdir"`
}

type ComponentConfig struct {
	Name    string `yaml:"name"`
	Repo    string `yaml:"repo"`     // GitHub org/repo (e.g. "sirosfoundation/go-wallet-backend")
	DocsURL string `yaml:"docs_url"` // developer docs URL (optional)
}

type Config struct {
	Root        string
	CatalogDir  string
	MappingsDir string
	AuditsDir   string
	SiteDir     string
	OSCALDir    string
	RiskDir     string

	Project          ProjectConfig
	Frameworks       []FrameworkConfig
	Components       []ComponentConfig
	Profiles         []ProfileConfig
	RiskRegister     RiskRegisterConfig
	YearCycle        YearCycleConfig
	CatalogSubdirs   []string
	FrameworksSubdir string
}

type DirConfig struct {
	Dir string `yaml:"dir"`
}

type FrameworkConfig struct {
	ID              string `yaml:"id"`
	Name            string `yaml:"name"`
	CatalogFile     string `yaml:"catalog_file"`
	MappingFile     string `yaml:"mapping_file"`
	SidebarPosition int    `yaml:"sidebar_position"`

	// Mapping schema fields (generic loading/deriving).
	ListKey         string   `yaml:"list_key"`          // top-level YAML key (default: "mappings")
	Sections        []string `yaml:"sections"`          // multiple YAML keys to merge (overrides list_key)
	KeyField        string   `yaml:"key_field"`         // field name for requirement ID
	StatusField     string   `yaml:"status_field"`      // assessment status field (default: "coverage")
	WorkStatusField string   `yaml:"work_status_field"` // optional secondary status field
	NotesField      string   `yaml:"notes_field"`       // field name for notes (default: "notes")
	DeriveMode      string   `yaml:"derive_mode"`       // "result" or "coverage" (default: "coverage")
	Slug            string   `yaml:"slug"`              // URL slug for framework dir (default: ID)
	Source          string   `yaml:"source"`            // source attribution for per-requirement pages
	SourceURL       string   `yaml:"source_url"`        // live URL to the framework standard
}

type GRCFile struct {
	Project      ProjectConfig      `yaml:"project"`
	Catalog      CatalogConfig      `yaml:"catalog"`
	Mappings     DirConfig          `yaml:"mappings"`
	Audits       DirConfig          `yaml:"audits"`
	Site         DirConfig          `yaml:"site"`
	OSCAL        DirConfig          `yaml:"oscal"`
	Frameworks   []FrameworkConfig  `yaml:"frameworks"`
	Components   []ComponentConfig  `yaml:"components"`
	Profiles     []ProfileConfig    `yaml:"profiles"`
	RiskRegister RiskRegisterConfig `yaml:"risk_register"`
	YearCycle    YearCycleConfig    `yaml:"year_cycle"`
}

type ProfileConfig struct {
	ID          string `yaml:"id"`
	Name        string `yaml:"name"`
	Description string `yaml:"description,omitempty"`
	Default     bool   `yaml:"default,omitempty"`  // the base profile (findings without profiles: apply here)
	Inherits    string `yaml:"inherits,omitempty"` // parent profile ID (overrides extend parent)
}

type ProjectConfig struct {
	Name string `yaml:"name"`
	Repo string `yaml:"repo"`
	URL  string `yaml:"url"`
}

type RiskRegisterConfig struct {
	Dir    string   `yaml:"dir"`
	Files  []string `yaml:"files"`
	Public bool     `yaml:"public"` // whether to include in public site render
}

type YearCycleConfig struct {
	Title  string `yaml:"title"`  // heading for the year-cycle page
	Source string `yaml:"source"` // URL or local path to an iCal (.ics) feed
	Public bool   `yaml:"public"` // whether to include in public site render
}