CLI command
jeden todo cancel
Withdraw exactly the work the operator selected.
Exact invocation#
jeden todo cancel <task-or-request-id> --revision <n> --reason "text" [--session <id-or-path>] [--json]Inputs and options#
- Optional
--session <id-or-path>selects a recorded session; otherwise the workspace's latest session is used.--jsonreturns 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.
--revisionmust match the latest snapshot and--reasonmust 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 <cwd> for jeden todo: … no session is recorded for <cwd> yet, fix: name one with--session <id-or-path>), exit1. A recorded last session that is gone issession-not-foundof the same functionality. - The command is read whole before any session is opened,
jeden.completion.command, exit2: 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 asjeden todo list extra(words-invalid), and a control without--reason(--textfor 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 thejeden todo listto read it again; nothing is changed. - A control is
jeden.completion.control: an unknown ID isid-unknown, naming the session's requests and tasks; completed or cancelled work is terminal (request-terminal,task-terminalwith its state) and cannot be resumed by changing its status; a task of a paused request isowner-pauseduntil the request is resumed; a blank reason isreason-blank(exit2). - 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.