@pachca/cli 2026.5.3 → 2026.5.4

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 2026.5.4  (20 мая 2026)
+
+- **Добавлено** (threads list): Новая команда — список доступных тредов с фильтрами `--last-message-at-after` / `--last-message-at-before` и курсорной пагинацией
+
 ## 2026.5.2  (17 мая 2026)
 
 - **Добавлено** (users create): Параметр `--chat-ids` — добавить сотрудника в указанные чаты сразу при создании. Параметр `--role` теперь принимает значение `guest`: для роли `guest` нужно передать `--chat-ids` ровно с одним активным чатом, иначе API вернёт `400`

package/README.md

@@ -8,7 +8,7 @@
 npm install -g @pachca/cli
 
 # Или без установки:
-npx @pachca/cli users list
+npx -y @pachca/cli users list
 ```
 
 ## Быстрый старт
@@ -163,6 +163,7 @@ pachca guide            # список всех сценариев
 | Команда | Описание |
 |---------|---------|
 | `pachca threads add` | Новый тред |
+| `pachca threads list` | Список тредов |
 | `pachca threads get` | Информация о треде |
 
 ### profile

package/README.template.md

@@ -8,7 +8,7 @@
 npm install -g @pachca/cli
 
 # Или без установки:
-npx @pachca/cli users list
+npx -y @pachca/cli users list
 ```
 
 ## Быстрый старт

package/dist/api-introspect.js

@@ -20,7 +20,7 @@ export function buildListRows(entries) {
  * Detect a self-documenting mode from raw argv (before this.parse()).
  * `pachca api` already requires the method positionally, so
  * `pachca api POST /messages --describe` is unambiguous by construction
- * (no `-X` needed, unlike Notion's `ntn api`).
+ * (the HTTP method is a positional arg, so no `-X`-style flag is needed).
  */
 export function detectIntrospectMode(argv) {
     if (argv.includes('--describe'))

package/dist/commands/threads/list.js

@@ -0,0 +1,102 @@
+// Auto-generated from openapi.yaml — DO NOT EDIT
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+export default class ThreadsList extends BaseCommand {
+    static description = "Список тредов";
+    static examples = [
+        "Получить список активных тредов за период:\n  $ pachca threads list"
+    ];
+    static scope = "threads:read";
+    static apiMethod = "GET";
+    static apiPath = "/threads";
+    static defaultColumns = ["id", "chat_id", "message_id", "message_chat_id", "updated_at"];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'last-message-at-after': Flags.string({
+            description: "Фильтрация по времени последнего сообщения в треде. Будут возвращены только те треды, время последнего сообщения в которых не раньше чем указанное (в формате YYYY-MM-DDThh:mm:ss.sssZ).",
+        }),
+        'last-message-at-before': Flags.string({
+            description: "Фильтрация по времени последнего сообщения в треде. Будут возвращены только те треды, время последнего сообщения в которых не позже чем указанное (в формате YYYY-MM-DDThh:mm:ss.sssZ).",
+        }),
+        limit: Flags.integer({
+            description: 'Количество результатов на страницу',
+        }),
+        cursor: Flags.string({
+            description: 'Курсор для следующей страницы',
+        }),
+        all: Flags.boolean({
+            description: 'Загрузить все страницы автоматически',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(ThreadsList);
+        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 = {
+                    'last_message_at_after': flags['last-message-at-after'],
+                    'last_message_at_before': flags['last-message-at-before'],
+                    limit: flags.limit,
+                    cursor: nextCursor,
+                };
+                const response = await this.apiRequest({ method: 'GET', path: '/threads', 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: '/threads',
+            query: {
+                'last_message_at_after': flags['last-message-at-after'],
+                'last_message_at_before': flags['last-message-at-before'],
+                limit: flags.limit,
+                cursor: flags.cursor,
+            },
+        });
+        const responseBody = data;
+        const items = responseBody.data ?? responseBody;
+        this.output(items);
+    }
+}

package/dist/data/alternatives.json

@@ -52,6 +52,7 @@
     "tasks:get": "Информация о напоминании",
     "tasks:update": "Редактирование напоминания",
     "tasks:delete": "Удаление напоминания",
+    "threads:list": "Список тредов",
     "threads:get": "Информация о треде",
     "common:uploads": "Получение подписи, ключа и других параметров",
     "users:create": "Создать сотрудника",

package/dist/data/changelog.json

@@ -1,4 +1,15 @@
 [
+    {
+        "version": "2026.5.4",
+        "date": "20 мая 2026",
+        "changes": [
+            {
+                "type": "+",
+                "command": "threads list",
+                "description": "Новая команда — список доступных тредов с фильтрами `--last-message-at-after` / `--last-message-at-before` и курсорной пагинацией"
+            }
+        ]
+    },
     {
         "version": "2026.5.2",
         "date": "17 мая 2026",