diversity

type Auditor struct {
	// contains filtered or unexported fields
}

type Category struct {
	ID       string   `toml:"id" json:"id"`
	Label    string   `toml:"label" json:"label,omitempty"`
	Keywords []string `toml:"keywords" json:"keywords,omitempty"`
	URIs     []string `toml:"uris" json:"uris,omitempty"`
	Schemes  []string `toml:"schemes" json:"schemes,omitempty"`
	// Roots are authority URIs whose transitive skos:narrower closure joins
	// the category -- "these URIs plus everything beneath them", expanded at
	// audit time from the loaded scheme (WithNarrower), so the facet
	// self-maintains as the vocabulary gains terms. A small CURATED set, not
	// one URI: closure only descends, so siblings and high parents each need
	// their own root; and concept/-ism terms with no broader edge stay the
	// keywords' job. Roots union with uris and keywords.
	Roots []string `toml:"roots" json:"roots,omitempty"`
	// Benchmark is an operator-supplied comparison share in [0,1] (service-area
	// demographics, publishing output, or the collection's own baseline), with
	// BenchmarkSource naming where it came from ("ACS 2024 service area",
	// "CCBC 2025"). The seed ships none: there is no standard target percentage,
	// and a benchmark without a named source is a number pretending to be a goal.
	Benchmark       *float64 `toml:"benchmark,omitempty" json:"benchmark,omitempty"`
	BenchmarkSource string   `toml:"benchmarkSource,omitempty" json:"benchmarkSource,omitempty"`
}

type CategoryTally struct {
	ID           string  `json:"id"`
	Label        string  `json:"label"`
	Works        int     `json:"works"`
	ShareCovered float64 `json:"shareCovered"`
	ShareTotal   float64 `json:"shareTotal"`
	// Benchmark/BenchmarkSource pass the operator's comparison share through
	// from the crosswalk, when one was configured. The tool never grades the
	// delta: a share against a benchmark is only as good as the coverage
	// above it, and interpreting the gap is the librarian's call.
	Benchmark       *float64 `json:"benchmark,omitempty"`
	BenchmarkSource string   `json:"benchmarkSource,omitempty"`
}

type Crosswalk struct {
	// contains filtered or unexported fields
}

type MultiplicityTally struct {
	Uncategorized int `json:"uncategorized"`
	MatchedOne    int `json:"matchedOne"`
	MatchedMulti  int `json:"matchedMulti"`
}

type Report struct {
	// TotalWorks is every work the audit saw.
	TotalWorks int `json:"totalWorks"`
	// CoveredWorks is the works carrying at least one subject (URI or label) --
	// the only works that can be categorized, and the honest denominator.
	CoveredWorks int `json:"coveredWorks"`
	// Coverage is CoveredWorks/TotalWorks in [0,1]. A low value means the audit
	// speaks for only part of the collection; read every category share with it.
	Coverage float64 `json:"coverage"`
	// Categories are the diversity categories in the crosswalk's reporting order.
	Categories []CategoryTally `json:"categories"`
	// Multiplicity decomposes CoveredWorks exclusively -- how many covered
	// works matched no category, exactly one, or two or more. Unlike the
	// per-category tallies (which overlap), these three sum with the
	// uncovered remainder to TotalWorks, so they stack honestly in a
	// composition chart; MatchedMulti doubles as the intersectionality
	// signal.
	Multiplicity MultiplicityTally `json:"multiplicity"`
}

type SubjectRef struct {
	URI    string
	Labels []string
	Scheme string
}