Jeden/Docs

CLI command

jeden todo cancel

Withdraw exactly the work the operator selected.

Exact invocation#

Shell
jeden todo cancel <task-or-request-id> --revision <n> --reason "text" [--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.
  • An original request ID controls every unfinished task it owns, including an unplanned request when model intake is unavailable. A task ID controls that task only. --revision must match the latest snapshot and --reason must explain the operator's action.

Output and state effect#

Records the operator's reason and cancellation without deleting the original request, completed evidence or other work. A cancelled request is not reported as verified implementation.

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.
  • The command is read whole before any session is opened, jeden.completion.command, exit 2: an option without its value (value-missing), a revision that is no whole number (revision-invalid), an unknown option or action (option-unknown, verb-unknown), words an action does not take, such as jeden todo list extra (words-invalid), and a control without --reason (--text for answer) and --revision (control-incomplete, naming what is left out).
  • A stale revision is jeden.completion.state.revision-changed, naming the revision the change was asked of and the one the state is at, with the jeden todo list to read it again; nothing is changed.
  • A control is jeden.completion.control: an unknown ID is id-unknown, naming the session's requests and tasks; completed or cancelled work is terminal (request-terminal, task-terminal with its state) and cannot be resumed by changing its status; a task of a paused request is owner-paused until the request is resumed; a blank reason is reason-blank (exit 2).
  • 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.