Command reference
oko defects list
Reads the register: every defect, or only the open, the unplanned or the unrepaired ones, optionally of one product and one owner.
Invocation#
oko defects list [--open | --unplanned | --unrepaired] [--product NAME] [--owner SESSION | --unowned] [--shape TEXT] [--category build-first] [--counts] [--json]Inputs and options#
- --open keeps defects without a verified published closure; --unplanned those without a plan; --unrepaired those without a repair revision whose declared completion measure passes on main. Old unsupported repairs become claims and remain open.
- --product, --owner, --unowned, --shape and --category narrow the selection; --category build-first keeps the items built before the rest (`oko defects category`). --counts adds per-standing counts. The native `defects` list action uses the same fields.
Output and state effect#
- Prints short id, product, standing, title and assignment. Open, claimed, verified, fixed and withdrawn are derived from the current measure, not an author's label. Standing includes measured remaining instances or the probe refusal at its revision. The final line counts unverified open defects and measured remaining class instances in the selection. `--counts --json` returns `{counts, defects}`; `--json` alone retains the array contract.
- Reads and migrates legacy unverified repairs to claims, preserving their revision and cause in notes.
Refusals and safe exits#
- A flag outside --unplanned, --unrepaired, --open, --product, --owner, --unowned, --shape, --category, --counts and --json is refused by name with exit status 2.
- `<word> is not a defect category; the category is build-first` (exit 2).