@pachca/cli 2026.3.0

package/README.md

@@ -0,0 +1,352 @@
+# @pachca/cli
+
+Официальный CLI для [Пачки](https://pachca.com).
+
+## Установка
+
+```
+npm install -g @pachca/cli
+
+# Или без установки:
+npx @pachca/cli users list
+```
+
+## Быстрый старт
+
+```
+pachca auth login          # сохранить токен
+pachca users list          # список сотрудников
+pachca messages create --entity-id 123 --content "Привет!"
+```
+
+Получить токен: https://dev.pachca.com/guides/authorization
+
+## Использование в агентах (Claude, Cursor и др.)
+
+Если агент устанавливает CLI по просьбе пользователя и токена ещё нет — агент должен запросить его у пользователя:
+
+```
+# Агент спрашивает: "Нужен API-токен Пачки."
+# "Получите его на https://dev.pachca.com/guides/authorization"
+pachca auth login --token <токен от пользователя>
+
+# Дальше команды работают без токена в каждой строке
+pachca users list
+pachca messages create --entity-id 123 --content "Привет!"
+```
+
+Если токен уже есть в окружении — `auth login` не нужен:
+
+```
+PACHCA_TOKEN=$TOKEN pachca users list
+```
+
+## Профили (несколько токенов)
+
+Храните несколько токенов под именами — личный, боты:
+
+```
+pachca auth login --profile personal
+pachca auth login --profile bot-notify
+pachca auth list
+pachca auth switch bot-notify
+```
+
+Токены хранятся в `~/.config/pachca/config.toml` (chmod 600).
+В CI — через переменную окружения PACHCA_TOKEN.
+
+## Поиск по сценариям
+
+Не знаете какую команду использовать? Поищите по задаче:
+
+```
+pachca guide "отправить файл"
+pachca guide "создать беседу и добавить участников"
+pachca guide            # список всех сценариев
+```
+
+<!-- AUTO:COMMANDS -->
+## Команды
+
+### security
+
+| Команда | Описание |
+|---------|---------|
+| `pachca security list` | Журнал аудита событий |
+
+### bots
+
+| Команда | Описание |
+|---------|---------|
+| `pachca bots update` | Редактирование бота |
+| `pachca bots list-events` | История событий |
+| `pachca bots remove-event` | Удаление события |
+
+### chats
+
+| Команда | Описание |
+|---------|---------|
+| `pachca chats create` | Новый чат |
+| `pachca chats list` | Список чатов |
+| `pachca chats get` | Информация о чате |
+| `pachca chats update` | Обновление чата |
+| `pachca chats archive` | Архивация чата |
+| `pachca chats unarchive` | Разархивация чата |
+
+### common
+
+| Команда | Описание |
+|---------|---------|
+| `pachca common request-export` | Экспорт сообщений |
+| `pachca common get-exports` | Скачать архив экспорта |
+| `pachca common custom-properties` | Список дополнительных полей |
+| `pachca common direct-url` | Загрузка файла |
+| `pachca common uploads` | Получение подписи, ключа и других параметров |
+
+### members
+
+| Команда | Описание |
+|---------|---------|
+| `pachca members add-group-tags` | Добавление тегов |
+| `pachca members remove-group-tag` | Исключение тега |
+| `pachca members leave` | Выход из беседы или канала |
+| `pachca members list` | Список участников чата |
+| `pachca members add` | Добавление пользователей |
+| `pachca members remove` | Исключение пользователя |
+| `pachca members update` | Редактирование роли |
+
+### group-tags
+
+| Команда | Описание |
+|---------|---------|
+| `pachca group-tags create` | Новый тег |
+| `pachca group-tags list` | Список тегов сотрудников |
+| `pachca group-tags get` | Информация о теге |
+| `pachca group-tags update` | Редактирование тега |
+| `pachca group-tags delete` | Удаление тега |
+| `pachca group-tags list-users` | Список сотрудников тега |
+
+### messages
+
+| Команда | Описание |
+|---------|---------|
+| `pachca messages create` | Новое сообщение |
+| `pachca messages list` | Список сообщений чата |
+| `pachca messages get` | Информация о сообщении |
+| `pachca messages update` | Редактирование сообщения |
+| `pachca messages delete` | Удаление сообщения |
+| `pachca messages pin` | Закрепление сообщения |
+| `pachca messages unpin` | Открепление сообщения |
+
+### link-previews
+
+| Команда | Описание |
+|---------|---------|
+| `pachca link-previews add` | Unfurl (разворачивание ссылок) |
+
+### reactions
+
+| Команда | Описание |
+|---------|---------|
+| `pachca reactions add` | Добавление реакции |
+| `pachca reactions remove` | Удаление реакции |
+| `pachca reactions list` | Список реакций |
+
+### read-member
+
+| Команда | Описание |
+|---------|---------|
+| `pachca read-member list-readers` | Список прочитавших сообщение |
+
+### thread
+
+| Команда | Описание |
+|---------|---------|
+| `pachca thread add` | Новый тред |
+| `pachca thread get` | Информация о треде |
+
+### profile
+
+| Команда | Описание |
+|---------|---------|
+| `pachca profile get-info` | Информация о токене |
+| `pachca profile get` | Информация о профиле |
+| `pachca profile get-status` | Текущий статус |
+| `pachca profile update-status` | Новый статус |
+| `pachca profile delete-status` | Удаление статуса |
+
+### search
+
+| Команда | Описание |
+|---------|---------|
+| `pachca search list-chats` | Поиск чатов |
+| `pachca search list-messages` | Поиск сообщений |
+| `pachca search list-users` | Поиск сотрудников |
+
+### tasks
+
+| Команда | Описание |
+|---------|---------|
+| `pachca tasks create` | Новое напоминание |
+| `pachca tasks list` | Список напоминаний |
+| `pachca tasks get` | Информация о напоминании |
+| `pachca tasks update` | Редактирование напоминания |
+| `pachca tasks delete` | Удаление напоминания |
+
+### users
+
+| Команда | Описание |
+|---------|---------|
+| `pachca users create` | Создать сотрудника |
+| `pachca users list` | Список сотрудников |
+| `pachca users get` | Информация о сотруднике |
+| `pachca users update` | Редактирование сотрудника |
+| `pachca users delete` | Удаление сотрудника |
+| `pachca users get-status` | Статус сотрудника |
+| `pachca users update-status` | Новый статус сотрудника |
+| `pachca users remove-status` | Удаление статуса сотрудника |
+
+### views
+
+| Команда | Описание |
+|---------|---------|
+| `pachca views open` | Открытие представления |
+
+<!-- AUTO:COMMANDS:END -->
+
+<!-- AUTO:FLAGS -->
+## Глобальные флаги
+
+| Флаг | Короткий | Описание |
+|------|----------|----------|
+| `--output <format>` | `-o` | Формат вывода: table, json, yaml, csv |
+| `--columns <list>` | `-c` | Колонки для table-вывода |
+| `--no-header` | | Скрыть заголовок таблицы |
+| `--profile <name>` | `-p` | Профиль для этой команды |
+| `--token <value>` | | Bearer-токен для этого вызова |
+| `--quiet` | `-q` | Подавить вывод кроме ошибок |
+| `--verbose` | `-v` | Показывать HTTP-детали |
+| `--no-input` | | Отключить промпты |
+| `--dry-run` | | Показать запрос без отправки |
+| `--timeout <seconds>` | | Таймаут запроса |
+| `--no-retry` | | Отключить авто-retry |
+
+<!-- AUTO:FLAGS:END -->
+
+## Пагинация
+
+```
+# Первая страница (по умолчанию)
+pachca users list --limit 20
+
+# Следующая страница вручную
+pachca users list --cursor eyJpZCI6NTB9
+
+# Загрузить все страницы автоматически
+pachca users list --all
+```
+
+## Вывод и скрипты
+
+```
+# JSON вместо таблицы
+pachca users list -o json
+
+# YAML
+pachca users list -o yaml
+
+# CSV (для Excel / Google Sheets)
+pachca users list -o csv
+
+# Выбрать колонки
+pachca users list --columns id,email,role
+
+# Только значения без заголовка (для скриптов)
+pachca users list --columns email --no-header
+
+# Пайп — цвет отключается автоматически
+pachca users list -o json | jq '.[].name'
+
+# Текст из файла или pipe
+pachca messages create --entity-id 123 < message.txt
+echo "Деплой завершён" | pachca messages create --entity-id 123
+
+# Скачать файл (для команд с редиректом)
+pachca common get-exports 123 --save ./export.zip
+
+# Посмотреть запрос без отправки
+pachca messages create --entity-id 123 --content "Привет" --dry-run
+
+# Тихий режим — только exit code, без вывода
+pachca messages create -q --entity-id 123 --content "Деплой завершён"
+
+# CI / неинтерактивный режим
+PACHCA_TOKEN=xxx pachca messages create --entity-id 123 --content "Деплой завершён" --no-input
+
+# DELETE без подтверждения (в TTY)
+pachca users delete 1234 --force
+```
+
+## Прямые API-запросы
+
+Escape hatch для нестандартных запросов без сгенерированных команд:
+
+```
+pachca api GET /messages --query chat_id=123
+pachca api POST /messages -F message[chat_id]=12345 -f message[content]="Привет"
+pachca api POST /messages --input payload.json
+pachca api GET /profile -o yaml --dry-run
+```
+
+## Настройки
+
+Установить постоянные дефолты:
+
+```
+pachca config set defaults.output json   # всегда JSON
+pachca config set defaults.timeout 60    # таймаут 60s
+pachca config list                       # все настройки
+```
+
+## Диагностика
+
+```
+pachca doctor
+```
+
+## Доступные команды
+
+```
+pachca commands --available
+```
+
+## Changelog
+
+```
+pachca changelog
+```
+
+## Shell completion
+
+```
+pachca autocomplete zsh   # zsh completion
+pachca autocomplete bash  # bash completion
+pachca autocomplete fish  # fish completion
+```
+
+## Переменные окружения
+
+| Переменная | Описание |
+|-----------|---------|
+| `PACHCA_TOKEN` | Bearer-токен (высший приоритет, удобно для CI) |
+| `PACHCA_PROFILE` | Активный профиль для команды |
+| `PACHCA_TIMEOUT` | Таймаут запроса в секундах (по умолчанию 30) |
+| `PACHCA_PROMPT_DISABLED` | Отключить интерактивные промпты |
+| `CI` | Стандартная переменная CI-окружений |
+| `NO_COLOR` | Отключить цвет в выводе |
+| `FORCE_COLOR` | Принудительно включить цвет |
+| `PACHCA_SKIP_NEW_VERSION_CHECK` | Отключить проверку обновлений |
+
+## Документация API
+
+Полная документация: https://dev.pachca.com

package/README.template.md

@@ -0,0 +1,190 @@
+# @pachca/cli
+
+Официальный CLI для [Пачки](https://pachca.com).
+
+## Установка
+
+```
+npm install -g @pachca/cli
+
+# Или без установки:
+npx @pachca/cli users list
+```
+
+## Быстрый старт
+
+```
+pachca auth login          # сохранить токен
+pachca users list          # список сотрудников
+pachca messages create --entity-id 123 --content "Привет!"
+```
+
+Получить токен: https://dev.pachca.com/guides/authorization
+
+## Использование в агентах (Claude, Cursor и др.)
+
+Если агент устанавливает CLI по просьбе пользователя и токена ещё нет — агент должен запросить его у пользователя:
+
+```
+# Агент спрашивает: "Нужен API-токен Пачки."
+# "Получите его на https://dev.pachca.com/guides/authorization"
+pachca auth login --token <токен от пользователя>
+
+# Дальше команды работают без токена в каждой строке
+pachca users list
+pachca messages create --entity-id 123 --content "Привет!"
+```
+
+Если токен уже есть в окружении — `auth login` не нужен:
+
+```
+PACHCA_TOKEN=$TOKEN pachca users list
+```
+
+## Профили (несколько токенов)
+
+Храните несколько токенов под именами — личный, боты:
+
+```
+pachca auth login --profile personal
+pachca auth login --profile bot-notify
+pachca auth list
+pachca auth switch bot-notify
+```
+
+Токены хранятся в `~/.config/pachca/config.toml` (chmod 600).
+В CI — через переменную окружения PACHCA_TOKEN.
+
+## Поиск по сценариям
+
+Не знаете какую команду использовать? Поищите по задаче:
+
+```
+pachca guide "отправить файл"
+pachca guide "создать беседу и добавить участников"
+pachca guide            # список всех сценариев
+```
+
+<!-- AUTO:COMMANDS -->
+<!-- AUTO:COMMANDS:END -->
+
+<!-- AUTO:FLAGS -->
+<!-- AUTO:FLAGS:END -->
+
+## Пагинация
+
+```
+# Первая страница (по умолчанию)
+pachca users list --limit 20
+
+# Следующая страница вручную
+pachca users list --cursor eyJpZCI6NTB9
+
+# Загрузить все страницы автоматически
+pachca users list --all
+```
+
+## Вывод и скрипты
+
+```
+# JSON вместо таблицы
+pachca users list -o json
+
+# YAML
+pachca users list -o yaml
+
+# CSV (для Excel / Google Sheets)
+pachca users list -o csv
+
+# Выбрать колонки
+pachca users list --columns id,email,role
+
+# Только значения без заголовка (для скриптов)
+pachca users list --columns email --no-header
+
+# Пайп — цвет отключается автоматически
+pachca users list -o json | jq '.[].name'
+
+# Текст из файла или pipe
+pachca messages create --entity-id 123 < message.txt
+echo "Деплой завершён" | pachca messages create --entity-id 123
+
+# Скачать файл (для команд с редиректом)
+pachca common get-exports 123 --save ./export.zip
+
+# Посмотреть запрос без отправки
+pachca messages create --entity-id 123 --content "Привет" --dry-run
+
+# Тихий режим — только exit code, без вывода
+pachca messages create -q --entity-id 123 --content "Деплой завершён"
+
+# CI / неинтерактивный режим
+PACHCA_TOKEN=xxx pachca messages create --entity-id 123 --content "Деплой завершён" --no-input
+
+# DELETE без подтверждения (в TTY)
+pachca users delete 1234 --force
+```
+
+## Прямые API-запросы
+
+Escape hatch для нестандартных запросов без сгенерированных команд:
+
+```
+pachca api GET /messages --query chat_id=123
+pachca api POST /messages -F message[chat_id]=12345 -f message[content]="Привет"
+pachca api POST /messages --input payload.json
+pachca api GET /profile -o yaml --dry-run
+```
+
+## Настройки
+
+Установить постоянные дефолты:
+
+```
+pachca config set defaults.output json   # всегда JSON
+pachca config set defaults.timeout 60    # таймаут 60s
+pachca config list                       # все настройки
+```
+
+## Диагностика
+
+```
+pachca doctor
+```
+
+## Доступные команды
+
+```
+pachca commands --available
+```
+
+## Changelog
+
+```
+pachca changelog
+```
+
+## Shell completion
+
+```
+pachca autocomplete zsh   # zsh completion
+pachca autocomplete bash  # bash completion
+pachca autocomplete fish  # fish completion
+```
+
+## Переменные окружения
+
+| Переменная | Описание |
+|-----------|---------|
+| `PACHCA_TOKEN` | Bearer-токен (высший приоритет, удобно для CI) |
+| `PACHCA_PROFILE` | Активный профиль для команды |
+| `PACHCA_TIMEOUT` | Таймаут запроса в секундах (по умолчанию 30) |
+| `PACHCA_PROMPT_DISABLED` | Отключить интерактивные промпты |
+| `CI` | Стандартная переменная CI-окружений |
+| `NO_COLOR` | Отключить цвет в выводе |
+| `FORCE_COLOR` | Принудительно включить цвет |
+| `PACHCA_SKIP_NEW_VERSION_CHECK` | Отключить проверку обновлений |
+
+## Документация API
+
+Полная документация: https://dev.pachca.com

package/bin/dev.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env tsx
+
+import { execute } from '@oclif/core';
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import { execute } from '@oclif/core';
+
+await execute({ dir: import.meta.url });

package/dist/base-command.d.ts

@@ -0,0 +1,74 @@
+import { Command, type Interfaces } from '@oclif/core';
+import { resolveToken } from './profiles.js';
+import { type RequestOptions, type ClientFlags } from './client.js';
+import { type OutputFormat, type OutputOptions } from './output.js';
+export type BaseFlags = Interfaces.InferredFlags<typeof BaseCommand.baseFlags>;
+export declare abstract class BaseCommand extends Command {
+    static baseFlags: {
+        output: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        columns: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        'no-header': Interfaces.BooleanFlag<boolean>;
+        'no-truncate': Interfaces.BooleanFlag<boolean>;
+        profile: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        token: Interfaces.OptionFlag<string | undefined, Interfaces.CustomOptions>;
+        quiet: Interfaces.BooleanFlag<boolean>;
+        'no-color': Interfaces.BooleanFlag<boolean>;
+        verbose: Interfaces.BooleanFlag<boolean>;
+        'no-input': Interfaces.BooleanFlag<boolean>;
+        'dry-run': Interfaces.BooleanFlag<boolean>;
+        timeout: Interfaces.OptionFlag<number | undefined, Interfaces.CustomOptions>;
+        'no-retry': Interfaces.BooleanFlag<boolean>;
+        json: Interfaces.BooleanFlag<boolean>;
+    };
+    private _parsedFlags;
+    protected get parsedFlags(): BaseFlags;
+    protected set parsedFlags(flags: BaseFlags);
+    /**
+     * Get the resolved output format, respecting flag > config > TTY default.
+     */
+    protected getOutputFormat(): OutputFormat;
+    /**
+     * Get output options from parsed flags.
+     */
+    protected getOutputOptions(): OutputOptions;
+    /**
+     * Get client flags for the HTTP client.
+     */
+    protected getClientFlags(): ClientFlags;
+    /**
+     * Whether the CLI is in interactive mode for this command.
+     */
+    protected isInteractive(): boolean;
+    /**
+     * Resolve the auth token.
+     */
+    protected resolveAuth(): ReturnType<typeof resolveToken>;
+    /**
+     * Check if the current profile has the required scope.
+     * Exits with error if scope is missing.
+     */
+    protected checkScope(requiredScope: string): void;
+    /**
+     * Make an authenticated API request.
+     */
+    protected apiRequest(opts: Omit<RequestOptions, 'token'>): Promise<{
+        data: unknown;
+        status: number;
+        headers: Headers;
+    }>;
+    /**
+     * Output data in the configured format.
+     */
+    protected output(data: unknown): void;
+    /**
+     * Output a success message to stderr.
+     */
+    protected success(message: string): void;
+    /**
+     * Handle errors with structured output.
+     */
+    protected catch(err: Error & {
+        exitCode?: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=base-command.d.ts.map

package/dist/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EACL,YAAY,EAMb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAgD,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAClH,OAAO,EAA0C,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5G,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,aAAa,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAE/E,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,SAAS;;;;;;;;;;;;;;;MA2Dd;IAEF,OAAO,CAAC,YAAY,CAAa;IACjC,SAAS,KAAK,WAAW,IAAI,SAAS,CAA8B;IACpE,SAAS,KAAK,WAAW,CAAC,KAAK,EAAE,SAAS,EAKzC;IAED;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,YAAY;IAQzC;;OAEG;IACH,SAAS,CAAC,gBAAgB,IAAI,aAAa;IAU3C;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,WAAW;IAYvC;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,OAAO;IAKlC;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,UAAU,CAAC,OAAO,YAAY,CAAC;IAOxD;;;OAGG;IACH,SAAS,CAAC,UAAU,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IA+BjD;;OAEG;cACa,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAmB7H;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAUrC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;cACsB,KAAK,CAAC,GAAG,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CA6ClF"}