From 587a9800810c18ba7141c6d729b8aaf34d0e78bc Mon Sep 17 00:00:00 2001
From: evgeny <evgeny@adaptto.ru>
Date: Tue, 6 Oct 2026 22:43:13 +0200
Subject: [PATCH] Document poll creation, voting and reaction commands

---
 tools/chatcli              |  5 +++++
 tools/chatcli_commands.txt | 27 +++++++++++++++++++++++++++
 2 files changed, 32 insertions(+)

diff --git a/tools/chatcli b/tools/chatcli
index 4511110e..3d5a9ecf 100755
--- a/tools/chatcli
+++ b/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
diff --git a/tools/chatcli_commands.txt b/tools/chatcli_commands.txt
index 1f9f80e1..305996c4 100644
--- a/tools/chatcli_commands.txt
+++ b/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 — автоматический выбор лучшего достижимого узла.