@iola_adm/iola-cli 0.1.62 → 0.1.64

package/README.md

@@ -111,6 +111,7 @@ iola version --check
 
 - [Установка](https://github.com/adm-iola/iola-cli/wiki/Установка)
 - [Первый запуск](https://github.com/adm-iola/iola-cli/wiki/Первый-запуск)
+- [Мастер настройки](https://github.com/adm-iola/iola-cli/wiki/Мастер-настройки)
 - [AI-профили](https://github.com/adm-iola/iola-cli/wiki/AI-профили)
 - [Локальный инструментальный агент](https://github.com/adm-iola/iola-cli/wiki/Локальный-инструментальный-агент)
 - [Skills и toolsets](https://github.com/adm-iola/iola-cli/wiki/Skills-и-toolsets)
@@ -141,6 +142,7 @@ iola version --check
 - личное локальное подключение Госуслуг через отдельный браузерный профиль на ПК пользователя;
 - read-only tools Госуслуг для агента: ФИО, дата рождения, задолженности и уведомления;
 - keepalive-проверка сессии Госуслуг каждые 30 минут через Windows Task Scheduler без висящего окна терминала;
+- мастер настройки автоматически включает keepalive после подключения Госуслуг;
 - управляемые локальные файловые операции с режимами `locked`, `read-only`, `workspace-write`, `full-access`;
 - планы выполнения, traces, tasks, artifacts, snapshots и policy-профили;
 - экспорт отчетов в Excel/Word-совместимые файлы;

package/package.json

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

package/src/cli.js

@@ -2431,6 +2431,7 @@ async function handleWiki(args) {
     ["Главная", base],
     ["Установка", `${base}/Установка`],
     ["Первый запуск", `${base}/Первый-запуск`],
+    ["Мастер настройки", `${base}/Мастер-настройки`],
     ["AI-профили", `${base}/AI-профили`],
     ["Локальный инструментальный агент", `${base}/Локальный-инструментальный-агент`],
     ["Skills и toolsets", `${base}/Skills-и-toolsets`],
@@ -7094,7 +7095,8 @@ async function onboard(args = []) {
     }
   }
 
-  const components = options.yes ? ["workspace", "policy", "ollama", "openai", "openrouter", "codex", "codex-mcp", "archive", "index"] : await chooseOnboardComponents();
+  const componentStatus = await getOnboardComponentStatus();
+  const components = options.yes ? defaultOnboardComponents(componentStatus) : await chooseOnboardComponents(componentStatus);
   if (components.includes("workspace")) await handleWorkspace(["init"]);
   if (components.includes("policy")) await handlePolicy(["use", "analyst"]);
   if (components.includes("archive")) await ensureArchiveTool({ install: true });
@@ -7126,6 +7128,7 @@ async function onboard(args = []) {
     await ensureBrowserRuntimeForGosuslugi();
     if (process.stdin.isTTY && await confirm("Открыть Госуслуги для входа сейчас? [Y/n] ")) {
       await gosuslugiBrowserConnect({ yes: true });
+      await installGosuslugiKeepaliveTask({ interval: "30m" });
     } else {
       console.log("Подключить личные Госуслуги позже: iola gosuslugi connect");
     }
@@ -7138,25 +7141,19 @@ async function onboard(args = []) {
   console.log("Onboard завершен.");
 }
 
-async function chooseOnboardComponents() {
+async function chooseOnboardComponents(status = null) {
   if (!process.stdin.isTTY) return ["workspace", "policy"];
+  const componentStatus = status || await getOnboardComponentStatus();
   console.log("");
   console.log("Выберите компоненты через запятую:");
-  console.log("1. workspace и контекст");
-  console.log("2. policy analyst");
-  console.log("3. Ollama + локальная модель");
-  console.log("4. OpenAI API");
-  console.log("5. OpenRouter API");
-  console.log("6. Codex CLI");
-  console.log("7. MCP для Codex");
-  console.log("8. 7-Zip / архивы");
-  console.log("9. Индекс локальных документов");
-  console.log("10. Browser runtime");
-  console.log("11. Личное подключение Госуслуг");
+  for (const item of onboardComponentRows(componentStatus)) {
+    console.log(`${item.number}. ${item.title} [${item.status}] - ${item.hint}`);
+  }
   console.log("");
   const rl = readline.createInterface({ input, output });
   try {
-    const answer = (await rl.question("Компоненты [1,2,8]: ")).trim() || "1,2,8";
+    const defaults = defaultOnboardSelection(componentStatus);
+    const answer = (await rl.question(`Компоненты [${defaults.join(",")}]: `)).trim() || defaults.join(",");
     const selected = new Set(answer.split(/[,\s]+/).filter(Boolean));
     const map = {
       1: "workspace",
@@ -7177,6 +7174,64 @@ async function chooseOnboardComponents() {
   }
 }
 
+async function getOnboardComponentStatus() {
+  const [config, readiness, browser, archive, codexVersion, ollamaVersion, secrets] = await Promise.all([
+    loadConfig(),
+    getAiReadiness(),
+    getBrowserStatus(),
+    findCommand(["7z", "7zz", "7za"], ["--help"]).catch(() => null),
+    getCommandVersion("codex", ["--version"]),
+    getOllamaVersion(),
+    loadSecrets(),
+  ]);
+  const workspaceReady = existsSync(PROJECT_CONTEXT_FILE) || existsSync(PROJECT_CONTEXT_DIR_FILE) || existsSync(PROJECT_IOLA_DIR);
+  const policyReady = (config.toolsets?.enabled || []).includes("analyst");
+  const gosuslugiReady = Boolean(config.gosuslugi?.enabled && existsSync(GOSUSLUGI_BROWSER_PROFILE_DIR) && secrets.gosuslugiBrowser?.connectedAt);
+  return {
+    workspace: workspaceReady,
+    policy: policyReady,
+    ollama: Boolean(ollamaVersion && readiness.ollama),
+    openai: Boolean(readiness.openai),
+    openrouter: Boolean(readiness.openrouter),
+    codex: Boolean(codexVersion !== "не найден" && readiness.codex),
+    "codex-mcp": false,
+    archive: Boolean(archive),
+    index: false,
+    browser: browser.installed === "yes",
+    gosuslugi: gosuslugiReady,
+  };
+}
+
+function onboardComponentRows(status) {
+  const rows = [
+    ["1", "workspace", "workspace и контекст", "рабочая папка, IOLA.md и .iola/context.md"],
+    ["2", "policy", "policy analyst", "разрешения и профиль аналитика"],
+    ["3", "ollama", "Ollama + локальная модель", "локальная модель найдена"],
+    ["4", "openai", "OpenAI API", "API-ключ сохранен или есть в env"],
+    ["5", "openrouter", "OpenRouter API", "API-ключ сохранен или есть в env"],
+    ["6", "codex", "Codex CLI", "CLI установлен и авторизация найдена"],
+    ["7", "codex-mcp", "MCP для Codex", "можно переустановить/обновить"],
+    ["8", "archive", "7-Zip / архивы", "архиватор найден"],
+    ["9", "index", "Индекс локальных документов", "настраивается под выбранную папку"],
+    ["10", "browser", "Browser runtime", "Playwright/Chromium установлен"],
+    ["11", "gosuslugi", "Личное подключение Госуслуг", "профиль и keepalive"],
+  ];
+  return rows.map(([number, key, title, hint]) => ({ number, key, title, hint, status: status[key] ? "готово" : "не настроено" }));
+}
+
+function defaultOnboardSelection(status) {
+  const defaults = [];
+  if (!status.workspace) defaults.push("1");
+  if (!status.policy) defaults.push("2");
+  if (!status.archive) defaults.push("8");
+  return defaults.length ? defaults : ["1", "2"];
+}
+
+function defaultOnboardComponents(status) {
+  const map = { 1: "workspace", 2: "policy", 3: "ollama", 4: "openai", 5: "openrouter", 6: "codex", 7: "codex-mcp", 8: "archive", 9: "index", 10: "browser", 11: "gosuslugi" };
+  return defaultOnboardSelection(status).map((item) => map[item]).filter(Boolean);
+}
+
 function parseOptions(args) {
   const result = { _: [] };
 

package/wiki/Home.md

@@ -26,6 +26,7 @@ iola ask "найди школу 29"
 
 - [Установка](Установка)
 - [Первый запуск](Первый-запуск)
+- [Мастер настройки](Мастер-настройки)
 - [AI-профили](AI-профили)
 - [Локальный инструментальный агент](Локальный-инструментальный-агент)
 - [Skills и toolsets](Skills-и-toolsets)

package/wiki//320/220/321/200/321/205/320/270/320/262/321/213-/320/270-/320/274/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

@@ -43,3 +43,5 @@ iola onboard
 В списке компонентов есть отдельный пункт `7-Zip / архивы`. Если выбрать его, CLI установит архиватор сразу из мастера настройки.
 
 Мастер также предлагает подключить workspace, policy, Ollama, OpenAI, OpenRouter, Codex CLI, MCP, browser runtime, Госуслуги и индекс локальных документов.
+
+Подробное описание пунктов мастера вынесено на страницу [Мастер настройки](Мастер-настройки).

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

@@ -0,0 +1,82 @@
+# Мастер настройки
+
+Мастер запускается при первом старте CLI и повторно командой:
+
+```bash
+iola master
+```
+
+Мастер обновляет только выбранные компоненты и не сбрасывает остальные настройки.
+
+Перед выбором компонентов CLI проверяет окружение и показывает статус каждого пункта: `готово` или `не настроено`.
+
+## Компоненты
+
+### 1. workspace и контекст
+
+Создает рабочую среду текущей папки: `.iola/`, `IOLA.md` и `.iola/context.md`.
+
+Нужно, если агент будет работать с локальными файлами, документами, задачами, артефактами и контекстом проекта.
+
+### 2. policy analyst
+
+Включает профиль разрешений для аналитической работы: открытые данные, отчеты, безопасные локальные операции.
+
+### 3. Ollama + локальная модель
+
+Проверяет Ollama и локальные модели. Если Ollama не установлена, мастер может установить ее и предложить модель под возможности ПК.
+
+Если модель уже скачана и доступна, пункт показывается как `готово`.
+
+### 4. OpenAI API
+
+Настраивает профиль OpenAI и сохраняет API-ключ локально у пользователя.
+
+### 5. OpenRouter API
+
+Настраивает профиль OpenRouter и сохраняет API-ключ локально у пользователя.
+
+### 6. Codex CLI
+
+Проверяет наличие Codex CLI и авторизации. Если Codex уже установлен и вход выполнен, пункт показывается как `готово`.
+
+### 7. MCP для Codex
+
+Добавляет MCP-сервер открытых данных Йошкар-Олы в Codex. Этот пункт можно запускать повторно для обновления подключения.
+
+### 8. 7-Zip / архивы
+
+Проверяет 7-Zip. Если архиватор не найден, мастер устанавливает его.
+
+Нужен для чтения, распаковки, сборки и индексирования архивов.
+
+### 9. Индекс локальных документов
+
+Готовит режим чтения файлов и подсказывает команду индексирования локальной папки:
+
+```bash
+iola index folder ./docs
+```
+
+### 10. Browser runtime
+
+Проверяет Playwright/Chromium runtime. Нужен для браузерного агента и подключения Госуслуг.
+
+Если runtime уже установлен, пункт показывается как `готово`.
+
+### 11. Личное подключение Госуслуг
+
+Открывает браузерный профиль Госуслуг. Пользователь сам вводит логин, пароль и двухфакторный код.
+
+После входа CLI сохраняет профиль на ПК и автоматически создает keepalive-задачу Windows Task Scheduler каждые 30 минут.
+
+Проверить:
+
+```bash
+iola gosuslugi status
+iola gosuslugi keepalive-status
+```
+
+## Повторный запуск
+
+Если компонент уже настроен, его можно не выбирать. Если нужно переустановить или обновить компонент, выберите его номер вручную.

package/wiki//320/237/320/265/321/200/320/262/321/213/320/271-/320/267/320/260/320/277/321/203/321/201/320/272.md

@@ -34,12 +34,13 @@ iola commands
 Повторный запуск мастера:
 
 ```bash
-iola wizard
-iola setup wizard
+iola master
 ```
 
 Мастер обновляет только выбранные разделы и не сбрасывает остальные настройки.
 
+Подробное описание всех пунктов: [Мастер настройки](Мастер-настройки).
+
 Диагностика:
 
 ```bash

package/wiki//320/237/320/276/320/264/320/272/320/273/321/216/321/207/320/265/320/275/320/270/320/265-/320/223/320/276/321/201/321/203/321/201/320/273/321/203/320/263.md

@@ -18,6 +18,7 @@ iola gosuslugi connect
 4. Пользователь сам проходит вход.
 5. После завершения пользователь закрывает окно браузера.
 6. CLI сохраняет локальное состояние профиля.
+7. При подключении через мастер настройки CLI автоматически создает keepalive-задачу на 30 минут.
 
 Профиль хранится в: