fluxsim accuracy
Seal a prediction before its horizon, score it against an observed readout afterwards, and publish the outcomes-only accuracy record.
Commands
| Command | What it does |
|---|---|
fluxsim accuracy register | seal a prediction before its horizon |
fluxsim accuracy score | score a registered prediction against a readout |
fluxsim accuracy record | publish one registration's outcomes-only record |
fluxsim accuracy register
Seal a PredictionRecord so it cannot be edited after the outcome is known.
Synopsis
fluxsim accuracy register [options]
Examples
# seal a prediction
fluxsim accuracy register --file prediction.json
Options
| Option | Value | Description |
|---|---|---|
--file | FILE | a PredictionRecord as JSON -- fields: prediction_id (string), run_digest (string), metric_id (string), statement (string), predicted (decimal), horizon_end (string), registered_at (string), interval_low (decimal) [optional], interval_high (decimal) [optional] (required) |
--state-dir | STATE_DIR | run-state directory (default: ./.flux) |
-j, --json | emit machine-readable JSON |
fluxsim accuracy score
Bind an ObservedReadout to a sealed prediction and record the verdict.
Synopsis
fluxsim accuracy score [options]
Examples
# score it once the outcome is known
fluxsim accuracy score --prediction-id p-1 --readout readout.json
Options
| Option | Value | Description |
|---|---|---|
--prediction-id | PREDICTION_ID | the id the prediction was registered under (required) |
--readout | READOUT | an ObservedReadout as JSON -- fields: prediction_id (string), metric_id (string), observed (decimal), sample_size (integer), basis (live-ab|historical-holdout|none), observed_at (string) (required) |
--state-dir | STATE_DIR | run-state directory (default: ./.flux) |
-j, --json | emit machine-readable JSON |
fluxsim accuracy record
Publish the outcomes-only accuracy record for everything registered at one registration timestamp.
Synopsis
fluxsim accuracy record [options]
Examples
# publish the outcomes-only record
fluxsim accuracy record --registered-at 2026-01-01T00:00:00Z --out accuracy.json
Options
| Option | Value | Description |
|---|---|---|
--registered-at | REGISTERED_AT | the registration timestamp to publish, as RFC 3339; only the predictions whose registered_at is exactly this are covered (required) |
--out | OUT | path the accuracy record is written to (required) |
--state-dir | STATE_DIR | run-state directory (default: ./.flux) |
-j, --json | emit machine-readable JSON |