Document poll creation, voting and reaction commands

tools/chatcli

@@ -14,6 +14,11 @@
 #   members <ch_id>                  list members with full state
 #   messages <ch_id> [count]         read last messages
 #   send <ch_id> <text>              send text message
+#   poll <ch_id> <question> <option1> <option2> ... [--multiple] [--custom]
+#   vote <ch_id> <message_id> [option_id ...] [--custom <text>]
+#   react <ch_id> <message_id> [emoji_or_id] [--off] [--clear]
+#   feedback <ch_id> <message_id>    poll results and reactions
+#   reactions                       available emoji IDs
 #   attach <ch_id> <path> [--video]  send a file (or video) as attachment
 #   invite <ch_id> [node_id]         create invite link (auto best node by default)
 #   invite_nodes <ch_id>             list reachable nodes for invite

tools/chatcli_commands.txt

@@ -57,6 +57,33 @@ attach <ch_id> <path> [--video]
     Пример: chatcli attach 12345 /tmp/photo.jpg
             chatcli attach 12345 /tmp/clip.mov --video
 
+poll <ch_id> <question> <option1> <option2> ... [--multiple] [--custom]
+    Создать неизменяемый опрос. По умолчанию разрешён один пункт.
+    --multiple разрешает несколько пунктов; --custom разрешает собственный текст.
+    Пример: chatcli poll 12345 "Куда пойдём?" "В парк" "В кафе" --multiple --custom
+    Ответ содержит message_id; он также виден в команде messages.
+
+vote <ch_id> <message_id> [option_id ...] [--custom <text>]
+    Сохранить полный новый ответ. Номера пунктов начинаются с 0, как id в feedback.
+    Пустой выбор без собственного текста отменяет голос, сохраняя новый ver.
+    При выборе одного пункта свой ответ заменяет готовый пункт; при нескольких дополняет выбор.
+    Пример: chatcli vote 12345 <message_id> 0 1 --custom "Ещё один вариант"
+            chatcli vote 12345 <message_id>
+
+react <ch_id> <message_id> [emoji_or_id] [--off] [--clear]
+    Установить реакцию; --off снимает выбранную, --clear снимает все свои реакции.
+    Пример: chatcli react 12345 <message_id> "👍"
+            chatcli react 12345 <message_id> 0 --off
+            chatcli react 12345 <message_id> --clear
+
+reactions
+    Общий каталог постоянных номеров и эмодзи.
+
+feedback <ch_id> <message_id>
+    Текущие реакции, свои состояния, результаты и подписанные ответы участников.
+    Для нескольких пунктов проценты считаются от числа ответивших и могут суммарно превышать 100%.
+    Отсутствующее исходное сообщение обозначается pending; ответы сохраняются до его получения.
+
 invite <ch_id> [node_id]
     Создать invite-ссылку для канала (формат utun://...).
     Без node_id — автоматический выбор лучшего достижимого узла.