diag

type Action struct {
	SourceRule  string     // 来源规则名
	Kind        ActionKind // 动作类型
	Severity    Severity   // 继承自 Finding
	Summary     string     // 简短描述
	Message     string     // 传递给控制流的消息
	Fingerprint string     // 来源 Finding 的稳定指纹，用于运行时去重
}

type ActionKind string

type AutoLevel string

type Category string

type Confidence string

type Finding struct {
	Rule       string     // 规则名，如 "StaleForeshadow"
	Category   Category   // 分类
	Severity   Severity   // 严重程度
	Confidence Confidence // 判定置信度
	AutoLevel  AutoLevel  // 自动化级别
	Target     string     // 建议作用面，如 "runtime.flow"
	Title      string     // 一行摘要
	Evidence   string     // 具体数据证据
	Suggestion string     // 改进建议（指向 prompt/flow/config）
}

type Report struct {
	Stats    Stats
	Findings []Finding
	Actions  []Action
}

type RuleFunc func(snap *Snapshot) []Finding

type Severity string

type Snapshot struct {
	Progress          *domain.Progress
	RunMeta           *domain.RunMeta
	Compass           *domain.StoryCompass
	Outline           []domain.OutlineEntry
	Volumes           []domain.VolumeOutline
	Characters        []domain.Character
	CastLedger        []domain.CastEntry
	WorldRules        []domain.WorldRule
	Timeline          []domain.TimelineEvent
	Foreshadow        []domain.ForeshadowEntry
	Relationships     []domain.RelationshipEntry
	StateChanges      []domain.StateChange
	StyleRules        *domain.WritingStyleRules
	Reviews           map[int]*domain.ReviewEntry
	Plans             map[int]*domain.ChapterPlan
	Summaries         map[int]*domain.ChapterSummary
	ContextBoundaries []domain.RuntimeContextBoundary
	ContextEvidence   map[int]domain.ContextBuildEvidence
	ReviewEvidence    map[int]domain.ReviewOutcomeEvidence
	ChapterTraces     map[int]*chapterTrace

	LoadErrors []string // 非 NotExist 的加载失败，区分"无数据"和"读取出错"
}

type Stats struct {
	CompletedChapters int
	TotalChapters     int
	TotalWords        int
	AvgWordsPerCh     int
	Phase             string
	Flow              string
	PlanningTier      string
	ReviewCount       int
	RewriteCount      int
	AvgReviewScore    float64
	ForeshadowOpen    int
	ForeshadowStale   int
}