Jeden/Docs

CLI command

jeden todo list

Read retained requests, tasks, acceptance requirements and completion evidence.

Exact invocation#

Shell
jeden todo list [--session <id-or-path>] [--json]

Inputs and options#

  • Optional --session &lt;id-or-path&gt; selects a recorded session; otherwise the workspace's latest session is used. --json returns the authoritative completion snapshot.

Output and state effect#

Prints status, revision, original requests, acceptance criteria, failed operations and verified session/event references. A task that waits on you shows Waiting on you: &lt;ask&gt; (ask &lt;ask-id&gt;; asked &lt;n&gt; times since &lt;time&gt;) and the exact jeden asks answer command, and the status reads waiting_for_operator until you answer; an answered ask stays beside the task as Asked of you and Your answer. A task asked before the register existed and not yet in it shows the jeden todo answer command instead. complete: false remains explicit when there is unplanned, pending, paused, interrupted, blocked, waiting or unverified work. Under each request it prints the time to completion: the estimate the independent intake recorded before execution beside the time so far, or, once an independent review accepted the request, the time it took and the difference, as in Time to completion: estimated 5 min · done in 1 min 45 s, 3 min 15 s under the estimate. A request not planned yet reads Time to completion: not estimated yet; Jeden records the estimate before execution, and one closed without an estimate reads Time to completion: no estimate was recorded. --json carries the same figures in timing. Reading a legacy workspace list migrates that superseded list before displaying its session-owned replacement.

Refusals and boundaries#

  • Without a selected session in a workspace that recorded none: jeden.session.find.last-session-unrecorded (finding the last session of &lt;cwd&gt; for jeden todo: … no session is recorded for &lt;cwd&gt; yet, fix: name one with --session &lt;id-or-path&gt;), exit 1. A recorded last session that is gone is session-not-found of the same functionality.
  • A broken completion state is refused as jeden.completion.state, never as an empty successful task list, naming the file and the entry: state-not-json (line and column), schema-other (a file of another schema), request-incomplete, request-duplicated, completion-unverified, task-incomplete, task-duplicated, task-orphaned (with the requests it records), task-unverified, defect-target-invalid, defect-untargeted, request-untasked, stamp-not-seconds, estimate-uncountable and due-uncountable; a path that is no session is not-a-session, a state file that is a link path-not-regular. A session written before completion.json whose legacy artifacts/todo.json cannot be imported is jeden.completion.legacy (todo-not-json, phases-missing, phase-invalid, task-textless).
  • 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.