CLI reference / change / prioritize

stado change prioritize

Invocation

stado change prioritize [OPTIONS] --reason <REASON> <ID>

Purpose

Move a queued candidate ahead of every candidate not moved ahead (after those moved ahead before it), so the next pass takes it first; the reason, the session that moved it and when are kept beside it and shown by `status` and `list`. A candidate stacked on another that still waits and was not moved ahead is refused: move the one below first

Required inputs and options

Input or optionContract
<ID>The candidate's id, whole or a unique prefix
--reason <REASON>Why it goes before the candidates submitted before it
--jsonCommand option; required or optional as shown in the invocation.

Output and state effect

It performs the operation described above and emits its operator result on standard output or standard error. Any state change is limited to the resources and records named by the purpose and options on this page.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.