engine

type Entry struct {
	SHA string
	// ShortSHA is SHA truncated to git's conventional 7-character
	// abbreviation, for compact display — text/template has no string
	// slicing of its own to derive this from SHA in a custom template.
	ShortSHA string
	// Author is the commit's plain git author name — always populated,
	// independent of AuthorRef.
	Author      string
	Type        string
	Scope       string
	Description string
	// Breaking is the commit's Conventional Commit breaking-change marker
	// (a "!" after type/scope, or a "BREAKING CHANGE:" footer) — orthogonal
	// to Type/Section, since a breaking commit still categorizes by its
	// literal type (e.g. a "feat!:" is both a Feature and breaking).
	Breaking bool
	// PR is the commit's resolved PR Reference, or nil when none was
	// found — enrichment only, never required (ADR-0001, ADR-0003).
	PR *commit.PRReference
	// AuthorRef is the commit author's linked backend account, or nil when
	// unresolved (no Backend, unsupported backend, or no linked account) —
	// enrichment only, template authors should fall back to Author.
	AuthorRef *backend.AuthorReference
	// CommitURL links to the commit on the backend's web UI. Empty when be
	// is nil (ADR-0001: enrichment only, never required for an Entry to
	// exist) — Backend.CommitURL is pure string formatting, so it's always
	// populated when a Backend is available, unlike PR which depends on a
	// live lookup succeeding.
	CommitURL string
}

type PackagePlan struct {
	Name             string
	Sections         []Section
	PreviousVersion  string
	SuggestedVersion string
	// PreviousTag/SuggestedTag are PreviousVersion/SuggestedVersion with
	// tag-format applied — the actual git tag names, not bare SemVer.
	// Empty wherever the corresponding Version field is (no previous
	// release, or no release-worthy Entries yet).
	PreviousTag  string
	SuggestedTag string
	// CompareURL links to a from/to diff between PreviousTag and
	// SuggestedTag on the backend's web UI. Empty when either tag is
	// empty, or no Backend was supplied — enrichment only, same as
	// Entry.CommitURL.
	CompareURL string
}

type Plan struct {
	Packages         []PackagePlan
	PreviousVersion  string
	SuggestedVersion string
	PreviousTag      string
	SuggestedTag     string
	CompareURL       string
	Rendered         string
}

type Section struct {
	Name    string
	Entries []Entry
}