Define shared permissions and version contracts

2026-10-25 05:39:57 +01:00
parent f1e5148480
commit b89edfafa9
5 changed files with 41 additions and 0 deletions
@@ -8,4 +8,10 @@
 - `GET /api/v1/server/info` publishes `minimum_client_version` and
  `maximum_client_version`; clients must use these fields to detect an
  incompatible pairing before enabling authenticated controls.
+- Permission values are shared through `contracts/v1/permissions.json`.
+  They are ordered from least to most privileged: `everyone`, `subscriber`,
+  `moderator`, and `broadcaster`.
+- The normalized result of a compatibility check is described by
+  `contracts/v1/version-negotiation.json`; an incompatible result includes a
+  human-readable `reason` while a compatible result may omit it.