`market order-measure`

Record what a delivery did in the world, from a named source.

Exact invocation

handtohuman market order-measure <ORDER_ID> --metric <NAME> --value <N> --source <WHO> --reference <WHERE>

Inputs and options

<ORDER_ID>

A delivered or accepted order.

--metric <NAME>

Required: what was counted, for example views.

--value <N>

The count. Negative values are refused.

--source <WHO>

Who read the number: a platform API, a person, a report. Recorded verbatim.

--reference <WHERE>

Where it can be read again: a post URL or a report id.

Output and state effect

Result

Stores the metric, value, source, reference, and timestamp under evidence.measurement, overwriting any previous measurement. This is the only input a performance bonus is computed from, and its trustworthiness is the trustworthiness of the source named beside it — we do not measure the outside world ourselves.

Serialization

Prints the resulting order as pretty-printed JSON.

Refusals

An order that is neither delivered nor accepted refuses with order <id> is <state>, so there is nothing to measure yet.
A negative value, or an empty metric, source, or reference, is refused by name.