domain

type AdvanceHold struct {
	After  AdvanceHoldAfter `json:"after"`
	Reason string           `json:"reason"`
}

type AdvanceHoldAfter string

type AgentUsageTotals struct {
	Input        int     `json:"input"`
	Output       int     `json:"output"`
	CacheRead    int     `json:"cache_read"`
	CacheWrite   int     `json:"cache_write"`
	Cost         float64 `json:"cost_usd"`
	Saved        float64 `json:"saved_usd"`
	CacheCapable bool    `json:"cache_capable"`
	// CacheBreaks 是 live 检测到的缓存链断裂次数（前缀未缩短而命中骤降）。
	// 只在实时路径累计，session replay 不重放检测。
	CacheBreaks int `json:"cache_breaks,omitempty"`
}

type ArcExpansion struct {
	Title    string         `json:"title"`
	Goal     string         `json:"goal"`
	Chapters []OutlineEntry `json:"chapters"`
}

type ArcOutline struct {
	Index             int            `json:"index"` // 卷内弧序号
	Title             string         `json:"title"`
	Goal              string         `json:"goal"`                         // 弧目标（起承转合）
	EstimatedChapters int            `json:"estimated_chapters,omitempty"` // 骨架弧的预估章数（展开后清零）
	Chapters          []OutlineEntry `json:"chapters"`
}

type ArcSummary struct {
	Volume    int      `json:"volume"`
	Arc       int      `json:"arc"`
	Title     string   `json:"title"`
	Summary   string   `json:"summary"`
	KeyEvents []string `json:"key_events"`
}

type CastEntry struct {
	Name string `json:"name"`
	// Aliases 当前没有写入通道；预留给将来的"用户 steer 合并别名"工具
	// （如把'李掌柜'与'老李'声明为同一人）。MergeAppearances 已支持别名查找。
	Aliases          []string `json:"aliases,omitempty"`
	BriefRole        string   `json:"brief_role,omitempty"` // 一句话定位（首次出场由 Writer 填，可后续补全；不被覆盖）
	FirstSeenChapter int      `json:"first_seen_chapter"`
	LastSeenChapter  int      `json:"last_seen_chapter"`
	// AppearanceCount 派生自 len(AppearanceChapters)，merge 时保持同步。
	// 保留显式字段方便 UI/JSON 直接读，无需每次重算。
	AppearanceCount    int   `json:"appearance_count"`
	AppearanceChapters []int `json:"appearance_chapters"`
	// Promoted 标记此条目已升格到 characters.json。RecentActive 会跳过这些条目，
	// 避免与核心档案重复召回。当前升格通道未实现，字段为预留 hook。
	Promoted bool `json:"promoted,omitempty"`
}

type CastIntro struct {
	Name      string `json:"name"`
	BriefRole string `json:"brief_role"`
}

type ChapterAdvanceMode string

type ChapterContract struct {
	RequiredBeats    []string `json:"required_beats,omitempty"`    // 本章必须落地的推进项
	ForbiddenMoves   []string `json:"forbidden_moves,omitempty"`   // 本章明确不能发生的推进
	ContinuityChecks []string `json:"continuity_checks,omitempty"` // 本章需特别核对的连续性点
	EvaluationFocus  []string `json:"evaluation_focus,omitempty"`  // Editor 需要重点检查的点
	EmotionTarget    string   `json:"emotion_target,omitempty"`    // 可选：本章希望读者主要感受到的情绪
	PayoffPoints     []string `json:"payoff_points,omitempty"`     // 可选：关键章希望回应的情节点/兑现点
	HookGoal         string   `json:"hook_goal,omitempty"`         // 可选：章末钩子希望驱动的追读欲望
}

type ChapterPlan struct {
	Chapter    int             `json:"chapter"`
	Title      string          `json:"title"`
	Goal       string          `json:"goal"`
	Conflict   string          `json:"conflict"`
	Hook       string          `json:"hook"`
	EmotionArc string          `json:"emotion_arc,omitempty"`
	Notes      string          `json:"notes,omitempty"` // Agent 的自由备忘
	Contract   ChapterContract `json:"contract,omitempty"`
}

type ChapterSummary struct {
	Chapter    int      `json:"chapter"`
	Title      string   `json:"title"`
	Summary    string   `json:"summary"`
	Characters []string `json:"characters"`
	KeyEvents  []string `json:"key_events"`
}

type Character struct {
	Name        string   `json:"name"`
	Aliases     []string `json:"aliases,omitempty"` // 别名/称号/绰号（如"废物少年"、"炎哥"）
	Role        string   `json:"role"`
	Description string   `json:"description"`
	Arc         string   `json:"arc"`
	Traits      []string `json:"traits"`
	Tier        string   `json:"tier,omitempty"` // core / important / secondary / decorative（默认 important）
}

type CharacterSnapshot struct {
	Volume     int    `json:"volume"`
	Arc        int    `json:"arc"`
	Name       string `json:"name"`
	Status     string `json:"status"`
	Power      string `json:"power,omitempty"`
	Motivation string `json:"motivation"`
	Relations  string `json:"relations,omitempty"`
}

type CharacterVoice struct {
	Name  string   `json:"name"`
	Rules []string `json:"rules"` // 2-3 条语言特征规则，每条 ≤30 字
}

type Checkpoint struct {
	Seq        int64     `json:"seq"`
	Scope      Scope     `json:"scope"`
	Step       string    `json:"step"`
	Artifact   string    `json:"artifact,omitempty"`
	Digest     string    `json:"digest,omitempty"`
	OccurredAt time.Time `json:"occurred_at"`
}

type CommitResult struct {
	Chapter        int              `json:"chapter"`
	Committed      bool             `json:"committed"`
	WordCount      int              `json:"word_count"`
	NextChapter    int              `json:"next_chapter"`
	ReviewRequired bool             `json:"review_required"`
	ReviewReason   string           `json:"review_reason,omitempty"`
	HookType       string           `json:"hook_type,omitempty"`
	DominantStrand string           `json:"dominant_strand,omitempty"`
	Feedback       *OutlineFeedback `json:"feedback,omitempty"`
	// 长篇分层信号
	ArcEnd         bool `json:"arc_end,omitempty"`
	VolumeEnd      bool `json:"volume_end,omitempty"`
	Volume         int  `json:"volume,omitempty"`
	Arc            int  `json:"arc,omitempty"`
	NeedsExpansion bool `json:"needs_expansion,omitempty"`  // 下一弧是骨架，需要展开章节
	NeedsNewVolume bool `json:"needs_new_volume,omitempty"` // 需要 Architect 创建下一卷
	NextVolume     int  `json:"next_volume,omitempty"`      // 下一弧/卷序号
	NextArc        int  `json:"next_arc,omitempty"`         // 下一弧序号
	// 完成态事实：本次 commit 后是否整本书已完成
	BookComplete bool `json:"book_complete,omitempty"`
	// 当前 Progress.Flow 快照（writing / reviewing / rewriting / polishing）
	Flow string `json:"flow,omitempty"`
}

type CommitStage string

type ConsistencyIssue struct {
	Type           string `json:"type"`     // 模型依据 rubric 给出的具体问题维度
	Severity       string `json:"severity"` // critical / error / warning
	Description    string `json:"description"`
	Evidence       string `json:"evidence,omitempty"` // 证据：原文片段、具体情节或状态数据
	Suggestion     string `json:"suggestion,omitempty"`
	Chapters       []int  `json:"chapters,omitempty"` // 证据实际落在哪些章节
	RequiresChange bool   `json:"requires_change"`    // 是否应立即进入返工队列，由 Editor 语义判断
}

type ContextProfile struct {
	SummaryWindow  int  // 加载最近 N 章摘要
	TimelineWindow int  // 加载最近 N 章时间线
	Layered        bool // true = 启用分层摘要加载（卷摘要+弧摘要+章摘要）
}

type DimensionScore struct {
	Dimension string `json:"dimension"`         // 由评审 rubric 定义，可按任务扩展
	Score     int    `json:"score"`             // 0-100
	Verdict   string `json:"verdict,omitempty"` // 兼容旧审阅；运行时不再用阈值覆盖模型判断
	Comment   string `json:"comment,omitempty"` // 该维度的简要结论
}

type FlowState string

type ForeshadowEntry struct {
	ID          string `json:"id"`
	Description string `json:"description"`
	PlantedAt   int    `json:"planted_at"`
	Status      string `json:"status"` // planted / advanced / resolved
	ResolvedAt  int    `json:"resolved_at,omitempty"`
}

type ForeshadowUpdate struct {
	ID          string `json:"id"`
	Action      string `json:"action"` // plant / advance / resolve
	Description string `json:"description,omitempty"`
}

type FoundationAudit struct {
	Fingerprint string                 `json:"fingerprint"`
	Ready       bool                   `json:"ready"`
	Summary     string                 `json:"summary"`
	Issues      []FoundationAuditIssue `json:"issues"`
}

type FoundationAuditIssue struct {
	Artifact    string `json:"artifact"`
	Description string `json:"description"`
	Evidence    string `json:"evidence"`
	Suggestion  string `json:"suggestion,omitempty"`
}

type MemoryPolicy struct {
	Mode                string `json:"mode,omitempty"`
	SummaryWindow       int    `json:"summary_window,omitempty"`
	TimelineWindow      int    `json:"timeline_window,omitempty"`
	LayeredSummaries    bool   `json:"layered_summaries,omitempty"`
	SummaryStrategy     string `json:"summary_strategy,omitempty"`
	WorkingRefresh      string `json:"working_refresh,omitempty"`
	EpisodicRefresh     string `json:"episodic_refresh,omitempty"`
	PlanningRefresh     string `json:"planning_refresh,omitempty"`
	FoundationRefresh   string `json:"foundation_refresh,omitempty"`
	PlanningFocus       string `json:"planning_focus,omitempty"`
	FoundationFocus     string `json:"foundation_focus,omitempty"`
	PreviousTailChars   int    `json:"previous_tail_chars,omitempty"`
	ChapterPlanEnabled  bool   `json:"chapter_plan_enabled,omitempty"`
	RelatedLookup       bool   `json:"related_chapter_lookup,omitempty"`
	CurrentOutlineBound bool   `json:"current_outline_bound,omitempty"`
	TotalChapters       int    `json:"total_chapters,omitempty"`
	HandoffPreferred    bool   `json:"handoff_preferred,omitempty"`
	ReadOnlyThreshold   int    `json:"read_only_threshold,omitempty"`
}

type Novel struct {
	Name          string `json:"name"`
	TotalChapters int    `json:"total_chapters"`
}

type OutlineEntry struct {
	Chapter   int      `json:"chapter"`
	Title     string   `json:"title"`
	CoreEvent string   `json:"core_event"`
	Hook      string   `json:"hook"`
	Scenes    []string `json:"scenes"`
}

type OutlineFeedback struct {
	Deviation  string `json:"deviation"`  // 偏离描述
	Suggestion string `json:"suggestion"` // 调整建议
}

type PendingCommit struct {
	Chapter        int             `json:"chapter"`
	Stage          CommitStage     `json:"stage"`
	Rewrite        bool            `json:"rewrite,omitempty"`
	RewriteMode    string          `json:"rewrite_mode,omitempty"`
	Payload        json.RawMessage `json:"payload,omitempty"`
	DraftContent   string          `json:"draft_content,omitempty"`
	Output         json.RawMessage `json:"output,omitempty"`
	Summary        string          `json:"summary,omitempty"`
	HookType       string          `json:"hook_type,omitempty"`
	DominantStrand string          `json:"dominant_strand,omitempty"`
	Result         *CommitResult   `json:"result,omitempty"`
	StartedAt      string          `json:"started_at,omitempty"`
	UpdatedAt      string          `json:"updated_at,omitempty"`
}

type Phase string

type PlanStartRecord struct {
	RawPrompt   string `json:"raw_prompt"`
	Planner     string `json:"planner"`
	PlannerTask string `json:"planner_task"`
	DecisionID  string `json:"decision_id,omitempty"`
}

type PlanningTier string

type Progress struct {
	NovelName         string      `json:"novel_name"`
	Phase             Phase       `json:"phase"`
	CurrentChapter    int         `json:"current_chapter"`
	TotalChapters     int         `json:"total_chapters"`
	CompletedChapters []int       `json:"completed_chapters"`
	TotalWordCount    int         `json:"total_word_count"`
	ChapterWordCounts map[int]int `json:"chapter_word_counts,omitempty"` // 每章字数，支持重写时修正总字数
	InProgressChapter int         `json:"in_progress_chapter,omitempty"` // 正在写作的章节（场景级恢复）
	CompletedScenes   []int       `json:"completed_scenes,omitempty"`    // 当前章节已完成的场景编号
	Flow              FlowState   `json:"flow,omitempty"`                // 当前流程
	PendingRewrites   []int       `json:"pending_rewrites,omitempty"`    // 待重写章节队列
	RewriteReason     string      `json:"rewrite_reason,omitempty"`      // 重写原因
	StrandHistory     []string    `json:"strand_history,omitempty"`      // 按章节顺序记录 dominant_strand
	HookHistory       []string    `json:"hook_history,omitempty"`        // 按章节顺序记录 hook_type
	// 长篇分层追踪（仅长篇模式使用，短篇/中篇为零值）
	CurrentVolume int  `json:"current_volume,omitempty"`
	CurrentArc    int  `json:"current_arc,omitempty"`
	Layered       bool `json:"layered,omitempty"`
	// ReopenedFromComplete 标记本书是经 reopen 从完结态重开进入返工的。返工只改已有章、
	// 不增减结构，故排空后应按"结构完整即重新完结"放行（避免终卷末伏笔被返工扰动后卡在
	// writing → 越界续写死循环）；正向写作不置此标记，完结判定保持线索收束的保守语义。
	ReopenedFromComplete bool `json:"reopened_from_complete,omitempty"`
	// ReopenCount 记录本书从完结态被重开的累计次数（/reopen 审计事实）。它同时保证
	// 重开后的再完结与上次完结的 progress.json 内容不同：checkpoint 对同 digest 幂等
	// 去重，字节相同的再完结不会产生新 checkpoint，StopGuard 会把成功的 complete_book
	// 误判为空转并升级终止。
	ReopenCount int `json:"reopen_count,omitempty"`
}

type RecallItem struct {
	Kind    string `json:"kind"`
	Key     string `json:"key,omitempty"`
	Chapter int    `json:"chapter,omitempty"`
	Reason  string `json:"reason,omitempty"`
	Summary string `json:"summary,omitempty"`
}

type RelatedChapter struct {
	Chapter int    `json:"chapter"`
	Reason  string `json:"reason"`
}

type RelationshipEntry struct {
	CharacterA string `json:"character_a"`
	CharacterB string `json:"character_b"`
	Relation   string `json:"relation"`
	Chapter    int    `json:"chapter"`
}

type ReviewEntry struct {
	Chapter          int                `json:"chapter"`
	Scope            string             `json:"scope"` // chapter / global / arc
	Issues           []ConsistencyIssue `json:"issues"`
	Dimensions       []DimensionScore   `json:"dimensions,omitempty"`      // 分维度评分
	ContractStatus   string             `json:"contract_status,omitempty"` // met / partial / missed
	ContractMisses   []string           `json:"contract_misses,omitempty"` // 未达成的 contract 条目
	ContractNotes    string             `json:"contract_notes,omitempty"`  // 对 contract 履行情况的简述
	Verdict          string             `json:"verdict"`                   // accept / polish / rewrite
	Summary          string             `json:"summary"`
	AffectedChapters []int              `json:"affected_chapters,omitempty"` // 需要重写/打磨的章节号
}

type RunMeta struct {
	StartedAt            string             `json:"started_at"`
	Provider             string             `json:"provider,omitempty"`
	Style                string             `json:"style"`
	Model                string             `json:"model"`
	PlanningTier         PlanningTier       `json:"planning_tier,omitempty"`
	StartPrompt          string             `json:"start_prompt,omitempty"`           // 用户原始创作需求（输入事实，先于启动裁定落盘；裁定失败后据此补裁）
	PlanStart            *PlanStartRecord   `json:"plan_start,omitempty"`             // 启动裁定事实，规划期崩溃恢复的唯一依据
	PendingSteer         string             `json:"pending_steer,omitempty"`          // 未完成的 Steer 指令，中断恢复时重新注入
	AdvanceMode          ChapterAdvanceMode `json:"advance_mode"`                     // 章节推进模式：auto / review
	AdvancePermitChapter int                `json:"advance_permit_chapter,omitempty"` // review 模式下一次性许可的正向章节
	AdvanceHold          *AdvanceHold       `json:"advance_hold,omitempty"`           // 当前干预签署的一次性暂停意图
}

type RuntimeQueueItem struct {
	Seq      int64                `json:"seq"`
	Time     time.Time            `json:"time"`
	Kind     RuntimeQueueKind     `json:"kind"`
	Priority RuntimeQueuePriority `json:"priority"`
	TaskID   string               `json:"task_id,omitempty"`
	Agent    string               `json:"agent,omitempty"`
	Category string               `json:"category,omitempty"`
	Summary  string               `json:"summary,omitempty"`
	Payload  any                  `json:"payload,omitempty"`
}

type RuntimeQueueKind string

type RuntimeQueuePriority string

type RuntimeTaskLogEntry struct {
	Time    time.Time `json:"time"`
	TaskID  string    `json:"task_id,omitempty"`
	Agent   string    `json:"agent,omitempty"`
	Event   string    `json:"event"`
	Tool    string    `json:"tool,omitempty"`
	Summary string    `json:"summary,omitempty"`
	Payload any       `json:"payload,omitempty"`
}

type Scope struct {
	Kind    ScopeKind `json:"kind"`
	Chapter int       `json:"chapter,omitempty"`
	Volume  int       `json:"volume,omitempty"`
	Arc     int       `json:"arc,omitempty"`
}

type ScopeKind string

type SimulationCompactProfile struct {
	Version          string                     `json:"version"`
	UpdatedAt        string                     `json:"updated_at,omitempty"`
	SourceCount      int                        `json:"source_count"`
	SourceFiles      []string                   `json:"source_files,omitempty"`
	Style            SimulationStyle            `json:"style,omitempty"`
	Lexicon          SimulationLexicon          `json:"lexicon,omitempty"`
	PlotDesign       SimulationPlotDesign       `json:"plot_design,omitempty"`
	HookDesign       SimulationHookDesign       `json:"hook_design,omitempty"`
	PacingDensity    SimulationPacingDensity    `json:"pacing_density,omitempty"`
	ReaderEngagement SimulationReaderEngagement `json:"reader_engagement,omitempty"`
	RoleGuidance     SimulationRoleGuidance     `json:"role_guidance,omitempty"`
}

type SimulationCorpusManifest struct {
	SourceDir string             `json:"source_dir,omitempty"`
	Sources   []SimulationSource `json:"sources"`
}

type SimulationHookDesign struct {
	HookTypes           []string `json:"hook_types,omitempty"`
	Placement           []string `json:"placement,omitempty"`
	CliffhangerPatterns []string `json:"cliffhanger_patterns,omitempty"`
	PayoffRules         []string `json:"payoff_rules,omitempty"`
}

type SimulationLexicon struct {
	CommonWords      []string `json:"common_words,omitempty"`
	EmotionWords     []string `json:"emotion_words,omitempty"`
	SceneWords       []string `json:"scene_words,omitempty"`
	TransitionWords  []string `json:"transition_words,omitempty"`
	SignaturePhrases []string `json:"signature_phrases,omitempty"`
}

type SimulationPacingDensity struct {
	SceneDensity        []string `json:"scene_density,omitempty"`
	InformationRelease  []string `json:"information_release,omitempty"`
	DialogueActionRatio []string `json:"dialogue_action_ratio,omitempty"`
	CompressionRules    []string `json:"compression_rules,omitempty"`
}

type SimulationPlotDesign struct {
	OpeningPatterns      []string `json:"opening_patterns,omitempty"`
	EscalationPatterns   []string `json:"escalation_patterns,omitempty"`
	TurningPointPatterns []string `json:"turning_point_patterns,omitempty"`
	PayoffPatterns       []string `json:"payoff_patterns,omitempty"`
}

type SimulationProfile struct {
	Version       string                   `json:"version"`
	CreatedAt     string                   `json:"created_at,omitempty"`
	UpdatedAt     string                   `json:"updated_at,omitempty"`
	Corpus        SimulationCorpusManifest `json:"corpus"`
	SourceReports []SimulationSourceReport `json:"source_reports"`
	Synthesis     SimulationSynthesis      `json:"synthesis"`
}

type SimulationReaderEngagement struct {
	Methods            []string `json:"methods,omitempty"`
	EmotionalDrivers   []string `json:"emotional_drivers,omitempty"`
	ProgressionRewards []string `json:"progression_rewards,omitempty"`
	AntiPatterns       []string `json:"anti_patterns,omitempty"`
}

type SimulationRoleGuidance struct {
	Architect []string `json:"architect,omitempty"`
	Writer    []string `json:"writer,omitempty"`
	Editor    []string `json:"editor,omitempty"`
}

type SimulationSource struct {
	RelativePath string `json:"relative_path"`
	SHA256       string `json:"sha256"`
	Fingerprint  string `json:"fingerprint"`
	SizeBytes    int64  `json:"size_bytes,omitempty"`
	ModTime      string `json:"mod_time,omitempty"`
	AnalyzedAt   string `json:"analyzed_at,omitempty"`
}

type SimulationSourceReport struct {
	RelativePath       string   `json:"relative_path,omitempty"`
	SHA256             string   `json:"sha256,omitempty"`
	Fingerprint        string   `json:"fingerprint,omitempty"`
	AnalyzedAt         string   `json:"analyzed_at,omitempty"`
	Title              string   `json:"title,omitempty"`
	Summary            string   `json:"summary,omitempty"`
	StyleObservations  []string `json:"style_observations,omitempty"`
	CommonWords        []string `json:"common_words,omitempty"`
	PlotPatterns       []string `json:"plot_patterns,omitempty"`
	HookPatterns       []string `json:"hook_patterns,omitempty"`
	PacingNotes        []string `json:"pacing_notes,omitempty"`
	ReaderAppeal       []string `json:"reader_appeal,omitempty"`
	ReusableTechniques []string `json:"reusable_techniques,omitempty"`
	Warnings           []string `json:"warnings,omitempty"`
}

type SimulationStyle struct {
	NarrativeVoice []string `json:"narrative_voice,omitempty"`
	SentenceRhythm []string `json:"sentence_rhythm,omitempty"`
	ProseTexture   []string `json:"prose_texture,omitempty"`
	Perspective    []string `json:"perspective,omitempty"`
	Mood           []string `json:"mood,omitempty"`
	DoNotCopy      []string `json:"do_not_copy,omitempty"`
}

type SimulationSynthesis struct {
	Style            SimulationStyle            `json:"style,omitempty"`
	Lexicon          SimulationLexicon          `json:"lexicon,omitempty"`
	PlotDesign       SimulationPlotDesign       `json:"plot_design,omitempty"`
	HookDesign       SimulationHookDesign       `json:"hook_design,omitempty"`
	PacingDensity    SimulationPacingDensity    `json:"pacing_density,omitempty"`
	ReaderEngagement SimulationReaderEngagement `json:"reader_engagement,omitempty"`
	RoleGuidance     SimulationRoleGuidance     `json:"role_guidance,omitempty"`
}

type StateChange struct {
	Chapter  int    `json:"chapter"`
	Entity   string `json:"entity"`              // 角色名或实体名
	Field    string `json:"field"`               // 变化属性：realm/location/status/power/relation 等
	OldValue string `json:"old_value,omitempty"` // 变化前（首次出现可空）
	NewValue string `json:"new_value"`           // 变化后
	Reason   string `json:"reason,omitempty"`    // 变化原因
}

type StoryCompass struct {
	EndingDirection string   `json:"ending_direction"`          // 终局方向（主题性描述）
	OpenThreads     []string `json:"open_threads,omitempty"`    // 活跃长线（需收束才能结局）
	EstimatedScale  string   `json:"estimated_scale,omitempty"` // 模糊规模（如"预计 4-6 卷"）
	LastUpdated     int      `json:"last_updated,omitempty"`    // 更新时的已完成章节数
}

type TimelineEvent struct {
	Chapter    int      `json:"chapter"`
	Time       string   `json:"time"`
	Event      string   `json:"event"`
	Characters []string `json:"characters,omitempty"`
}

type UnsupportedAdvanceModeError struct {
	Mode ChapterAdvanceMode
}

type UsageState struct {
	Schema       int                         `json:"schema"`
	UpdatedAt    time.Time                   `json:"updated_at"`
	Overall      AgentUsageTotals            `json:"overall"`
	PerAgent     map[string]AgentUsageTotals `json:"per_agent"`
	PerModel     map[string]AgentUsageTotals `json:"per_model,omitempty"`
	MissingUsage int                         `json:"missing_assistant_usage"`
}

type VolumeOutline struct {
	Index int          `json:"index"`
	Title string       `json:"title"`
	Theme string       `json:"theme"`           // 本卷核心冲突/主题
	Final bool         `json:"final,omitempty"` // 收官卷：全书在本卷收束（架构师 append_volume 时宣告）
	Arcs  []ArcOutline `json:"arcs"`
}

type VolumeSummary struct {
	Volume    int      `json:"volume"`
	Title     string   `json:"title"`
	Summary   string   `json:"summary"`
	KeyEvents []string `json:"key_events"`
}

type WorldRule struct {
	Category string `json:"category"` // magic / technology / geography / society / other
	Rule     string `json:"rule"`     // 规则描述
	Boundary string `json:"boundary"` // 不可违反的边界
}

type WritingStyleRules struct {
	Volume    int              `json:"volume"`
	Arc       int              `json:"arc"`
	Prose     []string         `json:"prose"`      // 3-5 条叙述风格规则，每条 ≤50 字
	Dialogue  []CharacterVoice `json:"dialogue"`   // 角色对话风格规则
	Taboos    []string         `json:"taboos"`     // 禁忌清单
	UpdatedAt string           `json:"updated_at"` // ISO8601 时间戳
}