content

type MarkdownProcessor struct{}

type NoOpSummarizer struct{}

type OutlineResult struct {
	Sections  []Section `json:"sections"`
	Truncated bool      `json:"truncated,omitempty"`
}

type Processor interface {
	// Name returns the processor identifier (e.g. "markdown").
	Name() string

	// CanProcess returns true if this processor handles the given path/content type.
	CanProcess(path, contentType string) bool

	// Outline extracts the heading structure from content.
	// maxDepth limits heading levels (0 = no limit).
	// maxSections caps the number of returned sections (0 = no limit).
	Outline(content string, maxDepth, maxSections int) OutlineResult

	// ReadSection extracts the content under a named heading.
	// Uses case-insensitive substring matching on heading text.
	ReadSection(content, sectionName string) (string, error)
}

type Section struct {
	Heading string `json:"heading"`
	Level   int    `json:"level"`
	Line    int    `json:"line"`       // 1-based line number
	Size    int    `json:"size_chars"` // characters in this section
}

type Summarizer interface {
	// Summarize returns a summary for the given content.
	// Returns empty string if summarization is not available.
	Summarize(ctx context.Context, domain, path, content string) (string, error)
}