@iola_adm/iola-cli 0.1.28 → 0.1.30

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.
package/wiki/Home.md CHANGED
@@ -31,7 +31,9 @@ iola ask "найди школу 29"
31
31
  - [Skills и toolsets](Skills-и-toolsets)
32
32
  - [Локальные файлы](Локальные-файлы)
33
33
  - [Рабочая среда агента](Рабочая-среда-агента)
34
+ - [Платформа агента](Платформа-агента)
34
35
  - [Расширения и локальные данные](Расширения-и-локальные-данные)
36
+ - [Архивы и мастер настройки](Архивы-и-мастер-настройки)
35
37
  - [Daemon, RPC и cron](Daemon-RPC-и-cron)
36
38
  - [Контекст и память](Контекст-и-память)
37
39
  - [Команды](Команды)
@@ -0,0 +1,42 @@
1
+ # Архивы и мастер настройки
2
+
3
+ `iola-cli` использует 7-Zip как штатный архиватор. Если 7-Zip не найден, `iola archive doctor` и `iola onboard` устанавливают его автоматически.
4
+
5
+ Поддерживаемые форматы зависят от 7-Zip:
6
+
7
+ - `.zip`
8
+ - `.7z`
9
+ - `.rar`
10
+ - `.tar`
11
+ - `.gz`
12
+ - `.tgz`
13
+ - `.bz2`
14
+ - `.xz`
15
+ - другие форматы, которые поддерживает установленный 7-Zip
16
+
17
+ Команды:
18
+
19
+ ```bash
20
+ iola archive doctor
21
+ iola archive list docs.zip
22
+ iola archive test docs.zip
23
+ iola archive extract docs.zip --output ./out
24
+ iola archive create docs.zip ./docs
25
+ iola archive index docs.zip
26
+ ```
27
+
28
+ Индекс архива:
29
+
30
+ ```bash
31
+ iola index archive docs.zip
32
+ iola index search "контракт"
33
+ ```
34
+
35
+ Мастер настройки:
36
+
37
+ ```bash
38
+ iola onboard
39
+ ```
40
+
41
+ Мастер проверяет Node/npm, SQLite, API, 7-Zip и предлагает подключить workspace, policy, Ollama, OpenAI, OpenRouter, Codex CLI, MCP и индекс локальных документов.
42
+
@@ -35,6 +35,7 @@ iola quality
35
35
  iola history search "Петрова"
36
36
  iola sessions search "Петрова"
37
37
  iola sessions compact 1
38
+ iola sessions replay 1
38
39
  ```
39
40
 
40
41
  AI:
@@ -45,7 +46,10 @@ iola ask "найди школу 29" --schema json
45
46
  iola ask "найди школу 29" --bare --quiet
46
47
  iola agents list
47
48
  iola agents run quality-checker "проверь школы"
49
+ iola subagents list
50
+ iola subagents run data-analyst "найди школы"
48
51
  iola skills list
52
+ iola skills bundles
49
53
  iola tools toolsets
50
54
  iola files status
51
55
  iola files mode read-only
@@ -55,15 +59,26 @@ iola policy use analyst
55
59
  iola tasks list
56
60
  iola artifacts list
57
61
  iola snapshot list
62
+ iola sandbox fork
58
63
  iola trace last
64
+ iola trajectory last
65
+ iola usage summary
66
+ iola budget status
59
67
  iola export education-contacts --format xlsx --output contacts.xlsx
60
68
  iola changes list
69
+ iola archive doctor
70
+ iola archive list docs.zip
71
+ iola archive extract docs.zip --output ./out
72
+ iola index archive docs.zip
61
73
  iola import file data.csv --dataset custom
62
74
  iola index folder ./docs
63
75
  iola reports list
64
76
  iola plugins list
65
77
  iola mcp serve
78
+ iola mcp serve --stdio
66
79
  iola memory suggest
80
+ iola memory curate
81
+ iola review config
67
82
  ```
68
83
 
69
84
  Контекст, расписания и daemon:
@@ -71,6 +86,8 @@ iola memory suggest
71
86
  ```bash
72
87
  iola context init
73
88
  iola context list
89
+ iola settings list
90
+ iola settings validate
74
91
  iola cron add "каждый день 09:00 -- quality"
75
92
  iola cron tick
76
93
  iola daemon status
@@ -0,0 +1,104 @@
1
+ # Платформа агента
2
+
3
+ `iola-cli` можно использовать не только как набор команд, но и как локальную платформу агента для работы с открытыми данными городского округа "Город Йошкар-Ола".
4
+
5
+ ## MCP server
6
+
7
+ Локальный MCP server поддерживает `stdio` и HTTP:
8
+
9
+ ```bash
10
+ iola mcp serve --stdio
11
+ iola mcp serve
12
+ ```
13
+
14
+ Доступные MCP-разделы:
15
+
16
+ - `tools/list`, `tools/call`: `status`, `search`, `card`, `quality`, `sync`, `files.tree`, `files.read`, `files.search`, `index.search`, `report`;
17
+ - `resources/list`, `resources/read`: `iola://status`, `iola://sync`, `iola://settings`, `iola://skills`, `iola://memory`, `iola://artifacts`;
18
+ - `prompts/list`, `prompts/get`: `data-question`, `document-review`, `report-build`.
19
+
20
+ ## Настройки слоями
21
+
22
+ Настройки собираются из нескольких слоев:
23
+
24
+ 1. встроенные значения;
25
+ 2. пользовательский файл `~/.iola/config.json`;
26
+ 3. проектный файл `.iola/config.json`;
27
+ 4. локальный файл `.iola/local.json`;
28
+ 5. переменные окружения для runtime.
29
+
30
+ Команды:
31
+
32
+ ```bash
33
+ iola settings list
34
+ iola settings get ai.activeProfile
35
+ iola settings validate
36
+ iola settings init
37
+ ```
38
+
39
+ ## Subagents
40
+
41
+ Subagents позволяют запускать разные рабочие роли поверх тех же данных и AI-профилей:
42
+
43
+ ```bash
44
+ iola subagents list
45
+ iola subagents run data-analyst "найди школы на Петрова"
46
+ iola subagents parallel data-analyst,reviewer "проверь результат"
47
+ iola subagents add culture --profile local --tools --prompt "Работай со слоями культуры Йошкар-Олы."
48
+ ```
49
+
50
+ ## Usage и budget
51
+
52
+ CLI пишет примерный учет запросов, символов, токенов и стоимости:
53
+
54
+ ```bash
55
+ iola usage summary
56
+ iola usage models
57
+ iola usage sessions
58
+ iola budget set daily 5
59
+ iola budget status
60
+ ```
61
+
62
+ Для локальной Ollama стоимость считается `0`, для внешних API используется грубая оценка, чтобы видеть порядок расходов.
63
+
64
+ ## Sandbox и trajectory
65
+
66
+ Sandbox делает копию workspace для рискованных действий:
67
+
68
+ ```bash
69
+ iola sandbox fork
70
+ iola sandbox run "npm test"
71
+ iola sandbox diff PATH
72
+ ```
73
+
74
+ Trajectory export нужен для разбора действий агента:
75
+
76
+ ```bash
77
+ iola trajectory last
78
+ iola trajectory export --format jsonl --output run.jsonl
79
+ ```
80
+
81
+ ## Hooks
82
+
83
+ Hooks можно запускать до и после tools, а также при ошибках:
84
+
85
+ ```bash
86
+ iola hooks events
87
+ iola hooks add PreToolUse "iola trace last 5"
88
+ iola hooks add files_search:"iola memory add Поиск по файлам использовался"
89
+ iola hooks audit
90
+ ```
91
+
92
+ События: `SessionStart`, `BeforeTool`, `AfterTool`, `PreToolUse`, `PostToolUse`, `OnError`, `AfterSync`, `BeforeExport`, `SessionEnd`.
93
+
94
+ ## Review
95
+
96
+ Команды review дают быстрые проверки:
97
+
98
+ ```bash
99
+ iola review config
100
+ iola review data
101
+ iola review docs ./docs
102
+ iola review report report.docx
103
+ ```
104
+