Command reference
oko tasks stages
The work of the last N hours as results, each with the stages it actually reached, and what is tied to nothing; not a count of calls.
Invocation#
oko tasks stages --hours N [--json]Inputs and options#
- --hours N, a whole number, required: the window is every session active in the last N hours, as `oko tasks --open --hours N` reads it (read-only).
- In Oko Desktop, the Tasks screen's Work stages toolbar button asks for the hours and reads the same document.
Output and state effect#
- Reads only. Each result is `{taskId, sessionId, ordinal, askedAt, said, statement, place, report, change, verdict, qualification}`: the operator message that asked for it, the task's place as `oko tasks map` gives it, the report its evidence names, and `change` for a commit evidence `<repository>@<commit>`: whether the commit exists in its checkout (null with the cause when this machine cannot tell), the remote-tracking refs that hold it (`pushed` false when none does), and Tama's admitting review rounds (`tama reviews admitted`). A stage that cannot be read carries `read: false` and why, never a stage shown as not reached. The verdict and Stado's qualification receipts are the report's own.
- `unlinked` names what is tied to nothing: `unattachedMessages` (each session's operator messages no task holds), `doneWithoutProof` (tasks settled done with no evidence) and `evidenceNamingNoCommit` (tasks whose evidence names a commit that does not exist).
Refusals and safe exits#
- `oko tasks stages requires --hours <whole number>` and `oko tasks stages: --hours takes a positive whole number, got <value>: <cause>`; every refusal of the tasks report it reads.