Oko/Docs

Command reference

oko-cli transcripts tasks-verify

Judges every answered list through Brama and records, per task, whether it is done, what is still missing, or what blocks it.

Invocation#

Command
oko-cli transcripts tasks verify (--open [--hours N] | --session ID ...) [--db PATH] [--json]

Inputs and options#

  • --open selects every session this machine touched in the last N hours (default 24); --session selects one exact session and may repeat.
  • --db overrides the index; --json selects structured output.

Output and state effect#

  • For each owing session whose newest turn is an answer nobody has judged since it was written, asks the judge one question per open task: the operator’s sentence, his standing rules from every session in scope, the evidence recorded, the prompt the session answered and the session’s own answer. The judge is a model reached through Brama as the consumer oko on the route best, held to one standard: done only when the answer shows the work executed end to end and verified, with every part of the sentence and every standing rule covered; not done when it plans, promises, asks the operator anything, lists steps the agent could take itself, or shows part; blocked only for a concrete external obstacle with its exact error.
  • Records each verdict in the ledger (table task_verdicts) with the judge’s reason and the missing items, and counts consecutive not-done rounds. The report then shows `verified done by <model>: …`, `verified not done: <missing>` or `verified blocked: …` on the task; a task judged done leaves every handover; the operator’s own later word — anything typed after the verdict that is not the product’s handover — outranks it both ways. Prints the count judged and each verdict, then the sessions already judged since their newest answer and the ones that have not answered.
  • A verdict the judge garbled is quoted, recorded for nothing, and asked again next time; the other tasks of the pass still get theirs.

Refusals and safe exits#

  • Refuses without --open or --session and prints the usage; refuses before asking anything when this machine has no Brama route for the consumer oko (`stado service directory connect brama --consumer oko`), cannot read `oko-model-router#token` through Skarbiec, or holds no `oko-model-agent-auth` signing identity, naming which; a refusal from Brama itself (HTTP status and body) stops the run and exits unsuccessfully, since every remaining task would meet the same answer.

CLI reference#