angela

type CorpusSignals struct {
	// PotentialPairs are docs of the same type with shared tags but distant dates.
	// These are the most likely contradiction candidates.
	PotentialPairs []DocPair

	// TagClusters groups docs by tag for thematic analysis.
	TagClusters map[string][]string // tag → filenames

	// IsolatedDocs are docs with no shared tags with any other doc.
	IsolatedDocs []string

	// TypeDistribution counts docs per type.
	TypeDistribution map[string]int
}

type DiffHunk struct {
	OrigStart     int      // 0-based line index in original
	OrigCount     int      // number of original lines in this hunk
	ModStart      int      // 0-based line index in modified
	ModCount      int      // number of modified lines in this hunk
	ContextBefore []string // up to 3 lines before the change
	Original      []string // lines removed/changed from original
	Modified      []string // lines added/changed in modified
	ContextAfter  []string // up to 3 lines after the change
}

type DiffOptions struct {
	DryRun bool
	YesAll bool
}

type DocPair struct {
	DocA     string // filename
	DocB     string // filename
	Type     string // shared type
	Tags     string // shared tags
	DaysDiff int    // approximate days between dates
}

type DocSummary struct {
	Filename string
	Type     string
	Date     string
	Tags     []string
	Summary  string // adaptive: top sections by content length (max 450 runes total)
}

type DraftCheck struct {
	Label string
	Check func(body string, sections map[string]string) *Suggestion
}

type PersonaProfile struct {
	Name            string
	DisplayName     string
	Icon            string
	Expertise       string
	Principles      []string
	DraftChecks     []DraftCheck
	PromptDirective string
	DocTypes        []string // explicit type activation
	ContentSignals  []string // keyword content activation (EN + FR)
}

type ReviewCache struct {
	Version    int             `json:"version"`
	LastReview time.Time       `json:"last_review"`
	DocCount   int             `json:"doc_count"`
	TotalDocs  int             `json:"total_docs"`
	Findings   []ReviewFinding `json:"findings"`
}

type ReviewFinding struct {
	Severity    string   `json:"severity"` // "contradiction", "gap", "style", "obsolete"
	Title       string   `json:"title"`
	Description string   `json:"description"`
	Documents   []string `json:"documents"` // filenames concerned
}

type ReviewReport struct {
	Findings []ReviewFinding
	DocCount int
}

type ScoredPersona struct {
	Profile PersonaProfile
	Score   int
}

type StyleGuide struct {
	RequireWhy          bool
	RequireAlternatives bool
	MaxBodyLength       int // in runes, 0 = no limit
	MinTags             int

	// Warnings collects any parse-time issues (e.g. unknown rules).
	Warnings []Suggestion
}

type Suggestion struct {
	Category string // "structure", "completeness", "style", "coherence", "persona"
	Message  string
	Severity string // "info", "warning"
}