@pachca/cli 2026.7.1 → 2026.7.2

package/dist/commands/tasks/update.js

@@ -4,8 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class TasksUpdate extends BaseCommand {
     static description = "Редактирование напоминания";
     static examples = [
-        "Отметить задачу выполненной:\n  $ pachca tasks update",
-        "Обновить задачу (перенести срок, сменить ответственных):\n  $ pachca tasks update"
+        "Отметить задачу выполненной — Обнови статус задачи:\n  $ pachca tasks update",
+        "Обновить задачу (перенести срок, сменить ответственных) — Обнови нужные поля задачи:\n  $ pachca tasks update"
     ];
     static scope = "tasks:update";
     static apiMethod = "PUT";
@@ -29,7 +29,7 @@ export default class TasksUpdate extends BaseCommand {
             description: "Срок выполнения напоминания (ISO-8601) в формате YYYY-MM-DDThh:mm:ss.sssTZD. Если указано время 23:59:59.000, то напоминание будет создано на весь день (без указания времени).",
         }),
         'priority': Flags.integer({
-            description: "Приоритет: 1, 2 (важно) или 3 (очень важно).",
+            description: "Приоритет: 1, 2 (важно) или 3 (очень важно)",
         }),
         'performer-ids': Flags.string({
             description: "Массив идентификаторов пользователей, привязываемых к напоминанию как «ответственные»",
@@ -84,7 +84,7 @@ export default class TasksUpdate extends BaseCommand {
             path: `/tasks/${args.id}`,
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/threads/add.js

@@ -4,8 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class ThreadsAdd extends BaseCommand {
     static description = "Новый тред";
     static examples = [
-        "Ответить в тред (комментарий к сообщению):\n  $ pachca thread add",
-        "Подписаться на тред сообщения:\n  $ pachca thread add"
+        "Ответить в тред (комментарий к сообщению) — Получи или создай тред, возьми `thread.id` из ответа:\n  $ pachca threads add",
+        "Подписаться на тред сообщения — Получи или создай тред, возьми `chat_id` из ответа:\n  $ pachca threads add"
     ];
     static scope = "threads:create";
     static apiMethod = "POST";
@@ -27,7 +27,7 @@ export default class ThreadsAdd extends BaseCommand {
             method: 'POST',
             path: `/messages/${args.id}/thread`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/threads/create.js

@@ -16,7 +16,7 @@ export default class ThreadsCreate extends BaseCommand {
             method: 'POST',
             path: '/threads',
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/threads/get.js

@@ -23,7 +23,7 @@ export default class ThreadsGet extends BaseCommand {
             method: 'GET',
             path: `/threads/${args.id}`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/threads/list.js

@@ -4,7 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class ThreadsList extends BaseCommand {
     static description = "Список тредов";
     static examples = [
-        "Получить список активных тредов за период:\n  $ pachca threads list"
+        "Получить список активных тредов за период — Запроси список тредов с фильтром по времени последнего сообщения и нужным `--limit`:\n  $ pachca threads list",
+        "Получить список активных тредов за период — Если в ответе `meta.paginate.next_page` — пройди по страницам через `--cursor`:\n  $ pachca threads list"
     ];
     static scope = "threads:read";
     static apiMethod = "GET";
@@ -95,7 +96,7 @@ export default class ThreadsList extends BaseCommand {
                 cursor: flags.cursor,
             },
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const items = responseBody.data ?? responseBody;
         this.output(items);
     }

package/dist/commands/users/create.js

@@ -5,9 +5,9 @@ import * as clack from '@clack/prompts';
 export default class UsersCreate extends BaseCommand {
     static description = "Новый сотрудник";
     static examples = [
-        "Массовое создание сотрудников с тегами:\n  $ pachca users create",
-        "Создать гостя в чат:\n  $ pachca users create",
-        "Онбординг нового сотрудника:\n  $ pachca users create"
+        "Массовое создание сотрудников с тегами — Для каждого сотрудника: создай аккаунт с тегами:\n  $ pachca users create",
+        "Создать гостя в чат — Создай гостя: роль `guest` и ровно один чат в `--chat-ids`:\n  $ pachca users create",
+        "Онбординг нового сотрудника — Создай аккаунт:\n  $ pachca users create"
     ];
     static scope = "users:create";
     static apiMethod = "POST";
@@ -142,7 +142,7 @@ export default class UsersCreate extends BaseCommand {
             path: '/users',
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/users/delete.js

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class UsersDelete extends BaseCommand {
     static description = "Удаление сотрудника";
     static examples = [
-        "Offboarding сотрудника:\n  $ pachca users delete"
+        "Offboarding сотрудника — Опционально: удалить аккаунт полностью:\n  $ pachca users delete"
     ];
     static scope = "users:delete";
     static apiMethod = "DELETE";

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

@@ -4,7 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class UsersGetStatus extends BaseCommand {
     static description = "Статус сотрудника";
     static examples = [
-        "Управление статусом сотрудника:\n  $ pachca users get-status"
+        "Управление статусом сотрудника — Получить текущий статус:\n  $ pachca users get-status"
     ];
     static scope = "user_status:read";
     static apiMethod = "GET";
@@ -26,7 +26,7 @@ export default class UsersGetStatus extends BaseCommand {
             method: 'GET',
             path: `/users/${args.user_id}/status`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/users/get.js

@@ -4,7 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class UsersGet extends BaseCommand {
     static description = "Информация о сотруднике";
     static examples = [
-        "Получить сотрудника по ID:\n  $ pachca users get"
+        "Получить сотрудника по ID — Получи информацию о сотруднике:\n  $ pachca users get"
     ];
     static scope = "users:read";
     static apiMethod = "GET";
@@ -26,7 +26,7 @@ export default class UsersGet extends BaseCommand {
             method: 'GET',
             path: `/users/${args.id}`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/users/list.js

@@ -4,9 +4,9 @@ import { BaseCommand } from '../../base-command.js';
 export default class UsersList extends BaseCommand {
     static description = "Список сотрудников";
     static examples = [
-        "Проверить, кто прочитал сообщение:\n  $ pachca users list",
-        "Разослать уведомление нескольким пользователям:\n  $ pachca users list",
-        "Найти сотрудника по имени или email:\n  $ pachca users list"
+        "Проверить, кто прочитал сообщение — При необходимости сопоставь с именами сотрудников:\n  $ pachca users list",
+        "Разослать уведомление нескольким пользователям — Определи список `user_id` получателей:\n  $ pachca users list",
+        "Найти сотрудника по имени или email — Поиск по имени/email (частичное совпадение):\n  $ pachca users list"
     ];
     static scope = "users:read";
     static apiMethod = "GET";
@@ -92,7 +92,7 @@ export default class UsersList extends BaseCommand {
                 cursor: flags.cursor,
             },
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const items = responseBody.data ?? responseBody;
         this.output(items);
     }

package/dist/commands/users/remove-avatar.js

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class UsersRemoveAvatar extends BaseCommand {
     static description = "Удаление аватара сотрудника";
     static examples = [
-        "Удалить аватар сотрудника:\n  $ pachca users remove-avatar"
+        "Удалить аватар сотрудника — Удали аватар сотрудника:\n  $ pachca users remove-avatar"
     ];
     static scope = "user_avatar:write";
     static apiMethod = "DELETE";

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

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class UsersRemoveStatus extends BaseCommand {
     static description = "Удаление статуса сотрудника";
     static examples = [
-        "Управление статусом сотрудника:\n  $ pachca users remove-status"
+        "Управление статусом сотрудника — Удалить статус:\n  $ pachca users remove-status"
     ];
     static scope = "user_status:write";
     static apiMethod = "DELETE";

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

@@ -6,7 +6,7 @@ import * as path from 'node:path';
 export default class UsersUpdateAvatar extends BaseCommand {
     static description = "Загрузка аватара сотрудника";
     static examples = [
-        "Загрузить аватар сотрудника:\n  $ pachca users update-avatar"
+        "Загрузить аватар сотрудника — Загрузи аватар сотруднику:\n  $ pachca users update-avatar"
     ];
     static scope = "user_avatar:write";
     static apiMethod = "PUT";
@@ -47,7 +47,7 @@ export default class UsersUpdateAvatar extends BaseCommand {
             path: `/users/${args.user_id}/avatar`,
             formData,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

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

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class UsersUpdateStatus extends BaseCommand {
     static description = "Новый статус сотрудника";
     static examples = [
-        "Управление статусом сотрудника:\n  $ pachca users update-status"
+        "Управление статусом сотрудника — Установить статус:\n  $ pachca users update-status"
     ];
     static scope = "user_status:write";
     static apiMethod = "PUT";
@@ -98,7 +98,7 @@ export default class UsersUpdateStatus extends BaseCommand {
             path: `/users/${args.user_id}/status`,
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/users/update.js

@@ -4,8 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class UsersUpdate extends BaseCommand {
     static description = "Редактирование сотрудника";
     static examples = [
-        "Массовое создание сотрудников с тегами:\n  $ pachca users update",
-        "Offboarding сотрудника:\n  $ pachca users update"
+        "Массовое создание сотрудников с тегами — Или обнови существующего:\n  $ pachca users update",
+        "Offboarding сотрудника — Заблокировать доступ:\n  $ pachca users update"
     ];
     static scope = "users:update";
     static apiMethod = "PUT";
@@ -106,7 +106,7 @@ export default class UsersUpdate extends BaseCommand {
             path: `/users/${args.id}`,
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/views/open.js

@@ -5,9 +5,9 @@ import * as clack from '@clack/prompts';
 export default class ViewsOpen extends BaseCommand {
     static description = "Открытие представления";
     static examples = [
-        "Показать интерактивную форму пользователю:\n  $ pachca views open",
-        "Опрос сотрудников через форму:\n  $ pachca views open",
-        "Форма заявки/запроса:\n  $ pachca views open"
+        "Показать интерактивную форму пользователю — Немедленно открой форму:\n  $ pachca views open",
+        "Опрос сотрудников через форму — Открой форму с полями опроса:\n  $ pachca views open",
+        "Форма заявки/запроса — При нажатии открой форму с полями: тема, описание, приоритет:\n  $ pachca views open"
     ];
     static scope = "views:write";
     static apiMethod = "POST";
@@ -123,7 +123,7 @@ export default class ViewsOpen extends BaseCommand {
             path: '/views/open',
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/data/changelog.json

@@ -1,4 +1,55 @@
 [
+    {
+        "version": "2026.7.2",
+        "date": "27 июля 2026",
+        "changes": [
+            {
+                "type": "-",
+                "command": "files direct-url",
+                "description": "Файл теперь добавляется в форму последним — S3 игнорирует поля после файла, из-за чего загрузка отклонялась с 400"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "Явный `--profile` больше не перебивается переменной `PACHCA_TOKEN` — команда с указанным профилем не уйдёт в чужое пространство"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "Запись (`POST`/`DELETE`/`PATCH`) больше не повторяется автоматически при 503 — повтор мог создать дубль сообщения"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "`Retry-After` в формате даты больше не игнорируется, значение ограничено разумным пределом"
+            },
+            {
+                "type": "-",
+                "command": "chats download-export",
+                "description": "Имя файла из `Content-Disposition` больше не может увести запись за пределы указанной папки"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "Вывод `-o csv`: ячейки, начинающиеся с `=`, `+`, `-` или `@`, экранируются; объекты и массивы выводятся как JSON, а не `[object Object]`"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "`--timeout` меньше 1 отклоняется, а не приводит к мгновенной отмене запроса"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "Примеры в `--help` подписаны шагом сценария, а не общим заголовком (`reactions remove` больше не подписан «Добавить реакцию»)"
+            },
+            {
+                "type": "-",
+                "command": "files direct-url",
+                "description": "Команда больше не падает с TypeError при успешной загрузке: S3 отвечает 204 с пустым телом, а команда пыталась прочитать из него поле"
+            }
+        ]
+    },
     {
         "version": "2026.7.1",
         "date": "24 июля 2026",