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 DupStat struct {
	Sha   string
	Count int
}

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 RepeatStat struct {
	Sig   string
	Count int
}

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

type RoleModel struct {
	Agent, Provider, Model string
}

type RuleFunc func(snap *Snapshot) []Finding

type RuntimeCapture struct {
	GoOS, GoArch  string
	Models        []RoleModel  // 各会话实际生效的 provider/model（从 _meta 收集）
	CurrentStep   string       // 最新 checkpoint：scope.step
	StuckStep     string       // 尾部连续同 step；"" = 不卡
	StuckCount    int          // 连续次数
	Repeats       []RepeatStat // 重复签名 top-N（循环信号）
	DupContent    []DupStat    // 同 sha 文本反复出现（反复生成同段）
	LogKinds      map[string]int
	LogErrors     int
	LogWarns      int
	StopGuard     int
	Tail          []SkelEvent // 末 N 条骨架（看顺序）
	RedactedTexts int         // 打码文本块总数（脱敏自检）
	Sources       []string    // 实际读到的源（自检）
}

type RuntimeRuleFunc func(rc *RuntimeCapture) []Finding

type Severity string

type SkelEvent struct {
	Agent    string     // 来源会话：coordinator / writer-ch07 …
	Role     string     // assistant / tool / user
	Tools    []SkelTool // 该消息内的工具调用
	ErrClass string     // role=tool 且 is_error：错误首行（框架错误串，不含正文）
	TextSha  string     // 打码正文的短哈希；同 sha = 反复生成同一段（循环信号）
	Redacted int        // 本条打码的文本/思考块数（用于脱敏自检）
}

type SkelTool struct {
	Name     string            // 工具名（结构信号，不含正文）
	Args     map[string]string // key → 标量原值 / 短字符串带引号 / "<redacted len sha>"
	Invalid  bool              // ArgsInvalid：模型发来的参数无法解析（#34 信号）
	ParseErr string            // ArgsParseError：解析失败原因
}

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

	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
}