@pachca/cli 2026.3.3 → 2026.3.5

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## 2026.3.5  (7 марта 2026)
+
+- **Изменено** (guide): Сценарии переписаны на CLI-примеры с подсказками вместо описаний API-методов
+- **Добавлено** (views open): Пример «Форма заявки/запроса»
+
+## 2026.3.4  (5 марта 2026)
+
+- **Добавлено** (all): Переменная окружения PACHCA_API_URL для использования кастомного base URL
+- **Изменено** (all): Исправлено выравнивание в уведомлении о доступном обновлении
+
+## 2026.3.3  (4 марта 2026)
+
+- **Добавлено** (all): Структурированные ошибки валидации: type, flag, hint в JSON-выводе
+- **Добавлено** (all): Батчинг ошибок валидации — все ошибки выводятся разом, а не по одной
+- **Добавлено** (all): Hint-подсказки в ошибках авторизации и профиля (pachca auth login, pachca auth list)
+- **Добавлено** (all): Описания команд и топиков переведены на русский язык
+- **Добавлено** (all): Подсказки связанных команд в описаниях ID-флагов (pachca chats list, pachca users list)
+- **Изменено** (introspect): Аргументы команды (args) в выводе, requiredFlags, улучшенная ошибка «команда не найдена»
+- **Изменено** (commands): Поле summary в выводе команд
+- **Изменено** (guide): Компактный вывод шагов ($ command), структурированные данные сценариев, фильтрация шагов без CLI-команд
+
+## 2026.3.2  (4 марта 2026)
+
+- **Изменено** (auth login): Исправлена обработка ответа /oauth/token/info (обёртка { data })
+- **Изменено** (auth refresh): Исправлена обработка ответа /oauth/token/info (обёртка { data })
+- **Изменено** (doctor): Исправлена обработка ответа /oauth/token/info (обёртка { data })
+- **Изменено** (commands): --available фильтрует недоступные команды вместо колонки available
+- **Изменено** (auth login): Fallback-имя «User #ID» вместо «Unknown» при недоступном профиле
+- **Изменено** (all): --version пропускает проверку авторизации
+
+## 2026.3.1  (4 марта 2026)
+
+- **Добавлено** (all): Все флаги в kebab-case (--first-name, --entity-id, --phone-number)
+- **Добавлено** (all): Boolean-флаги с --no- префиксом (--suspended / --no-suspended)
+- **Добавлено** (all): Хинт «через запятую» для массивных параметров (--chat-ids, --user-ids)
+- **Добавлено** (all): DELETE --json выводит {"ok":true} в stdout
+- **Добавлено** (all): POST/DELETE не ретраятся при сетевых ошибках
+- **Добавлено** (common direct-url): Флаги в kebab-case, корректные wire names в FormData
+- **Добавлено** (chats list): Флаг --sort-last-message-at (был --sort-last_message_at)
+- **Добавлено** (guide): Поиск по сценариям использования API
+- **Добавлено** (doctor): Диагностика окружения (Node.js, сеть, токен, версия)
+- **Добавлено** (introspect): Метаинформация о командах и флагах для агентов
+- **Добавлено** (api): Прямые HTTP-запросы с -f/-F, --input, --query

package/README.md

@@ -158,12 +158,12 @@ pachca guide            # список всех сценариев
 |---------|---------|
 | `pachca read-member list-readers` | Список прочитавших сообщение |
 
-### thread
+### threads
 
 | Команда | Описание |
 |---------|---------|
-| `pachca thread add` | Новый тред |
-| `pachca thread get` | Информация о треде |
+| `pachca threads add` | Новый тред |
+| `pachca threads get` | Информация о треде |
 
 ### profile
 

package/dist/base-command.js

@@ -285,4 +285,3 @@ export class BaseCommand extends Command {
         throw err;
     }
 }
-//# sourceMappingURL=base-command.js.map

package/dist/client.js

@@ -307,4 +307,3 @@ function isRecord(value) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-//# sourceMappingURL=client.js.map

package/dist/commands/api.js

@@ -209,4 +209,3 @@ export function parseTypedValue(value) {
     }
     return value;
 }
-//# sourceMappingURL=api.js.map

package/dist/commands/auth/list.js

@@ -36,4 +36,3 @@ export default class AuthList extends BaseCommand {
         this.output(entries);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/auth/login.js

@@ -138,4 +138,3 @@ export default class AuthLogin extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=login.js.map

package/dist/commands/auth/logout.js

@@ -78,4 +78,3 @@ export default class AuthLogout extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=logout.js.map

package/dist/commands/auth/refresh.js

@@ -65,4 +65,3 @@ export default class AuthRefresh extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=refresh.js.map

package/dist/commands/auth/status.js

@@ -48,4 +48,3 @@ export default class AuthStatus extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=status.js.map

package/dist/commands/auth/switch.js

@@ -34,4 +34,3 @@ export default class AuthSwitch extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=switch.js.map

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

@@ -82,4 +82,3 @@ export default class BotsListEvents extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list-events.js.map

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

@@ -44,4 +44,3 @@ export default class BotsRemoveEvent extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=remove-event.js.map

package/dist/commands/bots/update.js

@@ -76,4 +76,3 @@ export default class BotsUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/changelog.js

@@ -1,3 +1,4 @@
+import semver from 'semver';
 import { BaseCommand } from '../base-command.js';
 export default class Changelog extends BaseCommand {
     static description = 'История изменений CLI';
@@ -14,7 +15,7 @@ export default class Changelog extends BaseCommand {
         let entries = [];
         try {
             const data = await import('../data/changelog.json', { with: { type: 'json' } });
-            entries = (data.default || data);
+            entries = (data.default || data).filter((e) => e.version !== '0.0.0');
         }
         catch {
             entries = [];
@@ -28,6 +29,18 @@ export default class Changelog extends BaseCommand {
             process.stdout.write('Нет записей в changelog.\n');
             return;
         }
+        // Sort by version descending (newest first)
+        entries.sort((a, b) => {
+            const av = semver.valid(a.version);
+            const bv = semver.valid(b.version);
+            if (av && bv)
+                return semver.rcompare(av, bv);
+            if (av)
+                return -1;
+            if (bv)
+                return 1;
+            return 0;
+        });
         for (const entry of entries) {
             process.stdout.write(`${entry.version}  (${entry.date})\n`);
             for (const change of entry.changes) {
@@ -37,4 +50,3 @@ export default class Changelog extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=changelog.js.map

package/dist/commands/chats/archive.js

@@ -32,4 +32,3 @@ export default class ChatsArchive extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=archive.js.map

package/dist/commands/chats/create.js

@@ -5,9 +5,9 @@ import * as clack from '@clack/prompts';
 export default class ChatsCreate extends BaseCommand {
     static description = "Новый чат";
     static examples = [
-        "Найти чат по имени и отправить сообщение:\n  $ pachca chats list",
         "Создать канал и пригласить участников:\n  $ pachca chats create",
-        "Создать проектную беседу из шаблона:\n  $ pachca chats create"
+        "Создать проектную беседу из шаблона:\n  $ pachca chats create",
+        "Найти активные чаты за период:\n  $ pachca chats list"
     ];
     static scope = "chats:create";
     static apiMethod = "POST";
@@ -88,4 +88,3 @@ export default class ChatsCreate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/chats/get.js

@@ -32,4 +32,3 @@ export default class ChatsGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

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 list",
         "Создать канал и пригласить участников:\n  $ pachca chats create",
-        "Создать проектную беседу из шаблона:\n  $ pachca chats create"
+        "Создать проектную беседу из шаблона:\n  $ pachca chats create",
+        "Найти активные чаты за период:\n  $ pachca chats list"
     ];
     static scope = "chats:read";
     static apiMethod = "GET";
@@ -115,4 +115,3 @@ export default class ChatsList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/chats/unarchive.js

@@ -31,4 +31,3 @@ export default class ChatsUnarchive extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=unarchive.js.map

package/dist/commands/chats/update.js

@@ -53,4 +53,3 @@ export default class ChatsUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/commands.js

@@ -70,4 +70,3 @@ export default class Commands extends BaseCommand {
         this.output(entries);
     }
 }
-//# sourceMappingURL=commands.js.map

package/dist/commands/common/custom-properties.js

@@ -62,4 +62,3 @@ export default class CommonCustomProperties extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=custom-properties.js.map

package/dist/commands/common/direct-url.js

@@ -117,4 +117,3 @@ export default class CommonDirectUrl extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=direct-url.js.map

package/dist/commands/common/get-exports.js

@@ -44,4 +44,3 @@ export default class CommonGetExports extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get-exports.js.map

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

@@ -86,4 +86,3 @@ export default class CommonRequestExport extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=request-export.js.map

package/dist/commands/common/uploads.js

@@ -26,4 +26,3 @@ export default class CommonUploads extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=uploads.js.map

package/dist/commands/config/get.js

@@ -25,4 +25,3 @@ export default class ConfigGet extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/config/list.js

@@ -46,4 +46,3 @@ function flattenConfig(obj, exclude = [], prefix = '') {
     }
     return entries;
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/config/set.js

@@ -27,4 +27,3 @@ export default class ConfigSet extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=set.js.map

package/dist/commands/doctor.js

@@ -172,4 +172,3 @@ export default class Doctor extends BaseCommand {
         process.stderr.write(`${icons[status]} ${message}\n`);
     }
 }
-//# sourceMappingURL=doctor.js.map

package/dist/commands/group-tags/create.js

@@ -69,4 +69,3 @@ export default class GroupTagsCreate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/group-tags/delete.js

@@ -41,4 +41,3 @@ export default class GroupTagsDelete extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=delete.js.map

package/dist/commands/group-tags/get.js

@@ -29,4 +29,3 @@ export default class GroupTagsGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/group-tags/list-users.js

@@ -87,4 +87,3 @@ export default class GroupTagsListUsers extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list-users.js.map

package/dist/commands/group-tags/list.js

@@ -88,4 +88,3 @@ export default class GroupTagsList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/group-tags/update.js

@@ -73,4 +73,3 @@ export default class GroupTagsUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/guide.js

@@ -80,9 +80,11 @@ export default class Guide extends BaseCommand {
                 else {
                     process.stdout.write(`  ${i + 1}. ${step.description}\n`);
                 }
+                if (step.notes) {
+                    process.stdout.write(`     ${step.notes}\n`);
+                }
             }
             process.stdout.write('\n');
         }
     }
 }
-//# sourceMappingURL=guide.js.map

package/dist/commands/introspect.js

@@ -89,4 +89,3 @@ export default class Introspect extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=introspect.js.map

package/dist/commands/link-previews/add.js

@@ -71,4 +71,3 @@ export default class LinkPreviewsAdd extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=add.js.map

package/dist/commands/members/add-group-tags.js

@@ -68,4 +68,3 @@ export default class MembersAddGroupTags extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=add-group-tags.js.map

package/dist/commands/members/add.js

@@ -78,4 +78,3 @@ export default class MembersAdd extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=add.js.map

package/dist/commands/members/leave.js

@@ -44,4 +44,3 @@ export default class MembersLeave extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=leave.js.map

package/dist/commands/members/list.js

@@ -94,4 +94,3 @@ export default class MembersList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/members/remove-group-tag.js

@@ -45,4 +45,3 @@ export default class MembersRemoveGroupTag extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=remove-group-tag.js.map

package/dist/commands/members/remove.js

@@ -49,4 +49,3 @@ export default class MembersRemove extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=remove.js.map

package/dist/commands/members/update.js

@@ -79,4 +79,3 @@ export default class MembersUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/messages/create.js

@@ -127,4 +127,3 @@ export default class MessagesCreate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/messages/delete.js

@@ -46,4 +46,3 @@ export default class MessagesDelete extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=delete.js.map

package/dist/commands/messages/get.js

@@ -34,4 +34,3 @@ export default class MessagesGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/messages/list.js

@@ -122,4 +122,3 @@ export default class MessagesList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/messages/pin.js

@@ -32,4 +32,3 @@ export default class MessagesPin extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=pin.js.map

package/dist/commands/messages/unpin.js

@@ -45,4 +45,3 @@ export default class MessagesUnpin extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=unpin.js.map

package/dist/commands/messages/update.js

@@ -74,4 +74,3 @@ export default class MessagesUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/profile/delete-status.js

@@ -40,4 +40,3 @@ export default class ProfileDeleteStatus extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=delete-status.js.map

package/dist/commands/profile/get-info.js

@@ -23,4 +23,3 @@ export default class ProfileGetInfo extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get-info.js.map

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

@@ -26,4 +26,3 @@ export default class ProfileGetStatus extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get-status.js.map

package/dist/commands/profile/get.js

@@ -26,4 +26,3 @@ export default class ProfileGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

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

@@ -97,4 +97,3 @@ export default class ProfileUpdateStatus extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update-status.js.map

package/dist/commands/reactions/add.js

@@ -77,4 +77,3 @@ export default class ReactionsAdd extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=add.js.map

package/dist/commands/reactions/list.js

@@ -88,4 +88,3 @@ export default class ReactionsList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/reactions/remove.js

@@ -82,4 +82,3 @@ export default class ReactionsRemove extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=remove.js.map

package/dist/commands/read-member/list-readers.js

@@ -86,4 +86,3 @@ export default class ReadMemberListReaders extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list-readers.js.map

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

@@ -4,6 +4,7 @@ import { BaseCommand } from '../../base-command.js';
 export default class SearchListChats extends BaseCommand {
     static description = "Поиск чатов";
     static examples = [
+        "Найти чат по имени и отправить сообщение:\n  $ pachca search list-chats",
         "Найти чат по названию:\n  $ pachca search list-chats"
     ];
     static scope = "search:chats";
@@ -121,4 +122,3 @@ export default class SearchListChats extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list-chats.js.map

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

@@ -119,4 +119,3 @@ export default class SearchListMessages extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list-messages.js.map

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

@@ -4,6 +4,8 @@ import { BaseCommand } from '../../base-command.js';
 export default class SearchListUsers extends BaseCommand {
     static description = "Поиск сотрудников";
     static examples = [
+        "Отправить личное сообщение пользователю:\n  $ pachca search list-users",
+        "Упомянуть пользователя по имени:\n  $ pachca search list-users",
         "Найти сотрудника по имени:\n  $ pachca search list-users"
     ];
     static scope = "search:users";
@@ -114,4 +116,3 @@ export default class SearchListUsers extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list-users.js.map

package/dist/commands/security/list.js

@@ -150,4 +150,3 @@ export default class SecurityList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/tasks/create.js

@@ -107,4 +107,3 @@ export default class TasksCreate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/tasks/delete.js

@@ -46,4 +46,3 @@ export default class TasksDelete extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=delete.js.map

package/dist/commands/tasks/get.js

@@ -34,4 +34,3 @@ export default class TasksGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/tasks/list.js

@@ -84,4 +84,3 @@ export default class TasksList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/tasks/update.js

@@ -91,4 +91,3 @@ export default class TasksUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/thread/add.js

@@ -33,4 +33,3 @@ export default class ThreadAdd extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=add.js.map

package/dist/commands/thread/get.js

@@ -29,4 +29,3 @@ export default class ThreadGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/threads/add.js

@@ -0,0 +1,35 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ThreadsAdd extends BaseCommand {
+    static description = "Новый тред";
+    static examples = [
+        "Ответить в тред (комментарий к сообщению):\n  $ pachca thread add",
+        "Подписаться на тред сообщения:\n  $ pachca thread add"
+    ];
+    static scope = "threads:create";
+    static apiMethod = "POST";
+    static apiPath = "/messages/{id}/thread";
+    static defaultColumns = ["id", "chat_id", "message_id", "message_chat_id", "updated_at"];
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор сообщения",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async run() {
+        const { args, flags } = await this.parse(ThreadsAdd);
+        this.parsedFlags = flags;
+        this.checkScope("threads:create");
+        const { data } = await this.apiRequest({
+            method: 'POST',
+            path: `/messages/${args.id}/thread`,
+        });
+        const responseBody = data;
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}