release

type BinaryRow struct {
	Name     string // filename (e.g., "stagefreight-linux-amd64.tar.gz")
	Platform string // "linux/amd64", "darwin/arm64"
	Size     int64  // bytes
	SHA256   string // hex-encoded checksum
}

type BuildTagPlanOptions struct {
	ExplicitVersion string
	BumpKind        string // patch | minor | major
	TargetRef       string // default HEAD
	FromRef         string // optional previous boundary override
	MessageOverride string
	TagPatterns     []string // from versioning.tag_sources
	Glossary        config.GlossaryConfig
	Presentation    config.TagPresentation
}

type Commit struct {
	Hash     string
	Type     string // feat, fix, chore, etc.
	Scope    string // optional scope in parens
	Summary  string
	Body     string
	Author   string
	Breaking bool
}

type CommitCategory struct {
	Title   string // display title (e.g., "Features", "Bug Fixes")
	Prefix  string // conventional commit prefix (e.g., "feat", "fix")
	Commits []Commit
}

type ImageRow struct {
	RegistryLabel string        // human label (e.g., "Docker Hub")
	RegistryURL   string        // provider-derived repo page URL
	ImageRef      string        // full image ref (e.g., "docker.io/prplanit/stagefreight")
	Label         string        // optional human group label (build.label); empty → group header is the image name
	Tags          []ResolvedTag // resolved tags with URLs
	DigestRef     string        // host/path@sha256:... (for pull command)
	SBOM          string        // pull ref for SBOM artifact
	Provenance    string        // pull ref for provenance artifact
	Signature     string        // pull ref for signature artifact
}

type NotesInput struct {
	RepoDir      string         // git repository directory
	FromRef      string         // start ref (empty = auto-detect previous tag)
	ToRef        string         // end ref (default: HEAD)
	TagPatterns  []string       // regex patterns for release tags (from versioning.tag_sources)
	Config       *config.Config // config for auto-detect version (nil = skip auto-detect)
	SecurityTile string         // one-line status (e.g., "✅ **Passed** — no vulnerabilities")
	// ChangesLimit and ChangelogLimit bound the sections built from commit lists, in
	// characters; 0 is unbounded. Bounding here is what keeps a composed body inside
	// every forge's release-body cap without any forge knowing about it.
	ChangesLimit   int
	ChangelogLimit int
	SecurityBody   string                      // full section: status line + optional <details> CVE block
	TagMessage     string                      // annotated tag message (optional, auto-detected if empty)
	ProjectName    string                      // project name (auto-detected if empty)
	Version        string                      // version string (auto-detected if empty)
	SHA            string                      // short commit hash (auto-detected if empty)
	IsPrerelease   bool                        // true if version has prerelease suffix
	ReleaseType    string                      // resolved semantic type label (latest/prerelease/stable); overrides IsPrerelease for the "Release type:" line
	Images         []ImageRow                  // resolved registry image rows for availability table
	Downloads      []BinaryRow                 // binary/archive artifacts for downloads table
	Verify         *trustdisclosure.Disclosure // signing/verification disclosure (nil = nothing signed)

	// NotesBody is the release-notes stencil body composing this document —
	// resolved by the caller from the release target's notes: reference.
	// Empty = SF's shipped default body.
	NotesBody string

	// ResolveStencil renders a declared stencil by id for body embeds beyond the
	// release elements — text compositions, AI stencils, whatever the author
	// chose. The release elements are passed through so an embedded stencil (an
	// AI reword of {release.changes}, say) can ingest them. Supplied by the
	// caller (the stencil library lives in config); nil leaves non-release
	// tokens literal.
	ResolveStencil func(id string, elements map[string]string) (string, bool)
}

type ProcessedCommit struct {
	Raw      Commit // original parsed commit
	Type     string // canonical type (after alias resolution)
	Priority int    // from glossary + breaking boost
	Breaking bool   // from any detection method
	Summary  string // sanitized + rewritten summary
	Included bool   // passes release_visible filter
}

type ResolvedTag struct {
	Name string // e.g., "1.0.0"
	URL  string // provider-derived tag page URL
}

type TagPlan struct {
	PreviousTag string
	TargetRef   string
	TargetSHA   string
	// SkippedTipSHA is the original tip commit when it was a [skip ci] commit and the
	// tag was walked back to a releasable ancestor (TargetSHA). Empty when the tip was
	// already releasable. Surfaced so the CLI can narrate the substitution.
	SkippedTipSHA string
	NextTag       string
	Message       string
	CommitCount   int
	FilesChanged  int
	Insertions    int
	Deletions     int
}