docs consolidation and others

docs/modules/vex-lens/guides/consensus-api.md

@@ -0,0 +1,23 @@
+# VEX Consensus API (Contract Overview)
+
+This document provides a high-level overview of consensus endpoints. The gateway and module dossiers define the authoritative routing, auth, and schema details.
+
+## Common Headers
+
+- `Authorization: Bearer <token>` (or DPoP where configured)
+- `X-StellaOps-Tenant: <tenantId>` (required)
+
+## Typical Endpoints
+
+- `GET /v1/vex/consensus?artifact=...&advisory=...` — returns a single consensus record (plus conflicts).
+- `GET /v1/vex/conflicts` — list outstanding conflicts with summary metadata.
+- `GET /v1/vex/consensus/export` — deterministic JSONL export for Offline Kit / Export Center bundles.
+- `POST /v1/vex/trust/weights` — tenant-admin update of trust tiers/weights (when enabled).
+
+## Output Shape
+
+See `docs/vex/consensus-json.md` for the record payload reference.
+
+## References
+
+- `docs/modules/vex-lens/architecture.md`