@iola_adm/iola-cli 0.1.33 → 0.1.35

package/README.md

@@ -2,7 +2,7 @@
 
 # iola-cli
 
-CLI и AI-агент для работы с открытыми данными городского округа "Город Йошкар-Ола".
+CLI и AI-агент городского округа "Город Йошкар-Ола".
 
 Подробная документация: [GitHub Wiki](https://github.com/adm-iola/iola-cli/wiki).
 
@@ -26,16 +26,26 @@ npm --version
 
 ```bash
 npm install -g @iola_adm/iola-cli
-iola init
-iola --help
+iola
 ```
 
 Без глобальной установки:
 
 ```bash
-npx -y @iola_adm/iola-cli init
+npx -y @iola_adm/iola-cli
 ```
 
+При первом запуске `iola` открывает мастер настройки, затем запускает интерактивный агент. Короткая справка: `iola help`, полный список команд: `iola commands`.
+
+Повторный запуск мастера:
+
+```bash
+iola wizard
+iola setup wizard
+```
+
+Мастер обновляет только выбранные разделы и не сбрасывает остальные настройки.
+
 Основные команды:
 
 ```bash

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iola_adm/iola-cli",
-  "version": "0.1.33",
-  "description": "CLI и AI-агент для работы с открытыми данными городского округа Йошкар-Ола.",
+  "version": "0.1.35",
+  "description": "CLI и AI-агент городского округа Йошкар-Ола.",
   "license": "MIT",
   "homepage": "https://github.com/adm-iola/iola-cli#readme",
   "repository": {

package/src/cli.js

@@ -271,7 +271,7 @@ const BANNER = `\x1b[38;5;45m┌────────────────
 │\x1b[38;5;51m | |___| |___ | |_____|  __/|  _ <| |_| | |___| . \\  | |                   \x1b[38;5;45m│
 │\x1b[38;5;51m  \\____|_____|___|    |_|   |_| \\_\\\\___/|_____|_|\\_\\ |_|                   \x1b[38;5;45m│
 │                                                                            │
-│\x1b[38;5;213m                    Й О Ш К А Р - О Л Ы                                    \x1b[38;5;45m│
+│\x1b[38;5;213m                    C L I - Й О Ш К А Р - О Л А                            \x1b[38;5;45m│
 │                                                                            │
 │\x1b[38;5;250m        открытые данные • MCP • локальный AI                               \x1b[38;5;45m│
 │                                                                            │
@@ -280,6 +280,7 @@ const BANNER = `\x1b[38;5;45m┌────────────────
 
 const COMMANDS = new Map([
   ["help", showHelp],
+  ["commands", showCommands],
   ["version", showVersion],
   ["update", checkUpdate],
   ["doctor", doctor],
@@ -352,10 +353,16 @@ const COMMANDS = new Map([
   ["mcp-info", showMcpInfo],
   ["setup", setupClient],
   ["onboard", onboard],
+  ["wizard", onboard],
 ]);
 
 export async function main(argv) {
-  if (argv.length === 0 || argv[0] === "--help" || argv[0] === "-h") {
+  if (argv.length === 0) {
+    await runDefaultCli();
+    return;
+  }
+
+  if (argv[0] === "--help" || argv[0] === "-h") {
     await showHelp();
     return;
   }
@@ -398,6 +405,35 @@ export async function main(argv) {
 }
 
 async function showHelp() {
+  showBanner();
+  console.log(`iola - CLI и AI-агент городского округа "Город Йошкар-Ола"
+
+Запуск:
+  iola                         открыть интерактивный агент
+  iola wizard                  мастер настройки
+  iola ask "найди школу 29"    задать вопрос
+  iola search "Петрова"        поиск по открытым данным
+
+Основные разделы:
+  iola agent                   интерактивный режим
+  iola ai setup                настройка AI-профиля
+  iola browser status          браузерный runtime
+  iola gosuslugi status        личное подключение Госуслуг
+  iola mcp status              MCP-подключение
+  iola doctor                  диагностика
+  iola wiki                    документация
+
+Справка:
+  iola help                    короткая справка
+  iola commands                полный список команд
+  iola version                 версия
+
+Requirements:
+  Node.js >= ${MIN_NODE_VERSION}
+`);
+}
+
+async function showCommands() {
   showBanner();
   console.log(`iola - CLI для открытых данных городского округа "Город Йошкар-Ола"
 
@@ -498,6 +534,7 @@ Usage:
   iola mcp-info [--json]
   iola setup codex
   iola onboard
+  iola wizard
   iola version
 
 Environment:
@@ -509,6 +546,26 @@ Requirements:
 `);
 }
 
+async function runDefaultCli() {
+  const nodeStatus = getNodeRequirementStatus();
+  if (!nodeStatus.ok) {
+    throw new Error(`Нужен Node.js ${MIN_NODE_VERSION} или новее. Сейчас: ${nodeStatus.current}. Запустите: iola init --upgrade-node`);
+  }
+
+  initDatabase();
+  if (!isFirstRunCompleted()) {
+    showBanner();
+    console.log("Первый запуск iola-cli. Сейчас откроется мастер настройки.");
+    console.log("После мастера запустится интерактивный агент.");
+    console.log("");
+    await onboard([]);
+    markFirstRunCompleted();
+    console.log("");
+  }
+
+  await startAgent([]);
+}
+
 async function startAgent() {
   showBanner();
   console.log("Интерактивный режим. Введите /help для списка команд, /exit для выхода.");
@@ -905,6 +962,8 @@ async function handleAgentLine(line, state) {
     search: ["search", args],
     "mcp-info": ["mcp-info", args],
     setup: ["setup", args],
+    wizard: ["wizard", args],
+    onboard: ["onboard", args],
   }[command];
 
   if (!mapped) {
@@ -923,6 +982,7 @@ function printAgentHelp() {
   /help
   /health
   /doctor
+  /wizard
   /db status
   /sessions
   /resume SESSION_ID
@@ -1042,12 +1102,13 @@ function safePrompt(rl, closed = false) {
 }
 
 function showBanner() {
+  const version = getPackageVersion();
   if (process.stdout.isTTY && process.env.NO_COLOR !== "1") {
-    console.log(BANNER);
+    console.log(BANNER.replace("> iola help", `v${version} • iola help`));
     return;
   }
 
-  console.log("CLI-ПРОЕКТ ЙОШКАР-ОЛЫ");
+  console.log(`CLI-ЙОШКАР-ОЛА v${version}`);
   console.log("открытые данные • MCP • локальный AI");
 }
 
@@ -4421,6 +4482,34 @@ function getDbStatus() {
   }
 }
 
+function getMetaValue(key) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    return db.prepare("SELECT value FROM meta WHERE key = ?").get(key)?.value || null;
+  } finally {
+    db.close();
+  }
+}
+
+function setMetaValue(key, value) {
+  initDatabase();
+  const db = openDatabase();
+  try {
+    db.prepare("INSERT INTO meta(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(key, String(value));
+  } finally {
+    db.close();
+  }
+}
+
+function isFirstRunCompleted() {
+  return getMetaValue("first_run_completed") === "1";
+}
+
+function markFirstRunCompleted() {
+  setMetaValue("first_run_completed", "1");
+}
+
 function recordAskHistory({ question, answer, providerConfig, dataContext, error, sessionId }) {
   try {
     initDatabase();
@@ -6231,10 +6320,15 @@ async function searchAll(args) {
 }
 
 async function setupClient(args) {
-  const [client] = args;
+  const [client, ...rest] = args;
+
+  if (client === "wizard" || client === "onboard") {
+    await onboard(rest);
+    return;
+  }
 
   if (client !== "codex") {
-    throw new Error('Only "iola setup codex" is available in this first release.');
+    throw new Error('Доступно: iola setup codex, iola setup wizard.');
   }
 
   await runCommand("codex", ["mcp", "add", "yoshkarOlaPublicData", "--url", `${await getMcpBaseUrl()}/mcp`], { inherit: true });
@@ -6245,10 +6339,20 @@ async function setupClient(args) {
 async function onboard(args = []) {
   const options = parseOptions(args);
   showBanner();
+  console.log("Мастер настройки iola-cli.");
+  console.log("Повторный запуск обновляет только выбранные разделы и не сбрасывает остальные настройки.");
+  console.log("");
   initDatabase();
   await handleConfig(["validate"]);
   await doctor(["--summary"]);
-  await ensureArchiveTool({ install: true });
+  if (options.full || options.install) {
+    await ensureArchiveTool({ install: true });
+  } else {
+    const archiveTool = await findCommand(["7z", "7zz", "7za"], ["--help"]);
+    if (!archiveTool) {
+      console.log("7-Zip не найден. Для архивов можно позже запустить: iola archive doctor");
+    }
+  }
 
   const components = options.yes ? ["workspace", "policy", "ollama", "openai", "openrouter", "codex", "codex-mcp", "index"] : await chooseOnboardComponents();
   if (components.includes("workspace")) await handleWorkspace(["init"]);
@@ -6270,10 +6374,21 @@ async function onboard(args = []) {
     await aiSetup(["codex"]);
   }
   if (components.includes("codex-mcp")) await setupClient(["codex"]);
+  if (components.includes("browser")) {
+    const status = await getBrowserStatus();
+    if (status.installed === "yes") console.log("Browser runtime уже установлен.");
+    else await installBrowserRuntime();
+  }
+  if (components.includes("gosuslugi")) {
+    await handleGosuslugi(["terms"]);
+    if (process.stdin.isTTY) await handleGosuslugi(["consent"]);
+    console.log("Параметры подключения можно указать командой: iola gosuslugi configure --auth-url URL --token-url URL --client-id ID --scope openid");
+  }
   if (components.includes("index")) {
     await setFilesMode("read-only", await loadConfig());
     console.log("Индекс документов можно запустить командой: iola index folder ./docs");
   }
+  markFirstRunCompleted();
   console.log("Onboard завершен.");
 }
 
@@ -6289,6 +6404,8 @@ async function chooseOnboardComponents() {
   console.log("6. Codex CLI");
   console.log("7. MCP для Codex");
   console.log("8. Индекс локальных документов");
+  console.log("9. Browser runtime");
+  console.log("10. Личное подключение Госуслуг");
   console.log("");
   const rl = readline.createInterface({ input, output });
   try {
@@ -6303,6 +6420,8 @@ async function chooseOnboardComponents() {
       6: "codex",
       7: "codex-mcp",
       8: "index",
+      9: "browser",
+      10: "gosuslugi",
     };
     return [...selected].map((item) => map[item] || item).filter(Boolean);
   } finally {

package/wiki/Home.md

@@ -1,6 +1,6 @@
 # iola-cli
 
-`iola-cli` - терминальный инструмент и AI-агент для работы с открытыми данными городского округа "Город Йошкар-Ола".
+`iola-cli` - CLI и AI-агент городского округа "Город Йошкар-Ола".
 
 Основные сценарии:
 

package/wiki//320/232/320/276/320/274/320/260/320/275/320/264/321/213.md

@@ -4,6 +4,8 @@
 
 ```bash
 iola --help
+iola help
+iola commands
 iola init
 iola doctor
 iola doctor --fix

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

@@ -3,16 +3,42 @@
 Первый запуск:
 
 ```bash
-iola init
+iola
 ```
 
-Команда проверит:
+При первом запуске команда откроет мастер настройки, а затем запустит интерактивный агент.
+
+Мастер проверит:
 
 - Node.js и npm;
 - локальную SQLite-БД;
 - доступность публичного API/MCP;
-- Ollama и подходящую локальную модель;
-- обновления npm-пакета.
+- обновления npm-пакета;
+- выбранные компоненты: workspace, policy, локальную модель, API-ключи, Codex, MCP, индекс документов.
+
+Обычный последующий запуск:
+
+```bash
+iola
+```
+
+Команда сразу откроет интерактивный CLI-агент.
+
+Справка:
+
+```bash
+iola help
+iola commands
+```
+
+Повторный запуск мастера:
+
+```bash
+iola wizard
+iola setup wizard
+```
+
+Мастер обновляет только выбранные разделы и не сбрасывает остальные настройки.
 
 Диагностика:
 

package/wiki//320/237/320/273/320/260/321/202/321/204/320/276/321/200/320/274/320/260-/320/260/320/263/320/265/320/275/321/202/320/260.md

@@ -1,6 +1,6 @@
 # Платформа агента
 
-`iola-cli` можно использовать не только как набор команд, но и как локальную платформу агента для работы с открытыми данными городского округа "Город Йошкар-Ола".
+`iola-cli` можно использовать не только как набор команд, но и как локальную платформу AI-агента городского округа "Город Йошкар-Ола".
 
 ## MCP server
 
@@ -101,4 +101,3 @@ iola review data
 iola review docs ./docs
 iola review report report.docx
 ```
-