@iola_adm/iola-cli 0.2.37 → 0.2.39

package/package.json

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

package/src/cli.js

@@ -3575,6 +3575,7 @@ async function handleYandexCloudConnector(args = []) {
   }
 
   if (action === "open") {
+    printYandexCloudSetupGuide({ includeYandexGpt: true });
     await openUrl("https://console.yandex.cloud/");
     return;
   }
@@ -3585,9 +3586,13 @@ async function handleYandexCloudConnector(args = []) {
 async function setupYandexCloudConnector(options = {}) {
   console.log("Yandex Cloud Connector: геокодинг и YandexGPT.");
   console.log("Геокодер будет включен по умолчанию. YandexGPT можно выбрать в /model после сохранения ключей.");
+  printYandexCloudSetupGuide({ includeYandexGpt: true });
   if (process.stdin.isTTY) {
     const openConsole = await askYesNo("Открыть Yandex Cloud Console для получения ключей? [Y/n] ", true);
-    if (openConsole) await openUrl("https://console.yandex.cloud/");
+    if (openConsole) {
+      console.log("Открыл Yandex Cloud Console. Вернитесь сюда после создания ключей и вставьте их в CLI.");
+      await openUrl("https://console.yandex.cloud/");
+    }
   }
 
   const secrets = await loadSecrets();
@@ -3601,6 +3606,8 @@ async function setupYandexCloudConnector(options = {}) {
     return;
   }
 
+  console.log("");
+  console.log("Вставьте ключ API Геокодера. Если ключ еще создается, оставьте мастер открытым, получите ключ в браузере и вернитесь сюда.");
   const geocoderKey = (await askText(`YANDEX_GEOCODER_API_KEY${currentGeocoder ? " [уже сохранен, Enter - оставить]" : ""}: `)).trim() || currentGeocoder;
   if (!geocoderKey) throw new Error("Для Cloud Connector нужен хотя бы Geocoder API key.");
 
@@ -3619,6 +3626,22 @@ async function setupYandexCloudConnector(options = {}) {
   await printYandexCloudConnectorStatus({ check: true });
 }
 
+function printYandexCloudSetupGuide(options = {}) {
+  console.log("");
+  console.log("Что делать в открывшейся консоли Яндекса:");
+  console.log("1. Войдите в свой Яндекс-аккаунт.");
+  console.log("2. Если Яндекс попросит создать облако или каталог, создайте их. Названия можно оставить простыми: iola-cli и default.");
+  console.log("3. Для геокодера откройте Кабинет разработчика: https://developer.tech.yandex.ru/services/2");
+  console.log("4. Выберите API Геокодера, создайте API key и скопируйте значение ключа.");
+  console.log("5. Вернитесь в это окно CLI и вставьте ключ в поле YANDEX_GEOCODER_API_KEY.");
+  if (options.includeYandexGpt) {
+    console.log("6. Если нужен YandexGPT: в Yandex Cloud откройте каталог, скопируйте ID каталога, затем создайте сервисный аккаунт и API-ключ с правом yc.ai.foundationModels.execute.");
+    console.log("7. После ключа геокодера CLI отдельно спросит, настраивать ли YandexGPT. Можно ответить n и подключить модель позже через /model.");
+  }
+  console.log("Подробная инструкция: https://github.com/adm-iola/iola-cli/wiki/Yandex-Cloud-Connector");
+  console.log("");
+}
+
 async function saveYandexCloudConnectorSecrets({ geocoderApiKey, yandexgptApiKey, folderId }) {
   const secrets = await loadSecrets();
   secrets.yandexCloud = {
@@ -10062,6 +10085,15 @@ async function askText(question) {
   }
 }
 
+async function askYesNo(question, defaultValue = false) {
+  if (!process.stdin.isTTY) return Boolean(defaultValue);
+  const answer = (await askText(question)).trim().toLocaleLowerCase("ru-RU");
+  if (!answer) return Boolean(defaultValue);
+  if (answer === "y" || answer === "yes" || answer === "д" || answer === "да") return true;
+  if (answer === "n" || answer === "no" || answer === "н" || answer === "нет") return false;
+  return Boolean(defaultValue);
+}
+
 async function aiContext(args) {
   const options = parseOptions(args);
   const query = options._.join(" ").trim();
@@ -16465,9 +16497,6 @@ async function onboard(args = []) {
       await chooseAndSaveApiModel("openrouter");
     }
   }
-  if (components.includes("yandex-cloud")) {
-    await setupYandexCloudConnector({});
-  }
   if (components.includes("gigachat")) {
     await aiSetup(["gigachat"]);
     if (process.stdin.isTTY) {
@@ -16486,6 +16515,9 @@ async function onboard(args = []) {
   if (components.includes("yandex")) {
     await setupYandexConnector([]);
   }
+  if (components.includes("yandex-cloud")) {
+    await setupYandexCloudConnector({});
+  }
   if (components.includes("codex")) {
     await installCodexIfMissing();
     await aiSetup(["codex"]);
@@ -16524,19 +16556,18 @@ async function chooseOnboardComponents(status = null) {
       1: "workspace",
       2: "policy",
       3: "iola",
-      4: "yandex-cloud",
-      5: "gigachat",
-      6: "openai",
-      7: "openrouter",
-      8: "codex",
-      9: "codex-mcp",
-      10: "archive",
-      11: "index",
-      12: "browser",
-      13: "ollama",
-      14: "cloud",
-      15: "yandex",
-      16: "yandex",
+      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",
     };
     return [...selected].map((item) => map[item] || item).filter(Boolean);
   } finally {
@@ -16559,7 +16590,6 @@ async function getOnboardComponentStatus() {
     getYandexGeocoderKey(),
     loadSecrets(),
   ]);
-  const cloudSecrets = secrets.cloud || {};
   const workspaceReady = existsSync(PROJECT_CONTEXT_FILE) || existsSync(PROJECT_CONTEXT_DIR_FILE) || existsSync(PROJECT_IOLA_DIR);
   const policyReady = (config.toolsets?.enabled || []).includes("analyst");
   return {
@@ -16576,7 +16606,6 @@ async function getOnboardComponentStatus() {
     archive: Boolean(archive),
     index: false,
     browser: browser.installed === "yes",
-    cloud: Object.keys(cloudSecrets).length > 0,
     yandex: isYandexConnectorFullyConnected(secrets),
   };
 }
@@ -16586,18 +16615,17 @@ function onboardComponentRows(status) {
     ["1", "workspace", "workspace и контекст", "рабочая папка, IOLA.md и .iola/context.md"],
     ["2", "policy", "policy analyst", "разрешения и профиль аналитика"],
     ["3", "iola", "IOLA локальная модель", "локальная модель найдена"],
-    ["4", "yandex-cloud", "Yandex Cloud Connector", "геокодинг и YandexGPT"],
-    ["5", "gigachat", "GigaChat API", "authorization key сохранен или есть в env"],
-    ["6", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
-    ["7", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
-    ["8", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
-    ["9", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
-    ["10", "archive", "7-Zip / архивы", "архиватор найден"],
-    ["11", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
-    ["12", "browser", "Browser runtime", "Playwright/Chromium установлен"],
-    ["13", "ollama", "Ollama", "опциональный локальный runtime"],
-    ["14", "cloud", "Облачный диск", "Яндекс Диск или Облако Mail.ru"],
-    ["15", "yandex", "Yandex Connector", "единый вход и категории сервисов Яндекса"],
+    ["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"],
   ];
   return rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" }));
 }
@@ -16607,12 +16635,12 @@ function defaultOnboardSelection(status) {
   if (!status.workspace) defaults.push("1");
   if (!status.policy) defaults.push("2");
   if (!status.iola) defaults.push("3");
-  if (!status.archive) defaults.push("10");
+  if (!status.archive) defaults.push("9");
   return defaults.length ? defaults : ["1", "2"];
 }
 
 function defaultOnboardComponents(status) {
-  const map = { 1: "workspace", 2: "policy", 3: "iola", 4: "yandex-cloud", 5: "gigachat", 6: "openai", 7: "openrouter", 8: "codex", 9: "codex-mcp", 10: "archive", 11: "index", 12: "browser", 13: "ollama", 14: "cloud", 15: "yandex", 16: "yandex" };
+  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" };
   return defaultOnboardSelection(status).map((item) => map[item]).filter(Boolean);
 }
 

package/wiki/Yandex-Cloud-Connector.md

@@ -18,10 +18,22 @@ iola master
 В мастере выберите:
 
 ```text
-4. Yandex Cloud Connector - геокодинг и YandexGPT
+14. Yandex Cloud Connector - геокодинг и YandexGPT
 ```
 
-CLI откроет консоль Yandex Cloud и попросит сохранить:
+CLI не просто открывает консоль. Он печатает короткую инструкцию, что делать дальше, и только потом просит вставить ключи.
+
+Что делает пользователь:
+
+1. Входит в свой Яндекс-аккаунт.
+2. Если Яндекс просит создать облако или каталог, создает их. Названия можно оставить простыми: `iola-cli` и `default`.
+3. Для геокодера открывает Кабинет разработчика: `https://developer.tech.yandex.ru/services/2`.
+4. Выбирает `API Геокодера`, создает API key и копирует значение ключа.
+5. Возвращается в окно CLI и вставляет ключ в поле `YANDEX_GEOCODER_API_KEY`.
+6. Если нужен YandexGPT, в Yandex Cloud копирует ID каталога, создает сервисный аккаунт и API-ключ с правом `yc.ai.foundationModels.execute`.
+7. Если YandexGPT пока не нужен, на вопрос CLI можно ответить `n` и подключить модель позже через `/model`.
+
+CLI попросит сохранить:
 
 - ключ `YANDEX_GEOCODER_API_KEY`;
 - при необходимости YandexGPT API key;

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

@@ -30,49 +30,39 @@ iola master
 
 После настройки локальную модель можно менять в интерактивном агенте через `/model`. Помимо штатной IOLA-модели можно выбрать установленную или рекомендуемую Ollama-модель, либо вручную ввести имя любой модели из библиотеки Ollama.
 
-### 4. Yandex Cloud Connector
-
-Настраивает Yandex Cloud Connector: геокодер и, при необходимости, YandexGPT.
-
-Геокодер включается по умолчанию. Он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить сразу или выбрать позже через `/model`.
-
-Ключи сохраняются локально у пользователя. Российский AI-провайдер вызывается напрямую, без gateway/proxy.
-
-Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).
-
-### 5. GigaChat API
+### 4. GigaChat API
 
 Настраивает профиль GigaChat и сохраняет authorization key локально у пользователя.
 
 Российский провайдер вызывается напрямую, без gateway/proxy.
 
-### 6. OpenAI API
+### 5. OpenAI API
 
 Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать модель из доступного списка.
 
-### 7. OpenRouter API
+### 6. OpenRouter API
 
 Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
 
 После сохранения ключа мастер предлагает выбрать разработчика моделей OpenRouter, а затем одну из свежих моделей для текстовой работы. В списке моделей `0` возвращает к выбору разработчика.
 
-### 8. Codex CLI
+### 7. Codex CLI
 
 Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
 
-### 9. MCP для Codex
+### 8. MCP для Codex
 
 Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
 
-### 10. 7-Zip / архивы
+### 9. 7-Zip / архивы
 
 Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
 
 Нужен для чтения, распаковки, сборки и индексирования архивов.
 
-### 11. Индекс локальных документов
+### 10. Индекс локальных документов
 
 Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
 
@@ -80,28 +70,17 @@ iola master
 iola index folder ./docs
 ```
 
-### 12. Browser runtime
+### 11. Browser runtime
 
 Проверяет Playwright/Chromium runtime. Нужен для браузерного агента.
 
-### 13. Ollama
+### 12. Ollama
 
 Опциональный локальный runtime для выбора сторонних моделей из библиотеки Ollama.
 
 Если runtime уже установлен, пункт показывается как `готово`.
 
-### 14. Облачный диск
-
-Подключает личный облачный диск пользователя:
-
-- Яндекс Диск;
-- Облако Mail.ru.
-
-Секреты сохраняются локально в `~/.iola/secrets.json`. Резервные копии CLI не включают OAuth-токены, пароли и API-ключи.
-
-Инструкция: [Облачные диски](Облачные-диски).
-
-### 15. Yandex Connector
+### 13. Yandex Connector
 
 Настраивает единый коннектор пользовательских сервисов Яндекса.
 
@@ -116,6 +95,18 @@ iola index folder ./docs
 
 Инструкция: [Yandex Connector](Yandex-Connector).
 
+### 14. Yandex Cloud Connector
+
+Настраивает Yandex Cloud Connector: геокодер и, при необходимости, YandexGPT.
+
+Геокодер включается по умолчанию. Он нужен для geo-skills и deeplink Яндекс Go. YandexGPT можно включить сразу или выбрать позже через `/model`.
+
+При запуске CLI печатает пошаговую инструкцию: войти в Яндекс, создать облако/каталог при необходимости, открыть Кабинет разработчика геокодера, создать API key, вернуться в CLI и вставить ключ. Пользователь не остается один на пустой странице консоли.
+
+Ключи сохраняются локально у пользователя. Российский AI-провайдер вызывается напрямую, без gateway/proxy.
+
+Инструкция: [Yandex Cloud Connector](Yandex-Cloud-Connector).
+
 ## Повторный запуск
 
 Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.