Jeden/Docs

CLI command

jeden roadmap work

Activate one eligible roadmap item as the current goal, plan, todo set, and session work context.

Exact invocation#

Shell
jeden roadmap work <item-id> [--json]

Inputs and options#

  • Required: roadmap item ID. Optional: --json.

Output and state effect#

Loads the item, creates goal/plan/todos from its acceptance criteria, activates roadmap context, records a roadmap_item_started session event, and prints the new session path and todo count.

Refusals and boundaries#

  • Missing input returns Usage: roadmap work &lt;item-id&gt;.
  • Dropped or passed items are refused as not workable, and any dependency not passed refuses activation as &lt;id&gt; is blocked by unresolved dependencies: ....
  • 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.