Chio/Docs

chio runtime

Evaluate live-runtime admission artifacts on a local runtime: admit, orchestrate, weight peers, read signals, and run loopback operations.

Reference chio@5f63e6e

On this page

All command families · Global flags

chio runtime

Evaluate local live-runtime admission artifacts.

Command synopsistext
chio runtime [OPTIONS] <COMMAND>

chio runtime admit

Evaluate a runtime admission request against verifier-owned local state.

Command synopsistext
chio runtime admit [OPTIONS] --request <PATH> --admission-profile <PATH> --admission-bundle <PATH> --store <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --request <PATH> Stable request binding JSON. Required.
  • --admission-profile <PATH> Runtime admission profile JSON. Required.
  • --admission-bundle <PATH> Runtime admission bundle JSON to pin into local admission state. Required.
  • --runtime-trust-input <PATH> Signed strict runtime trust input JSON.
  • --trusted-verifiers <PATH> Caller-supplied trusted verifier keys JSON.
  • --pheromone-query-report <PATH> Signed pheromone query report to record as observe-only advice.
  • --runtime-pheromone-policy <PATH> Signed verifier-owned runtime pheromone policy JSON.
  • --runtime-peer-weights <PATH> Signed verifier-owned runtime peer weights JSON.
  • --action-class-id <ACTION_CLASS_ID> Treaty or governance action class id used for runtime policy matching.
  • --trust-floor-state <PATH> Durable trust-floor state path. Uses --store when omitted.
  • --store <PATH> Durable local admission store JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Admission evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for runtime admission report JSON. Required.

chio runtime sign-trust-input

Sign a strict runtime trust input from verifier-owned local material.

Command synopsistext
chio runtime sign-trust-input [OPTIONS] --body <PATH> --signing-seed-file <PATH> --out <PATH>
  • --body <PATH> Runtime trust input body JSON. Required.
  • --signing-seed-file <PATH> Hex-encoded 32-byte Ed25519 signing seed file. Required.
  • --out <PATH> Output path for signed runtime trust input JSON. Required.

chio runtime policy

Sign verifier-owned runtime pheromone policy material.

Command synopsistext
chio runtime policy [OPTIONS] <COMMAND>

chio runtime policy sign

Sign a runtime pheromone policy body.

Command synopsistext
chio runtime policy sign [OPTIONS] --body <PATH> --signing-seed-file <PATH> --out <PATH>
  • --body <PATH> Runtime pheromone policy body JSON. Required.
  • --signing-seed-file <PATH> Hex-encoded 32-byte Ed25519 signing seed file. Required.
  • --out <PATH> Output path for signed runtime pheromone policy JSON. Required.

chio runtime peer-weights

Sign verifier-owned runtime peer weights material.

Command synopsistext
chio runtime peer-weights [OPTIONS] <COMMAND>

chio runtime peer-weights hash

Compute the canonical hash of a runtime peer weights body.

Command synopsistext
chio runtime peer-weights hash [OPTIONS] --body <PATH> --out <PATH>
  • --body <PATH> Runtime peer weights body JSON. Required.
  • --out <PATH> Output path for the canonical hash. Required.

chio runtime peer-weights sign

Sign a runtime peer weights body.

Command synopsistext
chio runtime peer-weights sign [OPTIONS] --body <PATH> --signing-seed-file <PATH> --out <PATH>
  • --body <PATH> Runtime peer weights body JSON. Required.
  • --signing-seed-file <PATH> Hex-encoded 32-byte Ed25519 signing seed file. Required.
  • --out <PATH> Output path for signed runtime peer weights JSON. Required.

chio runtime pheromone

Evaluate runtime pheromone policy without mutating admission state.

Command synopsistext
chio runtime pheromone [OPTIONS] <COMMAND>

chio runtime pheromone sign-query-report

Sign a pheromone query report for runtime admission.

Command synopsistext
chio runtime pheromone sign-query-report [OPTIONS] --body <PATH> --signing-seed-file <PATH> --out <PATH>
  • --body <PATH> Pheromone query report body JSON. Required.
  • --signing-seed-file <PATH> Hex seed file for the verifier signing key. Required.
  • --out <PATH> Output path for signed pheromone query report JSON. Required.

chio runtime pheromone evaluate

Evaluate a signed runtime pheromone policy over a query report.

Command synopsistext
chio runtime pheromone evaluate [OPTIONS] --admission-bundle <PATH> --runtime-trust-input <PATH> --trusted-verifiers <PATH> --pheromone-query-report <PATH> --runtime-pheromone-policy <PATH> --runtime-peer-weights <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --admission-bundle <PATH> Runtime admission bundle JSON for request binding. Required.
  • --runtime-trust-input <PATH> Signed strict runtime trust input JSON. Required.
  • --trusted-verifiers <PATH> Caller-supplied trusted verifier keys JSON. Required.
  • --pheromone-query-report <PATH> Signed pheromone query report JSON. Required.
  • --runtime-pheromone-policy <PATH> Signed verifier-owned runtime pheromone policy JSON. Required.
  • --runtime-peer-weights <PATH> Signed verifier-owned runtime peer weights JSON. Required.
  • --action-class-id <ACTION_CLASS_ID> Treaty or governance action class id used for runtime policy matching.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for policy decision JSON. Required.

chio runtime orchestrate

Run production local Chio runtime orchestration checks.

Command synopsistext
chio runtime orchestrate [OPTIONS] <COMMAND>

chio runtime orchestrate lint

Validate a runtime orchestration profile.

Command synopsistext
chio runtime orchestrate lint [OPTIONS] --profile <PATH> --report <PATH>
  • --profile <PATH> Runtime orchestration profile JSON. Required.
  • --report <PATH> Output path for schema-valid status report JSON. Required.

chio runtime orchestrate plan

Build a local runtime orchestration plan.

Command synopsistext
chio runtime orchestrate plan [OPTIONS] --profile <PATH> --run-contract <PATH> --store <PATH> --evidence-dir <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --profile <PATH> Runtime orchestration profile JSON. Required.
  • --run-contract <PATH> Runtime run contract JSON. Required.
  • --store <PATH> SQLite runtime orchestration store path. Required.
  • --evidence-dir <DIR> Runtime evidence directory. Required.
  • --now-unix-ms <NOW_UNIX_MS> Plan time in Unix milliseconds. Required.
  • --report <PATH> Output path for orchestration plan JSON. Required.

chio runtime orchestrate run

Record a local runtime orchestration run from verifier-accepted evidence.

Command synopsistext
chio runtime orchestrate run [OPTIONS] --profile <PATH> --run-contract <PATH> --store <PATH> --evidence-dir <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --profile <PATH> Runtime orchestration profile JSON. Required.
  • --run-contract <PATH> Runtime run contract JSON. Required.
  • --store <PATH> SQLite runtime orchestration store path. Required.
  • --evidence-dir <DIR> Runtime evidence directory produced by run-loopback. Required.
  • --now-unix-ms <NOW_UNIX_MS> Run time in Unix milliseconds. Required.
  • --report <PATH> Output path for orchestration run report JSON. Required.

chio runtime orchestrate resume

Build a local runtime orchestration resume plan.

Command synopsistext
chio runtime orchestrate resume [OPTIONS] --profile <PATH> --resume-plan <PATH> --store <PATH> --evidence-dir <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --profile <PATH> Runtime orchestration profile JSON. Required.
  • --resume-plan <PATH> Runtime orchestration resume plan input JSON. Required.
  • --store <PATH> SQLite runtime orchestration store path. Required.
  • --evidence-dir <DIR> Runtime evidence directory. Required.
  • --now-unix-ms <NOW_UNIX_MS> Resume time in Unix milliseconds. Required.
  • --report <PATH> Output path for resolved resume plan JSON. Required.

chio runtime orchestrate status

Summarize local runtime orchestration state.

Command synopsistext
chio runtime orchestrate status [OPTIONS] --profile <PATH> --store <PATH> --evidence-dir <DIR> --report <PATH>
  • --profile <PATH> Runtime orchestration profile JSON. Required.
  • --store <PATH> SQLite runtime orchestration store path. Required.
  • --evidence-dir <DIR> Runtime evidence directory. Required.
  • --now-unix-ms <NOW_UNIX_MS> Status time in Unix milliseconds. Defaults to current wall time.
  • --report <PATH> Output path for status report JSON. Required.

chio runtime orchestrate drift

Compare repeated local runtime proof regeneration outputs.

Command synopsistext
chio runtime orchestrate drift [OPTIONS] --profile <PATH> --runs-dir <DIR> --since-unix-ms <SINCE_UNIX_MS> --until-unix-ms <UNTIL_UNIX_MS> --report <PATH>
  • --profile <PATH> Runtime orchestration profile JSON. Required.
  • --runs-dir <DIR> Directory containing per-run runtime evidence directories. Required.
  • --since-unix-ms <SINCE_UNIX_MS> Inclusive lower time bound in Unix milliseconds. Required.
  • --until-unix-ms <UNTIL_UNIX_MS> Inclusive upper time bound in Unix milliseconds. Required.
  • --report <PATH> Output path for proof drift report JSON. Required.

chio runtime ops

Run local Chio runtime operations supervision checks.

Command synopsistext
chio runtime ops [OPTIONS] <COMMAND>

chio runtime ops supervise

Supervise local runtime operations and emit aggregate status.

Command synopsistext
chio runtime ops supervise [OPTIONS] --supervisor-profile <PATH> --store <PATH> --evidence-root <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --supervisor-profile <PATH> Required.
  • --store <PATH> Required.
  • --evidence-root <DIR> Required.
  • --provider-bindings <PATH>
  • --now-unix-ms <NOW_UNIX_MS> Required.
  • --report <PATH> Required.

chio runtime ops tick

Run one bounded local scheduler tick.

Command synopsistext
chio runtime ops tick [OPTIONS] --supervisor-profile <PATH> --store <PATH> --evidence-root <DIR> --owner-id <OWNER_ID> --now-unix-ms <NOW_UNIX_MS> --max-runs <MAX_RUNS> --report <PATH>
  • --supervisor-profile <PATH> Required.
  • --store <PATH> Required.
  • --evidence-root <DIR> Required.
  • --owner-id <OWNER_ID> Required.
  • --now-unix-ms <NOW_UNIX_MS> Required.
  • --max-runs <MAX_RUNS> Required.
  • --report <PATH> Required.

chio runtime ops status

Summarize local runtime operations status.

Command synopsistext
chio runtime ops status [OPTIONS] --supervisor-profile <PATH> --store <PATH> --evidence-root <DIR> --report <PATH>
  • --supervisor-profile <PATH> Required.
  • --store <PATH> Required.
  • --evidence-root <DIR> Required.
  • --provider-bindings <PATH>
  • --now-unix-ms <NOW_UNIX_MS>
  • --report <PATH> Required.

chio runtime ops recovery-drill

Dry-run local recovery classification for a runtime run.

Command synopsistext
chio runtime ops recovery-drill [OPTIONS] --supervisor-profile <PATH> --run-id <RUN_ID> --store <PATH> --evidence-root <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --supervisor-profile <PATH> Required.
  • --run-id <RUN_ID> Required.
  • --store <PATH> Required.
  • --evidence-root <DIR> Required.
  • --now-unix-ms <NOW_UNIX_MS> Required.
  • --report <PATH> Required.

chio runtime ops evidence-health

Verify local runtime evidence sink health for one run.

Command synopsistext
chio runtime ops evidence-health [OPTIONS] --supervisor-profile <PATH> --run-id <RUN_ID> --store <PATH> --evidence-root <DIR> --report <PATH>
  • --supervisor-profile <PATH> Required.
  • --run-id <RUN_ID> Required.
  • --store <PATH> Required.
  • --evidence-root <DIR> Required.
  • --now-unix-ms <NOW_UNIX_MS>
  • --report <PATH> Required.

chio runtime ops provider-health

Verify static local provider bindings.

Command synopsistext
chio runtime ops provider-health [OPTIONS] --supervisor-profile <PATH> --provider-bindings <PATH> --report <PATH>
  • --supervisor-profile <PATH> Required.
  • --provider-bindings <PATH> Required.
  • --now-unix-ms <NOW_UNIX_MS>
  • --report <PATH> Required.

chio runtime ops retention

Plan runtime artifact retention without mutating evidence.

Command synopsistext
chio runtime ops retention [OPTIONS] <COMMAND>

chio runtime ops retention plan

Plan dry-run runtime artifact retention.

Command synopsistext
chio runtime ops retention plan [OPTIONS] --retention-profile <PATH> --store <PATH> --evidence-root <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --retention-profile <PATH> Required.
  • --store <PATH> Required.
  • --evidence-root <DIR> Required.
  • --now-unix-ms <NOW_UNIX_MS> Required.
  • --report <PATH> Required.

chio runtime run-loopback

Generate a local loopback runtime scenario report.

Command synopsistext
chio runtime run-loopback [OPTIONS] --scenario <PATH> --store-dir <PATH> --now-unix-ms <NOW_UNIX_MS> --out-dir <PATH>
  • --scenario <PATH> Runtime loopback scenario JSON. Required.
  • --static-package <PATH> Static proof package used as the parity baseline.
  • --static-report <PATH> Static verifier report used as the parity baseline.
  • --store-dir <PATH> Directory for local runtime stores. Required.
  • --now-unix-ms <NOW_UNIX_MS> Scenario evaluation time in Unix milliseconds. Required.
  • --out-dir <PATH> Output directory for generated runtime evidence. Required.

Read more in Swarms.

PreviousCLI task index