cli

type DigestOptions struct {
	// Days is the size of the activity window in days (the --days flag).
	// Must be > 0.
	Days int
	// Repos, when non-empty, is the explicit repository path list (the --repos
	// flag): it replaces cfg digest.repos wholesale (§10.4). Entries are
	// trimmed, empty ones skipped, relative paths made absolute. When empty,
	// cfg.Digest.Repos is used, falling back to the current directory.
	Repos []string
}

type PRRef struct {
	BaseSHA     string
	HeadSHA     string
	HeadRef     string // head branch name, for diagnostics
	BaseRefName string // base branch name (e.g. "main") — fetched by name, more robust than a bare SHA
	URL         string // full PR URL — identifies the PR's repository for remote-name resolution
	// CrossRepo marks a PR from a fork. Not an error: `git fetch <remote>
	// pull/N/head` works for forks too, so PR review handles them
	// transparently.
	CrossRepo bool
}

type PRResolver interface {
	ResolvePR(ctx context.Context, num int) (PRRef, error)
}

type ReviewOptions struct {
	// NoCache skips the on-disk LLM response cache entirely (the --no-cache
	// flag): no lookup, no store.
	NoCache bool
	// ErrOut receives user-facing warnings (the offline-mode notice, cost-guard
	// warnings). The CLI passes its stderr; nil discards them.
	ErrOut io.Writer
}