Jeden/Docs

CLI command

jeden roadmap add

Create a new validated roadmap item.

Exact invocation#

Shell
jeden roadmap add <title> | --title <title> --area AREA --priority P0|P1|P2|P3 --summary TEXT [--acceptance TEXT] [--depends-on ID] [--capability ID] [--external-prerequisite TEXT] [--status STATUS] [--id ID] [--revision N] [--json]

Inputs and options#

  • Required: a positional title or --title, but not both, and --area, --priority and --summary: an item is filed under the area, priority and summary its author gives it, never under ones Jeden picks.
  • Optional: an explicit id, implementation/rationale/order text (written empty when not given), repeatable acceptance criteria numbered acceptance-1 upward, dependencies, capabilities, prerequisites, an initial status (backlog when not given), and the expected revision.

Output and state effect#

Builds the item with actor/timestamp metadata, assigns the requested ID or the one after the highest JED- number, validates the entire roadmap, atomically commits a new revision, and prints the created item or ID/revision.

Refusals and boundaries#

  • Supplying both title forms is refused; an empty title returns the exact add usage.
  • A missing --area, --priority or --summary is refused as roadmap add requires --&lt;name&gt;: ... without committing.
  • A host clock set before the Unix epoch refuses the change as the roadmap change cannot be dated: ... instead of dating it at the epoch; the same holds for status changes and attached evidence.
  • Invalid priority, status, duplicate or missing IDs/dependencies, invalid acceptance/evidence, cycles, and stale revisions are refused without committing.
  • 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.