Command reference
oko waits bottlenecks
Says where the whole fleet waits longest: every wait Stado's wait mechanism printed into the agent sessions' tool results, summed per kind, place and what was waited for, longest total first.
Invocation#
oko waits bottlenecks [--hours N] [--json]Inputs and options#
- Every live transcript on this machine is read: each `czekam` line Stado's wait mechanism printed into a tool result, paired by its id with its `koniec czekania` or `blad czekania`, as `oko sessions agents` reads them. A wait with a duration counts toward its kind, place and what it waited for; the tool call whose output carried it is kept as one of the position's commands.
- --hours N reads the last N hours; without it, everything the transcripts hold.
- For example: `oko waits bottlenecks --hours 24` names first the one operation the fleet spent most of the day waiting on, with every session and command that waited for it.
Output and state effect#
- Prints one line per position, longest first: `<seconds>s <n> waits (<failed> failed) <kind> at <where>: <what> sessions <ids>`, then `unread <transcript>: <cause>` for every transcript that could not be read; with none read in the window, `no wait was read in the transcripts of the window`.
- --json prints {since, positions: [{kind, where, what, seconds, waits, failed, sessions, commands}], unread, threshold}; `waits` and `failed` are the wait ids. The native API's stats domain answers the same to `bottlenecks {hours?}`, and Oko Desktop's Blockers → Progress shows it as Where the fleet waits.
- Each model policy pass reads the same over its progress window and records the first position whose total exceeds the declared threshold as a class defect of the product it is spent on (the first word of what it waited for, or its place, that names a product checkout), titled `The fleet waits longest on <kind> at <where>: <what>`, on the surface `oko waits bottlenecks: the fleet's longest total wait`, and assigns it to the executor that owns most open defects of that product. A position whose defect is open is not recorded again. The pass answer carries `bottleneck {first, positions, unread, defect}`.
Refusals and safe exits#
- `oko waits takes bottlenecks; got <verb>`; an unknown flag or a --hours that is not a whole number is refused naming it (exit 2).
- In the pass: with no threshold, `no bottleneck threshold is declared; oko waits bottlenecks threshold --seconds N --by SESSION declares one`; a first position naming no product checkout, `the longest wait, <kind> at <where>: <what>, names no product checkout by its first word or its place, so its owner cannot be chosen`.