Jeden/Docs

CLI command

jeden roadmap status

Set an item's explicit roadmap status.

Exact invocation#

Shell
jeden roadmap status <id> <status> [reason|--reason TEXT] [--external-prerequisite TEXT] [--evidence URI] [--revision N] [--json]

Inputs and options#

  • Required: item ID and one allowed status. Optional reason, prerequisites, evidence, revision, and JSON output.

Output and state effect#

Applies the selected status through the shared status mutation, records status-specific event data, validates, and commits a new revision.

Refusals and boundaries#

  • Missing values return Usage: roadmap status &lt;id&gt; &lt;status&gt;; unknown statuses list the allowed set, and external_blocked still requires a reason or prerequisite.
  • 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: &lt;operation&gt;.&lt;cause&gt;, and jeden errors show &lt;operation&gt; lists every cause of that functionality.