Command reference
oko blockers idiotic
Lists the registered idiotic blockers — the false reasons to stop every session rediscovers — by how often they were raised, each with the fact that refutes it, so the reason an agent is about to give is read against its refutation instead of being repeated.
Invocation#
oko blockers idiotic [--hours N] [--json]Inputs and options#
- The registered shapes are build_withheld (building, compiling, testing or installing is withheld), brama_signed_out (Brama gives no judgment), gate_doing_its_job (a Tama gate refuses the edit), another_sessions_file (another session's uncommitted change is in the file), consent_already_given (waiting for consent the operator already gave in a ruling) and waiting_for_a_decision (waiting for the operator to choose).
- --hours N counts only the occurrences of the last N hours; without it every occurrence counts. --json prints the list as JSON.
Output and state effect#
- Prints every registered shape, the most raised first: its slug, what it is, how often it was raised and when last, `refuted by:` with its refutation, and the sessions that raised it. A shape nobody raised in the window is listed with zero, so the list always says what refutes each one. --json prints [{shape, name, refutation, count, sessions, lastAt}]. Reads OKO_IDIOTIC_BLOCKER_REGISTER, or idiotic-blockers.json in Oko's state directory; it changes nothing.
- The register is filled by `oko blockers record` and the blocked term of `oko tasks state`: Brama's blocker reviewer chooses between a blocker, one of the registered shapes, and another situation that is not one. A record placed in a shape is refused with `this records a blocker that is not one. It is a registered idiotic blocker, <what it is>: <refutation>` and one occurrence is counted for the recording session with what it said it blocks; when the occurrence cannot be written the refusal stands and adds `The occurrence was not counted: <cause>`.
Refusals and safe exits#
- `oko blockers idiotic --hours` given anything but a whole number (exit 2); `<register> holds an occurrence of an unregistered shape: no idiotic blocker shape is named <slug>`; the register's read refusal.