docs consolidation and others
This commit is contained in:
23
docs/modules/vex-lens/guides/consensus-console.md
Normal file
23
docs/modules/vex-lens/guides/consensus-console.md
Normal file
@@ -0,0 +1,23 @@
|
||||
# VEX Consensus in the Console
|
||||
|
||||
This document describes how the Console should surface VEX evidence and consensus to keep triage explainable.
|
||||
|
||||
## What the Console Should Show
|
||||
|
||||
- Effective VEX status (`affected`, `not_affected`, `under_investigation`, `fixed`) with confidence/tier label.
|
||||
- Provenance for each source statement: issuer identity, signature verification state, timestamps, and digests.
|
||||
- Conflicts as first-class facts (what disagrees, at what trust tier), not hidden UI logic.
|
||||
- Snapshot identity and staleness budgets when operating against Offline Kit snapshots.
|
||||
|
||||
## Evidence Linking
|
||||
|
||||
Every displayed fact should link back to:
|
||||
|
||||
- The raw VEX observation(s)
|
||||
- Linkset correlation view (what was grouped and why)
|
||||
- The policy explanation that consumed the evidence (when shown in triage)
|
||||
|
||||
## References
|
||||
|
||||
- Operator guide: `docs/UI_GUIDE.md`
|
||||
- VEX conceptual guide: `docs/VEX_CONSENSUS_GUIDE.md`
|
||||
Reference in New Issue
Block a user