version

Documentation

Index

• Constants
• func Latest(ctx context.Context) (string, error)
• func String() string
• func UpdateAvailable(latest, current string) bool
• func UpgradeHint() string

Constants

const Spec = "0.4.0"

Spec is the Agent CLI Guidelines version this tool conforms to (declared in `schema`).

Functions

func Latest

func Latest(ctx context.Context) (string, error)

Latest returns the latest released version tag (from GitHub Releases by default). Network, short timeout, **fail-silent**: returns ("", err) on any problem so a `version --check` never errors or blocks an agent loop. The release source can be overridden with VABC_RELEASES_URL (used in tests); a disallowed value is ignored.

func String

func String() string

String returns the build version, falling back to VCS build info for `go install` (which does not run ldflags).

func UpdateAvailable

func UpdateAvailable(latest, current string) bool

UpdateAvailable reports whether latest is a different release than current. Dev/source builds (current == "dev") never report an update — don't nag them.

func UpgradeHint

func UpgradeHint() string

UpgradeHint returns the recommended upgrade command for this tool. The main package lives at ./cmd/<tool> (the scaffold layout), so the install path includes /cmd/<tool> — a bare module@latest would fail for tools with no root main.