upgrade

type Asset struct {
	Name        string `json:"name"`
	DownloadURL string `json:"browser_download_url"`
	Size        int64  `json:"size"`
}

type InstallMethod int

type ManagedInstallError struct {
	Method   InstallMethod
	ExecPath string
}

type NetworkError struct {
	// Op is a short label describing the failing operation, e.g.
	// "github api" or "download <url>".
	Op  string
	Err error
}

type Options struct {
	// CurrentVersion is what the running binary reports (no leading "v").
	CurrentVersion string
	// TargetTag pins to a specific release tag like "v4.6.0". Empty
	// means "latest published release".
	TargetTag string
	// Force replaces the binary even when CurrentVersion already matches.
	Force bool
	// CheckOnly prints the comparison and exits without downloading.
	CheckOnly bool
	// IncludeMCP also swaps a sibling ezs-mcp binary if one exists in
	// the same directory.
	IncludeMCP bool
	// Confirm is called between the version check and the download.
	// Returning false aborts cleanly. nil auto-confirms.
	Confirm func(prompt string) bool
	// Logf receives progress messages, one per call, no trailing newline.
	// nil discards.
	Logf func(format string, args ...any)
}

type Release struct {
	TagName string  `json:"tag_name"`
	Assets  []Asset `json:"assets"`
}

type Result struct {
	From         string
	To           string
	Method       InstallMethod
	Updated      []string // absolute paths of binaries that were replaced
	AlreadyAtTip bool     // true when no upgrade was performed
	Cancelled    bool     // user said no at the confirm prompt
}