stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 12 Releases Wiki Activity
Files
6bee1fdcf58fe6c2fd8dae6201f5f71eb504710f
git.stella-ops.org/docs/modules/cli/guides/commands/vex.md
StellaOps Bot 6bee1fdcf5
Some checks failed
AOC Guard CI / aoc-guard (push) Has been cancelled
Details
AOC Guard CI / aoc-verify (push) Has been cancelled
Details
Concelier Attestation Tests / attestation-tests (push) Has been cancelled
Details
Docs CI / lint-and-preview (push) Has been cancelled
Details
work
2025-11-25 08:01:23 +02:00

1.1 KiB
Raw Blame History

stella vex — Command Guide

Commands

  • stella vex consensus --query <filter> [--output json|ndjson|table] [--offline]
  • stella vex get --id <consensusId> [--offline]
  • stella vex simulate --input <vexDocs> --policy <policyConfig> [--offline]

Flags (common)

  • --offline: use cached consensus snapshots; fail with exit code 5 if remote would be hit.
  • --policy <path>: apply trust/weighting config; aggregation-only outputs.
  • --page-size, --page-token: deterministic pagination.

Inputs/outputs

  • Inputs: VEX consensus projection (VexLens); optional cached snapshots when offline.
  • Outputs: consensus states with consensus_state, confidence, weights, issuers, rationale; stable ordering.

Determinism rules

  • Sort by consensusId; pagination tokens deterministic.
  • No verdict inference beyond upstream consensus projection; CLI stays aggregation-only.

Offline/air-gap notes

  • Cached snapshots are required when --offline; otherwise exit code 5 with remediation message.
  • Trust roots for signature verification are loaded from STELLA_TRUST_ROOTS when verifying cached snapshots.