Oko
Oko/Docs

Command reference

oko reflection signals list

Reads every declared signal and says what a pass would do, writing nothing.

Invocation#

Command
oko reflection signals list [--json]

Inputs and options#

  • The declarations, the defect register, the reflection queue and, for executor measures, the executor scorecard.

Output and state effect#

  • Prints {signals: [{name, measure, level, windowHours, value, crossing, unread, defect, action}], declarations, written}. value is the largest figure measured; crossing names each subject past the level; defect is the open class defect of the signal's product and shape. Oko Desktop → Defects → Factory signals shows the same reading.

Refusals and safe exits#

  • A signal whose measure cannot be read (an executor scorecard without the broker) is a row with `unreadable` and its cause; the others are still read. A subject a measure could not read (an executor whose transcript has no readable time, a reading naming no defect) is listed under `unread`, never counted as zero. An unreadable declarations file refuses with its path.

CLI reference#