config

type BuildConfig struct {
	BaseURL string               `yaml:"base-url,omitempty"`
	Recipes map[string]RecipeCfg `yaml:"recipes,omitempty"`
}

type Config struct {
	Rules          map[string]RuleCfg    `yaml:"rules"`
	Ignore         []string              `yaml:"ignore"`
	Overrides      []Override            `yaml:"overrides"`
	FrontMatter    *bool                 `yaml:"front-matter"`
	Categories     map[string]bool       `yaml:"categories"`
	Files          []string              `yaml:"files"`
	FollowSymlinks bool                  `yaml:"follow-symlinks"`
	MaxInputSize   string                `yaml:"max-input-size"`
	Kinds          map[string]KindBody   `yaml:"kinds,omitempty"`
	KindAssignment []KindAssignmentEntry `yaml:"kind-assignment,omitempty"`
	Build          BuildConfig           `yaml:"build,omitempty"`

	// Convention names a Markdown convention bundle. Built-in
	// values: "portable", "github", "plain". User-defined
	// conventions may also be referenced here after being declared
	// under the top-level `conventions:` key. Empty means no
	// convention. See internal/convention/convention.go and
	// docs/reference/conventions.md.
	Convention string `yaml:"convention,omitempty"`

	// Conventions holds user-defined convention bundles declared
	// under the top-level `conventions:` key. Each entry is a
	// { flavor, rules } pair. Names must not collide with the
	// built-in conventions ("portable", "github", "plain").
	Conventions map[string]UserConvention `yaml:"conventions,omitempty"`

	// LegacyNoFollowSymlinks captures the removed `no-follow-symlinks`
	// key. Its presence surfaces a deprecation warning via
	// Deprecations; its contents are otherwise ignored now that
	// symlinks are skipped by default. The `omitempty` tag keeps
	// round-tripped configs from re-emitting the deprecated key
	// unless a user explicitly supplied it.
	LegacyNoFollowSymlinks []string `yaml:"no-follow-symlinks,omitempty"`

	// ExplicitRules tracks rule names that were explicitly set in
	// the user config (not just inherited from defaults). This is
	// used for category override resolution: an explicitly enabled
	// rule takes precedence over a disabled category.
	// Not serialized to YAML.
	ExplicitRules map[string]bool `yaml:"-"`

	// FilesExplicit tracks whether the files key was explicitly set
	// in the user config. This distinguishes between an omitted key
	// (use defaults) and an explicitly empty list (no files).
	// Not serialized to YAML.
	FilesExplicit bool `yaml:"-"`

	// Deprecations lists human-readable warnings about deprecated
	// keys found in the loaded config. Callers (cmd/mdsmith) print
	// them to stderr.
	// Not serialized to YAML.
	Deprecations []string `yaml:"-"`

	// ConventionPreset is the convention's rule preset table,
	// captured at config load time. It is applied as a base layer
	// beneath the user's top-level rules: in effective-rule
	// resolution, the preset is merged first, the user's cfg.Rules
	// wins via deep-merge, then kinds and overrides apply on top.
	// Empty when no convention is selected.
	// Not serialized to YAML.
	ConventionPreset map[string]RuleCfg `yaml:"-"`
}

type FileResolution struct {
	File       string
	Kinds      []ResolvedKind
	Rules      map[string]RuleResolution
	Categories map[string]bool
}

type KindAssignmentEntry struct {
	// Glob is the canonical field for file patterns (doublestar syntax,
	// supports **, brace expansion, and !-prefix exclusion).
	Glob []string `yaml:"glob,omitempty"`
	// Files is a deprecated alias for Glob. Use Glob in new configs.
	Files []string `yaml:"files,omitempty"`
	// FieldsPresent lists front-matter keys that must all be present
	// with a non-null value for this entry to match. An empty list
	// disables the selector — only glob is considered.
	FieldsPresent []string `yaml:"fields-present,omitempty"`
	Kinds         []string `yaml:"kinds"`
}

type KindAssignmentSource string

type KindBody struct {
	Rules       map[string]RuleCfg `yaml:"rules"`
	Categories  map[string]bool    `yaml:"categories"`
	Schema      map[string]any     `yaml:"schema,omitempty"`
	PathPattern string             `yaml:"path-pattern,omitempty"`
}

type LayerEntry struct {
	Source string
	Set    bool
	Value  RuleCfg
}

type Leaf struct {
	Path  string
	Value any
	Chain []LeafChainEntry
}

type LeafChainEntry struct {
	Source string
	Value  any
}

type Override struct {
	// Glob is the canonical field for file patterns (doublestar syntax,
	// supports **, brace expansion, and !-prefix exclusion).
	Glob []string `yaml:"glob,omitempty"`
	// Files is a deprecated alias for Glob. Use Glob in new configs.
	Files      []string           `yaml:"files,omitempty"`
	Rules      map[string]RuleCfg `yaml:"rules"`
	Categories map[string]bool    `yaml:"categories"`
}

type ParamCfg struct {
	Required []string `yaml:"required,omitempty"`
	Optional []string `yaml:"optional,omitempty"`
}

type RecipeCfg struct {
	Command      string   `yaml:"command"`
	BodyTemplate string   `yaml:"body-template,omitempty"`
	Params       ParamCfg `yaml:"params,omitempty"`
}

type ResolvedKind struct {
	Name     string
	Source   KindAssignmentSource
	Selector string
}

type RuleCfg struct {
	Enabled  bool
	Settings map[string]any
}

type RuleResolution struct {
	Rule   string
	Final  RuleCfg
	Layers []LayerEntry
	Leaves []Leaf
}

type UserConvention struct {
	// Flavor is the Markdown flavor MDS034 should validate against
	// (e.g. "commonmark", "gfm", "goldmark").
	Flavor string `yaml:"flavor"`
	// Rules maps rule names to their presets, using the same schema
	// as the top-level `rules:` block.
	Rules map[string]RuleCfg `yaml:"rules,omitempty"`
}