@pachca/cli 2026.10.4 → 2026.11.1

package/dist/commands/reactions/add.js

@@ -18,7 +18,7 @@ export default class ReactionsAdd extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение: оно сохраняется как передано.",
+            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение до 16 символов: оно сохраняется как передано. (макс. 16 символов)",
         }),
         'name': Flags.string({
             description: "Имя кастомного эмодзи пространства. С ним реакцией ставится этот эмодзи, а если его в пространстве нет, ответ `404`.",
@@ -28,7 +28,7 @@ export default class ReactionsAdd extends BaseCommand {
         const { args, flags } = await this.parse(ReactionsAdd);
         this.parsedFlags = flags;
         const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение: оно сохраняется как передано.", type: 'string' },
+            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` подходит любое непустое значение до 16 символов: оно сохраняется как передано.", type: 'string' },
         ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
         if (missingRequired.length > 0) {
             if (this.isInteractive()) {
@@ -53,6 +53,13 @@ export default class ReactionsAdd extends BaseCommand {
                 this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --code <string>. pachca introspect reactions add" });
             }
         }
+        const validationErrors = [];
+        if (flags['code'] && String(flags['code']).length > 16) {
+            validationErrors.push({ message: `--code: максимум 16 символов (передано: ${String(flags['code']).length})`, flag: 'code' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = {
             code: flags['code'],
             name: flags['name'],

package/dist/commands/reactions/remove.js

@@ -7,7 +7,6 @@ export default class ReactionsRemove extends BaseCommand {
     static scope = "reactions:write";
     static apiMethod = "DELETE";
     static apiPath = "/messages/{id}/reactions";
-    static requiredFlags = ["code"];
     static args = {
         id: Args.integer({
             description: "Идентификатор сообщения",
@@ -17,7 +16,7 @@ export default class ReactionsRemove extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'code': Flags.string({
-            description: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.",
+            description: "Emoji символ реакции. Обязателен без `name`: нужен именно символ, текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи. С `name` не используется.",
         }),
         'name': Flags.string({
             description: "Имя реакции, как в её поле `name`. С ним реакция ищется по имени, так снимается и кастомный эмодзи пространства.",
@@ -30,32 +29,6 @@ export default class ReactionsRemove extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(ReactionsRemove);
         this.parsedFlags = flags;
-        const missingRequired = [
-            { flag: 'code', label: "Emoji символ реакции. Без `name` нужен именно символ: текстовые записи вроде `+1` или `:+1:` отклоняются как неизвестный эмодзи.", type: 'string' },
-        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
-        if (missingRequired.length > 0) {
-            if (this.isInteractive()) {
-                for (const field of missingRequired) {
-                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
-                    if (clack.isCancel(value)) {
-                        process.stderr.write('Отменено.\n');
-                        this.exit(0);
-                    }
-                    if (field.type === 'integer') {
-                        flags[field.flag] = Number.parseInt(value, 10);
-                    }
-                    else if (field.type === 'boolean') {
-                        flags[field.flag] = value === 'true';
-                    }
-                    else {
-                        flags[field.flag] = value;
-                    }
-                }
-            }
-            else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --code <string>. pachca introspect reactions remove" });
-            }
-        }
         if (!flags.force) {
             if (!this.isInteractive()) {
                 this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca reactions remove <id> --force" });

package/dist/commands/search/list-chats.js

@@ -11,7 +11,7 @@ export default class SearchListChats extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Запрос длиннее 256 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",

package/dist/commands/search/list-messages.js

@@ -11,7 +11,7 @@ export default class SearchListMessages extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Без него сообщения отбираются только фильтрами. Запрос длиннее 256 знаков обрезается.",
         }),
         'order': Flags.string({
             description: "Направление сортировки",

package/dist/commands/search/list-users.js

@@ -11,7 +11,7 @@ export default class SearchListUsers extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'query': Flags.string({
-            description: "Текст поискового запроса. Запрос длиннее 500 знаков обрезается.",
+            description: "Текст поискового запроса. Запрос длиннее 256 знаков обрезается.",
         }),
         'sort': Flags.string({
             description: "Сортировка результатов",

package/dist/commands/security/list.js

@@ -22,7 +22,7 @@ export default class SecurityList extends BaseCommand {
             options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_2fa_disabled", "login_grant_created", "login_grant_approved", "login_grant_denied", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "company_chats_accessed", "company_bots_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted", "bot_oauth_client_updated", "bot_oauth_client_disabled", "bot_oauth_client_secret_rotated", "bot_oauth_client_secret_issued", "bot_token_created", "bot_token_updated", "bot_token_reissued", "bot_token_deleted", "oauth_authorization_granted", "oauth_authorization_revoked", "oauth_token_revoked", "oauth_device_authorization_approved", "oauth_device_authorization_denied", "video_call_started", "video_call_finished", "video_call_recording_ready", "exchange_disabled"],
         }),
         'actor-id': Flags.string({
-            description: "Идентификатор пользователя, выполнившего действие",
+            description: "Идентификатор актора события, как в поле `actor_id` записи. Смену роли, добавление в чат и исключение из чата, назначение и снятие тегов фильтр находит по сотруднику, которого они коснулись.",
         }),
         'actor-type': Flags.string({
             description: "Тип актора",

package/dist/commands/tasks/create.js

@@ -1,14 +1,12 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import * as clack from '@clack/prompts';
 export default class TasksCreate extends BaseCommand {
     static description = "Новое напоминание";
     static scope = "tasks:create";
     static apiMethod = "POST";
     static apiPath = "/tasks";
     static defaultColumns = ["id", "content", "created_at", "kind", "due_at"];
-    static requiredFlags = ["kind"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -51,32 +49,6 @@ export default class TasksCreate extends BaseCommand {
             if (piped)
                 flags['content'] = piped;
         }
-        const missingRequired = [
-            { flag: 'kind', label: "Тип", type: 'string' },
-        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
-        if (missingRequired.length > 0) {
-            if (this.isInteractive()) {
-                for (const field of missingRequired) {
-                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
-                    if (clack.isCancel(value)) {
-                        process.stderr.write('Отменено.\n');
-                        this.exit(0);
-                    }
-                    if (field.type === 'integer') {
-                        flags[field.flag] = Number.parseInt(value, 10);
-                    }
-                    else if (field.type === 'boolean') {
-                        flags[field.flag] = value === 'true';
-                    }
-                    else {
-                        flags[field.flag] = value;
-                    }
-                }
-            }
-            else {
-                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --kind <string>. pachca introspect tasks create" });
-            }
-        }
         const body = { task: {
                 kind: flags['kind'],
                 content: flags['content'],

package/dist/commands/tasks/update.js

@@ -38,7 +38,7 @@ export default class TasksUpdate extends BaseCommand {
             allowNo: true,
         }),
         'done-at': Flags.string({
-            description: "Дата и время выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём `done_at` будет `null`.",
+            description: "Дата и время выполнения напоминания (ISO-8601). Смещение вида `+03:00` учитывается, время без смещения считается UTC. Значение, которое не удалось разобрать, отметку о выполнении снимает: ответ придёт успешный, а в нём `status` будет `undone`.",
         }),
         'custom-properties': Flags.string({
             description: "Задаваемые дополнительные поля",

package/dist/commands/users/create.js

@@ -25,13 +25,13 @@ export default class UsersCreate extends BaseCommand {
             description: "Телефон (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Имя пользователя (макс. 255 символов)",
+            description: "Имя пользователя: латинские и кириллические буквы, цифры, `_`, `-` и `.`, иначе ответ `400` с кодом `invalid`. Ники `here` и `all` зарезервированы: на них ответ `400` с кодом `use_of_system_words`. (макс. 255 символов)",
         }),
         'department': Flags.string({
             description: "Департамент (макс. 255 символов)",
         }),
         'title': Flags.string({
-            description: "Должность",
+            description: "Должность (макс. 255 символов)",
         }),
         'role': Flags.string({
             description: "Уровень доступа",
@@ -102,6 +102,9 @@ export default class UsersCreate 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/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: 'Количество результатов на страницу',

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,28 +22,28 @@ 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: "Уровень доступа",
         }),
         'chat-ids': Flags.string({
-            description: "Чат, в котором останется сотрудник при переводе в гости (`role: \"guest\"`): ровно одна активная беседа или канал, куда у токена есть право добавлять участников. Без такого чата ответ `400` по этому полю, и не меняется ничего. При других ролях и у того, кто уже гость, поле не учитывается.",
+            description: "Чат, в котором останется сотрудник при переводе в гости (`role: \"guest\"`): ровно одна активная беседа или канал, куда у токена есть право добавлять участников. Без такого чата ответ `400` по этому полю, и не меняется ничего. При других ролях и у того, кто уже гость, поле не учитывается. При переводе в гости сотруднику с указанной почтой уходит письмо о смене роли со ссылкой на этот чат, даже если он ещё не входил в Пачку или приостановлен. В суточный лимит писем-приглашений оно не идёт.",
         }),
         'suspended': Flags.boolean({
-            description: "Деактивация пользователя",
+            description: "Деактивация пользователя. Владельца пространства приостановить нельзя никому, в том числе ему самому: ответ `403`.",
             allowNo: true,
         }),
         'list-tags': Flags.string({
@@ -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/data/changelog.json

@@ -1,4 +1,83 @@
 [
+    {
+        "version": "2026.11.1",
+        "date": "9 ноября 2026",
+        "changes": [
+            {
+                "type": "~",
+                "command": "auth status",
+                "description": "Показывает токен, с которым работают команды, в том числе из `--token` и `PACHCA_TOKEN`. Владельца, права и срок жизни такого токена команда спрашивает у сервера и называет сохранённый профиль, который не используется, пока задан `PACHCA_TOKEN`."
+            },
+            {
+                "type": "~",
+                "description": "Подсказки к отказу `insufficient_scope` ведут к `pachca auth status` с тем же `--token` или `--profile`, что у команды, а для сохранённого профиля в `-o json` ещё и с `--remote`"
+            },
+            {
+                "type": "~",
+                "command": "auth login",
+                "description": "Подсказка `pachca auth status` после входа называет профиль, если без него команда покажет другой токен, а при заданном `PACHCA_TOKEN` вход предупреждает, что команды используют переменную"
+            },
+            {
+                "type": "+",
+                "command": "messages get, messages list, messages create, messages update, search list-messages",
+                "description": "В ответах с сообщениями есть поля `source` и `application`: через что сотрудник отправил сообщение и какая программа"
+            },
+            {
+                "type": "~",
+                "command": "chats list, messages list",
+                "description": "`--order` без `--sort` задаёт направление по `id`"
+            },
+            {
+                "type": "~",
+                "command": "bots create, bots update, bots update-webhook",
+                "description": "В описании адреса вебхука коды отказа, а в описании шаблона проверка синтаксиса"
+            },
+            {
+                "type": "~",
+                "command": "users update",
+                "description": "В описании чата для перевода в гости письмо о смене роли"
+            }
+        ]
+    },
+    {
+        "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",