types

type FocusWhen struct {
	From string `yaml:"from,omitempty"`
	To   string `yaml:"to,omitempty"`
}

type GraphHealth struct {
	Warnings   int
	LoadErrors int
	Issues     []HealthIssue
}

type HealthIssue struct {
	Ref     string
	Message string
}

type Involvement struct {
	Target string
	// Actors carries canonical-only names. Distinguishing "unset" (inherit
	// focus-level default) from "explicit empty" (deliberately
	// pull-available) requires the ActorsSet field; YAML's natural decoding
	// merges both into a nil slice, so we capture the distinction at
	// frontmatter parse time.
	Actors    []string
	ActorsSet bool
	When      *FocusWhen
}

type LintFinding struct {
	Category string
	Code     string
	Severity LintSeverity
	// EntryID names the entry (or file path, for load errors) the finding is
	// about; empty for store-level findings like index drift.
	EntryID string
	Message string
}

type LintQuery struct{}

type LintResult struct {
	Findings []LintFinding
}

type LintSeverity string

type PartSize struct {
	Part  string
	Bytes int
}

type PatchPair struct {
	Old string
	New string
}

type ServeLane struct {
	Name string
	Text string
}

type ShowTreeBudget struct {
	MaxNodes    int
	MaxChildren int
}

type ViewBudget struct {
	// GroupItems caps focus groups, participant groups, and WIP markers per
	// section.
	GroupItems int
	// RefsPerEntry caps expand(refs) sub-lines per entry.
	RefsPerEntry int
	// BodyBytes caps as-bodies sections: whole bodies while bytes fit.
	BodyBytes int
}

type Warning struct {
	Field   string // "refs", "closes", "supersedes"
	Value   string // the offending ID or value
	Message string // human-readable description
}