Files
git.stella-ops.org/docs/features/unchecked/cli/cli-vex-consensus-commands.md

1.6 KiB

CLI VEX Consensus Commands

Module

Cli

Status

IMPLEMENTED

Description

VEX consensus workflow commands (stella vex consensus list/show/simulate/export) for querying quorum status, trust/threshold overrides, and exporting NDJSON bundles with signature verification.

Implementation Details

  • Command Group: src/Cli/StellaOps.Cli/Commands/VexCommandGroup.cs -- VEX command group including consensus subcommands
  • VEX Gate Scan: src/Cli/StellaOps.Cli/Commands/VexGateScanCommandGroup.cs -- VEX gate scan operations
  • VEX Gen: src/Cli/StellaOps.Cli/Commands/VexGenCommandGroup.cs -- VEX generation commands
  • Tests: src/Cli/__Tests/StellaOps.Cli.Tests/Commands/VexGateCommandTests.cs, VexVerifyCommandTests.cs
  • Commands:
    • stella vex consensus list -- list consensus states with quorum status
    • stella vex consensus show <cve> -- show consensus details for a CVE
    • stella vex consensus simulate --trust <level> --threshold <value> -- simulate consensus with overrides
    • stella vex consensus export --format ndjson -- export consensus bundle with signatures

E2E Test Plan

  • Run stella vex consensus list and verify consensus states with quorum indicators
  • Run stella vex consensus show CVE-2024-1234 and verify detailed consensus for a CVE
  • Run stella vex consensus simulate --trust high --threshold 0.8 and verify simulated outcome
  • Run stella vex consensus export --format ndjson --output ./consensus.ndjson and verify signed bundle
  • Verify signature verification on exported bundles
  • Verify --format json for automation