Command reference
oko defects shape-review
Inventories the source construct and same-shape siblings before a repair claim, so the executor identifies the shared mechanism instead of closing one instance.
Invocation#
oko defects shape-review <id> --revision <repository>@<commit>|home:<path>@<sha256> --mechanism TEXT --construct LITERAL [--shared-concept TEXT] [--consolidation DEFECT] [--json]Inputs and options#
- A defect with a recorded shape, its proposed main commit or verified operator home document, the changed mechanism and a literal source construct. Oko searches the commit and its parent with Git, or the current digest-bound home document itself, and enumerates same-product, same-shape defects. When more than one sibling or source path exists, name the shared-concept migration or a registered consolidation defect with part-of links from every member.
Output and state effect#
- Stores the revision, shape, mechanism, construct, sibling ids, all observed paths and paths still containing the construct at the revision (`currentPaths`). `show` and the Desktop defect card show both; the repair claim carries them for verdicts. Repeating the review at a newer revision replaces the inventory and queues the existing class task. Multiple source paths can open that mechanism task with one recorded defect; it stays ready while a private occurrence remains, even when a member is closed.
Refusals and safe exits#
- A missing shape names `oko defects shape`; a source checkout, Git search or home document read failure names the actual operation and cause. A construct with no occurrence at the commit or its parent (or in the digest-bound home document) is refused instead of recording an empty inventory. Repeated instances without --shared-concept or --consolidation are refused with the observed siblings and paths. A consolidation lacking part-of links names every missing member. Closed defects refuse a new review.