chio arena

Run adversarial scenarios against the kernel, replay the receipt bundles they write, and evolve adversaries between runs.

On this page

All command families · Global flags

chio arena

chio-arena coliseum: run scenarios, replay bundles, evolve adversaries.

Command synopsistext

chio arena [OPTIONS] <COMMAND>

Additional behavior

chio arena run scenarios/<name>.toml loads a scenario, drives the kernel via the async surface, and writes a receipt bundle byte-compatible with the replay corpus under target/arena/<scenario-id>/. chio arena replay <scenario-id> resolves the bundle directory and delegates to chio replay. chio arena evolve scenarios/<seed>.toml --generations N runs the co-evolution driver under the bounded-budget gate.

chio arena run Run a scenario file and write an arena bundle under target/arena/.
chio arena replay Replay a previously emitted arena bundle by scenario id.
chio arena evolve Run the co-evolution loop for a scenario seed.

chio arena run

Run a scenario file and write an arena bundle under target/arena/.

Command synopsistext

chio arena run [OPTIONS] <SCENARIO>

<SCENARIO> Path to the scenario TOML file. Required.
--output-root <DIR> Override the bundle output root (default target/arena/).
--matrix <PATH> Write the signed qualification matrix here.
--signing-seed-file <PATH> Seed file for the matrix signing key.
--json Emit the run summary as JSON on stdout.

Additional behavior

Given an econsim manifest, runs its six scenario classes against the validators and writes the signed chio.econsim.qualification-matrix.v1; exits nonzero on TargetMissing or any High or Critical finding.

chio arena replay

Replay a previously emitted arena bundle by scenario id.

Command synopsistext

chio arena replay [OPTIONS] <SCENARIO_ID>

<SCENARIO_ID> Scenario id to replay. Required.
--output-root <DIR> Override the bundle output root.
--bundle-dir <DIR> Resolved bundle directory (overrides --output-root plus id).
--json Emit the resolved bundle metadata as JSON.

Additional behavior

Resolves target/arena/<scenario-id>/ and delegates to the chio replay engine. Use --bundle-dir to point at a non-default bundle location.

Accepts an econsim profile id, re-runs it from its seed, and compares the matrix bytes.

chio arena evolve

Run the co-evolution loop for a scenario seed.

Command synopsistext

chio arena evolve [OPTIONS] <SEED>

<SEED> Path to the seed scenario TOML file. Required.
--generations <GENERATIONS> Number of generations to run (the bounded-budget gate clamps). Default 5.
--wall-seconds <WALL_SECONDS> Maximum wall-clock budget in seconds. Default 1800.
--output-root <DIR> Override the leaderboard output root (default target/arena/).
--json Emit the evolve summary as JSON on stdout.

Additional behavior

Accepts an econsim scenario class and breeds campaign parameters for it within the budget gate of 200 generations or 30 minutes.