npm - cliskill - Versions diffs - 1.1.2 → 1.1.3 - Mend

cliskill 1.1.2 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +225 -485
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -1,239 +1,144 @@
 <div align="center">
-# 🚀 cliskill
+# cliskill
-### Universal Terminal AI CLI
+**Universal Terminal AI CLI**
-**Независимый AI-ассистент для терминала с поддержкой любых LLM провайдеров**
+Свободный AI-ассистент для терминала с поддержкой любых LLM провайдеров.
-[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
-[![Version](https://img.shields.io/badge/version-1.0.0-orange)]()
-[![Node](https://img.shields.io/badge/node-%3E%3D20.0.0-green)]()
-[Бесплатный](#) · [Без подписок](#) · [Без vendor lock-in](#) · [Универсальный](#)
+[![npm](https://img.shields.io/npm/v/cliskill?color=blue&label=npm)](https://www.npmjs.com/package/cliskill)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%E2%89%A520.0.0-green)]()
 </div>
 ---
-## 📑 Содержание
-- [О проекте](#-о-проекте)
-- [Возможности](#-возможности)
-- [Быстрый старт](#-быстрый-старт)
-- [Использование](#-использование)
-- [Конфигурация](#-конфигурация)
-- [Инструменты](#-инструменты)
-- [MCP серверы](#-mcp-серверы)
-- [Агентская система](#-агентская-система)
-- [Архитектура](#-архитектура)
-- [API провайдеры](#-api-провайдеры)
-- [Разработка](#-разработка)
-- [Технологии](#-технологии)
-- [Лицензия](#-лицензия)
----
-## 🧠 О проекте
-**cliskill** — это универсальный AI-ассистент для терминала, который работает с **любым** LLM провайдером через стандартный `/chat/completions` API. Никакой привязки к конкретному вендору: используйте локальные модели, облачные API или собственные серверы.
-### Ключевые принципы
-| Принцип | Описание |
-|---------|----------|
-| 🆓 **Бесплатный** | Никаких подписок и ограничений по функциям |
-| 🔓 **Открытый** | Полный исходный код, MIT лицензия |
-| 🔌 **Универсальный** | Любой `/chat/completions` совместимый API |
-| 🚫 **Без vendor lock-in** | Легко переключайтесь между провайдерами |
-| 🤖 **Агентский** | 15 инструментов, мульти-агентная координация |
-| 🛡️ **Безопасный** | Настраиваемые уровни доверия и разрешения |
----
-## ✨ Возможности
-### 🔌 Провайдеры и модели
-- **Универсальная система провайдеров** — подключение любого `/chat/completions` API
-- **Алиасы моделей** — предустановленные алиасы: `smart`, `fast`, `balanced`, `reasoning`, `code`
-- **1M токенов контекста** — по умолчанию, настраиваемый лимит
-- **Автоматический fallback** — переключение на резервные модели при ошибках
-- **Rate Limit Handler** — корректная обработка лимитов без upsell
-### 🏗️ Инфраструктура
-| Система | Описание |
-|---------|----------|
-| 🎨 **Theme System** | 6 тем оформления, включая daltonized для дальтоников |
-| ⏰ **Cron Scheduler** | Отложенные и повторяющиеся задачи по расписанию |
-| ⌨️ **Keybinding System** | 10 контекстов, 50+ хоткеев, полностью настраиваемые |
-| 🩺 **Doctor Diagnostic** | Автоматическая диагностика окружения |
-| 🪝 **Hooks System** | Pre/post hooks для кастомизации поведения |
-| 📡 **MCP Client** | Model Context Protocol для расширения возможностей |
-| 📚 **Skills System** | Markdown-навыки для расширения функциональности |
-| 🧠 **Memory** | Basic + Enhanced память с TF-IDF индексацией |
-### 🛠️ Утилиты
-- 🎬 **Asciicast Recording** — запись сессий в формате asciicast v2
-- 🎨 **ANSI→SVG** — рендеринг терминального вывода в SVG
-- 🔄 **Conversation Recovery** — умное восстановление сессий с ремонтом
-- 🔗 **Deep Links** — протокол `cliskill://` для интеграции с ОС
-- 🧹 **Background Housekeeping** — автоматическая очистка и обслуживание
-- 🔀 **Tool Pool** — слияние и фильтрация наборов инструментов
-- 💰 **Cost Tracker** — отслеживание расходов на API
-- 📊 **Token Estimation** — оценка токенов перед отправкой
-- 📦 **Context Compaction** — автоматическое сжатие контекста
----
-## 📦 Быстрый старт
-### Установка из исходников
-```bash
-# Клонирование репозитория
-git clone https://github.com/nic11/cliskill.git
-cd cliskill
-# Установка зависимостей
-npm install
+## Что это
-# Сборка проекта
-npm run build
+cliskill — CLI-инструмент для работы с LLM прямо из терминала. Подключает любого провайдера через стандартный `/chat/completions` API, даёт 15 встроенных инструментов, мульти-агентную координацию и MCP-интеграцию. Без подписок, без vendor lock-in.
-# Глобальная установка (опционально)
-npm link
-```
-### Установка из npm
+## Быстрый старт
 ```bash
 npm install -g cliskill
+cliskill
 ```
-### Требования
+Первый запуск запустит интерактивный мастер настройки — выберете провайдера, API-ключ, модель.
-- **Node.js** >= 20.0.0
-- **npm** >= 9.0.0
+Требования: Node.js >= 20.0.0
-### Первый запуск
+### Из исходников
 ```bash
-# Интерактивный мастер настройки
-cliskill
-# Или с явным указанием провайдера
-cliskill --base-url https://api.example.com/v1 --api-key your-key
+git clone https://github.com/nic11/cliskill.git
+cd cliskill
+npm install && npm run build
+npm link
 ```
 ---
-## 🚀 Использование
+## Использование
-### Основные команды
+### CLI
 ```bash
-# 🎯 Интерактивный REPL
+# Интерактивный REPL
 cliskill
-# 💬 Одноразовый запрос
+# Одноразовый запрос
 cliskill --prompt "исправь тесты"
-# 🧠 Использовать алиас модели
+# Алиасы моделей
 cliskill --model smart
 cliskill --model fast
-cliskill --model balanced
+cliskill --model reasoning
-# 🤖 Auto mode
-cliskill --auto                    # safe-auto (по умолчанию)
+# Auto mode
+cliskill --auto                    # safe-auto
 cliskill --auto-mode full-auto     # полная автономия
-cliskill --auto-mode safe-auto     # безопасная автономия
-cliskill --auto-mode ask           # с подтверждением
-# ⚡ Fast mode
-cliskill --fast
-# 🔄 Восстановление сессий
-cliskill --resume                  # последняя сессия
-cliskill --resume abc12345         # конкретная сессия
-# 🎬 Запись сессии
-cliskill --record
-cliskill --record --record-output ./my-session.cast
+# Восстановление сессии
+cliskill --resume
+cliskill --resume abc12345
-# 🎨 Выбор темы
+# Тема оформления
 cliskill --theme dark
-cliskill --theme light
-cliskill --theme dark-daltonized
-cliskill --theme light-daltonized
-cliskill --theme dark-ansi
-cliskill --theme light-ansi
-cliskill --theme auto
-# 🖥️ React TUI (Ink)
-cliskill --tui
-# 🔗 Удалённый сервер
-cliskill --remote user@host
-# 📊 Вербоузный режим
-cliskill --verbose
-```
-### Подкоманды
+# React TUI
+cliskill --tui
-```bash
-# 🩺 Диагностика окружения
-cliskill doctor
-# 📋 Список сессий
-cliskill sessions
-# ⏰ Cron задачи
-cliskill cron list                              # список задач
-cliskill cron add "0 9 * * 1-5" "запустить тесты"  # добавить задачу
-cliskill cron add "@daily" "отчёт" --one-shot   # одноразовая задача
-cliskill cron remove <id>                       # удалить задачу
-cliskill cron run <id>                          # запустить вручную
-# 🔗 Deep Links
-cliskill register-protocol                      # зарегистрировать cliskill://
-cliskill unregister-protocol                    # отменить регистрацию
-cliskill open-uri "cliskill://prompt?text=hello" # обработать URI
+# Запись сессии
+cliskill --record
 ```
-### Все опции CLI
+### Опции
 | Опция | Описание |
 |-------|----------|
-| `-m, --model <model>` | Модель или алиас (smart, fast, balanced) |
+| `-m, --model <model>` | Модель или алиас |
 | `--base-url <url>` | URL API провайдера |
-| `--api-key <key>` | API ключ провайдера |
+| `--api-key <key>` | API ключ |
 | `-p, --prompt <text>` | Одноразовый запрос |
-| `--config <path>` | Путь к файлу конфигурации |
-| `--tui` | React TUI (Ink) вместо базового REPL |
+| `--tui` | React TUI вместо базового REPL |
 | `--verbose` | Подробное логирование |
 | `--auto` | Auto mode (safe-auto) |
-| `--auto-mode <level>` | Auto mode с уровнем (full-auto, safe-auto, ask) |
+| `--auto-mode <level>` | full-auto / safe-auto / ask |
 | `--fast` | Быстрый режим |
-| `--max-context <tokens>` | Максимальное число токенов контекста |
-| `--remote <host>` | Подключение к удалённому серверу (SSH) |
+| `--max-context <tokens>` | Лимит контекста |
 | `--theme <name>` | Цветовая тема |
-| `--record` | Запись сессии (asciicast v2) |
-| `--record-output <path>` | Путь к файлу записи |
 | `--resume [id]` | Восстановить сессию |
-| `-v, --version` | Версия |
-| `-h, --help` | Справка |
+| `--record` | Запись в asciicast v2 |
+| `--remote <host>` | SSH подключение |
+### Подкоманды
+```bash
+cliskill doctor                    # Диагностика окружения
+cliskill sessions                  # Список сессий
+cliskill cron list                 # Cron задачи
+cliskill cron add "0 9 * * 1-5" "запустить тесты"
+```
 ---
-## ⚙️ Конфигурация
+## Провайдеры
+Работает с любым API, совместимым с OpenAI `/chat/completions`, а также с Anthropic Messages API.
+| Провайдер | Base URL | Формат |
+|-----------|----------|--------|
+| OpenAI | `https://api.openai.com/v1` | `openai-compatible` |
+| Anthropic Claude | `https://api.anthropic.com` | `anthropic-compatible` |
+| GLM / Z.AI | `https://api.z.ai/api/coding/paas/v4` | `openai-compatible` |
+| DeepSeek | `https://api.deepseek.com/v1` | `openai-compatible` |
+| Ollama | `http://localhost:11434/v1` | `openai-compatible` |
+| LM Studio | `http://localhost:1234/v1` | `openai-compatible` |
+| Любой другой | `<your-endpoint>/v1` | `openai-compatible` |
+### Алиасы моделей
+| Алиас | Описание |
+|-------|----------|
+| `smart` | Максимальное качество |
+| `fast` | Быстрые ответы |
+| `balanced` | Баланс качества и скорости |
+| `reasoning` | Логические задачи |
+| `code` | Код-специфичные задачи |
+Настраиваются в `.cliskillrc.json` → `models.aliases`.
+### Fallback chain
+При ошибках автоматически переключается на резервные модели. Настраивается через `fallbackModels` в конфигурации провайдера.
-### Файл конфигурации
+---
+## Конфигурация
-Создайте `.cliskillrc.json` в домашней директории или в корне проекта:
+Файл `.cliskillrc.json` в домашней директории или в корне проекта:
 ```json
 {
@@ -249,27 +154,14 @@ cliskill open-uri "cliskill://prompt?text=hello" # обработать URI
     }
   ],
   "permissionMode": "ask",
-  "verbose": false,
   "maxContextTokens": 1000000,
-  "theme": {
-    "name": "dark"
-  },
-  "autoMode": {
-    "enabled": false,
-    "trustLevel": "safe-auto"
-  },
-  "fastMode": {
-    "enabled": false
-  },
+  "theme": { "name": "dark" },
+  "autoMode": { "enabled": false, "trustLevel": "safe-auto" },
   "models": {
     "aliases": [
       { "alias": "smart", "model": "gpt-4o" },
-      { "alias": "fast", "model": "gpt-4o-mini" },
-      { "alias": "balanced", "model": "gpt-4o" },
-      { "alias": "reasoning", "model": "o1" },
-      { "alias": "code", "model": "gpt-4o" }
-    ],
-    "maxContextTokens": 1000000
+      { "alias": "fast", "model": "gpt-4o-mini" }
+    ]
   }
 }
 ```
@@ -277,91 +169,61 @@ cliskill open-uri "cliskill://prompt?text=hello" # обработать URI
 ### Переменные окружения
 ```bash
-export CLISKILL_API_KEY="your-api-key"
-export CLISKILL_BASE_URL="https://api.example.com/v1"
+CLISKILL_API_KEY="your-api-key"
+CLISKILL_BASE_URL="https://api.example.com/v1"
+ANTHROPIC_API_KEY="your-anthropic-key"
+ANTHROPIC_BASE_URL="https://api.anthropic.com"
 ```
-### Форматы провайдеров
-| Формат | Описание |
-|--------|----------|
-| `openai-compatible` | Любой `/v1/chat/completions` endpoint |
-| `messages-compatible` | Messages API формат (compat adapter) |
-| `custom` | Кастомный адаптер (программная регистрация) |
 ### Режимы разрешений
-| Режим | Описание |
-|-------|----------|
-| `ask` | Подтверждение каждой операции (по умолчанию) |
-| `auto-accept` | Разрешить все операции без подтверждения |
+| Режим | Поведение |
+|-------|-----------|
+| `ask` | Подтверждение каждой операции |
+| `auto-accept` | Всё без подтверждения |
 | `plan` | Только операции чтения |
-### Навыки (Skills)
-Создавайте файлы навыков в директории `.cliskill/skills/`:
-```markdown
----
-name: my-skill
-description: Описание навыка
 ---
-# Инструкции для навыка
+## Инструменты
+15 встроенных инструментов:
+| Инструмент | Описание |
+|------------|----------|
+| **Bash** | Выполнение shell команд с инспекцией безопасности |
+| **File Read** | Чтение файлов с поддержкой изображений |
+| **File Write** | Создание и перезапись файлов |
+| **File Edit** | Точечное редактирование (search/replace) |
+| **Glob** | Поиск файлов по паттернам |
+| **Grep** | Поиск текста с regex |
+| **Web Search** | Веб-поиск |
+| **Web Fetch** | Загрузка и парсинг веб-страниц |
+| **Agent** | Порождение суб-агентов |
+| **LSP** | Language Server Protocol интеграция |
+| **Todo Write** | Управление списками задач |
+| **Computer Use** | Управление мышью и клавиатурой |
+| **Remote** | SSH команды на удалённых серверах |
+| **Worktree** | Git worktree для параллельной работы |
+| **Plan Mode** | Планирование с параллельными агентами |
+Дополнительно: **Tool Search** — поиск инструментов по имени и описанию, **Background Bash** — фоновые задачи, **Task List / Task Stop** — управление задачами.
-Текст инструкций в формате Markdown...
-```
----
+### Безопасность
-## 🔧 Инструменты
-cliskill включает 15 встроенных инструментов для полноценной работы:
-| # | Инструмент | Описание | Категория |
-|---|------------|----------|-----------|
-| 1 | 🖥️ **Bash** | Выполнение shell команд с инспекцией безопасности | Выполнение |
-| 2 | 📄 **File Read** | Чтение файлов с поддержкой изображений | Файлы |
-| 3 | ✏️ **File Write** | Создание и перезапись файлов | Файлы |
-| 4 | 📝 **File Edit** | Точечное редактирование файлов (search/replace) | Файлы |
-| 5 | 🔍 **Glob** | Поиск файлов по паттернам | Поиск |
-| 6 | 🔎 **Grep** | Поиск текста с поддержкой regex | Поиск |
-| 7 | 🌐 **Web Search** | Веб-поиск через поисковые системы | Веб |
-| 8 | 🌍 **Web Fetch** | Загрузка и парсинг веб-страниц | Веб |
-| 9 | 🤖 **Agent** | Порождение суб-агентов для подзадач | Агенты |
-| 10 | 📡 **LSP** | Интеграция с Language Server Protocol | IDE |
-| 11 | ✅ **Todo Write** | Управление списками задач | Планирование |
-| 12 | 🖱️ **Computer Use** | Управление мышью и клавиатурой | Автоматизация |
-| 13 | 🔗 **Remote** | Выполнение команд на удалённых серверах через SSH | Удалённый доступ |
-| 14 | 🌳 **Worktree** | Управление git worktree для параллельной работы | Git |
-| 15 | 📋 **Plan Mode** | Планирование с 3 параллельными агентами | Планирование |
-### Безопасность инструментов
-Инструменты классифицируются по уровню безопасности:
-- **readOnly** (Glob, Grep, File Read, LSP) — могут выполняться параллельно
-- **write** (File Write, File Edit, Bash) — выполняются эксклюзивно
+- **readOnly** (Glob, Grep, File Read, LSP) — параллельное выполнение
+- **write** (File Write, File Edit, Bash) — эксклюзивное выполнение
 - **network** (Web Search, Web Fetch) — контролируемые сетевые операции
+- Динамическая проверка `concurrencySafe` per-input
 ---
-## 🔌 MCP серверы
+## MCP (Model Context Protocol)
-**MCP (Model Context Protocol)** — открытый протокол для подключения внешних инструментов к AI-ассистентам. cliskill автоматически запускает MCP-серверы при старте и регистрирует их инструменты как доступные для модели.
-### Как это работает
-1. cliskill читает `mcpServers` из конфига
-2. Запускает каждый сервер как дочерний процесс (stdio transport)
-3. Получает список инструментов через `tools/list`
-4. Регистрирует их в ToolRegistry с префиксом `mcp_{serverName}_`
-5. Модель может вызывать MCP-инструменты наравне со встроенными
+Подключение внешних инструментов через открытый протокол MCP. Серверы запускаются как дочерние процессы (stdio transport), инструменты регистрируются с префиксом `mcp_{serverName}_`.
 ### Настройка
-Добавьте массив `mcpServers` в конфиг (`~/.cliskill/config.json` или `.cliskillrc.json`):
 ```json
 {
   "mcpServers": [
@@ -375,277 +237,155 @@ cliskill включает 15 встроенных инструментов дл
       "name": "github",
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-github"],
-      "env": {
-        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token"
-      },
+      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_token" },
       "transport": "stdio"
     }
   ]
 }
 ```
-### Поля конфигурации MCP-сервера
+### Поля
 | Поле | Тип | Обязательное | Описание |
 |------|-----|:---:|----------|
-| `name` | string | ✅ | Уникальное имя сервера |
-| `command` | string | ✅ | Команда запуска процесса |
-| `args` | string[] | — | Аргументы команды (по умолчанию `[]`) |
-| `env` | object | — | Переменные окружения для процесса |
-| `transport` | string | — | Транспорт: `"stdio"` (по умолчанию) |
-### Популярные MCP-серверы
-| Сервер | Пакет | Назначение |
-|--------|-------|------------|
-| Filesystem | `@modelcontextprotocol/server-filesystem` | Доступ к файловой системе |
-| GitHub | `@modelcontextprotocol/server-github` | Работа с GitHub API |
-| PostgreSQL | `@modelcontextprotocol/server-postgres` | Запросы к PostgreSQL |
-| Brave Search | `@modelcontextprotocol/server-brave-search` | Веб-поиск через Brave |
-| Memory | `@modelcontextprotocol/server-memory` | Память между сессиями |
-| Puppeteer | `@modelcontextprotocol/server-puppeteer` | Управление браузером |
+| `name` | string | да | Уникальное имя |
+| `command` | string | да | Команда запуска |
+| `args` | string[] | нет | Аргументы |
+| `env` | object | нет | Переменные окружения |
+| `transport` | string | нет | Транспорт (stdio по умолчанию) |
-### Безопасность
-- MCP-инструменты наследуют `riskLevel = 'safe'` — требуют разрешения в режиме `ask`
-- Серверы запускаются с переменными окружения из конфига (не из системы)
-- При ошибке подключения сервер пропускается, остальные продолжают работу
+### Популярные серверы
-## 🤖 Агентская система
+`@modelcontextprotocol/server-filesystem` — файловая система, `server-github` — GitHub API, `server-postgres` — PostgreSQL, `server-brave-search` — веб-поиск, `server-memory` — память между сессиями, `server-puppeteer` — управление браузером.
-### Auto Mode
+---
-3 уровня автономности для автоматического выполнения задач:
+## Агентская система
-| Уровень | Описание | Подтверждение |
-|---------|----------|---------------|
-| `full-auto` | Полная автономия | Все действия без подтверждения |
-| `safe-auto` | Безопасная автономия | Только потенциально опасные операции |
-| `ask` | Ручное управление | Каждое действие (по умолчанию) |
+### Agent Loop
-### Multi-Agent система
+Ядро — агентский цикл с streaming, параллельным tool calling, error recovery и автоматическим сжатием контекста.
-- **Fast Mode** — оптимизации скорости ответов
-- **Multi-Agent Plan Mode V2** — 3 параллельных агента для планирования
-- **Swarm Coordinator** — мульти-агентная координация сложных задач
-- **Task System** — фоновые задачи с отслеживанием статуса
+### Multi-Agent
-### Agent Loop
+- **Agent Tool** — порождение суб-агентов с `AsyncLocalStorage`-трекингом контекста
+- **Plan Mode** — 3 параллельных агента для планирования
+- **Swarm Coordinator** — мульти-агентная координация
+- **Task System** — фоновые задачи с EventEmitter, `createTask`/`startTask`, `executeAgentTask`/`executeShellTask`
-Ядро системы — агентский цикл с поддержкой:
+### Auto Mode
-- **Streaming** — потоковая обработка ответов LLM
-- **Tool calling** — параллельный вызов инструментов
-- **Error recovery** — 3-уровневая стратегия восстановления при `max_tokens`
-- **Context management** — автоматическое сжатие при переполнении контекста
+| Уровень | Поведение |
+|---------|-----------|
+| `full-auto` | Полная автономия |
+| `safe-auto` | Подтверждение только опасных операций |
+| `ask` | Подтверждение каждого действия |
 ---
-## 🏛️ Архитектура
+## Архитектура
 ```
 src/
-├── 📡 bootstrap/     — CLI entry point, парсинг аргументов
-├── ⚙️ config/        — Загрузка и валидация конфигурации
-├── 🔌 connect/       — Абстракция провайдеров (API адаптеры)
-├── 🧠 core/          — Agent Loop, QueryEngine (ядро системы)
-├── 🔧 tools/         — Система инструментов (15 инструментов)
-├── 🛠️ services/      — Сервисы (auto-mode, cron, doctor, и т.д.)
-├── 🛡️ safety/        — Разрешения, Command Inspector
-├── 🧠 memory/        — Memory Store (basic + TF-IDF)
-├── 🎨 ui/            — Theme, Keybindings, Ink TUI
-├── 🪝 hooks/         — Hooks system (pre/post)
-├── 📡 mcp/           — MCP Client (Model Context Protocol)
-├── 🐝 swarm/         — Мульти-агентная координация
-├── 📋 tasks/         — Фоновые задачи
-├── 🔗 remote/        — SSH сессии
-├── 🧩 extensions/    — Расширения и навыки
-├── 🏗️ infra/         — Инфраструктурные модули
-└── 🔀 utils/         — Общие утилиты
+├── bootstrap/     CLI entry point, парсинг аргументов
+├── config/        Загрузка и валидация конфигурации
+├── connect/       API адаптеры (OpenAI, Anthropic, GLM, Generic)
+├── core/          Agent Loop, QueryEngine
+├── tools/         Система инструментов (15 + MCP)
+├── services/      Streaming executor, context compaction, cost tracker
+├── safety/        Разрешения, Command Inspector
+├── memory/        Memory Store + TF-IDF + project scanner
+├── ui/            Theme, Keybindings, Ink TUI, Wizard
+├── hooks/         Pre/post hooks
+├── mcp/           MCP Client
+├── swarm/         Мульти-агентная координация
+├── tasks/         Фоновые задачи
+├── remote/        SSH сессии
+├── extensions/    Расширения и навыки
+├── infra/         AbortController hierarchy, agent context, errors
+└── utils/         Общие утилиты
 ```
-### Диаграмма взаимодействия
-```mermaid
-graph TB
-    CLI[CLI Entry] --> Config[Config Loader]
-    CLI --> REPL[REPL / TUI]
-    REPL --> Core[Agent Loop]
-    Core --> Provider[Provider Adapter]
-    Core --> Tools[Tool System]
-    Core --> Memory[Memory Store]
-    Core --> Safety[Safety Layer]
-    Tools --> Bash[Bash Tool]
-    Tools --> Files[File Tools]
-    Tools --> Web[Web Tools]
-    Tools --> Agent[Agent Tool]
-    Tools --> LSP[LSP Tool]
-    Tools --> Remote[Remote Tool]
-    Core --> Hooks[Hooks System]
-    Core --> MCP[MCP Client]
-    Core --> Swarm[Swarm Coordinator]
-    Swarm --> Tasks[Task System]
-```
-### Поток данных
-```mermaid
-sequenceDiagram
-    participant U as User
-    participant R as REPL/TUI
-    participant L as Agent Loop
-    participant P as Provider Adapter
-    participant T as Tool System
-    U->>R: Ввод запроса
-    R->>L: Передача сообщения
-    L->>P: API запрос (streaming)
-    P-->>L: Потоковый ответ
-    L->>T: Вызов инструментов
-    T-->>L: Результат выполнения
-    L->>P: Продолжение диалога
-    P-->>L: Финальный ответ
-    L-->>R: Событие результата
-    R-->>U: Отображение ответа
-```
----
-## 🌐 API провайдеры
-### Поддерживаемые форматы
-cliskill работает с **любым** API, совместимым с OpenAI `/chat/completions`:
+### Ключевые подсистемы
-| Провайдер | Base URL | Формат |
-|-----------|----------|--------|
-| OpenAI | `https://api.openai.com/v1` | `openai-compatible` |
-| GLM / Z.AI | `https://api.z.ai/api/coding/paas/v4` | `openai-compatible` |
-| DeepSeek | `https://api.deepseek.com/v1` | `openai-compatible` |
-| LocalAI | `http://localhost:8080/v1` | `openai-compatible` |
-| Ollama | `http://localhost:11434/v1` | `openai-compatible` |
-| LM Studio | `http://localhost:1234/v1` | `openai-compatible` |
-| Любой другой | `<your-endpoint>/v1` | `openai-compatible` |
-### Модель алиасов
-Предустановленные алиасы для быстрого переключения моделей:
-| Алиас | Описание | Модель по умолчанию |
-|-------|----------|---------------------|
-| `smart` | Максимальное качество | `gpt-4o` |
-| `fast` | Быстрые ответы | `gpt-4o-mini` |
-| `balanced` | Баланс качества/скорости | `gpt-4o` |
-| `reasoning` | Логические задачи | `o1` |
-| `code` | Код-специфичные задачи | `gpt-4o` |
-Алиасы настраиваются в `.cliskillrc.json` → `models.aliases`.
+| Подсистема | Что делает |
+|------------|------------|
+| **AbortController Hierarchy** | `WeakRef`-based child controllers, `setMaxListeners(50)`, auto-cleanup |
+| **Progress Events** | `pendingProgress` буфер, `onToolProgress()`, реалтайм прогресс в TUI |
+| **Context Compaction** | Multi-level с circuit breaker (3 failures), 4 уровня предупреждений |
+| **Error Recovery** | Synthetic error results для pending tool calls при abort |
+| **Model Fallback** | `resolveFallbackChain()`, `streamWithFallback()`, `completeWithFallback()` |
+| **Session Recovery** | JSONL логирование, `/resume` и `/sessions` команды |
+| **Cost Tracking** | Cache token tracking, per-model pricing (20+ моделей), budget warnings |
+| **Permission System** | Dynamic checking, auto-approve patterns (regex), permission caching |
+| **Batch Partitioning** | `partitionToolCalls()` — concurrent/exclusive batch'и |
 ---
-## 👨‍💻 Разработка
-### Команды
+## Разработка
 ```bash
-npm install          # Установить зависимости
-npm run build        # Сборка проекта (tsup)
-npm run dev          # Разработка с watch-режимом
-npm test             # Запустить тесты (Vitest)
-npm run test:watch   # Тесты в watch-режиме
-npm run typecheck    # Проверка типов TypeScript
-npm run lint         # Линтинг (= typecheck)
-npm run start        # Запуск собранного CLI
-```
-### Структура тестов
-Каждый модуль сопровождается тестами:
-```
-src/
-├── services/
-│   ├── cron/
-│   │   ├── parser.ts          # Парсер cron-выражений
-│   │   ├── parser.test.ts     # Тесты парсера
-│   │   ├── scheduler.ts       # Планировщик
-│   │   ├── scheduler.test.ts  # Тесты планировщика
-│   │   ├── task-store.ts      # Хранилище задач
-│   │   └── task-store.test.ts # Тесты хранилища
-│   ├── doctor.ts / .test.ts
-│   ├── asciicast.ts / .test.ts
-│   ├── housekeeping.ts / .test.ts
-│   └── tool-pool.ts / .test.ts
-├── ui/
-│   ├── theme.ts / .test.ts
-│   └── keybindings/
-│       ├── parser.ts / .test.ts
-│       ├── resolver.ts / .test.ts
-│       └── schema.ts / .test.ts
-├── tools/builtins/
-│   ├── worktree-tool.ts / .test.ts
-│   ├── todo-write-tool.ts / .test.ts
-│   ├── web-fetch-tool.ts / .test.ts
-│   └── web-search-tool.ts / .test.ts
-└── utils/
-    ├── ansi-render.ts / .test.ts
-    └── bash-parser.ts / .test.ts
+npm install          # Зависимости
+npm run build        # Сборка (tsup)
+npm run dev          # Watch-режим
+npm test             # Тесты (Vitest)
+npm run typecheck    # Проверка типов
 ```
-### Добавление нового инструмента
+### Добавить инструмент
-1. Создайте файл в `src/tools/builtins/your-tool.ts`
-2. Реализуйте интерфейс `Tool` из `src/tools/types.ts`
-3. Зарегистрируйте в `src/tools/builtins/index.ts`
-4. Добавьте тесты `your-tool.test.ts`
+1. Создать `src/tools/builtins/your-tool.ts`
+2. Реализовать интерфейс `Tool` из `src/tools/types.ts`
+3. Зарегистрировать в `src/tools/builtins/index.ts`
+4. Написать тесты
-### Добавление нового провайдера
+### Добавить провайдера
-1. Создайте адаптер в `src/connect/your-adapter.ts`
-2. Реализуйте интерфейс `ProviderAdapter` из `src/connect/types.ts`
-3. Зарегистрируйте в `src/connect/registry.ts`
+1. Создать адаптер в `src/connect/your-adapter.ts`
+2. Реализовать `ProviderAdapter`
+3. Зарегистрировать в `src/connect/registry.ts`
 ---
-## 🧪 Технологии
-### Основной стек
+## Технологии
-| Технология | Назначение |
-|------------|------------|
-| **Node.js** LTS | Среда выполнения |
-| **TypeScript** (strict) | Типобезопасность |
-| **ESM** | Модульная система |
+**Стек:** Node.js LTS, TypeScript (strict), ESM
-### Зависимости
+**Зависимости:** Commander.js, Zod, Chalk, Ink/React, Ora, ssh2
-| Библиотека | Назначение |
-|------------|------------|
-| [Commander.js](https://github.com/tj/commander.js) | Парсинг CLI аргументов |
-| [Zod](https://zod.dev) | Валидация схем данных |
-| [Chalk](https://github.com/chalk/chalk) | Цветной вывод в терминал |
-| [Ink](https://github.com/vadimdemedes/ink) / [React](https://react.dev) | Terminal UI |
-| [Ora](https://github.com/sindresorhus/ora) | Спиннеры загрузки |
-| [ssh2](https://github.com/mscdex/ssh2) | SSH подключения |
-### Dev-зависимости
-| Библиотека | Назначение |
-|------------|------------|
-| [tsup](https://tsup.egoist.dev) | Сборка (esbuild-based) |
-| [Vitest](https://vitest.dev) | Тестирование |
-| [TypeScript](https://www.typescriptlang.org) | Компилятор и проверка типов |
+**Сборка и тесты:** tsup (esbuild), Vitest, TypeScript
 ---
-## 📄 Лицензия
-Этот проект распространяется под лицензией **MIT**. Подробнее см. [LICENSE](LICENSE).
+## Changelog
+### v1.1.2
+- Anthropic Claude integration — Messages API с streaming, tool use, кастомный Base URL
+- MCP deep audit — 20+ багов исправлено, connection state machine, graceful shutdown, JSON Schema → Zod конвертация
+- DRY: общий SSE парсер и network error handling для всех адаптеров
+- Agent UI freeze fix — 3 критических бага с tool.promise, heartbeat timeout, progress events
+- Animated progress display — braille-спиннер, реалтайм прогресс от агентов и инструментов
+### v1.1.0
+- AbortController hierarchy с WeakRef и auto-cleanup
+- Progress events — per-tool progress в single/multi tool calls
+- Dynamic concurrency safety — per-input проверка
+- Batch partitioning — concurrent/exclusive batch'и
+- Multi-level context compaction с circuit breaker
+- Error recovery — synthetic results при abort
+- Agent context — AsyncLocalStorage tracking
+- Task system — фоновые задачи с EventEmitter
+- Model fallback chain
+- Session recovery — JSONL + `/resume` + `/sessions`
+- Tool aliases & search
+- Permission system — dynamic checking, auto-approve, caching
+- Memory system — project-level `.cliskill.md` scanning
+- Cost tracking — cache tokens, per-model pricing, budget warnings
 ---
-<div align="center">
-**cliskill** — свободный AI-ассистент для тех, кто ценит независимость.
+## Лицензия
-</div>
+[MIT](LICENSE)

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "cliskill",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "description": "Universal terminal AI assistant with multi-provider LLM support, 15 built-in tools, streaming execution, and agent orchestration",
   "type": "module",
   "main": "dist/index.js",