releasebuild

type Artifact struct {
	// Target is the GOOS/GOARCH this artifact was built for.
	Target buildpkg.Target
	// Path is the absolute path of the published binary.
	Path string
	// ChecksumPath is the absolute path of the binary's .sha256 sidecar.
	ChecksumPath string
	// SHA256 is the binary's lowercase hex SHA-256 digest — convenient
	// for the aggregate checksums writer and any direct caller.
	SHA256 string
}

type Options struct {
	// Version is the release version (e.g. "v1.0.0" or "1.0.0"). Required.
	// The driver canonicalises the form once: every produced artifact
	// embeds the "v"-prefixed shape so the published filename matches
	// the GitHub Release tag.
	Version string
	// ProjectDir is the Dockyard repository root — the directory holding
	// go.mod. Empty means the current working directory.
	ProjectDir string
	// OutputDir is the directory release artifacts land in. Required —
	// the release workflow points at a fresh tempdir under runner.temp
	// so a re-run does not see a previous run's stale files.
	OutputDir string
	// CmdPath overrides the Go-import path of the dockyard CLI main
	// package. Defaults to "./cmd/dockyard". Tests use this to point
	// at a fixture main package.
	CmdPath string
	// Targets overrides the cross-compile matrix; empty means the RFC §14
	// DefaultMatrix (darwin/linux/windows × amd64/arm64). Tests use this
	// to narrow the matrix to the host-only target so a release dry-run
	// stays fast and CGo-free on any GitHub runner.
	Targets []buildpkg.Target
	// BinaryBase overrides the published artifact stem. Defaults to
	// "dockyard". Tests pass a unique name to keep parallel runs
	// untangled.
	BinaryBase string
	// Logger receives structured progress output. A nil Logger falls
	// back to a discarding handler so Release never panics on a missing
	// logger.
	Logger *slog.Logger
}

type Result struct {
	// Version is the canonicalised release version (always "v"-prefixed).
	Version string
	// OutputDir is the absolute path of the directory artifacts landed in.
	OutputDir string
	// Artifacts is every published binary + checksum, in matrix order.
	Artifacts []Artifact
	// ChecksumsFile is the absolute path of the aggregate checksums.txt.
	ChecksumsFile string
}

type Target = buildpkg.Target