@pachca/cli 2026.8.0 → 2026.8.2

package/dist/commands/auth/logout.js

@@ -1,7 +1,8 @@
 import { Args } from '@oclif/core';
 import * as clack from '@clack/prompts';
 import { BaseCommand } from '../../base-command.js';
-import { listProfiles, deleteProfile } from '../../profiles.js';
+import { listProfiles, deleteProfile, getAuthMethod, getSecretStorage, getProfile } from '../../profiles.js';
+import { revokeToken } from '../../oauth.js';
 import { outputError } from '../../output.js';
 export default class AuthLogout extends BaseCommand {
     static description = 'Удаление сохранённого профиля';
@@ -69,12 +70,45 @@ export default class AuthLogout extends BaseCommand {
             outputError({ error: `Profile "${profileName}" not found`, type: 'PACHCA_USAGE_ERROR', code: null }, format);
             this.exit(2);
         }
+        const authMethod = getAuthMethod(profiles[profileName]);
+        const storage = getSecretStorage(profiles[profileName]);
+        // Put the token out server-side before dropping the profile — afterwards the
+        // secret is gone and there is nothing left to revoke with. Only tokens this
+        // CLI issued can revoke themselves; a pasted one is not ours to cancel.
+        let revoked = false;
+        if (authMethod === 'oauth') {
+            const secret = getProfile(profileName)?.token;
+            if (secret)
+                revoked = await revokeToken(secret);
+        }
         deleteProfile(profileName);
         if (format === 'json') {
-            this.output({ deleted_profile: profileName });
+            this.output({
+                deleted_profile: profileName,
+                auth: authMethod,
+                storage,
+                token_revoked: revoked,
+            });
+            return;
         }
-        else {
-            this.success(`Профиль ${profileName} удалён`);
+        this.success(`Профиль ${profileName} удалён`);
+        // Never claim access is closed when it is not: believing a logout revoked a
+        // token when it did not is worse than an extra line here.
+        if (!flags.quiet) {
+            if (authMethod === 'oauth') {
+                process.stderr.write(revoked
+                    ? `  Токен отозван на сервере и удалён с этой машины.\n`
+                    : `  Токен удалён с этой машины. Отозвать его не удалось — перестанет действовать по истечении срока.\n`);
+            }
+            else {
+                process.stderr.write(`  Токен удалён с этой машины, но продолжает действовать.\n`);
+                process.stderr.write(`  Отзовите его в настройках Пачки, если он больше не нужен.\n`);
+            }
+            // Storage is a property of the profile, not of how it was created: a pasted
+            // token lives in the store just the same, and its entry goes away too.
+            if (storage === 'keyring') {
+                process.stderr.write(`  Запись в хранилище ключей ОС удалена.\n`);
+            }
         }
     }
 }

package/dist/commands/auth/status.js

@@ -1,6 +1,22 @@
+import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import { getActiveProfile, getProfile } from '../../profiles.js';
+import { getActiveProfile, getAuthMethod, getProfile, getSecretStorage, updateProfileScopes, } from '../../profiles.js';
+import { request } from '../../client.js';
 import { outputError } from '../../output.js';
+/** Human-readable time left, or null when the token has no expiry at all. */
+function describeExpiry(profile) {
+    if (getAuthMethod(profile) === 'token')
+        return null;
+    if (!profile.expires_at)
+        return null;
+    const msLeft = Date.parse(profile.expires_at) - Date.now();
+    if (Number.isNaN(msLeft))
+        return null;
+    if (msLeft <= 0)
+        return 'истёк, обновится при следующей команде';
+    const minutes = Math.round(msLeft / 60_000);
+    return minutes < 60 ? `осталось ${minutes} мин` : `осталось ${Math.round(minutes / 60)} ч`;
+}
 export default class AuthStatus extends BaseCommand {
     static description = 'Статус текущего профиля';
     static examples = [
@@ -9,6 +25,10 @@ export default class AuthStatus extends BaseCommand {
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        remote: Flags.boolean({
+            description: 'Спросить права у сервера, а не показывать сохранённые при входе',
+            default: false,
+        }),
     };
     async run() {
         const { flags } = await this.parse(AuthStatus);
@@ -24,17 +44,84 @@ export default class AuthStatus extends BaseCommand {
             outputError({ error: `Profile "${profileName}" not found`, type: 'PACHCA_USAGE_ERROR', code: null }, format);
             this.exit(2);
         }
+        const authMethod = getAuthMethod(profile);
+        // The stored scope list is frozen at login. A role change since then makes it
+        // stale, and this is the command people are sent to when a call is refused —
+        // so offer to ask the server what the token actually carries.
+        let scopes = profile.scopes;
+        let drifted = false;
+        // Whether the answer really came from the server. `--remote` alone is not
+        // enough: the request can fail, and labelling the cached list as server truth
+        // is worse than not asking at all.
+        let fromServer = false;
+        if (flags.remote && profile.token) {
+            const remote = await this.fetchRemoteScopes(profile.token);
+            if (remote) {
+                fromServer = true;
+                drifted = JSON.stringify([...(scopes ?? [])].sort()) !== JSON.stringify([...remote].sort());
+                scopes = remote;
+                if (drifted)
+                    updateProfileScopes(profileName, remote);
+            }
+        }
         if (format === 'json') {
             this.output({
                 profile: profileName,
                 type: profile.type,
                 user: profile.user,
                 email: profile.email || null,
+                auth: authMethod,
+                expires_at: profile.expires_at || null,
+                scopes: scopes || null,
+                scopes_source: fromServer ? 'server' : 'profile',
+                storage: getSecretStorage(profile),
+                // A keyring-backed profile with no token means the store did not answer.
+                // Surfaced here because this is the command people run to debug access.
+                secret_readable: !!profile.token,
             });
+            return;
+        }
+        const emailStr = profile.email ? ` (${profile.email})` : '';
+        process.stderr.write(`  Подключён как: ${profile.user}${emailStr}  [${profile.type}, profile: ${profileName}]\n`);
+        const expiry = describeExpiry(profile);
+        if (authMethod === 'oauth') {
+            process.stderr.write(`  Вход: через браузер${expiry ? `, ${expiry}` : ''}\n`);
+        }
+        else {
+            process.stderr.write(`  Вход: готовым токеном, без срока\n`);
+        }
+        if (getSecretStorage(profile) === 'keyring') {
+            process.stderr.write(profile.token
+                ? `  Хранение: хранилище ключей ОС\n`
+                : `  Хранение: хранилище ключей ОС — не читается, войдите заново\n`);
         }
         else {
-            const emailStr = profile.email ? ` (${profile.email})` : '';
-            process.stderr.write(`  Подключён как: ${profile.user}${emailStr}  [${profile.type}, profile: ${profileName}]\n`);
+            process.stderr.write(`  Хранение: файл конфигурации\n`);
+        }
+        if (scopes?.length) {
+            const source = fromServer ? ' по данным сервера' : '';
+            process.stderr.write(`  Права${source} (${scopes.length}): ${scopes.join(', ')}\n`);
+        }
+        else if (fromServer) {
+            // An empty set is an answer, not a missing one — and a token that carries
+            // no rights is exactly the failure worth naming out loud.
+            process.stderr.write(`  Права по данным сервера: ни одного\n`);
+        }
+        if (drifted) {
+            process.stderr.write(`  Список прав в профиле расходился с сервером и был обновлён\n`);
+        }
+    }
+    /** Ask the server what the token really carries. Null when it cannot be asked. */
+    async fetchRemoteScopes(token) {
+        try {
+            const response = await request({ method: 'GET', path: '/oauth/token/info', token }, { quiet: true });
+            const info = response.data.data;
+            return info?.scopes ?? null;
+        }
+        catch {
+            // Offline or a dead token: the local view is still worth printing.
+            process.stderr.write(`  Спросить права у сервера не удалось — показаны сохранённые при входе\n`);
+            return null;
         }
     }
 }

package/dist/commands/auth/switch.js

@@ -1,6 +1,6 @@
 import { Args } from '@oclif/core';
 import { BaseCommand } from '../../base-command.js';
-import { listProfiles, setActiveProfile } from '../../profiles.js';
+import { listProfiles, setActiveProfile, getProfile } from '../../profiles.js';
 import { outputError } from '../../output.js';
 export default class AuthSwitch extends BaseCommand {
     static description = 'Переключение активного профиля';
@@ -26,11 +26,25 @@ export default class AuthSwitch extends BaseCommand {
             this.exit(2);
         }
         setActiveProfile(args.profile);
+        // Say right here if the profile cannot work, rather than letting the next
+        // unrelated command fail: switching is where the user can still act on it.
+        const profile = getProfile(args.profile);
+        const secretMissing = !profile?.token;
+        const expired = !!profile?.expires_at && new Date(profile.expires_at) <= new Date();
         if (format === 'json') {
-            this.output({ active_profile: args.profile });
+            this.output({
+                active_profile: args.profile,
+                secret_readable: !secretMissing,
+                expired,
+            });
+            return;
         }
-        else {
-            this.success(`Активный профиль: ${args.profile}`);
+        this.success(`Активный профиль: ${args.profile}`);
+        if (secretMissing) {
+            process.stderr.write(`  Секрет профиля не читается — войдите заново: pachca auth login --profile ${args.profile}\n`);
+        }
+        else if (expired) {
+            process.stderr.write(`  Срок действия токена истёк — он будет обновлён при следующей команде\n`);
         }
     }
 }

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

@@ -0,0 +1,98 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class BotsListCompany extends BaseCommand {
+    static description = "Список ботов пространства";
+    static examples = [
+        "Инвентаризация всех ботов пространства — Получи всех ботов пространства, а не только доступных для редактирования:\n  $ pachca bots list-company"
+    ];
+    static scope = "company_bots:read";
+    static plan = "corporation";
+    static apiMethod = "GET";
+    static apiPath = "/company/bots";
+    static defaultColumns = ["id", "webhook"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'query': Flags.string({
+            description: "Поисковая фраза для фильтрации ботов по имени",
+        }),
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(BotsListCompany);
+        this.parsedFlags = flags;
+        if (flags.all) {
+            // Auto-pagination
+            const allData = [];
+            let nextCursor = undefined;
+            let pages = 0;
+            const seenCursors = new Set();
+            while (pages < 500) {
+                const query = {
+                    query: flags['query'],
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/company/bots', 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; методы поиска и /users?query= (без 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) {
+                    const total = paginate?.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: '/company/bots',
+            query: {
+                query: flags['query'],
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = (data ?? {});
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}

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

@@ -0,0 +1,99 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ChatsListCompany extends BaseCommand {
+    static description = "Список чатов пространства";
+    static examples = [
+        "Выгрузить все чаты пространства, включая закрытые — Получи беседы и каналы всего пространства, включая закрытые, где владелец токена не состоит:\n  $ pachca chats list-company"
+    ];
+    static scope = "company_chats:read";
+    static plan = "corporation";
+    static apiMethod = "GET";
+    static apiPath = "/company/chats";
+    static defaultColumns = ["id", "name", "created_at", "owner_id", "channel"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'activity': Flags.string({
+            description: "Состояние чатов. Если параметр не указан, возвращаются и активные, и архивные чаты.",
+            options: ["active", "archived"],
+        }),
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ChatsListCompany);
+        this.parsedFlags = flags;
+        if (flags.all) {
+            // Auto-pagination
+            const allData = [];
+            let nextCursor = undefined;
+            let pages = 0;
+            const seenCursors = new Set();
+            while (pages < 500) {
+                const query = {
+                    activity: flags['activity'],
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/company/chats', 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; методы поиска и /users?query= (без 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) {
+                    const total = paginate?.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: '/company/chats',
+            query: {
+                activity: flags['activity'],
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = (data ?? {});
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}

package/dist/commands/chats/list.js

@@ -6,7 +6,7 @@ export default class ChatsList extends BaseCommand {
     static examples = [
         "Найти активные чаты за период — Получи чаты с активностью после указанной даты:\n  $ pachca chats list",
         "Найти и заархивировать неактивные чаты — Получи чаты без активности с нужной даты:\n  $ pachca chats list",
-        "Создать гостя в чат — Выбери активный чат, в который добавить гостя — узнай его ID:\n  $ pachca chats list"
+        "Выгрузить все чаты пространства, включая закрытые — Если метод ответил `403` — у токена нет скоупа `company_chats:read`, либо владелец токена не владелец пространства, либо у пространства нет тарифа «Корпорация». Тогда возьми открытые чаты обычным списком:\n  $ pachca chats list"
     ];
     static scope = "chats:read";
     static apiMethod = "GET";
@@ -30,6 +30,11 @@ export default class ChatsList extends BaseCommand {
             options: ["is_member", "public"],
             default: "is_member",
         }),
+        'archived': Flags.boolean({
+            description: "Добавляет к выдаче архивные чаты. По умолчанию возвращаются только активные. Работает при любом значении `availability`.",
+            default: false,
+            allowNo: true,
+        }),
         'last-message-at-after': Flags.string({
             description: "Фильтрация по времени создания последнего сообщения. Будут возвращены те чаты, время последнего созданного сообщения в которых не раньше чем указанное (в формате YYYY-MM-DDThh:mm:ss.sssZ).",
         }),
@@ -65,6 +70,7 @@ export default class ChatsList extends BaseCommand {
                     sort: flags['sort'],
                     order: flags['order'],
                     availability: flags['availability'],
+                    archived: flags['archived'],
                     'last_message_at_after': flags['last-message-at-after'],
                     'last_message_at_before': flags['last-message-at-before'],
                     personal: flags['personal'],
@@ -117,6 +123,7 @@ export default class ChatsList extends BaseCommand {
                 sort: flags['sort'],
                 order: flags['order'],
                 availability: flags['availability'],
+                archived: flags['archived'],
                 'last_message_at_after': flags['last-message-at-after'],
                 'last_message_at_before': flags['last-message-at-before'],
                 personal: flags['personal'],

package/dist/commands/doctor.js

@@ -2,7 +2,9 @@ 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, } from '../profiles.js';
+import { getActiveProfile, getProfile, getConfigFilePath, getConfigFilePermissions, getAuthMethod, getSecretStorage, isExpiring, isRefreshable, listProfiles, } from '../profiles.js';
+import { isSecretStoreAvailable } from '../secret-store.js';
+import { getBaseUrl } from '../client.js';
 export default class Doctor extends BaseCommand {
     static description = 'Диагностика окружения: Node.js, сеть, токен, конфигурация';
     static examples = [
@@ -30,30 +32,39 @@ export default class Doctor extends BaseCommand {
             checks.push({ name: 'node', status: 'error', version: nodeVersion, required: '>=20' });
             this.printCheck('error', `Node.js        v${nodeVersion} — требуется >=20`, format);
         }
-        // 2. Network
+        // 2. Network. Check the host the CLI actually talks to: on-premise installs
+        // point elsewhere, and probing the cloud there reports a healthy network
+        // while the server the user works against is down.
+        const baseUrl = getBaseUrl();
+        const host = new URL(baseUrl).host;
         try {
             const start = Date.now();
             const controller = new AbortController();
             const timer = setTimeout(() => controller.abort(), 5000);
-            await fetch('https://api.pachca.com/api/shared/v1/profile', {
+            await fetch(`${baseUrl}/profile`, {
                 method: 'HEAD',
                 signal: controller.signal,
             });
             clearTimeout(timer);
             const latency = Date.now() - start;
-            checks.push({ name: 'network', status: 'ok', host: 'api.pachca.com', latency_ms: latency });
-            this.printCheck('ok', `Сеть           api.pachca.com доступен (${latency}ms)`, format);
+            checks.push({ name: 'network', status: 'ok', host, latency_ms: latency });
+            this.printCheck('ok', `Сеть           ${host} доступен (${latency}ms)`, format);
             networkOk = true;
         }
         catch {
-            checks.push({ name: 'network', status: 'error', host: 'api.pachca.com' });
-            this.printCheck('error', `Сеть           api.pachca.com недоступен (таймаут 5s)`, format);
+            checks.push({ name: 'network', status: 'error', host });
+            this.printCheck('error', `Сеть           ${host} недоступен (таймаут 5s)`, format);
         }
-        // 3. Config file
+        // 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.
         const configPath = getConfigFilePath();
+        const activeName = getActiveProfile();
+        const activeProfile = activeName ? listProfiles()[activeName] : undefined;
+        const storage = activeProfile ? getSecretStorage(activeProfile) : 'file';
         if (fs.existsSync(configPath)) {
             const permissions = getConfigFilePermissions();
-            if (permissions && Number.parseInt(permissions, 8) > 0o600) {
+            if (storage === 'file' && permissions && Number.parseInt(permissions, 8) > 0o600) {
                 checks.push({ name: 'config', status: 'warning', path: configPath, permissions, expected: '600' });
                 this.printCheck('warning', `Конфиг         ${configPath} (права: ${permissions} — рекомендуется chmod 600)`, format);
             }
@@ -66,13 +77,48 @@ export default class Doctor extends BaseCommand {
             checks.push({ name: 'config', status: 'error', path: configPath });
             this.printCheck('error', `Конфиг         файл не найден (запустите pachca auth login)`, 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') {
+            const storeUp = isSecretStoreAvailable();
+            secretReadable = storeUp && !!getProfile(activeName)?.token;
+            if (secretReadable) {
+                checks.push({ name: 'secret_store', status: 'ok', storage });
+                this.printCheck('ok', `Хранилище      хранилище ключей ОС, секрет читается`, format);
+            }
+            else {
+                checks.push({ name: 'secret_store', status: 'error', storage, available: storeUp });
+                this.printCheck('error', storeUp
+                    ? `Хранилище      секрет профиля не найден — войдите заново: pachca auth login`
+                    : `Хранилище      хранилище ключей ОС недоступно — разблокируйте связку ключей`, format);
+            }
+        }
+        else if (activeProfile) {
+            checks.push({ name: 'secret_store', status: 'ok', storage: 'file' });
+            this.printCheck('ok', `Хранилище      файл конфигурации`, format);
+        }
         // 4. Profile
         const profileName = getActiveProfile();
         if (profileName) {
             const profile = getProfile(profileName);
             if (profile) {
-                checks.push({ name: 'profile', status: 'ok', profile: profileName, type: profile.type, user: profile.user });
-                this.printCheck('ok', `Профиль        ${profileName} (${profile.type}: ${profile.user})`, format);
+                const method = getAuthMethod(profile);
+                const expiry = method === 'oauth' && profile.expires_at
+                    ? `, истекает ${new Date(profile.expires_at).toLocaleString('ru-RU')}`
+                    : method === 'token'
+                        ? ', бессрочный'
+                        : '';
+                checks.push({
+                    name: 'profile',
+                    status: 'ok',
+                    profile: profileName,
+                    type: profile.type,
+                    user: profile.user,
+                    auth: method,
+                    storage,
+                });
+                this.printCheck('ok', `Профиль        ${profileName} (${profile.type}: ${profile.user}) — ${method === 'oauth' ? 'вход через браузер' : 'готовый токен'}${expiry}`, format);
                 profileOk = true;
             }
             else {
@@ -84,16 +130,22 @@ export default class Doctor extends BaseCommand {
             checks.push({ name: 'profile', status: 'error' });
             this.printCheck('error', `Профиль        не настроен (запустите pachca auth login)`, format);
         }
-        // 5. Token (skip if no network or no profile)
-        if (!networkOk || !profileOk) {
-            const reason = !networkOk ? 'нет сети' : 'нет профиля';
+        // 5. Token (skip if no network, no profile, 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 ? 'нет профиля' : 'секрет недоступен';
             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);
             try {
-                const response = await fetch('https://api.pachca.com/api/shared/v1/oauth/token/info', {
+                const response = await fetch(`${baseUrl}/oauth/token/info`, {
                     headers: { Authorization: `Bearer ${profile.token}` },
                 });
                 if (response.ok) {
@@ -102,6 +154,10 @@ export default class Doctor extends BaseCommand {
                     checks.push({ name: 'token', status: 'ok', scopes_count: scopeCount });
                     this.printCheck('ok', `Токен          действителен (${scopeCount} скоупов)`, format);
                 }
+                else if (willRenew) {
+                    checks.push({ name: 'token', status: 'ok', renewable: true, http_status: response.status });
+                    this.printCheck('ok', `Токен          срок истёк — обновится при следующей команде`, format);
+                }
                 else {
                     checks.push({ name: 'token', status: 'error', http_status: response.status });
                     this.printCheck('error', `Токен          недействителен (${response.status}) — обновите: pachca auth login`, format);

package/dist/commands/introspect.js

@@ -48,6 +48,7 @@ export default class Introspect extends BaseCommand {
         }
         // D3 single source: baseFlagNames derived from BaseCommand.baseFlags
         const baseFlagNames = new Set(Object.keys(BaseCommand.baseFlags));
-        this.output(normalizeCommand(commandId, cmdMeta, baseFlagNames));
+        const baseFlagDescriptions = new Map(Object.entries(BaseCommand.baseFlags).map(([name, def]) => [name, def.description ?? '']));
+        this.output(normalizeCommand(commandId, cmdMeta, baseFlagNames, baseFlagDescriptions));
     }
 }

package/dist/commands/messages/create.js

@@ -18,7 +18,7 @@ export default class MessagesCreate extends BaseCommand {
     static flags = {
         ...BaseCommand.baseFlags,
         'entity-type': Flags.string({
-            description: "Тип сущности",
+            description: "Тип сущности. Регистр значения не учитывается. Значение вне списка возвращает `400` с кодом `invalid`.",
         }),
         'entity-id': Flags.integer({
             description: "Идентификатор сущности (pachca chats list | pachca users list)",

package/dist/commands/security/list.js

@@ -24,7 +24,7 @@ export default class SecurityList extends BaseCommand {
         }),
         'event-key': Flags.string({
             description: "Фильтр по конкретному типу события",
-            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted", "video_call_started", "video_call_finished", "video_call_recording_ready"],
+            options: ["user_login", "user_logout", "user_2fa_fail", "user_2fa_success", "user_created", "user_deleted", "user_role_changed", "user_updated", "tag_created", "tag_deleted", "user_added_to_tag", "user_removed_from_tag", "chat_created", "chat_renamed", "chat_permission_changed", "user_chat_join", "user_chat_leave", "tag_added_to_chat", "tag_removed_from_chat", "message_updated", "message_deleted", "message_created", "reaction_created", "reaction_deleted", "thread_created", "access_token_created", "access_token_updated", "access_token_destroy", "kms_encrypt", "kms_decrypt", "audit_events_accessed", "company_chats_accessed", "company_bots_accessed", "dlp_violation_detected", "search_users_api", "search_chats_api", "search_messages_api", "bot_scopes_updated", "bot_webhook_settings_updated", "bot_token_recreated", "bot_deleted", "bot_oauth_client_updated", "oauth_authorization_granted", "oauth_authorization_revoked", "video_call_started", "video_call_finished", "video_call_recording_ready"],
         }),
         'actor-id': Flags.string({
             description: "Идентификатор пользователя, выполнившего действие",