Jeden/Docs

CLI command

jeden todo defect

Record a defect and reopen its original task for repair.

Exact invocation#

Shell
jeden todo defect <task-or-request-id> --revision <n> --reason "what failed" [--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.
  • 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 &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.
  • Reopening the original obligation is jeden.completion.defect: an unknown target is target-unknown, naming the session's requests and tasks; cancelled work is not reopened (task-cancelled with the task's recorded reason, request-cancelled naming its tasks); defects that lead back to themselves are defect-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) 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.