chunk

type Chunk struct {
	ID          string
	Path        string
	LineStart   int
	LineEnd     int
	ContextFrom int
	ContextTo   int
	HeadingPath []string
	Numbered    string
}

type ChunkResult struct {
	Chunk  Chunk
	Report *schema.Report
	Model  string
}

type Config struct {
	Mode                   Mode
	ChunkLines             int
	ChunkOverlap           int
	ChunkMinLines          int
	ChunkTokenThreshold    int
	ChunkConcurrency       int
	SynthesisLineThreshold int
}

type ExecutorConfig struct {
	SystemPrompt string
	// Prefix is the shared user-message prefix from llm.BuildSpecPrefix. Every
	// chunk call sends it unchanged, so it is cached after the first.
	Prefix string
	// LongCache is passed through to llm.Request.LongCache.
	LongCache bool
	// WithLines puts each chunk's numbered lines in its task, for a Prefix
	// that leaves the spec out because it is too large to share.
	WithLines bool
	MaxTokens int
	Effort    string
	// EnforceSchema asks the provider to constrain responses to the review
	// schema.
	EnforceSchema bool
	// NoPatches leaves patches out of the requested output.
	NoPatches   bool
	Concurrency int
	Verbose     bool
	ErrWriter   io.Writer
}

type Heading struct {
	Level int
	Text  string
	Line  int
}

type MergeGroup struct {
	IssueIDs []string `json:"issue_ids"`
	Reason   string   `json:"reason"`
}

type MergeInput struct {
	ChunkResults []ChunkResult
	Preflight    []schema.Issue
	OriginalSpec string
}

type MergeResult struct {
	Issues    []schema.Issue
	Questions []schema.Question
	Patches   []schema.Patch
	// DroppedFindings counts findings the chunk and synthesis parsers left
	// out as invalid.
	DroppedFindings int
}

type Mode string

type Plan struct {
	Chunks    []Chunk
	Headings  []Heading
	Sections  []Section
	LineCount int
}

type Retraction struct {
	ID        string `json:"id"`
	LineStart int    `json:"line_start"`
	LineEnd   int    `json:"line_end"`
	Quote     string `json:"quote"`
	Reason    string `json:"reason"`
}

type Section struct {
	LineStart   int
	LineEnd     int
	HeadingPath []string
}

type SynthesisConfig struct {
	SystemPrompt string
	// Prefix is the shared user-message prefix from llm.BuildSpecPrefix, the
	// same one the chunk calls sent, so synthesis reads the spec from cache.
	Prefix string
	// LongCache is passed through to llm.Request.LongCache.
	LongCache bool
	// SpecShown reports that Prefix holds the whole spec. It is false when the
	// spec was too large to share, and synthesis then works from the findings.
	SpecShown bool
	MaxTokens int
	Effort    string
	// EnforceSchema asks the provider to constrain the response to the review
	// schema.
	EnforceSchema bool
	// NoPatches leaves patches out of the requested output.
	NoPatches     bool
	LineThreshold int
	Enabled       bool
}

type SynthesisInput struct {
	Merged MergeResult
	// SpecShown reports that the shared prefix holds the whole spec.
	SpecShown bool
}

type SynthesisResult struct {
	// Report holds the new cross-section findings.
	Report *schema.Report
	// Merges are groups of chunk findings that report one defect.
	Merges []MergeGroup
	// Retractions are chunk findings the spec answers.
	Retractions []Retraction
}