From 5672772dabc2dea50075fc10f99833f01dd156fb Mon Sep 17 00:00:00 2001
From: teknium1 <127238744+teknium1@users.noreply.github.com>
Date: Wed, 20 May 2026 19:11:51 -0700
Subject: [PATCH] =?UTF-8?q?fix(gateway):=20reorder=20telegram=20menu=20pri?=
 =?UTF-8?q?ority=20=E2=80=94=20everyday=20commands=20first?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Put /help, /new, /stop, /status, /resume, /sessions, /model ahead of
the maintenance group (/debug, /restart, /update, /verbose, /commands)
so the menu's first row matches what users actually type most often.

The maintenance commands that prompted this priority list still land
inside the 30-cap visible window — just not at the very top.
---
 hermes_cli/commands.py | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/hermes_cli/commands.py b/hermes_cli/commands.py
index be1da354bbb..b920ff2e5fe 100644
--- a/hermes_cli/commands.py
+++ b/hermes_cli/commands.py
@@ -509,23 +509,27 @@ def telegram_bot_commands() -> list[tuple[str, str]]:
 
 
 _TELEGRAM_MENU_PRIORITY = (
-    "debug",
-    "restart",
-    "update",
-    "verbose",
-    "commands",
+    # Most-typed everyday commands first.
     "help",
     "new",
     "stop",
     "status",
     "resume",
     "sessions",
+    "model",
+    # Maintenance / diagnostics — the ones that prompted this priority list.
+    "debug",
+    "restart",
+    "update",
+    "verbose",
+    "commands",
+    # Mid-turn session control.
     "approve",
     "deny",
     "queue",
     "steer",
     "background",
-    "model",
+    # Lower-priority but still useful operational built-ins.
     "reasoning",
     "usage",
     "platforms",