Oko/Docs

Command reference

oko defects unordered

Lists the open defects whose recorded repair Tama's build gate cannot order after their found-in, so each can be read and corrected instead of staying counted as unrepaired.

Invocation#

Command
oko defects unordered [--json]

Inputs and options#

  • No input; --json prints an array of {id, found_in, repaired_in, parent, unreadable}: parent is the revision to name when the order was read, unreadable the cause when it could not be (each null otherwise).

Output and state effect#

  • Prints one line per defect with the repair, the found-in and the `oko defects found-in <id> --revision <parent> --reason <why>` command to run when the repair is the fix, then the count. Changes nothing.
  • A found-in written as a revision expression such as `<commit>~1` (recorded before Oko required a commit id) is listed even when git orders the repair after it: Tama's gate resolves only commit ids and counts such a defect unrepaired. Its line names the same commit written as its id.
  • A defect whose order cannot be read (a found-in that is not a commit, a revision Git does not know) is its own line, `<id> repair <revision> cannot be ordered after found-in <found-in>: <cause>`, instead of refusing the whole listing.

Refusals and safe exits#

  • Any flag other than --json is refused by name (exit 2).

CLI reference#