gitlog

type AuthorStat struct {
	Author       string
	Commits      int
	LinesAdded   int
	LinesRemoved int
}

type Changelog struct {
	// Categories maps every CategoryOrder name to its entries (possibly
	// empty, but the key is always present — §9.4 JSON contract).
	Categories map[string][]ChangelogEntry
	// Breaking is the ordered list of breaking-change entries, duplicated
	// from their home category (§9.2).
	Breaking []ChangelogEntry
}

type ChangelogEntry struct {
	Hash     string // short (7-char) hash, per §9.4 uniform styling
	Subject  string // subject with the "type(scope)!:" prefix stripped
	Category string
	Breaking bool
	// BreakingText is the callout text used in the "⚠ BREAKING CHANGES"
	// section: the first line after "BREAKING CHANGE:" in the body, or the
	// stripped subject if the only marker was "!". Empty when !Breaking.
	BreakingText string
}

type Commit struct {
	Hash    string
	Author  string
	Date    time.Time
	Subject string
	Body    string
	Files   []FileChange
}

type Digest struct {
	Since        time.Time
	Until        time.Time
	Commits      int
	FilesChanged int
	LinesAdded   int
	LinesRemoved int
	ByAuthor     []AuthorStat
	ByTopic      []TopicStat
	TopFiles     []FileStat
}

type FileChange struct {
	// Status is the raw git status letter(s): "A", "M", "D", "R100", "C75", ...
	Status string
	// Path is the (new) path of the file.
	Path string
	// Old is the previous path for renames/copies (R/C statuses); empty otherwise.
	Old string
}

type FileStat struct {
	Path    string
	Commits int
}

type RepoResult struct {
	Path   string
	Since  time.Time
	Until  time.Time
	Digest Digest
	Err    error
}

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

type Source interface {
	// Log returns the commits in the given revision range (e.g. "HEAD~5..HEAD").
	Log(ctx context.Context, revRange string) ([]Commit, error)
	// Diff returns the unified diff text for the given revision range.
	Diff(ctx context.Context, revRange string) (string, error)
	// LatestTag returns the most recent reachable tag from HEAD (like
	// `git describe --tags --abbrev=0`). An empty string with a nil error
	// means no tags exist — a legitimate result, not a failure (see
	// docs/TECHNICAL_PLAN.md §9.5).
	LatestTag(ctx context.Context) (string, error)
	// LogSince returns the commits reachable from HEAD committed after since
	// (like `git log --since=<RFC3339>`).
	LogSince(ctx context.Context, since time.Time) ([]Commit, error)
	// DiffForCommit returns the unified diff text introduced by a single
	// commit (like `git show --format= <hash>`).
	DiffForCommit(ctx context.Context, hash string) (string, error)
}

type TopicStat struct {
	Topic   string
	Commits int
}