CLI command
jeden update
Transactionally install a signed Jeden release and verify the activated binary before committing it.
Exact invocation#
jeden updateInputs and options#
- Optional environment:
JEDEN_UPDATE_MANIFEST, an HTTPS or local DSSE release manifest; without it, the manifest Stado'sstado product deliver github-mirror --update-key-iddelivery put on the latest release of Jeden's GitHub repository for this platform,https://github.com/wisent-ai/jeden/releases/latest/download/jeden-<platform>.manifest.json. That repository is private, so the default answers only with a GitHub token that may read it (membership of the Wisent organization), whichjeden updatesends to Jeden's own repository alone, read fromJEDEN_UPDATE_GITHUB_TOKEN, elseGH_TOKEN; without one it answers 404, and a copy Stado installed is updated withstado product update jeden --surface cli. - Optional environment:
JEDEN_UPDATE_CHANNEL(stableby default),JEDEN_UPDATE_TARGET_TRIPLE, andJEDEN_UPDATE_TARGET.
Output and state effect#
Recovers any prior update journal, verifies the DSSE signature against the embedded channel trust root, checks target/version/digests plus SBOM and provenance, takes the programs out of the release archive (bin/jeden and bin/jeden-sandbox-helper of Stado's release archive, or a root-level jeden alone), installs them atomically as one transaction — the helper beside the target first, then jeden — runs post-health, and prints the installed version and digest. Failed health, or an update interrupted after the swap and recovered on the next run, rolls back both programs to the last-known-good ones, and removes a helper the update placed where none was installed.
Refusals and boundaries#
- A
JEDEN_UPDATE_MANIFESTthat is not Unicode is refused asJEDEN_UPDATE_MANIFEST cannot be read: <cause>; a platform no release is published for, with no manifest named, asno Jeden release is published for <triple>; name its manifest with JEDEN_UPDATE_MANIFEST; an archive holding no jeden asrelease archive holds neither jeden nor bin/jeden, and one holding a program twice or empty asrelease archive holds <program> more than onceorrelease program <program> is empty. - A channel other than
canaryorstableis refused asupdate channel "<name>" is none of canary, stable. An evidence reference whose#sha256=is not hex, or not a SHA-256 digest's length, is refused naming what it holds. Noncanonical or unsigned manifests, mismatched targets/digests/evidence, unsafe archives, downgrade/selection failures, and missing rollback material are refused too. - A copy Stado installed (its receipt
~/.stado/products/jeden/cli.jsonlists the running executable) is updated by Stado, sojeden updaterefuses to replace it, namingstado product update jeden --surface cliandstado product policy set jeden --surface cli;JEDEN_UPDATE_TARGETnames another copy to update. A receipt that cannot be read is refused with its path and cause. When a host's update rule for Jeden isnotify, a waiting update is said once on stderr when stderr is a terminal, and in the interactive prompt's status line asupdate <revision> waiting: stado product update jeden --surface cli. - A command line of the wrong form (an unknown command or option, a missing, unexpected or invalid argument, a missing confirmation) prints the error and the usage and exits
2; a refusal that retrying unchanged can help (a dependency down or not answering, a rate limit) exits69; any other refusal or failure exits1. A refusal a functionality declares ends withfix: …andcause: <operation>.<cause>, andjeden errors show <operation>lists every cause of that functionality.