@pachca/cli 2026.10.3 → 2026.11.0

package/dist/commands/users/list.js

@@ -11,7 +11,7 @@ export default class UsersList extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Поисковая фраза для фильтрации результатов. Поиск работает по полям: `first_name` (имя), `last_name` (фамилия), `email` (электронная почта), `phone_number` (телефон) и `nickname` (никнейм).",
+            description: "Поисковая фраза для фильтрации результатов. Поиск работает по полям: `first_name` (имя), `last_name` (фамилия), `nickname` (никнейм), `title` (должность) и `department` (департамент). Если вызывающему видны персональные данные (правило то же, что у поля `email`), поиск идёт ещё по `phone_number` (телефон), значениям дополнительных полей и по полному адресу `email`.",
         }),
         limit: Flags.integer({
             description: 'Количество результатов на страницу',
@@ -33,6 +33,7 @@ export default class UsersList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -48,7 +49,7 @@ export default class UsersList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -58,7 +59,8 @@ export default class UsersList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/users/update-status.js

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableString } from '../../lib/flags.js';
 export default class UsersUpdateStatus extends BaseCommand {
     static description = "Новый статус сотрудника";
     static scope = "user_status:write";
@@ -21,15 +22,15 @@ export default class UsersUpdateStatus extends BaseCommand {
         'title': Flags.string({
             description: "Текст статуса. Обязателен, если статуса ещё нет. (макс. 50 символов)",
         }),
-        'expires-at': Flags.string({
-            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC.",
+        'expires-at': nullableString({
+            description: "Срок жизни статуса (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. `null` убирает срок: статус не снимется сам. Чтобы передать null, укажите `--expires-at null`.",
         }),
         'is-away': Flags.boolean({
             description: "Режим «Нет на месте»",
             allowNo: true,
         }),
-        'away-message': Flags.string({
-            description: "Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях. (макс. 1024 символов)",
+        'away-message': nullableString({
+            description: "Текст сообщения при режиме «Нет на месте». Отображается в профиле и при личных сообщениях/упоминаниях. Поддерживает Markdown и упоминания `@nickname` и `<@user_id>`, но сохраняется и возвращается обычным текстом: разметка убирается, а упоминание сотрудника заменяется на `@` с его именем и фамилией. Предел 1024 символа действует и на присланный текст, и на получившийся, сверх него ответ `400` с кодом `too_long`. `null` или пустая строка убирает текст. Чтобы передать null, укажите `--away-message null`. (макс. 1024 символов)",
         }),
     };
     async run() {

package/dist/commands/users/update.js

@@ -22,19 +22,19 @@ export default class UsersUpdate extends BaseCommand {
             description: "Фамилия (макс. 255 символов)",
         }),
         'email': Flags.string({
-            description: "Электронная почта (макс. 255 символов)",
+            description: "Электронная почта. После её смены сотрудник считается ещё не входившим: `invite_status` приходит `sent`, а `last_activity_at` — `null`, пока он снова не зайдёт в Пачку. (макс. 255 символов)",
         }),
         'phone-number': Flags.string({
             description: "Телефон (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Имя пользователя. Ник бота должен оканчиваться на `_bot` и быть уникальным в пространстве, иначе метод отвечает `422` с ошибкой на поле `nickname`: `invalid` или `already_exists`. Прежний ник бота проверяется, только когда его меняют. (макс. 255 символов)",
+            description: "Имя пользователя: латинские и кириллические буквы, цифры, `_`, `-` и `.`, иначе ответ `400` с кодом `invalid`. Ники `here` и `all` зарезервированы: на них ответ `400` с кодом `use_of_system_words`. Ник, занятый другим сотрудником без учёта регистра, отвечает `400` с кодом `already_exists`: случайные символы, как в методе [Новый сотрудник](POST /users), здесь не дописываются. У сотрудника с `sso: true` занятый ник молча остаётся прежним. Ник бота состоит из латинских букв, цифр и `_`, оканчивается на `_bot` и уникален в пространстве, иначе метод отвечает `422` с ошибкой на поле `nickname`: `invalid` или `already_exists`. Другие ошибки ника бота при его смене, например `blank` или `too_long`, тоже приходят с `422`. Прежний ник бота проверяется, только когда его меняют. (макс. 255 символов)",
         }),
         'department': Flags.string({
             description: "Департамент (макс. 255 символов)",
         }),
         'title': Flags.string({
-            description: "Должность",
+            description: "Должность (макс. 255 символов)",
         }),
         'role': Flags.string({
             description: "Уровень доступа",
@@ -43,11 +43,11 @@ export default class UsersUpdate extends BaseCommand {
             description: "Чат, в котором останется сотрудник при переводе в гости (`role: \"guest\"`): ровно одна активная беседа или канал, куда у токена есть право добавлять участников. Без такого чата ответ `400` по этому полю, и не меняется ничего. При других ролях и у того, кто уже гость, поле не учитывается.",
         }),
         'suspended': Flags.boolean({
-            description: "Деактивация пользователя",
+            description: "Деактивация пользователя. Владельца пространства приостановить нельзя никому, в том числе ему самому: ответ `403`.",
             allowNo: true,
         }),
         'list-tags': Flags.string({
-            description: "Массив названий тегов, привязываемых к сотруднику. Список заменяет прежний целиком, пустой снимает все теги. Значение, которое не является массивом непустых строк, игнорируется: теги сотрудника не меняются. В тег можно добавить только бота, которого может добавить в чат любой сотрудник и у которого выключена настройка «Ограничить одним чатом». Если бот этим условиям не отвечает, а в списке есть тег, которого у него ещё нет, метод отвечает `422` на поле `group_tags` и ничего не меняет: с кодом `single_chat_bot_tag_denied`, когда бот ограничен одним чатом, и `restricted_bot_tag_denied`, когда добавлять его в чаты могут не все. Подробнее — в разделе [Бот в тегах](https://dev.pachca.com/guides/bots/settings#bot-v-tegah).",
+            description: "Массив названий тегов, привязываемых к сотруднику. Список заменяет прежний целиком, пустой снимает все теги. Значение, которое не является массивом непустых строк, игнорируется: теги сотрудника не меняются. В тег можно добавить только бота, которого может добавить в чат любой сотрудник и у которого выключена настройка «Ограничить одним чатом». Если бот этим условиям не отвечает, а в списке есть тег, которого у него ещё нет, метод отвечает `422` на поле `group_tags` и ничего не меняет: с кодом `single_chat_bot_tag_denied`, когда бот ограничен одним чатом, и `restricted_bot_tag_denied`, когда в настройке «Кто может добавлять бота в чаты» выбран «Создатель» или «Создатель и Администраторы». Подробнее — в разделе [Бот в тегах](https://dev.pachca.com/guides/bots/settings#bot-v-tegah).",
         }),
         'custom-properties': Flags.string({
             description: "Задаваемые дополнительные поля",
@@ -75,6 +75,9 @@ export default class UsersUpdate extends BaseCommand {
         if (flags['department'] && String(flags['department']).length > 255) {
             validationErrors.push({ message: `--department: максимум 255 символов (передано: ${String(flags['department']).length})`, flag: 'department' });
         }
+        if (flags['title'] && String(flags['title']).length > 255) {
+            validationErrors.push({ message: `--title: максимум 255 символов (передано: ${String(flags['title']).length})`, flag: 'title' });
+        }
         if (validationErrors.length > 0) {
             this.validationError(validationErrors);
         }

package/dist/commands/views/open.js

@@ -7,6 +7,7 @@ export default class ViewsOpen extends BaseCommand {
     static scope = "views:write";
     static apiMethod = "POST";
     static apiPath = "/views/open";
+    static defaultColumns = ["success"];
     static requiredFlags = ["title", "blocks", "type", "trigger-id"];
     static args = {};
     static flags = {

package/dist/data/changelog.json

@@ -1,4 +1,154 @@
 [
+    {
+        "version": "2026.11.0",
+        "date": "4 ноября 2026",
+        "changes": [
+            {
+                "type": "~",
+                "command": "tasks create",
+                "description": "Работает без `--kind` и не спрашивает тип в терминале: по умолчанию создаётся простое напоминание"
+            },
+            {
+                "type": "~",
+                "command": "reactions remove",
+                "description": "Снимает реакцию по `--name` без `--code`"
+            },
+            {
+                "type": "+",
+                "command": "profile update-status, users update-status",
+                "description": "`--expires-at null` убирает срок статуса, а `--away-message null` убирает текст «Нет на месте»"
+            },
+            {
+                "type": "+",
+                "command": "bots create, bots update, bots update-webhook, messages update, reactions add, users create, users update",
+                "description": "Длина значений проверяется до запроса: `--outgoing-url`, `--challenge-key`, `--display-avatar-url`, `--display-name` и `--title` до 255 символов, а `--code` у `reactions add` до 16"
+            },
+            {
+                "type": "+",
+                "description": "В выводе команд с сообщениями и черновиками есть поле `voice_content.transcript_status`: статус расшифровки голосового сообщения"
+            },
+            {
+                "type": "~",
+                "command": "api",
+                "description": "Справка `--docs` и схема `--spec` показывают необязательными поля деталей журнала аудита, которых нет в записи без значения, а список скоупов без `files:write`, `webhooks:read` и `webhooks:write`"
+            },
+            {
+                "type": "~",
+                "description": "Справка команд следует уточнённым описаниям API: ник сотрудника и бота, пустой бот, события, команды и `--ignore-self-messages` бота, поиск сотрудников и ботов, длина поискового запроса, подпись сообщения бота, название чата, упоминания в черновике, текст «Нет на месте», смена почты, приостановка владельца, `--actor-id` у `pachca security list` и `--done-at` у `pachca tasks update`"
+            }
+        ]
+    },
+    {
+        "version": "2026.10.4",
+        "date": "31 октября 2026",
+        "changes": [
+            {
+                "type": "-",
+                "command": "api",
+                "description": "Справка `--docs` и схема `--spec` показывают `dlp_rule_id` в деталях события `dlp_violation_detected` строкой, как его отдаёт API"
+            },
+            {
+                "type": "+",
+                "command": "upload",
+                "description": "Флаг `--name` задаёт имя файла, которым заканчивается `key`: так данные из stdin получают расширение и уходят в сообщение под этим именем"
+            },
+            {
+                "type": "-",
+                "command": "upload",
+                "description": "Файл, которого нет на диске, команда отклоняет до запроса подписи, в том числе с `--dry-run`"
+            },
+            {
+                "type": "~",
+                "command": "doctor",
+                "description": "Проверяет тот же токен, что и остальные команды, в том же порядке: `--token`, `--profile`, `PACHCA_TOKEN`, `PACHCA_PROFILE`, активный профиль, поэтому в CI с одной `PACHCA_TOKEN` команда проходит"
+            },
+            {
+                "type": "~",
+                "command": "doctor",
+                "description": "При ошибке хотя бы одной проверки команда завершается с кодом `1` в любом формате вывода, в том числе с `-o json`"
+            },
+            {
+                "type": "~",
+                "command": "doctor",
+                "description": "Без файла конфига команда показывает путь, по которому его ищет"
+            },
+            {
+                "type": "-",
+                "description": "`--dry-run` показывает запрос без входа и без `PACHCA_TOKEN`, а токен в заголовке `Authorization` заменён маской"
+            },
+            {
+                "type": "-",
+                "command": "files direct-url",
+                "description": "С `--dry-run` запрос показан без заголовка `Authorization`, как он и уходит в хранилище"
+            },
+            {
+                "type": "~",
+                "command": "bots update, drafts update",
+                "description": "Слово `null` во флаге поля, которое принимает `null`, уходит в API как JSON null: `--kind null` удаляет входящий вебхук бота, а `--parent-message-id null` снимает ответ с черновика"
+            },
+            {
+                "type": "-",
+                "command": "auth login",
+                "description": "Вход через браузер с `--quiet` печатает адрес и код подтверждения, а флаг убирает только строку ожидания и отчёт о входе"
+            },
+            {
+                "type": "~",
+                "command": "auth login",
+                "description": "Пример в `--help` и подсказка при `--token -` без потока ввода передают токен из буфера обмена: `pbpaste | pachca auth login --token -`"
+            },
+            {
+                "type": "-",
+                "command": "messages create, messages update, drafts create, drafts update, tasks create, tasks update",
+                "description": "Текст из потока ввода попадает в запрос, только когда поток не пуст, а с пустым потоком, как у скрипта или агента, команда отправляет поля из флагов"
+            },
+            {
+                "type": "~",
+                "description": "Отказ `403` с `role_forbidden` в терминале объясняется словами: право у токена есть, но действие не разрешает роль, поэтому новый вход или токен не помогут. Вывод с `-o json` и в пайпе прежний."
+            },
+            {
+                "type": "~",
+                "description": "Объяснение отказа `insufficient_scope` в терминале зависит от источника токена: с `--token` или `PACHCA_TOKEN` команда предлагает `pachca oauth token-info -o json`, а если право есть в сохранённом списке профиля, советует обновить его через `pachca auth status --remote`"
+            },
+            {
+                "type": "~",
+                "description": "Когда вход через браузер завершён или отозван, сообщение и подсказка `pachca auth login` называют профиль, с которым шла команда"
+            },
+            {
+                "type": "-",
+                "command": "api",
+                "description": "Эквивалентная команда в справке `--describe` повторяет пример запроса из спецификации и работает при копировании"
+            },
+            {
+                "type": "-",
+                "command": "api",
+                "description": "Пример `pachca api POST /messages` в `--help` передаёт `message[entity_id]` в кавычках и работает при копировании, а описание команды и ошибка `--describe` для неизвестного пути говорят «метод»"
+            },
+            {
+                "type": "~",
+                "command": "views open",
+                "description": "Выводит ответ API `{ \"success\": true }`"
+            },
+            {
+                "type": "~",
+                "description": "Справка команд следует обновлённым описаниям API: удаление входящего вебхука, правило совпадения команд бота, правило упоминаний в тексте сообщения, `duration_ms` и `file_type` у файлов, срок ссылки на поток событий, напоминания вместо задач, поле `scopes` у `bot_token_updated` и другие поля деталей журнала аудита, значения настройки бота у `restricted_bot_tag_denied` в подсказке `--list-tags`, добавление участников в тред, создание треда, `--skip-invite-mentions`, правка без уведомления и список прочитавших"
+            },
+            {
+                "type": "-",
+                "command": "api",
+                "description": "Справка `--docs` и схема `--spec` описывают `scopes` в деталях бота журнала аудита так, как его писал API до 7 октября 2026 года: список прав у `bot_token_created` и объект с `previous` и `new` у `bot_token_updated`"
+            },
+            {
+                "type": "~",
+                "command": "search",
+                "description": "С `--all` команды поиска останавливаются по `has_next` и показывают в терминале, сколько результатов загружено из общего числа найденных"
+            },
+            {
+                "type": "~",
+                "command": "api",
+                "description": "Справка `--docs` и схема `--spec` методов поиска показывают поле `has_next` в `meta.paginate`"
+            }
+        ]
+    },
     {
         "version": "2026.10.3",
         "date": "28 октября 2026",