Command reference
oko-cli transcripts tasks-defect
Reopens a task for repair; an old acknowledgement or verdict cannot close its defect.
Invocation#
oko-cli transcripts tasks defect (<session> <number> | <task-id>) --reason TEXT [--by SESSION] [--db PATH] [--json]Inputs and options#
- <session> and <number> name the task, or <task-id> names it by identity alone; --reason says what must be repaired; --by names who reports it (default operator).
- --db overrides the index; --json prints the session’s report afterwards.
Output and state effect#
- Writes the defect beside the ledger and as a task object of kind `defect` whose `parentId` is the task it repairs, with an identity of the same shape as a task’s. The task is `not done` again with the reason “reopened by defect <id>: <reason>”, and transcripts tasks show lists the defect under its parent. A message beginning with “usterka:”, “defect:”, “regresja:” or “regression:” in the transcript reopens the newest task the same way, with the defect’s identity derived from that message.
Refusals and safe exits#
- Refuses without a task and --reason and prints the usage; “a defect requires a nonempty repair reason”; a number nobody was given refuses with “session <id> has no task #<n> to reopen”; a withdrawn task refuses with “task #<n> was withdrawn; a defect cannot restore cancelled work”; the same open reason twice refuses with “the same defect is already open for task #<n>”; a defect’s identity refuses with “task <id> is a defect, not an instruction; claims, evidence and defects are recorded on the task it repairs”.