CLI reference: sparkwing update

CLI reference: sparkwing update

Every sparkwing update command, flag, and argument, generated from the CLI's own command registry. All command groups are indexed in cli-reference.md.

sparkwing update

Update the CLI binary or this project's SDK pin

CLI is the default target; --cli selects it explicitly. --sdk selects this project's .sparkwing/go.mod pin. Targets are mutually exclusive. Both resolve the latest published GitHub release unless --version names a specific release tag.

CLI updates verify Ed25519 signatures and the release digest before atomic replacement. Verification failure is terminal. --force permits a downgrade; --override-hold crosses an operator CLI hold. Both flags are CLI-only.

SDK updates run native go get for the resolved release, then go mod tidy. Go retains its toolchain selection, module verification and dependency rules. The CLI binary and operator CLI hold are unchanged.

--check reads installed identity and release metadata without installing, running Go, changing module files or writing caches. It honors the selected target and --version. Exit 0 means current or ahead, 1 means an update is available, and 2 means unknown, diverged or a check failure. Local SDK replacements and unverified CLI provenance are reported as unknown. A check does not verify downloadable assets or promise installation will work.

Output is pretty on a terminal and NDJSON otherwise. Checks emit one update_check record; successful updates emit one update receipt. Progress and failures go to stderr. Plain checks print the status word; plain updates print the resulting version.

Flags

Examples

# Check for a newer CLI release
sparkwing update --check

# Update the CLI
sparkwing update --cli

# Check this project's SDK pin
sparkwing update --sdk --check

# Update the SDK pin
sparkwing update --sdk

# Check a specific CLI release
sparkwing update --cli --check --version v9.8.7

# Downgrade the CLI
sparkwing update --cli --version v9.7.6 --force