CLI command
jeden roadmap block
Mark an item externally blocked and record what must change outside the repository.
Exact invocation#
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) 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.