Command reference
oko failures list
Lists the kept failed calls, each as `<id> <time> <kind> <defect <id>|owed|no defect> <command path>: <line>`; `owed` is one a later pass records.
Invocation#
oko failures list [--session S] [--product P] [--kind failed|timed-out|refused] [--defect D] [--command PATH] [--undefected] [--since TIME] [--json]Inputs and options#
- Each flag narrows the list: the session (in full or as its harness id), the product, the kind, a defect named in full or by its start, the command path, only the failures no defect holds, and the ones answered since a time.
- The register is OKO_CALL_FAILURES_REGISTER, else call-failures.json beside the defect register (`<defects>.call-failures.json` when OKO_DEFECT_REGISTER moves it); each call's whole output is kept, owner only, in the call-failures directory beside it (`oko failures location`).
Output and state effect#
- Prints one line per failure, or `no failed call selected in <register>`; --json prints the failures.
Refusals and safe exits#
- “--kind takes failed, timed-out or refused, got <word>”, a --since that is no RFC 3339 time and any other flag (exit 2).