@iola_adm/iola-cli 0.1.15 → 0.1.19

package/README.md

@@ -96,6 +96,15 @@ iola resume 1 "продолжи"
 iola fork 1 "новый вопрос"
 iola features list
 iola features enable api-cache
+iola permissions list
+iola permissions deny export_data
+iola permissions allow export_data
+iola memory add "Отвечай кратко и указывай источник данных"
+iola memory show
+iola hooks events
+iola hooks add AfterSync "iola quality"
+iola agents list
+iola agents run quality-checker "проверь школы"
 iola mcp status
 iola mcp list
 iola mcp install codex
@@ -103,7 +112,13 @@ iola cache status
 iola cache warm
 iola cache clear
 iola sync
+iola sync status
+iola diff schools
 iola search "Петрова" --local
+iola search "Петрова" --local --fts
+iola card "школа 29"
+iola quality
+iola quality missing-phones
 iola data schools --where address=Петрова --save schools-petrova
 iola views
 iola view schools-petrova --format csv --output schools-petrova.csv
@@ -121,6 +136,8 @@ iola version --check
 iola ask "Найди школу 29"
 iola ask "Найди школу 29" --profile codex --events --output answer.txt
 iola ask "Найди школу 29" --schema json --no-history
+iola ask "Найди школу 29" --bare --quiet
+iola ask "выгрузи школы на Петрова в csv" --profile local --tools --reasoning verify
 iola data schools --format csv --output schools.csv
 iola data schools --limit 10
 iola data kindergartens --search "29"
@@ -172,6 +189,11 @@ iola agent
 /sessions
 /resume 1
 /features list
+/permissions
+/tools
+/memory show
+/hooks list
+/agents list
 /mcp status
 /config get
 /layers
@@ -381,7 +403,10 @@ iola data schools --cache
 
 ```bash
 iola sync
+iola sync status
+iola diff
 iola search "Петрова" --local
+iola search "школа Петрова" --local --fts
 iola data schools --local --search "лицей"
 ```
 
@@ -409,6 +434,111 @@ iola petrova
 iola run "выгрузи школы на Петрова в csv"
 ```
 
+## Локальный tool-agent для слабых моделей
+
+Для локального профиля Ollama доступен режим `--tools`. Он сделан специально
+для маленьких моделей, которые хуже отвечают свободным текстом, но могут быть
+полезны как планировщик действий.
+
+В этом режиме CLI не доверяет модели напрямую. Модель предлагает JSON-план,
+CLI валидирует список разрешенных tools и сам выполняет действия через
+проверенные локальные функции:
+
+- `search_local`
+- `get_card`
+- `export_data`
+- `run_report`
+- `save_view`
+
+Пример:
+
+```bash
+iola ask "выгрузи школы на Петрова в csv" --profile local --tools
+iola ask "найди детсады без телефона" --profile local --tools --reasoning verify
+```
+
+Режимы:
+
+```bash
+--reasoning fast    # один план
+--reasoning verify  # план с валидацией результата
+--reasoning vote    # несколько вариантов, выбирается валидный
+```
+
+OpenAI, OpenRouter и Codex работают как раньше. `--tools` применяется только
+к локальному Ollama-профилю, чтобы не менять поведение внешних провайдеров.
+
+Карточки, качество данных и изменения:
+
+```bash
+iola card schools 1215067180
+iola card "школа 29"
+iola quality
+iola quality schools
+iola quality missing-phones
+iola quality invalid-emails
+iola quality duplicate-inn
+iola sync status
+iola diff
+iola diff schools
+```
+
+## Permissions, memory, hooks и agents
+
+Permissions ограничивают, что может делать локальный tool-agent:
+
+```bash
+iola permissions list
+iola permissions deny export_data
+iola permissions allow export_data
+```
+
+Memory хранит пользовательские предпочтения в локальной SQLite-БД и добавляет их
+в AI-контекст, кроме режима `--bare`:
+
+```bash
+iola memory add "Если найден конкретный объект, показывай ИНН"
+iola memory show
+iola memory export
+```
+
+Hooks запускают локальные команды на события CLI:
+
+```bash
+iola hooks events
+iola hooks add AfterSync "iola quality"
+iola hooks list
+```
+
+Поддерживаемые события: `SessionStart`, `BeforeTool`, `AfterTool`,
+`AfterSync`, `BeforeExport`, `SessionEnd`.
+
+Agents - готовые режимы работы поверх AI-профилей и локальных инструментов:
+
+```bash
+iola agents list
+iola agents run quality-checker "проверь школы"
+iola agents run exporter "выгрузи школы на Петрова в csv"
+```
+
+Для скриптов доступны минимальные режимы:
+
+```bash
+iola ask "Найди школу 29" --bare
+iola ask "Найди школу 29" --quiet
+iola ask "Найди школу 29" --schema json --fail-on-empty
+iola --debug --debug-file iola-debug.log doctor
+```
+
+## Wiki
+
+Подробные пользовательские инструкции ведутся в GitHub Wiki. Исходники страниц
+лежат в папке `wiki/`, чтобы их можно было редактировать и коммитить как обычные
+Markdown-файлы.
+
+Рекомендуемая структура: `Home`, `Установка`, `Первый-запуск`, `AI-профили`,
+`Локальный-инструментальный-агент`, `Команды`, `Решение-проблем`.
+
 ## Переменные окружения
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.1.15",
+  "version": "0.1.19",
   "description": "CLI и AI-агент для работы с открытыми данными городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",
@@ -23,6 +23,7 @@
   "files": [
     "bin",
     "src",
+    "wiki",
     "docs/assets/readme-header.png",
     "README.md",
     "LICENSE"