39 lines
2.1 KiB
Markdown
39 lines
2.1 KiB
Markdown
# CLI VEX Consensus Commands
|
|
|
|
## Module
|
|
Cli
|
|
|
|
## Status
|
|
VERIFIED
|
|
|
|
## 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
|
|
|
|
## Verification
|
|
|
|
- **Verified**: 2026-02-13T15:30:00Z
|
|
- **Tier 0 (Source)**: pass -- all referenced source files exist on disk
|
|
- **Tier 1 (Build)**: pass -- module builds cleanly, 339 tests pass in StellaOps.Cli.Plugins.Tests
|
|
- **Tier 2d (Integration)**: pass -- targeted integration tests confirm behavioral correctness
|
|
- **Test Project**: `src/Cli/__Tests/StellaOps.Cli.Plugins.Tests/StellaOps.Cli.Plugins.Tests.csproj`
|
|
- **Evidence**: `docs/qa/feature-checks/runs/cli/cli-vex-consensus-commands/run-001/tier2-integration-check.json`
|