model

type CoChange struct {
	FileA    string // canonical order: FileA < FileB
	FileB    string
	Together int // commits touching both
	Total    int // commits in the mined window
	Lift     float64
}

type Decision struct {
	ID     int64
	Kind   DecisionKind
	Ref    string // commit SHA, PR number, ADR path
	TS     int64  // unix seconds
	Author string
	Title  string
	Body   string
	Files  []string // repo-relative files this decision touched
}

type DecisionKind string

type Edge struct {
	Src    int64
	Dst    int64
	Kind   EdgeKind
	Origin string
}

type EdgeKind string

type Finding struct {
	ID        int64  // stable across mines: GitHub comment id, or sha-derived for fixes
	LessonKey string // ClusterKey of the lesson this comment fed; "" for fix findings
	// Path is the finding's semantic home: the commented file for a
	// review finding, the most-changed non-test code file for a fix.
	Path string
	// Paths is a fix commit's full code footprint (primary first, by
	// churn, capped) — what region inference votes with, so a fix whose
	// test out-churned it still points at the code it corrected. Nil
	// for review findings: their single Path IS the location.
	Paths     []string
	PR        int    // pull-request number, 0 when unknown
	Reviewer  string // coderabbit | copilot | bot | person
	Body      string // boilerplate-stripped text, capped
	URL       string // provenance link (comment or commit), "" when none
	CreatedAt int64  // unix seconds
	// Source is the provider and its derivation: review, revert, or
	// fix:conventional / fix:issue-link / fix:subject — every finding
	// declares how it was mined, like every edge declares how it was
	// resolved.
	Source string
}

type Lesson struct {
	ID          int64
	ClusterKey  string // stable identity of (region, symptom); the upsert key
	Region      string // file or directory the feedback lands in
	Reviewer    string // coderabbit | copilot | bot | person | mixed
	Symptom     string // a rule code (RUF001) or a normalized message
	Fix         string // extracted suggestion, when the comment carried one
	Occurrences int    // how many comments fall in this cluster
	LastTS      int64  // most recent occurrence, unix seconds
	ExampleURL  string // a representative comment, for provenance
	// Annotation is surface-time display text (a confidence tag like
	// "weak evidence: 1 event"), never part of the lesson's identity:
	// the firing log records Symptom, and an annotation that changes
	// with age must not split one lesson into many statistical rows.
	Annotation string
}

type Proposal struct {
	ID        int64
	Signature string // the evidence group that produced it
	Rule      string // short kebab-case pin label
	// Region is the first current delivery region of Regions, kept as
	// a single value for display and for readers that predate region
	// sets ("" = repo-wide).
	Region string
	// Regions is the current bounded delivery set. It starts as evidence
	// coverage and may become a set of verified trigger files or
	// directories. Empty means "derive from Region" — pre-set rows and
	// repo-wide proposals both land there.
	Regions []string
	// TriggerPaths are validated repo paths where the mistake is MADE,
	// named by the distiller and verified by the harness.
	// Region recomputation reads them, so precise trigger scopes survive
	// a retarget. Nil for rows distilled before extraction existed.
	TriggerPaths []string
	// TriggerChecked is when the trigger question was last answered
	// for this row (unix seconds; 0 = never). "Examined, none found"
	// must stay distinct from "never examined", or every extraction
	// run re-pays for the same negative answers.
	TriggerChecked int64
	// TriggerPromptVersion identifies the extraction question that produced
	// the answer. A newer semantic question may re-examine an old negative
	// answer once without disturbing already validated positive triggers.
	TriggerPromptVersion int
	Note                 string  // the guidance, pin-ready
	Members              []int64 // finding ids the agent cited — verified to exist in the group
	Agent                string  // provenance: adapter name + prompt version
	Status               string  // proposed | applied | dismissed
	CreatedAt            int64
}

type Span struct {
	StartLine uint32
	StartCol  uint32
	EndLine   uint32
	EndCol    uint32
}

type Symbol struct {
	ID      int64
	FQN     string // e.g. "internal/store.Store.UpsertSymbols"
	Name    string // last FQN segment, e.g. "UpsertSymbols"
	Kind    SymbolKind
	File    string // repo-relative path; empty for external packages
	Span    Span
	Sig     string // declaration signature text, single line
	DocHash string // sha256 hex of the doc comment, "" if none
}

type SymbolKind string