Jeden/Docs

CLI command

jeden roadmap block

Mark an item externally blocked and record what must change outside the repository.

Exact invocation#

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

Inputs and options#

  • Required: item ID plus a positional reason or at least one --external-prerequisite. Optional evidence, revision, and JSON output.

Output and state effect#

Sets status to external_blocked, merges prerequisites, appends evidence, records a blocked event, validates, and commits a new revision.

Refusals and boundaries#

  • A missing reason and missing prerequisite are refused as roadmap block requires a reason or --external-prerequisite; unknown IDs and stale revisions are refused.
  • 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.