update

Documentation

Overview

Package update does a passive, cached "is there a newer release?" check against GitHub. It is deliberately conservative for an agent-first tool: never auto-updates, never blocks a command's data path, caches results (24h) in $XDG_STATE_HOME/rivr/, and fails silently. The CLI only ever SURFACES an available upgrade (to a human, on stderr) — it never runs one.

Index

• Constants
• func Check(ctx context.Context, current string, force bool, now time.Time) (latest string, updateAvailable bool, err error)

Constants

const UpgradeHint = "go install github.com/rnwolfe/rivr/cmd/rivr@latest  (or: brew upgrade rivr)"

UpgradeHint is the command(s) a human runs to upgrade. rivr can't reliably detect the install method, so it offers both common ones.

Functions

func Check

func Check(ctx context.Context, current string, force bool, now time.Time) (latest string, updateAvailable bool, err error)

Check reports the latest release and whether it's newer than current. It uses the 24h cache unless force=true. Network/parse failures return err with updateAvailable=false (callers treat any error as "don't nag"). now is injected for testability.