@pachca/cli 2026.7.2 → 2026.8.1

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/chats/list.js

@@ -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/messages/list.js

@@ -5,7 +5,8 @@ import * as clack from '@clack/prompts';
 export default class MessagesList extends BaseCommand {
     static description = "Список сообщений чата";
     static examples = [
-        "Получить историю сообщений чата — Получи сообщения чата с пагинацией:\n  $ pachca messages list"
+        "Получить историю сообщений чата — Получи сообщения чата с пагинацией:\n  $ pachca messages list",
+        "Получить список активных тредов за период — Для каждого треда возьми `chat_id` и подтяни сообщения:\n  $ pachca messages list"
     ];
     static scope = "messages:read";
     static apiMethod = "GET";

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", "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: "Идентификатор пользователя, выполнившего действие",

package/dist/commands/upgrade.js

@@ -69,7 +69,7 @@ export default class Upgrade extends BaseCommand {
                 this.output({ upgraded: false, current: currentVersion, error: 'Cannot determine latest version' });
             }
             else {
-                process.stderr.write('✗ Не удалось определить последнюю версию\n');
+                process.stderr.write('✗ Не удалось определить последнюю версию.\n');
             }
             this.exit(1);
         }

package/dist/data/changelog.json

@@ -1,4 +1,119 @@
 [
+    {
+        "version": "2026.8.1",
+        "date": "6 августа 2026",
+        "changes": [
+            {
+                "type": "+",
+                "command": "auth login",
+                "description": "Вход через браузер — без ручной вставки токена. CLI показывает адрес и код, открывает браузер и ждёт подтверждения. Токен такого входа живёт час и продлевается сам перед каждой командой; при параллельных процессах обновляет только один, остальные ждут результат. Флаг `--no-browser` печатает адрес и код, не открывая браузер. `--token` и `PACHCA_TOKEN` работают как раньше — это путь для CI и агентов"
+            },
+            {
+                "type": "+",
+                "command": "auth login",
+                "description": "Токен хранится в хранилище ключей ОС — Keychain на macOS, Secret Service на Linux, Диспетчер учётных данных на Windows; в файле конфигурации остаются только имя, почта и права. Где хранилища нет (headless-машина, контейнер), CLI сохраняет токен в файл и сообщает об этом при входе. Отказаться от хранилища: флаг `--insecure-storage` или переменная `PACHCA_SECRET_STORE=file`"
+            },
+            {
+                "type": "+",
+                "command": "auth status",
+                "description": "Показывает способ входа, срок жизни токена, выданные права и где хранится токен — с этого стоит начинать разбор внезапного `403`"
+            },
+            {
+                "type": "+",
+                "command": "auth list",
+                "description": "Колонки `auth` и `expires_at` — видно, какой профиль вошёл через браузер, а какой держит готовый токен"
+            },
+            {
+                "type": "~",
+                "command": "auth logout",
+                "description": "Токен входа через браузер гасится на сервере — доступ закрывается в момент выхода, а не по истечении срока. Если отозвать не удалось, CLI об этом говорит и не выдаёт удаление профиля за закрытый доступ. Готовый токен продолжает работать: отозвать его можно только в интерфейсе"
+            },
+            {
+                "type": "~",
+                "description": "Отказ по правам разбирается отдельно от прочих `403`: CLI называет недостающее право и объясняет причину. В JSON-выводе — тип `PACHCA_SCOPE_ERROR` и поле `scope`"
+            },
+            {
+                "type": "~",
+                "description": "В подсказке «токен не найден» появилась переменная окружения `PACHCA_TOKEN` — раньше предлагался только флаг `--token`, хотя переменная работает и без входа"
+            },
+            {
+                "type": "+",
+                "command": "auth status",
+                "description": "Флаг `--remote` — спросить права у сервера вместо сохранённых при входе. Набор прав фиксируется в момент входа, и после смены роли локальный список устаревает; при расхождении CLI говорит об этом и обновляет сохранённый"
+            },
+            {
+                "type": "+",
+                "command": "auth login",
+                "description": "`--token -` читает токен из потока ввода: `echo $TOKEN | pachca auth login --token -` не оставляет секрет в истории оболочки и в списке процессов. Передача значением работает как раньше"
+            },
+            {
+                "type": "+",
+                "command": "auth switch",
+                "description": "Сразу после переключения сообщает, если секрет профиля не читается или срок токена истёк — раньше ошибка всплывала на следующей команде"
+            },
+            {
+                "type": "~",
+                "command": "doctor",
+                "description": "Проверяет хранилище ключей ОС отдельным пунктом и не выдаёт заблокированную связку за недействительный токен. Показывает способ входа и срок жизни токена. Права файла конфигурации проверяются только когда токен действительно лежит в файле"
+            },
+            {
+                "type": "-",
+                "command": "doctor",
+                "description": "Проверяет тот адрес API, с которым работает CLI, а не всегда `api.pachca.com` — при изменённом адресе сервера команда рапортовала о доступности чужого хоста"
+            },
+            {
+                "type": "-",
+                "command": "doctor",
+                "description": "Истёкший, но обновляемый токен больше не выдаётся за недействительный: команда говорит, что он обновится при следующем вызове, вместо совета войти заново"
+            },
+            {
+                "type": "+",
+                "command": "chats list",
+                "description": "Флаг `--archived` — вернуть архивные чаты вместе с активными. Отличить их можно по полю `archived` в выдаче"
+            },
+            {
+                "type": "+",
+                "command": "security list",
+                "description": "Фильтр `--event-key` принимает `bot_oauth_client_updated`, `oauth_authorization_granted` и `oauth_authorization_revoked`"
+            },
+            {
+                "type": "+",
+                "command": "security list",
+                "description": "Фильтр `--event-key` принимает `bot_oauth_client_updated`, `oauth_authorization_granted` и `oauth_authorization_revoked`"
+            },
+            {
+                "type": "-",
+                "command": "",
+                "description": "Подсказка «токен не найден» вела на несуществующую страницу `/guides/authorization` — теперь на `/api/authorization`"
+            },
+            {
+                "type": "+",
+                "command": "",
+                "description": "`pachca --help` заканчивается ссылкой на документацию и на `pachca guide` — из терминала стало видно, куда идти за сценариями"
+            }
+        ]
+    },
+    {
+        "version": "2026.8.0",
+        "date": "1 августа 2026",
+        "changes": [
+            {
+                "type": "~",
+                "command": "api",
+                "description": "`api POST /messages --spec` и `--docs`: у поля `files[].name` описано требование к расширению — оно должно совпадать с расширением файла в `key`"
+            },
+            {
+                "type": "~",
+                "command": "api",
+                "description": "`api GET /audit_events --spec`: уточнён состав деталей событий видеозвонков, `user_updated`, `bot_deleted` и `bot_token_recreated`"
+            },
+            {
+                "type": "~",
+                "command": "messages list",
+                "description": "В примерах появился шаг сценария «Получить список активных тредов за период» — раньше он был спрятан в тексте описания шага"
+            }
+        ]
+    },
     {
         "version": "2026.7.2",
         "date": "27 июля 2026",