@pachca/cli 2026.7.0 → 2026.7.2

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 2026.7.2  (27 июля 2026)
+
+- **Удалено** (files direct-url): Файл теперь добавляется в форму последним — S3 игнорирует поля после файла, из-за чего загрузка отклонялась с 400
+- **Удалено**: Явный `--profile` больше не перебивается переменной `PACHCA_TOKEN` — команда с указанным профилем не уйдёт в чужое пространство
+- **Удалено**: Запись (`POST`/`DELETE`/`PATCH`) больше не повторяется автоматически при 503 — повтор мог создать дубль сообщения
+- **Удалено**: `Retry-After` в формате даты больше не игнорируется, значение ограничено разумным пределом
+- **Удалено** (chats download-export): Имя файла из `Content-Disposition` больше не может увести запись за пределы указанной папки
+- **Удалено**: Вывод `-o csv`: ячейки, начинающиеся с `=`, `+`, `-` или `@`, экранируются; объекты и массивы выводятся как JSON, а не `[object Object]`
+- **Удалено**: `--timeout` меньше 1 отклоняется, а не приводит к мгновенной отмене запроса
+- **Удалено**: Примеры в `--help` подписаны шагом сценария, а не общим заголовком (`reactions remove` больше не подписан «Добавить реакцию»)
+- **Удалено** (files direct-url): Команда больше не падает с TypeError при успешной загрузке: S3 отвечает 204 с пустым телом, а команда пыталась прочитать из него поле
+
+## 2026.7.1  (24 июля 2026)
+
+- **Добавлено** (threads create): Новая команда — создание самостоятельного треда без привязки к сообщению
+- **Удалено**: Примеры в `--help` больше не смешиваются между командами с общим путём (например, create и list одного ресурса показывали примеры друг друга)
+
 ## 2026.7.0  (7 июля 2026)
 
 - **Добавлено** (bots list): Новая команда — список ботов с поиском по имени (`--query`)

package/README.md

@@ -170,6 +170,7 @@ pachca guide            # список всех сценариев
 | Команда | Описание |
 |---------|---------|
 | `pachca threads add` | Новый тред |
+| `pachca threads create` | Новый самостоятельный тред |
 | `pachca threads list` | Список тредов |
 | `pachca threads get` | Информация о треде |
 
@@ -391,7 +392,7 @@ pachca autocomplete powershell  # PowerShell completion
 
 | Переменная | Описание |
 |-----------|---------|
-| `PACHCA_TOKEN` | Bearer-токен (высший приоритет, удобно для CI) |
+| `PACHCA_TOKEN` | Bearer-токен, удобно для CI. Приоритетнее профиля, но флаги `--token` и `--profile` его перебивают |
 | `PACHCA_PROFILE` | Активный профиль для команды |
 | `PACHCA_TIMEOUT` | Таймаут запроса в секундах (по умолчанию 30) |
 | `PACHCA_PROMPT_DISABLED` | Отключить интерактивные промпты |

package/README.template.md

@@ -209,7 +209,7 @@ pachca autocomplete powershell  # PowerShell completion
 
 | Переменная | Описание |
 |-----------|---------|
-| `PACHCA_TOKEN` | Bearer-токен (высший приоритет, удобно для CI) |
+| `PACHCA_TOKEN` | Bearer-токен, удобно для CI. Приоритетнее профиля, но флаги `--token` и `--profile` его перебивают |
 | `PACHCA_PROFILE` | Активный профиль для команды |
 | `PACHCA_TIMEOUT` | Таймаут запроса в секундах (по умолчанию 30) |
 | `PACHCA_PROMPT_DISABLED` | Отключить интерактивные промпты |

package/dist/base-command.js

@@ -53,6 +53,8 @@ export class BaseCommand extends Command {
         }),
         timeout: Flags.integer({
             description: 'Request timeout in seconds',
+            // 0 or negative would abort on the next tick; fail loudly instead.
+            min: 1,
         }),
         'no-retry': Flags.boolean({
             description: 'Disable auto-retry on 429/503',

package/dist/client.js

@@ -74,12 +74,35 @@ export function formatDryRun(opts, isJson) {
     }
     return lines.join('\n');
 }
+/** Longest we honour a server-supplied `Retry-After` before falling back. */
+const MAX_RETRY_AFTER_MS = 60_000;
+/**
+ * `Retry-After` in milliseconds. RFC 9110 allows both delta-seconds and an
+ * HTTP-date; parsing only the former turned a date into NaN and silently
+ * discarded the server's backoff. Negative and absurd values are clamped so a
+ * hostile or buggy header can neither hot-loop nor park the CLI for a day.
+ */
+function parseRetryAfter(header) {
+    if (!header)
+        return 1000;
+    const seconds = Number.parseInt(header, 10);
+    const ms = Number.isNaN(seconds) ? Date.parse(header) - Date.now() : seconds * 1000;
+    if (Number.isNaN(ms))
+        return 1000;
+    return Math.min(Math.max(ms, 0), MAX_RETRY_AFTER_MS);
+}
 export async function request(opts, clientFlags) {
     const url = buildUrl(opts.path, opts.query);
     const rawEnvTimeout = process.env.PACHCA_TIMEOUT ? Number(process.env.PACHCA_TIMEOUT) : undefined;
     const envTimeout = rawEnvTimeout && !Number.isNaN(rawEnvTimeout) ? rawEnvTimeout : undefined;
-    const timeoutSeconds = opts.timeout ?? clientFlags?.timeout ?? envTimeout ?? DEFAULT_TIMEOUT;
+    const requestedTimeout = opts.timeout ?? clientFlags?.timeout ?? envTimeout ?? DEFAULT_TIMEOUT;
+    // A non-positive timeout aborts on the next tick, which is never what anyone
+    // means by `--timeout 0`. The env var already ignored 0; make the flag agree.
+    const timeoutSeconds = requestedTimeout > 0 ? requestedTimeout : DEFAULT_TIMEOUT;
     const noRetry = opts.noRetry ?? clientFlags?.['no-retry'] ?? false;
+    // Retrying a request the server may already have committed duplicates it.
+    // Only these methods are safe to repeat blindly.
+    const safeMethod = ['GET', 'HEAD', 'OPTIONS', 'PUT'].includes(opts.method);
     const fetchHeaders = {
         ...(opts.noAuth ? {} : { Authorization: `Bearer ${opts.token}` }),
         Accept: 'application/json',
@@ -106,14 +129,21 @@ export async function request(opts, clientFlags) {
         try {
             const controller = new AbortController();
             const timer = setTimeout(() => controller.abort(), timeoutSeconds * 1000);
-            const response = await fetch(url, {
-                method: opts.method,
-                headers: fetchHeaders,
-                body: fetchBody,
-                signal: controller.signal,
-                redirect: opts.isRedirect ? 'manual' : 'follow',
-            });
-            clearTimeout(timer);
+            let response;
+            try {
+                response = await fetch(url, {
+                    method: opts.method,
+                    headers: fetchHeaders,
+                    body: fetchBody,
+                    signal: controller.signal,
+                    redirect: opts.isRedirect ? 'manual' : 'follow',
+                });
+            }
+            finally {
+                // Must run on reject too: a leaked timer keeps the event loop alive and
+                // the CLI hangs for the full timeout after an otherwise successful retry.
+                clearTimeout(timer);
+            }
             if (clientFlags?.verbose) {
                 process.stderr.write(`${ansis.dim(`← ${response.status} ${response.statusText}`)}\n`);
             }
@@ -127,19 +157,20 @@ export async function request(opts, clientFlags) {
                     headers: response.headers,
                 };
             }
-            // Handle rate limiting (429)
+            // Handle rate limiting (429). Safe for any method: a throttled request
+            // was rejected before it was processed, so it cannot have been committed.
             if (response.status === 429 && !noRetry && attempt < MAX_RETRIES) {
-                const retryAfter = response.headers.get('retry-after');
-                const parsed = retryAfter ? Number.parseInt(retryAfter, 10) : NaN;
-                const waitMs = Number.isNaN(parsed) ? 1000 : parsed * 1000;
+                const waitMs = parseRetryAfter(response.headers.get('retry-after'));
                 if (clientFlags?.verbose) {
                     process.stderr.write(`${ansis.dim(`⏳ Rate limited, retrying in ${waitMs}ms...`)}\n`);
                 }
                 await sleep(waitMs);
                 continue;
             }
-            // Handle 503 with backoff
-            if (response.status === 503 && !noRetry && attempt < MAX_RETRIES) {
+            // Handle 503 with backoff. Unlike 429, a 503 from a proxy or a draining
+            // load balancer says nothing about whether the backend already committed
+            // the write — retrying a POST there duplicates the message.
+            if (response.status === 503 && safeMethod && !noRetry && attempt < MAX_RETRIES) {
                 const baseMs = 1000;
                 const waitMs = baseMs * Math.pow(2, attempt) + Math.random() * baseMs;
                 if (clientFlags?.verbose) {
@@ -184,7 +215,6 @@ export async function request(opts, clientFlags) {
             }
             lastError = error;
             // Only retry network errors for idempotent methods (not POST/DELETE)
-            const safeMethod = ['GET', 'HEAD', 'OPTIONS', 'PUT'].includes(opts.method);
             if (!safeMethod || noRetry || attempt >= MAX_RETRIES) {
                 break;
             }
@@ -292,7 +322,11 @@ export async function downloadFile(url, savePath) {
                 const urlPath = new URL(url).pathname;
                 filename = path.basename(urlPath.split('?')[0]);
             }
-            if (!filename)
+            // Strip any directory part: the name comes from a Content-Disposition on
+            // a redirect target outside our trust boundary, and `../../..` in it would
+            // otherwise let the response choose where on disk to write.
+            filename = path.basename(filename);
+            if (!filename || filename === '.' || filename === '..')
                 filename = 'download';
             if (!fs.existsSync(savePath)) {
                 throw new Error(`Directory does not exist: ${savePath}`);

package/dist/commands/bots/create.js

@@ -5,9 +5,8 @@ import * as clack from '@clack/prompts';
 export default class BotsCreate extends BaseCommand {
     static description = "Новый бот";
     static examples = [
-        "Создать бота через API и получить токен:\n  $ pachca bots create",
-        "Настроить бота с исходящим вебхуком:\n  $ pachca bots create",
-        "Найти и удалить бота:\n  $ pachca bots list"
+        "Создать бота через API и получить токен — Создай бота. Только пользовательским токеном (не токеном бота); `nickname` обязан заканчиваться на `_bot`. Параметры вебхука (Webhook URL, события, команды) можно задать сразу или позже. Скоупы токена бота можно ограничить флагом `--scopes` (если не указать — бот получит набор по умолчанию):\n  $ pachca bots create",
+        "Настроить бота с исходящим вебхуком — Создай бота, сразу указав Webhook URL и события в одном вызове (детали создания и работы с токеном — в сценарии «Создать бота через API и получить токен»):\n  $ pachca bots create"
     ];
     static scope = "bots:write";
     static apiMethod = "POST";
@@ -18,10 +17,10 @@ export default class BotsCreate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Имя бота",
+            description: "Имя бота (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Никнейм бота. Должен заканчиваться на `_bot`.",
+            description: "Никнейм бота. Должен заканчиваться на `_bot`. (макс. 255 символов)",
         }),
         'outgoing-url': Flags.string({
             description: "URL исходящего вебхука",
@@ -33,10 +32,10 @@ export default class BotsCreate extends BaseCommand {
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
-            description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию.",
+            description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",
         }),
         'template': Flags.string({
             description: "Шаблон форматирования входящего вебхука",
@@ -99,6 +98,16 @@ export default class BotsCreate extends BaseCommand {
                 this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --name <string>. pachca introspect bots create" });
             }
         }
+        const validationErrors = [];
+        if (flags['name'] && String(flags['name']).length > 255) {
+            validationErrors.push({ message: `--name: максимум 255 символов (передано: ${String(flags['name']).length})`, flag: 'name' });
+        }
+        if (flags['nickname'] && String(flags['nickname']).length > 255) {
+            validationErrors.push({ message: `--nickname: максимум 255 символов (передано: ${String(flags['nickname']).length})`, flag: 'nickname' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = { webhook: {
                 name: flags['name'],
                 nickname: flags['nickname'],
@@ -128,7 +137,7 @@ export default class BotsCreate extends BaseCommand {
             path: '/bots',
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/bots/delete.js

@@ -5,8 +5,7 @@ import * as clack from '@clack/prompts';
 export default class BotsDelete extends BaseCommand {
     static description = "Удаление бота";
     static examples = [
-        "Обновить Webhook URL бота:\n  $ pachca bots update",
-        "Найти и удалить бота:\n  $ pachca bots delete"
+        "Найти и удалить бота — Возьми `id` нужного бота из списка и удали его (скоуп `bots:write`). Доступно администратору, владельцу компании или создателю бота — владельцы чатов удалять бота не могут. Прежний токен инвалидируется сразу, бот исключается из всех чатов, его исходящий вебхук удаляется:\n  $ pachca bots delete"
     ];
     static scope = "bots:write";
     static apiMethod = "DELETE";

package/dist/commands/bots/get.js

@@ -3,10 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class BotsGet extends BaseCommand {
     static description = "Информация о боте";
-    static examples = [
-        "Обновить Webhook URL бота:\n  $ pachca bots update",
-        "Найти и удалить бота:\n  $ pachca bots delete"
-    ];
     static scope = "bots:read";
     static apiMethod = "GET";
     static apiPath = "/bots/{id}";
@@ -27,7 +23,7 @@ export default class BotsGet extends BaseCommand {
             method: 'GET',
             path: `/bots/${args.id}`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/bots/list-events.js

@@ -4,7 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsListEvents extends BaseCommand {
     static description = "История событий";
     static examples = [
-        "Обработка событий через историю (polling):\n  $ pachca bots list-events"
+        "Обработка событий через историю (polling) — Получи накопленные события:\n  $ pachca bots list-events"
     ];
     static scope = "webhooks:events:read";
     static apiMethod = "GET";
@@ -85,7 +85,7 @@ export default class BotsListEvents extends BaseCommand {
                 cursor: flags.cursor,
             },
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const items = responseBody.data ?? responseBody;
         this.output(items);
     }

package/dist/commands/bots/list.js

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

package/dist/commands/bots/recreate-token-self.js

@@ -2,7 +2,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsRecreateTokenSelf extends BaseCommand {
     static description = "Ротация собственного токена бота";
     static examples = [
-        "Ротация токена бота:\n  $ pachca bots recreate-token-self"
+        "Ротация токена бота — Или: бот перевыпускает собственный токен своим же токеном (скоуп `bot_self:write`). Токен, которым выполнен запрос, инвалидируется сразу — обязательно сохрани новый `access_token` из ответа, иначе бот потеряет доступ к API:\n  $ pachca bots recreate-token-self"
     ];
     static scope = "bot_self:write";
     static apiMethod = "POST";
@@ -19,7 +19,7 @@ export default class BotsRecreateTokenSelf extends BaseCommand {
             method: 'POST',
             path: '/bot/recreate_token',
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/bots/recreate-token.js

@@ -4,7 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsRecreateToken extends BaseCommand {
     static description = "Ротация токена бота";
     static examples = [
-        "Ротация токена бота:\n  $ pachca bots recreate-token"
+        "Ротация токена бота — Пользовательским токеном (администратор, владелец компании или создатель бота) — перевыпусти токен по `id` бота. Прежний токен инвалидируется сразу:\n  $ pachca bots recreate-token"
     ];
     static scope = "bots:write";
     static apiMethod = "POST";
@@ -26,7 +26,7 @@ export default class BotsRecreateToken extends BaseCommand {
             method: 'POST',
             path: `/bots/${args.id}/recreate_token`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/bots/remove-event.js

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class BotsRemoveEvent extends BaseCommand {
     static description = "Удаление события";
     static examples = [
-        "Обработка событий через историю (polling):\n  $ pachca bots remove-event"
+        "Обработка событий через историю (polling) — Удали обработанное событие:\n  $ pachca bots remove-event"
     ];
     static scope = "webhooks:events:delete";
     static apiMethod = "DELETE";

package/dist/commands/bots/update-webhook.js

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class BotsUpdateWebhook extends BaseCommand {
     static description = "Саморегистрация вебхука бота";
     static examples = [
-        "Обновить Webhook URL бота:\n  $ pachca bots update-webhook"
+        "Обновить Webhook URL бота — Или: бот сам обновляет свой webhook своим же токеном — без `id` и без участия администратора (нужен скоуп `bot_self:webhook:write`):\n  $ pachca bots update-webhook"
     ];
     static scope = "bot_self:webhook:write";
     static apiMethod = "PUT";
@@ -65,7 +65,7 @@ export default class BotsUpdateWebhook extends BaseCommand {
             path: '/bot/webhook',
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/bots/update.js

@@ -4,8 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class BotsUpdate extends BaseCommand {
     static description = "Редактирование бота";
     static examples = [
-        "Обновить Webhook URL бота:\n  $ pachca bots update",
-        "Найти и удалить бота:\n  $ pachca bots delete"
+        "Обновить Webhook URL бота — Пользовательским токеном (с правом редактировать бота) — обнови URL по `id` бота. Пустая строка отключает вебхук:\n  $ pachca bots update"
     ];
     static scope = "bots:write";
     static apiMethod = "PUT";
@@ -20,10 +19,10 @@ export default class BotsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Имя бота",
+            description: "Имя бота (макс. 255 символов)",
         }),
         'nickname': Flags.string({
-            description: "Никнейм бота. Должен заканчиваться на `_bot`.",
+            description: "Никнейм бота. Должен заканчиваться на `_bot`. (макс. 255 символов)",
         }),
         'outgoing-url': Flags.string({
             description: "URL исходящего вебхука",
@@ -35,10 +34,10 @@ export default class BotsUpdate extends BaseCommand {
             description: "Условие срабатывания исходящего вебхука",
         }),
         'commands': Flags.string({
-            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands",
+            description: "Команды бота (триггер-слова), на которые он реагирует при trigger_on = commands. Суммарная длина команд, объединённых через запятую, не должна превышать 255 символов.",
         }),
         'scopes': Flags.string({
-            description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию.",
+            description: "Скоупы (права доступа) токена бота. Если не указано, бот получает набор по умолчанию. Боту доступны не все скоупы: часть из них разрешена только пользовательским ролям, и попытка назначить такой скоуп возвращает `400`. Служебные значения `bot` и `all` назначать нельзя.",
         }),
         'template': Flags.string({
             description: "Шаблон форматирования входящего вебхука",
@@ -71,6 +70,16 @@ export default class BotsUpdate extends BaseCommand {
     async run() {
         const { args, flags } = await this.parse(BotsUpdate);
         this.parsedFlags = flags;
+        const validationErrors = [];
+        if (flags['name'] && String(flags['name']).length > 255) {
+            validationErrors.push({ message: `--name: максимум 255 символов (передано: ${String(flags['name']).length})`, flag: 'name' });
+        }
+        if (flags['nickname'] && String(flags['nickname']).length > 255) {
+            validationErrors.push({ message: `--nickname: максимум 255 символов (передано: ${String(flags['nickname']).length})`, flag: 'nickname' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = { webhook: {
                 name: flags['name'],
                 nickname: flags['nickname'],
@@ -102,7 +111,7 @@ export default class BotsUpdate extends BaseCommand {
             path: `/bots/${args.id}`,
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/chats/archive.js

@@ -4,8 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class ChatsArchive extends BaseCommand {
     static description = "Архивация чата";
     static examples = [
-        "Архивация и управление чатом:\n  $ pachca chats archive",
-        "Найти и заархивировать неактивные чаты:\n  $ pachca chats archive"
+        "Архивация и управление чатом — Архивировать чат:\n  $ pachca chats archive",
+        "Найти и заархивировать неактивные чаты — Для каждого чата: архивируй:\n  $ pachca chats archive"
     ];
     static scope = "chats:archive";
     static apiMethod = "PUT";
@@ -26,7 +26,7 @@ export default class ChatsArchive extends BaseCommand {
             method: 'PUT',
             path: `/chats/${args.id}/archive`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/chats/create.js

@@ -5,9 +5,8 @@ import * as clack from '@clack/prompts';
 export default class ChatsCreate extends BaseCommand {
     static description = "Новый чат";
     static examples = [
-        "Создать канал и пригласить участников:\n  $ pachca chats create",
-        "Создать проектную беседу из шаблона:\n  $ pachca chats create",
-        "Найти активные чаты за период:\n  $ pachca chats list"
+        "Создать канал и пригласить участников — Создай канал с участниками:\n  $ pachca chats create",
+        "Создать проектную беседу из шаблона — Создай беседу с участниками из тега:\n  $ pachca chats create"
     ];
     static scope = "chats:create";
     static apiMethod = "POST";
@@ -18,7 +17,7 @@ export default class ChatsCreate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'name': Flags.string({
-            description: "Название",
+            description: "Название (макс. 255 символов)",
         }),
         'member-ids': Flags.string({
             description: "Массив идентификаторов пользователей, которые станут участниками",
@@ -64,6 +63,13 @@ export default class ChatsCreate extends BaseCommand {
                 this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --name <string>. pachca introspect chats create" });
             }
         }
+        const validationErrors = [];
+        if (flags['name'] && String(flags['name']).length > 255) {
+            validationErrors.push({ message: `--name: максимум 255 символов (передано: ${String(flags['name']).length})`, flag: 'name' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
+        }
         const body = { chat: {
                 name: flags['name'],
                 member_ids: flags['member-ids'] ? this.parseJSON(flags['member-ids'], 'member-ids') : undefined,
@@ -82,7 +88,7 @@ export default class ChatsCreate extends BaseCommand {
             path: '/chats',
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/chats/download-export.js

@@ -6,7 +6,7 @@ import { formatSize } from '../../utils.js';
 export default class ChatsDownloadExport extends BaseCommand {
     static description = "Скачать архив экспорта";
     static examples = [
-        "Экспорт истории чата:\n  $ pachca chats download-export"
+        "Экспорт истории чата — Скачай файл экспорта:\n  $ pachca chats download-export"
     ];
     static hiddenAliases = ["common:get-exports"];
     static scope = "chat_exports:read";
@@ -39,7 +39,7 @@ export default class ChatsDownloadExport extends BaseCommand {
             this.success(`Сохранено: ${flags.save} (${formatSize(result.size)})`);
             return;
         }
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/chats/get.js

@@ -3,9 +3,6 @@ import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsGet extends BaseCommand {
     static description = "Информация о чате";
-    static examples = [
-        "Переименовать или обновить чат:\n  $ pachca chats update"
-    ];
     static scope = "chats:read";
     static apiMethod = "GET";
     static apiPath = "/chats/{id}";
@@ -26,7 +23,7 @@ export default class ChatsGet extends BaseCommand {
             method: 'GET',
             path: `/chats/${args.id}`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/chats/list.js

@@ -4,9 +4,9 @@ import { BaseCommand } from '../../base-command.js';
 export default class ChatsList extends BaseCommand {
     static description = "Список чатов";
     static examples = [
-        "Создать канал и пригласить участников:\n  $ pachca chats create",
-        "Создать проектную беседу из шаблона:\n  $ pachca chats create",
-        "Найти активные чаты за период:\n  $ pachca chats list"
+        "Найти активные чаты за период — Получи чаты с активностью после указанной даты:\n  $ pachca chats list",
+        "Найти и заархивировать неактивные чаты — Получи чаты без активности с нужной даты:\n  $ pachca chats list",
+        "Создать гостя в чат — Выбери активный чат, в который добавить гостя — узнай его ID:\n  $ pachca chats list"
     ];
     static scope = "chats:read";
     static apiMethod = "GET";
@@ -124,7 +124,7 @@ export default class ChatsList extends BaseCommand {
                 cursor: flags.cursor,
             },
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const items = responseBody.data ?? responseBody;
         this.output(items);
     }

package/dist/commands/chats/request-export.js

@@ -5,7 +5,7 @@ import * as clack from '@clack/prompts';
 export default class ChatsRequestExport extends BaseCommand {
     static description = "Экспорт сообщений";
     static examples = [
-        "Экспорт истории чата:\n  $ pachca chats request-export"
+        "Экспорт истории чата — Запроси экспорт:\n  $ pachca chats request-export"
     ];
     static hiddenAliases = ["common:request-export"];
     static scope = "chat_exports:write";
@@ -81,7 +81,7 @@ export default class ChatsRequestExport extends BaseCommand {
             path: '/chats/exports',
             body,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }

package/dist/commands/chats/unarchive.js

@@ -4,7 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class ChatsUnarchive extends BaseCommand {
     static description = "Разархивация чата";
     static examples = [
-        "Архивация и управление чатом:\n  $ pachca chats unarchive"
+        "Архивация и управление чатом — Разархивировать чат:\n  $ pachca chats unarchive"
     ];
     static scope = "chats:archive";
     static apiMethod = "PUT";
@@ -25,7 +25,7 @@ export default class ChatsUnarchive extends BaseCommand {
             method: 'PUT',
             path: `/chats/${args.id}/unarchive`,
         });
-        const responseBody = data;
+        const responseBody = (data ?? {});
         const result = responseBody.data ?? responseBody;
         this.output(result);
     }