@pachca/cli 2026.3.2 → 2026.3.4

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

@@ -12,6 +12,7 @@ export default class ProfileUpdateStatus extends BaseCommand {
     static apiMethod = "PUT";
     static apiPath = "/profile/status";
     static defaultColumns = ["title", "emoji", "expires_at", "is_away"];
+    static requiredFlags = ["emoji", "title"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -59,15 +60,15 @@ export default class ProfileUpdateStatus extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --emoji <string>, --title <string>. pachca introspect profile update-status" });
             }
         }
+        const validationErrors = [];
         if (flags['away-message'] && String(flags['away-message']).length > 1024) {
-            process.stderr.write(`✗ --away-message: максимум 1024 символов (передано: ${String(flags['away-message']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--away-message: максимум 1024 символов (передано: ${String(flags['away-message']).length})`, flag: 'away-message' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
         }
         this.checkScope("profile_status:write");
         const body = { status: {
@@ -84,8 +85,7 @@ export default class ProfileUpdateStatus extends BaseCommand {
                 delete inner[k];
         }
         if (Object.keys(inner).length === 0) {
-            process.stderr.write('⚠ Не указаны поля для обновления. Используйте --help для списка флагов.\n');
-            return;
+            this.validationError([{ message: 'Не указаны поля для обновления' }], { type: 'PACHCA_USAGE_ERROR' });
         }
         const { data } = await this.apiRequest({
             method: 'PUT',
@@ -97,4 +97,3 @@ export default class ProfileUpdateStatus extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update-status.js.map

package/dist/commands/reactions/add.js

@@ -12,6 +12,7 @@ export default class ReactionsAdd extends BaseCommand {
     static apiMethod = "POST";
     static apiPath = "/messages/{id}/reactions";
     static defaultColumns = ["name", "created_at", "user_id", "code"];
+    static requiredFlags = ["code"];
     static args = {
         id: Args.integer({
             description: "Идентификатор сообщения",
@@ -53,10 +54,7 @@ export default class ReactionsAdd extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --code <string>. pachca introspect reactions add" });
             }
         }
         this.checkScope("reactions:write");
@@ -79,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

@@ -11,6 +11,7 @@ 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: "Идентификатор сообщения",
@@ -56,16 +57,12 @@ export default class ReactionsRemove extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --code <string>. pachca introspect reactions remove" });
             }
         }
         if (!flags.force) {
             if (!this.isInteractive()) {
-                process.stderr.write('✗ Деструктивная операция требует флага --force в неинтерактивном режиме\n');
-                this.exit(2);
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca reactions remove <id> --force" });
             }
             const confirm = await clack.confirm({ message: 'Вы уверены?' });
             if (clack.isCancel(confirm) || !confirm) {
@@ -85,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

@@ -121,4 +121,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

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

package/dist/commands/security/list.js

@@ -14,6 +14,7 @@ export default class SecurityList extends BaseCommand {
     static apiMethod = "GET";
     static apiPath = "/audit_events";
     static defaultColumns = ["id", "created_at", "event_key", "entity_id", "entity_type"];
+    static requiredFlags = ["start-time", "end-time"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -77,10 +78,7 @@ export default class SecurityList extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --start-time <string>, --end-time <string>. pachca introspect security list" });
             }
         }
         this.checkScope("audit_events:read");
@@ -152,4 +150,3 @@ export default class SecurityList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/tasks/create.js

@@ -5,14 +5,15 @@ import * as clack from '@clack/prompts';
 export default class TasksCreate extends BaseCommand {
     static description = "Новое напоминание";
     static examples = [
+        "Форма заявки/запроса:\n  $ pachca tasks create",
         "Создать напоминание:\n  $ pachca tasks create",
-        "Получить список предстоящих задач:\n  $ pachca tasks list",
-        "Создать серию напоминаний:\n  $ pachca tasks create"
+        "Получить список предстоящих задач:\n  $ pachca tasks list"
     ];
     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,
@@ -32,7 +33,7 @@ export default class TasksCreate extends BaseCommand {
             description: "Массив идентификаторов пользователей, привязываемых к напоминанию как «ответственные» (по умолчанию ответственным назначается вы)",
         }),
         'chat-id': Flags.integer({
-            description: "Идентификатор чата, к которому привязывается напоминание",
+            description: "Идентификатор чата, к которому привязывается напоминание (pachca chats list)",
         }),
         'all-day': Flags.boolean({
             description: "Напоминание на весь день (без указания времени)",
@@ -76,10 +77,7 @@ export default class TasksCreate extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --kind <string>. pachca introspect tasks create" });
             }
         }
         this.checkScope("tasks:create");
@@ -109,4 +107,3 @@ export default class TasksCreate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/tasks/delete.js

@@ -14,7 +14,7 @@ export default class TasksDelete extends BaseCommand {
     static apiPath = "/tasks/{id}";
     static args = {
         id: Args.integer({
-            description: "Идентификатор напоминания",
+            description: "Идентификатор напоминания (pachca tasks list)",
             required: true,
         }),
     };
@@ -30,8 +30,7 @@ export default class TasksDelete extends BaseCommand {
         this.parsedFlags = flags;
         if (!flags.force) {
             if (!this.isInteractive()) {
-                process.stderr.write('✗ Деструктивная операция требует флага --force в неинтерактивном режиме\n');
-                this.exit(2);
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca tasks delete <id> --force" });
             }
             const confirm = await clack.confirm({ message: 'Вы уверены?' });
             if (clack.isCancel(confirm) || !confirm) {
@@ -47,4 +46,3 @@ export default class TasksDelete extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=delete.js.map

package/dist/commands/tasks/get.js

@@ -14,7 +14,7 @@ export default class TasksGet extends BaseCommand {
     static defaultColumns = ["id", "content", "created_at", "kind", "due_at"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор напоминания",
+            description: "Идентификатор напоминания (pachca tasks list)",
             required: true,
         }),
     };
@@ -34,4 +34,3 @@ export default class TasksGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/tasks/list.js

@@ -4,9 +4,9 @@ import { BaseCommand } from '../../base-command.js';
 export default class TasksList extends BaseCommand {
     static description = "Список напоминаний";
     static examples = [
+        "Форма заявки/запроса:\n  $ pachca tasks create",
         "Создать напоминание:\n  $ pachca tasks create",
-        "Получить список предстоящих задач:\n  $ pachca tasks list",
-        "Создать серию напоминаний:\n  $ pachca tasks create"
+        "Получить список предстоящих задач:\n  $ pachca tasks list"
     ];
     static scope = "tasks:read";
     static apiMethod = "GET";
@@ -84,4 +84,3 @@ export default class TasksList extends BaseCommand {
         this.output(items);
     }
 }
-//# sourceMappingURL=list.js.map

package/dist/commands/tasks/update.js

@@ -14,7 +14,7 @@ export default class TasksUpdate extends BaseCommand {
     static defaultColumns = ["id", "content", "created_at", "kind", "due_at"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор напоминания",
+            description: "Идентификатор напоминания (pachca tasks list)",
             required: true,
         }),
     };
@@ -79,8 +79,7 @@ export default class TasksUpdate extends BaseCommand {
                 delete inner[k];
         }
         if (Object.keys(inner).length === 0) {
-            process.stderr.write('⚠ Не указаны поля для обновления. Используйте --help для списка флагов.\n');
-            return;
+            this.validationError([{ message: 'Не указаны поля для обновления' }], { type: 'PACHCA_USAGE_ERROR' });
         }
         const { data } = await this.apiRequest({
             method: 'PUT',
@@ -92,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/users/create.js

@@ -13,6 +13,7 @@ export default class UsersCreate extends BaseCommand {
     static apiMethod = "POST";
     static apiPath = "/users";
     static defaultColumns = ["id", "title", "first_name", "last_name", "email"];
+    static requiredFlags = ["email"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -81,10 +82,7 @@ export default class UsersCreate extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --email <string>. pachca introspect users create" });
             }
         }
         this.checkScope("users:create");
@@ -124,4 +122,3 @@ export default class UsersCreate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=create.js.map

package/dist/commands/users/delete.js

@@ -14,7 +14,7 @@ export default class UsersDelete extends BaseCommand {
     static apiPath = "/users/{id}";
     static args = {
         id: Args.integer({
-            description: "Идентификатор пользователя",
+            description: "Идентификатор пользователя (pachca users list)",
             required: true,
         }),
     };
@@ -30,8 +30,7 @@ export default class UsersDelete extends BaseCommand {
         this.parsedFlags = flags;
         if (!flags.force) {
             if (!this.isInteractive()) {
-                process.stderr.write('✗ Деструктивная операция требует флага --force в неинтерактивном режиме\n');
-                this.exit(2);
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca users delete <id> --force" });
             }
             const confirm = await clack.confirm({ message: 'Вы уверены?' });
             if (clack.isCancel(confirm) || !confirm) {
@@ -47,4 +46,3 @@ export default class UsersDelete extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=delete.js.map

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

@@ -14,7 +14,7 @@ export default class UsersGetStatus extends BaseCommand {
     static defaultColumns = ["title", "emoji", "expires_at", "is_away"];
     static args = {
         user_id: Args.integer({
-            description: "Идентификатор пользователя",
+            description: "Идентификатор пользователя (pachca users list)",
             required: true,
         }),
     };
@@ -34,4 +34,3 @@ export default class UsersGetStatus extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get-status.js.map

package/dist/commands/users/get.js

@@ -14,7 +14,7 @@ export default class UsersGet extends BaseCommand {
     static defaultColumns = ["id", "title", "first_name", "last_name", "email"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор пользователя",
+            description: "Идентификатор пользователя (pachca users list)",
             required: true,
         }),
     };
@@ -34,4 +34,3 @@ export default class UsersGet extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=get.js.map

package/dist/commands/users/list.js

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

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

@@ -14,7 +14,7 @@ export default class UsersRemoveStatus extends BaseCommand {
     static apiPath = "/users/{user_id}/status";
     static args = {
         user_id: Args.integer({
-            description: "Идентификатор пользователя",
+            description: "Идентификатор пользователя (pachca users list)",
             required: true,
         }),
     };
@@ -30,8 +30,7 @@ export default class UsersRemoveStatus extends BaseCommand {
         this.parsedFlags = flags;
         if (!flags.force) {
             if (!this.isInteractive()) {
-                process.stderr.write('✗ Деструктивная операция требует флага --force в неинтерактивном режиме\n');
-                this.exit(2);
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca users remove-status <user_id> --force" });
             }
             const confirm = await clack.confirm({ message: 'Вы уверены?' });
             if (clack.isCancel(confirm) || !confirm) {
@@ -47,4 +46,3 @@ export default class UsersRemoveStatus extends BaseCommand {
         this.success('Удалено');
     }
 }
-//# sourceMappingURL=remove-status.js.map

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

@@ -13,9 +13,10 @@ export default class UsersUpdateStatus extends BaseCommand {
     static apiMethod = "PUT";
     static apiPath = "/users/{user_id}/status";
     static defaultColumns = ["title", "emoji", "expires_at", "is_away"];
+    static requiredFlags = ["emoji", "title"];
     static args = {
         user_id: Args.integer({
-            description: "Идентификатор пользователя",
+            description: "Идентификатор пользователя (pachca users list)",
             required: true,
         }),
     };
@@ -65,15 +66,15 @@ export default class UsersUpdateStatus extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --emoji <string>, --title <string>. pachca introspect users update-status" });
             }
         }
+        const validationErrors = [];
         if (flags['away-message'] && String(flags['away-message']).length > 1024) {
-            process.stderr.write(`✗ --away-message: максимум 1024 символов (передано: ${String(flags['away-message']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--away-message: максимум 1024 символов (передано: ${String(flags['away-message']).length})`, flag: 'away-message' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
         }
         this.checkScope("user_status:write");
         const body = { status: {
@@ -90,8 +91,7 @@ export default class UsersUpdateStatus extends BaseCommand {
                 delete inner[k];
         }
         if (Object.keys(inner).length === 0) {
-            process.stderr.write('⚠ Не указаны поля для обновления. Используйте --help для списка флагов.\n');
-            return;
+            this.validationError([{ message: 'Не указаны поля для обновления' }], { type: 'PACHCA_USAGE_ERROR' });
         }
         const { data } = await this.apiRequest({
             method: 'PUT',
@@ -103,4 +103,3 @@ export default class UsersUpdateStatus extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update-status.js.map

package/dist/commands/users/update.js

@@ -14,7 +14,7 @@ export default class UsersUpdate extends BaseCommand {
     static defaultColumns = ["id", "title", "first_name", "last_name", "email"];
     static args = {
         id: Args.integer({
-            description: "Идентификатор пользователя",
+            description: "Идентификатор пользователя (pachca users list)",
             required: true,
         }),
     };
@@ -79,8 +79,7 @@ export default class UsersUpdate extends BaseCommand {
                 delete inner[k];
         }
         if (Object.keys(inner).length === 0) {
-            process.stderr.write('⚠ Не указаны поля для обновления. Используйте --help для списка флагов.\n');
-            return;
+            this.validationError([{ message: 'Не указаны поля для обновления' }], { type: 'PACHCA_USAGE_ERROR' });
         }
         const { data } = await this.apiRequest({
             method: 'PUT',
@@ -92,4 +91,3 @@ export default class UsersUpdate extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=update.js.map

package/dist/commands/version.js

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../base-command.js';
 export default class Version extends BaseCommand {
-    static description = 'Show CLI version';
+    static description = 'Версия CLI';
     static examples = [
         '<%= config.bin %> version',
     ];
@@ -20,4 +20,3 @@ export default class Version extends BaseCommand {
         }
     }
 }
-//# sourceMappingURL=version.js.map

package/dist/commands/views/open.js

@@ -11,6 +11,7 @@ export default class ViewsOpen extends BaseCommand {
     static scope = "views:write";
     static apiMethod = "POST";
     static apiPath = "/views/open";
+    static requiredFlags = ["title", "blocks", "type", "trigger-id"];
     static args = {};
     static flags = {
         ...BaseCommand.baseFlags,
@@ -69,35 +70,30 @@ export default class ViewsOpen extends BaseCommand {
                 }
             }
             else {
-                for (const field of missingRequired) {
-                    process.stderr.write(`✗ Обязательный флаг --${field.flag} не передан\n`);
-                }
-                this.exit(2);
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --title <string>, --blocks <string>, --type <string>, --trigger-id <string>. pachca introspect views open" });
             }
         }
+        const validationErrors = [];
         if (flags['title'] && String(flags['title']).length > 24) {
-            process.stderr.write(`✗ --title: максимум 24 символов (передано: ${String(flags['title']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--title: максимум 24 символов (передано: ${String(flags['title']).length})`, flag: 'title' });
         }
         if (flags['close-text'] && String(flags['close-text']).length > 24) {
-            process.stderr.write(`✗ --close-text: максимум 24 символов (передано: ${String(flags['close-text']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--close-text: максимум 24 символов (передано: ${String(flags['close-text']).length})`, flag: 'close-text' });
         }
         if (flags['submit-text'] && String(flags['submit-text']).length > 24) {
-            process.stderr.write(`✗ --submit-text: максимум 24 символов (передано: ${String(flags['submit-text']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--submit-text: максимум 24 символов (передано: ${String(flags['submit-text']).length})`, flag: 'submit-text' });
         }
         if (flags['type'] && !["modal"].includes(flags['type'])) {
-            process.stderr.write(`✗ --type: допустимые значения — "modal"\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--type: допустимые значения — "modal"`, flag: 'type' });
         }
         if (flags['private-metadata'] && String(flags['private-metadata']).length > 3000) {
-            process.stderr.write(`✗ --private-metadata: максимум 3000 символов (передано: ${String(flags['private-metadata']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--private-metadata: максимум 3000 символов (передано: ${String(flags['private-metadata']).length})`, flag: 'private-metadata' });
         }
         if (flags['callback-id'] && String(flags['callback-id']).length > 255) {
-            process.stderr.write(`✗ --callback-id: максимум 255 символов (передано: ${String(flags['callback-id']).length})\n`);
-            this.exit(2);
+            validationErrors.push({ message: `--callback-id: максимум 255 символов (передано: ${String(flags['callback-id']).length})`, flag: 'callback-id' });
+        }
+        if (validationErrors.length > 0) {
+            this.validationError(validationErrors);
         }
         this.checkScope("views:write");
         const body = {
@@ -132,4 +128,3 @@ export default class ViewsOpen extends BaseCommand {
         this.output(result);
     }
 }
-//# sourceMappingURL=open.js.map