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)
	// DiffStaged returns the unified diff of staged (indexed, not yet
	// committed) changes, like `git diff --cached`. An empty string means
	// nothing is staged.
	DiffStaged(ctx context.Context) (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)
	// ObjectExists reports whether a git object (commit SHA) is available
	// locally without a network call — used for a best-effort fetch (skip
	// fetching what's already there, which also keeps PR review testable
	// without real git fetches).
	ObjectExists(ctx context.Context, sha string) bool
	// FetchRef runs `git fetch --no-tags <remote> <ref>` for a remote ref/SHA
	// not yet available locally (e.g. a PR head or a base commit needed for
	// a merge-base diff).
	FetchRef(ctx context.Context, remote, ref string) error
	// RemoteNames returns the configured remote names (like `git remote`),
	// one per line of git output. An empty slice with a nil error means the
	// repository has no remotes.
	RemoteNames(ctx context.Context) ([]string, error)
	// RemoteURL returns the fetch URL of the given remote (like
	// `git remote get-url <remote>`). Errors when the remote does not exist.
	RemoteURL(ctx context.Context, remote string) (string, error)
}

type TopicStat struct {
	Topic   string
	Commits int
}