@pachca/cli 2026.10.2 → 2026.10.4

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

@@ -5,9 +5,6 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 export default class ChatsUpdateAvatar extends BaseCommand {
     static description = "Загрузка аватара чата";
-    static examples = [
-        "Поставить или убрать аватар чата — Загрузи аватар беседы или канала:\n  $ pachca chats update-avatar"
-    ];
     static scope = "chats:update";
     static apiMethod = "PUT";
     static apiPath = "/chats/{id}/avatar";

package/dist/commands/chats/update.js

@@ -3,9 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class ChatsUpdate extends BaseCommand {
     static description = "Редактирование чата";
-    static examples = [
-        "Переименовать или обновить чат — Обнови чат:\n  $ pachca chats update"
-    ];
     static scope = "chats:update";
     static apiMethod = "PUT";
     static apiPath = "/chats/{id}";

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

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class CustomPropertiesList extends BaseCommand {
     static description = "Список дополнительных полей";
-    static examples = [
-        "Получить кастомные поля профиля — Получи список дополнительных полей для сотрудников:\n  $ pachca custom-properties list"
-    ];
     static hiddenAliases = ["common:custom-properties"];
     static scope = "custom_properties:read";
     static apiMethod = "GET";

package/dist/commands/doctor.js

@@ -2,7 +2,7 @@ import * as fs from 'node:fs';
 import * as process from 'node:process';
 import semver from 'semver';
 import { BaseCommand } from '../base-command.js';
-import { getActiveProfile, getProfile, getConfigFilePath, getConfigFilePermissions, getAuthMethod, getSecretStorage, isExpiring, isRefreshable, listProfiles, } from '../profiles.js';
+import { getProfile, getConfigFilePath, getConfigFilePermissions, getAuthMethod, getSecretStorage, isExpiring, isRefreshable, listProfiles, profileFlag, tokenSource, } from '../profiles.js';
 import { isSecretStoreAvailable } from '../secret-store.js';
 import { getBaseUrl } from '../client.js';
 export default class Doctor extends BaseCommand {
@@ -20,7 +20,6 @@ export default class Doctor extends BaseCommand {
         const format = this.getOutputFormat();
         const checks = [];
         let networkOk = false;
-        let profileOk = false;
         // 1. Node.js version
         const nodeVersion = process.version.replace('v', '');
         const nodeMajor = Number.parseInt(nodeVersion.split('.')[0], 10);
@@ -55,13 +54,19 @@ export default class Doctor extends BaseCommand {
             checks.push({ name: 'network', status: 'error', host });
             this.printCheck('error', `Сеть           ${host} недоступен (таймаут 5s)`, format);
         }
-        // 3. Config file. File permissions only matter for profiles that keep the
-        // secret there — for a keyring profile the file holds no token at all, and
-        // reporting its mode as a security state would be misleading.
+        // The token comes from the same place as for any other command, in the same
+        // order: --token, --profile, PACHCA_TOKEN, PACHCA_PROFILE, the active profile.
+        // In CI the token usually comes from PACHCA_TOKEN alone, with no config at all.
+        const source = tokenSource({ token: flags.token, profile: flags.profile });
+        const sourceLabel = source.kind === 'flag' ? '--token' : source.kind === 'env' ? 'PACHCA_TOKEN' : undefined;
+        const profileName = source.kind === 'profile' ? source.profileName : undefined;
+        const storedProfile = profileName ? listProfiles()[profileName] : undefined;
+        const relogin = `pachca auth login${profileFlag(profileName)}`;
+        // 3. Config file. File permissions only matter when a secret lives there: a
+        // keyring profile keeps no token in the file, and reporting its mode as a
+        // security state would be misleading.
         const configPath = getConfigFilePath();
-        const activeName = getActiveProfile();
-        const activeProfile = activeName ? listProfiles()[activeName] : undefined;
-        const storage = activeProfile ? getSecretStorage(activeProfile) : 'file';
+        const storage = storedProfile ? getSecretStorage(storedProfile) : 'file';
         if (fs.existsSync(configPath)) {
             const permissions = getConfigFilePermissions();
             if (storage === 'file' && permissions && Number.parseInt(permissions, 8) > 0o600) {
@@ -73,16 +78,20 @@ export default class Doctor extends BaseCommand {
                 this.printCheck('ok', `Конфиг         ${configPath} (права: ${permissions || '600'})`, format);
             }
         }
+        else if (sourceLabel) {
+            checks.push({ name: 'config', status: 'skipped', path: configPath, reason: `токен из ${sourceLabel}` });
+            this.printCheck('skipped', `Конфиг         не нужен: токен из ${sourceLabel}`, format);
+        }
         else {
             checks.push({ name: 'config', status: 'error', path: configPath });
-            this.printCheck('error', `Конфиг         файл не найден (запустите pachca auth login)`, format);
+            this.printCheck('error', `Конфиг         ${configPath} не найден (запустите pachca auth login или задайте PACHCA_TOKEN)`, format);
         }
         // 3a. Secret store. A locked keyring is the most likely failure of the new
         // login, and without this check it surfaces below as "token is invalid".
         let secretReadable = true;
-        if (activeProfile && storage === 'keyring') {
+        if (storedProfile && storage === 'keyring') {
             const storeUp = isSecretStoreAvailable();
-            secretReadable = storeUp && !!getProfile(activeName)?.token;
+            secretReadable = storeUp && !!getProfile(profileName)?.token;
             if (secretReadable) {
                 checks.push({ name: 'secret_store', status: 'ok', storage });
                 this.printCheck('ok', `Хранилище      хранилище ключей ОС, секрет читается`, format);
@@ -90,63 +99,81 @@ export default class Doctor extends BaseCommand {
             else {
                 checks.push({ name: 'secret_store', status: 'error', storage, available: storeUp });
                 this.printCheck('error', storeUp
-                    ? `Хранилище      секрет профиля не найден — войдите заново: pachca auth login`
+                    ? `Хранилище      секрет профиля не найден — войдите заново: ${relogin}`
                     : `Хранилище      хранилище ключей ОС недоступно — разблокируйте связку ключей`, format);
             }
         }
-        else if (activeProfile) {
+        else if (storedProfile) {
             checks.push({ name: 'secret_store', status: 'ok', storage: 'file' });
             this.printCheck('ok', `Хранилище      файл конфигурации`, format);
         }
         // 4. Profile
-        const profileName = getActiveProfile();
-        if (profileName) {
-            const profile = getProfile(profileName);
+        let token;
+        let profile;
+        if (sourceLabel) {
+            token = source.kind === 'flag' ? flags.token : process.env.PACHCA_TOKEN;
+            checks.push({ name: 'profile', status: 'skipped', source: sourceLabel, reason: `токен из ${sourceLabel}` });
+            this.printCheck('skipped', `Профиль        не используется: токен из ${sourceLabel}`, format);
+        }
+        else if (source.kind === 'profile') {
+            profile = getProfile(source.profileName);
             if (profile) {
+                token = profile.token;
                 const method = getAuthMethod(profile);
                 const expiry = method === 'oauth' && profile.expires_at
                     ? `, истекает ${new Date(profile.expires_at).toLocaleString('ru-RU')}`
                     : method === 'token'
                         ? ', бессрочный'
                         : '';
+                const via = source.via === 'active_profile' ? '' : ` из ${source.via}`;
                 checks.push({
                     name: 'profile',
                     status: 'ok',
-                    profile: profileName,
+                    profile: source.profileName,
+                    source: source.via,
                     type: profile.type,
                     user: profile.user,
                     auth: method,
                     storage,
                 });
-                this.printCheck('ok', `Профиль        ${profileName} (${profile.type}: ${profile.user}) — ${method === 'oauth' ? 'вход через браузер' : 'готовый токен'}${expiry}`, format);
-                profileOk = true;
+                this.printCheck('ok', `Профиль        ${source.profileName}${via} (${profile.type}: ${profile.user}) — ${method === 'oauth' ? 'вход через браузер' : 'готовый токен'}${expiry}`, format);
             }
             else {
-                checks.push({ name: 'profile', status: 'error', profile: profileName });
-                this.printCheck('error', `Профиль        ${profileName} — профиль не найден в конфиге`, format);
+                checks.push({ name: 'profile', status: 'error', profile: source.profileName, source: source.via });
+                this.printCheck('error', `Профиль        ${source.profileName} — профиль не найден в конфиге (список: pachca auth list)`, format);
             }
         }
         else {
             checks.push({ name: 'profile', status: 'error' });
-            this.printCheck('error', `Профиль        не настроен (запустите pachca auth login)`, format);
+            this.printCheck('error', `Профиль        не настроен (запустите pachca auth login или задайте PACHCA_TOKEN)`, format);
         }
-        // 5. Token (skip if no network, no profile, or the secret is unreadable —
+        // 5. Token (skip if no network, no token, or the secret is unreadable —
         // asking the server with an empty Bearer would come back 401 and get
         // reported as an invalid token, sending the user to log in for nothing)
-        if (!networkOk || !profileOk || !secretReadable) {
-            const reason = !networkOk ? 'нет сети' : !profileOk ? 'нет профиля' : 'секрет недоступен';
+        if (!networkOk || !token || !secretReadable) {
+            const reason = !networkOk
+                ? 'нет сети'
+                : !secretReadable
+                    ? 'секрет недоступен'
+                    : !sourceLabel && !profile
+                        ? 'нет профиля'
+                        : 'нет токена';
             checks.push({ name: 'token', status: 'skipped', reason });
             this.printCheck('skipped', `Токен          пропущено (${reason})`, format);
         }
         else {
-            const profile = getProfile(profileName);
             // An expired token that still has its refresh token is not a broken login:
             // the next command renews it on the init hook. Reporting it as invalid sent
             // people to log in again for nothing.
-            const willRenew = isRefreshable(profile) && isExpiring(profile);
+            const willRenew = !!profile && isRefreshable(profile) && isExpiring(profile);
+            const fix = sourceLabel
+                ? `проверьте ${sourceLabel}`
+                : profile && getAuthMethod(profile) === 'oauth'
+                    ? `войдите заново: ${relogin}`
+                    : `сохраните новый: ${relogin} --token <токен>`;
             try {
                 const response = await fetch(`${baseUrl}/oauth/token/info`, {
-                    headers: { Authorization: `Bearer ${profile.token}` },
+                    headers: { Authorization: `Bearer ${token}` },
                 });
                 if (response.ok) {
                     const body = (await response.json());
@@ -160,7 +187,7 @@ export default class Doctor extends BaseCommand {
                 }
                 else {
                     checks.push({ name: 'token', status: 'error', http_status: response.status });
-                    this.printCheck('error', `Токен          недействителен (${response.status}) — обновите: pachca auth login`, format);
+                    this.printCheck('error', `Токен          недействителен (${response.status}) — ${fix}`, format);
                 }
             }
             catch {
@@ -201,17 +228,15 @@ export default class Doctor extends BaseCommand {
                 this.printCheck('ok', `CLI            v${currentVersion}`, format);
             }
         }
-        // Output JSON if requested
+        // A failed check exits with 1 in every format, so a CI step can rely on the
+        // exit code alone; `status` of each check says which one failed.
+        const hasErrors = checks.some((c) => c.status === 'error');
         if (format === 'json') {
             this.output({ checks });
-            return;
         }
-        // Summary
-        const hasErrors = checks.some((c) => c.status === 'error');
-        if (!hasErrors) {
+        else if (!hasErrors) {
             process.stderr.write('\nВсё в порядке.\n');
         }
-        // Exit with error if any check failed
         if (hasErrors) {
             this.exit(1);
         }

package/dist/commands/drafts/create.js

@@ -2,11 +2,9 @@
 import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
+import { nullableInteger } from '../../lib/flags.js';
 export default class DraftsCreate extends BaseCommand {
     static description = "Новый черновик";
-    static examples = [
-        "Отправить сообщение позже или по расписанию — Создай отложенное сообщение: `schedule.start_date` — когда отправить, `schedule.repetition.interval` — как повторять (`once`, если один раз):\n  $ pachca drafts create"
-    ];
     static scope = "drafts:write";
     static apiMethod = "POST";
     static apiPath = "/drafts";
@@ -22,9 +20,9 @@ export default class DraftsCreate extends BaseCommand {
             description: "Идентификатор того, что названо в `entity_type`: беседы или канала, треда либо сотрудника (pachca chats list | pachca users list)",
         }),
         'content': Flags.string({
-            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 40 000 байт в UTF-8, а у отложенного сообщения в пространстве с продвинутым шифрованием — до 27 000.",
+            description: "Текст черновика. Можно не передавать, если есть вложения, но пустым черновик быть не может. До 40 000 байт в UTF-8.",
         }),
-        'parent-message-id': Flags.integer({
+        'parent-message-id': nullableInteger({
             description: "Идентификатор сообщения, ответом на которое уйдёт черновик. Сообщение должно быть в том же чате.",
         }),
         'files': Flags.string({
@@ -43,7 +41,9 @@ export default class DraftsCreate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const missingRequired = [
             { flag: 'entity-type', label: "Куда пишется черновик: в беседу или канал, в тред либо в личную переписку с сотрудником", type: 'string' },

package/dist/commands/drafts/delete.js

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class DraftsDelete extends BaseCommand {
     static description = "Удаление черновика";
-    static examples = [
-        "Отправить сообщение позже или по расписанию — Чтобы отменить отправку — удали отложенное сообщение:\n  $ pachca drafts delete"
-    ];
     static scope = "drafts:write";
     static apiMethod = "DELETE";
     static apiPath = "/drafts/{id}";

package/dist/commands/drafts/list.js

@@ -42,6 +42,7 @@ export default class DraftsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     type: flags['type'],
@@ -59,7 +60,7 @@ export default class DraftsList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -69,7 +70,8 @@ export default class DraftsList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/drafts/update.js

@@ -1,6 +1,7 @@
 // Auto-generated from openapi.yaml — DO NOT EDIT
 import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
+import { nullableInteger } from '../../lib/flags.js';
 export default class DraftsUpdate extends BaseCommand {
     static description = "Редактирование черновика";
     static scope = "drafts:write";
@@ -16,10 +17,10 @@ export default class DraftsUpdate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'content': Flags.string({
-            description: "Текст черновика. До 40 000 байт в UTF-8, а у отложенного сообщения в пространстве с продвинутым шифрованием — до 27 000.",
+            description: "Текст черновика. До 40 000 байт в UTF-8.",
         }),
-        'parent-message-id': Flags.integer({
-            description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ.",
+        'parent-message-id': nullableInteger({
+            description: "Идентификатор сообщения, ответом на которое уйдёт черновик. `null` снимает ответ. Чтобы передать null, укажите `--parent-message-id null`.",
         }),
         'files': Flags.string({
             description: "Прикрепляемые файлы, не больше десяти. Переданный массив заменяет прежний состав: пустой снимает все вложения, а чтобы сохранить уже прикреплённый файл, передайте его с `id`. Без этого поля вложения остаются как были.",
@@ -37,7 +38,9 @@ export default class DraftsUpdate extends BaseCommand {
             for await (const chunk of process.stdin) {
                 chunks.push(chunk);
             }
-            flags['content'] = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            const piped = Buffer.concat(chunks).toString('utf-8').trimEnd();
+            if (piped)
+                flags['content'] = piped;
         }
         const body = { draft: {
                 content: flags['content'],

package/dist/commands/files/uploads.js

@@ -1,9 +1,6 @@
 import { BaseCommand } from '../../base-command.js';
 export default class FilesUploads extends BaseCommand {
     static description = "Получение подписи, ключа и других параметров";
-    static examples = [
-        "Изменить вложения сообщения — Если нужно добавить новый файл — загрузи его:\n  $ pachca files uploads"
-    ];
     static hiddenAliases = ["common:uploads"];
     static scope = "uploads:write";
     static apiMethod = "POST";

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

@@ -4,9 +4,6 @@ import { BaseCommand } from '../../base-command.js';
 import * as clack from '@clack/prompts';
 export default class GroupTagsCreate extends BaseCommand {
     static description = "Новый тег";
-    static examples = [
-        "Массовое создание сотрудников с тегами — Создай тег (если нужен):\n  $ pachca group-tags create"
-    ];
     static scope = "group_tags:write";
     static apiMethod = "POST";
     static apiPath = "/group_tags";

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

@@ -3,9 +3,6 @@ import { Args, Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class GroupTagsListUsers extends BaseCommand {
     static description = "Список сотрудников тега";
-    static examples = [
-        "Получить всех сотрудников тега/департамента — Получи всех участников тега:\n  $ pachca group-tags list-users"
-    ];
     static scope = "group_tags:read";
     static apiMethod = "GET";
     static apiPath = "/group_tags/{id}/users";
@@ -38,6 +35,7 @@ export default class GroupTagsListUsers extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     limit: flags.limit,
@@ -52,7 +50,7 @@ export default class GroupTagsListUsers extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -62,7 +60,8 @@ export default class GroupTagsListUsers extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

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

@@ -3,9 +3,6 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
 export default class GroupTagsList extends BaseCommand {
     static description = "Список тегов";
-    static examples = [
-        "Получить всех сотрудников тега/департамента — Найди тег по названию, возьми `id`:\n  $ pachca group-tags list"
-    ];
     static scope = "group_tags:read";
     static apiMethod = "GET";
     static apiPath = "/group_tags";
@@ -36,6 +33,7 @@ export default class GroupTagsList extends BaseCommand {
             let nextCursor = undefined;
             let pages = 0;
             const seenCursors = new Set();
+            let total;
             while (pages < 500) {
                 const query = {
                     'names[]': flags['names']?.split(','),
@@ -51,7 +49,7 @@ export default class GroupTagsList extends BaseCommand {
                 const paginate = meta?.paginate;
                 nextCursor = paginate?.next_page;
                 pages++;
-                // Условие конца: списочные методы и /users?query= — has_next === false; методы поиска (без has_next) — пустой data
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
                 const hasNext = paginate?.has_next;
                 if (typeof hasNext === 'boolean') {
                     if (!hasNext)
@@ -61,7 +59,8 @@ export default class GroupTagsList extends BaseCommand {
                     break;
                 }
                 if (process.stderr.isTTY) {
-                    const total = paginate?.total;
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
                     const progress = total ? `${allData.length} / ${total}` : String(allData.length);
                     process.stderr.write(`\r  Загружено: ${progress}...`);
                 }

package/dist/commands/important-messages/create.js

@@ -0,0 +1,64 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as clack from '@clack/prompts';
+export default class ImportantMessagesCreate extends BaseCommand {
+    static description = "Добавление сообщения в важные";
+    static scope = "important_messages:write";
+    static apiMethod = "POST";
+    static apiPath = "/important_messages";
+    static requiredFlags = ["message-id"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'message-id': Flags.integer({
+            description: "Идентификатор сообщения (pachca messages list)",
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportantMessagesCreate);
+        this.parsedFlags = flags;
+        const missingRequired = [
+            { flag: 'message-id', label: "Идентификатор сообщения", type: 'integer' },
+        ].filter((f) => flags[f.flag] === undefined || flags[f.flag] === null);
+        if (missingRequired.length > 0) {
+            if (this.isInteractive()) {
+                for (const field of missingRequired) {
+                    const value = await clack.text({ message: field.label, validate: (v) => v.length === 0 ? 'Обязательное поле' : undefined });
+                    if (clack.isCancel(value)) {
+                        process.stderr.write('Отменено.\n');
+                        this.exit(0);
+                    }
+                    if (field.type === 'integer') {
+                        flags[field.flag] = Number.parseInt(value, 10);
+                    }
+                    else if (field.type === 'boolean') {
+                        flags[field.flag] = value === 'true';
+                    }
+                    else {
+                        flags[field.flag] = value;
+                    }
+                }
+            }
+            else {
+                this.validationError(missingRequired.map((f) => ({ message: `Обязательный флаг --${f.flag} не передан`, flag: f.flag })), { hint: "Обязательные: --message-id <integer>. pachca introspect important-messages create" });
+            }
+        }
+        const body = {
+            message_id: flags['message-id'],
+        };
+        // Clean undefined fields
+        for (const [k, v] of Object.entries(body)) {
+            if (v === undefined)
+                delete body[k];
+        }
+        const { data } = await this.apiRequest({
+            method: 'POST',
+            path: '/important_messages',
+            body,
+        });
+        const responseBody = (data ?? {});
+        const result = responseBody.data ?? responseBody;
+        this.output(result);
+    }
+}

package/dist/commands/important-messages/delete.js

@@ -0,0 +1,42 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Args, Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import * as clack from '@clack/prompts';
+export default class ImportantMessagesDelete extends BaseCommand {
+    static description = "Удаление сообщения из важных";
+    static scope = "important_messages:write";
+    static apiMethod = "DELETE";
+    static apiPath = "/important_messages/{id}";
+    static args = {
+        id: Args.integer({
+            description: "Идентификатор сообщения",
+            required: true,
+        }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        force: Flags.boolean({
+            description: 'Пропустить подтверждение',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportantMessagesDelete);
+        this.parsedFlags = flags;
+        if (!flags.force) {
+            if (!this.isInteractive()) {
+                this.validationError([{ message: 'Деструктивная операция требует флага --force', flag: 'force' }], { type: 'PACHCA_DESTRUCTIVE_OP_ERROR', hint: "pachca important-messages delete <id> --force" });
+            }
+            const confirm = await clack.confirm({ message: 'Вы уверены?' });
+            if (clack.isCancel(confirm) || !confirm) {
+                process.stderr.write('Отменено.\n');
+                this.exit(0);
+            }
+        }
+        const { data } = await this.apiRequest({
+            method: 'DELETE',
+            path: `/important_messages/${args.id}`,
+        });
+        this.success('Удалено');
+    }
+}

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

@@ -0,0 +1,91 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ImportantMessagesList extends BaseCommand {
+    static description = "Список важных сообщений";
+    static scope = "important_messages:read";
+    static apiMethod = "GET";
+    static apiPath = "/important_messages";
+    static defaultColumns = ["id", "content", "created_at", "entity_type", "entity_id"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ImportantMessagesList);
+        this.parsedFlags = flags;
+        if (flags.all) {
+            // Auto-pagination
+            const allData = [];
+            let nextCursor = undefined;
+            let pages = 0;
+            const seenCursors = new Set();
+            let total;
+            while (pages < 500) {
+                const query = {
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/important_messages', query });
+                const body = response.data;
+                const items = body.data;
+                if (items)
+                    allData.push(...items);
+                const meta = body.meta;
+                const paginate = meta?.paginate;
+                nextCursor = paginate?.next_page;
+                pages++;
+                // Условие конца: has_next === false, а в ответе без has_next — пустой data
+                const hasNext = paginate?.has_next;
+                if (typeof hasNext === 'boolean') {
+                    if (!hasNext)
+                        break;
+                }
+                else if (!items || items.length === 0) {
+                    break;
+                }
+                if (process.stderr.isTTY) {
+                    // total лежит в meta у методов поиска. Берём его с первой страницы: при поиске сообщений по дате следующие страницы считают только остаток
+                    total ??= meta?.total;
+                    const progress = total ? `${allData.length} / ${total}` : String(allData.length);
+                    process.stderr.write(`\r  Загружено: ${progress}...`);
+                }
+                if (!nextCursor)
+                    break;
+                if (seenCursors.has(nextCursor)) {
+                    process.stderr.write('\n⚠ Обнаружен цикл пагинации, остановка.\n');
+                    break;
+                }
+                seenCursors.add(nextCursor);
+            }
+            if (pages >= 500) {
+                process.stderr.write('\n⚠ Достигнут лимит 500 страниц.\n');
+            }
+            if (process.stderr.isTTY)
+                process.stderr.write('\n');
+            this.output(allData);
+            return;
+        }
+        const { data } = await this.apiRequest({
+            method: 'GET',
+            path: '/important_messages',
+            query: {
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = (data ?? {});
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}