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 policies.git_tags
	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")
	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 policies.git_tags)
	SecurityTile string      // one-line status (e.g., "🛡️ ✅ **Passed** — no vulnerabilities")
	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
	Images       []ImageRow  // resolved registry image rows for availability table
	Downloads    []BinaryRow // binary/archive artifacts for downloads table
}

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
	NextTag      string
	Message      string
	CommitCount  int
	FilesChanged int
	Insertions   int
	Deletions    int
}