Command reference
oko reflection signals declare
Declares one factory signal: a measure over Oko's own registers, the level past which it is a finding, and the class defect it records, so a missing system is recorded before the operator has to name it.
Invocation#
oko reflection signals declare --name NAME --measure MEASURE --level FIGURE [--window-hours HOURS] --product PRODUCT --shape SHAPE --title TEXT --impact TEXT --mechanism TEXT --priority PRIORITY --by WHO [--json]Inputs and options#
- MEASURE: failed_repair_share is the share of repair claims in the window later withdrawn or standing without their completion evidence; undelivered_repairs counts open defects whose repair is older than the window and closed by no release; class_instances counts instances per product and shape; class_interventions counts supervisor interventions per shape; operator_corrections counts the corrections, refusals and frustration reflection read, per shape; executor_idle is the seconds a live executor has called its model with no tool call or commit since; executor_hung is the seconds a live executor's running model call has stood.
- Oko states no level: a reading strictly above the declared FIGURE is a finding. PRIORITY is high, medium or low and ranks the class defect a crossing records. Declarations are kept in ~/Library/Application Support/Oko/reflection-signals.json; OKO_REFLECTION_SIGNALS moves it, and beside a moved OKO_DEFECT_REGISTER it is <register>.signals.json.
Output and state effect#
- Prints the declaration with its time.
Refusals and safe exits#
- A missing flag refuses by name (`oko reflection signals declare requires --level <text>`); a level that is not a figure, a window that is not whole hours, an unknown measure (the refusal names the measures) or priority, and a name already declared refuse without writing.