htmlreport

type Box struct {
	Key        string
	X, Y, W, H float64
}

type Card struct {
	ID      int64
	Rule    string
	Region  string
	Note    string
	Agent   string
	Status  string
	Pending bool
	// Cited is how many findings the agent cited when the pattern was
	// distilled — a fact of the proposal record, true forever.
	// Retrieved is how many of those the index can still show: mining
	// windows move on, and a pin applied months ago may cite comments
	// that have since aged out. When they differ the page says so
	// rather than presenting the shortfall as the evidence.
	Cited     int
	Retrieved int
	Events    int
	// Evidence health (RFC-002 §7), recomputed at report time: the
	// confidence tier with its facts, the prompt era when the proposal
	// predates the current recurrence rules, and the regions today's
	// inference would assign when they differ from the stored ones.
	Tier       string
	Facts      string
	Era        string
	RegionsNow string
	// Scope is the trigger-scope advisory sentence (RFC-004): the note
	// and co-change history point outside the pin's regions, so
	// delivery may miss the trigger site. Same Line() the ledger prints.
	Scope string
	// Blocked reports confirmed triggers that cannot become delivery scopes —
	// no drift and no advisory would otherwise mention them.
	Blocked  string
	Evidence []Evidence
	// Outcome is the passive loop's verdict sentence,
	// present only for measured applied pins.
	Outcome string
	// NotLanding styles the outcome as the class that needs action.
	NotLanding bool
}

type Cell struct {
	Box
	File    string
	Scope   string // what clicking it filters the lessons table by
	Label   string // truncated to what the cell can show; "" when it cannot
	Metric  string // the fix count line; "" when the cell is too short
	Fill    string
	Ink     string
	Tooltip string
}

type Duplicate struct {
	Pins []DuplicatePin
}

type DuplicatePin struct {
	ID     int64
	Rule   string
	Digest string
}

type Evidence struct {
	Source string // review | fix:conventional | ...
	Kind   string // the source's provider, for the badge colour
	Path   string
	Body   string
	URL    string // "" unless it is a plain http(s) link
}

type Group struct {
	Box
	Label string
	Files int
}

type LessonRow struct {
	Occurrences int
	Region      string
	Reviewer    string
	Symptom     string
	Search      string // lowercased region + symptom, for the text filter
	// Scopes are the map scopes this lesson belongs to, space-separated.
	// Region membership is decided here rather than in the page, so
	// clicking a cell cannot disagree with the count in its tooltip.
	Scopes string
}

type Report struct {
	Repo       string
	IndexState string
	Generated  string
	Stale      bool

	Stats   []Stat
	Sources string // the evidence mix behind every proposal

	Cards       []Card
	CardsTotal  int
	Pending     int
	Duplicates  []Duplicate
	AppliedPins int
	Redundant   int

	Groups    []Group
	Cells     []Cell
	MapWidth  float64
	MapHeight float64
	// FilesWithHistory is every file the index has commits for. The map
	// draws a fraction of them, and says which fraction: a picture that
	// silently omits most of the repo reads as the whole repo.
	FilesWithHistory int

	Lessons      []LessonRow
	LessonsTotal int
}

type Stat struct {
	Value int
	Label string
}