buildinfo

type Info struct {
	// Version is a human-readable version string. Possible shapes:
	//   "v1.2.3"           — release tag (ldflag or @v1.2.3 install)
	//   "abc1234"          — short SHA when no tag is available
	//   "abc1234 (2026-05-12)" — pseudo-version rendered from go install ...@latest
	//   "abc1234+dirty"    — built from a tree with uncommitted changes
	//   "dev"              — no metadata at all (go build -trimpath -buildvcs=false, etc.)
	Version string

	// Commit is the full or short SHA, or "unknown" if unavailable.
	Commit string

	// BuildTime is an ISO-8601 timestamp from ldflags or vcs.time, or "unknown".
	BuildTime string

	// Dirty is true when the binary was built from a working tree with
	// uncommitted edits. Callers should disable any "is my binary up to date"
	// comparison when Dirty is true — vcs.revision in that case is the parent
	// commit, not what's actually running.
	Dirty bool
}

type Inputs struct {
	LDFlagVersion   string
	LDFlagCommit    string
	LDFlagBuildTime string
	BuildInfo       *debug.BuildInfo
}