@iola_adm/iola-cli 0.2.43 → 0.2.45

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.2.43",
+  "version": "0.2.45",
   "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",

package/src/cli.js

@@ -16668,6 +16668,7 @@ async function onboard(args = []) {
   if (components.includes("workspace")) await handleWorkspace(["init"]);
   if (components.includes("policy")) await handlePolicy(["use", "analyst"]);
   if (components.includes("archive")) await ensureArchiveTool({ install: true });
+  if (components.includes("city-data")) await checkHealth([]);
   if (components.includes("iola")) {
     await setupIolaLocal(["--yes"]);
   }
@@ -16734,8 +16735,12 @@ async function chooseOnboardComponents(status = null) {
   console.log("");
   console.log("Выберите компоненты через запятую:");
   console.log("0. выход в CLI [без настройки] - пропустить мастер");
-  for (const item of onboardComponentRows(componentStatus)) {
-    console.log(`${item.number}. ${item.title} [${item.status}] - ${item.hint}`);
+  for (const group of onboardComponentGroups(componentStatus)) {
+    console.log("");
+    console.log(group.title);
+    for (const item of group.rows) {
+      console.log(`${item.number}. ${item.title} [${item.status}] - ${item.hint}`);
+    }
   }
   console.log("");
   const rl = readline.createInterface({ input, output });
@@ -16747,19 +16752,19 @@ async function chooseOnboardComponents(status = null) {
     const map = {
       1: "workspace",
       2: "policy",
-      3: "iola",
-      4: "gigachat",
-      5: "openai",
-      6: "openrouter",
-      7: "codex",
-      8: "codex-mcp",
-      9: "archive",
-      10: "index",
-      11: "browser",
-      12: "ollama",
-      13: "yandex",
-      14: "yandex-cloud",
-      15: "yandex-cloud",
+      3: "archive",
+      4: "index",
+      5: "browser",
+      6: "city-data",
+      7: "codex-mcp",
+      8: "iola",
+      9: "ollama",
+      10: "gigachat",
+      11: "yandex",
+      12: "yandex-cloud",
+      13: "openai",
+      14: "openrouter",
+      15: "codex",
     };
     return [...selected].map((item) => map[item] || item).filter(Boolean);
   } finally {
@@ -16772,7 +16777,7 @@ function isOnboardExitAnswer(answer) {
 }
 
 async function getOnboardComponentStatus() {
-  const [config, readiness, browser, archive, codexVersion, ollamaVersion, yandexGeocoderKey, secrets] = await Promise.all([
+  const [config, readiness, browser, archive, codexVersion, ollamaVersion, yandexGeocoderKey, secrets, cityDataHealth] = await Promise.all([
     loadConfig(),
     getAiReadiness(),
     getBrowserStatus(),
@@ -16781,6 +16786,7 @@ async function getOnboardComponentStatus() {
     getOllamaVersion(),
     getYandexGeocoderKey(),
     loadSecrets(),
+    getMcpBaseUrl().then((baseUrl) => probeEndpoint(`${baseUrl}/mcp-health`)),
   ]);
   const workspaceReady = existsSync(PROJECT_CONTEXT_FILE) || existsSync(PROJECT_CONTEXT_DIR_FILE) || existsSync(PROJECT_IOLA_DIR);
   const policyReady = (config.toolsets?.enabled || []).includes("analyst");
@@ -16795,6 +16801,7 @@ async function getOnboardComponentStatus() {
     openrouter: Boolean(readiness.openrouter),
     codex: Boolean(codexVersion !== "не найден" && readiness.codex),
     "codex-mcp": false,
+    "city-data": cityDataHealth === "доступен",
     archive: Boolean(archive),
     index: false,
     browser: browser.installed === "yes",
@@ -16802,37 +16809,75 @@ async function getOnboardComponentStatus() {
   };
 }
 
-function onboardComponentRows(status) {
-  const rows = [
-    ["1", "workspace", "workspace и контекст", "рабочая папка, IOLA.md и .iola/context.md"],
-    ["2", "policy", "policy analyst", "разрешения и профиль аналитика"],
-    ["3", "iola", "IOLA локальная модель", "локальная модель найдена"],
-    ["4", "gigachat", "GigaChat API", "authorization key сохранен или есть в env"],
-    ["5", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
-    ["6", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
-    ["7", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
-    ["8", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
-    ["9", "archive", "7-Zip / архивы", "архиватор найден"],
-    ["10", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
-    ["11", "browser", "Browser runtime", "Playwright/Chromium установлен"],
-    ["12", "ollama", "Ollama", "опциональный локальный runtime"],
-    ["13", "yandex", "Yandex Connector", "единый вход и категории сервисов Яндекса"],
-    ["14", "yandex-cloud", "Yandex Cloud Connector", "геокодинг и YandexGPT"],
+function onboardComponentGroups(status) {
+  const groups = [
+    {
+      title: "Базовая настройка",
+      rows: [
+        ["1", "workspace", "Рабочая папка и контекст", "IOLA.md и .iola/context.md"],
+        ["2", "policy", "Разрешения и безопасный режим", "профиль аналитика"],
+        ["3", "archive", "7-Zip / архивы", "архиватор найден"],
+        ["4", "index", "Индекс локальных документов", "выбранная папка"],
+        ["5", "browser", "Браузерный модуль", "Playwright/Chromium"],
+      ],
+    },
+    {
+      title: "Городские сервисы",
+      rows: [
+        ["6", "city-data", "Открытые данные Йошкар-Олы", "API/MCP gateway доступен"],
+        ["7", "codex-mcp", "Подключить городские данные к Codex", "MCP для Codex"],
+      ],
+    },
+    {
+      title: "Локальный AI",
+      rows: [
+        ["8", "iola", "IOLA локальная модель", "локальная модель найдена"],
+        ["9", "ollama", "Ollama", "опциональный локальный runtime"],
+      ],
+    },
+    {
+      title: "Российские AI и сервисы",
+      rows: [
+        ["10", "gigachat", "GigaChat API", "authorization key сохранен или есть в env"],
+        ["11", "yandex", "Yandex Connector", "Диск, Почта, Календарь, Контакты"],
+        ["12", "yandex-cloud", "Yandex Cloud Connector", "геокодинг и YandexGPT"],
+      ],
+    },
+    {
+      title: "Зарубежные AI",
+      rows: [
+        ["13", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
+        ["14", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
+      ],
+    },
+    {
+      title: "Codex",
+      rows: [
+        ["15", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
+      ],
+    },
   ];
-  return rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" }));
+  return groups.map((group) => ({
+    ...group,
+    rows: group.rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" })),
+  }));
+}
+
+function onboardComponentRows(status) {
+  return onboardComponentGroups(status).flatMap((group) => group.rows);
 }
 
 function defaultOnboardSelection(status) {
   const defaults = [];
   if (!status.workspace) defaults.push("1");
   if (!status.policy) defaults.push("2");
-  if (!status.iola) defaults.push("3");
-  if (!status.archive) defaults.push("9");
+  if (!status.archive) defaults.push("3");
+  if (!status.iola) defaults.push("8");
   return defaults.length ? defaults : ["1", "2"];
 }
 
 function defaultOnboardComponents(status) {
-  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "gigachat", 5: "openai", 6: "openrouter", 7: "codex", 8: "codex-mcp", 9: "archive", 10: "index", 11: "browser", 12: "ollama", 13: "yandex", 14: "yandex-cloud", 15: "yandex-cloud" };
+  const map = { 1: "workspace", 2: "policy", 3: "archive", 4: "index", 5: "browser", 6: "city-data", 7: "codex-mcp", 8: "iola", 9: "ollama", 10: "gigachat", 11: "yandex", 12: "yandex-cloud", 13: "openai", 14: "openrouter", 15: "codex" };
   return defaultOnboardSelection(status).map((item) => map[item]).filter(Boolean);
 }
 

package/wiki/Yandex-Cloud-Connector.md

@@ -18,7 +18,7 @@ iola master
 В мастере выберите:
 
 ```text
-14. Yandex Cloud Connector - геокодинг и YandexGPT
+12. Yandex Cloud Connector - геокодинг и YandexGPT
 ```
 
 CLI не просто открывает консоль. Он печатает короткую инструкцию, что делать дальше, и только потом просит вставить ключи.

package/wiki//320/234/320/260/321/201/321/202/320/265/321/200-/320/275/320/260/321/201/321/202/321/200/320/276/320/271/320/272/320/270.md

@@ -12,75 +12,106 @@ iola master
 
 ## Компоненты
 
-### 1. workspace и контекст
+```text
+0. выход в CLI [без настройки] - пропустить мастер
+
+Базовая настройка
+1. Рабочая папка и контекст
+2. Разрешения и безопасный режим
+3. 7-Zip / архивы
+4. Индекс локальных документов
+5. Браузерный модуль
+
+Городские сервисы
+6. Открытые данные Йошкар-Олы
+7. Подключить городские данные к Codex
+
+Локальный AI
+8. IOLA локальная модель
+9. Ollama
+
+Российские AI и сервисы
+10. GigaChat API
+11. Yandex Connector
+12. Yandex Cloud Connector
+
+Зарубежные AI
+13. OpenAI API
+14. OpenRouter API
+
+Codex
+15. Codex CLI
+```
+
+## Базовая настройка
+
+### 1. Рабочая папка и контекст
 
 Создает рабочую среду текущей папки: `.iola/`, `IOLA.md` и `.iola/context.md`.
 
 Нужно, если агент будет работать с локальными файлами, документами, задачами, артефактами и контекстом проекта.
 
-### 2. policy analyst
+### 2. Разрешения и безопасный режим
 
 Включает профиль разрешений для аналитической работы: открытые данные, отчеты, безопасные локальные операции.
 
-### 3. IOLA локальная модель
+### 3. 7-Zip / архивы
 
-Проверяет штатную локальную модель IOLA и готовит ее к работе через доступный runtime.
-
-Если модель уже скачана и доступна, пункт показывается как `готово`.
+Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
 
-После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
+Нужен для чтения, распаковки, сборки и индексирования архивов.
 
-### 4. GigaChat API
+### 4. Индекс локальных документов
 
-Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.
+Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
 
-Российский провайдер вызывается напрямую, без gateway/proxy.
+```bash
+iola index folder ./docs
+```
 
-### 5. OpenAI API
+### 5. Браузерный модуль
 
-Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
+Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
 
-После сохранения ключа мастер предлагает выбрать модель из доступного списка.
+## Городские сервисы
 
-### 6. OpenRouter API
+### 6. Открытые данные Йошкар-Олы
 
-Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
+Проверяет доступность городского API/MCP-шлюза `apiiola.yasg.ru`.
 
-После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.
+Этот пункт ничего не устанавливает локально. Он нужен, чтобы пользователь явно видел: CLI подключен к городским слоям открытых данных и может проверять школы, детские сады и другие подключенные городские сервисы через проверяемый gateway.
 
-### 7. Codex CLI
+### 7. Подключить городские данные к Codex
 
-Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
+Добавляет MCP-сервер открытых данных Йошкар-Олы во внешний Codex CLI. Этот пункт нужен только тем, кто хочет, чтобы Codex CLI тоже видел городские данные как MCP-инструменты.
 
-### 8. MCP для Codex
+Для обычной работы `iola-cli` с городскими слоями этот пункт не обязателен: сам CLI уже ходит к городскому API/MCP-шлюзу напрямую.
 
-Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
+## Локальный AI
 
-### 9. 7-Zip / архивы
+### 8. IOLA локальная модель
 
-Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
+Проверяет штатную локальную модель IOLA и готовит ее к работе через доступный runtime.
 
-Нужен для чтения, распаковки, сборки и индексирования архивов.
+Если модель уже скачана и доступна, пункт показывается как `готово`.
 
-### 10. Индекс локальных документов
+После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
 
-Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
+### 9. Ollama
 
-```bash
-iola index folder ./docs
-```
+Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.
 
-### 11. Browser runtime
+Если runtime уже установлен, пункт показывается как `готово`.
 
-Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
+## Российские AI и сервисы
 
-### 12. Ollama
+### 10. GigaChat API
 
-Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.
+Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.
 
-Если runtime уже установлен, пункт показывается как `готово`.
+Российский провайдер вызывается напрямую, без gateway/proxy.
 
-### 13. Yandex Connector
+### 11. Yandex Connector
 
 Настраивает единый коннектор пользовательских сервисов Яндекса.
 
@@ -95,7 +126,7 @@ iola index folder ./docs
 
 Инструкция: [Yandex Connector](Yandex-Connector).
 
-### 14. Yandex Cloud Connector
+### 12. Yandex Cloud Connector
 
 Настраивает Yandex Cloud Connector: геокодер и, при необходимости, YandexGPT.
 
@@ -107,6 +138,26 @@ iola index folder ./docs
 
 Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).
 
+## Зарубежные AI
+
+### 13. OpenAI API
+
+Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
+
+После сохранения ключа мастер предлагает выбрать модель из доступного списка.
+
+### 14. OpenRouter API
+
+Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
+
+После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.
+
+## Codex
+
+### 15. Codex CLI
+
+Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
+
 ## Повторный запуск
 
 Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.