diff --git a/src/commands/index.js b/src/commands/index.js
index 602b22a..12b526f 100644
--- a/src/commands/index.js
+++ b/src/commands/index.js
@@ -11,7 +11,7 @@ module.exports = [
     topic: 'set.mode',
     aliases: ['setMode'],
     payloadSchema: { type: 'string' },
-    description: 'Switch the valve between auto / manual control modes.',
+    description: 'Switch the operating mode. Allowed: `auto`, `virtualControl`, `fysicalControl`, `maintenance` (schema-validated in `valve.json` → `mode.current`).',
     handler: handlers.setMode,
   },
   {
diff --git a/wiki/Reference-Contracts.md b/wiki/Reference-Contracts.md
index 49ed8f6..2599d88 100644
--- a/wiki/Reference-Contracts.md
+++ b/wiki/Reference-Contracts.md
@@ -17,7 +17,7 @@ The registry lives in `src/commands/index.js`. Each descriptor maps a canonical
 
 | Canonical topic | Aliases | Payload | Unit | Effect |
 |---|---|---|---|---|
-| `set.mode` | `setMode` | `string` | — | Switch the valve between auto / manual control modes. |
+| `set.mode` | `setMode` | `string` | — | Switch the operating mode. Allowed: `auto`, `virtualControl`, `fysicalControl`, `maintenance` (schema-validated in `valve.json` → `mode.current`). |
 | `cmd.startup` | — | any | — | Initiate the valve startup sequence. |
 | `cmd.shutdown` | — | any | — | Initiate the valve shutdown sequence. |
 | `cmd.estop` | `emergencystop`, `emergencyStop` | any | — | Trigger an emergency stop on the valve. |