Jeden/Docs

CLI command

jeden update

Transactionally install a signed Jeden release and verify the activated binary before committing it.

Exact invocation#

Shell
jeden update

Inputs and options#

  • Optional environment: JEDEN_UPDATE_MANIFEST, an HTTPS or local DSSE release manifest; without it, the manifest Stado's stado product deliver github-mirror --update-key-id delivery 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), which jeden update sends to Jeden's own repository alone, read from JEDEN_UPDATE_GITHUB_TOKEN, else GH_TOKEN; without one it answers 404, and a copy Stado installed is updated with stado product update jeden --surface cli.
  • Optional environment: JEDEN_UPDATE_CHANNEL (stable by default), JEDEN_UPDATE_TARGET_TRIPLE, and JEDEN_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_MANIFEST that is not Unicode is refused as JEDEN_UPDATE_MANIFEST cannot be read: <cause>; a platform no release is published for, with no manifest named, as no Jeden release is published for <triple>; name its manifest with JEDEN_UPDATE_MANIFEST; an archive holding no jeden as release archive holds neither jeden nor bin/jeden, and one holding a program twice or empty as release archive holds <program> more than once or release program <program> is empty.
  • A channel other than canary or stable is refused as update 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.json lists the running executable) is updated by Stado, so jeden update refuses to replace it, naming stado product update jeden --surface cli and stado product policy set jeden --surface cli; JEDEN_UPDATE_TARGET names 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 is notify, a waiting update is said once on stderr when stderr is a terminal, and in the interactive prompt's status line as update <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) exits 69; any other refusal or failure exits 1. A refusal a functionality declares ends with fix: … and cause: <operation>.<cause>, and jeden errors show <operation> lists every cause of that functionality.