Chio/Docs
LOGIN · JOIN

chio pheromone

Receive, query, and relay signals, the advisory deposits agents leave to rank work, including signals that cross between partners.

Reference chio@5f63e6e

On this page

All command families · Global flags

chio pheromone

Receive, query, and relay pheromone artifacts.

Command synopsistext
chio pheromone [OPTIONS] <COMMAND>

chio pheromone receive

Verify and store a local pheromone gossip batch.

Command synopsistext
chio pheromone receive [OPTIONS] --batch <PATH> --transit-policy <PATH> --proof-package <PATH> --trust-bundle <PATH> --context <PATH> --store <PATH> --report <PATH>
  • --batch <PATH> Pheromone gossip batch JSON. Required.
  • --transit-policy <PATH> Local transit policy JSON with receiver admission material. Required.
  • --proof-package <PATH> Verified Chio proof package JSON. Required.
  • --trust-bundle <PATH> Verifier-owned Chio trust bundle JSON. Required.
  • --context <PATH> Chio verification context JSON. Required.
  • --store <PATH> SQLite store path for local pheromone state. Required.
  • --now-unix-ms <NOW_UNIX_MS> Receiver evaluation time in Unix milliseconds.
  • --report <PATH> Output path for receive report JSON. Required.

chio pheromone query

Query local pheromone concentration from a durable store.

Command synopsistext
chio pheromone query [OPTIONS] --store <PATH> --subject-class <ID> --namespace <NS> --reputation-epoch <REPUTATION_EPOCH> --peer-weights <PATH> --report <PATH>
  • --store <PATH> SQLite store path for local pheromone state. Required.
  • --subject-class <ID> Subject class id. Required.
  • --namespace <NS> Subject class namespace. Required.
  • --reputation-epoch <REPUTATION_EPOCH> Reputation epoch for advisory weighting. Required.
  • --peer-weights <PATH> Peer weights JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Query evaluation time in Unix milliseconds.
  • --report <PATH> Output path for query report JSON. Required.

chio pheromone relay

Run or inspect live pheromone relay state.

Command synopsistext
chio pheromone relay [OPTIONS] <COMMAND>

chio pheromone relay lint

Lint a relay peer directory against an operational profile.

Command synopsistext
chio pheromone relay lint [OPTIONS] --profile <PROFILE> --report <PATH>
  • --peer-directory <PATH> Raw peer directory or signed peer-directory bundle JSON.
  • --peer-directory-state <PATH> Verifier-owned active peer-directory state JSON.
  • --profile <PROFILE> Relay operational profile. Required. Values local-dev, production.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config required for production bundles.
  • --report <PATH> Output path for lint report JSON. Required.

chio pheromone relay serve

Serve signed pheromone relay HTTP endpoints.

Command synopsistext
chio pheromone relay serve [OPTIONS] --listen <ADDR> --store <PATH> --transit-policy <PATH> --proof-package <PATH> --trust-bundle <PATH> --context <PATH> --report-dir <DIR>
  • --listen <ADDR> Listen address for the relay HTTP service. Required.
  • --store <PATH> SQLite store path for runtime and relay state. Required.
  • --peer-directory <PATH> Verifier-owned peer directory JSON.
  • --peer-directory-state <PATH> Verifier-owned active peer-directory state JSON.
  • --profile <PROFILE> Relay operational profile. Default local-dev. Values local-dev, production.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config for signed bundles.
  • --transit-policy <PATH> Local transit policy JSON with receiver admission material. Required.
  • --proof-package <PATH> Verified Chio proof package JSON. Required.
  • --trust-bundle <PATH> Verifier-owned Chio trust bundle JSON. Required.
  • --context <PATH> Chio verification context JSON. Required.
  • --report-dir <DIR> Directory for per-request relay reports. Required.
  • --operator-token-env <ENV> Environment variable containing the operator token for observability endpoints.
  • --iroh-enable Mount the iroh federation-transport mesh alongside the HTTP relay (DUAL). OFF by default: with it off the serve path is byte-for-byte unchanged.
  • --iroh-transport-directory <PATH> Issuer-signed iroh transport-directory bundle JSON. Required with --iroh-enable; verified fail-closed against --trusted-issuers.
  • --iroh-transport-directory-state <PATH> Optional rotation-state pin ({ "versionFloor": N, "expectedPreviousVersionSha256": ".." }) for the transport-directory bundle. Without it only a GENESIS bundle loads (floor 0, no predecessor); a rotated successor bundle needs this to pin the rollback floor and the predecessor hash it must chain onto.
  • --iroh-transport-key <PATH> Dedicated rotatable ed25519 transport key file ({ "seedHex": ".." }), SEPARATE from the passport/relay signing key. Required with --iroh-enable.
  • --iroh-bind-addr <ADDR> Socket address the iroh endpoint binds. Default 0.0.0.0:0 (ephemeral port) is convenient for a quick DUAL trial, but a random port cannot be found by peers under the default RelayMode::Disabled. For a DURABLE deployment set a STABLE address here and pair it with a discovery mechanism / --iroh-relay-url so peers can reach a fixed EndpointId at a fixed address. The actual bound address(es) + EndpointId are logged at startup (tracing target "chio.iroh.transport"). Default 0.0.0.0:0.
  • --iroh-relay-url <URL> Self-hosted relay URL(s). Repeatable. Omitted -> RelayMode::Disabled (direct addressing; never the n0 free relays).
  • --iroh-lanes <LANES> Comma-separated iroh lanes to mount. Default: pheromone (the only lane that shares the relay receiver + store on this hook). Default pheromone.

chio pheromone relay enqueue

Queue accepted local relay work for subscribed peers.

Command synopsistext
chio pheromone relay enqueue [OPTIONS] --store <PATH> --batch <PATH> --transit-policy <PATH> --trust-bundle <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --store <PATH> SQLite store path for relay state. Required.
  • --batch <PATH> Pheromone gossip batch JSON to queue for a subscribed peer. Required.
  • --transit-policy <PATH> Local transit policy JSON used to verify non-empty relay batches. Required.
  • --trust-bundle <PATH> Verifier-owned Chio trust bundle that authorizes the signed transit policy issuer. Required.
  • --peer-directory <PATH> Verifier-owned peer directory JSON.
  • --peer-directory-state <PATH> Verifier-owned active peer-directory state JSON.
  • --profile <PROFILE> Relay operational profile. Default local-dev. Values local-dev, production.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config for signed bundles.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for enqueue report JSON. Required.

chio pheromone relay tick

Run one deterministic relay scheduler tick.

Command synopsistext
chio pheromone relay tick [OPTIONS] --store <PATH> --max-batches <MAX_BATCHES> --signing-key <PATH> --report <PATH>
  • --store <PATH> SQLite store path for relay state. Required.
  • --peer-directory <PATH> Verifier-owned peer directory JSON.
  • --peer-directory-state <PATH> Verifier-owned active peer-directory state JSON.
  • --profile <PROFILE> Relay operational profile. Default local-dev. Values local-dev, production.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config for signed bundles.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Defaults to the local clock.
  • --max-batches <MAX_BATCHES> Maximum batches to lease this tick. Required.
  • --signing-key <PATH> Local relay signing key JSON for the sender kernel. Required.
  • --report <PATH> Output path for tick report JSON. Required.
  • --report-dir <DIR> Directory for bounded outbound delivery event reports.
  • --iroh-enable Drain due batches over the iroh federation transport INSTEAD of HTTP for this tick (DUAL). OFF by default: with it off the tick delivers over HTTP exactly as before. A single tick drains over exactly one transport (an iroh tick and an HTTP tick would both lease the same outbox rows).
  • --iroh-transport-directory <PATH> Issuer-signed iroh transport-directory bundle JSON. Required with --iroh-enable; verified fail-closed against --trusted-issuers. Supplies the recipient kernel_id -> transport EndpointId resolution the drain dials.
  • --iroh-transport-directory-state <PATH> Optional rotation-state pin ({ "versionFloor": N, "expectedPreviousVersionSha256": ".." }) for the transport-directory bundle. Without it only a GENESIS bundle loads (floor 0, no predecessor); a rotated successor bundle needs this to pin the rollback floor and the predecessor hash it must chain onto.
  • --iroh-transport-key <PATH> Dedicated rotatable ed25519 transport key file ({ "seedHex": ".." }), SEPARATE from the passport/relay signing key. Required with --iroh-enable.
  • --iroh-bind-addr <ADDR> Socket address the outbound iroh endpoint binds. Default 0.0.0.0:0 (ephemeral port); the drain only dials, so an ephemeral local port is fine. Default 0.0.0.0:0.
  • --iroh-relay-url <URL> Self-hosted relay URL(s). Repeatable. Omitted -> RelayMode::Disabled (direct addressing; never the n0 free relays).
  • --iroh-peer-addr <KERNEL_ID=HOST:PORT> Direct dialable socket address(es) for a recipient in the relay-disabled / direct-address deployment, as KERNEL_ID=HOST:PORT. Repeatable; repeat the same KERNEL_ID to add multiple sockets. The verified transport directory binds kernel_id -> transport EndpointId but carries NO socket address, so without discovery / --iroh-relay-url the drain cannot reach a peer known only by EndpointId + socket. Each entry threads its socket(s) onto the resolved EndpointId so the drain dials directly. The EndpointId binding still comes from the verified directory and iroh authenticates it at the handshake, so a wrong/hostile socket cannot redirect delivery to an unauthorized peer.
  • --iroh-lanes <LANES> Comma-separated iroh lanes to drain. Default: pheromone (the only outbound lane on this hook). Default pheromone.

chio pheromone relay catchup

Request bounded catch-up metadata from local relay state.

Command synopsistext
chio pheromone relay catchup [OPTIONS] --store <PATH> --peer <ID> --peer-directory-state <PATH> --treaty <ID> --after-cursor <CURSOR> --limit <LIMIT> --report <PATH>
  • --store <PATH> SQLite store path for relay state. Required.
  • --peer <ID> Peer kernel id requesting catch-up. Required.
  • --peer-directory-state <PATH> Verifier-owned active peer-directory state JSON. Required.
  • --profile <PROFILE> Relay operational profile for state validation. Default local-dev. Values local-dev, production.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config for signed active state.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds.
  • --treaty <ID> Treaty id for the catch-up window. Required.
  • --after-cursor <CURSOR> Cursor after which frames are requested. Required.
  • --limit <LIMIT> Maximum frames to return. Required.
  • --report <PATH> Output path for catch-up report JSON. Required.

chio pheromone relay status

Write local relay operator status.

Command synopsistext
chio pheromone relay status [OPTIONS] --store <PATH> --report <PATH>
  • --store <PATH> SQLite store path for relay state. Required.
  • --report <PATH> Output path for status report JSON. Required.

chio pheromone relay observe

Write the relay observability report from durable local evidence.

Command synopsistext
chio pheromone relay observe [OPTIONS] --store <PATH> --peer-directory-state <PATH> --profile <PROFILE> --trusted-issuers <PATH> --report-dir <DIR> --report <PATH>
  • --store <PATH> SQLite store path for relay state. Required.
  • --peer-directory-state <PATH> Verifier-owned active peer-directory state JSON. Required.
  • --profile <PROFILE> Relay operational profile. Required. Values local-dev, production.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config for signed active state. Required.
  • --report-dir <DIR> Directory containing bounded relay event reports. Required.
  • --limit <LIMIT> Maximum recent failure codes to include. Default 25.
  • --report <PATH> Output path for observability report JSON. Required.

chio pheromone relay metrics

Export relay metrics from durable local state.

Command synopsistext
chio pheromone relay metrics [OPTIONS] --store <PATH> --output <PATH>
  • --store <PATH> SQLite store path for relay state. Required.
  • --format <relay_metrics_format> Output encoding for relay metrics. Default prometheus. Values prometheus, json.
  • --output <PATH> Output path for relay metrics. Required.

chio pheromone relay alert

Evaluate relay alert routing from canonical observability artifacts.

Command synopsistext
chio pheromone relay alert [OPTIONS] <COMMAND>

chio pheromone relay alert evaluate

Evaluate routeable relay alerts from current observability.

Command synopsistext
chio pheromone relay alert evaluate [OPTIONS] --observability-report <PATH> --event-dir <DIR> --routing-profile <PATH> --suppression-state <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --observability-report <PATH> Canonical relay observability report JSON. Required.
  • --event-dir <DIR> Directory containing bounded relay event reports. Required.
  • --routing-profile <PATH> Relay alert routing profile JSON. Required.
  • --suppression-state <PATH> Relay alert suppression state JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert report JSON. Required.

chio pheromone relay alert handoff

Dry-run downstream relay alert handoff readiness.

Command synopsistext
chio pheromone relay alert handoff [OPTIONS] --alert-report <PATH> --trend-report <PATH> --routing-profile <PATH> --handoff-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --alert-report <PATH> Relay alert report JSON. Required.
  • --trend-report <PATH> Relay trend report JSON. Required.
  • --routing-profile <PATH> Relay alert routing profile JSON. Required.
  • --handoff-profile <PATH> Relay alert handoff profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert handoff report JSON. Required.

chio pheromone relay alert normalize

Normalize local downstream alert exports into Chio delivery evidence.

Command synopsistext
chio pheromone relay alert normalize [OPTIONS] --profile <PATH> --input-dir <DIR> --now-unix-ms <NOW_UNIX_MS> --out-dir <DIR> --report <PATH>
  • --profile <PATH> Relay alert normalization profile JSON. Required.
  • --input-dir <DIR> Directory containing local downstream alert export JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --out-dir <DIR> Directory for canonical Chio delivery evidence JSON. Required.
  • --report <PATH> Output path for relay alert normalization report JSON. Required.

chio pheromone relay alert delivery

Import downstream delivery, acknowledgement, or drift evidence.

Command synopsistext
chio pheromone relay alert delivery [OPTIONS] <COMMAND>

chio pheromone relay alert delivery import

Import local downstream delivery-result artifacts.

Command synopsistext
chio pheromone relay alert delivery import [OPTIONS] --handoff-report <PATH> --delivery-profile <PATH> --evidence-dir <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --handoff-report <PATH> Relay alert handoff report JSON. Required.
  • --delivery-profile <PATH> Relay alert delivery profile JSON. Required.
  • --evidence-dir <DIR> Directory containing local downstream delivery evidence JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert delivery report JSON. Required.

chio pheromone relay alert delivery acknowledge

Summarize downstream acknowledgement evidence from a delivery report.

Command synopsistext
chio pheromone relay alert delivery acknowledge [OPTIONS] --handoff-report <PATH> --delivery-report <PATH> --delivery-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --handoff-report <PATH> Relay alert handoff report JSON. Required.
  • --delivery-report <PATH> Relay alert delivery report JSON. Required.
  • --delivery-profile <PATH> Relay alert delivery profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert acknowledgement report JSON. Required.

chio pheromone relay alert delivery drift

Compare handoff and delivery report directories for bounded drift.

Command synopsistext
chio pheromone relay alert delivery drift [OPTIONS] --handoff-reports-dir <DIR> --delivery-reports-dir <DIR> --delivery-profile <PATH> --since-unix-ms <SINCE_UNIX_MS> --until-unix-ms <UNTIL_UNIX_MS> --report <PATH>
  • --handoff-reports-dir <DIR> Directory containing relay alert handoff reports. Required.
  • --delivery-reports-dir <DIR> Directory containing relay alert delivery reports. Required.
  • --delivery-profile <PATH> Relay alert delivery profile JSON. Required.
  • --since-unix-ms <SINCE_UNIX_MS> Lower bound in Unix milliseconds. Required.
  • --until-unix-ms <UNTIL_UNIX_MS> Upper bound in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert handoff drift report JSON. Required.

chio pheromone relay alert delivery drift-window

Compare handoff and delivery report directories with source-bound delivery drift.

Command synopsistext
chio pheromone relay alert delivery drift-window [OPTIONS] --handoff-reports-dir <DIR> --delivery-reports-dir <DIR> --delivery-profile <PATH> --since-unix-ms <SINCE_UNIX_MS> --until-unix-ms <UNTIL_UNIX_MS> --report <PATH>
  • --handoff-reports-dir <DIR> Directory containing relay alert handoff reports. Required.
  • --delivery-reports-dir <DIR> Directory containing relay alert delivery reports. Required.
  • --delivery-profile <PATH> Relay alert delivery profile JSON. Required.
  • --since-unix-ms <SINCE_UNIX_MS> Lower bound in Unix milliseconds. Required.
  • --until-unix-ms <UNTIL_UNIX_MS> Upper bound in Unix milliseconds. Required.
  • --report <PATH> Output path for source-bound relay alert delivery drift report JSON. Required.

chio pheromone relay alert review

Generate route-owner review evidence.

Command synopsistext
chio pheromone relay alert review [OPTIONS] --handoff-report <PATH> --delivery-report <PATH> --acknowledgement-report <PATH> --drift-report <PATH> --route-owner-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --handoff-report <PATH> Relay alert handoff report JSON. Required.
  • --delivery-report <PATH> Relay alert delivery report JSON. Required.
  • --acknowledgement-report <PATH> Relay alert acknowledgement report JSON. Required.
  • --drift-report <PATH> Relay alert delivery drift report JSON. Required.
  • --route-owner-profile <PATH> Relay alert route-owner profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert route review packet JSON. Required.

chio pheromone relay alert assurance

Build relay alert assurance packages.

Command synopsistext
chio pheromone relay alert assurance [OPTIONS] <COMMAND>

chio pheromone relay alert assurance package

Bind alert evidence into one operator-safe assurance package.

Command synopsistext
chio pheromone relay alert assurance package [OPTIONS] --alert-report <PATH> --trend-report <PATH> --handoff-report <PATH> --normalization-report <PATH> --delivery-report <PATH> --acknowledgement-report <PATH> --drift-report <PATH> --review-packet <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --alert-report <PATH> Relay alert report JSON. Required.
  • --trend-report <PATH> Relay trend report JSON. Required.
  • --handoff-report <PATH> Relay alert handoff report JSON. Required.
  • --normalization-report <PATH> Relay alert normalization report JSON. Required.
  • --delivery-report <PATH> Relay alert delivery report JSON. Required.
  • --acknowledgement-report <PATH> Relay alert acknowledgement report JSON. Required.
  • --drift-report <PATH> Source-bound relay alert delivery drift report JSON. Required.
  • --review-packet <PATH> Relay alert route review packet JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance package JSON. Required.

chio pheromone relay alert assurance export

Export signed local alert assurance evidence.

Command synopsistext
chio pheromone relay alert assurance export [OPTIONS] --package <PATH> --alert-report <PATH> --trend-report <PATH> --handoff-report <PATH> --normalization-report <PATH> --delivery-report <PATH> --acknowledgement-report <PATH> --drift-report <PATH> --review-packet <PATH> --retention-profile <PATH> --signing-key <PATH> --now-unix-ms <NOW_UNIX_MS> --out-dir <DIR> --report <PATH>
  • --package <PATH> Relay alert assurance package JSON. Required.
  • --alert-report <PATH> Relay alert report JSON. Required.
  • --trend-report <PATH> Relay trend report JSON. Required.
  • --handoff-report <PATH> Relay alert handoff report JSON. Required.
  • --normalization-report <PATH> Relay alert normalization report JSON. Required.
  • --delivery-report <PATH> Relay alert delivery report JSON. Required.
  • --acknowledgement-report <PATH> Relay alert acknowledgement report JSON. Required.
  • --drift-report <PATH> Source-bound relay alert delivery drift report JSON. Required.
  • --review-packet <PATH> Relay alert route review packet JSON. Required.
  • --retention-profile <PATH> Relay alert assurance retention profile JSON. Required.
  • --signing-key <PATH> Local relay export signing key JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --out-dir <DIR> Output bundle directory. Required.
  • --report <PATH> Output path for relay alert assurance export report JSON. Required.

chio pheromone relay alert assurance verify

Verify a signed local alert assurance export bundle.

Command synopsistext
chio pheromone relay alert assurance verify [OPTIONS] --bundle-dir <DIR> --trusted-exporters <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --bundle-dir <DIR> Export bundle directory. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance export report JSON. Required.

chio pheromone relay alert assurance replay

Replay a signed local alert assurance export bundle.

Command synopsistext
chio pheromone relay alert assurance replay [OPTIONS] --bundle-dir <DIR> --trusted-exporters <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --bundle-dir <DIR> Export bundle directory. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance replay report JSON. Required.

chio pheromone relay alert assurance retention

Plan retention for signed local alert assurance export bundles.

Command synopsistext
chio pheromone relay alert assurance retention [OPTIONS] <COMMAND>

chio pheromone relay alert assurance retention plan

Plan retention over local export bundle directories without deleting evidence.

Command synopsistext
chio pheromone relay alert assurance retention plan [OPTIONS] --bundle-root <DIR> --retention-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --bundle-root <DIR> Directory containing export bundle directories. Required.
  • --retention-profile <PATH> Relay alert assurance retention profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance retention report JSON. Required.

chio pheromone relay alert assurance retention handoff

Review local-only retention handoff readiness evidence.

Command synopsistext
chio pheromone relay alert assurance retention handoff [OPTIONS] <COMMAND>

chio pheromone relay alert assurance retention handoff review

Review local evidence that is ready for external retention handoff.

Command synopsistext
chio pheromone relay alert assurance retention handoff review [OPTIONS] --evidence <PATH> --profile <PATH> --package-report <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --evidence <PATH> Retention handoff evidence JSON. Required.
  • --profile <PATH> Retention handoff profile JSON. Required.
  • --package-report <PATH> Expected archive package report JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for retention handoff report JSON. Required.

chio pheromone relay alert assurance retention external-review

Review local evidence for operator-managed external retention readiness.

Command synopsistext
chio pheromone relay alert assurance retention external-review [OPTIONS] --package-dir <DIR> --source-report-dir <DIR> --trusted-packagers <PATH> --trusted-exporters <PATH> --profile <PATH> --since-unix-ms <SINCE_UNIX_MS> --until-unix-ms <UNTIL_UNIX_MS> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --package-dir <DIR> Directory containing archive packages or archive package report JSON files. Required.
  • --source-report-dir <DIR> Directory containing source archive, closeout, restore, physical, and handoff reports. Required.
  • --trusted-packagers <PATH> Trusted archive packager profile JSON. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --profile <PATH> External retention review profile JSON. Required.
  • --since-unix-ms <SINCE_UNIX_MS> Start of review window in Unix milliseconds. Required.
  • --until-unix-ms <UNTIL_UNIX_MS> End of review window in Unix milliseconds. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for external retention review report JSON. Required.

chio pheromone relay alert assurance recovery-drill

Run offline recovery drills against an export bundle.

Command synopsistext
chio pheromone relay alert assurance recovery-drill [OPTIONS] --bundle-dir <DIR> --trusted-exporters <PATH> --case <ID> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --bundle-dir <DIR> Export bundle directory. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --case <ID> Recovery case id or all. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance recovery drill report JSON. Required.

chio pheromone relay alert assurance archive

Plan verifier-owned archive lifecycle over signed export bundles.

Command synopsistext
chio pheromone relay alert assurance archive [OPTIONS] <COMMAND>

chio pheromone relay alert assurance archive plan

Plan archive lifecycle over local export bundle directories without moving evidence.

Command synopsistext
chio pheromone relay alert assurance archive plan [OPTIONS] --bundle-root <DIR> --trusted-exporters <PATH> --archive-profile <PATH> --retention-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --bundle-root <DIR> Directory containing export bundle directories. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --archive-profile <PATH> Relay alert assurance archive profile JSON. Required.
  • --retention-profile <PATH> Relay alert assurance retention profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance archive report JSON. Required.

chio pheromone relay alert assurance archive package

Create, verify, or safely extract signed archive packages.

Command synopsistext
chio pheromone relay alert assurance archive package [OPTIONS] <COMMAND>

chio pheromone relay alert assurance archive package create

Create a signed local tar.gz archive package from export bundles.

Command synopsistext
chio pheromone relay alert assurance archive package create [OPTIONS] --bundle-root <DIR> --trusted-exporters <PATH> --archive-report <PATH> --closeout-report <PATH> --signing-key <PATH> --package-id <ID> --now-unix-ms <NOW_UNIX_MS> --out <PATH> --report <PATH>
  • --bundle-root <DIR> Directory containing export bundle directories. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --archive-report <PATH> Source archive report JSON. Required.
  • --closeout-report <PATH> Source closeout report JSON. Required.
  • --signing-key <PATH> Local relay archive packager signing key JSON. Required.
  • --package-id <ID> Archive package id. Required.
  • --packager-key-id <PACKAGER_KEY_ID> Archive packager key id. Default default.
  • --package-generation <PACKAGE_GENERATION> Archive package generation. Default 1.
  • --previous-package-report <PATH> Previous archive package report JSON. Required when generation is greater than 1.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --out <PATH> Output tar.gz package path. Required.
  • --report <PATH> Output path for archive package report JSON. Required.

chio pheromone relay alert assurance archive package verify

Verify a signed local tar.gz archive package without extracting it.

Command synopsistext
chio pheromone relay alert assurance archive package verify [OPTIONS] --package <PATH> --trusted-packagers <PATH> --trusted-exporters <PATH> --archive-report <PATH> --closeout-report <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --package <PATH> Archive package tar.gz path. Required.
  • --trusted-packagers <PATH> Trusted archive packager profile JSON. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --archive-report <PATH> Source archive report JSON. Required.
  • --closeout-report <PATH> Source closeout report JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for archive package report JSON. Required.

chio pheromone relay alert assurance archive package extract

Verify then safely extract a signed archive package into a new path.

Command synopsistext
chio pheromone relay alert assurance archive package extract [OPTIONS] --package <PATH> --trusted-packagers <PATH> --trusted-exporters <PATH> --archive-report <PATH> --closeout-report <PATH> --out-dir <DIR> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --package <PATH> Archive package tar.gz path. Required.
  • --trusted-packagers <PATH> Trusted archive packager profile JSON. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --archive-report <PATH> Source archive report JSON. Required.
  • --closeout-report <PATH> Source closeout report JSON. Required.
  • --out-dir <DIR> Fresh output directory. The path must not exist. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for archive extraction report JSON. Required.

chio pheromone relay alert assurance archive physical-drill

Review operator-managed physical archive readback evidence.

Command synopsistext
chio pheromone relay alert assurance archive physical-drill [OPTIONS] <COMMAND>

chio pheromone relay alert assurance archive physical-drill review

Review local physical archive readback evidence without media claims.

Command synopsistext
chio pheromone relay alert assurance archive physical-drill review [OPTIONS] --evidence <PATH> --package-report <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --evidence <PATH> Physical archive evidence JSON. Required.
  • --package-report <PATH> Expected archive package report JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for physical archive drill report JSON. Required.

chio pheromone relay alert assurance archive restore-drill

Review multi-generation archive package restore evidence.

Command synopsistext
chio pheromone relay alert assurance archive restore-drill [OPTIONS] <COMMAND>

chio pheromone relay alert assurance archive restore-drill review

Review local archive package generations and readback evidence.

Command synopsistext
chio pheromone relay alert assurance archive restore-drill review [OPTIONS] --package-dir <DIR> --source-report-dir <DIR> --trusted-packagers <PATH> --trusted-exporters <PATH> --restore-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --package-dir <DIR> Directory containing archive package report JSON files. Required.
  • --source-report-dir <DIR> Directory containing physical drill and retention handoff reports. Required.
  • --trusted-packagers <PATH> Trusted archive packager profile JSON. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --restore-profile <PATH> Archive restore profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for archive restore drill report JSON. Required.

chio pheromone relay alert assurance closeout

Review signed export bundles for operator-managed closeout.

Command synopsistext
chio pheromone relay alert assurance closeout [OPTIONS] <COMMAND>

chio pheromone relay alert assurance closeout review

Review local export bundle directories for operator-managed closeout.

Command synopsistext
chio pheromone relay alert assurance closeout review [OPTIONS] --bundle-root <DIR> --trusted-exporters <PATH> --closeout-profile <PATH> --retention-profile <PATH> --now-unix-ms <NOW_UNIX_MS> --report <PATH>
  • --bundle-root <DIR> Directory containing export bundle directories. Required.
  • --trusted-exporters <PATH> Trusted exporter profile JSON. Required.
  • --closeout-profile <PATH> Relay alert assurance closeout profile JSON. Required.
  • --retention-profile <PATH> Relay alert assurance retention profile JSON. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds. Required.
  • --report <PATH> Output path for relay alert assurance closeout report JSON. Required.

chio pheromone relay trend

Aggregate long-horizon relay operations trends from report artifacts.

Command synopsistext
chio pheromone relay trend [OPTIONS] --reports-dir <DIR> --event-dir <DIR> --routing-profile <PATH> --since-unix-ms <SINCE_UNIX_MS> --until-unix-ms <UNTIL_UNIX_MS> --report <PATH>
  • --reports-dir <DIR> Directory containing relay observability reports. Required.
  • --event-dir <DIR> Directory containing bounded relay event reports. Required.
  • --routing-profile <PATH> Relay alert routing profile JSON. Required.
  • --since-unix-ms <SINCE_UNIX_MS> Lower bound in Unix milliseconds. Required.
  • --until-unix-ms <UNTIL_UNIX_MS> Upper bound in Unix milliseconds. Required.
  • --report <PATH> Output path for relay trend report JSON. Required.

chio pheromone relay directory

Inspect, promote, or reject verifier-owned relay peer-directory state.

Command synopsistext
chio pheromone relay directory [OPTIONS] <COMMAND>

chio pheromone relay directory inspect

Inspect active peer-directory state.

Command synopsistext
chio pheromone relay directory inspect [OPTIONS] --state <PATH> --report <PATH>
  • --state <PATH> Peer-directory state JSON. Required.
  • --report <PATH> Output path for inspection report JSON. Required.

chio pheromone relay directory promote

Promote a signed peer-directory candidate into active state.

Command synopsistext
chio pheromone relay directory promote [OPTIONS] --state <PATH> --candidate <PATH> --trusted-issuers <PATH> --profile <PROFILE> --report <PATH>
  • --state <PATH> Peer-directory state JSON to update. Required.
  • --candidate <PATH> Signed peer-directory bundle candidate JSON. Required.
  • --trusted-issuers <PATH> Trusted peer-directory issuer config. Required.
  • --profile <PROFILE> Relay operational profile. Required. Values local-dev, production.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds.
  • --report <PATH> Output path for rotation report JSON. Required.

chio pheromone relay directory reject

Reject a signed peer-directory candidate without changing active state.

Command synopsistext
chio pheromone relay directory reject [OPTIONS] --state <PATH> --candidate <PATH> --reason <CODE> --report <PATH>
  • --state <PATH> Peer-directory state JSON to update. Required.
  • --candidate <PATH> Signed peer-directory bundle candidate JSON. Required.
  • --reason <CODE> Stable rejection reason code. Required.
  • --now-unix-ms <NOW_UNIX_MS> Evaluation time in Unix milliseconds.
  • --report <PATH> Output path for rotation report JSON. Required.

chio pheromone relay supervisor

Validate local relay supervisor deployment profiles.

Command synopsistext
chio pheromone relay supervisor [OPTIONS] <COMMAND>

chio pheromone relay supervisor lint

Lint a relay supervisor deployment profile.

Command synopsistext
chio pheromone relay supervisor lint [OPTIONS] --profile <PATH> --report <PATH>
  • --profile <PATH> Relay supervisor profile JSON. Required.
  • --report <PATH> Output path for drill report JSON. Required.

Read more in Signals between agents.

PreviousCLI task index