CLI command
jeden roadmap add
Create a new validated roadmap item.
Exact invocation#
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,--priorityand--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-1upward, 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,--priorityor--summaryis refused asroadmap add requires --<name>: ...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) 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.