CLI command
jeden todo defect
Record a defect and reopen its original task for repair.
Exact invocation#
jeden todo defect <task-or-request-id> --revision <n> --reason "what failed" [--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. - The selected original task may already be complete. An explicit defect report in a conversation is also linked to its original task during independent intake.
Output and state effect#
Atomically records a task with kind defect and defectOf pointing to the original task or request. The original acceptance criteria remain, its earlier verification is cleared, and both the original result and the repair require fresh independent observations. A defect in an earlier repair points back to the same original obligation. It does not execute the repair; use todo continue. Desktop and mobile Tasks panels expose Report defect and display the original target.
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. - Reopening the original obligation is
jeden.completion.defect: an unknown target istarget-unknown, naming the session's requests and tasks; cancelled work is not reopened (task-cancelledwith the task's recorded reason,request-cancellednaming its tasks); defects that lead back to themselves aredefect-cycle, naming the chain. - A duplicate open report is
defect-open, naming the open defect task and its status. A rejected operation leaves the saved state unchanged. - An operator pause stays in force. Recording a defect does not authorize resuming paused work.
- 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.