@pachca/cli 2026.10.3 → 2026.10.4

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

@@ -50,6 +50,7 @@ export default class SearchListUsers extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     query: flags['query'],
@@ -70,7 +71,7 @@ export default class SearchListUsers 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)
@@ -80,7 +81,8 @@ export default class SearchListUsers 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/security/list.js

@@ -53,6 +53,7 @@ export default class SecurityList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'start_time': flags['start-time'],
@@ -74,7 +75,7 @@ export default class SecurityList 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)
@@ -84,7 +85,8 @@ export default class SecurityList 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/tasks/create.js

@@ -47,7 +47,9 @@ export default class TasksCreate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const missingRequired = [
             { flag: 'kind', label: "Тип", type: 'string' },

package/dist/commands/tasks/list.js

@@ -43,6 +43,7 @@ export default class TasksList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     status: flags['status'],
@@ -61,7 +62,7 @@ export default class TasksList 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)
@@ -71,7 +72,8 @@ export default class TasksList 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/tasks/update.js

@@ -53,7 +53,9 @@ export default class TasksUpdate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const body = { task: {
                 kind: flags['kind'],

package/dist/commands/threads/list.js

@@ -36,6 +36,7 @@ export default class ThreadsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'last_message_at_after': flags['last-message-at-after'],
@@ -52,7 +53,7 @@ export default class ThreadsList 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)
@@ -62,7 +63,8 @@ export default class ThreadsList 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/upload.js

@@ -1,4 +1,4 @@
-import { Args } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
 import { BaseCommand } from '../base-command.js';
@@ -6,7 +6,8 @@ export default class Upload extends BaseCommand {
     static description = 'Загрузить файл (получает подпись и загружает автоматически)';
     static examples = [
         '<%= config.bin %> upload photo.jpg',
-        'cat data.csv | <%= config.bin %> upload -',
+        'cat data.csv | <%= config.bin %> upload - --name data.csv',
+        '<%= config.bin %> upload ./build/out.pdf --name report.pdf',
     ];
     static scope = 'uploads:write';
     static args = {
@@ -17,10 +18,20 @@ export default class Upload extends BaseCommand {
     };
     static flags = {
         ...BaseCommand.baseFlags,
+        name: Flags.string({
+            description: 'Имя файла, которым заканчивается key. Расширение name при отправке файла в сообщении должно совпадать с расширением этого имени. По умолчанию это имя загружаемого файла, а у данных из stdin имя stdin без расширения',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(Upload);
         this.parsedFlags = flags;
+        const fromStdin = args.file === '-';
+        if (flags.name !== undefined && !isPlainFileName(flags.name)) {
+            this.validationError([{ message: 'Имя файла в --name не может быть пустым и содержать / или \\', flag: 'name' }], { type: 'PACHCA_USAGE_ERROR' });
+        }
+        if (!fromStdin && !fs.existsSync(args.file)) {
+            this.validationError([{ message: `Файл не найден: ${args.file}` }], { type: 'PACHCA_USAGE_ERROR' });
+        }
         // Step 1: Get upload params
         const { data: uploadData } = await this.apiRequest({
             method: 'POST',
@@ -30,19 +41,18 @@ export default class Upload extends BaseCommand {
         // Step 2: Read file
         let fileBlob;
         let fileName;
-        if (args.file === '-') {
+        // The key ends in this name, and the API checks the extension of `name` in
+        // a message's `files` against it. Data from stdin has no name of its own.
+        if (fromStdin) {
             const chunks = [];
             for await (const chunk of process.stdin)
                 chunks.push(chunk);
             fileBlob = new Blob([Buffer.concat(chunks)]);
-            fileName = 'stdin';
+            fileName = flags.name ?? 'stdin';
         }
         else {
-            if (!fs.existsSync(args.file)) {
-                this.validationError([{ message: `Файл не найден: ${args.file}` }], { type: 'PACHCA_USAGE_ERROR' });
-            }
             fileBlob = new Blob([fs.readFileSync(args.file)]);
-            fileName = path.basename(args.file);
+            fileName = flags.name ?? path.basename(args.file);
         }
         // Step 3: Replace ${filename} in key
         const key = params.key.replace('${filename}', fileName);
@@ -67,7 +77,16 @@ export default class Upload extends BaseCommand {
             formData,
             noAuth: true,
         });
+        // Said after the upload succeeds, so a failed one does not report a file as uploaded.
+        if (fromStdin && flags.name === undefined && !flags.quiet) {
+            process.stderr.write('⚠ Файл из stdin загружен под именем stdin без расширения: в name файла в сообщении расширения тоже не должно быть.\n' +
+                '  Имя с расширением задаёт флаг --name, например --name report.csv\n');
+        }
         // Output the key for use in messages
         this.output({ key });
     }
 }
+/** A bare file name: the key keeps its folder, so a path separator would move the file out of it. */
+function isPlainFileName(name) {
+    return name.trim() !== '' && !/[\\/]/.test(name);
+}

package/dist/commands/users/list.js

@@ -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.js

@@ -47,7 +47,7 @@ export default class UsersUpdate extends BaseCommand {
             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: "Задаваемые дополнительные поля",

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,115 @@
 [
+    {
+        "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",