flow

type ContestConfig struct {
	Personas    []string // persona slug，顺序即写作顺序；len<2 视为未启用
	Concurrency bool     // 候选生成是否并发
	Synopsis    bool     // 两段式：候选只写梗概+开头，中选后写全章
}

type Dispatcher struct {
	// contains filtered or unexported fields
}

type Instruction struct {
	Agent   string    // architect_long / architect_short / writer / editor；批量时为 ""
	Task    string    // 给子代理的任务描述
	Reason  string    // 给 Coordinator 看的理由（可选，方便调试与日志）
	Chapter int       // writer 任务涉及的章节号；0 表示不涉及
	Batch   []SubTask // 非空 = parallel 批量指令；空 = 原单派语义
}

type State struct {
	Progress *domain.Progress

	// 上一个已完成章节（Progress.CompletedChapters 末尾）；为 0 表示尚未开始写作。
	LastCompleted int

	// 上一章的弧边界信息；IsArcEnd=false 时其他字段无意义。
	// 当 LastCompleted=0 或非 Layered 模式时应为 nil。
	ArcBoundary *storepkg.ArcBoundary

	// 弧末后处理的三个事实：评审 / 弧摘要 / 卷摘要是否已完成。
	HasArcReview     bool
	HasArcSummary    bool
	HasVolumeSummary bool

	// 基础设定缺项（规划阶段的补齐信号）。
	FoundationMissing []string

	// 竞稿事实（ContestEnabled=false 时其余字段无意义）。
	ContestEnabled       bool            // 是否启用多人格竞稿
	Personas             []string        // persona slug 列表，顺序即写作顺序
	ContestChapter       int             // 当前竞稿目标章（= NextChapter），0 表示不适用
	CandidatesReady      map[string]bool // 各 persona 候选稿是否到位
	HasVerdict           bool            // 本章是否已有裁定
	VerdictWinner        string          // 中选 persona slug
	IsPromoted           bool            // 中选稿是否已提升为正式 draft.md
	VerdictRevisionNotes string          // 中选稿的修改意见（来自 verdict，供润色 writer 参考）
	ContestConcurrent    bool            // 候选生成是否并发（true=一次 parallel 批量派发）
	ContestSynopsis      bool            // 两段式：候选为梗概+开头，终稿阶段才写全章
	// Abandoned: nil 表示读取失败（已降级处理），空 map 表示本章无弃权
	Abandoned map[string]bool // 本章已弃权 persona slug（并发失败收敛）
}

type SubTask struct {
	Agent   string
	Task    string
	Chapter int
}