Oko/Docs

Command reference

oko claims record

Records a claim about work: a defect's repair at a revision, a pushed commit, a tool call serving its item. `oko defects repaired` records every repair this way itself, its author the session that owns the defect, and Tama's `review-push` records each commit it lets through as a `push` claim on `<repository>@<commit>` with its structural verdict.

Invocation#

Command
oko claims record --class repair|push|tool-call --subject ITEM --assertion TEXT --revision REV [--evidence TEXT] [--author SESSION] [--model M] [--provider P] [--json]

Inputs and options#

  • --class, --subject (a defect or task id, or `<repository>@<commit>`), --assertion and --revision are required; --author, --model and --provider name who made the claim and on what, so an adversarial review can be shown to come from someone else.

Output and state effect#

  • Prints `claim <id> on <subject> at <revision>`; with --json the claim with `standing` and `said`. The same class, subject and revision recorded again is the claim already kept. The register is `claims.json` beside the defect register, or the file `OKO_CLAIM_REGISTER` names.

Refusals and safe exits#

  • `oko claims record requires --class <text>` and the same for --subject, --assertion and --revision (exit 2); `<word> is not a claim class: name repair, push or tool-call`; `a claim needs <field>` for a blank value.

CLI reference#