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 | human
	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 | human | 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 (deepest-coverage) region of Regions, kept as
	// a single value for display and for readers that predate region
	// sets ("" = repo-wide).
	Region string
	// Regions is the evidence-coverage region set (at most 3 directories
	// covering ≥80% of the cited events; see distill.coverageRegions).
	// Empty means "derive from Region" — pre-set rows and repo-wide
	// proposals both land there.
	Regions   []string
	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