markdown

type ActionType string

type Decoration string

type Document struct {
	Title       string     // Leading H1 heading text ("" when the document has none)
	Preamble    string     // Text before the first heading
	Sections    []*Section // Top-level sections
	SourceLines []string   // Raw source lines (for line-level commenting)
}

type File struct {
	Path   string
	Doc    *Document
	Diff   *diff.Info   // nil: review the full source instead of a diff
	Viewed *ViewedState // nil: viewed marks live only for the session
}

type FileReview struct {
	Path   string
	Doc    *Document
	Review *ReviewResult
}

type ReviewComment struct {
	SectionID  string     // Target section ID
	Action     ActionType // Comment action type
	Decoration Decoration // Comment decoration (e.g. non-blocking, blocking)
	Body       string     // Comment body text
	StartLine  int        // 1-based start line (0 = section-level comment)
	EndLine    int        // 1-based end line (0 = single line if StartLine > 0)
	Side       string     // "RIGHT" or "LEFT" (for diff comments)
	Quote      []string   // source text of the commented lines (line-level only)
}

type ReviewResult struct {
	Comments []ReviewComment
}

type Section struct {
	ID        string     // Auto-numbered: "S1", "S1.1", "S2", etc.
	Title     string     // Heading text (without the "## " prefix)
	Level     int        // Heading level (2=##, 3=###, ...)
	Body      string     // Markdown text from heading to next heading
	Children  []*Section // Sub-sections (lower-level headings)
	Parent    *Section   // Parent section (nil for top-level)
	StartLine int        // 1-based line number of heading (0 = not set)
	EndLine   int        // 1-based line number of last body line (0 = not set)
}

type Status string

type ViewedState struct {
	Sections map[string]string `json:"sections"` // title -> content hash
}